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 0001/1478] 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 0002/1478] 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 f29700bd2fe1fc79cb6fd5bf2b31129119e6978c Mon Sep 17 00:00:00 2001
From: LiuYangkuan <liuyangkuan@gmail.com>
Date: Wed, 1 Feb 2023 18:50:43 +0800
Subject: [PATCH 0003/1478] use IDisk to do IO in Keeper's snapshots and logs

---
 programs/keeper-converter/KeeperConverter.cpp |   3 +-
 src/Coordination/Changelog.cpp                | 151 +++++++++++-------
 src/Coordination/Changelog.h                  |   6 +-
 src/Coordination/KeeperLogStore.cpp           |  11 +-
 src/Coordination/KeeperLogStore.h             |   3 +
 src/Coordination/KeeperServer.cpp             |  23 ++-
 src/Coordination/KeeperSnapshotManager.cpp    |  91 ++++++-----
 src/Coordination/KeeperSnapshotManager.h      |  24 ++-
 src/Coordination/KeeperStateMachine.cpp       |   4 +-
 src/Coordination/KeeperStateMachine.h         |   2 +-
 src/Coordination/KeeperStateManager.cpp       |  71 ++++----
 src/Coordination/KeeperStateManager.h         |   8 +-
 src/IO/ZstdDeflatingAppendableWriteBuffer.cpp |   2 +-
 src/IO/ZstdDeflatingAppendableWriteBuffer.h   |   4 +-
 14 files changed, 244 insertions(+), 159 deletions(-)

diff --git a/programs/keeper-converter/KeeperConverter.cpp b/programs/keeper-converter/KeeperConverter.cpp
index 7d25c1d5017..c81e61685fd 100644
--- a/programs/keeper-converter/KeeperConverter.cpp
+++ b/programs/keeper-converter/KeeperConverter.cpp
@@ -9,6 +9,7 @@
 #include <Poco/AutoPtr.h>
 #include <Poco/Logger.h>
 #include <Common/logger_useful.h>
+#include <Disks/DiskLocal.h>
 
 
 int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
@@ -51,7 +52,7 @@ int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
         DB::SnapshotMetadataPtr snapshot_meta = std::make_shared<DB::SnapshotMetadata>(storage.getZXID(), 1, std::make_shared<nuraft::cluster_config>());
         DB::KeeperStorageSnapshot snapshot(&storage, snapshot_meta);
 
-        DB::KeeperSnapshotManager manager(options["output-dir"].as<std::string>(), 1, keeper_context);
+        DB::KeeperSnapshotManager manager(std::make_shared<DiskLocal>("Keeper-snapshots", options["output-dir"].as<std::string>(), 0), 1, keeper_context);
         auto snp = manager.serializeSnapshotToBuffer(snapshot);
         auto path = manager.serializeSnapshotBufferToDisk(*snp, storage.getZXID());
         std::cout << "Snapshot serialized to path:" << path << std::endl;
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index 142a7209b42..2d3fb9cba47 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -31,12 +31,9 @@ namespace
 
 constexpr auto DEFAULT_PREFIX = "changelog";
 
-std::string formatChangelogPath(
-    const std::string & prefix, const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
+inline std::string formatChangelogPath(const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
 {
-    std::filesystem::path path(prefix);
-    path /= std::filesystem::path(fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension));
-    return path;
+    return fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension);
 }
 
 ChangelogFileDescriptionPtr getChangelogFileDescription(const std::filesystem::path & path)
@@ -88,11 +85,11 @@ class ChangelogWriter
 public:
     ChangelogWriter(
         std::map<uint64_t, ChangelogFileDescriptionPtr> & existing_changelogs_,
-        const std::filesystem::path & changelogs_dir_,
+        DiskPtr disk_,
         LogFileSettings log_file_settings_)
         : existing_changelogs(existing_changelogs_)
         , log_file_settings(log_file_settings_)
-        , changelogs_dir(changelogs_dir_)
+        , disk(disk_)
         , log(&Poco::Logger::get("Changelog"))
     {
     }
@@ -109,7 +106,7 @@ public:
                     file_description->expectedEntriesCountInLog());
 
             // we have a file we need to finalize first
-            if (tryGetFileBuffer() && prealloc_done)
+            if (tryGetFileBaseBuffer() && prealloc_done)
             {
                 finalizeCurrentFile();
 
@@ -121,18 +118,16 @@ public:
                     && *last_index_written != current_file_description->to_log_index)
                 {
                     auto new_path = formatChangelogPath(
-                        changelogs_dir,
                         current_file_description->prefix,
                         current_file_description->from_log_index,
                         *last_index_written,
                         current_file_description->extension);
-                    std::filesystem::rename(current_file_description->path, new_path);
+                    disk->moveFile(current_file_description->path, new_path);
                     current_file_description->path = std::move(new_path);
                 }
             }
 
-            file_buf = std::make_unique<WriteBufferFromFile>(
-                file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode == WriteMode::Rewrite ? -1 : (O_APPEND | O_CREAT | O_WRONLY));
+            file_buf = disk->writeFile(file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode);
             last_index_written.reset();
             current_file_description = std::move(file_description);
 
@@ -148,12 +143,15 @@ public:
         }
     }
 
-    bool isFileSet() const { return tryGetFileBuffer() != nullptr; }
-
+    /// There is bug when compressed_buffer has value, file_buf's ownership transfer to compressed_buffer
+    bool isFileSet() const
+    {
+        return compressed_buffer.get() != nullptr || file_buf.get() != nullptr;
+    }
 
     bool appendRecord(ChangelogRecord && record)
     {
-        const auto * file_buffer = tryGetFileBuffer();
+        const auto * file_buffer = tryGetFileBaseBuffer();
         assert(file_buffer && current_file_description);
 
         assert(record.header.index - getStartIndex() <= current_file_description->expectedEntriesCountInLog());
@@ -207,7 +205,7 @@ public:
 
     void flush()
     {
-        auto * file_buffer = tryGetFileBuffer();
+        auto * file_buffer = tryGetFileBaseBuffer();
         /// Fsync file system if needed
         if (file_buffer && log_file_settings.force_sync)
             file_buffer->sync();
@@ -232,7 +230,6 @@ public:
             new_description->extension += "." + toContentEncodingName(CompressionMethod::Zstd);
 
         new_description->path = formatChangelogPath(
-            changelogs_dir,
             new_description->prefix,
             new_start_log_index,
             new_start_log_index + log_file_settings.rotate_interval - 1,
@@ -254,14 +251,13 @@ private:
 
     void finalizeCurrentFile()
     {
-        const auto * file_buffer = tryGetFileBuffer();
-        assert(file_buffer && prealloc_done);
+        assert(prealloc_done);
 
         assert(current_file_description);
         // compact can delete the file and we don't need to do anything
         if (current_file_description->deleted)
         {
-            LOG_WARNING(log, "Log {} is already deleted", file_buffer->getFileName());
+            LOG_WARNING(log, "Log {} is already deleted", current_file_description->path);
             return;
         }
 
@@ -270,7 +266,8 @@ private:
 
         flush();
 
-        if (log_file_settings.max_size != 0)
+        const auto * file_buffer = tryGetFileBuffer();
+        if (log_file_settings.max_size != 0 && file_buffer)
             ftruncate(file_buffer->getFD(), initial_file_size + file_buffer->count());
 
         if (log_file_settings.compress_logs)
@@ -281,6 +278,8 @@ private:
 
     WriteBuffer & getBuffer()
     {
+        /// TODO: unify compressed_buffer and file_buf,
+        /// compressed_buffer can use its NestedBuffer directly if compress_logs=false
         if (compressed_buffer)
             return *compressed_buffer;
 
@@ -310,10 +309,15 @@ private:
         if (compressed_buffer)
             return dynamic_cast<WriteBufferFromFile *>(compressed_buffer->getNestedBuffer());
 
-        if (file_buf)
-            return file_buf.get();
+        return dynamic_cast<WriteBufferFromFile *>(file_buf.get());
+    }
 
-        return nullptr;
+    WriteBufferFromFileBase * tryGetFileBaseBuffer()
+    {
+        if (compressed_buffer)
+            return dynamic_cast<WriteBufferFromFileBase *>(compressed_buffer->getNestedBuffer());
+
+        return file_buf.get();
     }
 
     void tryPreallocateForFile()
@@ -325,13 +329,22 @@ private:
             return;
         }
 
-        const auto & file_buffer = getFileBuffer();
+        const auto * file_buffer = tryGetFileBuffer();
+
+        if (!file_buffer)
+        {
+            initial_file_size = 0;
+            prealloc_done = true;
+            LOG_WARNING(log, "Could not preallocate space on disk {} using fallocate", disk->getName());
+            return;
+        }
+
 #ifdef OS_LINUX
         {
             int res = -1;
             do
             {
-                res = fallocate(file_buffer.getFD(), FALLOC_FL_KEEP_SIZE, 0, log_file_settings.max_size + log_file_settings.overallocate_size);
+                res = fallocate(file_buffer->getFD(), FALLOC_FL_KEEP_SIZE, 0, log_file_settings.max_size + log_file_settings.overallocate_size);
             } while (res < 0 && errno == EINTR);
 
             if (res != 0)
@@ -346,7 +359,7 @@ private:
             }
         }
 #endif
-        initial_file_size = getSizeFromFileDescriptor(file_buffer.getFD());
+        initial_file_size = getSizeFromFileDescriptor(file_buffer->getFD());
 
         prealloc_done = true;
     }
@@ -354,7 +367,7 @@ private:
     std::map<uint64_t, ChangelogFileDescriptionPtr> & existing_changelogs;
 
     ChangelogFileDescriptionPtr current_file_description{nullptr};
-    std::unique_ptr<WriteBufferFromFile> file_buf;
+    std::unique_ptr<WriteBufferFromFileBase> file_buf;
     std::optional<uint64_t> last_index_written;
     size_t initial_file_size{0};
 
@@ -364,7 +377,7 @@ private:
 
     LogFileSettings log_file_settings;
 
-    const std::filesystem::path changelogs_dir;
+    DiskPtr disk;
 
     Poco::Logger * const log;
 };
@@ -394,10 +407,12 @@ struct ChangelogReadResult
 class ChangelogReader
 {
 public:
-    explicit ChangelogReader(const std::string & filepath_) : filepath(filepath_)
+    explicit ChangelogReader(DiskPtr disk_, const std::string & filepath_)
+        : disk(disk_)
+        , filepath(filepath_)
     {
         auto compression_method = chooseCompressionMethod(filepath, "");
-        auto read_buffer_from_file = std::make_unique<ReadBufferFromFile>(filepath);
+        auto read_buffer_from_file = disk->readFile(filepath);
         read_buf = wrapReadBufferWithCompressionMethod(std::move(read_buffer_from_file), compression_method);
     }
 
@@ -493,37 +508,35 @@ public:
     }
 
 private:
+    DiskPtr disk;
     std::string filepath;
     std::unique_ptr<ReadBuffer> read_buf;
 };
 
 Changelog::Changelog(
-    const std::string & changelogs_dir_,
+    DiskPtr disk_,
     Poco::Logger * log_,
     LogFileSettings log_file_settings)
-    : changelogs_dir(changelogs_dir_)
-    , changelogs_detached_dir(changelogs_dir / "detached")
+    : disk(disk_)
+    , changelogs_detached_dir("detached")
     , rotate_interval(log_file_settings.rotate_interval)
     , log(log_)
     , write_operations(std::numeric_limits<size_t>::max())
     , append_completion_queue(std::numeric_limits<size_t>::max())
 {
     /// Load all files in changelog directory
-    namespace fs = std::filesystem;
-    if (!fs::exists(changelogs_dir))
-        fs::create_directories(changelogs_dir);
 
-    for (const auto & p : fs::directory_iterator(changelogs_dir))
+    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
     {
-        if (p == changelogs_detached_dir)
+        if (it->name() == changelogs_detached_dir)
             continue;
 
-        auto file_description = getChangelogFileDescription(p.path());
+        auto file_description = getChangelogFileDescription(it->path());
         existing_changelogs[file_description->from_log_index] = std::move(file_description);
     }
 
     if (existing_changelogs.empty())
-        LOG_WARNING(log, "No logs exists in {}. It's Ok if it's the first run of clickhouse-keeper.", changelogs_dir.generic_string());
+        LOG_WARNING(log, "No logs exists in {}. It's Ok if it's the first run of clickhouse-keeper.", disk->getPath());
 
     clean_log_thread = ThreadFromGlobalPool([this] { cleanLogThread(); });
 
@@ -532,7 +545,7 @@ Changelog::Changelog(
     append_completion_thread = ThreadFromGlobalPool([this] { appendCompletionThread(); });
 
     current_writer = std::make_unique<ChangelogWriter>(
-        existing_changelogs, changelogs_dir, log_file_settings);
+        existing_changelogs, disk, log_file_settings);
 }
 
 void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uint64_t logs_to_keep)
@@ -604,7 +617,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
                 break;
             }
 
-            ChangelogReader reader(changelog_description.path);
+            ChangelogReader reader(disk, changelog_description.path);
             last_log_read_result = reader.readChangelog(logs, start_to_read_from, log);
             last_log_read_result->log_start_index = changelog_description.from_log_index;
 
@@ -671,7 +684,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
         if (last_log_read_result->last_read_index == 0 || last_log_read_result->error) /// If it's broken log then remove it
         {
             LOG_INFO(log, "Removing chagelog {} because it's empty or read finished with error", description->path);
-            std::filesystem::remove(description->path);
+            disk->removeFile(description->path);
             existing_changelogs.erase(last_log_read_result->log_start_index);
             std::erase_if(logs, [last_log_read_result](const auto & item) { return item.first >= last_log_read_result->log_start_index; });
         }
@@ -691,6 +704,9 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
 
 void Changelog::initWriter(ChangelogFileDescriptionPtr description)
 {
+    if (description->expectedEntriesCountInLog() != rotate_interval)
+        LOG_TRACE(log, "Looks like rotate_logs_interval was changed, current {}, expected entries in last log {}", rotate_interval, description->expectedEntriesCountInLog());
+
     LOG_TRACE(log, "Continue to write into {}", description->path);
     current_writer->setFile(std::move(description), WriteMode::Append);
 }
@@ -715,20 +731,20 @@ std::string getCurrentTimestampFolder()
 
 void Changelog::removeExistingLogs(ChangelogIter begin, ChangelogIter end)
 {
-    const auto timestamp_folder = changelogs_detached_dir / getCurrentTimestampFolder();
+    const auto timestamp_folder = (fs::path(changelogs_detached_dir) / getCurrentTimestampFolder()).generic_string();
 
     for (auto itr = begin; itr != end;)
     {
-        if (!std::filesystem::exists(timestamp_folder))
+        if (!disk->exists(timestamp_folder))
         {
-            LOG_WARNING(log, "Moving broken logs to {}", timestamp_folder.generic_string());
-            std::filesystem::create_directories(timestamp_folder);
+            LOG_WARNING(log, "Moving broken logs to {}", timestamp_folder);
+            disk->createDirectories(timestamp_folder);
         }
 
         LOG_WARNING(log, "Removing changelog {}", itr->second->path);
         const std::filesystem::path & path = itr->second->path;
         const auto new_path = timestamp_folder / path.filename();
-        std::filesystem::rename(path, new_path);
+        disk->moveFile(path.generic_string(), new_path.generic_string());
         itr = existing_changelogs.erase(itr);
     }
 }
@@ -885,7 +901,7 @@ void Changelog::writeAt(uint64_t index, const LogEntryPtr & log_entry)
             auto to_remove_itr = existing_changelogs.upper_bound(index);
             for (auto itr = to_remove_itr; itr != existing_changelogs.end();)
             {
-                std::filesystem::remove(itr->second->path);
+                disk->removeFile(itr->second->path);
                 itr = existing_changelogs.erase(itr);
             }
         }
@@ -937,12 +953,19 @@ void Changelog::compact(uint64_t up_to_log_index)
             /// If failed to push to queue for background removing, then we will remove it now
             if (!log_files_to_delete_queue.tryPush(changelog_description.path, 1))
             {
-                std::error_code ec;
-                std::filesystem::remove(changelog_description.path, ec);
-                if (ec)
-                    LOG_WARNING(log, "Failed to remove changelog {} in compaction, error message: {}", changelog_description.path, ec.message());
-                else
-                    LOG_INFO(log, "Removed changelog {} because of compaction", changelog_description.path);
+                try
+                {
+                    disk->removeFile(itr->second->path);
+                    LOG_INFO(log, "Removed changelog {} because of compaction.", itr->second->path);
+                }
+                catch (Exception & e)
+                {
+                    LOG_WARNING(log, "Failed to remove changelog {} in compaction, error message: {}", itr->second->path, e.message());
+                }
+                catch (...)
+                {
+                    tryLogCurrentException(log);
+                }
             }
 
             changelog_description.deleted = true;
@@ -1135,11 +1158,19 @@ void Changelog::cleanLogThread()
     std::string path;
     while (log_files_to_delete_queue.pop(path))
     {
-        std::error_code ec;
-        if (std::filesystem::remove(path, ec))
+        try
+        {
+            disk->removeFile(path);
             LOG_INFO(log, "Removed changelog {} because of compaction.", path);
-        else
-            LOG_WARNING(log, "Failed to remove changelog {} in compaction, error message: {}", path, ec.message());
+        }
+        catch (Exception & e)
+        {
+            LOG_WARNING(log, "Failed to remove changelog {} in compaction, error message: {}", path, e.message());
+        }
+        catch (...)
+        {
+            tryLogCurrentException(log);
+        }
     }
 }
 
diff --git a/src/Coordination/Changelog.h b/src/Coordination/Changelog.h
index 288f71bb915..052eba45858 100644
--- a/src/Coordination/Changelog.h
+++ b/src/Coordination/Changelog.h
@@ -86,7 +86,7 @@ class Changelog
 {
 public:
     Changelog(
-        const std::string & changelogs_dir_,
+        DiskPtr disk_,
         Poco::Logger * log_,
         LogFileSettings log_file_settings);
 
@@ -168,8 +168,8 @@ private:
     /// Clean useless log files in a background thread
     void cleanLogThread();
 
-    const std::filesystem::path changelogs_dir;
-    const std::filesystem::path changelogs_detached_dir;
+    DiskPtr disk;
+    const String changelogs_detached_dir;
     const uint64_t rotate_interval;
     Poco::Logger * log;
 
diff --git a/src/Coordination/KeeperLogStore.cpp b/src/Coordination/KeeperLogStore.cpp
index d1bd2f9db18..fcf9400a1d9 100644
--- a/src/Coordination/KeeperLogStore.cpp
+++ b/src/Coordination/KeeperLogStore.cpp
@@ -1,13 +1,13 @@
 #include <Coordination/KeeperLogStore.h>
 #include <IO/CompressionMethod.h>
+#include <Disks/DiskLocal.h>
 
 namespace DB
 {
 
-KeeperLogStore::KeeperLogStore(
-    const std::string & changelogs_path, LogFileSettings log_file_settings)
+KeeperLogStore::KeeperLogStore(DiskPtr disk_, LogFileSettings log_file_settings)
     : log(&Poco::Logger::get("KeeperLogStore"))
-    , changelog(changelogs_path, log, log_file_settings)
+    , changelog(disk_, log, log_file_settings)
 {
     if (log_file_settings.force_sync)
         LOG_INFO(log, "force_sync enabled");
@@ -15,6 +15,11 @@ KeeperLogStore::KeeperLogStore(
         LOG_INFO(log, "force_sync disabled");
 }
 
+KeeperLogStore::KeeperLogStore(const std::string & changelogs_path, LogFileSettings log_file_settings)
+    : KeeperLogStore(std::make_shared<DiskLocal>("Keeper-logs", changelogs_path, 0), log_file_settings)
+{
+}
+
 uint64_t KeeperLogStore::start_index() const
 {
     std::lock_guard lock(changelog_lock);
diff --git a/src/Coordination/KeeperLogStore.h b/src/Coordination/KeeperLogStore.h
index 108241e024e..c2428413753 100644
--- a/src/Coordination/KeeperLogStore.h
+++ b/src/Coordination/KeeperLogStore.h
@@ -14,6 +14,9 @@ namespace DB
 class KeeperLogStore : public nuraft::log_store
 {
 public:
+    KeeperLogStore(DiskPtr disk_, LogFileSettings log_file_settings);
+
+    /// For gtest
     KeeperLogStore(const std::string & changelogs_path, LogFileSettings log_file_settings);
 
     /// Read log storage from filesystem starting from last_commited_log_index
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index b823fbc697c..4de194fe9ae 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -25,6 +25,7 @@
 #include <Common/ZooKeeper/ZooKeeperIO.h>
 #include <Common/Stopwatch.h>
 #include <Common/getMultipleKeysFromConfig.h>
+#include <Disks/DiskLocal.h>
 
 namespace DB
 {
@@ -121,20 +122,36 @@ KeeperServer::KeeperServer(
     keeper_context->digest_enabled = config.getBool("keeper_server.digest_enabled", false);
     keeper_context->ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
 
+    if (!fs::exists(configuration_and_settings_->snapshot_storage_path))
+        fs::create_directories(configuration_and_settings_->snapshot_storage_path);
+    auto snapshots_disk = std::make_shared<DiskLocal>("Keeper-snapshots", configuration_and_settings_->snapshot_storage_path, 0);
+
     state_machine = nuraft::cs_new<KeeperStateMachine>(
         responses_queue_,
         snapshots_queue_,
-        configuration_and_settings_->snapshot_storage_path,
+        snapshots_disk,
         coordination_settings,
         keeper_context,
         config.getBool("keeper_server.upload_snapshot_on_exit", true) ? &snapshot_manager_s3 : nullptr,
         checkAndGetSuperdigest(configuration_and_settings_->super_digest));
 
+    auto state_path = fs::path(configuration_and_settings_->state_file_path).parent_path().generic_string();
+    auto state_file_name = fs::path(configuration_and_settings_->state_file_path).filename().generic_string();
+
+    if (!fs::exists(state_path))
+        fs::create_directories(state_path);
+    auto state_disk = std::make_shared<DiskLocal>("Keeper-state", state_path, 0);
+
+    if (!fs::exists(configuration_and_settings_->log_storage_path))
+        fs::create_directories(configuration_and_settings_->log_storage_path);
+    auto logs_disk = std::make_shared<DiskLocal>("Keeper-logs", configuration_and_settings_->log_storage_path, 0);
+
     state_manager = nuraft::cs_new<KeeperStateManager>(
         server_id,
         "keeper_server",
-        configuration_and_settings_->log_storage_path,
-        configuration_and_settings_->state_file_path,
+        logs_disk,
+        state_disk,
+        state_file_name,
         config,
         coordination_settings);
 }
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index a3f7dbc2c6a..3d308fbabda 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -16,6 +16,7 @@
 #include <Coordination/KeeperContext.h>
 #include <Coordination/KeeperConstants.h>
 #include <Common/ZooKeeper/ZooKeeperCommon.h>
+#include <Disks/DiskLocal.h>
 
 
 namespace DB
@@ -507,39 +508,45 @@ KeeperSnapshotManager::KeeperSnapshotManager(
     bool compress_snapshots_zstd_,
     const std::string & superdigest_,
     size_t storage_tick_time_)
-    : snapshots_path(snapshots_path_)
+    : KeeperSnapshotManager(
+        std::make_shared<DiskLocal>("Keeper-snapshots", snapshots_path_, 0),
+        snapshots_to_keep_,
+        keeper_context_,
+        compress_snapshots_zstd_,
+        superdigest_,
+        storage_tick_time_)
+{
+}
+
+KeeperSnapshotManager::KeeperSnapshotManager(
+    DiskPtr disk_,
+    size_t snapshots_to_keep_,
+    const KeeperContextPtr & keeper_context_,
+    bool compress_snapshots_zstd_,
+    const std::string & superdigest_,
+    size_t storage_tick_time_)
+    : disk(disk_)
     , snapshots_to_keep(snapshots_to_keep_)
     , compress_snapshots_zstd(compress_snapshots_zstd_)
     , superdigest(superdigest_)
     , storage_tick_time(storage_tick_time_)
     , keeper_context(keeper_context_)
 {
-    namespace fs = std::filesystem;
-
-    if (!fs::exists(snapshots_path))
-        fs::create_directories(snapshots_path);
-
-    for (const auto & p : fs::directory_iterator(snapshots_path))
+    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
     {
-        const auto & path = p.path();
-
-        if (!path.has_filename())
+        const auto & name = it->name();
+        if (name.empty())
             continue;
-
-        if (startsWith(path.filename(), "tmp_")) /// Unfinished tmp files
+        if (startsWith(name, "tmp_"))
         {
-            std::filesystem::remove(p);
+            disk->removeFile(it->path());
             continue;
         }
-
         /// Not snapshot file
-        if (!startsWith(path.filename(), "snapshot_"))
-        {
+        if (!startsWith(name, "snapshot_"))
             continue;
-        }
-
-        size_t snapshot_up_to = getSnapshotPathUpToLogIdx(p.path());
-        existing_snapshots[snapshot_up_to] = p.path();
+        size_t snapshot_up_to = getSnapshotPathUpToLogIdx(name);
+        existing_snapshots[snapshot_up_to] = it->path();
     }
 
     removeOutdatedSnapshotsIfNeeded();
@@ -552,19 +559,17 @@ std::string KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer
 
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
-    std::string tmp_snapshot_path = std::filesystem::path{snapshots_path} / tmp_snapshot_file_name;
-    std::string new_snapshot_path = std::filesystem::path{snapshots_path} / snapshot_file_name;
 
-    WriteBufferFromFile plain_buf(tmp_snapshot_path);
-    copyData(reader, plain_buf);
-    plain_buf.sync();
+    auto plain_buf = disk->writeFile(tmp_snapshot_file_name);
+    copyData(reader, *plain_buf);
+    plain_buf->sync();
 
-    std::filesystem::rename(tmp_snapshot_path, new_snapshot_path);
+    disk->moveFile(tmp_snapshot_file_name, snapshot_file_name);
 
-    existing_snapshots.emplace(up_to_log_idx, new_snapshot_path);
+    existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
     removeOutdatedSnapshotsIfNeeded();
 
-    return new_snapshot_path;
+    return snapshot_file_name;
 }
 
 nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBufferFromDisk()
@@ -578,7 +583,7 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBuff
         }
         catch (const DB::Exception &)
         {
-            std::filesystem::remove(latest_itr->second);
+            disk->removeFile(latest_itr->second);
             existing_snapshots.erase(latest_itr->first);
             tryLogCurrentException(__PRETTY_FUNCTION__);
         }
@@ -591,8 +596,8 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeSnapshotBufferFrom
 {
     const std::string & snapshot_path = existing_snapshots.at(up_to_log_idx);
     WriteBufferFromNuraftBuffer writer;
-    ReadBufferFromFile reader(snapshot_path);
-    copyData(reader, writer);
+    auto reader = disk->readFile(snapshot_path);
+    copyData(*reader, writer);
     return writer.getBuffer();
 }
 
@@ -664,7 +669,7 @@ void KeeperSnapshotManager::removeSnapshot(uint64_t log_idx)
     auto itr = existing_snapshots.find(log_idx);
     if (itr == existing_snapshots.end())
         throw Exception(ErrorCodes::UNKNOWN_SNAPSHOT, "Unknown snapshot with log index {}", log_idx);
-    std::filesystem::remove(itr->second);
+    disk->removeFile(itr->second);
     existing_snapshots.erase(itr);
 }
 
@@ -673,10 +678,8 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
     auto up_to_log_idx = snapshot.snapshot_meta->get_last_log_idx();
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
-    std::string tmp_snapshot_path = std::filesystem::path{snapshots_path} / tmp_snapshot_file_name;
-    std::string new_snapshot_path = std::filesystem::path{snapshots_path} / snapshot_file_name;
 
-    auto writer = std::make_unique<WriteBufferFromFile>(tmp_snapshot_path, O_WRONLY | O_TRUNC | O_CREAT | O_CLOEXEC | O_APPEND);
+    auto writer = disk->writeFile(tmp_snapshot_file_name);
     std::unique_ptr<WriteBuffer> compressed_writer;
     if (compress_snapshots_zstd)
         compressed_writer = wrapWriteBufferWithCompressionMethod(std::move(writer), CompressionMethod::Zstd, 3);
@@ -688,13 +691,21 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
     compressed_writer->sync();
 
     std::error_code ec;
-    std::filesystem::rename(tmp_snapshot_path, new_snapshot_path, ec);
-    if (!ec)
+
+    try
     {
-        existing_snapshots.emplace(up_to_log_idx, new_snapshot_path);
-        removeOutdatedSnapshotsIfNeeded();
+        disk->moveFile(tmp_snapshot_file_name, snapshot_file_name);
     }
-    return {new_snapshot_path, ec};
+    catch (fs::filesystem_error & e)
+    {
+        ec = e.code();
+        return {snapshot_file_name, ec};
+    }
+
+    existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
+    removeOutdatedSnapshotsIfNeeded();
+
+    return {snapshot_file_name, ec};
 }
 
 }
diff --git a/src/Coordination/KeeperSnapshotManager.h b/src/Coordination/KeeperSnapshotManager.h
index 52647712083..9babad9ed98 100644
--- a/src/Coordination/KeeperSnapshotManager.h
+++ b/src/Coordination/KeeperSnapshotManager.h
@@ -6,6 +6,7 @@
 #include <IO/WriteBuffer.h>
 #include <libnuraft/nuraft.hxx>
 #include <Coordination/KeeperContext.h>
+#include <Disks/IDisk.h>
 
 namespace DB
 {
@@ -97,6 +98,15 @@ using SnapshotMetaAndStorage = std::pair<SnapshotMetadataPtr, KeeperStoragePtr>;
 class KeeperSnapshotManager
 {
 public:
+    KeeperSnapshotManager(
+        DiskPtr disk_,
+        size_t snapshots_to_keep_,
+        const KeeperContextPtr & keeper_context_,
+        bool compress_snapshots_zstd_ = true,
+        const std::string & superdigest_ = "",
+        size_t storage_tick_time_ = 500);
+
+    /// For gtest
     KeeperSnapshotManager(
         const std::string & snapshots_path_,
         size_t snapshots_to_keep_,
@@ -144,9 +154,15 @@ public:
         if (!existing_snapshots.empty())
         {
             const auto & path = existing_snapshots.at(getLatestSnapshotIndex());
-            std::error_code ec;
-            if (std::filesystem::exists(path, ec))
-                return path;
+
+            try
+            {
+                if (disk->exists(path))
+                    return path;
+            }
+            catch (...)
+            {
+            }
         }
         return "";
     }
@@ -158,7 +174,7 @@ private:
     /// ZSTD codec.
     static bool isZstdCompressed(nuraft::ptr<nuraft::buffer> buffer);
 
-    const std::string snapshots_path;
+    DiskPtr disk;
     /// How many snapshots to keep before remove
     const size_t snapshots_to_keep;
     /// All existing snapshots in our path (log_index -> path)
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index e591f87c6f1..56b8c7e5f2e 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -41,14 +41,14 @@ namespace
 KeeperStateMachine::KeeperStateMachine(
     ResponsesQueue & responses_queue_,
     SnapshotsQueue & snapshots_queue_,
-    const std::string & snapshots_path_,
+    DiskPtr disk_,
     const CoordinationSettingsPtr & coordination_settings_,
     const KeeperContextPtr & keeper_context_,
     KeeperSnapshotManagerS3 * snapshot_manager_s3_,
     const std::string & superdigest_)
     : coordination_settings(coordination_settings_)
     , snapshot_manager(
-          snapshots_path_,
+          disk_,
           coordination_settings->snapshots_to_keep,
           keeper_context_,
           coordination_settings->compress_snapshots_with_zstd_format,
diff --git a/src/Coordination/KeeperStateMachine.h b/src/Coordination/KeeperStateMachine.h
index ffc7fce1cfe..ba209f63a0c 100644
--- a/src/Coordination/KeeperStateMachine.h
+++ b/src/Coordination/KeeperStateMachine.h
@@ -25,7 +25,7 @@ public:
     KeeperStateMachine(
         ResponsesQueue & responses_queue_,
         SnapshotsQueue & snapshots_queue_,
-        const std::string & snapshots_path_,
+        DiskPtr disk_,
         const CoordinationSettingsPtr & coordination_settings_,
         const KeeperContextPtr & keeper_context_,
         KeeperSnapshotManagerS3 * snapshot_manager_s3_,
diff --git a/src/Coordination/KeeperStateManager.cpp b/src/Coordination/KeeperStateManager.cpp
index cfb3519e597..36a88f5591f 100644
--- a/src/Coordination/KeeperStateManager.cpp
+++ b/src/Coordination/KeeperStateManager.cpp
@@ -7,6 +7,7 @@
 #include <Common/isLocalAddress.h>
 #include <IO/ReadHelpers.h>
 #include <Common/getMultipleKeysFromConfig.h>
+#include <Disks/DiskLocal.h>
 
 namespace DB
 {
@@ -214,8 +215,8 @@ KeeperStateManager::KeeperStateManager(
     int server_id_, const std::string & host, int port, const std::string & logs_path, const std::string & state_file_path)
     : my_server_id(server_id_)
     , secure(false)
-    , log_store(nuraft::cs_new<KeeperLogStore>(logs_path, LogFileSettings{.force_sync =false, .compress_logs = false, .rotate_interval = 5000}))
-    , server_state_path(state_file_path)
+    , log_store(nuraft::cs_new<KeeperLogStore>(std::make_shared<DiskLocal>("Keeper-logs", logs_path, 0), LogFileSettings{.force_sync =false, .compress_logs = false, .rotate_interval = 5000}))
+    , server_state_file_name(fs::path(state_file_path).filename().generic_string())
     , logger(&Poco::Logger::get("KeeperStateManager"))
 {
     auto peer_config = nuraft::cs_new<nuraft::srv_config>(my_server_id, host + ":" + std::to_string(port));
@@ -228,8 +229,9 @@ KeeperStateManager::KeeperStateManager(
 KeeperStateManager::KeeperStateManager(
     int my_server_id_,
     const std::string & config_prefix_,
-    const std::string & log_storage_path,
-    const std::string & state_file_path,
+    DiskPtr log_disk_,
+    DiskPtr state_disk_,
+    const std::string & server_state_file_name_,
     const Poco::Util::AbstractConfiguration & config,
     const CoordinationSettingsPtr & coordination_settings)
     : my_server_id(my_server_id_)
@@ -237,7 +239,7 @@ KeeperStateManager::KeeperStateManager(
     , config_prefix(config_prefix_)
     , configuration_wrapper(parseServersConfiguration(config, false))
     , log_store(nuraft::cs_new<KeeperLogStore>(
-          log_storage_path,
+          log_disk_,
           LogFileSettings
           {
             .force_sync = coordination_settings->force_sync,
@@ -246,7 +248,8 @@ KeeperStateManager::KeeperStateManager(
             .max_size = coordination_settings->max_log_file_size,
             .overallocate_size = coordination_settings->log_file_overallocate_size
           }))
-    , server_state_path(state_file_path)
+    , disk(state_disk_)
+    , server_state_file_name(server_state_file_name_)
     , logger(&Poco::Logger::get("KeeperStateManager"))
 {
 }
@@ -285,11 +288,11 @@ void KeeperStateManager::save_config(const nuraft::cluster_config & config)
     configuration_wrapper.cluster_config = nuraft::cluster_config::deserialize(*buf);
 }
 
-const std::filesystem::path & KeeperStateManager::getOldServerStatePath()
+const String & KeeperStateManager::getOldServerStatePath()
 {
     static auto old_path = [this]
     {
-        return server_state_path.parent_path() / (server_state_path.filename().generic_string() + "-OLD");
+        return server_state_file_name + "-OLD";
     }();
 
     return old_path;
@@ -310,25 +313,24 @@ void KeeperStateManager::save_state(const nuraft::srv_state & state)
 {
     const auto & old_path = getOldServerStatePath();
 
-    if (std::filesystem::exists(server_state_path))
-        std::filesystem::rename(server_state_path, old_path);
+    if (disk->exists(server_state_file_name))
+        disk->moveFile(server_state_file_name, old_path);
 
-    WriteBufferFromFile server_state_file(server_state_path, DBMS_DEFAULT_BUFFER_SIZE, O_TRUNC | O_CREAT | O_WRONLY);
+    auto server_state_file = disk->writeFile(server_state_file_name);
     auto buf = state.serialize();
 
     // calculate checksum
     SipHash hash;
     hash.update(current_server_state_version);
     hash.update(reinterpret_cast<const char *>(buf->data_begin()), buf->size());
-    writeIntBinary(hash.get64(), server_state_file);
+    writeIntBinary(hash.get64(), *server_state_file);
 
-    writeIntBinary(static_cast<uint8_t>(current_server_state_version), server_state_file);
+    writeIntBinary(static_cast<uint8_t>(current_server_state_version), *server_state_file);
 
-    server_state_file.write(reinterpret_cast<const char *>(buf->data_begin()), buf->size());
-    server_state_file.sync();
-    server_state_file.close();
+    server_state_file->write(reinterpret_cast<const char *>(buf->data_begin()), buf->size());
+    server_state_file->sync();
 
-    std::filesystem::remove(old_path);
+    disk->removeFileIfExists(old_path);
 }
 
 nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
@@ -339,22 +341,22 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
     {
         try
         {
-            ReadBufferFromFile read_buf(path);
-            auto content_size = read_buf.getFileSize();
+            auto read_buf = disk->readFile(path);
+            auto content_size = read_buf->getFileSize();
 
             if (content_size == 0)
                 return nullptr;
 
             uint64_t read_checksum{0};
-            readIntBinary(read_checksum, read_buf);
+            readIntBinary(read_checksum, *read_buf);
 
             uint8_t version;
-            readIntBinary(version, read_buf);
+            readIntBinary(version, *read_buf);
 
             auto buffer_size = content_size - sizeof read_checksum - sizeof version;
 
             auto state_buf = nuraft::buffer::alloc(buffer_size);
-            read_buf.readStrict(reinterpret_cast<char *>(state_buf->data_begin()), buffer_size);
+            read_buf->readStrict(reinterpret_cast<char *>(state_buf->data_begin()), buffer_size);
 
             SipHash hash;
             hash.update(version);
@@ -364,15 +366,15 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
             {
                 constexpr auto error_format = "Invalid checksum while reading state from {}. Got {}, expected {}";
 #ifdef NDEBUG
-                LOG_ERROR(logger, error_format, path.generic_string(), hash.get64(), read_checksum);
+                LOG_ERROR(logger, error_format, path, hash.get64(), read_checksum);
                 return nullptr;
 #else
-                throw Exception(ErrorCodes::CORRUPTED_DATA, error_format, path.generic_string(), hash.get64(), read_checksum);
+                throw Exception(ErrorCodes::CORRUPTED_DATA, error_format, disk->getPath() + path, hash.get64(), read_checksum);
 #endif
             }
 
             auto state = nuraft::srv_state::deserialize(*state_buf);
-            LOG_INFO(logger, "Read state from {}", path.generic_string());
+            LOG_INFO(logger, "Read state from {}", disk->getPath() + path);
             return state;
         }
         catch (const std::exception & e)
@@ -383,37 +385,34 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
                 throw;
             }
 
-            LOG_ERROR(logger, "Failed to deserialize state from {}", path.generic_string());
+            LOG_ERROR(logger, "Failed to deserialize state from {}", disk->getPath() + path);
             return nullptr;
         }
     };
 
-    if (std::filesystem::exists(server_state_path))
+    if (disk->exists(server_state_file_name))
     {
-        auto state = try_read_file(server_state_path);
+        auto state = try_read_file(server_state_file_name);
 
         if (state)
         {
-            if (std::filesystem::exists(old_path))
-                std::filesystem::remove(old_path);
+            disk->removeFileIfExists(old_path);
 
             return state;
         }
 
-        std::filesystem::remove(server_state_path);
+        disk->removeFile(server_state_file_name);
     }
 
-    if (std::filesystem::exists(old_path))
+    if (disk->exists(old_path))
     {
         auto state = try_read_file(old_path);
-
         if (state)
         {
-            std::filesystem::rename(old_path, server_state_path);
+            disk->moveFile(old_path, server_state_file_name);
             return state;
         }
-
-        std::filesystem::remove(old_path);
+        disk->removeFile(old_path);
     }
 
     LOG_WARNING(logger, "No state was read");
diff --git a/src/Coordination/KeeperStateManager.h b/src/Coordination/KeeperStateManager.h
index 5d210f8c0ea..d8369100d1c 100644
--- a/src/Coordination/KeeperStateManager.h
+++ b/src/Coordination/KeeperStateManager.h
@@ -39,7 +39,8 @@ public:
     KeeperStateManager(
         int server_id_,
         const std::string & config_prefix_,
-        const std::string & log_storage_path,
+        DiskPtr logs_disk_,
+        DiskPtr state_disk_,
         const std::string & state_file_path,
         const Poco::Util::AbstractConfiguration & config,
         const CoordinationSettingsPtr & coordination_settings);
@@ -111,7 +112,7 @@ public:
     ConfigUpdateActions getConfigurationDiff(const Poco::Util::AbstractConfiguration & config) const;
 
 private:
-    const std::filesystem::path & getOldServerStatePath();
+    const String & getOldServerStatePath();
 
     /// Wrapper struct for Keeper cluster config. We parse this
     /// info from XML files.
@@ -136,7 +137,8 @@ private:
 
     nuraft::ptr<KeeperLogStore> log_store;
 
-    const std::filesystem::path server_state_path;
+    DiskPtr disk;
+    const String server_state_file_name;
 
     Poco::Logger * logger;
 
diff --git a/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp b/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
index f8c4d0e2bac..d079a0d230d 100644
--- a/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
+++ b/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
@@ -11,7 +11,7 @@ namespace ErrorCodes
 }
 
 ZstdDeflatingAppendableWriteBuffer::ZstdDeflatingAppendableWriteBuffer(
-    std::unique_ptr<WriteBufferFromFile> out_,
+    std::unique_ptr<WriteBufferFromFileBase> out_,
     int compression_level,
     bool append_to_existing_file_,
     size_t buf_size,
diff --git a/src/IO/ZstdDeflatingAppendableWriteBuffer.h b/src/IO/ZstdDeflatingAppendableWriteBuffer.h
index a0715480737..b64e5d5c4cf 100644
--- a/src/IO/ZstdDeflatingAppendableWriteBuffer.h
+++ b/src/IO/ZstdDeflatingAppendableWriteBuffer.h
@@ -29,7 +29,7 @@ public:
     static inline constexpr ZSTDLastBlock ZSTD_CORRECT_TERMINATION_LAST_BLOCK = {0x01, 0x00, 0x00};
 
     ZstdDeflatingAppendableWriteBuffer(
-        std::unique_ptr<WriteBufferFromFile> out_,
+        std::unique_ptr<WriteBufferFromFileBase> out_,
         int compression_level,
         bool append_to_existing_file_,
         size_t buf_size = DBMS_DEFAULT_BUFFER_SIZE,
@@ -68,7 +68,7 @@ private:
     /// Adding zstd empty block (ZSTD_CORRECT_TERMINATION_LAST_BLOCK) to out.working_buffer
     void addEmptyBlock();
 
-    std::unique_ptr<WriteBufferFromFile> out;
+    std::unique_ptr<WriteBufferFromFileBase> out;
 
     bool append_to_existing_file = false;
     ZSTD_CCtx * cctx;

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 0004/1478] 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 0005/1478] 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 0006/1478] 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 0007/1478] 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 0008/1478] 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 0009/1478] 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 0010/1478] 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 0011/1478] 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 0012/1478] 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 0013/1478] 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 0014/1478] 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 0015/1478] 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 0016/1478] 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 0017/1478] 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 0018/1478] 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 0019/1478] 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 0020/1478] 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 0021/1478] 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 0022/1478] 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 0023/1478] 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 0024/1478] 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 0025/1478] 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 0026/1478] 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 0027/1478] 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 0028/1478] 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 0029/1478] 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 0030/1478] 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 0031/1478] 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 0032/1478] 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 0033/1478] 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 0034/1478] 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 0035/1478] 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 0036/1478] 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 0037/1478] 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 0038/1478] 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 0039/1478] 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 0040/1478] 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 0041/1478] 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 0042/1478] 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 0043/1478] 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 0044/1478] 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 0045/1478] 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 0046/1478] 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 0047/1478] 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 0048/1478] 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 0049/1478] 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 0050/1478] 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 0051/1478] 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 0052/1478] 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 0053/1478] 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 65d23af611f28fbe0f2baf1dac6cd1aa317676b5 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Mon, 24 Apr 2023 19:35:49 +0000
Subject: [PATCH 0054/1478] Refactor PreparedSets [1]

---
 src/Interpreters/PreparedSets.cpp | 101 +++++++++++--------
 src/Interpreters/PreparedSets.h   | 157 ++++++++++++++++++++++++++----
 2 files changed, 200 insertions(+), 58 deletions(-)

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 7b0efddae87..11af41cae8f 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -5,6 +5,8 @@
 #include <Interpreters/InterpreterSelectWithUnionQuery.h>
 #include <Interpreters/Set.h>
 #include <IO/Operators.h>
+#include "Common/logger_useful.h"
+#include "Processors/QueryPlan/CreatingSetsStep.h"
 
 namespace DB
 {
@@ -66,30 +68,30 @@ String PreparedSetKey::toString() const
     return buf.str();
 }
 
-SubqueryForSet & PreparedSets::createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
-                                                   SizeLimits set_size_limit, bool transform_null_in)
-{
-    SubqueryForSet & subquery = subqueries[subquery_id];
+// SubqueryForSet & PreparedSets::createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
+//                                                    SizeLimits set_size_limit, bool transform_null_in)
+// {
+//     SubqueryForSet & subquery = subqueries[subquery_id];
 
-    /// If you already created a Set with the same subquery / table for another ast
-    /// In that case several PreparedSetKey would share same subquery and set
-    /// Not sure if it's really possible case (maybe for distributed query when set was filled by external table?)
-    if (subquery.set.isValid())
-        sets[key] = subquery.set;
-    else
-    {
-        subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
-        sets[key] = FutureSet(subquery.promise_to_fill_set.get_future());
-    }
+//     /// If you already created a Set with the same subquery / table for another ast
+//     /// In that case several PreparedSetKey would share same subquery and set
+//     /// Not sure if it's really possible case (maybe for distributed query when set was filled by external table?)
+//     if (subquery.set.isValid())
+//         sets[key] = subquery.set;
+//     else
+//     {
+//         subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
+//         sets[key] = FutureSet(subquery.promise_to_fill_set.get_future());
+//     }
 
-    if (!subquery.set_in_progress)
-    {
-        subquery.key = key.toString();
-        subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
-    }
+//     if (!subquery.set_in_progress)
+//     {
+//         subquery.key = key.toString();
+//         subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
+//     }
 
-    return subquery;
-}
+//     return subquery;
+// }
 
 /// If the subquery is not associated with any set, create default-constructed SubqueryForSet.
 /// It's aimed to fill external table passed to SubqueryForSet::createSource.
@@ -154,26 +156,6 @@ QueryPlanPtr SubqueryForSet::detachSource()
 }
 
 
-FutureSet::FutureSet(SetPtr set)
-{
-    std::promise<SetPtr> promise;
-    promise.set_value(set);
-    *this = FutureSet(promise.get_future());
-}
-
-
-bool FutureSet::isReady() const
-{
-    return future_set.valid() &&
-        future_set.wait_for(std::chrono::seconds(0)) == std::future_status::ready;
-}
-
-bool FutureSet::isCreated() const
-{
-    return isReady() && get() != nullptr && get()->isCreated();
-}
-
-
 std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseToBuild(const String & key)
 {
     std::lock_guard lock(cache_mutex);
@@ -194,4 +176,41 @@ std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseTo
     return promise_to_fill_set;
 }
 
+std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context, bool create_ordered_set)
+{
+    if (set)
+        return nullptr;
+
+    auto set_cache = context->getPreparedSetsCache();
+    if (set_cache)
+    {
+        auto from_cache = set_cache->findOrPromiseToBuild(subquery.key);
+        if (from_cache.index() == 0)
+        {
+            subquery.promise_to_fill_set = std::move(std::get<0>(from_cache));
+        }
+        else
+        {
+            LOG_TRACE(&Poco::Logger::get("FutureSetFromSubquery"), "Waiting for set, key: {}", subquery.key);
+            set = std::get<1>(from_cache).get();
+            return nullptr;
+        }
+    }
+
+    subquery.set = set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+
+    auto plan = subquery.detachSource();
+
+    const Settings & settings = context->getSettingsRef();
+    auto creating_set = std::make_unique<CreatingSetStep>(
+            plan->getCurrentDataStream(),
+            subquery_id,
+            std::move(subquery),
+            SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
+            context);
+    creating_set->setStepDescription("Create set for subquery");
+    plan->addStep(std::move(creating_set));
+    return plan;
+}
+
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 4a7d1c3de46..a4898fe5ec6 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -10,6 +10,14 @@
 #include <Storages/IStorage_fwd.h>
 #include <QueryPipeline/SizeLimits.h>
 #include <Processors/QueryPlan/QueryPlan.h>
+#include "Core/Block.h"
+#include "Interpreters/Context.h"
+#include "Interpreters/Set.h"
+#include "Processors/Executors/CompletedPipelineExecutor.h"
+#include "Processors/QueryPlan/BuildQueryPipelineSettings.h"
+#include "Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h"
+#include "Processors/Sinks/NullSink.h"
+#include <QueryPipeline/QueryPipelineBuilder.h>
 
 namespace DB
 {
@@ -25,30 +33,83 @@ class InterpreterSelectWithUnionQuery;
 /// At analysis stage the FutureSets are created but not necessarily filled. Then for non-constant sets there
 /// must be an explicit step to build them before they can be used.
 /// FutureSet objects can be stored in PreparedSets and are not intended to be used from multiple threads.
-class FutureSet final
+// class FutureSet final
+// {
+// public:
+//     FutureSet() = default;
+
+//     /// Create FutureSet from an object that will be created in the future.
+//     explicit FutureSet(const std::shared_future<SetPtr> & future_set_) : future_set(future_set_) {}
+
+//     /// Create FutureSet from a ready set.
+//     explicit FutureSet(SetPtr readySet);
+
+//     /// The set object will be ready in the future, as opposed to 'null' object  when FutureSet is default constructed.
+//     bool isValid() const { return future_set.valid(); }
+
+//     /// The the value of SetPtr is ready, but the set object might not have been filled yet.
+//     bool isReady() const;
+
+//     /// The set object is ready and filled.
+//     bool isCreated() const;
+
+//     SetPtr get() const { chassert(isReady()); return future_set.get(); }
+
+// private:
+//     std::shared_future<SetPtr> future_set;
+// };
+
+class FutureSet
 {
 public:
-    FutureSet() = default;
+    virtual ~FutureSet() = default;
 
-    /// Create FutureSet from an object that will be created in the future.
-    explicit FutureSet(const std::shared_future<SetPtr> & future_set_) : future_set(future_set_) {}
+    virtual bool isReady() const = 0;
+    virtual SetPtr get() const = 0;
 
-    /// Create FutureSet from a ready set.
-    explicit FutureSet(SetPtr readySet);
+    virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
+    virtual std::unique_ptr<QueryPlan> build(const ContextPtr & context) = 0;
+};
 
-    /// The set object will be ready in the future, as opposed to 'null' object  when FutureSet is default constructed.
-    bool isValid() const { return future_set.valid(); }
+using FutureSetPtr = std::unique_ptr<FutureSet>;
 
-    /// The the value of SetPtr is ready, but the set object might not have been filled yet.
-    bool isReady() const;
+class FutureSetFromTuple final : public FutureSet
+{
+public:
+    FutureSetFromTuple(Block block_, const SizeLimits & size_limits_, bool transform_null_in_);
 
-    /// The set object is ready and filled.
-    bool isCreated() const;
+    bool isReady() const override { return set != nullptr; }
+    SetPtr get() const override { return set; }
 
-    SetPtr get() const { chassert(isReady()); return future_set.get(); }
+    SetPtr buildOrderedSetInplace(const ContextPtr &) override
+    {
+        fill(true);
+        return set;
+    }
+
+    std::unique_ptr<QueryPlan> build(const ContextPtr &) override
+    {
+        fill(false);
+        return nullptr;
+    }
 
 private:
-    std::shared_future<SetPtr> future_set;
+    Block block;
+    SizeLimits size_limits;
+    bool transform_null_in;
+
+    SetPtr set;
+
+    void fill(bool create_ordered_set)
+    {
+        if (set)
+            return;
+
+        set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+        set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
+        set->insertFromBlock(block.getColumnsWithTypeAndName());
+        set->finishInsert();
+    }
 };
 
 /// Information on how to build set for the [GLOBAL] IN section.
@@ -66,11 +127,12 @@ public:
 
     /// Build this set from the result of the subquery.
     String key;
-    SetPtr set_in_progress;
+    SetPtr set;
     /// After set_in_progress is finished it will be put into promise_to_fill_set and thus all FutureSet's
     /// that are referencing this set will be filled.
+
     std::promise<SetPtr> promise_to_fill_set;
-    FutureSet set = FutureSet{promise_to_fill_set.get_future()};
+    // FutureSet set = FutureSet{promise_to_fill_set.get_future()};
 
     /// If set, put the result into the table.
     /// This is a temporary table for transferring to remote servers for distributed query processing.
@@ -80,6 +142,67 @@ public:
     std::unique_ptr<QueryPlan> source;
 };
 
+class FutureSetFromSubquery : public FutureSet
+{
+public:
+    FutureSetFromSubquery(SubqueryForSet subquery_, String subquery_id, SizeLimits set_size_limit_, bool transform_null_in_);
+
+    bool isReady() const override { return set != nullptr; }
+    SetPtr get() const override { return set; }
+
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override
+    {
+        auto plan = buildPlan(context, true);
+
+        auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
+        auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
+        pipeline.complete(std::make_shared<NullSink>(Block()));
+
+        CompletedPipelineExecutor executor(pipeline);
+        executor.execute();
+
+        return set;
+    }
+
+    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
+    {
+        return buildPlan(context, false);
+    }
+
+private:
+    SetPtr set;
+    SubqueryForSet subquery;
+    String subquery_id;
+    SizeLimits size_limits;
+    bool transform_null_in;
+
+    std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
+};
+
+// class FutureSetFromFuture : public FutureSet
+// {
+// public:
+//     FutureSetFromFuture(std::shared_future<SetPtr> future_set_);
+
+//     bool isReady() const override { return future_set.wait_for(std::chrono::seconds(0)) == std::future_status::ready; }
+//     SetPtr get() const override { return future_set.get(); }
+
+//     SetPtr buildOrderedSetInplace(const ContextPtr &) override
+//     {
+//         fill(true);
+//         return set;
+//     }
+
+//     std::unique_ptr<QueryPlan> build(const ContextPtr &) override
+//     {
+//         fill(false);
+//         return nullptr;
+//     }
+
+// private:
+//     std::shared_future<SetPtr> future_set;
+// }
+
 struct PreparedSetKey
 {
     /// Prepared sets for tuple literals are indexed by the hash of the tree contents and by the desired
@@ -132,7 +255,7 @@ private:
     std::unordered_map<PreparedSetKey, FutureSet, PreparedSetKey::Hash> sets;
 
     /// This is the information required for building sets
-    SubqueriesForSets subqueries;
+    // SubqueriesForSets subqueries;
 };
 
 using PreparedSetsPtr = std::shared_ptr<PreparedSets>;

From 80a2f30a0cc651db608735391d5173452f7b41ff Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 25 Apr 2023 18:14:08 +0000
Subject: [PATCH 0055/1478] Refactor PreparedSets [2]

---
 src/Columns/ColumnSet.h                    |   4 +-
 src/Interpreters/ActionsVisitor.cpp        |  56 +++---
 src/Interpreters/ActionsVisitor.h          |   7 +-
 src/Interpreters/ExpressionAnalyzer.cpp    | 188 ++++++++++-----------
 src/Interpreters/ExpressionAnalyzer.h      |   4 +-
 src/Interpreters/GlobalSubqueriesVisitor.h |  24 +--
 src/Interpreters/PreparedSets.cpp          | 110 +++++++++---
 src/Interpreters/PreparedSets.h            |  75 +++++---
 src/Planner/PlannerContext.h               |  20 +--
 9 files changed, 283 insertions(+), 205 deletions(-)

diff --git a/src/Columns/ColumnSet.h b/src/Columns/ColumnSet.h
index 3f5cf4ad280..ccd9aa19896 100644
--- a/src/Columns/ColumnSet.h
+++ b/src/Columns/ColumnSet.h
@@ -21,7 +21,7 @@ class ColumnSet final : public COWHelper<IColumnDummy, ColumnSet>
 private:
     friend class COWHelper<IColumnDummy, ColumnSet>;
 
-    ColumnSet(size_t s_, FutureSet data_) : data(std::move(data_)) { s = s_; }
+    ColumnSet(size_t s_, FutureSetPtr data_) : data(std::move(data_)) { s = s_; }
     ColumnSet(const ColumnSet &) = default;
 
 public:
@@ -35,7 +35,7 @@ public:
     Field operator[](size_t) const override { return {}; }
 
 private:
-    FutureSet data;
+    FutureSetPtr data;
 };
 
 }
diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 3bb3ea67e29..00feecb44f5 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -422,9 +422,8 @@ Block createBlockForSet(
 }
 
 
-SetPtr makeExplicitSet(
-    const ASTFunction * node, const ActionsDAG & actions, bool create_ordered_set,
-    ContextPtr context, const SizeLimits & size_limits, PreparedSets & prepared_sets)
+FutureSetPtr makeExplicitSet(
+    const ASTFunction * node, const ActionsDAG & actions, ContextPtr context, PreparedSets & prepared_sets)
 {
     const IAST & args = *node->arguments;
 
@@ -448,7 +447,7 @@ SetPtr makeExplicitSet(
             element_type = low_cardinality_type->getDictionaryType();
 
     auto set_key = PreparedSetKey::forLiteral(*right_arg, set_element_types);
-    if (auto set = prepared_sets.get(set_key))
+    if (auto set = prepared_sets.getFuture(set_key))
         return set; /// Already prepared.
 
     Block block;
@@ -458,14 +457,7 @@ SetPtr makeExplicitSet(
     else
         block = createBlockForSet(left_arg_type, right_arg, set_element_types, context);
 
-    SetPtr set
-        = std::make_shared<Set>(size_limits, create_ordered_set, context->getSettingsRef().transform_null_in);
-    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
-    set->insertFromBlock(block.getColumnsWithTypeAndName());
-    set->finishInsert();
-
-    prepared_sets.set(set_key, set);
-    return set;
+    return prepared_sets.addFromTuple(set_key, block);
 }
 
 class ScopeStack::Index
@@ -952,7 +944,7 @@ void ActionsMatcher::visit(const ASTFunction & node, const ASTPtr & ast, Data &
         return;
     }
 
-    FutureSet prepared_set;
+    FutureSetPtr prepared_set;
     if (checkFunctionIsInOrGlobalInOperator(node))
     {
         /// Let's find the type of the first argument (then getActionsImpl will be called again and will not affect anything).
@@ -961,7 +953,7 @@ void ActionsMatcher::visit(const ASTFunction & node, const ASTPtr & ast, Data &
         if (!data.no_makeset && !(data.is_create_parameterized_view && !analyzeReceiveQueryParams(ast).empty()))
             prepared_set = makeSet(node, data, data.no_subqueries);
 
-        if (prepared_set.isValid())
+        if (prepared_set)
         {
             /// Transform tuple or subquery into a set.
         }
@@ -1174,14 +1166,14 @@ void ActionsMatcher::visit(const ASTFunction & node, const ASTPtr & ast, Data &
                 num_arguments += columns.size() - 1;
                 arg += columns.size() - 1;
             }
-            else if (checkFunctionIsInOrGlobalInOperator(node) && arg == 1 && prepared_set.isValid())
+            else if (checkFunctionIsInOrGlobalInOperator(node) && arg == 1 && prepared_set)
             {
                 ColumnWithTypeAndName column;
                 column.type = std::make_shared<DataTypeSet>();
 
                 /// If the argument is a set given by an enumeration of values (so, the set was already built), give it a unique name,
                 ///  so that sets with the same literal representation do not fuse together (they can have different types).
-                const bool is_constant_set = prepared_set.isCreated();
+                const bool is_constant_set = typeid_cast<const FutureSetFromSubquery *>(prepared_set.get()) == nullptr;
                 if (is_constant_set)
                     column.name = data.getUniqueName("__set");
                 else
@@ -1373,7 +1365,7 @@ void ActionsMatcher::visit(const ASTLiteral & literal, const ASTPtr & /* ast */,
     data.addColumn(std::move(column));
 }
 
-FutureSet ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no_subqueries)
+FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no_subqueries)
 {
     if (!data.prepared_sets)
         return {};
@@ -1394,11 +1386,8 @@ FutureSet ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no
             return {};
         auto set_key = PreparedSetKey::forSubquery(*right_in_operand);
 
-        {
-            auto set = data.prepared_sets->getFuture(set_key);
-            if (set.isValid())
-                return set;
-        }
+        if (auto set = data.prepared_sets->getFuture(set_key))
+            return set;
 
         /// A special case is if the name of the table is specified on the right side of the IN statement,
         ///  and the table has the type Set (a previously prepared set).
@@ -1409,20 +1398,16 @@ FutureSet ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no
 
             if (table)
             {
-                StorageSet * storage_set = dynamic_cast<StorageSet *>(table.get());
-                if (storage_set)
-                {
-                    SetPtr set = storage_set->getSet();
-                    data.prepared_sets->set(set_key, set);
-                    return FutureSet(set);
-                }
+                if (StorageSet * storage_set = dynamic_cast<StorageSet *>(table.get()))
+                    return data.prepared_sets->addFromStorage(set_key, storage_set->getSet());
             }
         }
 
         /// We get the stream of blocks for the subquery. Create Set and put it in place of the subquery.
-        String set_id = right_in_operand->getColumnName();
-        bool transform_null_in =  data.getContext()->getSettingsRef().transform_null_in;
-        SubqueryForSet & subquery_for_set = data.prepared_sets->createOrGetSubquery(set_id, set_key, data.set_size_limit, transform_null_in);
+        // String set_id = right_in_operand->getColumnName();
+        //bool transform_null_in =  data.getContext()->getSettingsRef().transform_null_in;
+        SubqueryForSet subquery_for_set; // = data.prepared_sets->createOrGetSubquery(set_id, set_key, data.set_size_limit, transform_null_in);
+        subquery_for_set.key = right_in_operand->getColumnName();
 
         /** The following happens for GLOBAL INs or INs:
           * - in the addExternalStorage function, the IN (SELECT ...) subquery is replaced with IN _data1,
@@ -1432,13 +1417,13 @@ FutureSet ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no
           * In case that we have HAVING with IN subquery, we have to force creating set for it.
           * Also it doesn't make sense if it is GLOBAL IN or ordinary IN.
           */
-        if (data.create_source_for_in && !subquery_for_set.hasSource())
+        if (data.create_source_for_in)
         {
             auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
             subquery_for_set.createSource(*interpreter);
         }
 
-        return subquery_for_set.set;
+        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set));
     }
     else
     {
@@ -1446,8 +1431,7 @@ FutureSet ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool no
         const auto & index = data.actions_stack.getLastActionsIndex();
         if (data.prepared_sets && index.contains(left_in_operand->getColumnName()))
             /// An explicit enumeration of values in parentheses.
-            return FutureSet(
-                makeExplicitSet(&node, last_actions, false, data.getContext(), data.set_size_limit, *data.prepared_sets));
+            return makeExplicitSet(&node, last_actions, data.getContext(), *data.prepared_sets);
         else
             return {};
     }
diff --git a/src/Interpreters/ActionsVisitor.h b/src/Interpreters/ActionsVisitor.h
index 260fd5ab2c0..71d57620196 100644
--- a/src/Interpreters/ActionsVisitor.h
+++ b/src/Interpreters/ActionsVisitor.h
@@ -25,9 +25,8 @@ class IFunctionOverloadResolver;
 using FunctionOverloadResolverPtr = std::shared_ptr<IFunctionOverloadResolver>;
 
 /// The case of an explicit enumeration of values.
-SetPtr makeExplicitSet(
-    const ASTFunction * node, const ActionsDAG & actions, bool create_ordered_set,
-    ContextPtr context, const SizeLimits & limits, PreparedSets & prepared_sets);
+FutureSetPtr makeExplicitSet(
+    const ASTFunction * node, const ActionsDAG & actions, ContextPtr context, PreparedSets & prepared_sets);
 
 /** For ActionsVisitor
   * A stack of ExpressionActions corresponding to nested lambda expressions.
@@ -219,7 +218,7 @@ private:
     static void visit(const ASTLiteral & literal, const ASTPtr & ast, Data & data);
     static void visit(ASTExpressionList & expression_list, const ASTPtr & ast, Data & data);
 
-    static FutureSet makeSet(const ASTFunction & node, Data & data, bool no_subqueries);
+    static FutureSetPtr makeSet(const ASTFunction & node, Data & data, bool no_subqueries);
     static ASTs doUntuple(const ASTFunction * function, ActionsMatcher::Data & data);
     static std::optional<NameAndTypePair> getNameAndTypeFromAST(const ASTPtr & ast, Data & data);
 };
diff --git a/src/Interpreters/ExpressionAnalyzer.cpp b/src/Interpreters/ExpressionAnalyzer.cpp
index cc54e7620f6..7dece81734c 100644
--- a/src/Interpreters/ExpressionAnalyzer.cpp
+++ b/src/Interpreters/ExpressionAnalyzer.cpp
@@ -450,76 +450,76 @@ void ExpressionAnalyzer::initGlobalSubqueriesAndExternalTables(bool do_global, b
 }
 
 
-void ExpressionAnalyzer::tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options)
-{
-    if (!prepared_sets)
-        return;
+// void ExpressionAnalyzer::tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options)
+// {
+//     if (!prepared_sets)
+//         return;
 
-    auto set_key = PreparedSetKey::forSubquery(*subquery_or_table_name);
+//     auto set_key = PreparedSetKey::forSubquery(*subquery_or_table_name);
 
-    if (prepared_sets->getFuture(set_key).isValid())
-        return; /// Already prepared.
+//     if (prepared_sets->getFuture(set_key).isValid())
+//         return; /// Already prepared.
 
-    if (auto set_ptr_from_storage_set = isPlainStorageSetInSubquery(subquery_or_table_name))
-    {
-        prepared_sets->set(set_key, set_ptr_from_storage_set);
-        return;
-    }
+//     if (auto set_ptr_from_storage_set = isPlainStorageSetInSubquery(subquery_or_table_name))
+//     {
+//         prepared_sets->set(set_key, set_ptr_from_storage_set);
+//         return;
+//     }
 
-    auto build_set = [&] () -> SetPtr
-    {
-        LOG_TRACE(getLogger(), "Building set, key: {}", set_key.toString());
+//     auto build_set = [&] () -> SetPtr
+//     {
+//         LOG_TRACE(getLogger(), "Building set, key: {}", set_key.toString());
 
-        auto interpreter_subquery = interpretSubquery(subquery_or_table_name, getContext(), {}, query_options);
-        auto io = interpreter_subquery->execute();
-        PullingAsyncPipelineExecutor executor(io.pipeline);
+//         auto interpreter_subquery = interpretSubquery(subquery_or_table_name, getContext(), {}, query_options);
+//         auto io = interpreter_subquery->execute();
+//         PullingAsyncPipelineExecutor executor(io.pipeline);
 
-        SetPtr set = std::make_shared<Set>(settings.size_limits_for_set_used_with_index, true, getContext()->getSettingsRef().transform_null_in);
-        set->setHeader(executor.getHeader().getColumnsWithTypeAndName());
+//         SetPtr set = std::make_shared<Set>(settings.size_limits_for_set_used_with_index, true, getContext()->getSettingsRef().transform_null_in);
+//         set->setHeader(executor.getHeader().getColumnsWithTypeAndName());
 
-        Block block;
-        while (executor.pull(block))
-        {
-            if (block.rows() == 0)
-                continue;
+//         Block block;
+//         while (executor.pull(block))
+//         {
+//             if (block.rows() == 0)
+//                 continue;
 
-            /// If the limits have been exceeded, give up and let the default subquery processing actions take place.
-            if (!set->insertFromBlock(block.getColumnsWithTypeAndName()))
-                return nullptr;
-        }
+//             /// If the limits have been exceeded, give up and let the default subquery processing actions take place.
+//             if (!set->insertFromBlock(block.getColumnsWithTypeAndName()))
+//                 return nullptr;
+//         }
 
-        set->finishInsert();
+//         set->finishInsert();
 
-        return set;
-    };
+//         return set;
+//     };
 
-    SetPtr set;
+//     SetPtr set;
 
-    auto set_cache = getContext()->getPreparedSetsCache();
-    if (set_cache)
-    {
-        auto from_cache = set_cache->findOrPromiseToBuild(set_key.toString());
-        if (from_cache.index() == 0)
-        {
-            set = build_set();
-            std::get<0>(from_cache).set_value(set);
-        }
-        else
-        {
-            LOG_TRACE(getLogger(), "Waiting for set, key: {}", set_key.toString());
-            set = std::get<1>(from_cache).get();
-        }
-    }
-    else
-    {
-        set = build_set();
-    }
+//     auto set_cache = getContext()->getPreparedSetsCache();
+//     if (set_cache)
+//     {
+//         auto from_cache = set_cache->findOrPromiseToBuild(set_key.toString());
+//         if (from_cache.index() == 0)
+//         {
+//             set = build_set();
+//             std::get<0>(from_cache).set_value(set);
+//         }
+//         else
+//         {
+//             LOG_TRACE(getLogger(), "Waiting for set, key: {}", set_key.toString());
+//             set = std::get<1>(from_cache).get();
+//         }
+//     }
+//     else
+//     {
+//         set = build_set();
+//     }
 
-    if (!set)
-        return;
+//     if (!set)
+//         return;
 
-    prepared_sets->set(set_key, std::move(set));
-}
+//     prepared_sets->set(set_key, std::move(set));
+// }
 
 SetPtr ExpressionAnalyzer::isPlainStorageSetInSubquery(const ASTPtr & subquery_or_table_name)
 {
@@ -536,50 +536,50 @@ SetPtr ExpressionAnalyzer::isPlainStorageSetInSubquery(const ASTPtr & subquery_o
 
 
 /// Performance optimization for IN() if storage supports it.
-void SelectQueryExpressionAnalyzer::makeSetsForIndex(const ASTPtr & node)
-{
-    if (!node || !storage() || !storage()->supportsIndexForIn())
-        return;
+// void SelectQueryExpressionAnalyzer::makeSetsForIndex(const ASTPtr & node)
+// {
+//     if (!node || !storage() || !storage()->supportsIndexForIn())
+//         return;
 
-    for (auto & child : node->children)
-    {
-        /// Don't descend into subqueries.
-        if (child->as<ASTSubquery>())
-            continue;
+//     for (auto & child : node->children)
+//     {
+//         /// Don't descend into subqueries.
+//         if (child->as<ASTSubquery>())
+//             continue;
 
-        /// Don't descend into lambda functions
-        const auto * func = child->as<ASTFunction>();
-        if (func && func->name == "lambda")
-            continue;
+//         /// Don't descend into lambda functions
+//         const auto * func = child->as<ASTFunction>();
+//         if (func && func->name == "lambda")
+//             continue;
 
-        makeSetsForIndex(child);
-    }
+//         makeSetsForIndex(child);
+//     }
 
-    const auto * func = node->as<ASTFunction>();
-    if (func && functionIsInOrGlobalInOperator(func->name))
-    {
-        const IAST & args = *func->arguments;
-        const ASTPtr & left_in_operand = args.children.at(0);
+//     const auto * func = node->as<ASTFunction>();
+//     if (func && functionIsInOrGlobalInOperator(func->name))
+//     {
+//         const IAST & args = *func->arguments;
+//         const ASTPtr & left_in_operand = args.children.at(0);
 
-        if (storage()->mayBenefitFromIndexForIn(left_in_operand, getContext(), metadata_snapshot))
-        {
-            const ASTPtr & arg = args.children.at(1);
-            if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
-            {
-                if (settings.use_index_for_in_with_subqueries)
-                    tryMakeSetForIndexFromSubquery(arg, query_options);
-            }
-            else
-            {
-                auto temp_actions = std::make_shared<ActionsDAG>(columns_after_join);
-                getRootActions(left_in_operand, true, temp_actions);
+//         if (storage()->mayBenefitFromIndexForIn(left_in_operand, getContext(), metadata_snapshot))
+//         {
+//             const ASTPtr & arg = args.children.at(1);
+//             if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
+//             {
+//                 if (settings.use_index_for_in_with_subqueries)
+//                     tryMakeSetForIndexFromSubquery(arg, query_options);
+//             }
+//             else
+//             {
+//                 auto temp_actions = std::make_shared<ActionsDAG>(columns_after_join);
+//                 getRootActions(left_in_operand, true, temp_actions);
 
-                if (prepared_sets && temp_actions->tryFindInOutputs(left_in_operand->getColumnName()))
-                    makeExplicitSet(func, *temp_actions, true, getContext(), settings.size_limits_for_set, *prepared_sets);
-            }
-        }
-    }
-}
+//                 if (prepared_sets && temp_actions->tryFindInOutputs(left_in_operand->getColumnName()))
+//                     makeExplicitSet(func, *temp_actions, true, getContext(), settings.size_limits_for_set, *prepared_sets);
+//             }
+//         }
+//     }
+// }
 
 
 void ExpressionAnalyzer::getRootActions(const ASTPtr & ast, bool no_makeset_for_subqueries, ActionsDAGPtr & actions, bool only_consts)
diff --git a/src/Interpreters/ExpressionAnalyzer.h b/src/Interpreters/ExpressionAnalyzer.h
index 1b6e8e24091..e4926b80625 100644
--- a/src/Interpreters/ExpressionAnalyzer.h
+++ b/src/Interpreters/ExpressionAnalyzer.h
@@ -144,7 +144,7 @@ public:
     /** Create Set from a subquery or a table expression in the query. The created set is suitable for using the index.
       * The set will not be created if its size hits the limit.
       */
-    void tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options = {});
+    // void tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options = {});
 
     /** Checks if subquery is not a plain StorageSet.
       * Because while making set we will read data from StorageSet which is not allowed.
@@ -364,7 +364,7 @@ public:
     ActionsDAGPtr appendProjectResult(ExpressionActionsChain & chain) const;
 
     /// Create Set-s that we make from IN section to use index on them.
-    void makeSetsForIndex(const ASTPtr & node);
+    // void makeSetsForIndex(const ASTPtr & node);
 
 private:
     StorageMetadataPtr metadata_snapshot;
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index b105cae31c6..9fb2c02bd58 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -167,19 +167,21 @@ public:
             {
                 /// Do not materialize external tables if it's explain statement.
             }
-            else if (getContext()->getSettingsRef().use_index_for_in_with_subqueries)
-            {
-                auto external_table = external_storage_holder->getTable();
-                auto table_out = external_table->write({}, external_table->getInMemoryMetadataPtr(), getContext());
-                auto io = interpreter->execute();
-                io.pipeline.complete(std::move(table_out));
-                CompletedPipelineExecutor executor(io.pipeline);
-                executor.execute();
-            }
+            // else if (getContext()->getSettingsRef().use_index_for_in_with_subqueries)
+            // {
+            //     auto external_table = external_storage_holder->getTable();
+            //     auto table_out = external_table->write({}, external_table->getInMemoryMetadataPtr(), getContext());
+            //     auto io = interpreter->execute();
+            //     io.pipeline.complete(std::move(table_out));
+            //     CompletedPipelineExecutor executor(io.pipeline);
+            //     executor.execute();
+            // }
             else
             {
-                auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
-                subquery_for_set.createSource(*interpreter, external_storage);
+                // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
+                // subquery_for_set.createSource(*interpreter, external_storage);
+                auto key = subquery_or_table_name->getColumnName();
+                prepared_sets->addStorageToSubquery(key, std::move(external_storage));
             }
 
             /** NOTE If it was written IN tmp_table - the existing temporary (but not external) table,
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 11af41cae8f..300ef2aadb6 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -95,11 +95,51 @@ String PreparedSetKey::toString() const
 
 /// If the subquery is not associated with any set, create default-constructed SubqueryForSet.
 /// It's aimed to fill external table passed to SubqueryForSet::createSource.
-SubqueryForSet & PreparedSets::getSubquery(const String & subquery_id) { return subqueries[subquery_id]; }
+void PreparedSets::addStorageToSubquery(const String & subquery_id, StoragePtr storage)
+{
+    auto it = subqueries.find(subquery_id);
+    if (it == subqueries.end())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot find subquery {}", subquery_id);
 
-void PreparedSets::set(const PreparedSetKey & key, SetPtr set_) { sets[key] = FutureSet(set_); }
+    it->second->addStorage(std::move(storage));
+}
 
-FutureSet PreparedSets::getFuture(const PreparedSetKey & key) const
+FutureSetPtr PreparedSets::addFromStorage(const PreparedSetKey & key, SetPtr set_)
+{
+    auto from_storage = std::make_shared<FutureSetFromStorage>(std::move(set_));
+    auto [it, inserted] = sets.emplace(key, std::move(from_storage));
+
+    if (!inserted)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+
+    return it->second;
+}
+
+FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block)
+{
+    auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block));
+    auto [it, inserted] = sets.emplace(key, std::move(from_tuple));
+
+    if (!inserted)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+
+    return it->second;
+}
+
+FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery)
+{
+    auto id = subquery.key;
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery));
+    auto [it, inserted] = sets.emplace(key, from_subquery);
+
+    if (!inserted)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+
+    subqueries.emplace(id, std::move(from_subquery));
+    return it->second;
+}
+
+FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 {
     auto it = sets.find(key);
     if (it == sets.end())
@@ -107,24 +147,24 @@ FutureSet PreparedSets::getFuture(const PreparedSetKey & key) const
     return it->second;
 }
 
-SetPtr PreparedSets::get(const PreparedSetKey & key) const
-{
-    auto it = sets.find(key);
-    if (it == sets.end() || !it->second.isReady())
-        return nullptr;
-    return it->second.get();
-}
+// SetPtr PreparedSets::get(const PreparedSetKey & key) const
+// {
+//     auto it = sets.find(key);
+//     if (it == sets.end() || !it->second.isReady())
+//         return nullptr;
+//     return it->second.get();
+// }
 
-std::vector<FutureSet> PreparedSets::getByTreeHash(IAST::Hash ast_hash) const
-{
-    std::vector<FutureSet> res;
-    for (const auto & it : this->sets)
-    {
-        if (it.first.ast_hash == ast_hash)
-            res.push_back(it.second);
-    }
-    return res;
-}
+// std::vector<FutureSet> PreparedSets::getByTreeHash(IAST::Hash ast_hash) const
+// {
+//     std::vector<FutureSet> res;
+//     for (const auto & it : this->sets)
+//     {
+//         if (it.first.ast_hash == ast_hash)
+//             res.push_back(it.second);
+//     }
+//     return res;
+// }
 
 PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries()
 {
@@ -197,14 +237,18 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
         }
     }
 
-    subquery.set = set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+
+    const auto & settings = context->getSettingsRef();
+    auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
+
+    subquery.set = set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
 
     auto plan = subquery.detachSource();
+    auto description = subquery.key;
 
-    const Settings & settings = context->getSettingsRef();
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
-            subquery_id,
+            description,
             std::move(subquery),
             SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
             context);
@@ -213,4 +257,24 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     return plan;
 }
 
+
+static SizeLimits getSizeLimitsForUnorderedSet(const Settings & settings)
+{
+    return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
+}
+
+static SizeLimits getSizeLimitsForOrderedSet(const Settings & settings)
+{
+    if (settings.use_index_for_in_with_subqueries_max_values &&
+        settings.use_index_for_in_with_subqueries_max_values < settings.max_rows_in_set)
+        return getSizeLimitsForUnorderedSet(settings);
+
+    return SizeLimits(settings.use_index_for_in_with_subqueries_max_values, settings.max_bytes_in_set, OverflowMode::BREAK);
+}
+
+SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordered_set)
+{
+    return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
+}
+
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index a4898fe5ec6..8ebabc32b0a 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -69,43 +69,46 @@ public:
 
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
     virtual std::unique_ptr<QueryPlan> build(const ContextPtr & context) = 0;
+
+    static SizeLimits getSizeLimitsForSet(const Settings & settings, bool ordered_set);
 };
 
-using FutureSetPtr = std::unique_ptr<FutureSet>;
+using FutureSetPtr = std::shared_ptr<FutureSet>;
 
 class FutureSetFromTuple final : public FutureSet
 {
 public:
-    FutureSetFromTuple(Block block_, const SizeLimits & size_limits_, bool transform_null_in_);
+    FutureSetFromTuple(Block block_);
 
     bool isReady() const override { return set != nullptr; }
     SetPtr get() const override { return set; }
 
-    SetPtr buildOrderedSetInplace(const ContextPtr &) override
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override
     {
-        fill(true);
+        fill(context, true);
         return set;
     }
 
-    std::unique_ptr<QueryPlan> build(const ContextPtr &) override
+    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
     {
-        fill(false);
+        fill(context, false);
         return nullptr;
     }
 
 private:
     Block block;
-    SizeLimits size_limits;
-    bool transform_null_in;
 
     SetPtr set;
 
-    void fill(bool create_ordered_set)
+    void fill(const ContextPtr & context, bool create_ordered_set)
     {
         if (set)
             return;
 
-        set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+        const auto & settings = context->getSettingsRef();
+        auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
+
+        set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
         set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
         set->insertFromBlock(block.getColumnsWithTypeAndName());
         set->finishInsert();
@@ -145,13 +148,16 @@ public:
 class FutureSetFromSubquery : public FutureSet
 {
 public:
-    FutureSetFromSubquery(SubqueryForSet subquery_, String subquery_id, SizeLimits set_size_limit_, bool transform_null_in_);
+    FutureSetFromSubquery(SubqueryForSet subquery_);
 
     bool isReady() const override { return set != nullptr; }
     SetPtr get() const override { return set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override
     {
+        if (!context->getSettingsRef().use_index_for_in_with_subqueries)
+            return nullptr;
+
         auto plan = buildPlan(context, true);
 
         auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
@@ -169,16 +175,34 @@ public:
         return buildPlan(context, false);
     }
 
+    void addStorage(StoragePtr storage) { subquery.table = std::move(storage); }
+
 private:
     SetPtr set;
     SubqueryForSet subquery;
-    String subquery_id;
-    SizeLimits size_limits;
-    bool transform_null_in;
 
     std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
 };
 
+class FutureSetFromStorage : public FutureSet
+{
+public:
+    FutureSetFromStorage(SetPtr set_); // : set(std::move(set_) {}
+
+    bool isReady() const override { return set != nullptr; }
+    SetPtr get() const override { return set; }
+
+    SetPtr buildOrderedSetInplace(const ContextPtr &) override
+    {
+        return set->hasExplicitSetElements() ? set : nullptr;
+    }
+
+    std::unique_ptr<QueryPlan> build(const ContextPtr &) override { return nullptr; }
+
+private:
+    SetPtr set;
+};
+
 // class FutureSetFromFuture : public FutureSet
 // {
 // public:
@@ -230,15 +254,20 @@ struct PreparedSetKey
 class PreparedSets
 {
 public:
-    using SubqueriesForSets = std::unordered_map<String, SubqueryForSet>;
+    using SubqueriesForSets = std::unordered_map<String, std::shared_ptr<FutureSetFromSubquery>>;
 
-    SubqueryForSet & createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
-                                         SizeLimits set_size_limit, bool transform_null_in);
-    SubqueryForSet & getSubquery(const String & subquery_id);
+    // SubqueryForSet & createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
+    //                                      SizeLimits set_size_limit, bool transform_null_in);
 
-    void set(const PreparedSetKey & key, SetPtr set_);
-    FutureSet getFuture(const PreparedSetKey & key) const;
-    SetPtr get(const PreparedSetKey & key) const;
+    FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
+    FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block);
+    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery);
+
+    void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
+
+    FutureSetPtr getFuture(const PreparedSetKey & key) const;
+    //SubqueryForSet & getSubquery(const String & subquery_id);
+    // SetPtr get(const PreparedSetKey & key) const;
 
     /// Get subqueries and clear them.
     /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
@@ -252,10 +281,10 @@ public:
     bool empty() const;
 
 private:
-    std::unordered_map<PreparedSetKey, FutureSet, PreparedSetKey::Hash> sets;
+    std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hash> sets;
 
     /// This is the information required for building sets
-    // SubqueriesForSets subqueries;
+    SubqueriesForSets subqueries;
 };
 
 using PreparedSetsPtr = std::shared_ptr<PreparedSets>;
diff --git a/src/Planner/PlannerContext.h b/src/Planner/PlannerContext.h
index ccc4ab43638..9ecfdb6117a 100644
--- a/src/Planner/PlannerContext.h
+++ b/src/Planner/PlannerContext.h
@@ -57,18 +57,18 @@ class PlannerSet
 {
 public:
     /// Construct planner set that is ready for execution
-    explicit PlannerSet(FutureSet set_)
+    explicit PlannerSet(FutureSetPtr set_)
         : set(std::move(set_))
     {}
 
     /// Construct planner set with set and subquery node
     explicit PlannerSet(QueryTreeNodePtr subquery_node_)
-        : set(promise_to_build_set.get_future())
-        , subquery_node(std::move(subquery_node_))
+        //: set(promise_to_build_set.get_future())
+        : subquery_node(std::move(subquery_node_))
     {}
 
     /// Get a reference to a set that might be not built yet
-    const FutureSet & getSet() const
+    const FutureSetPtr & getSet() const
     {
         return set;
     }
@@ -80,14 +80,14 @@ public:
     }
 
     /// This promise will be fulfilled when set is built and all FutureSet objects will become ready
-    std::promise<SetPtr> extractPromiseToBuildSet()
-    {
-        return std::move(promise_to_build_set);
-    }
+    // std::promise<SetPtr> extractPromiseToBuildSet()
+    // {
+    //     return std::move(promise_to_build_set);
+    // }
 
 private:
-    std::promise<SetPtr> promise_to_build_set;
-    FutureSet set;
+    //std::promise<SetPtr> promise_to_build_set;
+    FutureSetPtr set;
 
     QueryTreeNodePtr subquery_node;
 };

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 0056/1478] 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 0057/1478] 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 0058/1478] 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 0059/1478] 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 0060/1478] 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 0061/1478] 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 0062/1478] 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 0063/1478] 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 0064/1478] 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 0065/1478] 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 0066/1478] 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 0067/1478] 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 0068/1478] 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 0069/1478] 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 0070/1478] 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 0071/1478] 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 0072/1478] 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 0073/1478] 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 0074/1478] 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 0075/1478] 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 0076/1478] retriger checks


From f598a39ea261161cefa363f21112ddb49c7300a5 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 4 May 2023 17:54:08 +0000
Subject: [PATCH 0077/1478] Refactor PreparedSets [3]

---
 src/Analyzer/Passes/QueryAnalysisPass.cpp     |  18 ++-
 src/Analyzer/SetUtils.cpp                     |  24 ++--
 src/Analyzer/SetUtils.h                       |   3 +-
 src/Columns/ColumnSet.h                       |   2 +-
 src/DataTypes/DataTypeSet.h                   |   2 +-
 src/Functions/in.cpp                          |  21 +++-
 src/Interpreters/ActionsVisitor.cpp           |   4 +-
 src/Interpreters/ExpressionActions.cpp        |   2 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |  14 ++-
 src/Interpreters/InterpreterSelectQuery.cpp   |  11 +-
 src/Interpreters/PreparedSets.cpp             |  22 ++--
 src/Interpreters/PreparedSets.h               |  42 ++++---
 src/Planner/CollectSets.cpp                   |  61 ++++++++--
 src/Planner/CollectSets.h                     |   4 +-
 src/Planner/Planner.cpp                       |  90 ++++++++-------
 src/Planner/PlannerActionsVisitor.cpp         |  35 ++++--
 src/Planner/PlannerContext.cpp                |  72 ++++++------
 src/Planner/PlannerContext.h                  | 107 +++++++++---------
 src/Planner/PlannerJoinTree.cpp               |  21 ++--
 src/Planner/Utils.cpp                         |   3 +-
 src/Planner/Utils.h                           |   1 +
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  72 +++++++++---
 src/Processors/QueryPlan/CreatingSetsStep.h   |  19 +++-
 .../QueryPlan/Optimizations/Optimizations.h   |   1 +
 .../Optimizations/addPlansForSets.cpp         |  35 ++++++
 .../QueryPlan/Optimizations/optimizeTree.cpp  |   1 +
 src/Processors/QueryPlan/QueryPlan.cpp        |   5 +
 src/Processors/QueryPlan/QueryPlan.h          |   5 +-
 .../Transforms/CreatingSetsTransform.cpp      |  24 ++--
 src/Storages/KVStorageUtils.cpp               |  13 ++-
 src/Storages/MergeTree/KeyCondition.cpp       |  20 +++-
 .../MergeTreeIndexConditionBloomFilter.cpp    |   8 +-
 .../MergeTree/MergeTreeIndexFullText.cpp      |   9 +-
 .../MergeTree/MergeTreeIndexInverted.cpp      |   9 +-
 src/Storages/MergeTree/RPNBuilder.cpp         |  42 ++++---
 src/Storages/MergeTree/RPNBuilder.h           |   6 +-
 .../System/StorageSystemZooKeeper.cpp         |  11 +-
 src/Storages/VirtualColumnUtils.cpp           |  38 +++----
 38 files changed, 585 insertions(+), 292 deletions(-)
 create mode 100644 src/Processors/QueryPlan/Optimizations/addPlansForSets.cpp

diff --git a/src/Analyzer/Passes/QueryAnalysisPass.cpp b/src/Analyzer/Passes/QueryAnalysisPass.cpp
index 8afb9078fae..78e8b1760cb 100644
--- a/src/Analyzer/Passes/QueryAnalysisPass.cpp
+++ b/src/Analyzer/Passes/QueryAnalysisPass.cpp
@@ -5117,14 +5117,26 @@ ProjectionNames QueryAnalyzer::resolveFunction(QueryTreeNodePtr & node, Identifi
             const auto & second_argument_constant_literal = second_argument_constant_node->getValue();
             const auto & second_argument_constant_type = second_argument_constant_node->getResultType();
 
-            auto set = makeSetForConstantValue(first_argument_constant_type,
+            const auto & settings = scope.context->getSettingsRef();
+
+            auto result_block = makeSetForConstantValue(first_argument_constant_type,
                 second_argument_constant_literal,
                 second_argument_constant_type,
-                scope.context->getSettingsRef());
+                settings.transform_null_in);
+
+            SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
+
+            auto set = std::make_shared<Set>(size_limits_for_set, true /*fill_set_elements*/, settings.transform_null_in);
+
+            set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
+            set->insertFromBlock(result_block.getColumnsWithTypeAndName());
+            set->finishInsert();
+
+            auto future_set = std::make_shared<FutureSetFromStorage>(std::move(set));
 
             /// Create constant set column for constant folding
 
-            auto column_set = ColumnSet::create(1, FutureSet(std::move(set)));
+            auto column_set = ColumnSet::create(1, std::move(future_set));
             argument_columns[1].column = ColumnConst::create(std::move(column_set), 1);
         }
 
diff --git a/src/Analyzer/SetUtils.cpp b/src/Analyzer/SetUtils.cpp
index 0fb075e925b..2fb05449714 100644
--- a/src/Analyzer/SetUtils.cpp
+++ b/src/Analyzer/SetUtils.cpp
@@ -118,7 +118,7 @@ Block createBlockFromCollection(const Collection & collection, const DataTypes &
 
 }
 
-SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, const Settings & settings)
+Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in)
 {
     DataTypes set_element_types = {expression_type};
     const auto * lhs_tuple_type = typeid_cast<const DataTypeTuple *>(expression_type.get());
@@ -135,8 +135,8 @@ SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field
     size_t lhs_type_depth = getCompoundTypeDepth(*expression_type);
     size_t rhs_type_depth = getCompoundTypeDepth(*value_type);
 
-    SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
-    bool tranform_null_in = settings.transform_null_in;
+    // SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
+    // bool transform_null_in = settings.transform_null_in;
 
     Block result_block;
 
@@ -145,7 +145,7 @@ SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field
         /// 1 in 1; (1, 2) in (1, 2); identity(tuple(tuple(tuple(1)))) in tuple(tuple(tuple(1))); etc.
 
         Array array{value};
-        result_block = createBlockFromCollection(array, set_element_types, tranform_null_in);
+        result_block = createBlockFromCollection(array, set_element_types, transform_null_in);
     }
     else if (lhs_type_depth + 1 == rhs_type_depth)
     {
@@ -154,9 +154,9 @@ SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field
         WhichDataType rhs_which_type(value_type);
 
         if (rhs_which_type.isArray())
-            result_block = createBlockFromCollection(value.get<const Array &>(), set_element_types, tranform_null_in);
+            result_block = createBlockFromCollection(value.get<const Array &>(), set_element_types, transform_null_in);
         else if (rhs_which_type.isTuple())
-            result_block = createBlockFromCollection(value.get<const Tuple &>(), set_element_types, tranform_null_in);
+            result_block = createBlockFromCollection(value.get<const Tuple &>(), set_element_types, transform_null_in);
         else
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
                 "Unsupported type at the right-side of IN. Expected Array or Tuple. Actual {}",
@@ -170,13 +170,15 @@ SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field
             value_type->getName());
     }
 
-    auto set = std::make_shared<Set>(size_limits_for_set, true /*fill_set_elements*/, tranform_null_in);
+    return result_block;
 
-    set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
-    set->insertFromBlock(result_block.getColumnsWithTypeAndName());
-    set->finishInsert();
+    // auto set = std::make_shared<Set>(size_limits_for_set, true /*fill_set_elements*/, tranform_null_in);
 
-    return set;
+    // set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
+    // set->insertFromBlock(result_block.getColumnsWithTypeAndName());
+    // set->finishInsert();
+
+    // return set;
 }
 
 }
diff --git a/src/Analyzer/SetUtils.h b/src/Analyzer/SetUtils.h
index 7afc8e5259c..fdeaa4a3c48 100644
--- a/src/Analyzer/SetUtils.h
+++ b/src/Analyzer/SetUtils.h
@@ -21,10 +21,9 @@ using SetPtr = std::shared_ptr<Set>;
   * @param expression_type - type of first argument of function IN.
   * @param value - constant value of second argument of function IN.
   * @param value_type - type of second argument of function IN.
-  * @param settings - query settings.
   *
   * @return SetPtr for constant value.
   */
-SetPtr makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, const Settings & settings);
+Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in);
 
 }
diff --git a/src/Columns/ColumnSet.h b/src/Columns/ColumnSet.h
index ccd9aa19896..935a72e551a 100644
--- a/src/Columns/ColumnSet.h
+++ b/src/Columns/ColumnSet.h
@@ -29,7 +29,7 @@ public:
     TypeIndex getDataType() const override { return TypeIndex::Set; }
     MutableColumnPtr cloneDummy(size_t s_) const override { return ColumnSet::create(s_, data); }
 
-    ConstSetPtr getData() const { if (!data.isReady()) return nullptr; return data.get(); }
+    FutureSetPtr getData() const { return data; }
 
     // Used only for debugging, making it DUMPABLE
     Field operator[](size_t) const override { return {}; }
diff --git a/src/DataTypes/DataTypeSet.h b/src/DataTypes/DataTypeSet.h
index 7ddfeb9fe30..7ef0d931279 100644
--- a/src/DataTypes/DataTypeSet.h
+++ b/src/DataTypes/DataTypeSet.h
@@ -20,7 +20,7 @@ public:
     bool isParametric() const override { return true; }
 
     // Used for expressions analysis.
-    MutableColumnPtr createColumn() const override { return ColumnSet::create(0, FutureSet{}); }
+    MutableColumnPtr createColumn() const override { return ColumnSet::create(0, nullptr); }
 
     // Used only for debugging, making it DUMPABLE
     Field getDefault() const override { return Tuple(); }
diff --git a/src/Functions/in.cpp b/src/Functions/in.cpp
index 7a41ae2e3ea..eb623951bf3 100644
--- a/src/Functions/in.cpp
+++ b/src/Functions/in.cpp
@@ -55,9 +55,13 @@ public:
     /// It is needed to perform type analysis without creation of set.
     static constexpr auto name = FunctionInName<negative, global, null_is_skipped, ignore_set>::name;
 
-    static FunctionPtr create(ContextPtr)
+    FunctionIn(SizeLimits size_limits_, bool transform_null_in_)
+        : size_limits(std::move(size_limits_)), transform_null_in(transform_null_in_) {}
+
+    static FunctionPtr create(ContextPtr context)
     {
-        return std::make_shared<FunctionIn>();
+        const auto & settings = context->getSettingsRef();
+        return std::make_shared<FunctionIn>(FutureSet::getSizeLimitsForSet(settings, false), settings.transform_null_in);
     }
 
     String getName() const override
@@ -122,10 +126,15 @@ public:
             tuple = typeid_cast<const ColumnTuple *>(materialized_tuple.get());
         }
 
-        auto set = column_set->getData();
-        if (!set)
+        auto future_set = column_set->getData();
+        if (!future_set || !future_set->isFilled())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Not-ready Set passed as the second argument for function '{}'", getName());
 
+        if (auto * for_tuple = typeid_cast<FutureSetFromTuple *>(future_set.get()))
+            if (!for_tuple->isReady())
+                for_tuple->buildForTuple(size_limits, transform_null_in);
+
+        auto set = future_set->get();
         auto set_types = set->getDataTypes();
 
         if (tuple && set_types.size() != 1 && set_types.size() == tuple->tupleSize())
@@ -173,6 +182,10 @@ public:
 
         return res;
     }
+
+private:
+    SizeLimits size_limits;
+    bool transform_null_in;
 };
 
 template<bool ignore_set>
diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 00feecb44f5..18e44ab9f2f 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -446,7 +446,7 @@ FutureSetPtr makeExplicitSet(
         if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
             element_type = low_cardinality_type->getDictionaryType();
 
-    auto set_key = PreparedSetKey::forLiteral(*right_arg, set_element_types);
+    auto set_key = PreparedSetKey::forLiteral(right_arg->getTreeHash(), set_element_types);
     if (auto set = prepared_sets.getFuture(set_key))
         return set; /// Already prepared.
 
@@ -1384,7 +1384,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
     {
         if (no_subqueries)
             return {};
-        auto set_key = PreparedSetKey::forSubquery(*right_in_operand);
+        auto set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
 
         if (auto set = data.prepared_sets->getFuture(set_key))
             return set;
diff --git a/src/Interpreters/ExpressionActions.cpp b/src/Interpreters/ExpressionActions.cpp
index 36725f36804..989fa12cba0 100644
--- a/src/Interpreters/ExpressionActions.cpp
+++ b/src/Interpreters/ExpressionActions.cpp
@@ -941,7 +941,7 @@ bool ExpressionActions::checkColumnIsAlwaysFalse(const String & column_name) con
                 if (const auto * column_set = checkAndGetColumn<const ColumnSet>(action.node->column.get()))
                 {
                     auto set = column_set->getData();
-                    if (set && set->isCreated() && set->getTotalRowCount() == 0)
+                    if (set && set->isReady() && set->get()->getTotalRowCount() == 0)
                         return true;
                 }
             }
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 9fb2c02bd58..3a846bb4bc3 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -181,7 +181,19 @@ public:
                 // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
                 // subquery_for_set.createSource(*interpreter, external_storage);
                 auto key = subquery_or_table_name->getColumnName();
-                prepared_sets->addStorageToSubquery(key, std::move(external_storage));
+                auto set_key = PreparedSetKey::forSubquery(subquery_or_table_name->getTreeHash());
+
+                if (!prepared_sets->getFuture(set_key))
+                {
+                    SubqueryForSet subquery_for_set;
+                    subquery_for_set.key = std::move(key);
+                    subquery_for_set.table = std::move(external_storage);
+                    subquery_for_set.createSource(*interpreter);
+
+                    prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set));
+                }
+                else
+                    prepared_sets->addStorageToSubquery(key, std::move(external_storage));
             }
 
             /** NOTE If it was written IN tmp_table - the existing temporary (but not external) table,
diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index afd34cb044e..2487381e2fb 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -905,8 +905,8 @@ Block InterpreterSelectQuery::getSampleBlockImpl()
 
     if (storage && !options.only_analyze)
     {
-        query_analyzer->makeSetsForIndex(select_query.where());
-        query_analyzer->makeSetsForIndex(select_query.prewhere());
+        // query_analyzer->makeSetsForIndex(select_query.where());
+        // query_analyzer->makeSetsForIndex(select_query.prewhere());
         query_info.prepared_sets = query_analyzer->getPreparedSets();
 
         from_stage = storage->getQueryProcessingStage(context, options.to_stage, storage_snapshot, query_info);
@@ -3088,7 +3088,12 @@ void InterpreterSelectQuery::executeExtremes(QueryPlan & query_plan)
 
 void InterpreterSelectQuery::executeSubqueriesInSetsAndJoins(QueryPlan & query_plan)
 {
-    addCreatingSetsStep(query_plan, prepared_sets, context);
+    auto step = std::make_unique<DelayedCreatingSetsStep>(
+            query_plan.getCurrentDataStream(),
+            prepared_sets->detachSubqueries(context),
+            context);
+
+    query_plan.addStep(std::move(step));
 }
 
 
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 300ef2aadb6..733eb1c24bb 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -11,7 +11,7 @@
 namespace DB
 {
 
-PreparedSetKey PreparedSetKey::forLiteral(const IAST & ast, DataTypes types_)
+PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
 {
     /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
     ///   just converts LowCardinality to ordinary types.
@@ -19,15 +19,15 @@ PreparedSetKey PreparedSetKey::forLiteral(const IAST & ast, DataTypes types_)
         type = recursiveRemoveLowCardinality(type);
 
     PreparedSetKey key;
-    key.ast_hash = ast.getTreeHash();
+    key.ast_hash = hash;
     key.types = std::move(types_);
     return key;
 }
 
-PreparedSetKey PreparedSetKey::forSubquery(const IAST & ast)
+PreparedSetKey PreparedSetKey::forSubquery(Hash hash)
 {
     PreparedSetKey key;
-    key.ast_hash = ast.getTreeHash();
+    key.ast_hash = hash;
     return key;
 }
 
@@ -155,9 +155,9 @@ FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 //     return it->second.get();
 // }
 
-// std::vector<FutureSet> PreparedSets::getByTreeHash(IAST::Hash ast_hash) const
+// std::vector<FutureSetPtr> PreparedSets::getByTreeHash(IAST::Hash ast_hash) const
 // {
-//     std::vector<FutureSet> res;
+//     std::vector<FutureSetPtr> res;
 //     for (const auto & it : this->sets)
 //     {
 //         if (it.first.ast_hash == ast_hash)
@@ -166,7 +166,7 @@ FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 //     return res;
 // }
 
-PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries()
+PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries(const ContextPtr &)
 {
     auto res = std::move(subqueries);
     subqueries = SubqueriesForSets();
@@ -221,6 +221,8 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     if (set)
         return nullptr;
 
+    std::cerr << StackTrace().toString() << std::endl;
+
     auto set_cache = context->getPreparedSetsCache();
     if (set_cache)
     {
@@ -277,4 +279,10 @@ SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordere
     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
 }
 
+FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) {}
+
+FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquery(std::move(subquery_)) {}
+
+FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
+
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 8ebabc32b0a..8661d81a96a 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -65,6 +65,7 @@ public:
     virtual ~FutureSet() = default;
 
     virtual bool isReady() const = 0;
+    virtual bool isFilled() const = 0;
     virtual SetPtr get() const = 0;
 
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
@@ -81,34 +82,41 @@ public:
     FutureSetFromTuple(Block block_);
 
     bool isReady() const override { return set != nullptr; }
+    bool isFilled() const override { return true; }
     SetPtr get() const override { return set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override
     {
-        fill(context, true);
+        const auto & settings = context->getSettingsRef();
+        auto size_limits = getSizeLimitsForSet(settings, true);
+        fill(size_limits, settings.transform_null_in, true);
         return set;
     }
 
     std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
     {
-        fill(context, false);
+        const auto & settings = context->getSettingsRef();
+        auto size_limits = getSizeLimitsForSet(settings, false);
+        fill(size_limits, settings.transform_null_in, false);
         return nullptr;
     }
 
+    void buildForTuple(SizeLimits size_limits, bool transform_null_in)
+    {
+        fill(size_limits, transform_null_in, false);
+    }
+
 private:
     Block block;
 
     SetPtr set;
 
-    void fill(const ContextPtr & context, bool create_ordered_set)
+    void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
     {
         if (set)
             return;
 
-        const auto & settings = context->getSettingsRef();
-        auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
-
-        set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
+        set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
         set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
         set->insertFromBlock(block.getColumnsWithTypeAndName());
         set->finishInsert();
@@ -151,6 +159,7 @@ public:
     FutureSetFromSubquery(SubqueryForSet subquery_);
 
     bool isReady() const override { return set != nullptr; }
+    bool isFilled() const override { return isReady(); }
     SetPtr get() const override { return set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override
@@ -190,6 +199,7 @@ public:
     FutureSetFromStorage(SetPtr set_); // : set(std::move(set_) {}
 
     bool isReady() const override { return set != nullptr; }
+    bool isFilled() const override { return isReady(); }
     SetPtr get() const override { return set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr &) override
@@ -229,23 +239,25 @@ private:
 
 struct PreparedSetKey
 {
+    using Hash = std::pair<UInt64, UInt64>;
+
     /// Prepared sets for tuple literals are indexed by the hash of the tree contents and by the desired
     /// data types of set elements (two different Sets can be required for two tuples with the same contents
     /// if left hand sides of the IN operators have different types).
-    static PreparedSetKey forLiteral(const IAST & ast, DataTypes types_);
+    static PreparedSetKey forLiteral(Hash hash, DataTypes types_);
 
     /// Prepared sets for subqueries are indexed only by the AST contents because the type of the resulting
     /// set is fully determined by the subquery.
-    static PreparedSetKey forSubquery(const IAST & ast);
+    static PreparedSetKey forSubquery(Hash hash);
 
-    IAST::Hash ast_hash;
+    Hash ast_hash;
     DataTypes types; /// Empty for subqueries.
 
     bool operator==(const PreparedSetKey & other) const;
 
     String toString() const;
 
-    struct Hash
+    struct Hashing
     {
         UInt64 operator()(const PreparedSetKey & key) const { return key.ast_hash.first; }
     };
@@ -272,16 +284,18 @@ public:
     /// Get subqueries and clear them.
     /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
     /// SetPtr would still be available for consumers of PreparedSets.
-    SubqueriesForSets detachSubqueries();
+    SubqueriesForSets detachSubqueries(const ContextPtr &);
 
     /// Returns all sets that match the given ast hash not checking types
     /// Used in KeyCondition and MergeTreeIndexConditionBloomFilter to make non exact match for types in PreparedSetKey
-    std::vector<FutureSet> getByTreeHash(IAST::Hash ast_hash) const;
+    //std::vector<FutureSetPtr> getByTreeHash(IAST::Hash ast_hash) const;
+
+    const std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hashing> & getSets() const { return sets; }
 
     bool empty() const;
 
 private:
-    std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hash> sets;
+    std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hashing> sets;
 
     /// This is the information required for building sets
     SubqueriesForSets subqueries;
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 02069aad292..6c970e0e91b 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -11,6 +11,8 @@
 #include <Analyzer/ConstantNode.h>
 #include <Analyzer/FunctionNode.h>
 #include <Analyzer/TableNode.h>
+#include <DataTypes/DataTypeTuple.h>
+#include <Planner/Planner.h>
 
 namespace DB
 {
@@ -26,8 +28,9 @@ namespace
 class CollectSetsVisitor : public ConstInDepthQueryTreeVisitor<CollectSetsVisitor>
 {
 public:
-    explicit CollectSetsVisitor(PlannerContext & planner_context_)
+    explicit CollectSetsVisitor(PlannerContext & planner_context_, const SelectQueryOptions & select_query_options_)
         : planner_context(planner_context_)
+        , select_query_options(select_query_options_)
     {}
 
     void visitImpl(const QueryTreeNodePtr & node)
@@ -42,10 +45,12 @@ public:
 
         const auto & settings = planner_context.getQueryContext()->getSettingsRef();
 
-        String set_key = planner_context.createSetKey(in_second_argument);
+        // String set_key = planner_context.createSetKey(in_second_argument);
 
-        if (planner_context.hasSet(set_key))
-            return;
+        // if (planner_context.hasSet(set_key))
+        //     return;
+
+        auto & sets = planner_context.getPreparedSets();
 
         /// Tables and table functions are replaced with subquery at Analysis stage, except special Set table.
         auto * second_argument_table = in_second_argument->as<TableNode>();
@@ -54,7 +59,9 @@ public:
         if (storage_set)
         {
             /// Handle storage_set as ready set.
-            planner_context.registerSet(set_key, PlannerSet(FutureSet(storage_set->getSet())));
+            auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
+            sets.addFromStorage(set_key, storage_set->getSet());
+            //planner_context.registerSet(set_key, PlannerSet(FutureSet(storage_set->getSet())));
         }
         else if (const auto * constant_node = in_second_argument->as<ConstantNode>())
         {
@@ -62,14 +69,47 @@ public:
                 in_first_argument->getResultType(),
                 constant_node->getValue(),
                 constant_node->getResultType(),
-                settings);
+                settings.transform_null_in);
 
-            planner_context.registerSet(set_key, PlannerSet(FutureSet(std::move(set))));
+            DataTypes set_element_types = {in_first_argument->getResultType()};
+            const auto * left_tuple_type = typeid_cast<const DataTypeTuple *>(set_element_types.front().get());
+            if (left_tuple_type && left_tuple_type->getElements().size() != 1)
+                set_element_types = left_tuple_type->getElements();
+
+            for (auto & element_type : set_element_types)
+                if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+                    element_type = low_cardinality_type->getDictionaryType();
+
+            auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
+
+            sets.addFromTuple(set_key, std::move(set));
+
+            //planner_context.registerSet(set_key, PlannerSet(FutureSet(std::move(set))));
         }
         else if (in_second_argument_node_type == QueryTreeNodeType::QUERY ||
             in_second_argument_node_type == QueryTreeNodeType::UNION)
         {
-            planner_context.registerSet(set_key, PlannerSet(in_second_argument));
+            auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
+
+            auto subquery_options = select_query_options.subquery();
+            Planner subquery_planner(
+                in_second_argument,
+                subquery_options,
+                planner_context.getGlobalPlannerContext());
+            subquery_planner.buildQueryPlanIfNeeded();
+
+            // const auto & settings = planner_context.getQueryContext()->getSettingsRef();
+            // SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
+            // bool tranform_null_in = settings.transform_null_in;
+            // auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, tranform_null_in);
+
+            SubqueryForSet subquery_for_set;
+            subquery_for_set.key = planner_context.createSetKey(in_second_argument);
+            subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+
+            sets.addFromSubquery(set_key, std::move(subquery_for_set));
+
+            //planner_context.registerSet(set_key, PlannerSet(in_second_argument));
         }
         else
         {
@@ -87,13 +127,14 @@ public:
 
 private:
     PlannerContext & planner_context;
+    const SelectQueryOptions & select_query_options;
 };
 
 }
 
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context)
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context, const SelectQueryOptions & select_query_options)
 {
-    CollectSetsVisitor visitor(planner_context);
+    CollectSetsVisitor visitor(planner_context, select_query_options);
     visitor.visit(node);
 }
 
diff --git a/src/Planner/CollectSets.h b/src/Planner/CollectSets.h
index 94f792e877b..57e662a392e 100644
--- a/src/Planner/CollectSets.h
+++ b/src/Planner/CollectSets.h
@@ -7,9 +7,11 @@
 namespace DB
 {
 
+struct SelectQueryOptions;
+
 /** Collect prepared sets and sets for subqueries that are necessary to execute IN function and its variations.
   * Collected sets are registered in planner context.
   */
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context);
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context, const SelectQueryOptions & select_query_options);
 
 }
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index d036c895fbb..38d0aa29d24 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -878,50 +878,50 @@ void addOffsetStep(QueryPlan & query_plan, const QueryAnalysisResult & query_ana
     query_plan.addStep(std::move(offsets_step));
 }
 
-void addBuildSubqueriesForSetsStepIfNeeded(QueryPlan & query_plan,
-    const SelectQueryOptions & select_query_options,
-    const PlannerContextPtr & planner_context,
-    const std::vector<ActionsDAGPtr> & result_actions_to_execute)
-{
-    PreparedSets::SubqueriesForSets subqueries_for_sets;
+// void addBuildSubqueriesForSetsStepIfNeeded(QueryPlan & query_plan,
+//     const SelectQueryOptions & select_query_options,
+//     const PlannerContextPtr & planner_context,
+//     const std::vector<ActionsDAGPtr> & result_actions_to_execute)
+// {
+//     PreparedSets::SubqueriesForSets subqueries_for_sets;
 
-    for (const auto & actions_to_execute : result_actions_to_execute)
-    {
-        for (const auto & node : actions_to_execute->getNodes())
-        {
-            const auto & set_key = node.result_name;
-            auto * planner_set = planner_context->getSetOrNull(set_key);
-            if (!planner_set)
-                continue;
+//     for (const auto & actions_to_execute : result_actions_to_execute)
+//     {
+//         for (const auto & node : actions_to_execute->getNodes())
+//         {
+//             const auto & set_key = node.result_name;
+//             auto * planner_set = planner_context->getSetOrNull(set_key);
+//             if (!planner_set)
+//                 continue;
 
-            if (planner_set->getSet().isCreated() || !planner_set->getSubqueryNode())
-                continue;
+//             if (planner_set->getSet().isCreated() || !planner_set->getSubqueryNode())
+//                 continue;
 
-            auto subquery_options = select_query_options.subquery();
-            Planner subquery_planner(
-                planner_set->getSubqueryNode(),
-                subquery_options,
-                planner_context->getGlobalPlannerContext());
-            subquery_planner.buildQueryPlanIfNeeded();
+//             auto subquery_options = select_query_options.subquery();
+//             Planner subquery_planner(
+//                 planner_set->getSubqueryNode(),
+//                 subquery_options,
+//                 planner_context->getGlobalPlannerContext());
+//             subquery_planner.buildQueryPlanIfNeeded();
 
-            const auto & settings = planner_context->getQueryContext()->getSettingsRef();
-            SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
-            bool tranform_null_in = settings.transform_null_in;
-            auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, tranform_null_in);
+//             const auto & settings = planner_context->getQueryContext()->getSettingsRef();
+//             SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
+//             bool tranform_null_in = settings.transform_null_in;
+//             auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, tranform_null_in);
 
-            SubqueryForSet subquery_for_set;
-            subquery_for_set.key = set_key;
-            subquery_for_set.set_in_progress = set;
-            subquery_for_set.set = planner_set->getSet();
-            subquery_for_set.promise_to_fill_set = planner_set->extractPromiseToBuildSet();
-            subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+//             SubqueryForSet subquery_for_set;
+//             subquery_for_set.key = set_key;
+//             subquery_for_set.set_in_progress = set;
+//             subquery_for_set.set = planner_set->getSet();
+//             subquery_for_set.promise_to_fill_set = planner_set->extractPromiseToBuildSet();
+//             subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
 
-            subqueries_for_sets.emplace(set_key, std::move(subquery_for_set));
-        }
-    }
+//             subqueries_for_sets.emplace(set_key, std::move(subquery_for_set));
+//         }
+//     }
 
-    addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
-}
+//     addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
+// }
 
 /// Support for `additional_result_filter` setting
 void addAdditionalFilterStepIfNeeded(QueryPlan & query_plan,
@@ -951,7 +951,7 @@ void addAdditionalFilterStepIfNeeded(QueryPlan & query_plan,
     auto storage = std::make_shared<StorageDummy>(StorageID{"dummy", "dummy"}, fake_column_descriptions);
     auto fake_table_expression = std::make_shared<TableNode>(std::move(storage), query_context);
 
-    auto filter_info = buildFilterInfo(additional_result_filter_ast, fake_table_expression, planner_context, std::move(fake_name_set));
+    auto filter_info = buildFilterInfo(additional_result_filter_ast, fake_table_expression, planner_context, select_query_options, std::move(fake_name_set));
     if (!filter_info.actions || !query_plan.isInitialized())
         return;
 
@@ -1179,7 +1179,7 @@ void Planner::buildPlanForQueryNode()
     }
 
     checkStoragesSupportTransactions(planner_context);
-    collectSets(query_tree, *planner_context);
+    collectSets(query_tree, *planner_context, select_query_options);
     collectTableExpressionData(query_tree, planner_context);
 
     const auto & settings = query_context->getSettingsRef();
@@ -1467,7 +1467,17 @@ void Planner::buildPlanForQueryNode()
     }
 
     if (!select_query_options.only_analyze)
-        addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
+    {
+        auto step = std::make_unique<DelayedCreatingSetsStep>(
+            query_plan.getCurrentDataStream(),
+            planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()),
+            planner_context->getQueryContext());
+
+        query_plan.addStep(std::move(step));
+
+        //addCreatingSetsStep(query_plan, planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()), planner_context->getQueryContext());
+        //addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
+    }
 }
 
 SelectQueryInfo Planner::buildSelectQueryInfo() const
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index c64d82299ca..453b02a2f8f 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -16,6 +16,7 @@
 #include <DataTypes/DataTypeSet.h>
 
 #include <Common/FieldVisitorToString.h>
+#include <DataTypes/DataTypeTuple.h>
 
 #include <Columns/ColumnSet.h>
 #include <Columns/ColumnConst.h>
@@ -623,33 +624,51 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::vi
 PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::makeSetForInFunction(const QueryTreeNodePtr & node)
 {
     const auto & function_node = node->as<FunctionNode &>();
+    auto in_first_argument = function_node.getArguments().getNodes().at(0);
     auto in_second_argument = function_node.getArguments().getNodes().at(1);
 
-    auto set_key = planner_context->createSetKey(in_second_argument);
-    const auto & planner_set = planner_context->getSetOrThrow(set_key);
+    //auto set_key = planner_context->createSetKey(in_second_argument);
+
+    DataTypes set_element_types = {in_first_argument->getResultType()};
+    const auto * left_tuple_type = typeid_cast<const DataTypeTuple *>(set_element_types.front().get());
+    if (left_tuple_type && left_tuple_type->getElements().size() != 1)
+        set_element_types = left_tuple_type->getElements();
+
+    for (auto & element_type : set_element_types)
+        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+            element_type = low_cardinality_type->getDictionaryType();
+
+    auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
+
+
+    auto set = planner_context->getPreparedSets().getFuture(set_key);
+    if (!set)
+        throw Exception(ErrorCodes::LOGICAL_ERROR,
+            "No set is registered for key {}",
+            set_key.toString());
 
     ColumnWithTypeAndName column;
-    column.name = set_key;
+    column.name = planner_context->createSetKey(in_second_argument);
     column.type = std::make_shared<DataTypeSet>();
 
-    bool set_is_created = planner_set.getSet().isCreated();
-    auto column_set = ColumnSet::create(1, planner_set.getSet());
+    bool set_is_created = set->isFilled();
+    auto column_set = ColumnSet::create(1, std::move(set));
 
     if (set_is_created)
         column.column = ColumnConst::create(std::move(column_set), 1);
     else
         column.column = std::move(column_set);
 
-    actions_stack[0].addConstantIfNecessary(set_key, column);
+    actions_stack[0].addConstantIfNecessary(column.name, column);
 
     size_t actions_stack_size = actions_stack.size();
     for (size_t i = 1; i < actions_stack_size; ++i)
     {
         auto & actions_stack_node = actions_stack[i];
-        actions_stack_node.addInputConstantColumnIfNecessary(set_key, column);
+        actions_stack_node.addInputConstantColumnIfNecessary(column.name, column);
     }
 
-    return {set_key, 0};
+    return {column.name, 0};
 }
 
 PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::visitIndexHintFunction(const QueryTreeNodePtr & node)
diff --git a/src/Planner/PlannerContext.cpp b/src/Planner/PlannerContext.cpp
index 346cc6d2080..e8c7bb7ef48 100644
--- a/src/Planner/PlannerContext.cpp
+++ b/src/Planner/PlannerContext.cpp
@@ -126,49 +126,49 @@ PlannerContext::SetKey PlannerContext::createSetKey(const QueryTreeNodePtr & set
     return "__set_" + toString(set_source_hash.first) + '_' + toString(set_source_hash.second);
 }
 
-void PlannerContext::registerSet(const SetKey & key, PlannerSet planner_set)
-{
-    if (!planner_set.getSet().isValid())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Set must be initialized");
+// void PlannerContext::registerSet(const SetKey & key, PlannerSet planner_set)
+// {
+//     if (!planner_set.getSet().isValid())
+//         throw Exception(ErrorCodes::LOGICAL_ERROR, "Set must be initialized");
 
-    const auto & subquery_node = planner_set.getSubqueryNode();
-    if (subquery_node)
-    {
-        auto node_type = subquery_node->getNodeType();
+//     const auto & subquery_node = planner_set.getSubqueryNode();
+//     if (subquery_node)
+//     {
+//         auto node_type = subquery_node->getNodeType();
 
-        if (node_type != QueryTreeNodeType::QUERY &&
-            node_type != QueryTreeNodeType::UNION)
-            throw Exception(ErrorCodes::LOGICAL_ERROR,
-                "Invalid node for set table expression. Expected query or union. Actual {}",
-                subquery_node->formatASTForErrorMessage());
-    }
+//         if (node_type != QueryTreeNodeType::QUERY &&
+//             node_type != QueryTreeNodeType::UNION)
+//             throw Exception(ErrorCodes::LOGICAL_ERROR,
+//                 "Invalid node for set table expression. Expected query or union. Actual {}",
+//                 subquery_node->formatASTForErrorMessage());
+//     }
 
-    set_key_to_set.emplace(key, std::move(planner_set));
-}
+//     set_key_to_set.emplace(key, std::move(planner_set));
+// }
 
-bool PlannerContext::hasSet(const SetKey & key) const
-{
-    return set_key_to_set.contains(key);
-}
+// bool PlannerContext::hasSet(const SetKey & key) const
+// {
+//     return set_key_to_set.contains(key);
+// }
 
-const PlannerSet & PlannerContext::getSetOrThrow(const SetKey & key) const
-{
-    auto it = set_key_to_set.find(key);
-    if (it == set_key_to_set.end())
-        throw Exception(ErrorCodes::LOGICAL_ERROR,
-            "No set is registered for key {}",
-            key);
+// const PlannerSet & PlannerContext::getSetOrThrow(const SetKey & key) const
+// {
+//     auto it = set_key_to_set.find(key);
+//     if (it == set_key_to_set.end())
+//         throw Exception(ErrorCodes::LOGICAL_ERROR,
+//             "No set is registered for key {}",
+//             key);
 
-    return it->second;
-}
+//     return it->second;
+// }
 
-PlannerSet * PlannerContext::getSetOrNull(const SetKey & key)
-{
-    auto it = set_key_to_set.find(key);
-    if (it == set_key_to_set.end())
-        return nullptr;
+// PlannerSet * PlannerContext::getSetOrNull(const SetKey & key)
+// {
+//     auto it = set_key_to_set.find(key);
+//     if (it == set_key_to_set.end())
+//         return nullptr;
 
-    return &it->second;
-}
+//     return &it->second;
+// }
 
 }
diff --git a/src/Planner/PlannerContext.h b/src/Planner/PlannerContext.h
index 9ecfdb6117a..df3fad01824 100644
--- a/src/Planner/PlannerContext.h
+++ b/src/Planner/PlannerContext.h
@@ -55,43 +55,47 @@ using GlobalPlannerContextPtr = std::shared_ptr<GlobalPlannerContext>;
   */
 class PlannerSet
 {
-public:
-    /// Construct planner set that is ready for execution
-    explicit PlannerSet(FutureSetPtr set_)
-        : set(std::move(set_))
-    {}
 
-    /// Construct planner set with set and subquery node
-    explicit PlannerSet(QueryTreeNodePtr subquery_node_)
-        //: set(promise_to_build_set.get_future())
-        : subquery_node(std::move(subquery_node_))
-    {}
-
-    /// Get a reference to a set that might be not built yet
-    const FutureSetPtr & getSet() const
-    {
-        return set;
-    }
-
-    /// Get subquery node
-    const QueryTreeNodePtr & getSubqueryNode() const
-    {
-        return subquery_node;
-    }
-
-    /// This promise will be fulfilled when set is built and all FutureSet objects will become ready
-    // std::promise<SetPtr> extractPromiseToBuildSet()
-    // {
-    //     return std::move(promise_to_build_set);
-    // }
-
-private:
-    //std::promise<SetPtr> promise_to_build_set;
-    FutureSetPtr set;
-
-    QueryTreeNodePtr subquery_node;
 };
 
+// {
+// public:
+//     /// Construct planner set that is ready for execution
+//     explicit PlannerSet(FutureSetPtr set_)
+//         : set(std::move(set_))
+//     {}
+
+//     /// Construct planner set with set and subquery node
+//     explicit PlannerSet(QueryTreeNodePtr subquery_node_)
+//         //: set(promise_to_build_set.get_future())
+//         : subquery_node(std::move(subquery_node_))
+//     {}
+
+//     /// Get a reference to a set that might be not built yet
+//     const FutureSetPtr & getSet() const
+//     {
+//         return set;
+//     }
+
+//     /// Get subquery node
+//     const QueryTreeNodePtr & getSubqueryNode() const
+//     {
+//         return subquery_node;
+//     }
+
+//     /// This promise will be fulfilled when set is built and all FutureSet objects will become ready
+//     // std::promise<SetPtr> extractPromiseToBuildSet()
+//     // {
+//     //     return std::move(promise_to_build_set);
+//     // }
+
+// private:
+//     //std::promise<SetPtr> promise_to_build_set;
+//     FutureSetPtr set;
+
+//     QueryTreeNodePtr subquery_node;
+// };
+
 class PlannerContext
 {
 public:
@@ -179,28 +183,30 @@ public:
 
     using SetKey = std::string;
 
-    using SetKeyToSet = std::unordered_map<String, PlannerSet>;
+    // using SetKeyToSet = std::unordered_map<String, PlannerSet>;
 
-    /// Create set key for set source node
+    // /// Create set key for set source node
     static SetKey createSetKey(const QueryTreeNodePtr & set_source_node);
 
-    /// Register set for set key
-    void registerSet(const SetKey & key, PlannerSet planner_set);
+    // /// Register set for set key
+    // void registerSet(const SetKey & key, PlannerSet planner_set);
 
-    /// Returns true if set is registered for key, false otherwise
-    bool hasSet(const SetKey & key) const;
+    // /// Returns true if set is registered for key, false otherwise
+    // bool hasSet(const SetKey & key) const;
 
-    /// Get set for key, if no set is registered logical exception is thrown
-    const PlannerSet & getSetOrThrow(const SetKey & key) const;
+    // /// Get set for key, if no set is registered logical exception is thrown
+    // const PlannerSet & getSetOrThrow(const SetKey & key) const;
 
-    /// Get set for key, if no set is registered null is returned
-    PlannerSet * getSetOrNull(const SetKey & key);
+    // /// Get set for key, if no set is registered null is returned
+    // PlannerSet * getSetOrNull(const SetKey & key);
 
-    /// Get registered sets
-    const SetKeyToSet & getRegisteredSets() const
-    {
-        return set_key_to_set;
-    }
+    // /// Get registered sets
+    // const SetKeyToSet & getRegisteredSets() const
+    // {
+    //     return set_key_to_set;
+    // }
+
+    PreparedSets & getPreparedSets() { return prepared_sets; }
 
 private:
     /// Query context
@@ -216,8 +222,7 @@ private:
     std::unordered_map<QueryTreeNodePtr, TableExpressionData> table_expression_node_to_data;
 
     /// Set key to set
-    SetKeyToSet set_key_to_set;
-
+    PreparedSets prepared_sets;
 };
 
 using PlannerContextPtr = std::shared_ptr<PlannerContext>;
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index 93a9945b1ca..77f53a6b7ac 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -388,7 +388,8 @@ void updatePrewhereOutputsIfNeeded(SelectQueryInfo & table_expression_query_info
 
 FilterDAGInfo buildRowPolicyFilterIfNeeded(const StoragePtr & storage,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context)
+    PlannerContextPtr & planner_context,
+    const SelectQueryOptions & select_query_options)
 {
     auto storage_id = storage->getStorageID();
     const auto & query_context = planner_context->getQueryContext();
@@ -397,12 +398,13 @@ FilterDAGInfo buildRowPolicyFilterIfNeeded(const StoragePtr & storage,
     if (!row_policy_filter)
         return {};
 
-    return buildFilterInfo(row_policy_filter->expression, table_expression_query_info.table_expression, planner_context);
+    return buildFilterInfo(row_policy_filter->expression, table_expression_query_info.table_expression, planner_context, select_query_options);
 }
 
 FilterDAGInfo buildCustomKeyFilterIfNeeded(const StoragePtr & storage,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context)
+    PlannerContextPtr & planner_context,
+    const SelectQueryOptions & select_query_options)
 {
     const auto & query_context = planner_context->getQueryContext();
     const auto & settings = query_context->getSettingsRef();
@@ -428,14 +430,15 @@ FilterDAGInfo buildCustomKeyFilterIfNeeded(const StoragePtr & storage,
             *storage,
             query_context);
 
-    return buildFilterInfo(parallel_replicas_custom_filter_ast, table_expression_query_info.table_expression, planner_context);
+    return buildFilterInfo(parallel_replicas_custom_filter_ast, table_expression_query_info.table_expression, planner_context, select_query_options);
 }
 
 /// Apply filters from additional_table_filters setting
 FilterDAGInfo buildAdditionalFiltersIfNeeded(const StoragePtr & storage,
     const String & table_expression_alias,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context)
+    PlannerContextPtr & planner_context,
+    const SelectQueryOptions & select_query_options)
 {
     const auto & query_context = planner_context->getQueryContext();
     const auto & settings = query_context->getSettingsRef();
@@ -469,7 +472,7 @@ FilterDAGInfo buildAdditionalFiltersIfNeeded(const StoragePtr & storage,
         return {};
 
     table_expression_query_info.additional_filter_ast = additional_filter_ast;
-    return buildFilterInfo(additional_filter_ast, table_expression_query_info.table_expression, planner_context);
+    return buildFilterInfo(additional_filter_ast, table_expression_query_info.table_expression, planner_context, select_query_options);
 }
 
 JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expression,
@@ -679,14 +682,14 @@ JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expres
                     }
                 };
 
-                auto row_policy_filter_info = buildRowPolicyFilterIfNeeded(storage, table_expression_query_info, planner_context);
+                auto row_policy_filter_info = buildRowPolicyFilterIfNeeded(storage, table_expression_query_info, planner_context, select_query_options);
                 add_filter(row_policy_filter_info, "Row-level security filter");
 
                 if (query_context->getParallelReplicasMode() == Context::ParallelReplicasMode::CUSTOM_KEY)
                 {
                     if (settings.parallel_replicas_count > 1)
                     {
-                        auto parallel_replicas_custom_key_filter_info = buildCustomKeyFilterIfNeeded(storage, table_expression_query_info, planner_context);
+                        auto parallel_replicas_custom_key_filter_info = buildCustomKeyFilterIfNeeded(storage, table_expression_query_info, planner_context, select_query_options);
                         add_filter(parallel_replicas_custom_key_filter_info, "Parallel replicas custom key filter");
                     }
                     else
@@ -701,7 +704,7 @@ JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expres
                 }
 
                 const auto & table_expression_alias = table_expression->getAlias();
-                auto additional_filters_info = buildAdditionalFiltersIfNeeded(storage, table_expression_alias, table_expression_query_info, planner_context);
+                auto additional_filters_info = buildAdditionalFiltersIfNeeded(storage, table_expression_alias, table_expression_query_info, planner_context, select_query_options);
                 add_filter(additional_filters_info, "additional filter");
 
                 from_stage = storage->getQueryProcessingStage(query_context, select_query_options.to_stage, storage_snapshot, table_expression_query_info);
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index 5c61b2fc2c7..2b4febf58ea 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -426,6 +426,7 @@ SelectQueryInfo buildSelectQueryInfo(const QueryTreeNodePtr & query_tree, const
 FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
         const QueryTreeNodePtr & table_expression,
         PlannerContextPtr & planner_context,
+        const SelectQueryOptions & select_query_options,
         NameSet table_expression_required_names_without_filter)
 {
     const auto & query_context = planner_context->getQueryContext();
@@ -443,7 +444,7 @@ FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
     }
 
     collectSourceColumns(filter_query_tree, planner_context);
-    collectSets(filter_query_tree, *planner_context);
+    collectSets(filter_query_tree, *planner_context, select_query_options);
 
     auto filter_actions_dag = std::make_shared<ActionsDAG>();
 
diff --git a/src/Planner/Utils.h b/src/Planner/Utils.h
index d9412800e61..8071e201f88 100644
--- a/src/Planner/Utils.h
+++ b/src/Planner/Utils.h
@@ -82,6 +82,7 @@ SelectQueryInfo buildSelectQueryInfo(const QueryTreeNodePtr & query_tree, const
 FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
         const QueryTreeNodePtr & table_expression,
         PlannerContextPtr & planner_context,
+        const SelectQueryOptions & select_query_options,
         NameSet table_expression_required_names_without_filter = {});
 
 ASTPtr parseAdditionalResultFilter(const Settings & settings);
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 9eec3e90494..d77c6627994 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -38,16 +38,16 @@ CreatingSetStep::CreatingSetStep(
     SizeLimits network_transfer_limits_,
     ContextPtr context_)
     : ITransformingStep(input_stream_, Block{}, getTraits())
-    , WithContext(context_)
     , description(std::move(description_))
     , subquery_for_set(std::move(subquery_for_set_))
     , network_transfer_limits(std::move(network_transfer_limits_))
+    , context(std::move(context_))
 {
 }
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)
 {
-    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(subquery_for_set), network_transfer_limits, getContext());
+    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(subquery_for_set), network_transfer_limits, context);
 }
 
 void CreatingSetStep::updateOutputStream()
@@ -60,7 +60,7 @@ void CreatingSetStep::describeActions(FormatSettings & settings) const
     String prefix(settings.offset, ' ');
 
     settings.out << prefix;
-    if (subquery_for_set.set_in_progress)
+    if (subquery_for_set.set)
         settings.out << "Set: ";
 
     settings.out << description << '\n';
@@ -68,7 +68,7 @@ void CreatingSetStep::describeActions(FormatSettings & settings) const
 
 void CreatingSetStep::describeActions(JSONBuilder::JSONMap & map) const
 {
-    if (subquery_for_set.set_in_progress)
+    if (subquery_for_set.set)
         map.add("Set", description);
 }
 
@@ -130,22 +130,14 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets
     plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
     query_plan = QueryPlan();
 
-    for (auto & [description, subquery_for_set] : subqueries_for_sets)
+    for (auto & [description, future_set] : subqueries_for_sets)
     {
-        if (!subquery_for_set.hasSource())
+        if (future_set->isReady())
             continue;
 
-        auto plan = subquery_for_set.detachSource();
-
-        const Settings & settings = context->getSettingsRef();
-        auto creating_set = std::make_unique<CreatingSetStep>(
-                plan->getCurrentDataStream(),
-                description,
-                std::move(subquery_for_set),
-                SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
-                context);
-        creating_set->setStepDescription("Create set for subquery");
-        plan->addStep(std::move(creating_set));
+        auto plan = future_set->build(context);
+        if (!plan)
+            continue;
 
         input_streams.emplace_back(plan->getCurrentDataStream());
         plans.emplace_back(std::move(plan));
@@ -162,12 +154,56 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets
     query_plan.unitePlans(std::move(creating_sets), std::move(plans));
 }
 
+//void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets subqueries_for_sets, ContextPtr context)
+
+std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSets(DelayedCreatingSetsStep && step)
+{
+    // DataStreams input_streams;
+    // input_streams.emplace_back(query_plan.getCurrentDataStream());
+
+    std::vector<std::unique_ptr<QueryPlan>> plans;
+    // plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
+    // query_plan = QueryPlan();
+
+    for (auto & [description, future_set] : step.subqueries_for_sets)
+    {
+        if (future_set->isReady())
+            continue;
+
+        auto plan = future_set->build(step.context);
+        if (!plan)
+            continue;
+
+        plan->optimize(QueryPlanOptimizationSettings::fromContext(step.context));
+
+        //input_streams.emplace_back(plan->getCurrentDataStream());
+        plans.emplace_back(std::move(plan));
+    }
+
+    return plans;
+}
+
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets, ContextPtr context)
 {
     if (!prepared_sets || prepared_sets->empty())
         return;
 
-    addCreatingSetsStep(query_plan, prepared_sets->detachSubqueries(), context);
+    addCreatingSetsStep(query_plan, prepared_sets->detachSubqueries(context), context);
+}
+
+DelayedCreatingSetsStep::DelayedCreatingSetsStep(
+    DataStream input_stream, PreparedSets::SubqueriesForSets subqueries_for_sets_, ContextPtr context_)
+    : subqueries_for_sets(std::move(subqueries_for_sets_)), context(std::move(context_))
+{
+    input_streams = {input_stream};
+    output_stream = std::move(input_stream);
+}
+
+QueryPipelineBuilderPtr DelayedCreatingSetsStep::updatePipeline(QueryPipelineBuilders, const BuildQueryPipelineSettings &)
+{
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "Cannot build pipeline in DelayedCreatingSets. This step should be optimized out.");
 }
 
 }
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index b4777578a30..96ab26077fc 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -9,7 +9,7 @@ namespace DB
 {
 
 /// Creates sets for subqueries and JOIN. See CreatingSetsTransform.
-class CreatingSetStep : public ITransformingStep, WithContext
+class CreatingSetStep : public ITransformingStep
 {
 public:
     CreatingSetStep(
@@ -32,6 +32,7 @@ private:
     String description;
     SubqueryForSet subquery_for_set;
     SizeLimits network_transfer_limits;
+    ContextPtr context;
 };
 
 class CreatingSetsStep : public IQueryPlanStep
@@ -46,6 +47,22 @@ public:
     void describePipeline(FormatSettings & settings) const override;
 };
 
+class DelayedCreatingSetsStep final : public IQueryPlanStep
+{
+public:
+    DelayedCreatingSetsStep(DataStream input_stream, PreparedSets::SubqueriesForSets subqueries_for_sets_, ContextPtr context_);
+
+    String getName() const override { return "DelayedCreatingSets"; }
+
+    QueryPipelineBuilderPtr updatePipeline(QueryPipelineBuilders, const BuildQueryPipelineSettings &) override;
+
+    static std::vector<std::unique_ptr<QueryPlan>> makePlansForSets(DelayedCreatingSetsStep && step);
+
+private:
+    PreparedSets::SubqueriesForSets subqueries_for_sets;
+    ContextPtr context;
+};
+
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets subqueries_for_sets, ContextPtr context);
 
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets, ContextPtr context);
diff --git a/src/Processors/QueryPlan/Optimizations/Optimizations.h b/src/Processors/QueryPlan/Optimizations/Optimizations.h
index de1d43bed1b..2b934ec440b 100644
--- a/src/Processors/QueryPlan/Optimizations/Optimizations.h
+++ b/src/Processors/QueryPlan/Optimizations/Optimizations.h
@@ -110,6 +110,7 @@ void optimizeReadInOrder(QueryPlan::Node & node, QueryPlan::Nodes & nodes);
 void optimizeAggregationInOrder(QueryPlan::Node & node, QueryPlan::Nodes &);
 bool optimizeUseAggregateProjections(QueryPlan::Node & node, QueryPlan::Nodes & nodes);
 bool optimizeUseNormalProjections(Stack & stack, QueryPlan::Nodes & nodes);
+bool addPlansForSets(QueryPlan::Node & node, QueryPlan::Nodes & nodes);
 
 /// Enable memory bound merging of aggregation states for remote queries
 /// in case it was enabled for local plan
diff --git a/src/Processors/QueryPlan/Optimizations/addPlansForSets.cpp b/src/Processors/QueryPlan/Optimizations/addPlansForSets.cpp
new file mode 100644
index 00000000000..e9100ae9d02
--- /dev/null
+++ b/src/Processors/QueryPlan/Optimizations/addPlansForSets.cpp
@@ -0,0 +1,35 @@
+#include <memory>
+#include <Processors/QueryPlan/Optimizations/Optimizations.h>
+#include <Processors/QueryPlan/CreatingSetsStep.h>
+#include <Common/typeid_cast.h>
+
+namespace DB::QueryPlanOptimizations
+{
+
+bool addPlansForSets(QueryPlan::Node & node, QueryPlan::Nodes & nodes)
+{
+    auto * delayed = typeid_cast<DelayedCreatingSetsStep *>(node.step.get());
+    if (!delayed)
+        return false;
+
+    auto plans = DelayedCreatingSetsStep::makePlansForSets(std::move(*delayed));
+    node.children.reserve(1 + plans.size());
+
+    DataStreams input_streams;
+    input_streams.reserve(1 + plans.size());
+    input_streams.push_back(node.children.front()->step->getOutputStream());
+
+    for (const auto & plan : plans)
+    {
+        input_streams.push_back(plan->getCurrentDataStream());
+        node.children.push_back(plan->getRootNode());
+        nodes.splice(nodes.end(), QueryPlan::detachNodes(std::move(*plan)));
+    }
+
+    auto creating_sets = std::make_unique<CreatingSetsStep>(std::move(input_streams));
+    creating_sets->setStepDescription("Create sets before main query execution");
+    node.step = std::move(creating_sets);
+    return true;
+}
+
+}
diff --git a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
index 37e3b2f67d8..c74487f7cc1 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
@@ -163,6 +163,7 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
         optimizePrewhere(stack, nodes);
         optimizePrimaryKeyCondition(stack);
         enableMemoryBoundMerging(*frame.node, nodes);
+        addPlansForSets(*frame.node, nodes);
 
         stack.pop_back();
     }
diff --git a/src/Processors/QueryPlan/QueryPlan.cpp b/src/Processors/QueryPlan/QueryPlan.cpp
index 3fbe3d89845..cb732e58855 100644
--- a/src/Processors/QueryPlan/QueryPlan.cpp
+++ b/src/Processors/QueryPlan/QueryPlan.cpp
@@ -541,4 +541,9 @@ void QueryPlan::explainEstimate(MutableColumns & columns)
     }
 }
 
+QueryPlan::Nodes QueryPlan::detachNodes(QueryPlan && plan)
+{
+    return std::move(plan.nodes);
+}
+
 }
diff --git a/src/Processors/QueryPlan/QueryPlan.h b/src/Processors/QueryPlan/QueryPlan.h
index 19d87b101de..d89bdc534be 100644
--- a/src/Processors/QueryPlan/QueryPlan.h
+++ b/src/Processors/QueryPlan/QueryPlan.h
@@ -105,10 +105,11 @@ public:
         std::vector<Node *> children = {};
     };
 
-    const Node * getRootNode() const { return root; }
-
     using Nodes = std::list<Node>;
 
+    Node * getRootNode() const { return root; }
+    static Nodes detachNodes(QueryPlan && plan);
+
 private:
     QueryPlanResourceHolder resources;
     Nodes nodes;
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index e3ae2d4fd4e..de10be599c8 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -76,7 +76,7 @@ void CreatingSetsTransform::startSubquery()
                 }
 
                 subquery.promise_to_fill_set.set_value(ready_set);
-                subquery.set_in_progress.reset();
+                subquery.set.reset();
                 done_with_set = true;
                 set_from_cache = true;
             }
@@ -84,7 +84,7 @@ void CreatingSetsTransform::startSubquery()
         }
     }
 
-    if (subquery.set_in_progress)
+    if (subquery.set)
         LOG_TRACE(log, "Creating set, key: {}", subquery.key);
     if (subquery.table)
         LOG_TRACE(log, "Filling temporary table.");
@@ -93,7 +93,7 @@ void CreatingSetsTransform::startSubquery()
         /// TODO: make via port
         table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), getContext()));
 
-    done_with_set = !subquery.set_in_progress;
+    done_with_set = !subquery.set;
     done_with_table = !subquery.table;
 
     if ((done_with_set && !set_from_cache) /*&& done_with_join*/ && done_with_table)
@@ -116,8 +116,8 @@ void CreatingSetsTransform::finishSubquery()
     }
     else if (read_rows != 0)
     {
-        if (subquery.set_in_progress)
-            LOG_DEBUG(log, "Created Set with {} entries from {} rows in {} sec.", subquery.set_in_progress->getTotalRowCount(), read_rows, seconds);
+        if (subquery.set)
+            LOG_DEBUG(log, "Created Set with {} entries from {} rows in {} sec.", subquery.set->getTotalRowCount(), read_rows, seconds);
         if (subquery.table)
             LOG_DEBUG(log, "Created Table with {} rows in {} sec.", read_rows, seconds);
     }
@@ -131,9 +131,9 @@ void CreatingSetsTransform::init()
 {
     is_initialized = true;
 
-    if (subquery.set_in_progress)
+    if (subquery.set)
     {
-        subquery.set_in_progress->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
+        subquery.set->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
     }
 
     watch.restart();
@@ -147,7 +147,7 @@ void CreatingSetsTransform::consume(Chunk chunk)
 
     if (!done_with_set)
     {
-        if (!subquery.set_in_progress->insertFromBlock(block.getColumnsWithTypeAndName()))
+        if (!subquery.set->insertFromBlock(block.getColumnsWithTypeAndName()))
             done_with_set = true;
     }
 
@@ -170,12 +170,12 @@ void CreatingSetsTransform::consume(Chunk chunk)
 
 Chunk CreatingSetsTransform::generate()
 {
-    if (subquery.set_in_progress)
+    if (subquery.set)
     {
-        subquery.set_in_progress->finishInsert();
-        subquery.promise_to_fill_set.set_value(subquery.set_in_progress);
+        subquery.set->finishInsert();
+        subquery.promise_to_fill_set.set_value(subquery.set);
         if (promise_to_build)
-            promise_to_build->set_value(subquery.set_in_progress);
+            promise_to_build->set_value(subquery.set);
     }
 
     if (table_out.initialized())
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index d5563108ad7..281236e631e 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -68,11 +68,18 @@ bool traverseASTFilter(
 
             PreparedSetKey set_key;
             if ((value->as<ASTSubquery>() || value->as<ASTIdentifier>()))
-                set_key = PreparedSetKey::forSubquery(*value);
+                set_key = PreparedSetKey::forSubquery(value->getTreeHash());
             else
-                set_key = PreparedSetKey::forLiteral(*value, {primary_key_type});
+                set_key = PreparedSetKey::forLiteral(value->getTreeHash(), {primary_key_type});
 
-            SetPtr set = prepared_sets->get(set_key);
+            FutureSetPtr future_set = prepared_sets->getFuture(set_key);
+            if (!future_set)
+                return false;
+
+            if (!future_set->isReady())
+                future_set->buildOrderedSetInplace(context);
+
+            auto set = future_set->get();
             if (!set)
                 return false;
 
diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index 5d961425469..7a1c3b10c8a 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1204,14 +1204,32 @@ bool KeyCondition::tryPrepareSetIndex(
 
     const auto right_arg = func.getArgumentAt(1);
 
-    auto prepared_set = right_arg.tryGetPreparedSet(indexes_mapping, data_types);
+    LOG_TRACE(&Poco::Logger::get("KK"), "Trying to get set for {}", right_arg.getColumnName());
+
+    auto future_set = right_arg.tryGetPreparedSet(indexes_mapping, data_types);
+    if (!future_set)
+        return false;
+
+    LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
+
+    if (!future_set->isReady())
+    {
+        LOG_TRACE(&Poco::Logger::get("KK"), "Building set inplace for {}", right_arg.getColumnName());
+        future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
+    }
+
+    auto prepared_set = future_set->get();
     if (!prepared_set)
         return false;
 
+    LOG_TRACE(&Poco::Logger::get("KK"), "Set if ready for {}", right_arg.getColumnName());
+
     /// The index can be prepared if the elements of the set were saved in advance.
     if (!prepared_set->hasExplicitSetElements())
         return false;
 
+    LOG_TRACE(&Poco::Logger::get("KK"), "Has explicit elements for {}", right_arg.getColumnName());
+
     prepared_set->checkColumnsNumber(left_args_count);
     for (size_t i = 0; i < indexes_mapping.size(); ++i)
         prepared_set->checkTypesEqual(indexes_mapping[i].tuple_index, data_types[i]);
diff --git a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
index 235d90bb974..5e186c25b83 100644
--- a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
@@ -310,7 +310,13 @@ bool MergeTreeIndexConditionBloomFilter::traverseFunction(const RPNBuilderTreeNo
 
         if (functionIsInOrGlobalInOperator(function_name))
         {
-            ConstSetPtr prepared_set = rhs_argument.tryGetPreparedSet();
+            auto future_set = rhs_argument.tryGetPreparedSet();
+            if (future_set && !future_set->isReady())
+                future_set->buildOrderedSetInplace(rhs_argument.getTreeContext().getQueryContext());
+
+            ConstSetPtr prepared_set;
+            if (future_set)
+                prepared_set = future_set->get();
 
             if (prepared_set && prepared_set->hasExplicitSetElements())
             {
diff --git a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
index 06fddd51cb8..5e1d23df3c7 100644
--- a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
@@ -624,7 +624,14 @@ bool MergeTreeConditionFullText::tryPrepareSetBloomFilter(
     if (key_tuple_mapping.empty())
         return false;
 
-    auto prepared_set = right_argument.tryGetPreparedSet(data_types);
+    auto future_set = right_argument.tryGetPreparedSet(data_types);
+    if (future_set && !future_set->isReady())
+        future_set->buildOrderedSetInplace(right_argument.getTreeContext().getQueryContext());
+
+    ConstSetPtr prepared_set;
+    if (future_set)
+        prepared_set = future_set->get();
+
     if (!prepared_set || !prepared_set->hasExplicitSetElements())
         return false;
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
index baa11368c8b..6ffba0ad029 100644
--- a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
@@ -655,7 +655,14 @@ bool MergeTreeConditionInverted::tryPrepareSetGinFilter(
     if (key_tuple_mapping.empty())
         return false;
 
-    ConstSetPtr prepared_set = rhs.tryGetPreparedSet();
+    auto future_set = rhs.tryGetPreparedSet();
+    if (future_set && !future_set->isReady())
+        future_set->buildOrderedSetInplace(rhs.getTreeContext().getQueryContext());
+
+    ConstSetPtr prepared_set;
+    if (future_set)
+        prepared_set = future_set->get();
+
     if (!prepared_set || !prepared_set->hasExplicitSetElements())
         return false;
 
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index e49459d3d17..e8843ff1489 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -275,7 +275,7 @@ bool RPNBuilderTreeNode::tryGetConstant(Field & output_value, DataTypePtr & outp
 namespace
 {
 
-ConstSetPtr tryGetSetFromDAGNode(const ActionsDAG::Node * dag_node)
+FutureSetPtr tryGetSetFromDAGNode(const ActionsDAG::Node * dag_node)
 {
     if (!dag_node->column)
         return {};
@@ -285,28 +285,20 @@ ConstSetPtr tryGetSetFromDAGNode(const ActionsDAG::Node * dag_node)
         column = &column_const->getDataColumn();
 
     if (const auto * column_set = typeid_cast<const ColumnSet *>(column))
-    {
-        auto set = column_set->getData();
-
-        if (set && set->isCreated())
-            return set;
-    }
+        return column_set->getData();
 
     return {};
 }
 
 }
 
-ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
+FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
 {
     const auto & prepared_sets = getTreeContext().getPreparedSets();
 
     if (ast_node && prepared_sets)
     {
-        auto prepared_sets_with_same_hash = prepared_sets->getByTreeHash(ast_node->getTreeHash());
-        for (auto & set : prepared_sets_with_same_hash)
-            if (set.isCreated())
-                return set.get();
+        return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
     }
     else if (dag_node)
     {
@@ -317,16 +309,16 @@ ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
     return {};
 }
 
-ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet(const DataTypes & data_types) const
+FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(const DataTypes & data_types) const
 {
     const auto & prepared_sets = getTreeContext().getPreparedSets();
 
     if (prepared_sets && ast_node)
     {
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
-            return prepared_sets->get(PreparedSetKey::forSubquery(*ast_node));
+            return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
 
-        return prepared_sets->get(PreparedSetKey::forLiteral(*ast_node, data_types));
+        return prepared_sets->getFuture(PreparedSetKey::forLiteral(ast_node->getTreeHash(), data_types));
     }
     else if (dag_node)
     {
@@ -337,7 +329,7 @@ ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet(const DataTypes & data_types)
     return nullptr;
 }
 
-ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
+FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
     const std::vector<MergeTreeSetIndex::KeyTuplePositionMapping> & indexes_mapping,
     const DataTypes & data_types) const
 {
@@ -346,19 +338,25 @@ ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
     if (prepared_sets && ast_node)
     {
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
-            return prepared_sets->get(PreparedSetKey::forSubquery(*ast_node));
+            return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
 
         /// We have `PreparedSetKey::forLiteral` but it is useless here as we don't have enough information
         /// about types in left argument of the IN operator. Instead, we manually iterate through all the sets
         /// and find the one for the right arg based on the AST structure (getTreeHash), after that we check
         /// that the types it was prepared with are compatible with the types of the primary key.
-        auto types_match = [&indexes_mapping, &data_types](const SetPtr & candidate_set)
+        auto types_match = [&indexes_mapping, &data_types](const DataTypes & set_types)
         {
             assert(indexes_mapping.size() == data_types.size());
 
             for (size_t i = 0; i < indexes_mapping.size(); ++i)
             {
-                if (!candidate_set->areTypesEqual(indexes_mapping[i].tuple_index, data_types[i]))
+                if (indexes_mapping[i].tuple_index >= set_types.size())
+                    return false;
+
+                auto lhs = recursiveRemoveLowCardinality(data_types[i]);
+                auto rhs = recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]);
+
+                if (!lhs->equals(*rhs))
                     return false;
             }
 
@@ -366,10 +364,10 @@ ConstSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
         };
 
         auto tree_hash = ast_node->getTreeHash();
-        for (const auto & set : prepared_sets->getByTreeHash(tree_hash))
+        for (const auto & [key, future_set] : prepared_sets->getSets())
         {
-            if (set.isCreated() && types_match(set.get()))
-                return set.get();
+            if (key.ast_hash == tree_hash && types_match(key.types))
+                return future_set;
         }
     }
     else
diff --git a/src/Storages/MergeTree/RPNBuilder.h b/src/Storages/MergeTree/RPNBuilder.h
index 626eb288493..6f624d93cd6 100644
--- a/src/Storages/MergeTree/RPNBuilder.h
+++ b/src/Storages/MergeTree/RPNBuilder.h
@@ -109,13 +109,13 @@ public:
     bool tryGetConstant(Field & output_value, DataTypePtr & output_type) const;
 
     /// Try get prepared set from node
-    ConstSetPtr tryGetPreparedSet() const;
+    FutureSetPtr tryGetPreparedSet() const;
 
     /// Try get prepared set from node that match data types
-    ConstSetPtr tryGetPreparedSet(const DataTypes & data_types) const;
+    FutureSetPtr tryGetPreparedSet(const DataTypes & data_types) const;
 
     /// Try get prepared set from node that match indexes mapping and data types
-    ConstSetPtr tryGetPreparedSet(
+    FutureSetPtr tryGetPreparedSet(
         const std::vector<MergeTreeSetIndex::KeyTuplePositionMapping> & indexes_mapping,
         const DataTypes & data_types) const;
 
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 6ca74406b17..0f45f6825f6 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -313,8 +313,15 @@ static void extractPathImpl(const ActionsDAG::Node & node, Paths & res, ContextP
         if (!column_set)
             return;
 
-        auto set = column_set->getData();
-        if (!set || !set->isCreated())
+        auto future_set = column_set->getData();
+        if (!future_set)
+            return;
+
+        if (!future_set->isReady())
+            future_set->buildOrderedSetInplace(context);
+
+        auto set = future_set->get();
+        if (!set)
             return;
 
         if (!set->hasExplicitSetElements())
diff --git a/src/Storages/VirtualColumnUtils.cpp b/src/Storages/VirtualColumnUtils.cpp
index 4ff00facfdc..6e7b9ea5849 100644
--- a/src/Storages/VirtualColumnUtils.cpp
+++ b/src/Storages/VirtualColumnUtils.cpp
@@ -80,24 +80,24 @@ ASTPtr buildWhereExpression(const ASTs & functions)
     return makeASTFunction("and", functions);
 }
 
-void buildSets(const ASTPtr & expression, ExpressionAnalyzer & analyzer)
-{
-    const auto * func = expression->as<ASTFunction>();
-    if (func && functionIsInOrGlobalInOperator(func->name))
-    {
-        const IAST & args = *func->arguments;
-        const ASTPtr & arg = args.children.at(1);
-        if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
-        {
-            analyzer.tryMakeSetForIndexFromSubquery(arg);
-        }
-    }
-    else
-    {
-        for (const auto & child : expression->children)
-            buildSets(child, analyzer);
-    }
-}
+// void buildSets(const ASTPtr & expression, ExpressionAnalyzer & analyzer)
+// {
+//     const auto * func = expression->as<ASTFunction>();
+//     if (func && functionIsInOrGlobalInOperator(func->name))
+//     {
+//         const IAST & args = *func->arguments;
+//         const ASTPtr & arg = args.children.at(1);
+//         if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
+//         {
+//             analyzer.tryMakeSetForIndexFromSubquery(arg);
+//         }
+//     }
+//     else
+//     {
+//         for (const auto & child : expression->children)
+//             buildSets(child, analyzer);
+//     }
+// }
 
 }
 
@@ -199,7 +199,7 @@ void filterBlockWithQuery(const ASTPtr & query, Block & block, ContextPtr contex
     /// Let's analyze and calculate the prepared expression.
     auto syntax_result = TreeRewriter(context).analyze(expression_ast, block.getNamesAndTypesList());
     ExpressionAnalyzer analyzer(expression_ast, syntax_result, context);
-    buildSets(expression_ast, analyzer);
+    //buildSets(expression_ast, analyzer);
     ExpressionActionsPtr actions = analyzer.getActions(false /* add alises */, true /* project result */, CompileExpressions::yes);
 
     Block block_with_filter = block;

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 0078/1478] 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 0079/1478] 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 54ef6769f1131e49c87235c6948a39951adeae49 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 5 May 2023 18:30:08 +0000
Subject: [PATCH 0080/1478] Refactor PreparedSets [4]

---
 src/Interpreters/PreparedSets.cpp             |   8 +-
 src/Interpreters/PreparedSets.h               |   3 +-
 src/Planner/PlannerActionsVisitor.cpp         |  20 +-
 .../optimizePrimaryKeyCondition.cpp           |   2 +
 .../QueryPlan/ReadFromMergeTree.cpp           | 173 ++++++++++++------
 src/Processors/QueryPlan/ReadFromMergeTree.h  |  11 +-
 .../QueryPlan/SourceStepWithFilter.h          |   2 +
 .../Transforms/CreatingSetsTransform.cpp      |   1 +
 src/Storages/MergeTree/KeyCondition.cpp       |  10 +-
 .../MergeTree/MergeTreeDataSelectExecutor.cpp |   4 +-
 10 files changed, 160 insertions(+), 74 deletions(-)

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 733eb1c24bb..5d9a0f27496 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -221,7 +221,7 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     if (set)
         return nullptr;
 
-    std::cerr << StackTrace().toString() << std::endl;
+    // std::cerr << StackTrace().toString() << std::endl;
 
     auto set_cache = context->getPreparedSetsCache();
     if (set_cache)
@@ -248,6 +248,10 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     auto plan = subquery.detachSource();
     auto description = subquery.key;
 
+    // WriteBufferFromOwnString buf;
+    // plan->explainPlan(buf, {.header=true});
+    // std::cerr << buf.str() << std::endl;
+
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
             description,
@@ -279,7 +283,7 @@ SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordere
     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
 }
 
-FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) {}
+FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) { std::cerr << block.dumpStructure() << std::endl; }
 
 FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquery(std::move(subquery_)) {}
 
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 8661d81a96a..b4d01754ea8 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -16,6 +16,7 @@
 #include "Processors/Executors/CompletedPipelineExecutor.h"
 #include "Processors/QueryPlan/BuildQueryPipelineSettings.h"
 #include "Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h"
+#include "Processors/Sinks/EmptySink.h"
 #include "Processors/Sinks/NullSink.h"
 #include <QueryPipeline/QueryPipelineBuilder.h>
 
@@ -171,7 +172,7 @@ public:
 
         auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
         auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
-        pipeline.complete(std::make_shared<NullSink>(Block()));
+        pipeline.complete(std::make_shared<EmptySink>(Block()));
 
         CompletedPipelineExecutor executor(pipeline);
         executor.execute();
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index 453b02a2f8f..e0844a6d2b1 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -629,14 +629,20 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
 
     //auto set_key = planner_context->createSetKey(in_second_argument);
 
-    DataTypes set_element_types = {in_first_argument->getResultType()};
-    const auto * left_tuple_type = typeid_cast<const DataTypeTuple *>(set_element_types.front().get());
-    if (left_tuple_type && left_tuple_type->getElements().size() != 1)
-        set_element_types = left_tuple_type->getElements();
+    DataTypes set_element_types;
 
-    for (auto & element_type : set_element_types)
-        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-            element_type = low_cardinality_type->getDictionaryType();
+    auto in_second_argument_node_type = in_second_argument->getNodeType();
+    if (!(in_second_argument_node_type == QueryTreeNodeType::QUERY || in_second_argument_node_type == QueryTreeNodeType::UNION))
+    {
+        set_element_types = {in_first_argument->getResultType()};
+        const auto * left_tuple_type = typeid_cast<const DataTypeTuple *>(set_element_types.front().get());
+        if (left_tuple_type && left_tuple_type->getElements().size() != 1)
+            set_element_types = left_tuple_type->getElements();
+
+        for (auto & element_type : set_element_types)
+            if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+                element_type = low_cardinality_type->getDictionaryType();
+    }
 
     auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
 
diff --git a/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp b/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
index e98386a6ee9..5ef786ff975 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
@@ -28,6 +28,8 @@ void optimizePrimaryKeyCondition(const Stack & stack)
         else
             break;
     }
+
+    source_step_with_filter->onAddFilterFinish();
 }
 
 }
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 185ec9bace8..ad63b486c7c 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -247,7 +247,7 @@ ReadFromMergeTree::ReadFromMergeTree(
 
     { /// build sort description for output stream
         SortDescription sort_description;
-        const Names & sorting_key_columns = storage_snapshot->getMetadataForQuery()->getSortingKeyColumns();
+        const Names & sorting_key_columns = metadata_for_reading->getSortingKeyColumns();
         const Block & header = output_stream->header;
         const int sort_direction = getSortDirection();
         for (const auto & column_name : sorting_key_columns)
@@ -1118,7 +1118,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(Merge
         prewhere_info,
         filter_nodes,
         storage_snapshot->metadata,
-        storage_snapshot->getMetadataForQuery(),
+        metadata_for_reading,
         query_info,
         context,
         requested_num_streams,
@@ -1126,7 +1126,90 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(Merge
         data,
         real_column_names,
         sample_factor_column_queried,
-        log);
+        log,
+        key_condition);
+}
+
+static ActionsDAGPtr buildFilterDAG(
+    const ContextPtr & context,
+    const PrewhereInfoPtr & prewhere_info,
+    const ActionDAGNodes & added_filter_nodes,
+    const SelectQueryInfo & query_info)
+{
+    const auto & settings = context->getSettingsRef();
+    ActionsDAG::NodeRawConstPtrs nodes;
+
+    if (prewhere_info)
+    {
+        {
+            const auto & node = prewhere_info->prewhere_actions->findInOutputs(prewhere_info->prewhere_column_name);
+            nodes.push_back(&node);
+        }
+
+        if (prewhere_info->row_level_filter)
+        {
+            const auto & node = prewhere_info->row_level_filter->findInOutputs(prewhere_info->row_level_column_name);
+            nodes.push_back(&node);
+        }
+    }
+
+    for (const auto & node : added_filter_nodes.nodes)
+        nodes.push_back(node);
+
+    std::unordered_map<std::string, ColumnWithTypeAndName> node_name_to_input_node_column;
+
+    if (settings.allow_experimental_analyzer && query_info.planner_context)
+    {
+        const auto & table_expression_data = query_info.planner_context->getTableExpressionDataOrThrow(query_info.table_expression);
+        for (const auto & [column_identifier, column_name] : table_expression_data.getColumnIdentifierToColumnName())
+        {
+            const auto & column = table_expression_data.getColumnOrThrow(column_name);
+            node_name_to_input_node_column.emplace(column_identifier, ColumnWithTypeAndName(column.type, column_name));
+        }
+    }
+
+    return ActionsDAG::buildFilterActionsDAG(nodes, node_name_to_input_node_column, context);
+}
+
+static void buildKeyCondition(
+    std::optional<KeyCondition> & key_condition,
+    ActionsDAGPtr filter_actions_dag,
+    const ContextPtr & context,
+    const SelectQueryInfo & query_info,
+    const StorageMetadataPtr & metadata_snapshot)
+{
+    key_condition.reset();
+
+    // Build and check if primary key is used when necessary
+    const auto & primary_key = metadata_snapshot->getPrimaryKey();
+    const Names & primary_key_column_names = primary_key.column_names;
+
+    const auto & settings = context->getSettingsRef();
+    if (settings.query_plan_optimize_primary_key)
+    {
+        NameSet array_join_name_set;
+        if (query_info.syntax_analyzer_result)
+            array_join_name_set = query_info.syntax_analyzer_result->getArrayJoinSourceNameSet();
+
+        key_condition.emplace(filter_actions_dag,
+            context,
+            primary_key_column_names,
+            primary_key.expression,
+            array_join_name_set);
+    }
+    else
+    {
+        key_condition.emplace(query_info, context, primary_key_column_names, primary_key.expression);
+    }
+}
+
+void ReadFromMergeTree::onAddFilterFinish()
+{
+    if (!filter_nodes.nodes.empty())
+    {
+        auto filter_actions_dag = buildFilterDAG(context, prewhere_info, filter_nodes, query_info);
+        buildKeyCondition(key_condition, filter_actions_dag, context, query_info, metadata_for_reading);
+    }
 }
 
 MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
@@ -1142,44 +1225,14 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
     const MergeTreeData & data,
     const Names & real_column_names,
     bool sample_factor_column_queried,
-    Poco::Logger * log)
+    Poco::Logger * log,
+    std::optional<KeyCondition> & key_condition)
 {
     const auto & settings = context->getSettingsRef();
     if (settings.allow_experimental_analyzer || settings.query_plan_optimize_primary_key)
     {
-        ActionsDAG::NodeRawConstPtrs nodes;
-
-        if (prewhere_info)
-        {
-            {
-                const auto & node = prewhere_info->prewhere_actions->findInOutputs(prewhere_info->prewhere_column_name);
-                nodes.push_back(&node);
-            }
-
-            if (prewhere_info->row_level_filter)
-            {
-                const auto & node = prewhere_info->row_level_filter->findInOutputs(prewhere_info->row_level_column_name);
-                nodes.push_back(&node);
-            }
-        }
-
-        for (const auto & node : added_filter_nodes.nodes)
-            nodes.push_back(node);
-
-        std::unordered_map<std::string, ColumnWithTypeAndName> node_name_to_input_node_column;
-
-        if (settings.allow_experimental_analyzer && query_info.planner_context)
-        {
-            const auto & table_expression_data = query_info.planner_context->getTableExpressionDataOrThrow(query_info.table_expression);
-            for (const auto & [column_identifier, column_name] : table_expression_data.getColumnIdentifierToColumnName())
-            {
-                const auto & column = table_expression_data.getColumnOrThrow(column_name);
-                node_name_to_input_node_column.emplace(column_identifier, ColumnWithTypeAndName(column.type, column_name));
-            }
-        }
-
         auto updated_query_info_with_filter_dag = query_info;
-        updated_query_info_with_filter_dag.filter_actions_dag = ActionsDAG::buildFilterActionsDAG(nodes, node_name_to_input_node_column, context);
+        updated_query_info_with_filter_dag.filter_actions_dag = buildFilterDAG(context, prewhere_info, added_filter_nodes, query_info);
 
         return selectRangesToReadImpl(
             parts,
@@ -1192,7 +1245,8 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
             data,
             real_column_names,
             sample_factor_column_queried,
-            log);
+            log,
+            key_condition);
     }
 
     return selectRangesToReadImpl(
@@ -1206,7 +1260,8 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
         data,
         real_column_names,
         sample_factor_column_queried,
-        log);
+        log,
+        key_condition);
 }
 
 MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
@@ -1220,7 +1275,8 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     const MergeTreeData & data,
     const Names & real_column_names,
     bool sample_factor_column_queried,
-    Poco::Logger * log)
+    Poco::Logger * log,
+    std::optional<KeyCondition> & key_condition)
 {
     AnalysisResult result;
     const auto & settings = context->getSettingsRef();
@@ -1246,24 +1302,29 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     // Build and check if primary key is used when necessary
     const auto & primary_key = metadata_snapshot->getPrimaryKey();
     const Names & primary_key_column_names = primary_key.column_names;
-    std::optional<KeyCondition> key_condition;
 
-    if (settings.query_plan_optimize_primary_key)
-    {
-        NameSet array_join_name_set;
-        if (query_info.syntax_analyzer_result)
-            array_join_name_set = query_info.syntax_analyzer_result->getArrayJoinSourceNameSet();
+    // if (!key_condition)
+    // {
+    //     if (settings.query_plan_optimize_primary_key)
+    //     {
+    //         NameSet array_join_name_set;
+    //         if (query_info.syntax_analyzer_result)
+    //             array_join_name_set = query_info.syntax_analyzer_result->getArrayJoinSourceNameSet();
 
-        key_condition.emplace(query_info.filter_actions_dag,
-            context,
-            primary_key_column_names,
-            primary_key.expression,
-            array_join_name_set);
-    }
-    else
-    {
-        key_condition.emplace(query_info, context, primary_key_column_names, primary_key.expression);
-    }
+    //         key_condition.emplace(query_info.filter_actions_dag,
+    //             context,
+    //             primary_key_column_names,
+    //             primary_key.expression,
+    //             array_join_name_set);
+    //     }
+    //     else
+    //     {
+    //         key_condition.emplace(query_info, context, primary_key_column_names, primary_key.expression);
+    //     }
+    // }
+
+    if (!key_condition)
+        buildKeyCondition(key_condition, query_info.filter_actions_dag, context, query_info, metadata_snapshot);
 
     if (settings.force_primary_key && key_condition->alwaysUnknownOrTrue())
     {
@@ -1395,7 +1456,7 @@ bool ReadFromMergeTree::requestReadingInOrder(size_t prefix_size, int direction,
 
     /// update sort info for output stream
     SortDescription sort_description;
-    const Names & sorting_key_columns = storage_snapshot->getMetadataForQuery()->getSortingKeyColumns();
+    const Names & sorting_key_columns = metadata_for_reading->getSortingKeyColumns();
     const Block & header = output_stream->header;
     const int sort_direction = getSortDirection();
     for (const auto & column_name : sorting_key_columns)
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index 5e4ba117967..121970f2ca9 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -145,7 +145,8 @@ public:
         const MergeTreeData & data,
         const Names & real_column_names,
         bool sample_factor_column_queried,
-        Poco::Logger * log);
+        Poco::Logger * log,
+        std::optional<KeyCondition> & key_condition);
 
     MergeTreeDataSelectAnalysisResultPtr selectRangesToRead(MergeTreeData::DataPartsVector parts) const;
 
@@ -177,6 +178,8 @@ public:
     size_t getNumStreams() const { return requested_num_streams; }
     bool isParallelReadingEnabled() const { return read_task_callback != std::nullopt; }
 
+    void onAddFilterFinish() override;
+
 private:
     static MergeTreeDataSelectAnalysisResultPtr selectRangesToReadImpl(
         MergeTreeData::DataPartsVector parts,
@@ -189,7 +192,8 @@ private:
         const MergeTreeData & data,
         const Names & real_column_names,
         bool sample_factor_column_queried,
-        Poco::Logger * log);
+        Poco::Logger * log,
+        std::optional<KeyCondition> & key_condition);
 
     int getSortDirection() const
     {
@@ -228,6 +232,9 @@ private:
 
     std::shared_ptr<PartitionIdToMaxBlock> max_block_numbers_to_read;
 
+    /// Pre-computed value, needed to trigger sets creatin for PK
+    mutable std::optional<KeyCondition> key_condition;
+
     Poco::Logger * log;
     UInt64 selected_parts = 0;
     UInt64 selected_rows = 0;
diff --git a/src/Processors/QueryPlan/SourceStepWithFilter.h b/src/Processors/QueryPlan/SourceStepWithFilter.h
index a363451fff2..34b6e3c6a7b 100644
--- a/src/Processors/QueryPlan/SourceStepWithFilter.h
+++ b/src/Processors/QueryPlan/SourceStepWithFilter.h
@@ -37,6 +37,8 @@ public:
         filter_dags.push_back(std::move(filter_dag));
     }
 
+    virtual void onAddFilterFinish() {}
+
 protected:
     std::vector<ActionsDAGPtr> filter_dags;
     ActionDAGNodes filter_nodes;
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index de10be599c8..6626d4b9795 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -133,6 +133,7 @@ void CreatingSetsTransform::init()
 
     if (subquery.set)
     {
+        //std::cerr << "=========== " << getInputPort().getHeader().dumpStructure() << std::endl;
         subquery.set->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
     }
 
diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index 7a1c3b10c8a..efeb9e40dd4 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1204,17 +1204,17 @@ bool KeyCondition::tryPrepareSetIndex(
 
     const auto right_arg = func.getArgumentAt(1);
 
-    LOG_TRACE(&Poco::Logger::get("KK"), "Trying to get set for {}", right_arg.getColumnName());
+    // LOG_TRACE(&Poco::Logger::get("KK"), "Trying to get set for {}", right_arg.getColumnName());
 
     auto future_set = right_arg.tryGetPreparedSet(indexes_mapping, data_types);
     if (!future_set)
         return false;
 
-    LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
+    // LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
 
     if (!future_set->isReady())
     {
-        LOG_TRACE(&Poco::Logger::get("KK"), "Building set inplace for {}", right_arg.getColumnName());
+        // LOG_TRACE(&Poco::Logger::get("KK"), "Building set inplace for {}", right_arg.getColumnName());
         future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
     }
 
@@ -1222,13 +1222,13 @@ bool KeyCondition::tryPrepareSetIndex(
     if (!prepared_set)
         return false;
 
-    LOG_TRACE(&Poco::Logger::get("KK"), "Set if ready for {}", right_arg.getColumnName());
+    // LOG_TRACE(&Poco::Logger::get("KK"), "Set if ready for {}", right_arg.getColumnName());
 
     /// The index can be prepared if the elements of the set were saved in advance.
     if (!prepared_set->hasExplicitSetElements())
         return false;
 
-    LOG_TRACE(&Poco::Logger::get("KK"), "Has explicit elements for {}", right_arg.getColumnName());
+    // LOG_TRACE(&Poco::Logger::get("KK"), "Has explicit elements for {}", right_arg.getColumnName());
 
     prepared_set->checkColumnsNumber(left_args_count);
     for (size_t i = 0; i < indexes_mapping.size(); ++i)
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 22df8f298c4..aae8f843a3c 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -1291,6 +1291,7 @@ MergeTreeDataSelectAnalysisResultPtr MergeTreeDataSelectExecutor::estimateNumMar
 
     selectColumnNames(column_names_to_return, data, real_column_names, virt_column_names, sample_factor_column_queried);
 
+    std::optional<KeyCondition> key_condition;
     return ReadFromMergeTree::selectRangesToRead(
         std::move(parts),
         prewhere_info,
@@ -1304,7 +1305,8 @@ MergeTreeDataSelectAnalysisResultPtr MergeTreeDataSelectExecutor::estimateNumMar
         data,
         real_column_names,
         sample_factor_column_queried,
-        log);
+        log,
+        key_condition);
 }
 
 QueryPlanStepPtr MergeTreeDataSelectExecutor::readFromParts(

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 0081/1478] 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 0082/1478] 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 b2c36fc3e5a968cd3223261585cb00f89be2c783 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 5 May 2023 20:51:38 +0000
Subject: [PATCH 0083/1478] Fixing style.

---
 src/Interpreters/PreparedSets.cpp            | 7 ++++++-
 src/Processors/QueryPlan/ReadFromMergeTree.h | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 5d9a0f27496..1d7d90432b0 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -11,6 +11,11 @@
 namespace DB
 {
 
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
 PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
 {
     /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
@@ -283,7 +288,7 @@ SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordere
     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
 }
 
-FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) { std::cerr << block.dumpStructure() << std::endl; }
+FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) {}
 
 FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquery(std::move(subquery_)) {}
 
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index 121970f2ca9..f13f75bfebc 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -232,7 +232,7 @@ private:
 
     std::shared_ptr<PartitionIdToMaxBlock> max_block_numbers_to_read;
 
-    /// Pre-computed value, needed to trigger sets creatin for PK
+    /// Pre-computed value, needed to trigger sets creating for PK
     mutable std::optional<KeyCondition> key_condition;
 
     Poco::Logger * log;

From fc02e9efc9eb2dcb9b7209e41eafb1e50abced7d Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Mon, 8 May 2023 17:23:46 +0000
Subject: [PATCH 0084/1478] update fasttest a bit

---
 tests/ci/fast_test_check.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/tests/ci/fast_test_check.py b/tests/ci/fast_test_check.py
index 89066ade2cb..fe211d79810 100644
--- a/tests/ci/fast_test_check.py
+++ b/tests/ci/fast_test_check.py
@@ -214,8 +214,11 @@ def main():
 
     # Refuse other checks to run if fast test failed
     if state != "success":
-        if FORCE_TESTS_LABEL in pr_info.labels and state != "error":
-            print(f"'{FORCE_TESTS_LABEL}' enabled, will report success")
+        if state == "error":
+            print("The status is 'error', report failure disregard the labels")
+            sys.exit(1)
+        elif FORCE_TESTS_LABEL in pr_info.labels:
+            print(f"'{FORCE_TESTS_LABEL}' enabled, reporting success")
         else:
             sys.exit(1)
 

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 0085/1478] 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 0086/1478] 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 0087/1478] 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 0088/1478] 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 0089/1478] 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 0090/1478] 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 0091/1478] 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 0092/1478] 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 0093/1478] 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 0094/1478] 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 0095/1478] 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 0096/1478] 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 0097/1478] 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 0098/1478] 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 0099/1478] 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 0100/1478] 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 0101/1478] 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 0102/1478] 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 0103/1478] 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 0104/1478] 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 0105/1478] 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 bf6afd27a655bb159583af2020113e101ca82e00 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 17 May 2023 13:32:51 +0000
Subject: [PATCH 0106/1478] build with disks

---
 programs/keeper-converter/KeeperConverter.cpp |   4 +-
 programs/keeper/CMakeLists.txt                |  58 +++-
 programs/keeper/Keeper.cpp                    |  13 +
 programs/server/config.d/users.xml            |  26 ++
 src/Coordination/Context/Context.cpp          | 259 ++++++++++++++++++
 src/Coordination/Context/Context.h            | 111 ++++++++
 src/Coordination/Context/Settings.cpp         |  24 ++
 src/Coordination/Context/ThreadStatusExt.cpp  |  14 +
 src/Coordination/CoordinationSettings.cpp     |  60 ----
 src/Coordination/CoordinationSettings.h       |   9 -
 src/Coordination/KeeperContext.cpp            | 104 +++++++
 src/Coordination/KeeperContext.h              |  37 ++-
 src/Coordination/KeeperDispatcher.cpp         |   6 +-
 src/Coordination/KeeperServer.cpp             |  33 ++-
 src/Coordination/KeeperSnapshotManager.cpp    |  14 +-
 src/Coordination/KeeperStateMachine.cpp       |   6 +-
 src/Coordination/KeeperStorage.cpp            |  46 ++--
 src/Coordination/ZooKeeperDataReader.cpp      |   4 +-
 src/Coordination/pathUtils.cpp                |   4 +-
 src/Coordination/pathUtils.h                  |   4 +-
 src/Coordination/tests/gtest_coordination.cpp |   2 +-
 src/Core/SettingsFields.cpp                   |  29 ++
 src/Core/SettingsFields.h                     |  16 +-
 src/Disks/IO/ReadBufferFromRemoteFSGather.cpp |   2 +
 src/Disks/IO/getThreadPoolReader.cpp          |  24 --
 .../ObjectStorages/DiskObjectStorage.cpp      |  19 --
 src/Disks/ObjectStorages/DiskObjectStorage.h  |  14 +-
 .../ObjectStorages/DiskObjectStorageCache.cpp |  28 ++
 src/Disks/registerDisks.cpp                   |  17 ++
 src/Interpreters/Context.h                    |   8 +
 30 files changed, 807 insertions(+), 188 deletions(-)
 create mode 100644 programs/server/config.d/users.xml
 create mode 100644 src/Coordination/Context/Context.cpp
 create mode 100644 src/Coordination/Context/Context.h
 create mode 100644 src/Coordination/Context/Settings.cpp
 create mode 100644 src/Coordination/Context/ThreadStatusExt.cpp
 create mode 100644 src/Coordination/KeeperContext.cpp
 create mode 100644 src/Disks/ObjectStorages/DiskObjectStorageCache.cpp

diff --git a/programs/keeper-converter/KeeperConverter.cpp b/programs/keeper-converter/KeeperConverter.cpp
index c81e61685fd..58d090ca8b9 100644
--- a/programs/keeper-converter/KeeperConverter.cpp
+++ b/programs/keeper-converter/KeeperConverter.cpp
@@ -40,8 +40,8 @@ int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
 
     try
     {
-        auto keeper_context = std::make_shared<KeeperContext>();
-        keeper_context->digest_enabled = true;
+        auto keeper_context = std::make_shared<KeeperContext>(true);
+        keeper_context->setDigestEnabled(true);
 
         DB::KeeperStorage storage(/* tick_time_ms */ 500, /* superdigest */ "", keeper_context, /* initialize_system_nodes */ false);
 
diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index e5d56023f7b..c0c0a6dd1b0 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -46,6 +46,7 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManager.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManagerS3.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStateMachine.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperContext.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStateManager.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStorage.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperAsynchronousMetrics.cpp
@@ -58,10 +59,14 @@ if (BUILD_STANDALONE_KEEPER)
 
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/SettingsFields.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/BaseSettings.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/ServerSettings.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/Field.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/SettingsEnums.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/ServerUUID.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/UUID.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Core/BackgroundSchedulePool.cpp
+
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/IO/ReadBuffer.cpp
 
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Server/KeeperTCPHandler.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Server/TCPServer.cpp
@@ -92,6 +97,10 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Compression/ICompressionCodec.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Compression/LZ4_decompress_faster.cpp
 
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/CurrentThread.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/NamedCollections/NamedCollections.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/NamedCollections/NamedCollectionConfiguration.cpp
+
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/ZooKeeper/IKeeper.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/ZooKeeper/TestKeeper.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/ZooKeeper/ZooKeeperCommon.cpp
@@ -102,11 +111,56 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/ZooKeeper/ZooKeeperLock.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Common/ZooKeeper/ZooKeeperNodeCache.cpp
 
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/registerDisks.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IDisk.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/DiskFactory.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/DiskSelector.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/DiskLocal.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/DiskLocalCheckThread.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/LocalDirectorySyncGuard.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/TemporaryFileOnDisk.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/loadLocalDiskConfig.cpp
+
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/IObjectStorage.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/MetadataStorageFromDisk.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/MetadataFromDiskTransactionState.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageMetadata.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/MetadataStorageFromDiskTransactionOperations.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorage.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageRemoteMetadataRestoreHelper.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageCommon.cpp
+
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/registerDiskS3.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/S3Capabilities.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/diskSettings.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/ProxyListConfiguration.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/ProxyResolverConfiguration.cpp
+
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/createReadBufferFromFileBase.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/IOUringReader.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferFromTemporaryFile.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/AsynchronousReadIndirectBufferFromRemoteFS.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteIndirectBufferFromRemoteFS.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/getThreadPoolReader.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolRemoteFSReader.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolReader.cpp
+
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Storages/StorageS3Settings.cpp
+
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/BaseDaemon.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/SentryWriter.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/GraphiteWriter.cpp
         ${CMAKE_CURRENT_BINARY_DIR}/../../src/Daemon/GitHash.generated.cpp
 
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/Context.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/Settings.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/ThreadStatusExt.cpp
+
         Keeper.cpp
         clickhouse-keeper.cpp
     )
@@ -117,10 +171,6 @@ if (BUILD_STANDALONE_KEEPER)
     target_compile_definitions (clickhouse-keeper PRIVATE -DCLICKHOUSE_PROGRAM_STANDALONE_BUILD)
     target_compile_definitions (clickhouse-keeper PUBLIC -DWITHOUT_TEXT_LOG)
 
-    target_include_directories(clickhouse-keeper PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/../../src") # uses includes from src directory
-    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
-
     target_link_libraries(clickhouse-keeper
         PRIVATE
             ch_contrib::abseil_swiss_tables
diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index 3d1773260f5..996c4678450 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -21,6 +21,8 @@
 #include <sys/stat.h>
 #include <pwd.h>
 
+#include <Interpreters/Context.h>
+
 #include <Coordination/FourLetterCommand.h>
 #include <Coordination/KeeperAsynchronousMetrics.h>
 
@@ -40,6 +42,8 @@
 #include <Server/ProtocolServerAdapter.h>
 #include <Server/KeeperTCPHandlerFactory.h>
 
+#include <Disks/registerDisks.h>
+
 
 int mainEntryClickHouseKeeper(int argc, char ** argv)
 {
@@ -408,6 +412,15 @@ try
     std::mutex servers_lock;
     auto servers = std::make_shared<std::vector<ProtocolServerAdapter>>();
 
+    auto shared_context = Context::createShared();
+    auto global_context = Context::createGlobal(shared_context.get());
+
+    global_context->makeGlobalContext();
+    global_context->setPath(path);
+    global_context->setRemoteHostFilter(config());
+
+    registerDisks(/*global_skip_access_check=*/false);
+
     tiny_context = std::make_shared<TinyContext>();
     /// This object will periodically calculate some metrics.
     KeeperAsynchronousMetrics async_metrics(
diff --git a/programs/server/config.d/users.xml b/programs/server/config.d/users.xml
new file mode 100644
index 00000000000..d8a62b45baa
--- /dev/null
+++ b/programs/server/config.d/users.xml
@@ -0,0 +1,26 @@
+<clickhouse>
+    <profiles>
+        <default>
+            <max_memory_usage>10000000000</max_memory_usage>
+            <force_index_by_date>0</force_index_by_date>
+            <replication_alter_partitions_sync>2</replication_alter_partitions_sync>
+            <constraints>
+                <max_memory_usage>
+                    <min>5000000000</min>
+                    <max>20000000000</max>
+                </max_memory_usage>
+               <force_index_by_date>
+                   <readonly/>
+               </force_index_by_date>
+               <replication_alter_partitions_sync>
+                   <readonly/>
+               </replication_alter_partitions_sync>
+            </constraints>
+        </default>
+    </profiles>
+    <users>
+        <readonly>
+            <profile>default</profile>
+        </readonly>
+    </users>
+</clickhouse>
diff --git a/src/Coordination/Context/Context.cpp b/src/Coordination/Context/Context.cpp
new file mode 100644
index 00000000000..aeb4e405938
--- /dev/null
+++ b/src/Coordination/Context/Context.cpp
@@ -0,0 +1,259 @@
+#include <Interpreters/Context.h>
+
+#include <Common/Config/ConfigProcessor.h>
+#include <Common/Macros.h>
+#include <Common/ThreadPool.h>
+
+#include <Core/ServerSettings.h>
+
+#include <boost/noncopyable.hpp>
+
+#include <memory>
+#include <cassert>
+
+namespace ProfileEvents
+{
+    extern const Event ContextLock;
+}
+
+namespace CurrentMetrics
+{
+    extern const Metric ContextLockWait;
+    extern const Metric BackgroundSchedulePoolTask;
+    extern const Metric BackgroundSchedulePoolSize;
+    extern const Metric IOWriterThreads;
+    extern const Metric IOWriterThreadsActive;
+}
+
+namespace DB
+{
+
+
+struct ContextSharedPart : boost::noncopyable
+{
+    ContextSharedPart()
+        : macros(std::make_unique<Macros>())
+    {}
+
+    /// For access of most of shared objects. Recursive mutex.
+    mutable std::recursive_mutex mutex;
+
+    ServerSettings server_settings;
+
+    String path;                                            /// Path to the data directory, with a slash at the end.
+    ConfigurationPtr config;                                /// Global configuration settings.
+    MultiVersion<Macros> macros;                            /// Substitutions extracted from config.
+    mutable std::unique_ptr<BackgroundSchedulePool> schedule_pool;    /// A thread pool that can run different jobs in background
+    RemoteHostFilter remote_host_filter; /// Allowed URL from config.xml
+                                         ///
+    mutable std::unique_ptr<IAsynchronousReader> asynchronous_remote_fs_reader;
+    mutable std::unique_ptr<IAsynchronousReader> asynchronous_local_fs_reader;
+    mutable std::unique_ptr<IAsynchronousReader> synchronous_local_fs_reader;
+
+    mutable std::unique_ptr<ThreadPool> threadpool_writer;
+
+    mutable ThrottlerPtr remote_read_throttler;             /// A server-wide throttler for remote IO reads
+    mutable ThrottlerPtr remote_write_throttler;            /// A server-wide throttler for remote IO writes
+
+    mutable ThrottlerPtr local_read_throttler;              /// A server-wide throttler for local IO reads
+    mutable ThrottlerPtr local_write_throttler;             /// A server-wide throttler for local IO writes
+
+};
+
+Context::Context() = default;
+Context::~Context() = default;
+Context::Context(const Context &) = default;
+Context & Context::operator=(const Context &) = default;
+
+SharedContextHolder::SharedContextHolder(SharedContextHolder &&) noexcept = default;
+SharedContextHolder & SharedContextHolder::operator=(SharedContextHolder &&) noexcept = default;
+SharedContextHolder::SharedContextHolder() = default;
+SharedContextHolder::~SharedContextHolder() = default;
+SharedContextHolder::SharedContextHolder(std::unique_ptr<ContextSharedPart> shared_context)
+    : shared(std::move(shared_context)) {}
+
+void SharedContextHolder::reset() { shared.reset(); }
+
+void Context::makeGlobalContext()
+{
+    initGlobal();
+    global_context = shared_from_this();
+}
+
+ContextMutablePtr Context::createGlobal(ContextSharedPart * shared)
+{
+    auto res = std::shared_ptr<Context>(new Context);
+    res->shared = shared;
+    return res;
+}
+
+void Context::initGlobal()
+{
+    assert(!global_context_instance);
+    global_context_instance = shared_from_this();
+}
+
+SharedContextHolder Context::createShared()
+{
+    return SharedContextHolder(std::make_unique<ContextSharedPart>());
+}
+
+ContextMutablePtr Context::getGlobalContext() const
+{
+    auto ptr = global_context.lock();
+    if (!ptr) throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no global context or global context has expired");
+    return ptr;
+}
+
+std::unique_lock<std::recursive_mutex> Context::getLock() const
+{
+    ProfileEvents::increment(ProfileEvents::ContextLock);
+    CurrentMetrics::Increment increment{CurrentMetrics::ContextLockWait};
+    return std::unique_lock(shared->mutex);
+}
+
+String Context::getPath() const
+{
+    auto lock = getLock();
+    return shared->path;
+}
+
+void Context::setPath(const String & path)
+{
+    auto lock = getLock();
+    shared->path = path;
+}
+
+MultiVersion<Macros>::Version Context::getMacros() const
+{
+    return shared->macros.get();
+}
+
+BackgroundSchedulePool & Context::getSchedulePool() const
+{
+    auto lock = getLock();
+    if (!shared->schedule_pool)
+    {
+        shared->schedule_pool = std::make_unique<BackgroundSchedulePool>(
+            shared->server_settings.background_schedule_pool_size,
+            CurrentMetrics::BackgroundSchedulePoolTask,
+            CurrentMetrics::BackgroundSchedulePoolSize,
+            "BgSchPool");
+    }
+
+    return *shared->schedule_pool;
+}
+
+void Context::setRemoteHostFilter(const Poco::Util::AbstractConfiguration & config)
+{
+    shared->remote_host_filter.setValuesFromConfig(config);
+}
+
+const RemoteHostFilter & Context::getRemoteHostFilter() const
+{
+    return shared->remote_host_filter;
+}
+
+IAsynchronousReader & Context::getThreadPoolReader(FilesystemReaderType type) const
+{
+    auto lock = getLock();
+
+    switch (type)
+    {
+        case FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER:
+        {
+            if (!shared->asynchronous_remote_fs_reader)
+                shared->asynchronous_remote_fs_reader = createThreadPoolReader(type, getConfigRef());
+            return *shared->asynchronous_remote_fs_reader;
+        }
+        case FilesystemReaderType::ASYNCHRONOUS_LOCAL_FS_READER:
+        {
+            if (!shared->asynchronous_local_fs_reader)
+                shared->asynchronous_local_fs_reader = createThreadPoolReader(type, getConfigRef());
+
+            return *shared->asynchronous_local_fs_reader;
+        }
+        case FilesystemReaderType::SYNCHRONOUS_LOCAL_FS_READER:
+        {
+            if (!shared->synchronous_local_fs_reader)
+                shared->synchronous_local_fs_reader = createThreadPoolReader(type, getConfigRef());
+
+            return *shared->synchronous_local_fs_reader;
+        }
+    }
+}
+
+std::shared_ptr<FilesystemCacheLog> Context::getFilesystemCacheLog() const
+{
+    return nullptr;
+}
+
+std::shared_ptr<FilesystemReadPrefetchesLog> Context::getFilesystemReadPrefetchesLog() const
+{
+    return nullptr;
+}
+
+void Context::setConfig(const ConfigurationPtr & config)
+{
+    auto lock = getLock();
+    shared->config = config;
+}
+
+const Poco::Util::AbstractConfiguration & Context::getConfigRef() const
+{
+    auto lock = getLock();
+    return shared->config ? *shared->config : Poco::Util::Application::instance().config();
+}
+
+std::shared_ptr<AsyncReadCounters> Context::getAsyncReadCounters() const
+{
+    auto lock = getLock();
+    if (!async_read_counters)
+        async_read_counters = std::make_shared<AsyncReadCounters>();
+    return async_read_counters;
+}
+
+ThreadPool & Context::getThreadPoolWriter() const
+{
+    const auto & config = getConfigRef();
+
+    auto lock = getLock();
+
+    if (!shared->threadpool_writer)
+    {
+        auto pool_size = config.getUInt(".threadpool_writer_pool_size", 100);
+        auto queue_size = config.getUInt(".threadpool_writer_queue_size", 1000000);
+
+        shared->threadpool_writer = std::make_unique<ThreadPool>(
+            CurrentMetrics::IOWriterThreads, CurrentMetrics::IOWriterThreadsActive, pool_size, pool_size, queue_size);
+    }
+
+    return *shared->threadpool_writer;
+}
+
+ThrottlerPtr Context::getRemoteReadThrottler() const
+{
+    return nullptr;
+}
+
+ThrottlerPtr Context::getRemoteWriteThrottler() const
+{
+    return nullptr;
+}
+
+ThrottlerPtr Context::getLocalReadThrottler() const
+{
+    return nullptr;
+}
+
+ThrottlerPtr Context::getLocalWriteThrottler() const
+{
+    return nullptr;
+}
+
+ReadSettings Context::getReadSettings() const
+{
+    return ReadSettings{};
+}
+
+}
diff --git a/src/Coordination/Context/Context.h b/src/Coordination/Context/Context.h
new file mode 100644
index 00000000000..683209d942e
--- /dev/null
+++ b/src/Coordination/Context/Context.h
@@ -0,0 +1,111 @@
+#pragma once
+
+#include <Interpreters/Context_fwd.h>
+
+#include <Common/MultiVersion.h>
+#include <Common/RemoteHostFilter.h>
+
+#include <Disks/IO/getThreadPoolReader.h>
+
+#include <Core/Settings.h>
+#include <Core/BackgroundSchedulePool.h>
+
+#include <IO/AsyncReadCounters.h>
+
+#include <Poco/Util/Application.h>
+
+#include <memory>
+
+namespace DB
+{
+
+struct ContextSharedPart;
+class Macros;
+class FilesystemCacheLog;
+class FilesystemReadPrefetchesLog;
+
+/// A small class which owns ContextShared.
+/// We don't use something like unique_ptr directly to allow ContextShared type to be incomplete.
+struct SharedContextHolder
+{
+    ~SharedContextHolder();
+    SharedContextHolder();
+    explicit SharedContextHolder(std::unique_ptr<ContextSharedPart> shared_context);
+    SharedContextHolder(SharedContextHolder &&) noexcept;
+
+    SharedContextHolder & operator=(SharedContextHolder &&) noexcept;
+
+    ContextSharedPart * get() const { return shared.get(); }
+    void reset();
+private:
+    std::unique_ptr<ContextSharedPart> shared;
+};
+
+
+class Context : public std::enable_shared_from_this<Context>
+{
+private:
+    /// Use copy constructor or createGlobal() instead
+    Context();
+    Context(const Context &);
+    Context & operator=(const Context &);
+
+    std::unique_lock<std::recursive_mutex> getLock() const;
+
+    ContextWeakMutablePtr global_context;
+    inline static ContextPtr global_context_instance;
+    ContextSharedPart * shared;
+
+    /// Query metrics for reading data asynchronously with IAsynchronousReader.
+    mutable std::shared_ptr<AsyncReadCounters> async_read_counters;
+
+    Settings settings;  /// Setting for query execution.
+public:
+    /// Create initial Context with ContextShared and etc.
+    static ContextMutablePtr createGlobal(ContextSharedPart * shared);
+    static SharedContextHolder createShared();
+
+    ContextMutablePtr getGlobalContext() const;
+    static ContextPtr getGlobalContextInstance() { return global_context_instance; }
+
+    void makeGlobalContext();
+    void initGlobal();
+
+    ~Context();
+
+    using ConfigurationPtr = Poco::AutoPtr<Poco::Util::AbstractConfiguration>;
+
+    /// Global application configuration settings.
+    void setConfig(const ConfigurationPtr & config);
+    const Poco::Util::AbstractConfiguration & getConfigRef() const;
+
+    const Settings & getSettingsRef() const { return settings; }
+
+    String getPath() const;
+    void setPath(const String & path);
+
+    MultiVersion<Macros>::Version getMacros() const;
+
+    BackgroundSchedulePool & getSchedulePool() const;
+
+    /// Storage of allowed hosts from config.xml
+    void setRemoteHostFilter(const Poco::Util::AbstractConfiguration & config);
+    const RemoteHostFilter & getRemoteHostFilter() const;
+
+    std::shared_ptr<FilesystemCacheLog> getFilesystemCacheLog() const;
+    std::shared_ptr<FilesystemReadPrefetchesLog> getFilesystemReadPrefetchesLog() const;
+
+    IAsynchronousReader & getThreadPoolReader(FilesystemReaderType type) const;
+    std::shared_ptr<AsyncReadCounters> getAsyncReadCounters() const;
+    ThreadPool & getThreadPoolWriter() const;
+
+    ThrottlerPtr getRemoteReadThrottler() const;
+    ThrottlerPtr getRemoteWriteThrottler() const;
+
+    ThrottlerPtr getLocalReadThrottler() const;
+    ThrottlerPtr getLocalWriteThrottler() const;
+
+    ReadSettings getReadSettings() const;
+};
+
+}
diff --git a/src/Coordination/Context/Settings.cpp b/src/Coordination/Context/Settings.cpp
new file mode 100644
index 00000000000..12a7a42ffac
--- /dev/null
+++ b/src/Coordination/Context/Settings.cpp
@@ -0,0 +1,24 @@
+#include <Core/Settings.h>
+
+namespace DB
+{
+
+IMPLEMENT_SETTINGS_TRAITS(SettingsTraits, LIST_OF_SETTINGS)
+
+std::vector<String> Settings::getAllRegisteredNames() const
+{
+    std::vector<String> all_settings;
+    for (const auto & setting_field : all())
+    {
+        all_settings.push_back(setting_field.getName());
+    }
+    return all_settings;
+}
+
+void Settings::set(std::string_view name, const Field & value)
+{
+    BaseSettings::set(name, value);
+}
+
+
+}
diff --git a/src/Coordination/Context/ThreadStatusExt.cpp b/src/Coordination/Context/ThreadStatusExt.cpp
new file mode 100644
index 00000000000..97f7287be8c
--- /dev/null
+++ b/src/Coordination/Context/ThreadStatusExt.cpp
@@ -0,0 +1,14 @@
+#include <Common/CurrentThread.h>
+
+namespace DB
+{
+
+void CurrentThread::detachFromGroupIfNotDetached()
+{
+}
+
+void CurrentThread::attachToGroup(const ThreadGroupPtr &)
+{
+}
+
+}
diff --git a/src/Coordination/CoordinationSettings.cpp b/src/Coordination/CoordinationSettings.cpp
index 7a66134f43f..833ff7be7ae 100644
--- a/src/Coordination/CoordinationSettings.cpp
+++ b/src/Coordination/CoordinationSettings.cpp
@@ -85,14 +85,6 @@ void KeeperConfigurationAndSettings::dump(WriteBufferFromOwnString & buf) const
     writeText(four_letter_word_allow_list, buf);
     buf.write('\n');
 
-    writeText("log_storage_path=", buf);
-    writeText(log_storage_path, buf);
-    buf.write('\n');
-
-    writeText("snapshot_storage_path=", buf);
-    writeText(snapshot_storage_path, buf);
-    buf.write('\n');
-
     /// coordination_settings
 
     writeText("max_requests_batch_size=", buf);
@@ -188,61 +180,9 @@ KeeperConfigurationAndSettings::loadFromConfig(const Poco::Util::AbstractConfigu
                          DEFAULT_FOUR_LETTER_WORD_CMD));
 
 
-    ret->log_storage_path = getLogsPathFromConfig(config, standalone_keeper_);
-    ret->snapshot_storage_path = getSnapshotsPathFromConfig(config, standalone_keeper_);
-
-    ret->state_file_path = getStateFilePathFromConfig(config, standalone_keeper_);
-
     ret->coordination_settings->loadFromConfig("keeper_server.coordination_settings", config);
 
     return ret;
 }
 
-String KeeperConfigurationAndSettings::getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_)
-{
-    /// the most specialized path
-    if (config.has("keeper_server.log_storage_path"))
-        return config.getString("keeper_server.log_storage_path");
-
-    if (config.has("keeper_server.storage_path"))
-        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "logs";
-
-    if (standalone_keeper_)
-        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "logs";
-    else
-        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/logs";
-}
-
-String KeeperConfigurationAndSettings::getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_)
-{
-    /// the most specialized path
-    if (config.has("keeper_server.snapshot_storage_path"))
-        return config.getString("keeper_server.snapshot_storage_path");
-
-    if (config.has("keeper_server.storage_path"))
-        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "snapshots";
-
-    if (standalone_keeper_)
-        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "snapshots";
-    else
-        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/snapshots";
-}
-
-String KeeperConfigurationAndSettings::getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_)
-{
-    if (config.has("keeper_server.storage_path"))
-        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "state";
-
-    if (config.has("keeper_server.snapshot_storage_path"))
-        return std::filesystem::path(config.getString("keeper_server.snapshot_storage_path")).parent_path() / "state";
-
-    if (config.has("keeper_server.log_storage_path"))
-        return std::filesystem::path(config.getString("keeper_server.log_storage_path")).parent_path() / "state";
-
-    if (standalone_keeper_)
-        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "state";
-    else
-        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/state";
-}
-
 }
diff --git a/src/Coordination/CoordinationSettings.h b/src/Coordination/CoordinationSettings.h
index 90f66ccc09b..16da8404b44 100644
--- a/src/Coordination/CoordinationSettings.h
+++ b/src/Coordination/CoordinationSettings.h
@@ -81,17 +81,8 @@ struct KeeperConfigurationAndSettings
     bool standalone_keeper;
     CoordinationSettingsPtr coordination_settings;
 
-    String log_storage_path;
-    String snapshot_storage_path;
-    String state_file_path;
-
     void dump(WriteBufferFromOwnString & buf) const;
     static std::shared_ptr<KeeperConfigurationAndSettings> loadFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_);
-
-private:
-    static String getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_);
-    static String getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_);
-    static String getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config, bool standalone_keeper_);
 };
 
 using KeeperConfigurationAndSettingsPtr = std::shared_ptr<KeeperConfigurationAndSettings>;
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
new file mode 100644
index 00000000000..9e504f5aa07
--- /dev/null
+++ b/src/Coordination/KeeperContext.cpp
@@ -0,0 +1,104 @@
+#include <Coordination/KeeperContext.h>
+
+#include <Coordination/Defines.h>
+#include <Disks/DiskLocal.h>
+#include <Interpreters/Context.h>
+
+namespace DB
+{
+
+
+KeeperContext::KeeperContext(bool standalone_keeper_)
+    : disk_selector(std::make_shared<DiskSelector>())
+    , standalone_keeper(standalone_keeper_)
+{}
+
+void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
+{
+    digest_enabled = config.getBool("keeper_server.digest_enabled", false);
+    ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
+
+    disk_selector->initialize(config, "storage_configuration.disks", Context::getGlobalContextInstance());
+
+    log_storage_path = getLogsPathFromConfig(config);
+    snapshot_storage_path = getSnapshotsPathFromConfig(config);
+
+    state_file_path = getStateFilePathFromConfig(config);
+}
+
+KeeperContext::Phase KeeperContext::getServerState() const
+{
+    return server_state;
+}
+
+void KeeperContext::setServerState(KeeperContext::Phase server_state_)
+{
+    server_state = server_state_;
+}
+
+bool KeeperContext::ignoreSystemPathOnStartup() const
+{
+    return ignore_system_path_on_startup;
+}
+
+bool KeeperContext::digestEnabled() const
+{
+    return digest_enabled;
+}
+
+void KeeperContext::setDigestEnabled(bool digest_enabled_)
+{
+    digest_enabled = digest_enabled_;
+}
+
+KeeperContext::Storage KeeperContext::getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const
+{
+    /// the most specialized path
+    if (config.has("keeper_server.log_storage_path"))
+        return std::make_shared<DiskLocal>("LogDisk", config.getString("keeper_server.log_storage_path"), 0);
+
+    if (config.has("keeper_server.log_storage_disk"))
+        return config.getString("keeper_server.log_storage_disk");
+
+    if (config.has("keeper_server.storage_path"))
+        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("keeper_server.storage_path")} / "logs", 0);
+
+    if (standalone_keeper)
+        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "logs", 0);
+    else
+        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/logs", 0);
+}
+
+std::string KeeperContext::getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config)
+{
+    /// the most specialized path
+    if (config.has("keeper_server.snapshot_storage_path"))
+        return config.getString("keeper_server.snapshot_storage_path");
+
+    if (config.has("keeper_server.storage_path"))
+        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "snapshots";
+
+    if (standalone_keeper)
+        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "snapshots";
+    else
+        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/snapshots";
+}
+
+std::string KeeperContext::getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config)
+{
+    if (config.has("keeper_server.storage_path"))
+        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "state";
+
+    if (config.has("keeper_server.snapshot_storage_path"))
+        return std::filesystem::path(config.getString("keeper_server.snapshot_storage_path")).parent_path() / "state";
+
+    if (config.has("keeper_server.log_storage_path"))
+        return std::filesystem::path(config.getString("keeper_server.log_storage_path")).parent_path() / "state";
+
+    if (standalone_keeper)
+        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "state";
+    else
+        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/state";
+}
+
+}
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 64fa8cea6ec..2a215f9d58f 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -1,10 +1,20 @@
 #pragma once
 
+#include <Poco/Util/AbstractConfiguration.h>
+
+#include <Disks/DiskSelector.h>
+
+#include <cstdint>
+#include <memory>
+
 namespace DB
 {
 
-struct KeeperContext
+class KeeperContext
 {
+public:
+    explicit KeeperContext(bool standalone_keeper_);
+
     enum class Phase : uint8_t
     {
         INIT,
@@ -12,10 +22,35 @@ struct KeeperContext
         SHUTDOWN
     };
 
+    void initialize(const Poco::Util::AbstractConfiguration & config);
+
+    Phase getServerState() const;
+    void setServerState(Phase server_state_);
+
+    bool ignoreSystemPathOnStartup() const;
+
+    bool digestEnabled() const;
+    void setDigestEnabled(bool digest_enabled_);
+private:
+    /// local disk defined using path or disk name
+    using Storage = std::variant<DiskPtr, std::string>;
+
+    Storage getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const;
+    std::string getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config);
+    std::string getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config);
+
     Phase server_state{Phase::INIT};
 
     bool ignore_system_path_on_startup{false};
     bool digest_enabled{true};
+
+    std::shared_ptr<DiskSelector> disk_selector;
+
+    Storage log_storage_path;
+    Storage snapshot_storage_path;
+    Storage state_file_path;
+
+    bool standalone_keeper;
 };
 
 using KeeperContextPtr = std::shared_ptr<KeeperContext>;
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index d64134f3024..6632e58782f 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -789,12 +789,14 @@ static uint64_t getDirSize(const fs::path & dir)
 
 uint64_t KeeperDispatcher::getLogDirSize() const
 {
-    return getDirSize(configuration_and_settings->log_storage_path);
+    //return getDirSize(configuration_and_settings->log_storage_path);
+    return 0;
 }
 
 uint64_t KeeperDispatcher::getSnapDirSize() const
 {
-    return getDirSize(configuration_and_settings->snapshot_storage_path);
+    //return getDirSize(configuration_and_settings->snapshot_storage_path);
+    return 0;
 }
 
 Keeper4LWInfo KeeperDispatcher::getKeeper4LWInfo() const
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 9ca792eecdd..d63593436f4 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -114,18 +114,17 @@ KeeperServer::KeeperServer(
     , coordination_settings(configuration_and_settings_->coordination_settings)
     , log(&Poco::Logger::get("KeeperServer"))
     , is_recovering(config.getBool("keeper_server.force_recovery", false))
-    , keeper_context{std::make_shared<KeeperContext>()}
+    , keeper_context{std::make_shared<KeeperContext>(true)}
     , create_snapshot_on_exit(config.getBool("keeper_server.create_snapshot_on_exit", true))
 {
     if (coordination_settings->quorum_reads)
         LOG_WARNING(log, "Quorum reads enabled, Keeper will work slower.");
 
-    keeper_context->digest_enabled = config.getBool("keeper_server.digest_enabled", false);
-    keeper_context->ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
+    keeper_context->initialize(config);
 
-    if (!fs::exists(configuration_and_settings_->snapshot_storage_path))
-        fs::create_directories(configuration_and_settings_->snapshot_storage_path);
-    auto snapshots_disk = std::make_shared<DiskLocal>("Keeper-snapshots", configuration_and_settings_->snapshot_storage_path, 0);
+    //if (!fs::exists(keeper_context->snapshot_storage_path))
+    //    fs::create_directories(keeper_context->snapshot_storage_path);
+    auto snapshots_disk = std::make_shared<DiskLocal>("Keeper-snapshots", "", 0);
 
     state_machine = nuraft::cs_new<KeeperStateMachine>(
         responses_queue_,
@@ -137,23 +136,23 @@ KeeperServer::KeeperServer(
         commit_callback,
         checkAndGetSuperdigest(configuration_and_settings_->super_digest));
 
-    auto state_path = fs::path(configuration_and_settings_->state_file_path).parent_path().generic_string();
-    auto state_file_name = fs::path(configuration_and_settings_->state_file_path).filename().generic_string();
+    //auto state_path = fs::path(keeper_context->state_file_path).parent_path().generic_string();
+    //auto state_file_name = fs::path(configuration_and_settings_->state_file_path).filename().generic_string();
 
-    if (!fs::exists(state_path))
-        fs::create_directories(state_path);
-    auto state_disk = std::make_shared<DiskLocal>("Keeper-state", state_path, 0);
+    //if (!fs::exists(state_path))
+    //    fs::create_directories(state_path);
+    auto state_disk = std::make_shared<DiskLocal>("Keeper-state", "", 0);
 
-    if (!fs::exists(configuration_and_settings_->log_storage_path))
-        fs::create_directories(configuration_and_settings_->log_storage_path);
-    auto logs_disk = std::make_shared<DiskLocal>("Keeper-logs", configuration_and_settings_->log_storage_path, 0);
+    //if (!fs::exists(configuration_and_settings_->log_storage_path))
+    //    fs::create_directories(configuration_and_settings_->log_storage_path);
+    auto logs_disk = std::make_shared<DiskLocal>("Keeper-logs", "", 0);
 
     state_manager = nuraft::cs_new<KeeperStateManager>(
         server_id,
         "keeper_server",
         logs_disk,
         state_disk,
-        state_file_name,
+        "state",
         config,
         coordination_settings);
 }
@@ -431,7 +430,7 @@ void KeeperServer::startup(const Poco::Util::AbstractConfiguration & config, boo
 
     launchRaftServer(config, enable_ipv6);
 
-    keeper_context->server_state = KeeperContext::Phase::RUNNING;
+    keeper_context->setServerState(KeeperContext::Phase::RUNNING);
 }
 
 void KeeperServer::shutdownRaftServer()
@@ -446,7 +445,7 @@ void KeeperServer::shutdownRaftServer()
 
     raft_instance->shutdown();
 
-    keeper_context->server_state = KeeperContext::Phase::SHUTDOWN;
+    keeper_context->setServerState(KeeperContext::Phase::SHUTDOWN);
 
     if (create_snapshot_on_exit)
         raft_instance->create_snapshot();
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index b7fca5c1eab..e1c0c034cff 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -9,11 +9,11 @@
 #include <IO/WriteHelpers.h>
 #include <IO/copyData.h>
 #include <Common/ZooKeeper/ZooKeeperIO.h>
-#include <Coordination/pathUtils.h>
 #include <filesystem>
 #include <memory>
 #include <Common/logger_useful.h>
 #include <Coordination/KeeperContext.h>
+#include <Coordination/pathUtils.h>
 #include <Coordination/KeeperConstants.h>
 #include <Common/ZooKeeper/ZooKeeperCommon.h>
 #include <Disks/DiskLocal.h>
@@ -157,7 +157,7 @@ void KeeperStorageSnapshot::serialize(const KeeperStorageSnapshot & snapshot, Wr
     if (snapshot.version >= SnapshotVersion::V5)
     {
         writeBinary(snapshot.zxid, out);
-        if (keeper_context->digest_enabled)
+        if (keeper_context->digestEnabled())
         {
             writeBinary(static_cast<uint8_t>(KeeperStorage::CURRENT_DIGEST_VERSION), out);
             writeBinary(snapshot.nodes_digest, out);
@@ -268,7 +268,7 @@ void KeeperStorageSnapshot::deserialize(SnapshotDeserializationResult & deserial
     deserialization_result.snapshot_meta = deserializeSnapshotMetadata(in);
     KeeperStorage & storage = *deserialization_result.storage;
 
-    bool recalculate_digest = keeper_context->digest_enabled;
+    bool recalculate_digest = keeper_context->digestEnabled();
     if (version >= SnapshotVersion::V5)
     {
         readBinary(storage.zxid, in);
@@ -350,7 +350,7 @@ void KeeperStorageSnapshot::deserialize(SnapshotDeserializationResult & deserial
         const std::string error_msg = fmt::format("Cannot read node on path {} from a snapshot because it is used as a system node", path);
         if (match_result == IS_CHILD)
         {
-            if (keeper_context->ignore_system_path_on_startup || keeper_context->server_state != KeeperContext::Phase::INIT)
+            if (keeper_context->ignoreSystemPathOnStartup() || keeper_context->getServerState() != KeeperContext::Phase::INIT)
             {
                 LOG_ERROR(&Poco::Logger::get("KeeperSnapshotManager"), "{}. Ignoring it", error_msg);
                 continue;
@@ -366,7 +366,7 @@ void KeeperStorageSnapshot::deserialize(SnapshotDeserializationResult & deserial
         {
             if (!is_node_empty(node))
             {
-                if (keeper_context->ignore_system_path_on_startup || keeper_context->server_state != KeeperContext::Phase::INIT)
+                if (keeper_context->ignoreSystemPathOnStartup() || keeper_context->getServerState() != KeeperContext::Phase::INIT)
                 {
                     LOG_ERROR(&Poco::Logger::get("KeeperSnapshotManager"), "{}. Ignoring it", error_msg);
                     node = KeeperStorage::Node{};
@@ -395,9 +395,9 @@ void KeeperStorageSnapshot::deserialize(SnapshotDeserializationResult & deserial
     {
         if (itr.key != "/")
         {
-            auto parent_path = parentPath(itr.key);
+            auto parent_path = parentNodePath(itr.key);
             storage.container.updateValue(
-                parent_path, [version, path = itr.key](KeeperStorage::Node & value) { value.addChild(getBaseName(path), /*update_size*/ version < SnapshotVersion::V4); });
+                parent_path, [version, path = itr.key](KeeperStorage::Node & value) { value.addChild(getBaseNodeName(path), /*update_size*/ version < SnapshotVersion::V4); });
         }
     }
 
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 53657d9b0b9..a7c845e5017 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -223,7 +223,7 @@ bool KeeperStateMachine::preprocess(const KeeperStorage::RequestForSession & req
         throw;
     }
 
-    if (keeper_context->digest_enabled && request_for_session.digest)
+    if (keeper_context->digestEnabled() && request_for_session.digest)
         assertDigest(*request_for_session.digest, storage->getNodesDigest(false), *request_for_session.request, false);
 
     return true;
@@ -271,7 +271,7 @@ nuraft::ptr<nuraft::buffer> KeeperStateMachine::commit(const uint64_t log_idx, n
                 LOG_WARNING(log, "Failed to push response with session id {} to the queue, probably because of shutdown", response_for_session.session_id);
             }
 
-        if (keeper_context->digest_enabled && request_for_session.digest)
+        if (keeper_context->digestEnabled() && request_for_session.digest)
             assertDigest(*request_for_session.digest, storage->getNodesDigest(true), *request_for_session.request, true);
     }
 
@@ -429,7 +429,7 @@ void KeeperStateMachine::create_snapshot(nuraft::snapshot & s, nuraft::async_res
     };
 
 
-    if (keeper_context->server_state == KeeperContext::Phase::SHUTDOWN)
+    if (keeper_context->getServerState() == KeeperContext::Phase::SHUTDOWN)
     {
         LOG_INFO(log, "Creating a snapshot during shutdown because 'create_snapshot_on_exit' is enabled.");
         auto snapshot_path = snapshot_task.create_snapshot(std::move(snapshot_task.snapshot));
diff --git a/src/Coordination/KeeperStorage.cpp b/src/Coordination/KeeperStorage.cpp
index 7a1a5e42632..64e785693e4 100644
--- a/src/Coordination/KeeperStorage.cpp
+++ b/src/Coordination/KeeperStorage.cpp
@@ -128,7 +128,7 @@ KeeperStorage::ResponsesForSessions processWatchesImpl(
         watches.erase(watch_it);
     }
 
-    auto parent_path = parentPath(path);
+    auto parent_path = parentNodePath(path);
 
     Strings paths_to_check_for_list_watches;
     if (event_type == Coordination::Event::CREATED)
@@ -276,7 +276,7 @@ void KeeperStorage::initializeSystemNodes()
             [](auto & node)
             {
                 ++node.stat.numChildren;
-                node.addChild(getBaseName(keeper_system_path));
+                node.addChild(getBaseNodeName(keeper_system_path));
             }
         );
         addDigest(updated_root_it->value, "/");
@@ -290,9 +290,9 @@ void KeeperStorage::initializeSystemNodes()
         child_system_node.setData(data);
         auto [map_key, _] = container.insert(std::string{path}, child_system_node);
         /// Take child path from key owned by map.
-        auto child_path = getBaseName(map_key->getKey());
+        auto child_path = getBaseNodeName(map_key->getKey());
         container.updateValue(
-            parentPath(StringRef(path)),
+            parentNodePath(StringRef(path)),
             [child_path](auto & parent)
             {
                 // don't update stats so digest is okay
@@ -705,7 +705,7 @@ bool KeeperStorage::createNode(
     bool is_sequental,
     Coordination::ACLs node_acls)
 {
-    auto parent_path = parentPath(path);
+    auto parent_path = parentNodePath(path);
     auto node_it = container.find(parent_path);
 
     if (node_it == container.end())
@@ -728,7 +728,7 @@ bool KeeperStorage::createNode(
     created_node.is_sequental = is_sequental;
     auto [map_key, _] = container.insert(path, created_node);
     /// Take child path from key owned by map.
-    auto child_path = getBaseName(map_key->getKey());
+    auto child_path = getBaseNodeName(map_key->getKey());
     container.updateValue(
             parent_path,
             [child_path](KeeperStorage::Node & parent)
@@ -758,8 +758,8 @@ bool KeeperStorage::removeNode(const std::string & path, int32_t version)
     acl_map.removeUsage(prev_node.acl_id);
 
     container.updateValue(
-        parentPath(path),
-        [child_basename = getBaseName(node_it->key)](KeeperStorage::Node & parent)
+        parentNodePath(path),
+        [child_basename = getBaseNodeName(node_it->key)](KeeperStorage::Node & parent)
         {
             parent.removeChild(child_basename);
             chassert(parent.stat.numChildren == static_cast<int32_t>(parent.getChildren().size()));
@@ -843,7 +843,7 @@ Coordination::ACLs getNodeACLs(KeeperStorage & storage, StringRef path, bool is_
 
 void handleSystemNodeModification(const KeeperContext & keeper_context, std::string_view error_msg)
 {
-    if (keeper_context.server_state == KeeperContext::Phase::INIT && !keeper_context.ignore_system_path_on_startup)
+    if (keeper_context.getServerState() == KeeperContext::Phase::INIT && !keeper_context.ignoreSystemPathOnStartup())
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "{}. Ignoring it can lead to data loss. "
@@ -906,7 +906,7 @@ struct KeeperStorageCreateRequestProcessor final : public KeeperStorageRequestPr
     bool checkAuth(KeeperStorage & storage, int64_t session_id, bool is_local) const override
     {
         auto path = zk_request->getPath();
-        return storage.checkACL(parentPath(path), Coordination::ACL::Create, session_id, is_local);
+        return storage.checkACL(parentNodePath(path), Coordination::ACL::Create, session_id, is_local);
     }
 
     std::vector<KeeperStorage::Delta>
@@ -917,7 +917,7 @@ struct KeeperStorageCreateRequestProcessor final : public KeeperStorageRequestPr
 
         std::vector<KeeperStorage::Delta> new_deltas;
 
-        auto parent_path = parentPath(request.path);
+        auto parent_path = parentNodePath(request.path);
         auto parent_node = storage.uncommitted_state.getNode(parent_path);
         if (parent_node == nullptr)
             return {KeeperStorage::Delta{zxid, Coordination::Error::ZNONODE}};
@@ -948,7 +948,7 @@ struct KeeperStorageCreateRequestProcessor final : public KeeperStorageRequestPr
         if (storage.uncommitted_state.getNode(path_created))
             return {KeeperStorage::Delta{zxid, Coordination::Error::ZNODEEXISTS}};
 
-        if (getBaseName(path_created).size == 0)
+        if (getBaseNodeName(path_created).size == 0)
             return {KeeperStorage::Delta{zxid, Coordination::Error::ZBADARGUMENTS}};
 
         Coordination::ACLs node_acls;
@@ -1098,7 +1098,7 @@ struct KeeperStorageRemoveRequestProcessor final : public KeeperStorageRequestPr
 {
     bool checkAuth(KeeperStorage & storage, int64_t session_id, bool is_local) const override
     {
-        return storage.checkACL(parentPath(zk_request->getPath()), Coordination::ACL::Delete, session_id, is_local);
+        return storage.checkACL(parentNodePath(zk_request->getPath()), Coordination::ACL::Delete, session_id, is_local);
     }
 
     using KeeperStorageRequestProcessor::KeeperStorageRequestProcessor;
@@ -1120,7 +1120,7 @@ struct KeeperStorageRemoveRequestProcessor final : public KeeperStorageRequestPr
 
         const auto update_parent_pzxid = [&]()
         {
-            auto parent_path = parentPath(request.path);
+            auto parent_path = parentNodePath(request.path);
             if (!storage.uncommitted_state.getNode(parent_path))
                 return;
 
@@ -1155,7 +1155,7 @@ struct KeeperStorageRemoveRequestProcessor final : public KeeperStorageRequestPr
             update_parent_pzxid();
 
         new_deltas.emplace_back(
-            std::string{parentPath(request.path)},
+            std::string{parentNodePath(request.path)},
             zxid,
             KeeperStorage::UpdateNodeDelta{[](KeeperStorage::Node & parent)
                                            {
@@ -1298,7 +1298,7 @@ struct KeeperStorageSetRequestProcessor final : public KeeperStorageRequestProce
                 request.version});
 
         new_deltas.emplace_back(
-                parentPath(request.path).toString(),
+                parentNodePath(request.path).toString(),
                 zxid,
                 KeeperStorage::UpdateNodeDelta
                 {
@@ -1458,7 +1458,7 @@ struct KeeperStorageCheckRequestProcessor final : public KeeperStorageRequestPro
     bool checkAuth(KeeperStorage & storage, int64_t session_id, bool is_local) const override
     {
         auto path = zk_request->getPath();
-        return storage.checkACL(check_not_exists ? parentPath(path) : path, Coordination::ACL::Read, session_id, is_local);
+        return storage.checkACL(check_not_exists ? parentNodePath(path) : path, Coordination::ACL::Read, session_id, is_local);
     }
 
     std::vector<KeeperStorage::Delta>
@@ -2001,7 +2001,7 @@ KeeperStorageRequestProcessorsFactory::KeeperStorageRequestProcessorsFactory()
 
 UInt64 KeeperStorage::calculateNodesDigest(UInt64 current_digest, const std::vector<Delta> & new_deltas) const
 {
-    if (!keeper_context->digest_enabled)
+    if (!keeper_context->digestEnabled())
         return current_digest;
 
     std::unordered_map<std::string_view, std::shared_ptr<Node>> updated_nodes;
@@ -2099,7 +2099,7 @@ void KeeperStorage::preprocessRequest(
     TransactionInfo transaction{.zxid = new_last_zxid};
     uint64_t new_digest = getNodesDigest(false).value;
     SCOPE_EXIT({
-        if (keeper_context->digest_enabled)
+        if (keeper_context->digestEnabled())
             // if the version of digest we got from the leader is the same as the one this instances has, we can simply copy the value
             // and just check the digest on the commit
             // a mistake can happen while applying the changes to the uncommitted_state so for now let's just recalculate the digest here also
@@ -2122,7 +2122,7 @@ void KeeperStorage::preprocessRequest(
             {
                 new_deltas.emplace_back
                 (
-                    parentPath(ephemeral_path).toString(),
+                    parentNodePath(ephemeral_path).toString(),
                     new_last_zxid,
                     UpdateNodeDelta
                     {
@@ -2315,7 +2315,7 @@ void KeeperStorage::rollbackRequest(int64_t rollback_zxid, bool allow_missing)
 
 KeeperStorage::Digest KeeperStorage::getNodesDigest(bool committed) const
 {
-    if (!keeper_context->digest_enabled)
+    if (!keeper_context->digestEnabled())
         return {.version = DigestVersion::NO_DIGEST};
 
     if (committed || uncommitted_transactions.empty())
@@ -2326,13 +2326,13 @@ KeeperStorage::Digest KeeperStorage::getNodesDigest(bool committed) const
 
 void KeeperStorage::removeDigest(const Node & node, const std::string_view path)
 {
-    if (keeper_context->digest_enabled)
+    if (keeper_context->digestEnabled())
         nodes_digest -= node.getDigest(path);
 }
 
 void KeeperStorage::addDigest(const Node & node, const std::string_view path)
 {
-    if (keeper_context->digest_enabled)
+    if (keeper_context->digestEnabled())
     {
         node.invalidateDigestCache();
         nodes_digest += node.getDigest(path);
diff --git a/src/Coordination/ZooKeeperDataReader.cpp b/src/Coordination/ZooKeeperDataReader.cpp
index bdc462f3ea0..94fc07bcc4a 100644
--- a/src/Coordination/ZooKeeperDataReader.cpp
+++ b/src/Coordination/ZooKeeperDataReader.cpp
@@ -139,8 +139,8 @@ int64_t deserializeStorageData(KeeperStorage & storage, ReadBuffer & in, Poco::L
     {
         if (itr.key != "/")
         {
-            auto parent_path = parentPath(itr.key);
-            storage.container.updateValue(parent_path, [my_path = itr.key] (KeeperStorage::Node & value) { value.addChild(getBaseName(my_path)); ++value.stat.numChildren; });
+            auto parent_path = parentNodePath(itr.key);
+            storage.container.updateValue(parent_path, [my_path = itr.key] (KeeperStorage::Node & value) { value.addChild(getBaseNodeName(my_path)); ++value.stat.numChildren; });
         }
     }
 
diff --git a/src/Coordination/pathUtils.cpp b/src/Coordination/pathUtils.cpp
index 1e1da339d2e..afa42b4a639 100644
--- a/src/Coordination/pathUtils.cpp
+++ b/src/Coordination/pathUtils.cpp
@@ -21,7 +21,7 @@ static size_t findLastSlash(StringRef path)
     return std::string::npos;
 }
 
-StringRef parentPath(StringRef path)
+StringRef parentNodePath(StringRef path)
 {
     auto rslash_pos = findLastSlash(path);
     if (rslash_pos > 0)
@@ -29,7 +29,7 @@ StringRef parentPath(StringRef path)
     return "/";
 }
 
-StringRef getBaseName(StringRef path)
+StringRef getBaseNodeName(StringRef path)
 {
     size_t basename_start = findLastSlash(path);
     return StringRef{path.data + basename_start + 1, path.size - basename_start - 1};
diff --git a/src/Coordination/pathUtils.h b/src/Coordination/pathUtils.h
index 69ed2d8b177..b2b79b14110 100644
--- a/src/Coordination/pathUtils.h
+++ b/src/Coordination/pathUtils.h
@@ -6,8 +6,8 @@
 namespace DB
 {
 
-StringRef parentPath(StringRef path);
+StringRef parentNodePath(StringRef path);
 
-StringRef getBaseName(StringRef path);
+StringRef getBaseNodeName(StringRef path);
 
 }
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index 62217fb2dd3..de5f2da262b 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -2366,7 +2366,7 @@ TEST_P(CoordinationTest, TestSystemNodeModify)
     int64_t zxid{0};
 
     // On INIT we abort when a system path is modified
-    keeper_context->server_state = KeeperContext::Phase::RUNNING;
+    keeper_context->setServerState(KeeperContext::Phase::RUNNING);
     KeeperStorage storage{500, "", keeper_context};
     const auto assert_create = [&](const std::string_view path, const auto expected_code)
     {
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 8cd4efb68c6..c1f9fa00f2a 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -379,6 +379,35 @@ void SettingFieldMap::readBinary(ReadBuffer & in)
     *this = map;
 }
 
+#else
+
+SettingFieldMap::SettingFieldMap(const Field &) : value(Map()) {}
+String SettingFieldMap::toString() const
+{
+    throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Setting of type Map not supported");
+}
+
+
+SettingFieldMap & SettingFieldMap::operator =(const Field &)
+{
+    throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Setting of type Map not supported");
+}
+
+void SettingFieldMap::parseFromString(const String &)
+{
+    throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Setting of type Map not supported");
+}
+
+void SettingFieldMap::writeBinary(WriteBuffer &) const
+{
+    throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Setting of type Map not supported");
+}
+
+void SettingFieldMap::readBinary(ReadBuffer &)
+{
+    throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Setting of type Map not supported");
+}
+
 #endif
 
 namespace
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 2cd55e6b4c5..8cbce71b094 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -245,6 +245,12 @@ struct SettingFieldString
     void readBinary(ReadBuffer & in);
 };
 
+#ifdef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
+#define NORETURN [[noreturn]]
+#else
+#define NORETURN
+#endif
+
 struct SettingFieldMap
 {
 public:
@@ -261,13 +267,15 @@ public:
     operator const Map &() const { return value; } /// NOLINT
     explicit operator Field() const { return value; }
 
-    String toString() const;
-    void parseFromString(const String & str);
+    NORETURN String toString() const;
+    NORETURN void parseFromString(const String & str);
 
-    void writeBinary(WriteBuffer & out) const;
-    void readBinary(ReadBuffer & in);
+    NORETURN void writeBinary(WriteBuffer & out) const;
+    NORETURN void readBinary(ReadBuffer & in);
 };
 
+#undef NORETURN
+
 struct SettingFieldChar
 {
 public:
diff --git a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
index 68b5a9c9d96..6c3556580a2 100644
--- a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
+++ b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
@@ -50,6 +50,7 @@ SeekableReadBufferPtr ReadBufferFromRemoteFSGather::createImplementationBuffer(c
     size_t current_read_until_position = read_until_position ? read_until_position : object.bytes_size;
     auto current_read_buffer_creator = [=, this]() { return read_buffer_creator(object_path, current_read_until_position); };
 
+#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
     if (with_cache)
     {
         auto cache_key = settings.remote_fs_cache->createKeyForPath(object_path);
@@ -66,6 +67,7 @@ SeekableReadBufferPtr ReadBufferFromRemoteFSGather::createImplementationBuffer(c
             read_until_position ? std::optional<size_t>(read_until_position) : std::nullopt,
             cache_log);
     }
+#endif
 
     return current_read_buffer_creator();
 }
diff --git a/src/Disks/IO/getThreadPoolReader.cpp b/src/Disks/IO/getThreadPoolReader.cpp
index deb8f66106c..7dbff9ffe76 100644
--- a/src/Disks/IO/getThreadPoolReader.cpp
+++ b/src/Disks/IO/getThreadPoolReader.cpp
@@ -7,9 +7,7 @@
 #include <Disks/IO/ThreadPoolRemoteFSReader.h>
 #include <Disks/IO/ThreadPoolReader.h>
 
-#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
 #include <Interpreters/Context.h>
-#endif
 
 namespace DB
 {
@@ -21,32 +19,10 @@ namespace ErrorCodes
 
 IAsynchronousReader & getThreadPoolReader(FilesystemReaderType type)
 {
-#ifdef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
-    const auto & config = Poco::Util::Application::instance().config();
-    switch (type)
-    {
-        case FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER:
-        {
-            static auto asynchronous_remote_fs_reader = createThreadPoolReader(type, config);
-            return *asynchronous_remote_fs_reader;
-        }
-        case FilesystemReaderType::ASYNCHRONOUS_LOCAL_FS_READER:
-        {
-            static auto asynchronous_local_fs_reader = createThreadPoolReader(type, config);
-            return *asynchronous_local_fs_reader;
-        }
-        case FilesystemReaderType::SYNCHRONOUS_LOCAL_FS_READER:
-        {
-            static auto synchronous_local_fs_reader = createThreadPoolReader(type, config);
-            return *synchronous_local_fs_reader;
-        }
-    }
-#else
     auto context = Context::getGlobalContextInstance();
     if (!context)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Global context not initialized");
     return context->getThreadPoolReader(type);
-#endif
 }
 
 std::unique_ptr<IAsynchronousReader> createThreadPoolReader(
diff --git a/src/Disks/ObjectStorages/DiskObjectStorage.cpp b/src/Disks/ObjectStorages/DiskObjectStorage.cpp
index f832ba5b7b6..2a9cb86f91c 100644
--- a/src/Disks/ObjectStorages/DiskObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/DiskObjectStorage.cpp
@@ -11,7 +11,6 @@
 #include <Common/logger_useful.h>
 #include <Common/filesystemHelpers.h>
 #include <Common/CurrentMetrics.h>
-#include <Disks/ObjectStorages/Cached/CachedObjectStorage.h>
 #include <Disks/ObjectStorages/DiskObjectStorageRemoteMetadataRestoreHelper.h>
 #include <Disks/ObjectStorages/DiskObjectStorageTransaction.h>
 #include <Disks/FakeDiskTransaction.h>
@@ -530,24 +529,6 @@ DiskObjectStoragePtr DiskObjectStorage::createDiskObjectStorage()
         threadpool_size);
 }
 
-void DiskObjectStorage::wrapWithCache(FileCachePtr cache, const FileCacheSettings & cache_settings, const String & layer_name)
-{
-    object_storage = std::make_shared<CachedObjectStorage>(object_storage, cache, cache_settings, layer_name);
-}
-
-NameSet DiskObjectStorage::getCacheLayersNames() const
-{
-    NameSet cache_layers;
-    auto current_object_storage = object_storage;
-    while (current_object_storage->supportsCache())
-    {
-        auto * cached_object_storage = assert_cast<CachedObjectStorage *>(current_object_storage.get());
-        cache_layers.insert(cached_object_storage->getCacheConfigName());
-        current_object_storage = cached_object_storage->getWrappedObjectStorage();
-    }
-    return cache_layers;
-}
-
 std::unique_ptr<ReadBufferFromFileBase> DiskObjectStorage::readFile(
     const String & path,
     const ReadSettings & settings,
diff --git a/src/Disks/ObjectStorages/DiskObjectStorage.h b/src/Disks/ObjectStorages/DiskObjectStorage.h
index 4372bc75950..2d942eda1d2 100644
--- a/src/Disks/ObjectStorages/DiskObjectStorage.h
+++ b/src/Disks/ObjectStorages/DiskObjectStorage.h
@@ -184,20 +184,22 @@ public:
     /// MergeTree table on this disk.
     bool isWriteOnce() const override;
 
-    /// Add a cache layer.
-    /// Example: DiskObjectStorage(S3ObjectStorage) -> DiskObjectStorage(CachedObjectStorage(S3ObjectStorage))
-    /// There can be any number of cache layers:
-    /// DiskObjectStorage(CachedObjectStorage(...CacheObjectStorage(S3ObjectStorage)...))
-    void wrapWithCache(FileCachePtr cache, const FileCacheSettings & cache_settings, const String & layer_name);
-
     /// Get structure of object storage this disk works with. Examples:
     /// DiskObjectStorage(S3ObjectStorage)
     /// DiskObjectStorage(CachedObjectStorage(S3ObjectStorage))
     /// DiskObjectStorage(CachedObjectStorage(CachedObjectStorage(S3ObjectStorage)))
     String getStructure() const { return fmt::format("DiskObjectStorage-{}({})", getName(), object_storage->getName()); }
 
+#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
+    /// Add a cache layer.
+    /// Example: DiskObjectStorage(S3ObjectStorage) -> DiskObjectStorage(CachedObjectStorage(S3ObjectStorage))
+    /// There can be any number of cache layers:
+    /// DiskObjectStorage(CachedObjectStorage(...CacheObjectStorage(S3ObjectStorage)...))
+    void wrapWithCache(FileCachePtr cache, const FileCacheSettings & cache_settings, const String & layer_name);
+
     /// Get names of all cache layers. Name is how cache is defined in configuration file.
     NameSet getCacheLayersNames() const override;
+#endif
 
     static std::shared_ptr<Executor> getAsyncExecutor(const std::string & log_name, size_t size);
 
diff --git a/src/Disks/ObjectStorages/DiskObjectStorageCache.cpp b/src/Disks/ObjectStorages/DiskObjectStorageCache.cpp
new file mode 100644
index 00000000000..9e5012dec54
--- /dev/null
+++ b/src/Disks/ObjectStorages/DiskObjectStorageCache.cpp
@@ -0,0 +1,28 @@
+#include <Disks/ObjectStorages/Cached/CachedObjectStorage.h>
+
+#include <Disks/ObjectStorages/DiskObjectStorage.h>
+
+#include <Common/assert_cast.h>
+
+namespace DB
+{
+
+void DiskObjectStorage::wrapWithCache(FileCachePtr cache, const FileCacheSettings & cache_settings, const String & layer_name)
+{
+    object_storage = std::make_shared<CachedObjectStorage>(object_storage, cache, cache_settings, layer_name);
+}
+
+NameSet DiskObjectStorage::getCacheLayersNames() const
+{
+    NameSet cache_layers;
+    auto current_object_storage = object_storage;
+    while (current_object_storage->supportsCache())
+    {
+        auto * cached_object_storage = assert_cast<CachedObjectStorage *>(current_object_storage.get());
+        cache_layers.insert(cached_object_storage->getCacheConfigName());
+        current_object_storage = cached_object_storage->getWrappedObjectStorage();
+    }
+    return cache_layers;
+}
+
+}
diff --git a/src/Disks/registerDisks.cpp b/src/Disks/registerDisks.cpp
index 48d5a19fb61..676744a8e79 100644
--- a/src/Disks/registerDisks.cpp
+++ b/src/Disks/registerDisks.cpp
@@ -32,6 +32,8 @@ void registerDiskCache(DiskFactory & factory, bool global_skip_access_check);
 void registerDiskLocalObjectStorage(DiskFactory & factory, bool global_skip_access_check);
 
 
+#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
+
 void registerDisks(bool global_skip_access_check)
 {
     auto & factory = DiskFactory::instance();
@@ -61,4 +63,19 @@ void registerDisks(bool global_skip_access_check)
     registerDiskLocalObjectStorage(factory, global_skip_access_check);
 }
 
+#else
+
+void registerDisks(bool global_skip_access_check)
+{
+    auto & factory = DiskFactory::instance();
+
+    registerDiskLocal(factory, global_skip_access_check);
+
+#if USE_AWS_S3
+    registerDiskS3(factory, global_skip_access_check);
+#endif
+}
+
+#endif
+
 }
diff --git a/src/Interpreters/Context.h b/src/Interpreters/Context.h
index 87843a458e8..23f3281330a 100644
--- a/src/Interpreters/Context.h
+++ b/src/Interpreters/Context.h
@@ -1,5 +1,7 @@
 #pragma once
 
+#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
+
 #include <base/types.h>
 #include <Common/isLocalAddress.h>
 #include <Common/MultiVersion.h>
@@ -1226,3 +1228,9 @@ struct HTTPContext : public IHTTPContext
 };
 
 }
+
+#else 
+
+#include <Coordination/Context/Context.h>
+
+#endif

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 0107/1478] 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 0108/1478] 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 0109/1478] 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 0110/1478] 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 0111/1478] 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 0112/1478] 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 0113/1478] 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 0114/1478] 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 0115/1478] 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 0116/1478] 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 0117/1478] 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 0118/1478] 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 0119/1478] 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 0120/1478] 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 bde2cf96b135235908b71cc0bf071a175321dc4d Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Mon, 22 May 2023 12:24:16 +0000
Subject: [PATCH 0121/1478] Better

---
 programs/keeper/CMakeLists.txt                |  7 +-
 programs/keeper/Keeper.cpp                    | 39 +++++---
 programs/keeper/Keeper.h                      |  7 --
 src/Coordination/Changelog.cpp                | 55 +++++++----
 src/Coordination/Changelog.h                  | 10 +-
 .../KeeperAsynchronousMetrics.cpp             |  6 +-
 src/Coordination/KeeperAsynchronousMetrics.h  |  6 +-
 src/Coordination/KeeperContext.cpp            | 91 +++++++++++++++----
 src/Coordination/KeeperContext.h              | 16 +++-
 src/Coordination/KeeperLogStore.cpp           |  9 +-
 src/Coordination/KeeperLogStore.h             |  6 +-
 src/Coordination/KeeperServer.cpp             | 21 +----
 src/Coordination/KeeperSnapshotManager.cpp    | 38 +++-----
 src/Coordination/KeeperSnapshotManager.h      | 15 +--
 src/Coordination/KeeperStateMachine.cpp       |  2 -
 src/Coordination/KeeperStateMachine.h         |  1 -
 src/Coordination/KeeperStateManager.cpp       | 32 ++++---
 src/Coordination/KeeperStateManager.h         | 15 +--
 .../{Context => Standalone}/Context.cpp       | 58 ++++++++++++
 .../{Context => Standalone}/Context.h         |  9 ++
 .../{Context => Standalone}/Settings.cpp      |  0
 .../ThreadStatusExt.cpp                       |  0
 src/Coordination/TinyContext.cpp              | 87 ------------------
 src/Coordination/TinyContext.h                | 36 --------
 src/Interpreters/Context.h                    |  2 +-
 25 files changed, 282 insertions(+), 286 deletions(-)
 rename src/Coordination/{Context => Standalone}/Context.cpp (80%)
 rename src/Coordination/{Context => Standalone}/Context.h (88%)
 rename src/Coordination/{Context => Standalone}/Settings.cpp (100%)
 rename src/Coordination/{Context => Standalone}/ThreadStatusExt.cpp (100%)
 delete mode 100644 src/Coordination/TinyContext.cpp
 delete mode 100644 src/Coordination/TinyContext.h

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index c0c0a6dd1b0..1b5b9e6a7b2 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -50,7 +50,6 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStateManager.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStorage.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperAsynchronousMetrics.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/TinyContext.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/pathUtils.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/SessionExpiryQueue.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/SummingStateMachine.cpp
@@ -157,9 +156,9 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/GraphiteWriter.cpp
         ${CMAKE_CURRENT_BINARY_DIR}/../../src/Daemon/GitHash.generated.cpp
 
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/Context.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/Settings.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Context/ThreadStatusExt.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Standalone/Context.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Standalone/Settings.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/Standalone/ThreadStatusExt.cpp
 
         Keeper.cpp
         clickhouse-keeper.cpp
diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index 996c4678450..d5cf61daa6e 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -44,6 +44,8 @@
 
 #include <Disks/registerDisks.h>
 
+#include <filesystem>
+
 
 int mainEntryClickHouseKeeper(int argc, char ** argv)
 {
@@ -280,9 +282,12 @@ void Keeper::defineOptions(Poco::Util::OptionSet & options)
     BaseDaemon::defineOptions(options);
 }
 
-struct Keeper::KeeperHTTPContext : public IHTTPContext
+namespace
 {
-    explicit KeeperHTTPContext(TinyContextPtr context_)
+
+struct KeeperHTTPContext : public IHTTPContext
+{
+    explicit KeeperHTTPContext(ContextPtr context_)
         : context(std::move(context_))
     {}
 
@@ -326,12 +331,14 @@ struct Keeper::KeeperHTTPContext : public IHTTPContext
         return {context->getConfigRef().getInt64("keeper_server.http_send_timeout", DBMS_DEFAULT_SEND_TIMEOUT_SEC), 0};
     }
 
-    TinyContextPtr context;
+    ContextPtr context;
 };
 
-HTTPContextPtr Keeper::httpContext()
+HTTPContextPtr httpContext()
 {
-    return std::make_shared<KeeperHTTPContext>(tiny_context);
+    return std::make_shared<KeeperHTTPContext>(Context::getGlobalContextInstance());
+}
+
 }
 
 int Keeper::main(const std::vector<std::string> & /*args*/)
@@ -419,12 +426,14 @@ try
     global_context->setPath(path);
     global_context->setRemoteHostFilter(config());
 
+    if (config().has("macros"))
+        global_context->setMacros(std::make_unique<Macros>(config(), "macros", log));
+
     registerDisks(/*global_skip_access_check=*/false);
 
-    tiny_context = std::make_shared<TinyContext>();
     /// This object will periodically calculate some metrics.
     KeeperAsynchronousMetrics async_metrics(
-        tiny_context,
+        global_context,
         config().getUInt("asynchronous_metrics_update_period_s", 1),
         [&]() -> std::vector<ProtocolServerMetrics>
         {
@@ -449,12 +458,12 @@ try
     }
 
     /// Initialize keeper RAFT. Do nothing if no keeper_server in config.
-    tiny_context->initializeKeeperDispatcher(/* start_async = */ true);
-    FourLetterCommandFactory::registerCommands(*tiny_context->getKeeperDispatcher());
+    global_context->initializeKeeperDispatcher(/* start_async = */ true);
+    FourLetterCommandFactory::registerCommands(*global_context->getKeeperDispatcher());
 
-    auto config_getter = [this] () -> const Poco::Util::AbstractConfiguration &
+    auto config_getter = [&] () -> const Poco::Util::AbstractConfiguration &
     {
-        return tiny_context->getConfigRef();
+        return global_context->getConfigRef();
     };
 
     auto tcp_receive_timeout = config().getInt64("keeper_server.socket_receive_timeout_sec", DBMS_DEFAULT_RECEIVE_TIMEOUT_SEC);
@@ -476,7 +485,7 @@ try
                 "Keeper (tcp): " + address.toString(),
                 std::make_unique<TCPServer>(
                     new KeeperTCPHandlerFactory(
-                        config_getter, tiny_context->getKeeperDispatcher(),
+                        config_getter, global_context->getKeeperDispatcher(),
                         tcp_receive_timeout, tcp_send_timeout, false), server_pool, socket));
         });
 
@@ -494,7 +503,7 @@ try
                 "Keeper with secure protocol (tcp_secure): " + address.toString(),
                 std::make_unique<TCPServer>(
                     new KeeperTCPHandlerFactory(
-                        config_getter, tiny_context->getKeeperDispatcher(),
+                        config_getter, global_context->getKeeperDispatcher(),
                         tcp_receive_timeout, tcp_send_timeout, true), server_pool, socket));
 #else
             UNUSED(port);
@@ -546,7 +555,7 @@ try
         [&](ConfigurationPtr config, bool /* initial_loading */)
         {
             if (config->has("keeper_server"))
-                tiny_context->updateKeeperConfiguration(*config);
+                global_context->updateKeeperConfiguration(*config);
         },
         /* already_loaded = */ false);  /// Reload it right now (initial loading)
 
@@ -577,7 +586,7 @@ try
         else
             LOG_INFO(log, "Closed connections to Keeper.");
 
-        tiny_context->shutdownKeeperDispatcher();
+        global_context->shutdownKeeperDispatcher();
 
         /// Wait server pool to avoid use-after-free of destroyed context in the handlers
         server_pool.joinAll();
diff --git a/programs/keeper/Keeper.h b/programs/keeper/Keeper.h
index 8a7724acb85..f889ffa595b 100644
--- a/programs/keeper/Keeper.h
+++ b/programs/keeper/Keeper.h
@@ -1,9 +1,7 @@
 #pragma once
 
 #include <Server/IServer.h>
-#include <Server/HTTP/HTTPContext.h>
 #include <Daemon/BaseDaemon.h>
-#include <Coordination/TinyContext.h>
 
 namespace Poco
 {
@@ -68,11 +66,6 @@ protected:
     std::string getDefaultConfigFileName() const override;
 
 private:
-    TinyContextPtr tiny_context;
-
-    struct KeeperHTTPContext;
-    HTTPContextPtr httpContext();
-
     Poco::Net::SocketAddress socketBindListen(Poco::Net::ServerSocket & socket, const std::string & host, UInt16 port, [[maybe_unused]] bool secure = false) const;
 
     using CreateServerFunc = std::function<void(UInt16)>;
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index 1fda760cab0..852a21c1c45 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -1,5 +1,6 @@
 #include <filesystem>
 #include <Coordination/Changelog.h>
+#include <Disks/DiskLocal.h>
 #include <IO/ReadBufferFromFile.h>
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
@@ -85,17 +86,19 @@ class ChangelogWriter
 public:
     ChangelogWriter(
         std::map<uint64_t, ChangelogFileDescriptionPtr> & existing_changelogs_,
-        DiskPtr disk_,
+        KeeperContextPtr keeper_context_,
         LogFileSettings log_file_settings_)
         : existing_changelogs(existing_changelogs_)
         , log_file_settings(log_file_settings_)
-        , disk(disk_)
+        , keeper_context(std::move(keeper_context_))
         , log(&Poco::Logger::get("Changelog"))
     {
     }
 
     void setFile(ChangelogFileDescriptionPtr file_description, WriteMode mode)
     {
+        auto disk = getDisk();
+
         try
         {
             if (mode == WriteMode::Append && file_description->expectedEntriesCountInLog() != log_file_settings.rotate_interval)
@@ -146,7 +149,7 @@ public:
     /// There is bug when compressed_buffer has value, file_buf's ownership transfer to compressed_buffer
     bool isFileSet() const
     {
-        return compressed_buffer.get() != nullptr || file_buf.get() != nullptr;
+        return compressed_buffer != nullptr || file_buf != nullptr;
     }
 
     bool appendRecord(ChangelogRecord && record)
@@ -276,7 +279,7 @@ private:
 
         const auto * file_buffer = tryGetFileBuffer();
 
-        if (log_file_settings.max_size != 0)
+        if (log_file_settings.max_size != 0 && isLocalDisk())
         {
             int res = -1;
             do
@@ -354,11 +357,12 @@ private:
         {
             initial_file_size = 0;
             prealloc_done = true;
-            LOG_WARNING(log, "Could not preallocate space on disk {} using fallocate", disk->getName());
+            LOG_WARNING(log, "Could not preallocate space on disk {} using fallocate", getDisk()->getName());
             return;
         }
 
 #ifdef OS_LINUX
+        if (isLocalDisk())
         {
             int res = -1;
             do
@@ -383,6 +387,16 @@ private:
         prealloc_done = true;
     }
 
+    DiskPtr getDisk() const
+    {
+        return keeper_context->getLogDisk();
+    }
+
+    bool isLocalDisk() const
+    {
+        return dynamic_cast<DiskLocal *>(getDisk().get()) != nullptr;
+    }
+
     std::map<uint64_t, ChangelogFileDescriptionPtr> & existing_changelogs;
 
     ChangelogFileDescriptionPtr current_file_description{nullptr};
@@ -396,7 +410,7 @@ private:
 
     LogFileSettings log_file_settings;
 
-    DiskPtr disk;
+    KeeperContextPtr keeper_context;
 
     Poco::Logger * const log;
 };
@@ -533,18 +547,20 @@ private:
 };
 
 Changelog::Changelog(
-    DiskPtr disk_,
     Poco::Logger * log_,
-    LogFileSettings log_file_settings)
-    : disk(disk_)
-    , changelogs_detached_dir("detached")
+    LogFileSettings log_file_settings,
+    KeeperContextPtr keeper_context_)
+    : changelogs_detached_dir("detached")
     , rotate_interval(log_file_settings.rotate_interval)
     , log(log_)
     , write_operations(std::numeric_limits<size_t>::max())
     , append_completion_queue(std::numeric_limits<size_t>::max())
+    , keeper_context(std::move(keeper_context_))
 {
     /// Load all files in changelog directory
 
+    auto disk = getDisk();
+
     for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
     {
         if (it->name() == changelogs_detached_dir)
@@ -564,7 +580,7 @@ Changelog::Changelog(
     append_completion_thread = ThreadFromGlobalPool([this] { appendCompletionThread(); });
 
     current_writer = std::make_unique<ChangelogWriter>(
-        existing_changelogs, disk, log_file_settings);
+        existing_changelogs, keeper_context, log_file_settings);
 }
 
 void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uint64_t logs_to_keep)
@@ -636,7 +652,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
                 break;
             }
 
-            ChangelogReader reader(disk, changelog_description.path);
+            ChangelogReader reader(getDisk(), changelog_description.path);
             last_log_read_result = reader.readChangelog(logs, start_to_read_from, log);
             last_log_read_result->log_start_index = changelog_description.from_log_index;
 
@@ -703,7 +719,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
         if (last_log_read_result->last_read_index == 0 || last_log_read_result->error) /// If it's broken log then remove it
         {
             LOG_INFO(log, "Removing chagelog {} because it's empty or read finished with error", description->path);
-            disk->removeFile(description->path);
+            getDisk()->removeFile(description->path);
             existing_changelogs.erase(last_log_read_result->log_start_index);
             std::erase_if(logs, [last_log_read_result](const auto & item) { return item.first >= last_log_read_result->log_start_index; });
         }
@@ -748,8 +764,15 @@ std::string getCurrentTimestampFolder()
 
 }
 
+DiskPtr Changelog::getDisk() const
+{
+    return keeper_context->getLogDisk();
+}
+
 void Changelog::removeExistingLogs(ChangelogIter begin, ChangelogIter end)
 {
+    auto disk = getDisk();
+
     const auto timestamp_folder = (fs::path(changelogs_detached_dir) / getCurrentTimestampFolder()).generic_string();
 
     for (auto itr = begin; itr != end;)
@@ -920,7 +943,7 @@ void Changelog::writeAt(uint64_t index, const LogEntryPtr & log_entry)
             auto to_remove_itr = existing_changelogs.upper_bound(index);
             for (auto itr = to_remove_itr; itr != existing_changelogs.end();)
             {
-                disk->removeFile(itr->second->path);
+                getDisk()->removeFile(itr->second->path);
                 itr = existing_changelogs.erase(itr);
             }
         }
@@ -974,7 +997,7 @@ void Changelog::compact(uint64_t up_to_log_index)
             {
                 try
                 {
-                    disk->removeFile(itr->second->path);
+                    getDisk()->removeFile(itr->second->path);
                     LOG_INFO(log, "Removed changelog {} because of compaction.", itr->second->path);
                 }
                 catch (Exception & e)
@@ -1179,7 +1202,7 @@ void Changelog::cleanLogThread()
     {
         try
         {
-            disk->removeFile(path);
+            getDisk()->removeFile(path);
             LOG_INFO(log, "Removed changelog {} because of compaction.", path);
         }
         catch (Exception & e)
diff --git a/src/Coordination/Changelog.h b/src/Coordination/Changelog.h
index 7204c80a356..6f0c4e45605 100644
--- a/src/Coordination/Changelog.h
+++ b/src/Coordination/Changelog.h
@@ -11,6 +11,7 @@
 #include <libnuraft/raft_server.hxx>
 #include <Common/ConcurrentBoundedQueue.h>
 #include <Common/ThreadPool.h>
+#include <Coordination/KeeperContext.h>
 
 namespace DB
 {
@@ -87,9 +88,9 @@ class Changelog
 {
 public:
     Changelog(
-        DiskPtr disk_,
         Poco::Logger * log_,
-        LogFileSettings log_file_settings);
+        LogFileSettings log_file_settings,
+        KeeperContextPtr keeper_context_);
 
     Changelog(Changelog &&) = delete;
 
@@ -152,6 +153,8 @@ private:
     /// Pack log_entry into changelog record
     static ChangelogRecord buildRecord(uint64_t index, const LogEntryPtr & log_entry);
 
+    DiskPtr getDisk() const;
+
     /// Currently existing changelogs
     std::map<uint64_t, ChangelogFileDescriptionPtr> existing_changelogs;
 
@@ -169,7 +172,6 @@ private:
     /// Clean useless log files in a background thread
     void cleanLogThread();
 
-    DiskPtr disk;
     const String changelogs_detached_dir;
     const uint64_t rotate_interval;
     Poco::Logger * log;
@@ -223,6 +225,8 @@ private:
 
     nuraft::wptr<nuraft::raft_server> raft_server;
 
+    KeeperContextPtr keeper_context;
+
     bool initialized = false;
 };
 
diff --git a/src/Coordination/KeeperAsynchronousMetrics.cpp b/src/Coordination/KeeperAsynchronousMetrics.cpp
index 2d523a26dcc..1427130b184 100644
--- a/src/Coordination/KeeperAsynchronousMetrics.cpp
+++ b/src/Coordination/KeeperAsynchronousMetrics.cpp
@@ -108,8 +108,8 @@ void updateKeeperInformation(KeeperDispatcher & keeper_dispatcher, AsynchronousM
 }
 
 KeeperAsynchronousMetrics::KeeperAsynchronousMetrics(
-    TinyContextPtr tiny_context_, int update_period_seconds, const ProtocolServerMetricsFunc & protocol_server_metrics_func_)
-    : AsynchronousMetrics(update_period_seconds, protocol_server_metrics_func_), tiny_context(std::move(tiny_context_))
+    ContextPtr context_, int update_period_seconds, const ProtocolServerMetricsFunc & protocol_server_metrics_func_)
+    : AsynchronousMetrics(update_period_seconds, protocol_server_metrics_func_), context(std::move(context_))
 {
 }
 
@@ -117,7 +117,7 @@ void KeeperAsynchronousMetrics::updateImpl(AsynchronousMetricValues & new_values
 {
 #if USE_NURAFT
     {
-        auto keeper_dispatcher = tiny_context->tryGetKeeperDispatcher();
+        auto keeper_dispatcher = context->tryGetKeeperDispatcher();
         if (keeper_dispatcher)
             updateKeeperInformation(*keeper_dispatcher, new_values);
     }
diff --git a/src/Coordination/KeeperAsynchronousMetrics.h b/src/Coordination/KeeperAsynchronousMetrics.h
index 8fa27336bc5..14092c11c15 100644
--- a/src/Coordination/KeeperAsynchronousMetrics.h
+++ b/src/Coordination/KeeperAsynchronousMetrics.h
@@ -1,6 +1,6 @@
 #pragma once
 
-#include <Coordination/TinyContext.h>
+#include <Interpreters/Context.h>
 #include <Common/AsynchronousMetrics.h>
 
 namespace DB
@@ -13,10 +13,10 @@ class KeeperAsynchronousMetrics : public AsynchronousMetrics
 {
 public:
     KeeperAsynchronousMetrics(
-        TinyContextPtr tiny_context_, int update_period_seconds, const ProtocolServerMetricsFunc & protocol_server_metrics_func_);
+        ContextPtr context_, int update_period_seconds, const ProtocolServerMetricsFunc & protocol_server_metrics_func_);
 
 private:
-    TinyContextPtr tiny_context;
+    ContextPtr context;
 
     void updateImpl(AsynchronousMetricValues & new_values, TimePoint update_time, TimePoint current_time) override;
 };
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index 9e504f5aa07..ff3f96f199b 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -20,10 +20,10 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
 
     disk_selector->initialize(config, "storage_configuration.disks", Context::getGlobalContextInstance());
 
-    log_storage_path = getLogsPathFromConfig(config);
-    snapshot_storage_path = getSnapshotsPathFromConfig(config);
+    log_storage = getLogsPathFromConfig(config);
+    snapshot_storage = getSnapshotsPathFromConfig(config);
 
-    state_file_path = getStateFilePathFromConfig(config);
+    state_file_storage = getStatePathFromConfig(config);
 }
 
 KeeperContext::Phase KeeperContext::getServerState() const
@@ -51,54 +51,109 @@ void KeeperContext::setDigestEnabled(bool digest_enabled_)
     digest_enabled = digest_enabled_;
 }
 
+DiskPtr KeeperContext::getDisk(const Storage & storage) const
+{
+    if (const auto * storage_disk = std::get_if<DiskPtr>(&storage))
+        return *storage_disk;
+
+    const auto & disk_name = std::get<std::string>(storage);
+
+    return disk_selector->get(disk_name);
+}
+
+DiskPtr KeeperContext::getLogDisk() const
+{
+    return getDisk(log_storage);
+}
+
+DiskPtr KeeperContext::getSnapshotsDisk() const
+{
+    return getDisk(snapshot_storage);
+}
+
+DiskPtr KeeperContext::getStateFileDisk() const
+{
+    return getDisk(state_file_storage);
+}
+
 KeeperContext::Storage KeeperContext::getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const
 {
+    const auto create_local_disk = [](const auto & path)
+    {
+        if (!fs::exists(path))
+            fs::create_directories(path);
+
+        return std::make_shared<DiskLocal>("LogDisk", path, 0);
+    };
+
     /// the most specialized path
     if (config.has("keeper_server.log_storage_path"))
-        return std::make_shared<DiskLocal>("LogDisk", config.getString("keeper_server.log_storage_path"), 0);
+        return create_local_disk(config.getString("keeper_server.log_storage_path"));
 
     if (config.has("keeper_server.log_storage_disk"))
         return config.getString("keeper_server.log_storage_disk");
 
     if (config.has("keeper_server.storage_path"))
-        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("keeper_server.storage_path")} / "logs", 0);
+        return create_local_disk(std::filesystem::path{config.getString("keeper_server.storage_path")} / "logs");
 
     if (standalone_keeper)
-        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "logs", 0);
+        return create_local_disk(std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "logs");
     else
-        return std::make_shared<DiskLocal>("LogDisk", std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/logs", 0);
+        return create_local_disk(std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/logs");
 }
 
-std::string KeeperContext::getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config)
+KeeperContext::Storage KeeperContext::getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const
 {
+    const auto create_local_disk = [](const auto & path)
+    {
+        if (!fs::exists(path))
+            fs::create_directories(path);
+
+        return std::make_shared<DiskLocal>("SnapshotDisk", path, 0);
+    };
+
     /// the most specialized path
     if (config.has("keeper_server.snapshot_storage_path"))
-        return config.getString("keeper_server.snapshot_storage_path");
+        return create_local_disk(config.getString("keeper_server.snapshot_storage_path"));
+
+    if (config.has("keeper_server.snapshot_storage_disk"))
+        return config.getString("keeper_server.snapshot_storage_disk");
 
     if (config.has("keeper_server.storage_path"))
-        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "snapshots";
+        return create_local_disk(std::filesystem::path{config.getString("keeper_server.storage_path")} / "snapshots");
 
     if (standalone_keeper)
-        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "snapshots";
+        return create_local_disk(std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "snapshots");
     else
-        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/snapshots";
+        return create_local_disk(std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/snapshots");
 }
 
-std::string KeeperContext::getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config)
+KeeperContext::Storage KeeperContext::getStatePathFromConfig(const Poco::Util::AbstractConfiguration & config) const
 {
+    const auto create_local_disk = [](const auto & path)
+    {
+        if (!fs::exists(path))
+            fs::create_directories(path);
+
+        return std::make_shared<DiskLocal>("SnapshotDisk", path, 0);
+    };
+
+    if (config.has("keeper_server.state_storage_disk"))
+        return config.getString("keeper_server.state_storage_disk");
+
     if (config.has("keeper_server.storage_path"))
-        return std::filesystem::path{config.getString("keeper_server.storage_path")} / "state";
+        return create_local_disk(std::filesystem::path{config.getString("keeper_server.storage_path")});
 
     if (config.has("keeper_server.snapshot_storage_path"))
-        return std::filesystem::path(config.getString("keeper_server.snapshot_storage_path")).parent_path() / "state";
+        return create_local_disk(std::filesystem::path(config.getString("keeper_server.snapshot_storage_path")).parent_path());
 
     if (config.has("keeper_server.log_storage_path"))
-        return std::filesystem::path(config.getString("keeper_server.log_storage_path")).parent_path() / "state";
+        return create_local_disk(std::filesystem::path(config.getString("keeper_server.log_storage_path")).parent_path());
 
     if (standalone_keeper)
-        return std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)} / "state";
+        return create_local_disk(std::filesystem::path{config.getString("path", KEEPER_DEFAULT_PATH)});
     else
-        return std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination/state";
+        return create_local_disk(std::filesystem::path{config.getString("path", DBMS_DEFAULT_PATH)} / "coordination");
 }
 
 }
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 2a215f9d58f..1fc01f12bba 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -31,13 +31,19 @@ public:
 
     bool digestEnabled() const;
     void setDigestEnabled(bool digest_enabled_);
+
+    DiskPtr getLogDisk() const;
+    DiskPtr getSnapshotsDisk() const;
+    DiskPtr getStateFileDisk() const;
 private:
     /// local disk defined using path or disk name
     using Storage = std::variant<DiskPtr, std::string>;
 
     Storage getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const;
-    std::string getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config);
-    std::string getStateFilePathFromConfig(const Poco::Util::AbstractConfiguration & config);
+    Storage getSnapshotsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const;
+    Storage getStatePathFromConfig(const Poco::Util::AbstractConfiguration & config) const;
+
+    DiskPtr getDisk(const Storage & storage) const;
 
     Phase server_state{Phase::INIT};
 
@@ -46,9 +52,9 @@ private:
 
     std::shared_ptr<DiskSelector> disk_selector;
 
-    Storage log_storage_path;
-    Storage snapshot_storage_path;
-    Storage state_file_path;
+    Storage log_storage;
+    Storage snapshot_storage;
+    Storage state_file_storage;
 
     bool standalone_keeper;
 };
diff --git a/src/Coordination/KeeperLogStore.cpp b/src/Coordination/KeeperLogStore.cpp
index 7c4f76e0180..a9153475dbc 100644
--- a/src/Coordination/KeeperLogStore.cpp
+++ b/src/Coordination/KeeperLogStore.cpp
@@ -6,9 +6,9 @@
 namespace DB
 {
 
-KeeperLogStore::KeeperLogStore(DiskPtr disk_, LogFileSettings log_file_settings)
+KeeperLogStore::KeeperLogStore(LogFileSettings log_file_settings, KeeperContextPtr keeper_context)
     : log(&Poco::Logger::get("KeeperLogStore"))
-    , changelog(disk_, log, log_file_settings)
+    , changelog(log, log_file_settings, keeper_context)
 {
     if (log_file_settings.force_sync)
         LOG_INFO(log, "force_sync enabled");
@@ -16,11 +16,6 @@ KeeperLogStore::KeeperLogStore(DiskPtr disk_, LogFileSettings log_file_settings)
         LOG_INFO(log, "force_sync disabled");
 }
 
-KeeperLogStore::KeeperLogStore(const std::string & changelogs_path, LogFileSettings log_file_settings)
-    : KeeperLogStore(std::make_shared<DiskLocal>("Keeper-logs", changelogs_path, 0), log_file_settings)
-{
-}
-
 uint64_t KeeperLogStore::start_index() const
 {
     std::lock_guard lock(changelog_lock);
diff --git a/src/Coordination/KeeperLogStore.h b/src/Coordination/KeeperLogStore.h
index 2902de129e7..6e71d8c55cf 100644
--- a/src/Coordination/KeeperLogStore.h
+++ b/src/Coordination/KeeperLogStore.h
@@ -4,6 +4,7 @@
 #include <mutex>
 #include <Core/Types.h>
 #include <Coordination/Changelog.h>
+#include <Coordination/KeeperContext.h>
 #include <base/defines.h>
 
 namespace DB
@@ -13,10 +14,7 @@ namespace DB
 class KeeperLogStore : public nuraft::log_store
 {
 public:
-    KeeperLogStore(DiskPtr disk_, LogFileSettings log_file_settings);
-
-    /// For gtest
-    KeeperLogStore(const std::string & changelogs_path, LogFileSettings log_file_settings);
+    KeeperLogStore(LogFileSettings log_file_settings, KeeperContextPtr keeper_context);
 
     /// Read log storage from filesystem starting from last_commited_log_index
     void init(uint64_t last_commited_log_index, uint64_t logs_to_keep);
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index d63593436f4..4cacf566df6 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -122,39 +122,22 @@ KeeperServer::KeeperServer(
 
     keeper_context->initialize(config);
 
-    //if (!fs::exists(keeper_context->snapshot_storage_path))
-    //    fs::create_directories(keeper_context->snapshot_storage_path);
-    auto snapshots_disk = std::make_shared<DiskLocal>("Keeper-snapshots", "", 0);
-
     state_machine = nuraft::cs_new<KeeperStateMachine>(
         responses_queue_,
         snapshots_queue_,
-        snapshots_disk,
         coordination_settings,
         keeper_context,
         config.getBool("keeper_server.upload_snapshot_on_exit", true) ? &snapshot_manager_s3 : nullptr,
         commit_callback,
         checkAndGetSuperdigest(configuration_and_settings_->super_digest));
 
-    //auto state_path = fs::path(keeper_context->state_file_path).parent_path().generic_string();
-    //auto state_file_name = fs::path(configuration_and_settings_->state_file_path).filename().generic_string();
-
-    //if (!fs::exists(state_path))
-    //    fs::create_directories(state_path);
-    auto state_disk = std::make_shared<DiskLocal>("Keeper-state", "", 0);
-
-    //if (!fs::exists(configuration_and_settings_->log_storage_path))
-    //    fs::create_directories(configuration_and_settings_->log_storage_path);
-    auto logs_disk = std::make_shared<DiskLocal>("Keeper-logs", "", 0);
-
     state_manager = nuraft::cs_new<KeeperStateManager>(
         server_id,
         "keeper_server",
-        logs_disk,
-        state_disk,
         "state",
         config,
-        coordination_settings);
+        coordination_settings,
+        keeper_context);
 }
 
 /**
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index e1c0c034cff..d47ea475c42 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -508,36 +508,18 @@ KeeperStorageSnapshot::~KeeperStorageSnapshot()
 }
 
 KeeperSnapshotManager::KeeperSnapshotManager(
-    const std::string & snapshots_path_,
     size_t snapshots_to_keep_,
     const KeeperContextPtr & keeper_context_,
     bool compress_snapshots_zstd_,
     const std::string & superdigest_,
     size_t storage_tick_time_)
-    : KeeperSnapshotManager(
-        std::make_shared<DiskLocal>("Keeper-snapshots", snapshots_path_, 0),
-        snapshots_to_keep_,
-        keeper_context_,
-        compress_snapshots_zstd_,
-        superdigest_,
-        storage_tick_time_)
-{
-}
-
-KeeperSnapshotManager::KeeperSnapshotManager(
-    DiskPtr disk_,
-    size_t snapshots_to_keep_,
-    const KeeperContextPtr & keeper_context_,
-    bool compress_snapshots_zstd_,
-    const std::string & superdigest_,
-    size_t storage_tick_time_)
-    : disk(disk_)
-    , snapshots_to_keep(snapshots_to_keep_)
+    : snapshots_to_keep(snapshots_to_keep_)
     , compress_snapshots_zstd(compress_snapshots_zstd_)
     , superdigest(superdigest_)
     , storage_tick_time(storage_tick_time_)
     , keeper_context(keeper_context_)
 {
+    auto disk = getDisk();
     for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
     {
         const auto & name = it->name();
@@ -566,6 +548,7 @@ std::string KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
+    auto disk = getDisk();
     auto plain_buf = disk->writeFile(tmp_snapshot_file_name);
     copyData(reader, *plain_buf);
     plain_buf->sync();
@@ -589,7 +572,7 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBuff
         }
         catch (const DB::Exception &)
         {
-            disk->removeFile(latest_itr->second);
+            getDisk()->removeFile(latest_itr->second);
             existing_snapshots.erase(latest_itr->first);
             tryLogCurrentException(__PRETTY_FUNCTION__);
         }
@@ -602,7 +585,7 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeSnapshotBufferFrom
 {
     const std::string & snapshot_path = existing_snapshots.at(up_to_log_idx);
     WriteBufferFromNuraftBuffer writer;
-    auto reader = disk->readFile(snapshot_path);
+    auto reader = getDisk()->readFile(snapshot_path);
     copyData(*reader, writer);
     return writer.getBuffer();
 }
@@ -664,6 +647,11 @@ SnapshotDeserializationResult KeeperSnapshotManager::restoreFromLatestSnapshot()
     return deserializeSnapshotFromBuffer(buffer);
 }
 
+DiskPtr KeeperSnapshotManager::getDisk() const
+{
+    return keeper_context->getSnapshotsDisk();
+}
+
 void KeeperSnapshotManager::removeOutdatedSnapshotsIfNeeded()
 {
     while (existing_snapshots.size() > snapshots_to_keep)
@@ -675,7 +663,7 @@ void KeeperSnapshotManager::removeSnapshot(uint64_t log_idx)
     auto itr = existing_snapshots.find(log_idx);
     if (itr == existing_snapshots.end())
         throw Exception(ErrorCodes::UNKNOWN_SNAPSHOT, "Unknown snapshot with log index {}", log_idx);
-    disk->removeFile(itr->second);
+    getDisk()->removeFile(itr->second);
     existing_snapshots.erase(itr);
 }
 
@@ -685,7 +673,7 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
-    auto writer = disk->writeFile(tmp_snapshot_file_name);
+    auto writer = getDisk()->writeFile(tmp_snapshot_file_name);
     std::unique_ptr<WriteBuffer> compressed_writer;
     if (compress_snapshots_zstd)
         compressed_writer = wrapWriteBufferWithCompressionMethod(std::move(writer), CompressionMethod::Zstd, 3);
@@ -700,7 +688,7 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
 
     try
     {
-        disk->moveFile(tmp_snapshot_file_name, snapshot_file_name);
+        getDisk()->moveFile(tmp_snapshot_file_name, snapshot_file_name);
     }
     catch (fs::filesystem_error & e)
     {
diff --git a/src/Coordination/KeeperSnapshotManager.h b/src/Coordination/KeeperSnapshotManager.h
index 9babad9ed98..7b1129018d8 100644
--- a/src/Coordination/KeeperSnapshotManager.h
+++ b/src/Coordination/KeeperSnapshotManager.h
@@ -99,16 +99,6 @@ class KeeperSnapshotManager
 {
 public:
     KeeperSnapshotManager(
-        DiskPtr disk_,
-        size_t snapshots_to_keep_,
-        const KeeperContextPtr & keeper_context_,
-        bool compress_snapshots_zstd_ = true,
-        const std::string & superdigest_ = "",
-        size_t storage_tick_time_ = 500);
-
-    /// For gtest
-    KeeperSnapshotManager(
-        const std::string & snapshots_path_,
         size_t snapshots_to_keep_,
         const KeeperContextPtr & keeper_context_,
         bool compress_snapshots_zstd_ = true,
@@ -157,7 +147,7 @@ public:
 
             try
             {
-                if (disk->exists(path))
+                if (getDisk()->exists(path))
                     return path;
             }
             catch (...)
@@ -170,11 +160,12 @@ public:
 private:
     void removeOutdatedSnapshotsIfNeeded();
 
+    DiskPtr getDisk() const;
+
     /// Checks first 4 buffer bytes to became sure that snapshot compressed with
     /// ZSTD codec.
     static bool isZstdCompressed(nuraft::ptr<nuraft::buffer> buffer);
 
-    DiskPtr disk;
     /// How many snapshots to keep before remove
     const size_t snapshots_to_keep;
     /// All existing snapshots in our path (log_index -> path)
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index a7c845e5017..69c15db51da 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -43,7 +43,6 @@ namespace
 KeeperStateMachine::KeeperStateMachine(
     ResponsesQueue & responses_queue_,
     SnapshotsQueue & snapshots_queue_,
-    DiskPtr disk_,
     const CoordinationSettingsPtr & coordination_settings_,
     const KeeperContextPtr & keeper_context_,
     KeeperSnapshotManagerS3 * snapshot_manager_s3_,
@@ -52,7 +51,6 @@ KeeperStateMachine::KeeperStateMachine(
     : commit_callback(commit_callback_)
     , coordination_settings(coordination_settings_)
     , snapshot_manager(
-          disk_,
           coordination_settings->snapshots_to_keep,
           keeper_context_,
           coordination_settings->compress_snapshots_with_zstd_format,
diff --git a/src/Coordination/KeeperStateMachine.h b/src/Coordination/KeeperStateMachine.h
index 1fe4db4de68..afe11150f36 100644
--- a/src/Coordination/KeeperStateMachine.h
+++ b/src/Coordination/KeeperStateMachine.h
@@ -26,7 +26,6 @@ public:
     KeeperStateMachine(
         ResponsesQueue & responses_queue_,
         SnapshotsQueue & snapshots_queue_,
-        DiskPtr disk_,
         const CoordinationSettingsPtr & coordination_settings_,
         const KeeperContextPtr & keeper_context_,
         KeeperSnapshotManagerS3 * snapshot_manager_s3_,
diff --git a/src/Coordination/KeeperStateManager.cpp b/src/Coordination/KeeperStateManager.cpp
index bcd5ce89e49..352e67e7c43 100644
--- a/src/Coordination/KeeperStateManager.cpp
+++ b/src/Coordination/KeeperStateManager.cpp
@@ -212,12 +212,14 @@ KeeperStateManager::parseServersConfiguration(const Poco::Util::AbstractConfigur
     return result;
 }
 
-KeeperStateManager::KeeperStateManager(
-    int server_id_, const std::string & host, int port, const std::string & logs_path, const std::string & state_file_path)
+KeeperStateManager::KeeperStateManager(int server_id_, const std::string & host, int port, KeeperContextPtr keeper_context_)
     : my_server_id(server_id_)
     , secure(false)
-    , log_store(nuraft::cs_new<KeeperLogStore>(std::make_shared<DiskLocal>("Keeper-logs", logs_path, 0), LogFileSettings{.force_sync =false, .compress_logs = false, .rotate_interval = 5000}))
-    , server_state_file_name(fs::path(state_file_path).filename().generic_string())
+    , log_store(nuraft::cs_new<KeeperLogStore>(
+          LogFileSettings{.force_sync = false, .compress_logs = false, .rotate_interval = 5000},
+          keeper_context_))
+    , server_state_file_name("state")
+    , keeper_context(keeper_context_)
     , logger(&Poco::Logger::get("KeeperStateManager"))
 {
     auto peer_config = nuraft::cs_new<nuraft::srv_config>(my_server_id, host + ":" + std::to_string(port));
@@ -230,17 +232,15 @@ KeeperStateManager::KeeperStateManager(
 KeeperStateManager::KeeperStateManager(
     int my_server_id_,
     const std::string & config_prefix_,
-    DiskPtr log_disk_,
-    DiskPtr state_disk_,
     const std::string & server_state_file_name_,
     const Poco::Util::AbstractConfiguration & config,
-    const CoordinationSettingsPtr & coordination_settings)
+    const CoordinationSettingsPtr & coordination_settings,
+    KeeperContextPtr keeper_context_)
     : my_server_id(my_server_id_)
     , secure(config.getBool(config_prefix_ + ".raft_configuration.secure", false))
     , config_prefix(config_prefix_)
     , configuration_wrapper(parseServersConfiguration(config, false))
     , log_store(nuraft::cs_new<KeeperLogStore>(
-          log_disk_,
           LogFileSettings
           {
             .force_sync = coordination_settings->force_sync,
@@ -248,9 +248,10 @@ KeeperStateManager::KeeperStateManager(
             .rotate_interval = coordination_settings->rotate_log_storage_interval,
             .max_size = coordination_settings->max_log_file_size,
             .overallocate_size = coordination_settings->log_file_overallocate_size
-          }))
-    , disk(state_disk_)
+          },
+          keeper_context_))
     , server_state_file_name(server_state_file_name_)
+    , keeper_context(keeper_context_)
     , logger(&Poco::Logger::get("KeeperStateManager"))
 {
 }
@@ -299,6 +300,11 @@ const String & KeeperStateManager::getOldServerStatePath()
     return old_path;
 }
 
+DiskPtr KeeperStateManager::getStateFileDisk() const
+{
+    return keeper_context->getStateFileDisk();
+}
+
 namespace
 {
 enum ServerStateVersion : uint8_t
@@ -314,6 +320,8 @@ void KeeperStateManager::save_state(const nuraft::srv_state & state)
 {
     const auto & old_path = getOldServerStatePath();
 
+    auto disk = getStateFileDisk();
+
     if (disk->exists(server_state_file_name))
         disk->moveFile(server_state_file_name, old_path);
 
@@ -338,7 +346,9 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
 {
     const auto & old_path = getOldServerStatePath();
 
-    const auto try_read_file = [this](const auto & path) -> nuraft::ptr<nuraft::srv_state>
+    auto disk = getStateFileDisk();
+
+    const auto try_read_file = [&](const auto & path) -> nuraft::ptr<nuraft::srv_state>
     {
         try
         {
diff --git a/src/Coordination/KeeperStateManager.h b/src/Coordination/KeeperStateManager.h
index d8369100d1c..f24f0c2b1e5 100644
--- a/src/Coordination/KeeperStateManager.h
+++ b/src/Coordination/KeeperStateManager.h
@@ -39,19 +39,17 @@ public:
     KeeperStateManager(
         int server_id_,
         const std::string & config_prefix_,
-        DiskPtr logs_disk_,
-        DiskPtr state_disk_,
-        const std::string & state_file_path,
+        const std::string & server_state_file_name_,
         const Poco::Util::AbstractConfiguration & config,
-        const CoordinationSettingsPtr & coordination_settings);
+        const CoordinationSettingsPtr & coordination_settings,
+        KeeperContextPtr keeper_context_);
 
     /// Constructor for tests
     KeeperStateManager(
         int server_id_,
         const std::string & host,
         int port,
-        const std::string & logs_path,
-        const std::string & state_file_path);
+        KeeperContextPtr keeper_context_);
 
     void loadLogStore(uint64_t last_commited_index, uint64_t logs_to_keep);
 
@@ -114,6 +112,8 @@ public:
 private:
     const String & getOldServerStatePath();
 
+    DiskPtr getStateFileDisk() const;
+
     /// Wrapper struct for Keeper cluster config. We parse this
     /// info from XML files.
     struct KeeperConfigurationWrapper
@@ -137,9 +137,10 @@ private:
 
     nuraft::ptr<KeeperLogStore> log_store;
 
-    DiskPtr disk;
     const String server_state_file_name;
 
+    KeeperContextPtr keeper_context;
+
     Poco::Logger * logger;
 
 public:
diff --git a/src/Coordination/Context/Context.cpp b/src/Coordination/Standalone/Context.cpp
similarity index 80%
rename from src/Coordination/Context/Context.cpp
rename to src/Coordination/Standalone/Context.cpp
index aeb4e405938..667fabf4d66 100644
--- a/src/Coordination/Context/Context.cpp
+++ b/src/Coordination/Standalone/Context.cpp
@@ -38,6 +38,9 @@ struct ContextSharedPart : boost::noncopyable
     /// For access of most of shared objects. Recursive mutex.
     mutable std::recursive_mutex mutex;
 
+    mutable std::mutex keeper_dispatcher_mutex;
+    mutable std::shared_ptr<KeeperDispatcher> keeper_dispatcher TSA_GUARDED_BY(keeper_dispatcher_mutex);
+
     ServerSettings server_settings;
 
     String path;                                            /// Path to the data directory, with a slash at the end.
@@ -129,6 +132,11 @@ MultiVersion<Macros>::Version Context::getMacros() const
     return shared->macros.get();
 }
 
+void Context::setMacros(std::unique_ptr<Macros> && macros)
+{
+    shared->macros.set(std::move(macros));
+}
+
 BackgroundSchedulePool & Context::getSchedulePool() const
 {
     auto lock = getLock();
@@ -256,4 +264,54 @@ ReadSettings Context::getReadSettings() const
     return ReadSettings{};
 }
 
+void Context::initializeKeeperDispatcher([[maybe_unused]] bool start_async) const
+{
+    const auto & config_ref = getConfigRef();
+
+    std::lock_guard lock(shared->keeper_dispatcher_mutex);
+
+    if (shared->keeper_dispatcher)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to initialize Keeper multiple times");
+
+    if (config_ref.has("keeper_server"))
+    {
+        shared->keeper_dispatcher = std::make_shared<KeeperDispatcher>();
+        shared->keeper_dispatcher->initialize(config_ref, true, start_async, getMacros());
+    }
+}
+
+std::shared_ptr<KeeperDispatcher> Context::getKeeperDispatcher() const
+{
+    std::lock_guard lock(shared->keeper_dispatcher_mutex);
+    if (!shared->keeper_dispatcher)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Keeper must be initialized before requests");
+
+    return shared->keeper_dispatcher;
+}
+
+std::shared_ptr<KeeperDispatcher> Context::tryGetKeeperDispatcher() const
+{
+    std::lock_guard lock(shared->keeper_dispatcher_mutex);
+    return shared->keeper_dispatcher;
+}
+
+void Context::shutdownKeeperDispatcher() const
+{
+    std::lock_guard lock(shared->keeper_dispatcher_mutex);
+    if (shared->keeper_dispatcher)
+    {
+        shared->keeper_dispatcher->shutdown();
+        shared->keeper_dispatcher.reset();
+    }
+}
+
+void Context::updateKeeperConfiguration([[maybe_unused]] const Poco::Util::AbstractConfiguration & config_)
+{
+    std::lock_guard lock(shared->keeper_dispatcher_mutex);
+    if (!shared->keeper_dispatcher)
+        return;
+
+    shared->keeper_dispatcher->updateConfiguration(getConfigRef(), getMacros());
+}
+
 }
diff --git a/src/Coordination/Context/Context.h b/src/Coordination/Standalone/Context.h
similarity index 88%
rename from src/Coordination/Context/Context.h
rename to src/Coordination/Standalone/Context.h
index 683209d942e..c2eee981aaa 100644
--- a/src/Coordination/Context/Context.h
+++ b/src/Coordination/Standalone/Context.h
@@ -2,6 +2,8 @@
 
 #include <Interpreters/Context_fwd.h>
 
+#include <Coordination/KeeperDispatcher.h>
+
 #include <Common/MultiVersion.h>
 #include <Common/RemoteHostFilter.h>
 
@@ -85,6 +87,7 @@ public:
     void setPath(const String & path);
 
     MultiVersion<Macros>::Version getMacros() const;
+    void setMacros(std::unique_ptr<Macros> && macros);
 
     BackgroundSchedulePool & getSchedulePool() const;
 
@@ -106,6 +109,12 @@ public:
     ThrottlerPtr getLocalWriteThrottler() const;
 
     ReadSettings getReadSettings() const;
+
+    std::shared_ptr<KeeperDispatcher> getKeeperDispatcher() const;
+    std::shared_ptr<KeeperDispatcher> tryGetKeeperDispatcher() const;
+    void initializeKeeperDispatcher(bool start_async) const;
+    void shutdownKeeperDispatcher() const;
+    void updateKeeperConfiguration(const Poco::Util::AbstractConfiguration & config);
 };
 
 }
diff --git a/src/Coordination/Context/Settings.cpp b/src/Coordination/Standalone/Settings.cpp
similarity index 100%
rename from src/Coordination/Context/Settings.cpp
rename to src/Coordination/Standalone/Settings.cpp
diff --git a/src/Coordination/Context/ThreadStatusExt.cpp b/src/Coordination/Standalone/ThreadStatusExt.cpp
similarity index 100%
rename from src/Coordination/Context/ThreadStatusExt.cpp
rename to src/Coordination/Standalone/ThreadStatusExt.cpp
diff --git a/src/Coordination/TinyContext.cpp b/src/Coordination/TinyContext.cpp
deleted file mode 100644
index 47b0a48dcda..00000000000
--- a/src/Coordination/TinyContext.cpp
+++ /dev/null
@@ -1,87 +0,0 @@
-#include <Coordination/TinyContext.h>
-
-#include <Common/Exception.h>
-#include <Coordination/KeeperDispatcher.h>
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-}
-
-void TinyContext::setConfig(const ConfigurationPtr & config_)
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    config = config_;
-}
-
-const Poco::Util::AbstractConfiguration & TinyContext::getConfigRef() const
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    return config ? *config : Poco::Util::Application::instance().config();
-}
-
-
-void TinyContext::initializeKeeperDispatcher([[maybe_unused]] bool start_async) const
-{
-    const auto & config_ref = getConfigRef();
-
-    std::lock_guard lock(keeper_dispatcher_mutex);
-
-    if (keeper_dispatcher)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to initialize Keeper multiple times");
-
-    if (config_ref.has("keeper_server"))
-    {
-        keeper_dispatcher = std::make_shared<KeeperDispatcher>();
-
-        MultiVersion<Macros>::Version macros;
-
-        if (config_ref.has("macros"))
-            macros = std::make_unique<Macros>(config_ref, "macros", &Poco::Logger::get("TinyContext"));
-        keeper_dispatcher->initialize(config_ref, true, start_async, macros);
-    }
-}
-
-std::shared_ptr<KeeperDispatcher> TinyContext::getKeeperDispatcher() const
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    if (!keeper_dispatcher)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Keeper must be initialized before requests");
-
-    return keeper_dispatcher;
-}
-
-std::shared_ptr<KeeperDispatcher> TinyContext::tryGetKeeperDispatcher() const
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    return keeper_dispatcher;
-}
-
-void TinyContext::shutdownKeeperDispatcher() const
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    if (keeper_dispatcher)
-    {
-        keeper_dispatcher->shutdown();
-        keeper_dispatcher.reset();
-    }
-}
-
-void TinyContext::updateKeeperConfiguration([[maybe_unused]] const Poco::Util::AbstractConfiguration & config_)
-{
-    std::lock_guard lock(keeper_dispatcher_mutex);
-    if (!keeper_dispatcher)
-        return;
-
-    MultiVersion<Macros>::Version macros;
-
-    if (config_.has("macros"))
-        macros = std::make_unique<Macros>(config_, "macros", &Poco::Logger::get("TinyContext"));
-
-    keeper_dispatcher->updateConfiguration(config_, macros);
-}
-
-}
diff --git a/src/Coordination/TinyContext.h b/src/Coordination/TinyContext.h
deleted file mode 100644
index b966d445004..00000000000
--- a/src/Coordination/TinyContext.h
+++ /dev/null
@@ -1,36 +0,0 @@
-#pragma once
-#include <memory>
-#include <mutex>
-
-#include <Poco/Util/Application.h>
-#include <base/defines.h>
-
-namespace DB
-{
-
-class KeeperDispatcher;
-
-class TinyContext : public std::enable_shared_from_this<TinyContext>
-{
-public:
-    std::shared_ptr<KeeperDispatcher> getKeeperDispatcher() const;
-    std::shared_ptr<KeeperDispatcher> tryGetKeeperDispatcher() const;
-    void initializeKeeperDispatcher(bool start_async) const;
-    void shutdownKeeperDispatcher() const;
-    void updateKeeperConfiguration(const Poco::Util::AbstractConfiguration & config);
-
-    using ConfigurationPtr = Poco::AutoPtr<Poco::Util::AbstractConfiguration>;
-
-    void setConfig(const ConfigurationPtr & config);
-    const Poco::Util::AbstractConfiguration & getConfigRef() const;
-
-private:
-    mutable std::mutex keeper_dispatcher_mutex;
-    mutable std::shared_ptr<KeeperDispatcher> keeper_dispatcher TSA_GUARDED_BY(keeper_dispatcher_mutex);
-
-    ConfigurationPtr config TSA_GUARDED_BY(keeper_dispatcher_mutex);
-};
-
-using TinyContextPtr = std::shared_ptr<TinyContext>;
-
-}
diff --git a/src/Interpreters/Context.h b/src/Interpreters/Context.h
index b2aee8d9ec0..0ec39f18757 100644
--- a/src/Interpreters/Context.h
+++ b/src/Interpreters/Context.h
@@ -1237,6 +1237,6 @@ struct HTTPContext : public IHTTPContext
 
 #else 
 
-#include <Coordination/Context/Context.h>
+#include <Coordination/Standalone/Context.h>
 
 #endif

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 0122/1478] 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 0123/1478] 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 0124/1478] 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 0125/1478] 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 0126/1478] 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 0127/1478] 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 b82ff979d014ef63f5661f83c1cf29309fe340be Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Tue, 23 May 2023 23:10:34 +0800
Subject: [PATCH 0128/1478] Fix invalid index analysis for date related keys

---
 src/Storages/MergeTree/KeyCondition.cpp       | 35 +++++++++++++++++--
 .../02764_index_analysis_fix.reference        |  1 +
 .../0_stateless/02764_index_analysis_fix.sql  |  9 +++++
 3 files changed, 42 insertions(+), 3 deletions(-)
 create mode 100644 tests/queries/0_stateless/02764_index_analysis_fix.reference
 create mode 100644 tests/queries/0_stateless/02764_index_analysis_fix.sql

diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index b8ef2152a99..dea2091f115 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -943,6 +943,19 @@ static FieldRef applyFunction(const FunctionBasePtr & func, const DataTypePtr &
     return {field.columns, field.row_idx, result_idx};
 }
 
+static std::set<std::string_view> date_time_parsing_functions = {
+    "toDate",
+    "toDate32",
+    "toDateTime",
+    "toDateTime64",
+    "ParseDateTimeBestEffort",
+    "ParseDateTimeBestEffortUS",
+    "ParseDateTime32BestEffort",
+    "ParseDateTime64BestEffort",
+    "parseDateTime",
+    "parseDateTimeInJodaSyntax",
+};
+
 /** The key functional expression constraint may be inferred from a plain column in the expression.
   * For example, if the key contains `toStartOfHour(Timestamp)` and query contains `WHERE Timestamp >= now()`,
   * it can be assumed that if `toStartOfHour()` is monotonic on [now(), inf), the `toStartOfHour(Timestamp) >= toStartOfHour(now())`
@@ -1026,10 +1039,23 @@ bool KeyCondition::transformConstantWithValidFunctions(
                     if (func->type != ActionsDAG::ActionType::FUNCTION)
                         continue;
 
+                    const auto & func_name = func->function_base->getName();
+                    auto func_base = func->function_base;
+                    if (date_time_parsing_functions.contains(func_name))
+                    {
+                        auto func_or_null = FunctionFactory::instance().get(func_name + "OrNull", context);
+                        ColumnsWithTypeAndName arguments;
+                        int i = 0;
+                        for (const auto & type : func->function_base->getArgumentTypes())
+                            arguments.push_back({nullptr, type, fmt::format("_{}", i++)});
+
+                        func_base = func_or_null->build(arguments);
+                    }
+
                     if (func->children.size() == 1)
                     {
                         std::tie(const_value, const_type)
-                            = applyFunctionForFieldOfUnknownType(func->function_base, const_type, const_value);
+                            = applyFunctionForFieldOfUnknownType(func_base, const_type, const_value);
                     }
                     else if (func->children.size() == 2)
                     {
@@ -1040,7 +1066,7 @@ bool KeyCondition::transformConstantWithValidFunctions(
                             auto left_arg_type = left->result_type;
                             auto left_arg_value = (*left->column)[0];
                             std::tie(const_value, const_type) = applyBinaryFunctionForFieldOfUnknownType(
-                                FunctionFactory::instance().get(func->function_base->getName(), context),
+                                FunctionFactory::instance().get(func_base->getName(), context),
                                 left_arg_type, left_arg_value, const_type, const_value);
                         }
                         else
@@ -1048,10 +1074,13 @@ bool KeyCondition::transformConstantWithValidFunctions(
                             auto right_arg_type = right->result_type;
                             auto right_arg_value = (*right->column)[0];
                             std::tie(const_value, const_type) = applyBinaryFunctionForFieldOfUnknownType(
-                                FunctionFactory::instance().get(func->function_base->getName(), context),
+                                FunctionFactory::instance().get(func_base->getName(), context),
                                 const_type, const_value, right_arg_type, right_arg_value);
                         }
                     }
+
+                    if (const_value.isNull())
+                        return false;
                 }
 
                 out_key_column_num = it->second;
diff --git a/tests/queries/0_stateless/02764_index_analysis_fix.reference b/tests/queries/0_stateless/02764_index_analysis_fix.reference
new file mode 100644
index 00000000000..8eeacf99fa8
--- /dev/null
+++ b/tests/queries/0_stateless/02764_index_analysis_fix.reference
@@ -0,0 +1 @@
+2022-10-01 10:10:10
diff --git a/tests/queries/0_stateless/02764_index_analysis_fix.sql b/tests/queries/0_stateless/02764_index_analysis_fix.sql
new file mode 100644
index 00000000000..541a3444ef3
--- /dev/null
+++ b/tests/queries/0_stateless/02764_index_analysis_fix.sql
@@ -0,0 +1,9 @@
+drop table if exists x;
+
+create table x (dt String) engine MergeTree partition by toYYYYMM(toDate(dt)) order by tuple();
+
+insert into x values ('2022-10-01 10:10:10');
+
+select * from x where dt like '2022-10-01%';
+
+drop table x;

From 6de52e9fced5c71c24a2f40a2b13b9c3d5656b14 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 23 May 2023 18:36:02 +0000
Subject: [PATCH 0129/1478] Fixing some tests.

---
 src/Interpreters/InterpreterSelectQuery.cpp   |  15 ++-
 src/Interpreters/PreparedSets.cpp             |  36 ++++-
 src/Interpreters/PreparedSets.h               |  32 +----
 src/Planner/Planner.cpp                       |  15 ++-
 src/Processors/QueryPlan/CreatingSetsStep.h   |   3 +
 .../Optimizations/filterPushDown.cpp          |  13 ++
 .../QueryPlan/ReadFromMergeTree.cpp           | 107 +++++++++------
 src/Processors/QueryPlan/ReadFromMergeTree.h  |  44 +++++-
 .../MergeTree/MergeTreeDataSelectExecutor.cpp | 127 ++++++------------
 .../MergeTree/MergeTreeDataSelectExecutor.h   |   2 +-
 .../MergeTreeIndexConditionBloomFilter.cpp    |  10 ++
 .../MergeTree/MergeTreeIndexInverted.cpp      |   5 +
 src/Storages/MergeTree/RPNBuilder.cpp         |  20 ++-
 src/Storages/SelectQueryInfo.h                |   2 +
 14 files changed, 259 insertions(+), 172 deletions(-)

diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index bd96ba693fe..8d305c07ce9 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -3088,12 +3088,17 @@ void InterpreterSelectQuery::executeExtremes(QueryPlan & query_plan)
 
 void InterpreterSelectQuery::executeSubqueriesInSetsAndJoins(QueryPlan & query_plan)
 {
-    auto step = std::make_unique<DelayedCreatingSetsStep>(
-            query_plan.getCurrentDataStream(),
-            prepared_sets->detachSubqueries(context),
-            context);
+    auto subqueries = prepared_sets->detachSubqueries(context);
 
-    query_plan.addStep(std::move(step));
+    if (!subqueries.empty())
+    {
+        auto step = std::make_unique<DelayedCreatingSetsStep>(
+                query_plan.getCurrentDataStream(),
+                std::move(subqueries),
+                context);
+
+        query_plan.addStep(std::move(step));
+    }
 }
 
 
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 1d7d90432b0..cd6b2a81ba0 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -226,7 +226,7 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     if (set)
         return nullptr;
 
-    // std::cerr << StackTrace().toString() << std::endl;
+    //std::cerr << StackTrace().toString() << std::endl;
 
     auto set_cache = context->getPreparedSetsCache();
     if (set_cache)
@@ -294,4 +294,38 @@ FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquer
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
 
+SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
+{
+    const auto & settings = context->getSettingsRef();
+    auto size_limits = getSizeLimitsForSet(settings, true);
+    fill(size_limits, settings.transform_null_in, true);
+    return set;
+}
+
+std::unique_ptr<QueryPlan> FutureSetFromTuple::build(const ContextPtr & context)
+{
+    const auto & settings = context->getSettingsRef();
+    auto size_limits = getSizeLimitsForSet(settings, false);
+    fill(size_limits, settings.transform_null_in, false);
+    return nullptr;
+}
+
+void FutureSetFromTuple::buildForTuple(SizeLimits size_limits, bool transform_null_in)
+{
+    fill(size_limits, transform_null_in, false);
+}
+
+void FutureSetFromTuple::fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
+{
+    //std::cerr << StackTrace().toString() << std::endl;
+
+    if (set)
+        return;
+
+    set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
+    set->insertFromBlock(block.getColumnsWithTypeAndName());
+    set->finishInsert();
+}
+
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index b4d01754ea8..ef7aba38f24 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -86,42 +86,18 @@ public:
     bool isFilled() const override { return true; }
     SetPtr get() const override { return set; }
 
-    SetPtr buildOrderedSetInplace(const ContextPtr & context) override
-    {
-        const auto & settings = context->getSettingsRef();
-        auto size_limits = getSizeLimitsForSet(settings, true);
-        fill(size_limits, settings.transform_null_in, true);
-        return set;
-    }
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
-    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
-    {
-        const auto & settings = context->getSettingsRef();
-        auto size_limits = getSizeLimitsForSet(settings, false);
-        fill(size_limits, settings.transform_null_in, false);
-        return nullptr;
-    }
+    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override;
 
-    void buildForTuple(SizeLimits size_limits, bool transform_null_in)
-    {
-        fill(size_limits, transform_null_in, false);
-    }
+    void buildForTuple(SizeLimits size_limits, bool transform_null_in);
 
 private:
     Block block;
 
     SetPtr set;
 
-    void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
-    {
-        if (set)
-            return;
-
-        set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
-        set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
-        set->insertFromBlock(block.getColumnsWithTypeAndName());
-        set->finishInsert();
-    }
+    void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set);
 };
 
 /// Information on how to build set for the [GLOBAL] IN section.
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index 38d0aa29d24..b1780212e51 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -1468,12 +1468,17 @@ void Planner::buildPlanForQueryNode()
 
     if (!select_query_options.only_analyze)
     {
-        auto step = std::make_unique<DelayedCreatingSetsStep>(
-            query_plan.getCurrentDataStream(),
-            planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()),
-            planner_context->getQueryContext());
+        auto subqueries = planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext());
 
-        query_plan.addStep(std::move(step));
+        if (!subqueries.empty())
+        {
+            auto step = std::make_unique<DelayedCreatingSetsStep>(
+                query_plan.getCurrentDataStream(),
+                std::move(subqueries),
+                planner_context->getQueryContext());
+
+            query_plan.addStep(std::move(step));
+        }
 
         //addCreatingSetsStep(query_plan, planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()), planner_context->getQueryContext());
         //addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index 96ab26077fc..244bb27ba78 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -58,6 +58,9 @@ public:
 
     static std::vector<std::unique_ptr<QueryPlan>> makePlansForSets(DelayedCreatingSetsStep && step);
 
+    ContextPtr getContext() const { return context; }
+    PreparedSets::SubqueriesForSets detachSubqueries() { return std::move(subqueries_for_sets); }
+
 private:
     PreparedSets::SubqueriesForSets subqueries_for_sets;
     ContextPtr context;
diff --git a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
index 37bc894339f..63ba3d5b56c 100644
--- a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
+++ b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
@@ -268,6 +268,19 @@ size_t tryPushDownFilter(QueryPlan::Node * parent_node, QueryPlan::Nodes & nodes
         return 2;
     }
 
+    if (auto * delayed = typeid_cast<DelayedCreatingSetsStep *>(child.get()))
+    {
+        /// CreatingSets does not change header.
+        /// We can push down filter and update header.
+        /// Filter - DelayedCreatingSets - Something
+        child = std::make_unique<DelayedCreatingSetsStep>(filter->getOutputStream(), delayed->detachSubqueries(), delayed->getContext());
+        std::swap(parent, child);
+        std::swap(parent_node->children, child_node->children);
+        std::swap(parent_node->children.front(), child_node->children.front());
+        /// DelayedCreatingSets - Filter - Something
+        return 2;
+    }
+
     if (auto * totals_having = typeid_cast<TotalsHavingStep *>(child.get()))
     {
         /// If totals step has HAVING expression, skip it for now.
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index ef013a36069..a096538a298 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1127,7 +1127,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(Merge
         real_column_names,
         sample_factor_column_queried,
         log,
-        key_condition);
+        indexes);
 }
 
 static ActionsDAGPtr buildFilterDAG(
@@ -1171,14 +1171,14 @@ static ActionsDAGPtr buildFilterDAG(
     return ActionsDAG::buildFilterActionsDAG(nodes, node_name_to_input_node_column, context);
 }
 
-static void buildKeyCondition(
-    std::optional<KeyCondition> & key_condition,
+static void buildIndexes(
+    std::optional<ReadFromMergeTree::Indexes> & indexes,
     ActionsDAGPtr filter_actions_dag,
     const ContextPtr & context,
     const SelectQueryInfo & query_info,
     const StorageMetadataPtr & metadata_snapshot)
 {
-    key_condition.reset();
+    indexes.reset();
 
     // Build and check if primary key is used when necessary
     const auto & primary_key = metadata_snapshot->getPrimaryKey();
@@ -1191,16 +1191,58 @@ static void buildKeyCondition(
         if (query_info.syntax_analyzer_result)
             array_join_name_set = query_info.syntax_analyzer_result->getArrayJoinSourceNameSet();
 
-        key_condition.emplace(filter_actions_dag,
+        indexes.emplace(ReadFromMergeTree::Indexes{{
+            filter_actions_dag,
             context,
             primary_key_column_names,
             primary_key.expression,
-            array_join_name_set);
+            array_join_name_set}, {}, false});
     }
     else
     {
-        key_condition.emplace(query_info, context, primary_key_column_names, primary_key.expression);
+        indexes.emplace(ReadFromMergeTree::Indexes{{
+            query_info,
+            context,
+            primary_key_column_names,
+            primary_key.expression}, {}, false});
     }
+
+    indexes->use_skip_indexes = settings.use_skip_indexes;
+    bool final = query_info.isFinal();
+
+    if (final && !settings.use_skip_indexes_if_final)
+        indexes->use_skip_indexes = false;
+
+    if (!indexes->use_skip_indexes)
+        return;
+
+    UsefulSkipIndexes skip_indexes;
+    using Key = std::pair<String, size_t>;
+    std::map<Key, size_t> merged;
+
+    for (const auto & index : metadata_snapshot->getSecondaryIndices())
+    {
+        auto index_helper = MergeTreeIndexFactory::instance().get(index);
+        if (index_helper->isMergeable())
+        {
+            auto [it, inserted] = merged.emplace(Key{index_helper->index.type, index_helper->getGranularity()}, skip_indexes.merged_indices.size());
+            if (inserted)
+            {
+                skip_indexes.merged_indices.emplace_back();
+                skip_indexes.merged_indices.back().condition = index_helper->createIndexMergedCondition(query_info, metadata_snapshot);
+            }
+
+            skip_indexes.merged_indices[it->second].addIndex(index_helper);
+        }
+        else
+        {
+            auto condition = index_helper->createIndexCondition(query_info, context);
+            if (!condition->alwaysUnknownOrTrue())
+                skip_indexes.useful_indices.emplace_back(index_helper, condition);
+        }
+    }
+
+    indexes->skip_indexes = std::move(skip_indexes);
 }
 
 void ReadFromMergeTree::onAddFilterFinish()
@@ -1208,7 +1250,7 @@ void ReadFromMergeTree::onAddFilterFinish()
     if (!filter_nodes.nodes.empty())
     {
         auto filter_actions_dag = buildFilterDAG(context, prewhere_info, filter_nodes, query_info);
-        buildKeyCondition(key_condition, filter_actions_dag, context, query_info, metadata_for_reading);
+        buildIndexes(indexes, filter_actions_dag, context, query_info, metadata_for_reading);
     }
 }
 
@@ -1226,7 +1268,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
     const Names & real_column_names,
     bool sample_factor_column_queried,
     Poco::Logger * log,
-    std::optional<KeyCondition> & key_condition)
+    std::optional<Indexes> & indexes)
 {
     const auto & settings = context->getSettingsRef();
     if (settings.allow_experimental_analyzer || settings.query_plan_optimize_primary_key)
@@ -1246,7 +1288,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
             real_column_names,
             sample_factor_column_queried,
             log,
-            key_condition);
+            indexes);
     }
 
     return selectRangesToReadImpl(
@@ -1261,7 +1303,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
         real_column_names,
         sample_factor_column_queried,
         log,
-        key_condition);
+        indexes);
 }
 
 MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
@@ -1276,7 +1318,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     const Names & real_column_names,
     bool sample_factor_column_queried,
     Poco::Logger * log,
-    std::optional<KeyCondition> & key_condition)
+    std::optional<Indexes> & indexes)
 {
     AnalysisResult result;
     const auto & settings = context->getSettingsRef();
@@ -1323,10 +1365,10 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     //     }
     // }
 
-    if (!key_condition)
-        buildKeyCondition(key_condition, query_info.filter_actions_dag, context, query_info, metadata_snapshot);
+    if (!indexes)
+        buildIndexes(indexes, query_info.filter_actions_dag, context, query_info, metadata_snapshot);
 
-    if (settings.force_primary_key && key_condition->alwaysUnknownOrTrue())
+    if (settings.force_primary_key && indexes->key_condition.alwaysUnknownOrTrue())
     {
         return std::make_shared<MergeTreeDataSelectAnalysisResult>(MergeTreeDataSelectAnalysisResult{
             .result = std::make_exception_ptr(Exception(
@@ -1334,9 +1376,9 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
                 "Primary key ({}) is not used and setting 'force_primary_key' is set",
                 fmt::join(primary_key_column_names, ", ")))});
     }
-    LOG_DEBUG(log, "Key condition: {}", key_condition->toString());
+    LOG_DEBUG(log, "Key condition: {}", indexes->key_condition.toString());
 
-    if (key_condition->alwaysFalse())
+    if (indexes->key_condition.alwaysFalse())
         return std::make_shared<MergeTreeDataSelectAnalysisResult>(MergeTreeDataSelectAnalysisResult{.result = std::move(result)});
 
     size_t total_marks_pk = 0;
@@ -1358,7 +1400,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
             query_info,
             metadata_snapshot->getColumns().getAllPhysical(),
             parts,
-            *key_condition,
+            indexes->key_condition,
             data,
             metadata_snapshot,
             context,
@@ -1374,23 +1416,17 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
 
         auto reader_settings = getMergeTreeReaderSettings(context, query_info);
 
-        bool use_skip_indexes = settings.use_skip_indexes;
-        bool final = isFinal(query_info);
-
-        if (final && !settings.use_skip_indexes_if_final)
-            use_skip_indexes = false;
-
         result.parts_with_ranges = MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipIndexes(
             std::move(parts),
             metadata_snapshot,
-            query_info,
             context,
-            *key_condition,
+            indexes->key_condition,
+            indexes->skip_indexes,
             reader_settings,
             log,
             num_streams,
             result.index_stats,
-            use_skip_indexes);
+            indexes->use_skip_indexes);
     }
     catch (...)
     {
@@ -1438,7 +1474,7 @@ bool ReadFromMergeTree::requestReadingInOrder(size_t prefix_size, int direction,
 
     /// Disable read-in-order optimization for reverse order with final.
     /// Otherwise, it can lead to incorrect final behavior because the implementation may rely on the reading in direct order).
-    if (direction != 1 && isFinal(query_info))
+    if (direction != 1 && query_info.isFinal())
         return false;
 
     auto order_info = std::make_shared<InputOrderInfo>(SortDescription{}, prefix_size, direction, limit);
@@ -1561,11 +1597,7 @@ ReadFromMergeTree::AnalysisResult ReadFromMergeTree::getAnalysisResult() const
 
 bool ReadFromMergeTree::isQueryWithFinal() const
 {
-    const auto & select = query_info.query->as<ASTSelectQuery &>();
-    if (query_info.table_expression_modifiers)
-        return query_info.table_expression_modifiers->hasFinal();
-    else
-        return select.final();
+    return query_info.isFinal();
 }
 
 bool ReadFromMergeTree::isQueryWithSampling() const
@@ -2009,15 +2041,6 @@ void ReadFromMergeTree::describeIndexes(JSONBuilder::JSONMap & map) const
     }
 }
 
-bool ReadFromMergeTree::isFinal(const SelectQueryInfo & query_info)
-{
-    if (query_info.table_expression_modifiers)
-        return query_info.table_expression_modifiers->hasFinal();
-
-    const auto & select = query_info.query->as<ASTSelectQuery &>();
-    return select.final();
-}
-
 bool MergeTreeDataSelectAnalysisResult::error() const
 {
     return std::holds_alternative<std::exception_ptr>(result);
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index f13f75bfebc..6610b463726 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -24,6 +24,35 @@ struct MergeTreeDataSelectSamplingData
     ActionsDAGPtr filter_expression;
 };
 
+struct UsefulSkipIndexes
+{
+    struct DataSkippingIndexAndCondition
+    {
+        MergeTreeIndexPtr index;
+        MergeTreeIndexConditionPtr condition;
+
+        DataSkippingIndexAndCondition(MergeTreeIndexPtr index_, MergeTreeIndexConditionPtr condition_)
+            : index(index_), condition(condition_)
+        {
+        }
+    };
+
+    struct MergedDataSkippingIndexAndCondition
+    {
+        std::vector<MergeTreeIndexPtr> indices;
+        MergeTreeIndexMergedConditionPtr condition;
+
+        void addIndex(const MergeTreeIndexPtr & index)
+        {
+            indices.push_back(index);
+            condition->addIndex(indices.back());
+        }
+    };
+
+    std::vector<DataSkippingIndexAndCondition> useful_indices;
+    std::vector<MergedDataSkippingIndexAndCondition> merged_indices;
+};
+
 struct MergeTreeDataSelectAnalysisResult;
 using MergeTreeDataSelectAnalysisResultPtr = std::shared_ptr<MergeTreeDataSelectAnalysisResult>;
 
@@ -132,6 +161,13 @@ public:
     UInt64 getSelectedRows() const { return selected_rows; }
     UInt64 getSelectedMarks() const { return selected_marks; }
 
+    struct Indexes
+    {
+        KeyCondition key_condition;
+        UsefulSkipIndexes skip_indexes;
+        bool use_skip_indexes;
+    };
+
     static MergeTreeDataSelectAnalysisResultPtr selectRangesToRead(
         MergeTreeData::DataPartsVector parts,
         const PrewhereInfoPtr & prewhere_info,
@@ -146,7 +182,7 @@ public:
         const Names & real_column_names,
         bool sample_factor_column_queried,
         Poco::Logger * log,
-        std::optional<KeyCondition> & key_condition);
+        std::optional<Indexes> & indexes);
 
     MergeTreeDataSelectAnalysisResultPtr selectRangesToRead(MergeTreeData::DataPartsVector parts) const;
 
@@ -159,8 +195,6 @@ public:
     bool requestReadingInOrder(size_t prefix_size, int direction, size_t limit);
 
     void updatePrewhereInfo(const PrewhereInfoPtr & prewhere_info_value);
-
-    static bool isFinal(const SelectQueryInfo & query_info);
     bool isQueryWithFinal() const;
     bool isQueryWithSampling() const;
 
@@ -193,7 +227,7 @@ private:
         const Names & real_column_names,
         bool sample_factor_column_queried,
         Poco::Logger * log,
-        std::optional<KeyCondition> & key_condition);
+        std::optional<Indexes> & indexes);
 
     int getSortDirection() const
     {
@@ -233,7 +267,7 @@ private:
     std::shared_ptr<PartitionIdToMaxBlock> max_block_numbers_to_read;
 
     /// Pre-computed value, needed to trigger sets creating for PK
-    mutable std::optional<KeyCondition> key_condition;
+    mutable std::optional<Indexes> indexes;
 
     Poco::Logger * log;
     UInt64 selected_parts = 0;
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 55dfc56d8ac..f99e15c0fc1 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -887,9 +887,9 @@ void MergeTreeDataSelectExecutor::filterPartsByPartition(
 RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipIndexes(
     MergeTreeData::DataPartsVector && parts,
     StorageMetadataPtr metadata_snapshot,
-    const SelectQueryInfo & query_info,
     const ContextPtr & context,
     const KeyCondition & key_condition,
+    const UsefulSkipIndexes & skip_indexes,
     const MergeTreeReaderSettings & reader_settings,
     Poco::Logger * log,
     size_t num_streams,
@@ -900,66 +900,6 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
     parts_with_ranges.resize(parts.size());
     const Settings & settings = context->getSettingsRef();
 
-    /// Let's start analyzing all useful indices
-
-    struct IndexStat
-    {
-        std::atomic<size_t> total_granules{0};
-        std::atomic<size_t> granules_dropped{0};
-        std::atomic<size_t> total_parts{0};
-        std::atomic<size_t> parts_dropped{0};
-    };
-
-    struct DataSkippingIndexAndCondition
-    {
-        MergeTreeIndexPtr index;
-        MergeTreeIndexConditionPtr condition;
-        IndexStat stat;
-
-        DataSkippingIndexAndCondition(MergeTreeIndexPtr index_, MergeTreeIndexConditionPtr condition_)
-            : index(index_), condition(condition_)
-        {
-        }
-    };
-
-    struct MergedDataSkippingIndexAndCondition
-    {
-        std::vector<MergeTreeIndexPtr> indices;
-        MergeTreeIndexMergedConditionPtr condition;
-        IndexStat stat;
-
-        void addIndex(const MergeTreeIndexPtr & index)
-        {
-            indices.push_back(index);
-            condition->addIndex(indices.back());
-        }
-    };
-
-    std::list<DataSkippingIndexAndCondition> useful_indices;
-    std::map<std::pair<String, size_t>, MergedDataSkippingIndexAndCondition> merged_indices;
-
-    if (use_skip_indexes)
-    {
-        for (const auto & index : metadata_snapshot->getSecondaryIndices())
-        {
-            auto index_helper = MergeTreeIndexFactory::instance().get(index);
-            if (index_helper->isMergeable())
-            {
-                auto [it, inserted] = merged_indices.try_emplace({index_helper->index.type, index_helper->getGranularity()});
-                if (inserted)
-                    it->second.condition = index_helper->createIndexMergedCondition(query_info, metadata_snapshot);
-
-                it->second.addIndex(index_helper);
-            }
-            else
-            {
-                auto condition = index_helper->createIndexCondition(query_info, context);
-                if (!condition->alwaysUnknownOrTrue())
-                    useful_indices.emplace_back(index_helper, condition);
-            }
-        }
-    }
-
     if (use_skip_indexes && settings.force_data_skipping_indices.changed)
     {
         const auto & indices = settings.force_data_skipping_indices.toString();
@@ -977,7 +917,7 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
             throw Exception(ErrorCodes::CANNOT_PARSE_TEXT, "No indices parsed from force_data_skipping_indices ('{}')", indices);
 
         std::unordered_set<std::string> useful_indices_names;
-        for (const auto & useful_index : useful_indices)
+        for (const auto & useful_index : skip_indexes.useful_indices)
             useful_indices_names.insert(useful_index.index->index.name);
 
         for (const auto & index_name : forced_indices)
@@ -992,6 +932,17 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
         }
     }
 
+    struct IndexStat
+    {
+        std::atomic<size_t> total_granules{0};
+        std::atomic<size_t> granules_dropped{0};
+        std::atomic<size_t> total_parts{0};
+        std::atomic<size_t> parts_dropped{0};
+    };
+
+    std::vector<IndexStat> useful_indices_stat(skip_indexes.useful_indices.size());
+    std::vector<IndexStat> merged_indices_stat(skip_indexes.merged_indices.size());
+
     std::atomic<size_t> sum_marks_pk = 0;
     std::atomic<size_t> sum_parts_pk = 0;
 
@@ -1018,12 +969,14 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
             if (!ranges.ranges.empty())
                 sum_parts_pk.fetch_add(1, std::memory_order_relaxed);
 
-            for (auto & index_and_condition : useful_indices)
+            for (size_t idx = 0; idx < skip_indexes.useful_indices.size(); ++idx)
             {
                 if (ranges.ranges.empty())
                     break;
 
-                index_and_condition.stat.total_parts.fetch_add(1, std::memory_order_relaxed);
+                auto & index_and_condition = skip_indexes.useful_indices[idx];
+                auto & stat = useful_indices_stat[idx];
+                stat.total_parts.fetch_add(1, std::memory_order_relaxed);
 
                 size_t total_granules = 0;
                 size_t granules_dropped = 0;
@@ -1040,19 +993,21 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
                     uncompressed_cache.get(),
                     log);
 
-                index_and_condition.stat.total_granules.fetch_add(total_granules, std::memory_order_relaxed);
-                index_and_condition.stat.granules_dropped.fetch_add(granules_dropped, std::memory_order_relaxed);
+                stat.total_granules.fetch_add(total_granules, std::memory_order_relaxed);
+                stat.granules_dropped.fetch_add(granules_dropped, std::memory_order_relaxed);
 
                 if (ranges.ranges.empty())
-                    index_and_condition.stat.parts_dropped.fetch_add(1, std::memory_order_relaxed);
+                    stat.parts_dropped.fetch_add(1, std::memory_order_relaxed);
             }
 
-            for (auto & [_, indices_and_condition] : merged_indices)
+            for (size_t idx = 0; idx < skip_indexes.merged_indices.size(); ++idx)
             {
                 if (ranges.ranges.empty())
                     break;
 
-                indices_and_condition.stat.total_parts.fetch_add(1, std::memory_order_relaxed);
+                auto & indices_and_condition = skip_indexes.merged_indices[idx];
+                auto & stat = merged_indices_stat[idx];
+                stat.total_parts.fetch_add(1, std::memory_order_relaxed);
 
                 size_t total_granules = 0;
                 size_t granules_dropped = 0;
@@ -1063,11 +1018,11 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
                     total_granules, granules_dropped,
                     mark_cache.get(), uncompressed_cache.get(), log);
 
-                indices_and_condition.stat.total_granules.fetch_add(total_granules, std::memory_order_relaxed);
-                indices_and_condition.stat.granules_dropped.fetch_add(granules_dropped, std::memory_order_relaxed);
+                stat.total_granules.fetch_add(total_granules, std::memory_order_relaxed);
+                stat.granules_dropped.fetch_add(granules_dropped, std::memory_order_relaxed);
 
                 if (ranges.ranges.empty())
-                    indices_and_condition.stat.parts_dropped.fetch_add(1, std::memory_order_relaxed);
+                    stat.parts_dropped.fetch_add(1, std::memory_order_relaxed);
             }
 
             if (!ranges.ranges.empty())
@@ -1134,15 +1089,17 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
             .num_granules_after = sum_marks_pk.load(std::memory_order_relaxed)});
     }
 
-    for (const auto & index_and_condition : useful_indices)
+    for (size_t idx = 0; idx < skip_indexes.useful_indices.size(); ++idx)
     {
+        const auto & index_and_condition = skip_indexes.useful_indices[idx];
+        const auto & stat = useful_indices_stat[idx];
         const auto & index_name = index_and_condition.index->index.name;
         LOG_DEBUG(
             log,
             "Index {} has dropped {}/{} granules.",
             backQuote(index_name),
-            index_and_condition.stat.granules_dropped,
-            index_and_condition.stat.total_granules);
+            stat.granules_dropped,
+            stat.total_granules);
 
         std::string description
             = index_and_condition.index->index.type + " GRANULARITY " + std::to_string(index_and_condition.index->index.granularity);
@@ -1151,25 +1108,27 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
             .type = ReadFromMergeTree::IndexType::Skip,
             .name = index_name,
             .description = std::move(description),
-            .num_parts_after = index_and_condition.stat.total_parts - index_and_condition.stat.parts_dropped,
-            .num_granules_after = index_and_condition.stat.total_granules - index_and_condition.stat.granules_dropped});
+            .num_parts_after = stat.total_parts - stat.parts_dropped,
+            .num_granules_after = stat.total_granules - stat.granules_dropped});
     }
 
-    for (const auto & [type_with_granularity, index_and_condition] : merged_indices)
+    for (size_t idx = 0; idx < skip_indexes.merged_indices.size(); ++idx)
     {
+        const auto & index_and_condition = skip_indexes.merged_indices[idx];
+        const auto & stat = merged_indices_stat[idx];
         const auto & index_name = "Merged";
         LOG_DEBUG(log, "Index {} has dropped {}/{} granules.",
                     backQuote(index_name),
-                    index_and_condition.stat.granules_dropped, index_and_condition.stat.total_granules);
+                    stat.granules_dropped, stat.total_granules);
 
-        std::string description = "MERGED GRANULARITY " + std::to_string(type_with_granularity.second);
+        std::string description = "MERGED GRANULARITY " + std::to_string(index_and_condition.indices.at(0)->index.granularity);
 
         index_stats.emplace_back(ReadFromMergeTree::IndexStat{
             .type = ReadFromMergeTree::IndexType::Skip,
             .name = index_name,
             .description = std::move(description),
-            .num_parts_after = index_and_condition.stat.total_parts - index_and_condition.stat.parts_dropped,
-            .num_granules_after = index_and_condition.stat.total_granules - index_and_condition.stat.granules_dropped});
+            .num_parts_after = stat.total_parts - stat.parts_dropped,
+            .num_granules_after = stat.total_granules - stat.granules_dropped});
     }
 
     return parts_with_ranges;
@@ -1291,7 +1250,7 @@ MergeTreeDataSelectAnalysisResultPtr MergeTreeDataSelectExecutor::estimateNumMar
 
     selectColumnNames(column_names_to_return, data, real_column_names, virt_column_names, sample_factor_column_queried);
 
-    std::optional<KeyCondition> key_condition;
+    std::optional<ReadFromMergeTree::Indexes> indexes;
     return ReadFromMergeTree::selectRangesToRead(
         std::move(parts),
         prewhere_info,
@@ -1306,7 +1265,7 @@ MergeTreeDataSelectAnalysisResultPtr MergeTreeDataSelectExecutor::estimateNumMar
         real_column_names,
         sample_factor_column_queried,
         log,
-        key_condition);
+        indexes);
 }
 
 QueryPlanStepPtr MergeTreeDataSelectExecutor::readFromParts(
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
index a337574bb64..8c8ce59bebe 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
@@ -189,9 +189,9 @@ public:
     static RangesInDataParts filterPartsByPrimaryKeyAndSkipIndexes(
         MergeTreeData::DataPartsVector && parts,
         StorageMetadataPtr metadata_snapshot,
-        const SelectQueryInfo & query_info,
         const ContextPtr & context,
         const KeyCondition & key_condition,
+        const UsefulSkipIndexes & skip_indexes,
         const MergeTreeReaderSettings & reader_settings,
         Poco::Logger * log,
         size_t num_streams,
diff --git a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
index 5e186c25b83..2bd9db12b93 100644
--- a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
@@ -310,14 +310,24 @@ bool MergeTreeIndexConditionBloomFilter::traverseFunction(const RPNBuilderTreeNo
 
         if (functionIsInOrGlobalInOperator(function_name))
         {
+            //std::cerr << StackTrace().toString() << std::endl;
+
             auto future_set = rhs_argument.tryGetPreparedSet();
+
+            //std::cerr << "==== Finding set for MergeTreeBF " << bool(future_set) << std::endl;
+
             if (future_set && !future_set->isReady())
+            {
+                //std::cerr << "==== not ready, building " << std::endl;
                 future_set->buildOrderedSetInplace(rhs_argument.getTreeContext().getQueryContext());
+            }
 
             ConstSetPtr prepared_set;
             if (future_set)
                 prepared_set = future_set->get();
 
+            //std::cerr << "==== Prep set for MergeTreeBF " << bool(prepared_set) << ' ' << (prepared_set ? prepared_set->hasExplicitSetElements() : false) << std::endl;
+
             if (prepared_set && prepared_set->hasExplicitSetElements())
             {
                 const auto prepared_info = getPreparedSetInfo(prepared_set);
diff --git a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
index 6ffba0ad029..a64f81807ae 100644
--- a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
@@ -655,7 +655,12 @@ bool MergeTreeConditionInverted::tryPrepareSetGinFilter(
     if (key_tuple_mapping.empty())
         return false;
 
+    //std::cerr << "==== Finding set for MergeTreeConditionInverted\n";
+
     auto future_set = rhs.tryGetPreparedSet();
+
+    //std::cerr << "==== Set for MergeTreeConditionInverted" << bool(future_set) << std::endl;
+
     if (future_set && !future_set->isReady())
         future_set->buildOrderedSetInplace(rhs.getTreeContext().getQueryContext());
 
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index e8843ff1489..cc7ec45be6a 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -298,11 +298,29 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
 
     if (ast_node && prepared_sets)
     {
-        return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
+        auto hash = ast_node->getTreeHash();
+        auto key = PreparedSetKey::forSubquery(hash);
+
+        // std::cerr << ".........Getting from AST \n" << ast_node->dumpTree() << std::endl
+        //   << key.toString() << std::endl;
+
+        for (const auto & [k, v] : prepared_sets->getSets())
+        {
+            // std::cerr << "........... " << k.toString() << std::endl;
+            if (k.ast_hash == hash)
+                return v;
+        }
+
+        //return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
     }
     else if (dag_node)
     {
+
+        // std::cerr << "...........Getting from DAG\n";
         const auto * node_without_alias = getNodeWithoutAlias(dag_node);
+        // std::cerr << ".......... node_without_alias : " << node_without_alias->result_name
+        //   << ' ' << node_without_alias->result_type->getName()
+        //   << ' ' << (node_without_alias->column ? node_without_alias->column->getName() : "") << std::endl;
         return tryGetSetFromDAGNode(node_without_alias);
     }
 
diff --git a/src/Storages/SelectQueryInfo.h b/src/Storages/SelectQueryInfo.h
index fb895d04b8f..a8eb00adc87 100644
--- a/src/Storages/SelectQueryInfo.h
+++ b/src/Storages/SelectQueryInfo.h
@@ -264,5 +264,7 @@ struct SelectQueryInfo
     {
         return input_order_info ? input_order_info : (projection ? projection->input_order_info : nullptr);
     }
+
+    bool isFinal() const;
 };
 }

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 0130/1478] 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 9db7e8ed62415aac040ee5d220d6dabc749ccc7b Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 23 May 2023 20:47:35 +0000
Subject: [PATCH 0131/1478] Fixing build.

---
 src/Storages/SelectQueryInfo.cpp | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 src/Storages/SelectQueryInfo.cpp

diff --git a/src/Storages/SelectQueryInfo.cpp b/src/Storages/SelectQueryInfo.cpp
new file mode 100644
index 00000000000..665da7fee70
--- /dev/null
+++ b/src/Storages/SelectQueryInfo.cpp
@@ -0,0 +1,16 @@
+#include <Storages/SelectQueryInfo.h>
+#include <Parsers/ASTSelectQuery.h>
+
+namespace DB
+{
+
+bool SelectQueryInfo::isFinal() const
+{
+    if (table_expression_modifiers)
+        return table_expression_modifiers->hasFinal();
+
+    const auto & select = query->as<ASTSelectQuery &>();
+    return select.final();
+}
+
+}

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 0132/1478] 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 b11aa42db9337ea652f8a0b36c9e3f21e9f675af Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Wed, 24 May 2023 14:27:49 +0800
Subject: [PATCH 0133/1478] Fix tests

---
 src/Storages/MergeTree/KeyCondition.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index dea2091f115..923e5237420 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1041,7 +1041,8 @@ bool KeyCondition::transformConstantWithValidFunctions(
 
                     const auto & func_name = func->function_base->getName();
                     auto func_base = func->function_base;
-                    if (date_time_parsing_functions.contains(func_name))
+                    const auto & arg_types = func_base->getArgumentTypes();
+                    if (date_time_parsing_functions.contains(func_name) && !arg_types.empty() && isStringOrFixedString(arg_types[0]))
                     {
                         auto func_or_null = FunctionFactory::instance().get(func_name + "OrNull", context);
                         ColumnsWithTypeAndName arguments;

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 0134/1478] 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 161afea266bc8f3a13dacfb99f7333ab98f2ac46 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 24 May 2023 07:36:39 +0000
Subject: [PATCH 0135/1478] Add support for changelog

---
 programs/keeper/Keeper.cpp                    |   2 -
 src/Coordination/Changelog.cpp                | 324 +++++++++++-------
 src/Coordination/Changelog.h                  |   4 +-
 src/Coordination/KeeperContext.cpp            |  12 +-
 src/Coordination/KeeperContext.h              |   2 +
 src/Coordination/KeeperSnapshotManager.cpp    |  47 ++-
 src/Coordination/KeeperStateManager.cpp       |   3 +-
 src/Coordination/Standalone/Context.cpp       |   4 +
 src/Core/SettingsFields.cpp                   |   5 +
 .../MetadataStorageFromPlainObjectStorage.cpp |   1 +
 .../MetadataStorageFromPlainObjectStorage.h   |   2 +-
 src/IO/ZstdDeflatingAppendableWriteBuffer.cpp |  11 +-
 src/IO/ZstdDeflatingAppendableWriteBuffer.h   |   3 +
 src/Interpreters/Context.h                    |   2 +-
 14 files changed, 277 insertions(+), 145 deletions(-)

diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index d5cf61daa6e..002ce413095 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -44,8 +44,6 @@
 
 #include <Disks/registerDisks.h>
 
-#include <filesystem>
-
 
 int mainEntryClickHouseKeeper(int argc, char ** argv)
 {
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index 852a21c1c45..c94633d6dbd 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -3,17 +3,17 @@
 #include <Disks/DiskLocal.h>
 #include <IO/ReadBufferFromFile.h>
 #include <IO/ReadHelpers.h>
+#include <IO/WriteBufferFromFile.h>
 #include <IO/WriteHelpers.h>
 #include <IO/ZstdDeflatingAppendableWriteBuffer.h>
+#include <base/errnoToString.h>
 #include <boost/algorithm/string/join.hpp>
 #include <boost/algorithm/string/split.hpp>
 #include <boost/algorithm/string/trim.hpp>
-#include <Common/filesystemHelpers.h>
 #include <Common/Exception.h>
 #include <Common/SipHash.h>
+#include <Common/filesystemHelpers.h>
 #include <Common/logger_useful.h>
-#include <IO/WriteBufferFromFile.h>
-#include <base/errnoToString.h>
 
 
 namespace DB
@@ -29,50 +29,58 @@ namespace ErrorCodes
 
 namespace
 {
+    void moveFileBetweenDisks(DiskPtr disk_from, ChangelogFileDescriptionPtr description, DiskPtr disk_to, const std::string & path_to)
+    {
+        disk_from->copyFile(description->path, *disk_to, path_to, {});
+        disk_from->removeFile(description->path);
+        description->path = path_to;
+        description->disk = disk_to;
+    }
 
-constexpr auto DEFAULT_PREFIX = "changelog";
+    constexpr auto DEFAULT_PREFIX = "changelog";
 
-inline std::string formatChangelogPath(const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
-{
-    return fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension);
-}
+    inline std::string
+    formatChangelogPath(const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
+    {
+        return fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension);
+    }
 
-ChangelogFileDescriptionPtr getChangelogFileDescription(const std::filesystem::path & path)
-{
-    // we can have .bin.zstd so we cannot use std::filesystem stem and extension
-    std::string filename_with_extension = path.filename();
-    std::string_view filename_with_extension_view = filename_with_extension;
+    ChangelogFileDescriptionPtr getChangelogFileDescription(const std::filesystem::path & path)
+    {
+        // we can have .bin.zstd so we cannot use std::filesystem stem and extension
+        std::string filename_with_extension = path.filename();
+        std::string_view filename_with_extension_view = filename_with_extension;
 
-    auto first_dot = filename_with_extension.find('.');
-    if (first_dot == std::string::npos)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid changelog file {}", path.generic_string());
+        auto first_dot = filename_with_extension.find('.');
+        if (first_dot == std::string::npos)
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid changelog file {}", path.generic_string());
 
-    Strings filename_parts;
-    boost::split(filename_parts, filename_with_extension_view.substr(0, first_dot), boost::is_any_of("_"));
-    if (filename_parts.size() < 3)
-        throw Exception(ErrorCodes::CORRUPTED_DATA, "Invalid changelog {}", path.generic_string());
+        Strings filename_parts;
+        boost::split(filename_parts, filename_with_extension_view.substr(0, first_dot), boost::is_any_of("_"));
+        if (filename_parts.size() < 3)
+            throw Exception(ErrorCodes::CORRUPTED_DATA, "Invalid changelog {}", path.generic_string());
 
-    auto result = std::make_shared<ChangelogFileDescription>();
-    result->prefix = filename_parts[0];
-    result->from_log_index = parse<uint64_t>(filename_parts[1]);
-    result->to_log_index = parse<uint64_t>(filename_parts[2]);
-    result->extension = std::string(filename_with_extension.substr(first_dot + 1));
-    result->path = path.generic_string();
-    return result;
-}
+        auto result = std::make_shared<ChangelogFileDescription>();
+        result->prefix = filename_parts[0];
+        result->from_log_index = parse<uint64_t>(filename_parts[1]);
+        result->to_log_index = parse<uint64_t>(filename_parts[2]);
+        result->extension = std::string(filename_with_extension.substr(first_dot + 1));
+        result->path = path.generic_string();
+        return result;
+    }
 
-Checksum computeRecordChecksum(const ChangelogRecord & record)
-{
-    SipHash hash;
-    hash.update(record.header.version);
-    hash.update(record.header.index);
-    hash.update(record.header.term);
-    hash.update(record.header.value_type);
-    hash.update(record.header.blob_size);
-    if (record.header.blob_size != 0)
-        hash.update(reinterpret_cast<char *>(record.blob->data_begin()), record.blob->size());
-    return hash.get64();
-}
+    Checksum computeRecordChecksum(const ChangelogRecord & record)
+    {
+        SipHash hash;
+        hash.update(record.header.version);
+        hash.update(record.header.index);
+        hash.update(record.header.term);
+        hash.update(record.header.value_type);
+        hash.update(record.header.blob_size);
+        if (record.header.blob_size != 0)
+            hash.update(reinterpret_cast<char *>(record.blob->data_begin()), record.blob->size());
+        return hash.get64();
+    }
 
 }
 
@@ -117,25 +125,55 @@ public:
                 // if we wrote at least 1 log in the log file we can rename the file to reflect correctly the
                 // contained logs
                 // file can be deleted from disk earlier by compaction
-                if (!current_file_description->deleted && last_index_written
-                    && *last_index_written != current_file_description->to_log_index)
+                if (!current_file_description->deleted)
                 {
-                    auto new_path = formatChangelogPath(
-                        current_file_description->prefix,
-                        current_file_description->from_log_index,
-                        *last_index_written,
-                        current_file_description->extension);
-                    disk->moveFile(current_file_description->path, new_path);
-                    current_file_description->path = std::move(new_path);
+                    auto log_disk = current_file_description->disk;
+                    const auto & path = current_file_description->path;
+                    std::string new_path = path;
+                    if (last_index_written && *last_index_written != current_file_description->to_log_index)
+                    {
+                        new_path = formatChangelogPath(
+                            current_file_description->prefix,
+                            current_file_description->from_log_index,
+                            *last_index_written,
+                            current_file_description->extension);
+                    }
+
+                    if (disk == log_disk)
+                    {
+                        if (path != new_path)
+                        {
+                            try
+                            {
+                                disk->moveFile(path, new_path);
+                            }
+                            catch (...)
+                            {
+                                tryLogCurrentException(log, fmt::format("File rename failed on disk {}", disk->getName()));
+                            }
+                            current_file_description->path = std::move(new_path);
+                        }
+                    }
+                    else
+                    {
+                        moveFileBetweenDisks(log_disk, current_file_description, disk, new_path);
+                    }
                 }
             }
 
-            file_buf = disk->writeFile(file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode);
+            auto current_log_disk = getCurrentLogDisk();
+            assert(file_description->disk == current_log_disk);
+            file_buf = current_log_disk->writeFile(file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode);
+            assert(file_buf);
             last_index_written.reset();
             current_file_description = std::move(file_description);
 
             if (log_file_settings.compress_logs)
-                compressed_buffer = std::make_unique<ZstdDeflatingAppendableWriteBuffer>(std::move(file_buf), /* compression level = */ 3, /* append_to_existing_file_ = */ mode == WriteMode::Append);
+                compressed_buffer = std::make_unique<ZstdDeflatingAppendableWriteBuffer>(
+                    std::move(file_buf),
+                    /* compressi)on level = */ 3,
+                    /* append_to_existing_file_ = */ mode == WriteMode::Append,
+                    [current_log_disk, path = current_file_description->path] { return current_log_disk->readFile(path); });
 
             prealloc_done = false;
         }
@@ -147,10 +185,7 @@ public:
     }
 
     /// There is bug when compressed_buffer has value, file_buf's ownership transfer to compressed_buffer
-    bool isFileSet() const
-    {
-        return compressed_buffer != nullptr || file_buf != nullptr;
-    }
+    bool isFileSet() const { return compressed_buffer != nullptr || file_buf != nullptr; }
 
     bool appendRecord(ChangelogRecord && record)
     {
@@ -236,6 +271,7 @@ public:
         new_description->from_log_index = new_start_log_index;
         new_description->to_log_index = new_start_log_index + log_file_settings.rotate_interval - 1;
         new_description->extension = "bin";
+        new_description->disk = getCurrentLogDisk();
 
         if (log_file_settings.compress_logs)
             new_description->extension += "." + toContentEncodingName(CompressionMethod::Zstd);
@@ -259,7 +295,6 @@ public:
     }
 
 private:
-
     void finalizeCurrentFile()
     {
         assert(prealloc_done);
@@ -279,14 +314,13 @@ private:
 
         const auto * file_buffer = tryGetFileBuffer();
 
-        if (log_file_settings.max_size != 0 && isLocalDisk())
+        if (log_file_settings.max_size != 0 && file_buffer)
         {
             int res = -1;
             do
             {
                 res = ftruncate(file_buffer->getFD(), initial_file_size + file_buffer->count());
-            }
-            while (res < 0 && errno == EINTR);
+            } while (res < 0 && errno == EINTR);
 
             if (res != 0)
                 LOG_WARNING(log, "Could not ftruncate file. Error: {}, errno: {}", errnoToString(), errno);
@@ -321,10 +355,7 @@ private:
         return *file_buffer;
     }
 
-    const WriteBufferFromFile * tryGetFileBuffer() const
-    {
-        return const_cast<ChangelogWriter *>(this)->tryGetFileBuffer();
-    }
+    const WriteBufferFromFile * tryGetFileBuffer() const { return const_cast<ChangelogWriter *>(this)->tryGetFileBuffer(); }
 
     WriteBufferFromFile * tryGetFileBuffer()
     {
@@ -344,30 +375,22 @@ private:
 
     void tryPreallocateForFile()
     {
-        if (log_file_settings.max_size == 0)
-        {
-            initial_file_size = 0;
-            prealloc_done = true;
-            return;
-        }
-
         const auto * file_buffer = tryGetFileBuffer();
 
-        if (!file_buffer)
+        if (log_file_settings.max_size == 0 || !file_buffer)
         {
             initial_file_size = 0;
             prealloc_done = true;
-            LOG_WARNING(log, "Could not preallocate space on disk {} using fallocate", getDisk()->getName());
             return;
         }
 
 #ifdef OS_LINUX
-        if (isLocalDisk())
         {
             int res = -1;
             do
             {
-                res = fallocate(file_buffer->getFD(), FALLOC_FL_KEEP_SIZE, 0, log_file_settings.max_size + log_file_settings.overallocate_size);
+                res = fallocate(
+                    file_buffer->getFD(), FALLOC_FL_KEEP_SIZE, 0, log_file_settings.max_size + log_file_settings.overallocate_size);
             } while (res < 0 && errno == EINTR);
 
             if (res != 0)
@@ -387,15 +410,11 @@ private:
         prealloc_done = true;
     }
 
-    DiskPtr getDisk() const
-    {
-        return keeper_context->getLogDisk();
-    }
+    DiskPtr getCurrentLogDisk() const { return keeper_context->getCurrentLogDisk(); }
 
-    bool isLocalDisk() const
-    {
-        return dynamic_cast<DiskLocal *>(getDisk().get()) != nullptr;
-    }
+    DiskPtr getDisk() const { return keeper_context->getLogDisk(); }
+
+    bool isLocalDisk() const { return dynamic_cast<DiskLocal *>(getDisk().get()) != nullptr; }
 
     std::map<uint64_t, ChangelogFileDescriptionPtr> & existing_changelogs;
 
@@ -440,9 +459,7 @@ struct ChangelogReadResult
 class ChangelogReader
 {
 public:
-    explicit ChangelogReader(DiskPtr disk_, const std::string & filepath_)
-        : disk(disk_)
-        , filepath(filepath_)
+    explicit ChangelogReader(DiskPtr disk_, const std::string & filepath_) : disk(disk_), filepath(filepath_)
     {
         auto compression_method = chooseCompressionMethod(filepath, "");
         auto read_buffer_from_file = disk->readFile(filepath);
@@ -546,10 +563,7 @@ private:
     std::unique_ptr<ReadBuffer> read_buf;
 };
 
-Changelog::Changelog(
-    Poco::Logger * log_,
-    LogFileSettings log_file_settings,
-    KeeperContextPtr keeper_context_)
+Changelog::Changelog(Poco::Logger * log_, LogFileSettings log_file_settings, KeeperContextPtr keeper_context_)
     : changelogs_detached_dir("detached")
     , rotate_interval(log_file_settings.rotate_interval)
     , log(log_)
@@ -557,18 +571,30 @@ Changelog::Changelog(
     , append_completion_queue(std::numeric_limits<size_t>::max())
     , keeper_context(std::move(keeper_context_))
 {
-    /// Load all files in changelog directory
+    /// Load all files on changelog disks
+
+    const auto load_from_disk = [&](const auto & disk)
+    {
+        for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
+        {
+            if (it->name() == changelogs_detached_dir)
+                continue;
+
+            auto file_description = getChangelogFileDescription(it->path());
+            file_description->disk = disk;
+
+            auto [changelog_it, inserted] = existing_changelogs.insert_or_assign(file_description->from_log_index, std::move(file_description));
+
+            if (!inserted)
+                LOG_WARNING(log, "Found duplicate entries for {}, will use the entry from {}", changelog_it->second->path, disk->getName());
+        }
+    };
 
     auto disk = getDisk();
+    load_from_disk(disk);
 
-    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
-    {
-        if (it->name() == changelogs_detached_dir)
-            continue;
-
-        auto file_description = getChangelogFileDescription(it->path());
-        existing_changelogs[file_description->from_log_index] = std::move(file_description);
-    }
+    auto current_log_disk = getCurrentLogDisk();
+    load_from_disk(current_log_disk);
 
     if (existing_changelogs.empty())
         LOG_WARNING(log, "No logs exists in {}. It's Ok if it's the first run of clickhouse-keeper.", disk->getPath());
@@ -579,8 +605,7 @@ Changelog::Changelog(
 
     append_completion_thread = ThreadFromGlobalPool([this] { appendCompletionThread(); });
 
-    current_writer = std::make_unique<ChangelogWriter>(
-        existing_changelogs, keeper_context, log_file_settings);
+    current_writer = std::make_unique<ChangelogWriter>(existing_changelogs, keeper_context, log_file_settings);
 }
 
 void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uint64_t logs_to_keep)
@@ -652,7 +677,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
                 break;
             }
 
-            ChangelogReader reader(getDisk(), changelog_description.path);
+            ChangelogReader reader(changelog_description.disk, changelog_description.path);
             last_log_read_result = reader.readChangelog(logs, start_to_read_from, log);
             last_log_read_result->log_start_index = changelog_description.from_log_index;
 
@@ -713,13 +738,13 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
         assert(existing_changelogs.find(last_log_read_result->log_start_index) != existing_changelogs.end());
         assert(existing_changelogs.find(last_log_read_result->log_start_index)->first == existing_changelogs.rbegin()->first);
 
-        /// Continue to write into incomplete existing log if it doesn't finished with error
+        /// Continue to write into incomplete existing log if it doesn't finish with error
         const auto & description = existing_changelogs[last_log_read_result->log_start_index];
 
         if (last_log_read_result->last_read_index == 0 || last_log_read_result->error) /// If it's broken log then remove it
         {
             LOG_INFO(log, "Removing chagelog {} because it's empty or read finished with error", description->path);
-            getDisk()->removeFile(description->path);
+            description->disk->removeFile(description->path);
             existing_changelogs.erase(last_log_read_result->log_start_index);
             std::erase_if(logs, [last_log_read_result](const auto & item) { return item.first >= last_log_read_result->log_start_index; });
         }
@@ -728,6 +753,16 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
             initWriter(description);
         }
     }
+    else if (last_log_read_result.has_value())
+    {
+        /// check if we need to move it to another disk
+        auto current_log_disk = getCurrentLogDisk();
+        auto disk = getDisk();
+
+        auto & description = existing_changelogs.at(last_log_read_result->log_start_index);
+        if (current_log_disk != disk && current_log_disk == description->disk)
+            moveFileBetweenDisks(current_log_disk, description, disk, description->path);
+    }
 
     /// Start new log if we don't initialize writer from previous log. All logs can be "complete".
     if (!current_writer->isFileSet())
@@ -740,27 +775,37 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
 void Changelog::initWriter(ChangelogFileDescriptionPtr description)
 {
     if (description->expectedEntriesCountInLog() != rotate_interval)
-        LOG_TRACE(log, "Looks like rotate_logs_interval was changed, current {}, expected entries in last log {}", rotate_interval, description->expectedEntriesCountInLog());
+        LOG_TRACE(
+            log,
+            "Looks like rotate_logs_interval was changed, current {}, expected entries in last log {}",
+            rotate_interval,
+            description->expectedEntriesCountInLog());
 
     LOG_TRACE(log, "Continue to write into {}", description->path);
+
+    auto log_disk = description->disk;
+    auto current_log_disk = getCurrentLogDisk();
+    if (log_disk != current_log_disk)
+        moveFileBetweenDisks(log_disk, description, current_log_disk, description->path);
+
     current_writer->setFile(std::move(description), WriteMode::Append);
 }
 
 namespace
 {
 
-std::string getCurrentTimestampFolder()
-{
-    const auto timestamp = LocalDateTime{std::time(nullptr)};
-    return fmt::format(
-        "{:02}{:02}{:02}T{:02}{:02}{:02}",
-        timestamp.year(),
-        timestamp.month(),
-        timestamp.day(),
-        timestamp.hour(),
-        timestamp.minute(),
-        timestamp.second());
-}
+    std::string getCurrentTimestampFolder()
+    {
+        const auto timestamp = LocalDateTime{std::time(nullptr)};
+        return fmt::format(
+            "{:02}{:02}{:02}T{:02}{:02}{:02}",
+            timestamp.year(),
+            timestamp.month(),
+            timestamp.day(),
+            timestamp.hour(),
+            timestamp.minute(),
+            timestamp.second());
+    }
 
 }
 
@@ -769,6 +814,11 @@ DiskPtr Changelog::getDisk() const
     return keeper_context->getLogDisk();
 }
 
+DiskPtr Changelog::getCurrentLogDisk() const
+{
+    return keeper_context->getCurrentLogDisk();
+}
+
 void Changelog::removeExistingLogs(ChangelogIter begin, ChangelogIter end)
 {
     auto disk = getDisk();
@@ -786,7 +836,23 @@ void Changelog::removeExistingLogs(ChangelogIter begin, ChangelogIter end)
         LOG_WARNING(log, "Removing changelog {}", itr->second->path);
         const std::filesystem::path & path = itr->second->path;
         const auto new_path = timestamp_folder / path.filename();
-        disk->moveFile(path.generic_string(), new_path.generic_string());
+
+        auto changelog_disk = itr->second->disk;
+        if (changelog_disk == disk)
+        {
+            try
+            {
+                disk->moveFile(path.generic_string(), new_path.generic_string());
+            }
+            catch (const DB::Exception & e)
+            {
+                if (e.code() == DB::ErrorCodes::NOT_IMPLEMENTED)
+                    moveFileBetweenDisks(changelog_disk, itr->second, disk, new_path);
+            }
+        }
+        else
+            moveFileBetweenDisks(changelog_disk, itr->second, disk, new_path);
+
         itr = existing_changelogs.erase(itr);
     }
 }
@@ -921,7 +987,6 @@ void Changelog::writeAt(uint64_t index, const LogEntryPtr & log_entry)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Changelog must be initialized before writing records");
 
     {
-
         std::lock_guard lock(writer_mutex);
         /// This write_at require to overwrite everything in this file and also in previous file(s)
         const bool go_to_previous_file = index < current_writer->getStartIndex();
@@ -937,13 +1002,18 @@ void Changelog::writeAt(uint64_t index, const LogEntryPtr & log_entry)
             else
                 description = std::prev(index_changelog)->second;
 
+            auto log_disk = description->disk;
+            auto current_log_disk = getCurrentLogDisk();
+            if (log_disk != current_log_disk)
+                moveFileBetweenDisks(log_disk, description, current_log_disk, description->path);
+
             current_writer->setFile(std::move(description), WriteMode::Append);
 
             /// Remove all subsequent files if overwritten something in previous one
             auto to_remove_itr = existing_changelogs.upper_bound(index);
             for (auto itr = to_remove_itr; itr != existing_changelogs.end();)
             {
-                getDisk()->removeFile(itr->second->path);
+                itr->second->disk->removeFile(itr->second->path);
                 itr = existing_changelogs.erase(itr);
             }
         }
@@ -993,16 +1063,17 @@ void Changelog::compact(uint64_t up_to_log_index)
             LOG_INFO(log, "Removing changelog {} because of compaction", changelog_description.path);
 
             /// If failed to push to queue for background removing, then we will remove it now
-            if (!log_files_to_delete_queue.tryPush(changelog_description.path, 1))
+            if (!log_files_to_delete_queue.tryPush({changelog_description.path, changelog_description.disk}, 1))
             {
                 try
                 {
-                    getDisk()->removeFile(itr->second->path);
-                    LOG_INFO(log, "Removed changelog {} because of compaction.", itr->second->path);
+                    changelog_description.disk->removeFile(changelog_description.path);
+                    LOG_INFO(log, "Removed changelog {} because of compaction.", changelog_description.path);
                 }
                 catch (Exception & e)
                 {
-                    LOG_WARNING(log, "Failed to remove changelog {} in compaction, error message: {}", itr->second->path, e.message());
+                    LOG_WARNING(
+                        log, "Failed to remove changelog {} in compaction, error message: {}", changelog_description.path, e.message());
                 }
                 catch (...)
                 {
@@ -1197,12 +1268,13 @@ Changelog::~Changelog()
 
 void Changelog::cleanLogThread()
 {
-    std::string path;
-    while (log_files_to_delete_queue.pop(path))
+    std::pair<std::string, DiskPtr> path_with_disk;
+    while (log_files_to_delete_queue.pop(path_with_disk))
     {
+        const auto & [path, disk] = path_with_disk;
         try
         {
-            getDisk()->removeFile(path);
+            disk->removeFile(path);
             LOG_INFO(log, "Removed changelog {} because of compaction.", path);
         }
         catch (Exception & e)
diff --git a/src/Coordination/Changelog.h b/src/Coordination/Changelog.h
index 6f0c4e45605..4054829ef19 100644
--- a/src/Coordination/Changelog.h
+++ b/src/Coordination/Changelog.h
@@ -60,6 +60,7 @@ struct ChangelogFileDescription
     uint64_t to_log_index;
     std::string extension;
 
+    DiskPtr disk;
     std::string path;
 
     bool deleted = false;
@@ -154,6 +155,7 @@ private:
     static ChangelogRecord buildRecord(uint64_t index, const LogEntryPtr & log_entry);
 
     DiskPtr getDisk() const;
+    DiskPtr getCurrentLogDisk() const;
 
     /// Currently existing changelogs
     std::map<uint64_t, ChangelogFileDescriptionPtr> existing_changelogs;
@@ -187,7 +189,7 @@ private:
     uint64_t max_log_id = 0;
     /// For compaction, queue of delete not used logs
     /// 128 is enough, even if log is not removed, it's not a problem
-    ConcurrentBoundedQueue<std::string> log_files_to_delete_queue{128};
+    ConcurrentBoundedQueue<std::pair<std::string, DiskPtr>> log_files_to_delete_queue{128};
     ThreadFromGlobalPool clean_log_thread;
 
     struct AppendLog
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index ff3f96f199b..bacafe75d13 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -21,6 +21,12 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
     disk_selector->initialize(config, "storage_configuration.disks", Context::getGlobalContextInstance());
 
     log_storage = getLogsPathFromConfig(config);
+
+    if (config.has("keeper_server.current_log_storage_disk"))
+        current_log_storage = config.getString("keeper_server.current_log_storage_disk");
+    else
+        current_log_storage = log_storage;
+
     snapshot_storage = getSnapshotsPathFromConfig(config);
 
     state_file_storage = getStatePathFromConfig(config);
@@ -57,7 +63,6 @@ DiskPtr KeeperContext::getDisk(const Storage & storage) const
         return *storage_disk;
 
     const auto & disk_name = std::get<std::string>(storage);
-
     return disk_selector->get(disk_name);
 }
 
@@ -66,6 +71,11 @@ DiskPtr KeeperContext::getLogDisk() const
     return getDisk(log_storage);
 }
 
+DiskPtr KeeperContext::getCurrentLogDisk() const
+{
+    return getDisk(current_log_storage);
+}
+
 DiskPtr KeeperContext::getSnapshotsDisk() const
 {
     return getDisk(snapshot_storage);
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 1fc01f12bba..aec2061bddf 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -32,6 +32,7 @@ public:
     bool digestEnabled() const;
     void setDigestEnabled(bool digest_enabled_);
 
+    DiskPtr getCurrentLogDisk() const;
     DiskPtr getLogDisk() const;
     DiskPtr getSnapshotsDisk() const;
     DiskPtr getStateFileDisk() const;
@@ -53,6 +54,7 @@ private:
     std::shared_ptr<DiskSelector> disk_selector;
 
     Storage log_storage;
+    Storage current_log_storage;
     Storage snapshot_storage;
     Storage state_file_storage;
 
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index d47ea475c42..bfadf3af9aa 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -520,19 +520,41 @@ KeeperSnapshotManager::KeeperSnapshotManager(
     , keeper_context(keeper_context_)
 {
     auto disk = getDisk();
+
+    std::unordered_set<std::string> invalid_snapshots;
+    /// collect invalid snapshots
     for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
     {
         const auto & name = it->name();
         if (name.empty())
             continue;
+
         if (startsWith(name, "tmp_"))
+        {
+            disk->removeFile(it->path());
+            invalid_snapshots.insert(name.substr(4));
+            continue;
+        }
+
+    }
+
+    /// process snapshots
+    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
+    {
+        const auto & name = it->name();
+        if (name.empty())
+            continue;
+
+        /// Not snapshot file
+        if (!startsWith(name, "snapshot_"))
+            continue;
+
+        if (invalid_snapshots.contains(name))
         {
             disk->removeFile(it->path());
             continue;
         }
-        /// Not snapshot file
-        if (!startsWith(name, "snapshot_"))
-            continue;
+
         size_t snapshot_up_to = getSnapshotPathUpToLogIdx(name);
         existing_snapshots[snapshot_up_to] = it->path();
     }
@@ -549,11 +571,16 @@ std::string KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
     auto disk = getDisk();
-    auto plain_buf = disk->writeFile(tmp_snapshot_file_name);
+
+    {
+        disk->writeFile(tmp_snapshot_file_name);
+    }
+
+    auto plain_buf = disk->writeFile(snapshot_file_name);
     copyData(reader, *plain_buf);
     plain_buf->sync();
 
-    disk->moveFile(tmp_snapshot_file_name, snapshot_file_name);
+    disk->removeFile(tmp_snapshot_file_name);
 
     existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
     removeOutdatedSnapshotsIfNeeded();
@@ -673,7 +700,12 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
-    auto writer = getDisk()->writeFile(tmp_snapshot_file_name);
+    auto disk = getDisk();
+    {
+        disk->writeFile(tmp_snapshot_file_name);
+    }
+
+    auto writer = disk->writeFile(snapshot_file_name);
     std::unique_ptr<WriteBuffer> compressed_writer;
     if (compress_snapshots_zstd)
         compressed_writer = wrapWriteBufferWithCompressionMethod(std::move(writer), CompressionMethod::Zstd, 3);
@@ -688,7 +720,8 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
 
     try
     {
-        getDisk()->moveFile(tmp_snapshot_file_name, snapshot_file_name);
+        std::cout << "Removing file " << tmp_snapshot_file_name << std::endl;
+        disk->removeFile(tmp_snapshot_file_name);
     }
     catch (fs::filesystem_error & e)
     {
diff --git a/src/Coordination/KeeperStateManager.cpp b/src/Coordination/KeeperStateManager.cpp
index 352e67e7c43..6c1b14bc94f 100644
--- a/src/Coordination/KeeperStateManager.cpp
+++ b/src/Coordination/KeeperStateManager.cpp
@@ -385,7 +385,7 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
             }
 
             auto state = nuraft::srv_state::deserialize(*state_buf);
-            LOG_INFO(logger, "Read state from {}", disk->getPath() + path);
+            LOG_INFO(logger, "Read state from {}", fs::path(disk->getPath()) / path);
             return state;
         }
         catch (const std::exception & e)
@@ -408,7 +408,6 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
         if (state)
         {
             disk->removeFileIfExists(old_path);
-
             return state;
         }
 
diff --git a/src/Coordination/Standalone/Context.cpp b/src/Coordination/Standalone/Context.cpp
index 667fabf4d66..84083169df3 100644
--- a/src/Coordination/Standalone/Context.cpp
+++ b/src/Coordination/Standalone/Context.cpp
@@ -28,6 +28,10 @@ namespace CurrentMetrics
 namespace DB
 {
 
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
 
 struct ContextSharedPart : boost::noncopyable
 {
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index c1f9fa00f2a..7711ed7465b 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -381,6 +381,11 @@ void SettingFieldMap::readBinary(ReadBuffer & in)
 
 #else
 
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
 SettingFieldMap::SettingFieldMap(const Field &) : value(Map()) {}
 String SettingFieldMap::toString() const
 {
diff --git a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
index a680a344746..650fde7bcd1 100644
--- a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
@@ -120,6 +120,7 @@ const IMetadataStorage & MetadataStorageFromPlainObjectStorageTransaction::getSt
 void MetadataStorageFromPlainObjectStorageTransaction::unlinkFile(const std::string & path)
 {
     auto object = StoredObject(metadata_storage.getAbsolutePath(path));
+    std::cout << "Removing from plain " << path << std::endl;
     metadata_storage.object_storage->removeObject(object);
 }
 
diff --git a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.h b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.h
index 0beed65879b..fb5b6d0757c 100644
--- a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.h
+++ b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.h
@@ -63,7 +63,7 @@ public:
 
     uint32_t getHardlinkCount(const std::string & /* path */) const override
     {
-        return 1;
+        return 0;
     }
 
     bool supportsChmod() const override { return false; }
diff --git a/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp b/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
index 406de532216..81be8d8ce4d 100644
--- a/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
+++ b/src/IO/ZstdDeflatingAppendableWriteBuffer.cpp
@@ -1,5 +1,6 @@
 #include <IO/ZstdDeflatingAppendableWriteBuffer.h>
 #include <Common/Exception.h>
+#include "IO/ReadBufferFromFileBase.h"
 #include <IO/ReadBufferFromFile.h>
 
 namespace DB
@@ -14,11 +15,13 @@ ZstdDeflatingAppendableWriteBuffer::ZstdDeflatingAppendableWriteBuffer(
     std::unique_ptr<WriteBufferFromFileBase> out_,
     int compression_level,
     bool append_to_existing_file_,
+    std::function<std::unique_ptr<ReadBufferFromFileBase>()> read_buffer_creator_,
     size_t buf_size,
     char * existing_memory,
     size_t alignment)
     : BufferWithOwnMemory(buf_size, existing_memory, alignment)
     , out(std::move(out_))
+    , read_buffer_creator(std::move(read_buffer_creator_))
     , append_to_existing_file(append_to_existing_file_)
 {
     cctx = ZSTD_createCCtx();
@@ -194,13 +197,13 @@ void ZstdDeflatingAppendableWriteBuffer::addEmptyBlock()
 
 bool ZstdDeflatingAppendableWriteBuffer::isNeedToAddEmptyBlock()
 {
-    ReadBufferFromFile reader(out->getFileName());
-    auto fsize = reader.getFileSize();
+    auto reader = read_buffer_creator();
+    auto fsize = reader->getFileSize();
     if (fsize > 3)
     {
         std::array<char, 3> result;
-        reader.seek(fsize - 3, SEEK_SET);
-        reader.readStrict(result.data(), 3);
+        reader->seek(fsize - 3, SEEK_SET);
+        reader->readStrict(result.data(), 3);
 
         /// If we don't have correct block in the end, then we need to add it manually.
         /// NOTE: maybe we can have the same bytes in case of data corruption/unfinished write.
diff --git a/src/IO/ZstdDeflatingAppendableWriteBuffer.h b/src/IO/ZstdDeflatingAppendableWriteBuffer.h
index b64e5d5c4cf..d9c4f32d6da 100644
--- a/src/IO/ZstdDeflatingAppendableWriteBuffer.h
+++ b/src/IO/ZstdDeflatingAppendableWriteBuffer.h
@@ -5,6 +5,7 @@
 #include <IO/WriteBuffer.h>
 #include <IO/WriteBufferDecorator.h>
 #include <IO/WriteBufferFromFile.h>
+#include <IO/ReadBufferFromFileBase.h>
 
 #include <zstd.h>
 
@@ -32,6 +33,7 @@ public:
         std::unique_ptr<WriteBufferFromFileBase> out_,
         int compression_level,
         bool append_to_existing_file_,
+        std::function<std::unique_ptr<ReadBufferFromFileBase>()> read_buffer_creator_,
         size_t buf_size = DBMS_DEFAULT_BUFFER_SIZE,
         char * existing_memory = nullptr,
         size_t alignment = 0);
@@ -69,6 +71,7 @@ private:
     void addEmptyBlock();
 
     std::unique_ptr<WriteBufferFromFileBase> out;
+    std::function<std::unique_ptr<ReadBufferFromFileBase>()> read_buffer_creator;
 
     bool append_to_existing_file = false;
     ZSTD_CCtx * cctx;
diff --git a/src/Interpreters/Context.h b/src/Interpreters/Context.h
index 0ec39f18757..84e42830dee 100644
--- a/src/Interpreters/Context.h
+++ b/src/Interpreters/Context.h
@@ -1235,7 +1235,7 @@ struct HTTPContext : public IHTTPContext
 
 }
 
-#else 
+#else
 
 #include <Coordination/Standalone/Context.h>
 

From 5db21607627cf244ce40cf12d8be3dd4430c218a Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 24 May 2023 09:04:12 +0000
Subject: [PATCH 0136/1478] Fix build

---
 programs/keeper-converter/KeeperConverter.cpp |   3 +-
 src/Coordination/KeeperContext.cpp            |  18 +-
 src/Coordination/KeeperContext.h              |   7 +-
 src/Coordination/KeeperDispatcher.cpp         |  44 +-
 src/Coordination/KeeperServer.cpp             |   3 +-
 src/Coordination/KeeperServer.h               |   1 +
 src/Coordination/KeeperSnapshotManager.cpp    |   2 +-
 src/Coordination/tests/gtest_coordination.cpp | 463 ++++++++++++------
 8 files changed, 358 insertions(+), 183 deletions(-)

diff --git a/programs/keeper-converter/KeeperConverter.cpp b/programs/keeper-converter/KeeperConverter.cpp
index 58d090ca8b9..f2389021cb6 100644
--- a/programs/keeper-converter/KeeperConverter.cpp
+++ b/programs/keeper-converter/KeeperConverter.cpp
@@ -42,6 +42,7 @@ int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
     {
         auto keeper_context = std::make_shared<KeeperContext>(true);
         keeper_context->setDigestEnabled(true);
+        keeper_context->setSnapshotDisk(std::make_shared<DiskLocal>("Keeper-snapshots", options["output-dir"].as<std::string>(), 0));
 
         DB::KeeperStorage storage(/* tick_time_ms */ 500, /* superdigest */ "", keeper_context, /* initialize_system_nodes */ false);
 
@@ -52,7 +53,7 @@ int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
         DB::SnapshotMetadataPtr snapshot_meta = std::make_shared<DB::SnapshotMetadata>(storage.getZXID(), 1, std::make_shared<nuraft::cluster_config>());
         DB::KeeperStorageSnapshot snapshot(&storage, snapshot_meta);
 
-        DB::KeeperSnapshotManager manager(std::make_shared<DiskLocal>("Keeper-snapshots", options["output-dir"].as<std::string>(), 0), 1, keeper_context);
+        DB::KeeperSnapshotManager manager(1, keeper_context);
         auto snp = manager.serializeSnapshotToBuffer(snapshot);
         auto path = manager.serializeSnapshotBufferToDisk(*snp, storage.getZXID());
         std::cout << "Snapshot serialized to path:" << path << std::endl;
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index bacafe75d13..3c6411a3a24 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -76,16 +76,32 @@ DiskPtr KeeperContext::getCurrentLogDisk() const
     return getDisk(current_log_storage);
 }
 
-DiskPtr KeeperContext::getSnapshotsDisk() const
+void KeeperContext::setLogDisk(DiskPtr disk)
+{
+    log_storage = disk;
+    current_log_storage = std::move(disk);
+}
+
+DiskPtr KeeperContext::getSnapshotDisk() const
 {
     return getDisk(snapshot_storage);
 }
 
+void KeeperContext::setSnapshotDisk(DiskPtr disk)
+{
+    snapshot_storage = std::move(disk);
+}
+
 DiskPtr KeeperContext::getStateFileDisk() const
 {
     return getDisk(state_file_storage);
 }
 
+void KeeperContext::setStateFileDisk(DiskPtr disk)
+{
+    state_file_storage = std::move(disk);
+}
+
 KeeperContext::Storage KeeperContext::getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const
 {
     const auto create_local_disk = [](const auto & path)
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index aec2061bddf..4e538c99649 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -34,8 +34,13 @@ public:
 
     DiskPtr getCurrentLogDisk() const;
     DiskPtr getLogDisk() const;
-    DiskPtr getSnapshotsDisk() const;
+    void setLogDisk(DiskPtr disk);
+
+    DiskPtr getSnapshotDisk() const;
+    void setSnapshotDisk(DiskPtr disk);
+
     DiskPtr getStateFileDisk() const;
+    void setStateFileDisk(DiskPtr disk);
 private:
     /// local disk defined using path or disk name
     using Storage = std::variant<DiskPtr, std::string>;
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index 6632e58782f..17a15067301 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -336,28 +336,36 @@ void KeeperDispatcher::initialize(const Poco::Util::AbstractConfiguration & conf
 
     snapshot_s3.startup(config, macros);
 
-    server = std::make_unique<KeeperServer>(configuration_and_settings, config, responses_queue, snapshots_queue, snapshot_s3, [this](const KeeperStorage::RequestForSession & request_for_session)
-    {
-        /// check if we have queue of read requests depending on this request to be committed
-        std::lock_guard lock(read_request_queue_mutex);
-        if (auto it = read_request_queue.find(request_for_session.session_id); it != read_request_queue.end())
+    server = std::make_unique<KeeperServer>(
+        configuration_and_settings,
+        config,
+        responses_queue,
+        snapshots_queue,
+        standalone_keeper,
+        snapshot_s3,
+        [this](const KeeperStorage::RequestForSession & request_for_session)
         {
-            auto & xid_to_request_queue = it->second;
-
-            if (auto request_queue_it = xid_to_request_queue.find(request_for_session.request->xid); request_queue_it != xid_to_request_queue.end())
+            /// check if we have queue of read requests depending on this request to be committed
+            std::lock_guard lock(read_request_queue_mutex);
+            if (auto it = read_request_queue.find(request_for_session.session_id); it != read_request_queue.end())
             {
-                for (const auto & read_request : request_queue_it->second)
-                {
-                    if (server->isLeaderAlive())
-                        server->putLocalReadRequest(read_request);
-                    else
-                        addErrorResponses({read_request}, Coordination::Error::ZCONNECTIONLOSS);
-                }
+                auto & xid_to_request_queue = it->second;
 
-                xid_to_request_queue.erase(request_queue_it);
+                if (auto request_queue_it = xid_to_request_queue.find(request_for_session.request->xid);
+                    request_queue_it != xid_to_request_queue.end())
+                {
+                    for (const auto & read_request : request_queue_it->second)
+                    {
+                        if (server->isLeaderAlive())
+                            server->putLocalReadRequest(read_request);
+                        else
+                            addErrorResponses({read_request}, Coordination::Error::ZCONNECTIONLOSS);
+                    }
+
+                    xid_to_request_queue.erase(request_queue_it);
+                }
             }
-        }
-    });
+        });
 
     try
     {
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 4cacf566df6..31c91e2de80 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -108,13 +108,14 @@ KeeperServer::KeeperServer(
     const Poco::Util::AbstractConfiguration & config,
     ResponsesQueue & responses_queue_,
     SnapshotsQueue & snapshots_queue_,
+    bool standalone_keeper,
     KeeperSnapshotManagerS3 & snapshot_manager_s3,
     KeeperStateMachine::CommitCallback commit_callback)
     : server_id(configuration_and_settings_->server_id)
     , coordination_settings(configuration_and_settings_->coordination_settings)
     , log(&Poco::Logger::get("KeeperServer"))
     , is_recovering(config.getBool("keeper_server.force_recovery", false))
-    , keeper_context{std::make_shared<KeeperContext>(true)}
+    , keeper_context{std::make_shared<KeeperContext>(standalone_keeper)}
     , create_snapshot_on_exit(config.getBool("keeper_server.create_snapshot_on_exit", true))
 {
     if (coordination_settings->quorum_reads)
diff --git a/src/Coordination/KeeperServer.h b/src/Coordination/KeeperServer.h
index db4e9c1962e..63f9cc2bcea 100644
--- a/src/Coordination/KeeperServer.h
+++ b/src/Coordination/KeeperServer.h
@@ -72,6 +72,7 @@ public:
         const Poco::Util::AbstractConfiguration & config_,
         ResponsesQueue & responses_queue_,
         SnapshotsQueue & snapshots_queue_,
+        bool standalone_keeper,
         KeeperSnapshotManagerS3 & snapshot_manager_s3,
         KeeperStateMachine::CommitCallback commit_callback);
 
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index bfadf3af9aa..7d808e88b3d 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -676,7 +676,7 @@ SnapshotDeserializationResult KeeperSnapshotManager::restoreFromLatestSnapshot()
 
 DiskPtr KeeperSnapshotManager::getDisk() const
 {
-    return keeper_context->getSnapshotsDisk();
+    return keeper_context->getSnapshotDisk();
 }
 
 void KeeperSnapshotManager::removeOutdatedSnapshotsIfNeeded()
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index de5f2da262b..d3783a83bb0 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -2,35 +2,37 @@
 #include <gtest/gtest.h>
 #include "Common/ZooKeeper/IKeeper.h"
 
-#include "Coordination/KeeperContext.h"
-#include "Coordination/KeeperStorage.h"
 #include "Core/Defines.h"
-#include "IO/WriteHelpers.h"
 #include "config.h"
 
 #if USE_NURAFT
+#include <filesystem>
+#include <thread>
+#include <Coordination/Changelog.h>
+#include <Coordination/InMemoryLogStore.h>
+#include <Coordination/KeeperContext.h>
+#include <Coordination/KeeperLogStore.h>
+#include <Coordination/KeeperSnapshotManager.h>
+#include <Coordination/KeeperStateMachine.h>
+#include <Coordination/KeeperStateManager.h>
+#include <Coordination/KeeperStorage.h>
+#include <Coordination/LoggerWrapper.h>
+#include <Coordination/ReadBufferFromNuraftBuffer.h>
+#include <Coordination/SummingStateMachine.h>
+#include <Coordination/WriteBufferFromNuraftBuffer.h>
+#include <Coordination/pathUtils.h>
+#include <IO/ReadBufferFromString.h>
+#include <IO/WriteHelpers.h>
+#include <libnuraft/nuraft.hxx>
 #include <Poco/ConsoleChannel.h>
 #include <Poco/Logger.h>
-#include <Coordination/InMemoryLogStore.h>
-#include <Coordination/KeeperStateManager.h>
-#include <Coordination/KeeperSnapshotManager.h>
-#include <Coordination/SummingStateMachine.h>
-#include <Coordination/KeeperStateMachine.h>
-#include <Coordination/LoggerWrapper.h>
-#include <Coordination/WriteBufferFromNuraftBuffer.h>
-#include <Coordination/ReadBufferFromNuraftBuffer.h>
-#include <IO/ReadBufferFromString.h>
+#include <Common/Exception.h>
+#include <Common/SipHash.h>
 #include <Common/ZooKeeper/ZooKeeperCommon.h>
 #include <Common/ZooKeeper/ZooKeeperIO.h>
-#include <Common/Exception.h>
 #include <Common/logger_useful.h>
-#include <libnuraft/nuraft.hxx>
-#include <thread>
-#include <Coordination/KeeperLogStore.h>
-#include <Coordination/Changelog.h>
-#include <filesystem>
-#include <Common/SipHash.h>
-#include <Coordination/pathUtils.h>
+
+#include <Disks/DiskLocal.h>
 
 #include <Coordination/SnapshotableHashTable.h>
 
@@ -39,9 +41,7 @@ struct ChangelogDirTest
 {
     std::string path;
     bool drop;
-    explicit ChangelogDirTest(std::string path_, bool drop_ = true)
-        : path(path_)
-        , drop(drop_)
+    explicit ChangelogDirTest(std::string path_, bool drop_ = true) : path(path_), drop(drop_)
     {
         if (fs::exists(path))
         {
@@ -66,8 +66,20 @@ struct CompressionParam
 class CoordinationTest : public ::testing::TestWithParam<CompressionParam>
 {
 protected:
-    DB::KeeperContextPtr keeper_context = std::make_shared<DB::KeeperContext>();
+    DB::KeeperContextPtr keeper_context = std::make_shared<DB::KeeperContext>(true);
     Poco::Logger * log{&Poco::Logger::get("CoordinationTest")};
+
+    void setLogDirectory(const std::string & path) { keeper_context->setLogDisk(std::make_shared<DB::DiskLocal>("LogDisk", path, 0)); }
+
+    void setSnapshotDirectory(const std::string & path)
+    {
+        keeper_context->setSnapshotDisk(std::make_shared<DB::DiskLocal>("SnapshotDisk", path, 0));
+    }
+
+    void setStateFileDirectory(const std::string & path)
+    {
+        keeper_context->setStateFileDisk(std::make_shared<DB::DiskLocal>("StateFile", path, 0));
+    }
 };
 
 TEST_P(CoordinationTest, BuildTest)
@@ -113,13 +125,14 @@ TEST_P(CoordinationTest, BufferSerde)
 template <typename StateMachine>
 struct SimpliestRaftServer
 {
-    SimpliestRaftServer(int server_id_, const std::string & hostname_, int port_, const std::string & logs_path, const std::string & state_path)
+    SimpliestRaftServer(
+        int server_id_, const std::string & hostname_, int port_, DB::KeeperContextPtr keeper_context)
         : server_id(server_id_)
         , hostname(hostname_)
         , port(port_)
         , endpoint(hostname + ":" + std::to_string(port))
         , state_machine(nuraft::cs_new<StateMachine>())
-        , state_manager(nuraft::cs_new<DB::KeeperStateManager>(server_id, hostname, port, logs_path, state_path))
+        , state_manager(nuraft::cs_new<DB::KeeperStateManager>(server_id, hostname, port, keeper_context))
     {
         state_manager->loadLogStore(1, 0);
         nuraft::raft_params params;
@@ -135,8 +148,13 @@ struct SimpliestRaftServer
         nuraft::raft_server::init_options opts;
         opts.start_server_in_constructor_ = false;
         raft_instance = launcher.init(
-            state_machine, state_manager, nuraft::cs_new<DB::LoggerWrapper>("ToyRaftLogger", DB::LogsLevel::trace), port,
-            nuraft::asio_service::options{}, params, opts);
+            state_machine,
+            state_manager,
+            nuraft::cs_new<DB::LoggerWrapper>("ToyRaftLogger", DB::LogsLevel::trace),
+            port,
+            nuraft::asio_service::options{},
+            params,
+            opts);
 
         if (!raft_instance)
         {
@@ -195,15 +213,14 @@ nuraft::ptr<nuraft::buffer> getBuffer(int64_t number)
     return ret;
 }
 
-
 TEST_P(CoordinationTest, TestSummingRaft1)
 {
     ChangelogDirTest test("./logs");
-    SummingRaftServer s1(1, "localhost", 44444, "./logs", "./state");
-    SCOPE_EXIT(
-        if (std::filesystem::exists("./state"))
-            std::filesystem::remove("./state");
-    );
+    setLogDirectory("./logs");
+    setStateFileDirectory(".");
+
+    SummingRaftServer s1(1, "localhost", 44444, keeper_context);
+    SCOPE_EXIT(if (std::filesystem::exists("./state")) std::filesystem::remove("./state"););
 
     /// Single node is leader
     EXPECT_EQ(s1.raft_instance->get_leader(), 1);
@@ -235,8 +252,10 @@ TEST_P(CoordinationTest, ChangelogTestSimple)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
 
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
     auto entry = getLogEntry("hello world", 77);
     changelog.append(entry);
@@ -263,7 +282,10 @@ TEST_P(CoordinationTest, ChangelogTestFile)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
     auto entry = getLogEntry("hello world", 77);
     changelog.append(entry);
@@ -292,7 +314,10 @@ TEST_P(CoordinationTest, ChangelogReadWrite)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 10; ++i)
@@ -306,7 +331,8 @@ TEST_P(CoordinationTest, ChangelogReadWrite)
 
     waitDurableLogs(changelog);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000}, keeper_context);
     changelog_reader.init(1, 0);
     EXPECT_EQ(changelog_reader.size(), 10);
     EXPECT_EQ(changelog_reader.last_entry()->get_term(), changelog.last_entry()->get_term());
@@ -326,7 +352,10 @@ TEST_P(CoordinationTest, ChangelogWriteAt)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000}, keeper_context);
     changelog.init(1, 0);
     for (size_t i = 0; i < 10; ++i)
     {
@@ -348,7 +377,8 @@ TEST_P(CoordinationTest, ChangelogWriteAt)
     EXPECT_EQ(changelog.entry_at(7)->get_term(), 77);
     EXPECT_EQ(changelog.next_slot(), 8);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1000}, keeper_context);
     changelog_reader.init(1, 0);
 
     EXPECT_EQ(changelog_reader.size(), changelog.size());
@@ -362,7 +392,10 @@ TEST_P(CoordinationTest, ChangelogTestAppendAfterRead)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
     for (size_t i = 0; i < 7; ++i)
     {
@@ -378,7 +411,8 @@ TEST_P(CoordinationTest, ChangelogTestAppendAfterRead)
     EXPECT_TRUE(fs::exists("./logs/changelog_1_5.bin" + params.extension));
     EXPECT_TRUE(fs::exists("./logs/changelog_6_10.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_reader.init(1, 0);
 
     EXPECT_EQ(changelog_reader.size(), 7);
@@ -395,7 +429,7 @@ TEST_P(CoordinationTest, ChangelogTestAppendAfterRead)
     EXPECT_TRUE(fs::exists("./logs/changelog_6_10.bin" + params.extension));
 
     size_t logs_count = 0;
-    for (const auto & _ [[maybe_unused]]: fs::directory_iterator("./logs"))
+    for (const auto & _ [[maybe_unused]] : fs::directory_iterator("./logs"))
         logs_count++;
 
     EXPECT_EQ(logs_count, 2);
@@ -412,7 +446,7 @@ TEST_P(CoordinationTest, ChangelogTestAppendAfterRead)
     EXPECT_TRUE(fs::exists("./logs/changelog_11_15.bin" + params.extension));
 
     logs_count = 0;
-    for (const auto & _ [[maybe_unused]]: fs::directory_iterator("./logs"))
+    for (const auto & _ [[maybe_unused]] : fs::directory_iterator("./logs"))
         logs_count++;
 
     EXPECT_EQ(logs_count, 3);
@@ -440,7 +474,10 @@ TEST_P(CoordinationTest, ChangelogTestCompaction)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 3; ++i)
@@ -489,7 +526,8 @@ TEST_P(CoordinationTest, ChangelogTestCompaction)
     EXPECT_EQ(changelog.next_slot(), 8);
     EXPECT_EQ(changelog.last_entry()->get_term(), 60);
     /// And we able to read it
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_reader.init(7, 0);
 
     EXPECT_EQ(changelog_reader.size(), 1);
@@ -502,7 +540,10 @@ TEST_P(CoordinationTest, ChangelogTestBatchOperations)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog.init(1, 0);
     for (size_t i = 0; i < 10; ++i)
     {
@@ -517,7 +558,8 @@ TEST_P(CoordinationTest, ChangelogTestBatchOperations)
 
     auto entries = changelog.pack(1, 5);
 
-    DB::KeeperLogStore apply_changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore apply_changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
     apply_changelog.init(1, 0);
 
     for (size_t i = 0; i < 10; ++i)
@@ -549,23 +591,31 @@ TEST_P(CoordinationTest, ChangelogTestBatchOperationsEmpty)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
-    changelog.init(1, 0);
-    for (size_t i = 0; i < 10; ++i)
+    setLogDirectory("./logs");
+
+    nuraft::ptr<nuraft::buffer> entries;
     {
-        auto entry = getLogEntry(std::to_string(i) + "_hello_world", i * 10);
-        changelog.append(entry);
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
+        changelog.init(1, 0);
+        for (size_t i = 0; i < 10; ++i)
+        {
+            auto entry = getLogEntry(std::to_string(i) + "_hello_world", i * 10);
+            changelog.append(entry);
+        }
+        changelog.end_of_append_batch(0, 0);
+
+        EXPECT_EQ(changelog.size(), 10);
+
+        waitDurableLogs(changelog);
+
+        entries = changelog.pack(5, 5);
     }
-    changelog.end_of_append_batch(0, 0);
-
-    EXPECT_EQ(changelog.size(), 10);
-
-    waitDurableLogs(changelog);
-
-    auto entries = changelog.pack(5, 5);
 
     ChangelogDirTest test1("./logs1");
-    DB::KeeperLogStore changelog_new("./logs1", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+    setLogDirectory("./logs1");
+    DB::KeeperLogStore changelog_new(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog_new.init(1, 0);
     EXPECT_EQ(changelog_new.size(), 0);
 
@@ -587,7 +637,8 @@ TEST_P(CoordinationTest, ChangelogTestBatchOperationsEmpty)
     EXPECT_EQ(changelog_new.start_index(), 5);
     EXPECT_EQ(changelog_new.next_slot(), 11);
 
-    DB::KeeperLogStore changelog_reader("./logs1", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog_reader.init(5, 0);
 }
 
@@ -596,7 +647,10 @@ TEST_P(CoordinationTest, ChangelogTestWriteAtPreviousFile)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 33; ++i)
@@ -637,7 +691,8 @@ TEST_P(CoordinationTest, ChangelogTestWriteAtPreviousFile)
     EXPECT_FALSE(fs::exists("./logs/changelog_26_30.bin" + params.extension));
     EXPECT_FALSE(fs::exists("./logs/changelog_31_35.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_read("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_read(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_read.init(1, 0);
     EXPECT_EQ(changelog_read.size(), 7);
     EXPECT_EQ(changelog_read.start_index(), 1);
@@ -649,7 +704,10 @@ TEST_P(CoordinationTest, ChangelogTestWriteAtFileBorder)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 33; ++i)
@@ -690,7 +748,8 @@ TEST_P(CoordinationTest, ChangelogTestWriteAtFileBorder)
     EXPECT_FALSE(fs::exists("./logs/changelog_26_30.bin" + params.extension));
     EXPECT_FALSE(fs::exists("./logs/changelog_31_35.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_read("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_read(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_read.init(1, 0);
     EXPECT_EQ(changelog_read.size(), 11);
     EXPECT_EQ(changelog_read.start_index(), 1);
@@ -702,7 +761,10 @@ TEST_P(CoordinationTest, ChangelogTestWriteAtAllFiles)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
     for (size_t i = 0; i < 33; ++i)
     {
@@ -747,7 +809,10 @@ TEST_P(CoordinationTest, ChangelogTestStartNewLogAfterRead)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 35; ++i)
@@ -768,7 +833,8 @@ TEST_P(CoordinationTest, ChangelogTestStartNewLogAfterRead)
     EXPECT_TRUE(fs::exists("./logs/changelog_31_35.bin" + params.extension));
     EXPECT_FALSE(fs::exists("./logs/changelog_36_40.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_reader.init(1, 0);
 
     auto entry = getLogEntry("36_hello_world", 360);
@@ -792,16 +858,16 @@ namespace
 {
 void assertBrokenLogRemoved(const fs::path & log_folder, const fs::path & filename)
 {
-        EXPECT_FALSE(fs::exists(log_folder / filename));
-        // broken logs are sent to the detached/{timestamp} folder
-        // we don't know timestamp so we iterate all of them
-        for (const auto & dir_entry : fs::recursive_directory_iterator(log_folder / "detached"))
-        {
-            if (dir_entry.path().filename() == filename)
-                return;
-        }
+    EXPECT_FALSE(fs::exists(log_folder / filename));
+    // broken logs are sent to the detached/{timestamp} folder
+    // we don't know timestamp so we iterate all of them
+    for (const auto & dir_entry : fs::recursive_directory_iterator(log_folder / "detached"))
+    {
+        if (dir_entry.path().filename() == filename)
+            return;
+    }
 
-        FAIL() << "Broken log " << filename << " was not moved to the detached folder";
+    FAIL() << "Broken log " << filename << " was not moved to the detached folder";
 }
 
 }
@@ -812,8 +878,10 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate)
 
     auto params = GetParam();
     ChangelogDirTest test(log_folder);
+    setLogDirectory(log_folder);
 
-    DB::KeeperLogStore changelog(log_folder, DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 35; ++i)
@@ -833,10 +901,12 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate)
     EXPECT_TRUE(fs::exists("./logs/changelog_26_30.bin" + params.extension));
     EXPECT_TRUE(fs::exists("./logs/changelog_31_35.bin" + params.extension));
 
-    DB::WriteBufferFromFile plain_buf("./logs/changelog_11_15.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
+    DB::WriteBufferFromFile plain_buf(
+        "./logs/changelog_11_15.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
     plain_buf.truncate(0);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_reader.init(1, 0);
     changelog_reader.end_of_append_batch(0, 0);
 
@@ -869,7 +939,8 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate)
     assertBrokenLogRemoved(log_folder, "changelog_26_30.bin" + params.extension);
     assertBrokenLogRemoved(log_folder, "changelog_31_35.bin" + params.extension);
 
-    DB::KeeperLogStore changelog_reader2("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_reader2(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_reader2.init(1, 0);
     EXPECT_EQ(changelog_reader2.size(), 11);
     EXPECT_EQ(changelog_reader2.last_entry()->get_term(), 7777);
@@ -879,8 +950,10 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate2)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
 
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 35; ++i)
@@ -894,10 +967,12 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate2)
     EXPECT_TRUE(fs::exists("./logs/changelog_1_20.bin" + params.extension));
     EXPECT_TRUE(fs::exists("./logs/changelog_21_40.bin" + params.extension));
 
-    DB::WriteBufferFromFile plain_buf("./logs/changelog_1_20.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
+    DB::WriteBufferFromFile plain_buf(
+        "./logs/changelog_1_20.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
     plain_buf.truncate(30);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20}, keeper_context);
     changelog_reader.init(1, 0);
 
     EXPECT_EQ(changelog_reader.size(), 0);
@@ -912,7 +987,8 @@ TEST_P(CoordinationTest, ChangelogTestReadAfterBrokenTruncate2)
     EXPECT_EQ(changelog_reader.size(), 1);
     EXPECT_EQ(changelog_reader.last_entry()->get_term(), 7777);
 
-    DB::KeeperLogStore changelog_reader2("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1});
+    DB::KeeperLogStore changelog_reader2(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 1}, keeper_context);
     changelog_reader2.init(1, 0);
     EXPECT_EQ(changelog_reader2.size(), 1);
     EXPECT_EQ(changelog_reader2.last_entry()->get_term(), 7777);
@@ -922,8 +998,10 @@ TEST_P(CoordinationTest, ChangelogTestLostFiles)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
 
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 35; ++i)
@@ -939,7 +1017,8 @@ TEST_P(CoordinationTest, ChangelogTestLostFiles)
 
     fs::remove("./logs/changelog_1_20.bin" + params.extension);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20}, keeper_context);
     /// It should print error message, but still able to start
     changelog_reader.init(5, 0);
     assertBrokenLogRemoved("./logs", "changelog_21_40.bin" + params.extension);
@@ -949,8 +1028,10 @@ TEST_P(CoordinationTest, ChangelogTestLostFiles2)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
 
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10}, keeper_context);
     changelog.init(1, 0);
 
     for (size_t i = 0; i < 35; ++i)
@@ -970,7 +1051,8 @@ TEST_P(CoordinationTest, ChangelogTestLostFiles2)
     // we have a gap in our logs, we need to remove all the logs after the gap
     fs::remove("./logs/changelog_21_30.bin" + params.extension);
 
-    DB::KeeperLogStore changelog_reader("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10});
+    DB::KeeperLogStore changelog_reader(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10}, keeper_context);
     /// It should print error message, but still able to start
     changelog_reader.init(5, 0);
     EXPECT_TRUE(fs::exists("./logs/changelog_1_10.bin" + params.extension));
@@ -1155,7 +1237,7 @@ TEST_P(CoordinationTest, SnapshotableHashMapDataSize)
     EXPECT_EQ(world.getApproximateDataSize(), 0);
 }
 
-void addNode(DB::KeeperStorage & storage, const std::string & path, const std::string & data, int64_t ephemeral_owner=0)
+void addNode(DB::KeeperStorage & storage, const std::string & path, const std::string & data, int64_t ephemeral_owner = 0)
 {
     using Node = DB::KeeperStorage::Node;
     Node node{};
@@ -1163,19 +1245,23 @@ void addNode(DB::KeeperStorage & storage, const std::string & path, const std::s
     node.stat.ephemeralOwner = ephemeral_owner;
     storage.container.insertOrReplace(path, node);
     auto child_it = storage.container.find(path);
-    auto child_path = DB::getBaseName(child_it->key);
-    storage.container.updateValue(DB::parentPath(StringRef{path}), [&](auto & parent)
-    {
-        parent.addChild(child_path);
-        parent.stat.numChildren++;
-    });
+    auto child_path = DB::getBaseNodeName(child_it->key);
+    storage.container.updateValue(
+        DB::parentNodePath(StringRef{path}),
+        [&](auto & parent)
+        {
+            parent.addChild(child_path);
+            parent.stat.numChildren++;
+        });
 }
 
 TEST_P(CoordinationTest, TestStorageSnapshotSimple)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
 
     DB::KeeperStorage storage(500, "", keeper_context);
     addNode(storage, "/hello", "world", 1);
@@ -1223,7 +1309,9 @@ TEST_P(CoordinationTest, TestStorageSnapshotMoreWrites)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
 
     DB::KeeperStorage storage(500, "", keeper_context);
     storage.getSessionID(130);
@@ -1264,7 +1352,9 @@ TEST_P(CoordinationTest, TestStorageSnapshotManySnapshots)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
 
     DB::KeeperStorage storage(500, "", keeper_context);
     storage.getSessionID(130);
@@ -1303,7 +1393,9 @@ TEST_P(CoordinationTest, TestStorageSnapshotMode)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
     DB::KeeperStorage storage(500, "", keeper_context);
     for (size_t i = 0; i < 50; ++i)
     {
@@ -1349,14 +1441,15 @@ TEST_P(CoordinationTest, TestStorageSnapshotMode)
     {
         EXPECT_EQ(restored_storage->container.getValue("/hello_" + std::to_string(i)).getData(), "world_" + std::to_string(i));
     }
-
 }
 
 TEST_P(CoordinationTest, TestStorageSnapshotBroken)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
     DB::KeeperStorage storage(500, "", keeper_context);
     for (size_t i = 0; i < 50; ++i)
     {
@@ -1370,7 +1463,8 @@ TEST_P(CoordinationTest, TestStorageSnapshotBroken)
     EXPECT_TRUE(fs::exists("./snapshots/snapshot_50.bin" + params.extension));
 
     /// Let's corrupt file
-    DB::WriteBufferFromFile plain_buf("./snapshots/snapshot_50.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
+    DB::WriteBufferFromFile plain_buf(
+        "./snapshots/snapshot_50.bin" + params.extension, DBMS_DEFAULT_BUFFER_SIZE, O_APPEND | O_CREAT | O_WRONLY);
     plain_buf.truncate(34);
     plain_buf.sync();
 
@@ -1390,25 +1484,35 @@ nuraft::ptr<nuraft::buffer> getBufferFromZKRequest(int64_t session_id, int64_t z
     return buf.getBuffer();
 }
 
-nuraft::ptr<nuraft::log_entry> getLogEntryFromZKRequest(size_t term, int64_t session_id, int64_t zxid, const Coordination::ZooKeeperRequestPtr & request)
+nuraft::ptr<nuraft::log_entry>
+getLogEntryFromZKRequest(size_t term, int64_t session_id, int64_t zxid, const Coordination::ZooKeeperRequestPtr & request)
 {
     auto buffer = getBufferFromZKRequest(session_id, zxid, request);
     return nuraft::cs_new<nuraft::log_entry>(term, buffer);
 }
 
-void testLogAndStateMachine(Coordination::CoordinationSettingsPtr settings, uint64_t total_logs, bool enable_compression, Coordination::KeeperContextPtr keeper_context)
+void testLogAndStateMachine(
+    Coordination::CoordinationSettingsPtr settings,
+    uint64_t total_logs,
+    bool enable_compression,
+    Coordination::KeeperContextPtr keeper_context)
 {
     using namespace Coordination;
     using namespace DB;
 
     ChangelogDirTest snapshots("./snapshots");
+    keeper_context->setSnapshotDisk(std::make_shared<DiskLocal>("SnapshotDisk", "./snapshots", 0));
     ChangelogDirTest logs("./logs");
+    keeper_context->setLogDisk(std::make_shared<DiskLocal>("LogDisk", "./logs", 0));
 
     ResponsesQueue queue(std::numeric_limits<size_t>::max());
     SnapshotsQueue snapshots_queue{1};
-    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, "./snapshots", settings, keeper_context, nullptr);
+    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, settings, keeper_context, nullptr);
     state_machine->init();
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = enable_compression, .rotate_interval = settings->rotate_log_storage_interval});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{
+            .force_sync = true, .compress_logs = enable_compression, .rotate_interval = settings->rotate_log_storage_interval},
+        keeper_context);
     changelog.init(state_machine->last_commit_index() + 1, settings->reserved_log_items);
     for (size_t i = 1; i < total_logs + 1; ++i)
     {
@@ -1426,7 +1530,8 @@ void testLogAndStateMachine(Coordination::CoordinationSettingsPtr settings, uint
         if (i % settings->snapshot_distance == 0)
         {
             nuraft::snapshot s(i, 0, std::make_shared<nuraft::cluster_config>());
-            nuraft::async_result<bool>::handler_type when_done = [&snapshot_created] (bool & ret, nuraft::ptr<std::exception> &/*exception*/)
+            nuraft::async_result<bool>::handler_type when_done
+                = [&snapshot_created](bool & ret, nuraft::ptr<std::exception> & /*exception*/)
             {
                 snapshot_created = ret;
                 LOG_INFO(&Poco::Logger::get("CoordinationTest"), "Snapshot finished");
@@ -1444,17 +1549,21 @@ void testLogAndStateMachine(Coordination::CoordinationSettingsPtr settings, uint
     }
 
     SnapshotsQueue snapshots_queue1{1};
-    auto restore_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue1, "./snapshots", settings, keeper_context, nullptr);
+    auto restore_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue1, settings, keeper_context, nullptr);
     restore_machine->init();
     EXPECT_EQ(restore_machine->last_commit_index(), total_logs - total_logs % settings->snapshot_distance);
 
-    DB::KeeperLogStore restore_changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = enable_compression, .rotate_interval = settings->rotate_log_storage_interval});
+    DB::KeeperLogStore restore_changelog(
+        DB::LogFileSettings{
+            .force_sync = true, .compress_logs = enable_compression, .rotate_interval = settings->rotate_log_storage_interval},
+        keeper_context);
     restore_changelog.init(restore_machine->last_commit_index() + 1, settings->reserved_log_items);
 
     EXPECT_EQ(restore_changelog.size(), std::min(settings->reserved_log_items + total_logs % settings->snapshot_distance, total_logs));
     EXPECT_EQ(restore_changelog.next_slot(), total_logs + 1);
     if (total_logs > settings->reserved_log_items + 1)
-        EXPECT_EQ(restore_changelog.start_index(), total_logs - total_logs % settings->snapshot_distance - settings->reserved_log_items + 1);
+        EXPECT_EQ(
+            restore_changelog.start_index(), total_logs - total_logs % settings->snapshot_distance - settings->reserved_log_items + 1);
     else
         EXPECT_EQ(restore_changelog.start_index(), 1);
 
@@ -1552,11 +1661,13 @@ TEST_P(CoordinationTest, TestEphemeralNodeRemove)
     using namespace DB;
 
     ChangelogDirTest snapshots("./snapshots");
+    setSnapshotDirectory("./snapshots");
+
     CoordinationSettingsPtr settings = std::make_shared<CoordinationSettings>();
 
     ResponsesQueue queue(std::numeric_limits<size_t>::max());
     SnapshotsQueue snapshots_queue{1};
-    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, "./snapshots", settings, keeper_context, nullptr);
+    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, settings, keeper_context, nullptr);
     state_machine->init();
 
     std::shared_ptr<ZooKeeperCreateRequest> request_c = std::make_shared<ZooKeeperCreateRequest>();
@@ -1585,11 +1696,12 @@ TEST_P(CoordinationTest, TestCreateNodeWithAuthSchemeForAclWhenAuthIsPrecommitte
     using namespace DB;
 
     ChangelogDirTest snapshots("./snapshots");
+    setSnapshotDirectory("./snapshots");
     CoordinationSettingsPtr settings = std::make_shared<CoordinationSettings>();
     ResponsesQueue queue(std::numeric_limits<size_t>::max());
     SnapshotsQueue snapshots_queue{1};
 
-    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, "./snapshots", settings, keeper_context, nullptr);
+    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, settings, keeper_context, nullptr);
     state_machine->init();
 
     String user_auth_data = "test_user:test_password";
@@ -1635,11 +1747,13 @@ TEST_P(CoordinationTest, TestSetACLWithAuthSchemeForAclWhenAuthIsPrecommitted)
     using namespace DB;
 
     ChangelogDirTest snapshots("./snapshots");
+    setSnapshotDirectory("./snapshots");
+
     CoordinationSettingsPtr settings = std::make_shared<CoordinationSettings>();
     ResponsesQueue queue(std::numeric_limits<size_t>::max());
     SnapshotsQueue snapshots_queue{1};
 
-    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, "./snapshots", settings, keeper_context, nullptr);
+    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, settings, keeper_context, nullptr);
     state_machine->init();
 
     String user_auth_data = "test_user:test_password";
@@ -1691,8 +1805,10 @@ TEST_P(CoordinationTest, TestRotateIntervalChanges)
     using namespace Coordination;
     auto params = GetParam();
     ChangelogDirTest snapshots("./logs");
+    setLogDirectory("./logs");
     {
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
 
         changelog.init(0, 3);
         for (size_t i = 1; i < 55; ++i)
@@ -1710,7 +1826,8 @@ TEST_P(CoordinationTest, TestRotateIntervalChanges)
 
     EXPECT_TRUE(fs::exists("./logs/changelog_1_100.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_1("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10});
+    DB::KeeperLogStore changelog_1(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 10}, keeper_context);
     changelog_1.init(0, 50);
     for (size_t i = 0; i < 55; ++i)
     {
@@ -1726,7 +1843,8 @@ TEST_P(CoordinationTest, TestRotateIntervalChanges)
     EXPECT_TRUE(fs::exists("./logs/changelog_1_100.bin" + params.extension));
     EXPECT_TRUE(fs::exists("./logs/changelog_101_110.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_2("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 7});
+    DB::KeeperLogStore changelog_2(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 7}, keeper_context);
     changelog_2.init(98, 55);
 
     for (size_t i = 0; i < 17; ++i)
@@ -1749,7 +1867,8 @@ TEST_P(CoordinationTest, TestRotateIntervalChanges)
     EXPECT_TRUE(fs::exists("./logs/changelog_118_124.bin" + params.extension));
     EXPECT_TRUE(fs::exists("./logs/changelog_125_131.bin" + params.extension));
 
-    DB::KeeperLogStore changelog_3("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5});
+    DB::KeeperLogStore changelog_3(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 5}, keeper_context);
     changelog_3.init(116, 3);
     for (size_t i = 0; i < 17; ++i)
     {
@@ -1796,8 +1915,10 @@ TEST_P(CoordinationTest, TestCompressedLogsMultipleRewrite)
 {
     using namespace Coordination;
     auto test_params = GetParam();
-    ChangelogDirTest snapshots("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100});
+    ChangelogDirTest logs("./logs");
+    setLogDirectory("./logs");
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
 
     changelog.init(0, 3);
     for (size_t i = 1; i < 55; ++i)
@@ -1811,7 +1932,8 @@ TEST_P(CoordinationTest, TestCompressedLogsMultipleRewrite)
 
     waitDurableLogs(changelog);
 
-    DB::KeeperLogStore changelog1("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore changelog1(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog1.init(0, 3);
     for (size_t i = 55; i < 70; ++i)
     {
@@ -1822,7 +1944,8 @@ TEST_P(CoordinationTest, TestCompressedLogsMultipleRewrite)
         changelog1.end_of_append_batch(0, 0);
     }
 
-    DB::KeeperLogStore changelog2("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore changelog2(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog2.init(0, 3);
     for (size_t i = 70; i < 80; ++i)
     {
@@ -1839,7 +1962,9 @@ TEST_P(CoordinationTest, TestStorageSnapshotDifferentCompressions)
     auto params = GetParam();
 
     ChangelogDirTest test("./snapshots");
-    DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+    setSnapshotDirectory("./snapshots");
+
+    DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
 
     DB::KeeperStorage storage(500, "", keeper_context);
     addNode(storage, "/hello", "world", 1);
@@ -1857,7 +1982,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotDifferentCompressions)
     manager.serializeSnapshotBufferToDisk(*buf, 2);
     EXPECT_TRUE(fs::exists("./snapshots/snapshot_2.bin" + params.extension));
 
-    DB::KeeperSnapshotManager new_manager("./snapshots", 3, keeper_context, !params.enable_compression);
+    DB::KeeperSnapshotManager new_manager(3, keeper_context, !params.enable_compression);
 
     auto debuf = new_manager.deserializeSnapshotBufferFromDisk(2);
 
@@ -1883,9 +2008,10 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesSmooth)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
     {
         LOG_INFO(log, "================First time=====================");
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog.append(entry);
@@ -1896,7 +2022,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesSmooth)
 
     {
         LOG_INFO(log, "================Second time=====================");
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog.append(entry);
@@ -1907,7 +2034,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesSmooth)
 
     {
         LOG_INFO(log, "================Third time=====================");
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog.append(entry);
@@ -1918,7 +2046,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesSmooth)
 
     {
         LOG_INFO(log, "================Fourth time=====================");
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog.append(entry);
@@ -1933,10 +2062,12 @@ TEST_P(CoordinationTest, ChangelogInsertMultipleTimesSmooth)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
     for (size_t i = 0; i < 36; ++i)
     {
         LOG_INFO(log, "================First time=====================");
-        DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog.init(1, 0);
         for (size_t j = 0; j < 7; ++j)
         {
@@ -1947,7 +2078,8 @@ TEST_P(CoordinationTest, ChangelogInsertMultipleTimesSmooth)
         waitDurableLogs(changelog);
     }
 
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog.init(1, 0);
     EXPECT_EQ(changelog.next_slot(), 36 * 7 + 1);
 }
@@ -1956,9 +2088,11 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesHard)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
     {
         LOG_INFO(log, "================First time=====================");
-        DB::KeeperLogStore changelog1("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog1(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog1.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog1.append(entry);
@@ -1969,7 +2103,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesHard)
 
     {
         LOG_INFO(log, "================Second time=====================");
-        DB::KeeperLogStore changelog2("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog2(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog2.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog2.append(entry);
@@ -1980,7 +2115,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesHard)
 
     {
         LOG_INFO(log, "================Third time=====================");
-        DB::KeeperLogStore changelog3("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog3(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog3.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog3.append(entry);
@@ -1991,7 +2127,8 @@ TEST_P(CoordinationTest, ChangelogInsertThreeTimesHard)
 
     {
         LOG_INFO(log, "================Fourth time=====================");
-        DB::KeeperLogStore changelog4("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100});
+        DB::KeeperLogStore changelog4(
+            DB::LogFileSettings{.force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100}, keeper_context);
         changelog4.init(1, 0);
         auto entry = getLogEntry("hello_world", 1000);
         changelog4.append(entry);
@@ -2005,10 +2142,12 @@ TEST_P(CoordinationTest, TestStorageSnapshotEqual)
 {
     auto params = GetParam();
     ChangelogDirTest test("./snapshots");
+    setSnapshotDirectory("./snapshots");
+
     std::optional<UInt128> snapshot_hash;
     for (size_t i = 0; i < 15; ++i)
     {
-        DB::KeeperSnapshotManager manager("./snapshots", 3, keeper_context, params.enable_compression);
+        DB::KeeperSnapshotManager manager(3, keeper_context, params.enable_compression);
 
         DB::KeeperStorage storage(500, "", keeper_context);
         addNode(storage, "/hello", "");
@@ -2048,7 +2187,10 @@ TEST_P(CoordinationTest, TestLogGap)
     using namespace Coordination;
     auto test_params = GetParam();
     ChangelogDirTest logs("./logs");
-    DB::KeeperLogStore changelog("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100});
+    setLogDirectory("./logs");
+
+    DB::KeeperLogStore changelog(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
 
     changelog.init(0, 3);
     for (size_t i = 1; i < 55; ++i)
@@ -2060,7 +2202,8 @@ TEST_P(CoordinationTest, TestLogGap)
         changelog.end_of_append_batch(0, 0);
     }
 
-    DB::KeeperLogStore changelog1("./logs", DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100});
+    DB::KeeperLogStore changelog1(
+        DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog1.init(61, 3);
 
     /// Logs discarded
@@ -2220,13 +2363,13 @@ TEST_P(CoordinationTest, TestListRequestTypes)
         return create_response.path_created;
     };
 
-    create_path(parentPath(StringRef{test_path}).toString(), false, false);
+    create_path(parentNodePath(StringRef{test_path}).toString(), false, false);
 
     static constexpr size_t persistent_num = 5;
     std::unordered_set<std::string> expected_persistent_children;
     for (size_t i = 0; i < persistent_num; ++i)
     {
-        expected_persistent_children.insert(getBaseName(create_path(test_path, false)).toString());
+        expected_persistent_children.insert(getBaseNodeName(create_path(test_path, false)).toString());
     }
     ASSERT_EQ(expected_persistent_children.size(), persistent_num);
 
@@ -2234,7 +2377,7 @@ TEST_P(CoordinationTest, TestListRequestTypes)
     std::unordered_set<std::string> expected_ephemeral_children;
     for (size_t i = 0; i < ephemeral_num; ++i)
     {
-        expected_ephemeral_children.insert(getBaseName(create_path(test_path, true)).toString());
+        expected_ephemeral_children.insert(getBaseNodeName(create_path(test_path, true)).toString());
     }
     ASSERT_EQ(expected_ephemeral_children.size(), ephemeral_num);
 
@@ -2242,7 +2385,7 @@ TEST_P(CoordinationTest, TestListRequestTypes)
     {
         const auto list_request = std::make_shared<ZooKeeperFilteredListRequest>();
         int new_zxid = ++zxid;
-        list_request->path = parentPath(StringRef{test_path}).toString();
+        list_request->path = parentNodePath(StringRef{test_path}).toString();
         list_request->list_request_type = list_request_type;
         storage.preprocessRequest(list_request, 1, 0, new_zxid);
         auto responses = storage.processRequest(list_request, 1, new_zxid);
@@ -2270,20 +2413,23 @@ TEST_P(CoordinationTest, TestListRequestTypes)
     EXPECT_EQ(all_children.size(), ephemeral_num + persistent_num);
     for (const auto & child : all_children)
     {
-        EXPECT_TRUE(expected_ephemeral_children.contains(child) || expected_persistent_children.contains(child)) << "Missing child " << child;
+        EXPECT_TRUE(expected_ephemeral_children.contains(child) || expected_persistent_children.contains(child))
+            << "Missing child " << child;
     }
 }
 
 TEST_P(CoordinationTest, TestDurableState)
 {
     ChangelogDirTest logs("./logs");
+    setLogDirectory("./logs");
+    setStateFileDirectory(".");
 
     auto state = nuraft::cs_new<nuraft::srv_state>();
     std::optional<DB::KeeperStateManager> state_manager;
 
     const auto reload_state_manager = [&]
     {
-        state_manager.emplace(1, "localhost", 9181, "./logs", "./state");
+        state_manager.emplace(1, "localhost", 9181, keeper_context);
         state_manager->loadLogStore(1, 0);
     };
 
@@ -2318,11 +2464,11 @@ TEST_P(CoordinationTest, TestDurableState)
         write_buf.sync();
         write_buf.close();
         reload_state_manager();
-#ifdef NDEBUG
+#    ifdef NDEBUG
         ASSERT_EQ(state_manager->read_state(), nullptr);
-#else
+#    else
         ASSERT_THROW(state_manager->read_state(), DB::Exception);
-#endif
+#    endif
     }
 
     {
@@ -2396,15 +2542,16 @@ TEST_P(CoordinationTest, ChangelogTestMaxLogSize)
 {
     auto params = GetParam();
     ChangelogDirTest test("./logs");
+    setLogDirectory("./logs");
 
     uint64_t last_entry_index{0};
     size_t i{0};
     {
         SCOPED_TRACE("Small rotation interval, big size limit");
         DB::KeeperLogStore changelog(
-            "./logs",
             DB::LogFileSettings{
-                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20, .max_size = 50 * 1024 * 1024});
+                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 20, .max_size = 50 * 1024 * 1024},
+            keeper_context);
         changelog.init(1, 0);
 
         for (; i < 100; ++i)
@@ -2421,9 +2568,9 @@ TEST_P(CoordinationTest, ChangelogTestMaxLogSize)
     {
         SCOPED_TRACE("Large rotation interval, small size limit");
         DB::KeeperLogStore changelog(
-            "./logs",
             DB::LogFileSettings{
-                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100'000, .max_size = 4000});
+                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100'000, .max_size = 4000},
+            keeper_context);
         changelog.init(1, 0);
 
         ASSERT_EQ(changelog.entry_at(last_entry_index)->get_term(), (i - 1 + 44) * 10);
@@ -2442,13 +2589,12 @@ TEST_P(CoordinationTest, ChangelogTestMaxLogSize)
     {
         SCOPED_TRACE("Final verify all logs");
         DB::KeeperLogStore changelog(
-            "./logs",
             DB::LogFileSettings{
-                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100'000, .max_size = 4000});
+                .force_sync = true, .compress_logs = params.enable_compression, .rotate_interval = 100'000, .max_size = 4000},
+            keeper_context);
         changelog.init(1, 0);
         ASSERT_EQ(changelog.entry_at(last_entry_index)->get_term(), (i - 1 + 44) * 10);
     }
-
 }
 
 TEST_P(CoordinationTest, TestCheckNotExistsRequest)
@@ -2524,13 +2670,10 @@ TEST_P(CoordinationTest, TestCheckNotExistsRequest)
     }
 }
 
-INSTANTIATE_TEST_SUITE_P(CoordinationTestSuite,
+INSTANTIATE_TEST_SUITE_P(
+    CoordinationTestSuite,
     CoordinationTest,
-    ::testing::ValuesIn(std::initializer_list<CompressionParam>{
-            CompressionParam{true, ".zstd"},
-            CompressionParam{false, ""}
-    })
-);
+    ::testing::ValuesIn(std::initializer_list<CompressionParam>{CompressionParam{true, ".zstd"}, CompressionParam{false, ""}}));
 
 int main(int argc, char ** argv)
 {

From 092cf99147293a8dbb45031cf361a03cbcf5777f Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 24 May 2023 09:46:07 +0000
Subject: [PATCH 0137/1478] Fix build

---
 programs/keeper/CMakeLists.txt                |   2 +-
 src/Coordination/Changelog.cpp                | 134 ++++++++++++------
 src/Coordination/KeeperContext.cpp            |  20 +++
 src/Coordination/KeeperContext.h              |   3 +
 src/Coordination/KeeperSnapshotManager.cpp    |   1 -
 .../MetadataStorageFromPlainObjectStorage.cpp |   1 -
 utils/keeper-data-dumper/main.cpp             |  10 +-
 7 files changed, 118 insertions(+), 53 deletions(-)

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index a946ea06626..6e97ab324e3 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -143,9 +143,9 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/IOUringReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferFromTemporaryFile.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferWithFinalizeCallback.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/AsynchronousReadIndirectBufferFromRemoteFS.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteIndirectBufferFromRemoteFS.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/getThreadPoolReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolRemoteFSReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolReader.cpp
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index c94633d6dbd..875b0758d27 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -24,63 +24,66 @@ namespace ErrorCodes
     extern const int CHECKSUM_DOESNT_MATCH;
     extern const int CORRUPTED_DATA;
     extern const int UNKNOWN_FORMAT_VERSION;
+    extern const int NOT_IMPLEMENTED;
+    extern const int BAD_ARGUMENTS;
     extern const int LOGICAL_ERROR;
 }
 
 namespace
 {
-    void moveFileBetweenDisks(DiskPtr disk_from, ChangelogFileDescriptionPtr description, DiskPtr disk_to, const std::string & path_to)
-    {
-        disk_from->copyFile(description->path, *disk_to, path_to, {});
-        disk_from->removeFile(description->path);
-        description->path = path_to;
-        description->disk = disk_to;
-    }
 
-    constexpr auto DEFAULT_PREFIX = "changelog";
+void moveFileBetweenDisks(DiskPtr disk_from, ChangelogFileDescriptionPtr description, DiskPtr disk_to, const std::string & path_to)
+{
+    disk_from->copyFile(description->path, *disk_to, path_to, {});
+    disk_from->removeFile(description->path);
+    description->path = path_to;
+    description->disk = disk_to;
+}
 
-    inline std::string
-    formatChangelogPath(const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
-    {
-        return fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension);
-    }
+constexpr auto DEFAULT_PREFIX = "changelog";
 
-    ChangelogFileDescriptionPtr getChangelogFileDescription(const std::filesystem::path & path)
-    {
-        // we can have .bin.zstd so we cannot use std::filesystem stem and extension
-        std::string filename_with_extension = path.filename();
-        std::string_view filename_with_extension_view = filename_with_extension;
+inline std::string
+formatChangelogPath(const std::string & name_prefix, uint64_t from_index, uint64_t to_index, const std::string & extension)
+{
+    return fmt::format("{}_{}_{}.{}", name_prefix, from_index, to_index, extension);
+}
 
-        auto first_dot = filename_with_extension.find('.');
-        if (first_dot == std::string::npos)
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid changelog file {}", path.generic_string());
+ChangelogFileDescriptionPtr getChangelogFileDescription(const std::filesystem::path & path)
+{
+    // we can have .bin.zstd so we cannot use std::filesystem stem and extension
+    std::string filename_with_extension = path.filename();
+    std::string_view filename_with_extension_view = filename_with_extension;
 
-        Strings filename_parts;
-        boost::split(filename_parts, filename_with_extension_view.substr(0, first_dot), boost::is_any_of("_"));
-        if (filename_parts.size() < 3)
-            throw Exception(ErrorCodes::CORRUPTED_DATA, "Invalid changelog {}", path.generic_string());
+    auto first_dot = filename_with_extension.find('.');
+    if (first_dot == std::string::npos)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid changelog file {}", path.generic_string());
 
-        auto result = std::make_shared<ChangelogFileDescription>();
-        result->prefix = filename_parts[0];
-        result->from_log_index = parse<uint64_t>(filename_parts[1]);
-        result->to_log_index = parse<uint64_t>(filename_parts[2]);
-        result->extension = std::string(filename_with_extension.substr(first_dot + 1));
-        result->path = path.generic_string();
-        return result;
-    }
+    Strings filename_parts;
+    boost::split(filename_parts, filename_with_extension_view.substr(0, first_dot), boost::is_any_of("_"));
+    if (filename_parts.size() < 3)
+        throw Exception(ErrorCodes::CORRUPTED_DATA, "Invalid changelog {}", path.generic_string());
 
-    Checksum computeRecordChecksum(const ChangelogRecord & record)
-    {
-        SipHash hash;
-        hash.update(record.header.version);
-        hash.update(record.header.index);
-        hash.update(record.header.term);
-        hash.update(record.header.value_type);
-        hash.update(record.header.blob_size);
-        if (record.header.blob_size != 0)
-            hash.update(reinterpret_cast<char *>(record.blob->data_begin()), record.blob->size());
-        return hash.get64();
-    }
+    auto result = std::make_shared<ChangelogFileDescription>();
+    result->prefix = filename_parts[0];
+    result->from_log_index = parse<uint64_t>(filename_parts[1]);
+    result->to_log_index = parse<uint64_t>(filename_parts[2]);
+    result->extension = std::string(filename_with_extension.substr(first_dot + 1));
+    result->path = path.generic_string();
+    return result;
+}
+
+Checksum computeRecordChecksum(const ChangelogRecord & record)
+{
+    SipHash hash;
+    hash.update(record.header.version);
+    hash.update(record.header.index);
+    hash.update(record.header.term);
+    hash.update(record.header.value_type);
+    hash.update(record.header.blob_size);
+    if (record.header.blob_size != 0)
+        hash.update(reinterpret_cast<char *>(record.blob->data_begin()), record.blob->size());
+    return hash.get64();
+}
 
 }
 
@@ -571,6 +574,19 @@ Changelog::Changelog(Poco::Logger * log_, LogFileSettings log_file_settings, Kee
     , append_completion_queue(std::numeric_limits<size_t>::max())
     , keeper_context(std::move(keeper_context_))
 {
+    if (auto current_log_disk = getCurrentLogDisk();
+        log_file_settings.force_sync && dynamic_cast<const DiskLocal *>(current_log_disk.get()) == nullptr)
+    {
+        throw DB::Exception(
+            DB::ErrorCodes::BAD_ARGUMENTS,
+            "force_sync is set to true for logs but disk '{}' cannot satisfy such guarantee because it's not of type DiskLocal.\n"
+            "If you want to use force_sync and same disk for all logs, please set keeper_server.log_storage_disk to a local disk.\n"
+            "If you want to use force_sync and different disk only for old logs, please set 'keeper_server.log_storage_disk' to any "
+            "supported disk and 'keeper_server.current_log_storage_disk' to a local disk.\n"
+            "Otherwise, disable force_sync",
+            current_log_disk->getName());
+    }
+
     /// Load all files on changelog disks
 
     const auto load_from_disk = [&](const auto & disk)
@@ -590,6 +606,12 @@ Changelog::Changelog(Poco::Logger * log_, LogFileSettings log_file_settings, Kee
         }
     };
 
+    /// Load all files from old disks
+    for (const auto & disk : keeper_context->getOldLogDisks())
+    {
+        load_from_disk(disk);
+    }
+
     auto disk = getDisk();
     load_from_disk(disk);
 
@@ -738,7 +760,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
         assert(existing_changelogs.find(last_log_read_result->log_start_index) != existing_changelogs.end());
         assert(existing_changelogs.find(last_log_read_result->log_start_index)->first == existing_changelogs.rbegin()->first);
 
-        /// Continue to write into incomplete existing log if it doesn't finish with error
+        /// Continue to write into incomplete existing log if it didn't finish with error
         const auto & description = existing_changelogs[last_log_read_result->log_start_index];
 
         if (last_log_read_result->last_read_index == 0 || last_log_read_result->error) /// If it's broken log then remove it
@@ -755,7 +777,7 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
     }
     else if (last_log_read_result.has_value())
     {
-        /// check if we need to move it to another disk
+        /// check if we need to move completed log to another disk
         auto current_log_disk = getCurrentLogDisk();
         auto disk = getDisk();
 
@@ -768,6 +790,24 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
     if (!current_writer->isFileSet())
         current_writer->rotate(max_log_id + 1);
 
+    /// Move files to correct disks
+    auto latest_start_index = current_writer->getStartIndex();
+    auto current_log_disk = getCurrentLogDisk();
+    auto disk = getDisk();
+    for (const auto & [start_index, description] : existing_changelogs)
+    {
+        /// latest log should already be on current_log_disk
+        if (start_index == latest_start_index)
+        {
+            chassert(description->disk == current_log_disk);
+            continue;
+        }
+
+        if (description->disk != disk)
+            moveFileBetweenDisks(description->disk, description, disk, description->path);
+    }
+
+
     initialized = true;
 }
 
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index 3c6411a3a24..e27cfc60cff 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -3,6 +3,7 @@
 #include <Coordination/Defines.h>
 #include <Disks/DiskLocal.h>
 #include <Interpreters/Context.h>
+#include <Poco/Util/AbstractConfiguration.h>
 
 namespace DB
 {
@@ -27,6 +28,14 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
     else
         current_log_storage = log_storage;
 
+    Poco::Util::AbstractConfiguration::Keys old_log_disk_name_keys;
+    config.keys("keeper_server", old_log_disk_name_keys);
+    for (const auto & key : old_log_disk_name_keys)
+    {
+        if (key.starts_with("old_log_storage_disk"))
+            old_log_disk_names.push_back(config.getString("keeper_server." + key));
+    }
+
     snapshot_storage = getSnapshotsPathFromConfig(config);
 
     state_file_storage = getStatePathFromConfig(config);
@@ -71,6 +80,17 @@ DiskPtr KeeperContext::getLogDisk() const
     return getDisk(log_storage);
 }
 
+std::vector<DiskPtr> KeeperContext::getOldLogDisks() const
+{
+    std::vector<DiskPtr> old_log_disks;
+    old_log_disks.reserve(old_log_disk_names.size());
+
+    for (const auto & disk_name : old_log_disk_names)
+        old_log_disks.push_back(disk_selector->get(disk_name));
+
+    return old_log_disks;
+}
+
 DiskPtr KeeperContext::getCurrentLogDisk() const
 {
     return getDisk(current_log_storage);
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 4e538c99649..e04d1cd6b3d 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -34,6 +34,7 @@ public:
 
     DiskPtr getCurrentLogDisk() const;
     DiskPtr getLogDisk() const;
+    std::vector<DiskPtr> getOldLogDisks() const;
     void setLogDisk(DiskPtr disk);
 
     DiskPtr getSnapshotDisk() const;
@@ -63,6 +64,8 @@ private:
     Storage snapshot_storage;
     Storage state_file_storage;
 
+    std::vector<std::string> old_log_disk_names;
+
     bool standalone_keeper;
 };
 
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 7d808e88b3d..7f097c182a1 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -720,7 +720,6 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
 
     try
     {
-        std::cout << "Removing file " << tmp_snapshot_file_name << std::endl;
         disk->removeFile(tmp_snapshot_file_name);
     }
     catch (fs::filesystem_error & e)
diff --git a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
index 650fde7bcd1..a680a344746 100644
--- a/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/MetadataStorageFromPlainObjectStorage.cpp
@@ -120,7 +120,6 @@ const IMetadataStorage & MetadataStorageFromPlainObjectStorageTransaction::getSt
 void MetadataStorageFromPlainObjectStorageTransaction::unlinkFile(const std::string & path)
 {
     auto object = StoredObject(metadata_storage.getAbsolutePath(path));
-    std::cout << "Removing from plain " << path << std::endl;
     metadata_storage.object_storage->removeObject(object);
 }
 
diff --git a/utils/keeper-data-dumper/main.cpp b/utils/keeper-data-dumper/main.cpp
index e82b21079fe..5a6fd15d72c 100644
--- a/utils/keeper-data-dumper/main.cpp
+++ b/utils/keeper-data-dumper/main.cpp
@@ -8,6 +8,7 @@
 #include <Coordination/KeeperLogStore.h>
 #include <Coordination/Changelog.h>
 #include <Common/logger_useful.h>
+#include <Disks/DiskLocal.h>
 
 using namespace Coordination;
 using namespace DB;
@@ -62,15 +63,18 @@ int main(int argc, char *argv[])
     ResponsesQueue queue(std::numeric_limits<size_t>::max());
     SnapshotsQueue snapshots_queue{1};
     CoordinationSettingsPtr settings = std::make_shared<CoordinationSettings>();
-    KeeperContextPtr keeper_context = std::make_shared<DB::KeeperContext>();
-    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, argv[1], settings, keeper_context, nullptr);
+    KeeperContextPtr keeper_context = std::make_shared<DB::KeeperContext>(true);
+    keeper_context->setLogDisk(std::make_shared<DB::DiskLocal>("LogDisk", argv[2], 0));
+    keeper_context->setSnapshotDisk(std::make_shared<DB::DiskLocal>("LogDisk", argv[1], 0));
+
+    auto state_machine = std::make_shared<KeeperStateMachine>(queue, snapshots_queue, settings, keeper_context, nullptr);
     state_machine->init();
     size_t last_commited_index = state_machine->last_commit_index();
 
     LOG_INFO(logger, "Last committed index: {}", last_commited_index);
 
     DB::KeeperLogStore changelog(
-        argv[2], LogFileSettings{.force_sync = true, .compress_logs = settings->compress_logs, .rotate_interval = 10000000});
+        LogFileSettings{.force_sync = true, .compress_logs = settings->compress_logs, .rotate_interval = 10000000}, keeper_context);
     changelog.init(last_commited_index, 10000000000UL); /// collect all logs
     if (changelog.size() == 0)
         LOG_INFO(logger, "Changelog empty");

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 0138/1478] 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 0139/1478] 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 0140/1478] 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 0141/1478] 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 0142/1478] 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 0143/1478] 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 0144/1478] 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 0145/1478] 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 0146/1478] 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 0147/1478] 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 0148/1478] 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 d8f39b8df1ef608b9f78844a6665495be3cbec33 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Wed, 24 May 2023 17:53:37 +0000
Subject: [PATCH 0149/1478] Fixing more tests.

---
 src/Interpreters/ActionsVisitor.cpp           |  8 ++++++
 .../ClusterProxy/SelectStreamFactory.cpp      |  8 +++---
 .../ClusterProxy/SelectStreamFactory.h        |  6 ++++-
 .../ClusterProxy/executeQuery.cpp             |  1 +
 src/Interpreters/GlobalSubqueriesVisitor.h    |  3 ++-
 src/Interpreters/PreparedSets.cpp             |  6 ++++-
 .../QueryPlan/DistributedCreateLocalPlan.cpp  |  3 ++-
 .../QueryPlan/DistributedCreateLocalPlan.h    |  4 +++
 src/Processors/QueryPlan/ReadFromRemote.cpp   |  6 +++--
 src/Processors/QueryPlan/ReadFromRemote.h     |  2 ++
 src/Storages/StorageDistributed.cpp           |  3 ++-
 src/Storages/StorageMergeTree.cpp             |  3 ++-
 src/Storages/StorageReplicatedMergeTree.cpp   |  3 ++-
 src/Storages/VirtualColumnUtils.cpp           | 27 +++++++++++++++++++
 14 files changed, 71 insertions(+), 12 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index dcf6c4a461f..1405568aa71 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -3,6 +3,7 @@
 #include <Common/quoteString.h>
 #include <Common/typeid_cast.h>
 #include <Common/FieldVisitorsAccurateComparison.h>
+#include "Parsers/queryToString.h"
 
 #include <Core/ColumnNumbers.h>
 #include <Core/ColumnWithTypeAndName.h>
@@ -1392,8 +1393,15 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
     {
         if (no_subqueries)
             return {};
+        //std::cerr << queryToString(right_in_operand) << std::endl;
         auto set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
 
+        // std::cerr << set_key.toString() << std::endl;
+        // std::cerr << data.prepared_sets->getSets().size() << std::endl;
+        // std::cerr << reinterpret_cast<const void *>(data.prepared_sets.get()) << std::endl;
+        // for (const auto & [k, v] : data.prepared_sets->getSets())
+        //     std::cerr << "... " << k.toString();
+
         if (auto set = data.prepared_sets->getFuture(set_key))
             return set;
 
diff --git a/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp b/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
index 0cf3f360994..0f8a725e144 100644
--- a/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
+++ b/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
@@ -92,11 +92,13 @@ SelectStreamFactory::SelectStreamFactory(
     const Block & header_,
     const ColumnsDescriptionByShardNum & objects_by_shard_,
     const StorageSnapshotPtr & storage_snapshot_,
-    QueryProcessingStage::Enum processed_stage_)
+    QueryProcessingStage::Enum processed_stage_,
+    PreparedSetsPtr prepared_sets_)
     : header(header_),
     objects_by_shard(objects_by_shard_),
     storage_snapshot(storage_snapshot_),
-    processed_stage(processed_stage_)
+    processed_stage(processed_stage_),
+    prepared_sets(std::move(prepared_sets_))
 {
 }
 
@@ -117,7 +119,7 @@ void SelectStreamFactory::createForShard(
     auto emplace_local_stream = [&]()
     {
         local_plans.emplace_back(createLocalPlan(
-            query_ast, header, context, processed_stage, shard_info.shard_num, shard_count, /*replica_num=*/0, /*replica_count=*/0, /*coordinator=*/nullptr));
+            query_ast, header, context, processed_stage, prepared_sets, shard_info.shard_num, shard_count, /*replica_num=*/0, /*replica_count=*/0, /*coordinator=*/nullptr));
     };
 
     auto emplace_remote_stream = [&](bool lazy = false, time_t local_delay = 0)
diff --git a/src/Interpreters/ClusterProxy/SelectStreamFactory.h b/src/Interpreters/ClusterProxy/SelectStreamFactory.h
index f1a8b3e0984..b19012ddba6 100644
--- a/src/Interpreters/ClusterProxy/SelectStreamFactory.h
+++ b/src/Interpreters/ClusterProxy/SelectStreamFactory.h
@@ -26,6 +26,8 @@ using QueryPlanPtr = std::unique_ptr<QueryPlan>;
 
 struct StorageID;
 
+class PreparedSets;
+using PreparedSetsPtr = std::shared_ptr<PreparedSets>;
 namespace ClusterProxy
 {
 
@@ -67,7 +69,8 @@ public:
         const Block & header_,
         const ColumnsDescriptionByShardNum & objects_by_shard_,
         const StorageSnapshotPtr & storage_snapshot_,
-        QueryProcessingStage::Enum processed_stage_);
+        QueryProcessingStage::Enum processed_stage_,
+        PreparedSetsPtr prepared_sets_);
 
     void createForShard(
         const Cluster::ShardInfo & shard_info,
@@ -92,6 +95,7 @@ public:
     const ColumnsDescriptionByShardNum objects_by_shard;
     const StorageSnapshotPtr storage_snapshot;
     QueryProcessingStage::Enum processed_stage;
+    PreparedSetsPtr prepared_sets;
 };
 
 }
diff --git a/src/Interpreters/ClusterProxy/executeQuery.cpp b/src/Interpreters/ClusterProxy/executeQuery.cpp
index e2f1dfe8ba7..a9cf3d55392 100644
--- a/src/Interpreters/ClusterProxy/executeQuery.cpp
+++ b/src/Interpreters/ClusterProxy/executeQuery.cpp
@@ -226,6 +226,7 @@ void executeQuery(
             std::move(remote_shards),
             header,
             processed_stage,
+            stream_factory.prepared_sets,
             main_table,
             table_func_ptr,
             new_context,
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 3a846bb4bc3..a872af529aa 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -181,7 +181,7 @@ public:
                 // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
                 // subquery_for_set.createSource(*interpreter, external_storage);
                 auto key = subquery_or_table_name->getColumnName();
-                auto set_key = PreparedSetKey::forSubquery(subquery_or_table_name->getTreeHash());
+                auto set_key = PreparedSetKey::forSubquery(database_and_table_name->getTreeHash());
 
                 if (!prepared_sets->getFuture(set_key))
                 {
@@ -190,6 +190,7 @@ public:
                     subquery_for_set.table = std::move(external_storage);
                     subquery_for_set.createSource(*interpreter);
 
+                    //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
                     prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set));
                 }
                 else
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index cd6b2a81ba0..3b63d942404 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -140,6 +140,10 @@ FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryF
     if (!inserted)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
 
+    // std::cerr << key.toString() << std::endl;
+    // std::cerr << "========= PreparedSets::addFromSubquery\n";
+    // std::cerr << StackTrace().toString() << std::endl;
+
     subqueries.emplace(id, std::move(from_subquery));
     return it->second;
 }
@@ -226,7 +230,7 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     if (set)
         return nullptr;
 
-    //std::cerr << StackTrace().toString() << std::endl;
+    // std::cerr << StackTrace().toString() << std::endl;
 
     auto set_cache = context->getPreparedSetsCache();
     if (set_cache)
diff --git a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
index 9b9cc221ca8..62e369659d1 100644
--- a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
+++ b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
@@ -43,6 +43,7 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     const Block & header,
     ContextPtr context,
     QueryProcessingStage::Enum processed_stage,
+    PreparedSetsPtr prepared_sets,
     size_t shard_num,
     size_t shard_count,
     size_t replica_num,
@@ -98,7 +99,7 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     }
     else
     {
-        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options);
+        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options, prepared_sets);
         interpreter.buildQueryPlan(*query_plan);
     }
 
diff --git a/src/Processors/QueryPlan/DistributedCreateLocalPlan.h b/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
index 1afdc07fa4d..cf59027a33f 100644
--- a/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
+++ b/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
@@ -10,11 +10,15 @@
 namespace DB
 {
 
+class PreparedSets;
+using PreparedSetsPtr = std::shared_ptr<PreparedSets>;
+
 std::unique_ptr<QueryPlan> createLocalPlan(
     const ASTPtr & query_ast,
     const Block & header,
     ContextPtr context,
     QueryProcessingStage::Enum processed_stage,
+    PreparedSetsPtr prepared_sets,
     size_t shard_num,
     size_t shard_count,
     size_t replica_num,
diff --git a/src/Processors/QueryPlan/ReadFromRemote.cpp b/src/Processors/QueryPlan/ReadFromRemote.cpp
index ed740e3e242..16cb06a94d6 100644
--- a/src/Processors/QueryPlan/ReadFromRemote.cpp
+++ b/src/Processors/QueryPlan/ReadFromRemote.cpp
@@ -97,6 +97,7 @@ ReadFromRemote::ReadFromRemote(
     ClusterProxy::SelectStreamFactory::Shards shards_,
     Block header_,
     QueryProcessingStage::Enum stage_,
+    PreparedSetsPtr prepared_sets_,
     StorageID main_table_,
     ASTPtr table_func_ptr_,
     ContextMutablePtr context_,
@@ -109,6 +110,7 @@ ReadFromRemote::ReadFromRemote(
     : ISourceStep(DataStream{.header = std::move(header_)})
     , shards(std::move(shards_))
     , stage(stage_)
+    , prepared_sets(std::move(prepared_sets_))
     , main_table(std::move(main_table_))
     , table_func_ptr(std::move(table_func_ptr_))
     , context(std::move(context_))
@@ -150,7 +152,7 @@ void ReadFromRemote::addLazyPipe(Pipes & pipes, const ClusterProxy::SelectStream
             my_context = context, my_throttler = throttler,
             my_main_table = main_table, my_table_func_ptr = table_func_ptr,
             my_scalars = scalars, my_external_tables = external_tables,
-            my_stage = stage, local_delay = shard.local_delay,
+            my_stage = stage, my_prepared_sets = prepared_sets, local_delay = shard.local_delay,
             add_agg_info, add_totals, add_extremes, async_read, async_query_sending]() mutable
         -> QueryPipelineBuilder
     {
@@ -185,7 +187,7 @@ void ReadFromRemote::addLazyPipe(Pipes & pipes, const ClusterProxy::SelectStream
         if (try_results.empty() || local_delay < max_remote_delay)
         {
             auto plan = createLocalPlan(
-                query, header, my_context, my_stage, my_shard.shard_info.shard_num, my_shard_count, 0, 0, /*coordinator=*/nullptr);
+                query, header, my_context, my_stage, my_prepared_sets, my_shard.shard_info.shard_num, my_shard_count, 0, 0, /*coordinator=*/nullptr);
 
             return std::move(*plan->buildQueryPipeline(
                 QueryPlanOptimizationSettings::fromContext(my_context),
diff --git a/src/Processors/QueryPlan/ReadFromRemote.h b/src/Processors/QueryPlan/ReadFromRemote.h
index d4005d81f1b..405b5727ff2 100644
--- a/src/Processors/QueryPlan/ReadFromRemote.h
+++ b/src/Processors/QueryPlan/ReadFromRemote.h
@@ -26,6 +26,7 @@ public:
         ClusterProxy::SelectStreamFactory::Shards shards_,
         Block header_,
         QueryProcessingStage::Enum stage_,
+        PreparedSetsPtr prepared_sets_,
         StorageID main_table_,
         ASTPtr table_func_ptr_,
         ContextMutablePtr context_,
@@ -46,6 +47,7 @@ public:
 private:
     ClusterProxy::SelectStreamFactory::Shards shards;
     QueryProcessingStage::Enum stage;
+    PreparedSetsPtr prepared_sets;
     StorageID main_table;
     ASTPtr table_func_ptr;
     ContextMutablePtr context;
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 86a2599b49c..f45e247f8e7 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -1098,7 +1098,8 @@ void StorageDistributed::read(
             header,
             snapshot_data.objects_by_shard,
             storage_snapshot,
-            processed_stage);
+            processed_stage,
+            query_info.prepared_sets);
 
     auto settings = local_context->getSettingsRef();
 
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index 2c19d3ba122..4600532231f 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -231,7 +231,8 @@ void StorageMergeTree::read(
                 header,
                 {},
                 storage_snapshot,
-                processed_stage);
+                processed_stage,
+                query_info.prepared_sets);
 
         ClusterProxy::executeQueryWithParallelReplicas(
             query_plan, getStorageID(), /*remove_table_function_ptr*/ nullptr,
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index d9c8f09ccf1..ab78ea2f0a4 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -4663,7 +4663,8 @@ void StorageReplicatedMergeTree::read(
                 header,
                 {},
                 storage_snapshot,
-                processed_stage);
+                processed_stage,
+                query_info.prepared_sets);
 
         ClusterProxy::executeQueryWithParallelReplicas(
             query_plan, getStorageID(), /*remove_table_function_ptr*/ nullptr,
diff --git a/src/Storages/VirtualColumnUtils.cpp b/src/Storages/VirtualColumnUtils.cpp
index 31fa1cc6a7e..be2206a78e9 100644
--- a/src/Storages/VirtualColumnUtils.cpp
+++ b/src/Storages/VirtualColumnUtils.cpp
@@ -23,6 +23,8 @@
 #include <Storages/VirtualColumnUtils.h>
 #include <IO/WriteHelpers.h>
 #include <Common/typeid_cast.h>
+#include <Columns/ColumnSet.h>
+#include <Functions/FunctionHelpers.h>
 #include <Interpreters/ActionsVisitor.h>
 
 
@@ -202,6 +204,31 @@ void filterBlockWithQuery(const ASTPtr & query, Block & block, ContextPtr contex
     //buildSets(expression_ast, analyzer);
     ExpressionActionsPtr actions = analyzer.getActions(false /* add alises */, true /* project result */, CompileExpressions::yes);
 
+    for (const auto & node : actions->getNodes())
+    {
+        if (node.type == ActionsDAG::ActionType::COLUMN)
+        {
+            const ColumnSet * column_set = checkAndGetColumnConstData<const ColumnSet>(node.column.get());
+            if (!column_set)
+                column_set = checkAndGetColumn<const ColumnSet>(node.column.get());
+
+            if (column_set)
+            {
+                auto future_set = column_set->getData();
+                if (!future_set->isFilled())
+                {
+                    auto plan = future_set->build(context);
+                    auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
+                    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
+                    pipeline.complete(std::make_shared<EmptySink>(Block()));
+
+                    CompletedPipelineExecutor executor(pipeline);
+                    executor.execute();
+                }
+            }
+        }
+    }
+
     Block block_with_filter = block;
     actions->execute(block_with_filter);
 

From 75791d7a63b9a6a579e1f036cdffc321bcc9fa2d Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Thu, 25 May 2023 07:51:32 +0000
Subject: [PATCH 0150/1478] Added input_format_csv_trim_whitespaces parameter

---
 docs/en/interfaces/formats.md                 |   1 +
 .../operations/settings/settings-formats.md   |  32 +++++
 docs/ru/interfaces/formats.md                 |  17 +++
 docs/ru/operations/settings/settings.md       |  62 +++++++++
 src/Core/Settings.h                           |   1 +
 src/Formats/FormatFactory.cpp                 |   1 +
 src/Formats/FormatSettings.h                  |   1 +
 src/IO/ReadHelpers.cpp                        |  19 +--
 .../Formats/Impl/CSVRowInputFormat.cpp        |  17 ++-
 .../02764_csv_trim_whitespaces.reference      | 122 ++++++++++++++++++
 .../0_stateless/02764_csv_trim_whitespaces.sh |  55 ++++++++
 11 files changed, 317 insertions(+), 11 deletions(-)
 create mode 100644 tests/queries/0_stateless/02764_csv_trim_whitespaces.reference
 create mode 100755 tests/queries/0_stateless/02764_csv_trim_whitespaces.sh

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 2ab9e8caec4..f19fd94dcd8 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -467,6 +467,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_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`.
 
 ## CSVWithNames {#csvwithnames}
 
diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index 3b87b829c92..cb7d98a4876 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -882,6 +882,38 @@ My NULL
 My NULL
 ```
 
+### input_format_csv_trim_whitespaces {#input_format_csv_trim_whitespaces}
+
+Trims spaces and tabs in non-quoted CSV strings.
+
+Default value: `true`.
+
+**Examples**
+
+Query
+
+```bash
+echo '  string  ' |./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
+```
+
+Result
+
+```text
+"string"
+```
+
+Query
+
+```bash
+echo '  string  ' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=false
+```
+
+Result
+
+```text
+"  string  "
+```
+
 ## Values format settings {#values-format-settings}
 
 ### input_format_values_interpret_expressions {#input_format_values_interpret_expressions}
diff --git a/docs/ru/interfaces/formats.md b/docs/ru/interfaces/formats.md
index bef5c223281..48a6132170a 100644
--- a/docs/ru/interfaces/formats.md
+++ b/docs/ru/interfaces/formats.md
@@ -387,6 +387,23 @@ $ clickhouse-client --format_csv_delimiter="|" --query="INSERT INTO test.csv FOR
 
 Формат CSV поддерживает вывод totals и extremes аналогично `TabSeparated`.
 
+
+### CSV опции форматирования {#csv-format-settings}
+
+- [format_csv_delimiter](../operations/settings/settings.md#format_csv_delimiter) - символ, который будет считаться разделителем в CSV данных. Значение по умолчанию - `,`.
+- [format_csv_allow_single_quotes](../operations/settings/settings.md#format_csv_allow_single_quotes) - разрешить строки в одинарных кавычках. Значение по умолчанию - `true`.
+- [format_csv_allow_double_quotes](../operations/settings/settings.md#format_csv_allow_double_quotes) - разрешить строки в двойных кавычках. Значение по умолчанию - `true`.
+- [format_csv_null_representation](../operations/settings/settings.md#format_tsv_null_representation) - пользовательское представление NULL в формате CSV. Значение по умолчанию - `\N`.
+- [input_format_csv_empty_as_default](../operations/settings/settings.md#input_format_csv_empty_as_default) - рассматривать пустые поля в CSV в качестве значений по умолчанию. Значение по умолчанию - `true`. Для сложных выражений по умолчанию необходимо также включить [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#input_format_defaults_for_omitted_fields).
+- [input_format_csv_enum_as_number](../operations/settings/settings.md#input_format_csv_enum_as_number) - рассматривать вставленные значения enum в форматах CSV как индексы enum. Значение по умолчанию - `false`.
+- [input_format_csv_use_best_effort_in_schema_inference](../operations/settings/settings.md#input_format_csv_use_best_effort_in_schema_inference) - использовать некоторые твики и эвристики для вывода схемы в формате CSV. Если параметр отключен, все поля будут определяться как строки. Значение по умолчанию - `true`.
+- [input_format_csv_arrays_as_nested_csv](../operations/settings/settings.md#input_format_csv_arrays_as_nested_csv) - при чтении массива из CSV ожидать, что его элементы были сериализованы во вложенный CSV и затем помещены в строку. Значение по умолчанию - `false`.
+- [output_format_csv_crlf_end_of_line](../operations/settings/settings.md#output_format_csv_crlf_end_of_line) - если установлено значение true, конец строки в формате вывода CSV будет `\r\n` вместо `\n`. Значение по умолчанию - `false`.
+- [input_format_csv_skip_first_lines](../operations/settings/settings.md#input_format_csv_skip_first_lines) - пропустить указанное количество строк в начале данных. Значение по умолчанию - `0`.
+- [input_format_csv_detect_header](../operations/settings/settings.md#input_format_csv_detect_header) - обнаружить заголовок с именами и типами в формате CSV. Значение по умолчанию - `true`.
+- [input_format_csv_trim_whitespaces](../operations/settings/settings.md#input_format_csv_trim_whitespaces) - удалить пробелы и символы табуляции из строк без кавычек.
+Значение по умолчанию - `true`.
+
 ## CSVWithNames {#csvwithnames}
 
 Выводит также заголовок, аналогично [TabSeparatedWithNames](#tabseparatedwithnames).
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index fa3ea582c55..e9b7091c8b8 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -1589,6 +1589,24 @@ SELECT area/period FROM account_orders FORMAT JSON;
 
 Символ, интерпретируемый как разделитель в данных формата CSV. По умолчанию — `,`.
 
+## format_csv_allow_double_quotes {#format_csv_allow_double_quotes}
+
+Если установлено значение true, разрешить строки в двойных кавычках.
+
+Включено по умолчанию.
+
+## input_format_csv_empty_as_default {#input_format_csv_empty_as_default}
+
+Если включено, заменяет пустые поля ввода в CSV значениями по умолчанию. Для сложных выражений по умолчанию `input_format_defaults_for_omitted_fields` также должен быть включен.
+
+Включено по умолчанию.
+
+## input_format_csv_arrays_as_nested_csv {#input_format_csv_arrays_as_nested_csv}
+
+При чтении массива из CSV ожидайте, что его элементы были сериализованы во вложенный CSV, а затем помещены в строку. Пример: "[""Hello"", ""world"", ""42"""" TV""]". Скобки вокруг массива могут быть опущены.
+
+По умолчанию отключены.
+
 ## input_format_csv_unquoted_null_literal_as_null {#settings-input_format_csv_unquoted_null_literal_as_null}
 
 Для формата CSV включает или выключает парсинг неэкранированной строки `NULL` как литерала (синоним для `\N`)
@@ -1665,6 +1683,50 @@ SELECT * FROM table_with_enum_column_for_csv_insert;
 
 Использовать в качестве разделителя строк для CSV формата CRLF (DOS/Windows стиль) вместо LF (Unix стиль).
 
+## input_format_csv_detect_header {#input_format_csv_detect_header}
+
+Обнаружить заголовок с именами и типами в формате CSV.
+ 
+Значение по умолчанию - `true`.
+
+## input_format_csv_skip_first_lines {#input_format_csv_skip_first_lines}
+
+Количество строк, пропускаемых в начале данных в формате ввода CSV.
+
+Значение по умолчанию: `0`.
+
+## input_format_csv_trim_whitespaces {#input_format_csv_trim_whitespaces}
+
+Удалить пробелы и символы табуляции из строк без кавычек.
+
+Значение по умолчанию: `true`.
+
+**Примеры**
+
+Запрос
+
+```bash
+echo '  string  ' |./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
+```
+
+Результат
+
+```text
+"string"
+```
+
+Запрос
+
+```bash
+echo '  string  ' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=false
+```
+
+Результат
+
+```text
+"  string  "
+```
+
 ## output_format_tsv_crlf_end_of_line {#settings-output-format-tsv-crlf-end-of-line}
 
 Использовать в качестве разделителя строк для TSV формата CRLF (DOC/Windows стиль) вместо LF (Unix стиль).
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 1df0a8af24f..750b6e16c4b 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -844,6 +844,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_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) \
     M(Bool, input_format_parquet_skip_columns_with_unsupported_types_in_schema_inference, false, "Skip columns with unsupported types while schema inference for format Parquet", 0) \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index dd6252b96f1..ada8751545c 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.trim_whitespaces = settings.input_format_csv_trim_whitespaces;
     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 c88af650671..3ae579cd552 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 trim_whitespaces = true;
     } csv;
 
     struct HiveText
diff --git a/src/IO/ReadHelpers.cpp b/src/IO/ReadHelpers.cpp
index 99d25ee6613..8dc05e75855 100644
--- a/src/IO/ReadHelpers.cpp
+++ b/src/IO/ReadHelpers.cpp
@@ -849,15 +849,18 @@ void readCSVStringInto(Vector & s, ReadBuffer & buf, const FormatSettings::CSV &
 
             if constexpr (WithResize<Vector>)
             {
-                /** CSV format can contain insignificant spaces and tabs.
-                * Usually the task of skipping them is for the calling code.
-                * But in this case, it will be difficult to do this, so remove the trailing whitespace by ourself.
-                */
-                size_t size = s.size();
-                while (size > 0 && (s[size - 1] == ' ' || s[size - 1] == '\t'))
-                    --size;
+                if (settings.trim_whitespaces) [[likely]]
+                {
+                    /** CSV format can contain insignificant spaces and tabs.
+                    * Usually the task of skipping them is for the calling code.
+                    * But in this case, it will be difficult to do this, so remove the trailing whitespace by ourself.
+                    */
+                    size_t size = s.size();
+                    while (size > 0 && (s[size - 1] == ' ' || s[size - 1] == '\t'))
+                        --size;
 
-                s.resize(size);
+                    s.resize(size);
+                }
             }
             return;
         }
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index de955d81651..9922bd41442 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -10,6 +10,7 @@
 #include <Processors/Formats/Impl/CSVRowInputFormat.h>
 #include <DataTypes/Serializations/SerializationNullable.h>
 #include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypeNullable.h>
 
 
 namespace DB
@@ -152,7 +153,9 @@ void CSVFormatReader::skipFieldDelimiter()
 template <bool read_string>
 String CSVFormatReader::readCSVFieldIntoString()
 {
-    skipWhitespacesAndTabs(*buf);
+    if (format_settings.csv.trim_whitespaces) [[likely]]
+        skipWhitespacesAndTabs(*buf);
+
     String field;
     if constexpr (read_string)
         readCSVString(field, *buf, format_settings.csv);
@@ -200,7 +203,6 @@ void CSVFormatReader::skipHeaderRow()
 template <bool is_header>
 std::vector<String> CSVFormatReader::readRowImpl()
 {
-
     std::vector<String> fields;
     do
     {
@@ -280,7 +282,16 @@ bool CSVFormatReader::readField(
     bool is_last_file_column,
     const String & /*column_name*/)
 {
-    skipWhitespacesAndTabs(*buf);
+    if (format_settings.csv.trim_whitespaces) [[likely]]
+        skipWhitespacesAndTabs(*buf);
+    else if (type->isNullable())
+    {
+        auto nested_type = typeid_cast<const DataTypeNullable *>(type.get())->getNestedType();
+        if (!isStringOrFixedString(nested_type))
+            skipWhitespacesAndTabs(*buf);
+    }
+    else if (!isStringOrFixedString(type))
+        skipWhitespacesAndTabs(*buf);
 
     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/02764_csv_trim_whitespaces.reference b/tests/queries/0_stateless/02764_csv_trim_whitespaces.reference
new file mode 100644
index 00000000000..a2ea31ddae7
--- /dev/null
+++ b/tests/queries/0_stateless/02764_csv_trim_whitespaces.reference
@@ -0,0 +1,122 @@
+"	trim_false_tab_left"
+"trim_false_tab_right	"
+"trim_false_	tab_middle"
+"	trim_false_	tab_everywhere	"
+"	trim_false_fixed_string_	tab_everywhere	"
+"	quoted_trim_false_	tab_everywhere	"
+"	trim_false_csv_field1	","123	","5.0	","	12.0123","	quoted_string1"
+"	trim_false_csv_field2	","	321	","	0.5","21.321	","	quoted_	string2	"
+"	trim_false_csv_field1_with_	structure	",123,5,12.0123,"	quoted_string	"
+"	trim_false_csv_field2_with_structure	",321,0.5,21.321,"	quoted_	_string2	"
+" trim_false_space_left"
+"trim_false_space_right "
+"trim_false_ space_middle"
+" trim_false_ space_everywhere "
+" trim_false_fixed_string_ space_everywhere "
+" quoted_trim_false_ space_everywhere "
+" trim_false_csv_field1 ","123 ","5.0 "," 12.0123"," quoted_string1"
+" trim_false_csv_field2 "," 321 "," 0.5","21.321 "," quoted_ string2 "
+" trim_false_csv_field1_with_ structure ",123,5,12.0123," quoted_string "
+" trim_false_csv_field2_with_structure ",321,0.5,21.321," quoted_ _string2 "
+"	 trim_false_tab_space_left"
+"trim_false_tab_space_right	 "
+"trim_false_	 tab_space_middle"
+"	 trim_false_	 tab_space_everywhere	 "
+"	 trim_false_fixed_string_	 tab_space_everywhere	 "
+"	 quoted_trim_false_	 tab_space_everywhere	 "
+"	 trim_false_csv_field1	 ","123	 ","5.0	 ","	 12.0123","	 quoted_string1"
+"	 trim_false_csv_field2	 ","	 321	 ","	 0.5","21.321	 ","	 quoted_	 string2	 "
+"	 trim_false_csv_field1_with_	 structure	 ",123,5,12.0123,"	 quoted_string	 "
+"	 trim_false_csv_field2_with_structure	 ",321,0.5,21.321,"	 quoted_	 _string2	 "
+8
+8
+16
+16
+32.32
+32.32
+64.64
+64.64
+"2023-05-22"
+"2023-05-22"
+"2023-05-22"
+"2023-05-22"
+"2023-05-22 00:00:00"
+"2023-05-22 00:00:00"
+"2023-05-22 00:00:00.000"
+"2023-05-22 00:00:00.000"
+"trim_true_tab_left"
+"trim_true_tab_right"
+"trim_true_	tab_middle"
+"trim_true_	tab_everywhere"
+"trim_true_fixed_string_	tab_everywhere"
+"	quoted_trim_true_	tab_everywhere	"
+"trim_true_csv_field1",123,5,12.0123,"	quoted_string1"
+"trim_true_csv_field2",321,0.5,21.321,"	quoted_	string2	"
+"trim_true_csv_field1_with_	structure",123,5,12.0123,"	quoted_string	"
+"trim_true_csv_field2_with_structure",321,0.5,21.321,"	quoted_	_string2	"
+"trim_true_space_left"
+"trim_true_space_right"
+"trim_true_ space_middle"
+"trim_true_ space_everywhere"
+"trim_true_fixed_string_ space_everywhere"
+" quoted_trim_true_ space_everywhere "
+"trim_true_csv_field1",123,5,12.0123," quoted_string1"
+"trim_true_csv_field2",321,0.5,21.321," quoted_ string2 "
+"trim_true_csv_field1_with_ structure",123,5,12.0123," quoted_string "
+"trim_true_csv_field2_with_structure",321,0.5,21.321," quoted_ _string2 "
+"trim_true_tab_space_left"
+"trim_true_tab_space_right"
+"trim_true_	 tab_space_middle"
+"trim_true_	 tab_space_everywhere"
+"trim_true_fixed_string_	 tab_space_everywhere"
+"	 quoted_trim_true_	 tab_space_everywhere	 "
+"trim_true_csv_field1",123,5,12.0123,"	 quoted_string1"
+"trim_true_csv_field2",321,0.5,21.321,"	 quoted_	 string2	 "
+"trim_true_csv_field1_with_	 structure",123,5,12.0123,"	 quoted_string	 "
+"trim_true_csv_field2_with_structure",321,0.5,21.321,"	 quoted_	 _string2	 "
+8
+8
+16
+16
+32.32
+32.32
+64.64
+64.64
+"2023-05-22"
+"2023-05-22"
+"2023-05-22"
+"2023-05-22"
+"2023-05-22 00:00:00"
+"2023-05-22 00:00:00"
+"2023-05-22 00:00:00.000"
+"2023-05-22 00:00:00.000"
+"	custom_csv_tab_left"
+"custom_csv_tab_right	"
+"custom_csv_	tab_middle"
+"	custom_csv_	tab_everywhere	"
+"	custom_csv_fixed_string_	tab_everywhere	"
+"	quoted_custom_csv_	tab_everywhere	"
+"	custom_csv_field_with_	structure	",123,5,12.0123,"	custom_csv_quoted_string	"
+"	custom_csv_field2_with_structure	",321,0.5,21.321,"	custom_csv_quoted_	_string2	"
+"	custom_csv_field_with_	structure	",123,5,12.0123,"	custom_csv_quoted_string	"
+"	custom_csv_field2_with_structure	",321,0.5,21.321,"	custom_csv_quoted_	_string2	"
+" custom_csv_space_left"
+"custom_csv_space_right "
+"custom_csv_ space_middle"
+" custom_csv_ space_everywhere "
+" custom_csv_fixed_string_ space_everywhere "
+" quoted_custom_csv_ space_everywhere "
+" custom_csv_field_with_ structure ",123,5,12.0123," custom_csv_quoted_string "
+" custom_csv_field2_with_structure ",321,0.5,21.321," custom_csv_quoted_ _string2 "
+" custom_csv_field_with_ structure ",123,5,12.0123," custom_csv_quoted_string "
+" custom_csv_field2_with_structure ",321,0.5,21.321," custom_csv_quoted_ _string2 "
+"	 custom_csv_tab_space_left"
+"custom_csv_tab_space_right	 "
+"custom_csv_	 tab_space_middle"
+"	 custom_csv_	 tab_space_everywhere	 "
+"	 custom_csv_fixed_string_	 tab_space_everywhere	 "
+"	 quoted_custom_csv_	 tab_space_everywhere	 "
+"	 custom_csv_field_with_	 structure	 ",123,5,12.0123,"	 custom_csv_quoted_string	 "
+"	 custom_csv_field2_with_structure	 ",321,0.5,21.321,"	 custom_csv_quoted_	 _string2	 "
+"	 custom_csv_field_with_	 structure	 ",123,5,12.0123,"	 custom_csv_quoted_string	 "
+"	 custom_csv_field2_with_structure	 ",321,0.5,21.321,"	 custom_csv_quoted_	 _string2	 "
diff --git a/tests/queries/0_stateless/02764_csv_trim_whitespaces.sh b/tests/queries/0_stateless/02764_csv_trim_whitespaces.sh
new file mode 100755
index 00000000000..9b3b7231f6e
--- /dev/null
+++ b/tests/queries/0_stateless/02764_csv_trim_whitespaces.sh
@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+BOOLS=('false' 'true')
+
+WHITESPACES=(      '\t'  ' '      '\t ')
+WHITESPACES_NAMES=('tab' 'space'  'tab_space')
+
+DATA_TYPES=(  'Int8'  'Int16' 'Float32' 'Float64'  'Date'        'Date32'        'DateTime'              'DateTime64')
+DATA_VALUES=( '8'     '16'    '32.32'   '64.64'    '2023-05-22'  '2023-05-22'    '2023-05-22 00:00:00'   '2023-05-22 00:00:00.000')
+
+for trim in "${BOOLS[@]}"
+do
+    for wsIndex in "${!WHITESPACES[@]}";
+    do
+        whitespace=${WHITESPACES[$wsIndex]}
+        whitespace_name=${WHITESPACES_NAMES[$wsIndex]}
+        echo -e "${whitespace}trim_${trim}_${whitespace_name}_left"                                              | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "trim_${trim}_${whitespace_name}_right${whitespace}"                                             | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "trim_${trim}_${whitespace}${whitespace_name}_middle"                                            | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "${whitespace}trim_${trim}_${whitespace}${whitespace_name}_everywhere${whitespace}"              | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "${whitespace}trim_${trim}_fixed_string_${whitespace}${whitespace_name}_everywhere${whitespace}" | $CLICKHOUSE_LOCAL -S "c1 FixedString(64)" --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select toString(c1) from table FORMAT CSV"
+        echo -e "\"${whitespace}quoted_trim_${trim}_${whitespace}${whitespace_name}_everywhere${whitespace}\""   | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "${whitespace}trim_${trim}_csv_field1${whitespace},123${whitespace},5.0${whitespace},${whitespace}12.0123,\"${whitespace}quoted_string1\"\n${whitespace}trim_${trim}_csv_field2${whitespace},${whitespace}321${whitespace},${whitespace}0.5,21.321${whitespace},\"${whitespace}quoted_${whitespace}string2${whitespace}\"${whitespace}" | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+        echo -e "${whitespace}trim_${trim}_csv_field1_with_${whitespace}structure${whitespace},${whitespace}123,${whitespace}5.0${whitespace},12.0123${whitespace},\"${whitespace}quoted_string${whitespace}\"\n${whitespace}trim_${trim}_csv_field2_with_structure${whitespace},${whitespace}321${whitespace},0.5,21.321,\"${whitespace}quoted_${whitespace}_string2${whitespace}\"${whitespace}" | $CLICKHOUSE_LOCAL -S "c1 String, c2 Int32, c3 Float, c4 Double, c5 String" --input_format_csv_trim_whitespaces=${trim} --input-format="CSV" -q "select * from table FORMAT CSV"
+    done
+
+    for type_index in "${!DATA_TYPES[@]}";
+    do
+        type=${DATA_TYPES[$type_index]}
+        value=${DATA_VALUES[$type_index]}
+        echo -e "\t ${value} \t" | $CLICKHOUSE_LOCAL -S "c1 ${type}" --input-format="CSV" --input_format_csv_trim_whitespaces=${trim} -q "select * from table FORMAT CSV"
+        echo -e "\t ${value} \t" | $CLICKHOUSE_LOCAL -S "c1 Nullable(${type})" --input-format="CSV" --input_format_csv_trim_whitespaces=${trim} -q "select * from table FORMAT CSV"
+    done
+done
+
+## Custom CSV tested with input_format_csv_trim_whitespaces = false.
+## Custom CSV with input_format_csv_trim_whitespaces=true doesn't trim whitespaces from the left side at the moment
+for wsIndex in "${!WHITESPACES[@]}";
+do
+    whitespace=${WHITESPACES[$wsIndex]}
+    whitespace_name=${WHITESPACES_NAMES[$wsIndex]}
+    echo -e "${whitespace}custom_csv_${whitespace_name}_left"                                               | $CLICKHOUSE_LOCAL --input-format="CustomSeparated" --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+    echo -e "custom_csv_${whitespace_name}_right${whitespace}"                                              | $CLICKHOUSE_LOCAL --input-format="CustomSeparated" --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+    echo -e "custom_csv_${whitespace}${whitespace_name}_middle"                                             | $CLICKHOUSE_LOCAL --input-format="CustomSeparated" --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+    echo -e "${whitespace}custom_csv_${whitespace}${whitespace_name}_everywhere${whitespace}"               | $CLICKHOUSE_LOCAL --input-format="CustomSeparated" --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+    echo -e "${whitespace}custom_csv_fixed_string_${whitespace}${whitespace_name}_everywhere${whitespace}"  | $CLICKHOUSE_LOCAL -S "c1 FixedString(64)" --input-format="CustomSeparated"  --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select toString(c1) from table FORMAT CSV"
+    echo -e "\"${whitespace}quoted_custom_csv_${whitespace}${whitespace_name}_everywhere${whitespace}\""    | $CLICKHOUSE_LOCAL --input-format="CustomSeparated" --input_format_csv_trim_whitespaces=false --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+
+    echo -e "${whitespace}custom_csv_field_with_${whitespace}structure${whitespace},123,5.0,12.0123,\"${whitespace}custom_csv_quoted_string${whitespace}\"\n${whitespace}custom_csv_field2_with_structure${whitespace},321,0.5,21.321,\"${whitespace}custom_csv_quoted_${whitespace}_string2${whitespace}\"" | $CLICKHOUSE_LOCAL --input_format_csv_trim_whitespaces=false --input-format="CustomSeparated" --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+    echo -e "${whitespace}custom_csv_field_with_${whitespace}structure${whitespace},123,5.0,12.0123,\"${whitespace}custom_csv_quoted_string${whitespace}\"\n${whitespace}custom_csv_field2_with_structure${whitespace},321,0.5,21.321,\"${whitespace}custom_csv_quoted_${whitespace}_string2${whitespace}\"" | $CLICKHOUSE_LOCAL -S "c1 String, c2 Int32, c3 Float, c4 Double, c5 String" --input_format_csv_trim_whitespaces=false --input-format="CustomSeparated" --format_custom_escaping_rule=CSV --format_custom_field_delimiter=',' --format_csv_delimiter=',' -q "select * from table FORMAT CSV"
+done

From 4eb944fef11dacc95873f9e5de9949c381d4dc79 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Thu, 25 May 2023 08:05:11 +0000
Subject: [PATCH 0151/1478] minor changes in documentation

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

diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index cb7d98a4876..1db1b5066c3 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -893,7 +893,7 @@ Default value: `true`.
 Query
 
 ```bash
-echo '  string  ' |./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
+echo '  string  ' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
 ```
 
 Result
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index e9b7091c8b8..4c2117b2b87 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -1706,7 +1706,7 @@ SELECT * FROM table_with_enum_column_for_csv_insert;
 Запрос
 
 ```bash
-echo '  string  ' |./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
+echo '  string  ' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_trim_whitespaces=true
 ```
 
 Результат

From 7e68f61df1671b0be0b30c8cef33f34c8c971d3b Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 25 May 2023 08:43:11 +0000
Subject: [PATCH 0152/1478] Fix snapshot recovery

---
 programs/keeper-converter/KeeperConverter.cpp |  4 +-
 programs/server/config.d/users.xml            | 26 -----
 src/Coordination/FourLetterCommand.cpp        |  1 +
 src/Coordination/KeeperContext.cpp            | 35 ++++++-
 src/Coordination/KeeperContext.h              |  4 +
 src/Coordination/KeeperDiskSelector.h         | 37 --------
 src/Coordination/KeeperDispatcher.cpp         | 11 ++-
 src/Coordination/KeeperDispatcher.h           |  7 ++
 src/Coordination/KeeperServer.cpp             |  4 +-
 src/Coordination/KeeperServer.h               |  2 +-
 src/Coordination/KeeperSnapshotManager.cpp    | 20 +---
 src/Coordination/KeeperSnapshotManager.h      | 21 ++--
 src/Coordination/KeeperSnapshotManagerS3.cpp  | 24 ++---
 src/Coordination/KeeperSnapshotManagerS3.h    |  8 +-
 src/Coordination/KeeperStateMachine.cpp       | 95 ++++++++++++++-----
 src/Coordination/KeeperStateMachine.h         |  2 +-
 .../test_keeper_four_word_command/test.py     |  2 +
 17 files changed, 165 insertions(+), 138 deletions(-)
 delete mode 100644 programs/server/config.d/users.xml
 delete mode 100644 src/Coordination/KeeperDiskSelector.h

diff --git a/programs/keeper-converter/KeeperConverter.cpp b/programs/keeper-converter/KeeperConverter.cpp
index f2389021cb6..a049e6bc2b3 100644
--- a/programs/keeper-converter/KeeperConverter.cpp
+++ b/programs/keeper-converter/KeeperConverter.cpp
@@ -55,8 +55,8 @@ int mainEntryClickHouseKeeperConverter(int argc, char ** argv)
 
         DB::KeeperSnapshotManager manager(1, keeper_context);
         auto snp = manager.serializeSnapshotToBuffer(snapshot);
-        auto path = manager.serializeSnapshotBufferToDisk(*snp, storage.getZXID());
-        std::cout << "Snapshot serialized to path:" << path << std::endl;
+        auto file_info = manager.serializeSnapshotBufferToDisk(*snp, storage.getZXID());
+        std::cout << "Snapshot serialized to path:" << fs::path(file_info.disk->getPath()) / file_info.path << std::endl;
     }
     catch (...)
     {
diff --git a/programs/server/config.d/users.xml b/programs/server/config.d/users.xml
deleted file mode 100644
index d8a62b45baa..00000000000
--- a/programs/server/config.d/users.xml
+++ /dev/null
@@ -1,26 +0,0 @@
-<clickhouse>
-    <profiles>
-        <default>
-            <max_memory_usage>10000000000</max_memory_usage>
-            <force_index_by_date>0</force_index_by_date>
-            <replication_alter_partitions_sync>2</replication_alter_partitions_sync>
-            <constraints>
-                <max_memory_usage>
-                    <min>5000000000</min>
-                    <max>20000000000</max>
-                </max_memory_usage>
-               <force_index_by_date>
-                   <readonly/>
-               </force_index_by_date>
-               <replication_alter_partitions_sync>
-                   <readonly/>
-               </replication_alter_partitions_sync>
-            </constraints>
-        </default>
-    </profiles>
-    <users>
-        <readonly>
-            <profile>default</profile>
-        </readonly>
-    </users>
-</clickhouse>
diff --git a/src/Coordination/FourLetterCommand.cpp b/src/Coordination/FourLetterCommand.cpp
index 7077e792fd8..b7419bcaccc 100644
--- a/src/Coordination/FourLetterCommand.cpp
+++ b/src/Coordination/FourLetterCommand.cpp
@@ -292,6 +292,7 @@ String ConfCommand::run()
 
     StringBuffer buf;
     keeper_dispatcher.getKeeperConfigurationAndSettings()->dump(buf);
+    keeper_dispatcher.getKeeperContext()->dumpConfiguration(buf);
     return buf.str();
 }
 
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index e27cfc60cff..da49868f706 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -122,6 +122,35 @@ void KeeperContext::setStateFileDisk(DiskPtr disk)
     state_file_storage = std::move(disk);
 }
 
+void KeeperContext::dumpConfiguration(WriteBufferFromOwnString & buf) const
+{
+    auto dump_disk_info = [&](const std::string_view prefix, const IDisk & disk)
+    {
+        writeText(fmt::format("{}_path=", prefix), buf);
+        writeText(disk.getPath(), buf);
+        buf.write('\n');
+
+        writeText(fmt::format("{}_disk=", prefix), buf);
+        writeText(disk.getName(), buf);
+        buf.write('\n');
+
+    };
+
+    {
+        auto log_disk = getDisk(log_storage);
+        dump_disk_info("log_storage", *log_disk);
+
+        auto current_log_disk = getDisk(current_log_storage);
+        if (log_disk != current_log_disk)
+            dump_disk_info("current_log_storage", *current_log_disk);
+    }
+
+    {
+        auto snapshot_disk = getDisk(snapshot_storage);
+        dump_disk_info("snapshot_storage", *snapshot_disk);
+    }
+}
+
 KeeperContext::Storage KeeperContext::getLogsPathFromConfig(const Poco::Util::AbstractConfiguration & config) const
 {
     const auto create_local_disk = [](const auto & path)
@@ -129,7 +158,7 @@ KeeperContext::Storage KeeperContext::getLogsPathFromConfig(const Poco::Util::Ab
         if (!fs::exists(path))
             fs::create_directories(path);
 
-        return std::make_shared<DiskLocal>("LogDisk", path, 0);
+        return std::make_shared<DiskLocal>("LocalLogDisk", path, 0);
     };
 
     /// the most specialized path
@@ -155,7 +184,7 @@ KeeperContext::Storage KeeperContext::getSnapshotsPathFromConfig(const Poco::Uti
         if (!fs::exists(path))
             fs::create_directories(path);
 
-        return std::make_shared<DiskLocal>("SnapshotDisk", path, 0);
+        return std::make_shared<DiskLocal>("LocalSnapshotDisk", path, 0);
     };
 
     /// the most specialized path
@@ -181,7 +210,7 @@ KeeperContext::Storage KeeperContext::getStatePathFromConfig(const Poco::Util::A
         if (!fs::exists(path))
             fs::create_directories(path);
 
-        return std::make_shared<DiskLocal>("SnapshotDisk", path, 0);
+        return std::make_shared<DiskLocal>("LocalStateFileDisk", path, 0);
     };
 
     if (config.has("keeper_server.state_storage_disk"))
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index e04d1cd6b3d..6b7af3a60db 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -2,6 +2,8 @@
 
 #include <Poco/Util/AbstractConfiguration.h>
 
+#include <IO/WriteBufferFromString.h>
+
 #include <Disks/DiskSelector.h>
 
 #include <cstdint>
@@ -42,6 +44,8 @@ public:
 
     DiskPtr getStateFileDisk() const;
     void setStateFileDisk(DiskPtr disk);
+
+    void dumpConfiguration(WriteBufferFromOwnString & buf) const;
 private:
     /// local disk defined using path or disk name
     using Storage = std::variant<DiskPtr, std::string>;
diff --git a/src/Coordination/KeeperDiskSelector.h b/src/Coordination/KeeperDiskSelector.h
deleted file mode 100644
index fa78fec1952..00000000000
--- a/src/Coordination/KeeperDiskSelector.h
+++ /dev/null
@@ -1,37 +0,0 @@
-#pragma once
-
-#include <Disks/DiskSelector.h>
-#include <Poco/Util/AbstractConfiguration.h>
-
-namespace DB
-{
-
-class KeeperDiskSelector
-{
-public:
-    void initialize(const Poco::Util::AbstractConfiguration & config, const String & config_prefix, ContextPtr context);
-
-    DiskSelectorPtr updateFromConfig(
-        const Poco::Util::AbstractConfiguration & config,
-        const String & config_prefix,
-        ContextPtr context) const;
-
-    /// Get disk by name
-    DiskPtr get(const String & name) const;
-
-    DiskPtr tryGet(const String & name) const;
-
-    /// Get all disks with names
-    const DisksMap & getDisksMap() const;
-
-    void shutdown();
-
-private:
-    mutable std::mutex disk_selector_mutex;
-    DiskSelectorPtr disk_selector;
-};
-
-using KeeperDiskSelectorPtr = std::shared_ptr<KeeperDiskSelector>;
-
-
-}
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index 17a15067301..4a460777621 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -238,13 +238,13 @@ void KeeperDispatcher::snapshotThread()
 
         try
         {
-            auto snapshot_path = task.create_snapshot(std::move(task.snapshot));
+            auto snapshot_file_info = task.create_snapshot(std::move(task.snapshot));
 
-            if (snapshot_path.empty())
+            if (snapshot_file_info.path.empty())
                 continue;
 
             if (isLeader())
-                snapshot_s3.uploadSnapshot(snapshot_path);
+                snapshot_s3.uploadSnapshot(snapshot_file_info);
         }
         catch (...)
         {
@@ -336,12 +336,15 @@ void KeeperDispatcher::initialize(const Poco::Util::AbstractConfiguration & conf
 
     snapshot_s3.startup(config, macros);
 
+    keeper_context = std::make_shared<KeeperContext>(standalone_keeper);
+    keeper_context->initialize(config);
+
     server = std::make_unique<KeeperServer>(
         configuration_and_settings,
         config,
         responses_queue,
         snapshots_queue,
-        standalone_keeper,
+        keeper_context,
         snapshot_s3,
         [this](const KeeperStorage::RequestForSession & request_for_session)
         {
diff --git a/src/Coordination/KeeperDispatcher.h b/src/Coordination/KeeperDispatcher.h
index 4b8b134cf8f..1b44f0f6ced 100644
--- a/src/Coordination/KeeperDispatcher.h
+++ b/src/Coordination/KeeperDispatcher.h
@@ -81,6 +81,8 @@ private:
 
     KeeperSnapshotManagerS3 snapshot_s3;
 
+    KeeperContextPtr keeper_context;
+
     /// Thread put requests to raft
     void requestThread();
     /// Thread put responses for subscribed sessions
@@ -198,6 +200,11 @@ public:
         return configuration_and_settings;
     }
 
+    const KeeperContextPtr & getKeeperContext() const
+    {
+        return keeper_context;
+    }
+
     void incrementPacketsSent()
     {
         keeper_stats.incrementPacketsSent();
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 31c91e2de80..989455a5a79 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -108,14 +108,14 @@ KeeperServer::KeeperServer(
     const Poco::Util::AbstractConfiguration & config,
     ResponsesQueue & responses_queue_,
     SnapshotsQueue & snapshots_queue_,
-    bool standalone_keeper,
+    KeeperContextPtr keeper_context_,
     KeeperSnapshotManagerS3 & snapshot_manager_s3,
     KeeperStateMachine::CommitCallback commit_callback)
     : server_id(configuration_and_settings_->server_id)
     , coordination_settings(configuration_and_settings_->coordination_settings)
     , log(&Poco::Logger::get("KeeperServer"))
     , is_recovering(config.getBool("keeper_server.force_recovery", false))
-    , keeper_context{std::make_shared<KeeperContext>(standalone_keeper)}
+    , keeper_context{std::move(keeper_context_)}
     , create_snapshot_on_exit(config.getBool("keeper_server.create_snapshot_on_exit", true))
 {
     if (coordination_settings->quorum_reads)
diff --git a/src/Coordination/KeeperServer.h b/src/Coordination/KeeperServer.h
index 63f9cc2bcea..8f416b1f48c 100644
--- a/src/Coordination/KeeperServer.h
+++ b/src/Coordination/KeeperServer.h
@@ -72,7 +72,7 @@ public:
         const Poco::Util::AbstractConfiguration & config_,
         ResponsesQueue & responses_queue_,
         SnapshotsQueue & snapshots_queue_,
-        bool standalone_keeper,
+        KeeperContextPtr keeper_context_,
         KeeperSnapshotManagerS3 & snapshot_manager_s3,
         KeeperStateMachine::CommitCallback commit_callback);
 
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 7f097c182a1..3bfe700bcd5 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -563,7 +563,7 @@ KeeperSnapshotManager::KeeperSnapshotManager(
 }
 
 
-std::string KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx)
+SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx)
 {
     ReadBufferFromNuraftBuffer reader(buffer);
 
@@ -585,7 +585,7 @@ std::string KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer
     existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
     removeOutdatedSnapshotsIfNeeded();
 
-    return snapshot_file_name;
+    return {snapshot_file_name, disk};
 }
 
 nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBufferFromDisk()
@@ -694,7 +694,7 @@ void KeeperSnapshotManager::removeSnapshot(uint64_t log_idx)
     existing_snapshots.erase(itr);
 }
 
-std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStorageSnapshot & snapshot)
+SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStorageSnapshot & snapshot)
 {
     auto up_to_log_idx = snapshot.snapshot_meta->get_last_log_idx();
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
@@ -716,22 +716,12 @@ std::pair<std::string, std::error_code> KeeperSnapshotManager::serializeSnapshot
     compressed_writer->finalize();
     compressed_writer->sync();
 
-    std::error_code ec;
-
-    try
-    {
-        disk->removeFile(tmp_snapshot_file_name);
-    }
-    catch (fs::filesystem_error & e)
-    {
-        ec = e.code();
-        return {snapshot_file_name, ec};
-    }
+    disk->removeFile(tmp_snapshot_file_name);
 
     existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
     removeOutdatedSnapshotsIfNeeded();
 
-    return {snapshot_file_name, ec};
+    return {snapshot_file_name, disk};
 }
 
 }
diff --git a/src/Coordination/KeeperSnapshotManager.h b/src/Coordination/KeeperSnapshotManager.h
index 7b1129018d8..036c0cab62b 100644
--- a/src/Coordination/KeeperSnapshotManager.h
+++ b/src/Coordination/KeeperSnapshotManager.h
@@ -87,8 +87,14 @@ public:
     uint64_t nodes_digest;
 };
 
+struct SnapshotFileInfo
+{
+    std::string path;
+    DiskPtr disk;
+};
+
 using KeeperStorageSnapshotPtr = std::shared_ptr<KeeperStorageSnapshot>;
-using CreateSnapshotCallback = std::function<std::string(KeeperStorageSnapshotPtr &&)>;
+using CreateSnapshotCallback = std::function<SnapshotFileInfo(KeeperStorageSnapshotPtr &&)>;
 
 
 using SnapshotMetaAndStorage = std::pair<SnapshotMetadataPtr, KeeperStoragePtr>;
@@ -112,10 +118,10 @@ public:
     nuraft::ptr<nuraft::buffer> serializeSnapshotToBuffer(const KeeperStorageSnapshot & snapshot) const;
 
     /// Serialize already compressed snapshot to disk (return path)
-    std::string serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx);
+    SnapshotFileInfo serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx);
 
     /// Serialize snapshot directly to disk
-    std::pair<std::string, std::error_code> serializeSnapshotToDisk(const KeeperStorageSnapshot & snapshot);
+    SnapshotFileInfo serializeSnapshotToDisk(const KeeperStorageSnapshot & snapshot);
 
     SnapshotDeserializationResult deserializeSnapshotFromBuffer(nuraft::ptr<nuraft::buffer> buffer) const;
 
@@ -139,7 +145,7 @@ public:
         return 0;
     }
 
-    std::string getLatestSnapshotPath() const
+    SnapshotFileInfo getLatestSnapshotInfo() const
     {
         if (!existing_snapshots.empty())
         {
@@ -147,14 +153,15 @@ public:
 
             try
             {
-                if (getDisk()->exists(path))
-                    return path;
+                auto disk = getDisk();
+                if (disk->exists(path))
+                    return {path, disk};
             }
             catch (...)
             {
             }
         }
-        return "";
+        return {"", nullptr};
     }
 
 private:
diff --git a/src/Coordination/KeeperSnapshotManagerS3.cpp b/src/Coordination/KeeperSnapshotManagerS3.cpp
index 1afe0b352c5..580e166e302 100644
--- a/src/Coordination/KeeperSnapshotManagerS3.cpp
+++ b/src/Coordination/KeeperSnapshotManagerS3.cpp
@@ -132,8 +132,9 @@ std::shared_ptr<KeeperSnapshotManagerS3::S3Configuration> KeeperSnapshotManagerS
     return snapshot_s3_client;
 }
 
-void KeeperSnapshotManagerS3::uploadSnapshotImpl(const std::string & snapshot_path)
+void KeeperSnapshotManagerS3::uploadSnapshotImpl(const SnapshotFileInfo & snapshot_file_info)
 {
+    const auto & [snapshot_path, snapshot_disk] = snapshot_file_info;
     try
     {
         auto s3_client = getSnapshotS3Client();
@@ -154,8 +155,9 @@ void KeeperSnapshotManagerS3::uploadSnapshotImpl(const std::string & snapshot_pa
             };
         };
 
-        LOG_INFO(log, "Will try to upload snapshot on {} to S3", snapshot_path);
-        ReadBufferFromFile snapshot_file(snapshot_path);
+        LOG_INFO(log, "Will try to upload snapshot on {} to S3", snapshot_file_info.path);
+
+        auto snapshot_file = snapshot_disk->readFile(snapshot_file_info.path);
 
         auto snapshot_name = fs::path(snapshot_path).filename().string();
         auto lock_file = fmt::format(".{}_LOCK", snapshot_name);
@@ -222,7 +224,7 @@ void KeeperSnapshotManagerS3::uploadSnapshotImpl(const std::string & snapshot_pa
         });
 
         WriteBufferFromS3 snapshot_writer = create_writer(snapshot_name);
-        copyData(snapshot_file, snapshot_writer);
+        copyData(*snapshot_file, snapshot_writer);
         snapshot_writer.finalize();
 
         LOG_INFO(log, "Successfully uploaded {} to S3", snapshot_path);
@@ -240,31 +242,31 @@ void KeeperSnapshotManagerS3::snapshotS3Thread()
 
     while (!shutdown_called)
     {
-        std::string snapshot_path;
-        if (!snapshots_s3_queue.pop(snapshot_path))
+        SnapshotFileInfo snapshot_file_info;
+        if (!snapshots_s3_queue.pop(snapshot_file_info))
             break;
 
         if (shutdown_called)
             break;
 
-        uploadSnapshotImpl(snapshot_path);
+        uploadSnapshotImpl(snapshot_file_info);
     }
 }
 
-void KeeperSnapshotManagerS3::uploadSnapshot(const std::string & path, bool async_upload)
+void KeeperSnapshotManagerS3::uploadSnapshot(const SnapshotFileInfo & file_info, bool async_upload)
 {
     if (getSnapshotS3Client() == nullptr)
         return;
 
     if (async_upload)
     {
-        if (!snapshots_s3_queue.push(path))
-            LOG_WARNING(log, "Failed to add snapshot {} to S3 queue", path);
+        if (!snapshots_s3_queue.push(file_info))
+            LOG_WARNING(log, "Failed to add snapshot {} to S3 queue", file_info.path);
 
         return;
     }
 
-    uploadSnapshotImpl(path);
+    uploadSnapshotImpl(file_info);
 }
 
 void KeeperSnapshotManagerS3::startup(const Poco::Util::AbstractConfiguration & config, const MultiVersion<Macros>::Version & macros)
diff --git a/src/Coordination/KeeperSnapshotManagerS3.h b/src/Coordination/KeeperSnapshotManagerS3.h
index eff7868bba9..908deb76851 100644
--- a/src/Coordination/KeeperSnapshotManagerS3.h
+++ b/src/Coordination/KeeperSnapshotManagerS3.h
@@ -10,6 +10,8 @@
 #include <Common/ConcurrentBoundedQueue.h>
 #include <Common/ThreadPool.h>
 
+#include <Coordination/KeeperSnapshotManager.h>
+
 #include <string>
 #endif
 
@@ -24,13 +26,13 @@ public:
 
     /// 'macros' are used to substitute macros in endpoint of disks
     void updateS3Configuration(const Poco::Util::AbstractConfiguration & config, const MultiVersion<Macros>::Version & macros);
-    void uploadSnapshot(const std::string & path, bool async_upload = true);
+    void uploadSnapshot(const SnapshotFileInfo & file_info, bool async_upload = true);
 
     /// 'macros' are used to substitute macros in endpoint of disks
     void startup(const Poco::Util::AbstractConfiguration & config, const MultiVersion<Macros>::Version & macros);
     void shutdown();
 private:
-    using SnapshotS3Queue = ConcurrentBoundedQueue<std::string>;
+    using SnapshotS3Queue = ConcurrentBoundedQueue<SnapshotFileInfo>;
     SnapshotS3Queue snapshots_s3_queue;
 
     /// Upload new snapshots to S3
@@ -48,7 +50,7 @@ private:
 
     std::shared_ptr<S3Configuration> getSnapshotS3Client() const;
 
-    void uploadSnapshotImpl(const std::string & snapshot_path);
+    void uploadSnapshotImpl(const SnapshotFileInfo & snapshot_file_info);
 
     /// Thread upload snapshots to S3 in the background
     void snapshotS3Thread();
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 69c15db51da..49243541bc8 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -14,6 +14,8 @@
 #include <Common/logger_useful.h>
 #include "Coordination/KeeperStorage.h"
 
+#include <Disks/DiskLocal.h>
+
 
 namespace ProfileEvents
 {
@@ -66,6 +68,16 @@ KeeperStateMachine::KeeperStateMachine(
 {
 }
 
+namespace
+{
+
+bool isLocalDisk(const IDisk & disk)
+{
+    return dynamic_cast<const DiskLocal *>(&disk) != nullptr;
+}
+
+}
+
 void KeeperStateMachine::init()
 {
     /// Do everything without mutexes, no other threads exist.
@@ -80,9 +92,13 @@ void KeeperStateMachine::init()
 
         try
         {
-            auto snapshot_deserialization_result
-                = snapshot_manager.deserializeSnapshotFromBuffer(snapshot_manager.deserializeSnapshotBufferFromDisk(latest_log_index));
-            latest_snapshot_path = snapshot_manager.getLatestSnapshotPath();
+            latest_snapshot_buf = snapshot_manager.deserializeSnapshotBufferFromDisk(latest_log_index);
+            auto snapshot_deserialization_result = snapshot_manager.deserializeSnapshotFromBuffer(latest_snapshot_buf);
+            latest_snapshot_info = snapshot_manager.getLatestSnapshotInfo();
+
+            if (isLocalDisk(*latest_snapshot_info.disk))
+                latest_snapshot_buf = nullptr;
+
             storage = std::move(snapshot_deserialization_result.storage);
             latest_snapshot_meta = snapshot_deserialization_result.snapshot_meta;
             cluster_config = snapshot_deserialization_result.cluster_config;
@@ -306,8 +322,14 @@ bool KeeperStateMachine::apply_snapshot(nuraft::snapshot & s)
 
     { /// deserialize and apply snapshot to storage
         std::lock_guard lock(storage_and_responses_lock);
-        auto snapshot_deserialization_result
-            = snapshot_manager.deserializeSnapshotFromBuffer(snapshot_manager.deserializeSnapshotBufferFromDisk(s.get_last_log_idx()));
+
+        SnapshotDeserializationResult snapshot_deserialization_result;
+        if (latest_snapshot_ptr)
+            snapshot_deserialization_result = snapshot_manager.deserializeSnapshotFromBuffer(latest_snapshot_ptr);
+        else
+            snapshot_deserialization_result
+                = snapshot_manager.deserializeSnapshotFromBuffer(snapshot_manager.deserializeSnapshotBufferFromDisk(s.get_last_log_idx()));
+
         storage = std::move(snapshot_deserialization_result.storage);
         latest_snapshot_meta = snapshot_deserialization_result.snapshot_meta;
         cluster_config = snapshot_deserialization_result.cluster_config;
@@ -387,19 +409,22 @@ void KeeperStateMachine::create_snapshot(nuraft::snapshot & s, nuraft::async_res
                 }
                 else
                 {
-                    auto [path, error_code] = snapshot_manager.serializeSnapshotToDisk(*snapshot);
-                    if (error_code)
+                    /// we rely on the fact that the snapshot disk cannot be changed during runtime
+                    if (isLocalDisk(*keeper_context->getSnapshotDisk()))
                     {
-                        throw Exception(
-                            ErrorCodes::SYSTEM_ERROR,
-                            "Snapshot {} was created failed, error: {}",
-                            snapshot->snapshot_meta->get_last_log_idx(),
-                            error_code.message());
+                        latest_snapshot_info = snapshot_manager.serializeSnapshotToDisk(*snapshot);
+                        latest_snapshot_meta = snapshot->snapshot_meta;
+                        latest_snapshot_buf = nullptr;
                     }
-                    latest_snapshot_path = path;
-                    latest_snapshot_meta = snapshot->snapshot_meta;
+                    else
+                    {
+                        auto snapshot_buf = snapshot_manager.serializeSnapshotToBuffer(*snapshot);
+                        latest_snapshot_info = snapshot_manager.serializeSnapshotBufferToDisk(*snapshot_buf, snapshot->snapshot_meta->get_last_log_idx());
+                        latest_snapshot_buf = std::move(snapshot_buf);
+                    }
+
                     ProfileEvents::increment(ProfileEvents::KeeperSnapshotCreations);
-                    LOG_DEBUG(log, "Created persistent snapshot {} with path {}", latest_snapshot_meta->get_last_log_idx(), path);
+                    LOG_DEBUG(log, "Created persistent snapshot {} with path {}", latest_snapshot_meta->get_last_log_idx(), latest_snapshot_info.path);
                 }
             }
 
@@ -423,19 +448,19 @@ void KeeperStateMachine::create_snapshot(nuraft::snapshot & s, nuraft::async_res
 
         when_done(ret, exception);
 
-        return ret ? latest_snapshot_path : "";
+        return ret ? latest_snapshot_info : SnapshotFileInfo{};
     };
 
 
     if (keeper_context->getServerState() == KeeperContext::Phase::SHUTDOWN)
     {
         LOG_INFO(log, "Creating a snapshot during shutdown because 'create_snapshot_on_exit' is enabled.");
-        auto snapshot_path = snapshot_task.create_snapshot(std::move(snapshot_task.snapshot));
+        auto snapshot_file_info = snapshot_task.create_snapshot(std::move(snapshot_task.snapshot));
 
-        if (!snapshot_path.empty() && snapshot_manager_s3)
+        if (!snapshot_file_info.path.empty() && snapshot_manager_s3)
         {
-            LOG_INFO(log, "Uploading snapshot {} during shutdown because 'upload_snapshot_on_exit' is enabled.", snapshot_path);
-            snapshot_manager_s3->uploadSnapshot(snapshot_path, /* asnyc_upload */ false);
+            LOG_INFO(log, "Uploading snapshot {} during shutdown because 'upload_snapshot_on_exit' is enabled.", snapshot_file_info.path);
+            snapshot_manager_s3->uploadSnapshot(snapshot_file_info, /* asnyc_upload */ false);
         }
 
         return;
@@ -456,14 +481,20 @@ void KeeperStateMachine::save_logical_snp_obj(
     nuraft::ptr<nuraft::buffer> snp_buf = s.serialize();
     nuraft::ptr<nuraft::snapshot> cloned_meta = nuraft::snapshot::deserialize(*snp_buf);
 
+    nuraft::ptr<nuraft::buffer> cloned_buffer;
+
+    /// we rely on the fact that the snapshot disk cannot be changed during runtime
+    if (!isLocalDisk(*keeper_context->getSnapshotDisk()))
+        cloned_buffer = nuraft::buffer::clone(data);
+
     try
     {
         std::lock_guard lock(snapshots_lock);
         /// Serialize snapshot to disk
-        auto result_path = snapshot_manager.serializeSnapshotBufferToDisk(data, s.get_last_log_idx());
-        latest_snapshot_path = result_path;
+        latest_snapshot_info = snapshot_manager.serializeSnapshotBufferToDisk(data, s.get_last_log_idx());
         latest_snapshot_meta = cloned_meta;
-        LOG_DEBUG(log, "Saved snapshot {} to path {}", s.get_last_log_idx(), result_path);
+        latest_snapshot_buf = std::move(cloned_buffer);
+        LOG_DEBUG(log, "Saved snapshot {} to path {}", s.get_last_log_idx(), latest_snapshot_info.path);
         obj_id++;
         ProfileEvents::increment(ProfileEvents::KeeperSaveSnapshot);
     }
@@ -523,11 +554,23 @@ int KeeperStateMachine::read_logical_snp_obj(
             latest_snapshot_meta->get_last_log_idx());
         return -1;
     }
-    if (bufferFromFile(log, latest_snapshot_path, data_out))
+
+    const auto & [path, disk] = latest_snapshot_info;
+    if (isLocalDisk(*disk))
     {
-        LOG_WARNING(log, "Error reading snapshot {} from {}", s.get_last_log_idx(), latest_snapshot_path);
-        return -1;
+        auto full_path = fs::path(disk->getPath()) / path;
+        if (bufferFromFile(log, full_path, data_out))
+        {
+            LOG_WARNING(log, "Error reading snapshot {} from {}", s.get_last_log_idx(), full_path);
+            return -1;
+        }
     }
+    else
+    {
+        chassert(latest_snapshot_buf);
+        data_out = nuraft::buffer::clone(*latest_snapshot_buf);
+    }
+
     is_last_obj = true;
     ProfileEvents::increment(ProfileEvents::KeeperReadSnapshot);
 
diff --git a/src/Coordination/KeeperStateMachine.h b/src/Coordination/KeeperStateMachine.h
index afe11150f36..834837314df 100644
--- a/src/Coordination/KeeperStateMachine.h
+++ b/src/Coordination/KeeperStateMachine.h
@@ -110,7 +110,7 @@ private:
     /// In our state machine we always have a single snapshot which is stored
     /// in memory in compressed (serialized) format.
     SnapshotMetadataPtr latest_snapshot_meta = nullptr;
-    std::string latest_snapshot_path;
+    SnapshotFileInfo latest_snapshot_info;
     nuraft::ptr<nuraft::buffer> latest_snapshot_buf = nullptr;
 
     CoordinationSettingsPtr coordination_settings;
diff --git a/tests/integration/test_keeper_four_word_command/test.py b/tests/integration/test_keeper_four_word_command/test.py
index 2098daea5fe..aab8a2ccb68 100644
--- a/tests/integration/test_keeper_four_word_command/test.py
+++ b/tests/integration/test_keeper_four_word_command/test.py
@@ -252,10 +252,12 @@ def test_cmd_conf(started_cluster):
 
         assert result["four_letter_word_allow_list"] == "*"
         assert result["log_storage_path"] == "/var/lib/clickhouse/coordination/log"
+        assert result["log_storage_disk"] == "LocalLogDisk"
         assert (
             result["snapshot_storage_path"]
             == "/var/lib/clickhouse/coordination/snapshots"
         )
+        assert result["snapshot_storage_disk"] == "LocalSnapshotDisk"
 
         assert result["session_timeout_ms"] == "30000"
         assert result["min_session_timeout_ms"] == "10000"

From 4483602c50918e69d5a4d79c1628412b2c667c0d Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 25 May 2023 08:52:14 +0000
Subject: [PATCH 0153/1478] Remove double initialization

---
 src/Coordination/KeeperServer.cpp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 989455a5a79..363e7f9bef1 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -121,8 +121,6 @@ KeeperServer::KeeperServer(
     if (coordination_settings->quorum_reads)
         LOG_WARNING(log, "Quorum reads enabled, Keeper will work slower.");
 
-    keeper_context->initialize(config);
-
     state_machine = nuraft::cs_new<KeeperStateMachine>(
         responses_queue_,
         snapshots_queue_,

From f519aa4613a7f82b30bb39686412343d5a5a939d Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 25 May 2023 09:10:45 +0000
Subject: [PATCH 0154/1478] Calculate size

---
 .../KeeperAsynchronousMetrics.cpp             | 12 +++----
 src/Coordination/KeeperDispatcher.cpp         | 32 +++++++++----------
 src/Coordination/KeeperSnapshotManagerS3.h    |  5 +--
 src/Coordination/KeeperStateMachine.cpp       |  5 ---
 4 files changed, 25 insertions(+), 29 deletions(-)

diff --git a/src/Coordination/KeeperAsynchronousMetrics.cpp b/src/Coordination/KeeperAsynchronousMetrics.cpp
index 1427130b184..890079e98f7 100644
--- a/src/Coordination/KeeperAsynchronousMetrics.cpp
+++ b/src/Coordination/KeeperAsynchronousMetrics.cpp
@@ -28,8 +28,8 @@ void updateKeeperInformation(KeeperDispatcher & keeper_dispatcher, AsynchronousM
     size_t zxid = 0;
     size_t session_with_watches = 0;
     size_t paths_watched = 0;
-    size_t snapshot_dir_size = 0;
-    size_t log_dir_size = 0;
+    //size_t snapshot_dir_size = 0;
+    //size_t log_dir_size = 0;
 
     if (keeper_dispatcher.isServerActive())
     {
@@ -49,8 +49,8 @@ void updateKeeperInformation(KeeperDispatcher & keeper_dispatcher, AsynchronousM
         latest_snapshot_size = state_machine.getLatestSnapshotBufSize();
         session_with_watches = state_machine.getSessionsWithWatchesCount();
         paths_watched = state_machine.getWatchedPathsCount();
-        snapshot_dir_size = keeper_dispatcher.getSnapDirSize();
-        log_dir_size = keeper_dispatcher.getLogDirSize();
+        //snapshot_dir_size = keeper_dispatcher.getSnapDirSize();
+        //log_dir_size = keeper_dispatcher.getLogDirSize();
 
 #    if defined(__linux__) || defined(__APPLE__)
         open_file_descriptor_count = getCurrentProcessFDCount();
@@ -85,8 +85,8 @@ void updateKeeperInformation(KeeperDispatcher & keeper_dispatcher, AsynchronousM
     new_values["KeeperZxid"] = { zxid, "The current transaction id number (zxid) in ClickHouse Keeper." };
     new_values["KeeperSessionWithWatches"] = { session_with_watches, "The number of client sessions of ClickHouse Keeper having watches." };
     new_values["KeeperPathsWatched"] = { paths_watched, "The number of different paths watched by the clients of ClickHouse Keeper." };
-    new_values["KeeperSnapshotDirSize"] = { snapshot_dir_size, "The size of the snapshots directory of ClickHouse Keeper, in bytes." };
-    new_values["KeeperLogDirSize"] = { log_dir_size, "The size of the logs directory of ClickHouse Keeper, in bytes." };
+    //new_values["KeeperSnapshotDirSize"] = { snapshot_dir_size, "The size of the snapshots directory of ClickHouse Keeper, in bytes." };
+    //new_values["KeeperLogDirSize"] = { log_dir_size, "The size of the logs directory of ClickHouse Keeper, in bytes." };
 
     auto keeper_log_info = keeper_dispatcher.getKeeperLogInfo();
 
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index 4a460777621..6d1239c9210 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -777,37 +777,37 @@ void KeeperDispatcher::updateKeeperStatLatency(uint64_t process_time_ms)
     keeper_stats.updateLatency(process_time_ms);
 }
 
-static uint64_t getDirSize(const fs::path & dir)
+static uint64_t getTotalSize(const DiskPtr & disk, const std::string & path = "")
 {
     checkStackSize();
-    if (!fs::exists(dir))
-        return 0;
 
-    fs::directory_iterator it(dir);
-    fs::directory_iterator end;
-
-    uint64_t size{0};
-    while (it != end)
+    uint64_t size = 0;
+    for (auto it = disk->iterateDirectory(path); it->isValid(); it->next())
     {
-        if (it->is_regular_file())
-            size += fs::file_size(*it);
+        if (disk->isFile(it->path()))
+            size += disk->getFileSize(it->path());
         else
-            size += getDirSize(it->path());
-        ++it;
+            size += getTotalSize(disk, it->path());
     }
+
     return size;
 }
 
 uint64_t KeeperDispatcher::getLogDirSize() const
 {
-    //return getDirSize(configuration_and_settings->log_storage_path);
-    return 0;
+    auto log_disk = keeper_context->getLogDisk();
+    auto size = getTotalSize(log_disk);
+
+    auto current_log_disk = keeper_context->getCurrentLogDisk();
+    if (log_disk != current_log_disk)
+        size += getTotalSize(current_log_disk);
+
+    return size;
 }
 
 uint64_t KeeperDispatcher::getSnapDirSize() const
 {
-    //return getDirSize(configuration_and_settings->snapshot_storage_path);
-    return 0;
+    return getTotalSize(keeper_context->getSnapshotDisk());
 }
 
 Keeper4LWInfo KeeperDispatcher::getKeeper4LWInfo() const
diff --git a/src/Coordination/KeeperSnapshotManagerS3.h b/src/Coordination/KeeperSnapshotManagerS3.h
index 908deb76851..e17cf5a1cfb 100644
--- a/src/Coordination/KeeperSnapshotManagerS3.h
+++ b/src/Coordination/KeeperSnapshotManagerS3.h
@@ -6,11 +6,12 @@
 #include <Common/MultiVersion.h>
 #include <Common/Macros.h>
 
+#include <Coordination/KeeperSnapshotManager.h>
+
 #if USE_AWS_S3
 #include <Common/ConcurrentBoundedQueue.h>
 #include <Common/ThreadPool.h>
 
-#include <Coordination/KeeperSnapshotManager.h>
 
 #include <string>
 #endif
@@ -62,7 +63,7 @@ public:
     KeeperSnapshotManagerS3() = default;
 
     void updateS3Configuration(const Poco::Util::AbstractConfiguration &, const MultiVersion<Macros>::Version &) {}
-    void uploadSnapshot(const std::string &, [[maybe_unused]] bool async_upload = true) {}
+    void uploadSnapshot(const SnapshotFileInfo &, [[maybe_unused]] bool async_upload = true) {}
 
     void startup(const Poco::Util::AbstractConfiguration &, const MultiVersion<Macros>::Version &) {}
 
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 49243541bc8..5cfc9333a66 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -35,11 +35,6 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int LOGICAL_ERROR;
-    extern const int SYSTEM_ERROR;
-}
-
-namespace
-{
 }
 
 KeeperStateMachine::KeeperStateMachine(

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 0155/1478] 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 bb77441acb488bb2a32f691ce724b2950ec0d9ba Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 25 May 2023 13:31:11 +0000
Subject: [PATCH 0156/1478] Add support for old storage disks

---
 src/Coordination/KeeperContext.cpp         |  30 ++++--
 src/Coordination/KeeperContext.h           |   2 +
 src/Coordination/KeeperSnapshotManager.cpp | 118 +++++++++++++--------
 src/Coordination/KeeperSnapshotManager.h   |   5 +-
 src/Coordination/KeeperStateMachine.cpp    |   2 +-
 5 files changed, 103 insertions(+), 54 deletions(-)

diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index da49868f706..1d6f1be9bfb 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -8,7 +8,6 @@
 namespace DB
 {
 
-
 KeeperContext::KeeperContext(bool standalone_keeper_)
     : disk_selector(std::make_shared<DiskSelector>())
     , standalone_keeper(standalone_keeper_)
@@ -28,13 +27,19 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
     else
         current_log_storage = log_storage;
 
-    Poco::Util::AbstractConfiguration::Keys old_log_disk_name_keys;
-    config.keys("keeper_server", old_log_disk_name_keys);
-    for (const auto & key : old_log_disk_name_keys)
+    const auto collect_old_disk_names = [&](const std::string_view key_prefix, std::vector<std::string> & disk_names)
     {
-        if (key.starts_with("old_log_storage_disk"))
-            old_log_disk_names.push_back(config.getString("keeper_server." + key));
-    }
+        Poco::Util::AbstractConfiguration::Keys disk_name_keys;
+        config.keys("keeper_server", disk_name_keys);
+        for (const auto & key : disk_name_keys)
+        {
+            if (key.starts_with(key_prefix))
+                disk_names.push_back(config.getString(fmt::format("keeper_server.{}", key_prefix)));
+        }
+    };
+
+    collect_old_disk_names("old_log_storage_disk", old_log_disk_names);
+    collect_old_disk_names("old_snapshot_storage_disk", old_snapshot_disk_names);
 
     snapshot_storage = getSnapshotsPathFromConfig(config);
 
@@ -107,6 +112,17 @@ DiskPtr KeeperContext::getSnapshotDisk() const
     return getDisk(snapshot_storage);
 }
 
+std::vector<DiskPtr> KeeperContext::getOldSnapshotDisks() const
+{
+    std::vector<DiskPtr> old_snapshot_disks;
+    old_snapshot_disks.reserve(old_snapshot_disk_names.size());
+
+    for (const auto & disk_name : old_snapshot_disk_names)
+        old_snapshot_disks.push_back(disk_selector->get(disk_name));
+
+    return old_snapshot_disks;
+}
+
 void KeeperContext::setSnapshotDisk(DiskPtr disk)
 {
     snapshot_storage = std::move(disk);
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 6b7af3a60db..e41d8e35032 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -40,6 +40,7 @@ public:
     void setLogDisk(DiskPtr disk);
 
     DiskPtr getSnapshotDisk() const;
+    std::vector<DiskPtr> getOldSnapshotDisks() const;
     void setSnapshotDisk(DiskPtr disk);
 
     DiskPtr getStateFileDisk() const;
@@ -69,6 +70,7 @@ private:
     Storage state_file_storage;
 
     std::vector<std::string> old_log_disk_names;
+    std::vector<std::string> old_snapshot_disk_names;
 
     bool standalone_keeper;
 };
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 3bfe700bcd5..77abbfb2054 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -519,49 +519,79 @@ KeeperSnapshotManager::KeeperSnapshotManager(
     , storage_tick_time(storage_tick_time_)
     , keeper_context(keeper_context_)
 {
+    const auto load_snapshot_from_disk = [&](DiskPtr disk)
+    {
+        std::unordered_set<std::string> invalid_snapshots;
+        /// collect invalid snapshots
+        for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
+        {
+            const auto & name = it->name();
+            if (name.empty())
+                continue;
+
+            if (startsWith(name, "tmp_"))
+            {
+                disk->removeFile(it->path());
+                invalid_snapshots.insert(name.substr(4));
+                continue;
+            }
+        }
+
+        /// process snapshots
+        for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
+        {
+            const auto & name = it->name();
+            if (name.empty())
+                continue;
+
+            /// Not snapshot file
+            if (!startsWith(name, "snapshot_"))
+                continue;
+
+            if (invalid_snapshots.contains(name))
+            {
+                disk->removeFile(it->path());
+                continue;
+            }
+
+            size_t snapshot_up_to = getSnapshotPathUpToLogIdx(name);
+            auto [_, inserted] = existing_snapshots.insert_or_assign(snapshot_up_to, SnapshotFileInfo{it->path(), disk});
+
+            if (!inserted)
+                LOG_WARNING(
+                    &Poco::Logger::get("KeeperSnapshotManager"),
+                    "Found another snapshots with last log idx {}, will use snapshot from disk {}",
+                    snapshot_up_to,
+                    disk->getName());
+        }
+    };
+
+    for (const auto & disk : keeper_context->getOldSnapshotDisks())
+        load_snapshot_from_disk(disk);
+
     auto disk = getDisk();
-
-    std::unordered_set<std::string> invalid_snapshots;
-    /// collect invalid snapshots
-    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
-    {
-        const auto & name = it->name();
-        if (name.empty())
-            continue;
-
-        if (startsWith(name, "tmp_"))
-        {
-            disk->removeFile(it->path());
-            invalid_snapshots.insert(name.substr(4));
-            continue;
-        }
-
-    }
-
-    /// process snapshots
-    for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
-    {
-        const auto & name = it->name();
-        if (name.empty())
-            continue;
-
-        /// Not snapshot file
-        if (!startsWith(name, "snapshot_"))
-            continue;
-
-        if (invalid_snapshots.contains(name))
-        {
-            disk->removeFile(it->path());
-            continue;
-        }
-
-        size_t snapshot_up_to = getSnapshotPathUpToLogIdx(name);
-        existing_snapshots[snapshot_up_to] = it->path();
-    }
+    load_snapshot_from_disk(disk);
 
     removeOutdatedSnapshotsIfNeeded();
-}
 
+    /// move snapshots from old disks to new one 
+    for (auto & [_, file_info] : existing_snapshots)
+    {
+        if (file_info.disk == disk)
+            continue;
+
+        auto file_path = fs::path(file_info.path);
+        auto tmp_snapshot_path = file_path.parent_path() / ("tmp_" + file_path.filename().generic_string());
+
+        {
+            disk->writeFile(tmp_snapshot_path);
+        }
+
+        file_info.disk->copyFile(file_info.path, *disk, file_info.path, {});
+        disk->removeFile(tmp_snapshot_path);
+        file_info.disk = disk;
+    }
+}
 
 SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx)
 {
@@ -599,7 +629,8 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBuff
         }
         catch (const DB::Exception &)
         {
-            getDisk()->removeFile(latest_itr->second);
+            const auto & [path, disk] = latest_itr->second;
+            disk->removeFile(path);
             existing_snapshots.erase(latest_itr->first);
             tryLogCurrentException(__PRETTY_FUNCTION__);
         }
@@ -610,9 +641,9 @@ nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeLatestSnapshotBuff
 
 nuraft::ptr<nuraft::buffer> KeeperSnapshotManager::deserializeSnapshotBufferFromDisk(uint64_t up_to_log_idx) const
 {
-    const std::string & snapshot_path = existing_snapshots.at(up_to_log_idx);
+    const auto & [snapshot_path, snapshot_disk] = existing_snapshots.at(up_to_log_idx);
     WriteBufferFromNuraftBuffer writer;
-    auto reader = getDisk()->readFile(snapshot_path);
+    auto reader = snapshot_disk->readFile(snapshot_path);
     copyData(*reader, writer);
     return writer.getBuffer();
 }
@@ -690,7 +721,8 @@ void KeeperSnapshotManager::removeSnapshot(uint64_t log_idx)
     auto itr = existing_snapshots.find(log_idx);
     if (itr == existing_snapshots.end())
         throw Exception(ErrorCodes::UNKNOWN_SNAPSHOT, "Unknown snapshot with log index {}", log_idx);
-    getDisk()->removeFile(itr->second);
+    const auto & [path, disk] = itr->second;
+    disk->removeFile(path);
     existing_snapshots.erase(itr);
 }
 
diff --git a/src/Coordination/KeeperSnapshotManager.h b/src/Coordination/KeeperSnapshotManager.h
index 036c0cab62b..0afe582ef59 100644
--- a/src/Coordination/KeeperSnapshotManager.h
+++ b/src/Coordination/KeeperSnapshotManager.h
@@ -149,11 +149,10 @@ public:
     {
         if (!existing_snapshots.empty())
         {
-            const auto & path = existing_snapshots.at(getLatestSnapshotIndex());
+            const auto & [path, disk] = existing_snapshots.at(getLatestSnapshotIndex());
 
             try
             {
-                auto disk = getDisk();
                 if (disk->exists(path))
                     return {path, disk};
             }
@@ -176,7 +175,7 @@ private:
     /// How many snapshots to keep before remove
     const size_t snapshots_to_keep;
     /// All existing snapshots in our path (log_index -> path)
-    std::map<uint64_t, std::string> existing_snapshots;
+    std::map<uint64_t, SnapshotFileInfo> existing_snapshots;
     /// Compress snapshots in common ZSTD format instead of custom ClickHouse block LZ4 format
     const bool compress_snapshots_zstd;
     /// Superdigest for deserialization of storage
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 5cfc9333a66..9a1cb1941b7 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -404,11 +404,11 @@ void KeeperStateMachine::create_snapshot(nuraft::snapshot & s, nuraft::async_res
                 }
                 else
                 {
+                    latest_snapshot_meta = snapshot->snapshot_meta;
                     /// we rely on the fact that the snapshot disk cannot be changed during runtime
                     if (isLocalDisk(*keeper_context->getSnapshotDisk()))
                     {
                         latest_snapshot_info = snapshot_manager.serializeSnapshotToDisk(*snapshot);
-                        latest_snapshot_meta = snapshot->snapshot_meta;
                         latest_snapshot_buf = nullptr;
                     }
                     else

From 30ff5113d98141ab4adb05ad08b7ffb48888c33d Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 25 May 2023 13:33:52 +0000
Subject: [PATCH 0157/1478] Fixing more tests.

---
 src/Functions/in.cpp                          |  8 +-
 src/Interpreters/ActionsVisitor.cpp           |  2 +-
 src/Interpreters/PreparedSets.cpp             | 70 +++++++++++------
 src/Interpreters/PreparedSets.h               | 17 +++--
 src/Interpreters/Set.cpp                      | 76 +++++++++++--------
 src/Interpreters/Set.h                        | 18 ++++-
 src/Planner/CollectSets.cpp                   |  2 +-
 .../CreateSetAndFilterOnTheFlyTransform.cpp   |  2 +-
 src/Storages/KVStorageUtils.cpp               |  4 +-
 src/Storages/MergeTree/KeyCondition.cpp       |  8 +-
 .../MergeTreeIndexConditionBloomFilter.cpp    |  2 +-
 .../MergeTree/MergeTreeIndexFullText.cpp      |  2 +-
 .../MergeTree/MergeTreeIndexInverted.cpp      |  2 +-
 .../System/StorageSystemZooKeeper.cpp         |  4 +-
 14 files changed, 136 insertions(+), 81 deletions(-)

diff --git a/src/Functions/in.cpp b/src/Functions/in.cpp
index eb623951bf3..6a88a413c63 100644
--- a/src/Functions/in.cpp
+++ b/src/Functions/in.cpp
@@ -127,12 +127,12 @@ public:
         }
 
         auto future_set = column_set->getData();
-        if (!future_set || !future_set->isFilled())
+        if (!future_set || !future_set->isReady())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Not-ready Set passed as the second argument for function '{}'", getName());
 
-        if (auto * for_tuple = typeid_cast<FutureSetFromTuple *>(future_set.get()))
-            if (!for_tuple->isReady())
-                for_tuple->buildForTuple(size_limits, transform_null_in);
+        // if (auto * for_tuple = typeid_cast<FutureSetFromTuple *>(future_set.get()))
+        //     if (!for_tuple->isReady())
+        //         for_tuple->buildForTuple(size_limits, transform_null_in);
 
         auto set = future_set->get();
         auto set_types = set->getDataTypes();
diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 1405568aa71..da8666466fc 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -458,7 +458,7 @@ FutureSetPtr makeExplicitSet(
     else
         block = createBlockForSet(left_arg_type, right_arg, set_element_types, context);
 
-    return prepared_sets.addFromTuple(set_key, block);
+    return prepared_sets.addFromTuple(set_key, block, context->getSettings());
 }
 
 class ScopeStack::Index
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 3b63d942404..eebc59e85d5 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -14,6 +14,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int LOGICAL_ERROR;
+    extern const int SET_SIZE_LIMIT_EXCEEDED;
 }
 
 PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
@@ -120,9 +121,9 @@ FutureSetPtr PreparedSets::addFromStorage(const PreparedSetKey & key, SetPtr set
     return it->second;
 }
 
-FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block)
+FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings)
 {
-    auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block));
+    auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block), settings);
     auto [it, inserted] = sets.emplace(key, std::move(from_tuple));
 
     if (!inserted)
@@ -292,7 +293,25 @@ SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordere
     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
 }
 
-FutureSetFromTuple::FutureSetFromTuple(Block block_) : block(std::move(block_)) {}
+FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
+{
+    bool create_ordered_set = false;
+    auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
+    set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
+    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
+
+    Columns columns;
+    columns.reserve(block.columns());
+    for (const auto & column : block)
+        columns.emplace_back(column.column);
+
+    set_key_columns.filter = ColumnUInt8::create(block.rows());
+
+    set->initSetElements();
+    set->insertFromColumns(columns, set_key_columns);
+    set->finishInsert();
+    //block(std::move(block_))
+}
 
 FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquery(std::move(subquery_)) {}
 
@@ -301,35 +320,40 @@ FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {
 SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
 {
     const auto & settings = context->getSettingsRef();
-    auto size_limits = getSizeLimitsForSet(settings, true);
-    fill(size_limits, settings.transform_null_in, true);
+    auto limits = getSizeLimitsForSet(settings, true);
+
+    if (!limits.check(set->getTotalRowCount(), set->getTotalByteCount(), "IN-set", ErrorCodes::SET_SIZE_LIMIT_EXCEEDED))
+        return nullptr;
+
+    set->initSetElements();
+    set->appendSetElements(set_key_columns);
     return set;
 }
 
-std::unique_ptr<QueryPlan> FutureSetFromTuple::build(const ContextPtr & context)
+std::unique_ptr<QueryPlan> FutureSetFromTuple::build(const ContextPtr &)
 {
-    const auto & settings = context->getSettingsRef();
-    auto size_limits = getSizeLimitsForSet(settings, false);
-    fill(size_limits, settings.transform_null_in, false);
+    // const auto & settings = context->getSettingsRef();
+    // auto size_limits = getSizeLimitsForSet(settings, false);
+    // fill(size_limits, settings.transform_null_in, false);
     return nullptr;
 }
 
-void FutureSetFromTuple::buildForTuple(SizeLimits size_limits, bool transform_null_in)
-{
-    fill(size_limits, transform_null_in, false);
-}
+// void FutureSetFromTuple::buildForTuple(SizeLimits size_limits, bool transform_null_in)
+// {
+//     fill(size_limits, transform_null_in, false);
+// }
 
-void FutureSetFromTuple::fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
-{
-    //std::cerr << StackTrace().toString() << std::endl;
+// void FutureSetFromTuple::fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
+// {
+//     //std::cerr << StackTrace().toString() << std::endl;
 
-    if (set)
-        return;
+//     if (set)
+//         return;
 
-    set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
-    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
-    set->insertFromBlock(block.getColumnsWithTypeAndName());
-    set->finishInsert();
-}
+//     set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
+//     set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
+//     set->insertFromBlock(block.getColumnsWithTypeAndName());
+//     set->finishInsert();
+// }
 
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index ef7aba38f24..35bbc1e12fb 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -80,24 +80,23 @@ using FutureSetPtr = std::shared_ptr<FutureSet>;
 class FutureSetFromTuple final : public FutureSet
 {
 public:
-    FutureSetFromTuple(Block block_);
+    FutureSetFromTuple(Block block, const Settings & settings);
 
-    bool isReady() const override { return set != nullptr; }
+    bool isReady() const override { return true; }
     bool isFilled() const override { return true; }
     SetPtr get() const override { return set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
-    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override;
+    std::unique_ptr<QueryPlan> build(const ContextPtr &) override;
 
-    void buildForTuple(SizeLimits size_limits, bool transform_null_in);
+///    void buildForTuple(SizeLimits size_limits, bool transform_null_in);
 
 private:
-    Block block;
-
     SetPtr set;
+    Set::SetKeyColumns set_key_columns;
 
-    void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set);
+    //void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set);
 };
 
 /// Information on how to build set for the [GLOBAL] IN section.
@@ -145,6 +144,8 @@ public:
             return nullptr;
 
         auto plan = buildPlan(context, true);
+        if (!plan)
+            return nullptr;
 
         auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
         auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
@@ -249,7 +250,7 @@ public:
     //                                      SizeLimits set_size_limit, bool transform_null_in);
 
     FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
-    FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block);
+    FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings);
     FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery);
 
     void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index a7bea63bd99..5adf3d07353 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -156,25 +156,46 @@ void Set::setHeader(const ColumnsWithTypeAndName & header)
     {
         /// Create empty columns with set values in advance.
         /// It is needed because set may be empty, so method 'insertFromBlock' will be never called.
-        set_elements.reserve(keys_size);
-        for (const auto & type : set_elements_types)
-            set_elements.emplace_back(type->createColumn());
+        initSetElements();
     }
 
     /// Choose data structure to use for the set.
     data.init(data.chooseMethod(key_columns, key_sizes));
 }
 
+void Set::initSetElements()
+{
+    set_elements.reserve(keys_size);
+    for (const auto & type : set_elements_types)
+        set_elements.emplace_back(type->createColumn());
+}
+
 bool Set::insertFromBlock(const ColumnsWithTypeAndName & columns)
 {
     Columns cols;
     cols.reserve(columns.size());
     for (const auto & column : columns)
         cols.emplace_back(column.column);
-    return insertFromBlock(cols);
+    return insertFromColumns(cols);
 }
 
-bool Set::insertFromBlock(const Columns & columns)
+bool Set::insertFromColumns(const Columns & columns)
+{
+    size_t rows = columns.at(0)->size();
+
+    SetKeyColumns holder;
+    /// Filter to extract distinct values from the block.
+    if (fill_set_elements)
+        holder.filter = ColumnUInt8::create(rows);
+
+    bool inserted = insertFromColumns(columns, holder);
+    if (inserted && fill_set_elements)
+        appendSetElements(holder);
+
+    return inserted;
+}
+
+bool Set::insertFromColumns(const Columns & columns, SetKeyColumns & holder)
 {
     std::lock_guard lock(rwlock);
 
@@ -183,15 +204,13 @@ bool Set::insertFromBlock(const Columns & columns)
 
     ColumnRawPtrs key_columns;
     key_columns.reserve(keys_size);
-
-    /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
-    Columns materialized_columns;
+    holder.key_columns.reserve(keys_size);
 
     /// Remember the columns we will work with
     for (size_t i = 0; i < keys_size; ++i)
     {
-        materialized_columns.emplace_back(columns.at(i)->convertToFullIfNeeded());
-        key_columns.emplace_back(materialized_columns.back().get());
+        holder.key_columns.emplace_back(columns.at(i)->convertToFullIfNeeded());
+        key_columns.emplace_back(holder.key_columns.back().get());
     }
 
     size_t rows = columns.at(0)->size();
@@ -202,40 +221,37 @@ bool Set::insertFromBlock(const Columns & columns)
     if (!transform_null_in)
         null_map_holder = extractNestedColumnsAndNullMap(key_columns, null_map);
 
-    /// Filter to extract distinct values from the block.
-    ColumnUInt8::MutablePtr filter;
-    if (fill_set_elements)
-        filter = ColumnUInt8::create(rows);
-
     switch (data.type)
     {
         case SetVariants::Type::EMPTY:
             break;
 #define M(NAME) \
         case SetVariants::Type::NAME: \
-            insertFromBlockImpl(*data.NAME, key_columns, rows, data, null_map, filter ? &filter->getData() : nullptr); \
+            insertFromBlockImpl(*data.NAME, key_columns, rows, data, null_map, holder.filter ? &holder.filter->getData() : nullptr); \
             break;
         APPLY_FOR_SET_VARIANTS(M)
 #undef M
     }
 
-    if (fill_set_elements)
-    {
-        for (size_t i = 0; i < keys_size; ++i)
-        {
-            auto filtered_column = key_columns[i]->filter(filter->getData(), rows);
-            if (set_elements[i]->empty())
-                set_elements[i] = filtered_column;
-            else
-                set_elements[i]->insertRangeFrom(*filtered_column, 0, filtered_column->size());
-            if (transform_null_in && null_map_holder)
-                set_elements[i]->insert(Null{});
-        }
-    }
-
     return limits.check(data.getTotalRowCount(), data.getTotalByteCount(), "IN-set", ErrorCodes::SET_SIZE_LIMIT_EXCEEDED);
 }
 
+void Set::appendSetElements(SetKeyColumns & holder)
+{
+    //std::cerr << "========= " << keys_size << ' ' << holder.key_columns.size() << std::endl;
+    size_t rows = holder.key_columns.at(0)->size();
+    for (size_t i = 0; i < keys_size; ++i)
+    {
+        auto filtered_column = holder.key_columns[i]->filter(holder.filter->getData(), rows);
+        if (set_elements[i]->empty())
+            set_elements[i] = filtered_column;
+        else
+            set_elements[i]->insertRangeFrom(*filtered_column, 0, filtered_column->size());
+        if (transform_null_in && holder.null_map_holder)
+            set_elements[i]->insert(Null{});
+    }
+}
+
 void Set::checkIsCreated() const
 {
     if (!is_created.load())
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index fff5fa4e1b1..cb47fde7f7d 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -45,9 +45,23 @@ public:
     void setHeader(const ColumnsWithTypeAndName & header);
 
     /// Returns false, if some limit was exceeded and no need to insert more data.
-    bool insertFromBlock(const Columns & columns);
+    bool insertFromColumns(const Columns & columns);
     bool insertFromBlock(const ColumnsWithTypeAndName & columns);
 
+
+    struct SetKeyColumns
+    {
+        //ColumnRawPtrs key_columns;
+        /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
+        Columns key_columns;
+        ColumnPtr null_map_holder;
+        ColumnUInt8::MutablePtr filter;
+    };
+
+    void initSetElements();
+    bool insertFromColumns(const Columns & columns, SetKeyColumns & holder);
+    void appendSetElements(SetKeyColumns & holder);
+
     /// Call after all blocks were inserted. To get the information that set is already created.
     void finishInsert() { is_created = true; }
 
@@ -68,7 +82,7 @@ public:
     const DataTypes & getDataTypes() const { return data_types; }
     const DataTypes & getElementsTypes() const { return set_elements_types; }
 
-    bool hasExplicitSetElements() const { return fill_set_elements; }
+    bool hasExplicitSetElements() const { return fill_set_elements || (!set_elements.empty() && set_elements.front()->size() == data.getTotalRowCount()); }
     Columns getSetElements() const { checkIsCreated(); return { set_elements.begin(), set_elements.end() }; }
 
     void checkColumnsNumber(size_t num_key_columns) const;
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 6c970e0e91b..d66424f89ec 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -82,7 +82,7 @@ public:
 
             auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
 
-            sets.addFromTuple(set_key, std::move(set));
+            sets.addFromTuple(set_key, std::move(set), settings);
 
             //planner_context.registerSet(set_key, PlannerSet(FutureSet(std::move(set))));
         }
diff --git a/src/Processors/Transforms/CreateSetAndFilterOnTheFlyTransform.cpp b/src/Processors/Transforms/CreateSetAndFilterOnTheFlyTransform.cpp
index 4278eb8e8b2..59c4b9a6a87 100644
--- a/src/Processors/Transforms/CreateSetAndFilterOnTheFlyTransform.cpp
+++ b/src/Processors/Transforms/CreateSetAndFilterOnTheFlyTransform.cpp
@@ -106,7 +106,7 @@ void CreatingSetsOnTheFlyTransform::transform(Chunk & chunk)
     if (chunk.getNumRows())
     {
         Columns key_columns = getColumnsByIndices(chunk, key_column_indices);
-        bool limit_exceeded = !set->insertFromBlock(key_columns);
+        bool limit_exceeded = !set->insertFromColumns(key_columns);
         if (limit_exceeded)
         {
             auto prev_state = set->state.exchange(SetWithState::State::Suspended);
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index 281236e631e..f4a4b6e9af1 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -76,8 +76,8 @@ bool traverseASTFilter(
             if (!future_set)
                 return false;
 
-            if (!future_set->isReady())
-                future_set->buildOrderedSetInplace(context);
+            //if (!future_set->isReady())
+            future_set->buildOrderedSetInplace(context);
 
             auto set = future_set->get();
             if (!set)
diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index 4b053a37aa2..7fcc111ced9 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1212,11 +1212,11 @@ bool KeyCondition::tryPrepareSetIndex(
 
     // LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
 
-    if (!future_set->isReady())
-    {
+    //if (!future_set->isReady())
+    //{
         // LOG_TRACE(&Poco::Logger::get("KK"), "Building set inplace for {}", right_arg.getColumnName());
-        future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
-    }
+    future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
+    //}
 
     auto prepared_set = future_set->get();
     if (!prepared_set)
diff --git a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
index 2bd9db12b93..3d0883a1241 100644
--- a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
@@ -316,7 +316,7 @@ bool MergeTreeIndexConditionBloomFilter::traverseFunction(const RPNBuilderTreeNo
 
             //std::cerr << "==== Finding set for MergeTreeBF " << bool(future_set) << std::endl;
 
-            if (future_set && !future_set->isReady())
+            if (future_set) // && !future_set->isReady())
             {
                 //std::cerr << "==== not ready, building " << std::endl;
                 future_set->buildOrderedSetInplace(rhs_argument.getTreeContext().getQueryContext());
diff --git a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
index 5e1d23df3c7..d14ff4fa20b 100644
--- a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
@@ -625,7 +625,7 @@ bool MergeTreeConditionFullText::tryPrepareSetBloomFilter(
         return false;
 
     auto future_set = right_argument.tryGetPreparedSet(data_types);
-    if (future_set && !future_set->isReady())
+    if (future_set) // && !future_set->isReady())
         future_set->buildOrderedSetInplace(right_argument.getTreeContext().getQueryContext());
 
     ConstSetPtr prepared_set;
diff --git a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
index a64f81807ae..1d3b923056a 100644
--- a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
@@ -661,7 +661,7 @@ bool MergeTreeConditionInverted::tryPrepareSetGinFilter(
 
     //std::cerr << "==== Set for MergeTreeConditionInverted" << bool(future_set) << std::endl;
 
-    if (future_set && !future_set->isReady())
+    if (future_set) // && !future_set->isReady())
         future_set->buildOrderedSetInplace(rhs.getTreeContext().getQueryContext());
 
     ConstSetPtr prepared_set;
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 0f45f6825f6..34b463eadee 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -317,8 +317,8 @@ static void extractPathImpl(const ActionsDAG::Node & node, Paths & res, ContextP
         if (!future_set)
             return;
 
-        if (!future_set->isReady())
-            future_set->buildOrderedSetInplace(context);
+        //if (!future_set->isReady())
+        future_set->buildOrderedSetInplace(context);
 
         auto set = future_set->get();
         if (!set)

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 0158/1478] 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 6a8a21e09a49303919d2357f0b7f9ca38c79684b Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 25 May 2023 16:01:40 +0000
Subject: [PATCH 0159/1478] Add test for s3 disk restore

---
 src/Coordination/Changelog.cpp                |   3 +-
 src/Coordination/KeeperSnapshotManager.cpp    |   4 +-
 .../configs/disk_s3_storage.xml               |  26 +++
 .../configs/enable_keeper1.xml                |   2 -
 .../configs/enable_keeper2.xml                |   2 -
 .../configs/enable_keeper3.xml                |   2 -
 .../configs/keeper1_snapshot_disk.xml         |   5 +
 .../configs/keeper2_snapshot_disk.xml         |   5 +
 .../configs/keeper3_snapshot_disk.xml         |   5 +
 .../configs/local_storage_path.xml            |   6 +
 .../test_keeper_restore_from_snapshot/test.py |  12 +-
 .../test_disk_s3.py                           | 152 ++++++++++++++++++
 12 files changed, 212 insertions(+), 12 deletions(-)
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/configs/disk_s3_storage.xml
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/configs/keeper1_snapshot_disk.xml
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/configs/keeper2_snapshot_disk.xml
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/configs/keeper3_snapshot_disk.xml
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/configs/local_storage_path.xml
 create mode 100644 tests/integration/test_keeper_restore_from_snapshot/test_disk_s3.py

diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index 875b0758d27..b289e1dc9f2 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -616,7 +616,8 @@ Changelog::Changelog(Poco::Logger * log_, LogFileSettings log_file_settings, Kee
     load_from_disk(disk);
 
     auto current_log_disk = getCurrentLogDisk();
-    load_from_disk(current_log_disk);
+    if (disk != current_log_disk)
+        load_from_disk(current_log_disk);
 
     if (existing_changelogs.empty())
         LOG_WARNING(log, "No logs exists in {}. It's Ok if it's the first run of clickhouse-keeper.", disk->getPath());
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 77abbfb2054..c3371501976 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -612,7 +612,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::bu
 
     disk->removeFile(tmp_snapshot_file_name);
 
-    existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
+    existing_snapshots.emplace(up_to_log_idx, SnapshotFileInfo{snapshot_file_name, disk});
     removeOutdatedSnapshotsIfNeeded();
 
     return {snapshot_file_name, disk};
@@ -750,7 +750,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStor
 
     disk->removeFile(tmp_snapshot_file_name);
 
-    existing_snapshots.emplace(up_to_log_idx, snapshot_file_name);
+    existing_snapshots.emplace(up_to_log_idx, SnapshotFileInfo{snapshot_file_name, disk});
     removeOutdatedSnapshotsIfNeeded();
 
     return {snapshot_file_name, disk};
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/disk_s3_storage.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/disk_s3_storage.xml
new file mode 100644
index 00000000000..2ec4bcd77fb
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/disk_s3_storage.xml
@@ -0,0 +1,26 @@
+<clickhouse>
+    <storage_configuration>
+        <disks>
+            <snapshot_s3_plain1>
+                <type>s3_plain</type>
+                <endpoint>http://minio1:9001/root/data/snapshots1/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </snapshot_s3_plain1>
+            <snapshot_s3_plain2>
+                <type>s3_plain</type>
+                <endpoint>http://minio1:9001/root/data/snapshots2/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </snapshot_s3_plain2>
+            <snapshot_s3_plain3>
+                <type>s3_plain</type>
+                <endpoint>http://minio1:9001/root/data/snapshots3/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </snapshot_s3_plain3>
+        </disks>
+    </storage_configuration>
+
+</clickhouse>
+
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper1.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper1.xml
index 4ea543e6f31..510913b5dc4 100644
--- a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper1.xml
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper1.xml
@@ -2,8 +2,6 @@
     <keeper_server>
         <tcp_port>9181</tcp_port>
         <server_id>1</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
 
         <coordination_settings>
             <operation_timeout_ms>5000</operation_timeout_ms>
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper2.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper2.xml
index 4bf3083c1fa..0d50573df01 100644
--- a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper2.xml
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper2.xml
@@ -2,8 +2,6 @@
     <keeper_server>
         <tcp_port>9181</tcp_port>
         <server_id>2</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
 
         <coordination_settings>
             <operation_timeout_ms>5000</operation_timeout_ms>
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper3.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper3.xml
index b9e2a2d0422..8fa322cb9e7 100644
--- a/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper3.xml
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/enable_keeper3.xml
@@ -2,8 +2,6 @@
     <keeper_server>
         <tcp_port>9181</tcp_port>
         <server_id>3</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
 
         <coordination_settings>
             <operation_timeout_ms>5000</operation_timeout_ms>
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/keeper1_snapshot_disk.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper1_snapshot_disk.xml
new file mode 100644
index 00000000000..01759e2771a
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper1_snapshot_disk.xml
@@ -0,0 +1,5 @@
+<clickhouse>
+    <keeper_server>
+        <snapshot_storage_disk>snapshot_s3_plain1</snapshot_storage_disk>
+    </keeper_server>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/keeper2_snapshot_disk.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper2_snapshot_disk.xml
new file mode 100644
index 00000000000..6c33c5fb300
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper2_snapshot_disk.xml
@@ -0,0 +1,5 @@
+<clickhouse>
+    <keeper_server>
+        <snapshot_storage_disk>snapshot_s3_plain2</snapshot_storage_disk>
+    </keeper_server>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/keeper3_snapshot_disk.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper3_snapshot_disk.xml
new file mode 100644
index 00000000000..5016ccd581b
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/keeper3_snapshot_disk.xml
@@ -0,0 +1,5 @@
+<clickhouse>
+    <keeper_server>
+        <snapshot_storage_disk>snapshot_s3_plain3</snapshot_storage_disk>
+    </keeper_server>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_keeper_restore_from_snapshot/configs/local_storage_path.xml b/tests/integration/test_keeper_restore_from_snapshot/configs/local_storage_path.xml
new file mode 100644
index 00000000000..63cb958c88e
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/configs/local_storage_path.xml
@@ -0,0 +1,6 @@
+<clickhouse>
+    <keeper_server>
+        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
+        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
+    </keeper_server>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_keeper_restore_from_snapshot/test.py b/tests/integration/test_keeper_restore_from_snapshot/test.py
index bc33689dd20..e4d5793bb17 100644
--- a/tests/integration/test_keeper_restore_from_snapshot/test.py
+++ b/tests/integration/test_keeper_restore_from_snapshot/test.py
@@ -9,13 +9,19 @@ import time
 
 cluster = ClickHouseCluster(__file__)
 node1 = cluster.add_instance(
-    "node1", main_configs=["configs/enable_keeper1.xml"], stay_alive=True
+    "node1",
+    main_configs=["configs/enable_keeper1.xml", "configs/local_storage_path.xml"],
+    stay_alive=True,
 )
 node2 = cluster.add_instance(
-    "node2", main_configs=["configs/enable_keeper2.xml"], stay_alive=True
+    "node2",
+    main_configs=["configs/enable_keeper2.xml", "configs/local_storage_path.xml"],
+    stay_alive=True,
 )
 node3 = cluster.add_instance(
-    "node3", main_configs=["configs/enable_keeper3.xml"], stay_alive=True
+    "node3",
+    main_configs=["configs/enable_keeper3.xml", "configs/local_storage_path.xml"],
+    stay_alive=True,
 )
 
 from kazoo.client import KazooClient, KazooState
diff --git a/tests/integration/test_keeper_restore_from_snapshot/test_disk_s3.py b/tests/integration/test_keeper_restore_from_snapshot/test_disk_s3.py
new file mode 100644
index 00000000000..1226df75203
--- /dev/null
+++ b/tests/integration/test_keeper_restore_from_snapshot/test_disk_s3.py
@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+import pytest
+from helpers.cluster import ClickHouseCluster
+import helpers.keeper_utils as keeper_utils
+import random
+import string
+import os
+import time
+
+cluster = ClickHouseCluster(__file__)
+node1 = cluster.add_instance(
+    "node1",
+    main_configs=[
+        "configs/enable_keeper1.xml",
+        "configs/disk_s3_storage.xml",
+        "configs/keeper1_snapshot_disk.xml",
+    ],
+    stay_alive=True,
+    with_minio=True,
+)
+node2 = cluster.add_instance(
+    "node2",
+    main_configs=[
+        "configs/enable_keeper2.xml",
+        "configs/disk_s3_storage.xml",
+        "configs/keeper2_snapshot_disk.xml",
+    ],
+    stay_alive=True,
+    with_minio=True,
+)
+node3 = cluster.add_instance(
+    "node3",
+    main_configs=[
+        "configs/enable_keeper3.xml",
+        "configs/disk_s3_storage.xml",
+        "configs/keeper3_snapshot_disk.xml",
+    ],
+    stay_alive=True,
+    with_minio=True,
+)
+
+from kazoo.client import KazooClient, KazooState
+
+
+@pytest.fixture(scope="module")
+def started_cluster():
+    try:
+        cluster.start()
+
+        yield cluster
+
+    finally:
+        cluster.shutdown()
+
+
+def get_fake_zk(nodename, timeout=30.0):
+    _fake_zk_instance = KazooClient(
+        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
+    )
+    _fake_zk_instance.start()
+    return _fake_zk_instance
+
+
+def stop_zk(zk):
+    try:
+        if zk:
+            zk.stop()
+            zk.close()
+    except:
+        pass
+
+
+def test_recover_from_snapshot_with_disk_s3(started_cluster):
+    try:
+        node1_zk = node2_zk = node3_zk = None
+        node1_zk = get_fake_zk("node1")
+        node2_zk = get_fake_zk("node2")
+        node3_zk = get_fake_zk("node3")
+
+        node1_zk.create("/test_snapshot_multinode_recover", "somedata".encode())
+
+        node2_zk.sync("/test_snapshot_multinode_recover")
+        node3_zk.sync("/test_snapshot_multinode_recover")
+
+        assert node1_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+        assert node2_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+        assert node3_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+
+        node3.stop_clickhouse(kill=True)
+
+        # at least we will have 2 snapshots
+        for i in range(435):
+            node1_zk.create(
+                "/test_snapshot_multinode_recover" + str(i),
+                ("somedata" + str(i)).encode(),
+            )
+
+        for i in range(435):
+            if i % 10 == 0:
+                node1_zk.delete("/test_snapshot_multinode_recover" + str(i))
+
+    finally:
+        for zk in [node1_zk, node2_zk, node3_zk]:
+            stop_zk(zk)
+
+    # stale node should recover from leader's snapshot
+    # with some sanitizers can start longer than 5 seconds
+    node3.start_clickhouse(20)
+    keeper_utils.wait_until_connected(cluster, node3)
+    print("Restarted")
+
+    try:
+        node1_zk = node2_zk = node3_zk = None
+        node1_zk = get_fake_zk("node1")
+        node2_zk = get_fake_zk("node2")
+        node3_zk = get_fake_zk("node3")
+
+        node1_zk.sync("/test_snapshot_multinode_recover")
+        node2_zk.sync("/test_snapshot_multinode_recover")
+        node3_zk.sync("/test_snapshot_multinode_recover")
+
+        assert node1_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+        assert node2_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+        assert node3_zk.get("/test_snapshot_multinode_recover")[0] == b"somedata"
+
+        for i in range(435):
+            if i % 10 != 0:
+                assert (
+                    node1_zk.get("/test_snapshot_multinode_recover" + str(i))[0]
+                    == ("somedata" + str(i)).encode()
+                )
+                assert (
+                    node2_zk.get("/test_snapshot_multinode_recover" + str(i))[0]
+                    == ("somedata" + str(i)).encode()
+                )
+                assert (
+                    node3_zk.get("/test_snapshot_multinode_recover" + str(i))[0]
+                    == ("somedata" + str(i)).encode()
+                )
+            else:
+                assert (
+                    node1_zk.exists("/test_snapshot_multinode_recover" + str(i)) is None
+                )
+                assert (
+                    node2_zk.exists("/test_snapshot_multinode_recover" + str(i)) is None
+                )
+                assert (
+                    node3_zk.exists("/test_snapshot_multinode_recover" + str(i)) is None
+                )
+    finally:
+        for zk in [node1_zk, node2_zk, node3_zk]:
+            stop_zk(zk)

From 7ebe19f5fb1390bc5f2dac3a5cca7db9c76bdd98 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 25 May 2023 19:18:11 +0000
Subject: [PATCH 0160/1478] Fixing more tests

---
 src/Interpreters/ActionsVisitor.cpp           |  7 ++-
 src/Interpreters/Context.cpp                  | 15 +++++
 src/Interpreters/Context.h                    |  1 +
 src/Interpreters/DatabaseCatalog.h            |  3 +
 src/Interpreters/GlobalSubqueriesVisitor.h    | 19 ++++---
 src/Interpreters/InterpreterSelectQuery.cpp   |  2 +-
 src/Interpreters/PreparedSets.cpp             | 55 +++++++++++++++----
 src/Interpreters/PreparedSets.h               | 35 ++++--------
 src/Planner/CollectSets.cpp                   |  3 +-
 src/Planner/Planner.cpp                       |  2 +-
 src/Planner/PlannerActionsVisitor.cpp         |  8 ++-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  4 +-
 .../QueryPlan/DistributedCreateLocalPlan.cpp  |  4 +-
 .../QueryPlan/ReadFromMemoryStorageStep.cpp   |  6 +-
 .../QueryPlan/ReadFromMemoryStorageStep.h     |  2 +
 .../Transforms/CreatingSetsTransform.cpp      | 13 +++--
 .../Transforms/CreatingSetsTransform.h        |  5 +-
 src/QueryPipeline/QueryPipelineBuilder.cpp    |  4 +-
 src/QueryPipeline/QueryPipelineBuilder.h      |  5 +-
 src/Storages/StorageMemory.cpp                |  2 +-
 src/Storages/StorageMemory.h                  |  2 +
 21 files changed, 132 insertions(+), 65 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index da8666466fc..133fcbbfe87 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1405,6 +1405,8 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         if (auto set = data.prepared_sets->getFuture(set_key))
             return set;
 
+        FutureSetPtr external_table_set;
+
         /// A special case is if the name of the table is specified on the right side of the IN statement,
         ///  and the table has the type Set (a previously prepared set).
         if (identifier)
@@ -1417,6 +1419,9 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
                 if (StorageSet * storage_set = dynamic_cast<StorageSet *>(table.get()))
                     return data.prepared_sets->addFromStorage(set_key, storage_set->getSet());
             }
+
+            if (auto tmp_table = data.getContext()->findExternalTable(table_id.getShortName()))
+                external_table_set = tmp_table->future_set;
         }
 
         /// We get the stream of blocks for the subquery. Create Set and put it in place of the subquery.
@@ -1438,7 +1443,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             subquery_for_set.createSource(*interpreter);
         }
 
-        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set));
+        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), std::move(external_table_set));
     }
     else
     {
diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index d9f450191bc..f8fe99fbcc6 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -1319,6 +1319,21 @@ void Context::addExternalTable(const String & table_name, TemporaryTableHolder &
     external_tables_mapping.emplace(table_name, std::make_shared<TemporaryTableHolder>(std::move(temporary_table)));
 }
 
+std::shared_ptr<TemporaryTableHolder> Context::findExternalTable(const String & table_name) const
+{
+    if (isGlobalContext())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Global context cannot have external tables");
+
+    std::shared_ptr<TemporaryTableHolder> holder;
+    {
+        auto lock = getLock();
+        auto iter = external_tables_mapping.find(table_name);
+        if (iter == external_tables_mapping.end())
+            return {};
+        holder = iter->second;
+    }
+    return holder;
+}
 
 std::shared_ptr<TemporaryTableHolder> Context::removeExternalTable(const String & table_name)
 {
diff --git a/src/Interpreters/Context.h b/src/Interpreters/Context.h
index 1be662e0958..1a0ee891699 100644
--- a/src/Interpreters/Context.h
+++ b/src/Interpreters/Context.h
@@ -611,6 +611,7 @@ public:
 
     Tables getExternalTables() const;
     void addExternalTable(const String & table_name, TemporaryTableHolder && temporary_table);
+    std::shared_ptr<TemporaryTableHolder> findExternalTable(const String & table_name) const;
     std::shared_ptr<TemporaryTableHolder> removeExternalTable(const String & table_name);
 
     const Scalars & getScalars() const;
diff --git a/src/Interpreters/DatabaseCatalog.h b/src/Interpreters/DatabaseCatalog.h
index 51e9fbdb936..258ea2dee7c 100644
--- a/src/Interpreters/DatabaseCatalog.h
+++ b/src/Interpreters/DatabaseCatalog.h
@@ -79,6 +79,8 @@ private:
 
 using DDLGuardPtr = std::unique_ptr<DDLGuard>;
 
+class FutureSet;
+using FutureSetPtr = std::shared_ptr<FutureSet>;
 
 /// Creates temporary table in `_temporary_and_external_tables` with randomly generated unique StorageID.
 /// Such table can be accessed from everywhere by its ID.
@@ -111,6 +113,7 @@ struct TemporaryTableHolder : boost::noncopyable, WithContext
 
     IDatabase * temporary_tables = nullptr;
     UUID id = UUIDHelpers::Nil;
+    FutureSetPtr future_set;
 };
 
 ///TODO maybe remove shared_ptr from here?
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index a872af529aa..195839da04f 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -64,6 +64,7 @@ public:
 
         void addExternalStorage(ASTPtr & ast, bool set_alias = false)
         {
+            // std::cerr << "=============== addExternalStorage is remote " << is_remote << std::endl;
             /// With nondistributed queries, creating temporary tables does not make sense.
             if (!is_remote)
                 return;
@@ -163,10 +164,10 @@ public:
             /// We need to materialize external tables immediately because reading from distributed
             /// tables might generate local plans which can refer to external tables during index
             /// analysis. It's too late to populate the external table via CreatingSetsTransform.
-            if (is_explain)
-            {
-                /// Do not materialize external tables if it's explain statement.
-            }
+            // if (is_explain)
+            // {
+            //     /// Do not materialize external tables if it's explain statement.
+            // }
             // else if (getContext()->getSettingsRef().use_index_for_in_with_subqueries)
             // {
             //     auto external_table = external_storage_holder->getTable();
@@ -176,13 +177,15 @@ public:
             //     CompletedPipelineExecutor executor(io.pipeline);
             //     executor.execute();
             // }
-            else
+            // else
             {
                 // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
                 // subquery_for_set.createSource(*interpreter, external_storage);
                 auto key = subquery_or_table_name->getColumnName();
                 auto set_key = PreparedSetKey::forSubquery(database_and_table_name->getTreeHash());
 
+                // std::cerr << "====== Adding key " << set_key.toString() << std::endl;
+
                 if (!prepared_sets->getFuture(set_key))
                 {
                     SubqueryForSet subquery_for_set;
@@ -191,10 +194,12 @@ public:
                     subquery_for_set.createSource(*interpreter);
 
                     //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
-                    prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set));
+                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), nullptr);
+                    external_storage_holder->future_set = std::move(future_set);
                 }
                 else
-                    prepared_sets->addStorageToSubquery(key, std::move(external_storage));
+                    throw Exception(ErrorCodes::LOGICAL_ERROR, "!!!!!!!!");
+                    //prepared_sets->addStorageToSubquery(key, std::move(external_storage));
             }
 
             /** NOTE If it was written IN tmp_table - the existing temporary (but not external) table,
diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index 8d305c07ce9..28a0e27384a 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -3088,7 +3088,7 @@ void InterpreterSelectQuery::executeExtremes(QueryPlan & query_plan)
 
 void InterpreterSelectQuery::executeSubqueriesInSetsAndJoins(QueryPlan & query_plan)
 {
-    auto subqueries = prepared_sets->detachSubqueries(context);
+    auto subqueries = prepared_sets->detachSubqueries();
 
     if (!subqueries.empty())
     {
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index eebc59e85d5..f2b70462227 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -101,14 +101,14 @@ String PreparedSetKey::toString() const
 
 /// If the subquery is not associated with any set, create default-constructed SubqueryForSet.
 /// It's aimed to fill external table passed to SubqueryForSet::createSource.
-void PreparedSets::addStorageToSubquery(const String & subquery_id, StoragePtr storage)
-{
-    auto it = subqueries.find(subquery_id);
-    if (it == subqueries.end())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot find subquery {}", subquery_id);
+// void PreparedSets::addStorageToSubquery(const String & subquery_id, StoragePtr storage)
+// {
+//     auto it = subqueries.find(subquery_id);
+//     if (it == subqueries.end())
+//         throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot find subquery {}", subquery_id);
 
-    it->second->addStorage(std::move(storage));
-}
+//     it->second->addStorage(std::move(storage));
+// }
 
 FutureSetPtr PreparedSets::addFromStorage(const PreparedSetKey & key, SetPtr set_)
 {
@@ -132,10 +132,10 @@ FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block,
     return it->second;
 }
 
-FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery)
+FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, FutureSetPtr external_table_set)
 {
     auto id = subquery.key;
-    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery));
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set));
     auto [it, inserted] = sets.emplace(key, from_subquery);
 
     if (!inserted)
@@ -145,7 +145,7 @@ FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryF
     // std::cerr << "========= PreparedSets::addFromSubquery\n";
     // std::cerr << StackTrace().toString() << std::endl;
 
-    subqueries.emplace(id, std::move(from_subquery));
+    subqueries.emplace_back(SetAndName{.name = id, .set = std::move(from_subquery)});
     return it->second;
 }
 
@@ -176,7 +176,7 @@ FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 //     return res;
 // }
 
-PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries(const ContextPtr &)
+PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries()
 {
     auto res = std::move(subqueries);
     subqueries = SubqueriesForSets();
@@ -226,6 +226,36 @@ std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseTo
     return promise_to_fill_set;
 }
 
+SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
+{
+    if (!context->getSettingsRef().use_index_for_in_with_subqueries)
+        return nullptr;
+
+    if (set)
+    {
+        if (set->hasExplicitSetElements())
+            return set;
+
+        return nullptr;
+    }
+
+    if (external_table_set)
+        return set = external_table_set->buildOrderedSetInplace(context);
+
+    auto plan = buildPlan(context, true);
+    if (!plan)
+        return nullptr;
+
+    auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
+    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
+    pipeline.complete(std::make_shared<EmptySink>(Block()));
+
+    CompletedPipelineExecutor executor(pipeline);
+    executor.execute();
+
+    return set;
+}
+
 std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context, bool create_ordered_set)
 {
     if (set)
@@ -313,7 +343,8 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
     //block(std::move(block_))
 }
 
-FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_) : subquery(std::move(subquery_)) {}
+FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_)
+    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_)) {}
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
 
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 35bbc1e12fb..c510e690e25 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -132,30 +132,13 @@ public:
 class FutureSetFromSubquery : public FutureSet
 {
 public:
-    FutureSetFromSubquery(SubqueryForSet subquery_);
+    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_);
 
     bool isReady() const override { return set != nullptr; }
     bool isFilled() const override { return isReady(); }
     SetPtr get() const override { return set; }
 
-    SetPtr buildOrderedSetInplace(const ContextPtr & context) override
-    {
-        if (!context->getSettingsRef().use_index_for_in_with_subqueries)
-            return nullptr;
-
-        auto plan = buildPlan(context, true);
-        if (!plan)
-            return nullptr;
-
-        auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
-        auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
-        pipeline.complete(std::make_shared<EmptySink>(Block()));
-
-        CompletedPipelineExecutor executor(pipeline);
-        executor.execute();
-
-        return set;
-    }
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
     std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
     {
@@ -167,6 +150,7 @@ public:
 private:
     SetPtr set;
     SubqueryForSet subquery;
+    FutureSetPtr external_table_set;
 
     std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
 };
@@ -244,16 +228,21 @@ struct PreparedSetKey
 class PreparedSets
 {
 public:
-    using SubqueriesForSets = std::unordered_map<String, std::shared_ptr<FutureSetFromSubquery>>;
+    struct SetAndName
+    {
+        String name;
+        std::shared_ptr<FutureSetFromSubquery> set;
+    };
+    using SubqueriesForSets = std::vector<SetAndName>;
 
     // SubqueryForSet & createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
     //                                      SizeLimits set_size_limit, bool transform_null_in);
 
     FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
     FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings);
-    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery);
+    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, FutureSetPtr external_table_set);
 
-    void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
+    //void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
 
     FutureSetPtr getFuture(const PreparedSetKey & key) const;
     //SubqueryForSet & getSubquery(const String & subquery_id);
@@ -262,7 +251,7 @@ public:
     /// Get subqueries and clear them.
     /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
     /// SetPtr would still be available for consumers of PreparedSets.
-    SubqueriesForSets detachSubqueries(const ContextPtr &);
+    SubqueriesForSets detachSubqueries();
 
     /// Returns all sets that match the given ast hash not checking types
     /// Used in KeyCondition and MergeTreeIndexConditionBloomFilter to make non exact match for types in PreparedSetKey
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index d66424f89ec..19dc569ff0c 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -107,7 +107,8 @@ public:
             subquery_for_set.key = planner_context.createSetKey(in_second_argument);
             subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
 
-            sets.addFromSubquery(set_key, std::move(subquery_for_set));
+            /// TODO
+            sets.addFromSubquery(set_key, std::move(subquery_for_set), nullptr);
 
             //planner_context.registerSet(set_key, PlannerSet(in_second_argument));
         }
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index b1780212e51..5c3fc82a80b 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -1468,7 +1468,7 @@ void Planner::buildPlanForQueryNode()
 
     if (!select_query_options.only_analyze)
     {
-        auto subqueries = planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext());
+        auto subqueries = planner_context->getPreparedSets().detachSubqueries();
 
         if (!subqueries.empty())
         {
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index e0844a6d2b1..bbac9bf5c4b 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -632,7 +632,13 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
     DataTypes set_element_types;
 
     auto in_second_argument_node_type = in_second_argument->getNodeType();
-    if (!(in_second_argument_node_type == QueryTreeNodeType::QUERY || in_second_argument_node_type == QueryTreeNodeType::UNION))
+    // std::cerr << "=========== " << in_second_argument->getNodeTypeName() << std::endl;
+    bool subquery_or_table =
+        in_second_argument_node_type == QueryTreeNodeType::QUERY ||
+        in_second_argument_node_type == QueryTreeNodeType::UNION ||
+        in_second_argument_node_type == QueryTreeNodeType::TABLE;
+
+    if (!subquery_or_table)
     {
         set_element_types = {in_first_argument->getResultType()};
         const auto * left_tuple_type = typeid_cast<const DataTypeTuple *>(set_element_types.front().get());
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 34018b2144c..38506412531 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -48,7 +48,7 @@ CreatingSetStep::CreatingSetStep(
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)
 {
-    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(subquery_for_set), network_transfer_limits, context);
+    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(subquery_for_set), network_transfer_limits, context->getPreparedSetsCache());
 }
 
 void CreatingSetStep::updateOutputStream()
@@ -189,7 +189,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets,
     if (!prepared_sets || prepared_sets->empty())
         return;
 
-    addCreatingSetsStep(query_plan, prepared_sets->detachSubqueries(context), context);
+    addCreatingSetsStep(query_plan, prepared_sets->detachSubqueries(), context);
 }
 
 DelayedCreatingSetsStep::DelayedCreatingSetsStep(
diff --git a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
index 62e369659d1..8e2221d564d 100644
--- a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
+++ b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
@@ -43,7 +43,7 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     const Block & header,
     ContextPtr context,
     QueryProcessingStage::Enum processed_stage,
-    PreparedSetsPtr prepared_sets,
+    [[maybe_unused]] PreparedSetsPtr prepared_sets,
     size_t shard_num,
     size_t shard_count,
     size_t replica_num,
@@ -99,7 +99,7 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     }
     else
     {
-        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options, prepared_sets);
+        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options); //, prepared_sets);
         interpreter.buildQueryPlan(*query_plan);
     }
 
diff --git a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
index 2080c31d253..4ad3cc7373a 100644
--- a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
+++ b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
@@ -96,11 +96,13 @@ private:
 };
 
 ReadFromMemoryStorageStep::ReadFromMemoryStorageStep(const Names & columns_to_read_,
+                                                     StoragePtr storage_,
                                                      const StorageSnapshotPtr & storage_snapshot_,
                                                      const size_t num_streams_,
                                                      const bool delay_read_for_global_sub_queries_) :
     SourceStepWithFilter(DataStream{.header=storage_snapshot_->getSampleBlockForColumns(columns_to_read_)}),
     columns_to_read(columns_to_read_),
+    storage(std::move(storage_)),
     storage_snapshot(storage_snapshot_),
     num_streams(num_streams_),
     delay_read_for_global_sub_queries(delay_read_for_global_sub_queries_)
@@ -142,9 +144,9 @@ Pipe ReadFromMemoryStorageStep::makePipe()
             storage_snapshot,
             nullptr /* data */,
             nullptr /* parallel execution index */,
-            [current_data](std::shared_ptr<const Blocks> & data_to_initialize)
+            [storage = storage](std::shared_ptr<const Blocks> & data_to_initialize)
             {
-                data_to_initialize = current_data;
+                data_to_initialize = static_cast<const StorageMemory &>(*storage).data.get();
             }));
     }
 
diff --git a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.h b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.h
index cec523ed58b..1122bfbb2a5 100644
--- a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.h
+++ b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.h
@@ -16,6 +16,7 @@ class ReadFromMemoryStorageStep final : public SourceStepWithFilter
 {
 public:
     ReadFromMemoryStorageStep(const Names & columns_to_read_,
+                              StoragePtr storage_,
                               const StorageSnapshotPtr & storage_snapshot_,
                               size_t num_streams_,
                               bool delay_read_for_global_sub_queries_);
@@ -35,6 +36,7 @@ private:
     static constexpr auto name = "ReadFromMemoryStorage";
 
     Names columns_to_read;
+    StoragePtr storage;
     StorageSnapshotPtr storage_snapshot;
     size_t num_streams;
     bool delay_read_for_global_sub_queries;
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index 6626d4b9795..24e17ff210f 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -27,11 +27,11 @@ CreatingSetsTransform::CreatingSetsTransform(
     Block out_header_,
     SubqueryForSet subquery_for_set_,
     SizeLimits network_transfer_limits_,
-    ContextPtr context_)
+    PreparedSetsCachePtr prepared_sets_cache_)
     : IAccumulatingTransform(std::move(in_header_), std::move(out_header_))
-    , WithContext(context_)
     , subquery(std::move(subquery_for_set_))
     , network_transfer_limits(std::move(network_transfer_limits_))
+    , prepared_sets_cache(std::move(prepared_sets_cache_))
 {
 }
 
@@ -52,14 +52,13 @@ void CreatingSetsTransform::work()
 void CreatingSetsTransform::startSubquery()
 {
     /// Lookup the set in the cache if we don't need to build table.
-    auto ctx = context.lock();
-    if (ctx && ctx->getPreparedSetsCache() && !subquery.table)
+    if (prepared_sets_cache && !subquery.table)
     {
         /// Try to find the set in the cache and wait for it to be built.
         /// Retry if the set from cache fails to be built.
         while (true)
         {
-            auto from_cache = ctx->getPreparedSetsCache()->findOrPromiseToBuild(subquery.key);
+            auto from_cache = prepared_sets_cache->findOrPromiseToBuild(subquery.key);
             if (from_cache.index() == 0)
             {
                 promise_to_build = std::move(std::get<0>(from_cache));
@@ -89,9 +88,11 @@ void CreatingSetsTransform::startSubquery()
     if (subquery.table)
         LOG_TRACE(log, "Filling temporary table.");
 
+    // std::cerr << StackTrace().toString() << std::endl;
+
     if (subquery.table)
         /// TODO: make via port
-        table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), getContext()));
+        table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), nullptr));
 
     done_with_set = !subquery.set;
     done_with_table = !subquery.table;
diff --git a/src/Processors/Transforms/CreatingSetsTransform.h b/src/Processors/Transforms/CreatingSetsTransform.h
index 26bbc45933d..ef586b0655c 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.h
+++ b/src/Processors/Transforms/CreatingSetsTransform.h
@@ -23,7 +23,7 @@ class PushingPipelineExecutor;
 /// Don't return any data. Sets are created when Finish status is returned.
 /// In general, several work() methods need to be called to finish.
 /// Independent processors is created for each subquery.
-class CreatingSetsTransform : public IAccumulatingTransform, WithContext
+class CreatingSetsTransform : public IAccumulatingTransform
 {
 public:
     CreatingSetsTransform(
@@ -31,7 +31,7 @@ public:
         Block out_header_,
         SubqueryForSet subquery_for_set_,
         SizeLimits network_transfer_limits_,
-        ContextPtr context_);
+        PreparedSetsCachePtr prepared_sets_cache_);
 
     ~CreatingSetsTransform() override;
 
@@ -55,6 +55,7 @@ private:
     bool done_with_table = true;
 
     SizeLimits network_transfer_limits;
+    PreparedSetsCachePtr prepared_sets_cache;
 
     size_t rows_to_transfer = 0;
     size_t bytes_to_transfer = 0;
diff --git a/src/QueryPipeline/QueryPipelineBuilder.cpp b/src/QueryPipeline/QueryPipelineBuilder.cpp
index 764997e7b7e..4898501b980 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.cpp
+++ b/src/QueryPipeline/QueryPipelineBuilder.cpp
@@ -569,7 +569,7 @@ std::unique_ptr<QueryPipelineBuilder> QueryPipelineBuilder::joinPipelinesRightLe
     return left;
 }
 
-void QueryPipelineBuilder::addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, ContextPtr context)
+void QueryPipelineBuilder::addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, PreparedSetsCachePtr prepared_sets_cache)
 {
     resize(1);
 
@@ -578,7 +578,7 @@ void QueryPipelineBuilder::addCreatingSetsTransform(const Block & res_header, Su
             res_header,
             std::move(subquery_for_set),
             limits,
-            context);
+            std::move(prepared_sets_cache));
 
     InputPort * totals_port = nullptr;
 
diff --git a/src/QueryPipeline/QueryPipelineBuilder.h b/src/QueryPipeline/QueryPipelineBuilder.h
index 3a5d65d4388..85b6f5c6772 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.h
+++ b/src/QueryPipeline/QueryPipelineBuilder.h
@@ -33,6 +33,9 @@ class TableJoin;
 class QueryPipelineBuilder;
 using QueryPipelineBuilderPtr = std::unique_ptr<QueryPipelineBuilder>;
 
+class PreparedSetsCache;
+using PreparedSetsCachePtr = std::shared_ptr<PreparedSetsCache>;
+
 class QueryPipelineBuilder
 {
 public:
@@ -138,7 +141,7 @@ public:
     /// This is used for CreatingSets.
     void addPipelineBefore(QueryPipelineBuilder pipeline);
 
-    void addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, ContextPtr context);
+    void addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, PreparedSetsCachePtr prepared_sets_cache);
 
     PipelineExecutorPtr execute();
 
diff --git a/src/Storages/StorageMemory.cpp b/src/Storages/StorageMemory.cpp
index 31e45db55cb..1392ed5c684 100644
--- a/src/Storages/StorageMemory.cpp
+++ b/src/Storages/StorageMemory.cpp
@@ -155,7 +155,7 @@ void StorageMemory::read(
     size_t /*max_block_size*/,
     size_t num_streams)
 {
-    query_plan.addStep(std::make_unique<ReadFromMemoryStorageStep>(column_names, storage_snapshot, num_streams, delay_read_for_global_subqueries));
+    query_plan.addStep(std::make_unique<ReadFromMemoryStorageStep>(column_names, shared_from_this(), storage_snapshot, num_streams, delay_read_for_global_subqueries));
 }
 
 
diff --git a/src/Storages/StorageMemory.h b/src/Storages/StorageMemory.h
index ce8a59b8bcd..31c8ee31f8b 100644
--- a/src/Storages/StorageMemory.h
+++ b/src/Storages/StorageMemory.h
@@ -132,6 +132,8 @@ private:
     std::atomic<size_t> total_size_rows = 0;
 
     bool compress;
+
+    friend class ReadFromMemoryStorageStep;
 };
 
 }

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 0161/1478] 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 42e1e3ae208ed6488b7f30e6e87c88be38b07b17 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 25 May 2023 20:24:03 +0000
Subject: [PATCH 0162/1478] Fix working with secure socket after async
 connection

---
 src/Client/Connection.cpp            |  5 -----
 src/IO/ReadBufferFromPocoSocket.cpp  | 28 +++++++++++++++++++++-------
 src/IO/ReadBufferFromPocoSocket.h    |  2 ++
 src/IO/WriteBufferFromPocoSocket.cpp | 27 +++++++++++++++++++++------
 src/IO/WriteBufferFromPocoSocket.h   |  2 ++
 5 files changed, 46 insertions(+), 18 deletions(-)

diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index d39148d3016..451d29d4091 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -138,11 +138,6 @@ void Connection::connect(const ConnectionTimeouts & timeouts)
                         socket->impl()->error(err); // Throws an exception
 
                     socket->setBlocking(true);
-
-#if USE_SSL
-                    if (static_cast<bool>(secure))
-                        static_cast<Poco::Net::SecureStreamSocket *>(socket.get())->completeHandshake();
-#endif
                 }
                 else
                 {
diff --git a/src/IO/ReadBufferFromPocoSocket.cpp b/src/IO/ReadBufferFromPocoSocket.cpp
index d0fba2c28e8..4ceba347707 100644
--- a/src/IO/ReadBufferFromPocoSocket.cpp
+++ b/src/IO/ReadBufferFromPocoSocket.cpp
@@ -9,6 +9,7 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
+#include <Poco/Net/SecureStreamSocket.h>
 
 namespace ProfileEvents
 {
@@ -49,16 +50,18 @@ bool ReadBufferFromPocoSocket::nextImpl()
     {
         CurrentMetrics::Increment metric_increment(CurrentMetrics::NetworkReceive);
 
-        /// If async_callback is specified, and read will block, run async_callback and try again later.
-        /// It is expected that file descriptor may be polled externally.
-        /// Note that receive timeout is not checked here. External code should check it while polling.
-        while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_READ | Poco::Net::Socket::SELECT_ERROR))
-            async_callback(socket.impl()->sockfd(), socket.getReceiveTimeout(), AsyncEventTimeoutType::RECEIVE, socket_description, AsyncTaskExecutor::Event::READ | AsyncTaskExecutor::Event::ERROR);
-
         if (internal_buffer.size() > INT_MAX)
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Buffer overflow");
 
-        bytes_read = socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
+        bytes_read = readFromSocket();
+
+        /// In case of non-blocking connect for secure socket receiveBytes can return ERR_SSL_WANT_READ,
+        /// in this case we should call receiveBytes again when socket is ready.
+        if (socket.secure())
+        {
+            while (bytes_read == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ)
+                bytes_read = readFromSocket();
+        }
     }
     catch (const Poco::Net::NetException & e)
     {
@@ -86,6 +89,17 @@ bool ReadBufferFromPocoSocket::nextImpl()
     return true;
 }
 
+ssize_t ReadBufferFromPocoSocket::readFromSocket()
+{
+    /// If async_callback is specified, and read will block, run async_callback and try again later.
+    /// It is expected that file descriptor may be polled externally.
+    /// Note that receive timeout is not checked here. External code should check it while polling.
+    while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_READ | Poco::Net::Socket::SELECT_ERROR))
+        async_callback(socket.impl()->sockfd(), socket.getReceiveTimeout(), AsyncEventTimeoutType::RECEIVE, socket_description, AsyncTaskExecutor::Event::READ | AsyncTaskExecutor::Event::ERROR);
+
+    return socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
+}
+
 ReadBufferFromPocoSocket::ReadBufferFromPocoSocket(Poco::Net::Socket & socket_, size_t buf_size)
     : BufferWithOwnMemory<ReadBuffer>(buf_size)
     , socket(socket_)
diff --git a/src/IO/ReadBufferFromPocoSocket.h b/src/IO/ReadBufferFromPocoSocket.h
index dab4ac86295..3c4bc424334 100644
--- a/src/IO/ReadBufferFromPocoSocket.h
+++ b/src/IO/ReadBufferFromPocoSocket.h
@@ -30,6 +30,8 @@ public:
     void setAsyncCallback(AsyncCallback async_callback_) { async_callback = std::move(async_callback_); }
 
 private:
+    ssize_t readFromSocket();
+
     AsyncCallback async_callback;
     std::string socket_description;
 };
diff --git a/src/IO/WriteBufferFromPocoSocket.cpp b/src/IO/WriteBufferFromPocoSocket.cpp
index 039110dfb62..27fc78e5fe3 100644
--- a/src/IO/WriteBufferFromPocoSocket.cpp
+++ b/src/IO/WriteBufferFromPocoSocket.cpp
@@ -10,6 +10,7 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
+#include <Poco/Net/SecureStreamSocket.h>
 
 
 namespace ProfileEvents
@@ -62,13 +63,15 @@ void WriteBufferFromPocoSocket::nextImpl()
             if (size > INT_MAX)
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "Buffer overflow");
 
-            /// If async_callback is specified, and write will block, run async_callback and try again later.
-            /// It is expected that file descriptor may be polled externally.
-            /// Note that send timeout is not checked here. External code should check it while polling.
-            while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_WRITE | Poco::Net::Socket::SELECT_ERROR))
-                async_callback(socket.impl()->sockfd(), socket.getSendTimeout(), AsyncEventTimeoutType::SEND, socket_description, AsyncTaskExecutor::Event::WRITE | AsyncTaskExecutor::Event::ERROR);
+            res = writeToSocket(pos, size);
 
-            res = socket.impl()->sendBytes(pos, static_cast<int>(size));
+            /// In case of non-blocking connect for secure socket sendBytes can return ERR_SSL_WANT_READ,
+            /// in this case we should call sendBytes again when socket is ready.
+            if (socket.secure())
+            {
+                while (res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE)
+                    res = writeToSocket(pos, size);
+            }
         }
         catch (const Poco::Net::NetException & e)
         {
@@ -95,6 +98,18 @@ void WriteBufferFromPocoSocket::nextImpl()
     }
 }
 
+ssize_t WriteBufferFromPocoSocket::writeToSocket(char * data, size_t size)
+{
+    /// If async_callback is specified, and write will block, run async_callback and try again later.
+    /// It is expected that file descriptor may be polled externally.
+    /// Note that send timeout is not checked here. External code should check it while polling.
+    while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_WRITE | Poco::Net::Socket::SELECT_ERROR))
+        async_callback(socket.impl()->sockfd(), socket.getSendTimeout(), AsyncEventTimeoutType::SEND, socket_description, AsyncTaskExecutor::Event::WRITE | AsyncTaskExecutor::Event::ERROR);
+
+    return socket.impl()->sendBytes(data, static_cast<int>(size));
+
+}
+
 WriteBufferFromPocoSocket::WriteBufferFromPocoSocket(Poco::Net::Socket & socket_, size_t buf_size)
     : BufferWithOwnMemory<WriteBuffer>(buf_size)
     , socket(socket_)
diff --git a/src/IO/WriteBufferFromPocoSocket.h b/src/IO/WriteBufferFromPocoSocket.h
index ecb61020357..0f03e816af5 100644
--- a/src/IO/WriteBufferFromPocoSocket.h
+++ b/src/IO/WriteBufferFromPocoSocket.h
@@ -35,6 +35,8 @@ protected:
     Poco::Net::SocketAddress our_address;
 
 private:
+    ssize_t writeToSocket(char * data, size_t size);
+
     AsyncCallback async_callback;
     std::string socket_description;
 };

From 1964d1bb7e55c5827837aa4ac083da3c2c8f39db Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 25 May 2023 22:30:16 +0200
Subject: [PATCH 0163/1478] Fix comment

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

diff --git a/src/IO/WriteBufferFromPocoSocket.cpp b/src/IO/WriteBufferFromPocoSocket.cpp
index 27fc78e5fe3..ed58e37ddee 100644
--- a/src/IO/WriteBufferFromPocoSocket.cpp
+++ b/src/IO/WriteBufferFromPocoSocket.cpp
@@ -65,7 +65,7 @@ void WriteBufferFromPocoSocket::nextImpl()
 
             res = writeToSocket(pos, size);
 
-            /// In case of non-blocking connect for secure socket sendBytes can return ERR_SSL_WANT_READ,
+            /// In case of non-blocking connect for secure socket sendBytes can return ERR_SSL_WANT_WRITE,
             /// in this case we should call sendBytes again when socket is ready.
             if (socket.secure())
             {

From 613568423d7b34a80d9c5a1688865122f1136a07 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuk <Demilivor@mail.ru>
Date: Fri, 26 May 2023 07:49:45 +1000
Subject: [PATCH 0164/1478] Update
 src/Processors/Formats/Impl/CSVRowInputFormat.cpp

Co-authored-by: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
---
 src/Processors/Formats/Impl/CSVRowInputFormat.cpp | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index 9922bd41442..6593567a581 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -282,15 +282,7 @@ bool CSVFormatReader::readField(
     bool is_last_file_column,
     const String & /*column_name*/)
 {
-    if (format_settings.csv.trim_whitespaces) [[likely]]
-        skipWhitespacesAndTabs(*buf);
-    else if (type->isNullable())
-    {
-        auto nested_type = typeid_cast<const DataTypeNullable *>(type.get())->getNestedType();
-        if (!isStringOrFixedString(nested_type))
-            skipWhitespacesAndTabs(*buf);
-    }
-    else if (!isStringOrFixedString(type))
+    if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(RemoveNullable(type))) [[likely]]
         skipWhitespacesAndTabs(*buf);
 
     const bool at_delimiter = !buf->eof() && *buf->position() == format_settings.csv.delimiter;

From a9082b24b40a9b09ce057836b4b5d55bf7bb491b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 26 May 2023 00:20:20 +0200
Subject: [PATCH 0165/1478] Fix build

---
 src/IO/ReadBufferFromPocoSocket.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/IO/ReadBufferFromPocoSocket.cpp b/src/IO/ReadBufferFromPocoSocket.cpp
index 4ceba347707..11acd3a9136 100644
--- a/src/IO/ReadBufferFromPocoSocket.cpp
+++ b/src/IO/ReadBufferFromPocoSocket.cpp
@@ -9,7 +9,10 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
+
+#if USE_SSL
 #include <Poco/Net/SecureStreamSocket.h>
+#endif
 
 namespace ProfileEvents
 {

From 67b78829fcc74407418db922f1ef58cfe8e1b6ad Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 26 May 2023 00:21:14 +0200
Subject: [PATCH 0166/1478] Fix build

---
 src/IO/ReadBufferFromPocoSocket.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/IO/ReadBufferFromPocoSocket.cpp b/src/IO/ReadBufferFromPocoSocket.cpp
index 11acd3a9136..c051478afc5 100644
--- a/src/IO/ReadBufferFromPocoSocket.cpp
+++ b/src/IO/ReadBufferFromPocoSocket.cpp
@@ -58,6 +58,7 @@ bool ReadBufferFromPocoSocket::nextImpl()
 
         bytes_read = readFromSocket();
 
+#if USE_SSL
         /// In case of non-blocking connect for secure socket receiveBytes can return ERR_SSL_WANT_READ,
         /// in this case we should call receiveBytes again when socket is ready.
         if (socket.secure())
@@ -65,6 +66,7 @@ bool ReadBufferFromPocoSocket::nextImpl()
             while (bytes_read == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ)
                 bytes_read = readFromSocket();
         }
+#endif
     }
     catch (const Poco::Net::NetException & e)
     {

From f03ca41b081630061f57d3c3b1b1938c4ddcb759 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 26 May 2023 00:21:46 +0200
Subject: [PATCH 0167/1478] Fix build

---
 src/IO/WriteBufferFromPocoSocket.cpp | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/IO/WriteBufferFromPocoSocket.cpp b/src/IO/WriteBufferFromPocoSocket.cpp
index ed58e37ddee..e566c228534 100644
--- a/src/IO/WriteBufferFromPocoSocket.cpp
+++ b/src/IO/WriteBufferFromPocoSocket.cpp
@@ -10,8 +10,10 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
-#include <Poco/Net/SecureStreamSocket.h>
 
+#if USE_SSL
+#include <Poco/Net/SecureStreamSocket.h>
+#endif
 
 namespace ProfileEvents
 {
@@ -65,6 +67,7 @@ void WriteBufferFromPocoSocket::nextImpl()
 
             res = writeToSocket(pos, size);
 
+#if USE_SSL
             /// In case of non-blocking connect for secure socket sendBytes can return ERR_SSL_WANT_WRITE,
             /// in this case we should call sendBytes again when socket is ready.
             if (socket.secure())
@@ -72,6 +75,7 @@ void WriteBufferFromPocoSocket::nextImpl()
                 while (res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE)
                     res = writeToSocket(pos, size);
             }
+#endif
         }
         catch (const Poco::Net::NetException & e)
         {

From 01f3a46cf06d168452a8cbbca76b1c083355d63b Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Thu, 25 May 2023 22:49:36 +0000
Subject: [PATCH 0168/1478] fixed wrong case in removeNullable

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

diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index 6593567a581..8b4dbbffe1d 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -282,7 +282,7 @@ bool CSVFormatReader::readField(
     bool is_last_file_column,
     const String & /*column_name*/)
 {
-    if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(RemoveNullable(type))) [[likely]]
+    if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(removeNullable(type))) [[likely]]
         skipWhitespacesAndTabs(*buf);
 
     const bool at_delimiter = !buf->eof() && *buf->position() == format_settings.csv.delimiter;

From 2a2c35e4c11fe1ef245577cb8c1f2cc1db5f9284 Mon Sep 17 00:00:00 2001
From: Aleksei Filatov <alexfvk@yandex-team.ru>
Date: Thu, 25 May 2023 18:14:16 +0300
Subject: [PATCH 0169/1478] Fix changed IP for https session

---
 .../Net/include/Poco/Net/HTTPClientSession.h  |  3 +
 src/IO/HTTPCommon.cpp                         | 29 ++++--
 .../configs/listen_host.xml                   |  3 +
 .../test_https_replication/test_change_ip.py  | 96 +++++++++++++++++++
 4 files changed, 123 insertions(+), 8 deletions(-)
 create mode 100644 tests/integration/test_https_replication/configs/listen_host.xml
 create mode 100644 tests/integration/test_https_replication/test_change_ip.py

diff --git a/base/poco/Net/include/Poco/Net/HTTPClientSession.h b/base/poco/Net/include/Poco/Net/HTTPClientSession.h
index 6f67918d2c8..d495d662f75 100644
--- a/base/poco/Net/include/Poco/Net/HTTPClientSession.h
+++ b/base/poco/Net/include/Poco/Net/HTTPClientSession.h
@@ -127,6 +127,9 @@ namespace Net
 
         void setResolvedHost(std::string resolved_host) { _resolved_host.swap(resolved_host); }
 
+        std::string getResolvedHost() const { return _resolved_host; }
+        /// Returns the resolved IP address of the target HTTP server.
+
         Poco::UInt16 getPort() const;
         /// Returns the port number of the target HTTP server.
 
diff --git a/src/IO/HTTPCommon.cpp b/src/IO/HTTPCommon.cpp
index 4bea646a42b..3ec9b3d0a83 100644
--- a/src/IO/HTTPCommon.cpp
+++ b/src/IO/HTTPCommon.cpp
@@ -68,7 +68,8 @@ namespace
         if (https)
         {
 #if USE_SSL
-            String resolved_host = resolve_host ? DNSResolver::instance().resolveHost(host).toString() : host;
+            /// Cannot resolve host in advance, otherwise SNI won't work in Poco.
+            /// For more information about SNI, see the https://en.wikipedia.org/wiki/Server_Name_Indication
             auto https_session = std::make_shared<Poco::Net::HTTPSClientSession>(host, port);
             if (resolve_host)
                 https_session->setResolvedHost(DNSResolver::instance().resolveHost(host).toString());
@@ -184,6 +185,24 @@ namespace
         std::mutex mutex;
         std::unordered_map<Key, PoolPtr, Hasher> endpoints_pool;
 
+        void updateHostIfIpChanged(Entry & session, const String & new_ip)
+        {
+            const auto old_ip = session->getResolvedHost().empty() ? session->getHost() : session->getResolvedHost();
+
+            if (new_ip != old_ip)
+            {
+                session->reset();
+                if (session->getResolvedHost().empty())
+                {
+                    session->setHost(new_ip);
+                }
+                else
+                {
+                    session->setResolvedHost(new_ip);
+                }
+            }
+        }
+
     protected:
         HTTPSessionPool() = default;
 
@@ -238,13 +257,7 @@ namespace
 
                     if (resolve_host)
                     {
-                        /// Host can change IP
-                        const auto ip = DNSResolver::instance().resolveHost(host).toString();
-                        if (ip != session->getHost())
-                        {
-                            session->reset();
-                            session->setHost(ip);
-                        }
+                        updateHostIfIpChanged(session, DNSResolver::instance().resolveHost(host).toString());
                     }
                 }
                 /// Reset the message, once it has been printed,
diff --git a/tests/integration/test_https_replication/configs/listen_host.xml b/tests/integration/test_https_replication/configs/listen_host.xml
new file mode 100644
index 00000000000..f94e5c88568
--- /dev/null
+++ b/tests/integration/test_https_replication/configs/listen_host.xml
@@ -0,0 +1,3 @@
+<clickhouse>
+    <listen_host>::</listen_host>
+</clickhouse>
diff --git a/tests/integration/test_https_replication/test_change_ip.py b/tests/integration/test_https_replication/test_change_ip.py
new file mode 100644
index 00000000000..14fe5351c8d
--- /dev/null
+++ b/tests/integration/test_https_replication/test_change_ip.py
@@ -0,0 +1,96 @@
+import pytest
+from helpers.cluster import ClickHouseCluster
+from helpers.test_tools import assert_eq_with_retry
+
+"""
+Both ssl_conf.xml and no_ssl_conf.xml have the same port
+"""
+
+
+def _fill_nodes(nodes, shard):
+    for node in nodes:
+        node.query(
+            """
+                CREATE DATABASE test;
+    
+                CREATE TABLE test_table(date Date, id UInt32)
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test{shard}/replicated', '{replica}') PARTITION BY toYYYYMM(date) ORDER BY id;
+            """.format(
+                shard=shard, replica=node.name
+            )
+        )
+
+
+cluster = ClickHouseCluster(__file__)
+node1 = cluster.add_instance(
+    "node1",
+    main_configs=[
+        "configs/remote_servers.xml",
+        "configs/listen_host.xml",
+        "configs/ssl_conf.xml",
+        "configs/server.crt",
+        "configs/server.key",
+        "configs/dhparam.pem",
+    ],
+    with_zookeeper=True,
+    ipv6_address="2001:3984:3989::1:1111",
+)
+node2 = cluster.add_instance(
+    "node2",
+    main_configs=[
+        "configs/remote_servers.xml",
+        "configs/listen_host.xml",
+        "configs/ssl_conf.xml",
+        "configs/server.crt",
+        "configs/server.key",
+        "configs/dhparam.pem",
+    ],
+    with_zookeeper=True,
+    ipv6_address="2001:3984:3989::1:1112",
+)
+
+
+@pytest.fixture(scope="module")
+def both_https_cluster():
+    try:
+        cluster.start()
+
+        _fill_nodes([node1, node2], 1)
+
+        yield cluster
+
+    finally:
+        cluster.shutdown()
+
+
+def test_replication_when_node_ip_changed(both_https_cluster):
+    """
+    Test for a bug when replication over HTTPS stops working when the IP of the source replica was changed.
+
+    node1 is a source node
+    node2 fethes data from node1
+    """
+    node1.query("truncate table test_table")
+    node2.query("truncate table test_table")
+
+    # First we check, that normal replication works
+    node1.query(
+        "INSERT INTO test_table VALUES ('2022-10-01', 1), ('2022-10-02', 2), ('2022-10-03', 3)"
+    )
+    assert node1.query("SELECT count(*) from test_table") == "3\n"
+    assert_eq_with_retry(node2, "SELECT count(*) from test_table", "3")
+
+    # We change source node ip
+    cluster.restart_instance_with_ip_change(node1, "2001:3984:3989::1:7777")
+
+    # Put some data to source node1
+    node1.query(
+        "INSERT INTO test_table VALUES ('2018-10-01', 4), ('2018-10-02', 4), ('2018-10-03', 6)"
+    )
+    # Check that data is placed on node1
+    assert node1.query("SELECT count(*) from test_table") == "6\n"
+
+    # drop DNS cache
+    node2.query("SYSTEM DROP DNS CACHE")
+    # Data is fetched
+    assert_eq_with_retry(node2, "SELECT count(*) from test_table", "6")

From 03652efe58469351f87e87c0ca47a6789776710f Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 26 May 2023 12:44:28 +0200
Subject: [PATCH 0170/1478] Add missing include

---
 src/IO/ReadBufferFromPocoSocket.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/IO/ReadBufferFromPocoSocket.cpp b/src/IO/ReadBufferFromPocoSocket.cpp
index c051478afc5..d6790439683 100644
--- a/src/IO/ReadBufferFromPocoSocket.cpp
+++ b/src/IO/ReadBufferFromPocoSocket.cpp
@@ -10,6 +10,8 @@
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
 
+#include "config.h"
+
 #if USE_SSL
 #include <Poco/Net/SecureStreamSocket.h>
 #endif

From 67c8c5c561668f0fca8d5ab2545d2ee82178fbdb Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 26 May 2023 12:44:43 +0200
Subject: [PATCH 0171/1478] Add missing include

---
 src/IO/WriteBufferFromPocoSocket.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/IO/WriteBufferFromPocoSocket.cpp b/src/IO/WriteBufferFromPocoSocket.cpp
index e566c228534..6e7c67cc054 100644
--- a/src/IO/WriteBufferFromPocoSocket.cpp
+++ b/src/IO/WriteBufferFromPocoSocket.cpp
@@ -11,6 +11,8 @@
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
 
+#include "config.h"
+
 #if USE_SSL
 #include <Poco/Net/SecureStreamSocket.h>
 #endif

From 0740bfbe4bfb3d186c8803e15aaffd2042c7f1fa Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 26 May 2023 14:31:09 +0000
Subject: [PATCH 0172/1478] Better disks moving

---
 programs/keeper/CMakeLists.txt        |   3 +-
 src/Coordination/Changelog.cpp        | 111 +++++++++++++++++++-------
 src/Coordination/Changelog.h          |   2 +-
 src/Coordination/KeeperContext.cpp    |  20 ++---
 src/Coordination/KeeperContext.h      |   4 +-
 src/Coordination/KeeperDispatcher.cpp |   6 +-
 6 files changed, 98 insertions(+), 48 deletions(-)

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 6e97ab324e3..f775e8a5a22 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -131,6 +131,7 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageRemoteMetadataRestoreHelper.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageCommon.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/StoredObject.cpp
 
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/registerDiskS3.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
@@ -144,7 +145,7 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/IOUringReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferFromTemporaryFile.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferWithFinalizeCallback.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/AsynchronousReadIndirectBufferFromRemoteFS.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/AsynchronousBoundedReadBuffer.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/getThreadPoolReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolRemoteFSReader.cpp
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index b289e1dc9f2..bcce9982e04 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -32,9 +32,21 @@ namespace ErrorCodes
 namespace
 {
 
+constexpr std::string_view tmp_prefix = "tmp_";
+
 void moveFileBetweenDisks(DiskPtr disk_from, ChangelogFileDescriptionPtr description, DiskPtr disk_to, const std::string & path_to)
 {
-    disk_from->copyFile(description->path, *disk_to, path_to, {});
+    /// we use empty file with prefix tmp_ to detect incomplete copies
+    /// if a copy is complete we don't care from which disk we use the same file
+    /// so it's okay if a failure happens after removing of tmp file but before we remove
+    /// the changelog from the source disk
+    auto from_path = fs::path(description->path);
+    auto tmp_changelog_name = from_path.parent_path() / (std::string{tmp_prefix} + from_path.filename().string());
+    {
+        disk_to->writeFile(tmp_changelog_name);
+    }
+    disk_from->copyFile(from_path, *disk_to, path_to, {});
+    disk_to->removeFile(tmp_changelog_name);
     disk_from->removeFile(description->path);
     description->path = path_to;
     description->disk = disk_to;
@@ -164,9 +176,9 @@ public:
                 }
             }
 
-            auto current_log_disk = getCurrentLogDisk();
-            assert(file_description->disk == current_log_disk);
-            file_buf = current_log_disk->writeFile(file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode);
+            auto latest_log_disk = getLatestLogDisk();
+            assert(file_description->disk == latest_log_disk);
+            file_buf = latest_log_disk->writeFile(file_description->path, DBMS_DEFAULT_BUFFER_SIZE, mode);
             assert(file_buf);
             last_index_written.reset();
             current_file_description = std::move(file_description);
@@ -176,7 +188,7 @@ public:
                     std::move(file_buf),
                     /* compressi)on level = */ 3,
                     /* append_to_existing_file_ = */ mode == WriteMode::Append,
-                    [current_log_disk, path = current_file_description->path] { return current_log_disk->readFile(path); });
+                    [latest_log_disk, path = current_file_description->path] { return latest_log_disk->readFile(path); });
 
             prealloc_done = false;
         }
@@ -274,7 +286,7 @@ public:
         new_description->from_log_index = new_start_log_index;
         new_description->to_log_index = new_start_log_index + log_file_settings.rotate_interval - 1;
         new_description->extension = "bin";
-        new_description->disk = getCurrentLogDisk();
+        new_description->disk = getLatestLogDisk();
 
         if (log_file_settings.compress_logs)
             new_description->extension += "." + toContentEncodingName(CompressionMethod::Zstd);
@@ -413,7 +425,7 @@ private:
         prealloc_done = true;
     }
 
-    DiskPtr getCurrentLogDisk() const { return keeper_context->getCurrentLogDisk(); }
+    DiskPtr getLatestLogDisk() const { return keeper_context->getLatestLogDisk(); }
 
     DiskPtr getDisk() const { return keeper_context->getLogDisk(); }
 
@@ -574,50 +586,87 @@ Changelog::Changelog(Poco::Logger * log_, LogFileSettings log_file_settings, Kee
     , append_completion_queue(std::numeric_limits<size_t>::max())
     , keeper_context(std::move(keeper_context_))
 {
-    if (auto current_log_disk = getCurrentLogDisk();
-        log_file_settings.force_sync && dynamic_cast<const DiskLocal *>(current_log_disk.get()) == nullptr)
+    if (auto latest_log_disk = getLatestLogDisk();
+        log_file_settings.force_sync && dynamic_cast<const DiskLocal *>(latest_log_disk.get()) == nullptr)
     {
         throw DB::Exception(
             DB::ErrorCodes::BAD_ARGUMENTS,
             "force_sync is set to true for logs but disk '{}' cannot satisfy such guarantee because it's not of type DiskLocal.\n"
             "If you want to use force_sync and same disk for all logs, please set keeper_server.log_storage_disk to a local disk.\n"
             "If you want to use force_sync and different disk only for old logs, please set 'keeper_server.log_storage_disk' to any "
-            "supported disk and 'keeper_server.current_log_storage_disk' to a local disk.\n"
+            "supported disk and 'keeper_server.latest_log_storage_disk' to a local disk.\n"
             "Otherwise, disable force_sync",
-            current_log_disk->getName());
+            latest_log_disk->getName());
     }
 
     /// Load all files on changelog disks
 
     const auto load_from_disk = [&](const auto & disk)
     {
+        LOG_TRACE(log, "Reading from disk {}", disk->getName());
+        std::unordered_map<std::string, std::string> incomplete_files;
+
+        const auto clean_incomplete_file = [&](const auto & file_path)
+        {
+            if (auto incomplete_it = incomplete_files.find(fs::path(file_path).filename()); incomplete_it != incomplete_files.end())
+            {
+                LOG_TRACE(log, "Removing {} from {}", file_path, disk->getName());
+                disk->removeFile(file_path);
+                disk->removeFile(incomplete_it->second);
+                incomplete_files.erase(incomplete_it);
+                return true;
+            }
+
+            return false;
+        };
+
+        std::vector<std::string> changelog_files;
         for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
         {
             if (it->name() == changelogs_detached_dir)
                 continue;
 
-            auto file_description = getChangelogFileDescription(it->path());
+            if (it->name().starts_with(tmp_prefix))
+            {
+                incomplete_files.emplace(it->name().substr(tmp_prefix.size()), it->path());
+                continue;
+            }
+
+            if (clean_incomplete_file(it->path()))
+                continue;
+
+            changelog_files.push_back(it->path());
+        }
+
+        for (const auto & changelog_file : changelog_files)
+        {
+            if (clean_incomplete_file(fs::path(changelog_file).filename()))
+                continue;
+
+            auto file_description = getChangelogFileDescription(changelog_file);
             file_description->disk = disk;
 
+            LOG_TRACE(log, "Found {} on {}", changelog_file, disk->getName());
             auto [changelog_it, inserted] = existing_changelogs.insert_or_assign(file_description->from_log_index, std::move(file_description));
 
             if (!inserted)
                 LOG_WARNING(log, "Found duplicate entries for {}, will use the entry from {}", changelog_it->second->path, disk->getName());
         }
+
+        for (const auto & [name, path] : incomplete_files)
+            disk->removeFile(path);
     };
 
     /// Load all files from old disks
     for (const auto & disk : keeper_context->getOldLogDisks())
-    {
         load_from_disk(disk);
-    }
 
     auto disk = getDisk();
     load_from_disk(disk);
 
-    auto current_log_disk = getCurrentLogDisk();
-    if (disk != current_log_disk)
-        load_from_disk(current_log_disk);
+    auto latest_log_disk = getLatestLogDisk();
+    if (disk != latest_log_disk)
+        load_from_disk(latest_log_disk);
 
     if (existing_changelogs.empty())
         LOG_WARNING(log, "No logs exists in {}. It's Ok if it's the first run of clickhouse-keeper.", disk->getPath());
@@ -779,12 +828,12 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
     else if (last_log_read_result.has_value())
     {
         /// check if we need to move completed log to another disk
-        auto current_log_disk = getCurrentLogDisk();
+        auto latest_log_disk = getLatestLogDisk();
         auto disk = getDisk();
 
         auto & description = existing_changelogs.at(last_log_read_result->log_start_index);
-        if (current_log_disk != disk && current_log_disk == description->disk)
-            moveFileBetweenDisks(current_log_disk, description, disk, description->path);
+        if (latest_log_disk != disk && latest_log_disk == description->disk)
+            moveFileBetweenDisks(latest_log_disk, description, disk, description->path);
     }
 
     /// Start new log if we don't initialize writer from previous log. All logs can be "complete".
@@ -793,14 +842,14 @@ void Changelog::readChangelogAndInitWriter(uint64_t last_commited_log_index, uin
 
     /// Move files to correct disks
     auto latest_start_index = current_writer->getStartIndex();
-    auto current_log_disk = getCurrentLogDisk();
+    auto latest_log_disk = getLatestLogDisk();
     auto disk = getDisk();
     for (const auto & [start_index, description] : existing_changelogs)
     {
-        /// latest log should already be on current_log_disk
+        /// latest log should already be on latest_log_disk
         if (start_index == latest_start_index)
         {
-            chassert(description->disk == current_log_disk);
+            chassert(description->disk == latest_log_disk);
             continue;
         }
 
@@ -825,9 +874,9 @@ void Changelog::initWriter(ChangelogFileDescriptionPtr description)
     LOG_TRACE(log, "Continue to write into {}", description->path);
 
     auto log_disk = description->disk;
-    auto current_log_disk = getCurrentLogDisk();
-    if (log_disk != current_log_disk)
-        moveFileBetweenDisks(log_disk, description, current_log_disk, description->path);
+    auto latest_log_disk = getLatestLogDisk();
+    if (log_disk != latest_log_disk)
+        moveFileBetweenDisks(log_disk, description, latest_log_disk, description->path);
 
     current_writer->setFile(std::move(description), WriteMode::Append);
 }
@@ -855,9 +904,9 @@ DiskPtr Changelog::getDisk() const
     return keeper_context->getLogDisk();
 }
 
-DiskPtr Changelog::getCurrentLogDisk() const
+DiskPtr Changelog::getLatestLogDisk() const
 {
-    return keeper_context->getCurrentLogDisk();
+    return keeper_context->getLatestLogDisk();
 }
 
 void Changelog::removeExistingLogs(ChangelogIter begin, ChangelogIter end)
@@ -1044,9 +1093,9 @@ void Changelog::writeAt(uint64_t index, const LogEntryPtr & log_entry)
                 description = std::prev(index_changelog)->second;
 
             auto log_disk = description->disk;
-            auto current_log_disk = getCurrentLogDisk();
-            if (log_disk != current_log_disk)
-                moveFileBetweenDisks(log_disk, description, current_log_disk, description->path);
+            auto latest_log_disk = getLatestLogDisk();
+            if (log_disk != latest_log_disk)
+                moveFileBetweenDisks(log_disk, description, latest_log_disk, description->path);
 
             current_writer->setFile(std::move(description), WriteMode::Append);
 
diff --git a/src/Coordination/Changelog.h b/src/Coordination/Changelog.h
index 4054829ef19..d20eaa1666c 100644
--- a/src/Coordination/Changelog.h
+++ b/src/Coordination/Changelog.h
@@ -155,7 +155,7 @@ private:
     static ChangelogRecord buildRecord(uint64_t index, const LogEntryPtr & log_entry);
 
     DiskPtr getDisk() const;
-    DiskPtr getCurrentLogDisk() const;
+    DiskPtr getLatestLogDisk() const;
 
     /// Currently existing changelogs
     std::map<uint64_t, ChangelogFileDescriptionPtr> existing_changelogs;
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index 1d6f1be9bfb..9d7e62ffae7 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -22,10 +22,10 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
 
     log_storage = getLogsPathFromConfig(config);
 
-    if (config.has("keeper_server.current_log_storage_disk"))
-        current_log_storage = config.getString("keeper_server.current_log_storage_disk");
+    if (config.has("keeper_server.latest_log_storage_disk"))
+        latest_log_storage = config.getString("keeper_server.latest_log_storage_disk");
     else
-        current_log_storage = log_storage;
+        latest_log_storage = log_storage;
 
     const auto collect_old_disk_names = [&](const std::string_view key_prefix, std::vector<std::string> & disk_names)
     {
@@ -34,7 +34,7 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
         for (const auto & key : disk_name_keys)
         {
             if (key.starts_with(key_prefix))
-                disk_names.push_back(config.getString(fmt::format("keeper_server.{}", key_prefix)));
+                disk_names.push_back(config.getString(fmt::format("keeper_server.{}", key)));
         }
     };
 
@@ -96,15 +96,15 @@ std::vector<DiskPtr> KeeperContext::getOldLogDisks() const
     return old_log_disks;
 }
 
-DiskPtr KeeperContext::getCurrentLogDisk() const
+DiskPtr KeeperContext::getLatestLogDisk() const
 {
-    return getDisk(current_log_storage);
+    return getDisk(latest_log_storage);
 }
 
 void KeeperContext::setLogDisk(DiskPtr disk)
 {
     log_storage = disk;
-    current_log_storage = std::move(disk);
+    latest_log_storage = std::move(disk);
 }
 
 DiskPtr KeeperContext::getSnapshotDisk() const
@@ -156,9 +156,9 @@ void KeeperContext::dumpConfiguration(WriteBufferFromOwnString & buf) const
         auto log_disk = getDisk(log_storage);
         dump_disk_info("log_storage", *log_disk);
 
-        auto current_log_disk = getDisk(current_log_storage);
-        if (log_disk != current_log_disk)
-            dump_disk_info("current_log_storage", *current_log_disk);
+        auto latest_log_disk = getDisk(latest_log_storage);
+        if (log_disk != latest_log_disk)
+            dump_disk_info("latest_log_storage", *latest_log_disk);
     }
 
     {
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index e41d8e35032..00607fd904e 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -34,7 +34,7 @@ public:
     bool digestEnabled() const;
     void setDigestEnabled(bool digest_enabled_);
 
-    DiskPtr getCurrentLogDisk() const;
+    DiskPtr getLatestLogDisk() const;
     DiskPtr getLogDisk() const;
     std::vector<DiskPtr> getOldLogDisks() const;
     void setLogDisk(DiskPtr disk);
@@ -65,7 +65,7 @@ private:
     std::shared_ptr<DiskSelector> disk_selector;
 
     Storage log_storage;
-    Storage current_log_storage;
+    Storage latest_log_storage;
     Storage snapshot_storage;
     Storage state_file_storage;
 
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index 6d1239c9210..a5b0f0b2c01 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -798,9 +798,9 @@ uint64_t KeeperDispatcher::getLogDirSize() const
     auto log_disk = keeper_context->getLogDisk();
     auto size = getTotalSize(log_disk);
 
-    auto current_log_disk = keeper_context->getCurrentLogDisk();
-    if (log_disk != current_log_disk)
-        size += getTotalSize(current_log_disk);
+    auto latest_log_disk = keeper_context->getLatestLogDisk();
+    if (log_disk != latest_log_disk)
+        size += getTotalSize(latest_log_disk);
 
     return size;
 }

From 6ed7a3b73feadcf5c3d72ed4a137fccd55e10fbb Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 26 May 2023 19:25:33 +0000
Subject: [PATCH 0173/1478] Fixing more tests.

---
 src/Interpreters/ActionsVisitor.cpp           |  6 +++-
 src/Interpreters/DatabaseCatalog.cpp          |  2 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |  4 +++
 src/Interpreters/PreparedSets.cpp             |  7 +++-
 src/Interpreters/Set.cpp                      | 17 ++++++----
 src/Interpreters/Set.h                        |  3 +-
 .../QueryPlan/ReadFromMergeTree.cpp           | 27 ++++++++++++---
 src/Processors/QueryPlan/ReadFromMergeTree.h  |  3 ++
 src/Storages/MergeTree/KeyCondition.cpp       | 18 +++++++++-
 .../MergeTree/MergeTreeDataSelectExecutor.cpp | 20 ++++-------
 .../MergeTree/MergeTreeDataSelectExecutor.h   |  3 +-
 .../MergeTreeIndexConditionBloomFilter.cpp    | 11 ++++++
 src/Storages/MergeTree/PartitionPruner.cpp    | 16 +++++++++
 src/Storages/MergeTree/PartitionPruner.h      |  1 +
 .../System/StorageSystemZooKeeper.cpp         | 34 +++++++++++--------
 15 files changed, 127 insertions(+), 45 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 133fcbbfe87..23c6867a868 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1420,8 +1420,12 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
                     return data.prepared_sets->addFromStorage(set_key, storage_set->getSet());
             }
 
-            if (auto tmp_table = data.getContext()->findExternalTable(table_id.getShortName()))
+            // std::cerr << ".... checking for " << identifier->getColumnName() << std::endl;
+            if (auto tmp_table = data.getContext()->findExternalTable(identifier->getColumnName()))
+            {
                 external_table_set = tmp_table->future_set;
+                // std::cerr << "Found " << reinterpret_cast<const void *>(tmp_table.get()) << " " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
+            }
         }
 
         /// We get the stream of blocks for the subquery. Create Set and put it in place of the subquery.
diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index 8d3fa91a7fe..dccf2978f49 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -110,7 +110,7 @@ TemporaryTableHolder::TemporaryTableHolder(
 }
 
 TemporaryTableHolder::TemporaryTableHolder(TemporaryTableHolder && rhs) noexcept
-        : WithContext(rhs.context), temporary_tables(rhs.temporary_tables), id(rhs.id)
+        : WithContext(rhs.context), temporary_tables(rhs.temporary_tables), id(rhs.id), future_set(std::move(rhs.future_set))
 {
     rhs.id = UUIDHelpers::Nil;
 }
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 195839da04f..8d2f2204e84 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -30,6 +30,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int WRONG_GLOBAL_SUBQUERY;
+    extern const int LOGICAL_ERROR;
 }
 
 class GlobalSubqueriesMatcher
@@ -159,6 +160,8 @@ public:
                 /*create_for_global_subquery*/ true);
             StoragePtr external_storage = external_storage_holder->getTable();
 
+            // std::cerr << "......... adding external table " << external_table_name << std::endl;
+
             external_tables.emplace(external_table_name, external_storage_holder);
 
             /// We need to materialize external tables immediately because reading from distributed
@@ -195,6 +198,7 @@ public:
 
                     //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
                     auto future_set = prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), nullptr);
+                    // std::cerr << "... Future set " << reinterpret_cast<const void *>(external_storage_holder.get()) << " " << reinterpret_cast<const void *>(future_set.get()) << std::endl;
                     external_storage_holder->future_set = std::move(future_set);
                 }
                 else
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index f2b70462227..c71273e0baa 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -239,6 +239,8 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
         return nullptr;
     }
 
+    // std::cerr << "... external_table_set " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
+
     if (external_table_set)
         return set = external_table_set->buildOrderedSetInplace(context);
 
@@ -337,7 +339,7 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
 
     set_key_columns.filter = ColumnUInt8::create(block.rows());
 
-    set->initSetElements();
+    //set->initSetElements();
     set->insertFromColumns(columns, set_key_columns);
     set->finishInsert();
     //block(std::move(block_))
@@ -350,6 +352,9 @@ FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {
 
 SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
 {
+    if (set->hasExplicitSetElements())
+        return set;
+
     const auto & settings = context->getSettingsRef();
     auto limits = getSizeLimitsForSet(settings, true);
 
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index 5adf3d07353..bd9cafc66eb 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -202,15 +202,14 @@ bool Set::insertFromColumns(const Columns & columns, SetKeyColumns & holder)
     if (data.empty())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Method Set::setHeader must be called before Set::insertFromBlock");
 
-    ColumnRawPtrs key_columns;
-    key_columns.reserve(keys_size);
     holder.key_columns.reserve(keys_size);
+    holder.materialized_columns.reserve(keys_size);
 
     /// Remember the columns we will work with
     for (size_t i = 0; i < keys_size; ++i)
     {
-        holder.key_columns.emplace_back(columns.at(i)->convertToFullIfNeeded());
-        key_columns.emplace_back(holder.key_columns.back().get());
+        holder.materialized_columns.emplace_back(columns.at(i)->convertToFullIfNeeded());
+        holder.key_columns.emplace_back(holder.materialized_columns.back().get());
     }
 
     size_t rows = columns.at(0)->size();
@@ -219,7 +218,7 @@ bool Set::insertFromColumns(const Columns & columns, SetKeyColumns & holder)
     ConstNullMapPtr null_map{};
     ColumnPtr null_map_holder;
     if (!transform_null_in)
-        null_map_holder = extractNestedColumnsAndNullMap(key_columns, null_map);
+        null_map_holder = extractNestedColumnsAndNullMap(holder.key_columns, null_map);
 
     switch (data.type)
     {
@@ -227,7 +226,7 @@ bool Set::insertFromColumns(const Columns & columns, SetKeyColumns & holder)
             break;
 #define M(NAME) \
         case SetVariants::Type::NAME: \
-            insertFromBlockImpl(*data.NAME, key_columns, rows, data, null_map, holder.filter ? &holder.filter->getData() : nullptr); \
+            insertFromBlockImpl(*data.NAME, holder.key_columns, rows, data, null_map, holder.filter ? &holder.filter->getData() : nullptr); \
             break;
         APPLY_FOR_SET_VARIANTS(M)
 #undef M
@@ -445,6 +444,11 @@ void Set::checkTypesEqual(size_t set_type_idx, const DataTypePtr & other_type) c
 MergeTreeSetIndex::MergeTreeSetIndex(const Columns & set_elements, std::vector<KeyTuplePositionMapping> && indexes_mapping_)
     : has_all_keys(set_elements.size() == indexes_mapping_.size()), indexes_mapping(std::move(indexes_mapping_))
 {
+    // std::cerr << "MergeTreeSetIndex::MergeTreeSetIndex "
+    //     << set_elements.size() << ' ' << indexes_mapping.size() << std::endl;
+    // for (const auto & vv : indexes_mapping)
+    //     std::cerr << vv.key_index << ' ' << vv.tuple_index << std::endl;
+
     ::sort(indexes_mapping.begin(), indexes_mapping.end(),
         [](const KeyTuplePositionMapping & l, const KeyTuplePositionMapping & r)
         {
@@ -487,6 +491,7 @@ MergeTreeSetIndex::MergeTreeSetIndex(const Columns & set_elements, std::vector<K
 BoolMask MergeTreeSetIndex::checkInRange(const std::vector<Range> & key_ranges, const DataTypes & data_types, bool single_point) const
 {
     size_t tuple_size = indexes_mapping.size();
+    // std::cerr << "MergeTreeSetIndex::checkInRange " << single_point << ' ' << tuple_size << ' ' << has_all_keys << std::endl;
 
     FieldValues left_point;
     FieldValues right_point;
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index cb47fde7f7d..c2931d79de0 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -53,7 +53,8 @@ public:
     {
         //ColumnRawPtrs key_columns;
         /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
-        Columns key_columns;
+        ColumnRawPtrs key_columns;
+        Columns materialized_columns;
         ColumnPtr null_map_holder;
         ColumnUInt8::MutablePtr filter;
     };
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index acd9147b613..4940cbd032c 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1174,6 +1174,7 @@ static ActionsDAGPtr buildFilterDAG(
 static void buildIndexes(
     std::optional<ReadFromMergeTree::Indexes> & indexes,
     ActionsDAGPtr filter_actions_dag,
+    const MergeTreeData & data,
     const ContextPtr & context,
     const SelectQueryInfo & query_info,
     const StorageMetadataPtr & metadata_snapshot)
@@ -1196,7 +1197,7 @@ static void buildIndexes(
             context,
             primary_key_column_names,
             primary_key.expression,
-            array_join_name_set}, {}, false});
+            array_join_name_set}, {}, {}, {}, false});
     }
     else
     {
@@ -1204,7 +1205,22 @@ static void buildIndexes(
             query_info,
             context,
             primary_key_column_names,
-            primary_key.expression}, {}, false});
+            primary_key.expression}, {}, {}, {}, false});
+    }
+
+    if (metadata_snapshot->hasPartitionKey())
+    {
+        const auto & partition_key = metadata_snapshot->getPartitionKey();
+        auto minmax_columns_names = data.getMinMaxColumnsNames(partition_key);
+        auto minmax_expression_actions = data.getMinMaxExpr(partition_key, ExpressionActionsSettings::fromContext(context));
+        // minmax_columns_types = data.getMinMaxColumnsTypes(partition_key);
+
+        // if (context->getSettingsRef().allow_experimental_analyzer)
+        indexes->minmax_idx_condition.emplace(filter_actions_dag, context, minmax_columns_names, minmax_expression_actions, NameSet());
+        // else
+        //     indexes->minmax_idx_condition.emplace(query_info, context, minmax_columns_names, minmax_expression_actions);
+
+        indexes->partition_pruner.emplace(metadata_snapshot, filter_actions_dag, context, false /* strict */);
     }
 
     indexes->use_skip_indexes = settings.use_skip_indexes;
@@ -1250,7 +1266,7 @@ void ReadFromMergeTree::onAddFilterFinish()
     if (!filter_nodes.nodes.empty())
     {
         auto filter_actions_dag = buildFilterDAG(context, prewhere_info, filter_nodes, query_info);
-        buildIndexes(indexes, filter_actions_dag, context, query_info, metadata_for_reading);
+        buildIndexes(indexes, filter_actions_dag, data, context, query_info, metadata_for_reading);
     }
 }
 
@@ -1366,7 +1382,7 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     // }
 
     if (!indexes)
-        buildIndexes(indexes, query_info.filter_actions_dag, context, query_info, metadata_snapshot);
+        buildIndexes(indexes, query_info.filter_actions_dag, data, context, query_info, metadata_snapshot);
 
     if (settings.force_primary_key && indexes->key_condition.alwaysUnknownOrTrue())
     {
@@ -1386,11 +1402,12 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
     try
     {
         MergeTreeDataSelectExecutor::filterPartsByPartition(
+            indexes->partition_pruner,
+            indexes->minmax_idx_condition,
             parts,
             part_values,
             metadata_snapshot_base,
             data,
-            query_info,
             context,
             max_block_numbers_to_read.get(),
             log,
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index 6610b463726..5ff9d2f046c 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -5,6 +5,7 @@
 #include <Storages/SelectQueryInfo.h>
 #include <Storages/MergeTree/MergeTreeData.h>
 #include <Storages/MergeTree/MergeTreeReadPool.h>
+#include <Storages/MergeTree/PartitionPruner.h>
 
 namespace DB
 {
@@ -164,6 +165,8 @@ public:
     struct Indexes
     {
         KeyCondition key_condition;
+        std::optional<PartitionPruner> partition_pruner;
+        std::optional<KeyCondition> minmax_idx_condition;
         UsefulSkipIndexes skip_indexes;
         bool use_skip_indexes;
     };
diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index 7fcc111ced9..fe87198dcf5 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1157,6 +1157,8 @@ bool KeyCondition::tryPrepareSetIndex(
     RPNElement & out,
     size_t & out_key_column_num)
 {
+    // std::cerr << "::: tryPrepareSetIndex for " << func.getColumnName() << std::endl;
+    // std::cerr << StackTrace().toString() << std::endl;
     const auto & left_arg = func.getArgumentAt(0);
 
     out_key_column_num = 0;
@@ -1200,7 +1202,10 @@ bool KeyCondition::tryPrepareSetIndex(
     }
 
     if (indexes_mapping.empty())
+    {
+        // std::cerr << ".. index mapping is empty\n";
         return false;
+    }
 
     const auto right_arg = func.getArgumentAt(1);
 
@@ -1208,7 +1213,10 @@ bool KeyCondition::tryPrepareSetIndex(
 
     auto future_set = right_arg.tryGetPreparedSet(indexes_mapping, data_types);
     if (!future_set)
+    {
+        // std::cerr << ".. no future set\n";
         return false;
+    }
 
     // LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
 
@@ -1220,13 +1228,21 @@ bool KeyCondition::tryPrepareSetIndex(
 
     auto prepared_set = future_set->get();
     if (!prepared_set)
+    {
+
+        // std::cerr << ".. no prepared set\n";
         return false;
+    }
 
     // LOG_TRACE(&Poco::Logger::get("KK"), "Set if ready for {}", right_arg.getColumnName());
 
     /// The index can be prepared if the elements of the set were saved in advance.
     if (!prepared_set->hasExplicitSetElements())
+    {
+
+        // std::cerr << ".. no explicit elements\n";
         return false;
+    }
 
     // LOG_TRACE(&Poco::Logger::get("KK"), "Has explicit elements for {}", right_arg.getColumnName());
 
@@ -1235,7 +1251,7 @@ bool KeyCondition::tryPrepareSetIndex(
         prepared_set->checkTypesEqual(indexes_mapping[i].tuple_index, data_types[i]);
 
     out.set_index = std::make_shared<MergeTreeSetIndex>(prepared_set->getSetElements(), std::move(indexes_mapping));
-
+    // std::cerr << ".. can use\n";
     return true;
 }
 
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index f99e15c0fc1..f42fada4222 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -793,38 +793,28 @@ std::optional<std::unordered_set<String>> MergeTreeDataSelectExecutor::filterPar
 }
 
 void MergeTreeDataSelectExecutor::filterPartsByPartition(
+    std::optional<PartitionPruner> & partition_pruner,
+    std::optional<KeyCondition> & minmax_idx_condition,
     MergeTreeData::DataPartsVector & parts,
     const std::optional<std::unordered_set<String>> & part_values,
     const StorageMetadataPtr & metadata_snapshot,
     const MergeTreeData & data,
-    const SelectQueryInfo & query_info,
     const ContextPtr & context,
     const PartitionIdToMaxBlock * max_block_numbers_to_read,
     Poco::Logger * log,
     ReadFromMergeTree::IndexStats & index_stats)
 {
     const Settings & settings = context->getSettingsRef();
-
-    std::optional<PartitionPruner> partition_pruner;
-    std::optional<KeyCondition> minmax_idx_condition;
     DataTypes minmax_columns_types;
 
     if (metadata_snapshot->hasPartitionKey())
     {
         const auto & partition_key = metadata_snapshot->getPartitionKey();
-        auto minmax_columns_names = data.getMinMaxColumnsNames(partition_key);
-        auto minmax_expression_actions = data.getMinMaxExpr(partition_key, ExpressionActionsSettings::fromContext(context));
         minmax_columns_types = data.getMinMaxColumnsTypes(partition_key);
 
-        if (context->getSettingsRef().allow_experimental_analyzer)
-            minmax_idx_condition.emplace(query_info.filter_actions_dag, context, minmax_columns_names, minmax_expression_actions, NameSet());
-        else
-            minmax_idx_condition.emplace(query_info, context, minmax_columns_names, minmax_expression_actions);
-
-        partition_pruner.emplace(metadata_snapshot, query_info, context, false /* strict */);
-
         if (settings.force_index_by_date && (minmax_idx_condition->alwaysUnknownOrTrue() && partition_pruner->isUseless()))
         {
+            auto minmax_columns_names = data.getMinMaxColumnsNames(partition_key);
             throw Exception(ErrorCodes::INDEX_NOT_USED,
                 "Neither MinMax index by columns ({}) nor partition expr is used and setting 'force_index_by_date' is set",
                 fmt::join(minmax_columns_names, ", "));
@@ -1835,7 +1825,9 @@ void MergeTreeDataSelectExecutor::selectPartsToRead(
 
         if (partition_pruner)
         {
-            if (partition_pruner->canBePruned(*part))
+            auto val = partition_pruner->canBePruned(*part);
+            // std::cerr << "... part " << part->getNameWithState() << "  cbp ? " << val << std::endl;
+            if (val)
                 continue;
         }
 
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
index 8c8ce59bebe..f1efbdf0310 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.h
@@ -173,11 +173,12 @@ public:
 
     /// Filter parts using minmax index and partition key.
     static void filterPartsByPartition(
+        std::optional<PartitionPruner> & partition_pruner,
+        std::optional<KeyCondition> & minmax_idx_condition,
         MergeTreeData::DataPartsVector & parts,
         const std::optional<std::unordered_set<String>> & part_values,
         const StorageMetadataPtr & metadata_snapshot,
         const MergeTreeData & data,
-        const SelectQueryInfo & query_info,
         const ContextPtr & context,
         const PartitionIdToMaxBlock * max_block_numbers_to_read,
         Poco::Logger * log,
diff --git a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
index 3d0883a1241..e2bf9bde674 100644
--- a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
@@ -31,12 +31,21 @@ namespace
 
 ColumnWithTypeAndName getPreparedSetInfo(const ConstSetPtr & prepared_set)
 {
+    // std::cerr << "====== " << prepared_set->getDataTypes().size() << std::endl;
     if (prepared_set->getDataTypes().size() == 1)
         return {prepared_set->getSetElements()[0], prepared_set->getElementsTypes()[0], "dummy"};
 
     Columns set_elements;
     for (auto & set_element : prepared_set->getSetElements())
+    {
+        // std::cerr << set_element->dumpStructure() << std::endl;
         set_elements.emplace_back(set_element->convertToFullColumnIfConst());
+    }
+
+    // for (auto & set_element : prepared_set->getElementsTypes())
+    // {
+    //     // std::cerr << set_element->getName() << std::endl;
+    // }
 
     return {ColumnTuple::create(set_elements), std::make_shared<DataTypeTuple>(prepared_set->getElementsTypes()), "dummy"};
 }
@@ -331,6 +340,7 @@ bool MergeTreeIndexConditionBloomFilter::traverseFunction(const RPNBuilderTreeNo
             if (prepared_set && prepared_set->hasExplicitSetElements())
             {
                 const auto prepared_info = getPreparedSetInfo(prepared_set);
+                // std::cerr << "...... " << prepared_info.dumpStructure() << std::endl;
                 if (traverseTreeIn(function_name, lhs_argument, prepared_set, prepared_info.type, prepared_info.column, out))
                     maybe_useful = true;
             }
@@ -377,6 +387,7 @@ bool MergeTreeIndexConditionBloomFilter::traverseTreeIn(
         size_t row_size = column->size();
         size_t position = header.getPositionByName(key_node_column_name);
         const DataTypePtr & index_type = header.getByPosition(position).type;
+        // std::cerr << "::::: " << ColumnWithTypeAndName{column, type, ""}.dumpStructure() << " -> " << index_type->getName() << std::endl;
         const auto & converted_column = castColumn(ColumnWithTypeAndName{column, type, ""}, index_type);
         out.predicate.emplace_back(std::make_pair(position, BloomFilterHash::hashWithColumn(index_type, converted_column, 0, row_size)));
 
diff --git a/src/Storages/MergeTree/PartitionPruner.cpp b/src/Storages/MergeTree/PartitionPruner.cpp
index 35b2d5db3b5..a397a1475d1 100644
--- a/src/Storages/MergeTree/PartitionPruner.cpp
+++ b/src/Storages/MergeTree/PartitionPruner.cpp
@@ -24,6 +24,19 @@ PartitionPruner::PartitionPruner(const StorageMetadataPtr & metadata, const Sele
 {
 }
 
+PartitionPruner::PartitionPruner(const StorageMetadataPtr & metadata, ActionsDAGPtr filter_actions_dag, ContextPtr context, bool strict)
+    : partition_key(MergeTreePartition::adjustPartitionKey(metadata, context))
+    , partition_condition(filter_actions_dag, context, partition_key.column_names, partition_key.expression, {}, true /* single_point */, strict)
+    , useless(strict ? partition_condition.anyUnknownOrAlwaysTrue() : partition_condition.alwaysUnknownOrTrue())
+{
+    // auto description = getKeyCondition().getDescription();
+    // std::cerr << ".... " << description.condition << std::endl;
+    // std::cerr << filter_actions_dag->dumpDAG() << std::endl;
+    // for (const auto & name : partition_key.column_names)
+    //     std::cerr << ". " << name << std::endl;
+    // std::cerr << partition_key.expression->dumpActions() << std::endl;
+}
+
 bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
 {
     if (part.isEmpty())
@@ -39,6 +52,8 @@ bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
     else
     {
         const auto & partition_value = part.partition.value;
+        // for (const auto & val : partition_value)
+        //     std::cerr << val.dump() << std::endl;
         std::vector<FieldRef> index_value(partition_value.begin(), partition_value.end());
         for (auto & field : index_value)
         {
@@ -49,6 +64,7 @@ bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
 
         is_valid = partition_condition.mayBeTrueInRange(
             partition_value.size(), index_value.data(), index_value.data(), partition_key.data_types);
+        // std::cerr << "may be true " << is_valid << std::endl;
         partition_filter_map.emplace(partition_id, is_valid);
 
         if (!is_valid)
diff --git a/src/Storages/MergeTree/PartitionPruner.h b/src/Storages/MergeTree/PartitionPruner.h
index 3a986923321..7f1b74795c4 100644
--- a/src/Storages/MergeTree/PartitionPruner.h
+++ b/src/Storages/MergeTree/PartitionPruner.h
@@ -14,6 +14,7 @@ class PartitionPruner
 {
 public:
     PartitionPruner(const StorageMetadataPtr & metadata, const SelectQueryInfo & query_info, ContextPtr context, bool strict);
+    PartitionPruner(const StorageMetadataPtr & metadata, ActionsDAGPtr filter_actions_dag, ContextPtr context, bool strict);
 
     bool canBePruned(const IMergeTreeDataPart & part);
 
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 34b463eadee..1e89427071c 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -161,6 +161,17 @@ public:
     }
 };
 
+/// Type of path to be fetched
+enum class ZkPathType
+{
+    Exact,   /// Fetch all nodes under this path
+    Prefix,  /// Fetch all nodes starting with this prefix, recursively (multiple paths may match prefix)
+    Recurse, /// Fatch all nodes under this path, recursively
+};
+
+/// List of paths to be feched from zookeeper
+using Paths = std::deque<std::pair<String, ZkPathType>>;
+
 class ReadFromSystemZooKeeper final : public SourceStepWithFilter
 {
 public:
@@ -170,11 +181,14 @@ public:
 
     void initializePipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings & settings) override;
 
+    void onAddFilterFinish() override;
+
 private:
-    void fillData(MutableColumns & res_columns) const;
+    void fillData(MutableColumns & res_columns);
 
     std::shared_ptr<const StorageLimitsList> storage_limits;
     ContextPtr context;
+    Paths paths;
 };
 
 StorageSystemZooKeeper::StorageSystemZooKeeper(const StorageID & table_id_)
@@ -246,17 +260,6 @@ NamesAndTypesList StorageSystemZooKeeper::getNamesAndTypes()
     };
 }
 
-/// Type of path to be fetched
-enum class ZkPathType
-{
-    Exact,   /// Fetch all nodes under this path
-    Prefix,  /// Fetch all nodes starting with this prefix, recursively (multiple paths may match prefix)
-    Recurse, /// Fatch all nodes under this path, recursively
-};
-
-/// List of paths to be feched from zookeeper
-using Paths = std::deque<std::pair<String, ZkPathType>>;
-
 static String pathCorrected(const String & path)
 {
     String path_corrected;
@@ -421,10 +424,13 @@ static Paths extractPath(const ActionsDAG::NodeRawConstPtrs & filter_nodes, Cont
 }
 
 
-void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
+void ReadFromSystemZooKeeper::onAddFilterFinish()
 {
-    Paths paths = extractPath(getFilterNodes().nodes, context, context->getSettingsRef().allow_unrestricted_reads_from_keeper);
+    paths = extractPath(getFilterNodes().nodes, context, context->getSettingsRef().allow_unrestricted_reads_from_keeper);
+}
 
+void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns)
+{
     zkutil::ZooKeeperPtr zookeeper = context->getZooKeeper();
 
     if (paths.empty())

From ef9bae50b9cc83a885a6e0f8c0d82a88ee2c791b Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 26 May 2023 23:11:57 +0000
Subject: [PATCH 0174/1478] Fix bugs in Poco, use true non-blocking IO

---
 base/poco/Net/src/SocketImpl.cpp              | 10 +++-
 .../include/Poco/Net/SecureSocketImpl.h       | 10 ++++
 .../include/Poco/Net/SecureStreamSocketImpl.h | 10 ++++
 .../NetSSL_OpenSSL/src/SecureSocketImpl.cpp   | 10 ++++
 .../src/SecureStreamSocketImpl.cpp            | 10 ++++
 src/Common/checkSSLError.h                    |  8 +++
 src/Common/checkSSLReturnCode.cpp             | 29 ++++++++++
 src/Common/checkSSLReturnCode.h               | 12 ++++
 src/IO/ReadBufferFromPocoSocket.cpp           | 58 +++++++++----------
 src/IO/ReadBufferFromPocoSocket.h             |  2 -
 src/IO/WriteBufferFromPocoSocket.cpp          | 58 +++++++++----------
 src/IO/WriteBufferFromPocoSocket.h            |  2 -
 12 files changed, 154 insertions(+), 65 deletions(-)
 create mode 100644 src/Common/checkSSLError.h
 create mode 100644 src/Common/checkSSLReturnCode.cpp
 create mode 100644 src/Common/checkSSLReturnCode.h

diff --git a/base/poco/Net/src/SocketImpl.cpp b/base/poco/Net/src/SocketImpl.cpp
index 2aba413b322..484b8cfeec3 100644
--- a/base/poco/Net/src/SocketImpl.cpp
+++ b/base/poco/Net/src/SocketImpl.cpp
@@ -274,7 +274,9 @@ void SocketImpl::shutdown()
 
 int SocketImpl::sendBytes(const void* buffer, int length, int flags)
 {
-	if (_isBrokenTimeout)
+    bool blocking = _blocking && (flags & MSG_DONTWAIT) == 0;
+
+	if (_isBrokenTimeout && blocking)
 	{
 		if (_sndTimeout.totalMicroseconds() != 0)
 		{
@@ -289,11 +291,13 @@ int SocketImpl::sendBytes(const void* buffer, int length, int flags)
 		if (_sockfd == POCO_INVALID_SOCKET) throw InvalidSocketException();
 		rc = ::send(_sockfd, reinterpret_cast<const char*>(buffer), length, flags);
 	}
-	while (_blocking && rc < 0 && lastError() == POCO_EINTR);
+	while (blocking && rc < 0 && lastError() == POCO_EINTR);
 	if (rc < 0)
 	{
 		int err = lastError();
-		if (err == POCO_EAGAIN || err == POCO_ETIMEDOUT)
+		if ((err == POCO_EAGAIN || err == POCO_EWOULDBLOCK) && !blocking)
+			;
+		else if (err == POCO_EAGAIN || err == POCO_ETIMEDOUT)
 			throw TimeoutException();
 		else
 			error(err);
diff --git a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureSocketImpl.h b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureSocketImpl.h
index 56c550decfe..49c12b6b45f 100644
--- a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureSocketImpl.h
+++ b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureSocketImpl.h
@@ -183,6 +183,16 @@ namespace Net
         /// Returns true iff a reused session was negotiated during
         /// the handshake.
 
+        virtual void setBlocking(bool flag);
+        /// Sets the socket in blocking mode if flag is true,
+        /// disables blocking mode if flag is false.
+
+        virtual bool getBlocking() const;
+        /// Returns the blocking mode of the socket.
+        /// This method will only work if the blocking modes of
+        /// the socket are changed via the setBlocking method!
+
+
     protected:
         void acceptSSL();
         /// Assume per-object mutex is locked.
diff --git a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureStreamSocketImpl.h b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureStreamSocketImpl.h
index b41043769fe..99e2130d673 100644
--- a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureStreamSocketImpl.h
+++ b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SecureStreamSocketImpl.h
@@ -201,6 +201,16 @@ namespace Net
         /// Returns true iff a reused session was negotiated during
         /// the handshake.
 
+        virtual void setBlocking(bool flag);
+        /// Sets the socket in blocking mode if flag is true,
+        /// disables blocking mode if flag is false.
+
+        virtual bool getBlocking() const;
+        /// Returns the blocking mode of the socket.
+        /// This method will only work if the blocking modes of
+        /// the socket are changed via the setBlocking method!
+
+
     protected:
         void acceptSSL();
         /// Performs a SSL server-side handshake.
diff --git a/base/poco/NetSSL_OpenSSL/src/SecureSocketImpl.cpp b/base/poco/NetSSL_OpenSSL/src/SecureSocketImpl.cpp
index 9631c7a401a..efe25f65909 100644
--- a/base/poco/NetSSL_OpenSSL/src/SecureSocketImpl.cpp
+++ b/base/poco/NetSSL_OpenSSL/src/SecureSocketImpl.cpp
@@ -629,5 +629,15 @@ bool SecureSocketImpl::sessionWasReused()
 		return false;
 }
 
+void SecureSocketImpl::setBlocking(bool flag)
+{
+    _pSocket->setBlocking(flag);
+}
+
+bool SecureSocketImpl::getBlocking() const
+{
+    return _pSocket->getBlocking();
+}
+
 
 } } // namespace Poco::Net
diff --git a/base/poco/NetSSL_OpenSSL/src/SecureStreamSocketImpl.cpp b/base/poco/NetSSL_OpenSSL/src/SecureStreamSocketImpl.cpp
index aa1a96e1585..c00dd43b2ed 100644
--- a/base/poco/NetSSL_OpenSSL/src/SecureStreamSocketImpl.cpp
+++ b/base/poco/NetSSL_OpenSSL/src/SecureStreamSocketImpl.cpp
@@ -237,5 +237,15 @@ int SecureStreamSocketImpl::completeHandshake()
 	return _impl.completeHandshake();
 }
 
+bool SecureStreamSocketImpl::getBlocking() const
+{
+    return _impl.getBlocking();
+}
+
+void SecureStreamSocketImpl::setBlocking(bool flag)
+{
+    _impl.setBlocking(flag);
+}
+
 
 } } // namespace Poco::Net
diff --git a/src/Common/checkSSLError.h b/src/Common/checkSSLError.h
new file mode 100644
index 00000000000..05bca9f8b5f
--- /dev/null
+++ b/src/Common/checkSSLError.h
@@ -0,0 +1,8 @@
+//
+// Created by Павел Круглов on 27/05/2023.
+//
+
+#ifndef CLICKHOUSE_CHECKSSLERROR_H
+#define CLICKHOUSE_CHECKSSLERROR_H
+
+#endif //CLICKHOUSE_CHECKSSLERROR_H
diff --git a/src/Common/checkSSLReturnCode.cpp b/src/Common/checkSSLReturnCode.cpp
new file mode 100644
index 00000000000..8916a25e19c
--- /dev/null
+++ b/src/Common/checkSSLReturnCode.cpp
@@ -0,0 +1,29 @@
+#include <Common/checkSSLReturnCode.h>
+#include "config.h"
+
+#if USE_SSL
+#include <Poco/Net/SecureStreamSocket.h>
+#endif
+
+namespace DB
+{
+
+bool checkSSLWantRead(ssize_t res)
+{
+#if USE_SSL
+    return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ;
+#else
+    return false;
+#endif
+}
+
+bool checkSSLWantWrite(ssize_t res)
+{
+#if USE_SSL
+    return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE;
+#else
+    return false;
+#endif
+}
+
+}
diff --git a/src/Common/checkSSLReturnCode.h b/src/Common/checkSSLReturnCode.h
new file mode 100644
index 00000000000..f30564137aa
--- /dev/null
+++ b/src/Common/checkSSLReturnCode.h
@@ -0,0 +1,12 @@
+#pragma once
+
+namespace DB
+{
+
+/// Check if ret is ERR_SSL_WANT_READ.
+bool checkSSLWantRead(ssize_t ret);
+
+/// CHeck if ret is ERR_SSL_WANT_WRITE.
+bool checkSSLWantWrite(ssize_t ret);
+
+}
diff --git a/src/IO/ReadBufferFromPocoSocket.cpp b/src/IO/ReadBufferFromPocoSocket.cpp
index d6790439683..ff72dc5386c 100644
--- a/src/IO/ReadBufferFromPocoSocket.cpp
+++ b/src/IO/ReadBufferFromPocoSocket.cpp
@@ -9,12 +9,7 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
-
-#include "config.h"
-
-#if USE_SSL
-#include <Poco/Net/SecureStreamSocket.h>
-#endif
+#include <Common/checkSSLReturnCode.h>
 
 namespace ProfileEvents
 {
@@ -27,7 +22,6 @@ namespace CurrentMetrics
     extern const Metric NetworkReceive;
 }
 
-
 namespace DB
 {
 namespace ErrorCodes
@@ -38,14 +32,13 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-
 bool ReadBufferFromPocoSocket::nextImpl()
 {
     ssize_t bytes_read = 0;
     Stopwatch watch;
 
     SCOPE_EXIT({
-        // / NOTE: it is quite inaccurate on high loads since the thread could be replaced by another one
+        /// NOTE: it is quite inaccurate on high loads since the thread could be replaced by another one
         ProfileEvents::increment(ProfileEvents::NetworkReceiveElapsedMicroseconds, watch.elapsedMicroseconds());
         ProfileEvents::increment(ProfileEvents::NetworkReceiveBytes, bytes_read);
     });
@@ -58,17 +51,35 @@ bool ReadBufferFromPocoSocket::nextImpl()
         if (internal_buffer.size() > INT_MAX)
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Buffer overflow");
 
-        bytes_read = readFromSocket();
-
-#if USE_SSL
-        /// In case of non-blocking connect for secure socket receiveBytes can return ERR_SSL_WANT_READ,
-        /// in this case we should call receiveBytes again when socket is ready.
-        if (socket.secure())
+        /// If async_callback is specified, set socket to non-blocking mode
+        /// and try to read data from it, if socket is not ready for reading,
+        /// run async_callback and try again later.
+        /// It is expected that file descriptor may be polled externally.
+        /// Note that send timeout is not checked here. External code should check it while polling.
+        if (async_callback)
         {
-            while (bytes_read == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ)
-                bytes_read = readFromSocket();
+            socket.setBlocking(false);
+            SCOPE_EXIT(socket.setBlocking(true));
+            bool secure = socket.secure();
+            bytes_read = socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
+
+            /// Check EAGAIN and ERR_SSL_WANT_READ/ERR_SSL_WANT_WRITE for secure socket (reading from secure socket can write too).
+            while (bytes_read < 0 && (errno == EAGAIN || (secure && (checkSSLWantRead(bytes_read) || checkSSLWantWrite(bytes_read)))))
+            {
+                /// In case of ERR_SSL_WANT_WRITE we should wait for socket to be ready for writing, otherwise - for reading.
+                if (secure && checkSSLWantWrite(bytes_read))
+                    async_callback(socket.impl()->sockfd(), socket.getSendTimeout(), AsyncEventTimeoutType::SEND, socket_description, AsyncTaskExecutor::Event::WRITE | AsyncTaskExecutor::Event::ERROR);
+                else
+                    async_callback(socket.impl()->sockfd(), socket.getReceiveTimeout(), AsyncEventTimeoutType::RECEIVE, socket_description, AsyncTaskExecutor::Event::READ | AsyncTaskExecutor::Event::ERROR);
+
+                /// Try to read again.
+                bytes_read = socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
+            }
+        }
+        else
+        {
+            bytes_read = socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
         }
-#endif
     }
     catch (const Poco::Net::NetException & e)
     {
@@ -96,17 +107,6 @@ bool ReadBufferFromPocoSocket::nextImpl()
     return true;
 }
 
-ssize_t ReadBufferFromPocoSocket::readFromSocket()
-{
-    /// If async_callback is specified, and read will block, run async_callback and try again later.
-    /// It is expected that file descriptor may be polled externally.
-    /// Note that receive timeout is not checked here. External code should check it while polling.
-    while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_READ | Poco::Net::Socket::SELECT_ERROR))
-        async_callback(socket.impl()->sockfd(), socket.getReceiveTimeout(), AsyncEventTimeoutType::RECEIVE, socket_description, AsyncTaskExecutor::Event::READ | AsyncTaskExecutor::Event::ERROR);
-
-    return socket.impl()->receiveBytes(internal_buffer.begin(), static_cast<int>(internal_buffer.size()));
-}
-
 ReadBufferFromPocoSocket::ReadBufferFromPocoSocket(Poco::Net::Socket & socket_, size_t buf_size)
     : BufferWithOwnMemory<ReadBuffer>(buf_size)
     , socket(socket_)
diff --git a/src/IO/ReadBufferFromPocoSocket.h b/src/IO/ReadBufferFromPocoSocket.h
index 3c4bc424334..dab4ac86295 100644
--- a/src/IO/ReadBufferFromPocoSocket.h
+++ b/src/IO/ReadBufferFromPocoSocket.h
@@ -30,8 +30,6 @@ public:
     void setAsyncCallback(AsyncCallback async_callback_) { async_callback = std::move(async_callback_); }
 
 private:
-    ssize_t readFromSocket();
-
     AsyncCallback async_callback;
     std::string socket_description;
 };
diff --git a/src/IO/WriteBufferFromPocoSocket.cpp b/src/IO/WriteBufferFromPocoSocket.cpp
index 6e7c67cc054..df1041f0056 100644
--- a/src/IO/WriteBufferFromPocoSocket.cpp
+++ b/src/IO/WriteBufferFromPocoSocket.cpp
@@ -10,12 +10,7 @@
 #include <Common/ProfileEvents.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/AsyncTaskExecutor.h>
-
-#include "config.h"
-
-#if USE_SSL
-#include <Poco/Net/SecureStreamSocket.h>
-#endif
+#include <Common/checkSSLReturnCode.h>
 
 namespace ProfileEvents
 {
@@ -28,7 +23,6 @@ namespace CurrentMetrics
     extern const Metric NetworkSend;
 }
 
-
 namespace DB
 {
 
@@ -40,7 +34,6 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-
 void WriteBufferFromPocoSocket::nextImpl()
 {
     if (!offset())
@@ -67,17 +60,36 @@ void WriteBufferFromPocoSocket::nextImpl()
             if (size > INT_MAX)
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "Buffer overflow");
 
-            res = writeToSocket(pos, size);
-
-#if USE_SSL
-            /// In case of non-blocking connect for secure socket sendBytes can return ERR_SSL_WANT_WRITE,
-            /// in this case we should call sendBytes again when socket is ready.
-            if (socket.secure())
+            /// If async_callback is specified, set socket to non-blocking mode
+            /// and try to write data to it, if socket is not ready for writing,
+            /// run async_callback and try again later.
+            /// It is expected that file descriptor may be polled externally.
+            /// Note that send timeout is not checked here. External code should check it while polling.
+            if (async_callback)
             {
-                while (res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE)
-                    res = writeToSocket(pos, size);
+                socket.setBlocking(false);
+                /// Set socket to blocking mode at the end.
+                SCOPE_EXIT(socket.setBlocking(true));
+                bool secure = socket.secure();
+                res = socket.impl()->sendBytes(pos, static_cast<int>(size));
+
+                /// Check EAGAIN and ERR_SSL_WANT_WRITE/ERR_SSL_WANT_READ for secure socket (writing to secure socket can read too).
+                while (res < 0 && (errno == EAGAIN || (secure && (checkSSLWantRead(res) || checkSSLWantWrite(res)))))
+                {
+                    /// In case of ERR_SSL_WANT_READ we should wait for socket to be ready for reading, otherwise - for writing.
+                    if (secure && checkSSLWantRead(res))
+                        async_callback(socket.impl()->sockfd(), socket.getReceiveTimeout(), AsyncEventTimeoutType::RECEIVE, socket_description, AsyncTaskExecutor::Event::READ | AsyncTaskExecutor::Event::ERROR);
+                    else
+                        async_callback(socket.impl()->sockfd(), socket.getSendTimeout(), AsyncEventTimeoutType::SEND, socket_description, AsyncTaskExecutor::Event::WRITE | AsyncTaskExecutor::Event::ERROR);
+
+                    /// Try to write again.
+                    res = socket.impl()->sendBytes(pos, static_cast<int>(size));
+                }
+            }
+            else
+            {
+                res = socket.impl()->sendBytes(pos, static_cast<int>(size));
             }
-#endif
         }
         catch (const Poco::Net::NetException & e)
         {
@@ -104,18 +116,6 @@ void WriteBufferFromPocoSocket::nextImpl()
     }
 }
 
-ssize_t WriteBufferFromPocoSocket::writeToSocket(char * data, size_t size)
-{
-    /// If async_callback is specified, and write will block, run async_callback and try again later.
-    /// It is expected that file descriptor may be polled externally.
-    /// Note that send timeout is not checked here. External code should check it while polling.
-    while (async_callback && !socket.poll(0, Poco::Net::Socket::SELECT_WRITE | Poco::Net::Socket::SELECT_ERROR))
-        async_callback(socket.impl()->sockfd(), socket.getSendTimeout(), AsyncEventTimeoutType::SEND, socket_description, AsyncTaskExecutor::Event::WRITE | AsyncTaskExecutor::Event::ERROR);
-
-    return socket.impl()->sendBytes(data, static_cast<int>(size));
-
-}
-
 WriteBufferFromPocoSocket::WriteBufferFromPocoSocket(Poco::Net::Socket & socket_, size_t buf_size)
     : BufferWithOwnMemory<WriteBuffer>(buf_size)
     , socket(socket_)
diff --git a/src/IO/WriteBufferFromPocoSocket.h b/src/IO/WriteBufferFromPocoSocket.h
index 0f03e816af5..ecb61020357 100644
--- a/src/IO/WriteBufferFromPocoSocket.h
+++ b/src/IO/WriteBufferFromPocoSocket.h
@@ -35,8 +35,6 @@ protected:
     Poco::Net::SocketAddress our_address;
 
 private:
-    ssize_t writeToSocket(char * data, size_t size);
-
     AsyncCallback async_callback;
     std::string socket_description;
 };

From 806b7fc18b0e526f39f6b9f04faa2ee90d4136ee Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Sat, 27 May 2023 17:39:21 +0800
Subject: [PATCH 0175/1478] fix datetime64 index querying

---
 src/Interpreters/convertFieldToType.cpp                   | 8 ++++++++
 .../1_stateful/00178_query_datetime64_index.reference     | 1 +
 tests/queries/1_stateful/00178_query_datetime64_index.sql | 8 ++++++++
 3 files changed, 17 insertions(+)
 create mode 100644 tests/queries/1_stateful/00178_query_datetime64_index.reference
 create mode 100644 tests/queries/1_stateful/00178_query_datetime64_index.sql

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index dc61e748db6..9d82cade814 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -192,6 +192,14 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
     {
         return static_cast<const DataTypeDateTime &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
     }
+    else if(which_type.isDateTime64() && which_from_type.isDate()) {
+        const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
+        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
+    }
+    else if(which_type.isDateTime64() && which_from_type.isDate()) {
+        const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
+        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
+    }
     else if (type.isValueRepresentedByNumber() && src.getType() != Field::Types::String)
     {
         if (which_type.isUInt8()) return convertNumericType<UInt8>(src, type);
diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.reference b/tests/queries/1_stateful/00178_query_datetime64_index.reference
new file mode 100644
index 00000000000..3d26cfc1d66
--- /dev/null
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.reference
@@ -0,0 +1 @@
+2023-05-27 00:00:00.000
diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.sql b/tests/queries/1_stateful/00178_query_datetime64_index.sql
new file mode 100644
index 00000000000..0e46401c2d3
--- /dev/null
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.sql
@@ -0,0 +1,8 @@
+DROP TABLE IF EXISTS datetime64_index_tbl;
+
+CREATE TABLE datetime64_index_tbl(ts DateTime64(3, 'UTC')) ENGINE=MergeTree ORDER BY ts;
+INSERT INTO datetime64_index_tbl(ts) VALUES(toDateTime64('2023-05-27 00:00:00', 3, 'UTC'));
+
+SELECT ts from datetime64_index_tbl where ts < toDate('2023-05-28');
+
+DROP TABLE datetime64_index_tbl;
\ No newline at end of file

From 41c599b86252d7219adc8e0adc455d93d5e7a5ee Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Sat, 27 May 2023 17:59:41 +0800
Subject: [PATCH 0176/1478] fix date32

---
 src/Interpreters/convertFieldToType.cpp                         | 2 +-
 tests/queries/1_stateful/00178_query_datetime64_index.reference | 1 +
 tests/queries/1_stateful/00178_query_datetime64_index.sql       | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index 9d82cade814..9bea9f6851f 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -196,7 +196,7 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }
-    else if(which_type.isDateTime64() && which_from_type.isDate()) {
+    else if(which_type.isDateTime64() && which_from_type.isDate32()) {
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }
diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.reference b/tests/queries/1_stateful/00178_query_datetime64_index.reference
index 3d26cfc1d66..f24667b36da 100644
--- a/tests/queries/1_stateful/00178_query_datetime64_index.reference
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.reference
@@ -1 +1,2 @@
 2023-05-27 00:00:00.000
+2023-05-27 00:00:00.000
diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.sql b/tests/queries/1_stateful/00178_query_datetime64_index.sql
index 0e46401c2d3..1e1d1561af7 100644
--- a/tests/queries/1_stateful/00178_query_datetime64_index.sql
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.sql
@@ -4,5 +4,6 @@ CREATE TABLE datetime64_index_tbl(ts DateTime64(3, 'UTC')) ENGINE=MergeTree ORDE
 INSERT INTO datetime64_index_tbl(ts) VALUES(toDateTime64('2023-05-27 00:00:00', 3, 'UTC'));
 
 SELECT ts from datetime64_index_tbl where ts < toDate('2023-05-28');
+SELECT ts from datetime64_index_tbl where ts < toDate32('2023-05-28');
 
 DROP TABLE datetime64_index_tbl;
\ No newline at end of file

From a8122861213071026430af636801587679b3e710 Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Sat, 27 May 2023 18:04:19 +0800
Subject: [PATCH 0177/1478] new line eof

---
 tests/queries/1_stateful/00178_query_datetime64_index.sql | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.sql b/tests/queries/1_stateful/00178_query_datetime64_index.sql
index 1e1d1561af7..68542bc0524 100644
--- a/tests/queries/1_stateful/00178_query_datetime64_index.sql
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.sql
@@ -6,4 +6,4 @@ INSERT INTO datetime64_index_tbl(ts) VALUES(toDateTime64('2023-05-27 00:00:00',
 SELECT ts from datetime64_index_tbl where ts < toDate('2023-05-28');
 SELECT ts from datetime64_index_tbl where ts < toDate32('2023-05-28');
 
-DROP TABLE datetime64_index_tbl;
\ No newline at end of file
+DROP TABLE datetime64_index_tbl;

From 93415789d7e69c2874171941f56eb92a6bc80bbf Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Sun, 28 May 2023 10:40:34 +0800
Subject: [PATCH 0178/1478] format

---
 src/Interpreters/convertFieldToType.cpp                   | 4 ++--
 tests/queries/1_stateful/00178_query_datetime64_index.sql | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index 9bea9f6851f..ba02eefabc9 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -192,11 +192,11 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
     {
         return static_cast<const DataTypeDateTime &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
     }
-    else if(which_type.isDateTime64() && which_from_type.isDate()) {
+    else if (which_type.isDateTime64() && which_from_type.isDate()) {
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }
-    else if(which_type.isDateTime64() && which_from_type.isDate32()) {
+    else if (which_type.isDateTime64() && which_from_type.isDate32()) {
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }
diff --git a/tests/queries/1_stateful/00178_query_datetime64_index.sql b/tests/queries/1_stateful/00178_query_datetime64_index.sql
index 68542bc0524..a3fb594db73 100644
--- a/tests/queries/1_stateful/00178_query_datetime64_index.sql
+++ b/tests/queries/1_stateful/00178_query_datetime64_index.sql
@@ -3,7 +3,7 @@ DROP TABLE IF EXISTS datetime64_index_tbl;
 CREATE TABLE datetime64_index_tbl(ts DateTime64(3, 'UTC')) ENGINE=MergeTree ORDER BY ts;
 INSERT INTO datetime64_index_tbl(ts) VALUES(toDateTime64('2023-05-27 00:00:00', 3, 'UTC'));
 
-SELECT ts from datetime64_index_tbl where ts < toDate('2023-05-28');
-SELECT ts from datetime64_index_tbl where ts < toDate32('2023-05-28');
+SELECT ts FROM datetime64_index_tbl WHERE ts < toDate('2023-05-28');
+SELECT ts FROM datetime64_index_tbl WHERE ts < toDate32('2023-05-28');
 
 DROP TABLE datetime64_index_tbl;

From 0d873d50a33d4837d4010be0385df23c8be9b204 Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Sun, 28 May 2023 10:49:36 +0800
Subject: [PATCH 0179/1478] format

---
 src/Interpreters/convertFieldToType.cpp | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index ba02eefabc9..79251d944c8 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -192,11 +192,13 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
     {
         return static_cast<const DataTypeDateTime &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
     }
-    else if (which_type.isDateTime64() && which_from_type.isDate()) {
+    else if (which_type.isDateTime64() && which_from_type.isDate())
+    {
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }
-    else if (which_type.isDateTime64() && which_from_type.isDate32()) {
+    else if (which_type.isDateTime64() && which_from_type.isDate32())
+    {
         const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
         return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
     }

From 65c34e73e7010bfb5c6298ed2a5bedcc434e7aa7 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Sun, 28 May 2023 15:45:40 +0200
Subject: [PATCH 0180/1478] Clean

---
 src/Common/checkSSLError.h | 8 --------
 1 file changed, 8 deletions(-)
 delete mode 100644 src/Common/checkSSLError.h

diff --git a/src/Common/checkSSLError.h b/src/Common/checkSSLError.h
deleted file mode 100644
index 05bca9f8b5f..00000000000
--- a/src/Common/checkSSLError.h
+++ /dev/null
@@ -1,8 +0,0 @@
-//
-// Created by Павел Круглов on 27/05/2023.
-//
-
-#ifndef CLICKHOUSE_CHECKSSLERROR_H
-#define CLICKHOUSE_CHECKSSLERROR_H
-
-#endif //CLICKHOUSE_CHECKSSLERROR_H

From 3aa795355f946e6638804124b03d0724bf1ba37b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Sun, 28 May 2023 15:46:32 +0200
Subject: [PATCH 0181/1478] Fix build

---
 src/Common/checkSSLReturnCode.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Common/checkSSLReturnCode.h b/src/Common/checkSSLReturnCode.h
index f30564137aa..77e51625daf 100644
--- a/src/Common/checkSSLReturnCode.h
+++ b/src/Common/checkSSLReturnCode.h
@@ -1,4 +1,5 @@
 #pragma once
+#include <sys/types.h>
 
 namespace DB
 {

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 0182/1478] 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 954e76cb7a432081df8865a2988749fec3b950e4 Mon Sep 17 00:00:00 2001
From: Lucas Chang <weiweichang@tubi.tv>
Date: Tue, 30 May 2023 09:38:50 +0800
Subject: [PATCH 0183/1478] use getScaleMultiplier

---
 src/Interpreters/convertFieldToType.cpp | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index 79251d944c8..1ea9ecd7e00 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -194,13 +194,15 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
     }
     else if (which_type.isDateTime64() && which_from_type.isDate())
     {
-        const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
-        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
+        const DataTypeDateTime64 & data_type_date_time64 = static_cast<const DataTypeDateTime64 &>(type);
+        const Int64 value = data_type_date_time64.getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
+        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, data_type_date_time64.getScaleMultiplier());
     }
     else if (which_type.isDateTime64() && which_from_type.isDate32())
     {
-        const auto value = static_cast<const DataTypeDateTime64 &>(type).getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
-        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, 1);
+        const DataTypeDateTime64 & data_type_date_time64 = static_cast<const DataTypeDateTime64 &>(type);
+        const Int64 value = data_type_date_time64.getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
+        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, data_type_date_time64.getScaleMultiplier());
     }
     else if (type.isValueRepresentedByNumber() && src.getType() != Field::Types::String)
     {

From fe82d2bbe24a98bf2192796f47a9b1e2b5d40b3a Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Tue, 30 May 2023 12:58:37 +0200
Subject: [PATCH 0184/1478] Fix build

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

diff --git a/src/Common/checkSSLReturnCode.cpp b/src/Common/checkSSLReturnCode.cpp
index 8916a25e19c..bc87af1d37d 100644
--- a/src/Common/checkSSLReturnCode.cpp
+++ b/src/Common/checkSSLReturnCode.cpp
@@ -8,7 +8,7 @@
 namespace DB
 {
 
-bool checkSSLWantRead(ssize_t res)
+bool checkSSLWantRead([[maybe_unused]] ssize_t res)
 {
 #if USE_SSL
     return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ;
@@ -17,7 +17,7 @@ bool checkSSLWantRead(ssize_t res)
 #endif
 }
 
-bool checkSSLWantWrite(ssize_t res)
+bool checkSSLWantWrite([[maybe_unused]] ssize_t res)
 {
 #if USE_SSL
     return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE;

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 0185/1478] 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 092b06f32eb7e4e8b0c4f379632d560810393299 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Tue, 30 May 2023 14:36:47 +0200
Subject: [PATCH 0186/1478] Fix special build

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

diff --git a/src/Common/checkSSLReturnCode.cpp b/src/Common/checkSSLReturnCode.cpp
index bc87af1d37d..353c287813d 100644
--- a/src/Common/checkSSLReturnCode.cpp
+++ b/src/Common/checkSSLReturnCode.cpp
@@ -8,7 +8,7 @@
 namespace DB
 {
 
-bool checkSSLWantRead([[maybe_unused]] ssize_t res)
+bool checkSSLWantRead([[maybe_unused]] ssize_t ret)
 {
 #if USE_SSL
     return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ;
@@ -17,7 +17,7 @@ bool checkSSLWantRead([[maybe_unused]] ssize_t res)
 #endif
 }
 
-bool checkSSLWantWrite([[maybe_unused]] ssize_t res)
+bool checkSSLWantWrite([[maybe_unused]] ssize_t ret)
 {
 #if USE_SSL
     return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE;

From 21aba94909e2ab7fe357c30d694af8674f81dbd0 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Tue, 30 May 2023 13:22:40 +0000
Subject: [PATCH 0187/1478] Add support for latest snapshot disk

---
 src/Coordination/KeeperContext.cpp         |  11 ++
 src/Coordination/KeeperContext.h           |   2 +
 src/Coordination/KeeperSnapshotManager.cpp | 143 ++++++++++++++-------
 src/Coordination/KeeperSnapshotManager.h   |   4 +
 src/Coordination/KeeperStateMachine.cpp    |   8 +-
 5 files changed, 119 insertions(+), 49 deletions(-)

diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index 9d7e62ffae7..5ec86c827b8 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -43,6 +43,11 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
 
     snapshot_storage = getSnapshotsPathFromConfig(config);
 
+    if (config.has("keeper_server.latest_snapshot_storage_disk"))
+        latest_snapshot_storage = config.getString("keeper_server.latest_snapshot_storage_disk");
+    else
+        latest_snapshot_storage = snapshot_storage;
+
     state_file_storage = getStatePathFromConfig(config);
 }
 
@@ -107,6 +112,11 @@ void KeeperContext::setLogDisk(DiskPtr disk)
     latest_log_storage = std::move(disk);
 }
 
+DiskPtr KeeperContext::getLatestSnapshotDisk() const
+{
+    return getDisk(latest_snapshot_storage);
+}
+
 DiskPtr KeeperContext::getSnapshotDisk() const
 {
     return getDisk(snapshot_storage);
@@ -126,6 +136,7 @@ std::vector<DiskPtr> KeeperContext::getOldSnapshotDisks() const
 void KeeperContext::setSnapshotDisk(DiskPtr disk)
 {
     snapshot_storage = std::move(disk);
+    latest_snapshot_storage = snapshot_storage;
 }
 
 DiskPtr KeeperContext::getStateFileDisk() const
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 00607fd904e..b04afd2a57b 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -39,6 +39,7 @@ public:
     std::vector<DiskPtr> getOldLogDisks() const;
     void setLogDisk(DiskPtr disk);
 
+    DiskPtr getLatestSnapshotDisk() const;
     DiskPtr getSnapshotDisk() const;
     std::vector<DiskPtr> getOldSnapshotDisks() const;
     void setSnapshotDisk(DiskPtr disk);
@@ -67,6 +68,7 @@ private:
     Storage log_storage;
     Storage latest_log_storage;
     Storage snapshot_storage;
+    Storage latest_snapshot_storage;
     Storage state_file_storage;
 
     std::vector<std::string> old_log_disk_names;
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index c3371501976..4b9a34c07e9 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -16,6 +16,7 @@
 #include <Coordination/pathUtils.h>
 #include <Coordination/KeeperConstants.h>
 #include <Common/ZooKeeper/ZooKeeperCommon.h>
+#include "Core/Field.h"
 #include <Disks/DiskLocal.h>
 
 
@@ -31,6 +32,24 @@ namespace ErrorCodes
 
 namespace
 {
+    constexpr std::string_view tmp_prefix = "tmp_";
+
+    void moveFileBetweenDisks(DiskPtr disk_from, const std::string & path_from, DiskPtr disk_to, const std::string & path_to)
+    {
+        /// we use empty file with prefix tmp_ to detect incomplete copies
+        /// if a copy is complete we don't care from which disk we use the same file
+        /// so it's okay if a failure happens after removing of tmp file but before we remove
+        /// the snapshot from the source disk
+        auto from_path = fs::path(path_from);
+        auto tmp_snapshot_name = from_path.parent_path() / (std::string{tmp_prefix} + from_path.filename().string());
+        {
+            disk_to->writeFile(tmp_snapshot_name);
+        }
+        disk_from->copyFile(from_path, *disk_to, path_to, {});
+        disk_to->removeFile(tmp_snapshot_name);
+        disk_from->removeFile(path_from);
+    }
+
     uint64_t getSnapshotPathUpToLogIdx(const String & snapshot_path)
     {
         std::filesystem::path path(snapshot_path);
@@ -519,43 +538,48 @@ KeeperSnapshotManager::KeeperSnapshotManager(
     , storage_tick_time(storage_tick_time_)
     , keeper_context(keeper_context_)
 {
-    const auto load_snapshot_from_disk = [&](DiskPtr disk)
+    const auto load_snapshot_from_disk = [&](const auto & disk)
     {
-        std::unordered_set<std::string> invalid_snapshots;
-        /// collect invalid snapshots
+        LOG_TRACE(log, "Reading from disk {}", disk->getName());
+        std::unordered_map<std::string, std::string> incomplete_files;
+
+        const auto clean_incomplete_file = [&](const auto & file_path)
+        {
+            if (auto incomplete_it = incomplete_files.find(fs::path(file_path).filename()); incomplete_it != incomplete_files.end())
+            {
+                LOG_TRACE(log, "Removing {} from {}", file_path, disk->getName());
+                disk->removeFile(file_path);
+                disk->removeFile(incomplete_it->second);
+                incomplete_files.erase(incomplete_it);
+                return true;
+            }
+
+            return false;
+        };
+
+        std::vector<std::string> snapshot_files;
         for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
         {
-            const auto & name = it->name();
-            if (name.empty())
-                continue;
-
-            if (startsWith(name, "tmp_"))
+            if (it->name().starts_with(tmp_prefix))
             {
-                disk->removeFile(it->path());
-                invalid_snapshots.insert(name.substr(4));
+                incomplete_files.emplace(it->name().substr(tmp_prefix.size()), it->path());
                 continue;
             }
+
+            if (clean_incomplete_file(it->path()))
+                continue;
+
+            snapshot_files.push_back(it->path());
         }
 
-        /// process snapshots
-        for (auto it = disk->iterateDirectory(""); it->isValid(); it->next())
+        for (const auto & snapshot_file : snapshot_files)
         {
-            const auto & name = it->name();
-            if (name.empty())
+            if (clean_incomplete_file(fs::path(snapshot_file).filename()))
                 continue;
 
-            /// Not snapshot file
-            if (!startsWith(name, "snapshot_"))
-                continue;
-
-            if (invalid_snapshots.contains(name))
-            {
-                disk->removeFile(it->path());
-                continue;
-            }
-
-            size_t snapshot_up_to = getSnapshotPathUpToLogIdx(name);
-            auto [_, inserted] = existing_snapshots.insert_or_assign(snapshot_up_to, SnapshotFileInfo{it->path(), disk});
+            LOG_TRACE(log, "Found {} on {}", snapshot_file, disk->getName());
+            size_t snapshot_up_to = getSnapshotPathUpToLogIdx(snapshot_file);
+            auto [_, inserted] = existing_snapshots.insert_or_assign(snapshot_up_to, SnapshotFileInfo{snapshot_file, disk});
 
             if (!inserted)
                 LOG_WARNING(
@@ -564,6 +588,9 @@ KeeperSnapshotManager::KeeperSnapshotManager(
                     snapshot_up_to,
                     disk->getName());
         }
+
+        for (const auto & [name, path] : incomplete_files)
+            disk->removeFile(path);
     };
 
     for (const auto & disk : keeper_context->getOldSnapshotDisks())
@@ -572,25 +599,12 @@ KeeperSnapshotManager::KeeperSnapshotManager(
     auto disk = getDisk();
     load_snapshot_from_disk(disk);
 
+    auto latest_snapshot_disk = getLatestSnapshotDisk();
+    if (latest_snapshot_disk != disk)
+        load_snapshot_from_disk(latest_snapshot_disk);
+
     removeOutdatedSnapshotsIfNeeded();
-
-    /// move snapshots from old disks to new one 
-    for (auto & [_, file_info] : existing_snapshots)
-    {
-        if (file_info.disk == disk)
-            continue;
-
-        auto file_path = fs::path(file_info.path);
-        auto tmp_snapshot_path = file_path.parent_path() / ("tmp_" + file_path.filename().generic_string());
-
-        {
-            disk->writeFile(tmp_snapshot_path);
-        }
-
-        file_info.disk->copyFile(file_info.path, *disk, file_info.path, {});
-        disk->removeFile(tmp_snapshot_path);
-        file_info.disk = disk;
-    }
+    moveSnapshotsIfNeeded();
 }
 
 SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::buffer & buffer, uint64_t up_to_log_idx)
@@ -600,7 +614,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::bu
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
-    auto disk = getDisk();
+    auto disk = getLatestSnapshotDisk();
 
     {
         disk->writeFile(tmp_snapshot_file_name);
@@ -614,6 +628,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::bu
 
     existing_snapshots.emplace(up_to_log_idx, SnapshotFileInfo{snapshot_file_name, disk});
     removeOutdatedSnapshotsIfNeeded();
+    moveSnapshotsIfNeeded();
 
     return {snapshot_file_name, disk};
 }
@@ -710,12 +725,47 @@ DiskPtr KeeperSnapshotManager::getDisk() const
     return keeper_context->getSnapshotDisk();
 }
 
+DiskPtr KeeperSnapshotManager::getLatestSnapshotDisk() const
+{
+    return keeper_context->getLatestSnapshotDisk();
+}
+
 void KeeperSnapshotManager::removeOutdatedSnapshotsIfNeeded()
 {
     while (existing_snapshots.size() > snapshots_to_keep)
         removeSnapshot(existing_snapshots.begin()->first);
 }
 
+void KeeperSnapshotManager::moveSnapshotsIfNeeded()
+{
+    /// move snapshots to correct disks
+
+    auto disk = getDisk();
+    auto latest_snapshot_disk = getLatestSnapshotDisk();
+    auto latest_snapshot_idx = getLatestSnapshotIndex();
+
+    for (auto & [idx, file_info] : existing_snapshots)
+    {
+        if (idx == latest_snapshot_idx)
+        {
+            if (file_info.disk != latest_snapshot_disk)
+            {
+                moveFileBetweenDisks(file_info.disk, file_info.path, latest_snapshot_disk, file_info.path);
+                file_info.disk = latest_snapshot_disk;
+            }
+        }
+        else
+        {
+            if (file_info.disk != disk)
+            {
+                moveFileBetweenDisks(file_info.disk, file_info.path, disk, file_info.path);
+                file_info.disk = disk;
+            }
+        }
+    }
+
+}
+
 void KeeperSnapshotManager::removeSnapshot(uint64_t log_idx)
 {
     auto itr = existing_snapshots.find(log_idx);
@@ -732,7 +782,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStor
     auto snapshot_file_name = getSnapshotFileName(up_to_log_idx, compress_snapshots_zstd);
     auto tmp_snapshot_file_name = "tmp_" + snapshot_file_name;
 
-    auto disk = getDisk();
+    auto disk = getLatestSnapshotDisk();
     {
         disk->writeFile(tmp_snapshot_file_name);
     }
@@ -752,6 +802,7 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStor
 
     existing_snapshots.emplace(up_to_log_idx, SnapshotFileInfo{snapshot_file_name, disk});
     removeOutdatedSnapshotsIfNeeded();
+    moveSnapshotsIfNeeded();
 
     return {snapshot_file_name, disk};
 }
diff --git a/src/Coordination/KeeperSnapshotManager.h b/src/Coordination/KeeperSnapshotManager.h
index 0afe582ef59..9bb287b9276 100644
--- a/src/Coordination/KeeperSnapshotManager.h
+++ b/src/Coordination/KeeperSnapshotManager.h
@@ -165,8 +165,10 @@ public:
 
 private:
     void removeOutdatedSnapshotsIfNeeded();
+    void moveSnapshotsIfNeeded();
 
     DiskPtr getDisk() const;
+    DiskPtr getLatestSnapshotDisk() const;
 
     /// Checks first 4 buffer bytes to became sure that snapshot compressed with
     /// ZSTD codec.
@@ -184,6 +186,8 @@ private:
     size_t storage_tick_time;
 
     KeeperContextPtr keeper_context;
+
+    Poco::Logger * log = &Poco::Logger::get("KeeperSnapshotManager");
 };
 
 /// Keeper create snapshots in background thread. KeeperStateMachine just create
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index e7cd409f569..a8c0d8d1518 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -468,15 +468,17 @@ void KeeperStateMachine::create_snapshot(nuraft::snapshot & s, nuraft::async_res
                 {
                     latest_snapshot_meta = snapshot->snapshot_meta;
                     /// we rely on the fact that the snapshot disk cannot be changed during runtime
-                    if (isLocalDisk(*keeper_context->getSnapshotDisk()))
+                    if (isLocalDisk(*keeper_context->getLatestSnapshotDisk()))
                     {
-                        latest_snapshot_info = snapshot_manager.serializeSnapshotToDisk(*snapshot);
+                        auto snapshot_info = snapshot_manager.serializeSnapshotToDisk(*snapshot);
+                        latest_snapshot_info = std::move(snapshot_info);
                         latest_snapshot_buf = nullptr;
                     }
                     else
                     {
                         auto snapshot_buf = snapshot_manager.serializeSnapshotToBuffer(*snapshot);
-                        latest_snapshot_info = snapshot_manager.serializeSnapshotBufferToDisk(*snapshot_buf, snapshot->snapshot_meta->get_last_log_idx());
+                        auto snapshot_info = snapshot_manager.serializeSnapshotBufferToDisk(*snapshot_buf, snapshot->snapshot_meta->get_last_log_idx());
+                        latest_snapshot_info = std::move(snapshot_info);
                         latest_snapshot_buf = std::move(snapshot_buf);
                     }
 

From 93cf34320c12d17554d047497928cac1c177937b Mon Sep 17 00:00:00 2001
From: Vasily Nemkov <V.Nemkov@gmail.com>
Date: Tue, 30 May 2023 16:10:52 +0200
Subject: [PATCH 0188/1478] Fixed convertFieldToType case of converting Date
 and Date32 to DateTime64 Field

Also added a unit-test that clarifies implementation
---
 src/Interpreters/convertFieldToType.cpp       |  16 +-
 .../tests/gtest_convertFieldToType.cpp        | 185 ++++++++++++++++++
 2 files changed, 195 insertions(+), 6 deletions(-)
 create mode 100644 src/Interpreters/tests/gtest_convertFieldToType.cpp

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index 1ea9ecd7e00..ff09175f898 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -194,15 +194,19 @@ Field convertFieldToTypeImpl(const Field & src, const IDataType & type, const ID
     }
     else if (which_type.isDateTime64() && which_from_type.isDate())
     {
-        const DataTypeDateTime64 & data_type_date_time64 = static_cast<const DataTypeDateTime64 &>(type);
-        const Int64 value = data_type_date_time64.getTimeZone().fromDayNum(DayNum(src.get<UInt64>()));
-        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, data_type_date_time64.getScaleMultiplier());
+        const auto & date_time64_type = static_cast<const DataTypeDateTime64 &>(type);
+        const auto value = date_time64_type.getTimeZone().fromDayNum(DayNum(src.get<UInt16>()));
+        return DecimalField(
+            DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, date_time64_type.getScaleMultiplier()),
+            date_time64_type.getScale());
     }
     else if (which_type.isDateTime64() && which_from_type.isDate32())
     {
-        const DataTypeDateTime64 & data_type_date_time64 = static_cast<const DataTypeDateTime64 &>(type);
-        const Int64 value = data_type_date_time64.getTimeZone().fromDayNum(DayNum(src.get<Int32>()));
-        return DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, data_type_date_time64.getScaleMultiplier());
+        const auto & date_time64_type = static_cast<const DataTypeDateTime64 &>(type);
+        const auto value = date_time64_type.getTimeZone().fromDayNum(ExtendedDayNum(static_cast<Int32>(src.get<Int32>())));
+        return DecimalField(
+            DecimalUtils::decimalFromComponentsWithMultiplier<DateTime64>(value, 0, date_time64_type.getScaleMultiplier()),
+            date_time64_type.getScale());
     }
     else if (type.isValueRepresentedByNumber() && src.getType() != Field::Types::String)
     {
diff --git a/src/Interpreters/tests/gtest_convertFieldToType.cpp b/src/Interpreters/tests/gtest_convertFieldToType.cpp
new file mode 100644
index 00000000000..5421c192ac7
--- /dev/null
+++ b/src/Interpreters/tests/gtest_convertFieldToType.cpp
@@ -0,0 +1,185 @@
+#include <initializer_list>
+#include <limits>
+#include <ostream>
+#include <Core/Field.h>
+#include <Core/iostream_debug_helpers.h>
+#include <Interpreters/convertFieldToType.h>
+#include <DataTypes/DataTypeFactory.h>
+
+#include <gtest/gtest.h>
+#include "base/Decimal.h"
+#include "base/types.h"
+#include "gtest/gtest.h"
+
+using namespace DB;
+
+struct ConvertFieldToTypeTestParams
+{
+    const char * from_type; // MUST NOT BE NULL
+    const Field from_value;
+    const char * to_type; // MUST NOT BE NULL
+    const std::optional<Field> expected_value;
+};
+
+std::ostream & operator << (std::ostream & ostr, const ConvertFieldToTypeTestParams & params)
+{
+    return ostr << "{"
+            << "\n\tfrom_type  : " << params.from_type
+            << "\n\tfrom_value : " << params.from_value
+            << "\n\tto_type    : " << params.to_type
+            << "\n\texpected   : " << (params.expected_value ? *params.expected_value : Field())
+            << "\n}";
+}
+
+class ConvertFieldToTypeTest : public ::testing::TestWithParam<ConvertFieldToTypeTestParams>
+{};
+
+TEST_P(ConvertFieldToTypeTest, convert)
+{
+    const auto & params = GetParam();
+
+    ASSERT_NE(nullptr, params.from_type);
+    ASSERT_NE(nullptr, params.to_type);
+
+    const auto & type_factory = DataTypeFactory::instance();
+    const auto from_type = type_factory.get(params.from_type);
+    const auto to_type = type_factory.get(params.to_type);
+
+    if (params.expected_value)
+    {
+        const auto result = convertFieldToType(params.from_value, *to_type, from_type.get());
+        EXPECT_EQ(*params.expected_value, result);
+    }
+    else
+    {
+        EXPECT_ANY_THROW(convertFieldToType(params.from_value, *to_type, from_type.get()));
+    }
+}
+
+// Basically nuber of seconds in a day, works for UTC here
+const long long int Day = 24 * 60 * 60;
+
+// 123 is arbitrary value here
+
+INSTANTIATE_TEST_SUITE_P(
+    DateToDateTime64,
+    ConvertFieldToTypeTest,
+    ::testing::ValuesIn(std::initializer_list<ConvertFieldToTypeTestParams>{
+        // min value of Date
+        {
+            "Date",
+            Field(0),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(0), 0)
+        },
+        // Max value of Date
+        {
+            "Date",
+            Field(std::numeric_limits<DB::UInt16>::max()),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(std::numeric_limits<DB::UInt16>::max() * Day), 0)
+        },
+        // check that scale is respected
+        {
+            "Date",
+            Field(123),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(123 * Day), 0)
+        },
+        {
+            "Date",
+            Field(1),
+            "DateTime64(1, 'UTC')",
+            DecimalField(DateTime64(Day * 10), 1)
+        },
+        {
+            "Date",
+            Field(123),
+            "DateTime64(3, 'UTC')",
+            DecimalField(DateTime64(123 * Day * 1000), 3)
+        },
+        {
+            "Date",
+            Field(123),
+            "DateTime64(6, 'UTC')",
+            DecimalField(DateTime64(123 * Day * 1'000'000), 6)
+        },
+    })
+);
+
+INSTANTIATE_TEST_SUITE_P(
+    Date32ToDateTime64,
+    ConvertFieldToTypeTest,
+    ::testing::ValuesIn(std::initializer_list<ConvertFieldToTypeTestParams>{
+        // min value of Date32: 1st Jan 1900 (see DATE_LUT_MIN_YEAR)
+        {
+            "Date32",
+            Field(-25'567),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(-25'567 * Day), 0)
+        },
+        // max value of Date32: 31 Dec 2299 (see DATE_LUT_MAX_YEAR)
+        {
+            "Date32",
+            Field(120'529),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(120'529 * Day), 0)
+        },
+        // check that scale is respected
+        {
+            "Date32",
+            Field(123),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(123 * Day), 0)
+        },
+        {
+            "Date32",
+            Field(123),
+            "DateTime64(1, 'UTC')",
+            DecimalField(DateTime64(123 * Day * 10), 1)
+        },
+        {
+            "Date32",
+            Field(123),
+            "DateTime64(3, 'UTC')",
+            DecimalField(DateTime64(123 * Day * 1000), 3)
+        },
+        {
+            "Date32",
+            Field(123),
+            "DateTime64(6, 'UTC')",
+            DecimalField(DateTime64(123 * Day * 1'000'000), 6)
+        }
+    })
+    );
+
+INSTANTIATE_TEST_SUITE_P(
+    DateTimeToDateTime64,
+    ConvertFieldToTypeTest,
+    ::testing::ValuesIn(std::initializer_list<ConvertFieldToTypeTestParams>{
+        {
+            "DateTime",
+            Field(1),
+            "DateTime64(0, 'UTC')",
+            DecimalField(DateTime64(1), 0)
+        },
+        {
+            "DateTime",
+            Field(1),
+            "DateTime64(1, 'UTC')",
+            DecimalField(DateTime64(1'0), 1)
+        },
+        {
+            "DateTime",
+            Field(123),
+            "DateTime64(3, 'UTC')",
+            DecimalField(DateTime64(123'000), 3)
+        },
+        {
+            "DateTime",
+            Field(123),
+            "DateTime64(6, 'UTC')",
+            DecimalField(DateTime64(123'000'000), 6)
+        },
+    })
+);

From 1c904ecc8ef5886ec90221f52c02758a26a5b81e Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Tue, 30 May 2023 16:25:17 +0200
Subject: [PATCH 0189/1478] Fix typo

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

diff --git a/src/Common/checkSSLReturnCode.cpp b/src/Common/checkSSLReturnCode.cpp
index 353c287813d..ffb912da18a 100644
--- a/src/Common/checkSSLReturnCode.cpp
+++ b/src/Common/checkSSLReturnCode.cpp
@@ -11,7 +11,7 @@ namespace DB
 bool checkSSLWantRead([[maybe_unused]] ssize_t ret)
 {
 #if USE_SSL
-    return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ;
+    return ret == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_READ;
 #else
     return false;
 #endif
@@ -20,7 +20,7 @@ bool checkSSLWantRead([[maybe_unused]] ssize_t ret)
 bool checkSSLWantWrite([[maybe_unused]] ssize_t ret)
 {
 #if USE_SSL
-    return res == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE;
+    return ret == Poco::Net::SecureStreamSocket::ERR_SSL_WANT_WRITE;
 #else
     return false;
 #endif

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 0190/1478] 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 e91934bceaea3809feb0e2e52532b9eeb35ad7f2 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 30 May 2023 16:02:14 +0000
Subject: [PATCH 0191/1478] Fixing style.

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

diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 8d2f2204e84..fa4fc2c82df 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -202,7 +202,7 @@ public:
                     external_storage_holder->future_set = std::move(future_set);
                 }
                 else
-                    throw Exception(ErrorCodes::LOGICAL_ERROR, "!!!!!!!!");
+                    throw Exception(ErrorCodes::LOGICAL_ERROR, "Set is already created for GLOBAL IN");
                     //prepared_sets->addStorageToSubquery(key, std::move(external_storage));
             }
 

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 0192/1478] 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 c7403284260992c296fbb34782bd1007a18ba28f Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 30 May 2023 18:51:18 +0000
Subject: [PATCH 0193/1478] Fix more tests.

---
 src/Interpreters/ActionsVisitor.cpp            | 11 +++++++----
 src/Planner/CollectSets.cpp                    |  2 ++
 src/Processors/QueryPlan/ReadFromMergeTree.cpp | 13 +++++++++++--
 3 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 23c6867a868..142b6f73b75 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1420,11 +1420,14 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
                     return data.prepared_sets->addFromStorage(set_key, storage_set->getSet());
             }
 
-            // std::cerr << ".... checking for " << identifier->getColumnName() << std::endl;
-            if (auto tmp_table = data.getContext()->findExternalTable(identifier->getColumnName()))
+            if (!data.getContext()->isGlobalContext())
             {
-                external_table_set = tmp_table->future_set;
-                // std::cerr << "Found " << reinterpret_cast<const void *>(tmp_table.get()) << " " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
+                // std::cerr << ".... checking for " << identifier->getColumnName() << std::endl;
+                if (auto tmp_table = data.getContext()->findExternalTable(identifier->getColumnName()))
+                {
+                    external_table_set = tmp_table->future_set;
+                    // std::cerr << "Found " << reinterpret_cast<const void *>(tmp_table.get()) << " " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
+                }
             }
         }
 
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 19dc569ff0c..913cf1c6ee3 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -90,6 +90,8 @@ public:
             in_second_argument_node_type == QueryTreeNodeType::UNION)
         {
             auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
+            if (sets.getFuture(set_key))
+                return;
 
             auto subquery_options = select_query_options.subquery();
             Planner subquery_planner(
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 367d3dcb525..8483df797ef 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1236,6 +1236,15 @@ static void buildIndexes(
     if (!indexes->use_skip_indexes)
         return;
 
+    const SelectQueryInfo * info = &query_info;
+    std::optional<SelectQueryInfo> info_copy;
+    if (settings.allow_experimental_analyzer)
+    {
+        info_copy.emplace(query_info);
+        info_copy->filter_actions_dag = filter_actions_dag;
+        info = &*info_copy;
+    }
+
     UsefulSkipIndexes skip_indexes;
     using Key = std::pair<String, size_t>;
     std::map<Key, size_t> merged;
@@ -1249,14 +1258,14 @@ static void buildIndexes(
             if (inserted)
             {
                 skip_indexes.merged_indices.emplace_back();
-                skip_indexes.merged_indices.back().condition = index_helper->createIndexMergedCondition(query_info, metadata_snapshot);
+                skip_indexes.merged_indices.back().condition = index_helper->createIndexMergedCondition(*info, metadata_snapshot);
             }
 
             skip_indexes.merged_indices[it->second].addIndex(index_helper);
         }
         else
         {
-            auto condition = index_helper->createIndexCondition(query_info, context);
+            auto condition = index_helper->createIndexCondition(*info, context);
             if (!condition->alwaysUnknownOrTrue())
                 skip_indexes.useful_indices.emplace_back(index_helper, condition);
         }

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 0194/1478] 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 0195/1478] 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 0196/1478] 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 0197/1478] 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 0198/1478] 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 0199/1478] 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 0200/1478] 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 0201/1478] 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 0202/1478] 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 0203/1478] 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 0204/1478] 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 0205/1478] 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 0206/1478] 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 0207/1478] 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 0208/1478] 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 0209/1478] 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 0210/1478] 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 5dbce62ec365f8d4801faef4ef5a0cd8eb117615 Mon Sep 17 00:00:00 2001
From: lgbo-ustc <lgbo.ustc@gmail.com>
Date: Wed, 31 May 2023 17:37:20 +0800
Subject: [PATCH 0211/1478] fixed. without apply prepareRightBlock will cause
 mismatch block structure

---
 src/Interpreters/GraceHashJoin.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Interpreters/GraceHashJoin.cpp b/src/Interpreters/GraceHashJoin.cpp
index f54ee9d85c7..0dd61ff2793 100644
--- a/src/Interpreters/GraceHashJoin.cpp
+++ b/src/Interpreters/GraceHashJoin.cpp
@@ -623,6 +623,7 @@ Block GraceHashJoin::prepareRightBlock(const Block & block)
 
 void GraceHashJoin::addJoinedBlockImpl(Block block)
 {
+    block = prepareRightBlock(block);
     Buckets buckets_snapshot = getCurrentBuckets();
     size_t bucket_index = current_bucket->idx;
     Block current_block;

From 0b4d29ff98916d3ab1f2ea24f4254897b18351cf Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 1 Jun 2023 12:19:00 +0000
Subject: [PATCH 0212/1478] Add tests for disks

---
 .../integration/test_keeper_disks/__init__.py |   0
 .../configs/enable_keeper.xml                 |  53 ++++
 tests/integration/test_keeper_disks/test.py   | 260 ++++++++++++++++++
 3 files changed, 313 insertions(+)
 create mode 100644 tests/integration/test_keeper_disks/__init__.py
 create mode 100644 tests/integration/test_keeper_disks/configs/enable_keeper.xml
 create mode 100644 tests/integration/test_keeper_disks/test.py

diff --git a/tests/integration/test_keeper_disks/__init__.py b/tests/integration/test_keeper_disks/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_keeper_disks/configs/enable_keeper.xml b/tests/integration/test_keeper_disks/configs/enable_keeper.xml
new file mode 100644
index 00000000000..5814979229c
--- /dev/null
+++ b/tests/integration/test_keeper_disks/configs/enable_keeper.xml
@@ -0,0 +1,53 @@
+<clickhouse>
+    <storage_configuration>
+        <disks>
+            <log_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/logs/</path>
+            </log_local>
+            <log_s3_plain>
+                <type>s3_plain</type>
+                <endpoint>http://minio1:9001/root/logs/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </log_s3_plain>
+            <snapshot_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/snapshots/</path>
+            </snapshot_local>
+            <snapshot_s3_plain>
+                <type>s3_plain</type>
+                <endpoint>http://minio1:9001/root/snapshots/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </snapshot_s3_plain>
+        </disks>
+    </storage_configuration>
+
+    <keeper_server>
+        <use_cluster>false</use_cluster>
+        <tcp_port>9181</tcp_port>
+        <server_id>1</server_id>
+        <create_snapshot_on_exit>false</create_snapshot_on_exit>
+
+        <coordination_settings>
+            <operation_timeout_ms>5000</operation_timeout_ms>
+            <session_timeout_ms>10000</session_timeout_ms>
+            <raft_logs_level>trace</raft_logs_level>
+            <snapshot_distance>10</snapshot_distance>
+            <stale_log_gap>10</stale_log_gap>
+            <reserved_log_items>1</reserved_log_items>
+            <rotate_log_storage_interval>3</rotate_log_storage_interval>
+        </coordination_settings>
+
+        <!-- DISK DEFINITION PLACEHOLDER -->
+
+        <raft_configuration>
+            <server>
+                <id>1</id>
+                <hostname>node</hostname>
+                <port>9234</port>
+            </server>
+        </raft_configuration>
+    </keeper_server>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_keeper_disks/test.py b/tests/integration/test_keeper_disks/test.py
new file mode 100644
index 00000000000..e978df18bab
--- /dev/null
+++ b/tests/integration/test_keeper_disks/test.py
@@ -0,0 +1,260 @@
+#!/usr/bin/env python3
+import pytest
+from helpers.cluster import ClickHouseCluster
+import helpers.keeper_utils as keeper_utils
+from minio.deleteobjects import DeleteObject
+
+import os
+
+CURRENT_TEST_DIR = os.path.dirname(os.path.abspath(__file__))
+cluster = ClickHouseCluster(__file__)
+node = cluster.add_instance(
+    "node", main_configs=["configs/enable_keeper.xml"], stay_alive=True, with_minio=True
+)
+
+from kazoo.client import KazooClient, KazooState
+
+
+@pytest.fixture(scope="module")
+def started_cluster():
+    try:
+        cluster.start()
+        yield cluster
+
+    finally:
+        cluster.shutdown()
+
+
+def get_fake_zk(nodename, timeout=30.0):
+    _fake_zk_instance = KazooClient(
+        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
+    )
+    _fake_zk_instance.start()
+    return _fake_zk_instance
+
+
+def stop_zk(zk):
+    try:
+        if zk:
+            zk.stop()
+            zk.close()
+    except:
+        pass
+
+
+def stop_clickhouse(cluster, cleanup_disks):
+    node.stop_clickhouse()
+
+    if not cleanup_disks:
+        return
+
+    node.exec_in_container(["rm", "-rf", "/var/lib/clickhouse/coordination/logs"])
+    node.exec_in_container(
+        ["rm", "-rf", "/var/lib/clickhouse/coordination/snapshots"]
+    )
+
+    s3_objects = list_s3_objects(cluster, prefix="")
+    if len(s3_objects) == 0:
+        return
+
+    assert (
+        len(
+            list(
+                cluster.minio_client.remove_objects(
+                    cluster.minio_bucket,
+                    [DeleteObject(obj) for obj in s3_objects],
+                )
+            )
+        )
+        == 0
+    )
+
+
+def setup_storage(cluster, storage_config, cleanup_disks):
+    stop_clickhouse(cluster, cleanup_disks)
+    node.copy_file_to_container(
+        os.path.join(CURRENT_TEST_DIR, "configs/enable_keeper.xml"),
+        "/etc/clickhouse-server/config.d/enable_keeper.xml",
+    )
+    node.replace_in_config(
+        "/etc/clickhouse-server/config.d/enable_keeper.xml",
+        "<!-- DISK DEFINITION PLACEHOLDER -->",
+        storage_config,
+    )
+    node.start_clickhouse()
+    keeper_utils.wait_until_connected(cluster, node)
+
+
+def setup_local_storage(cluster):
+    setup_storage(
+        cluster,
+        "<log_storage_disk>log_local<\\/log_storage_disk>"
+        "<snapshot_storage_disk>snapshot_local<\\/snapshot_storage_disk>",
+        cleanup_disks=True,
+    )
+
+
+def list_s3_objects(cluster, prefix=""):
+    minio = cluster.minio_client
+    prefix_len = len(prefix)
+    return [
+        obj.object_name[prefix_len:]
+        for obj in minio.list_objects(
+            cluster.minio_bucket, prefix=prefix, recursive=True
+        )
+    ]
+
+
+def get_local_files(path):
+    files = node.exec_in_container(["ls", path]).strip().split("\n")
+    files.sort()
+    return files
+
+
+def get_local_logs():
+    return get_local_files("/var/lib/clickhouse/coordination/logs")
+
+
+def get_local_snapshots():
+    return get_local_files("/var/lib/clickhouse/coordination/snapshots")
+
+
+def test_logs_with_disks(started_cluster):
+    setup_local_storage(started_cluster)
+
+    node_zk = get_fake_zk("node")
+    try:
+        node_zk.create("/test")
+        for _ in range(30):
+            node_zk.create("/test/somenode", b"somedata", sequence=True)
+
+        stop_zk(node_zk)
+
+        previous_log_files = get_local_logs()
+
+        setup_storage(
+            started_cluster,
+            "<log_storage_disk>log_s3_plain<\\/log_storage_disk>"
+            "<latest_log_storage_disk>log_local<\\/latest_log_storage_disk>"
+            "<snapshot_storage_disk>snapshot_local<\\/snapshot_storage_disk>",
+            cleanup_disks=False,
+        )
+
+        # all but the latest log should be on S3
+        s3_log_files = list_s3_objects(started_cluster, "logs/")
+        assert set(s3_log_files) == set(previous_log_files[:-1])
+        local_log_files = get_local_logs()
+        assert len(local_log_files) == 1
+        assert local_log_files[0] == previous_log_files[-1]
+
+        previous_log_files = s3_log_files + local_log_files
+
+        node_zk = get_fake_zk("node")
+
+        for _ in range(30):
+            node_zk.create("/test/somenode", b"somedata", sequence=True)
+
+        stop_zk(node_zk)
+
+        log_files = list_s3_objects(started_cluster, "logs/")
+        local_log_files = get_local_logs()
+        assert len(local_log_files) == 1
+
+        log_files.extend(local_log_files)
+        assert set(log_files) != previous_log_files
+
+        previous_log_files = log_files
+
+        setup_storage(
+            started_cluster,
+            "<old_log_storage_disk>log_s3_plain<\\/old_log_storage_disk>"
+            "<log_storage_disk>log_local<\\/log_storage_disk>"
+            "<snapshot_storage_disk>snapshot_local<\\/snapshot_storage_disk>",
+            cleanup_disks=False,
+        )
+
+        local_log_files = get_local_logs()
+        assert set(local_log_files) == set(previous_log_files)
+
+        node_zk = get_fake_zk("node")
+
+        for child in node_zk.get_children("/test"):
+            assert node_zk.get(f"/test/{child}")[0] == b"somedata"
+
+    finally:
+        stop_zk(node_zk)
+
+
+def test_snapshots_with_disks(started_cluster):
+    setup_local_storage(started_cluster)
+
+    node_zk = get_fake_zk("node")
+    try:
+        node_zk.create("/test2")
+        for _ in range(30):
+            node_zk.create("/test2/somenode", b"somedata", sequence=True)
+
+        stop_zk(node_zk)
+
+        snapshot_idx = keeper_utils.send_4lw_cmd(cluster, node, "csnp")
+        node.wait_for_log_line(
+            f"Created persistent snapshot {snapshot_idx}", look_behind_lines=1000
+        )
+
+        previous_snapshot_files = get_local_snapshots()
+
+        setup_storage(
+            started_cluster,
+            "<snapshot_storage_disk>snapshot_s3_plain<\\/snapshot_storage_disk>"
+            "<latest_snapshot_storage_disk>snapshot_local<\\/latest_snapshot_storage_disk>"
+            "<log_storage_disk>log_local<\\/log_storage_disk>",
+            cleanup_disks=False,
+        )
+
+        ## all but the latest log should be on S3
+        s3_snapshot_files = list_s3_objects(started_cluster, "snapshots/")
+        assert set(s3_snapshot_files) == set(previous_snapshot_files[:-1])
+        local_snapshot_files = get_local_snapshots()
+        assert len(local_snapshot_files) == 1
+        assert local_snapshot_files[0] == previous_snapshot_files[-1]
+
+        previous_snapshot_files = s3_snapshot_files + local_snapshot_files
+
+        node_zk = get_fake_zk("node")
+
+        for _ in range(30):
+            node_zk.create("/test2/somenode", b"somedata", sequence=True)
+
+        stop_zk(node_zk)
+
+        snapshot_idx = keeper_utils.send_4lw_cmd(cluster, node, "csnp")
+        node.wait_for_log_line(
+            f"Created persistent snapshot {snapshot_idx}", look_behind_lines=1000
+        )
+
+        snapshot_files = list_s3_objects(started_cluster, "snapshots/")
+        local_snapshot_files = get_local_snapshots()
+        assert len(local_snapshot_files) == 1
+
+        snapshot_files.extend(local_snapshot_files)
+
+        previous_snapshot_files = snapshot_files
+
+        setup_storage(
+            started_cluster,
+            "<old_snapshot_storage_disk>snapshot_s3_plain<\\/old_snapshot_storage_disk>"
+            "<snapshot_storage_disk>snapshot_local<\\/snapshot_storage_disk>"
+            "<log_storage_disk>log_local<\\/log_storage_disk>",
+            cleanup_disks=False,
+        )
+
+        local_snapshot_files = get_local_snapshots()
+        assert set(local_snapshot_files) == set(previous_snapshot_files)
+
+        node_zk = get_fake_zk("node")
+
+        for child in node_zk.get_children("/test2"):
+            assert node_zk.get(f"/test2/{child}")[0] == b"somedata"
+
+    finally:
+        stop_zk(node_zk)

From a9eb2c3c4eb8354753e611c6eed71fa9b672077c Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 1 Jun 2023 12:31:06 +0000
Subject: [PATCH 0213/1478] use multiple disks for jepsne

---
 .../resources/keeper_config.xml               | 22 +++++++++++++++++++
 .../src/jepsen/clickhouse/constants.clj       |  2 ++
 .../src/jepsen/clickhouse/keeper/utils.clj    |  6 +++--
 3 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/tests/jepsen.clickhouse/resources/keeper_config.xml b/tests/jepsen.clickhouse/resources/keeper_config.xml
index 2ab747fbd71..52f2a0dbdc2 100644
--- a/tests/jepsen.clickhouse/resources/keeper_config.xml
+++ b/tests/jepsen.clickhouse/resources/keeper_config.xml
@@ -8,6 +8,28 @@
         <size>never</size>
     </logger>
 
+
+    <storage_configuration>
+        <disks>
+            <log_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/logs/</path>
+            </log_local>
+            <latest_log_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/latest_log/</path>
+            </latest_log_local>
+            <snapshot_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/snapshots/</path>
+            </snapshot_local>
+            <latest_snapshot_local>
+                <type>local</type>
+                <path>/var/lib/clickhouse/coordination/latest_snapshot/</path>
+            </latest_snapshot_local>
+        </disks>
+    </storage_configuration>
+
     <keeper_server>
         <tcp_port>9181</tcp_port>
         <server_id>{id}</server_id>
diff --git a/tests/jepsen.clickhouse/src/jepsen/clickhouse/constants.clj b/tests/jepsen.clickhouse/src/jepsen/clickhouse/constants.clj
index 887fc04265c..2a9a7ef6d27 100644
--- a/tests/jepsen.clickhouse/src/jepsen/clickhouse/constants.clj
+++ b/tests/jepsen.clickhouse/src/jepsen/clickhouse/constants.clj
@@ -14,7 +14,9 @@
 
 (def coordination-data-dir (str data-dir "/coordination"))
 (def coordination-snapshots-dir (str coordination-data-dir "/snapshots"))
+(def coordination-latest-snapshot-dir (str coordination-data-dir "/latest_snapshot"))
 (def coordination-logs-dir (str coordination-data-dir "/logs"))
+(def coordination-latest_log-dir (str coordination-data-dir "/latest_log"))
 
 (def stderr-file (str logs-dir "/stderr.log"))
 
diff --git a/tests/jepsen.clickhouse/src/jepsen/clickhouse/keeper/utils.clj b/tests/jepsen.clickhouse/src/jepsen/clickhouse/keeper/utils.clj
index b882af77758..869313079d0 100644
--- a/tests/jepsen.clickhouse/src/jepsen/clickhouse/keeper/utils.clj
+++ b/tests/jepsen.clickhouse/src/jepsen/clickhouse/keeper/utils.clj
@@ -146,6 +146,8 @@
     :--
     :--logger.log (str logs-dir "/clickhouse-keeper.log")
     :--logger.errorlog (str logs-dir "/clickhouse-keeper.err.log")
-    :--keeper_server.snapshot_storage_path coordination-snapshots-dir
-    :--keeper_server.log_storage_path coordination-logs-dir
+    :--keeper_server.snapshot_storage_disk "snapshot_local"
+    :--keeper_server.latest_snapshot_storage_disk "latest_snapshot_local"
+    :--keeper_server.log_storage_disk "log_local"
+    :--keeper_server.latest_log_storage_disk "latest_log_local"
     :--path coordination-data-dir))

From e8442b7a88467aa68a87c0abfa3983131c7b8c75 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 1 Jun 2023 12:54:00 +0000
Subject: [PATCH 0214/1478] Add finalize calls

---
 src/Coordination/Changelog.cpp             | 9 ++++++++-
 src/Coordination/KeeperSnapshotManager.cpp | 6 ++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index bcce9982e04..97f2b437377 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -43,7 +43,8 @@ void moveFileBetweenDisks(DiskPtr disk_from, ChangelogFileDescriptionPtr descrip
     auto from_path = fs::path(description->path);
     auto tmp_changelog_name = from_path.parent_path() / (std::string{tmp_prefix} + from_path.filename().string());
     {
-        disk_to->writeFile(tmp_changelog_name);
+        auto buf = disk_to->writeFile(tmp_changelog_name);
+        buf->finalize();
     }
     disk_from->copyFile(from_path, *disk_to, path_to, {});
     disk_to->removeFile(tmp_changelog_name);
@@ -342,9 +343,15 @@ private:
         }
 
         if (log_file_settings.compress_logs)
+        {
             compressed_buffer.reset();
+        }
         else
+        {
+            chassert(file_buf);
+            file_buf->finalize();
             file_buf.reset();
+        }
     }
 
     WriteBuffer & getBuffer()
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 4b9a34c07e9..8dd6d27c379 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -43,7 +43,8 @@ namespace
         auto from_path = fs::path(path_from);
         auto tmp_snapshot_name = from_path.parent_path() / (std::string{tmp_prefix} + from_path.filename().string());
         {
-            disk_to->writeFile(tmp_snapshot_name);
+            auto buf = disk_to->writeFile(tmp_snapshot_name);
+            buf->finalize();
         }
         disk_from->copyFile(from_path, *disk_to, path_to, {});
         disk_to->removeFile(tmp_snapshot_name);
@@ -784,7 +785,8 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotToDisk(const KeeperStor
 
     auto disk = getLatestSnapshotDisk();
     {
-        disk->writeFile(tmp_snapshot_file_name);
+        auto buf = disk->writeFile(tmp_snapshot_file_name);
+        buf->finalize();
     }
 
     auto writer = disk->writeFile(snapshot_file_name);

From 92ee24acd33dc6f62c369dcbd10c90f126b72613 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 1 Jun 2023 13:10:50 +0000
Subject: [PATCH 0215/1478] Automatic style fix

---
 tests/integration/test_keeper_disks/test.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tests/integration/test_keeper_disks/test.py b/tests/integration/test_keeper_disks/test.py
index e978df18bab..11bb215be54 100644
--- a/tests/integration/test_keeper_disks/test.py
+++ b/tests/integration/test_keeper_disks/test.py
@@ -49,9 +49,7 @@ def stop_clickhouse(cluster, cleanup_disks):
         return
 
     node.exec_in_container(["rm", "-rf", "/var/lib/clickhouse/coordination/logs"])
-    node.exec_in_container(
-        ["rm", "-rf", "/var/lib/clickhouse/coordination/snapshots"]
-    )
+    node.exec_in_container(["rm", "-rf", "/var/lib/clickhouse/coordination/snapshots"])
 
     s3_objects = list_s3_objects(cluster, prefix="")
     if len(s3_objects) == 0:

From d57ffec72fb3a52b6d642270f3fc3907bcabbe0b Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Thu, 1 Jun 2023 13:45:00 +0000
Subject: [PATCH 0216/1478] Add signal handler for SIGQUIT

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

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 77a93a25e9b..29b2eb5ce1e 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -286,7 +286,7 @@ public:
     static Int32 cancelled_status() { return exit_after_signals.load(); }
 };
 
-/// This signal handler is set only for SIGINT.
+/// This signal handler is set for SIGINT and SIGQUIT.
 void interruptSignalHandler(int signum)
 {
     if (QueryInterruptHandler::try_stop())
@@ -325,6 +325,9 @@ void ClientBase::setupSignalHandler()
 
     if (sigaction(SIGINT, &new_act, nullptr))
         throwFromErrno("Cannot set signal handler.", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
+
+    if (sigaction(SIGQUIT, &new_act, nullptr))
+        throwFromErrno("Cannot set signal handler.", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
 }
 
 

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 0217/1478] 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 a4cb82127dfe488fb1e1ad90aebaccf469ad742e Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 22 May 2023 13:54:33 +0200
Subject: [PATCH 0218/1478] Analyzer: WIP on distributed queries

---
 src/Analyzer/ColumnNode.cpp         |  5 ++++-
 src/Analyzer/TableNode.cpp          |  2 ++
 src/Planner/PlannerContext.cpp      | 14 +++++++-------
 src/Planner/PlannerJoinTree.cpp     |  3 ++-
 src/Planner/Utils.cpp               |  2 +-
 src/Storages/StorageDistributed.cpp |  6 ++++--
 6 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/src/Analyzer/ColumnNode.cpp b/src/Analyzer/ColumnNode.cpp
index a9d47f8287d..f020040ea78 100644
--- a/src/Analyzer/ColumnNode.cpp
+++ b/src/Analyzer/ColumnNode.cpp
@@ -117,7 +117,10 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
                 else
                 {
                     const auto & table_storage_id = table_node->getStorageID();
-                    column_identifier_parts = { table_storage_id.getDatabaseName(), table_storage_id.getTableName() };
+                    if (table_storage_id.hasDatabase())
+                        column_identifier_parts = { table_storage_id.getDatabaseName(), table_storage_id.getTableName() };
+                    else
+                        column_identifier_parts = { table_storage_id.getTableName() };
                 }
             }
         }
diff --git a/src/Analyzer/TableNode.cpp b/src/Analyzer/TableNode.cpp
index c86cbcd5a80..17d12bd6afa 100644
--- a/src/Analyzer/TableNode.cpp
+++ b/src/Analyzer/TableNode.cpp
@@ -91,6 +91,8 @@ ASTPtr TableNode::toASTImpl(const ConvertToASTOptions & /* options */) const
     if (!temporary_table_name.empty())
         return std::make_shared<ASTTableIdentifier>(temporary_table_name);
 
+    if (!storage_id.hasDatabase())
+        return std::make_shared<ASTTableIdentifier>(storage_id.getTableName());
     return std::make_shared<ASTTableIdentifier>(storage_id.getDatabaseName(), storage_id.getTableName());
 }
 
diff --git a/src/Planner/PlannerContext.cpp b/src/Planner/PlannerContext.cpp
index 346cc6d2080..7ab8180eb9c 100644
--- a/src/Planner/PlannerContext.cpp
+++ b/src/Planner/PlannerContext.cpp
@@ -19,17 +19,17 @@ const ColumnIdentifier & GlobalPlannerContext::createColumnIdentifier(const Quer
     return createColumnIdentifier(column_node_typed.getColumn(), column_source_node);
 }
 
-const ColumnIdentifier & GlobalPlannerContext::createColumnIdentifier(const NameAndTypePair & column, const QueryTreeNodePtr & column_source_node)
+const ColumnIdentifier & GlobalPlannerContext::createColumnIdentifier(const NameAndTypePair & column, const QueryTreeNodePtr & /*column_source_node*/)
 {
     std::string column_identifier;
 
-    if (column_source_node->hasAlias())
-        column_identifier += column_source_node->getAlias();
-    else if (const auto * table_source_node = column_source_node->as<TableNode>())
-        column_identifier += table_source_node->getStorageID().getFullNameNotQuoted();
+    // if (column_source_node->hasAlias())
+    //     column_identifier += column_source_node->getAlias();
+    // else if (const auto * table_source_node = column_source_node->as<TableNode>())
+    //     column_identifier += table_source_node->getStorageID().getFullNameNotQuoted();
 
-    if (!column_identifier.empty())
-        column_identifier += '.';
+    // if (!column_identifier.empty())
+    //     column_identifier += '.';
 
     column_identifier += column.name;
     column_identifier += '_' + std::to_string(column_identifiers.size());
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index 4f091f73187..4a1708f96d3 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -106,7 +106,8 @@ void checkAccessRights(const TableNode & table_node, const Names & column_names,
             storage_id.getFullTableName());
     }
 
-    query_context->checkAccess(AccessType::SELECT, storage_id, column_names);
+    if (storage_id.hasDatabase())
+        query_context->checkAccess(AccessType::SELECT, storage_id, column_names);
 }
 
 NameAndTypePair chooseSmallestColumnToReadFromStorage(const StoragePtr & storage, const StorageSnapshotPtr & storage_snapshot)
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index 5c61b2fc2c7..cd4fb9182e9 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -107,7 +107,7 @@ Block buildCommonHeaderForUnion(const Blocks & queries_headers, SelectUnionMode
 ASTPtr queryNodeToSelectQuery(const QueryTreeNodePtr & query_node)
 {
     auto & query_node_typed = query_node->as<QueryNode &>();
-    auto result_ast = query_node_typed.toAST();
+    auto result_ast = query_node_typed.toAST({ .fully_qualified_identifiers = false });
 
     while (true)
     {
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index bcf6f68d00d..e0bb14c62fd 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -943,7 +943,9 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
     }
     else
     {
-        auto resolved_remote_storage_id = query_context->resolveStorageID(remote_storage_id);
+        auto resolved_remote_storage_id = remote_storage_id;
+        if (remote_storage_id.hasDatabase())
+            resolved_remote_storage_id = query_context->resolveStorageID(remote_storage_id);
         auto storage = std::make_shared<StorageDummy>(resolved_remote_storage_id, distributed_storage_snapshot->metadata->getColumns());
         auto table_node = std::make_shared<TableNode>(std::move(storage), query_context);
 
@@ -1059,7 +1061,7 @@ void StorageDistributed::read(
             remote_table_function_ptr);
 
         query_ast = queryNodeToSelectQuery(query_tree_distributed);
-        header = InterpreterSelectQueryAnalyzer::getSampleBlock(query_ast, local_context, SelectQueryOptions(processed_stage).analyze());
+        header = InterpreterSelectQueryAnalyzer::getSampleBlock(query_tree_distributed, local_context, SelectQueryOptions(processed_stage).analyze());
     }
     else
     {

From 70c1b1de57252ace05fe69b3a791b3fe4f025273 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 22 May 2023 15:43:30 +0000
Subject: [PATCH 0219/1478] Remove code

---
 src/Planner/PlannerContext.cpp                |   8 --
 ...ns_optimize_read_in_window_order.reference |  10 +-
 .../02227_union_match_by_name.reference       |   4 +-
 .../0_stateless/02303_query_kind.reference    |  16 +--
 .../02381_join_dup_columns_in_plan.reference  |  44 +++---
 .../0_stateless/02421_explain_subquery.sql    |   2 +-
 .../02451_order_by_monotonic.reference        |  32 ++---
 .../02481_aggregation_in_order_plan.reference |   2 +-
 .../02514_analyzer_drop_join_on.reference     | 134 +++++++++---------
 ...dicate_push_down_filled_join_fix.reference |  30 ++--
 ...n_merge_tree_prewhere_row_policy.reference |   8 +-
 11 files changed, 141 insertions(+), 149 deletions(-)

diff --git a/src/Planner/PlannerContext.cpp b/src/Planner/PlannerContext.cpp
index 7ab8180eb9c..a788a6cbc3c 100644
--- a/src/Planner/PlannerContext.cpp
+++ b/src/Planner/PlannerContext.cpp
@@ -23,14 +23,6 @@ const ColumnIdentifier & GlobalPlannerContext::createColumnIdentifier(const Name
 {
     std::string column_identifier;
 
-    // if (column_source_node->hasAlias())
-    //     column_identifier += column_source_node->getAlias();
-    // else if (const auto * table_source_node = column_source_node->as<TableNode>())
-    //     column_identifier += table_source_node->getStorageID().getFullNameNotQuoted();
-
-    // if (!column_identifier.empty())
-    //     column_identifier += '.';
-
     column_identifier += column.name;
     column_identifier += '_' + std::to_string(column_identifiers.size());
 
diff --git a/tests/queries/0_stateless/01655_plan_optimizations_optimize_read_in_window_order.reference b/tests/queries/0_stateless/01655_plan_optimizations_optimize_read_in_window_order.reference
index f23cf03913b..8a33df9fad2 100644
--- a/tests/queries/0_stateless/01655_plan_optimizations_optimize_read_in_window_order.reference
+++ b/tests/queries/0_stateless/01655_plan_optimizations_optimize_read_in_window_order.reference
@@ -7,19 +7,19 @@ Partial sorting plan
     Prefix sort description: n ASC
     Result sort description: n ASC, x ASC
   optimize_read_in_window_order=1, allow_experimental_analyzer=1
-    Prefix sort description: default.test_01655_plan_optimizations_optimize_read_in_window_order_n.n_0 ASC
-    Result sort description: default.test_01655_plan_optimizations_optimize_read_in_window_order_n.n_0 ASC, default.test_01655_plan_optimizations_optimize_read_in_window_order_n.x_1 ASC
+    Prefix sort description: n_0 ASC
+    Result sort description: n_0 ASC, x_1 ASC
 No sorting plan
   optimize_read_in_window_order=0
     Sort description: n ASC, x ASC
   optimize_read_in_window_order=0, allow_experimental_analyzer=1
-    Sort description: default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.n_0 ASC, default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.x_1 ASC
+    Sort description: n_0 ASC, x_1 ASC
   optimize_read_in_window_order=1
     Prefix sort description: n ASC, x ASC
     Result sort description: n ASC, x ASC
   optimize_read_in_window_order=1, allow_experimental_analyzer=1
-    Prefix sort description: default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.n_0 ASC, default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.x_1 ASC
-    Result sort description: default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.n_0 ASC, default.test_01655_plan_optimizations_optimize_read_in_window_order_n_x.x_1 ASC
+    Prefix sort description: n_0 ASC, x_1 ASC
+    Result sort description: n_0 ASC, x_1 ASC
 Complex ORDER BY
   optimize_read_in_window_order=0
 3	3	1
diff --git a/tests/queries/0_stateless/02227_union_match_by_name.reference b/tests/queries/0_stateless/02227_union_match_by_name.reference
index e51ea983f7f..685b3c83b05 100644
--- a/tests/queries/0_stateless/02227_union_match_by_name.reference
+++ b/tests/queries/0_stateless/02227_union_match_by_name.reference
@@ -30,7 +30,7 @@ Header: avgWeighted(x, y) Nullable(Float64)
                         255_UInt8 UInt8
                         1_UInt8 UInt8
                   Expression (Change column names to column identifiers)
-                  Header: system.one.dummy_0 UInt8
+                  Header: dummy_0 UInt8
                     ReadFromStorage (SystemOne)
                     Header: dummy UInt8
             Expression (Conversion before UNION)
@@ -46,7 +46,7 @@ Header: avgWeighted(x, y) Nullable(Float64)
                         NULL_Nullable(Nothing) Nullable(Nothing)
                         1_UInt8 UInt8
                   Expression (Change column names to column identifiers)
-                  Header: system.one.dummy_0 UInt8
+                  Header: dummy_0 UInt8
                     ReadFromStorage (SystemOne)
                     Header: dummy UInt8
 SELECT avgWeighted(x, y) FROM (SELECT NULL, 255 AS x, 1 AS y UNION ALL SELECT y, NULL AS x, 1 AS y);
diff --git a/tests/queries/0_stateless/02303_query_kind.reference b/tests/queries/0_stateless/02303_query_kind.reference
index 5af8c2b743f..8d119fb22b2 100644
--- a/tests/queries/0_stateless/02303_query_kind.reference
+++ b/tests/queries/0_stateless/02303_query_kind.reference
@@ -2,35 +2,35 @@ clickhouse-client --allow_experimental_analyzer=1 --query_kind secondary_query -
 Expression ((Project names + Projection))
 Header: dummy String
   Aggregating
-  Header: toString(system.one.dummy_0) String
+  Header: toString(dummy_0) String
     Expression ((Before GROUP BY + Change column names to column identifiers))
-    Header: toString(system.one.dummy_0) String
+    Header: toString(dummy_0) String
       ReadFromStorage (SystemOne)
       Header: dummy UInt8
 clickhouse-local --allow_experimental_analyzer=1 --query_kind secondary_query -q explain plan header=1 select toString(dummy) as dummy from system.one group by dummy
 Expression ((Project names + Projection))
 Header: dummy String
   Aggregating
-  Header: toString(system.one.dummy_0) String
+  Header: toString(dummy_0) String
     Expression ((Before GROUP BY + Change column names to column identifiers))
-    Header: toString(system.one.dummy_0) String
+    Header: toString(dummy_0) String
       ReadFromStorage (SystemOne)
       Header: dummy UInt8
 clickhouse-client --allow_experimental_analyzer=1 --query_kind initial_query -q explain plan header=1 select toString(dummy) as dummy from system.one group by dummy
 Expression ((Project names + Projection))
 Header: dummy String
   Aggregating
-  Header: toString(system.one.dummy_0) String
+  Header: toString(dummy_0) String
     Expression ((Before GROUP BY + Change column names to column identifiers))
-    Header: toString(system.one.dummy_0) String
+    Header: toString(dummy_0) String
       ReadFromStorage (SystemOne)
       Header: dummy UInt8
 clickhouse-local --allow_experimental_analyzer=1 --query_kind initial_query -q explain plan header=1 select toString(dummy) as dummy from system.one group by dummy
 Expression ((Project names + Projection))
 Header: dummy String
   Aggregating
-  Header: toString(system.one.dummy_0) String
+  Header: toString(dummy_0) String
     Expression ((Before GROUP BY + Change column names to column identifiers))
-    Header: toString(system.one.dummy_0) String
+    Header: toString(dummy_0) String
       ReadFromStorage (SystemOne)
       Header: dummy UInt8
diff --git a/tests/queries/0_stateless/02381_join_dup_columns_in_plan.reference b/tests/queries/0_stateless/02381_join_dup_columns_in_plan.reference
index 31a37862663..dd5c9d4616e 100644
--- a/tests/queries/0_stateless/02381_join_dup_columns_in_plan.reference
+++ b/tests/queries/0_stateless/02381_join_dup_columns_in_plan.reference
@@ -2,51 +2,51 @@ Expression
 Header: key String
         value String
   Join
-  Header: s1.key_0 String
-          s2.value_1 String
+  Header: key_0 String
+          value_1 String
     Expression
-    Header: s1.key_0 String
+    Header: key_0 String
       ReadFromStorage
       Header: dummy UInt8
     Union
-    Header: s2.key_2 String
-            s2.value_1 String
+    Header: key_2 String
+            value_1 String
       Expression
-      Header: s2.key_2 String
-              s2.value_1 String
+      Header: key_2 String
+              value_1 String
         ReadFromStorage
         Header: dummy UInt8
       Expression
-      Header: s2.key_2 String
-              s2.value_1 String
+      Header: key_2 String
+              value_1 String
         ReadFromStorage
         Header: dummy UInt8
 Expression
 Header: key String
         value String
   Join
-  Header: s1.key_0 String
-          s2.key_2 String
-          s2.value_1 String
+  Header: key_0 String
+          key_2 String
+          value_1 String
     Sorting
-    Header: s1.key_0 String
+    Header: key_0 String
       Expression
-      Header: s1.key_0 String
+      Header: key_0 String
         ReadFromStorage
         Header: dummy UInt8
     Sorting
-    Header: s2.key_2 String
-            s2.value_1 String
+    Header: key_2 String
+            value_1 String
       Union
-      Header: s2.key_2 String
-              s2.value_1 String
+      Header: key_2 String
+              value_1 String
         Expression
-        Header: s2.key_2 String
-                s2.value_1 String
+        Header: key_2 String
+                value_1 String
           ReadFromStorage
           Header: dummy UInt8
         Expression
-        Header: s2.key_2 String
-                s2.value_1 String
+        Header: key_2 String
+                value_1 String
           ReadFromStorage
           Header: dummy UInt8
diff --git a/tests/queries/0_stateless/02421_explain_subquery.sql b/tests/queries/0_stateless/02421_explain_subquery.sql
index 32631b54d0c..4b970f81219 100644
--- a/tests/queries/0_stateless/02421_explain_subquery.sql
+++ b/tests/queries/0_stateless/02421_explain_subquery.sql
@@ -34,7 +34,7 @@ DROP TABLE t1;
 
 SET allow_experimental_analyzer = 1;
 
-SELECT count() > 3 FROM (EXPLAIN PIPELINE header = 1 SELECT * FROM system.numbers ORDER BY number DESC) WHERE explain LIKE '%Header: system.numbers.number__ UInt64%';
+SELECT count() > 3 FROM (EXPLAIN PIPELINE header = 1 SELECT * FROM system.numbers ORDER BY number DESC) WHERE explain LIKE '%Header: number__ UInt64%';
 SELECT count() > 0 FROM (EXPLAIN PLAN SELECT * FROM system.numbers ORDER BY number DESC) WHERE explain ILIKE '%Sort%';
 SELECT count() > 0 FROM (EXPLAIN SELECT * FROM system.numbers ORDER BY number DESC) WHERE explain ILIKE '%Sort%';
 SELECT count() > 0 FROM (EXPLAIN CURRENT TRANSACTION);
diff --git a/tests/queries/0_stateless/02451_order_by_monotonic.reference b/tests/queries/0_stateless/02451_order_by_monotonic.reference
index f9f0ef38be1..05f20a9bad8 100644
--- a/tests/queries/0_stateless/02451_order_by_monotonic.reference
+++ b/tests/queries/0_stateless/02451_order_by_monotonic.reference
@@ -4,19 +4,19 @@
 2022-09-09 12:00:00	0x
 2022-09-09 12:00:00	1
 2022-09-09 12:00:00	1x
-  Prefix sort description: toStartOfMinute(test.t_0) ASC
-  Result sort description: toStartOfMinute(test.t_0) ASC, test.c1_1 ASC
-  Prefix sort description: toStartOfMinute(test.t_0) ASC
-  Result sort description: toStartOfMinute(test.t_0) ASC
-  Prefix sort description: negate(test.a_0) ASC
-  Result sort description: negate(test.a_0) ASC
-  Prefix sort description: negate(test.a_0) ASC, negate(test.b_1) ASC
-  Result sort description: negate(test.a_0) ASC, negate(test.b_1) ASC
-  Prefix sort description: test.a_0 DESC, negate(test.b_1) ASC
-  Result sort description: test.a_0 DESC, negate(test.b_1) ASC
-  Prefix sort description: negate(test.a_0) ASC, test.b_1 DESC
-  Result sort description: negate(test.a_0) ASC, test.b_1 DESC
-  Prefix sort description: negate(test.a_0) ASC
-  Result sort description: negate(test.a_0) ASC, test.b_1 ASC
-  Prefix sort description: test.a_0 ASC
-  Result sort description: test.a_0 ASC, negate(test.b_1) ASC
+  Prefix sort description: toStartOfMinute(t_0) ASC
+  Result sort description: toStartOfMinute(t_0) ASC, c1_1 ASC
+  Prefix sort description: toStartOfMinute(t_0) ASC
+  Result sort description: toStartOfMinute(t_0) ASC
+  Prefix sort description: negate(a_0) ASC
+  Result sort description: negate(a_0) ASC
+  Prefix sort description: negate(a_0) ASC, negate(b_1) ASC
+  Result sort description: negate(a_0) ASC, negate(b_1) ASC
+  Prefix sort description: a_0 DESC, negate(b_1) ASC
+  Result sort description: a_0 DESC, negate(b_1) ASC
+  Prefix sort description: negate(a_0) ASC, b_1 DESC
+  Result sort description: negate(a_0) ASC, b_1 DESC
+  Prefix sort description: negate(a_0) ASC
+  Result sort description: negate(a_0) ASC, b_1 ASC
+  Prefix sort description: a_0 ASC
+  Result sort description: a_0 ASC, negate(b_1) ASC
diff --git a/tests/queries/0_stateless/02481_aggregation_in_order_plan.reference b/tests/queries/0_stateless/02481_aggregation_in_order_plan.reference
index bb4eb4ddd75..b11f3e3a1d3 100644
--- a/tests/queries/0_stateless/02481_aggregation_in_order_plan.reference
+++ b/tests/queries/0_stateless/02481_aggregation_in_order_plan.reference
@@ -6,5 +6,5 @@
   Order: a ASC, c ASC
       ReadFromMergeTree (default.tab)
   Aggregating
-  Order: default.tab.a_0 ASC, default.tab.c_2 ASC
+  Order: a_0 ASC, c_2 ASC
         ReadFromMergeTree (default.tab)
diff --git a/tests/queries/0_stateless/02514_analyzer_drop_join_on.reference b/tests/queries/0_stateless/02514_analyzer_drop_join_on.reference
index 8b4cafc3260..0037ab85c07 100644
--- a/tests/queries/0_stateless/02514_analyzer_drop_join_on.reference
+++ b/tests/queries/0_stateless/02514_analyzer_drop_join_on.reference
@@ -6,43 +6,43 @@ SELECT count() FROM a JOIN b ON b.b1 = a.a1 JOIN c ON c.c1 = b.b1 JOIN d ON d.d1
 Expression ((Project names + Projection))
 Header: count() UInt64
   Aggregating
-  Header: default.a.a2_4 String
+  Header: a2_4 String
           count() UInt64
     Expression ((Before GROUP BY + DROP unused columns after JOIN))
-    Header: default.a.a2_4 String
+    Header: a2_4 String
       Join (JOIN FillRightFirst)
-      Header: default.a.a2_4 String
-              default.c.c1_2 UInt64
+      Header: a2_4 String
+              c1_2 UInt64
         Expression ((JOIN actions + DROP unused columns after JOIN))
-        Header: default.a.a2_4 String
-                default.c.c1_2 UInt64
+        Header: a2_4 String
+                c1_2 UInt64
           Join (JOIN FillRightFirst)
-          Header: default.a.a2_4 String
-                  default.b.b1_0 UInt64
-                  default.c.c1_2 UInt64
+          Header: a2_4 String
+                  b1_0 UInt64
+                  c1_2 UInt64
             Expression ((JOIN actions + DROP unused columns after JOIN))
-            Header: default.a.a2_4 String
-                    default.b.b1_0 UInt64
+            Header: a2_4 String
+                    b1_0 UInt64
               Join (JOIN FillRightFirst)
-              Header: default.a.a1_1 UInt64
-                      default.a.a2_4 String
-                      default.b.b1_0 UInt64
+              Header: a1_1 UInt64
+                      a2_4 String
+                      b1_0 UInt64
                 Expression ((JOIN actions + Change column names to column identifiers))
-                Header: default.a.a1_1 UInt64
-                        default.a.a2_4 String
+                Header: a1_1 UInt64
+                        a2_4 String
                   ReadFromMemoryStorage
                   Header: a1 UInt64
                           a2 String
                 Expression ((JOIN actions + Change column names to column identifiers))
-                Header: default.b.b1_0 UInt64
+                Header: b1_0 UInt64
                   ReadFromMemoryStorage
                   Header: b1 UInt64
             Expression ((JOIN actions + Change column names to column identifiers))
-            Header: default.c.c1_2 UInt64
+            Header: c1_2 UInt64
               ReadFromMemoryStorage
               Header: c1 UInt64
         Expression ((JOIN actions + Change column names to column identifiers))
-        Header: default.d.d1_3 UInt64
+        Header: d1_3 UInt64
           ReadFromMemoryStorage
           Header: d1 UInt64
 EXPLAIN PLAN header = 1
@@ -52,38 +52,38 @@ Expression ((Project names + (Projection + DROP unused columns after JOIN)))
 Header: a2 String
         d2 String
   Join (JOIN FillRightFirst)
-  Header: default.a.a2_0 String
-          default.a.k_2 UInt64
-          default.d.d2_1 String
+  Header: a2_0 String
+          k_2 UInt64
+          d2_1 String
     Expression (DROP unused columns after JOIN)
-    Header: default.a.a2_0 String
-            default.a.k_2 UInt64
+    Header: a2_0 String
+            k_2 UInt64
       Join (JOIN FillRightFirst)
-      Header: default.a.a2_0 String
-              default.a.k_2 UInt64
+      Header: a2_0 String
+              k_2 UInt64
         Expression (DROP unused columns after JOIN)
-        Header: default.a.a2_0 String
-                default.a.k_2 UInt64
+        Header: a2_0 String
+                k_2 UInt64
           Join (JOIN FillRightFirst)
-          Header: default.a.a2_0 String
-                  default.a.k_2 UInt64
+          Header: a2_0 String
+                  k_2 UInt64
             Expression (Change column names to column identifiers)
-            Header: default.a.a2_0 String
-                    default.a.k_2 UInt64
+            Header: a2_0 String
+                    k_2 UInt64
               ReadFromMemoryStorage
               Header: a2 String
                       k UInt64
             Expression (Change column names to column identifiers)
-            Header: default.b.k_3 UInt64
+            Header: k_3 UInt64
               ReadFromMemoryStorage
               Header: k UInt64
         Expression (Change column names to column identifiers)
-        Header: default.c.k_4 UInt64
+        Header: k_4 UInt64
           ReadFromMemoryStorage
           Header: k UInt64
     Expression (Change column names to column identifiers)
-    Header: default.d.d2_1 String
-            default.d.k_5 UInt64
+    Header: d2_1 String
+            k_5 UInt64
       ReadFromMemoryStorage
       Header: d2 String
               k UInt64
@@ -97,55 +97,55 @@ WHERE c.c2 != '' ORDER BY a.a2
 Expression (Project names)
 Header: bx String
   Sorting (Sorting for ORDER BY)
-  Header: default.a.a2_6 String
-          b.bx_0 String
+  Header: a2_6 String
+          bx_0 String
     Expression ((Before ORDER BY + (Projection + )))
-    Header: default.a.a2_6 String
-            b.bx_0 String
+    Header: a2_6 String
+            bx_0 String
       Join (JOIN FillRightFirst)
-      Header: default.a.a2_6 String
-              b.bx_0 String
-              default.c.c2_5 String
-              default.c.c1_3 UInt64
+      Header: a2_6 String
+              bx_0 String
+              c2_5 String
+              c1_3 UInt64
         Filter (( + (JOIN actions + DROP unused columns after JOIN)))
-        Header: default.a.a2_6 String
-                b.bx_0 String
-                default.c.c2_5 String
-                default.c.c1_3 UInt64
+        Header: a2_6 String
+                bx_0 String
+                c2_5 String
+                c1_3 UInt64
           Join (JOIN FillRightFirst)
-          Header: default.a.a2_6 String
-                  b.bx_0 String
-                  b.b1_1 UInt64
-                  default.c.c2_5 String
-                  default.c.c1_3 UInt64
+          Header: a2_6 String
+                  bx_0 String
+                  b1_1 UInt64
+                  c2_5 String
+                  c1_3 UInt64
             Expression ((JOIN actions + DROP unused columns after JOIN))
-            Header: default.a.a2_6 String
-                    b.bx_0 String
-                    b.b1_1 UInt64
+            Header: a2_6 String
+                    bx_0 String
+                    b1_1 UInt64
               Join (JOIN FillRightFirst)
-              Header: default.a.a1_2 UInt64
-                      default.a.a2_6 String
-                      b.bx_0 String
-                      b.b1_1 UInt64
+              Header: a1_2 UInt64
+                      a2_6 String
+                      bx_0 String
+                      b1_1 UInt64
                 Expression ((JOIN actions + Change column names to column identifiers))
-                Header: default.a.a1_2 UInt64
-                        default.a.a2_6 String
+                Header: a1_2 UInt64
+                        a2_6 String
                   ReadFromMemoryStorage
                   Header: a1 UInt64
                           a2 String
                 Expression ((JOIN actions + (Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers)))))
-                Header: b.b1_1 UInt64
-                        b.bx_0 String
+                Header: b1_1 UInt64
+                        bx_0 String
                   ReadFromMemoryStorage
                   Header: b1 UInt64
                           b2 String
             Expression ((JOIN actions + Change column names to column identifiers))
-            Header: default.c.c1_3 UInt64
-                    default.c.c2_5 String
+            Header: c1_3 UInt64
+                    c2_5 String
               ReadFromMemoryStorage
               Header: c1 UInt64
                       c2 String
         Expression ((JOIN actions + (Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers)))))
-        Header: d.d1_4 UInt64
+        Header: d1_4 UInt64
           ReadFromStorage (SystemNumbers)
           Header: number UInt64
diff --git a/tests/queries/0_stateless/02675_predicate_push_down_filled_join_fix.reference b/tests/queries/0_stateless/02675_predicate_push_down_filled_join_fix.reference
index ecdb62c5cb5..986ecffcdf8 100644
--- a/tests/queries/0_stateless/02675_predicate_push_down_filled_join_fix.reference
+++ b/tests/queries/0_stateless/02675_predicate_push_down_filled_join_fix.reference
@@ -2,27 +2,27 @@ Expression ((Project names + (Projection + )))
 Header: t1.id UInt64
         t1.value String
         t2.value String
-Actions: INPUT : 0 -> t1.id_0 UInt64 : 0
-         INPUT : 1 -> t1.value_1 String : 1
-         INPUT : 2 -> t2.value_2 String : 2
-         ALIAS t1.id_0 :: 0 -> t1.id UInt64 : 3
-         ALIAS t1.value_1 :: 1 -> t1.value String : 0
-         ALIAS t2.value_2 :: 2 -> t2.value String : 1
+Actions: INPUT : 0 -> id_0 UInt64 : 0
+         INPUT : 1 -> value_1 String : 1
+         INPUT : 2 -> value_2 String : 2
+         ALIAS id_0 :: 0 -> t1.id UInt64 : 3
+         ALIAS value_1 :: 1 -> t1.value String : 0
+         ALIAS value_2 :: 2 -> t2.value String : 1
 Positions: 3 0 1
   FilledJoin (Filled JOIN)
-  Header: t1.id_0 UInt64
-          t1.value_1 String
-          t2.value_2 String
+  Header: id_0 UInt64
+          value_1 String
+          value_2 String
     Filter (( + (JOIN actions + Change column names to column identifiers)))
-    Header: t1.id_0 UInt64
-            t1.value_1 String
-    Filter column: equals(t1.id_0, 0_UInt8) (removed)
+    Header: id_0 UInt64
+            value_1 String
+    Filter column: equals(id_0, 0_UInt8) (removed)
     Actions: INPUT : 0 -> id UInt64 : 0
              INPUT : 1 -> value String : 1
              COLUMN Const(UInt8) -> 0_UInt8 UInt8 : 2
-             ALIAS id :: 0 -> t1.id_0 UInt64 : 3
-             ALIAS value :: 1 -> t1.value_1 String : 0
-             FUNCTION equals(t1.id_0 : 3, 0_UInt8 :: 2) -> equals(t1.id_0, 0_UInt8) UInt8 : 1
+             ALIAS id :: 0 -> id_0 UInt64 : 3
+             ALIAS value :: 1 -> value_1 String : 0
+             FUNCTION equals(id_0 : 3, 0_UInt8 :: 2) -> equals(id_0, 0_UInt8) UInt8 : 1
     Positions: 1 3 0
       ReadFromMergeTree (default.test_table)
       Header: id UInt64
diff --git a/tests/queries/0_stateless/02679_explain_merge_tree_prewhere_row_policy.reference b/tests/queries/0_stateless/02679_explain_merge_tree_prewhere_row_policy.reference
index 2fe98ea1682..cc16a1fce02 100644
--- a/tests/queries/0_stateless/02679_explain_merge_tree_prewhere_row_policy.reference
+++ b/tests/queries/0_stateless/02679_explain_merge_tree_prewhere_row_policy.reference
@@ -29,10 +29,10 @@ Header: id UInt64
         value String
 Actions: INPUT : 0 -> id UInt64 : 0
          INPUT : 1 -> value String : 1
-         ALIAS id :: 0 -> default.test_table.id_0 UInt64 : 2
-         ALIAS value :: 1 -> default.test_table.value_1 String : 0
-         ALIAS default.test_table.id_0 :: 2 -> id UInt64 : 1
-         ALIAS default.test_table.value_1 :: 0 -> value String : 2
+         ALIAS id :: 0 -> id_0 UInt64 : 2
+         ALIAS value :: 1 -> value_1 String : 0
+         ALIAS id_0 :: 2 -> id UInt64 : 1
+         ALIAS value_1 :: 0 -> value String : 2
 Positions: 1 2
   ReadFromMergeTree (default.test_table)
   Header: id UInt64

From 2c878581bf0642b7e7d8b3c63ac483f6f102639d Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 22 May 2023 17:20:53 +0000
Subject: [PATCH 0220/1478] Update
 02377_optimize_sorting_by_input_stream_properties_explain reference

---
 ..._input_stream_properties_explain.reference | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/tests/queries/0_stateless/02377_optimize_sorting_by_input_stream_properties_explain.reference b/tests/queries/0_stateless/02377_optimize_sorting_by_input_stream_properties_explain.reference
index 69c325c21a9..5c9e39805b7 100644
--- a/tests/queries/0_stateless/02377_optimize_sorting_by_input_stream_properties_explain.reference
+++ b/tests/queries/0_stateless/02377_optimize_sorting_by_input_stream_properties_explain.reference
@@ -8,7 +8,7 @@ Sorting (None)
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting ORDER BY a
 Sorting (Global): a ASC
 Sorting (Sorting for ORDER BY)
-Sorting (Global): default.optimize_sorting.a_0 ASC
+Sorting (Global): a_0 ASC
 Sorting (None)
 Sorting (None)
 -- disable optimization -> sorting order is NOT propagated from subquery -> full sort
@@ -36,8 +36,8 @@ Sorting (Stream): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting ORDER BY a
 Sorting (Global): a ASC
 Sorting (Sorting for ORDER BY)
-Sorting (Global): default.optimize_sorting.a_0 ASC
-Sorting (Stream): default.optimize_sorting.a_0 ASC
+Sorting (Global): a_0 ASC
+Sorting (Stream): a_0 ASC
 Sorting (Stream): a ASC
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting ORDER BY a+1
 Sorting (None)
@@ -48,8 +48,8 @@ Sorting (Chunk): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting ORDER BY a+1
 Sorting (None)
 Sorting (Sorting for ORDER BY)
-Sorting (Global): plus(default.optimize_sorting.a_0, 1_UInt8) ASC
-Sorting (Chunk): default.optimize_sorting.a_0 ASC
+Sorting (Global): plus(a_0, 1_UInt8) ASC
+Sorting (Chunk): a_0 ASC
 Sorting (Chunk): a ASC
 -- ExpressionStep breaks sort mode
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a+1 FROM optimize_sorting ORDER BY a+1
@@ -61,7 +61,7 @@ Sorting (Chunk): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a+1 FROM optimize_sorting ORDER BY a+1
 Sorting (Global): plus(a, 1) ASC
 Sorting (Sorting for ORDER BY)
-Sorting (Global): plus(default.optimize_sorting.a_0, 1_UInt8) ASC
+Sorting (Global): plus(a_0, 1_UInt8) ASC
 Sorting (None)
 Sorting (Chunk): a ASC
 -- FilterStep preserves sort mode
@@ -71,7 +71,7 @@ Sorting (Chunk): a ASC
 Sorting (Chunk): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting WHERE a > 0
 Sorting (Chunk): a ASC
-Sorting (Chunk): default.optimize_sorting.a_0 ASC
+Sorting (Chunk): a_0 ASC
 Sorting (Chunk): a ASC
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting WHERE a+1 > 0
 Sorting (Chunk): a ASC
@@ -79,7 +79,7 @@ Sorting (Chunk): a ASC
 Sorting (Chunk): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a FROM optimize_sorting WHERE a+1 > 0
 Sorting (Chunk): a ASC
-Sorting (Chunk): default.optimize_sorting.a_0 ASC
+Sorting (Chunk): a_0 ASC
 Sorting (Chunk): a ASC
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a, a+1 FROM optimize_sorting WHERE a+1 > 0
 Sorting (Chunk): a ASC
@@ -87,7 +87,7 @@ Sorting (Chunk): a ASC
 Sorting (Chunk): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a, a+1 FROM optimize_sorting WHERE a+1 > 0
 Sorting (Chunk): a ASC
-Sorting (Chunk): default.optimize_sorting.a_0 ASC
+Sorting (Chunk): a_0 ASC
 Sorting (Chunk): a ASC
 -- FilterStep breaks sort mode
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a > 0 FROM optimize_sorting WHERE a > 0
@@ -122,8 +122,8 @@ Sorting (Sorting for ORDER BY)
 Sorting (Global): a_0 ASC
 Sorting (None)
 Sorting (Sorting for ORDER BY)
-Sorting (Global): default.optimize_sorting.a_2 ASC
-Sorting (Stream): default.optimize_sorting.a_2 ASC
+Sorting (Global): a_2 ASC
+Sorting (Stream): a_2 ASC
 Sorting (Stream): a ASC
 -- aliases DONT break sorting order
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN actions=1, header=1, sorting=1 SELECT a, b FROM (SELECT x AS a, y AS b FROM (SELECT a AS x, b AS y FROM optimize_sorting) ORDER BY x, y)
@@ -152,10 +152,10 @@ Sorting (Chunk): a ASC
 Sorting (None)
 Sorting (Sorting for ORDER BY)
 Sorting (Global): plus(a_0, 1_UInt8) ASC
-Sorting (Global): plus(default.optimize_sorting.a_3, 1_UInt8) ASC
+Sorting (Global): plus(a_3, 1_UInt8) ASC
 Sorting (Sorting for ORDER BY)
-Sorting (Global): plus(default.optimize_sorting.a_3, 1_UInt8) ASC
-Sorting (Chunk): default.optimize_sorting.a_3 ASC
+Sorting (Global): plus(a_3, 1_UInt8) ASC
+Sorting (Chunk): a_3 ASC
 Sorting (Chunk): a ASC
 -- check that correct sorting info is provided in case of only prefix of sorting key is in ORDER BY clause but all sorting key columns returned by query
 -- QUERY: set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN sorting=1 SELECT a, b FROM optimize_sorting ORDER BY a
@@ -167,6 +167,6 @@ Sorting (Stream): a ASC
 -- QUERY (analyzer): set optimize_read_in_order=1;set max_threads=3;set query_plan_remove_redundant_sorting=0;EXPLAIN PLAN sorting=1 SELECT a, b FROM optimize_sorting ORDER BY a
 Sorting (Global): a ASC
 Sorting (Sorting for ORDER BY)
-Sorting (Global): default.optimize_sorting.a_0 ASC
-Sorting (Stream): default.optimize_sorting.a_0 ASC
+Sorting (Global): a_0 ASC
+Sorting (Stream): a_0 ASC
 Sorting (Stream): a ASC

From d79bd5694ad6345e41aa640afb4d839c46da716d Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Wed, 24 May 2023 00:05:27 +0200
Subject: [PATCH 0221/1478] Fix LambdaNode::cloneImpl

---
 src/Analyzer/LambdaNode.cpp | 5 +++--
 src/Analyzer/LambdaNode.h   | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/Analyzer/LambdaNode.cpp b/src/Analyzer/LambdaNode.cpp
index 0d15c4d42e6..4be4d69c190 100644
--- a/src/Analyzer/LambdaNode.cpp
+++ b/src/Analyzer/LambdaNode.cpp
@@ -10,9 +10,10 @@
 namespace DB
 {
 
-LambdaNode::LambdaNode(Names argument_names_, QueryTreeNodePtr expression_)
+LambdaNode::LambdaNode(Names argument_names_, QueryTreeNodePtr expression_, DataTypePtr result_type_)
     : IQueryTreeNode(children_size)
     , argument_names(std::move(argument_names_))
+    , result_type(std::move(result_type_))
 {
     auto arguments_list_node = std::make_shared<ListNode>();
     auto & nodes = arguments_list_node->getNodes();
@@ -63,7 +64,7 @@ void LambdaNode::updateTreeHashImpl(HashState & state) const
 
 QueryTreeNodePtr LambdaNode::cloneImpl() const
 {
-    return std::make_shared<LambdaNode>(argument_names, getExpression());
+    return std::make_shared<LambdaNode>(argument_names, getExpression(), result_type);
 }
 
 ASTPtr LambdaNode::toASTImpl(const ConvertToASTOptions & options) const
diff --git a/src/Analyzer/LambdaNode.h b/src/Analyzer/LambdaNode.h
index 355ed77cc6a..ea44a7e8187 100644
--- a/src/Analyzer/LambdaNode.h
+++ b/src/Analyzer/LambdaNode.h
@@ -35,7 +35,7 @@ class LambdaNode final : public IQueryTreeNode
 {
 public:
     /// Initialize lambda with argument names and lambda body expression
-    explicit LambdaNode(Names argument_names_, QueryTreeNodePtr expression_);
+    explicit LambdaNode(Names argument_names_, QueryTreeNodePtr expression_, DataTypePtr result_type_ = {});
 
     /// Get argument names
     const Names & getArgumentNames() const

From b86516131bef352b114e67c17b77706496bb0fd9 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Wed, 24 May 2023 16:22:58 +0000
Subject: [PATCH 0222/1478] Attempt to fix global JOINs and INs

---
 src/Storages/StorageDistributed.cpp | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index e0bb14c62fd..05f9821f6cb 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -30,6 +30,8 @@
 #include <Common/randomSeed.h>
 #include <Common/formatReadable.h>
 #include <Common/CurrentMetrics.h>
+#include "Analyzer/IQueryTreeNode.h"
+#include "Analyzer/MatcherNode.h"
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -1003,7 +1005,17 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
                 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));
+
+            auto in_second_argument_query_node = std::make_shared<QueryNode>(Context::createCopy(query_context));
+            in_second_argument_query_node->setIsSubquery(true);
+            in_second_argument_query_node->getProjectionNode() = std::make_shared<ListNode>();
+            in_second_argument_query_node->getProjection().getNodes() = { std::make_shared<MatcherNode>() };
+            in_second_argument_query_node->getJoinTree() = std::move(temporary_table_expression_node);
+
+            QueryAnalysisPass query_analysis_pass;
+            query_analysis_pass.run(in_second_argument_query_node, query_context);
+
+            replacement_map.emplace(join_right_table_expression.get(), std::move(in_second_argument_query_node));
             continue;
         }
         else if (auto * in_function_node = global_in_or_join_node.query_node->as<FunctionNode>())
@@ -1016,7 +1028,17 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
             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);
+
+            auto in_second_argument_query_node = std::make_shared<QueryNode>(Context::createCopy(query_context));
+            in_second_argument_query_node->setIsSubquery(true);
+            in_second_argument_query_node->getProjectionNode() = std::make_shared<ListNode>();
+            in_second_argument_query_node->getProjection().getNodes() = { std::make_shared<MatcherNode>() };
+            in_second_argument_query_node->getJoinTree() = std::move(temporary_table_expression_node);
+
+            QueryAnalysisPass query_analysis_pass;
+            query_analysis_pass.run(in_second_argument_query_node, query_context);
+
+            in_function_subquery_node = std::move(in_second_argument_query_node);
         }
         else
         {
@@ -1059,9 +1081,8 @@ void StorageDistributed::read(
             storage_snapshot,
             remote_storage_id,
             remote_table_function_ptr);
-
-        query_ast = queryNodeToSelectQuery(query_tree_distributed);
         header = InterpreterSelectQueryAnalyzer::getSampleBlock(query_tree_distributed, local_context, SelectQueryOptions(processed_stage).analyze());
+        query_ast = queryNodeToSelectQuery(query_tree_distributed);
     }
     else
     {

From 85e5ed79e5b60f00df2cf7d8c41b249485c02547 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Thu, 25 May 2023 15:58:08 +0000
Subject: [PATCH 0223/1478] Fix distributed JOINs

---
 src/Storages/StorageDistributed.cpp | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 05f9821f6cb..98c92541f67 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -1006,16 +1006,7 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
                 global_in_or_join_node.subquery_depth);
             temporary_table_expression_node->setAlias(join_right_table_expression->getAlias());
 
-            auto in_second_argument_query_node = std::make_shared<QueryNode>(Context::createCopy(query_context));
-            in_second_argument_query_node->setIsSubquery(true);
-            in_second_argument_query_node->getProjectionNode() = std::make_shared<ListNode>();
-            in_second_argument_query_node->getProjection().getNodes() = { std::make_shared<MatcherNode>() };
-            in_second_argument_query_node->getJoinTree() = std::move(temporary_table_expression_node);
-
-            QueryAnalysisPass query_analysis_pass;
-            query_analysis_pass.run(in_second_argument_query_node, query_context);
-
-            replacement_map.emplace(join_right_table_expression.get(), std::move(in_second_argument_query_node));
+            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>())

From bc7b7f2cd2e1c56aacecd2855feb37bac10590c6 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Thu, 25 May 2023 16:00:13 +0000
Subject: [PATCH 0224/1478] Always add source alias in ColumnNode::toASTImpl

---
 src/Analyzer/ColumnNode.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Analyzer/ColumnNode.cpp b/src/Analyzer/ColumnNode.cpp
index f020040ea78..76f5697afb0 100644
--- a/src/Analyzer/ColumnNode.cpp
+++ b/src/Analyzer/ColumnNode.cpp
@@ -96,7 +96,7 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
     std::vector<std::string> column_identifier_parts;
 
     auto column_source = getColumnSourceOrNull();
-    if (column_source && options.fully_qualified_identifiers)
+    if (column_source)
     {
         auto node_type = column_source->getNodeType();
         if (node_type == QueryTreeNodeType::TABLE ||
@@ -108,7 +108,8 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
             {
                 column_identifier_parts = {column_source->getAlias()};
             }
-            else if (auto * table_node = column_source->as<TableNode>())
+            else if (auto * table_node = column_source->as<TableNode>();
+                table_node && options.fully_qualified_identifiers)
             {
                 if (!table_node->getTemporaryTableName().empty())
                 {

From c6dcb69b853528aacda070d00b3a873179470f82 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Tue, 30 May 2023 14:33:35 +0000
Subject: [PATCH 0225/1478] Fix GLOBAL IN

---
 src/Analyzer/Passes/QueryAnalysisPass.cpp |  9 +++---
 src/Planner/CollectSets.cpp               |  3 +-
 src/Planner/Planner.cpp                   | 35 +++++++++++++++++++++--
 src/Planner/PlannerContext.cpp            |  3 +-
 src/Storages/StorageDistributed.cpp       | 14 ++-------
 5 files changed, 45 insertions(+), 19 deletions(-)

diff --git a/src/Analyzer/Passes/QueryAnalysisPass.cpp b/src/Analyzer/Passes/QueryAnalysisPass.cpp
index b2bfa648435..c454ad9f84f 100644
--- a/src/Analyzer/Passes/QueryAnalysisPass.cpp
+++ b/src/Analyzer/Passes/QueryAnalysisPass.cpp
@@ -4767,13 +4767,14 @@ ProjectionNames QueryAnalyzer::resolveFunction(QueryTreeNodePtr & node, Identifi
         auto * table_node = in_second_argument->as<TableNode>();
         auto * table_function_node = in_second_argument->as<TableFunctionNode>();
 
-        if (table_node && dynamic_cast<StorageSet *>(table_node->getStorage().get()) != nullptr)
+        if (table_node)
         {
-            /// If table is already prepared set, we do not replace it with subquery
+            /// If table is already prepared set, we do not replace it with subquery.
+            /// If table is not a StorageSet, we'll create plan to build set in the Planner.
         }
-        else if (table_node || table_function_node)
+        else if (table_function_node)
         {
-            const auto & storage_snapshot = table_node ? table_node->getStorageSnapshot() : table_function_node->getStorageSnapshot();
+            const auto & storage_snapshot = table_function_node->getStorageSnapshot();
             auto columns_to_select = storage_snapshot->getColumns(GetColumnsOptions(GetColumnsOptions::Ordinary));
 
             size_t columns_to_select_size = columns_to_select.size();
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 02069aad292..eb2b02c7ccb 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -67,7 +67,8 @@ public:
             planner_context.registerSet(set_key, PlannerSet(FutureSet(std::move(set))));
         }
         else if (in_second_argument_node_type == QueryTreeNodeType::QUERY ||
-            in_second_argument_node_type == QueryTreeNodeType::UNION)
+            in_second_argument_node_type == QueryTreeNodeType::UNION ||
+            in_second_argument_node_type == QueryTreeNodeType::TABLE)
         {
             planner_context.registerSet(set_key, PlannerSet(in_second_argument));
         }
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index 7292f73e21c..5abf3ec5a80 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -43,6 +43,7 @@
 #include <Storages/IStorage.h>
 
 #include <Analyzer/Utils.h>
+#include <Analyzer/ColumnNode.h>
 #include <Analyzer/ConstantNode.h>
 #include <Analyzer/FunctionNode.h>
 #include <Analyzer/SortNode.h>
@@ -909,12 +910,42 @@ void addBuildSubqueriesForSetsStepIfNeeded(QueryPlan & query_plan,
             if (!planner_set)
                 continue;
 
-            if (planner_set->getSet().isCreated() || !planner_set->getSubqueryNode())
+            auto subquery_to_execute = planner_set->getSubqueryNode();
+
+            if (planner_set->getSet().isCreated() || !subquery_to_execute)
                 continue;
 
+            if (auto * table_node = subquery_to_execute->as<TableNode>())
+            {
+                auto storage_snapshot = table_node->getStorageSnapshot();
+                auto columns_to_select = storage_snapshot->getColumns(GetColumnsOptions(GetColumnsOptions::Ordinary));
+
+                size_t columns_to_select_size = columns_to_select.size();
+
+                auto column_nodes_to_select = std::make_shared<ListNode>();
+                column_nodes_to_select->getNodes().reserve(columns_to_select_size);
+
+                NamesAndTypes projection_columns;
+                projection_columns.reserve(columns_to_select_size);
+
+                for (auto & column : columns_to_select)
+                {
+                    column_nodes_to_select->getNodes().emplace_back(std::make_shared<ColumnNode>(column, subquery_to_execute));
+                    projection_columns.emplace_back(column.name, column.type);
+                }
+
+                auto subquery_for_table = std::make_shared<QueryNode>(Context::createCopy(planner_context->getQueryContext()));
+                subquery_for_table->setIsSubquery(true);
+                subquery_for_table->getProjectionNode() = std::move(column_nodes_to_select);
+                subquery_for_table->getJoinTree() = std::move(subquery_to_execute);
+                subquery_for_table->resolveProjectionColumns(std::move(projection_columns));
+
+                subquery_to_execute = std::move(subquery_for_table);
+            }
+
             auto subquery_options = select_query_options.subquery();
             Planner subquery_planner(
-                planner_set->getSubqueryNode(),
+                subquery_to_execute,
                 subquery_options,
                 planner_context->getGlobalPlannerContext());
             subquery_planner.buildQueryPlanIfNeeded();
diff --git a/src/Planner/PlannerContext.cpp b/src/Planner/PlannerContext.cpp
index a788a6cbc3c..708dab04d02 100644
--- a/src/Planner/PlannerContext.cpp
+++ b/src/Planner/PlannerContext.cpp
@@ -129,7 +129,8 @@ void PlannerContext::registerSet(const SetKey & key, PlannerSet planner_set)
         auto node_type = subquery_node->getNodeType();
 
         if (node_type != QueryTreeNodeType::QUERY &&
-            node_type != QueryTreeNodeType::UNION)
+            node_type != QueryTreeNodeType::UNION &&
+            node_type != QueryTreeNodeType::TABLE)
             throw Exception(ErrorCodes::LOGICAL_ERROR,
                 "Invalid node for set table expression. Expected query or union. Actual {}",
                 subquery_node->formatASTForErrorMessage());
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 98c92541f67..f1fb4bb0c65 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -849,7 +849,7 @@ private:
 /** Execute subquery node and put result in mutable context temporary table.
   * Returns table node that is initialized with temporary table storage.
   */
-QueryTreeNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
+TableNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
     ContextMutablePtr & mutable_context,
     size_t subquery_depth)
 {
@@ -1019,17 +1019,9 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
             auto temporary_table_expression_node = executeSubqueryNode(in_function_subquery_node,
                 planner_context->getMutableQueryContext(),
                 global_in_or_join_node.subquery_depth);
+            temporary_table_expression_node->setAlias(temporary_table_expression_node->getTemporaryTableName());
 
-            auto in_second_argument_query_node = std::make_shared<QueryNode>(Context::createCopy(query_context));
-            in_second_argument_query_node->setIsSubquery(true);
-            in_second_argument_query_node->getProjectionNode() = std::make_shared<ListNode>();
-            in_second_argument_query_node->getProjection().getNodes() = { std::make_shared<MatcherNode>() };
-            in_second_argument_query_node->getJoinTree() = std::move(temporary_table_expression_node);
-
-            QueryAnalysisPass query_analysis_pass;
-            query_analysis_pass.run(in_second_argument_query_node, query_context);
-
-            in_function_subquery_node = std::move(in_second_argument_query_node);
+            in_function_subquery_node = std::move(temporary_table_expression_node);
         }
         else
         {

From eb7ae91d0144a895ef53c862c79d930fe2cbdbab Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Wed, 31 May 2023 15:00:11 +0000
Subject: [PATCH 0226/1478] Do not add alias to a temporary table

---
 src/Storages/StorageDistributed.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index f1fb4bb0c65..43b1333413e 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -1019,7 +1019,6 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
             auto temporary_table_expression_node = executeSubqueryNode(in_function_subquery_node,
                 planner_context->getMutableQueryContext(),
                 global_in_or_join_node.subquery_depth);
-            temporary_table_expression_node->setAlias(temporary_table_expression_node->getTemporaryTableName());
 
             in_function_subquery_node = std::move(temporary_table_expression_node);
         }

From 99b35eca0789cd9e3a055697486532bc1d4403d1 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Wed, 31 May 2023 15:05:48 +0000
Subject: [PATCH 0227/1478] Update reference files

---
 .../01561_clickhouse_client_stage.reference        |  2 +-
 .../0_stateless/01591_window_functions.reference   | 14 +++++++-------
 .../02048_clickhouse_local_stage.reference         |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/tests/queries/0_stateless/01561_clickhouse_client_stage.reference b/tests/queries/0_stateless/01561_clickhouse_client_stage.reference
index 00e0f4ddb2e..8a34751b071 100644
--- a/tests/queries/0_stateless/01561_clickhouse_client_stage.reference
+++ b/tests/queries/0_stateless/01561_clickhouse_client_stage.reference
@@ -2,7 +2,7 @@ execute: --allow_experimental_analyzer=1
 "foo"
 1
 execute: --allow_experimental_analyzer=1 --stage fetch_columns
-"system.one.dummy_0"
+"dummy_0"
 0
 execute: --allow_experimental_analyzer=1 --stage with_mergeable_state
 "1_UInt8"
diff --git a/tests/queries/0_stateless/01591_window_functions.reference b/tests/queries/0_stateless/01591_window_functions.reference
index b981a46b4fd..8939ea1111d 100644
--- a/tests/queries/0_stateless/01591_window_functions.reference
+++ b/tests/queries/0_stateless/01591_window_functions.reference
@@ -917,9 +917,9 @@ from
 ;
 Expression ((Project names + Projection))
   Window (Window step for window \'\')
-    Window (Window step for window \'PARTITION BY t.p_0\')
-      Window (Window step for window \'PARTITION BY t.p_0 ORDER BY t.o_1 ASC\')
-        Sorting (Sorting for window \'PARTITION BY t.p_0 ORDER BY t.o_1 ASC\')
+    Window (Window step for window \'PARTITION BY p_0\')
+      Window (Window step for window \'PARTITION BY p_0 ORDER BY o_1 ASC\')
+        Sorting (Sorting for window \'PARTITION BY p_0 ORDER BY o_1 ASC\')
           Expression ((Before WINDOW + (Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers)))))
             ReadFromStorage (SystemNumbers)
 explain select
@@ -930,11 +930,11 @@ from
         from numbers(16)) t
 ;
 Expression ((Project names + Projection))
-  Window (Window step for window \'ORDER BY t.o_0 ASC, t.number_1 ASC\')
-    Sorting (Sorting for window \'ORDER BY t.o_0 ASC, t.number_1 ASC\')
-      Window (Window step for window \'ORDER BY t.number_1 ASC\')
+  Window (Window step for window \'ORDER BY o_0 ASC, number_1 ASC\')
+    Sorting (Sorting for window \'ORDER BY o_0 ASC, number_1 ASC\')
+      Window (Window step for window \'ORDER BY number_1 ASC\')
         Expression ((Before WINDOW + (Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers)))) [lifted up part])
-          Sorting (Sorting for window \'ORDER BY t.number_1 ASC\')
+          Sorting (Sorting for window \'ORDER BY number_1 ASC\')
             Expression ((Before WINDOW + (Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers)))))
               ReadFromStorage (SystemNumbers)
 -- A test case for the sort comparator found by fuzzer.
diff --git a/tests/queries/0_stateless/02048_clickhouse_local_stage.reference b/tests/queries/0_stateless/02048_clickhouse_local_stage.reference
index 00e0f4ddb2e..8a34751b071 100644
--- a/tests/queries/0_stateless/02048_clickhouse_local_stage.reference
+++ b/tests/queries/0_stateless/02048_clickhouse_local_stage.reference
@@ -2,7 +2,7 @@ execute: --allow_experimental_analyzer=1
 "foo"
 1
 execute: --allow_experimental_analyzer=1 --stage fetch_columns
-"system.one.dummy_0"
+"dummy_0"
 0
 execute: --allow_experimental_analyzer=1 --stage with_mergeable_state
 "1_UInt8"

From ffd4f7f196db8f827ea3f8cc5edeb6b0a1082d72 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 1 Jun 2023 14:39:01 +0000
Subject: [PATCH 0228/1478] Add better support for state disks

---
 src/Coordination/KeeperDispatcher.cpp   |  2 --
 src/Coordination/KeeperStateManager.cpp | 33 ++++++++++++++++++++-----
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index a5b0f0b2c01..9d9df5c7f30 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -38,8 +38,6 @@ namespace ProfileEvents
     extern const Event MemoryAllocatorPurgeTimeMicroseconds;
 }
 
-namespace fs = std::filesystem;
-
 namespace DB
 {
 
diff --git a/src/Coordination/KeeperStateManager.cpp b/src/Coordination/KeeperStateManager.cpp
index 33e62684d46..450fd04b61d 100644
--- a/src/Coordination/KeeperStateManager.cpp
+++ b/src/Coordination/KeeperStateManager.cpp
@@ -23,6 +23,8 @@ namespace ErrorCodes
 namespace
 {
 
+const std::string copy_lock_file = "STATE_COPY_LOCK";
+
 bool isLocalhost(const std::string & hostname)
 {
     try
@@ -324,7 +326,13 @@ void KeeperStateManager::save_state(const nuraft::srv_state & state)
     auto disk = getStateFileDisk();
 
     if (disk->exists(server_state_file_name))
-        disk->moveFile(server_state_file_name, old_path);
+    {
+        auto buf = disk->writeFile(copy_lock_file);
+        buf->finalize();
+        disk->copyFile(server_state_file_name, *disk, old_path);
+        disk->removeFile(copy_lock_file);
+        disk->removeFile(old_path);
+    }
 
     auto server_state_file = disk->writeFile(server_state_file_name);
     auto buf = state.serialize();
@@ -339,6 +347,7 @@ void KeeperStateManager::save_state(const nuraft::srv_state & state)
 
     server_state_file->write(reinterpret_cast<const char *>(buf->data_begin()), buf->size());
     server_state_file->sync();
+    server_state_file->finalize();
 
     disk->removeFileIfExists(old_path);
 }
@@ -417,13 +426,25 @@ nuraft::ptr<nuraft::srv_state> KeeperStateManager::read_state()
 
     if (disk->exists(old_path))
     {
-        auto state = try_read_file(old_path);
-        if (state)
+        if (disk->exists(copy_lock_file))
         {
-            disk->moveFile(old_path, server_state_file_name);
-            return state;
+            disk->removeFile(old_path);
+            disk->removeFile(copy_lock_file);
         }
-        disk->removeFile(old_path);
+        else
+        {
+            auto state = try_read_file(old_path);
+            if (state)
+            {
+                disk->moveFile(old_path, server_state_file_name);
+                return state;
+            }
+            disk->removeFile(old_path);
+        }
+    }
+    else if (disk->exists(copy_lock_file))
+    {
+        disk->removeFile(copy_lock_file);
     }
 
     LOG_WARNING(logger, "No state was read");

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 0229/1478] 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 0230/1478] 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 480db8622df10993a2df31e24255f96f58ef0094 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Thu, 1 Jun 2023 15:21:55 +0000
Subject: [PATCH 0231/1478] Always add table name while converting ColumnNode
 to AST

---
 src/Analyzer/ColumnNode.cpp | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/Analyzer/ColumnNode.cpp b/src/Analyzer/ColumnNode.cpp
index 76f5697afb0..dd41522ac7d 100644
--- a/src/Analyzer/ColumnNode.cpp
+++ b/src/Analyzer/ColumnNode.cpp
@@ -108,8 +108,7 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
             {
                 column_identifier_parts = {column_source->getAlias()};
             }
-            else if (auto * table_node = column_source->as<TableNode>();
-                table_node && options.fully_qualified_identifiers)
+            else if (auto * table_node = column_source->as<TableNode>())
             {
                 if (!table_node->getTemporaryTableName().empty())
                 {
@@ -118,7 +117,7 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
                 else
                 {
                     const auto & table_storage_id = table_node->getStorageID();
-                    if (table_storage_id.hasDatabase())
+                    if (table_storage_id.hasDatabase() && options.fully_qualified_identifiers)
                         column_identifier_parts = { table_storage_id.getDatabaseName(), table_storage_id.getTableName() };
                     else
                         column_identifier_parts = { table_storage_id.getTableName() };

From 985cd8fc8a0fdbe09a95132f1fb549825ece636f Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 26 Apr 2023 21:20:19 +0200
Subject: [PATCH 0232/1478] Improve events logging

---
 tests/ci/terminate_runner_lambda/app.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index c9192417575..5a78c8c8e39 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -160,7 +160,7 @@ def get_candidates_to_be_killed(event_data: dict) -> Dict[str, List[str]]:
 
 
 def main(access_token: str, event: dict) -> Dict[str, List[str]]:
-    print("Got event", json.dumps(event, sort_keys=True, indent=4))
+    print("Got event", json.dumps(event, sort_keys=True).replace("\n", ""))
     to_kill_by_zone = how_many_instances_to_kill(event)
     instances_by_zone = get_candidates_to_be_killed(event)
 
@@ -177,7 +177,8 @@ def main(access_token: str, event: dict) -> Dict[str, List[str]]:
         total_to_kill += num_to_kill
         if num_to_kill > len(candidates):
             raise Exception(
-                f"Required to kill {num_to_kill}, but have only {len(candidates)} candidates in AV {zone}"
+                f"Required to kill {num_to_kill}, but have only {len(candidates)}"
+                f" candidates in AV {zone}"
             )
 
         delete_for_av = []  # type: RunnerDescriptions
@@ -207,7 +208,8 @@ def main(access_token: str, event: dict) -> Dict[str, List[str]]:
 
         if len(delete_for_av) < num_to_kill:
             print(
-                f"Checked all candidates for av {zone}, get to delete {len(delete_for_av)}, but still cannot get required {num_to_kill}"
+                f"Checked all candidates for av {zone}, get to delete "
+                f"{len(delete_for_av)}, but still cannot get required {num_to_kill}"
             )
 
         instances_to_kill += [runner.name for runner in delete_for_av]

From 7bf9089dcd34e0c29b1f951066136fec1d990372 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 27 Apr 2023 12:00:22 +0200
Subject: [PATCH 0233/1478] Increase access_token cached time

---
 tests/ci/terminate_runner_lambda/app.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index 5a78c8c8e39..390375a34e4 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -64,7 +64,7 @@ cached_token = CachedToken(0, "")
 
 
 def get_cached_access_token() -> str:
-    if time.time() - 500 < cached_token.time:
+    if time.time() - 550 < cached_token.time:
         return cached_token.value
     private_key, app_id = get_key_and_app_from_aws()
     payload = {

From bf9b563e0b2c3b1933405aef34d904afc7ade57f Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 27 Apr 2023 16:54:37 +0200
Subject: [PATCH 0234/1478] Improve caching mechanism for token, add cached
 instances

---
 tests/ci/terminate_runner_lambda/app.py | 40 ++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index 390375a34e4..bf883880c8d 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -58,14 +58,19 @@ def get_access_token(jwt_token: str, installation_id: int) -> str:
 class CachedToken:
     time: int
     value: str
+    updating: bool = False
 
 
 cached_token = CachedToken(0, "")
 
 
 def get_cached_access_token() -> str:
-    if time.time() - 550 < cached_token.time:
+    if time.time() - 550 < cached_token.time or cached_token.updating:
         return cached_token.value
+    # Indicate that the value is updating now, so the cached value can be
+    # 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
     private_key, app_id = get_key_and_app_from_aws()
     payload = {
         "iat": int(time.time()) - 60,
@@ -77,9 +82,42 @@ def get_cached_access_token() -> str:
     installation_id = get_installation_id(encoded_jwt)
     cached_token.time = int(time.time())
     cached_token.value = get_access_token(encoded_jwt, installation_id)
+    cached_token.updating = False
     return cached_token.value
 
 
+@dataclass
+class CachedInstances:
+    time: int
+    value: dict
+    updating: bool = False
+
+
+cached_instances = CachedInstances(0, {})
+
+
+def get_cached_instances() -> dict:
+    """return cached instances description with updating it once per five minutes"""
+    if time.time() - 250 < cached_instances.time or cached_instances.updating:
+        return cached_instances.value
+    # Indicate that the value is updating now, so the cached value can be
+    # 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
+    ec2_client = boto3.client("ec2")
+    instances_response = ec2_client.describe_instances(
+        Filters=[{"Name": "instance-state-name", "Values": ["running"]}]
+    )
+    cached_instances.time = int(time.time())
+    cached_instances.value = {
+        instance["InstanceId"]: instance
+        for reservation in instances_response["Reservations"]
+        for instance in reservation["Instances"]
+    }
+    cached_instances.updating = False
+    return cached_instances.value
+
+
 RunnerDescription = namedtuple(
     "RunnerDescription", ["id", "name", "tags", "offline", "busy"]
 )

From 855afb56f913d3d7ba6dcc7f992b59cfaf5cb02e Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 27 Apr 2023 16:56:17 +0200
Subject: [PATCH 0235/1478] Get instances for the region to not kill a fresh
 one

---
 tests/ci/terminate_runner_lambda/app.py | 53 ++++++++++++++++++-------
 1 file changed, 39 insertions(+), 14 deletions(-)

diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index bf883880c8d..e0164bc58c0 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -198,11 +198,37 @@ def get_candidates_to_be_killed(event_data: dict) -> Dict[str, List[str]]:
 
 
 def main(access_token: str, event: dict) -> Dict[str, List[str]]:
+    start = time.time()
     print("Got event", json.dumps(event, sort_keys=True).replace("\n", ""))
     to_kill_by_zone = how_many_instances_to_kill(event)
     instances_by_zone = get_candidates_to_be_killed(event)
+    # Getting ASG and instances' descriptions from the API
+    # We don't kill instances that alive for less than 10 minutes, since they
+    # could be not in the GH active runners yet
+    print(f"Check other hosts from the same ASG {event['AutoScalingGroupName']}")
+    asg_client = boto3.client("autoscaling")
+    as_groups_response = asg_client.describe_auto_scaling_groups(
+        AutoScalingGroupNames=[event["AutoScalingGroupName"]]
+    )
+    assert len(as_groups_response["AutoScalingGroups"]) == 1
+    asg = as_groups_response["AutoScalingGroups"][0]
+    asg_instance_ids = [instance["InstanceId"] for instance in asg["Instances"]]
+    instance_descriptions = get_cached_instances()
+    # The instances launched less than 10 minutes ago
+    immune_ids = [
+        instance["InstanceId"]
+        for instance in instance_descriptions.values()
+        if start - instance["LaunchTime"].timestamp() < 600
+    ]
+    # if the ASG's instance ID not in instance_descriptions, it's most probably
+    # is not cached yet, so we must mark it as immuned
+    immune_ids.extend(
+        iid for iid in asg_instance_ids if iid not in instance_descriptions
+    )
+    print("Time spent on the requests to AWS: ", time.time() - start)
 
     runners = list_runners(access_token)
+    runner_ids = set(runner.name for runner in runners)
     # We used to delete potential hosts to terminate from GitHub runners pool,
     # but the documentation states:
     # --- Returning an instance first in the response data does not guarantee its termination
@@ -221,13 +247,17 @@ def main(access_token: str, event: dict) -> Dict[str, List[str]]:
 
         delete_for_av = []  # type: RunnerDescriptions
         for candidate in candidates:
-            if candidate not in set(runner.name for runner in runners):
+            if candidate in immune_ids:
+                print(
+                    f"Candidate {candidate} started less than 10 minutes ago, won't touch a child"
+                )
+                break
+            if candidate not in runner_ids:
                 print(
                     f"Candidate {candidate} was not in runners list, simply delete it"
                 )
                 instances_to_kill.append(candidate)
-
-        for candidate in candidates:
+                break
             if len(delete_for_av) + len(instances_to_kill) == num_to_kill:
                 break
             if candidate in instances_to_kill:
@@ -253,16 +283,11 @@ def main(access_token: str, event: dict) -> Dict[str, List[str]]:
         instances_to_kill += [runner.name for runner in delete_for_av]
 
     if len(instances_to_kill) < total_to_kill:
-        print(f"Check other hosts from the same ASG {event['AutoScalingGroupName']}")
-        client = boto3.client("autoscaling")
-        as_groups = client.describe_auto_scaling_groups(
-            AutoScalingGroupNames=[event["AutoScalingGroupName"]]
-        )
-        assert len(as_groups["AutoScalingGroups"]) == 1
-        asg = as_groups["AutoScalingGroups"][0]
-        for instance in asg["Instances"]:
+        for instance in asg_instance_ids:
+            if instance in immune_ids:
+                continue
             for runner in runners:
-                if runner.name == instance["InstanceId"] and not runner.busy:
+                if runner.name == instance and not runner.busy:
                     print(f"Runner {runner.name} is not busy and can be deleted")
                     instances_to_kill.append(runner.name)
 
@@ -270,9 +295,9 @@ def main(access_token: str, event: dict) -> Dict[str, List[str]]:
                 print("Got enough instances to kill")
                 break
 
-    print("Got instances to kill: ", ", ".join(instances_to_kill))
     response = {"InstanceIDs": instances_to_kill}
-    print(response)
+    print("Got instances to kill: ", response)
+    print("Time spent on the request: ", time.time() - start)
     return response
 
 

From db029384110be42a55e8420e6a13091cd2dca164 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 4 May 2023 12:20:57 +0200
Subject: [PATCH 0236/1478] Do not count unfinished tasks with conclusion=None

---
 tests/ci/workflow_jobs_lambda/app.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/tests/ci/workflow_jobs_lambda/app.py b/tests/ci/workflow_jobs_lambda/app.py
index bc8e1212be5..c4ce68c3f8e 100644
--- a/tests/ci/workflow_jobs_lambda/app.py
+++ b/tests/ci/workflow_jobs_lambda/app.py
@@ -257,6 +257,7 @@ def handler(event: dict, context: Any) -> dict:
     else:
         event_data = json.loads(event["body"])
 
+    logging.info("Got the next raw event from the github hook: %s", event_data)
     repo = event_data["repository"]
     try:
         wf_job = event_data["workflow_job"]
@@ -265,6 +266,9 @@ def handler(event: dict, context: Any) -> dict:
         logging.error("The event data: %s", event)
         logging.error("The context data: %s", context)
 
+    # We record only finished steps
+    steps = len([step for step in wf_job["steps"] if step["conclusion"] is not None])
+
     workflow_job = WorkflowJob(
         wf_job["id"],
         wf_job["run_id"],
@@ -281,7 +285,7 @@ def handler(event: dict, context: Any) -> dict:
         wf_job["started_at"],
         wf_job["completed_at"] or "1970-01-01T00:00:00",  # nullable date
         wf_job["name"],
-        len(wf_job["steps"]),
+        steps,
         wf_job["check_run_url"],
         wf_job["labels"],
         wf_job["runner_id"] or 0,  # nullable

From 27941b4d2603a1308978bdc32c6db4d6ed0da7ef Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 22 May 2023 17:57:12 +0200
Subject: [PATCH 0237/1478] Decrease the time window for
 autoscale_runners_lambda

---
 tests/ci/autoscale_runners_lambda/app.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index cbc9f4f8901..3fbab0d13dc 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -22,10 +22,13 @@ RUNNER_TYPE_LABELS = [
     "style-checker-aarch64",
 ]
 
+### Update comment on the change ###
 # 4 HOUR - is a balance to get the most precise values
 #   - Our longest possible running check is around 5h on the worst scenario
 #   - The long queue won't be wiped out and replaced, so the measurmenet is fine
 #   - If the data is spoiled by something, we are from the bills perspective
+# Changed it to 3 HOUR: in average we have 1h tasks, but p90 is around 2h.
+# With 4h we have too much wasted computing time in case of issues with DB
 QUEUE_QUERY = f"""SELECT
     last_status AS status,
     toUInt32(count()) AS length,
@@ -40,7 +43,7 @@ FROM
     FROM default.workflow_jobs
     WHERE has(labels, 'self-hosted')
         AND hasAny({RUNNER_TYPE_LABELS}, labels)
-        AND started_at > now() - INTERVAL 4 HOUR
+        AND started_at > now() - INTERVAL 3 HOUR
     GROUP BY ALL
     HAVING last_status IN ('in_progress', 'queued')
 )

From 484c91c47e3aa8365eec5ae29d03fb66a8372bb0 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 22 May 2023 20:39:22 +0200
Subject: [PATCH 0238/1478] Add DRY_RUN and configurable PY_VERSION to lambda
 deployment

---
 .../ci/team_keys_lambda/build_and_deploy_archive.sh  | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
index 4aee85c588a..f35d6456cd3 100644
--- a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
+++ b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
@@ -5,11 +5,17 @@ WORKDIR=$(dirname "$0")
 WORKDIR=$(readlink -f "${WORKDIR}")
 cd "$WORKDIR"
 
-PY_VERSION=3.10
+# Do not deploy the lambda to AWS
+DRY_RUN=${DRY_RUN:-}
+# Python runtime to install dependencies
+PY_VERSION=${PY_VERSION:-3.10}
 PY_EXEC="python${PY_VERSION}"
+# Image to build the lambda zip package
 DOCKER_IMAGE="python:${PY_VERSION}-slim"
 LAMBDA_NAME=$(basename "$WORKDIR")
+# Rename the_lambda_name directory to the-lambda-name lambda in AWS
 LAMBDA_NAME=${LAMBDA_NAME//_/-}
+# The name of directory with lambda code
 PACKAGE=lambda-package
 rm -rf "$PACKAGE" "$PACKAGE".zip
 mkdir "$PACKAGE"
@@ -28,4 +34,6 @@ if [ -f requirements.txt ]; then
 fi
 ( cd "$PACKAGE" && zip -9 -r ../"$PACKAGE".zip . )
 
-aws lambda update-function-code --function-name "$LAMBDA_NAME" --zip-file fileb://"$PACKAGE".zip
+if [ -z "$DRY_RUN" ]; then
+  aws lambda update-function-code --function-name "$LAMBDA_NAME" --zip-file fileb://"$PACKAGE".zip
+fi

From 7f08f218d9ee71ba52d011cabce2faea7492c5ca Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 22 May 2023 23:07:35 +0200
Subject: [PATCH 0239/1478] Create lambda_shared package for lambdas

---
 .github/workflows/pull_request.yml            |  5 ++
 tests/ci/autoscale_runners_lambda/app.py      | 77 +++----------------
 .../autoscale_runners_lambda_test.py          |  2 +-
 .../ci/autoscale_runners_lambda/lambda_shared |  1 +
 .../autoscale_runners_lambda/requirements.txt |  2 +-
 tests/ci/lambda_shared_package/.gitignore     |  2 +
 .../lambda_shared/__init__.py                 | 74 ++++++++++++++++++
 tests/ci/lambda_shared_package/pyproject.toml | 13 ++++
 tests/ci/lambda_shared_package/setup.cfg      |  8 ++
 .../build_and_deploy_archive.sh               | 11 +--
 10 files changed, 121 insertions(+), 74 deletions(-)
 rename tests/ci/{ => autoscale_runners_lambda}/autoscale_runners_lambda_test.py (98%)
 create mode 120000 tests/ci/autoscale_runners_lambda/lambda_shared
 create mode 100644 tests/ci/lambda_shared_package/.gitignore
 create mode 100644 tests/ci/lambda_shared_package/lambda_shared/__init__.py
 create mode 100644 tests/ci/lambda_shared_package/pyproject.toml
 create mode 100644 tests/ci/lambda_shared_package/setup.cfg

diff --git a/.github/workflows/pull_request.yml b/.github/workflows/pull_request.yml
index 506ed451b6d..afc08f3e637 100644
--- a/.github/workflows/pull_request.yml
+++ b/.github/workflows/pull_request.yml
@@ -46,7 +46,12 @@ jobs:
       - name: Python unit tests
         run: |
           cd "$GITHUB_WORKSPACE/tests/ci"
+          echo "Testing the main ci directory"
           python3 -m unittest discover -s . -p '*_test.py'
+          for dir in *_lambda/; do
+            echo "Testing $dir"
+            python3 -m unittest discover -s "$dir" -p '*_test.py'
+          done
   DockerHubPushAarch64:
     needs: CheckLabels
     runs-on: [self-hosted, style-checker-aarch64]
diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index 3fbab0d13dc..ab09afb3aa8 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -2,25 +2,19 @@
 
 """The lambda to decrease/increase ASG desired capacity based on current queue"""
 
-import json
 import logging
-import time
 from dataclasses import dataclass
 from pprint import pformat
 from typing import Any, List, Literal, Optional, Tuple
 
 import boto3  # type: ignore
-import requests  # type: ignore
 
-RUNNER_TYPE_LABELS = [
-    "builder",
-    "func-tester",
-    "func-tester-aarch64",
-    "fuzzer-unit-tester",
-    "stress-tester",
-    "style-checker",
-    "style-checker-aarch64",
-]
+from lambda_shared import (
+    CHException,
+    ClickHouseHelper,
+    RUNNER_TYPE_LABELS,
+    get_parameter_from_ssm,
+)
 
 ### Update comment on the change ###
 # 4 HOUR - is a balance to get the most precise values
@@ -74,61 +68,7 @@ def get_scales(runner_type: str) -> Tuple[int, int]:
     return scale_down, scale_up
 
 
-### VENDORING
-def get_parameter_from_ssm(name, decrypt=True, client=None):
-    if not client:
-        client = boto3.client("ssm", region_name="us-east-1")
-    return client.get_parameter(Name=name, WithDecryption=decrypt)["Parameter"]["Value"]
-
-
-class CHException(Exception):
-    pass
-
-
-class ClickHouseHelper:
-    def __init__(
-        self,
-        url: Optional[str] = None,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-    ):
-        self.url = url
-        self.auth = {}
-        if user:
-            self.auth["X-ClickHouse-User"] = user
-        if password:
-            self.auth["X-ClickHouse-Key"] = password
-
-    def _select_and_get_json_each_row(self, db, query):
-        params = {
-            "database": db,
-            "query": query,
-            "default_format": "JSONEachRow",
-        }
-        for i in range(5):
-            response = None
-            try:
-                response = requests.get(self.url, params=params, headers=self.auth)
-                response.raise_for_status()
-                return response.text
-            except Exception as ex:
-                logging.warning("Cannot fetch data with exception %s", str(ex))
-                if response:
-                    logging.warning("Reponse text %s", response.text)
-                time.sleep(0.1 * i)
-
-        raise CHException("Cannot fetch data from clickhouse")
-
-    def select_json_each_row(self, db, query):
-        text = self._select_and_get_json_each_row(db, query)
-        result = []
-        for line in text.split("\n"):
-            if line:
-                result.append(json.loads(line))
-        return result
-
-
-CH_CLIENT = ClickHouseHelper(get_parameter_from_ssm("clickhouse-test-stat-url"), "play")
+CH_CLIENT = None  # type: Optional[ClickHouseHelper]
 
 
 def set_capacity(
@@ -222,6 +162,9 @@ def main(dry_run: bool = True) -> None:
     asg_client = boto3.client("autoscaling")
     try:
         global CH_CLIENT
+        CH_CLIENT = CH_CLIENT or ClickHouseHelper(
+            get_parameter_from_ssm("clickhouse-test-stat-url"), "play"
+        )
         queues = CH_CLIENT.select_json_each_row("default", QUEUE_QUERY)
     except CHException as ex:
         logging.exception(
diff --git a/tests/ci/autoscale_runners_lambda_test.py b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
similarity index 98%
rename from tests/ci/autoscale_runners_lambda_test.py
rename to tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
index 8e3828f51c0..6772e33374c 100644
--- a/tests/ci/autoscale_runners_lambda_test.py
+++ b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
@@ -4,7 +4,7 @@ import unittest
 from dataclasses import dataclass
 from typing import Any, List
 
-from autoscale_runners_lambda.app import set_capacity, Queue
+from app import set_capacity, Queue
 
 
 @dataclass
diff --git a/tests/ci/autoscale_runners_lambda/lambda_shared b/tests/ci/autoscale_runners_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/autoscale_runners_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/autoscale_runners_lambda/requirements.txt b/tests/ci/autoscale_runners_lambda/requirements.txt
index 3bcbe2dfd07..098e04a9798 100644
--- a/tests/ci/autoscale_runners_lambda/requirements.txt
+++ b/tests/ci/autoscale_runners_lambda/requirements.txt
@@ -1 +1 @@
-requests<2.30
+../lambda_shared_package
diff --git a/tests/ci/lambda_shared_package/.gitignore b/tests/ci/lambda_shared_package/.gitignore
new file mode 100644
index 00000000000..59d52651e06
--- /dev/null
+++ b/tests/ci/lambda_shared_package/.gitignore
@@ -0,0 +1,2 @@
+build
+*.egg-info
diff --git a/tests/ci/lambda_shared_package/lambda_shared/__init__.py b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
new file mode 100644
index 00000000000..c5ae4df9e17
--- /dev/null
+++ b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
@@ -0,0 +1,74 @@
+"""The shared code and types for all our CI lambdas
+It exists as __init__.py and lambda_shared/__init__.py to work both in local and venv"""
+
+import json
+import logging
+import time
+from typing import List, Optional
+
+import boto3  # type: ignore
+import requests  # type: ignore
+
+RUNNER_TYPE_LABELS = [
+    "builder",
+    "func-tester",
+    "func-tester-aarch64",
+    "fuzzer-unit-tester",
+    "stress-tester",
+    "style-checker",
+    "style-checker-aarch64",
+]
+
+
+### VENDORING
+def get_parameter_from_ssm(name, decrypt=True, client=None):
+    if not client:
+        client = boto3.client("ssm", region_name="us-east-1")
+    return client.get_parameter(Name=name, WithDecryption=decrypt)["Parameter"]["Value"]
+
+
+class CHException(Exception):
+    pass
+
+
+class ClickHouseHelper:
+    def __init__(
+        self,
+        url: Optional[str] = None,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+    ):
+        self.url = url
+        self.auth = {}
+        if user:
+            self.auth["X-ClickHouse-User"] = user
+        if password:
+            self.auth["X-ClickHouse-Key"] = password
+
+    def _select_and_get_json_each_row(self, db: str, query: str) -> str:
+        params = {
+            "database": db,
+            "query": query,
+            "default_format": "JSONEachRow",
+        }
+        for i in range(5):
+            response = None
+            try:
+                response = requests.get(self.url, params=params, headers=self.auth)
+                response.raise_for_status()
+                return response.text  # type: ignore
+            except Exception as ex:
+                logging.warning("Cannot fetch data with exception %s", str(ex))
+                if response:
+                    logging.warning("Reponse text %s", response.text)
+                time.sleep(0.1 * i)
+
+        raise CHException("Cannot fetch data from clickhouse")
+
+    def select_json_each_row(self, db: str, query: str) -> List[dict]:  # type: ignore
+        text = self._select_and_get_json_each_row(db, query)
+        result = []
+        for line in text.split("\n"):
+            if line:
+                result.append(json.loads(line))
+        return result
diff --git a/tests/ci/lambda_shared_package/pyproject.toml b/tests/ci/lambda_shared_package/pyproject.toml
new file mode 100644
index 00000000000..8b4b0a80948
--- /dev/null
+++ b/tests/ci/lambda_shared_package/pyproject.toml
@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lambda_shared"
+version = "0.0.1"
+dependencies = [
+  "requests < 2.30",
+]
+
+[tool.distutils.bdist_wheel]
+universal = true
diff --git a/tests/ci/lambda_shared_package/setup.cfg b/tests/ci/lambda_shared_package/setup.cfg
new file mode 100644
index 00000000000..744280ae41b
--- /dev/null
+++ b/tests/ci/lambda_shared_package/setup.cfg
@@ -0,0 +1,8 @@
+### This file exists for clear builds in docker ###
+#   without it the `build` directory wouldn't be  #
+# updated on the fly and will require manual clean #
+[build]
+build_base = /tmp/lambda_shared
+
+[egg_info]
+egg_base = /tmp/
diff --git a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
index f35d6456cd3..89a2d514965 100644
--- a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
+++ b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
@@ -3,6 +3,7 @@ set -xeo pipefail
 
 WORKDIR=$(dirname "$0")
 WORKDIR=$(readlink -f "${WORKDIR}")
+DIR_NAME=$(basename "$WORKDIR")
 cd "$WORKDIR"
 
 # Do not deploy the lambda to AWS
@@ -12,9 +13,8 @@ PY_VERSION=${PY_VERSION:-3.10}
 PY_EXEC="python${PY_VERSION}"
 # Image to build the lambda zip package
 DOCKER_IMAGE="python:${PY_VERSION}-slim"
-LAMBDA_NAME=$(basename "$WORKDIR")
 # Rename the_lambda_name directory to the-lambda-name lambda in AWS
-LAMBDA_NAME=${LAMBDA_NAME//_/-}
+LAMBDA_NAME=${DIR_NAME//_/-}
 # The name of directory with lambda code
 PACKAGE=lambda-package
 rm -rf "$PACKAGE" "$PACKAGE".zip
@@ -23,8 +23,9 @@ cp app.py "$PACKAGE"
 if [ -f requirements.txt ]; then
   VENV=lambda-venv
   rm -rf "$VENV" lambda-package.zip
-  docker run --rm --user="${UID}" --volume="${WORKDIR}:/lambda" --workdir="/lambda" "${DOCKER_IMAGE}" \
-    /bin/bash -c "
+  docker run --rm --user="${UID}" -e HOME=/tmp \
+    --volume="${WORKDIR}/..:/ci" --workdir="/ci/${DIR_NAME}" "${DOCKER_IMAGE}" \
+    /bin/bash -exc "
       '$PY_EXEC' -m venv '$VENV' &&
       source '$VENV/bin/activate' &&
       pip install -r requirements.txt
@@ -35,5 +36,5 @@ fi
 ( cd "$PACKAGE" && zip -9 -r ../"$PACKAGE".zip . )
 
 if [ -z "$DRY_RUN" ]; then
-  aws lambda update-function-code --function-name "$LAMBDA_NAME" --zip-file fileb://"$PACKAGE".zip
+  aws lambda update-function-code --function-name "$LAMBDA_NAME" --zip-file fileb://"$WORKDIR/$PACKAGE".zip
 fi

From 0fa6a8416148a9f47f8d5c4e6a6bdb67992d2cd4 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 23 May 2023 12:55:23 +0200
Subject: [PATCH 0240/1478] Move the stuff related to runners to lambda_shared

---
 tests/ci/ci_runners_metrics_lambda/app.py     | 68 ++-----------------
 .../ci_runners_metrics_lambda/lambda_shared   |  1 +
 .../requirements.txt                          |  2 +-
 .../lambda_shared/__init__.py                 | 67 ++++++++++++++++--
 tests/ci/terminate_runner_lambda/app.py       | 55 +--------------
 .../ci/terminate_runner_lambda/lambda_shared  |  1 +
 .../terminate_runner_lambda/requirements.txt  |  2 +-
 7 files changed, 76 insertions(+), 120 deletions(-)
 create mode 120000 tests/ci/ci_runners_metrics_lambda/lambda_shared
 create mode 120000 tests/ci/terminate_runner_lambda/lambda_shared

diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index 341e1b674ec..a12143752a1 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -10,7 +10,6 @@ import argparse
 import sys
 import json
 import time
-from collections import namedtuple
 from datetime import datetime
 from typing import Dict, List, Tuple
 
@@ -19,21 +18,14 @@ import requests  # type: ignore
 import boto3  # type: ignore
 from botocore.exceptions import ClientError  # type: ignore
 
-UNIVERSAL_LABEL = "universal"
-RUNNER_TYPE_LABELS = [
-    "builder",
-    "func-tester",
-    "func-tester-aarch64",
-    "fuzzer-unit-tester",
-    "stress-tester",
-    "style-checker",
-    "style-checker-aarch64",
-]
-
-RunnerDescription = namedtuple(
-    "RunnerDescription", ["id", "name", "tags", "offline", "busy"]
+from lambda_shared import (
+    RUNNER_TYPE_LABELS,
+    RunnerDescription,
+    RunnerDescriptions,
+    list_runners,
 )
-RunnerDescriptions = List[RunnerDescription]
+
+UNIVERSAL_LABEL = "universal"
 
 
 def get_dead_runners_in_ec2(runners: RunnerDescriptions) -> RunnerDescriptions:
@@ -193,52 +185,6 @@ def get_access_token(jwt_token: str, installation_id: int) -> str:
     return data["token"]  # type: ignore
 
 
-def list_runners(access_token: str) -> RunnerDescriptions:
-    headers = {
-        "Authorization": f"token {access_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    per_page = 100
-    response = requests.get(
-        f"https://api.github.com/orgs/ClickHouse/actions/runners?per_page={per_page}",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    total_runners = data["total_count"]
-    print("Expected total runners", total_runners)
-    runners = data["runners"]
-
-    # round to 0 for 0, 1 for 1..100, but to 2 for 101..200
-    total_pages = (total_runners - 1) // per_page + 1
-
-    print("Total pages", total_pages)
-    for i in range(2, total_pages + 1):
-        response = requests.get(
-            "https://api.github.com/orgs/ClickHouse/actions/runners"
-            f"?page={i}&per_page={per_page}",
-            headers=headers,
-        )
-        response.raise_for_status()
-        data = response.json()
-        runners += data["runners"]
-
-    print("Total runners", len(runners))
-    result = []
-    for runner in runners:
-        tags = [tag["name"] for tag in runner["labels"]]
-        desc = RunnerDescription(
-            id=runner["id"],
-            name=runner["name"],
-            tags=tags,
-            offline=runner["status"] == "offline",
-            busy=runner["busy"],
-        )
-        result.append(desc)
-
-    return result
-
-
 def group_runners_by_tag(
     listed_runners: RunnerDescriptions,
 ) -> Dict[str, RunnerDescriptions]:
diff --git a/tests/ci/ci_runners_metrics_lambda/lambda_shared b/tests/ci/ci_runners_metrics_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/ci_runners_metrics_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/ci_runners_metrics_lambda/requirements.txt b/tests/ci/ci_runners_metrics_lambda/requirements.txt
index 98be09ab232..e99dee1743c 100644
--- a/tests/ci/ci_runners_metrics_lambda/requirements.txt
+++ b/tests/ci/ci_runners_metrics_lambda/requirements.txt
@@ -1,3 +1,3 @@
-requests<2.30
+../lambda_shared_package
 PyJWT
 cryptography<38
diff --git a/tests/ci/lambda_shared_package/lambda_shared/__init__.py b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
index c5ae4df9e17..fe52f98d5f6 100644
--- a/tests/ci/lambda_shared_package/lambda_shared/__init__.py
+++ b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
@@ -4,7 +4,8 @@ It exists as __init__.py and lambda_shared/__init__.py to work both in local and
 import json
 import logging
 import time
-from typing import List, Optional
+from collections import namedtuple
+from typing import Any, List, Optional
 
 import boto3  # type: ignore
 import requests  # type: ignore
@@ -21,10 +22,14 @@ RUNNER_TYPE_LABELS = [
 
 
 ### VENDORING
-def get_parameter_from_ssm(name, decrypt=True, client=None):
+def get_parameter_from_ssm(
+    name: str, decrypt: bool = True, client: Optional[Any] = None
+) -> str:
     if not client:
         client = boto3.client("ssm", region_name="us-east-1")
-    return client.get_parameter(Name=name, WithDecryption=decrypt)["Parameter"]["Value"]
+    return client.get_parameter(Name=name, WithDecryption=decrypt)[  # type: ignore
+        "Parameter"
+    ]["Value"]
 
 
 class CHException(Exception):
@@ -65,10 +70,64 @@ class ClickHouseHelper:
 
         raise CHException("Cannot fetch data from clickhouse")
 
-    def select_json_each_row(self, db: str, query: str) -> List[dict]:  # type: ignore
+    def select_json_each_row(self, db: str, query: str) -> List[dict]:
         text = self._select_and_get_json_each_row(db, query)
         result = []
         for line in text.split("\n"):
             if line:
                 result.append(json.loads(line))
         return result
+
+
+### Runners
+
+RunnerDescription = namedtuple(
+    "RunnerDescription", ["id", "name", "tags", "offline", "busy"]
+)
+RunnerDescriptions = List[RunnerDescription]
+
+
+def list_runners(access_token: str) -> RunnerDescriptions:
+    headers = {
+        "Authorization": f"token {access_token}",
+        "Accept": "application/vnd.github.v3+json",
+    }
+    per_page = 100
+    response = requests.get(
+        f"https://api.github.com/orgs/ClickHouse/actions/runners?per_page={per_page}",
+        headers=headers,
+    )
+    response.raise_for_status()
+    data = response.json()
+    total_runners = data["total_count"]
+    print("Expected total runners", total_runners)
+    runners = data["runners"]
+
+    # round to 0 for 0, 1 for 1..100, but to 2 for 101..200
+    total_pages = (total_runners - 1) // per_page + 1
+
+    print("Total pages", total_pages)
+    for i in range(2, total_pages + 1):
+        response = requests.get(
+            "https://api.github.com/orgs/ClickHouse/actions/runners"
+            f"?page={i}&per_page={per_page}",
+            headers=headers,
+        )
+        response.raise_for_status()
+        data = response.json()
+        runners += data["runners"]
+
+    print("Total runners", len(runners))
+    result = []
+    for runner in runners:
+        tags = [tag["name"] for tag in runner["labels"]]
+        desc = RunnerDescription(
+            id=runner["id"],
+            name=runner["name"],
+            tags=tags,
+            offline=runner["status"] == "offline",
+            busy=runner["busy"],
+        )
+        result.append(desc)
+
+    return result
diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index e0164bc58c0..5799a498d5a 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -4,7 +4,6 @@ import argparse
 import json
 import sys
 import time
-from collections import namedtuple
 from dataclasses import dataclass
 from typing import Any, Dict, List, Tuple
 
@@ -12,6 +11,8 @@ import boto3  # type: ignore
 import requests  # type: ignore
 import jwt
 
+from lambda_shared import RunnerDescriptions, list_runners
+
 
 def get_key_and_app_from_aws() -> Tuple[str, int]:
     secret_name = "clickhouse_github_secret_key"
@@ -118,58 +119,6 @@ def get_cached_instances() -> dict:
     return cached_instances.value
 
 
-RunnerDescription = namedtuple(
-    "RunnerDescription", ["id", "name", "tags", "offline", "busy"]
-)
-RunnerDescriptions = List[RunnerDescription]
-
-
-def list_runners(access_token: str) -> RunnerDescriptions:
-    headers = {
-        "Authorization": f"token {access_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    per_page = 100
-    response = requests.get(
-        f"https://api.github.com/orgs/ClickHouse/actions/runners?per_page={per_page}",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    total_runners = data["total_count"]
-    print("Expected total runners", total_runners)
-    runners = data["runners"]
-
-    # round to 0 for 0, 1 for 1..100, but to 2 for 101..200
-    total_pages = (total_runners - 1) // per_page + 1
-
-    print("Total pages", total_pages)
-    for i in range(2, total_pages + 1):
-        response = requests.get(
-            "https://api.github.com/orgs/ClickHouse/actions/runners"
-            f"?page={i}&per_page={per_page}",
-            headers=headers,
-        )
-        response.raise_for_status()
-        data = response.json()
-        runners += data["runners"]
-
-    print("Total runners", len(runners))
-    result = []
-    for runner in runners:
-        tags = [tag["name"] for tag in runner["labels"]]
-        desc = RunnerDescription(
-            id=runner["id"],
-            name=runner["name"],
-            tags=tags,
-            offline=runner["status"] == "offline",
-            busy=runner["busy"],
-        )
-        result.append(desc)
-
-    return result
-
-
 def how_many_instances_to_kill(event_data: dict) -> Dict[str, int]:
     data_array = event_data["CapacityToTerminate"]
     to_kill_by_zone = {}  # type: Dict[str, int]
diff --git a/tests/ci/terminate_runner_lambda/lambda_shared b/tests/ci/terminate_runner_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/terminate_runner_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/terminate_runner_lambda/requirements.txt b/tests/ci/terminate_runner_lambda/requirements.txt
index 98be09ab232..e99dee1743c 100644
--- a/tests/ci/terminate_runner_lambda/requirements.txt
+++ b/tests/ci/terminate_runner_lambda/requirements.txt
@@ -1,3 +1,3 @@
-requests<2.30
+../lambda_shared_package
 PyJWT
 cryptography<38

From acb9531ebf829a5c11bbeff6661e8d2122334ee6 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 23 May 2023 18:47:19 +0200
Subject: [PATCH 0241/1478] Unify and put GH access token to the lambda_shared

---
 .../cancel_and_rerun_workflow_lambda/app.py   | 176 +----------------
 .../lambda_shared                             |   1 +
 .../requirements.txt                          |   4 +-
 tests/ci/ci_runners_metrics_lambda/app.py     |  70 ++-----
 .../requirements.txt                          |   3 +-
 tests/ci/lambda_shared_package/__init__.py    |   0
 .../lambda_shared_package/lambda_shared/pr.py | 184 ++++++++++++++++++
 .../lambda_shared/token.py                    |  90 +++++++++
 tests/ci/lambda_shared_package/pyproject.toml |  10 +
 tests/ci/run_check.py                         |   8 +-
 tests/ci/runner_token_rotation_lambda/app.py  |  61 +-----
 .../lambda_shared                             |   1 +
 .../requirements.txt                          |   4 +-
 tests/ci/team_keys_lambda/app.py              |   4 +-
 tests/ci/team_keys_lambda/lambda_shared       |   1 +
 tests/ci/team_keys_lambda/requirements.txt    |   2 +-
 tests/ci/terminate_runner_lambda/app.py       |  92 +--------
 .../terminate_runner_lambda/requirements.txt  |   4 +-
 tests/ci/workflow_approve_rerun_lambda/app.py | 122 +-----------
 .../lambda_shared                             |   1 +
 .../requirements.txt                          |   4 +-
 tests/ci/workflow_jobs_lambda/lambda_shared   |   1 +
 22 files changed, 332 insertions(+), 511 deletions(-)
 create mode 120000 tests/ci/cancel_and_rerun_workflow_lambda/lambda_shared
 create mode 100644 tests/ci/lambda_shared_package/__init__.py
 create mode 100644 tests/ci/lambda_shared_package/lambda_shared/pr.py
 create mode 100644 tests/ci/lambda_shared_package/lambda_shared/token.py
 create mode 120000 tests/ci/runner_token_rotation_lambda/lambda_shared
 create mode 120000 tests/ci/team_keys_lambda/lambda_shared
 create mode 120000 tests/ci/workflow_approve_rerun_lambda/lambda_shared
 create mode 120000 tests/ci/workflow_jobs_lambda/lambda_shared

diff --git a/tests/ci/cancel_and_rerun_workflow_lambda/app.py b/tests/ci/cancel_and_rerun_workflow_lambda/app.py
index 54c87fbcfa5..250655ddeb2 100644
--- a/tests/ci/cancel_and_rerun_workflow_lambda/app.py
+++ b/tests/ci/cancel_and_rerun_workflow_lambda/app.py
@@ -9,9 +9,10 @@ import json
 import re
 import time
 
-import jwt
 import requests  # type: ignore
-import boto3  # type: ignore
+
+from lambda_shared.pr import CATEGORY_TO_LABEL, check_pr_description
+from lambda_shared.token import get_cached_access_token
 
 
 NEED_RERUN_ON_EDITED = {
@@ -27,123 +28,6 @@ MAX_RETRY = 5
 
 DEBUG_INFO = {}  # type: Dict[str, Any]
 
-# Descriptions are used in .github/PULL_REQUEST_TEMPLATE.md, keep comments there
-# updated accordingly
-# The following lists are append only, try to avoid editing them
-# They still could be cleaned out after the decent time though.
-LABELS = {
-    "pr-backward-incompatible": ["Backward Incompatible Change"],
-    "pr-bugfix": [
-        "Bug Fix",
-        "Bug Fix (user-visible misbehavior in an official stable release)",
-        "Bug Fix (user-visible misbehaviour in official stable or prestable release)",
-        "Bug Fix (user-visible misbehavior in official stable or prestable release)",
-    ],
-    "pr-build": [
-        "Build/Testing/Packaging Improvement",
-        "Build Improvement",
-        "Build/Testing Improvement",
-        "Build",
-        "Packaging Improvement",
-    ],
-    "pr-documentation": [
-        "Documentation (changelog entry is not required)",
-        "Documentation",
-    ],
-    "pr-feature": ["New Feature"],
-    "pr-improvement": ["Improvement"],
-    "pr-not-for-changelog": [
-        "Not for changelog (changelog entry is not required)",
-        "Not for changelog",
-    ],
-    "pr-performance": ["Performance Improvement"],
-}
-
-CATEGORY_TO_LABEL = {c: lb for lb, categories in LABELS.items() for c in categories}
-
-
-def check_pr_description(pr_body: str) -> Tuple[str, str]:
-    """The function checks the body to being properly formatted according to
-    .github/PULL_REQUEST_TEMPLATE.md, if the first returned string is not empty,
-    then there is an error."""
-    lines = list(map(lambda x: x.strip(), pr_body.split("\n") if pr_body else []))
-    lines = [re.sub(r"\s+", " ", line) for line in lines]
-
-    # Check if body contains "Reverts ClickHouse/ClickHouse#36337"
-    if [
-        True
-        for line in lines
-        if re.match(r"\AReverts {GITHUB_REPOSITORY}#[\d]+\Z", line)
-    ]:
-        return "", LABELS["pr-not-for-changelog"][0]
-
-    category = ""
-    entry = ""
-    description_error = ""
-
-    i = 0
-    while i < len(lines):
-        if re.match(r"(?i)^[#>*_ ]*change\s*log\s*category", lines[i]):
-            i += 1
-            if i >= len(lines):
-                break
-            # Can have one empty line between header and the category
-            # itself. Filter it out.
-            if not lines[i]:
-                i += 1
-                if i >= len(lines):
-                    break
-            category = re.sub(r"^[-*\s]*", "", lines[i])
-            i += 1
-
-            # Should not have more than one category. Require empty line
-            # after the first found category.
-            if i >= len(lines):
-                break
-            if lines[i]:
-                second_category = re.sub(r"^[-*\s]*", "", lines[i])
-                description_error = (
-                    "More than one changelog category specified: "
-                    f"'{category}', '{second_category}'"
-                )
-                return description_error, category
-
-        elif re.match(
-            r"(?i)^[#>*_ ]*(short\s*description|change\s*log\s*entry)", lines[i]
-        ):
-            i += 1
-            # Can have one empty line between header and the entry itself.
-            # Filter it out.
-            if i < len(lines) and not lines[i]:
-                i += 1
-            # All following lines until empty one are the changelog entry.
-            entry_lines = []
-            while i < len(lines) and lines[i]:
-                entry_lines.append(lines[i])
-                i += 1
-            entry = " ".join(entry_lines)
-            # Don't accept changelog entries like '...'.
-            entry = re.sub(r"[#>*_.\- ]", "", entry)
-            # Don't accept changelog entries like 'Close #12345'.
-            entry = re.sub(r"^[\w\-\s]{0,10}#?\d{5,6}\.?$", "", entry)
-        else:
-            i += 1
-
-    if not category:
-        description_error = "Changelog category is empty"
-    # Filter out the PR categories that are not for changelog.
-    elif re.match(
-        r"(?i)doc|((non|in|not|un)[-\s]*significant)|(not[ ]*for[ ]*changelog)",
-        category,
-    ):
-        pass  # to not check the rest of the conditions
-    elif category not in CATEGORY_TO_LABEL:
-        description_error, category = f"Category '{category}' is not valid", ""
-    elif not entry:
-        description_error = f"Changelog entry required for category '{category}'"
-
-    return description_error, category
-
 
 class Worker(Thread):
     def __init__(
@@ -166,58 +50,6 @@ class Worker(Thread):
         self.queue.task_done()
 
 
-def get_installation_id(jwt_token):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.get("https://api.github.com/app/installations", headers=headers)
-    response.raise_for_status()
-    data = response.json()
-    for installation in data:
-        if installation["account"]["login"] == "ClickHouse":
-            installation_id = installation["id"]
-    return installation_id
-
-
-def get_access_token(jwt_token, installation_id):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.post(
-        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    return data["token"]
-
-
-def get_key_and_app_from_aws():
-    secret_name = "clickhouse_github_secret_key"
-    session = boto3.session.Session()
-    client = session.client(
-        service_name="secretsmanager",
-    )
-    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
-    data = json.loads(get_secret_value_response["SecretString"])
-    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
-
-
-def get_token_from_aws():
-    private_key, app_id = get_key_and_app_from_aws()
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, private_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    return get_access_token(encoded_jwt, installation_id)
-
-
 def _exec_get_with_retry(url: str, token: str) -> dict:
     headers = {"Authorization": f"token {token}"}
     for i in range(MAX_RETRY):
@@ -407,7 +239,7 @@ def exec_workflow_url(urls_to_post, token):
 
 
 def main(event):
-    token = get_token_from_aws()
+    token = get_cached_access_token()
     DEBUG_INFO["event"] = event
     if event["isBase64Encoded"]:
         event_data = json.loads(b64decode(event["body"]))
diff --git a/tests/ci/cancel_and_rerun_workflow_lambda/lambda_shared b/tests/ci/cancel_and_rerun_workflow_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/cancel_and_rerun_workflow_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/cancel_and_rerun_workflow_lambda/requirements.txt b/tests/ci/cancel_and_rerun_workflow_lambda/requirements.txt
index 98be09ab232..4cb3fba0f7b 100644
--- a/tests/ci/cancel_and_rerun_workflow_lambda/requirements.txt
+++ b/tests/ci/cancel_and_rerun_workflow_lambda/requirements.txt
@@ -1,3 +1 @@
-requests<2.30
-PyJWT
-cryptography<38
+../lambda_shared_package[token]
diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index a12143752a1..dc128dea739 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -8,12 +8,9 @@ Lambda function to:
 
 import argparse
 import sys
-import json
-import time
 from datetime import datetime
-from typing import Dict, List, Tuple
+from typing import Dict, List
 
-import jwt
 import requests  # type: ignore
 import boto3  # type: ignore
 from botocore.exceptions import ClientError  # type: ignore
@@ -24,6 +21,11 @@ from lambda_shared import (
     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"
 
@@ -139,50 +141,8 @@ def get_lost_ec2_instances(runners: RunnerDescriptions) -> List[dict]:
     return lost_instances
 
 
-def get_key_and_app_from_aws() -> Tuple[str, int]:
-    secret_name = "clickhouse_github_secret_key"
-    session = boto3.session.Session()
-    client = session.client(
-        service_name="secretsmanager",
-    )
-    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
-    data = json.loads(get_secret_value_response["SecretString"])
-    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
-
-
 def handler(event, context):
-    private_key, app_id = get_key_and_app_from_aws()
-    main(private_key, app_id, True, True)
-
-
-def get_installation_id(jwt_token: str) -> int:
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.get("https://api.github.com/app/installations", headers=headers)
-    response.raise_for_status()
-    data = response.json()
-    for installation in data:
-        if installation["account"]["login"] == "ClickHouse":
-            installation_id = installation["id"]
-            break
-
-    return installation_id  # type: ignore
-
-
-def get_access_token(jwt_token: str, installation_id: int) -> str:
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.post(
-        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    return data["token"]  # type: ignore
+    main(get_cached_access_token(), True, True)
 
 
 def group_runners_by_tag(
@@ -273,20 +233,10 @@ def delete_runner(access_token: str, runner: RunnerDescription) -> bool:
 
 
 def main(
-    github_secret_key: str,
-    github_app_id: int,
+    access_token: str,
     push_to_cloudwatch: bool,
     delete_offline_runners: bool,
 ) -> None:
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": github_app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, github_secret_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    access_token = get_access_token(encoded_jwt, installation_id)
     gh_runners = list_runners(access_token)
     grouped_runners = group_runners_by_tag(gh_runners)
     for group, group_runners in grouped_runners.items():
@@ -354,4 +304,6 @@ if __name__ == "__main__":
         print("Attempt to get key and id from AWS secret manager")
         private_key, args.app_id = get_key_and_app_from_aws()
 
-    main(private_key, args.app_id, args.push_to_cloudwatch, args.delete_offline)
+    token = get_access_token_by_key_app(private_key, args.app_id)
+
+    main(token, args.push_to_cloudwatch, args.delete_offline)
diff --git a/tests/ci/ci_runners_metrics_lambda/requirements.txt b/tests/ci/ci_runners_metrics_lambda/requirements.txt
index e99dee1743c..e2b16067a93 100644
--- a/tests/ci/ci_runners_metrics_lambda/requirements.txt
+++ b/tests/ci/ci_runners_metrics_lambda/requirements.txt
@@ -1,3 +1,2 @@
 ../lambda_shared_package
-PyJWT
-cryptography<38
+../lambda_shared_package[token]
diff --git a/tests/ci/lambda_shared_package/__init__.py b/tests/ci/lambda_shared_package/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/ci/lambda_shared_package/lambda_shared/pr.py b/tests/ci/lambda_shared_package/lambda_shared/pr.py
new file mode 100644
index 00000000000..ef47eacc082
--- /dev/null
+++ b/tests/ci/lambda_shared_package/lambda_shared/pr.py
@@ -0,0 +1,184 @@
+#!/usr/bin/env python
+
+import re
+from typing import Tuple
+
+# Individual trusted contirbutors who are not in any trusted organization.
+# Can be changed in runtime: we will append users that we learned to be in
+# a trusted org, to save GitHub API calls.
+TRUSTED_CONTRIBUTORS = {
+    e.lower()
+    for e in [
+        "achimbab",
+        "adevyatova ",  # DOCSUP
+        "Algunenano",  # Raúl Marín, Tinybird
+        "amosbird",
+        "AnaUvarova",  # DOCSUP
+        "anauvarova",  # technical writer, Yandex
+        "annvsh",  # technical writer, Yandex
+        "atereh",  # DOCSUP
+        "azat",
+        "bharatnc",  # Newbie, but already with many contributions.
+        "bobrik",  # Seasoned contributor, CloudFlare
+        "BohuTANG",
+        "codyrobert",  # Flickerbox engineer
+        "cwurm",  # Employee
+        "damozhaeva",  # DOCSUP
+        "den-crane",
+        "flickerbox-tom",  # Flickerbox
+        "gyuton",  # DOCSUP
+        "hagen1778",  # Roman Khavronenko, seasoned contributor
+        "hczhcz",
+        "hexiaoting",  # Seasoned contributor
+        "ildus",  # adjust, ex-pgpro
+        "javisantana",  # a Spanish ClickHouse enthusiast, ex-Carto
+        "ka1bi4",  # DOCSUP
+        "kirillikoff",  # DOCSUP
+        "kreuzerkrieg",
+        "lehasm",  # DOCSUP
+        "michon470",  # DOCSUP
+        "nikvas0",
+        "nvartolomei",
+        "olgarev",  # DOCSUP
+        "otrazhenia",  # Yandex docs contractor
+        "pdv-ru",  # DOCSUP
+        "podshumok",  # cmake expert from QRator Labs
+        "s-mx",  # Maxim Sabyanin, former employee, present contributor
+        "sevirov",  # technical writer, Yandex
+        "spongedu",  # Seasoned contributor
+        "taiyang-li",
+        "ucasFL",  # Amos Bird's friend
+        "vdimir",  # Employee
+        "vzakaznikov",
+        "YiuRULE",
+        "zlobober",  # Developer of YT
+        "ilejn",  # Arenadata, responsible for Kerberized Kafka
+        "thomoco",  # ClickHouse
+        "BoloniniD",  # Seasoned contributor, HSE
+        "tonickkozlov",  # Cloudflare
+        "tylerhannan",  # ClickHouse Employee
+        "myrrc",  # Mike Kot, DoubleCloud
+        "thevar1able",  # ClickHouse Employee
+        "aalexfvk",
+        "MikhailBurdukov",
+        "tsolodov",  # ClickHouse Employee
+        "kitaisreal",
+    ]
+}
+
+# Descriptions are used in .github/PULL_REQUEST_TEMPLATE.md, keep comments there
+# updated accordingly
+# The following lists are append only, try to avoid editing them
+# They still could be cleaned out after the decent time though.
+LABELS = {
+    "pr-backward-incompatible": ["Backward Incompatible Change"],
+    "pr-bugfix": [
+        "Bug Fix",
+        "Bug Fix (user-visible misbehavior in an official stable release)",
+        "Bug Fix (user-visible misbehaviour in official stable or prestable release)",
+        "Bug Fix (user-visible misbehavior in official stable or prestable release)",
+    ],
+    "pr-build": [
+        "Build/Testing/Packaging Improvement",
+        "Build Improvement",
+        "Build/Testing Improvement",
+        "Build",
+        "Packaging Improvement",
+    ],
+    "pr-documentation": [
+        "Documentation (changelog entry is not required)",
+        "Documentation",
+    ],
+    "pr-feature": ["New Feature"],
+    "pr-improvement": ["Improvement"],
+    "pr-not-for-changelog": [
+        "Not for changelog (changelog entry is not required)",
+        "Not for changelog",
+    ],
+    "pr-performance": ["Performance Improvement"],
+}
+
+CATEGORY_TO_LABEL = {c: lb for lb, categories in LABELS.items() for c in categories}
+
+
+def check_pr_description(pr_body: str) -> Tuple[str, str]:
+    """The function checks the body to being properly formatted according to
+    .github/PULL_REQUEST_TEMPLATE.md, if the first returned string is not empty,
+    then there is an error."""
+    lines = list(map(lambda x: x.strip(), pr_body.split("\n") if pr_body else []))
+    lines = [re.sub(r"\s+", " ", line) for line in lines]
+
+    # Check if body contains "Reverts ClickHouse/ClickHouse#36337"
+    if [
+        True
+        for line in lines
+        if re.match(r"\AReverts {GITHUB_REPOSITORY}#[\d]+\Z", line)
+    ]:
+        return "", LABELS["pr-not-for-changelog"][0]
+
+    category = ""
+    entry = ""
+    description_error = ""
+
+    i = 0
+    while i < len(lines):
+        if re.match(r"(?i)^[#>*_ ]*change\s*log\s*category", lines[i]):
+            i += 1
+            if i >= len(lines):
+                break
+            # Can have one empty line between header and the category
+            # itself. Filter it out.
+            if not lines[i]:
+                i += 1
+                if i >= len(lines):
+                    break
+            category = re.sub(r"^[-*\s]*", "", lines[i])
+            i += 1
+
+            # Should not have more than one category. Require empty line
+            # after the first found category.
+            if i >= len(lines):
+                break
+            if lines[i]:
+                second_category = re.sub(r"^[-*\s]*", "", lines[i])
+                description_error = (
+                    "More than one changelog category specified: "
+                    f"'{category}', '{second_category}'"
+                )
+                return description_error, category
+
+        elif re.match(
+            r"(?i)^[#>*_ ]*(short\s*description|change\s*log\s*entry)", lines[i]
+        ):
+            i += 1
+            # Can have one empty line between header and the entry itself.
+            # Filter it out.
+            if i < len(lines) and not lines[i]:
+                i += 1
+            # All following lines until empty one are the changelog entry.
+            entry_lines = []
+            while i < len(lines) and lines[i]:
+                entry_lines.append(lines[i])
+                i += 1
+            entry = " ".join(entry_lines)
+            # Don't accept changelog entries like '...'.
+            entry = re.sub(r"[#>*_.\- ]", "", entry)
+            # Don't accept changelog entries like 'Close #12345'.
+            entry = re.sub(r"^[\w\-\s]{0,10}#?\d{5,6}\.?$", "", entry)
+        else:
+            i += 1
+
+    if not category:
+        description_error = "Changelog category is empty"
+    # Filter out the PR categories that are not for changelog.
+    elif re.match(
+        r"(?i)doc|((non|in|not|un)[-\s]*significant)|(not[ ]*for[ ]*changelog)",
+        category,
+    ):
+        pass  # to not check the rest of the conditions
+    elif category not in CATEGORY_TO_LABEL:
+        description_error, category = f"Category '{category}' is not valid", ""
+    elif not entry:
+        description_error = f"Changelog entry required for category '{category}'"
+
+    return description_error, category
diff --git a/tests/ci/lambda_shared_package/lambda_shared/token.py b/tests/ci/lambda_shared_package/lambda_shared/token.py
new file mode 100644
index 00000000000..174ea4625a3
--- /dev/null
+++ b/tests/ci/lambda_shared_package/lambda_shared/token.py
@@ -0,0 +1,90 @@
+"""Module to get the token for GitHub"""
+from dataclasses import dataclass
+import json
+import time
+from typing import Tuple
+
+import boto3  # type: ignore
+import jwt
+import requests  # type: ignore
+
+
+def get_key_and_app_from_aws() -> Tuple[str, int]:
+    secret_name = "clickhouse_github_secret_key"
+    session = boto3.session.Session()
+    client = session.client(
+        service_name="secretsmanager",
+    )
+    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
+    data = json.loads(get_secret_value_response["SecretString"])
+    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
+
+
+def get_installation_id(jwt_token: str) -> int:
+    headers = {
+        "Authorization": f"Bearer {jwt_token}",
+        "Accept": "application/vnd.github.v3+json",
+    }
+    response = requests.get("https://api.github.com/app/installations", headers=headers)
+    response.raise_for_status()
+    data = response.json()
+    for installation in data:
+        if installation["account"]["login"] == "ClickHouse":
+            installation_id = installation["id"]
+
+    return installation_id  # type: ignore
+
+
+def get_access_token_by_jwt(jwt_token: str, installation_id: int) -> str:
+    headers = {
+        "Authorization": f"Bearer {jwt_token}",
+        "Accept": "application/vnd.github.v3+json",
+    }
+    response = requests.post(
+        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
+        headers=headers,
+    )
+    response.raise_for_status()
+    data = response.json()
+    return data["token"]  # type: ignore
+
+
+def get_token_from_aws() -> str:
+    private_key, app_id = get_key_and_app_from_aws()
+    return get_access_token_by_key_app(private_key, app_id)
+
+
+def get_access_token_by_key_app(private_key: str, app_id: int) -> str:
+    payload = {
+        "iat": int(time.time()) - 60,
+        "exp": int(time.time()) + (10 * 60),
+        "iss": app_id,
+    }
+
+    encoded_jwt = jwt.encode(payload, private_key, algorithm="RS256")
+    installation_id = get_installation_id(encoded_jwt)
+    return get_access_token_by_jwt(encoded_jwt, installation_id)
+
+
+@dataclass
+class CachedToken:
+    time: int
+    value: str
+    updating: bool = False
+
+
+_cached_token = CachedToken(0, "")
+
+
+def get_cached_access_token() -> str:
+    if time.time() - 550 < _cached_token.time or _cached_token.updating:
+        return _cached_token.value
+    # Indicate that the value is updating now, so the cached value can be
+    # 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
+    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)
+    _cached_token.updating = False
+    return _cached_token.value
diff --git a/tests/ci/lambda_shared_package/pyproject.toml b/tests/ci/lambda_shared_package/pyproject.toml
index 8b4b0a80948..bbf74cc0649 100644
--- a/tests/ci/lambda_shared_package/pyproject.toml
+++ b/tests/ci/lambda_shared_package/pyproject.toml
@@ -9,5 +9,15 @@ dependencies = [
   "requests < 2.30",
 ]
 
+[project.optional-dependencies]
+token = [
+  "PyJWT",
+  "cryptography<38",
+]
+dev = [
+  "boto3",
+  "lambda_shared[token]",
+]
+
 [tool.distutils.bdist_wheel]
 universal = true
diff --git a/tests/ci/run_check.py b/tests/ci/run_check.py
index 9849f19a1e4..330a1309016 100644
--- a/tests/ci/run_check.py
+++ b/tests/ci/run_check.py
@@ -20,9 +20,11 @@ from docs_check import NAME as DOCS_NAME
 from env_helper import GITHUB_REPOSITORY, GITHUB_SERVER_URL
 from get_robot_token import get_best_robot_token
 from pr_info import FORCE_TESTS_LABEL, PRInfo
-
-from cancel_and_rerun_workflow_lambda.app import CATEGORY_TO_LABEL, check_pr_description
-from workflow_approve_rerun_lambda.app import TRUSTED_CONTRIBUTORS
+from lambda_shared_package.lambda_shared.pr import (
+    CATEGORY_TO_LABEL,
+    TRUSTED_CONTRIBUTORS,
+    check_pr_description,
+)
 
 TRUSTED_ORG_IDS = {
     54801242,  # clickhouse
diff --git a/tests/ci/runner_token_rotation_lambda/app.py b/tests/ci/runner_token_rotation_lambda/app.py
index 70ee5da01f4..6544eee9581 100644
--- a/tests/ci/runner_token_rotation_lambda/app.py
+++ b/tests/ci/runner_token_rotation_lambda/app.py
@@ -2,40 +2,11 @@
 
 import argparse
 import sys
-import json
-import time
 
 import boto3  # type: ignore
-import jwt
 import requests  # type: ignore
 
-
-def get_installation_id(jwt_token):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.get("https://api.github.com/app/installations", headers=headers)
-    response.raise_for_status()
-    data = response.json()
-    for installation in data:
-        if installation["account"]["login"] == "ClickHouse":
-            installation_id = installation["id"]
-    return installation_id
-
-
-def get_access_token(jwt_token, installation_id):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.post(
-        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    return data["token"]
+from lambda_shared.token import get_cached_access_token, get_access_token_by_key_app
 
 
 def get_runner_registration_token(access_token):
@@ -52,32 +23,10 @@ def get_runner_registration_token(access_token):
     return data["token"]
 
 
-def get_key_and_app_from_aws():
-    secret_name = "clickhouse_github_secret_key"
-    session = boto3.session.Session()
-    client = session.client(
-        service_name="secretsmanager",
-    )
-    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
-    data = json.loads(get_secret_value_response["SecretString"])
-    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
-
-
-def main(github_secret_key, github_app_id, push_to_ssm, ssm_parameter_name):
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": github_app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, github_secret_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    access_token = get_access_token(encoded_jwt, installation_id)
+def main(access_token, push_to_ssm, ssm_parameter_name):
     runner_registration_token = get_runner_registration_token(access_token)
 
     if push_to_ssm:
-        import boto3
-
         print("Trying to put params into ssm manager")
         client = boto3.client("ssm")
         client.put_parameter(
@@ -94,8 +43,7 @@ def main(github_secret_key, github_app_id, push_to_ssm, ssm_parameter_name):
 
 
 def handler(event, context):
-    private_key, app_id = get_key_and_app_from_aws()
-    main(private_key, app_id, True, "github_runner_registration_token")
+    main(get_cached_access_token(), True, "github_runner_registration_token")
 
 
 if __name__ == "__main__":
@@ -140,4 +88,5 @@ if __name__ == "__main__":
         with open(args.private_key_path, "r") as key_file:
             private_key = key_file.read()
 
-    main(private_key, args.app_id, args.push_to_ssm, args.ssm_parameter_name)
+    token = get_access_token_by_key_app(private_key, args.app_id)
+    main(token, args.push_to_ssm, args.ssm_parameter_name)
diff --git a/tests/ci/runner_token_rotation_lambda/lambda_shared b/tests/ci/runner_token_rotation_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/runner_token_rotation_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/runner_token_rotation_lambda/requirements.txt b/tests/ci/runner_token_rotation_lambda/requirements.txt
index 98be09ab232..4cb3fba0f7b 100644
--- a/tests/ci/runner_token_rotation_lambda/requirements.txt
+++ b/tests/ci/runner_token_rotation_lambda/requirements.txt
@@ -1,3 +1 @@
-requests<2.30
-PyJWT
-cryptography<38
+../lambda_shared_package[token]
diff --git a/tests/ci/team_keys_lambda/app.py b/tests/ci/team_keys_lambda/app.py
index 870d41c441e..f562fbe101d 100644
--- a/tests/ci/team_keys_lambda/app.py
+++ b/tests/ci/team_keys_lambda/app.py
@@ -81,6 +81,8 @@ def get_cached_members_keys(members: set) -> Keys:
 
 
 def get_token_from_aws() -> str:
+    # We need a separate token, since the clickhouse-ci app does not have
+    # access to the organization members' endpoint
     secret_name = "clickhouse_robot_token"
     session = boto3.session.Session()
     client = session.client(
@@ -130,4 +132,4 @@ if __name__ == "__main__":
     args = parser.parse_args()
     output = main(args.token, args.organization, args.team)
 
-    print(f"# Just shoing off the keys:\n{output}")
+    print(f"# Just showing off the keys:\n{output}")
diff --git a/tests/ci/team_keys_lambda/lambda_shared b/tests/ci/team_keys_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/team_keys_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/team_keys_lambda/requirements.txt b/tests/ci/team_keys_lambda/requirements.txt
index 3bcbe2dfd07..098e04a9798 100644
--- a/tests/ci/team_keys_lambda/requirements.txt
+++ b/tests/ci/team_keys_lambda/requirements.txt
@@ -1 +1 @@
-requests<2.30
+../lambda_shared_package
diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index 5799a498d5a..98b14508314 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -5,86 +5,12 @@ import json
 import sys
 import time
 from dataclasses import dataclass
-from typing import Any, Dict, List, Tuple
+from typing import Any, Dict, List
 
 import boto3  # type: ignore
-import requests  # type: ignore
-import jwt
 
 from lambda_shared import RunnerDescriptions, list_runners
-
-
-def get_key_and_app_from_aws() -> Tuple[str, int]:
-    secret_name = "clickhouse_github_secret_key"
-    session = boto3.session.Session()
-    client = session.client(
-        service_name="secretsmanager",
-    )
-    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
-    data = json.loads(get_secret_value_response["SecretString"])
-    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
-
-
-def get_installation_id(jwt_token: str) -> int:
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.get("https://api.github.com/app/installations", headers=headers)
-    response.raise_for_status()
-    data = response.json()
-    for installation in data:
-        if installation["account"]["login"] == "ClickHouse":
-            installation_id = installation["id"]
-            break
-
-    return installation_id  # type: ignore
-
-
-def get_access_token(jwt_token: str, installation_id: int) -> str:
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.post(
-        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    return data["token"]  # type: ignore
-
-
-@dataclass
-class CachedToken:
-    time: int
-    value: str
-    updating: bool = False
-
-
-cached_token = CachedToken(0, "")
-
-
-def get_cached_access_token() -> str:
-    if time.time() - 550 < cached_token.time or cached_token.updating:
-        return cached_token.value
-    # Indicate that the value is updating now, so the cached value can be
-    # 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
-    private_key, app_id = get_key_and_app_from_aws()
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, private_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    cached_token.time = int(time.time())
-    cached_token.value = get_access_token(encoded_jwt, installation_id)
-    cached_token.updating = False
-    return cached_token.value
+from lambda_shared.token import get_access_token_by_key_app, get_cached_access_token
 
 
 @dataclass
@@ -284,6 +210,8 @@ if __name__ == "__main__":
         with open(args.private_key_path, "r") as key_file:
             private_key = key_file.read()
 
+    token = get_access_token_by_key_app(private_key, args.app_id)
+
     sample_event = {
         "AutoScalingGroupARN": "arn:aws:autoscaling:us-east-1:<account-id>:autoScalingGroup:d4738357-2d40-4038-ae7e-b00ae0227003:autoScalingGroupName/my-asg",
         "AutoScalingGroupName": "my-asg",
@@ -328,14 +256,4 @@ if __name__ == "__main__":
         "Cause": "SCALE_IN",
     }
 
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": args.app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, private_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    access_token = get_access_token(encoded_jwt, args.app_id)
-
-    main(access_token, sample_event)
+    main(token, sample_event)
diff --git a/tests/ci/terminate_runner_lambda/requirements.txt b/tests/ci/terminate_runner_lambda/requirements.txt
index e99dee1743c..4cb3fba0f7b 100644
--- a/tests/ci/terminate_runner_lambda/requirements.txt
+++ b/tests/ci/terminate_runner_lambda/requirements.txt
@@ -1,3 +1 @@
-../lambda_shared_package
-PyJWT
-cryptography<38
+../lambda_shared_package[token]
diff --git a/tests/ci/workflow_approve_rerun_lambda/app.py b/tests/ci/workflow_approve_rerun_lambda/app.py
index 32cba5d466b..3db62430d85 100644
--- a/tests/ci/workflow_approve_rerun_lambda/app.py
+++ b/tests/ci/workflow_approve_rerun_lambda/app.py
@@ -5,9 +5,10 @@ import fnmatch
 import json
 import time
 
-import jwt
 import requests  # type: ignore
-import boto3  # type: ignore
+
+from lambda_shared.pr import TRUSTED_CONTRIBUTORS
+from lambda_shared.token import get_cached_access_token
 
 SUSPICIOUS_CHANGED_FILES_NUMBER = 200
 
@@ -67,108 +68,6 @@ NEED_RERUN_WORKFLOWS = {
     "ReleaseBranchCI",
 }
 
-# Individual trusted contirbutors who are not in any trusted organization.
-# Can be changed in runtime: we will append users that we learned to be in
-# a trusted org, to save GitHub API calls.
-TRUSTED_CONTRIBUTORS = {
-    e.lower()
-    for e in [
-        "achimbab",
-        "adevyatova ",  # DOCSUP
-        "Algunenano",  # Raúl Marín, Tinybird
-        "amosbird",
-        "AnaUvarova",  # DOCSUP
-        "anauvarova",  # technical writer, Yandex
-        "annvsh",  # technical writer, Yandex
-        "atereh",  # DOCSUP
-        "azat",
-        "bharatnc",  # Newbie, but already with many contributions.
-        "bobrik",  # Seasoned contributor, CloudFlare
-        "BohuTANG",
-        "codyrobert",  # Flickerbox engineer
-        "cwurm",  # Employee
-        "damozhaeva",  # DOCSUP
-        "den-crane",
-        "flickerbox-tom",  # Flickerbox
-        "gyuton",  # DOCSUP
-        "hagen1778",  # Roman Khavronenko, seasoned contributor
-        "hczhcz",
-        "hexiaoting",  # Seasoned contributor
-        "ildus",  # adjust, ex-pgpro
-        "javisantana",  # a Spanish ClickHouse enthusiast, ex-Carto
-        "ka1bi4",  # DOCSUP
-        "kirillikoff",  # DOCSUP
-        "kreuzerkrieg",
-        "lehasm",  # DOCSUP
-        "michon470",  # DOCSUP
-        "nikvas0",
-        "nvartolomei",
-        "olgarev",  # DOCSUP
-        "otrazhenia",  # Yandex docs contractor
-        "pdv-ru",  # DOCSUP
-        "podshumok",  # cmake expert from QRator Labs
-        "s-mx",  # Maxim Sabyanin, former employee, present contributor
-        "sevirov",  # technical writer, Yandex
-        "spongedu",  # Seasoned contributor
-        "taiyang-li",
-        "ucasFL",  # Amos Bird's friend
-        "vdimir",  # Employee
-        "vzakaznikov",
-        "YiuRULE",
-        "zlobober",  # Developer of YT
-        "ilejn",  # Arenadata, responsible for Kerberized Kafka
-        "thomoco",  # ClickHouse
-        "BoloniniD",  # Seasoned contributor, HSE
-        "tonickkozlov",  # Cloudflare
-        "tylerhannan",  # ClickHouse Employee
-        "myrrc",  # Mike Kot, DoubleCloud
-        "thevar1able",  # ClickHouse Employee
-        "aalexfvk",
-        "MikhailBurdukov",
-        "tsolodov",  # ClickHouse Employee
-        "kitaisreal",
-    ]
-}
-
-
-def get_installation_id(jwt_token):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.get("https://api.github.com/app/installations", headers=headers)
-    response.raise_for_status()
-    data = response.json()
-    for installation in data:
-        if installation["account"]["login"] == "ClickHouse":
-            installation_id = installation["id"]
-    return installation_id
-
-
-def get_access_token(jwt_token, installation_id):
-    headers = {
-        "Authorization": f"Bearer {jwt_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-    response = requests.post(
-        f"https://api.github.com/app/installations/{installation_id}/access_tokens",
-        headers=headers,
-    )
-    response.raise_for_status()
-    data = response.json()
-    return data["token"]
-
-
-def get_key_and_app_from_aws():
-    secret_name = "clickhouse_github_secret_key"
-    session = boto3.session.Session()
-    client = session.client(
-        service_name="secretsmanager",
-    )
-    get_secret_value_response = client.get_secret_value(SecretId=secret_name)
-    data = json.loads(get_secret_value_response["SecretString"])
-    return data["clickhouse-app-key"], int(data["clickhouse-app-id"])
-
 
 def is_trusted_contributor(pr_user_login, pr_user_orgs):
     if pr_user_login.lower() in TRUSTED_CONTRIBUTORS:
@@ -331,19 +230,6 @@ def label_manual_approve(pull_request, token):
     _exec_post_with_retry(url, token, data)
 
 
-def get_token_from_aws():
-    private_key, app_id = get_key_and_app_from_aws()
-    payload = {
-        "iat": int(time.time()) - 60,
-        "exp": int(time.time()) + (10 * 60),
-        "iss": app_id,
-    }
-
-    encoded_jwt = jwt.encode(payload, private_key, algorithm="RS256")
-    installation_id = get_installation_id(encoded_jwt)
-    return get_access_token(encoded_jwt, installation_id)
-
-
 def get_workflow_jobs(workflow_description, token):
     jobs_url = (
         workflow_description.api_url + f"/attempts/{workflow_description.attempt}/jobs"
@@ -443,7 +329,7 @@ def check_workflow_completed(
 
 
 def main(event):
-    token = get_token_from_aws()
+    token = get_cached_access_token()
     event_data = json.loads(event["body"])
     print("The body received:", event["body"])
     workflow_description = get_workflow_description_from_event(event_data)
diff --git a/tests/ci/workflow_approve_rerun_lambda/lambda_shared b/tests/ci/workflow_approve_rerun_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/workflow_approve_rerun_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/workflow_approve_rerun_lambda/requirements.txt b/tests/ci/workflow_approve_rerun_lambda/requirements.txt
index 98be09ab232..4cb3fba0f7b 100644
--- a/tests/ci/workflow_approve_rerun_lambda/requirements.txt
+++ b/tests/ci/workflow_approve_rerun_lambda/requirements.txt
@@ -1,3 +1 @@
-requests<2.30
-PyJWT
-cryptography<38
+../lambda_shared_package[token]
diff --git a/tests/ci/workflow_jobs_lambda/lambda_shared b/tests/ci/workflow_jobs_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/workflow_jobs_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file

From 2dca0eac1b5024e97f8e36889d8d39f43e8e4c2b Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 23 May 2023 21:51:35 +0200
Subject: [PATCH 0242/1478] Delete __init__.py in lambda directories to break
 subpackage

---
 tests/ci/cancel_and_rerun_workflow_lambda/__init__.py | 0
 tests/ci/runner_token_rotation_lambda/__init__.py     | 0
 tests/ci/team_keys_lambda/__init__.py                 | 0
 tests/ci/terminate_runner_lambda/__init__.py          | 0
 tests/ci/workflow_approve_rerun_lambda/__init__.py    | 1 -
 5 files changed, 1 deletion(-)
 delete mode 100644 tests/ci/cancel_and_rerun_workflow_lambda/__init__.py
 delete mode 100644 tests/ci/runner_token_rotation_lambda/__init__.py
 delete mode 100644 tests/ci/team_keys_lambda/__init__.py
 delete mode 100644 tests/ci/terminate_runner_lambda/__init__.py
 delete mode 100644 tests/ci/workflow_approve_rerun_lambda/__init__.py

diff --git a/tests/ci/cancel_and_rerun_workflow_lambda/__init__.py b/tests/ci/cancel_and_rerun_workflow_lambda/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/ci/runner_token_rotation_lambda/__init__.py b/tests/ci/runner_token_rotation_lambda/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/ci/team_keys_lambda/__init__.py b/tests/ci/team_keys_lambda/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/ci/terminate_runner_lambda/__init__.py b/tests/ci/terminate_runner_lambda/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/ci/workflow_approve_rerun_lambda/__init__.py b/tests/ci/workflow_approve_rerun_lambda/__init__.py
deleted file mode 100644
index 4265cc3e6c1..00000000000
--- a/tests/ci/workflow_approve_rerun_lambda/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-#!/usr/bin/env python

From e8b03d74986a4e0f51f9cd064493cd5419c78add Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 26 May 2023 17:17:49 +0200
Subject: [PATCH 0243/1478] Move insert part for ClickHouseHelper to shared

---
 .../lambda_shared/__init__.py                 |  91 +++++++++-
 tests/ci/workflow_jobs_lambda/app.py          | 165 +++---------------
 .../ci/workflow_jobs_lambda/requirements.txt  |   2 +-
 3 files changed, 110 insertions(+), 148 deletions(-)

diff --git a/tests/ci/lambda_shared_package/lambda_shared/__init__.py b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
index fe52f98d5f6..534d7773ddd 100644
--- a/tests/ci/lambda_shared_package/lambda_shared/__init__.py
+++ b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
@@ -5,7 +5,7 @@ import json
 import logging
 import time
 from collections import namedtuple
-from typing import Any, List, Optional
+from typing import Any, Dict, Iterable, List, Optional
 
 import boto3  # type: ignore
 import requests  # type: ignore
@@ -36,10 +36,14 @@ class CHException(Exception):
     pass
 
 
+class InsertException(CHException):
+    pass
+
+
 class ClickHouseHelper:
     def __init__(
         self,
-        url: Optional[str] = None,
+        url: str,
         user: Optional[str] = None,
         password: Optional[str] = None,
     ):
@@ -50,6 +54,89 @@ class ClickHouseHelper:
         if password:
             self.auth["X-ClickHouse-Key"] = password
 
+    @staticmethod
+    def _insert_json_str_info_impl(
+        url: str, auth: Dict[str, str], db: str, table: str, json_str: str
+    ) -> None:
+        params = {
+            "database": db,
+            "query": f"INSERT INTO {table} FORMAT JSONEachRow",
+            "date_time_input_format": "best_effort",
+            "send_logs_level": "warning",
+        }
+
+        for i in range(5):
+            try:
+                response = requests.post(
+                    url, params=params, data=json_str, headers=auth
+                )
+            except Exception as e:
+                error = f"Received exception while sending data to {url} on {i} attempt: {e}"
+                logging.warning(error)
+                continue
+
+            logging.info("Response content '%s'", response.content)
+
+            if response.ok:
+                break
+
+            error = (
+                "Cannot insert data into clickhouse at try "
+                + str(i)
+                + ": HTTP code "
+                + str(response.status_code)
+                + ": '"
+                + str(response.text)
+                + "'"
+            )
+
+            if response.status_code >= 500:
+                # A retriable error
+                time.sleep(1)
+                continue
+
+            logging.info(
+                "Request headers '%s', body '%s'",
+                response.request.headers,
+                response.request.body,
+            )
+
+            raise InsertException(error)
+        else:
+            raise InsertException(error)
+
+    def _insert_json_str_info(self, db: str, table: str, json_str: str) -> None:
+        self._insert_json_str_info_impl(self.url, self.auth, db, table, json_str)
+
+    def insert_event_into(
+        self, db: str, table: str, event: object, safe: bool = True
+    ) -> None:
+        event_str = json.dumps(event)
+        try:
+            self._insert_json_str_info(db, table, event_str)
+        except InsertException as e:
+            logging.error(
+                "Exception happened during inserting data into clickhouse: %s", e
+            )
+            if not safe:
+                raise
+
+    def insert_events_into(
+        self, db: str, table: str, events: Iterable[object], safe: bool = True
+    ) -> None:
+        jsons = []
+        for event in events:
+            jsons.append(json.dumps(event))
+
+        try:
+            self._insert_json_str_info(db, table, ",".join(jsons))
+        except InsertException as e:
+            logging.error(
+                "Exception happened during inserting data into clickhouse: %s", e
+            )
+            if not safe:
+                raise
+
     def _select_and_get_json_each_row(self, db: str, query: str) -> str:
         params = {
             "database": db,
diff --git a/tests/ci/workflow_jobs_lambda/app.py b/tests/ci/workflow_jobs_lambda/app.py
index c4ce68c3f8e..c624a492604 100644
--- a/tests/ci/workflow_jobs_lambda/app.py
+++ b/tests/ci/workflow_jobs_lambda/app.py
@@ -10,13 +10,11 @@ fields for private repositories
 
 from base64 import b64decode
 from dataclasses import dataclass
-from typing import Any, List
+from typing import Any, List, Optional
 import json
 import logging
-import time
 
-import boto3  # type: ignore
-import requests  # type: ignore
+from lambda_shared import ClickHouseHelper, InsertException, get_parameter_from_ssm
 
 logging.getLogger().setLevel(logging.INFO)
 
@@ -66,137 +64,7 @@ class WorkflowJob:
         return self.__dict__
 
 
-### VENDORING
-def get_parameter_from_ssm(name, decrypt=True, client=None):
-    if not client:
-        client = boto3.client("ssm", region_name="us-east-1")
-    return client.get_parameter(Name=name, WithDecryption=decrypt)["Parameter"]["Value"]
-
-
-class InsertException(Exception):
-    pass
-
-
-class ClickHouseHelper:
-    def __init__(self, url=None):
-        if url is None:
-            url = get_parameter_from_ssm("clickhouse-test-stat-url")
-
-        self.url = url
-        self.auth = {
-            "X-ClickHouse-User": get_parameter_from_ssm("clickhouse-test-stat-login"),
-            "X-ClickHouse-Key": get_parameter_from_ssm("clickhouse-test-stat-password"),
-        }
-
-    @staticmethod
-    def _insert_json_str_info_impl(url, auth, db, table, json_str):
-        params = {
-            "database": db,
-            "query": f"INSERT INTO {table} FORMAT JSONEachRow",
-            "date_time_input_format": "best_effort",
-            "send_logs_level": "warning",
-        }
-
-        for i in range(5):
-            try:
-                response = requests.post(
-                    url, params=params, data=json_str, headers=auth
-                )
-            except Exception as e:
-                error = f"Received exception while sending data to {url} on {i} attempt: {e}"
-                logging.warning(error)
-                continue
-
-            logging.info("Response content '%s'", response.content)
-
-            if response.ok:
-                break
-
-            error = (
-                "Cannot insert data into clickhouse at try "
-                + str(i)
-                + ": HTTP code "
-                + str(response.status_code)
-                + ": '"
-                + str(response.text)
-                + "'"
-            )
-
-            if response.status_code >= 500:
-                # A retriable error
-                time.sleep(1)
-                continue
-
-            logging.info(
-                "Request headers '%s', body '%s'",
-                response.request.headers,
-                response.request.body,
-            )
-
-            raise InsertException(error)
-        else:
-            raise InsertException(error)
-
-    def _insert_json_str_info(self, db, table, json_str):
-        self._insert_json_str_info_impl(self.url, self.auth, db, table, json_str)
-
-    def insert_event_into(self, db, table, event, safe=True):
-        event_str = json.dumps(event)
-        try:
-            self._insert_json_str_info(db, table, event_str)
-        except InsertException as e:
-            logging.error(
-                "Exception happened during inserting data into clickhouse: %s", e
-            )
-            if not safe:
-                raise
-
-    def insert_events_into(self, db, table, events, safe=True):
-        jsons = []
-        for event in events:
-            jsons.append(json.dumps(event))
-
-        try:
-            self._insert_json_str_info(db, table, ",".join(jsons))
-        except InsertException as e:
-            logging.error(
-                "Exception happened during inserting data into clickhouse: %s", e
-            )
-            if not safe:
-                raise
-
-    def _select_and_get_json_each_row(self, db, query):
-        params = {
-            "database": db,
-            "query": query,
-            "default_format": "JSONEachRow",
-        }
-        for i in range(5):
-            response = None
-            try:
-                response = requests.get(self.url, params=params, headers=self.auth)
-                response.raise_for_status()
-                return response.text
-            except Exception as ex:
-                logging.warning("Cannot insert with exception %s", str(ex))
-                if response:
-                    logging.warning("Reponse text %s", response.text)
-                time.sleep(0.1 * i)
-
-        raise Exception("Cannot fetch data from clickhouse")
-
-    def select_json_each_row(self, db, query):
-        text = self._select_and_get_json_each_row(db, query)
-        result = []
-        for line in text.split("\n"):
-            if line:
-                result.append(json.loads(line))
-        return result
-
-
-### VENDORING END
-
-clickhouse_client = ClickHouseHelper()
+CH_CLIENT = None  # type: Optional[ClickHouseHelper]
 
 
 def send_event_workflow_job(workflow_job: WorkflowJob) -> None:
@@ -232,23 +100,30 @@ def send_event_workflow_job(workflow_job: WorkflowJob) -> None:
     # PARTITION BY toStartOfMonth(started_at)
     # ORDER BY (id, updated_at)
     # SETTINGS index_granularity = 8192
-    global clickhouse_client
-    kwargs = {
-        "db": "default",
-        "table": "workflow_jobs",
-        "event": workflow_job.as_dict(),
-        "safe": False,
-    }
+    global CH_CLIENT
+    CH_CLIENT = CH_CLIENT or ClickHouseHelper(
+        get_parameter_from_ssm("clickhouse-test-stat-url"),
+        get_parameter_from_ssm("clickhouse-test-stat-login"),
+        get_parameter_from_ssm("clickhouse-test-stat-password"),
+    )
     try:
-        clickhouse_client.insert_event_into(**kwargs)
+        CH_CLIENT.insert_event_into(
+            "default", "workflow_jobs", workflow_job.as_dict(), False
+        )
     except InsertException as ex:
         logging.exception(
             "Got an exception on insert, tryuing to update the client "
             "credentials and repeat",
             exc_info=ex,
         )
-        clickhouse_client = ClickHouseHelper()
-        clickhouse_client.insert_event_into(**kwargs)
+        CH_CLIENT = ClickHouseHelper(
+            get_parameter_from_ssm("clickhouse-test-stat-url"),
+            get_parameter_from_ssm("clickhouse-test-stat-login"),
+            get_parameter_from_ssm("clickhouse-test-stat-password"),
+        )
+        CH_CLIENT.insert_event_into(
+            "default", "workflow_jobs", workflow_job.as_dict(), False
+        )
 
 
 def handler(event: dict, context: Any) -> dict:
diff --git a/tests/ci/workflow_jobs_lambda/requirements.txt b/tests/ci/workflow_jobs_lambda/requirements.txt
index 3bcbe2dfd07..098e04a9798 100644
--- a/tests/ci/workflow_jobs_lambda/requirements.txt
+++ b/tests/ci/workflow_jobs_lambda/requirements.txt
@@ -1 +1 @@
-requests<2.30
+../lambda_shared_package

From f62faaedc3c837b009479cb971e868526a6464fa Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 1 Jun 2023 21:20:39 +0200
Subject: [PATCH 0244/1478] paranoid fix for removing parts from zk

---
 .../MergeTree/ReplicatedMergeTreeSink.cpp     |  19 +-
 .../MergeTree/ReplicatedMergeTreeSink.h       |   2 +-
 src/Storages/StorageReplicatedMergeTree.cpp   | 171 +++++++-----------
 src/Storages/StorageReplicatedMergeTree.h     |   1 +
 ...tem_parts_race_condition_zookeeper_long.sh |   2 +
 .../0_stateless/01154_move_partition_long.sh  |   2 +
 6 files changed, 86 insertions(+), 111 deletions(-)

diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index a38e9eba844..28dad454afe 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -532,12 +532,12 @@ void ReplicatedMergeTreeSinkImpl<false>::finishDelayedChunk(const ZooKeeperWithF
 
         try
         {
-            commitPart(zookeeper, part, partition.block_id, delayed_chunk->replicas_num, false);
+            bool deduplicated = commitPart(zookeeper, part, partition.block_id, delayed_chunk->replicas_num, false).second;
 
-            last_block_is_duplicate = last_block_is_duplicate || part->is_duplicate;
+            last_block_is_duplicate = last_block_is_duplicate || deduplicated;
 
             /// Set a special error code if the block is duplicate
-            int error = (deduplicate && part->is_duplicate) ? ErrorCodes::INSERT_WAS_DEDUPLICATED : 0;
+            int error = (deduplicate && deduplicated) ? ErrorCodes::INSERT_WAS_DEDUPLICATED : 0;
             auto counters_snapshot = std::make_shared<ProfileEvents::Counters::Snapshot>(partition.part_counters.getPartiallyAtomicSnapshot());
             PartLog::addNewPart(storage.getContext(), PartLog::PartLogEntry(part, partition.elapsed_ns, counters_snapshot), ExecutionStatus(error));
             storage.incrementInsertedPartsProfileEvent(part->getType());
@@ -575,7 +575,7 @@ void ReplicatedMergeTreeSinkImpl<true>::finishDelayedChunk(const ZooKeeperWithFa
         while (true)
         {
             partition.temp_part.finalize();
-            auto conflict_block_ids = commitPart(zookeeper, partition.temp_part.part, partition.block_id, delayed_chunk->replicas_num, false);
+            auto conflict_block_ids = commitPart(zookeeper, partition.temp_part.part, partition.block_id, delayed_chunk->replicas_num, false).first;
             if (conflict_block_ids.empty())
                 break;
             ++retry_times;
@@ -620,7 +620,7 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::writeExistingPart(MergeTreeData:
 }
 
 template<bool async_insert>
-std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
+std::pair<std::vector<String>, bool> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
     const ZooKeeperWithFaultInjectionPtr & zookeeper,
     MergeTreeData::MutableDataPartPtr & part,
     const BlockIDsType & block_id,
@@ -644,6 +644,7 @@ std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
 
     /// for retries due to keeper error
     bool part_committed_locally_but_zookeeper = false;
+    bool part_was_deduplicated = false;
     Coordination::Error write_part_info_keeper_error = Coordination::Error::ZOK;
     std::vector<String> conflict_block_ids;
 
@@ -844,7 +845,7 @@ std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
             /// If it exists on our replica, ignore it.
             if (storage.getActiveContainingPart(existing_part_name))
             {
-                part->is_duplicate = true;
+                part_was_deduplicated = true;
                 ProfileEvents::increment(ProfileEvents::DuplicatedInsertedBlocks);
                 if (isQuorumEnabled())
                 {
@@ -1040,7 +1041,7 @@ std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
                 ++loop_counter;
                 if (loop_counter == max_iterations)
                 {
-                    part->is_duplicate = true; /// Part is duplicate, just remove it from local FS
+                    part_was_deduplicated = true; /// Part is duplicate, just remove it from local FS
                     throw Exception(ErrorCodes::DUPLICATE_DATA_PART, "Too many transaction retries - it may indicate an error");
                 }
                 retries_ctl.requestUnconditionalRetry(); /// we want one more iteration w/o counting it as a try and timeout
@@ -1093,7 +1094,7 @@ std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
     [&zookeeper]() { zookeeper->cleanupEphemeralNodes(); });
 
     if (!conflict_block_ids.empty())
-        return conflict_block_ids;
+        return {conflict_block_ids, part_was_deduplicated};
 
     if (isQuorumEnabled())
     {
@@ -1129,7 +1130,7 @@ std::vector<String> ReplicatedMergeTreeSinkImpl<async_insert>::commitPart(
                 return;
         });
     }
-    return {};
+    return {conflict_block_ids, part_was_deduplicated};
 }
 
 template<bool async_insert>
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
index 3777a9f7285..3efd364fc9c 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
@@ -87,7 +87,7 @@ private:
     size_t checkQuorumPrecondition(const ZooKeeperWithFaultInjectionPtr & zookeeper);
 
     /// Rename temporary part and commit to ZooKeeper.
-    std::vector<String> commitPart(
+    std::pair<std::vector<String>, bool> commitPart(
         const ZooKeeperWithFaultInjectionPtr & zookeeper,
         MergeTreeData::MutableDataPartPtr & part,
         const BlockIDsType & block_id,
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 0f79e9f8f19..44403fc708b 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -12,6 +12,7 @@
 #include <Common/ZooKeeper/Types.h>
 #include <Common/escapeForFileName.h>
 #include <Common/formatReadable.h>
+#include <Common/noexcept_scope.h>
 #include <Common/thread_local_rng.h>
 #include <Common/typeid_cast.h>
 #include <Common/ThreadFuzzer.h>
@@ -1992,6 +1993,16 @@ void StorageReplicatedMergeTree::executeDropRange(const LogEntry & entry)
     /// Forcibly remove parts from ZooKeeper
     removePartsFromZooKeeperWithRetries(parts_to_remove);
 
+#ifdef ABORT_ON_LOGICAL_ERROR
+    Strings parts_remain = getZooKeeper()->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, entry.new_part_name);
+    }
+#endif
+
     if (entry.detach)
         LOG_DEBUG(log, "Detached {} parts inside {}.", parts_to_remove.size(), entry.new_part_name);
     else
@@ -6634,8 +6645,7 @@ bool StorageReplicatedMergeTree::hasLightweightDeletedMask() const
 
 void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
 {
-    auto table_lock = lockForShare(
-            RWLockImpl::NO_QUERY, getSettings()->lock_acquire_timeout_for_background_operations);
+    auto table_lock = lockForShare(RWLockImpl::NO_QUERY, getSettings()->lock_acquire_timeout_for_background_operations);
     auto zookeeper = getZooKeeper();
 
     /// Now these parts are in Deleting state. If we fail to remove some of them we must roll them back to Outdated state.
@@ -6644,6 +6654,12 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
     if (parts.empty())
         return;
 
+    NOEXCEPT_SCOPE({ clearOldPartsAndRemoveFromZKImpl(zookeeper, std::move(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
@@ -6654,7 +6670,11 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
         /// Broken part can be removed from zk by removePartAndEnqueueFetch(...) only.
         /// Removal without enqueueing a fetch leads to intersecting parts.
         if (part->is_duplicate || part->outdated_because_broken)
+        {
+            LOG_WARNING(log, "Will not remove part {} from ZooKeeper (is_duplicate: {}, outdated_because_broken: {})",
+                        part->name, part->is_duplicate, part->outdated_because_broken);
             parts_to_delete_only_from_filesystem.emplace_back(part);
+        }
         else
             parts_to_delete_completely.emplace_back(part);
     }
@@ -6680,7 +6700,7 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
             if (!rollback_parts.empty())
                 rollbackDeletingParts(rollback_parts);
         }
-        else  /// all parts was successfully removed
+        else  /// all parts were successfully removed
         {
             finally_remove_parts = parts_to_delete;
         }
@@ -6764,114 +6784,57 @@ void StorageReplicatedMergeTree::removePartsFromZooKeeperWithRetries(PartsToRemo
 
 void StorageReplicatedMergeTree::removePartsFromZooKeeperWithRetries(const Strings & part_names, size_t max_retries)
 {
+    auto zookeeper = getZooKeeper();
+    NameSet parts_to_retry_set;
+    removePartsFromZooKeeper(zookeeper, part_names, &parts_to_retry_set);
+
     size_t num_tries = 0;
-    bool success = false;
-
-    while (!success && (max_retries == 0 || num_tries < max_retries))
+    while (!parts_to_retry_set.empty() && (max_retries == 0 || num_tries < max_retries))
     {
-        try
-        {
-            ++num_tries;
-            success = true;
-
-            auto zookeeper = getZooKeeper();
-
-            Strings exists_paths;
-            exists_paths.reserve(part_names.size());
-            for (const String & part_name : part_names)
-            {
-                exists_paths.emplace_back(fs::path(replica_path) / "parts" / part_name);
-            }
-
-            auto exists_results = zookeeper->exists(exists_paths);
-
-            std::vector<std::future<Coordination::MultiResponse>> remove_futures;
-            remove_futures.reserve(part_names.size());
-            for (size_t i = 0; i < part_names.size(); ++i)
-            {
-                Coordination::ExistsResponse exists_resp = exists_results[i];
-                if (exists_resp.error == Coordination::Error::ZOK)
-                {
-                    Coordination::Requests ops;
-                    getRemovePartFromZooKeeperOps(part_names[i], ops, exists_resp.stat.numChildren > 0);
-                    remove_futures.emplace_back(zookeeper->asyncTryMultiNoThrow(ops));
-                }
-            }
-
-            for (auto & future : remove_futures)
-            {
-                auto response = future.get();
-
-                if (response.error == Coordination::Error::ZOK || response.error == Coordination::Error::ZNONODE)
-                    continue;
-
-                if (Coordination::isHardwareError(response.error))
-                {
-                    success = false;
-                    continue;
-                }
-
-                throw Coordination::Exception(response.error);
-            }
-        }
-        catch (Coordination::Exception & e)
-        {
-            success = false;
-
-            if (Coordination::isHardwareError(e.code))
-                tryLogCurrentException(log, __PRETTY_FUNCTION__);
-            else
-                throw;
-        }
-
-        if (!success && num_tries < max_retries)
-            std::this_thread::sleep_for(std::chrono::milliseconds(1000));
+        zookeeper = getZooKeeper();
+        Strings parts_to_retry;
+        std::move(parts_to_retry_set.begin(), parts_to_retry_set.end(), std::back_inserter(parts_to_retry));
+        parts_to_retry_set.clear();
+        removePartsFromZooKeeper(zookeeper, parts_to_retry, &parts_to_retry_set);
+        ++num_tries;
     }
 
-    if (!success)
-        throw Exception(ErrorCodes::UNFINISHED, "Failed to remove parts from ZooKeeper after {} retries", num_tries);
+    if (!parts_to_retry_set.empty())
+        throw Exception(ErrorCodes::UNFINISHED, "Failed to remove {} parts from ZooKeeper after {} retries", parts_to_retry_set.size(), num_tries);
 }
 
 void StorageReplicatedMergeTree::removePartsFromZooKeeper(
     zkutil::ZooKeeperPtr & zookeeper, const Strings & part_names, NameSet * parts_should_be_retried)
+try
 {
     Strings exists_paths;
     std::vector<std::future<Coordination::MultiResponse>> remove_futures;
     exists_paths.reserve(part_names.size());
     remove_futures.reserve(part_names.size());
-    try
+    /// Exception can be thrown from loop
+    /// if zk session will be dropped
+    for (const String & part_name : part_names)
     {
-        /// Exception can be thrown from loop
-        /// if zk session will be dropped
-        for (const String & part_name : part_names)
-        {
-            exists_paths.emplace_back(fs::path(replica_path) / "parts" / part_name);
-        }
-
-        auto exists_results = zookeeper->exists(exists_paths);
-
-        for (size_t i = 0; i < part_names.size(); ++i)
-        {
-            auto exists_resp = exists_results[i];
-            if (exists_resp.error == Coordination::Error::ZOK)
-            {
-                Coordination::Requests ops;
-                getRemovePartFromZooKeeperOps(part_names[i], ops, exists_resp.stat.numChildren > 0);
-                remove_futures.emplace_back(zookeeper->asyncTryMultiNoThrow(ops));
-            }
-            else
-            {
-                LOG_DEBUG(log, "There is no part {} in ZooKeeper, it was only in filesystem", part_names[i]);
-                // emplace invalid future so that the total number of futures is the same as part_names.size();
-                remove_futures.emplace_back();
-            }
-        }
+        exists_paths.emplace_back(fs::path(replica_path) / "parts" / part_name);
     }
-    catch (const Coordination::Exception & e)
+
+    auto exists_results = zookeeper->exists(exists_paths);
+
+    for (size_t i = 0; i < part_names.size(); ++i)
     {
-        if (parts_should_be_retried && Coordination::isHardwareError(e.code))
-            parts_should_be_retried->insert(part_names.begin(), part_names.end());
-        throw;
+        auto exists_resp = exists_results[i];
+        if (exists_resp.error == Coordination::Error::ZOK)
+        {
+            Coordination::Requests ops;
+            getRemovePartFromZooKeeperOps(part_names[i], ops, exists_resp.stat.numChildren > 0);
+            remove_futures.emplace_back(zookeeper->asyncTryMultiNoThrow(ops));
+        }
+        else
+        {
+            LOG_DEBUG(log, "There is no part {} in ZooKeeper, it was only in filesystem", part_names[i]);
+            // emplace invalid future so that the total number of futures is the same as part_names.size();
+            remove_futures.emplace_back();
+        }
     }
 
     for (size_t i = 0; i < remove_futures.size(); ++i)
@@ -6884,21 +6847,27 @@ void StorageReplicatedMergeTree::removePartsFromZooKeeper(
         auto response = future.get();
         if (response.error == Coordination::Error::ZOK)
             continue;
-        else if (response.error == Coordination::Error::ZNONODE)
+
+        if (response.error == Coordination::Error::ZNONODE)
         {
             LOG_DEBUG(log, "There is no part {} in ZooKeeper, it was only in filesystem", part_names[i]);
-            continue;
         }
-        else if (Coordination::isHardwareError(response.error))
+        else
         {
             if (parts_should_be_retried)
                 parts_should_be_retried->insert(part_names[i]);
-            continue;
+
+            if (!Coordination::isHardwareError(response.error))
+                LOG_WARNING(log, "Cannot remove part {} from ZooKeeper: {}", part_names[i], Coordination::errorMessage(response.error));
         }
-        else
-            LOG_WARNING(log, "Cannot remove part {} from ZooKeeper: {}", part_names[i], Coordination::errorMessage(response.error));
     }
 }
+catch (...)
+{
+    if (parts_should_be_retried)
+        parts_should_be_retried->insert(part_names.begin(), part_names.end());
+    throw;
+}
 
 void StorageReplicatedMergeTree::clearLockedBlockNumbersInPartition(
     zkutil::ZooKeeper & zookeeper, const String & partition_id, Int64 min_block_num, Int64 max_block_num)
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index cb93dd0b5e3..dd7ea84f76b 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -344,6 +344,7 @@ private:
 
     /// Delete old parts from disk and from ZooKeeper.
     void clearOldPartsAndRemoveFromZK();
+    void clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKeeperPtr zookeeper, DataPartsVector && parts);
 
     template<bool async_insert>
     friend class ReplicatedMergeTreeSinkImpl;
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..862cc90fb1c 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
@@ -79,6 +79,8 @@ timeout $TIMEOUT bash -c thread5 2> /dev/null &
 wait
 check_replication_consistency "alter_table" "count(), sum(a), sum(b), round(sum(c))"
 
+$CLICKHOUSE_CLIENT -q "SELECT table, lost_part_count FROM system.replicas WHERE database=currentDatabase() AND lost_part_count!=0";
+
 $CLICKHOUSE_CLIENT -n -q "DROP TABLE alter_table0;" 2> >(grep -F -v 'is already started to be removing by another replica right now') &
 $CLICKHOUSE_CLIENT -n -q "DROP TABLE alter_table1;" 2> >(grep -F -v 'is already started to be removing by another replica right now') &
 wait
diff --git a/tests/queries/0_stateless/01154_move_partition_long.sh b/tests/queries/0_stateless/01154_move_partition_long.sh
index c68b0944407..3e068fa0e2d 100755
--- a/tests/queries/0_stateless/01154_move_partition_long.sh
+++ b/tests/queries/0_stateless/01154_move_partition_long.sh
@@ -125,6 +125,8 @@ wait
 check_replication_consistency "dst_" "count(), sum(p), sum(k), sum(v)"
 try_sync_replicas "src_" 300
 
+$CLICKHOUSE_CLIENT -q "SELECT table, lost_part_count FROM system.replicas WHERE database=currentDatabase() AND lost_part_count!=0";
+
 for ((i=0; i<16; i++)) do
     $CLICKHOUSE_CLIENT -q "DROP TABLE dst_$i" 2>&1| grep -Fv "is already started to be removing" &
     $CLICKHOUSE_CLIENT -q "DROP TABLE IF EXISTS src_$i" 2>&1| grep -Fv "is already started to be removing" &

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 0245/1478] 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 0246/1478] 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 0247/1478] 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 92859ebb3baad37e6538118f5e2c5c8016754b7f Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 1 Jun 2023 21:15:15 +0000
Subject: [PATCH 0248/1478] Fixing more tests.

---
 src/Analyzer/Passes/QueryAnalysisPass.cpp     |   2 +-
 src/Functions/in.cpp                          |  12 +-
 src/Interpreters/ActionsVisitor.cpp           |   4 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |   2 +-
 src/Interpreters/PreparedSets.cpp             | 119 ++++++++++--------
 src/Interpreters/PreparedSets.h               |  25 ++--
 src/Interpreters/Set.cpp                      |  30 ++++-
 src/Interpreters/Set.h                        |   7 +-
 src/Planner/CollectSets.cpp                   |   2 +-
 .../CreateSetAndFilterOnTheFlyStep.cpp        |   2 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |   8 +-
 src/Processors/QueryPlan/CreatingSetsStep.h   |   6 +-
 .../Transforms/CreatingSetsTransform.cpp      |  11 +-
 .../Transforms/CreatingSetsTransform.h        |   6 +-
 src/QueryPipeline/QueryPipelineBuilder.cpp    |  10 +-
 src/QueryPipeline/QueryPipelineBuilder.h      |  10 +-
 src/Storages/MergeTree/RPNBuilder.cpp         |  53 ++++----
 src/Storages/StorageSet.cpp                   |   4 +-
 .../01786_explain_merge_tree.reference        |   4 +-
 19 files changed, 195 insertions(+), 122 deletions(-)

diff --git a/src/Analyzer/Passes/QueryAnalysisPass.cpp b/src/Analyzer/Passes/QueryAnalysisPass.cpp
index 05b3a545dca..b39aff86d32 100644
--- a/src/Analyzer/Passes/QueryAnalysisPass.cpp
+++ b/src/Analyzer/Passes/QueryAnalysisPass.cpp
@@ -5141,7 +5141,7 @@ ProjectionNames QueryAnalyzer::resolveFunction(QueryTreeNodePtr & node, Identifi
 
             SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
 
-            auto set = std::make_shared<Set>(size_limits_for_set, true /*fill_set_elements*/, settings.transform_null_in);
+            auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, 0, settings.transform_null_in);
 
             set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
             set->insertFromBlock(result_block.getColumnsWithTypeAndName());
diff --git a/src/Functions/in.cpp b/src/Functions/in.cpp
index 6a88a413c63..0e576b92aad 100644
--- a/src/Functions/in.cpp
+++ b/src/Functions/in.cpp
@@ -55,13 +55,9 @@ public:
     /// It is needed to perform type analysis without creation of set.
     static constexpr auto name = FunctionInName<negative, global, null_is_skipped, ignore_set>::name;
 
-    FunctionIn(SizeLimits size_limits_, bool transform_null_in_)
-        : size_limits(std::move(size_limits_)), transform_null_in(transform_null_in_) {}
-
-    static FunctionPtr create(ContextPtr context)
+    static FunctionPtr create(ContextPtr)
     {
-        const auto & settings = context->getSettingsRef();
-        return std::make_shared<FunctionIn>(FutureSet::getSizeLimitsForSet(settings, false), settings.transform_null_in);
+        return std::make_shared<FunctionIn>();
     }
 
     String getName() const override
@@ -182,10 +178,6 @@ public:
 
         return res;
     }
-
-private:
-    SizeLimits size_limits;
-    bool transform_null_in;
 };
 
 template<bool ignore_set>
diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 142b6f73b75..59bbc74ca3a 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1435,7 +1435,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         // String set_id = right_in_operand->getColumnName();
         //bool transform_null_in =  data.getContext()->getSettingsRef().transform_null_in;
         SubqueryForSet subquery_for_set; // = data.prepared_sets->createOrGetSubquery(set_id, set_key, data.set_size_limit, transform_null_in);
-        subquery_for_set.key = right_in_operand->getColumnName();
+        subquery_for_set.key = set_key.toString(); //right_in_operand->getColumnName();
 
         /** The following happens for GLOBAL INs or INs:
           * - in the addExternalStorage function, the IN (SELECT ...) subquery is replaced with IN _data1,
@@ -1450,7 +1450,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             subquery_for_set.createSource(*interpreter);
         }
 
-        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), std::move(external_table_set));
+        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), data.getContext()->getSettingsRef(), std::move(external_table_set));
     }
     else
     {
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 624b33ea66b..cbdfb826f85 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -197,7 +197,7 @@ public:
                     subquery_for_set.createSource(*interpreter);
 
                     //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
-                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), nullptr);
+                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), getContext()->getSettingsRef(), nullptr);
                     // std::cerr << "... Future set " << reinterpret_cast<const void *>(external_storage_holder.get()) << " " << reinterpret_cast<const void *>(future_set.get()) << std::endl;
                     external_storage_holder->future_set = std::move(future_set);
                 }
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index c71273e0baa..1e475e8403d 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -132,10 +132,10 @@ FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block,
     return it->second;
 }
 
-FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, FutureSetPtr external_table_set)
+FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set)
 {
     auto id = subquery.key;
-    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set));
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set), settings.transform_null_in);
     auto [it, inserted] = sets.emplace(key, from_subquery);
 
     if (!inserted)
@@ -210,6 +210,8 @@ std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseTo
 {
     std::lock_guard lock(cache_mutex);
 
+    // std::cerr << "PreparedSetsCache::findOrPromiseToBuild " <<  key << "\n" << StackTrace().toString() << std::endl;
+
     auto it = cache.find(key);
     if (it != cache.end())
     {
@@ -231,10 +233,10 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     if (!context->getSettingsRef().use_index_for_in_with_subqueries)
         return nullptr;
 
-    if (set)
+    if (subquery.set)
     {
-        if (set->hasExplicitSetElements())
-            return set;
+        if (subquery.set->hasExplicitSetElements())
+            return subquery.set;
 
         return nullptr;
     }
@@ -242,7 +244,7 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     // std::cerr << "... external_table_set " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
 
     if (external_table_set)
-        return set = external_table_set->buildOrderedSetInplace(context);
+        return subquery.set = external_table_set->buildOrderedSetInplace(context);
 
     auto plan = buildPlan(context, true);
     if (!plan)
@@ -255,37 +257,44 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     CompletedPipelineExecutor executor(pipeline);
     executor.execute();
 
-    return set;
+    subquery.set->checkIsCreated();
+
+    return subquery.set;
+}
+
+static SizeLimits getSizeLimitsForSet(const Settings & settings)
+{
+    return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
 }
 
 std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context, bool create_ordered_set)
 {
-    if (set)
+    if (subquery.set)
         return nullptr;
 
     // std::cerr << StackTrace().toString() << std::endl;
 
-    auto set_cache = context->getPreparedSetsCache();
-    if (set_cache)
-    {
-        auto from_cache = set_cache->findOrPromiseToBuild(subquery.key);
-        if (from_cache.index() == 0)
-        {
-            subquery.promise_to_fill_set = std::move(std::get<0>(from_cache));
-        }
-        else
-        {
-            LOG_TRACE(&Poco::Logger::get("FutureSetFromSubquery"), "Waiting for set, key: {}", subquery.key);
-            set = std::get<1>(from_cache).get();
-            return nullptr;
-        }
-    }
+    // auto set_cache = context->getPreparedSetsCache();
+    // if (set_cache)
+    // {
+    //     auto from_cache = set_cache->findOrPromiseToBuild(subquery.key);
+    //     if (from_cache.index() == 0)
+    //     {
+    //         subquery.promise_to_fill_set = std::move(std::get<0>(from_cache));
+    //     }
+    //     else
+    //     {
+    //         LOG_TRACE(&Poco::Logger::get("FutureSetFromSubquery"), "Waiting for set, key: {}", subquery.key);
+    //         set = std::get<1>(from_cache).get();
+    //         return nullptr;
+    //     }
+    // }
 
 
     const auto & settings = context->getSettingsRef();
-    auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
+    auto size_limits = getSizeLimitsForSet(settings);
 
-    subquery.set = set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
+    subquery.set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
 
     auto plan = subquery.detachSource();
     auto description = subquery.key;
@@ -297,7 +306,8 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
             description,
-            std::move(subquery),
+            subquery,
+            shared_from_this(),
             SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
             context);
     creating_set->setStepDescription("Create set for subquery");
@@ -305,31 +315,25 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     return plan;
 }
 
+// static SizeLimits getSizeLimitsForOrderedSet(const Settings & settings)
+// {
+//     if (settings.use_index_for_in_with_subqueries_max_values &&
+//         settings.use_index_for_in_with_subqueries_max_values < settings.max_rows_in_set)
+//         return getSizeLimitsForUnorderedSet(settings);
 
-static SizeLimits getSizeLimitsForUnorderedSet(const Settings & settings)
-{
-    return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
-}
+//     return SizeLimits(settings.use_index_for_in_with_subqueries_max_values, settings.max_bytes_in_set, OverflowMode::BREAK);
+// }
 
-static SizeLimits getSizeLimitsForOrderedSet(const Settings & settings)
-{
-    if (settings.use_index_for_in_with_subqueries_max_values &&
-        settings.use_index_for_in_with_subqueries_max_values < settings.max_rows_in_set)
-        return getSizeLimitsForUnorderedSet(settings);
-
-    return SizeLimits(settings.use_index_for_in_with_subqueries_max_values, settings.max_bytes_in_set, OverflowMode::BREAK);
-}
-
-SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordered_set)
-{
-    return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
-}
+// SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordered_set)
+// {
+//     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
+// }
 
 FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
 {
     bool create_ordered_set = false;
-    auto size_limits = getSizeLimitsForSet(settings, create_ordered_set);
-    set = std::make_shared<Set>(size_limits, create_ordered_set, settings.transform_null_in);
+    auto size_limits = getSizeLimitsForSet(settings);
+    set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
     set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
 
     Columns columns;
@@ -345,8 +349,16 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
     //block(std::move(block_))
 }
 
-FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_)
-    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_)) {}
+FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_)
+    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_)), transform_null_in(transform_null_in_) {}
+
+DataTypes FutureSetFromSubquery::getTypes() const
+{
+    if (subquery.set)
+        return subquery.set->getElementsTypes();
+
+    return Set::getElementTypes(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName(), transform_null_in);
+}
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
 
@@ -356,13 +368,14 @@ SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
         return set;
 
     const auto & settings = context->getSettingsRef();
-    auto limits = getSizeLimitsForSet(settings, true);
+    size_t max_values = settings.use_index_for_in_with_subqueries_max_values;
+    bool too_many_values = max_values && max_values < set->getTotalRowCount();
+    if (!too_many_values)
+    {
+        set->initSetElements();
+        set->appendSetElements(set_key_columns);
+    }
 
-    if (!limits.check(set->getTotalRowCount(), set->getTotalByteCount(), "IN-set", ErrorCodes::SET_SIZE_LIMIT_EXCEEDED))
-        return nullptr;
-
-    set->initSetElements();
-    set->appendSetElements(set_key_columns);
     return set;
 }
 
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index c510e690e25..fa7f7069994 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -72,7 +72,9 @@ public:
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
     virtual std::unique_ptr<QueryPlan> build(const ContextPtr & context) = 0;
 
-    static SizeLimits getSizeLimitsForSet(const Settings & settings, bool ordered_set);
+    virtual DataTypes getTypes() const = 0;
+
+    // static SizeLimits getSizeLimitsForSet(const Settings & settings, bool ordered_set);
 };
 
 using FutureSetPtr = std::shared_ptr<FutureSet>;
@@ -90,6 +92,8 @@ public:
 
     std::unique_ptr<QueryPlan> build(const ContextPtr &) override;
 
+    DataTypes getTypes() const override { return set->getElementsTypes(); }
+
 ///    void buildForTuple(SizeLimits size_limits, bool transform_null_in);
 
 private:
@@ -129,14 +133,14 @@ public:
     std::unique_ptr<QueryPlan> source;
 };
 
-class FutureSetFromSubquery : public FutureSet
+class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_this<FutureSetFromSubquery>
 {
 public:
-    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_);
+    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_);
 
-    bool isReady() const override { return set != nullptr; }
+    bool isReady() const override { return subquery.set != nullptr && subquery.set->isCreated(); }
     bool isFilled() const override { return isReady(); }
-    SetPtr get() const override { return set; }
+    SetPtr get() const override { return subquery.set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
@@ -145,12 +149,15 @@ public:
         return buildPlan(context, false);
     }
 
-    void addStorage(StoragePtr storage) { subquery.table = std::move(storage); }
+    DataTypes getTypes() const override;
+
+    // void addStorage(StoragePtr storage) { subquery.table = std::move(storage); }
 
 private:
-    SetPtr set;
+    //SetPtr set;
     SubqueryForSet subquery;
     FutureSetPtr external_table_set;
+    bool transform_null_in;
 
     std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
 };
@@ -169,6 +176,8 @@ public:
         return set->hasExplicitSetElements() ? set : nullptr;
     }
 
+    DataTypes getTypes() const override { return set->getElementsTypes(); }
+
     std::unique_ptr<QueryPlan> build(const ContextPtr &) override { return nullptr; }
 
 private:
@@ -240,7 +249,7 @@ public:
 
     FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
     FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings);
-    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, FutureSetPtr external_table_set);
+    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
 
     //void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
 
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index bd9cafc66eb..52e9a3a9bcb 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -103,6 +103,25 @@ void NO_INLINE Set::insertFromBlockImplCase(
 }
 
 
+DataTypes Set::getElementTypes(const ColumnsWithTypeAndName & header, bool transform_null_in)
+{
+    DataTypes data_types;
+    data_types.reserve(header.size());
+
+    for (const auto & column : header)
+    {
+        data_types.push_back(column.type);
+        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(data_types.back().get()))
+            data_types.back() = low_cardinality_type->getDictionaryType();
+
+        if (!transform_null_in)
+            data_types.back() = removeNullable(data_types.back());
+    }
+
+    return data_types;
+}
+
+
 void Set::setHeader(const ColumnsWithTypeAndName & header)
 {
     std::lock_guard lock(rwlock);
@@ -190,7 +209,16 @@ bool Set::insertFromColumns(const Columns & columns)
 
     bool inserted = insertFromColumns(columns, holder);
     if (inserted && fill_set_elements)
-        appendSetElements(holder);
+    {
+        if (max_elements_to_fill && max_elements_to_fill < data.getTotalRowCount())
+        {
+            /// Drop filled elementes
+            fill_set_elements = false;
+            set_elements.clear();
+        }
+        else
+            appendSetElements(holder);
+    }
 
     return inserted;
 }
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index c2931d79de0..9b76ab30a1b 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -30,9 +30,9 @@ public:
     /// (that is useful only for checking that some value is in the set and may not store the original values),
     /// store all set elements in explicit form.
     /// This is needed for subsequent use for index.
-    Set(const SizeLimits & limits_, bool fill_set_elements_, bool transform_null_in_)
+    Set(const SizeLimits & limits_, bool fill_set_elements_, size_t max_elements_to_fill_, bool transform_null_in_)
         : log(&Poco::Logger::get("Set")),
-        limits(limits_), fill_set_elements(fill_set_elements_), transform_null_in(transform_null_in_)
+        limits(limits_), fill_set_elements(fill_set_elements_), max_elements_to_fill(max_elements_to_fill_), transform_null_in(transform_null_in_)
     {
     }
 
@@ -90,6 +90,8 @@ public:
     bool areTypesEqual(size_t set_type_idx, const DataTypePtr & other_type) const;
     void checkTypesEqual(size_t set_type_idx, const DataTypePtr & other_type) const;
 
+    static DataTypes getElementTypes(const ColumnsWithTypeAndName & header, bool transform_null_in);
+
 private:
     size_t keys_size = 0;
     Sizes key_sizes;
@@ -126,6 +128,7 @@ private:
 
     /// Do we need to additionally store all elements of the set in explicit form for subsequent use for index.
     bool fill_set_elements;
+    size_t max_elements_to_fill;
 
     /// If true, insert NULL values to set.
     bool transform_null_in;
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 913cf1c6ee3..d264810645a 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -110,7 +110,7 @@ public:
             subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
 
             /// TODO
-            sets.addFromSubquery(set_key, std::move(subquery_for_set), nullptr);
+            sets.addFromSubquery(set_key, std::move(subquery_for_set), settings, nullptr);
 
             //planner_context.registerSet(set_key, PlannerSet(in_second_argument));
         }
diff --git a/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp b/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
index fe362f64b96..ebd58c3dc95 100644
--- a/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
+++ b/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
@@ -105,7 +105,7 @@ CreateSetAndFilterOnTheFlyStep::CreateSetAndFilterOnTheFlyStep(
     : ITransformingStep(input_stream_, input_stream_.header, getTraits())
     , column_names(column_names_)
     , max_rows_in_set(max_rows_in_set_)
-    , own_set(std::make_shared<SetWithState>(SizeLimits(max_rows_in_set, 0, OverflowMode::BREAK), false, true))
+    , own_set(std::make_shared<SetWithState>(SizeLimits(max_rows_in_set, 0, OverflowMode::BREAK), false, 0, true))
     , filtering_set(nullptr)
     , crosswise_connection(crosswise_connection_)
     , position(position_)
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 38506412531..0909ee9f1eb 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -35,12 +35,14 @@ static ITransformingStep::Traits getTraits()
 CreatingSetStep::CreatingSetStep(
     const DataStream & input_stream_,
     String description_,
-    SubqueryForSet subquery_for_set_,
+    SubqueryForSet & subquery_for_set_,
+    FutureSetPtr set_,
     SizeLimits network_transfer_limits_,
     ContextPtr context_)
     : ITransformingStep(input_stream_, Block{}, getTraits())
     , description(std::move(description_))
-    , subquery_for_set(std::move(subquery_for_set_))
+    , subquery_for_set(subquery_for_set_)
+    , set(std::move(set_))
     , network_transfer_limits(std::move(network_transfer_limits_))
     , context(std::move(context_))
 {
@@ -48,7 +50,7 @@ CreatingSetStep::CreatingSetStep(
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)
 {
-    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(subquery_for_set), network_transfer_limits, context->getPreparedSetsCache());
+    pipeline.addCreatingSetsTransform(getOutputStream().header, subquery_for_set, std::move(set), network_transfer_limits, context->getPreparedSetsCache());
 }
 
 void CreatingSetStep::updateOutputStream()
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index 244bb27ba78..2a6cb43c45a 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -15,7 +15,8 @@ public:
     CreatingSetStep(
             const DataStream & input_stream_,
             String description_,
-            SubqueryForSet subquery_for_set_,
+            SubqueryForSet & subquery_for_set_,
+            FutureSetPtr set_,
             SizeLimits network_transfer_limits_,
             ContextPtr context_);
 
@@ -30,7 +31,8 @@ private:
     void updateOutputStream() override;
 
     String description;
-    SubqueryForSet subquery_for_set;
+    SubqueryForSet & subquery_for_set;
+    FutureSetPtr set;
     SizeLimits network_transfer_limits;
     ContextPtr context;
 };
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index 24e17ff210f..f6e6f7a191e 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -25,11 +25,13 @@ CreatingSetsTransform::~CreatingSetsTransform() = default;
 CreatingSetsTransform::CreatingSetsTransform(
     Block in_header_,
     Block out_header_,
-    SubqueryForSet subquery_for_set_,
+    SubqueryForSet & subquery_for_set_,
+    FutureSetPtr set_,
     SizeLimits network_transfer_limits_,
     PreparedSetsCachePtr prepared_sets_cache_)
     : IAccumulatingTransform(std::move(in_header_), std::move(out_header_))
-    , subquery(std::move(subquery_for_set_))
+    , subquery(subquery_for_set_)
+    , set(std::move(set_))
     , network_transfer_limits(std::move(network_transfer_limits_))
     , prepared_sets_cache(std::move(prepared_sets_cache_))
 {
@@ -61,6 +63,7 @@ void CreatingSetsTransform::startSubquery()
             auto from_cache = prepared_sets_cache->findOrPromiseToBuild(subquery.key);
             if (from_cache.index() == 0)
             {
+                LOG_TRACE(log, "Building set, key: {}", subquery.key);
                 promise_to_build = std::move(std::get<0>(from_cache));
             }
             else
@@ -74,8 +77,8 @@ void CreatingSetsTransform::startSubquery()
                     continue;
                 }
 
-                subquery.promise_to_fill_set.set_value(ready_set);
-                subquery.set.reset();
+                //subquery.promise_to_fill_set.set_value(ready_set);
+                subquery.set = ready_set; //.reset();
                 done_with_set = true;
                 set_from_cache = true;
             }
diff --git a/src/Processors/Transforms/CreatingSetsTransform.h b/src/Processors/Transforms/CreatingSetsTransform.h
index ef586b0655c..27c330bdbc3 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.h
+++ b/src/Processors/Transforms/CreatingSetsTransform.h
@@ -29,7 +29,8 @@ public:
     CreatingSetsTransform(
         Block in_header_,
         Block out_header_,
-        SubqueryForSet subquery_for_set_,
+        SubqueryForSet & subquery_for_set_,
+        FutureSetPtr set_,
         SizeLimits network_transfer_limits_,
         PreparedSetsCachePtr prepared_sets_cache_);
 
@@ -42,7 +43,8 @@ public:
     Chunk generate() override;
 
 private:
-    SubqueryForSet subquery;
+    SubqueryForSet & subquery;
+    FutureSetPtr set;
     std::optional<std::promise<SetPtr>> promise_to_build;
 
     QueryPipeline table_out;
diff --git a/src/QueryPipeline/QueryPipelineBuilder.cpp b/src/QueryPipeline/QueryPipelineBuilder.cpp
index 4898501b980..08d90899f4a 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.cpp
+++ b/src/QueryPipeline/QueryPipelineBuilder.cpp
@@ -569,14 +569,20 @@ std::unique_ptr<QueryPipelineBuilder> QueryPipelineBuilder::joinPipelinesRightLe
     return left;
 }
 
-void QueryPipelineBuilder::addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, PreparedSetsCachePtr prepared_sets_cache)
+void QueryPipelineBuilder::addCreatingSetsTransform(
+    const Block & res_header,
+    SubqueryForSet & subquery_for_set,
+    FutureSetPtr set,
+    const SizeLimits & limits,
+    PreparedSetsCachePtr prepared_sets_cache)
 {
     resize(1);
 
     auto transform = std::make_shared<CreatingSetsTransform>(
             getHeader(),
             res_header,
-            std::move(subquery_for_set),
+            subquery_for_set,
+            std::move(set),
             limits,
             std::move(prepared_sets_cache));
 
diff --git a/src/QueryPipeline/QueryPipelineBuilder.h b/src/QueryPipeline/QueryPipelineBuilder.h
index 85b6f5c6772..da8443a7e33 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.h
+++ b/src/QueryPipeline/QueryPipelineBuilder.h
@@ -33,6 +33,9 @@ class TableJoin;
 class QueryPipelineBuilder;
 using QueryPipelineBuilderPtr = std::unique_ptr<QueryPipelineBuilder>;
 
+class FutureSet;
+using FutureSetPtr = std::shared_ptr<FutureSet>;
+
 class PreparedSetsCache;
 using PreparedSetsCachePtr = std::shared_ptr<PreparedSetsCache>;
 
@@ -141,7 +144,12 @@ public:
     /// This is used for CreatingSets.
     void addPipelineBefore(QueryPipelineBuilder pipeline);
 
-    void addCreatingSetsTransform(const Block & res_header, SubqueryForSet subquery_for_set, const SizeLimits & limits, PreparedSetsCachePtr prepared_sets_cache);
+    void addCreatingSetsTransform(
+        const Block & res_header,
+        SubqueryForSet & subquery_for_set,
+        FutureSetPtr set,
+        const SizeLimits & limits,
+        PreparedSetsCachePtr prepared_sets_cache);
 
     PipelineExecutorPtr execute();
 
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index cc7ec45be6a..c9feb533ea3 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -353,34 +353,34 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
 {
     const auto & prepared_sets = getTreeContext().getPreparedSets();
 
+    /// We have `PreparedSetKey::forLiteral` but it is useless here as we don't have enough information
+    /// about types in left argument of the IN operator. Instead, we manually iterate through all the sets
+    /// and find the one for the right arg based on the AST structure (getTreeHash), after that we check
+    /// that the types it was prepared with are compatible with the types of the primary key.
+    auto types_match = [&indexes_mapping, &data_types](const DataTypes & set_types)
+    {
+        assert(indexes_mapping.size() == data_types.size());
+
+        for (size_t i = 0; i < indexes_mapping.size(); ++i)
+        {
+            if (indexes_mapping[i].tuple_index >= set_types.size())
+                return false;
+
+            auto lhs = recursiveRemoveLowCardinality(data_types[i]);
+            auto rhs = recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]);
+
+            if (!lhs->equals(*rhs))
+                return false;
+        }
+
+        return true;
+    };
+
     if (prepared_sets && ast_node)
     {
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
             return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
 
-        /// We have `PreparedSetKey::forLiteral` but it is useless here as we don't have enough information
-        /// about types in left argument of the IN operator. Instead, we manually iterate through all the sets
-        /// and find the one for the right arg based on the AST structure (getTreeHash), after that we check
-        /// that the types it was prepared with are compatible with the types of the primary key.
-        auto types_match = [&indexes_mapping, &data_types](const DataTypes & set_types)
-        {
-            assert(indexes_mapping.size() == data_types.size());
-
-            for (size_t i = 0; i < indexes_mapping.size(); ++i)
-            {
-                if (indexes_mapping[i].tuple_index >= set_types.size())
-                    return false;
-
-                auto lhs = recursiveRemoveLowCardinality(data_types[i]);
-                auto rhs = recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]);
-
-                if (!lhs->equals(*rhs))
-                    return false;
-            }
-
-            return true;
-        };
-
         auto tree_hash = ast_node->getTreeHash();
         for (const auto & [key, future_set] : prepared_sets->getSets())
         {
@@ -392,7 +392,12 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
     {
         const auto * node_without_alias = getNodeWithoutAlias(dag_node);
         if (node_without_alias->column)
-            return tryGetSetFromDAGNode(node_without_alias);
+        {
+            auto future_set = tryGetSetFromDAGNode(node_without_alias);
+            auto set_types = future_set->getTypes();
+            if (types_match(future_set->getTypes()))
+                return future_set;
+        }
     }
 
     return nullptr;
diff --git a/src/Storages/StorageSet.cpp b/src/Storages/StorageSet.cpp
index 00b5dbfc5e3..da94c87b69e 100644
--- a/src/Storages/StorageSet.cpp
+++ b/src/Storages/StorageSet.cpp
@@ -147,7 +147,7 @@ StorageSet::StorageSet(
     const String & comment,
     bool persistent_)
     : StorageSetOrJoinBase{disk_, relative_path_, table_id_, columns_, constraints_, comment, persistent_}
-    , set(std::make_shared<Set>(SizeLimits(), false, true))
+    , set(std::make_shared<Set>(SizeLimits(), false, 0, true))
 {
     Block header = getInMemoryMetadataPtr()->getSampleBlock();
     set->setHeader(header.getColumnsWithTypeAndName());
@@ -176,7 +176,7 @@ void StorageSet::truncate(const ASTPtr &, const StorageMetadataPtr & metadata_sn
     Block header = metadata_snapshot->getSampleBlock();
 
     increment = 0;
-    set = std::make_shared<Set>(SizeLimits(), false, true);
+    set = std::make_shared<Set>(SizeLimits(), false, 0, true);
     set->setHeader(header.getColumnsWithTypeAndName());
 }
 
diff --git a/tests/queries/0_stateless/01786_explain_merge_tree.reference b/tests/queries/0_stateless/01786_explain_merge_tree.reference
index e6628813dbd..8d3954484dd 100644
--- a/tests/queries/0_stateless/01786_explain_merge_tree.reference
+++ b/tests/queries/0_stateless/01786_explain_merge_tree.reference
@@ -10,7 +10,7 @@
         Keys: 
           y
           bitAnd(z, 3)
-        Condition: and((bitAnd(z, 3) not in [1, 1]), and((y in [1, +Inf)), (bitAnd(z, 3) not in [1, 1])))
+        Condition: and((y in [1, +Inf)), (bitAnd(z, 3) not in [1, 1]))
         Parts: 3/4
         Granules: 10/11
       PrimaryKey
@@ -46,7 +46,7 @@
                 {
                   "Type": "Partition",
                   "Keys": ["y", "bitAnd(z, 3)"],
-                  "Condition": "and((bitAnd(z, 3) not in [1, 1]), and((y in [1, +Inf)), (bitAnd(z, 3) not in [1, 1])))",
+                  "Condition": "and((y in [1, +Inf)), (bitAnd(z, 3) not in [1, 1]))",
                   "Initial Parts": 4,
                   "Selected Parts": 3,
                   "Initial Granules": 11,

From e7868e576c71de07d7dd4d921382d4cd549d6493 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 2 Jun 2023 00:50:14 +0000
Subject: [PATCH 0249/1478] Don't crash if config doesn't have logger section

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

diff --git a/src/Loggers/Loggers.cpp b/src/Loggers/Loggers.cpp
index 645ae5dcc7a..0c3a7bd615d 100644
--- a/src/Loggers/Loggers.cpp
+++ b/src/Loggers/Loggers.cpp
@@ -51,7 +51,7 @@ void Loggers::buildLoggers(Poco::Util::AbstractConfiguration & config, Poco::Log
 #endif
 
     auto current_logger = config.getString("logger", "");
-    if (config_logger == current_logger)
+    if (config_logger.has_value() && *config_logger == current_logger)
         return;
 
     config_logger = current_logger;
diff --git a/src/Loggers/Loggers.h b/src/Loggers/Loggers.h
index 31a215aa9ce..ebc10954b94 100644
--- a/src/Loggers/Loggers.h
+++ b/src/Loggers/Loggers.h
@@ -39,7 +39,7 @@ private:
     Poco::AutoPtr<Poco::Channel> syslog_channel;
 
     /// Previous value of logger element in config. It is used to reinitialize loggers whenever the value changed.
-    std::string config_logger;
+    std::optional<std::string> config_logger;
 
 #ifndef WITHOUT_TEXT_LOG
     std::weak_ptr<DB::TextLog> text_log;

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 0250/1478] 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 0251/1478] 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 0252/1478] 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 0253/1478] 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 0254/1478] 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 0255/1478] 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 0256/1478] 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 0257/1478] 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 0258/1478] 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 0259/1478] 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 0260/1478] 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 0261/1478] 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 0262/1478] 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 0263/1478] 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 0264/1478] 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 0265/1478] 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 0266/1478] 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 0267/1478] 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 0268/1478] 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 0269/1478] 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 0270/1478] 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 0271/1478] 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 0272/1478] 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 0273/1478] 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 0274/1478] 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 0275/1478] 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 0276/1478] 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 0277/1478] 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 0278/1478] 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 0279/1478] 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 0ddd53088d48134cdbd55bcda2e6bc3bfad423de Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 31 May 2023 23:17:41 +0200
Subject: [PATCH 0280/1478] Add a new runner type for ci metrics and
 autoscaling

---
 tests/ci/autoscale_runners_lambda/app.py                 | 4 ++++
 tests/ci/lambda_shared_package/lambda_shared/__init__.py | 1 +
 2 files changed, 5 insertions(+)

diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index ab09afb3aa8..825708cabbc 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -65,6 +65,10 @@ def get_scales(runner_type: str) -> Tuple[int, int]:
         # 10. I am trying 7 now.
         # UPDATE THE COMMENT ON CHANGES
         scale_up = 7
+    elif runner_type == "limited-tester":
+        # The limited runners should inflate and deflate faster
+        scale_down = 1
+        scale_up = 2
     return scale_down, scale_up
 
 
diff --git a/tests/ci/lambda_shared_package/lambda_shared/__init__.py b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
index 534d7773ddd..c56994cc86a 100644
--- a/tests/ci/lambda_shared_package/lambda_shared/__init__.py
+++ b/tests/ci/lambda_shared_package/lambda_shared/__init__.py
@@ -15,6 +15,7 @@ RUNNER_TYPE_LABELS = [
     "func-tester",
     "func-tester-aarch64",
     "fuzzer-unit-tester",
+    "limited-tester",
     "stress-tester",
     "style-checker",
     "style-checker-aarch64",

From b7c5fdab77c41361af7b5130256a2afdf2bc1488 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 31 May 2023 23:56:39 +0200
Subject: [PATCH 0281/1478] Move lambda package building to
 public.ecr.aws/lambda/python for compatibility

---
 tests/ci/lambda_shared_package/pyproject.toml         | 5 +++--
 tests/ci/team_keys_lambda/build_and_deploy_archive.sh | 6 +++---
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/tests/ci/lambda_shared_package/pyproject.toml b/tests/ci/lambda_shared_package/pyproject.toml
index bbf74cc0649..dff36b89fbb 100644
--- a/tests/ci/lambda_shared_package/pyproject.toml
+++ b/tests/ci/lambda_shared_package/pyproject.toml
@@ -6,13 +6,14 @@ build-backend = "setuptools.build_meta"
 name = "lambda_shared"
 version = "0.0.1"
 dependencies = [
-  "requests < 2.30",
+  "requests",
+  "urllib3 < 2"
 ]
 
 [project.optional-dependencies]
 token = [
   "PyJWT",
-  "cryptography<38",
+  "cryptography",
 ]
 dev = [
   "boto3",
diff --git a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
index 89a2d514965..02d5638cf18 100644
--- a/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
+++ b/tests/ci/team_keys_lambda/build_and_deploy_archive.sh
@@ -12,7 +12,7 @@ DRY_RUN=${DRY_RUN:-}
 PY_VERSION=${PY_VERSION:-3.10}
 PY_EXEC="python${PY_VERSION}"
 # Image to build the lambda zip package
-DOCKER_IMAGE="python:${PY_VERSION}-slim"
+DOCKER_IMAGE="public.ecr.aws/lambda/python:${PY_VERSION}"
 # Rename the_lambda_name directory to the-lambda-name lambda in AWS
 LAMBDA_NAME=${DIR_NAME//_/-}
 # The name of directory with lambda code
@@ -23,9 +23,9 @@ cp app.py "$PACKAGE"
 if [ -f requirements.txt ]; then
   VENV=lambda-venv
   rm -rf "$VENV" lambda-package.zip
-  docker run --rm --user="${UID}" -e HOME=/tmp \
+  docker run --rm --user="${UID}" -e HOME=/tmp --entrypoint=/bin/bash \
     --volume="${WORKDIR}/..:/ci" --workdir="/ci/${DIR_NAME}" "${DOCKER_IMAGE}" \
-    /bin/bash -exc "
+    -exc "
       '$PY_EXEC' -m venv '$VENV' &&
       source '$VENV/bin/activate' &&
       pip install -r requirements.txt

From e657e2ba10c425caa550de6e9b3814dca8fc3f32 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 1 Jun 2023 17:12:19 +0200
Subject: [PATCH 0282/1478] Additional logging in autoscale_runners_lambda

---
 tests/ci/autoscale_runners_lambda/app.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index 825708cabbc..bebfb594b59 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -117,7 +117,17 @@ def set_capacity(
         # Finally, should the capacity be even changed
         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",
+                asg["AutoScalingGroupName"],
+                desired_capacity,
+                asg["MaxSize"],
+                running,
+                queued,
+            )
             return
+
         logging.info(
             "The ASG %s capacity will be increased to %s, current capacity=%s, "
             "maximum capacity=%s, running jobs=%s, queue size=%s",
@@ -142,6 +152,15 @@ def set_capacity(
     desired_capacity = min(desired_capacity, asg["MaxSize"])
     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",
+            asg["AutoScalingGroupName"],
+            desired_capacity,
+            asg["MinSize"],
+            running,
+            queued,
+        )
         return
 
     logging.info(

From b775b5cfd6eb924bc119ea80b08fde9a4bb42a1b Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 1 Jun 2023 17:44:57 +0200
Subject: [PATCH 0283/1478] Move all CI runners metrics into one namespace

---
 tests/ci/ci_runners_metrics_lambda/app.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index dc128dea739..d8b9489b1a7 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -171,18 +171,21 @@ def group_runners_by_tag(
 
 
 def push_metrics_to_cloudwatch(
-    listed_runners: RunnerDescriptions, namespace: str
+    listed_runners: RunnerDescriptions, group_name: str
 ) -> None:
     client = boto3.client("cloudwatch")
+    namespace = "RunnersMetrics"
     metrics_data = []
     busy_runners = sum(
         1 for runner in listed_runners if runner.busy and not runner.offline
     )
+    dimensions = [{"Name": "group", "Value": group_name}]
     metrics_data.append(
         {
             "MetricName": "BusyRunners",
             "Value": busy_runners,
             "Unit": "Count",
+            "Dimensions": dimensions,
         }
     )
     total_active_runners = sum(1 for runner in listed_runners if not runner.offline)
@@ -191,6 +194,7 @@ def push_metrics_to_cloudwatch(
             "MetricName": "ActiveRunners",
             "Value": total_active_runners,
             "Unit": "Count",
+            "Dimensions": dimensions,
         }
     )
     total_runners = len(listed_runners)
@@ -199,6 +203,7 @@ def push_metrics_to_cloudwatch(
             "MetricName": "TotalRunners",
             "Value": total_runners,
             "Unit": "Count",
+            "Dimensions": dimensions,
         }
     )
     if total_active_runners == 0:
@@ -211,6 +216,7 @@ def push_metrics_to_cloudwatch(
             "MetricName": "BusyRunnersRatio",
             "Value": busy_ratio,
             "Unit": "Percent",
+            "Dimensions": dimensions,
         }
     )
 
@@ -242,7 +248,7 @@ def main(
     for group, group_runners in grouped_runners.items():
         if push_to_cloudwatch:
             print(f"Pushing metrics for group '{group}'")
-            push_metrics_to_cloudwatch(group_runners, "RunnersMetrics/" + group)
+            push_metrics_to_cloudwatch(group_runners, group)
         else:
             print(group, f"({len(group_runners)})")
             for runner in group_runners:

From 3c13eaa1592b5cf46d6aca8b3764aefc546eeff7 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 1 Jun 2023 22:03:42 +0200
Subject: [PATCH 0284/1478] Simplify get_dead_runners_in_ec2 a little bit,
 update runners

---
 tests/ci/ci_runners_metrics_lambda/app.py | 62 +++++++++++------------
 1 file changed, 31 insertions(+), 31 deletions(-)

diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index d8b9489b1a7..9c38659269b 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -99,44 +99,44 @@ def get_dead_runners_in_ec2(runners: RunnerDescriptions) -> RunnerDescriptions:
 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"]}]
+        Filters=[{"Name": "tag-key", "Values": ["github:runner-type"]}],
     )["Reservations"]
-    lost_instances = []
-    offline_runners = [
-        runner.name for runner in runners if runner.offline and not runner.busy
+    # flatten the reservation into instances
+    instances = [
+        instance
+        for reservation in reservations
+        for instance in reservation["Instances"]
     ]
-    # Here we refresh the runners to get the most recent state
+    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 reservation in reservations:
-        for instance in reservation["Instances"]:
-            # Do not consider instances started 20 minutes ago as problematic
-            if now - instance["LaunchTime"].timestamp() < 1200:
-                continue
+    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
+        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_runners:
-                lost_instances.append(instance)
-                continue
+        if instance["InstanceId"] in offline_runner_names:
+            lost_instances.append(instance)
+            continue
 
-            if instance["State"]["Name"] == "running" and (
-                not [
-                    runner
-                    for runner in runners
-                    if runner.name == instance["InstanceId"]
-                ]
-            ):
-                lost_instances.append(instance)
+        if (
+            instance["State"]["Name"] == "running"
+            and not instance["InstanceId"] in runner_names
+        ):
+            lost_instances.append(instance)
 
     return lost_instances
 

From 9bd0a53e7c3ce6b1ad86bc09b134319a8563ff47 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 1 Jun 2023 22:28:02 +0200
Subject: [PATCH 0285/1478] Get only online instances in get_lost_ec2_instances

---
 tests/ci/ci_runners_metrics_lambda/app.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index 9c38659269b..71a644fe072 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -99,7 +99,10 @@ def get_dead_runners_in_ec2(runners: RunnerDescriptions) -> RunnerDescriptions:
 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"]}],
+        Filters=[
+            {"Name": "tag-key", "Values": ["github:runner-type"]},
+            {"Name": "instance-state-name", "Values": ["pending", "running"]},
+        ],
     )["Reservations"]
     # flatten the reservation into instances
     instances = [

From 79c14c89ee39bea6017e41e375f9b6a59e3e7899 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 2 Jun 2023 12:53:25 +0200
Subject: [PATCH 0286/1478] Add some assertions

---
 src/Interpreters/Cache/FileCache.cpp   |  6 +++---
 src/Interpreters/Cache/FileSegment.cpp | 18 +++++++++++++-----
 src/Interpreters/Cache/Metadata.cpp    | 21 ++++++++++++---------
 src/Interpreters/Cache/Metadata.h      |  4 ++--
 4 files changed, 30 insertions(+), 19 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 1908a4ce895..163e1b71ab9 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -48,12 +48,12 @@ const String & FileCache::getBasePath() const
 
 String FileCache::getPathInLocalCache(const Key & key, size_t offset, FileSegmentKind segment_kind) const
 {
-    return metadata.getPathInLocalCache(key, offset, segment_kind);
+    return metadata.getPathForFileSegment(key, offset, segment_kind);
 }
 
 String FileCache::getPathInLocalCache(const Key & key) const
 {
-    return metadata.getPathInLocalCache(key);
+    return metadata.getPathForKey(key);
 }
 
 void FileCache::assertInitialized() const
@@ -1019,7 +1019,7 @@ std::vector<String> FileCache::tryGetCachePaths(const Key & key)
     for (const auto & [offset, file_segment_metadata] : *locked_key->getKeyMetadata())
     {
         if (file_segment_metadata->file_segment->state() == FileSegment::State::DOWNLOADED)
-            cache_paths.push_back(metadata.getPathInLocalCache(key, offset, file_segment_metadata->file_segment->getKind()));
+            cache_paths.push_back(metadata.getPathForFileSegment(key, offset, file_segment_metadata->file_segment->getKind()));
     }
     return cache_paths;
 }
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 60228573666..fb0ba0eba14 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -313,6 +313,13 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
     if (!size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Writing zero size is not allowed");
 
+    auto file_segment_path = getPathInLocalCache();
+    if (offset == range().left && fs::exists(file_segment_path))
+    {
+        fs::remove(file_segment_path);
+        chassert(false);
+    }
+
     {
         auto lock = segment_guard.lock();
 
@@ -365,7 +372,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
 
         downloaded_size += size;
 
-        chassert(std::filesystem::file_size(getPathInLocalCache()) == downloaded_size);
+        chassert(std::filesystem::file_size(file_segment_path) == downloaded_size);
     }
     catch (ErrnoException & e)
     {
@@ -375,7 +382,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
         int code = e.getErrno();
         if (code == /* No space left on device */28 || code == /* Quota exceeded */122)
         {
-            const auto file_size = fs::file_size(getPathInLocalCache());
+            const auto file_size = fs::file_size(file_segment_path);
             chassert(downloaded_size <= file_size);
             chassert(reserved_size >= file_size);
             if (downloaded_size != file_size)
@@ -520,8 +527,8 @@ void FileSegment::setDownloadedUnlocked(const FileSegmentGuard::Lock &)
         remote_file_reader.reset();
     }
 
-    chassert(getDownloadedSize(false) > 0);
-    chassert(fs::file_size(getPathInLocalCache()) > 0);
+    chassert(downloaded_size > 0);
+    chassert(fs::file_size(getPathInLocalCache()) == downloaded_size);
 }
 
 void FileSegment::setDownloadFailedUnlocked(const FileSegmentGuard::Lock & lock)
@@ -845,7 +852,8 @@ void FileSegment::detach(const FileSegmentGuard::Lock & lock, const LockedKey &)
     if (download_state == State::DETACHED)
         return;
 
-    resetDownloaderUnlocked(lock);
+    if (!downloader_id.empty())
+        resetDownloaderUnlocked(lock);
     setDetachedState(lock);
 }
 
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 843ffd45b63..9dff77e2af8 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -145,15 +145,12 @@ String CacheMetadata::getFileNameForFileSegment(size_t offset, FileSegmentKind s
     return std::to_string(offset) + file_suffix;
 }
 
-String CacheMetadata::getPathInLocalCache(const Key & key, size_t offset, FileSegmentKind segment_kind) const
+String CacheMetadata::getPathForFileSegment(const Key & key, size_t offset, FileSegmentKind segment_kind) const
 {
-    String file_suffix;
-
-    const auto key_str = key.toString();
-    return fs::path(path) / key_str.substr(0, 3) / key_str / getFileNameForFileSegment(offset, segment_kind);
+    return fs::path(getPathForKey(key)) / getFileNameForFileSegment(offset, segment_kind);
 }
 
-String CacheMetadata::getPathInLocalCache(const Key & key) const
+String CacheMetadata::getPathForKey(const Key & key) const
 {
     const auto key_str = key.toString();
     return fs::path(path) / key_str.substr(0, 3) / key_str;
@@ -178,7 +175,7 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
 
             it = emplace(
                 key, std::make_shared<KeyMetadata>(
-                    key, getPathInLocalCache(key), *cleanup_queue, is_initial_load)).first;
+                    key, getPathForKey(key), *cleanup_queue, is_initial_load)).first;
         }
 
         key_metadata = it->second;
@@ -260,7 +257,7 @@ void CacheMetadata::doCleanup()
         erase(it);
         LOG_DEBUG(log, "Key {} is removed from metadata", cleanup_key);
 
-        const fs::path key_directory = getPathInLocalCache(cleanup_key);
+        const fs::path key_directory = getPathForKey(cleanup_key);
         const fs::path key_prefix_directory = key_directory.parent_path();
 
         try
@@ -370,8 +367,14 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
         file_segment->queue_iterator->annul();
 
     const auto path = key_metadata->getFileSegmentPath(*file_segment);
-    if (fs::exists(path))
+    bool exists = fs::exists(path);
+    if (exists)
+    {
+        LOG_TEST(log, "Removed file segment at path: {}", path);
         fs::remove(path);
+    }
+    else if (file_segment->downloaded_size)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist");
 
     file_segment->detach(segment_lock, *this);
     return key_metadata->erase(it);
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 2e015b07ed0..a7e101c3d9d 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -85,12 +85,12 @@ public:
 
     const String & getBaseDirectory() const { return path; }
 
-    String getPathInLocalCache(
+    String getPathForFileSegment(
         const Key & key,
         size_t offset,
         FileSegmentKind segment_kind) const;
 
-    String getPathInLocalCache(const Key & key) const;
+    String getPathForKey(const Key & key) const;
     static String getFileNameForFileSegment(size_t offset, FileSegmentKind segment_kind);
 
     void iterate(IterateCacheMetadataFunc && func);

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 0287/1478] 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 0288/1478] 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 5cb4363e58bf1553bd80a930779cda2a79ef34b0 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 2 Jun 2023 14:44:28 +0200
Subject: [PATCH 0289/1478] Remove assertion

---
 src/Interpreters/Cache/FileSegment.cpp | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index fb0ba0eba14..f3a21749086 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -313,12 +313,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
     if (!size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Writing zero size is not allowed");
 
-    auto file_segment_path = getPathInLocalCache();
-    if (offset == range().left && fs::exists(file_segment_path))
-    {
-        fs::remove(file_segment_path);
-        chassert(false);
-    }
+    const auto file_segment_path = getPathInLocalCache();
 
     {
         auto lock = segment_guard.lock();
@@ -358,7 +353,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
                     "Cache writer was finalized (downloaded size: {}, state: {})",
                     current_downloaded_size, stateToString(download_state));
 
-            cache_writer = std::make_unique<WriteBufferFromFile>(getPathInLocalCache());
+            cache_writer = std::make_unique<WriteBufferFromFile>(file_segment_path);
         }
     }
 
@@ -385,6 +380,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
             const auto file_size = fs::file_size(file_segment_path);
             chassert(downloaded_size <= file_size);
             chassert(reserved_size >= file_size);
+            chassert(file_size <= range().right + 1);
             if (downloaded_size != file_size)
                 downloaded_size = file_size;
         }

From 21e9877098c24fc90319fae2682a815da8fef389 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 2 Jun 2023 15:08:04 +0200
Subject: [PATCH 0290/1478] Add assertion

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index a60f5dffa96..561a66a826f 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -932,18 +932,23 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
             ProfileEvents::increment(ProfileEvents::CachedReadBufferReadFromCacheBytes, size);
             ProfileEvents::increment(ProfileEvents::CachedReadBufferReadFromCacheMicroseconds, elapsed);
 
-#ifdef ABORT_ON_LOGICAL_ERROR
             const size_t new_file_offset = file_offset_of_buffer_end + size;
-            chassert(new_file_offset - 1 <= file_segment.range().right);
             const size_t file_segment_write_offset = file_segment.getCurrentWriteOffset(true);
+            if (new_file_offset > file_segment.range().right + 1)
+            {
+                auto file_segment_path = file_segment.getPathInLocalCache();
+                throw Exception(
+                    ErrorCodes::LOGICAL_ERROR,
+                    "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)
             {
-                LOG_TRACE(
-                    log, "Read {} bytes, file offset: {}, segment: {}, 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);
-                chassert(false);
             }
-#endif
         }
         else
         {

From 8e076c33d51d6ecdfa209158d75305befd6ab308 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 2 Jun 2023 13:19:13 +0000
Subject: [PATCH 0291/1478] Try fix flaky test test_async_query_sending

---
 tests/integration/test_hedged_requests/configs/logger.xml | 5 +++++
 tests/integration/test_hedged_requests/test.py            | 5 ++++-
 2 files changed, 9 insertions(+), 1 deletion(-)
 create mode 100644 tests/integration/test_hedged_requests/configs/logger.xml

diff --git a/tests/integration/test_hedged_requests/configs/logger.xml b/tests/integration/test_hedged_requests/configs/logger.xml
new file mode 100644
index 00000000000..48fb4e91428
--- /dev/null
+++ b/tests/integration/test_hedged_requests/configs/logger.xml
@@ -0,0 +1,5 @@
+<clickhouse>
+    <logger>
+        <count>20</count>
+    </logger>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_hedged_requests/test.py b/tests/integration/test_hedged_requests/test.py
index 2ca37fbb7ee..be6cea80f87 100644
--- a/tests/integration/test_hedged_requests/test.py
+++ b/tests/integration/test_hedged_requests/test.py
@@ -23,7 +23,7 @@ def started_cluster():
     NODES["node"] = cluster.add_instance(
         "node",
         stay_alive=True,
-        main_configs=["configs/remote_servers.xml"],
+        main_configs=["configs/remote_servers.xml", "configs/logger.xml"],
         user_configs=["configs/users.xml"],
     )
 
@@ -377,6 +377,9 @@ def test_async_connect(started_cluster):
     check_changing_replica_events(2)
     check_if_query_sending_was_not_suspended()
 
+    # Restart server to reset connection pool state
+    NODES["node"].restart_clickhouse()
+
     NODES["node"].query(
         "SELECT hostName(), id FROM distributed_connect ORDER BY id LIMIT 1 SETTINGS prefer_localhost_replica = 0, connect_timeout_with_failover_ms=5000, async_query_sending_for_remote=1, max_threads=1"
     )

From d9a4f8115fb7f362e93dc59e38a8d649d016e0e7 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 2 Jun 2023 13:19:41 +0000
Subject: [PATCH 0292/1478] Add new line delimiter

---
 tests/integration/test_hedged_requests/configs/logger.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/test_hedged_requests/configs/logger.xml b/tests/integration/test_hedged_requests/configs/logger.xml
index 48fb4e91428..b341b14d43c 100644
--- a/tests/integration/test_hedged_requests/configs/logger.xml
+++ b/tests/integration/test_hedged_requests/configs/logger.xml
@@ -2,4 +2,4 @@
     <logger>
         <count>20</count>
     </logger>
-</clickhouse>
\ No newline at end of file
+</clickhouse>

From 336c9d71360f8c289394c0b8018cc523464b8aef Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 2 Jun 2023 13:31:14 +0000
Subject: [PATCH 0293/1478] Apply uncommitted state after snapshot deser

---
 src/Coordination/KeeperStateMachine.cpp       |  5 ++
 src/Coordination/KeeperStorage.cpp            | 51 ++++++++----
 src/Coordination/KeeperStorage.h              |  5 ++
 src/Coordination/tests/gtest_coordination.cpp | 77 +++++++++++++++++++
 4 files changed, 124 insertions(+), 14 deletions(-)

diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 6635c74149a..a4568cbbdd3 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -363,6 +363,7 @@ bool KeeperStateMachine::apply_snapshot(nuraft::snapshot & s)
         else if (s.get_last_log_idx() < latest_snapshot_meta->get_last_log_idx())
         {
             LOG_INFO(log, "A snapshot with a larger last log index ({}) was created, skipping applying this snapshot", latest_snapshot_meta->get_last_log_idx());
+            return true;
         }
 
         latest_snapshot_ptr = latest_snapshot_buf;
@@ -372,6 +373,10 @@ bool KeeperStateMachine::apply_snapshot(nuraft::snapshot & s)
         std::lock_guard lock(storage_and_responses_lock);
         auto snapshot_deserialization_result
             = snapshot_manager.deserializeSnapshotFromBuffer(snapshot_manager.deserializeSnapshotBufferFromDisk(s.get_last_log_idx()));
+
+        /// maybe some logs were preprocessed with log idx larger than the snapshot idx
+        /// we have to apply them to the new storage
+        storage->applyUncommittedState(*snapshot_deserialization_result.storage, s.get_last_log_idx());
         storage = std::move(snapshot_deserialization_result.storage);
         latest_snapshot_meta = snapshot_deserialization_result.snapshot_meta;
         cluster_config = snapshot_deserialization_result.cluster_config;
diff --git a/src/Coordination/KeeperStorage.cpp b/src/Coordination/KeeperStorage.cpp
index 7a1a5e42632..66d6b0f5843 100644
--- a/src/Coordination/KeeperStorage.cpp
+++ b/src/Coordination/KeeperStorage.cpp
@@ -375,23 +375,26 @@ void KeeperStorage::UncommittedState::applyDelta(const Delta & delta)
         delta.operation);
 }
 
+void KeeperStorage::UncommittedState::addDelta(Delta new_delta)
+{
+    const auto & added_delta = deltas.emplace_back(std::move(new_delta));
+
+    if (!added_delta.path.empty())
+    {
+        deltas_for_path[added_delta.path].push_back(&added_delta);
+        applyDelta(added_delta);
+    }
+    else if (const auto * auth_delta = std::get_if<AddAuthDelta>(&added_delta.operation))
+    {
+        auto & uncommitted_auth = session_and_auth[auth_delta->session_id];
+        uncommitted_auth.emplace_back(&auth_delta->auth_id);
+    }
+}
+
 void KeeperStorage::UncommittedState::addDeltas(std::vector<Delta> new_deltas)
 {
     for (auto & delta : new_deltas)
-    {
-        const auto & added_delta = deltas.emplace_back(std::move(delta));
-
-        if (!added_delta.path.empty())
-        {
-            deltas_for_path[added_delta.path].push_back(&added_delta);
-            applyDelta(added_delta);
-        }
-        else if (const auto * auth_delta = std::get_if<AddAuthDelta>(&added_delta.operation))
-        {
-            auto & uncommitted_auth = session_and_auth[auth_delta->session_id];
-            uncommitted_auth.emplace_back(&auth_delta->auth_id);
-        }
-    }
+        addDelta(std::move(delta));
 }
 
 void KeeperStorage::UncommittedState::commit(int64_t commit_zxid)
@@ -602,6 +605,26 @@ namespace
 
 }
 
+void KeeperStorage::applyUncommittedState(KeeperStorage & other, int64_t last_zxid)
+{
+    for (const auto & transaction : uncommitted_transactions)
+    {
+        if (transaction.zxid <= last_zxid)
+            continue;
+        other.uncommitted_transactions.push_back(transaction);
+    }
+
+    auto it = uncommitted_state.deltas.begin();
+
+    for (; it != uncommitted_state.deltas.end(); ++it)
+    {
+        if (it->zxid <= last_zxid)
+            continue;
+
+        other.uncommitted_state.addDelta(*it);
+    }
+}
+
 Coordination::Error KeeperStorage::commit(int64_t commit_zxid)
 {
     // Deltas are added with increasing ZXIDs
diff --git a/src/Coordination/KeeperStorage.h b/src/Coordination/KeeperStorage.h
index 7eb10be3847..844cbf85c1e 100644
--- a/src/Coordination/KeeperStorage.h
+++ b/src/Coordination/KeeperStorage.h
@@ -222,6 +222,7 @@ public:
     {
         explicit UncommittedState(KeeperStorage & storage_) : storage(storage_) { }
 
+        void addDelta(Delta new_delta);
         void addDeltas(std::vector<Delta> new_deltas);
         void commit(int64_t commit_zxid);
         void rollback(int64_t rollback_zxid);
@@ -310,6 +311,10 @@ public:
 
     UncommittedState uncommitted_state{*this};
 
+    // Apply uncommitted state to another storage using only transactions
+    // with zxid > last_zxid
+    void applyUncommittedState(KeeperStorage & other, int64_t last_zxid);
+
     Coordination::Error commit(int64_t zxid);
 
     // Create node in the storage
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index 62217fb2dd3..453fd0f2e60 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -2524,6 +2524,83 @@ TEST_P(CoordinationTest, TestCheckNotExistsRequest)
     }
 }
 
+TEST_P(CoordinationTest, TestReapplyingDeltas)
+{
+    using namespace DB;
+    using namespace Coordination;
+
+    static constexpr int64_t initial_zxid = 100;
+
+    const auto create_request = std::make_shared<ZooKeeperCreateRequest>();
+    create_request->path = "/test/data";
+    create_request->is_sequential = true;
+
+    const auto process_create = [](KeeperStorage & storage, const auto & request, int64_t zxid)
+    {
+        storage.preprocessRequest(request, 1, 0, zxid);
+        auto responses = storage.processRequest(request, 1, zxid);
+        EXPECT_GE(responses.size(), 1);
+        EXPECT_EQ(responses[0].response->error, Error::ZOK);
+    };
+
+    const auto commit_initial_data = [&](auto & storage)
+    {
+        int64_t zxid = 1;
+
+        const auto root_create = std::make_shared<ZooKeeperCreateRequest>();
+        root_create->path = "/test";
+        process_create(storage, root_create, zxid);
+        ++zxid;
+
+        for (; zxid <= initial_zxid; ++zxid)
+            process_create(storage, create_request, zxid);
+    };
+
+    KeeperStorage storage1{500, "", keeper_context};
+    commit_initial_data(storage1);
+
+    for (int64_t zxid = initial_zxid + 1; zxid < initial_zxid + 50; ++zxid)
+        storage1.preprocessRequest(create_request, 1, 0, zxid);
+
+    /// create identical new storage
+    KeeperStorage storage2{500, "", keeper_context};
+    commit_initial_data(storage2);
+
+    storage1.applyUncommittedState(storage2, initial_zxid);
+
+    const auto commit_unprocessed = [&](KeeperStorage & storage)
+    {
+        for (int64_t zxid = initial_zxid + 1; zxid < initial_zxid + 50; ++zxid)
+        {
+            auto responses = storage.processRequest(create_request, 1, zxid);
+            EXPECT_GE(responses.size(), 1);
+            EXPECT_EQ(responses[0].response->error, Error::ZOK);
+        }
+    };
+
+    commit_unprocessed(storage1);
+    commit_unprocessed(storage2);
+
+    const auto get_children = [&](KeeperStorage & storage)
+    {
+        const auto list_request = std::make_shared<ZooKeeperListRequest>();
+        list_request->path = "/test";
+        auto responses = storage.processRequest(list_request, 1, std::nullopt, /*check_acl=*/true, /*is_local=*/true);
+        EXPECT_EQ(responses.size(), 1);
+        const auto * list_response = dynamic_cast<const ListResponse *>(responses[0].response.get());
+        EXPECT_TRUE(list_response);
+        return list_response->names;
+    };
+
+    auto children1 = get_children(storage1);
+    std::unordered_set<std::string> children1_set(children1.begin(), children1.end());
+
+    auto children2 = get_children(storage2);
+    std::unordered_set<std::string> children2_set(children2.begin(), children2.end());
+
+    ASSERT_TRUE(children1_set == children2_set);
+}
+
 INSTANTIATE_TEST_SUITE_P(CoordinationTestSuite,
     CoordinationTest,
     ::testing::ValuesIn(std::initializer_list<CompressionParam>{

From 36129c3d20bef74c4502126b2c37001e2c80b8d2 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 2 Jun 2023 13:36:14 +0000
Subject: [PATCH 0294/1478] Try to fix last tests.

---
 src/Storages/MergeTree/RPNBuilder.cpp                       | 6 ++++--
 .../0_stateless/00981_in_subquery_with_tuple.reference      | 3 ---
 tests/queries/0_stateless/01651_bugs_from_15889.reference   | 1 +
 tests/queries/0_stateless/01651_bugs_from_15889.sql         | 5 ++---
 4 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index c9feb533ea3..b82c350fa1a 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -366,8 +366,10 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
             if (indexes_mapping[i].tuple_index >= set_types.size())
                 return false;
 
-            auto lhs = recursiveRemoveLowCardinality(data_types[i]);
-            auto rhs = recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]);
+            auto lhs = removeNullable(recursiveRemoveLowCardinality(data_types[i]));
+            auto rhs = removeNullable(recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]));
+
+            // std::cerr << "============ " << lhs->getName() << ' ' << rhs->getName() << std::endl;
 
             if (!lhs->equals(*rhs))
                 return false;
diff --git a/tests/queries/0_stateless/00981_in_subquery_with_tuple.reference b/tests/queries/0_stateless/00981_in_subquery_with_tuple.reference
index 673d035ede6..833a8c93d24 100644
--- a/tests/queries/0_stateless/00981_in_subquery_with_tuple.reference
+++ b/tests/queries/0_stateless/00981_in_subquery_with_tuple.reference
@@ -1,7 +1,4 @@
-OK1
 OK2
 OK3
-OK4
-OK5
 2019-08-11	world
 2019-08-12	hello
diff --git a/tests/queries/0_stateless/01651_bugs_from_15889.reference b/tests/queries/0_stateless/01651_bugs_from_15889.reference
index 8b137891791..77ac542d4fb 100644
--- a/tests/queries/0_stateless/01651_bugs_from_15889.reference
+++ b/tests/queries/0_stateless/01651_bugs_from_15889.reference
@@ -1 +1,2 @@
+0
 
diff --git a/tests/queries/0_stateless/01651_bugs_from_15889.sql b/tests/queries/0_stateless/01651_bugs_from_15889.sql
index 4717a8dcc0d..6a8c6d35911 100644
--- a/tests/queries/0_stateless/01651_bugs_from_15889.sql
+++ b/tests/queries/0_stateless/01651_bugs_from_15889.sql
@@ -8,10 +8,9 @@ INSERT INTO xp SELECT '2020-01-01', number, '' FROM numbers(100000);
 
 CREATE TABLE xp_d AS xp ENGINE = Distributed(test_shard_localhost, currentDatabase(), xp);
 
--- FIXME: this query spontaneously returns either 8 or 20 error code. Looks like it's potentially flaky.
--- SELECT count(7 = (SELECT number FROM numbers(0) ORDER BY number ASC NULLS FIRST LIMIT 7)) FROM xp_d PREWHERE toYYYYMM(A) GLOBAL IN (SELECT NULL = (SELECT number FROM numbers(1) ORDER BY number DESC NULLS LAST LIMIT 1), toYYYYMM(min(A)) FROM xp_d) WHERE B > NULL; -- { serverError 8 }
+SELECT count(7 = (SELECT number FROM numbers(0) ORDER BY number ASC NULLS FIRST LIMIT 7)) FROM xp_d PREWHERE toYYYYMM(A) GLOBAL IN (SELECT NULL = (SELECT number FROM numbers(1) ORDER BY number DESC NULLS LAST LIMIT 1), toYYYYMM(min(A)) FROM xp_d) WHERE B > NULL; -- { serverError 8 }
 
-SELECT count() FROM xp_d WHERE A GLOBAL IN (SELECT NULL); -- { serverError 53 }
+SELECT count() FROM xp_d WHERE A GLOBAL IN (SELECT NULL);
 
 DROP TABLE IF EXISTS xp;
 DROP TABLE IF EXISTS xp_d;

From 5e17adc9c0cab1ac911ccf6c7ad3cb1f8d8c7447 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Fri, 2 Jun 2023 14:08:14 +0000
Subject: [PATCH 0295/1478] Add `system.user_processes` table

---
 .../System/StorageSystemUserProcesses.cpp     | 60 +++++++++++++++++++
 .../System/StorageSystemUserProcesses.h       | 29 +++++++++
 src/Storages/System/attachSystemTables.cpp    |  2 +
 3 files changed, 91 insertions(+)
 create mode 100644 src/Storages/System/StorageSystemUserProcesses.cpp
 create mode 100644 src/Storages/System/StorageSystemUserProcesses.h

diff --git a/src/Storages/System/StorageSystemUserProcesses.cpp b/src/Storages/System/StorageSystemUserProcesses.cpp
new file mode 100644
index 00000000000..5973f9e2af3
--- /dev/null
+++ b/src/Storages/System/StorageSystemUserProcesses.cpp
@@ -0,0 +1,60 @@
+#include <Columns/ColumnArray.h>
+#include <Columns/ColumnsNumber.h>
+#include <Core/Settings.h>
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeFactory.h>
+#include <DataTypes/DataTypeMap.h>
+#include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypesNumber.h>
+#include <Interpreters/Context.h>
+#include <Interpreters/ProcessList.h>
+#include <Interpreters/ProfileEventsExt.h>
+#include <Storages/System/StorageSystemUserProcesses.h>
+#include <Common/IPv6ToBinary.h>
+#include <Common/typeid_cast.h>
+
+
+namespace DB
+{
+
+NamesAndTypesList StorageSystemUserProcesses::getNamesAndTypes()
+{
+    return {
+        {"user", std::make_shared<DataTypeString>()},
+        {"memory_usage", std::make_shared<DataTypeInt64>()},
+        {"peak_memory_usage", std::make_shared<DataTypeInt64>()},
+        {"ProfileEvents", std::make_shared<DataTypeMap>(std::make_shared<DataTypeString>(), std::make_shared<DataTypeUInt64>())},
+    };
+}
+
+NamesAndAliases StorageSystemUserProcesses::getNamesAndAliases()
+{
+    return {
+        {"ProfileEvents.Names", {std::make_shared<DataTypeArray>(std::make_shared<DataTypeString>())}, "mapKeys(ProfileEvents)"},
+        {"ProfileEvents.Values", {std::make_shared<DataTypeArray>(std::make_shared<DataTypeUInt64>())}, "mapValues(ProfileEvents)"}};
+}
+
+void StorageSystemUserProcesses::fillData(MutableColumns & res_columns, ContextPtr context, const SelectQueryInfo &) const
+{
+    const auto user_info = context->getProcessList().getUserInfo(true);
+
+    for (const auto & [user, info] : user_info)
+    {
+        size_t i = 0;
+
+        res_columns[i++]->insert(user);
+        res_columns[i++]->insert(info.memory_usage);
+        res_columns[i++]->insert(info.peak_memory_usage);
+        {
+            IColumn * column = res_columns[i++].get();
+
+            if (info.profile_counters)
+                ProfileEvents::dumpToMapColumn(*info.profile_counters, column, true);
+            else
+            {
+                column->insertDefault();
+            }
+        }
+    }
+}
+}
diff --git a/src/Storages/System/StorageSystemUserProcesses.h b/src/Storages/System/StorageSystemUserProcesses.h
new file mode 100644
index 00000000000..9bdc009d849
--- /dev/null
+++ b/src/Storages/System/StorageSystemUserProcesses.h
@@ -0,0 +1,29 @@
+#pragma once
+
+#include <Storages/System/IStorageSystemOneBlock.h>
+
+
+namespace DB
+{
+
+class Context;
+
+
+/** Implements `processes` system table, which allows you to get information about the queries that are currently executing.
+  */
+class StorageSystemUserProcesses final : public IStorageSystemOneBlock<StorageSystemUserProcesses>
+{
+public:
+    std::string getName() const override { return "SystemUserProcesses"; }
+
+    static NamesAndTypesList getNamesAndTypes();
+
+    static NamesAndAliases getNamesAndAliases();
+
+protected:
+    using IStorageSystemOneBlock::IStorageSystemOneBlock;
+
+    void fillData(MutableColumns & res_columns, ContextPtr context, const SelectQueryInfo & query_info) const override;
+};
+
+}
diff --git a/src/Storages/System/attachSystemTables.cpp b/src/Storages/System/attachSystemTables.cpp
index 424c74662ec..7d21d9e39d2 100644
--- a/src/Storages/System/attachSystemTables.cpp
+++ b/src/Storages/System/attachSystemTables.cpp
@@ -36,6 +36,7 @@
 #include <Storages/System/StorageSystemPartsColumns.h>
 #include <Storages/System/StorageSystemProjectionPartsColumns.h>
 #include <Storages/System/StorageSystemProcesses.h>
+#include <Storages/System/StorageSystemUserProcesses.h>
 #include <Storages/System/StorageSystemReplicas.h>
 #include <Storages/System/StorageSystemReplicationQueue.h>
 #include <Storages/System/StorageSystemDistributionQueue.h>
@@ -185,6 +186,7 @@ void attachSystemTablesServer(ContextPtr context, IDatabase & system_database, b
     attach<StorageSystemRemoteDataPaths>(context, system_database, "remote_data_paths");
     attach<StorageSystemCertificates>(context, system_database, "certificates");
     attach<StorageSystemNamedCollections>(context, system_database, "named_collections");
+    attach<StorageSystemUserProcesses>(context, system_database, "user_processes");
 
     if (has_zookeeper)
     {

From 17cca6ed756eaaa58eae7ef6aa89e43dcda8ce24 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 2 Jun 2023 10:08:48 -0400
Subject: [PATCH 0296/1478] add direct join docs

---
 .../integrations/embedded-rocksdb.md          | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
index a3604b3c332..dab741a9f63 100644
--- a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
+++ b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
@@ -120,3 +120,88 @@ Values can be updated using the `ALTER TABLE` query. The primary key cannot be u
 ```sql
 ALTER TABLE test UPDATE v1 = v1 * 10 + 2 WHERE key LIKE 'some%' AND v3 > 3.1;
 ```
+
+### Joins
+
+A special `direct` join with EmbeddedRocksDB tables is supported.
+This direct join avoids forming a hash table in memory and accesses
+the data directly from the EmbeddedRocksDB.
+
+To enable direct joins:
+```sql
+SET join_algorithm = 'direct'
+```
+
+:::tip
+When the `join_algorithm` is set to `direct`, direct joins will be used
+when possible.  However, direct joins are not used for RIGHT or FULL JOINs.
+ClickHouse will choose another join algorithm when direct joins are not possible.
+:::
+
+#### Example
+
+##### Create and populate an EmbeddedRocksDB table:
+```sql
+CREATE TABLE rdb
+(
+    `key` UInt32,
+    `value` Array(UInt32),
+    `value2` String
+)
+ENGINE = EmbeddedRocksDB
+PRIMARY KEY key
+```
+
+```sql
+INSERT INTO rdb
+    SELECT
+        toUInt32(sipHash64(number) % 10) as key,
+        [key, key+1] as value,
+        ('val2' || toString(key)) as value2
+    FROM numbers_mt(10);
+```
+
+##### Create and populate a table to join with table `rdb`:
+
+```sql
+CREATE TABLE t2
+(
+    `k` UInt16
+)
+ENGINE = TinyLog
+```
+
+```sql
+INSERT INTO t2 SELECT number AS k
+FROM numbers_mt(10)
+```
+
+##### Set the join algorithm to `direct`:
+
+```sql
+SET join_algorithm = 'direct'
+```
+
+##### An INNER JOIN:
+```sql
+SELECT *
+FROM
+(
+    SELECT k AS key
+    FROM t2
+) AS t2
+INNER JOIN rdb ON rdb.key = t2.key
+ORDER BY key ASC
+```
+```response
+┌─key─┬─rdb.key─┬─value──┬─value2─┐
+│   0 │       0 │ [0,1]  │ val20  │
+│   2 │       2 │ [2,3]  │ val22  │
+│   3 │       3 │ [3,4]  │ val23  │
+│   6 │       6 │ [6,7]  │ val26  │
+│   7 │       7 │ [7,8]  │ val27  │
+│   8 │       8 │ [8,9]  │ val28  │
+│   9 │       9 │ [9,10] │ val29  │
+└─────┴─────────┴────────┴────────┘
+```
+

From 47966c4e8129c3777679e42966cfec9c7a2aa383 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 2 Jun 2023 14:10:52 +0000
Subject: [PATCH 0297/1478] Finalize bufferg

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

diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 8dd6d27c379..44e990c7b95 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -618,12 +618,14 @@ SnapshotFileInfo KeeperSnapshotManager::serializeSnapshotBufferToDisk(nuraft::bu
     auto disk = getLatestSnapshotDisk();
 
     {
-        disk->writeFile(tmp_snapshot_file_name);
+        auto buf = disk->writeFile(tmp_snapshot_file_name);
+        buf->finalize();
     }
 
     auto plain_buf = disk->writeFile(snapshot_file_name);
     copyData(reader, *plain_buf);
     plain_buf->sync();
+    plain_buf->finalize();
 
     disk->removeFile(tmp_snapshot_file_name);
 

From d0da370d1e18c69e533f5d85725b7db4aa87d884 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Fri, 2 Jun 2023 16:19:24 +0200
Subject: [PATCH 0298/1478] Add a test for compound column identifier

---
 .../02771_resolve_compound_identifier.reference       | 10 ++++++++++
 .../0_stateless/02771_resolve_compound_identifier.sql | 11 +++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 tests/queries/0_stateless/02771_resolve_compound_identifier.reference
 create mode 100644 tests/queries/0_stateless/02771_resolve_compound_identifier.sql

diff --git a/tests/queries/0_stateless/02771_resolve_compound_identifier.reference b/tests/queries/0_stateless/02771_resolve_compound_identifier.reference
new file mode 100644
index 00000000000..8b1acc12b63
--- /dev/null
+++ b/tests/queries/0_stateless/02771_resolve_compound_identifier.reference
@@ -0,0 +1,10 @@
+0
+1
+2
+3
+4
+5
+6
+7
+8
+9
diff --git a/tests/queries/0_stateless/02771_resolve_compound_identifier.sql b/tests/queries/0_stateless/02771_resolve_compound_identifier.sql
new file mode 100644
index 00000000000..db4d443379e
--- /dev/null
+++ b/tests/queries/0_stateless/02771_resolve_compound_identifier.sql
@@ -0,0 +1,11 @@
+DROP DATABASE IF EXISTS test_02771;
+
+CREATE DATABASE test_02771;
+
+CREATE TABLE test_02771.t (x UInt8) ENGINE = MergeTree() ORDER BY x;
+
+INSERT INTO test_02771.t SELECT number FROM numbers(10);
+
+SELECT t.x FROM test_02771.t ORDER BY t.x;
+
+DROP DATABASE IF EXISTS test_02771;

From ae497d398a5bcb48fef1d6b90e24fb0818e2bd05 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 2 Jun 2023 14:23:04 +0000
Subject: [PATCH 0299/1478] Remove unneeded test

---
 .../__init__.py                               |   0
 .../configs/enable_keeper1.xml                |  41 --
 .../configs/enable_keeper2.xml                |  41 --
 .../configs/enable_keeper3.xml                |  41 --
 .../configs/use_keeper.xml                    |  16 -
 .../test.py                                   | 473 ------------------
 6 files changed, 612 deletions(-)
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/__init__.py
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper1.xml
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper2.xml
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper3.xml
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/configs/use_keeper.xml
 delete mode 100644 tests/integration/test_keeper_multinode_blocade_leader/test.py

diff --git a/tests/integration/test_keeper_multinode_blocade_leader/__init__.py b/tests/integration/test_keeper_multinode_blocade_leader/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper1.xml b/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper1.xml
deleted file mode 100644
index 17455ed12f5..00000000000
--- a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper1.xml
+++ /dev/null
@@ -1,41 +0,0 @@
-<clickhouse>
-    <keeper_server>
-        <tcp_port>9181</tcp_port>
-        <server_id>1</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
-
-        <coordination_settings>
-            <operation_timeout_ms>5000</operation_timeout_ms>
-            <session_timeout_ms>10000</session_timeout_ms>
-            <snapshot_distance>75</snapshot_distance>
-            <raft_logs_level>trace</raft_logs_level>
-        </coordination_settings>
-
-        <raft_configuration>
-            <server>
-                <id>1</id>
-                <hostname>node1</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <priority>3</priority>
-            </server>
-            <server>
-                <id>2</id>
-                <hostname>node2</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>2</priority>
-            </server>
-            <server>
-                <id>3</id>
-                <hostname>node3</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>1</priority>
-            </server>
-        </raft_configuration>
-    </keeper_server>
-</clickhouse>
diff --git a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper2.xml b/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper2.xml
deleted file mode 100644
index 03a23984cc2..00000000000
--- a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper2.xml
+++ /dev/null
@@ -1,41 +0,0 @@
-<clickhouse>
-    <keeper_server>
-        <tcp_port>9181</tcp_port>
-        <server_id>2</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
-
-        <coordination_settings>
-            <operation_timeout_ms>5000</operation_timeout_ms>
-            <session_timeout_ms>10000</session_timeout_ms>
-            <snapshot_distance>75</snapshot_distance>
-            <raft_logs_level>trace</raft_logs_level>
-        </coordination_settings>
-
-        <raft_configuration>
-            <server>
-                <id>1</id>
-                <hostname>node1</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <priority>3</priority>
-            </server>
-            <server>
-                <id>2</id>
-                <hostname>node2</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>2</priority>
-            </server>
-            <server>
-                <id>3</id>
-                <hostname>node3</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>1</priority>
-            </server>
-        </raft_configuration>
-    </keeper_server>
-</clickhouse>
diff --git a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper3.xml b/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper3.xml
deleted file mode 100644
index a3196ac3061..00000000000
--- a/tests/integration/test_keeper_multinode_blocade_leader/configs/enable_keeper3.xml
+++ /dev/null
@@ -1,41 +0,0 @@
-<clickhouse>
-    <keeper_server>
-        <tcp_port>9181</tcp_port>
-        <server_id>3</server_id>
-        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
-        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
-
-        <coordination_settings>
-            <operation_timeout_ms>5000</operation_timeout_ms>
-            <session_timeout_ms>10000</session_timeout_ms>
-            <snapshot_distance>75</snapshot_distance>
-            <raft_logs_level>trace</raft_logs_level>
-        </coordination_settings>
-
-        <raft_configuration>
-            <server>
-                <id>1</id>
-                <hostname>node1</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <priority>3</priority>
-            </server>
-            <server>
-                <id>2</id>
-                <hostname>node2</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>2</priority>
-            </server>
-            <server>
-                <id>3</id>
-                <hostname>node3</hostname>
-                <port>9234</port>
-                <can_become_leader>true</can_become_leader>
-                <start_as_follower>true</start_as_follower>
-                <priority>1</priority>
-            </server>
-        </raft_configuration>
-    </keeper_server>
-</clickhouse>
diff --git a/tests/integration/test_keeper_multinode_blocade_leader/configs/use_keeper.xml b/tests/integration/test_keeper_multinode_blocade_leader/configs/use_keeper.xml
deleted file mode 100644
index 384e984f210..00000000000
--- a/tests/integration/test_keeper_multinode_blocade_leader/configs/use_keeper.xml
+++ /dev/null
@@ -1,16 +0,0 @@
-<clickhouse>
-    <zookeeper>
-        <node index="1">
-            <host>node1</host>
-            <port>9181</port>
-        </node>
-        <node index="2">
-            <host>node2</host>
-            <port>9181</port>
-        </node>
-        <node index="3">
-            <host>node3</host>
-            <port>9181</port>
-        </node>
-    </zookeeper>
-</clickhouse>
diff --git a/tests/integration/test_keeper_multinode_blocade_leader/test.py b/tests/integration/test_keeper_multinode_blocade_leader/test.py
deleted file mode 100644
index 3af0751b0fd..00000000000
--- a/tests/integration/test_keeper_multinode_blocade_leader/test.py
+++ /dev/null
@@ -1,473 +0,0 @@
-import pytest
-from helpers.cluster import ClickHouseCluster
-import helpers.keeper_utils as keeper_utils
-import random
-import string
-import os
-import time
-from multiprocessing.dummy import Pool
-from helpers.network import PartitionManager
-from helpers.test_tools import assert_eq_with_retry
-
-cluster = ClickHouseCluster(__file__)
-node1 = cluster.add_instance(
-    "node1",
-    main_configs=["configs/enable_keeper1.xml", "configs/use_keeper.xml"],
-    stay_alive=True,
-)
-node2 = cluster.add_instance(
-    "node2",
-    main_configs=["configs/enable_keeper2.xml", "configs/use_keeper.xml"],
-    stay_alive=True,
-)
-node3 = cluster.add_instance(
-    "node3",
-    main_configs=["configs/enable_keeper3.xml", "configs/use_keeper.xml"],
-    stay_alive=True,
-)
-
-from kazoo.client import KazooClient, KazooState
-
-"""
-In this test, we blockade RAFT leader and check that the whole system is
-able to recover. It's not a good test because we use ClickHouse's replicated
-tables to check connectivity, but they may require special operations (or a long
-wait) after session expiration. We don't use kazoo, because this client pretends
-to be very smart: SUSPEND sessions, try to recover them, and so on. The test
-will be even less predictable than with ClickHouse tables.
-
-TODO find (or write) not so smart python client.
-TODO remove this when jepsen tests will be written.
-"""
-
-
-@pytest.fixture(scope="module")
-def started_cluster():
-    try:
-        cluster.start()
-
-        yield cluster
-
-    finally:
-        cluster.shutdown()
-
-
-def smaller_exception(ex):
-    return "\n".join(str(ex).split("\n")[0:2])
-
-
-def get_fake_zk(nodename, timeout=30.0):
-    _fake_zk_instance = KazooClient(
-        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
-    )
-    _fake_zk_instance.start()
-    return _fake_zk_instance
-
-
-def wait_nodes():
-    keeper_utils.wait_nodes(cluster, [node1, node2, node3])
-
-
-# in extremely rare case it can take more than 5 minutes in debug build with sanitizer
-@pytest.mark.timeout(600)
-def test_blocade_leader(started_cluster):
-    for i in range(100):
-        wait_nodes()
-        try:
-            for i, node in enumerate([node1, node2, node3]):
-                node.query(
-                    "CREATE DATABASE IF NOT EXISTS ordinary ENGINE=Ordinary",
-                    settings={"allow_deprecated_database_ordinary": 1},
-                )
-                node.query(
-                    "CREATE TABLE IF NOT EXISTS ordinary.t1 (value UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/t1', '{}') ORDER BY tuple()".format(
-                        i + 1
-                    )
-                )
-            break
-        except Exception as ex:
-            print("Got exception from node", smaller_exception(ex))
-            time.sleep(0.1)
-
-    node2.query(
-        "INSERT INTO ordinary.t1 SELECT number FROM numbers(10) SETTINGS insert_keeper_max_retries = 0"
-    )
-
-    node1.query("SYSTEM SYNC REPLICA ordinary.t1", timeout=10)
-    node3.query("SYSTEM SYNC REPLICA ordinary.t1", timeout=10)
-
-    assert_eq_with_retry(node1, "SELECT COUNT() FROM ordinary.t1", "10")
-    assert_eq_with_retry(node2, "SELECT COUNT() FROM ordinary.t1", "10")
-    assert_eq_with_retry(node3, "SELECT COUNT() FROM ordinary.t1", "10")
-
-    with PartitionManager() as pm:
-        pm.partition_instances(node2, node1)
-        pm.partition_instances(node3, node1)
-
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node2, "ordinary.t1", "/clickhouse/t1/replicas/2"
-                )
-                node2.query(
-                    "INSERT INTO ordinary.t1 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                break
-            except Exception as ex:
-                try:
-                    node2.query("ATTACH TABLE ordinary.t1")
-                except Exception as attach_ex:
-                    print("Got exception node2", smaller_exception(attach_ex))
-                print("Got exception node2", smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t1", "/clickhouse/t1/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot insert anything node2"
-
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node3, "ordinary.t1", "/clickhouse/t1/replicas/3"
-                )
-                node3.query(
-                    "INSERT INTO ordinary.t1 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                break
-            except Exception as ex:
-                try:
-                    node3.query("ATTACH TABLE ordinary.t1")
-                except Exception as attach_ex:
-                    print("Got exception node3", smaller_exception(attach_ex))
-                print("Got exception node3", smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t1", "/clickhouse/t1/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot insert anything node3"
-
-    for n, node in enumerate([node1, node2, node3]):
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node, "ordinary.t1", "/clickhouse/t1/replicas/{}".format(n + 1)
-                )
-                break
-            except Exception as ex:
-                try:
-                    node.query("ATTACH TABLE ordinary.t1")
-                except Exception as attach_ex:
-                    print(
-                        "Got exception node{}".format(n + 1),
-                        smaller_exception(attach_ex),
-                    )
-
-                print("Got exception node{}".format(n + 1), smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            assert False, "Cannot reconnect for node{}".format(n + 1)
-
-    for i in range(100):
-        try:
-            node1.query(
-                "INSERT INTO ordinary.t1 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-            )
-            break
-        except Exception as ex:
-            print("Got exception node1", smaller_exception(ex))
-            time.sleep(0.5)
-    else:
-        for num, node in enumerate([node1, node2, node3]):
-            dump_zk(
-                node, "/clickhouse/t1", "/clickhouse/t1/replicas/{}".format(num + 1)
-            )
-        assert False, "Cannot insert anything node1"
-
-    for n, node in enumerate([node1, node2, node3]):
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node, "ordinary.t1", "/clickhouse/t1/replicas/{}".format(n + 1)
-                )
-                node.query("SYSTEM SYNC REPLICA ordinary.t1", timeout=10)
-                break
-            except Exception as ex:
-                try:
-                    node.query("ATTACH TABLE ordinary.t1")
-                except Exception as attach_ex:
-                    print(
-                        "Got exception node{}".format(n + 1),
-                        smaller_exception(attach_ex),
-                    )
-
-                print("Got exception node{}".format(n + 1), smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t1", "/clickhouse/t1/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot sync replica node{}".format(n + 1)
-
-    if node1.query("SELECT COUNT() FROM ordinary.t1") != "310\n":
-        for num, node in enumerate([node1, node2, node3]):
-            dump_zk(
-                node, "/clickhouse/t1", "/clickhouse/t1/replicas/{}".format(num + 1)
-            )
-
-    assert_eq_with_retry(node1, "SELECT COUNT() FROM ordinary.t1", "310")
-    assert_eq_with_retry(node2, "SELECT COUNT() FROM ordinary.t1", "310")
-    assert_eq_with_retry(node3, "SELECT COUNT() FROM ordinary.t1", "310")
-
-
-def dump_zk(node, zk_path, replica_path):
-    print(node.query("SELECT * FROM system.replication_queue FORMAT Vertical"))
-    print("Replicas")
-    print(node.query("SELECT * FROM system.replicas FORMAT Vertical"))
-    print("Replica 2 info")
-    print(
-        node.query(
-            "SELECT * FROM system.zookeeper WHERE path = '{}' FORMAT Vertical".format(
-                zk_path
-            )
-        )
-    )
-    print("Queue")
-    print(
-        node.query(
-            "SELECT * FROM system.zookeeper WHERE path = '{}/queue' FORMAT Vertical".format(
-                replica_path
-            )
-        )
-    )
-    print("Log")
-    print(
-        node.query(
-            "SELECT * FROM system.zookeeper WHERE path = '{}/log' FORMAT Vertical".format(
-                zk_path
-            )
-        )
-    )
-    print("Parts")
-    print(
-        node.query(
-            "SELECT name FROM system.zookeeper WHERE path = '{}/parts' FORMAT Vertical".format(
-                replica_path
-            )
-        )
-    )
-
-
-def restart_replica_for_sure(node, table_name, zk_replica_path):
-    fake_zk = None
-    try:
-        node.query("DETACH TABLE {}".format(table_name))
-        fake_zk = get_fake_zk(node.name)
-        if fake_zk.exists(zk_replica_path + "/is_active") is not None:
-            fake_zk.delete(zk_replica_path + "/is_active")
-
-        node.query("ATTACH TABLE {}".format(table_name))
-    except Exception as ex:
-        print("Exception", ex)
-        raise ex
-    finally:
-        if fake_zk:
-            fake_zk.stop()
-            fake_zk.close()
-
-
-# in extremely rare case it can take more than 5 minutes in debug build with sanitizer
-@pytest.mark.timeout(600)
-def test_blocade_leader_twice(started_cluster):
-    for i in range(100):
-        wait_nodes()
-        try:
-            for i, node in enumerate([node1, node2, node3]):
-                node.query(
-                    "CREATE DATABASE IF NOT EXISTS ordinary ENGINE=Ordinary",
-                    settings={"allow_deprecated_database_ordinary": 1},
-                )
-                node.query(
-                    "CREATE TABLE IF NOT EXISTS ordinary.t2 (value UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/t2', '{}') ORDER BY tuple()".format(
-                        i + 1
-                    )
-                )
-            break
-        except Exception as ex:
-            print("Got exception from node", smaller_exception(ex))
-            time.sleep(0.1)
-
-    node2.query(
-        "INSERT INTO ordinary.t2 SELECT number FROM numbers(10) SETTINGS insert_keeper_max_retries = 0"
-    )
-
-    node1.query("SYSTEM SYNC REPLICA ordinary.t2", timeout=10)
-    node3.query("SYSTEM SYNC REPLICA ordinary.t2", timeout=10)
-
-    assert_eq_with_retry(node1, "SELECT COUNT() FROM ordinary.t2", "10")
-    assert_eq_with_retry(node2, "SELECT COUNT() FROM ordinary.t2", "10")
-    assert_eq_with_retry(node3, "SELECT COUNT() FROM ordinary.t2", "10")
-
-    with PartitionManager() as pm:
-        pm.partition_instances(node2, node1)
-        pm.partition_instances(node3, node1)
-
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node2, "ordinary.t2", "/clickhouse/t2/replicas/2"
-                )
-                node2.query(
-                    "INSERT INTO ordinary.t2 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                break
-            except Exception as ex:
-                try:
-                    node2.query("ATTACH TABLE ordinary.t2")
-                except Exception as attach_ex:
-                    print("Got exception node2", smaller_exception(attach_ex))
-                print("Got exception node2", smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot reconnect for node2"
-
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node3, "ordinary.t2", "/clickhouse/t2/replicas/3"
-                )
-                node3.query("SYSTEM SYNC REPLICA ordinary.t2", timeout=10)
-                node3.query(
-                    "INSERT INTO ordinary.t2 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                break
-            except Exception as ex:
-                try:
-                    node3.query("ATTACH TABLE ordinary.t2")
-                except Exception as attach_ex:
-                    print("Got exception node3", smaller_exception(attach_ex))
-                print("Got exception node3", smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot reconnect for node3"
-
-        node2.query("SYSTEM SYNC REPLICA ordinary.t2", timeout=10)
-
-        assert_eq_with_retry(node2, "SELECT COUNT() FROM ordinary.t2", "210")
-        assert_eq_with_retry(node3, "SELECT COUNT() FROM ordinary.t2", "210")
-
-        # Total network partition
-        pm.partition_instances(node3, node2)
-
-        for i in range(10):
-            try:
-                node3.query(
-                    "INSERT INTO ordinary.t2 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                assert False, "Node3 became leader?"
-            except Exception as ex:
-                time.sleep(0.5)
-
-        for i in range(10):
-            try:
-                node2.query(
-                    "INSERT INTO ordinary.t2 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                assert False, "Node2 became leader?"
-            except Exception as ex:
-                time.sleep(0.5)
-
-    for n, node in enumerate([node1, node2, node3]):
-        for i in range(100):
-            try:
-                restart_replica_for_sure(
-                    node, "ordinary.t2", "/clickhouse/t2/replicas/{}".format(n + 1)
-                )
-                break
-            except Exception as ex:
-                try:
-                    node.query("ATTACH TABLE ordinary.t2")
-                except Exception as attach_ex:
-                    print(
-                        "Got exception node{}".format(n + 1),
-                        smaller_exception(attach_ex),
-                    )
-
-                print("Got exception node{}".format(n + 1), smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot reconnect for node{}".format(n + 1)
-
-    for n, node in enumerate([node1, node2, node3]):
-        for i in range(100):
-            try:
-                node.query(
-                    "INSERT INTO ordinary.t2 SELECT rand() FROM numbers(100) SETTINGS insert_keeper_max_retries = 0"
-                )
-                break
-            except Exception as ex:
-                print("Got exception node{}".format(n + 1), smaller_exception(ex))
-                time.sleep(0.5)
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot reconnect for node{}".format(n + 1)
-
-        for i in range(100):
-            all_done = True
-            for n, node in enumerate([node1, node2, node3]):
-                try:
-                    restart_replica_for_sure(
-                        node, "ordinary.t2", "/clickhouse/t2/replicas/{}".format(n + 1)
-                    )
-                    node.query("SYSTEM SYNC REPLICA ordinary.t2", timeout=10)
-                    break
-                except Exception as ex:
-                    all_done = False
-                    try:
-                        node.query("ATTACH TABLE ordinary.t2")
-                    except Exception as attach_ex:
-                        print(
-                            "Got exception node{}".format(n + 1),
-                            smaller_exception(attach_ex),
-                        )
-
-                    print("Got exception node{}".format(n + 1), smaller_exception(ex))
-                    time.sleep(0.5)
-
-            if all_done:
-                break
-        else:
-            for num, node in enumerate([node1, node2, node3]):
-                dump_zk(
-                    node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-                )
-            assert False, "Cannot reconnect in i {} retries".format(i)
-
-    assert_eq_with_retry(node1, "SELECT COUNT() FROM ordinary.t2", "510")
-    if node2.query("SELECT COUNT() FROM ordinary.t2") != "510\n":
-        for num, node in enumerate([node1, node2, node3]):
-            dump_zk(
-                node, "/clickhouse/t2", "/clickhouse/t2/replicas/{}".format(num + 1)
-            )
-
-    assert_eq_with_retry(node2, "SELECT COUNT() FROM ordinary.t2", "510")
-    assert_eq_with_retry(node3, "SELECT COUNT() FROM ordinary.t2", "510")

From 8e4a2a42fbab37b1d4511d45d6b01580172689db Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Fri, 2 Jun 2023 16:51:09 +0200
Subject: [PATCH 0300/1478] Some code

---
 src/Access/Common/AccessType.h                |   1 +
 .../AzureBlobStorage/AzureObjectStorage.h     |  12 +-
 src/Storages/StorageAzure.cpp                 | 518 ++++++++++++++++++
 src/Storages/StorageAzure.h                   | 121 ++++
 src/Storages/registerStorages.cpp             |  12 +
 5 files changed, 659 insertions(+), 5 deletions(-)
 create mode 100644 src/Storages/StorageAzure.cpp
 create mode 100644 src/Storages/StorageAzure.h

diff --git a/src/Access/Common/AccessType.h b/src/Access/Common/AccessType.h
index 6394c0279a7..84c99939f2d 100644
--- a/src/Access/Common/AccessType.h
+++ b/src/Access/Common/AccessType.h
@@ -210,6 +210,7 @@ enum class AccessType
     M(HDFS, "", GLOBAL, SOURCES) \
     M(S3, "", GLOBAL, SOURCES) \
     M(HIVE, "", GLOBAL, SOURCES) \
+    M(AZURE, "", GLOBAL, SOURCES) \
     M(SOURCES, "", GROUP, ALL) \
     \
     M(CLUSTER, "", GLOBAL, ALL) /* ON CLUSTER queries */ \
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index 0c2aecd5c62..1be1eb69799 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -37,11 +37,13 @@ struct AzureObjectStorageSettings
     {
     }
 
-    size_t max_single_part_upload_size; /// NOTE: on 32-bit machines it will be at most 4GB, but size_t is also used in BufferBase for offset
-    uint64_t min_bytes_for_seek;
-    size_t max_single_read_retries;
-    size_t max_single_download_retries;
-    int list_object_keys_size;
+    AzureObjectStorageSettings() = default;
+
+    size_t max_single_part_upload_size = 100 * 1024 * 1024; /// NOTE: on 32-bit machines it will be at most 4GB, but size_t is also used in BufferBase for offset
+    uint64_t min_bytes_for_seek = 1024 * 1024;
+    size_t max_single_read_retries = 3;
+    size_t max_single_download_retries = 3;
+    int list_object_keys_size = 1000;
 };
 
 using AzureClient = Azure::Storage::Blobs::BlobContainerClient;
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
new file mode 100644
index 00000000000..30fd3fcbe95
--- /dev/null
+++ b/src/Storages/StorageAzure.cpp
@@ -0,0 +1,518 @@
+#include <Storages/StorageAzure.h>
+
+
+#if USE_AZURE_BLOB_STORAGE
+#include <Formats/FormatFactory.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTInsertQuery.h>
+
+#include <IO/ParallelReadBuffer.h>
+#include <IO/SharedThreadPools.h>
+
+#include <Parsers/ASTCreateQuery.h>
+#include <Formats/FormatFactory.h>
+#include <Formats/ReadSchemaUtils.h>
+#include <DataTypes/DataTypeString.h>
+#include <re2/re2.h>
+
+#include <azure/identity/managed_identity_credential.hpp>
+#include <Processors/Transforms/AddingDefaultsTransform.h>
+#include <Processors/Formats/IOutputFormat.h>
+#include <Processors/Formats/IInputFormat.h>
+
+#include <Storages/StorageFactory.h>
+#include <Storages/StorageSnapshot.h>
+#include <Storages/PartitionedSink.h>
+#include <Storages/VirtualColumnUtils.h>
+#include <Storages/getVirtualsForStorage.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+#include <Storages/StorageURL.h>
+#include <Storages/NamedCollectionsHelpers.h>
+#include <Storages/ReadFromStorageProgress.h>
+
+
+using namespace Azure::Storage::Blobs;
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+    extern const int BAD_ARGUMENTS;
+    extern const int DATABASE_ACCESS_DENIED;
+}
+
+bool isConnectionString(const std::string & candidate)
+{
+    return candidate.starts_with("DefaultEndpointsProtocol");
+}
+
+StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
+{
+    StorageAzure::Configuration configuration;
+
+    /// Supported signatures:
+    ///
+    /// Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])
+
+    if (engine_args.size() < 3 || engine_args.size() > 7)
+        throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
+                        "Storage Azure requires 3 to 7 arguments: "
+                        "Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])");
+
+    for (auto & engine_arg : engine_args)
+        engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, local_context);
+
+    std::unordered_map<std::string_view, size_t> engine_args_to_idx;
+
+    configuration.connection_url = checkAndGetLiteralArgument<String>(engine_args[0], "connection_string/storage_account_url");
+    configuration.is_connection_string = isConnectionString(configuration.connection_url);
+
+    configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
+    configuration.blob_path = checkAndGetLiteralArgument<String>(engine_args[2], "blobpath");
+
+    auto is_format_arg = [] (const std::string & s) -> bool
+    {
+        return s == "auto" || FormatFactory::instance().getAllFormats().contains(s);
+    };
+
+    if (engine_args.size() == 4)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            configuration.format = fourth_arg;
+        }
+        else
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format or account name specified without account key");
+        }
+    }
+    else if (engine_args.size() == 5)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            configuration.format = fourth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[4], "compression");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+        }
+    }
+    else if (engine_args.size() == 6)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (fourth_arg == "auto" || FormatFactory::instance().getAllFormats().contains(fourth_arg))
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Format and compression must be last arguments");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+            auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
+            if (!is_format_arg(sixth_arg))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format {}", sixth_arg);
+            configuration.format = sixth_arg;
+        }
+    }
+    else if (engine_args.size() == 7)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (fourth_arg == "auto" || FormatFactory::instance().getAllFormats().contains(fourth_arg))
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Format and compression must be last arguments");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+            auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
+            if (!is_format_arg(sixth_arg))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format {}", sixth_arg);
+            configuration.format = sixth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[6], "compression");
+        }
+    }
+
+    configuration.blobs_paths = {configuration.blob_path};
+
+    if (configuration.format == "auto" && get_format_from_file)
+        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+    return configuration;
+}
+
+
+void registerStorageAzure(StorageFactory & factory)
+{
+    factory.registerStorage("Azure", [](const StorageFactory::Arguments & args)
+    {
+        auto & engine_args = args.engine_args;
+        if (engine_args.empty())
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "External data source must have arguments");
+
+        auto configuration = StorageAzure::getConfiguration(engine_args, args.getLocalContext());
+        auto client = StorageAzure::createClient(configuration);
+        // Use format settings from global server context + settings from
+        // the SETTINGS clause of the create query. Settings from current
+        // session and user are ignored.
+        std::optional<FormatSettings> format_settings;
+        if (args.storage_def->settings)
+        {
+            FormatFactorySettings user_format_settings;
+
+            // Apply changed settings from global context, but ignore the
+            // unknown ones, because we only have the format settings here.
+            const auto & changes = args.getContext()->getSettingsRef().changes();
+            for (const auto & change : changes)
+            {
+                if (user_format_settings.has(change.name))
+                    user_format_settings.set(change.name, change.value);
+            }
+
+            // Apply changes from SETTINGS clause, with validation.
+            user_format_settings.applyChanges(args.storage_def->settings->changes);
+            format_settings = getFormatSettings(args.getContext(), user_format_settings);
+        }
+        else
+        {
+            format_settings = getFormatSettings(args.getContext());
+        }
+
+        ASTPtr partition_by;
+        if (args.storage_def->partition_by)
+            partition_by = args.storage_def->partition_by->clone();
+
+        return std::make_shared<StorageAzure>(
+            std::move(configuration),
+            std::make_unique<AzureObjectStorage>("AzureStorage", std::move(client), std::make_unique<AzureObjectStorageSettings>()),
+            args.getContext(),
+            args.table_id,
+            args.columns,
+            args.constraints,
+            args.comment,
+            format_settings,
+            partition_by);
+    },
+    {
+        .supports_settings = true,
+        .supports_sort_order = true, // for partition by
+        .supports_schema_inference = true,
+        .source_access_type = AccessType::AZURE,
+    });
+}
+
+AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configuration)
+{
+    AzureClientPtr result;
+
+    if (configuration.is_connection_string)
+    {
+        result = std::make_unique<BlobContainerClient>(BlobContainerClient::CreateFromConnectionString(configuration.connection_url, configuration.container));
+    }
+    else
+    {
+        if (configuration.account_name.has_value() && configuration.account_key.has_value())
+        {
+            auto storage_shared_key_credential = std::make_shared<Azure::Storage::StorageSharedKeyCredential>(*configuration.account_name, *configuration.account_key);
+            result = std::make_unique<BlobContainerClient>(configuration.connection_url, storage_shared_key_credential);
+        }
+
+        auto managed_identity_credential = std::make_shared<Azure::Identity::ManagedIdentityCredential>();
+
+        result = std::make_unique<BlobContainerClient>(configuration.connection_url, managed_identity_credential);
+    }
+
+    return result;
+}
+
+StorageAzure::StorageAzure(
+    const Configuration & configuration_,
+    std::unique_ptr<AzureObjectStorage> && object_storage_,
+    ContextPtr context_,
+    const StorageID & table_id_,
+    const ColumnsDescription & columns_,
+    const ConstraintsDescription & constraints_,
+    const String & comment,
+    std::optional<FormatSettings> format_settings_,
+    ASTPtr partition_by_)
+    : IStorage(table_id_)
+    , name("AzureBlobStorage")
+    , configuration(configuration_)
+    , object_storage(std::move(object_storage_))
+    , distributed_processing(false)
+    , format_settings(format_settings_)
+    , partition_by(partition_by_)
+{
+    FormatFactory::instance().checkFormatName(configuration.format);
+    context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(configuration.getConnectionURL()));
+
+    StorageInMemoryMetadata storage_metadata;
+    if (columns_.empty())
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Schema inference is not supported yet");
+        //auto columns = getTableStructureFromDataImpl(configuration, format_settings, context_);
+        //storage_metadata.setColumns(columns);
+    }
+    else
+        storage_metadata.setColumns(columns_);
+
+    storage_metadata.setConstraints(constraints_);
+    storage_metadata.setComment(comment);
+    setInMemoryMetadata(storage_metadata);
+
+    auto default_virtuals = NamesAndTypesList{
+        {"_path", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())},
+        {"_file", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())}};
+
+    auto columns = storage_metadata.getSampleBlock().getNamesAndTypesList();
+    virtual_columns = getVirtualsForStorage(columns, default_virtuals);
+    for (const auto & column : virtual_columns)
+        virtual_block.insert({column.type->createColumn(), column.type, column.name});
+}
+
+void StorageAzure::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
+{
+
+    if (configuration.withGlobs())
+    {
+        throw Exception(
+            ErrorCodes::DATABASE_ACCESS_DENIED,
+            "S3 key '{}' contains globs, so the table is in readonly mode",
+            configuration.blob_path);
+    }
+
+    StoredObjects objects;
+    for (const auto & key : configuration.blobs_paths)
+        objects.emplace_back(key);
+
+    object_storage->removeObjects(objects);
+}
+
+namespace
+{
+
+class StorageAzureSink : public SinkToStorage
+{
+public:
+    StorageAzureSink(
+        const String & format,
+        const Block & sample_block_,
+        ContextPtr context,
+        std::optional<FormatSettings> format_settings_,
+        const CompressionMethod compression_method,
+        AzureObjectStorage * object_storage,
+        const String & blob_path)
+        : SinkToStorage(sample_block_)
+        , sample_block(sample_block_)
+        , format_settings(format_settings_)
+    {
+        StoredObject object(blob_path);
+        write_buf = wrapWriteBufferWithCompressionMethod(object_storage->writeObject(object, WriteMode::Rewrite), compression_method, 3);
+        writer = FormatFactory::instance().getOutputFormatParallelIfPossible(format, *write_buf, sample_block, context, format_settings);
+    }
+
+    String getName() const override { return "StorageS3Sink"; }
+
+    void consume(Chunk chunk) override
+    {
+        std::lock_guard lock(cancel_mutex);
+        if (cancelled)
+            return;
+        writer->write(getHeader().cloneWithColumns(chunk.detachColumns()));
+    }
+
+    void onCancel() override
+    {
+        std::lock_guard lock(cancel_mutex);
+        finalize();
+        cancelled = true;
+    }
+
+    void onException() override
+    {
+        std::lock_guard lock(cancel_mutex);
+        finalize();
+    }
+
+    void onFinish() override
+    {
+        std::lock_guard lock(cancel_mutex);
+        finalize();
+    }
+
+private:
+    void finalize()
+    {
+        if (!writer)
+            return;
+
+        try
+        {
+            writer->finalize();
+            writer->flush();
+            write_buf->finalize();
+        }
+        catch (...)
+        {
+            /// Stop ParallelFormattingOutputFormat correctly.
+            writer.reset();
+            write_buf->finalize();
+            throw;
+        }
+    }
+
+    Block sample_block;
+    std::optional<FormatSettings> format_settings;
+    std::unique_ptr<WriteBuffer> write_buf;
+    OutputFormatPtr writer;
+    bool cancelled = false;
+    std::mutex cancel_mutex;
+};
+
+class PartitionedStorageAzureSink : public PartitionedSink
+{
+public:
+    PartitionedStorageAzureSink(
+        const ASTPtr & partition_by,
+        const String & format_,
+        const Block & sample_block_,
+        ContextPtr context_,
+        std::optional<FormatSettings> format_settings_,
+        const CompressionMethod compression_method_,
+        AzureObjectStorage * object_storage_,
+        const String & blob_)
+        : PartitionedSink(partition_by, context_, sample_block_)
+        , format(format_)
+        , sample_block(sample_block_)
+        , context(context_)
+        , compression_method(compression_method_)
+        , object_storage(object_storage_)
+        , blob(blob_)
+        , format_settings(format_settings_)
+    {
+    }
+
+    SinkPtr createSinkForPartition(const String & partition_id) override
+    {
+        auto partition_key = replaceWildcards(blob, partition_id);
+        validateKey(partition_key);
+
+        return std::make_shared<StorageAzureSink>(
+            format,
+            sample_block,
+            context,
+            format_settings,
+            compression_method,
+            object_storage,
+            partition_key
+        );
+    }
+
+private:
+    const String format;
+    const Block sample_block;
+    const ContextPtr context;
+    const CompressionMethod compression_method;
+    AzureObjectStorage * object_storage;
+    const String blob;
+    const std::optional<FormatSettings> format_settings;
+
+    ExpressionActionsPtr partition_by_expr;
+
+    static void validateKey(const String & str)
+    {
+        validatePartitionKey(str, true);
+    }
+};
+
+}
+
+SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+{
+    auto sample_block = metadata_snapshot->getSampleBlock();
+    auto chosen_compression_method = chooseCompressionMethod(configuration.blobs_paths.back(), configuration.compression_method);
+    auto insert_query = std::dynamic_pointer_cast<ASTInsertQuery>(query);
+
+    auto partition_by_ast = insert_query ? (insert_query->partition_by ? insert_query->partition_by : partition_by) : nullptr;
+    bool is_partitioned_implementation = partition_by_ast && configuration.withWildcard();
+
+    if (is_partitioned_implementation)
+    {
+        return std::make_shared<PartitionedStorageAzureSink>(
+            partition_by_ast,
+            configuration.format,
+            sample_block,
+            local_context,
+            format_settings,
+            chosen_compression_method,
+            object_storage.get(),
+            configuration.blobs_paths.back());
+    }
+    else
+    {
+        if (configuration.withGlobs())
+            throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED,
+                            "Azure key '{}' contains globs, so the table is in readonly mode", configuration.blob_path);
+
+        bool truncate_in_insert = local_context->getSettingsRef().s3_truncate_on_insert;
+
+        if (!truncate_in_insert && object_storage->exists(StoredObject(configuration.blob_path)))
+        {
+            if (local_context->getSettingsRef().s3_create_new_file_on_insert)
+            {
+                size_t index = configuration.blobs_paths.size();
+                const auto & first_key = configuration.blobs_paths[0];
+                auto pos = first_key.find_first_of('.');
+                String new_key;
+                do
+                {
+                    new_key = first_key.substr(0, pos) + "." + std::to_string(index) + (pos == std::string::npos ? "" : first_key.substr(pos));
+                    ++index;
+                }
+                while (object_storage->exists(StoredObject(new_key)));
+
+                configuration.blobs_paths.push_back(new_key);
+            }
+            else
+            {
+                throw Exception(
+                    ErrorCodes::BAD_ARGUMENTS,
+                    "Object in bucket {} with key {} already exists. "
+                    "If you want to overwrite it, enable setting s3_truncate_on_insert, if you "
+                    "want to create a new file on each insert, enable setting s3_create_new_file_on_insert",
+                    configuration.container, configuration.blobs_paths.back());
+            }
+        }
+
+        return std::make_shared<StorageAzureSink>(
+            configuration.format,
+            sample_block,
+            local_context,
+            format_settings,
+            chosen_compression_method,
+            object_storage.get(),
+            configuration.blobs_paths.back());
+    }
+}
+
+NamesAndTypesList StorageAzure::getVirtuals() const
+{
+    return virtual_columns;
+}
+
+bool StorageAzure::supportsPartitionBy() const
+{
+    return true;
+}
+
+}
+
+#endif
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
new file mode 100644
index 00000000000..b99df2e89a5
--- /dev/null
+++ b/src/Storages/StorageAzure.h
@@ -0,0 +1,121 @@
+#pragma once
+
+#include "config.h"
+
+#if USE_AZURE_BLOB_STORAGE
+
+#include <Storages/IStorage.h>
+#include <Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h>
+#include <Storages/Cache/SchemaCache.h>
+#include <Storages/StorageConfiguration.h>
+#include <Processors/Executors/PullingPipelineExecutor.h>
+
+namespace DB
+{
+
+struct AzureSimpleAccountConfiguration
+{
+    std::string storage_account_url;
+};
+
+using AzureConnectionString = std::string;
+
+using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConnectionString>;
+
+class StorageAzure : public IStorage
+{
+public:
+    using AzureClient = Azure::Storage::Blobs::BlobContainerClient;
+    using AzureClientPtr = std::unique_ptr<Azure::Storage::Blobs::BlobContainerClient>;
+
+    struct Configuration : public StatelessTableEngineConfiguration
+    {
+        Configuration() = default;
+
+        String getPath() const { return blob_path; }
+
+        bool update(ContextPtr context);
+
+        void connect(ContextPtr context);
+
+        bool withGlobs() const { return blob_path.find_first_of("*?{") != std::string::npos; }
+
+        bool withWildcard() const
+        {
+            static const String PARTITION_ID_WILDCARD = "{_partition_id}";
+            return blobs_paths.back().find(PARTITION_ID_WILDCARD) != String::npos;
+        }
+
+        std::string getConnectionURL() const
+        {
+            if (!is_connection_string)
+                return connection_url;
+
+            throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Connection string not implemented yet");
+        }
+
+        std::string connection_url;
+        bool is_connection_string;
+
+        std::optional<std::string> account_name;
+        std::optional<std::string> account_key;
+
+        std::string container;
+        std::string blob_path;
+        std::vector<String> blobs_paths;
+    };
+
+    StorageAzure(
+        const Configuration & configuration_,
+        std::unique_ptr<AzureObjectStorage> && object_storage_,
+        ContextPtr context_,
+        const StorageID & table_id_,
+        const ColumnsDescription & columns_,
+        const ConstraintsDescription & constraints_,
+        const String & comment,
+        std::optional<FormatSettings> format_settings_,
+        ASTPtr partition_by_);
+
+    static StorageAzure::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
+    static AzureClientPtr createClient(StorageAzure::Configuration configuration);
+
+    String getName() const override
+    {
+        return name;
+    }
+
+    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;
+
+    void truncate(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, TableExclusiveLockHolder &) override;
+
+    NamesAndTypesList getVirtuals() const override;
+
+    bool supportsPartitionBy() const override;
+
+    static SchemaCache & getSchemaCache(const ContextPtr & ctx);
+
+private:
+    std::string name;
+    Configuration configuration;
+    std::unique_ptr<AzureObjectStorage> object_storage;
+    NamesAndTypesList virtual_columns;
+    Block virtual_block;
+
+    const bool distributed_processing;
+    std::optional<FormatSettings> format_settings;
+    ASTPtr partition_by;
+
+};
+
+}
+
+#endif
diff --git a/src/Storages/registerStorages.cpp b/src/Storages/registerStorages.cpp
index 8be176a5375..03bd4dbb310 100644
--- a/src/Storages/registerStorages.cpp
+++ b/src/Storages/registerStorages.cpp
@@ -94,8 +94,16 @@ void registerStorageFileLog(StorageFactory & factory);
 void registerStorageSQLite(StorageFactory & factory);
 #endif
 
+
+
 void registerStorageKeeperMap(StorageFactory & factory);
 
+#if USE_AZURE_BLOB_STORAGE
+
+void registerStorageAzure(StorageFactory & factory);
+
+#endif
+
 void registerStorages()
 {
     auto & factory = StorageFactory::instance();
@@ -191,6 +199,10 @@ void registerStorages()
     #endif
 
     registerStorageKeeperMap(factory);
+
+    #if USE_AZURE_BLOB_STORAGE
+    registerStorageAzure(factory);
+    #endif
 }
 
 }

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 0301/1478] 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 975e58c56d5cf7038052e0be9699c094c7203161 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 2 Jun 2023 15:15:44 +0000
Subject: [PATCH 0302/1478] Fix style.

---
 src/Interpreters/PreparedSets.cpp             | 1 -
 src/Planner/CollectSets.cpp                   | 2 ++
 src/Processors/QueryPlan/CreatingSetsStep.cpp | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 1e475e8403d..6df7c748e60 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -14,7 +14,6 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int LOGICAL_ERROR;
-    extern const int SET_SIZE_LIMIT_EXCEEDED;
 }
 
 PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index d264810645a..5f44994c14b 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -81,6 +81,8 @@ public:
                     element_type = low_cardinality_type->getDictionaryType();
 
             auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
+            if (sets.getFuture(set_key))
+                return;
 
             sets.addFromTuple(set_key, std::move(set), settings);
 
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 0909ee9f1eb..264c4b9ef47 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -46,6 +46,7 @@ CreatingSetStep::CreatingSetStep(
     , network_transfer_limits(std::move(network_transfer_limits_))
     , context(std::move(context_))
 {
+    std::cerr << StackTrace().toString() << std::endl;
 }
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)

From c19866f72d3b356f2c4fed334c2beeecd441ef0e Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 2 Jun 2023 15:16:36 +0000
Subject: [PATCH 0303/1478] Fix style.

---
 src/Processors/QueryPlan/CreatingSetsStep.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 264c4b9ef47..0909ee9f1eb 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -46,7 +46,6 @@ CreatingSetStep::CreatingSetStep(
     , network_transfer_limits(std::move(network_transfer_limits_))
     , context(std::move(context_))
 {
-    std::cerr << StackTrace().toString() << std::endl;
 }
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)

From a0901b1d1cb938759e6bcca37d0b03df0c1929e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Fri, 2 Jun 2023 15:33:38 +0000
Subject: [PATCH 0304/1478] Add tests

---
 .../02771_system_user_processes.reference         |  6 ++++++
 .../0_stateless/02771_system_user_processes.sh    | 15 +++++++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 tests/queries/0_stateless/02771_system_user_processes.reference
 create mode 100755 tests/queries/0_stateless/02771_system_user_processes.sh

diff --git a/tests/queries/0_stateless/02771_system_user_processes.reference b/tests/queries/0_stateless/02771_system_user_processes.reference
new file mode 100644
index 00000000000..ab0ff41ddc5
--- /dev/null
+++ b/tests/queries/0_stateless/02771_system_user_processes.reference
@@ -0,0 +1,6 @@
+0
+0
+default
+test_user_02771
+default	true	true
+test_user_02771	2	2
diff --git a/tests/queries/0_stateless/02771_system_user_processes.sh b/tests/queries/0_stateless/02771_system_user_processes.sh
new file mode 100755
index 00000000000..e8bf88a9fb2
--- /dev/null
+++ b/tests/queries/0_stateless/02771_system_user_processes.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS test_user_02771"
+$CLICKHOUSE_CLIENT -q "CREATE USER test_user_02771"
+$CLICKHOUSE_CLIENT -u test_user_02771 -q "SELECT * FROM system.numbers LIMIT 1"
+$CLICKHOUSE_CLIENT -u test_user_02771 -q "SELECT * FROM system.numbers LIMIT 1"
+$CLICKHOUSE_CLIENT -q "SELECT user FROM system.user_processes"
+$CLICKHOUSE_CLIENT -q "SELECT user, toBool(ProfileEvents['SelectQuery'] > 0), toBool(ProfileEvents['Query'] > 0) FROM system.user_processes WHERE user='default'"
+$CLICKHOUSE_CLIENT -q "SELECT user, ProfileEvents['SelectQuery'], ProfileEvents['Query'] FROM system.user_processes WHERE user='test_user_02771'"
+$CLICKHOUSE_CLIENT -q "DROP USER test_user_02771"
+

From 4209ccfc088f832c49d7c530b517e73a2661504a Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 2 Jun 2023 17:42:04 +0200
Subject: [PATCH 0305/1478] fix

---
 .../MergeTree/ReplicatedMergeTreeSink.h       |  1 +
 src/Storages/StorageReplicatedMergeTree.cpp   | 53 +++++++++++--------
 tests/config/config.d/merge_tree.xml          |  2 +
 tests/integration/test_ttl_replicated/test.py |  6 +--
 4 files changed, 37 insertions(+), 25 deletions(-)

diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
index 3efd364fc9c..8d9e2e14129 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
@@ -87,6 +87,7 @@ private:
     size_t checkQuorumPrecondition(const ZooKeeperWithFaultInjectionPtr & zookeeper);
 
     /// Rename temporary part and commit to ZooKeeper.
+    /// Returns a list of conflicting async blocks and true if the whole parts was deduplicated
     std::pair<std::vector<String>, bool> commitPart(
         const ZooKeeperWithFaultInjectionPtr & zookeeper,
         MergeTreeData::MutableDataPartPtr & part,
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 44403fc708b..0a61369e163 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -1936,6 +1936,30 @@ MutableDataPartStoragePtr StorageReplicatedMergeTree::executeFetchShared(
     }
 }
 
+static void paranoidCheckForCoveredPartsInZooKeeper(const ZooKeeperPtr & zookeeper, const String & replica_path,
+                                                    MergeTreeDataFormatVersion format_version, const String & covering_part_name)
+{
+#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_drop_range", paranoid_check_for_covered_parts_default);
+    if (paranoid_check_for_covered_parts)
+    {
+        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);
+        }
+    }
+}
 
 void StorageReplicatedMergeTree::executeDropRange(const LogEntry & entry)
 {
@@ -1992,16 +2016,7 @@ void StorageReplicatedMergeTree::executeDropRange(const LogEntry & entry)
 
     /// Forcibly remove parts from ZooKeeper
     removePartsFromZooKeeperWithRetries(parts_to_remove);
-
-#ifdef ABORT_ON_LOGICAL_ERROR
-    Strings parts_remain = getZooKeeper()->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, entry.new_part_name);
-    }
-#endif
+    paranoidCheckForCoveredPartsInZooKeeper(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);
@@ -2137,6 +2152,8 @@ 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);
         return true;
     }
 
@@ -2433,6 +2450,8 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
     }
 
     removePartsFromZooKeeperWithRetries(parts_to_remove);
+    if (replace)
+        paranoidCheckForCoveredPartsInZooKeeper(getZooKeeper(), replica_path, format_version, entry_replace.drop_range_part_name);
     res_parts.clear();
     parts_to_remove.clear();
     cleanup_thread.wakeup();
@@ -7133,7 +7152,6 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
             clearBlocksInPartition(*zookeeper, drop_range.partition_id, drop_range.max_block, drop_range.max_block);
         }
 
-        PartsToRemoveFromZooKeeper parts_to_remove;
         Coordination::Responses op_results;
 
         try
@@ -7184,7 +7202,7 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
                 auto data_parts_lock = lockParts();
                 transaction.commit(&data_parts_lock);
                 if (replace)
-                    parts_to_remove = removePartsInRangeFromWorkingSetAndGetPartsToRemoveFromZooKeeper(NO_TRANSACTION_RAW, drop_range, 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()));
@@ -7204,11 +7222,6 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
         for (auto & lock : ephemeral_locks)
             lock.assumeUnlocked();
 
-        /// Forcibly remove replaced parts from ZooKeeper
-        removePartsFromZooKeeperWithRetries(parts_to_remove);
-
-        /// Speedup removing of replaced parts from filesystem
-        parts_to_remove.clear();
         cleanup_thread.wakeup();
 
         lock2.reset();
@@ -7377,7 +7390,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
 
         clearBlocksInPartition(*zookeeper, drop_range.partition_id, drop_range.max_block, drop_range.max_block);
 
-        PartsToRemoveFromZooKeeper parts_to_remove;
         Coordination::Responses op_results;
 
         try
@@ -7414,7 +7426,7 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
                 else
                     zkutil::KeeperMultiException::check(code, ops, op_results);
 
-                parts_to_remove = removePartsInRangeFromWorkingSetAndGetPartsToRemoveFromZooKeeper(NO_TRANSACTION_RAW, drop_range, src_data_parts_lock);
+                removePartsInRangeFromWorkingSet(NO_TRANSACTION_RAW, drop_range, src_data_parts_lock);
                 transaction.commit(&src_data_parts_lock);
             }
 
@@ -7436,9 +7448,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
         for (auto & lock : ephemeral_locks)
             lock.assumeUnlocked();
 
-        removePartsFromZooKeeperWithRetries(parts_to_remove);
-
-        parts_to_remove.clear();
         cleanup_thread.wakeup();
         lock2.reset();
 
diff --git a/tests/config/config.d/merge_tree.xml b/tests/config/config.d/merge_tree.xml
index bf2da9b09a2..bee9812274c 100644
--- a/tests/config/config.d/merge_tree.xml
+++ b/tests/config/config.d/merge_tree.xml
@@ -3,4 +3,6 @@
         <enable_the_endpoint_id_with_zookeeper_name_prefix>1</enable_the_endpoint_id_with_zookeeper_name_prefix>
         <number_of_free_entries_in_pool_to_execute_mutation>8</number_of_free_entries_in_pool_to_execute_mutation>
     </merge_tree>
+
+    <replicated_merge_tree_paranoid_check_on_drop_range>1</replicated_merge_tree_paranoid_check_on_drop_range>
 </clickhouse>
diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index a3e7d6e4b8b..39d66d857ff 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -517,7 +517,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
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
             """.format(
                 suff=num_run, replica=node.name
             )
@@ -529,7 +529,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
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
             """.format(
                 suff=num_run, replica=node.name
             )
@@ -541,7 +541,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
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
             """.format(
                 suff=num_run, replica=node.name
             )

From 179b6aca6aec1962fe3690d037aa0dae27531f5d Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 2 Jun 2023 17:52:57 +0200
Subject: [PATCH 0306/1478] fix

---
 src/Storages/StorageReplicatedMergeTree.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 0a61369e163..5b7616d5f28 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -2846,6 +2846,8 @@ void StorageReplicatedMergeTree::cloneReplica(const String & source_replica, Coo
     }
 
     LOG_DEBUG(log, "Copied {} queue entries, {} entries ignored", total_entries_to_copy, source_queue.size() - total_entries_to_copy);
+    LOG_TRACE(log, "Parts in ZooKeeper after mimic: {}", fmt::join(zookeeper->getChildren(replica_path + "/parts"), ", "));
+    LOG_TRACE(log, "Enqueued fetches after mimic: {}", fmt::join(created_get_parts, ", "));
 }
 
 

From da4d55cdaf4e25e16ddbf9028e6c8f5d336c60f6 Mon Sep 17 00:00:00 2001
From: Valentin Alexeev <valentin.alekseev@gmail.com>
Date: Fri, 2 Jun 2023 14:02:26 +0200
Subject: [PATCH 0307/1478] Additional error information when JSON is too large

If a parser fails on a large JSON, then output the last position processed to allow review.
---
 src/Formats/JSONUtils.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/JSONUtils.cpp b/src/Formats/JSONUtils.cpp
index 284cffdb9d7..7b7c073b6b2 100644
--- a/src/Formats/JSONUtils.cpp
+++ b/src/Formats/JSONUtils.cpp
@@ -45,9 +45,9 @@ namespace JSONUtils
             const auto current_object_size = memory.size() + static_cast<size_t>(pos - in.position());
             if (min_bytes != 0 && current_object_size > 10 * min_bytes)
                 throw ParsingException(ErrorCodes::INCORRECT_DATA,
-                    "Size of JSON object is extremely large. Expected not greater than {} bytes, but current is {} bytes per row. "
+                    "Size of JSON object at position {} is extremely large. Expected not greater than {} bytes, but current is {} bytes per row. "
                     "Increase the value setting 'min_chunk_bytes_for_parallel_parsing' or check your data manually, "
-                    "most likely JSON is malformed", min_bytes, current_object_size);
+                    "most likely JSON is malformed", pos, min_bytes, current_object_size);
 
             if (quotes)
             {

From 516cda94eeb6c822b12697fd32921cc79ea97c15 Mon Sep 17 00:00:00 2001
From: Valentin Alexeev <valentin.alekseev@gmail.com>
Date: Fri, 2 Jun 2023 17:14:21 +0200
Subject: [PATCH 0308/1478] Use in.count() instead of pos

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

diff --git a/src/Formats/JSONUtils.cpp b/src/Formats/JSONUtils.cpp
index 7b7c073b6b2..0aac72c68fe 100644
--- a/src/Formats/JSONUtils.cpp
+++ b/src/Formats/JSONUtils.cpp
@@ -47,7 +47,7 @@ namespace JSONUtils
                 throw ParsingException(ErrorCodes::INCORRECT_DATA,
                     "Size of JSON object at position {} is extremely large. Expected not greater than {} bytes, but current is {} bytes per row. "
                     "Increase the value setting 'min_chunk_bytes_for_parallel_parsing' or check your data manually, "
-                    "most likely JSON is malformed", pos, min_bytes, current_object_size);
+                    "most likely JSON is malformed", in.count(), min_bytes, current_object_size);
 
             if (quotes)
             {

From 9b8975194821fe44018ed5bcbc9d5ae088b970f5 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 2 Jun 2023 12:52:06 -0400
Subject: [PATCH 0309/1478] add docs for parallel view processing

---
 docs/en/operations/settings/settings.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 6c951739d41..5730503a670 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4229,6 +4229,12 @@ Default value: `2000`
 If it's enabled, in hedged requests we can start new connection until receiving first data packet even if we have already made some progress
 (but progress haven't updated for `receive_data_timeout` timeout), otherwise we disable changing replica after the first time we made progress.
 
+## parallel_view_processing
+
+Enables pushing to attached views concurrently instead of sequentially.
+
+Default value: `false`.
+
 ## partial_result_on_first_cancel {#partial_result_on_first_cancel}
 When set to `true` and the user wants to interrupt a query (for example using `Ctrl+C` on the client), then the query continues execution only on data that was already read from the table. Afterwards, it will return a partial result of the query for the part of the table that was read. To fully stop the execution of a query without a partial result, the user should send 2 cancel requests.
 

From d28b4181e94c5602b5512af8ed541dcc2a1a55f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Fri, 2 Jun 2023 16:57:36 +0000
Subject: [PATCH 0310/1478] Add `SHOW USER PROCESSES` query

---
 src/Interpreters/InterpreterFactory.cpp       |  6 ++++
 .../InterpreterShowUserProcessesQuery.cpp     | 18 +++++++++++
 .../InterpreterShowUserProcessesQuery.h       | 30 +++++++++++++++++
 src/Parsers/ASTShowUserProcessesQuery.h       | 17 ++++++++++
 src/Parsers/ParserQueryWithOutput.cpp         |  5 ++-
 src/Parsers/ParserShowUserProcessesQuery.h    | 32 +++++++++++++++++++
 6 files changed, 107 insertions(+), 1 deletion(-)
 create mode 100644 src/Interpreters/InterpreterShowUserProcessesQuery.cpp
 create mode 100644 src/Interpreters/InterpreterShowUserProcessesQuery.h
 create mode 100644 src/Parsers/ASTShowUserProcessesQuery.h
 create mode 100644 src/Parsers/ParserShowUserProcessesQuery.h

diff --git a/src/Interpreters/InterpreterFactory.cpp b/src/Interpreters/InterpreterFactory.cpp
index 9cd1f2a251c..c31e3801478 100644
--- a/src/Interpreters/InterpreterFactory.cpp
+++ b/src/Interpreters/InterpreterFactory.cpp
@@ -23,6 +23,7 @@
 #include <Parsers/ASTShowTablesQuery.h>
 #include <Parsers/ASTShowColumnsQuery.h>
 #include <Parsers/ASTShowIndexesQuery.h>
+#include <Parsers/ASTShowUserProcessesQuery.h>
 #include <Parsers/ASTUseQuery.h>
 #include <Parsers/ASTWatchQuery.h>
 #include <Parsers/ASTCreateNamedCollectionQuery.h>
@@ -81,6 +82,7 @@
 #include <Interpreters/InterpreterShowEngineQuery.h>
 #include <Interpreters/InterpreterShowProcesslistQuery.h>
 #include <Interpreters/InterpreterShowTablesQuery.h>
+#include <Interpreters/InterpreterShowUserProcessesQuery.h>
 #include <Interpreters/InterpreterShowColumnsQuery.h>
 #include <Interpreters/InterpreterShowIndexesQuery.h>
 #include <Interpreters/InterpreterSystemQuery.h>
@@ -266,6 +268,10 @@ std::unique_ptr<IInterpreter> InterpreterFactory::get(ASTPtr & query, ContextMut
     {
         return std::make_unique<InterpreterShowProcesslistQuery>(query, context);
     }
+    else if (query->as<ASTShowUserProcessesQuery>())
+    {
+        return std::make_unique<InterpreterShowUserProcessesQuery>(query, context);
+    }
     else if (query->as<ASTAlterQuery>())
     {
         return std::make_unique<InterpreterAlterQuery>(query, context);
diff --git a/src/Interpreters/InterpreterShowUserProcessesQuery.cpp b/src/Interpreters/InterpreterShowUserProcessesQuery.cpp
new file mode 100644
index 00000000000..51287a7ad5b
--- /dev/null
+++ b/src/Interpreters/InterpreterShowUserProcessesQuery.cpp
@@ -0,0 +1,18 @@
+#include <IO/ReadBufferFromString.h>
+
+#include <Interpreters/Context.h>
+#include <Interpreters/executeQuery.h>
+#include <Interpreters/InterpreterShowUserProcessesQuery.h>
+
+#include <Parsers/ASTQueryWithOutput.h>
+
+
+namespace DB
+{
+
+BlockIO InterpreterShowUserProcessesQuery::execute()
+{
+    return executeQuery("SELECT * FROM system.user_processes ORDER BY user DESC", getContext(), true);
+}
+
+}
diff --git a/src/Interpreters/InterpreterShowUserProcessesQuery.h b/src/Interpreters/InterpreterShowUserProcessesQuery.h
new file mode 100644
index 00000000000..a1c385dc82f
--- /dev/null
+++ b/src/Interpreters/InterpreterShowUserProcessesQuery.h
@@ -0,0 +1,30 @@
+#pragma once
+
+#include <Interpreters/IInterpreter.h>
+#include <Parsers/IAST_fwd.h>
+
+
+namespace DB
+{
+
+/** Return list of currently executing queries.
+TODO(antaljanosbenjamin)
+  */
+class InterpreterShowUserProcessesQuery : public IInterpreter, WithMutableContext
+{
+public:
+    InterpreterShowUserProcessesQuery(const ASTPtr & query_ptr_, ContextMutablePtr context_)
+        : WithMutableContext(context_), query_ptr(query_ptr_) {}
+
+    BlockIO execute() override;
+
+    /// We ignore the quota and limits here because execute() will rewrite a show query as a SELECT query and then
+    /// the SELECT query will checks the quota and limits.
+    bool ignoreQuota() const override { return true; }
+    bool ignoreLimits() const override { return true; }
+
+private:
+    ASTPtr query_ptr;
+};
+
+}
diff --git a/src/Parsers/ASTShowUserProcessesQuery.h b/src/Parsers/ASTShowUserProcessesQuery.h
new file mode 100644
index 00000000000..cd522c152b6
--- /dev/null
+++ b/src/Parsers/ASTShowUserProcessesQuery.h
@@ -0,0 +1,17 @@
+#pragma once
+
+#include <Parsers/ASTQueryWithOutput.h>
+
+
+namespace DB
+{
+
+struct ASTShowUserProcessesIDAndQueryNames
+{
+    static constexpr auto ID = "ShowUserProcesses";
+    static constexpr auto Query = "SHOW USER PROCESSES";
+};
+
+using ASTShowUserProcessesQuery = ASTQueryWithOutputImpl<ASTShowUserProcessesIDAndQueryNames>;
+
+}
diff --git a/src/Parsers/ParserQueryWithOutput.cpp b/src/Parsers/ParserQueryWithOutput.cpp
index 6796f4528c4..d5293e5f709 100644
--- a/src/Parsers/ParserQueryWithOutput.cpp
+++ b/src/Parsers/ParserQueryWithOutput.cpp
@@ -15,6 +15,7 @@
 #include <Parsers/ParserSelectWithUnionQuery.h>
 #include <Parsers/ParserSetQuery.h>
 #include <Parsers/ParserShowProcesslistQuery.h>
+#include <Parsers/ParserShowUserProcessesQuery.h>
 #include <Parsers/ParserShowTablesQuery.h>
 #include <Parsers/ParserShowColumnsQuery.h>
 #include <Parsers/ParserShowEngineQuery.h>
@@ -61,6 +62,7 @@ bool ParserQueryWithOutput::parseImpl(Pos & pos, ASTPtr & node, Expected & expec
     ParserShowGrantsQuery show_grants_p;
     ParserShowPrivilegesQuery show_privileges_p;
     ParserExplainQuery explain_p(end, allow_settings_after_format_in_insert);
+    ParserShowUserProcessesQuery show_user_processes_p;
 
     ASTPtr query;
 
@@ -88,7 +90,8 @@ bool ParserQueryWithOutput::parseImpl(Pos & pos, ASTPtr & node, Expected & expec
         || show_access_p.parse(pos, query, expected)
         || show_access_entities_p.parse(pos, query, expected)
         || show_grants_p.parse(pos, query, expected)
-        || show_privileges_p.parse(pos, query, expected);
+        || show_privileges_p.parse(pos, query, expected)
+        || show_user_processes_p.parse(pos, query, expected);
 
     if (!parsed)
         return false;
diff --git a/src/Parsers/ParserShowUserProcessesQuery.h b/src/Parsers/ParserShowUserProcessesQuery.h
new file mode 100644
index 00000000000..be484e74d5d
--- /dev/null
+++ b/src/Parsers/ParserShowUserProcessesQuery.h
@@ -0,0 +1,32 @@
+#pragma once
+
+#include <Parsers/ASTShowUserProcessesQuery.h>
+#include <Parsers/CommonParsers.h>
+#include <Parsers/ExpressionElementParsers.h>
+#include <Parsers/IParserBase.h>
+
+
+namespace DB
+{
+
+/** Query SHOW USER PROCESSES
+  */
+class ParserShowUserProcessesQuery : public IParserBase
+{
+protected:
+    const char * getName() const override { return "SHOW USER PROCESSES query"; }
+
+    bool parseImpl(Pos & pos, ASTPtr & node, Expected & expected) override
+    {
+        auto query = std::make_shared<ASTShowUserProcessesQuery>();
+
+        if (!ParserKeyword("SHOW USER PROCESSES").ignore(pos, expected))
+            return false;
+
+        node = query;
+
+        return true;
+    }
+};
+
+}

From 96fe4b5107611a627b7981fdac2afe9304660e48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Fri, 2 Jun 2023 16:57:46 +0000
Subject: [PATCH 0311/1478] Add tests

---
 .../02771_system_user_processes.reference     |  5 ++---
 .../02771_system_user_processes.sh            | 19 +++++++++++--------
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/tests/queries/0_stateless/02771_system_user_processes.reference b/tests/queries/0_stateless/02771_system_user_processes.reference
index ab0ff41ddc5..8c8ca8abb52 100644
--- a/tests/queries/0_stateless/02771_system_user_processes.reference
+++ b/tests/queries/0_stateless/02771_system_user_processes.reference
@@ -1,6 +1,5 @@
+SHOW USER PROCESSES query succeeded!
 0
 0
-default
-test_user_02771
 default	true	true
-test_user_02771	2	2
+2	2
diff --git a/tests/queries/0_stateless/02771_system_user_processes.sh b/tests/queries/0_stateless/02771_system_user_processes.sh
index e8bf88a9fb2..910af4be9e2 100755
--- a/tests/queries/0_stateless/02771_system_user_processes.sh
+++ b/tests/queries/0_stateless/02771_system_user_processes.sh
@@ -4,12 +4,15 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CUR_DIR"/../shell_config.sh
 
-$CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS test_user_02771"
-$CLICKHOUSE_CLIENT -q "CREATE USER test_user_02771"
-$CLICKHOUSE_CLIENT -u test_user_02771 -q "SELECT * FROM system.numbers LIMIT 1"
-$CLICKHOUSE_CLIENT -u test_user_02771 -q "SELECT * FROM system.numbers LIMIT 1"
-$CLICKHOUSE_CLIENT -q "SELECT user FROM system.user_processes"
-$CLICKHOUSE_CLIENT -q "SELECT user, toBool(ProfileEvents['SelectQuery'] > 0), toBool(ProfileEvents['Query'] > 0) FROM system.user_processes WHERE user='default'"
-$CLICKHOUSE_CLIENT -q "SELECT user, ProfileEvents['SelectQuery'], ProfileEvents['Query'] FROM system.user_processes WHERE user='test_user_02771'"
-$CLICKHOUSE_CLIENT -q "DROP USER test_user_02771"
+USER_POSTFIX=`random_str 10`
+USER="test_user_02771_$USER_POSTFIX"
+
+$CLICKHOUSE_CLIENT -q "SHOW USER PROCESSES" &>"${CLICKHOUSE_TMP}/test_output" && echo "SHOW USER PROCESSES query succeeded!" || cat "${CLICKHOUSE_TMP}/test_output" 
+$CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS $USER"
+$CLICKHOUSE_CLIENT -q "CREATE USER $USER"
+$CLICKHOUSE_CLIENT -u "$USER" -q "SELECT * FROM system.numbers LIMIT 1"
+$CLICKHOUSE_CLIENT -u "$USER" -q "SELECT * FROM system.numbers LIMIT 1"
+$CLICKHOUSE_CLIENT -q "SELECT user, toBool(ProfileEvents['SelectQuery'] > 0), toBool(ProfileEvents['Query'] > 0) FROM system.user_processes WHERE user='default'"
+$CLICKHOUSE_CLIENT -q "SELECT ProfileEvents['SelectQuery'], ProfileEvents['Query'] FROM system.user_processes WHERE user='$USER'"
+$CLICKHOUSE_CLIENT -q "DROP USER $USER"
 

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 0312/1478] 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 09b5b0c3f7a1265e5b21f2a818ec05c9afdc48e4 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 2 Jun 2023 13:31:02 -0400
Subject: [PATCH 0313/1478] add word

---
 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 2feb7981fcc..0455556ae96 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1453,6 +1453,7 @@ gRPC
 gccMurmurHash
 gcem
 generateRandom
+generateRandomStructure
 generateULID
 generateUUIDv
 geoDistance

From 50654435dc1cf6ac826d08d28adf2e669250d5ec Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Fri, 2 Jun 2023 19:36:37 +0000
Subject: [PATCH 0314/1478] Implement endianness-independent serialization for
 UUID

---
 .../Serializations/SerializationUUID.cpp      | 16 ++---
 src/IO/ReadHelpers.cpp                        | 72 +++++++++----------
 src/IO/ReadHelpers.h                          | 15 ++--
 src/IO/WriteHelpers.cpp                       | 38 +++++++---
 src/IO/WriteHelpers.h                         |  7 +-
 .../Formats/Impl/AvroRowInputFormat.cpp       |  3 +-
 .../Formats/Impl/AvroRowOutputFormat.cpp      |  5 +-
 7 files changed, 75 insertions(+), 81 deletions(-)

diff --git a/src/DataTypes/Serializations/SerializationUUID.cpp b/src/DataTypes/Serializations/SerializationUUID.cpp
index ee1327ef094..13313111b2b 100644
--- a/src/DataTypes/Serializations/SerializationUUID.cpp
+++ b/src/DataTypes/Serializations/SerializationUUID.cpp
@@ -51,19 +51,11 @@ void SerializationUUID::deserializeTextQuoted(IColumn & column, ReadBuffer & ist
     {
         assertChar('\'', istr);
         char * next_pos = find_first_symbols<'\\', '\''>(istr.position(), istr.buffer().end());
-        size_t len = next_pos - istr.position();
-        if ((len == 32) && (istr.position()[32] == '\''))
+        const auto len = next_pos - istr.position();
+        if ((len == 32 || len == 36) && istr.position()[len] == '\'')
         {
-            parseUUIDWithoutSeparator(
-                reinterpret_cast<const UInt8 *>(istr.position()), std::reverse_iterator<UInt8 *>(reinterpret_cast<UInt8 *>(&uuid) + 16));
-            istr.ignore(33);
-            fast = true;
-        }
-        else if ((len == 36) && (istr.position()[36] == '\''))
-        {
-            parseUUID(
-                reinterpret_cast<const UInt8 *>(istr.position()), std::reverse_iterator<UInt8 *>(reinterpret_cast<UInt8 *>(&uuid) + 16));
-            istr.ignore(37);
+            uuid = parseUUID(std::span(reinterpret_cast<const UInt8 *>(istr.position()), len));
+            istr.ignore(len + 1);
             fast = true;
         }
         else
diff --git a/src/IO/ReadHelpers.cpp b/src/IO/ReadHelpers.cpp
index 99d25ee6613..a85a057f2b3 100644
--- a/src/IO/ReadHelpers.cpp
+++ b/src/IO/ReadHelpers.cpp
@@ -46,48 +46,40 @@ inline void parseHex(IteratorSrc src, IteratorDst dst)
         dst[dst_pos] = unhex2(reinterpret_cast<const char *>(&src[src_pos]));
 }
 
-void parseUUID(const UInt8 * src36, UInt8 * dst16)
+UUID parseUUID(std::span<const UInt8> src)
 {
-    /// If string is not like UUID - implementation specific behaviour.
+    UUID uuid;
+    const auto * src_ptr = src.data();
+    auto * dst = reinterpret_cast<UInt8 *>(&uuid);
+    if (const auto size = src.size(); size == 36)
+    {
+#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+        parseHex<4>(src_ptr, dst);
+        parseHex<2>(src_ptr + 9, dst + 4);
+        parseHex<2>(src_ptr + 14, dst + 6);
+        parseHex<2>(src_ptr + 19, dst + 8);
+        parseHex<6>(src_ptr + 24, dst + 10);
+#else
+        const std::reverse_iterator dst_it(dst + sizeof(UUID));
+        /// FIXME This code looks like trash.
+        parseHex<4>(src_ptr, dst + 8);
+        parseHex<2>(src_ptr + 9, dst + 12);
+        parseHex<2>(src_ptr + 14, dst + 14);
+        parseHex<2>(src_ptr + 19, dst);
+        parseHex<6>(src_ptr + 24, dst + 2);
+#endif
+    }
+    else if (size == 32)
+    {
+#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+        parseHex<16>(src_ptr, dst);
+#else
+        parseHex<8>(src_ptr, dst + 8);
+        parseHex<8>(src_ptr + 16, dst);
+#endif
+    }
 
-    parseHex<4>(&src36[0], &dst16[0]);
-    parseHex<2>(&src36[9], &dst16[4]);
-    parseHex<2>(&src36[14], &dst16[6]);
-    parseHex<2>(&src36[19], &dst16[8]);
-    parseHex<6>(&src36[24], &dst16[10]);
-}
-
-void parseUUIDWithoutSeparator(const UInt8 * src36, UInt8 * dst16)
-{
-    /// If string is not like UUID - implementation specific behaviour.
-
-    parseHex<16>(&src36[0], &dst16[0]);
-}
-
-/** Function used when byte ordering is important when parsing uuid
- *  ex: When we create an UUID type
- */
-void parseUUID(const UInt8 * src36, std::reverse_iterator<UInt8 *> dst16)
-{
-    /// If string is not like UUID - implementation specific behaviour.
-
-    /// FIXME This code looks like trash.
-    parseHex<4>(&src36[0], dst16 + 8);
-    parseHex<2>(&src36[9], dst16 + 12);
-    parseHex<2>(&src36[14], dst16 + 14);
-    parseHex<2>(&src36[19], dst16);
-    parseHex<6>(&src36[24], dst16 + 2);
-}
-
-/** Function used when byte ordering is important when parsing uuid
- *  ex: When we create an UUID type
- */
-void parseUUIDWithoutSeparator(const UInt8 * src36, std::reverse_iterator<UInt8 *> dst16)
-{
-    /// If string is not like UUID - implementation specific behaviour.
-
-    parseHex<8>(&src36[0], dst16 + 8);
-    parseHex<8>(&src36[16], dst16);
+    return uuid;
 }
 
 void NO_INLINE throwAtAssertionFailed(const char * s, ReadBuffer & buf)
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 32338552b66..7e293944d19 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -8,6 +8,7 @@
 #include <algorithm>
 #include <iterator>
 #include <bit>
+#include <span>
 
 #include <type_traits>
 
@@ -623,12 +624,6 @@ struct NullOutput
     void push_back(char) {} /// NOLINT
 };
 
-void parseUUID(const UInt8 * src36, UInt8 * dst16);
-void parseUUIDWithoutSeparator(const UInt8 * src36, UInt8 * dst16);
-void parseUUID(const UInt8 * src36, std::reverse_iterator<UInt8 *> dst16);
-void parseUUIDWithoutSeparator(const UInt8 * src36, std::reverse_iterator<UInt8 *> dst16);
-
-
 template <typename ReturnType>
 ReturnType readDateTextFallback(LocalDate & date, ReadBuffer & buf);
 
@@ -770,6 +765,9 @@ inline bool tryReadDateText(ExtendedDayNum & date, ReadBuffer & buf)
     return readDateTextImpl<bool>(date, buf);
 }
 
+/// If string is not like UUID - implementation specific behaviour.
+UUID parseUUID(std::span<const UInt8> src);
+
 template <typename ReturnType = void>
 inline ReturnType readUUIDTextImpl(UUID & uuid, ReadBuffer & buf)
 {
@@ -797,12 +795,9 @@ inline ReturnType readUUIDTextImpl(UUID & uuid, ReadBuffer & buf)
                     return ReturnType(false);
                 }
             }
-
-            parseUUID(reinterpret_cast<const UInt8 *>(s), std::reverse_iterator<UInt8 *>(reinterpret_cast<UInt8 *>(&uuid) + 16));
         }
-        else
-            parseUUIDWithoutSeparator(reinterpret_cast<const UInt8 *>(s), std::reverse_iterator<UInt8 *>(reinterpret_cast<UInt8 *>(&uuid) + 16));
 
+        uuid = parseUUID({reinterpret_cast<const UInt8 *>(s), size});
         return ReturnType(true);
     }
     else
diff --git a/src/IO/WriteHelpers.cpp b/src/IO/WriteHelpers.cpp
index a0eceddc6f6..6023d4c9d5b 100644
--- a/src/IO/WriteHelpers.cpp
+++ b/src/IO/WriteHelpers.cpp
@@ -23,17 +23,35 @@ void formatHex(IteratorSrc src, IteratorDst dst, size_t num_bytes)
 /** Function used when byte ordering is important when parsing uuid
  *  ex: When we create an UUID type
  */
-void formatUUID(std::reverse_iterator<const UInt8 *> src16, UInt8 * dst36)
+std::array<char, 36> formatUUID(const UUID & uuid)
 {
-    formatHex(src16 + 8, &dst36[0], 4);
-    dst36[8] = '-';
-    formatHex(src16 + 12, &dst36[9], 2);
-    dst36[13] = '-';
-    formatHex(src16 + 14, &dst36[14], 2);
-    dst36[18] = '-';
-    formatHex(src16, &dst36[19], 2);
-    dst36[23] = '-';
-    formatHex(src16 + 2, &dst36[24], 6);
+    std::array<char, 36> dst;
+    const auto * src_ptr = reinterpret_cast<const UInt8 *>(&uuid);
+    auto * dst_ptr = dst.data();
+#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+    formatHex(src_ptr, dst_ptr, 4);
+    dst[8] = '-';
+    formatHex(src_ptr + 4, dst_ptr + 9, 2);
+    dst[13] = '-';
+    formatHex(src_ptr + 6, dst_ptr + 14, 2);
+    dst[18] = '-';
+    formatHex(src_ptr + 8, dst_ptr + 19, 2);
+    dst[23] = '-';
+    formatHex(src_ptr + 10, dst_ptr + 24, 6);
+#else
+    const std::reverse_iterator src_it(src_ptr + 16);
+    formatHex(src_it + 8, dst_ptr, 4);
+    dst[8] = '-';
+    formatHex(src_it + 12, dst_ptr + 9, 2);
+    dst[13] = '-';
+    formatHex(src_it + 14, dst_ptr + 14, 2);
+    dst[18] = '-';
+    formatHex(src_it, dst_ptr + 19, 2);
+    dst[23] = '-';
+    formatHex(src_it + 2, dst_ptr + 24, 6);
+#endif
+
+    return dst;
 }
 
 void writeIPv4Text(const IPv4 & ip, WriteBuffer & buf)
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index cdbc952690c..923684c4249 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -625,13 +625,12 @@ inline void writeXMLStringForTextElement(std::string_view s, WriteBuffer & buf)
     writeXMLStringForTextElement(s.data(), s.data() + s.size(), buf);
 }
 
-void formatUUID(std::reverse_iterator<const UInt8 *> src16, UInt8 * dst36);
+std::array<char, 36> formatUUID(const UUID & uuid);
 
 inline void writeUUIDText(const UUID & uuid, WriteBuffer & buf)
 {
-    char s[36];
-    formatUUID(std::reverse_iterator<const UInt8 *>(reinterpret_cast<const UInt8 *>(&uuid) + 16), reinterpret_cast<UInt8 *>(s));
-    buf.write(s, sizeof(s));
+    const auto text = formatUUID(uuid);
+    buf.write(text.data(), text.size());
 }
 
 void writeIPv4Text(const IPv4 & ip, WriteBuffer & buf);
diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index c2602a4d1d5..974b198a483 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -256,8 +256,7 @@ AvroDeserializer::DeserializeFn AvroDeserializer::createDeserializeFn(const avro
                     if (tmp.length() != 36)
                         throw ParsingException(ErrorCodes::CANNOT_PARSE_UUID, "Cannot parse uuid {}", tmp);
 
-                    UUID uuid;
-                    parseUUID(reinterpret_cast<const UInt8 *>(tmp.data()), std::reverse_iterator<UInt8 *>(reinterpret_cast<UInt8 *>(&uuid) + 16));
+                    const auto uuid = parseUUID({reinterpret_cast<const UInt8 *>(tmp.data()), tmp.length()});
                     assert_cast<DataTypeUUID::ColumnType &>(column).insertValue(uuid);
                     return true;
                 };
diff --git a/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp b/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
index c743b2c1766..2b163164d56 100644
--- a/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
@@ -329,9 +329,8 @@ AvroSerializer::SchemaWithSerializeFn AvroSerializer::createSchemaWithSerializeF
             return {schema, [](const IColumn & column, size_t row_num, avro::Encoder & encoder)
             {
                 const auto & uuid = assert_cast<const DataTypeUUID::ColumnType &>(column).getElement(row_num);
-                std::array<UInt8, 36> s;
-                formatUUID(std::reverse_iterator<const UInt8 *>(reinterpret_cast<const UInt8 *>(&uuid) + 16), s.data());
-                encoder.encodeBytes(reinterpret_cast<const uint8_t *>(s.data()), s.size());
+                const auto text = formatUUID(uuid);
+                encoder.encodeBytes(reinterpret_cast<const uint8_t *>(text.data()), text.size());
             }};
         }
         case TypeIndex::Array:

From 87eaaa0f7bf43a7145c24e726af8b3b912f38eea Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 2 Jun 2023 16:30:18 -0400
Subject: [PATCH 0315/1478] address review comments

---
 .../table-engines/integrations/embedded-rocksdb.md  | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
index dab741a9f63..6664b6a4613 100644
--- a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
+++ b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
@@ -127,15 +127,17 @@ A special `direct` join with EmbeddedRocksDB tables is supported.
 This direct join avoids forming a hash table in memory and accesses
 the data directly from the EmbeddedRocksDB.
 
+With large joins you may see much lower memory usage with direct joins
+because the hash table is not created.
+
 To enable direct joins:
 ```sql
-SET join_algorithm = 'direct'
+SET join_algorithm = 'direct, hash'
 ```
 
 :::tip
-When the `join_algorithm` is set to `direct`, direct joins will be used
-when possible.  However, direct joins are not used for RIGHT or FULL JOINs.
-ClickHouse will choose another join algorithm when direct joins are not possible.
+When the `join_algorithm` is set to `direct, hash`, direct joins will be used
+when possible, and hash otherwise.
 :::
 
 #### Example
@@ -205,3 +207,6 @@ ORDER BY key ASC
 └─────┴─────────┴────────┴────────┘
 ```
 
+### More information on Joins
+- [`join_algorithm` setting](/docs/en/operations/settings/settings.md#settings-join_algorithm)
+- [JOIN clause](/docs/en/sql-reference/statements/select/join.md)

From 4506299d73a3fbf8fc9446b3eed05fe4d5553c23 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Tue, 30 May 2023 20:53:45 +0200
Subject: [PATCH 0316/1478] impl

---
 docker/test/performance-comparison/report.py | 4 +++-
 tests/ci/performance_comparison_check.py     | 8 +++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docker/test/performance-comparison/report.py b/docker/test/performance-comparison/report.py
index 214f2d550b4..a1f2eb9d9ec 100755
--- a/docker/test/performance-comparison/report.py
+++ b/docker/test/performance-comparison/report.py
@@ -626,7 +626,9 @@ if args.report == "main":
         message_array.append(str(faster_queries) + " faster")
 
     if slower_queries:
-        if slower_queries > 3:
+        # This threshold should be synchronized with the value in https://github.com/ClickHouse/ClickHouse/blob/master/tests/ci/performance_comparison_check.py#L225
+        # False positives rate should be < 1%: https://shorturl.at/CDEK8
+        if slower_queries > 5:
             status = "failure"
         message_array.append(str(slower_queries) + " slower")
 
diff --git a/tests/ci/performance_comparison_check.py b/tests/ci/performance_comparison_check.py
index bf5704f31bd..1baf547816f 100644
--- a/tests/ci/performance_comparison_check.py
+++ b/tests/ci/performance_comparison_check.py
@@ -219,6 +219,12 @@ if __name__ == "__main__":
     except Exception:
         traceback.print_exc()
 
+    def too_many_slow(msg):
+        match = re.search("(|.* )(\d+) slower.*", msg)
+        # This threshold should be synchronized with the value in https://github.com/ClickHouse/ClickHouse/blob/master/docker/test/performance-comparison/report.py#L629
+        threshold = 5
+        return int(match.group(2).strip()) > threshold if match else False
+
     # Try to fetch status from the report.
     status = ""
     message = ""
@@ -236,7 +242,7 @@ if __name__ == "__main__":
 
         # TODO: Remove me, always green mode for the first time, unless errors
         status = "success"
-        if "errors" in message.lower():
+        if "errors" in message.lower() or too_many_slow(message.lower()):
             status = "failure"
         # TODO: Remove until here
     except Exception:

From 530f743ed062157cb0fc74d3bbc0bf51b186c0b5 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Fri, 2 Jun 2023 23:41:25 +0200
Subject: [PATCH 0317/1478] Fix Object data type for StorageDistributed

---
 src/Storages/StorageDistributed.cpp | 3 ++-
 src/Storages/StorageDummy.cpp       | 3 ++-
 src/Storages/StorageDummy.h         | 9 ++++++++-
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 43b1333413e..b9625ce2ab7 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -948,7 +948,8 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
         auto resolved_remote_storage_id = remote_storage_id;
         if (remote_storage_id.hasDatabase())
             resolved_remote_storage_id = query_context->resolveStorageID(remote_storage_id);
-        auto storage = std::make_shared<StorageDummy>(resolved_remote_storage_id, distributed_storage_snapshot->metadata->getColumns());
+
+        auto storage = std::make_shared<StorageDummy>(resolved_remote_storage_id, distributed_storage_snapshot->metadata->getColumns(), distributed_storage_snapshot->object_columns);
         auto table_node = std::make_shared<TableNode>(std::move(storage), query_context);
 
         if (table_expression_modifiers)
diff --git a/src/Storages/StorageDummy.cpp b/src/Storages/StorageDummy.cpp
index e5f3b0b4d8e..4f2fb3883bf 100644
--- a/src/Storages/StorageDummy.cpp
+++ b/src/Storages/StorageDummy.cpp
@@ -9,8 +9,9 @@
 namespace DB
 {
 
-StorageDummy::StorageDummy(const StorageID & table_id_, const ColumnsDescription & columns_)
+StorageDummy::StorageDummy(const StorageID & table_id_, const ColumnsDescription & columns_, ColumnsDescription object_columns_)
     : IStorage(table_id_)
+    , object_columns(std::move(object_columns_))
 {
     StorageInMemoryMetadata storage_metadata;
     storage_metadata.setColumns(columns_);
diff --git a/src/Storages/StorageDummy.h b/src/Storages/StorageDummy.h
index a7beef9d531..2f9a8beb4d0 100644
--- a/src/Storages/StorageDummy.h
+++ b/src/Storages/StorageDummy.h
@@ -11,7 +11,7 @@ namespace DB
 class StorageDummy : public IStorage
 {
 public:
-    StorageDummy(const StorageID & table_id_, const ColumnsDescription & columns_);
+    StorageDummy(const StorageID & table_id_, const ColumnsDescription & columns_, ColumnsDescription object_columns_ = {});
 
     std::string getName() const override { return "StorageDummy"; }
 
@@ -22,6 +22,11 @@ public:
     bool supportsDynamicSubcolumns() const override { return true; }
     bool canMoveConditionsToPrewhere() const override { return false; }
 
+    StorageSnapshotPtr getStorageSnapshot(const StorageMetadataPtr & metadata_snapshot, ContextPtr /*query_context*/) const override
+    {
+        return std::make_shared<StorageSnapshot>(*this, metadata_snapshot, object_columns);
+    }
+
     QueryProcessingStage::Enum getQueryProcessingStage(
         ContextPtr local_context,
         QueryProcessingStage::Enum to_stage,
@@ -37,6 +42,8 @@ public:
         QueryProcessingStage::Enum processed_stage,
         size_t max_block_size,
         size_t num_streams) override;
+private:
+    const ColumnsDescription object_columns;
 };
 
 class ReadFromDummy : public SourceStepWithFilter

From e548dce123debf4864348d606629f90844b5e5f8 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Sat, 3 Jun 2023 00:08:47 +0200
Subject: [PATCH 0318/1478] fix

---
 tests/ci/performance_comparison_check.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/performance_comparison_check.py b/tests/ci/performance_comparison_check.py
index 1baf547816f..41ace95c350 100644
--- a/tests/ci/performance_comparison_check.py
+++ b/tests/ci/performance_comparison_check.py
@@ -220,7 +220,7 @@ if __name__ == "__main__":
         traceback.print_exc()
 
     def too_many_slow(msg):
-        match = re.search("(|.* )(\d+) slower.*", msg)
+        match = re.search(r"(|.* )(\d+) slower.*", msg)
         # This threshold should be synchronized with the value in https://github.com/ClickHouse/ClickHouse/blob/master/docker/test/performance-comparison/report.py#L629
         threshold = 5
         return int(match.group(2).strip()) > threshold if match else False

From 7a7e03a2ffbd879afd5971de6de13c7919a89157 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sat, 3 Jun 2023 14:16:59 +0300
Subject: [PATCH 0319/1478] Function if constant folding

---
 src/Functions/if.cpp                          | 25 +++++++++++++++++++
 .../25337_if_constant_folding.reference       |  5 ++++
 .../0_stateless/25337_if_constant_folding.sql |  1 +
 3 files changed, 31 insertions(+)
 create mode 100644 tests/queries/0_stateless/25337_if_constant_folding.reference
 create mode 100644 tests/queries/0_stateless/25337_if_constant_folding.sql

diff --git a/src/Functions/if.cpp b/src/Functions/if.cpp
index 93bdf406f9d..d00e83c4eb7 100644
--- a/src/Functions/if.cpp
+++ b/src/Functions/if.cpp
@@ -1116,6 +1116,31 @@ public:
 
         return res;
     }
+
+    ColumnPtr getConstantResultForNonConstArguments(const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type) const override
+    {
+        const ColumnWithTypeAndName & arg_cond = arguments[0];
+        if (!arg_cond.column || !isColumnConst(*arg_cond.column)) {
+            return {};
+        }
+
+        const ColumnConst * cond_const_col = checkAndGetColumnConst<ColumnVector<UInt8>>(arg_cond.column.get());
+        bool condition_value = cond_const_col->getValue<UInt8>();
+
+        const ColumnWithTypeAndName & arg_then = arguments[1];
+        const ColumnWithTypeAndName & arg_else = arguments[2];
+        const ColumnWithTypeAndName & potential_const_column = condition_value ? arg_then : arg_else;
+
+        if (!potential_const_column.column || !isColumnConst(*potential_const_column.column))
+            return {};
+
+        auto result = castColumn(potential_const_column, result_type);
+        if (!isColumnConst(*result)) {
+            return {};
+        }
+
+        return result;
+    }
 };
 
 }
diff --git a/tests/queries/0_stateless/25337_if_constant_folding.reference b/tests/queries/0_stateless/25337_if_constant_folding.reference
new file mode 100644
index 00000000000..9dfcf39f5a7
--- /dev/null
+++ b/tests/queries/0_stateless/25337_if_constant_folding.reference
@@ -0,0 +1,5 @@
+0
+1
+2
+3
+4
diff --git a/tests/queries/0_stateless/25337_if_constant_folding.sql b/tests/queries/0_stateless/25337_if_constant_folding.sql
new file mode 100644
index 00000000000..1610465021b
--- /dev/null
+++ b/tests/queries/0_stateless/25337_if_constant_folding.sql
@@ -0,0 +1 @@
+SELECT cast(number, if(1 = 1, 'UInt64', toString(number))) FROM numbers(5);

From 13a122697139f80f34ca006f691fd1f4f20e8528 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Thu, 25 May 2023 16:09:05 +0200
Subject: [PATCH 0320/1478] Fix nested distributed SELECT in WITH clause

For the CSE (common scalar expression, form of CTE) form of WITH it will
set max_result_rows to 1, since there should not be more rows, but this
will be applied for the DESC TABLE as well (service distributed query
that required to obtain the structure).

Note, that it is a problem only for nested distributed queries because
getSubqueryContext() from InterpreterSelectQuery.cpp resets those limits
as well, but this does not helps, for the nested DESC since it is
executed on the remote node that has max_result_rows=1.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Storages/getStructureOfRemoteTable.cpp               | 9 +++++++++
 .../0_stateless/02768_cse_nested_distributed.reference   | 3 +++
 .../queries/0_stateless/02768_cse_nested_distributed.sql | 5 +++++
 3 files changed, 17 insertions(+)
 create mode 100644 tests/queries/0_stateless/02768_cse_nested_distributed.reference
 create mode 100644 tests/queries/0_stateless/02768_cse_nested_distributed.sql

diff --git a/src/Storages/getStructureOfRemoteTable.cpp b/src/Storages/getStructureOfRemoteTable.cpp
index b2737249166..e5fc01be9f4 100644
--- a/src/Storages/getStructureOfRemoteTable.cpp
+++ b/src/Storages/getStructureOfRemoteTable.cpp
@@ -60,6 +60,15 @@ ColumnsDescription getStructureOfRemoteTableInShard(
     ColumnsDescription res;
     auto new_context = ClusterProxy::updateSettingsForCluster(cluster, context, context->getSettingsRef(), table_id);
 
+    /// Ignore limit for result number of rows (that could be set during handling CSE/CTE),
+    /// since this is a service query and should not lead to query failure.
+    {
+        Settings new_settings = new_context->getSettings();
+        new_settings.max_result_rows = 0;
+        new_settings.max_result_bytes = 0;
+        new_context->setSettings(new_settings);
+    }
+
     /// Expect only needed columns from the result of DESC TABLE. NOTE 'comment' column is ignored for compatibility reasons.
     Block sample_block
     {
diff --git a/tests/queries/0_stateless/02768_cse_nested_distributed.reference b/tests/queries/0_stateless/02768_cse_nested_distributed.reference
new file mode 100644
index 00000000000..e8183f05f5d
--- /dev/null
+++ b/tests/queries/0_stateless/02768_cse_nested_distributed.reference
@@ -0,0 +1,3 @@
+1
+1
+1
diff --git a/tests/queries/0_stateless/02768_cse_nested_distributed.sql b/tests/queries/0_stateless/02768_cse_nested_distributed.sql
new file mode 100644
index 00000000000..90e526c0d01
--- /dev/null
+++ b/tests/queries/0_stateless/02768_cse_nested_distributed.sql
@@ -0,0 +1,5 @@
+with (select count() > 0 from remote('127.2', system.settings)) as s select s;
+-- nested
+with (select count() > 0 from remote('127.2', remote('127.2', system.settings))) as s select s;
+-- nested via view()
+with (select count() > 0 from remote('127.2', view(select count() from remote('127.2', system.settings)))) as s select s;

From e28dfb7ea851844c943a4dbab33dcf6d2f468f4e Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sat, 3 Jun 2023 21:44:31 +0300
Subject: [PATCH 0321/1478] Updated tests

---
 tests/queries/0_stateless/00835_if_generic_case.reference | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/00835_if_generic_case.reference b/tests/queries/0_stateless/00835_if_generic_case.reference
index 84c036b17ca..8f9c3f6ef13 100644
--- a/tests/queries/0_stateless/00835_if_generic_case.reference
+++ b/tests/queries/0_stateless/00835_if_generic_case.reference
@@ -3,7 +3,7 @@
 2000-01-01 00:00:00	2000-01-02	2000-01-02 00:00:00
 2000-01-01 00:00:00	2000-01-02	2000-01-02 00:00:00
 2000-01-01 00:00:00	2000-01-02	2000-01-02 00:00:00
-2000-01-01 00:00:00	2000-01-02	2000-01-02
+2000-01-01 00:00:00	2000-01-02	2000-01-02 00:00:00
 2000-01-01 00:00:00	2000-01-02	2000-01-02
 2000-01-01 00:00:00	2000-01-02	2000-01-02
 2000-01-01 00:00:00	2000-01-02	2000-01-01 00:00:00

From 0f37be549236f4b891ec324abd73adfdcc68f0b0 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Thu, 25 May 2023 17:20:07 +0200
Subject: [PATCH 0322/1478] Fix description for BrokenDistributedFilesToInsert

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Common/CurrentMetrics.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 82d68ca8185..63a23c30f84 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -146,7 +146,7 @@
     M(OutdatedPartsLoadingThreads, "Number of threads in the threadpool for loading Outdated data parts.") \
     M(OutdatedPartsLoadingThreadsActive, "Number of active threads in the threadpool for loading Outdated data parts.") \
     M(DistributedFilesToInsert, "Number of pending files to process for asynchronous insertion into Distributed tables. Number of files for every shard is summed.") \
-    M(BrokenDistributedFilesToInsert, "Number of files for asynchronous insertion into Distributed tables that has been marked as broken. This metric will starts from 0 on start. Number of files for every shard is summed.") \
+    M(BrokenDistributedFilesToInsert, "Number of files for asynchronous insertion into Distributed tables that has been marked as broken. Number of files for every shard is summed.") \
     M(TablesToDropQueueSize, "Number of dropped tables, that are waiting for background data removal.") \
     M(MaxDDLEntryID, "Max processed DDL entry of DDLWorker.") \
     M(MaxPushedDDLEntryID, "Max DDL entry of DDLWorker that pushed to zookeeper.") \

From 69aec7af9bfa475bbc6581f4c582eff6db04d3de Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Thu, 25 May 2023 17:23:39 +0200
Subject: [PATCH 0323/1478] Add new metrics
 BrokenDistributedBytesToInsert/DistributedBytesToInsert

Useful to see at the server status overall.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Common/CurrentMetrics.cpp                            | 2 ++
 .../Distributed/DistributedAsyncInsertDirectoryQueue.cpp | 9 +++++++++
 .../Distributed/DistributedAsyncInsertDirectoryQueue.h   | 2 ++
 3 files changed, 13 insertions(+)

diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 63a23c30f84..edfbbe17600 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -145,6 +145,8 @@
     M(ParquetDecoderThreadsActive, "Number of threads in the ParquetBlockInputFormat thread pool.") \
     M(OutdatedPartsLoadingThreads, "Number of threads in the threadpool for loading Outdated data parts.") \
     M(OutdatedPartsLoadingThreadsActive, "Number of active threads in the threadpool for loading Outdated data parts.") \
+    M(DistributedBytesToInsert, "Number of pending bytes to process for asynchronous insertion into Distributed tables. Number of bytes for every shard is summed.") \
+    M(BrokenDistributedBytesToInsert, "Number of bytes for asynchronous insertion into Distributed tables that has been marked as broken. Number of bytes for every shard is summed.") \
     M(DistributedFilesToInsert, "Number of pending files to process for asynchronous insertion into Distributed tables. Number of files for every shard is summed.") \
     M(BrokenDistributedFilesToInsert, "Number of files for asynchronous insertion into Distributed tables that has been marked as broken. Number of files for every shard is summed.") \
     M(TablesToDropQueueSize, "Number of dropped tables, that are waiting for background data removal.") \
diff --git a/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.cpp b/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.cpp
index 9a9a6651bc4..d8d9a0c9d1e 100644
--- a/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.cpp
+++ b/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.cpp
@@ -35,6 +35,8 @@ namespace CurrentMetrics
     extern const Metric DistributedSend;
     extern const Metric DistributedFilesToInsert;
     extern const Metric BrokenDistributedFilesToInsert;
+    extern const Metric DistributedBytesToInsert;
+    extern const Metric BrokenDistributedBytesToInsert;
 }
 
 namespace fs = std::filesystem;
@@ -138,7 +140,9 @@ DistributedAsyncInsertDirectoryQueue::DistributedAsyncInsertDirectoryQueue(
     , max_sleep_time(storage.getDistributedSettingsRef().monitor_max_sleep_time_ms.totalMilliseconds())
     , log(&Poco::Logger::get(getLoggerName()))
     , monitor_blocker(monitor_blocker_)
+    , metric_pending_bytes(CurrentMetrics::DistributedBytesToInsert, 0)
     , metric_pending_files(CurrentMetrics::DistributedFilesToInsert, 0)
+    , metric_broken_bytes(CurrentMetrics::BrokenDistributedBytesToInsert, 0)
     , metric_broken_files(CurrentMetrics::BrokenDistributedFilesToInsert, 0)
 {
     fs::create_directory(broken_path);
@@ -357,6 +361,7 @@ void DistributedAsyncInsertDirectoryQueue::initializeFilesFromDisk()
         LOG_TRACE(log, "Files set to {}", pending_files.size());
         LOG_TRACE(log, "Bytes set to {}", bytes_count);
 
+        metric_pending_bytes.changeTo(bytes_count);
         metric_pending_files.changeTo(pending_files.size());
         status.files_count = pending_files.size();
         status.bytes_count = bytes_count;
@@ -380,6 +385,7 @@ void DistributedAsyncInsertDirectoryQueue::initializeFilesFromDisk()
         LOG_TRACE(log, "Broken bytes set to {}", broken_bytes_count);
 
         metric_broken_files.changeTo(broken_files);
+        metric_broken_bytes.changeTo(broken_bytes_count);
         status.broken_files_count = broken_files;
         status.broken_bytes_count = broken_bytes_count;
     }
@@ -520,6 +526,7 @@ bool DistributedAsyncInsertDirectoryQueue::addFileAndSchedule(const std::string
     {
         std::lock_guard lock(status_mutex);
         metric_pending_files.add();
+        metric_pending_bytes.add(file_size);
         status.bytes_count += file_size;
         ++status.files_count;
     }
@@ -679,6 +686,7 @@ void DistributedAsyncInsertDirectoryQueue::markAsBroken(const std::string & file
         status.broken_bytes_count += file_size;
 
         metric_broken_files.add();
+        metric_broken_bytes.add(file_size);
     }
 
     fs::rename(file_path, broken_file_path);
@@ -692,6 +700,7 @@ void DistributedAsyncInsertDirectoryQueue::markAsSend(const std::string & file_p
     {
         std::lock_guard status_lock(status_mutex);
         metric_pending_files.sub();
+        metric_pending_bytes.sub(file_size);
         --status.files_count;
         status.bytes_count -= file_size;
     }
diff --git a/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.h b/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.h
index de8bb813824..9a8a235e265 100644
--- a/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.h
+++ b/src/Storages/Distributed/DistributedAsyncInsertDirectoryQueue.h
@@ -149,7 +149,9 @@ private:
 
     BackgroundSchedulePoolTaskHolder task_handle;
 
+    CurrentMetrics::Increment metric_pending_bytes;
     CurrentMetrics::Increment metric_pending_files;
+    CurrentMetrics::Increment metric_broken_bytes;
     CurrentMetrics::Increment metric_broken_files;
 };
 

From a0df8566051a4c0c163dae14b5e41b7d83b7540c Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Sat, 3 Jun 2023 23:11:03 +0200
Subject: [PATCH 0324/1478] Able to insert

---
 .../AzureBlobStorage/AzureBlobStorageAuth.cpp | 17 +++++++++-----
 src/Storages/StorageAzure.cpp                 |  4 ++--
 src/Storages/StorageAzure.h                   | 22 +++++++++++++------
 3 files changed, 28 insertions(+), 15 deletions(-)

diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureBlobStorageAuth.cpp b/src/Disks/ObjectStorages/AzureBlobStorage/AzureBlobStorageAuth.cpp
index 1e06490b5bc..1b62b5fdb05 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureBlobStorageAuth.cpp
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureBlobStorageAuth.cpp
@@ -57,14 +57,22 @@ void validateContainerName(const String & container_name)
 
 AzureBlobStorageEndpoint processAzureBlobStorageEndpoint(const Poco::Util::AbstractConfiguration & config, const String & config_prefix)
 {
-    String storage_account_url = config.getString(config_prefix + ".storage_account_url");
-    validateStorageAccountUrl(storage_account_url);
+    std::string storage_url;
+    if (config.has(config_prefix + ".storage_account_url"))
+    {
+        storage_url = config.getString(config_prefix + ".storage_account_url");
+        validateStorageAccountUrl(storage_url);
+    }
+    else
+    {
+        storage_url = config.getString(config_prefix + ".connection_string");
+    }
     String container_name = config.getString(config_prefix + ".container_name", "default-container");
     validateContainerName(container_name);
     std::optional<bool> container_already_exists {};
     if (config.has(config_prefix + ".container_already_exists"))
         container_already_exists = {config.getBool(config_prefix + ".container_already_exists")};
-    return {storage_account_url, container_name, container_already_exists};
+    return {storage_url, container_name, container_already_exists};
 }
 
 
@@ -136,10 +144,7 @@ std::unique_ptr<BlobContainerClient> getAzureBlobContainerClient(
         /// If container_already_exists is not set (in config), ignore already exists error.
         /// (Conflict - The specified container already exists)
         if (!endpoint.container_already_exists.has_value() && e.StatusCode == Azure::Core::Http::HttpStatusCode::Conflict)
-        {
-            tryLogCurrentException("Container already exists, returning the existing container");
             return getAzureBlobStorageClientWithAuth<BlobContainerClient>(final_url, container_name, config, config_prefix);
-        }
         throw;
     }
 }
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 30fd3fcbe95..fd250a128c9 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -236,7 +236,7 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
 StorageAzure::StorageAzure(
     const Configuration & configuration_,
     std::unique_ptr<AzureObjectStorage> && object_storage_,
-    ContextPtr context_,
+    ContextPtr,
     const StorageID & table_id_,
     const ColumnsDescription & columns_,
     const ConstraintsDescription & constraints_,
@@ -252,7 +252,7 @@ StorageAzure::StorageAzure(
     , partition_by(partition_by_)
 {
     FormatFactory::instance().checkFormatName(configuration.format);
-    context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(configuration.getConnectionURL()));
+    //context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(configuration.getConnectionURL()));
 
     StorageInMemoryMetadata storage_metadata;
     if (columns_.empty())
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index b99df2e89a5..6bf18d91265 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -18,6 +18,11 @@ struct AzureSimpleAccountConfiguration
     std::string storage_account_url;
 };
 
+namespace ErrorCodes
+{
+    extern const int NOT_IMPLEMENTED;
+}
+
 using AzureConnectionString = std::string;
 
 using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConnectionString>;
@@ -85,13 +90,16 @@ public:
     }
 
     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;
+        const Names &,
+        const StorageSnapshotPtr &,
+        SelectQueryInfo &,
+        ContextPtr,
+        QueryProcessingStage::Enum,
+        size_t,
+        size_t) override
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Read not implemented");
+    }
 
     SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /* metadata_snapshot */, ContextPtr context) override;
 

From 6f01e2ad9fd25d3d09828d7fb8847d7e730ccb3f Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 4 Jun 2023 02:49:45 +0200
Subject: [PATCH 0325/1478] Fix incorrect constant folding

---
 src/Parsers/ExpressionElementParsers.cpp      |  6 ++-
 ..._formatting_and_constant_folding.reference |  4 ++
 ...istent_formatting_and_constant_folding.sql | 41 +++++++++++++++++++
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.reference
 create mode 100644 tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.sql

diff --git a/src/Parsers/ExpressionElementParsers.cpp b/src/Parsers/ExpressionElementParsers.cpp
index 28cef51e571..3a7e8790bb4 100644
--- a/src/Parsers/ExpressionElementParsers.cpp
+++ b/src/Parsers/ExpressionElementParsers.cpp
@@ -829,7 +829,11 @@ static bool parseNumber(char * buffer, size_t size, bool negative, int base, Fie
 
     if (pos_integer == buffer + size && errno != ERANGE && (!negative || uint_value <= (1ULL << 63)))
     {
-        if (negative)
+        /// -0 should be still parsed as UInt instead of Int,
+        /// because otherwise it is not preserved during formatting-parsing roundtrip
+        /// (the signedness is lost during formatting)
+
+        if (negative && uint_value != 0)
             res = static_cast<Int64>(-uint_value);
         else
             res = uint_value;
diff --git a/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.reference b/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.reference
new file mode 100644
index 00000000000..39d23aa2298
--- /dev/null
+++ b/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.reference
@@ -0,0 +1,4 @@
+0	UInt8	-1	Int8	-0	Float64
+0
+0
+0
diff --git a/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.sql b/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.sql
new file mode 100644
index 00000000000..31278862ab8
--- /dev/null
+++ b/tests/queries/0_stateless/02782_inconsistent_formatting_and_constant_folding.sql
@@ -0,0 +1,41 @@
+SELECT -0, toTypeName(-0), -1, toTypeName(-1), -0., toTypeName(-0.);
+
+DROP TABLE IF EXISTS t4;
+DROP TABLE IF EXISTS t7;
+
+create table t4 (c26 String) engine = Log;
+create view t7 as select max(ref_3.c26) as c_2_c46_1 from t4 as ref_3;
+
+select
+        c_7_c4585_14 as c_4_c4593_5
+      from
+        (select
+              avg(0) as c_7_c4572_1,
+              max(-0) as c_7_c4585_14
+            from
+              t7 as ref_0
+            group by ref_0.c_2_c46_1) as subq_0
+where c_4_c4593_5 <= multiIf(true, 1, exp10(c_4_c4593_5) <= 1, 1, 1);
+
+select x as c
+      from
+        (select 1 AS k,
+              max(0) as a,
+              max(-0) as x
+            from
+              t7 GROUP BY k)
+where NOT ignore(c);
+
+SELECT x
+FROM
+(
+    SELECT
+        avg(0) AS c_7_c4572_1,
+        max(-0) AS x
+    FROM t7 AS ref_0
+    GROUP BY ref_0.c_2_c46_1
+)
+WHERE x <= multiIf(true, 1, exp10(x) <= 1, 1, 1);
+
+DROP TABLE t7;
+DROP TABLE t4;

From c62558f982366ba2b2bc03cd410bf70840358fcc Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 4 Jun 2023 04:44:51 +0200
Subject: [PATCH 0326/1478] Control memory usage in generateRandom

---
 src/Storages/StorageGenerateRandom.cpp        | 85 ++++++++++++++++++-
 ...0416_pocopatch_progress_in_http_headers.sh |  1 -
 2 files changed, 83 insertions(+), 3 deletions(-)

diff --git a/src/Storages/StorageGenerateRandom.cpp b/src/Storages/StorageGenerateRandom.cpp
index e48d3187cb2..293beca9c24 100644
--- a/src/Storages/StorageGenerateRandom.cpp
+++ b/src/Storages/StorageGenerateRandom.cpp
@@ -29,6 +29,7 @@
 
 #include <Common/SipHash.h>
 #include <Common/randomSeed.h>
+#include <Interpreters/Context.h>
 #include <base/unaligned.h>
 
 #include <Functions/FunctionFactory.h>
@@ -81,6 +82,66 @@ void fillBufferWithRandomData(char * __restrict data, size_t limit, size_t size_
 }
 
 
+size_t estimateValueSize(
+    const DataTypePtr type,
+    UInt64 max_array_length,
+    UInt64 max_string_length)
+{
+    if (type->haveMaximumSizeOfValue())
+        return type->getMaximumSizeOfValueInMemory();
+
+    TypeIndex idx = type->getTypeId();
+
+    switch (idx)
+    {
+        case TypeIndex::String:
+        {
+            return max_string_length + sizeof(size_t) + 1;
+        }
+
+        /// The logic in this function should reflect the logic of fillColumnWithRandomData.
+        case TypeIndex::Array:
+        {
+            auto nested_type = typeid_cast<const DataTypeArray &>(*type).getNestedType();
+            return sizeof(size_t) + estimateValueSize(nested_type, max_array_length / 2, max_string_length);
+        }
+
+        case TypeIndex::Map:
+        {
+            const DataTypePtr & nested_type = typeid_cast<const DataTypeMap &>(*type).getNestedType();
+            return sizeof(size_t) + estimateValueSize(nested_type, max_array_length / 2, max_string_length);
+        }
+
+        case TypeIndex::Tuple:
+        {
+            auto elements = typeid_cast<const DataTypeTuple *>(type.get())->getElements();
+            const size_t tuple_size = elements.size();
+            size_t res = 0;
+
+            for (size_t i = 0; i < tuple_size; ++i)
+                res += estimateValueSize(elements[i], max_array_length, max_string_length);
+
+            return res;
+        }
+
+        case TypeIndex::Nullable:
+        {
+            auto nested_type = typeid_cast<const DataTypeNullable &>(*type).getNestedType();
+            return 1 + estimateValueSize(nested_type, max_array_length, max_string_length);
+        }
+
+        case TypeIndex::LowCardinality:
+        {
+            auto nested_type = typeid_cast<const DataTypeLowCardinality &>(*type).getDictionaryType();
+            return sizeof(size_t) + estimateValueSize(nested_type, max_array_length, max_string_length);
+        }
+
+        default:
+            throw Exception(ErrorCodes::NOT_IMPLEMENTED, "The 'GenerateRandom' is not implemented for type {}", type->getName());
+    }
+}
+
+
 ColumnPtr fillColumnWithRandomData(
     const DataTypePtr type,
     UInt64 limit,
@@ -192,7 +253,8 @@ ColumnPtr fillColumnWithRandomData(
                 offsets[i] = offset;
             }
 
-            auto data_column = fillColumnWithRandomData(nested_type, offset, max_array_length, max_string_length, rng, context);
+            /// This division by two makes the size growth subexponential on depth.
+            auto data_column = fillColumnWithRandomData(nested_type, offset, max_array_length / 2, max_string_length, rng, context);
 
             return ColumnArray::create(data_column, std::move(offsets_column));
         }
@@ -200,7 +262,7 @@ ColumnPtr fillColumnWithRandomData(
         case TypeIndex::Map:
         {
             const DataTypePtr & nested_type = typeid_cast<const DataTypeMap &>(*type).getNestedType();
-            auto nested_column = fillColumnWithRandomData(nested_type, limit, max_array_length, max_string_length, rng, context);
+            auto nested_column = fillColumnWithRandomData(nested_type, limit, max_array_length / 2, max_string_length, rng, context);
             return ColumnMap::create(nested_column);
         }
 
@@ -597,6 +659,25 @@ Pipe StorageGenerateRandom::read(
         block_header.insert({std::move(column), name_type.type, name_type.name});
     }
 
+    /// Correction of block size for wide tables.
+    size_t preferred_block_size_bytes = context->getSettingsRef().preferred_block_size_bytes;
+    if (preferred_block_size_bytes)
+    {
+        size_t estimated_row_size_bytes = estimateValueSize(std::make_shared<DataTypeTuple>(block_header.getDataTypes()), max_array_length, max_string_length);
+
+        size_t estimated_block_size_bytes = 0;
+        if (common::mulOverflow(max_block_size, estimated_row_size_bytes, estimated_block_size_bytes))
+            throw Exception(ErrorCodes::TOO_LARGE_ARRAY_SIZE, "Too large estimated block size in GenerateRandom table: its estimation leads to 64bit overflow");
+        chassert(estimated_block_size_bytes != 0);
+
+        if (estimated_block_size_bytes > preferred_block_size_bytes)
+        {
+            max_block_size = static_cast<size_t>(max_block_size * (static_cast<double>(preferred_block_size_bytes) / estimated_block_size_bytes));
+            if (max_block_size == 0)
+                max_block_size = 1;
+        }
+    }
+
     /// Will create more seed values for each source from initial seed.
     pcg64 generate(random_seed);
 
diff --git a/tests/queries/0_stateless/00416_pocopatch_progress_in_http_headers.sh b/tests/queries/0_stateless/00416_pocopatch_progress_in_http_headers.sh
index 6e9814cbca8..b2189ab0cc2 100755
--- a/tests/queries/0_stateless/00416_pocopatch_progress_in_http_headers.sh
+++ b/tests/queries/0_stateless/00416_pocopatch_progress_in_http_headers.sh
@@ -5,7 +5,6 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 . "$CURDIR"/../shell_config.sh
 
 ${CLICKHOUSE_CURL} -vsS "${CLICKHOUSE_URL}&max_block_size=5&send_progress_in_http_headers=1&http_headers_progress_interval_ms=0" -d 'SELECT max(number) FROM numbers(10)' 2>&1 | grep -E 'Content-Encoding|X-ClickHouse-Progress|^[0-9]'
-# This test will fail with external poco (progress not supported)
 
 ${CLICKHOUSE_CURL} -vsS "${CLICKHOUSE_URL}&max_block_size=1&send_progress_in_http_headers=1&http_headers_progress_interval_ms=0&output_format_parallel_formatting=0" -d 'SELECT number FROM numbers(10)' 2>&1 | grep -E 'Content-Encoding|X-ClickHouse-Progress|^[0-9]'
 ${CLICKHOUSE_CURL} -sS "${CLICKHOUSE_URL}&max_block_size=1&send_progress_in_http_headers=1&http_headers_progress_interval_ms=0&enable_http_compression=1" -H 'Accept-Encoding: gzip' -d 'SELECT number FROM system.numbers LIMIT 10' | gzip -d

From 7ceedbd1806348f3af80d135430db5ca245a341a Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 4 Jun 2023 04:45:55 +0200
Subject: [PATCH 0327/1478] Update tests

---
 tests/queries/0_stateless/02539_generate_random_map.reference | 4 ++--
 .../0_stateless/02586_generate_random_structure.reference     | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/02539_generate_random_map.reference b/tests/queries/0_stateless/02539_generate_random_map.reference
index c0dc175c3cd..25e7f55667e 100644
--- a/tests/queries/0_stateless/02539_generate_random_map.reference
+++ b/tests/queries/0_stateless/02539_generate_random_map.reference
@@ -1,2 +1,2 @@
-1
-20
+0
+10
diff --git a/tests/queries/0_stateless/02586_generate_random_structure.reference b/tests/queries/0_stateless/02586_generate_random_structure.reference
index d2929fb4564..abe168c59e8 100644
--- a/tests/queries/0_stateless/02586_generate_random_structure.reference
+++ b/tests/queries/0_stateless/02586_generate_random_structure.reference
@@ -13,7 +13,7 @@ c3.e6	Array(Int256)
 c4	FixedString(183)					
 c5	IPv4					
 c6	UInt256					
-Tb�#yV��[>�M��*ܨ��(�O
�R8V1n���)���H�}C�������\'����I7�t���qn�V)䳆��qL��P�o�R�g<�{���3�i����H_m��!q���\'G���	127.48.9.45	['e1V10','e1V0','e1V10','e1V14','e1V10','e1V14']	[{-13:777622572,102:-1122882357,62:1647813163,-94:2094022166},{-32:1448633509},{},{},{34:1536340393,19:-2049677851,74:65643868,-46:-1990799930,97:-531041081,46:-2634833,14:1581632600,89:-771229823,-105:1238603584},{47:1458809010,109:1640682510,86:1945730198,85:1505847247,35:-35189402}]	[153363749503.3642648494826450951141750747382772821825909005880434540971999557,79828591186.7378041015337066268618633118713347614941338787453473118807106292,81672688565.9633830721322966111551266731935181670389237071708068971548883315,573768486971.1812413548839655834002608768736215115033958693122764224003897029,-393925092368.4893467278351090742501814120269109477445490969167853713051140487,46027399426.0865278566391382610843315130162915324295037009704113636499519839]	[755855942,1804001770,-78103159,-866181765,731736602,-79599206]	[5253556148991564114,4681434929596395351,-7302160004580855709,-3686747220178471318,6288582051009949273,646864891160092871]	[17035203905051045016266537043565487029724162173062647021612805252288722534904,-42105881403933504641593145676742477006499618886131028341247993701618141933523,45346626822580305846120377917274679004279343244238782744860626882886217433843,-3660165069803677989574889324494857545543653453780976182221584349306428201647,-23316760935816288837287058499520670431785615691220162210524162590241529297823,6184785563808848524970564618169964412151721224362412457508264894603779018817]	�ڡ|�A"�x���>����r�wz�
Z�:��j�8tZ��D"Tu��2h�!���W�I��y��tP��a|�\'�y��o�����
f�F�O\0��Ֆ6\fIr�E�Sac�W<~�e
 �l��T>P3})��w%
�4@_2�N"ІXp$^Ҙ���Ͱ\04�@��n\b���\r�4�H�	16.177.117.209	7882774382721411359365561736453116698030365959050344381263687375357052837130
-Tb�#yV��[>�M��*ܨ��(�O
�R8V1n���)���H�}C�������\'����I7�t���qn�V)䳆��qL��P�o�R�g<�{���3�i����H_m��!q���\'G���	127.48.9.45	['e1V10','e1V0','e1V10','e1V14','e1V10','e1V14']	[{-13:777622572,102:-1122882357,62:1647813163,-94:2094022166},{-32:1448633509},{},{},{34:1536340393,19:-2049677851,74:65643868,-46:-1990799930,97:-531041081,46:-2634833,14:1581632600,89:-771229823,-105:1238603584},{47:1458809010,109:1640682510,86:1945730198,85:1505847247,35:-35189402}]	[153363749503.3642648494826450951141750747382772821825909005880434540971999557,79828591186.7378041015337066268618633118713347614941338787453473118807106292,81672688565.9633830721322966111551266731935181670389237071708068971548883315,573768486971.1812413548839655834002608768736215115033958693122764224003897029,-393925092368.4893467278351090742501814120269109477445490969167853713051140487,46027399426.0865278566391382610843315130162915324295037009704113636499519839]	[755855942,1804001770,-78103159,-866181765,731736602,-79599206]	[5253556148991564114,4681434929596395351,-7302160004580855709,-3686747220178471318,6288582051009949273,646864891160092871]	[17035203905051045016266537043565487029724162173062647021612805252288722534904,-42105881403933504641593145676742477006499618886131028341247993701618141933523,45346626822580305846120377917274679004279343244238782744860626882886217433843,-3660165069803677989574889324494857545543653453780976182221584349306428201647,-23316760935816288837287058499520670431785615691220162210524162590241529297823,6184785563808848524970564618169964412151721224362412457508264894603779018817]	�ڡ|�A"�x���>����r�wz�
Z�:��j�8tZ��D"Tu��2h�!���W�I��y��tP��a|�\'�y��o�����
f�F�O\0��Ֆ6\fIr�E�Sac�W<~�e
 �l��T>P3})��w%
�4@_2�N"ІXp$^Ҙ���Ͱ\04�@��n\b���\r�4�H�	16.177.117.209	7882774382721411359365561736453116698030365959050344381263687375357052837130
+Tb�#yV��[>�M��*ܨ��(�O
�R8V1n���)���H�}C�������\'����I7�t���qn�V)䳆��qL��P�o�R�g<�{���3�i����H_m��!q���\'G���	127.48.9.45	['e1V10','e1V0','e1V10','e1V14','e1V10','e1V14']	[{-13:237920722},{102:1831835481},{},{},{62:-1960618666,-94:-1219892650},{-32:777622572}]	[-431683920736.2529974565693898437068698973660186760023819586689844248966618581,59756148020.9162673945900094878560562068677573399624031604279613893604002735,586508082308.9120376291637372686770291666437007489038136467093669000000245094,-542964250950.8072472621084212227729061994250148872708538789242780170470779236,102348230986.0528243362965635624540408239649901816289081513971979913007157412,856260707339.0308016734722383288485766011293159337170215574648625303012038641]	[700742145,583743175,-694731143,205377506,-47073316,524775483]	[-1523104801326101990,-3813742700509249040,-198797568561120929,1360848130483946585,-2034445041726915230,6445693522245970031]	[-42294009754395695750286152418877456026522055877244789929409825751148328749462,-30114637036117781224059264373564439361653611308928312514969460679379590706382,50790691897328530213645537587874962516097580703236937570724165115560305762147,-53982023979693597997184389721196431225054557132927198244547868871851761566844,-4746897427675718862552189488292169089453556841811840545196357111533622948298,-12014200750706123405006110782843469166121588186681927916239818910819762049960]	�ڡ|�A"�x���>����r�wz�
Z�:��j�8tZ��D"Tu��2h�!���W�I��y��tP��a|�\'�y��o�����
f�F�O\0��Ֆ6\fIr�E�Sac�W<~�e
 �l��T>P3})��w%
�4@_2�N"ІXp$^Ҙ���Ͱ\04�@��n\b���\r�4�H�	16.177.117.209	7882774382721411359365561736453116698030365959050344381263687375357052837130
+Tb�#yV��[>�M��*ܨ��(�O
�R8V1n���)���H�}C�������\'����I7�t���qn�V)䳆��qL��P�o�R�g<�{���3�i����H_m��!q���\'G���	127.48.9.45	['e1V10','e1V0','e1V10','e1V14','e1V10','e1V14']	[{-13:237920722},{102:1831835481},{},{},{62:-1960618666,-94:-1219892650},{-32:777622572}]	[-431683920736.2529974565693898437068698973660186760023819586689844248966618581,59756148020.9162673945900094878560562068677573399624031604279613893604002735,586508082308.9120376291637372686770291666437007489038136467093669000000245094,-542964250950.8072472621084212227729061994250148872708538789242780170470779236,102348230986.0528243362965635624540408239649901816289081513971979913007157412,856260707339.0308016734722383288485766011293159337170215574648625303012038641]	[700742145,583743175,-694731143,205377506,-47073316,524775483]	[-1523104801326101990,-3813742700509249040,-198797568561120929,1360848130483946585,-2034445041726915230,6445693522245970031]	[-42294009754395695750286152418877456026522055877244789929409825751148328749462,-30114637036117781224059264373564439361653611308928312514969460679379590706382,50790691897328530213645537587874962516097580703236937570724165115560305762147,-53982023979693597997184389721196431225054557132927198244547868871851761566844,-4746897427675718862552189488292169089453556841811840545196357111533622948298,-12014200750706123405006110782843469166121588186681927916239818910819762049960]	�ڡ|�A"�x���>����r�wz�
Z�:��j�8tZ��D"Tu��2h�!���W�I��y��tP��a|�\'�y��o�����
f�F�O\0��Ֆ6\fIr�E�Sac�W<~�e
 �l��T>P3})��w%
�4@_2�N"ІXp$^Ҙ���Ͱ\04�@��n\b���\r�4�H�	16.177.117.209	7882774382721411359365561736453116698030365959050344381263687375357052837130
 Tb�#yV��[>�M��*ܨ��(�O
�R8V1n���)���H�}C�������\'����I7�t���qn�V)䳆��qL��P�o�R�g<�{���3�i����H_m��!q���\'G���	127.48.9.45	['e1V10']	[{}]	[825002272867.1157788721157301271303736024856710948164507982705676578804195475]	[1865150610]	[7514464811443271056]	[33504961604882608369857530219353040639899064613284394558131808339620328539033]	�ڡ|�A"�x���>����r�wz�
Z�:��j�8tZ��D"Tu��2h�!���W�I��y��tP��a|�\'�y��o�����
f�F�O\0��Ֆ6\fIr�E�Sac�W<~�e
 �l��T>P3})��w%
�4@_2�N"ІXp$^Ҙ���Ͱ\04�@��n\b���\r�4�H�	16.177.117.209	7882774382721411359365561736453116698030365959050344381263687375357052837130
 c1 LowCardinality(Nullable(UInt64)), c2 Date32, c3 LowCardinality(Nullable(Float64)), c4 Int256, c5 Date32

From 60c2245da4c1cb23a7e62088b6c409afe941bd56 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Sun, 4 Jun 2023 10:58:05 +0200
Subject: [PATCH 0328/1478] Make 01565_query_loop_after_client_error slightly
 more robust
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CI founds one failure of this test [1], which is quite interesting, the
test itself should not takes too long:

    2023.06.04 05:01:36.889144 [ 42287 ] {} <Trace> DynamicQueryHandler: Request URI: /?query=SELECT+%27Running+test+stateless%2F01565_query_loop_after_client_error.expect+from+pid%3D1053%27&database=system&connect_timeout=30&receive_timeout=30&send_timeout=30&http_connection_timeout=30&http_receive_timeout=30&http_send_timeout=30&output_format_parallel_formatting=0
    ...
    2023.06.04 05:01:37.364595 [ 42844 ] {fa79939f-1fa0-4f3b-b599-fd2269122d6a} <Debug> executeQuery: (from [::1]:40264) (comment: 01565_query_loop_after_client_error.expect) INSERT INTO t01565(c0, c1) VALUES  (stage: Complete)
    2023.06.04 05:01:37.366485 [ 42844 ] {fa79939f-1fa0-4f3b-b599-fd2269122d6a} <Information> TCPHandler: Change cancellation status from NOT_CANCELLED to FULLY_CANCELLED. Log message: Received 'Cancel' packet from the client, canceling the query.
    2023.06.04 05:01:37.366810 [ 42844 ] {fa79939f-1fa0-4f3b-b599-fd2269122d6a} <Debug> TCPHandler: Processed in 0.002539914 sec.

But for the last INSERT the client itself works **very slow**, which
seems was the reason why "\r" had been sent too early and was never
interpreted:

    send: sending "INSERT INTO t01565(c0, c1) VALUES ('1', 1) ;\n" to { exp4 }

    expect: does " " (spawn_id exp4) match glob pattern "INSERT"? no
    I
    expect: does " \u001b[21GI\u001b[0m\u001b[J\u001b[22G" (spawn_id exp4) match glob pattern "INSERT"? no
    
    expect: does " \u001b[21GI\u001b[0m\u001b[J\u001b[22G\u001b[21G" (spawn_id exp4) match glob pattern "INSERT"? no
    INSERT INTO t
    expect: does " \u001b[21GI\u001b[0m\u001b[J\u001b[22G\u001b[21GINSERT INTO t\u001b[0m" (spawn_id exp4) match glob pattern "INSERT"? yes
    expect: set expect_out(0,string) "INSERT"
    expect: set expect_out(spawn_id) "exp4"
    expect: set expect_out(buffer) " \u001b[21GI\u001b[0m\u001b[J\u001b[22G\u001b[21GINSERT"
    send: sending "\r" to { exp4 }

    expect: does " INTO t\u001b[0m" (spawn_id exp4) match glob pattern "Ok."? no
    
    expect: does " INTO t\u001b[0m\u001b[J" (spawn_id exp4) match glob pattern "Ok."? no
    
    expect: does " INTO t\u001b[0m\u001b[J\u001b[34G" (spawn_id exp4) match glob pattern "Ok."? no
    
    expect: does " INTO t\u001b[0m\u001b[J\u001b[34G\u001b[21G" (spawn_id exp4) match glob pattern "Ok."? no
    INSERT INTO t01565(c0, c1) VALUES ('1', 1) ;

    
    expect: does " INTO t\u001b[0m\u001b[J\u001b[34G\u001b[21G\u001b[JINSERT INTO t01565\u001b[0;22;33m(\u001b[0mc0\u001b[0;1m,\u001b[0m c1\u001b[0;22;33m)\u001b[0m VALUES \u001b[0;22;33m(\u001b[0;22;36m'1'\u001b[0;1m,\u001b[0m \u001b[0;22;32m1\u001b[0;22;33m)\u001b[0m \u001b[0;1m;\u001b[0m\r\n\r\n\u001b[0m\u001b[1G" (spawn_id exp4) match glob pattern "Ok."? no
    expect: timed out

Here you can see that it matched "INSERT" and then expect receive data
from the client almost byte by byte.

So I hope that expecting the last part of the query should fix the
problem.

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/50429/228ebab86db95dca1e29967061d245985bc86a0f/stateless_tests__release__s3_storage__[2_2].html
Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../01565_query_loop_after_client_error.expect            | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/01565_query_loop_after_client_error.expect b/tests/queries/0_stateless/01565_query_loop_after_client_error.expect
index 0faf8f0192b..e718fd99b7f 100755
--- a/tests/queries/0_stateless/01565_query_loop_after_client_error.expect
+++ b/tests/queries/0_stateless/01565_query_loop_after_client_error.expect
@@ -24,24 +24,24 @@ expect "\n:) "
 
 send -- "DROP TABLE IF EXISTS t01565;\n"
 # NOTE: this is important for -mn mode, you should send "\r" only after reading echoed command
-expect "DROP"
+expect "\r\n"
 send -- "\r"
 expect "\nOk."
 expect "\n:)"
 
 send -- "CREATE TABLE t01565 (c0 String, c1 Int32) ENGINE = Memory() ;\n"
-expect "CREATE"
+expect "\r\n"
 send -- "\r"
 expect "\nOk."
 expect "\n:) "
 
 send -- "INSERT INTO t01565(c0, c1) VALUES (\"1\",1) ;\n"
-expect "INSERT"
+expect "\r\n"
 send -- "\r"
 expect "\n:) "
 
 send -- "INSERT INTO t01565(c0, c1) VALUES ('1', 1) ;\n"
-expect "INSERT"
+expect "\r\n"
 send -- "\r"
 expect "\nOk."
 expect "\n:) "

From db806bd394c7b7dfe42f225f3c1ad7b1be1f2ea9 Mon Sep 17 00:00:00 2001
From: auxten <auxten@users.noreply.github.com>
Date: Sun, 4 Jun 2023 17:44:29 +0800
Subject: [PATCH 0329/1478] Resize underlying vector only pos_offset ==
 vector.size()

---
 src/IO/WriteBufferFromVector.h | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/IO/WriteBufferFromVector.h b/src/IO/WriteBufferFromVector.h
index 4b2a3581625..c793a34b406 100644
--- a/src/IO/WriteBufferFromVector.h
+++ b/src/IO/WriteBufferFromVector.h
@@ -86,7 +86,10 @@ private:
         size_t old_size = vector.size();
         /// pos may not be equal to vector.data() + old_size, because WriteBuffer::next() can be used to flush data
         size_t pos_offset = pos - reinterpret_cast<Position>(vector.data());
-        vector.resize(old_size * size_multiplier);
+        if (pos_offset == vector.size())
+        {
+            vector.resize(old_size * size_multiplier);
+        }
         internal_buffer = Buffer(reinterpret_cast<Position>(vector.data() + pos_offset), reinterpret_cast<Position>(vector.data() + vector.size()));
         working_buffer = internal_buffer;
     }

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 0330/1478] 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 0331/1478] 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 24e015b961189e1b2202cfdf5fefe6c9e5904e71 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Sun, 4 Jun 2023 13:34:20 +0200
Subject: [PATCH 0332/1478] Fix

---
 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 8a24a4fe5ee..7afd17d32d1 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -650,7 +650,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
             }
 
             ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedFileSegments);
-            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->range().size());
+            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->getDownloadedSize(false));
 
             locked_key.removeFileSegment(segment->offset(), segment->lock());
             return PriorityIterationResult::REMOVE_AND_CONTINUE;

From 46cbdeeb7e7975b25de35fb75912da3a7ece21ec Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sun, 4 Jun 2023 15:02:46 +0300
Subject: [PATCH 0333/1478] Fixed tests

---
 src/Functions/if.cpp                                        | 6 ++----
 ...olding.reference => 02771_if_constant_folding.reference} | 0
 ...f_constant_folding.sql => 02771_if_constant_folding.sql} | 0
 3 files changed, 2 insertions(+), 4 deletions(-)
 rename tests/queries/0_stateless/{25337_if_constant_folding.reference => 02771_if_constant_folding.reference} (100%)
 rename tests/queries/0_stateless/{25337_if_constant_folding.sql => 02771_if_constant_folding.sql} (100%)

diff --git a/src/Functions/if.cpp b/src/Functions/if.cpp
index d00e83c4eb7..8d43b3a4ca3 100644
--- a/src/Functions/if.cpp
+++ b/src/Functions/if.cpp
@@ -1120,9 +1120,8 @@ public:
     ColumnPtr getConstantResultForNonConstArguments(const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type) const override
     {
         const ColumnWithTypeAndName & arg_cond = arguments[0];
-        if (!arg_cond.column || !isColumnConst(*arg_cond.column)) {
+        if (!arg_cond.column || !isColumnConst(*arg_cond.column))
             return {};
-        }
 
         const ColumnConst * cond_const_col = checkAndGetColumnConst<ColumnVector<UInt8>>(arg_cond.column.get());
         bool condition_value = cond_const_col->getValue<UInt8>();
@@ -1135,9 +1134,8 @@ public:
             return {};
 
         auto result = castColumn(potential_const_column, result_type);
-        if (!isColumnConst(*result)) {
+        if (!isColumnConst(*result))
             return {};
-        }
 
         return result;
     }
diff --git a/tests/queries/0_stateless/25337_if_constant_folding.reference b/tests/queries/0_stateless/02771_if_constant_folding.reference
similarity index 100%
rename from tests/queries/0_stateless/25337_if_constant_folding.reference
rename to tests/queries/0_stateless/02771_if_constant_folding.reference
diff --git a/tests/queries/0_stateless/25337_if_constant_folding.sql b/tests/queries/0_stateless/02771_if_constant_folding.sql
similarity index 100%
rename from tests/queries/0_stateless/25337_if_constant_folding.sql
rename to tests/queries/0_stateless/02771_if_constant_folding.sql

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 0334/1478] 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 63eab2783e4e0c23fdbe3e5e233b4e3c0773f40a Mon Sep 17 00:00:00 2001
From: Sergey Kazmin <43613813+yerseg@users.noreply.github.com>
Date: Fri, 2 Jun 2023 17:06:19 +0000
Subject: [PATCH 0335/1478] Make typeid_cast for pointers noexcept

---
 src/Common/typeid_cast.h | 38 ++++++++++++--------------------------
 1 file changed, 12 insertions(+), 26 deletions(-)

diff --git a/src/Common/typeid_cast.h b/src/Common/typeid_cast.h
index baee3aaf632..e134aac09e4 100644
--- a/src/Common/typeid_cast.h
+++ b/src/Common/typeid_cast.h
@@ -25,14 +25,14 @@ namespace DB
   */
 template <typename To, typename From>
 requires std::is_reference_v<To>
-To typeid_cast(From & from)
+To typeid_cast(From & from) noexcept(false)
 {
     try
     {
         if ((typeid(From) == typeid(To)) || (typeid(from) == typeid(To)))
             return static_cast<To>(from);
     }
-    catch (const std::exception & e)
+    catch (const std::bad_typeid & e)
     {
         throw DB::Exception::createDeprecated(e.what(), DB::ErrorCodes::LOGICAL_ERROR);
     }
@@ -44,19 +44,12 @@ To typeid_cast(From & from)
 
 template <typename To, typename From>
 requires std::is_pointer_v<To>
-To typeid_cast(From * from)
+To typeid_cast(From * from) noexcept
 {
-    try
-    {
-        if ((typeid(From) == typeid(std::remove_pointer_t<To>)) || (from && typeid(*from) == typeid(std::remove_pointer_t<To>)))
-            return static_cast<To>(from);
-        else
-            return nullptr;
-    }
-    catch (const std::exception & e)
-    {
-        throw DB::Exception::createDeprecated(e.what(), DB::ErrorCodes::LOGICAL_ERROR);
-    }
+    if ((typeid(From) == typeid(std::remove_pointer_t<To>)) || (from && typeid(*from) == typeid(std::remove_pointer_t<To>)))
+        return static_cast<To>(from);
+    else
+        return nullptr;
 }
 
 namespace detail
@@ -79,17 +72,10 @@ inline constexpr bool is_shared_ptr_v = is_shared_ptr<T>::value;
 
 template <typename To, typename From>
 requires detail::is_shared_ptr_v<To>
-To typeid_cast(const std::shared_ptr<From> & from)
+To typeid_cast(const std::shared_ptr<From> & from) noexcept
 {
-    try
-    {
-        if ((typeid(From) == typeid(typename To::element_type)) || (from && typeid(*from) == typeid(typename To::element_type)))
-            return std::static_pointer_cast<typename To::element_type>(from);
-        else
-            return nullptr;
-    }
-    catch (const std::exception & e)
-    {
-        throw DB::Exception::createDeprecated(e.what(), DB::ErrorCodes::LOGICAL_ERROR);
-    }
+    if ((typeid(From) == typeid(typename To::element_type)) || (from && typeid(*from) == typeid(typename To::element_type)))
+        return std::static_pointer_cast<typename To::element_type>(from);
+    else
+        return nullptr;
 }

From a3a12834671c95914103e59c24cf68fadc40f68f Mon Sep 17 00:00:00 2001
From: Sergey Kazmin <43613813+yerseg@users.noreply.github.com>
Date: Sat, 3 Jun 2023 19:36:11 +0300
Subject: [PATCH 0336/1478] remove try-catch from the impl of typeid_cast for
 refs

---
 src/Common/typeid_cast.h | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/src/Common/typeid_cast.h b/src/Common/typeid_cast.h
index e134aac09e4..f1ded97a9f1 100644
--- a/src/Common/typeid_cast.h
+++ b/src/Common/typeid_cast.h
@@ -27,15 +27,8 @@ template <typename To, typename From>
 requires std::is_reference_v<To>
 To typeid_cast(From & from) noexcept(false)
 {
-    try
-    {
-        if ((typeid(From) == typeid(To)) || (typeid(from) == typeid(To)))
-            return static_cast<To>(from);
-    }
-    catch (const std::bad_typeid & e)
-    {
-        throw DB::Exception::createDeprecated(e.what(), DB::ErrorCodes::LOGICAL_ERROR);
-    }
+    if ((typeid(From) == typeid(To)) || (typeid(from) == typeid(To)))
+        return static_cast<To>(from);
 
     throw DB::Exception(DB::ErrorCodes::LOGICAL_ERROR, "Bad cast from type {} to {}",
                         demangle(typeid(from).name()), demangle(typeid(To).name()));

From 0f4dd26cebbcf9201124287e8d31acda92a9e9f7 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Sun, 4 Jun 2023 16:03:44 +0200
Subject: [PATCH 0337/1478] Add async iteration to object storage

---
 src/Common/CurrentMetrics.cpp                 |  4 +
 .../AzureBlobStorage/AzureObjectStorage.cpp   | 69 ++++++++++++++++++
 .../AzureBlobStorage/AzureObjectStorage.h     |  2 +
 src/Disks/ObjectStorages/IObjectStorage.cpp   |  9 +++
 src/Disks/ObjectStorages/IObjectStorage.h     |  7 ++
 .../ObjectStorages/ObjectStorageIterator.cpp  | 20 +++++
 .../ObjectStorages/ObjectStorageIterator.h    | 53 ++++++++++++++
 .../ObjectStorageIteratorAsync.cpp            | 64 ++++++++++++++++
 .../ObjectStorageIteratorAsync.h              | 58 +++++++++++++++
 .../ObjectStorages/S3/S3ObjectStorage.cpp     | 73 +++++++++++++++++++
 src/Disks/ObjectStorages/S3/S3ObjectStorage.h |  2 +
 11 files changed, 361 insertions(+)
 create mode 100644 src/Disks/ObjectStorages/ObjectStorageIterator.cpp
 create mode 100644 src/Disks/ObjectStorages/ObjectStorageIterator.h
 create mode 100644 src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
 create mode 100644 src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h

diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 82d68ca8185..4c858ee788d 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -131,6 +131,10 @@
     M(DistributedInsertThreadsActive, "Number of threads used for INSERT into Distributed running a task.") \
     M(StorageS3Threads, "Number of threads in the StorageS3 thread pool.") \
     M(StorageS3ThreadsActive, "Number of threads in the StorageS3 thread pool running a task.") \
+    M(ObjectStorageS3Threads, "Number of threads in the S3ObjectStorage thread pool.") \
+    M(ObjectStorageS3ThreadsActive, "Number of threads in the S3ObjectStorage thread pool running a task.") \
+    M(ObjectStorageAzureThreads, "Number of threads in the AzureObjectStorage thread pool.") \
+    M(ObjectStorageAzureThreadsActive, "Number of threads in the AzureObjectStorage thread pool running a task.") \
     M(MergeTreePartsLoaderThreads, "Number of threads in the MergeTree parts loader thread pool.") \
     M(MergeTreePartsLoaderThreadsActive, "Number of threads in the MergeTree parts loader thread pool running a task.") \
     M(MergeTreePartsCleanerThreads, "Number of threads in the MergeTree parts cleaner thread pool.") \
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
index 0358b4e915a..23a0da39dd3 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
@@ -11,9 +11,16 @@
 #include <Disks/IO/AsynchronousBoundedReadBuffer.h>
 
 #include <Disks/ObjectStorages/AzureBlobStorage/AzureBlobStorageAuth.h>
+#include <Disks/ObjectStorages/ObjectStorageIteratorAsync.h>
 #include <Interpreters/Context.h>
 #include <Common/logger_useful.h>
 
+namespace CurrentMetrics
+{
+    extern const Metric ObjectStorageAzureThreads;
+    extern const Metric ObjectStorageAzureThreadsActive;
+
+}
 
 namespace DB
 {
@@ -26,6 +33,60 @@ namespace ErrorCodes
 }
 
 
+namespace
+{
+
+class AzureIteratorAsync final : public IObjectStorageIteratorAsync
+{
+public:
+    AzureIteratorAsync(
+        const std::string & path_prefix,
+        std::shared_ptr<const Azure::Storage::Blobs::BlobContainerClient> client_,
+        size_t max_list_size)
+        : IObjectStorageIteratorAsync(
+            CurrentMetrics::ObjectStorageAzureThreads,
+            CurrentMetrics::ObjectStorageAzureThreadsActive,
+            "ListObjectAzure")
+        , client(client_)
+    {
+
+        options.Prefix = path_prefix;
+        options.PageSizeHint = static_cast<int>(max_list_size);
+    }
+
+private:
+    bool getBatchAndCheckNext(RelativePathsWithMetadata & batch) override
+    {
+        auto outcome = client->ListBlobs(options);
+        auto blob_list_response = client->ListBlobs(options);
+        auto blobs_list = blob_list_response.Blobs;
+
+        for (const auto & blob : blobs_list)
+        {
+            batch.emplace_back(
+                blob.Name,
+                ObjectMetadata{
+                    static_cast<uint64_t>(blob.BlobSize),
+                    Poco::Timestamp::fromEpochTime(
+                        std::chrono::duration_cast<std::chrono::seconds>(
+                            blob.Details.LastModified.time_since_epoch()).count()),
+                    {}});
+        }
+
+        options.ContinuationToken = blob_list_response.NextPageToken;
+        if (blob_list_response.HasPage())
+            return true;
+
+        return false;
+    }
+
+    std::shared_ptr<const Azure::Storage::Blobs::BlobContainerClient> client;
+    Azure::Storage::Blobs::ListBlobsOptions options;
+};
+
+}
+
+
 AzureObjectStorage::AzureObjectStorage(
     const String & name_,
     AzureClientPtr && client_,
@@ -67,6 +128,14 @@ bool AzureObjectStorage::exists(const StoredObject & object) const
     return false;
 }
 
+ObjectStorageIteratorPtr AzureObjectStorage::iterate(const std::string & path_prefix) const
+{
+    auto settings_ptr = settings.get();
+    auto client_ptr = client.get();
+
+    return std::make_shared<AzureIteratorAsync>(path_prefix, client_ptr, settings_ptr->list_object_keys_size);
+}
+
 void AzureObjectStorage::listObjects(const std::string & path, RelativePathsWithMetadata & children, int max_keys) const
 {
     auto client_ptr = client.get();
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index a36a03bcda4..5b08ceb80e3 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -60,6 +60,8 @@ public:
 
     void listObjects(const std::string & path, RelativePathsWithMetadata & children, int max_keys) const override;
 
+    ObjectStorageIteratorPtr iterate(const std::string & path_prefix) const override;
+
     DataSourceDescription getDataSourceDescription() const override { return data_source_description; }
 
     std::string getName() const override { return "AzureObjectStorage"; }
diff --git a/src/Disks/ObjectStorages/IObjectStorage.cpp b/src/Disks/ObjectStorages/IObjectStorage.cpp
index a5903f9d429..ea22294224c 100644
--- a/src/Disks/ObjectStorages/IObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/IObjectStorage.cpp
@@ -5,6 +5,7 @@
 #include <IO/copyData.h>
 #include <IO/ReadBufferFromFileBase.h>
 #include <Interpreters/Context.h>
+#include <Disks/ObjectStorages/ObjectStorageIterator.h>
 
 
 namespace DB
@@ -29,6 +30,14 @@ void IObjectStorage::listObjects(const std::string &, RelativePathsWithMetadata
 }
 
 
+ObjectStorageIteratorPtr IObjectStorage::iterate(const std::string & path_prefix) const
+{
+    RelativePathsWithMetadata files;
+    listObjects(path_prefix, files, 0);
+
+    return std::make_shared<ObjectStorageIteratorFromList>(std::move(files));
+}
+
 std::optional<ObjectMetadata> IObjectStorage::tryGetObjectMetadata(const std::string & path) const
 {
     try
diff --git a/src/Disks/ObjectStorages/IObjectStorage.h b/src/Disks/ObjectStorages/IObjectStorage.h
index 28de80a88cd..32f9d1ba764 100644
--- a/src/Disks/ObjectStorages/IObjectStorage.h
+++ b/src/Disks/ObjectStorages/IObjectStorage.h
@@ -20,6 +20,9 @@
 #include <Disks/WriteMode.h>
 #include <Interpreters/Context_fwd.h>
 #include <Core/Types.h>
+#include <Disks/DirectoryIterator.h>
+#include <Common/ThreadPool.h>
+#include <Interpreters/threadPoolCallbackRunner.h>
 
 
 namespace DB
@@ -51,6 +54,8 @@ struct RelativePathWithMetadata
 
 using RelativePathsWithMetadata = std::vector<RelativePathWithMetadata>;
 
+class IObjectStorageIterator;
+using ObjectStorageIteratorPtr = std::shared_ptr<IObjectStorageIterator>;
 
 /// Base class for all object storages which implement some subset of ordinary filesystem operations.
 ///
@@ -75,6 +80,8 @@ public:
 
     virtual void listObjects(const std::string & path, RelativePathsWithMetadata & children, int max_keys) const;
 
+    virtual ObjectStorageIteratorPtr iterate(const std::string & path_prefix) const;
+
     /// Get object metadata if supported. It should be possible to receive
     /// at least size of object
     virtual std::optional<ObjectMetadata> tryGetObjectMetadata(const std::string & path) const;
diff --git a/src/Disks/ObjectStorages/ObjectStorageIterator.cpp b/src/Disks/ObjectStorages/ObjectStorageIterator.cpp
new file mode 100644
index 00000000000..188b743958c
--- /dev/null
+++ b/src/Disks/ObjectStorages/ObjectStorageIterator.cpp
@@ -0,0 +1,20 @@
+#include <Disks/ObjectStorages/ObjectStorageIterator.h>
+#include <Common/Exception.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
+RelativePathWithMetadata ObjectStorageIteratorFromList::current() const
+{
+    if (!isValid())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
+
+    return *batch_iterator;
+}
+
+}
diff --git a/src/Disks/ObjectStorages/ObjectStorageIterator.h b/src/Disks/ObjectStorages/ObjectStorageIterator.h
new file mode 100644
index 00000000000..c3afd395a74
--- /dev/null
+++ b/src/Disks/ObjectStorages/ObjectStorageIterator.h
@@ -0,0 +1,53 @@
+#pragma once
+
+#include <Disks/ObjectStorages/IObjectStorage.h>
+#include <memory>
+
+namespace DB
+{
+
+class IObjectStorageIterator
+{
+public:
+    virtual void next() = 0;
+    virtual bool isValid() const = 0;
+    virtual RelativePathWithMetadata current() const = 0;
+    virtual size_t getAccumulatedSize() const = 0;
+
+    virtual ~IObjectStorageIterator() = default;
+};
+
+using ObjectStorageIteratorPtr = std::shared_ptr<IObjectStorageIterator>;
+
+class ObjectStorageIteratorFromList : public IObjectStorageIterator
+{
+public:
+    explicit ObjectStorageIteratorFromList(RelativePathsWithMetadata && batch_)
+        : batch(std::move(batch_))
+        , batch_iterator(batch.begin())
+    {
+    }
+
+    void next() override
+    {
+        if (isValid())
+            ++batch_iterator;
+    }
+
+    bool isValid() const override
+    {
+        return batch_iterator != batch.end();
+    }
+
+    RelativePathWithMetadata current() const override;
+
+    size_t getAccumulatedSize() const override
+    {
+        return batch.size();
+    }
+private:
+    RelativePathsWithMetadata batch;
+    RelativePathsWithMetadata::iterator batch_iterator;
+};
+
+}
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
new file mode 100644
index 00000000000..766071cf815
--- /dev/null
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
@@ -0,0 +1,64 @@
+#include <Disks/ObjectStorages/ObjectStorageIteratorAsync.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
+void IObjectStorageIteratorAsync::next()
+{
+    std::lock_guard lock(mutex);
+
+    if (current_batch_iterator != current_batch.end())
+    {
+        ++current_batch_iterator;
+    }
+    else if (!is_finished)
+    {
+        if (outcome_future.valid())
+        {
+            BatchAndHasNext next_batch = outcome_future.get();
+            current_batch = std::move(next_batch.batch);
+            accumulated_size.fetch_add(current_batch.size(), std::memory_order_relaxed);
+            current_batch_iterator = current_batch.begin();
+            if (next_batch.has_next)
+                outcome_future = scheduleBatch();
+            else
+                is_finished = true;
+        }
+    }
+}
+
+std::future<IObjectStorageIteratorAsync::BatchAndHasNext> IObjectStorageIteratorAsync::scheduleBatch()
+{
+    return list_objects_scheduler([this]
+    {
+        BatchAndHasNext result;
+        result.has_next = getBatchAndCheckNext(result.batch);
+        return result;
+    }, Priority{});
+}
+
+
+bool IObjectStorageIteratorAsync::isValid() const
+{
+    return current_batch_iterator != current_batch.end();
+}
+
+RelativePathWithMetadata IObjectStorageIteratorAsync::current() const
+{
+    if (!isValid())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
+
+    return *current_batch_iterator;
+}
+
+size_t IObjectStorageIteratorAsync::getAccumulatedSize() const
+{
+    return accumulated_size.load(std::memory_order_relaxed);
+}
+
+}
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
new file mode 100644
index 00000000000..81ba9bce137
--- /dev/null
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
@@ -0,0 +1,58 @@
+#pragma once
+
+#include <Disks/ObjectStorages/ObjectStorageIterator.h>
+#include <Common/ThreadPool.h>
+#include <Interpreters/threadPoolCallbackRunner.h>
+#include <mutex>
+#include <Common/CurrentMetrics.h>
+
+namespace DB
+{
+
+class IObjectStorageIteratorAsync : public IObjectStorageIterator
+{
+public:
+    IObjectStorageIteratorAsync(
+        CurrentMetrics::Metric threads_metric,
+        CurrentMetrics::Metric threads_active_metric,
+        const std::string & thread_name)
+        : list_objects_pool(threads_metric, threads_active_metric, 1)
+        , list_objects_scheduler(threadPoolCallbackRunner<BatchAndHasNext>(list_objects_pool, thread_name))
+    {
+    }
+
+    void next() override;
+    bool isValid() const override;
+    RelativePathWithMetadata current() const override;
+    size_t getAccumulatedSize() const override;
+
+    ~IObjectStorageIteratorAsync() override
+    {
+        list_objects_pool.wait();
+    }
+
+protected:
+
+    virtual bool getBatchAndCheckNext(RelativePathsWithMetadata & batch) = 0;
+
+    struct BatchAndHasNext
+    {
+        RelativePathsWithMetadata batch;
+        bool has_next;
+    };
+
+    std::future<BatchAndHasNext> scheduleBatch();
+
+    bool is_finished{false};
+
+    std::mutex mutex;
+    ThreadPool list_objects_pool;
+    ThreadPoolCallbackRunner<BatchAndHasNext> list_objects_scheduler;
+    std::future<BatchAndHasNext> outcome_future;
+    RelativePathsWithMetadata current_batch;
+    RelativePathsWithMetadata::iterator current_batch_iterator;
+    std::atomic<size_t> accumulated_size = 0;
+};
+
+
+}
diff --git a/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp b/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
index 6e63efcc1e3..d19be20f920 100644
--- a/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
@@ -3,6 +3,7 @@
 #if USE_AWS_S3
 
 #include <IO/S3Common.h>
+#include <Disks/ObjectStorages/ObjectStorageIteratorAsync.h>
 
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Disks/ObjectStorages/DiskObjectStorageCommon.h>
@@ -33,6 +34,13 @@ namespace ProfileEvents
     extern const Event DiskS3ListObjects;
 }
 
+namespace CurrentMetrics
+{
+    extern const Metric ObjectStorageS3Threads;
+    extern const Metric ObjectStorageS3ThreadsActive;
+}
+
+
 namespace DB
 {
 
@@ -84,6 +92,62 @@ void logIfError(const Aws::Utils::Outcome<Result, Error> & response, std::functi
 
 }
 
+namespace
+{
+
+class S3IteratorAsync final : public IObjectStorageIteratorAsync
+{
+public:
+    S3IteratorAsync(
+        const std::string & bucket,
+        const std::string & path_prefix,
+        std::shared_ptr<const S3::Client> client_,
+        size_t max_list_size)
+        : IObjectStorageIteratorAsync(
+            CurrentMetrics::ObjectStorageS3Threads,
+            CurrentMetrics::ObjectStorageS3ThreadsActive,
+            "ListObjectS3")
+        , client(client_)
+    {
+        request.SetBucket(bucket);
+        request.SetPrefix(path_prefix);
+        request.SetMaxKeys(static_cast<int>(max_list_size));
+    }
+
+private:
+    bool getBatchAndCheckNext(RelativePathsWithMetadata & batch) override
+    {
+        ProfileEvents::increment(ProfileEvents::S3ListObjects);
+
+        bool result = false;
+        auto outcome = client->ListObjectsV2(request);
+        /// Outcome failure will be handled on the caller side.
+        if (outcome.IsSuccess())
+        {
+            auto objects = outcome.GetResult().GetContents();
+
+            result = !objects.empty();
+
+            for (const auto & object : objects)
+                batch.emplace_back(object.GetKey(), ObjectMetadata{static_cast<uint64_t>(object.GetSize()), Poco::Timestamp::fromEpochTime(object.GetLastModified().Seconds()), {}});
+
+            if (result)
+                request.SetContinuationToken(outcome.GetResult().GetNextContinuationToken());
+
+            return result;
+        }
+
+        throw Exception(ErrorCodes::S3_ERROR, "Could not list objects in bucket {} with prefix {}, S3 exception: {}, message: {}",
+                quoteString(request.GetBucket()), quoteString(request.GetPrefix()),
+                backQuote(outcome.GetError().GetExceptionName()), quoteString(outcome.GetError().GetMessage()));
+    }
+
+    std::shared_ptr<const S3::Client> client;
+    S3::ListObjectsV2Request request;
+};
+
+}
+
 bool S3ObjectStorage::exists(const StoredObject & object) const
 {
     auto settings_ptr = s3_settings.get();
@@ -183,6 +247,15 @@ std::unique_ptr<WriteBufferFromFileBase> S3ObjectStorage::writeObject( /// NOLIN
         disk_write_settings);
 }
 
+
+ObjectStorageIteratorPtr S3ObjectStorage::iterate(const std::string & path_prefix) const
+{
+    auto settings_ptr = s3_settings.get();
+    auto client_ptr = client.get();
+
+    return std::make_shared<S3IteratorAsync>(bucket, path_prefix, client_ptr, settings_ptr->list_object_keys_size);
+}
+
 void S3ObjectStorage::listObjects(const std::string & path, RelativePathsWithMetadata & children, int max_keys) const
 {
     auto settings_ptr = s3_settings.get();
diff --git a/src/Disks/ObjectStorages/S3/S3ObjectStorage.h b/src/Disks/ObjectStorages/S3/S3ObjectStorage.h
index b0eb01aec0d..072e1354d38 100644
--- a/src/Disks/ObjectStorages/S3/S3ObjectStorage.h
+++ b/src/Disks/ObjectStorages/S3/S3ObjectStorage.h
@@ -102,6 +102,8 @@ public:
 
     void listObjects(const std::string & path, RelativePathsWithMetadata & children, int max_keys) const override;
 
+    ObjectStorageIteratorPtr iterate(const std::string & path_prefix) const override;
+
     /// Uses `DeleteObjectRequest`.
     void removeObject(const StoredObject & object) override;
 

From 4bb44c7c72417a6e7a5f2ec7e1651b4360f9956e Mon Sep 17 00:00:00 2001
From: cmsxbc <i@cmsis.me>
Date: Sun, 4 Jun 2023 23:06:21 +0800
Subject: [PATCH 0338/1478] 1. skip extract darwin toolchain in builder when
 uncessary

2. update MacOSX SDK version in toolchain readme to match in builder
---
 cmake/toolchain/darwin-x86_64/README.txt | 4 ++--
 docker/packager/binary/build.sh          | 8 +++++---
 docker/packager/packager                 | 2 ++
 3 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/cmake/toolchain/darwin-x86_64/README.txt b/cmake/toolchain/darwin-x86_64/README.txt
index 65c9aba5be6..90ada960bfa 100644
--- a/cmake/toolchain/darwin-x86_64/README.txt
+++ b/cmake/toolchain/darwin-x86_64/README.txt
@@ -1,2 +1,2 @@
-wget https://github.com/phracker/MacOSX-SDKs/releases/download/10.15/MacOSX10.15.sdk.tar.xz
-tar xJf MacOSX10.15.sdk.tar.xz --strip-components=1
+wget https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.0.sdk.tar.xz
+tar xJf MacOSX11.0.sdk.tar.xz --strip-components=1
diff --git a/docker/packager/binary/build.sh b/docker/packager/binary/build.sh
index 2cd0a011013..ee1011a9cd5 100755
--- a/docker/packager/binary/build.sh
+++ b/docker/packager/binary/build.sh
@@ -11,9 +11,11 @@ ccache_status () {
 
 [ -O /build ] || git config --global --add safe.directory /build
 
-mkdir -p /build/cmake/toolchain/darwin-x86_64
-tar xJf /MacOSX11.0.sdk.tar.xz -C /build/cmake/toolchain/darwin-x86_64 --strip-components=1
-ln -sf darwin-x86_64 /build/cmake/toolchain/darwin-aarch64
+if [ "$EXTRACT_TOOLCHAIN_DARWIN" = "1" ];then
+  mkdir -p /build/cmake/toolchain/darwin-x86_64
+  tar xJf /MacOSX11.0.sdk.tar.xz -C /build/cmake/toolchain/darwin-x86_64 --strip-components=1
+  ln -sf darwin-x86_64 /build/cmake/toolchain/darwin-aarch64
+fi
 
 # Uncomment to debug ccache. Don't put ccache log in /output right away, or it
 # will be confusingly packed into the "performance" package.
diff --git a/docker/packager/packager b/docker/packager/packager
index a894fe2d8e9..1b3df858cd2 100755
--- a/docker/packager/packager
+++ b/docker/packager/packager
@@ -167,6 +167,7 @@ def parse_env_variables(
         cmake_flags.append(
             "-DCMAKE_TOOLCHAIN_FILE=/build/cmake/darwin/toolchain-x86_64.cmake"
         )
+        result.append("EXTRACT_TOOLCHAIN_DARWIN=1")
     elif is_cross_darwin_arm:
         cc = compiler[: -len(DARWIN_ARM_SUFFIX)]
         cmake_flags.append("-DCMAKE_AR:FILEPATH=/cctools/bin/aarch64-apple-darwin-ar")
@@ -181,6 +182,7 @@ def parse_env_variables(
         cmake_flags.append(
             "-DCMAKE_TOOLCHAIN_FILE=/build/cmake/darwin/toolchain-aarch64.cmake"
         )
+        result.append("EXTRACT_TOOLCHAIN_DARWIN=1")
     elif is_cross_arm:
         cc = compiler[: -len(ARM_SUFFIX)]
         cmake_flags.append(

From 34c4b89b161df4427912d402fa6aee4a6821dde1 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sun, 4 Jun 2023 16:23:34 +0000
Subject: [PATCH 0339/1478] fix backward compatibility for IP types hashing in
 aggregate functions

---
 base/base/IPv4andIPv6.h                       | 24 +++++++++++++------
 .../AggregateFunctionMap.cpp                  |  3 +++
 src/AggregateFunctions/AggregateFunctionMap.h |  3 +++
 .../AggregateFunctionUniq.cpp                 |  9 +++++++
 .../AggregateFunctionUniq.h                   | 12 +++++-----
 src/Core/Types_fwd.h                          |  2 +-
 src/DataTypes/DataTypeMap.cpp                 |  3 ++-
 7 files changed, 41 insertions(+), 15 deletions(-)

diff --git a/base/base/IPv4andIPv6.h b/base/base/IPv4andIPv6.h
index 7b745ec7b84..4aee2329572 100644
--- a/base/base/IPv4andIPv6.h
+++ b/base/base/IPv4andIPv6.h
@@ -7,16 +7,17 @@
 namespace DB
 {
 
-    using IPv4 = StrongTypedef<UInt32, struct IPv4Tag>;
+    struct IPv4 : StrongTypedef<UInt32, struct IPv4Tag>
+    {
+        using StrongTypedef::StrongTypedef;
+        using StrongTypedef::operator=;
+        constexpr explicit IPv4(UInt64 value): StrongTypedef(static_cast<UnderlyingType>(value)) {}
+    };
 
     struct IPv6 : StrongTypedef<UInt128, struct IPv6Tag>
     {
-        constexpr IPv6() = default;
-        constexpr explicit IPv6(const UInt128 & x) : StrongTypedef(x) {}
-        constexpr explicit IPv6(UInt128 && x) : StrongTypedef(std::move(x)) {}
-
-        IPv6 & operator=(const UInt128 & rhs) { StrongTypedef::operator=(rhs); return *this; }
-        IPv6 & operator=(UInt128 && rhs) { StrongTypedef::operator=(std::move(rhs)); return *this; }
+        using StrongTypedef::StrongTypedef;
+        using StrongTypedef::operator=;
 
         bool operator<(const IPv6 & rhs) const
         {
@@ -62,4 +63,13 @@ namespace std
             return std::hash<DB::IPv6::UnderlyingType>()(x.toUnderType());
         }
     };
+
+    template <>
+    struct hash<DB::IPv4>
+    {
+        size_t operator()(const DB::IPv4 & x) const
+        {
+            return std::hash<DB::IPv4::UnderlyingType>()(x.toUnderType());
+        }
+    };
 }
diff --git a/src/AggregateFunctions/AggregateFunctionMap.cpp b/src/AggregateFunctions/AggregateFunctionMap.cpp
index f6100602f3f..38e4f49d9a2 100644
--- a/src/AggregateFunctions/AggregateFunctionMap.cpp
+++ b/src/AggregateFunctions/AggregateFunctionMap.cpp
@@ -100,6 +100,9 @@ public:
                     return std::make_shared<AggregateFunctionMap<UInt256>>(nested_function, arguments);
                 case TypeIndex::UUID:
                     return std::make_shared<AggregateFunctionMap<UUID>>(nested_function, arguments);
+                case TypeIndex::IPv4:
+                    return std::make_shared<AggregateFunctionMap<IPv4>>(nested_function, arguments);
+                case TypeIndex::IPv6:
                 case TypeIndex::FixedString:
                 case TypeIndex::String:
                     return std::make_shared<AggregateFunctionMap<String>>(nested_function, arguments);
diff --git a/src/AggregateFunctions/AggregateFunctionMap.h b/src/AggregateFunctions/AggregateFunctionMap.h
index 55f6611974e..4a4ae92735b 100644
--- a/src/AggregateFunctions/AggregateFunctionMap.h
+++ b/src/AggregateFunctions/AggregateFunctionMap.h
@@ -19,6 +19,7 @@
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
 #include "DataTypes/Serializations/ISerialization.h"
+#include <base/IPv4andIPv6.h>
 #include "base/types.h"
 #include <Common/Arena.h>
 #include "AggregateFunctions/AggregateFunctionFactory.h"
@@ -147,6 +148,8 @@ public:
                 StringRef key_ref;
                 if (key_type->getTypeId() == TypeIndex::FixedString)
                     key_ref = assert_cast<const ColumnFixedString &>(key_column).getDataAt(offset + i);
+                else if (key_type->getTypeId() == TypeIndex::IPv6)
+                    key_ref = assert_cast<const ColumnIPv6 &>(key_column).getDataAt(offset + i);
                 else
                     key_ref = assert_cast<const ColumnString &>(key_column).getDataAt(offset + i);
 
diff --git a/src/AggregateFunctions/AggregateFunctionUniq.cpp b/src/AggregateFunctions/AggregateFunctionUniq.cpp
index bf998c5ee9e..f5147daa97b 100644
--- a/src/AggregateFunctions/AggregateFunctionUniq.cpp
+++ b/src/AggregateFunctions/AggregateFunctionUniq.cpp
@@ -8,6 +8,7 @@
 #include <DataTypes/DataTypeDateTime.h>
 #include <DataTypes/DataTypeTuple.h>
 #include <DataTypes/DataTypeUUID.h>
+#include <DataTypes/DataTypeIPv4andIPv6.h>
 
 #include <Core/Settings.h>
 
@@ -60,6 +61,10 @@ createAggregateFunctionUniq(const std::string & name, const DataTypes & argument
             return std::make_shared<AggregateFunctionUniq<String, Data>>(argument_types);
         else if (which.isUUID())
             return std::make_shared<AggregateFunctionUniq<DataTypeUUID::FieldType, Data>>(argument_types);
+        else if (which.isIPv4())
+            return std::make_shared<AggregateFunctionUniq<DataTypeIPv4::FieldType, Data>>(argument_types);
+        else if (which.isIPv6())
+            return std::make_shared<AggregateFunctionUniq<DataTypeIPv6::FieldType, Data>>(argument_types);
         else if (which.isTuple())
         {
             if (use_exact_hash_function)
@@ -109,6 +114,10 @@ createAggregateFunctionUniq(const std::string & name, const DataTypes & argument
             return std::make_shared<AggregateFunctionUniq<String, Data<String, is_able_to_parallelize_merge>>>(argument_types);
         else if (which.isUUID())
             return std::make_shared<AggregateFunctionUniq<DataTypeUUID::FieldType, Data<DataTypeUUID::FieldType, is_able_to_parallelize_merge>>>(argument_types);
+        else if (which.isIPv4())
+            return std::make_shared<AggregateFunctionUniq<DataTypeIPv4::FieldType, Data<DataTypeIPv4::FieldType, is_able_to_parallelize_merge>>>(argument_types);
+        else if (which.isIPv6())
+            return std::make_shared<AggregateFunctionUniq<DataTypeIPv6::FieldType, Data<String, is_able_to_parallelize_merge>>>(argument_types);
         else if (which.isTuple())
         {
             if (use_exact_hash_function)
diff --git a/src/AggregateFunctions/AggregateFunctionUniq.h b/src/AggregateFunctions/AggregateFunctionUniq.h
index c782b9314fd..0524dd53ec0 100644
--- a/src/AggregateFunctions/AggregateFunctionUniq.h
+++ b/src/AggregateFunctions/AggregateFunctionUniq.h
@@ -248,17 +248,17 @@ struct Adder
                 AggregateFunctionUniqUniquesHashSetData> || std::is_same_v<Data, AggregateFunctionUniqHLL12Data<T, Data::is_able_to_parallelize_merge>>)
         {
             const auto & column = *columns[0];
-            if constexpr (!std::is_same_v<T, String>)
+            if constexpr (std::is_same_v<T, String> || std::is_same_v<T, IPv6>)
+            {
+                StringRef value = column.getDataAt(row_num);
+                data.set.insert(CityHash_v1_0_2::CityHash64(value.data, value.size));
+            }
+            else
             {
                 using ValueType = typename decltype(data.set)::value_type;
                 const auto & value = assert_cast<const ColumnVector<T> &>(column).getElement(row_num);
                 data.set.insert(static_cast<ValueType>(AggregateFunctionUniqTraits<T>::hash(value)));
             }
-            else
-            {
-                StringRef value = column.getDataAt(row_num);
-                data.set.insert(CityHash_v1_0_2::CityHash64(value.data, value.size));
-            }
         }
         else if constexpr (std::is_same_v<Data, AggregateFunctionUniqExactData<T, Data::is_able_to_parallelize_merge>>)
         {
diff --git a/src/Core/Types_fwd.h b/src/Core/Types_fwd.h
index 3db1127fe5a..a59e4b6eab8 100644
--- a/src/Core/Types_fwd.h
+++ b/src/Core/Types_fwd.h
@@ -27,7 +27,7 @@ namespace DB
 
 using UUID = StrongTypedef<UInt128, struct UUIDTag>;
 
-using IPv4 = StrongTypedef<UInt32, struct IPv4Tag>;
+struct IPv4;
 
 struct IPv6;
 
diff --git a/src/DataTypes/DataTypeMap.cpp b/src/DataTypes/DataTypeMap.cpp
index 0f5d97e6761..90561857fad 100644
--- a/src/DataTypes/DataTypeMap.cpp
+++ b/src/DataTypes/DataTypeMap.cpp
@@ -69,7 +69,7 @@ void DataTypeMap::assertKeyType() const
     if (!checkKeyType(key_type))
         throw Exception(ErrorCodes::BAD_ARGUMENTS,
                         "Type of Map key must be a type, that can be represented by integer "
-                        "or String or FixedString (possibly LowCardinality) or UUID,"
+                        "or String or FixedString (possibly LowCardinality) or UUID or IPv6,"
                         " but {} given", key_type->getName());
 }
 
@@ -120,6 +120,7 @@ bool DataTypeMap::checkKeyType(DataTypePtr key_type)
     else if (!key_type->isValueRepresentedByInteger()
              && !isStringOrFixedString(*key_type)
              && !WhichDataType(key_type).isNothing()
+             && !WhichDataType(key_type).isIPv6()
              && !WhichDataType(key_type).isUUID())
     {
         return false;

From 8d8d06285ff6d931d6a1ee069c9a5885dc09264a Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Sun, 4 Jun 2023 18:59:22 +0200
Subject: [PATCH 0340/1478] Add integration test

---
 src/Storages/StorageAzure.cpp                 |  51 +++++++-
 .../__init__.py                               |   1 +
 .../test_storage_azure_blob_storage/test.py   | 122 ++++++++++++++++++
 3 files changed, 170 insertions(+), 4 deletions(-)
 create mode 100644 tests/integration/test_storage_azure_blob_storage/__init__.py
 create mode 100644 tests/integration/test_storage_azure_blob_storage/test.py

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index fd250a128c9..7b4bc9e6769 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -115,6 +115,7 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
         else
         {
             configuration.account_name = fourth_arg;
+
             configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
             auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
             if (!is_format_arg(sixth_arg))
@@ -216,18 +217,58 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
     if (configuration.is_connection_string)
     {
         result = std::make_unique<BlobContainerClient>(BlobContainerClient::CreateFromConnectionString(configuration.connection_url, configuration.container));
+        result->CreateIfNotExists();
     }
     else
     {
         if (configuration.account_name.has_value() && configuration.account_key.has_value())
         {
             auto storage_shared_key_credential = std::make_shared<Azure::Storage::StorageSharedKeyCredential>(*configuration.account_name, *configuration.account_key);
-            result = std::make_unique<BlobContainerClient>(configuration.connection_url, storage_shared_key_credential);
+            auto blob_service_client = std::make_unique<BlobServiceClient>(configuration.connection_url, storage_shared_key_credential);
+            try
+            {
+                result = std::make_unique<BlobContainerClient>(blob_service_client->CreateBlobContainer(configuration.container).Value);
+            }
+            catch (const Azure::Storage::StorageException & e)
+            {
+                if (e.StatusCode == Azure::Core::Http::HttpStatusCode::Conflict)
+                {
+                    auto final_url = configuration.connection_url
+                        + (configuration.connection_url.back() == '/' ? "" : "/")
+                        + configuration.container;
+
+                    result = std::make_unique<BlobContainerClient>(final_url, storage_shared_key_credential);
+                }
+                else
+                {
+                    throw;
+                }
+            }
         }
+        else
+        {
+            auto managed_identity_credential = std::make_shared<Azure::Identity::ManagedIdentityCredential>();
+            auto blob_service_client = std::make_unique<BlobServiceClient>(configuration.connection_url, managed_identity_credential);
+            try
+            {
+                result = std::make_unique<BlobContainerClient>(blob_service_client->CreateBlobContainer(configuration.container).Value);
+            }
+            catch (const Azure::Storage::StorageException & e)
+            {
+                if (e.StatusCode == Azure::Core::Http::HttpStatusCode::Conflict)
+                {
+                    auto final_url = configuration.connection_url
+                        + (configuration.connection_url.back() == '/' ? "" : "/")
+                        + configuration.container;
 
-        auto managed_identity_credential = std::make_shared<Azure::Identity::ManagedIdentityCredential>();
-
-        result = std::make_unique<BlobContainerClient>(configuration.connection_url, managed_identity_credential);
+                    result = std::make_unique<BlobContainerClient>(final_url, managed_identity_credential);
+                }
+                else
+                {
+                    throw;
+                }
+            }
+        }
     }
 
     return result;
@@ -466,12 +507,14 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
 
         if (!truncate_in_insert && object_storage->exists(StoredObject(configuration.blob_path)))
         {
+
             if (local_context->getSettingsRef().s3_create_new_file_on_insert)
             {
                 size_t index = configuration.blobs_paths.size();
                 const auto & first_key = configuration.blobs_paths[0];
                 auto pos = first_key.find_first_of('.');
                 String new_key;
+
                 do
                 {
                     new_key = first_key.substr(0, pos) + "." + std::to_string(index) + (pos == std::string::npos ? "" : first_key.substr(pos));
diff --git a/tests/integration/test_storage_azure_blob_storage/__init__.py b/tests/integration/test_storage_azure_blob_storage/__init__.py
new file mode 100644
index 00000000000..e5a0d9b4834
--- /dev/null
+++ b/tests/integration/test_storage_azure_blob_storage/__init__.py
@@ -0,0 +1 @@
+#!/usr/bin/env python3
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
new file mode 100644
index 00000000000..94b059fe4fe
--- /dev/null
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+
+import gzip
+import json
+import logging
+import os
+import io
+import random
+import threading
+import time
+
+from azure.storage.blob import BlobServiceClient
+import helpers.client
+import pytest
+from helpers.cluster import ClickHouseCluster, ClickHouseInstance
+from helpers.network import PartitionManager
+from helpers.mock_servers import start_mock_servers
+from helpers.test_tools import exec_query_with_retry
+
+@pytest.fixture(scope="module")
+def cluster():
+    try:
+        cluster = ClickHouseCluster(__file__)
+        cluster.add_instance(
+            "node",
+            with_azurite=True,
+        )
+        cluster.start()
+
+        yield cluster
+    finally:
+        cluster.shutdown()
+
+def azure_query(node, query, try_num=3, settings={}):
+    for i in range(try_num):
+        try:
+            return node.query(query, settings=settings)
+        except Exception as ex:
+            retriable_errors = [
+                "DB::Exception: Azure::Core::Http::TransportException: Connection was closed by the server while trying to read a response"
+            ]
+            retry = False
+            for error in retriable_errors:
+                if error in str(ex):
+                    retry = True
+                    print(f"Try num: {i}. Having retriable error: {ex}")
+                    break
+            if not retry or i == try_num - 1:
+                raise Exception(ex)
+            continue
+
+def get_azure_file_content(filename):
+    container_name = "cont"
+    connection_string = "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;"
+    blob_service_client = BlobServiceClient.from_connection_string(connection_string)
+    container_client = blob_service_client.get_container_client(container_name)
+    blob_client = container_client.get_blob_client(filename)
+    download_stream = blob_client.download_blob()
+    return download_stream.readall().decode('utf-8')
+
+def test_create_table_connection_string(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_create_table_conn_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 'cont', 'test_create_connection_string', 'CSV')")
+
+def test_create_table_account_string(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_create_table_account_url (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1',  'cont', 'test_create_connection_string', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')")
+
+def test_simple_write_account_string(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_simple_write (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')")
+    azure_query(node, "INSERT INTO test_simple_write VALUES (1, 'a')")
+    print(get_azure_file_content('test_simple_write.csv'))
+    assert get_azure_file_content('test_simple_write.csv') == '1,"a"\n'
+
+def test_simple_write_connection_string(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')")
+    azure_query(node, "INSERT INTO test_simple_write_connection_string VALUES (1, 'a')")
+    print(get_azure_file_content('test_simple_write_c.csv'))
+    assert get_azure_file_content('test_simple_write_c.csv') == '1,"a"\n'
+
+
+def test_partition_by(cluster):
+    node = cluster.instances["node"]
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    partition_by = "column3"
+    values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
+    filename = "test_{_partition_id}.csv"
+
+    azure_query(node, f"CREATE TABLE test_partitioned_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(node, f"INSERT INTO test_partitioned_write VALUES {values}")
+
+    assert "1,2,3\n" == get_azure_file_content("test_3.csv")
+    assert "3,2,1\n" == get_azure_file_content("test_1.csv")
+    assert "78,43,45\n" == get_azure_file_content("test_45.csv")
+
+
+def test_partition_by_string_column(cluster):
+    node = cluster.instances["node"]
+    table_format = "col_num UInt32, col_str String"
+    partition_by = "col_str"
+    values = "(1, 'foo/bar'), (3, 'йцук'), (78, '你好')"
+    filename = "test_{_partition_id}.csv"
+    azure_query(node, f"CREATE TABLE test_partitioned_string_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(node, f"INSERT INTO test_partitioned_string_write VALUES {values}")
+
+    assert '1,"foo/bar"\n' == get_azure_file_content("test_foo/bar.csv")
+    assert '3,"йцук"\n' == get_azure_file_content("test_йцук.csv")
+    assert '78,"你好"\n' == get_azure_file_content("test_你好.csv")
+
+
+def test_partition_by_const_column(cluster):
+    node = cluster.instances["node"]
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
+    partition_by = "'88'"
+    values_csv = "1,2,3\n3,2,1\n78,43,45\n"
+    filename = "test_{_partition_id}.csv"
+    azure_query(node, f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(node, f"INSERT INTO test_partitioned_const_write VALUES {values}")
+    assert values_csv == get_azure_file_content("test_88.csv")

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 0341/1478] 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 0342/1478] 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 0343/1478] 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 6fe0aa531e28c27287fb5b6f57536ede0016b20a Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 16:18:53 -0300
Subject: [PATCH 0344/1478] Update summap.md

---
 .../aggregate-functions/reference/summap.md              | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/summap.md b/docs/en/sql-reference/aggregate-functions/reference/summap.md
index 1acfde3783a..d63e8b81716 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/summap.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/summap.md
@@ -5,7 +5,9 @@ sidebar_position: 141
 
 # sumMap
 
-Syntax: `sumMap(key, value)` or `sumMap(Tuple(key, value))`
+Syntax: [sumMap(key <Array>, value <Array>)](../../data-types/array.md) or [sumMap(Tuple(key <Array>, value <Array>))](../../data-types/tuple.md)
+
+Alias: `sumMappedArrays`.
 
 Totals the `value` array according to the keys specified in the `key` array.
 
@@ -27,6 +29,7 @@ CREATE TABLE sum_map(
     ),
     statusMapTuple Tuple(Array(Int32), Array(Int32))
 ) ENGINE = Log;
+
 INSERT INTO sum_map VALUES
     ('2000-01-01', '2000-01-01 00:00:00', [1, 2, 3], [10, 10, 10], ([1, 2, 3], [10, 10, 10])),
     ('2000-01-01', '2000-01-01 00:00:00', [3, 4, 5], [10, 10, 10], ([3, 4, 5], [10, 10, 10])),
@@ -47,3 +50,7 @@ GROUP BY timeslot
 │ 2000-01-01 00:01:00 │ ([4,5,6,7,8],[10,10,20,10,10])               │ ([4,5,6,7,8],[10,10,20,10,10]) │
 └─────────────────────┴──────────────────────────────────────────────┴────────────────────────────────┘
 ```
+
+**See Also**
+    
+- [-Map combinator for Map datatype](../combinators.md#-map)

From 424a043c326cb8451bfc0da23fc2d1df2385fd4e Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 16:22:26 -0300
Subject: [PATCH 0345/1478] Update map.md

---
 docs/en/sql-reference/data-types/map.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/sql-reference/data-types/map.md b/docs/en/sql-reference/data-types/map.md
index 0ea183d73d8..e0c8b98f9f8 100644
--- a/docs/en/sql-reference/data-types/map.md
+++ b/docs/en/sql-reference/data-types/map.md
@@ -108,6 +108,7 @@ Result:
 
 - [map()](../../sql-reference/functions/tuple-map-functions.md#function-map) function
 - [CAST()](../../sql-reference/functions/type-conversion-functions.md#type_conversion_function-cast) function
+- [-Map combinator for Map datatype](../aggregate-functions/combinators.md#-map)
 
 
 ## Related content

From 7c64b1f26634acc8e93dd65c00b8b0dfb6419f1d Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 16:32:22 -0300
Subject: [PATCH 0346/1478] Update combinators.md

---
 .../aggregate-functions/combinators.md        | 29 ++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/combinators.md b/docs/en/sql-reference/aggregate-functions/combinators.md
index e1db5d8d23e..fd693430064 100644
--- a/docs/en/sql-reference/aggregate-functions/combinators.md
+++ b/docs/en/sql-reference/aggregate-functions/combinators.md
@@ -30,7 +30,34 @@ Example 2: `uniqArray(arr)` – Counts the number of unique elements in all ‘a
 
 The -Map suffix can be appended to any aggregate function. This will create an aggregate function which gets Map type as an argument, and aggregates values of each key of the map separately using the specified aggregate function. The result is also of a Map type.
 
-Examples: `sumMap(map(1,1))`, `avgMap(map('a', 1))`.
+**Example**
+
+```sql
+CREATE TABLE map_map(
+    date Date,
+    timeslot DateTime,
+    status Map(String, UInt64)
+) ENGINE = Log;
+
+INSERT INTO map_map VALUES
+    ('2000-01-01', '2000-01-01 00:00:00', (['a', 'b', 'c'], [10, 10, 10])),
+    ('2000-01-01', '2000-01-01 00:00:00', (['c', 'd', 'e'], [10, 10, 10])),
+    ('2000-01-01', '2000-01-01 00:01:00', (['d', 'e', 'f'], [10, 10, 10])),
+    ('2000-01-01', '2000-01-01 00:01:00', (['f', 'g', 'g'], [10, 10, 10]));
+    
+SELECT
+    timeslot,
+    sumMap(status),
+    avgMap(status),
+    minMap(status)
+FROM map_map
+GROUP BY timeslot;
+
+┌────────────timeslot─┬─sumMap(status)───────────────────────┬─avgMap(status)───────────────────────┬─minMap(status)───────────────────────┐
+│ 2000-01-01 00:00:00 │ {'a':10,'b':10,'c':20,'d':10,'e':10} │ {'a':10,'b':10,'c':10,'d':10,'e':10} │ {'a':10,'b':10,'c':10,'d':10,'e':10} │
+│ 2000-01-01 00:01:00 │ {'d':10,'e':10,'f':20,'g':20}        │ {'d':10,'e':10,'f':10,'g':10}        │ {'d':10,'e':10,'f':10,'g':10}        │
+└─────────────────────┴──────────────────────────────────────┴──────────────────────────────────────┴──────────────────────────────────────┘
+```
 
 ## -SimpleState
 

From d81884be82bf32440cbaae3f63349716898aa1e3 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:13:25 -0300
Subject: [PATCH 0347/1478] Update summap.md

---
 docs/en/sql-reference/aggregate-functions/reference/summap.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/summap.md b/docs/en/sql-reference/aggregate-functions/reference/summap.md
index d63e8b81716..0725b80c2a2 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/summap.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/summap.md
@@ -5,7 +5,7 @@ sidebar_position: 141
 
 # sumMap
 
-Syntax: [sumMap(key <Array>, value <Array>)](../../data-types/array.md) or [sumMap(Tuple(key <Array>, value <Array>))](../../data-types/tuple.md)
+Syntax: `sumMap(key <Array>, value <Array>)` [Array](../../data-types/array.md) or `sumMap(Tuple(key <Array>, value <Array>))` [Tuple](../../data-types/tuple.md)
 
 Alias: `sumMappedArrays`.
 

From d93ee14e328ce0c8026a1d94a4233b9905fed793 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:15:16 -0300
Subject: [PATCH 0348/1478] Update summap.md

---
 docs/en/sql-reference/aggregate-functions/reference/summap.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/summap.md b/docs/en/sql-reference/aggregate-functions/reference/summap.md
index 0725b80c2a2..aa12fad9559 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/summap.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/summap.md
@@ -5,7 +5,7 @@ sidebar_position: 141
 
 # sumMap
 
-Syntax: `sumMap(key <Array>, value <Array>)` [Array](../../data-types/array.md) or `sumMap(Tuple(key <Array>, value <Array>))` [Tuple](../../data-types/tuple.md)
+Syntax: `sumMap(key <[Array](../../data-types/array.md)>, value <[Array](../../data-types/array.md)>)` or `sumMap([Tuple](../../data-types/tuple.md)(key <Array>, value <Array>))`
 
 Alias: `sumMappedArrays`.
 

From 7ca719c73a41f54c3b2032297e8d0b3f9f6dd7a2 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:19:07 -0300
Subject: [PATCH 0349/1478] Update summap.md

---
 docs/en/sql-reference/aggregate-functions/reference/summap.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/summap.md b/docs/en/sql-reference/aggregate-functions/reference/summap.md
index aa12fad9559..baa25edc250 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/summap.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/summap.md
@@ -5,7 +5,9 @@ sidebar_position: 141
 
 # sumMap
 
-Syntax: `sumMap(key <[Array](../../data-types/array.md)>, value <[Array](../../data-types/array.md)>)` or `sumMap([Tuple](../../data-types/tuple.md)(key <Array>, value <Array>))`
+Syntax: `sumMap(key <Array>, value <Array>)` [Array type](../../data-types/array.md) or `sumMap(Tuple(key <Array>, value <Array>))` [Tuple type](../../data-types/tuple.md).
+
+Arguments: 
 
 Alias: `sumMappedArrays`.
 

From 0d9728410fd7631ff0e0755c749024de5b7ffdb1 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:31:12 -0300
Subject: [PATCH 0350/1478] Update first_value.md

---
 .../reference/first_value.md                  | 35 ++++++++++++++++---
 1 file changed, 30 insertions(+), 5 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/first_value.md b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
index f343ca3f66c..15e0b113afd 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/first_value.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
@@ -6,24 +6,32 @@ sidebar_position: 7
 # first_value
 
 Selects the first encountered value, similar to `any`, but could accept NULL.
+Mostly it should be used with [Window Functions](../../window-functions.md).
+Without Window Functions the result will be random if the source stream is not ordered.
 
 ## examples
 
 ```sql
-insert into test_data (a,b) values (1,null), (2,3), (4, 5), (6,null)
+CREATE TABLE test_data
+(
+    a Int64,
+    b Nullable(Int64)
+)
+ENGINE = Memory;
+
+INSERT INTO test_data (a, b) FORMAT Values (1,null), (2,3), (4, 5), (6,null);
 ```
 
 ### example1
 The NULL value is ignored at default.
 ```sql
-select first_value(b) from test_data
+select first_value(b) from test_data;
 ```
 
 ```text
 ┌─first_value_ignore_nulls(b)─┐
 │                           3 │
 └─────────────────────────────┘
-
 ```
 
 ### example2
@@ -36,7 +44,6 @@ select first_value(b) ignore nulls from test_data
 ┌─first_value_ignore_nulls(b)─┐
 │                           3 │
 └─────────────────────────────┘
-
 ```
 
 ### example3
@@ -46,10 +53,28 @@ select first_value(b) respect nulls from test_data
 ```
 
 ```text
-
 ┌─first_value_respect_nulls(b)─┐
 │                         ᴺᵁᴸᴸ │
 └──────────────────────────────┘
 ```
 
+### example4
+Stabilized result using the sub-query with `ORDER BY`.
+```sql
+SELECT
+    first_value_respect_nulls(b),
+    first_value(b)
+FROM
+(
+    SELECT *
+    FROM test_data
+    ORDER BY a ASC
+)
+```
+
+```text
+┌─first_value_respect_nulls(b)─┬─first_value(b)─┐
+│                         ᴺᵁᴸᴸ │              3 │
+└──────────────────────────────┴────────────────┘
+```
 

From 2e26e84909098c97eab553eb7fcfa98b5a92bfae Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:34:31 -0300
Subject: [PATCH 0351/1478] Update last_value.md

---
 .../reference/last_value.md                   | 32 +++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/last_value.md b/docs/en/sql-reference/aggregate-functions/reference/last_value.md
index 7b6e14e4a55..77b4f3d1b60 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/last_value.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/last_value.md
@@ -6,12 +6,20 @@ sidebar_position: 8
 # last_value
 
 Selects the last encountered value, similar to `anyLast`, but could accept NULL.
-
+Mostly it should be used with [Window Functions](../../window-functions.md).
+Without Window Functions the result will be random if the source stream is not ordered.
 
 ## examples
 
 ```sql
-insert into test_data (a,b) values (1,null), (2,3), (4, 5), (6,null)
+CREATE TABLE test_data
+(
+    a Int64,
+    b Nullable(Int64)
+)
+ENGINE = Memory;
+
+INSERT INTO test_data (a, b) Values (1,null), (2,3), (4, 5), (6,null)
 ```
 
 ### example1
@@ -50,4 +58,24 @@ select last_value(b) respect nulls from test_data
 └─────────────────────────────┘
 ```
 
+### example4
+Stabilized result using the sub-query with `ORDER BY`.
+```sql
+SELECT
+    last_value_respect_nulls(b),
+    last_value(b)
+FROM
+(
+    SELECT *
+    FROM test_data
+    ORDER BY a ASC
+)
+```
+
+```text
+┌─last_value_respect_nulls(b)─┬─last_value(b)─┐
+│                        ᴺᵁᴸᴸ │             5 │
+└─────────────────────────────┴───────────────┘
+```
+
 

From bd7a593dd3ae4447f23c8658a04fb79d164b9d84 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:34:46 -0300
Subject: [PATCH 0352/1478] Update first_value.md

---
 .../sql-reference/aggregate-functions/reference/first_value.md  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/first_value.md b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
index 15e0b113afd..6b764ec5739 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/first_value.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
@@ -19,7 +19,7 @@ CREATE TABLE test_data
 )
 ENGINE = Memory;
 
-INSERT INTO test_data (a, b) FORMAT Values (1,null), (2,3), (4, 5), (6,null);
+INSERT INTO test_data (a, b) Values (1,null), (2,3), (4, 5), (6,null);
 ```
 
 ### example1

From fb21a6907a3eef7a054b44f9c81c5bc3a05f5cb7 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:38:05 -0300
Subject: [PATCH 0353/1478] Update last_value.md

---
 .../sql-reference/aggregate-functions/reference/last_value.md   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/last_value.md b/docs/en/sql-reference/aggregate-functions/reference/last_value.md
index 77b4f3d1b60..21a86a5f130 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/last_value.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/last_value.md
@@ -6,7 +6,7 @@ sidebar_position: 8
 # last_value
 
 Selects the last encountered value, similar to `anyLast`, but could accept NULL.
-Mostly it should be used with [Window Functions](../../window-functions.md).
+Mostly it should be used with [Window Functions](../../window-functions/index.md).
 Without Window Functions the result will be random if the source stream is not ordered.
 
 ## examples

From bcd89cbbf28c79e831f3e39a422319e5b6ea5915 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 17:38:38 -0300
Subject: [PATCH 0354/1478] Update first_value.md

---
 .../sql-reference/aggregate-functions/reference/first_value.md  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/first_value.md b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
index 6b764ec5739..c1965b23fe3 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/first_value.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/first_value.md
@@ -6,7 +6,7 @@ sidebar_position: 7
 # first_value
 
 Selects the first encountered value, similar to `any`, but could accept NULL.
-Mostly it should be used with [Window Functions](../../window-functions.md).
+Mostly it should be used with [Window Functions](../../window-functions/index.md).
 Without Window Functions the result will be random if the source stream is not ordered.
 
 ## examples

From bf127f4e1e3a08de7ae822d0b53d25ad80899efa Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Sat, 3 Jun 2023 21:31:43 +0200
Subject: [PATCH 0355/1478] MSan support for Rust

Previously you have to unpoison memory from the Rust, however Rust does
supports MSan, so let's simply use it.

But for this we need nightly Rust and recompile standard library.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 docker/packager/binary/Dockerfile |  4 +++-
 rust/.cargo/config.toml.in        |  7 +++++++
 rust/BLAKE3/include/blake3.h      |  2 --
 rust/BLAKE3/src/lib.rs            | 25 -------------------------
 rust/CMakeLists.txt               | 10 ++++++++++
 src/Functions/FunctionsHashing.h  |  7 +------
 6 files changed, 21 insertions(+), 34 deletions(-)

diff --git a/docker/packager/binary/Dockerfile b/docker/packager/binary/Dockerfile
index fa860b2207f..dd21c8552d3 100644
--- a/docker/packager/binary/Dockerfile
+++ b/docker/packager/binary/Dockerfile
@@ -46,10 +46,12 @@ ENV CXX=clang++-${LLVM_VERSION}
 # Rust toolchain and libraries
 ENV RUSTUP_HOME=/rust/rustup
 ENV CARGO_HOME=/rust/cargo
-ENV PATH="/rust/cargo/env:${PATH}"
 ENV PATH="/rust/cargo/bin:${PATH}"
 RUN curl https://sh.rustup.rs -sSf | bash -s -- -y && \
     chmod 777 -R /rust && \
+    rustup toolchain install nightly && \
+    rustup default nightly && \
+    rustup component add rust-src && \
     rustup target add aarch64-unknown-linux-gnu && \
     rustup target add x86_64-apple-darwin && \
     rustup target add x86_64-unknown-freebsd && \
diff --git a/rust/.cargo/config.toml.in b/rust/.cargo/config.toml.in
index a1dd966117b..db83145d449 100644
--- a/rust/.cargo/config.toml.in
+++ b/rust/.cargo/config.toml.in
@@ -1,3 +1,10 @@
 [env]
 CFLAGS = "@RUST_CFLAGS@"
 CXXFLAGS = "@RUST_CXXFLAGS@"
+
+[build]
+rustflags = @RUSTFLAGS@
+rustdocflags = @RUSTFLAGS@
+
+[unstable]
+@RUST_CARGO_BUILD_STD@
diff --git a/rust/BLAKE3/include/blake3.h b/rust/BLAKE3/include/blake3.h
index 85572506d43..5dc7d5bd902 100644
--- a/rust/BLAKE3/include/blake3.h
+++ b/rust/BLAKE3/include/blake3.h
@@ -8,8 +8,6 @@ extern "C" {
 
 char *blake3_apply_shim(const char *begin, uint32_t _size, uint8_t *out_char_data);
 
-char *blake3_apply_shim_msan_compat(const char *begin, uint32_t size, uint8_t *out_char_data);
-
 void blake3_free_char_pointer(char *ptr_to_free);
 
 } // extern "C"
diff --git a/rust/BLAKE3/src/lib.rs b/rust/BLAKE3/src/lib.rs
index 2b54787589f..011145d2f71 100644
--- a/rust/BLAKE3/src/lib.rs
+++ b/rust/BLAKE3/src/lib.rs
@@ -3,7 +3,6 @@ extern crate libc;
 
 use std::ffi::{CStr, CString};
 use std::os::raw::c_char;
-use std::mem;
 
 #[no_mangle]
 pub unsafe extern "C" fn blake3_apply_shim(
@@ -24,30 +23,6 @@ pub unsafe extern "C" fn blake3_apply_shim(
     std::ptr::null_mut()
 }
 
-#[no_mangle]
-pub unsafe extern "C" fn blake3_apply_shim_msan_compat(
-    mut begin: *const c_char,
-    size: u32,
-    out_char_data: *mut u8,
-) -> *mut c_char {
-    if begin.is_null() {
-        let err_str = CString::new("input was a null pointer").unwrap();
-        return err_str.into_raw();
-    }
-    libc::memset(out_char_data as *mut libc::c_void, 0, mem::size_of::<u8>());
-    let mut hasher = blake3::Hasher::new();
-    let mut vec = Vec::<u8>::new();
-    for _ in 0..size {
-        vec.push(*begin as u8);
-        begin = begin.add(1);
-    }
-    let input_res = vec.as_mut_slice();
-    hasher.update(input_res);
-    let mut reader = hasher.finalize_xof();
-    reader.fill(std::slice::from_raw_parts_mut(out_char_data, blake3::OUT_LEN));
-    std::ptr::null_mut()
-}
-
 // Freeing memory according to docs: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_raw
 #[no_mangle]
 pub unsafe extern "C" fn blake3_free_char_pointer(ptr_to_free: *mut c_char) {
diff --git a/rust/CMakeLists.txt b/rust/CMakeLists.txt
index d229894791a..6700ead9786 100644
--- a/rust/CMakeLists.txt
+++ b/rust/CMakeLists.txt
@@ -14,8 +14,18 @@ macro(configure_rustc)
         set(RUST_CFLAGS "${RUST_CFLAGS} --sysroot ${CMAKE_SYSROOT}")
     endif()
 
+    set(RUSTFLAGS "[]")
+    set(RUST_CARGO_BUILD_STD "")
+    # For more info: https://doc.rust-lang.org/beta/unstable-book/compiler-flags/sanitizer.html#memorysanitizer
+    if (SANITIZE STREQUAL "memory")
+        set(RUST_CARGO_BUILD_STD "build-std = [\"std\", \"panic_abort\", \"core\", \"alloc\"]")
+        set(RUSTFLAGS "[\"-Zsanitizer=memory\", \"-Zsanitizer-memory-track-origins\"]")
+    endif()
+
     message(STATUS "RUST_CFLAGS: ${RUST_CFLAGS}")
     message(STATUS "RUST_CXXFLAGS: ${RUST_CXXFLAGS}")
+    message(STATUS "RUSTFLAGS: ${RUSTFLAGS}")
+    message(STATUS "RUST_CARGO_BUILD_STD: ${RUST_CARGO_BUILD_STD}")
 
     # NOTE: requires RW access for the source dir
     configure_file("${CMAKE_CURRENT_SOURCE_DIR}/.cargo/config.toml.in" "${CMAKE_CURRENT_SOURCE_DIR}/.cargo/config.toml" @ONLY)
diff --git a/src/Functions/FunctionsHashing.h b/src/Functions/FunctionsHashing.h
index 32e3fbbd4ea..a4d4fbd085d 100644
--- a/src/Functions/FunctionsHashing.h
+++ b/src/Functions/FunctionsHashing.h
@@ -816,12 +816,7 @@ struct ImplBLAKE3
 #else
     static void apply(const char * begin, const size_t size, unsigned char* out_char_data)
     {
-#    if defined(MEMORY_SANITIZER)
-            auto err_msg = blake3_apply_shim_msan_compat(begin, safe_cast<uint32_t>(size), out_char_data);
-            __msan_unpoison(out_char_data, length);
-#    else
-            auto err_msg = blake3_apply_shim(begin, safe_cast<uint32_t>(size), out_char_data);
-#    endif
+        auto err_msg = blake3_apply_shim(begin, safe_cast<uint32_t>(size), out_char_data);
         if (err_msg != nullptr)
         {
             auto err_st = std::string(err_msg);

From 045573e92565a6a58a7eae80cc11bb686807e9ee Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 18:10:34 -0300
Subject: [PATCH 0356/1478] Update datetime64.md

---
 .../en/sql-reference/data-types/datetime64.md | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/en/sql-reference/data-types/datetime64.md b/docs/en/sql-reference/data-types/datetime64.md
index 2d4035831fa..da3d9dc4f65 100644
--- a/docs/en/sql-reference/data-types/datetime64.md
+++ b/docs/en/sql-reference/data-types/datetime64.md
@@ -63,7 +63,7 @@ SELECT * FROM dt WHERE timestamp = toDateTime64('2019-01-01 00:00:00', 3, 'Asia/
 
 ``` text
 ┌───────────────timestamp─┬─event_id─┐
-│ 2019-01-01 00:00:00.000 │        2 │
+│ 2019-01-01 00:00:00.000 │        3 │
 └─────────────────────────┴──────────┘
 ```
 
@@ -75,8 +75,8 @@ SELECT * FROM dt WHERE timestamp = toDateTime64(1546300800.123, 3);
 
 ``` text
 ┌───────────────timestamp─┬─event_id─┐
-│ 2019-01-01 00:00:00.123 │        1 │
-│ 2019-01-01 00:00:00.123 │        2 │
+│ 2019-01-01 03:00:00.123 │        1 │
+│ 2019-01-01 03:00:00.123 │        2 │
 └─────────────────────────┴──────────┘
 ```
 
@@ -91,7 +91,7 @@ SELECT toDateTime64(now(), 3, 'Asia/Istanbul') AS column, toTypeName(column) AS
 
 ``` text
 ┌──────────────────column─┬─x──────────────────────────────┐
-│ 2019-10-16 04:12:04.000 │ DateTime64(3, 'Asia/Istanbul') │
+│ 2023-06-05 00:09:52.000 │ DateTime64(3, 'Asia/Istanbul') │
 └─────────────────────────┴────────────────────────────────┘
 ```
 
@@ -100,13 +100,14 @@ SELECT toDateTime64(now(), 3, 'Asia/Istanbul') AS column, toTypeName(column) AS
 ``` sql
 SELECT
 toDateTime64(timestamp, 3, 'Europe/London') as lon_time,
-toDateTime64(timestamp, 3, 'Asia/Istanbul') as mos_time
+toDateTime64(timestamp, 3, 'Asia/Istanbul') as istanbul_time
 FROM dt;
 ```
 
 ``` text
-┌───────────────lon_time──┬────────────────mos_time─┐
-│ 2019-01-01 00:00:00.000 │ 2019-01-01 03:00:00.000 │
+┌────────────────lon_time─┬───────────istanbul_time─┐
+│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
+│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
 │ 2018-12-31 21:00:00.000 │ 2019-01-01 00:00:00.000 │
 └─────────────────────────┴─────────────────────────┘
 ```
@@ -115,10 +116,9 @@ FROM dt;
 
 - [Type conversion functions](../../sql-reference/functions/type-conversion-functions.md)
 - [Functions for working with dates and times](../../sql-reference/functions/date-time-functions.md)
-- [Functions for working with arrays](../../sql-reference/functions/array-functions.md)
-- [The `date_time_input_format` setting](../../operations/settings/settings.md#settings-date_time_input_format)
-- [The `date_time_output_format` setting](../../operations/settings/settings.md#settings-date_time_output_format)
+- [The `date_time_input_format` setting](../../operations/settings/formats.md#date_time_input_format)
+- [The `date_time_output_format` setting](../../operations/settings/formats.md#date_time_output_format)
 - [The `timezone` server configuration parameter](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
-- [Operators for working with dates and times](../../sql-reference/operators/index.md#operators-datetime)
+- [Operators for working with dates and times](../../sql-reference/operators/index.md#operators-for-working-with-dates-and-times)
 - [`Date` data type](../../sql-reference/data-types/date.md)
 - [`DateTime` data type](../../sql-reference/data-types/datetime.md)

From 136efd68257ccaac503b2e47957803e283165afc Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 18:58:24 -0300
Subject: [PATCH 0357/1478] Update datetime64.md

---
 docs/en/sql-reference/data-types/datetime64.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/data-types/datetime64.md b/docs/en/sql-reference/data-types/datetime64.md
index da3d9dc4f65..793691850b1 100644
--- a/docs/en/sql-reference/data-types/datetime64.md
+++ b/docs/en/sql-reference/data-types/datetime64.md
@@ -116,8 +116,8 @@ FROM dt;
 
 - [Type conversion functions](../../sql-reference/functions/type-conversion-functions.md)
 - [Functions for working with dates and times](../../sql-reference/functions/date-time-functions.md)
-- [The `date_time_input_format` setting](../../operations/settings/formats.md#date_time_input_format)
-- [The `date_time_output_format` setting](../../operations/settings/formats.md#date_time_output_format)
+- [The `date_time_input_format` setting](../../operations/settings/settings-formats.md#date_time_input_format)
+- [The `date_time_output_format` setting](../../operations/settings/settings-formats.md#date_time_output_format)
 - [The `timezone` server configuration parameter](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
 - [Operators for working with dates and times](../../sql-reference/operators/index.md#operators-for-working-with-dates-and-times)
 - [`Date` data type](../../sql-reference/data-types/date.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 0358/1478] 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 0359/1478] 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 e5c95add52ed86c56249fe85d8f7c02132736ae3 Mon Sep 17 00:00:00 2001
From: auxten <auxten@users.noreply.github.com>
Date: Mon, 5 Jun 2023 08:43:55 +0800
Subject: [PATCH 0360/1478] use old_size

Co-authored-by: Alexey Milovidov <milovidov@clickhouse.com>
---
 src/IO/WriteBufferFromVector.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/IO/WriteBufferFromVector.h b/src/IO/WriteBufferFromVector.h
index c793a34b406..a2ecc34f1ab 100644
--- a/src/IO/WriteBufferFromVector.h
+++ b/src/IO/WriteBufferFromVector.h
@@ -86,7 +86,7 @@ private:
         size_t old_size = vector.size();
         /// pos may not be equal to vector.data() + old_size, because WriteBuffer::next() can be used to flush data
         size_t pos_offset = pos - reinterpret_cast<Position>(vector.data());
-        if (pos_offset == vector.size())
+        if (pos_offset == old_size)
         {
             vector.resize(old_size * size_multiplier);
         }

From 4234c4f36addd2607ecc16131ec67ef1089d10ee Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 5 Jun 2023 02:51:11 +0200
Subject: [PATCH 0361/1478] Remove flaky test

---
 tests/integration/test_merge_tree_s3/test.py | 25 --------------------
 1 file changed, 25 deletions(-)

diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index 7730bfcf7b2..2ccd517923a 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -739,31 +739,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_store_cleanup_disk_s3(cluster, node_name):
-    node = cluster.instances[node_name]
-    node.query("DROP TABLE IF EXISTS s3_test SYNC")
-    node.query(
-        "CREATE TABLE s3_test UUID '00000000-1000-4000-8000-000000000001' (n UInt64) Engine=MergeTree() ORDER BY n SETTINGS storage_policy='s3';"
-    )
-    node.query("INSERT INTO s3_test SELECT 1")
-
-    node.stop_clickhouse(kill=True)
-    path_to_data = "/var/lib/clickhouse/"
-    node.exec_in_container(["rm", f"{path_to_data}/metadata/default/s3_test.sql"])
-    node.start_clickhouse()
-
-    node.wait_for_log_line(
-        "Removing unused directory", timeout=90, look_behind_lines=1000
-    )
-    node.wait_for_log_line("directories from store")
-    node.query(
-        "CREATE TABLE s3_test UUID '00000000-1000-4000-8000-000000000001' (n UInt64) Engine=MergeTree() ORDER BY n SETTINGS storage_policy='s3';"
-    )
-    node.query("INSERT INTO s3_test SELECT 1")
-    check_no_objects_after_drop(cluster)
-
-
 @pytest.mark.parametrize("node_name", ["node"])
 def test_cache_setting_compatibility(cluster, node_name):
     node = cluster.instances[node_name]

From 47379ac03965f4834bf6aaa00ce777dec731a3c9 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 5 Jun 2023 03:58:42 +0300
Subject: [PATCH 0362/1478] Update build.sh

---
 docker/packager/binary/build.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/packager/binary/build.sh b/docker/packager/binary/build.sh
index ee1011a9cd5..c0803c74147 100755
--- a/docker/packager/binary/build.sh
+++ b/docker/packager/binary/build.sh
@@ -11,7 +11,7 @@ ccache_status () {
 
 [ -O /build ] || git config --global --add safe.directory /build
 
-if [ "$EXTRACT_TOOLCHAIN_DARWIN" = "1" ];then
+if [ "$EXTRACT_TOOLCHAIN_DARWIN" = "1" ]; then
   mkdir -p /build/cmake/toolchain/darwin-x86_64
   tar xJf /MacOSX11.0.sdk.tar.xz -C /build/cmake/toolchain/darwin-x86_64 --strip-components=1
   ln -sf darwin-x86_64 /build/cmake/toolchain/darwin-aarch64

From 5fc8838b04d37d26207fff488bd60127f9eedaa8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 5 Jun 2023 04:58:29 +0300
Subject: [PATCH 0363/1478] Update KeyCondition.cpp

---
 src/Storages/MergeTree/KeyCondition.cpp | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index 923e5237420..16bd555092e 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -943,6 +943,13 @@ static FieldRef applyFunction(const FunctionBasePtr & func, const DataTypePtr &
     return {field.columns, field.row_idx, result_idx};
 }
 
+/** When table's key has expression with these functions from a column,
+  * and when a column in a query is compared with a constant, such as:
+  * CREATE TABLE (x String) ORDER BY toDate(x)
+  * SELECT ... WHERE x LIKE 'Hello%'
+  * we want to apply the function to the constant for index analysis,
+  * but should modify it to pass on unparseable values.
+  */
 static std::set<std::string_view> date_time_parsing_functions = {
     "toDate",
     "toDate32",

From 3c5bd78856d1848cd457a30c2d8320b3f65a41d9 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 5 Jun 2023 06:13:39 +0200
Subject: [PATCH 0364/1478] Fix typo

---
 src/Storages/MergeTree/KeyCondition.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index ab5820be90a..02ef7e6bebd 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -948,7 +948,7 @@ static FieldRef applyFunction(const FunctionBasePtr & func, const DataTypePtr &
   * CREATE TABLE (x String) ORDER BY toDate(x)
   * SELECT ... WHERE x LIKE 'Hello%'
   * we want to apply the function to the constant for index analysis,
-  * but should modify it to pass on unparseable values.
+  * but should modify it to pass on unparsable values.
   */
 static std::set<std::string_view> date_time_parsing_functions = {
     "toDate",

From c0f162c5b67b112691b8ef805bf2a56060441a0b Mon Sep 17 00:00:00 2001
From: johanngan <johanngan.us@gmail.com>
Date: Fri, 26 May 2023 15:56:40 -0500
Subject: [PATCH 0365/1478] Add dictGetAll function for RegExpTreeDictionary

This function outputs an array of attribute values from all regexp nodes
that matched in a regexp tree dictionary. An optional final argument can
be passed to limit the array size.
---
 docs/en/sql-reference/dictionaries/index.md   |  63 ++++++++-
 .../functions/ext-dict-functions.md           |  78 +++++++++++
 src/Dictionaries/IDictionary.h                |  45 +++++++
 src/Dictionaries/RegExpTreeDictionary.cpp     | 122 +++++++++++++++---
 src/Dictionaries/RegExpTreeDictionary.h       |  49 ++++++-
 .../FunctionsExternalDictionaries.cpp         |  15 +++
 src/Functions/FunctionsExternalDictionaries.h |  77 ++++++++---
 ...04_regexp_dictionary_yaml_source.reference |   6 +
 .../02504_regexp_dictionary_yaml_source.sh    |  48 +++++++
 9 files changed, 459 insertions(+), 44 deletions(-)

diff --git a/docs/en/sql-reference/dictionaries/index.md b/docs/en/sql-reference/dictionaries/index.md
index 43e9300c1ae..6c3d80683db 100644
--- a/docs/en/sql-reference/dictionaries/index.md
+++ b/docs/en/sql-reference/dictionaries/index.md
@@ -2280,7 +2280,7 @@ This config consists of a list of regular expression tree nodes. Each node has t
   - The value of an attribute may contain **back references**, referring to capture groups of the matched regular expression. In the example, the value of attribute `version` in the first node consists of a back-reference `\1` to capture group `(\d+[\.\d]*)` in the regular expression. Back-reference numbers range from 1 to 9 and are written as `$1` or `\1` (for number 1). The back reference is replaced by the matched capture group during query execution.
 - **child nodes**: a list of children of a regexp tree node, each of which has its own attributes and (potentially) children nodes. String matching proceeds in a depth-first fashion. If a string matches a regexp node, the dictionary checks if it also matches the nodes' child nodes. If that is the case, the attributes of the deepest matching node are assigned. Attributes of a child node overwrite equally named attributes of parent nodes. The name of child nodes in YAML files can be arbitrary, e.g. `versions` in above example.
 
-Regexp tree dictionaries only allow access using the functions `dictGet` and `dictGetOrDefault`.
+Regexp tree dictionaries only allow access using the functions `dictGet`, `dictGetOrDefault`, and `dictGetAll`.
 
 Example:
 
@@ -2300,6 +2300,67 @@ In this case, we first match the regular expression `\d+/tclwebkit(?:\d+[\.\d]*)
 
 With a powerful YAML configure file, we can use a regexp tree dictionaries as a user agent string parser. We support [uap-core](https://github.com/ua-parser/uap-core) and demonstrate how to use it in the functional test [02504_regexp_dictionary_ua_parser](https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/02504_regexp_dictionary_ua_parser.sh)
 
+#### Collecting Attribute Values
+
+Sometimes it is useful to return values from multiple regular expressions that matched, rather than just the value of a leaf node. In these cases, the specialized [`dictGetAll`](../../sql-reference/functions/ext-dict-functions.md#dictgetall) function can be used. If a node has an attribute value of type `T`, `dictGetAll` will return an `Array(T)` containing zero or more values.
+
+By default, the number of matches returned per key is unbounded. A bound can be passed as an optional fourth argument to `dictGetAll`. The array is populated in _topological order_, meaning that child nodes come before parent nodes, and sibling nodes follow the ordering in the source.
+
+Example:
+
+```sql
+CREATE DICTIONARY regexp_dict
+(
+    regexp String,
+    tag String,
+    topological_index Int64,
+    captured Nullable(String),
+    parent String
+)
+PRIMARY KEY(regexp)
+SOURCE(YAMLRegExpTree(PATH '/var/lib/clickhouse/user_files/regexp_tree.yaml'))
+LAYOUT(regexp_tree)
+LIFETIME(0)
+```
+
+```yaml
+# /var/lib/clickhouse/user_files/regexp_tree.yaml
+- regexp: 'clickhouse\.com'
+  tag: 'ClickHouse'
+  topological_index: 1
+  paths:
+    - regexp: 'clickhouse\.com/docs(.*)'
+      tag: 'ClickHouse Documentation'
+      topological_index: 0
+      captured: '\1'
+      parent: 'ClickHouse'
+
+- regexp: '/docs(/|$)'
+  tag: 'Documentation'
+  topological_index: 2
+
+- regexp: 'github.com'
+  tag: 'GitHub'
+  topological_index: 3
+  captured: 'NULL'
+```
+
+```sql
+CREATE TABLE urls (url String) ENGINE=MergeTree ORDER BY url;
+INSERT INTO urls VALUES ('clickhouse.com'), ('clickhouse.com/docs/en'), ('github.com/clickhouse/tree/master/docs');
+SELECT url, dictGetAll('regexp_dict', ('tag', 'topological_index', 'captured', 'parent'), url, 2) FROM urls;
+```
+
+Result:
+
+```text
+┌─url────────────────────────────────────┬─dictGetAll('regexp_dict', ('tag', 'topological_index', 'captured', 'parent'), url, 2)─┐
+│ clickhouse.com                         │ (['ClickHouse'],[1],[],[])                                                            │
+│ clickhouse.com/docs/en                 │ (['ClickHouse Documentation','ClickHouse'],[0,1],['/en'],['ClickHouse'])              │
+│ github.com/clickhouse/tree/master/docs │ (['Documentation','GitHub'],[2,3],[NULL],[])                                          │
+└────────────────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────┘
+```
+
 ### Use Regular Expression Tree Dictionary in ClickHouse Cloud
 
 Above used `YAMLRegExpTree` source works in ClickHouse Open Source but not in ClickHouse Cloud. To use regexp tree dictionaries in ClickHouse could, first create a regexp tree dictionary from a YAML file locally in ClickHouse Open Source, then dump this dictionary into a CSV file using the `dictionary` table function and the [INTO OUTFILE](../statements/select/into-outfile.md) clause.
diff --git a/docs/en/sql-reference/functions/ext-dict-functions.md b/docs/en/sql-reference/functions/ext-dict-functions.md
index 7d8aa2c0390..284d6d80405 100644
--- a/docs/en/sql-reference/functions/ext-dict-functions.md
+++ b/docs/en/sql-reference/functions/ext-dict-functions.md
@@ -403,6 +403,84 @@ SELECT dictGetDescendants('hierarchy_flat_dictionary', number, 1) FROM system.nu
 └────────────────────────────────────────────────────────────┘
 ```
 
+
+## dictGetAll
+
+Retrieves the attribute values of all nodes that matched each key in a [regular expression tree dictionary](../../sql-reference/dictionaries/index.md#regexp-tree-dictionary).
+
+Besides returning values of type `Array(T)` instead of `T`, this function behaves similarly to [`dictGet`](#dictget-dictgetordefault-dictgetornull).
+
+**Syntax**
+
+``` sql
+dictGetAll('dict_name', attr_names, id_expr[, limit])
+```
+
+**Arguments**
+
+- `dict_name` — Name of the dictionary. [String literal](../../sql-reference/syntax.md#syntax-string-literal).
+- `attr_names` — Name of the column of the dictionary, [String literal](../../sql-reference/syntax.md#syntax-string-literal), or tuple of column names, [Tuple](../../sql-reference/data-types/tuple.md)([String literal](../../sql-reference/syntax.md#syntax-string-literal)).
+- `id_expr` — Key value. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning array of dictionary key-type value or [Tuple](../../sql-reference/data-types/tuple.md)-type value depending on the dictionary configuration.
+- `limit` - Maximum length for each value array returned. When truncating, child nodes are given precedence over parent nodes, and otherwise the defined list order for the regexp tree dictionary is respected. If unspecified, array length is unlimited.
+
+**Returned value**
+
+- If ClickHouse parses the attribute successfully in the attribute’s data type as defined in the dictionary, returns an array of dictionary attribute values that correspond to `id_expr` for each attribute specified by `attr_names`.
+
+- If there is no key corresponding to `id_expr` in the dictionary, then an empty array is returned.
+
+ClickHouse throws an exception if it cannot parse the value of the attribute or the value does not match the attribute data type.
+
+**Example**
+
+Consider the following regexp tree dictionary:
+
+```sql
+CREATE DICTIONARY regexp_dict
+(
+    regexp String,
+    tag String
+)
+PRIMARY KEY(regexp)
+SOURCE(YAMLRegExpTree(PATH '/var/lib/clickhouse/user_files/regexp_tree.yaml'))
+LAYOUT(regexp_tree)
+...
+```
+
+```yaml
+# /var/lib/clickhouse/user_files/regexp_tree.yaml
+- regexp: 'foo'
+  tag: 'foo_attr'
+- regexp: 'bar'
+  tag: 'bar_attr'
+- regexp: 'baz'
+  tag: 'baz_attr'
+```
+
+Get all matching values:
+
+```sql
+SELECT dictGetAll('regexp_dict', 'tag', 'foobarbaz');
+```
+
+```text
+┌─dictGetAll('regexp_dict', 'tag', 'foobarbaz')─┐
+│ ['foo_attr','bar_attr','baz_attr']            │
+└───────────────────────────────────────────────┘
+```
+
+Get up to 2 matching values:
+
+```sql
+SELECT dictGetAll('regexp_dict', 'tag', 'foobarbaz', 2);
+```
+
+```text
+┌─dictGetAll('regexp_dict', 'tag', 'foobarbaz', 2)─┐
+│ ['foo_attr','bar_attr']                          │
+└──────────────────────────────────────────────────┘
+```
+
 ## Other Functions
 
 ClickHouse supports specialized functions that convert dictionary attribute values to a specific data type regardless of the dictionary configuration.
diff --git a/src/Dictionaries/IDictionary.h b/src/Dictionaries/IDictionary.h
index ee18e8b9a7e..f1834b4b129 100644
--- a/src/Dictionaries/IDictionary.h
+++ b/src/Dictionaries/IDictionary.h
@@ -207,6 +207,51 @@ public:
         return result;
     }
 
+    /**
+     * Analogous to getColumn, but for dictGetAll
+     */
+    virtual ColumnPtr getColumnAllValues(
+        const std::string & attribute_name [[maybe_unused]],
+        const DataTypePtr & result_type [[maybe_unused]],
+        const Columns & key_columns [[maybe_unused]],
+        const DataTypes & key_types [[maybe_unused]],
+        const ColumnPtr & default_values_column [[maybe_unused]],
+        size_t limit [[maybe_unused]]) const
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED,
+                        "Method getColumnAllValues is not supported for {} dictionary.",
+                        getDictionaryID().getNameForLogs());
+    }
+
+    /**
+     * Analogous to getColumns, but for dictGetAll
+     */
+    virtual Columns getColumnsAllValues(
+        const Strings & attribute_names,
+        const DataTypes & result_types,
+        const Columns & key_columns,
+        const DataTypes & key_types,
+        const Columns & default_values_columns,
+        size_t limit) const
+    {
+        size_t attribute_names_size = attribute_names.size();
+
+        Columns result;
+        result.reserve(attribute_names_size);
+
+        for (size_t i = 0; i < attribute_names_size; ++i)
+        {
+            const auto & attribute_name = attribute_names[i];
+            const auto & result_type = result_types[i];
+            const auto & default_values_column = default_values_columns[i];
+
+            result.emplace_back(getColumnAllValues(
+                attribute_name, result_type, key_columns, key_types, default_values_column, limit));
+        }
+
+        return result;
+    }
+
     /** Subclass must validate key columns and key types and return ColumnUInt8 that
       * is bitmask representation of is key in dictionary or not.
       * If key is in dictionary then value of associated row will be 1, otherwise 0.
diff --git a/src/Dictionaries/RegExpTreeDictionary.cpp b/src/Dictionaries/RegExpTreeDictionary.cpp
index 9841cadcdca..8d0af9b0abf 100644
--- a/src/Dictionaries/RegExpTreeDictionary.cpp
+++ b/src/Dictionaries/RegExpTreeDictionary.cpp
@@ -70,7 +70,7 @@ namespace
         explicit StringPiece(int ref_) : ref_num(ref_) {}
     };
 
-    Field parseStringToField(const String & raw, DataTypePtr data_type)
+    Field parseStringToField(const String & raw, const DataTypePtr data_type)
     try
     {
         ReadBufferFromString buffer(raw);
@@ -419,6 +419,65 @@ RegExpTreeDictionary::RegExpTreeDictionary(
     calculateBytesAllocated();
 }
 
+// Thin wrapper around unordered_map<String, Field> that manages the collection of attribute values subject to the
+// behavior specified by collect_values_limit
+class RegExpTreeDictionary::AttributeCollector : public std::unordered_map<String, Field>
+{
+private:
+    std::optional<size_t> collect_values_limit; // std::nullopt means single-value mode, i.e. don't collect
+    size_t n_full_attributes;
+
+public:
+    explicit AttributeCollector(std::optional<size_t> collect_values_limit_)
+        : collect_values_limit(collect_values_limit_), n_full_attributes(0)
+    {
+    }
+
+    constexpr bool collecting() const { return collect_values_limit != std::nullopt; }
+
+    // Add a name-value pair to the collection if there's space
+    void add(const String & attr_name, Field field)
+    {
+        if (collect_values_limit)
+        {
+            if (!this->contains(attr_name))
+                (*this)[attr_name] = Array();
+
+            Array & values = (*this)[attr_name].safeGet<Array &>();
+            if (values.size() < *collect_values_limit)
+            {
+                values.push_back(std::move(field));
+                if (values.size() == *collect_values_limit)
+                    n_full_attributes++;
+            }
+        }
+        else if (!this->contains(attr_name))
+        {
+            (*this)[attr_name] = std::move(field);
+            n_full_attributes++;
+        }
+    }
+
+    // Checks if no more values can be added for a given attribute
+    inline bool full(const String & attr_name) const
+    {
+        if (collect_values_limit)
+        {
+            auto it = this->find(attr_name);
+            if (it == this->end())
+                return false;
+            return it->second.safeGet<const Array &>().size() >= *collect_values_limit;
+        }
+        else
+        {
+            return this->contains(attr_name);
+        }
+    }
+
+    // Returns the number of full attributes
+    inline size_t attributesFull() const { return n_full_attributes; }
+};
+
 std::pair<String, bool> processBackRefs(const String & data, const re2_st::RE2 & searcher, const std::vector<StringPiece> & pieces)
 {
     re2_st::StringPiece haystack(data.data(), data.size());
@@ -442,7 +501,7 @@ std::pair<String, bool> processBackRefs(const String & data, const re2_st::RE2 &
 // The return value means whether we finish collecting.
 bool RegExpTreeDictionary::setAttributes(
     UInt64 id,
-    std::unordered_map<String, Field> & attributes_to_set,
+    AttributeCollector & attributes_to_set,
     const String & data,
     std::unordered_set<UInt64> & visited_nodes,
     const std::unordered_map<String, const DictionaryAttribute &> & attributes,
@@ -451,34 +510,43 @@ bool RegExpTreeDictionary::setAttributes(
 {
 
     if (visited_nodes.contains(id))
-        return attributes_to_set.size() == attributes.size();
+        return attributes_to_set.attributesFull() == attributes.size();
     visited_nodes.emplace(id);
     const auto & node_attributes = regex_nodes.at(id)->attributes;
     for (const auto & [name_, value] : node_attributes)
     {
-        if (!attributes.contains(name_) || attributes_to_set.contains(name_))
+        if (!attributes.contains(name_) || attributes_to_set.full(name_))
             continue;
+
         if (value.containsBackRefs())
         {
             auto [updated_str, use_default] = processBackRefs(data, regex_nodes.at(id)->searcher, value.pieces);
             if (use_default)
             {
-                DefaultValueProvider default_value(attributes.at(name_).null_value, defaults.at(name_));
-                attributes_to_set[name_] = default_value.getDefaultValue(key_index);
+                // Back-ref processing failed.
+                // - If not collecting values, set the default value immediately while we're still on this node.
+                //   Otherwise, a value from a different node could take its place before we set it to the default value post-walk.
+                // - If collecting values, don't add anything. If we find no other matches for this attribute,
+                //   then we'll set its value to the default Array value later.
+                if (!attributes_to_set.collecting())
+                {
+                    DefaultValueProvider default_value(attributes.at(name_).null_value, defaults.at(name_));
+                    attributes_to_set.add(name_, default_value.getDefaultValue(key_index));
+                }
             }
             else
-                attributes_to_set[name_] = parseStringToField(updated_str, attributes.at(name_).type);
+                attributes_to_set.add(name_, parseStringToField(updated_str, attributes.at(name_).type));
         }
         else
-            attributes_to_set[name_] = value.field;
+            attributes_to_set.add(name_, value.field);
     }
 
     auto parent_id = regex_nodes.at(id)->parent_id;
     if (parent_id > 0)
         setAttributes(parent_id, attributes_to_set, data, visited_nodes, attributes, defaults, key_index);
 
-    /// if all the attributes have set, the walking through can be stopped.
-    return attributes_to_set.size() == attributes.size();
+    /// if all attributes are full, we can stop walking the tree
+    return attributes_to_set.attributesFull() == attributes.size();
 }
 
 /// a temp struct to store all the matched result.
@@ -550,7 +618,8 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
     const ColumnString::Chars & keys_data,
     const ColumnString::Offsets & keys_offsets,
     const std::unordered_map<String, const DictionaryAttribute &> & attributes,
-    const std::unordered_map<String, ColumnPtr> & defaults) const
+    const std::unordered_map<String, ColumnPtr> & defaults,
+    std::optional<size_t> collect_values_limit) const
 {
 
 #if USE_VECTORSCAN
@@ -573,7 +642,7 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
     /// initialize columns
     for (const auto & [name_, attr] : attributes)
     {
-        auto col_ptr = attr.type->createColumn();
+        auto col_ptr = (collect_values_limit ? std::make_shared<DataTypeArray>(attr.type) : attr.type)->createColumn();
         col_ptr->reserve(keys_offsets.size());
         columns[name_] = std::move(col_ptr);
     }
@@ -630,11 +699,11 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
 
         match_result.sort();
         /// Walk through the regex tree util all attributes are set;
-        std::unordered_map<String, Field> attributes_to_set;
+        AttributeCollector attributes_to_set{collect_values_limit};
         std::unordered_set<UInt64> visited_nodes;
 
         /// Some node matches but its parents cannot match. In this case we must regard this node unmatched.
-        auto is_invalid = [&](UInt64 id)
+        auto is_valid = [&](UInt64 id)
         {
             while (id)
             {
@@ -650,7 +719,7 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
         for (auto item : match_result.matched_idx_sorted_list)
         {
             UInt64 id = item.second;
-            if (!is_invalid(id))
+            if (!is_valid(id))
                 continue;
             if (visited_nodes.contains(id))
                 continue;
@@ -663,7 +732,8 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
             if (attributes_to_set.contains(name_))
                 continue;
 
-            DefaultValueProvider default_value(attr.null_value, defaults.at(name_));
+            DefaultValueProvider default_value(
+                collect_values_limit ? DataTypeArray(attr.type).getDefault() : attr.null_value, defaults.at(name_));
             columns[name_]->insert(default_value.getDefaultValue(key_idx));
         }
 
@@ -727,12 +797,13 @@ Pipe RegExpTreeDictionary::read(const Names & , size_t max_block_size, size_t) c
     return Pipe(std::make_shared<BlocksListSource>(std::move(result)));
 }
 
-Columns RegExpTreeDictionary::getColumns(
+Columns RegExpTreeDictionary::getColumnsImpl(
     const Strings & attribute_names,
     const DataTypes & result_types,
     const Columns & key_columns,
     const DataTypes & key_types,
-    const Columns & default_values_columns) const
+    const Columns & default_values_columns,
+    std::optional<size_t> collect_values_limit) const
 {
     /// valid check
     if (key_columns.size() != 1)
@@ -746,7 +817,17 @@ Columns RegExpTreeDictionary::getColumns(
 
     for (size_t i = 0; i < attribute_names.size(); i++)
     {
-        const auto & attribute = structure.getAttribute(attribute_names[i], result_types[i]);
+        DataTypePtr attribute_type = result_types[i];
+        if (collect_values_limit)
+        {
+            if (!WhichDataType(attribute_type).isArray())
+                throw Exception(
+                    ErrorCodes::LOGICAL_ERROR, "Expected Array result type for attribute `{}`, got `{}`",
+                    attribute_names[i],
+                    attribute_type->getName());
+            attribute_type = assert_cast<const DataTypeArray &>(*attribute_type).getNestedType();
+        }
+        const auto & attribute = structure.getAttribute(attribute_names[i], attribute_type);
         attributes.emplace(attribute.name, attribute);
         defaults[attribute.name] = default_values_columns[i];
     }
@@ -757,7 +838,8 @@ Columns RegExpTreeDictionary::getColumns(
         key_column->getChars(),
         key_column->getOffsets(),
         attributes,
-        defaults);
+        defaults,
+        collect_values_limit);
 
     Columns result;
     for (const String & name_ : attribute_names)
diff --git a/src/Dictionaries/RegExpTreeDictionary.h b/src/Dictionaries/RegExpTreeDictionary.h
index 683588e688f..30966184eb6 100644
--- a/src/Dictionaries/RegExpTreeDictionary.h
+++ b/src/Dictionaries/RegExpTreeDictionary.h
@@ -101,16 +101,50 @@ public:
         const Columns & key_columns,
         const DataTypes & key_types,
         const ColumnPtr & default_values_column) const override
-        {
-            return getColumns(Strings({attribute_name}), DataTypes({result_type}), key_columns, key_types, Columns({default_values_column}))[0];
-        }
+    {
+        return getColumns(Strings({attribute_name}), DataTypes({result_type}), key_columns, key_types, Columns({default_values_column}))[0];
+    }
 
     Columns getColumns(
         const Strings & attribute_names,
         const DataTypes & result_types,
         const Columns & key_columns,
         const DataTypes & key_types,
-        const Columns & default_values_columns) const override;
+        const Columns & default_values_columns) const override
+    {
+        return getColumnsImpl(attribute_names, result_types, key_columns, key_types, default_values_columns, std::nullopt);
+    }
+
+    ColumnPtr getColumnAllValues(
+        const std::string & attribute_name,
+        const DataTypePtr & result_type,
+        const Columns & key_columns,
+        const DataTypes & key_types,
+        const ColumnPtr & default_values_column,
+        size_t limit) const override
+    {
+        return getColumnsAllValues(
+            Strings({attribute_name}), DataTypes({result_type}), key_columns, key_types, Columns({default_values_column}), limit)[0];
+    }
+
+    Columns getColumnsAllValues(
+        const Strings & attribute_names,
+        const DataTypes & result_types,
+        const Columns & key_columns,
+        const DataTypes & key_types,
+        const Columns & default_values_columns,
+        size_t limit) const override
+    {
+        return getColumnsImpl(attribute_names, result_types, key_columns, key_types, default_values_columns, limit);
+    }
+
+    Columns getColumnsImpl(
+        const Strings & attribute_names,
+        const DataTypes & result_types,
+        const Columns & key_columns,
+        const DataTypes & key_types,
+        const Columns & default_values_columns,
+        std::optional<size_t> collect_values_limit) const;
 
 private:
     const DictionaryStructure structure;
@@ -137,11 +171,14 @@ private:
         const ColumnString::Chars & keys_data,
         const ColumnString::Offsets & keys_offsets,
         const std::unordered_map<String, const DictionaryAttribute &> & attributes,
-        const std::unordered_map<String, ColumnPtr> & defaults) const;
+        const std::unordered_map<String, ColumnPtr> & defaults,
+        std::optional<size_t> collect_values_limit) const;
+
+    class AttributeCollector;
 
     bool setAttributes(
         UInt64 id,
-        std::unordered_map<String, Field> & attributes_to_set,
+        AttributeCollector & attributes_to_set,
         const String & data,
         std::unordered_set<UInt64> & visited_nodes,
         const std::unordered_map<String, const DictionaryAttribute &> & attributes,
diff --git a/src/Functions/FunctionsExternalDictionaries.cpp b/src/Functions/FunctionsExternalDictionaries.cpp
index 70b1e3cc861..9fa08c82d41 100644
--- a/src/Functions/FunctionsExternalDictionaries.cpp
+++ b/src/Functions/FunctionsExternalDictionaries.cpp
@@ -45,11 +45,26 @@ Accepts 3 parameters:
 Returned value: value of the dictionary attribute parsed in the attribute’s data type if key is found, otherwise NULL.
 
 Throws an exception if cannot parse the value of the attribute or the value does not match the attribute data type.
+)" };
+
+    constexpr auto dict_get_all_description { R"(
+Retrieves all values from a dictionary corresponding to the given key values.
+
+Accepts 3 or 4 parameters:
+-- name of the dictionary;
+-- name of the column of the dictionary or tuple of column names;
+-- key value - expression returning dictionary key-type value or tuple-type value - depending on the dictionary configuration;
+-- [optional] maximum number of values to return for each attribute;
+
+Returned value: array of dictionary attribute values parsed in the attribute's data type if key is found, otherwise empty array.
+
+Throws an exception if cannot parse the value of the attribute, the value does not match the attribute data type, or the dictionary doesn't support this function.
 )" };
 
     factory.registerFunction<FunctionDictGetNoType<DictionaryGetFunctionType::get>>(FunctionDocumentation{ .description=fmt::format(dict_get_description, "attribute’s data type") });
     factory.registerFunction<FunctionDictGetNoType<DictionaryGetFunctionType::getOrDefault>>(FunctionDocumentation{ .description=fmt::format(dict_get_or_default_description, "attribute’s data type") });
     factory.registerFunction<FunctionDictGetOrNull>(FunctionDocumentation{ .description=dict_get_or_null_description });
+    factory.registerFunction<FunctionDictGetNoType<DictionaryGetFunctionType::getAll>>(FunctionDocumentation{ .description=dict_get_all_description });
 
     factory.registerFunction<FunctionDictGetUInt8>(FunctionDocumentation{ .description=fmt::format(dict_get_description, "UInt8") });
     factory.registerFunction<FunctionDictGetUInt16>(FunctionDocumentation{ .description=fmt::format(dict_get_description, "UInt16") });
diff --git a/src/Functions/FunctionsExternalDictionaries.h b/src/Functions/FunctionsExternalDictionaries.h
index 97d85f384bc..e4529ff1765 100644
--- a/src/Functions/FunctionsExternalDictionaries.h
+++ b/src/Functions/FunctionsExternalDictionaries.h
@@ -296,7 +296,8 @@ private:
 enum class DictionaryGetFunctionType
 {
     get,
-    getOrDefault
+    getOrDefault,
+    getAll
 };
 
 /// This variant of function derives the result type automatically.
@@ -304,7 +305,10 @@ template <DictionaryGetFunctionType dictionary_get_function_type>
 class FunctionDictGetNoType final : public IFunction
 {
 public:
-    static constexpr auto name = dictionary_get_function_type == DictionaryGetFunctionType::get ? "dictGet" : "dictGetOrDefault";
+    // Kind of gross but we need a static field called "name" for FunctionFactory::registerFunction, and this is the easiest way
+    static constexpr auto name = (dictionary_get_function_type == DictionaryGetFunctionType::get)
+        ? "dictGet"
+        : ((dictionary_get_function_type == DictionaryGetFunctionType::getOrDefault) ? "dictGetOrDefault" : "dictGetAll");
 
     static FunctionPtr create(ContextPtr context)
     {
@@ -321,7 +325,13 @@ public:
 
     bool useDefaultImplementationForConstants() const final { return true; }
     bool useDefaultImplementationForNulls() const final { return false; }
-    ColumnNumbers getArgumentsThatAreAlwaysConstant() const final { return {0, 1}; }
+    ColumnNumbers getArgumentsThatAreAlwaysConstant() const final
+    {
+        if constexpr (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+            return {0, 1, 3};
+        else
+            return {0, 1};
+    }
 
     bool isDeterministic() const override { return false; }
 
@@ -360,6 +370,15 @@ public:
         }
 
         bool key_is_nullable = arguments[2].type->isNullable();
+        if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+        {
+            if (key_is_nullable)
+                throw Exception(ErrorCodes::UNSUPPORTED_METHOD, "Function {} does not support nullable keys", getName());
+
+            // Wrap all the attribute types in Array()
+            for (auto it = attribute_types.begin(); it != attribute_types.end(); ++it)
+                *it = std::make_shared<DataTypeArray>(*it);
+        }
         if (attribute_types.size() > 1)
         {
             if (key_is_nullable)
@@ -424,6 +443,7 @@ public:
         }
 
         Columns default_cols;
+        size_t collect_values_limit = std::numeric_limits<size_t>::max();
 
         if (dictionary_get_function_type == DictionaryGetFunctionType::getOrDefault)
         {
@@ -464,6 +484,19 @@ public:
         }
         else
         {
+            if (dictionary_get_function_type == DictionaryGetFunctionType::getAll && current_arguments_index < arguments.size())
+            {
+                auto limit_col = arguments[current_arguments_index].column;
+                if (!limit_col || !isColumnConst(*limit_col))
+                    throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
+                        "Illegal type {} of fourth argument of function {}. Expected const unsigned integer.",
+                        arguments[current_arguments_index].type->getName(),
+                        getName());
+
+                collect_values_limit = limit_col->getUInt(0);
+                ++current_arguments_index;
+            }
+
             for (size_t i = 0; i < attribute_names.size(); ++i)
                 default_cols.emplace_back(nullptr);
         }
@@ -549,7 +582,8 @@ public:
             attribute_type = attribute_types.front();
         }
 
-        auto result_column = executeDictionaryRequest(dictionary, attribute_names, key_columns, key_types, attribute_type, default_cols);
+        auto result_column = executeDictionaryRequest(
+            dictionary, attribute_names, key_columns, key_types, attribute_type, default_cols, collect_values_limit);
 
         if (key_is_nullable)
             result_column = wrapInNullable(result_column, {arguments[2]}, result_type, input_rows_count);
@@ -565,7 +599,8 @@ private:
         const Columns & key_columns,
         const DataTypes & key_types,
         const DataTypePtr & result_type,
-        const Columns & default_cols) const
+        const Columns & default_cols,
+        size_t collect_values_limit) const
     {
         ColumnPtr result;
 
@@ -573,23 +608,31 @@ private:
         {
             const auto & result_tuple_type = assert_cast<const DataTypeTuple &>(*result_type);
 
-            Columns result_columns = dictionary->getColumns(
-                attribute_names,
-                result_tuple_type.getElements(),
-                key_columns,
-                key_types,
-                default_cols);
+            Columns result_columns;
+            if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+            {
+                result_columns = dictionary->getColumnsAllValues(
+                    attribute_names, result_tuple_type.getElements(), key_columns, key_types, default_cols, collect_values_limit);
+            }
+            else
+            {
+                result_columns
+                    = dictionary->getColumns(attribute_names, result_tuple_type.getElements(), key_columns, key_types, default_cols);
+            }
 
             result = ColumnTuple::create(std::move(result_columns));
         }
         else
         {
-            result = dictionary->getColumn(
-                attribute_names[0],
-                result_type,
-                key_columns,
-                key_types,
-                default_cols.front());
+            if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+            {
+                result = dictionary->getColumnAllValues(
+                    attribute_names[0], result_type, key_columns, key_types, default_cols.front(), collect_values_limit);
+            }
+            else
+            {
+                result = dictionary->getColumn(attribute_names[0], result_type, key_columns, key_types, default_cols.front());
+            }
         }
 
         return result;
diff --git a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
index dfcd170e8f4..437012dd516 100644
--- a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
+++ b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
@@ -5,3 +5,9 @@
 ('BlackBerry WebKit','10.0')
 ('BlackBerry WebKit','1.0')
 (true,'61f0c404-5cb3-11e7-907b-a6006ad3dba0','2023-01-01','2023-01-01 01:01:01',[1,2,3,-1,-2,-3])
+(['ClickHouse'],[1],[],[])
+(['ClickHouse'],[1],[],[])
+(['ClickHouse Documentation','ClickHouse','Documentation'],[0,1,2],['/en'],['ClickHouse'])
+(['ClickHouse Documentation','ClickHouse'],[0,1],['/en'],['ClickHouse'])
+(['Documentation','GitHub'],[2,3],[NULL],[])
+(['Documentation','GitHub'],[2,3],[NULL],[])
diff --git a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
index 1b5a9cdeea4..ac0793460a9 100755
--- a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
+++ b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
@@ -128,9 +128,57 @@ LAYOUT(regexp_tree);
 select dictGet('regexp_dict2', ('col_bool','col_uuid', 'col_date', 'col_datetime', 'col_array'), 'abc');
 "
 
+cat > "$yaml" <<EOL
+- regexp: 'clickhouse\.com'
+  tag: 'ClickHouse'
+  topological_index: 1
+  paths:
+    - regexp: 'clickhouse\.com/docs(.*)'
+      tag: 'ClickHouse Documentation'
+      topological_index: 0
+      captured: '\1'
+      parent: 'ClickHouse'
+
+- regexp: '/docs(/|$)'
+  tag: 'Documentation'
+  topological_index: 2
+
+- regexp: 'github.com'
+  tag: 'GitHub'
+  topological_index: 3
+  captured: 'NULL'
+EOL
+
+# dictGetAll
+$CLICKHOUSE_CLIENT -n --query="
+drop dictionary if exists regexp_dict3;
+create dictionary regexp_dict3
+(
+    regexp String,
+    tag String,
+    topological_index Int64,
+    captured Nullable(String),
+    parent String
+)
+PRIMARY KEY(regexp)
+SOURCE(YAMLRegExpTree(PATH '$yaml'))
+LIFETIME(0)
+LAYOUT(regexp_tree);
+
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'clickhouse.com');
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'clickhouse.com', 2);
+
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'clickhouse.com/docs/en');
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'clickhouse.com/docs/en', 2);
+
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'github.com/clickhouse/tree/master/docs');
+select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'github.com/clickhouse/tree/master/docs', 2);
+"
+
 $CLICKHOUSE_CLIENT -n --query="
 drop dictionary regexp_dict1;
 drop dictionary regexp_dict2;
+drop dictionary regexp_dict3;
 "
 
 rm -rf "$USER_FILES_PATH/test_02504"

From 8d4206df66a8356065fa82168b0a4cb75411cbec Mon Sep 17 00:00:00 2001
From: johanngan <johanngan.us@gmail.com>
Date: Sun, 4 Jun 2023 19:48:14 -0500
Subject: [PATCH 0366/1478] Review comments: Use constexpr-if in more places

Also add a comment about the apparent lack of type checking on the limit
column.
---
 src/Functions/FunctionsExternalDictionaries.h | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/Functions/FunctionsExternalDictionaries.h b/src/Functions/FunctionsExternalDictionaries.h
index e4529ff1765..db6529da73c 100644
--- a/src/Functions/FunctionsExternalDictionaries.h
+++ b/src/Functions/FunctionsExternalDictionaries.h
@@ -370,7 +370,7 @@ public:
         }
 
         bool key_is_nullable = arguments[2].type->isNullable();
-        if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+        if constexpr (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
         {
             if (key_is_nullable)
                 throw Exception(ErrorCodes::UNSUPPORTED_METHOD, "Function {} does not support nullable keys", getName());
@@ -487,6 +487,7 @@ public:
             if (dictionary_get_function_type == DictionaryGetFunctionType::getAll && current_arguments_index < arguments.size())
             {
                 auto limit_col = arguments[current_arguments_index].column;
+                // The getUInt later attempts to cast and throws on a type mismatch, so skip actual type checking here
                 if (!limit_col || !isColumnConst(*limit_col))
                     throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
                         "Illegal type {} of fourth argument of function {}. Expected const unsigned integer.",
@@ -609,7 +610,7 @@ private:
             const auto & result_tuple_type = assert_cast<const DataTypeTuple &>(*result_type);
 
             Columns result_columns;
-            if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+            if constexpr (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
             {
                 result_columns = dictionary->getColumnsAllValues(
                     attribute_names, result_tuple_type.getElements(), key_columns, key_types, default_cols, collect_values_limit);
@@ -624,7 +625,7 @@ private:
         }
         else
         {
-            if (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
+            if constexpr (dictionary_get_function_type == DictionaryGetFunctionType::getAll)
             {
                 result = dictionary->getColumnAllValues(
                     attribute_names[0], result_type, key_columns, key_types, default_cols.front(), collect_values_limit);

From 5e1c93c9c819a1d5819ab742fe4981199c621462 Mon Sep 17 00:00:00 2001
From: johanngan <johanngan.us@gmail.com>
Date: Sun, 4 Jun 2023 21:09:41 -0500
Subject: [PATCH 0367/1478] Add dictGetAll to spell-check dictionary

---
 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 0455556ae96..d6cef1883f4 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1342,6 +1342,7 @@ detectLanguageUnknown
 determinator
 deterministically
 dictGet
+dictGetAll
 dictGetChildren
 dictGetDescendant
 dictGetHierarchy

From f1058d2d9d2201f21882b487499ea4f4212fec0b Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Mon, 5 Jun 2023 09:51:16 +0300
Subject: [PATCH 0368/1478] Revert "Disable skim (Rust library) under memory
 sanitizer"

---
 rust/skim/CMakeLists.txt | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/rust/skim/CMakeLists.txt b/rust/skim/CMakeLists.txt
index c2e406ec12f..1e7a43aba7c 100644
--- a/rust/skim/CMakeLists.txt
+++ b/rust/skim/CMakeLists.txt
@@ -14,11 +14,6 @@ if (OS_FREEBSD)
     return()
 endif()
 
-if (SANITIZE STREQUAL "memory")
-    message(STATUS "skim is disabled under memory sanitizer, because the interop is not instrumented properly")
-    return()
-endif()
-
 clickhouse_import_crate(MANIFEST_PATH Cargo.toml)
 
 # -Wno-dollar-in-identifier-extension: cxx bridge complies names with '$'

From c860db0fb77ad247e39dec10b3419ab1cb2b05e3 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Mon, 5 Jun 2023 10:32:46 +0300
Subject: [PATCH 0369/1478] Fixed tests

---
 src/Functions/if.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Functions/if.cpp b/src/Functions/if.cpp
index 8d43b3a4ca3..65e2212e894 100644
--- a/src/Functions/if.cpp
+++ b/src/Functions/if.cpp
@@ -1124,6 +1124,9 @@ public:
             return {};
 
         const ColumnConst * cond_const_col = checkAndGetColumnConst<ColumnVector<UInt8>>(arg_cond.column.get());
+        if (!cond_const_col)
+            return {};
+
         bool condition_value = cond_const_col->getValue<UInt8>();
 
         const ColumnWithTypeAndName & arg_then = arguments[1];

From 4225cab2e8203b45e17188da28c3f6a1a330878c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 08:34:25 +0000
Subject: [PATCH 0370/1478] Rewrite bugprone shell script command

---
 tests/queries/0_stateless/02771_system_user_processes.sh | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02771_system_user_processes.sh b/tests/queries/0_stateless/02771_system_user_processes.sh
index 910af4be9e2..f0e5b2a6987 100755
--- a/tests/queries/0_stateless/02771_system_user_processes.sh
+++ b/tests/queries/0_stateless/02771_system_user_processes.sh
@@ -7,7 +7,13 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 USER_POSTFIX=`random_str 10`
 USER="test_user_02771_$USER_POSTFIX"
 
-$CLICKHOUSE_CLIENT -q "SHOW USER PROCESSES" &>"${CLICKHOUSE_TMP}/test_output" && echo "SHOW USER PROCESSES query succeeded!" || cat "${CLICKHOUSE_TMP}/test_output" 
+if $CLICKHOUSE_CLIENT -q "SHOW USER PROCESSES" &>"${CLICKHOUSE_TMP}/test_output"
+then
+    echo "SHOW USER PROCESSES query succeeded!"
+else
+    cat "${CLICKHOUSE_TMP}/test_output"
+fi
+
 $CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS $USER"
 $CLICKHOUSE_CLIENT -q "CREATE USER $USER"
 $CLICKHOUSE_CLIENT -u "$USER" -q "SELECT * FROM system.numbers LIMIT 1"

From 3657ef05fffa722115becb7f7e8937a3a472625d Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:26:41 +0000
Subject: [PATCH 0371/1478] Cosmetics: Fix indentation

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h | 30 +++++++++++---------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 3b1a41eb85d..b349c0567ef 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -14,19 +14,23 @@ namespace DB
 // mainly for serialization and deserialization of the index
 namespace ApproximateNearestNeighbour
 {
-    using AnnoyIndexThreadedBuildPolicy = ::Annoy::AnnoyIndexMultiThreadedBuildPolicy;
-    // TODO: Support different metrics. List of available metrics can be taken from here:
-    // https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
-    template <typename Distance>
-    class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>
-    {
-        using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>;
-    public:
-        explicit AnnoyIndex(const uint64_t dim) : Base::AnnoyIndex(dim) {}
-        void serialize(WriteBuffer& ostr) const;
-        void deserialize(ReadBuffer& istr);
-        uint64_t getNumOfDimensions() const;
-    };
+
+using AnnoyIndexThreadedBuildPolicy = ::Annoy::AnnoyIndexMultiThreadedBuildPolicy;
+
+// TODO: Support different metrics. List of available metrics can be taken from here:
+// https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
+template <typename Distance>
+class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>
+{
+    using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>;
+
+public:
+    explicit AnnoyIndex(const uint64_t dim) : Base::AnnoyIndex(dim) {}
+    void serialize(WriteBuffer& ostr) const;
+    void deserialize(ReadBuffer& istr);
+    uint64_t getNumOfDimensions() const;
+};
+
 }
 
 template <typename Distance>

From 32756292309182bfa2ddf59213c1628a22651e26 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:31:34 +0000
Subject: [PATCH 0372/1478] Cosmetics: Remove parentheses in single statement
 if/for/while

---
 src/Storages/MergeTree/CommonANNIndexes.cpp   | 94 -------------------
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 31 +-----
 2 files changed, 4 insertions(+), 121 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 4b360e029e5..f0c6f256f73 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -35,17 +35,11 @@ void extractTargetVectorFromLiteral(ANN::ANNQueryInformation::Embedding & target
     for (const auto & value : literal.value())
     {
         if (value.tryGet(float_element_of_target_vector))
-        {
             target.emplace_back(float_element_of_target_vector);
-        }
         else if (value.tryGet(int_element_of_target_vector))
-        {
             target.emplace_back(static_cast<float>(int_element_of_target_vector));
-        }
         else
-        {
             throw Exception(ErrorCodes::INCORRECT_QUERY, "Wrong type of elements in target vector. Only float or int are supported.");
-        }
     }
 }
 
@@ -74,9 +68,7 @@ ANNCondition::ANNCondition(const SelectQueryInfo & query_info,
 bool ANNCondition::alwaysUnknownOrTrue(String metric_name) const
 {
     if (!index_is_useful)
-    {
         return true; // Query isn't supported
-    }
     // If query is supported, check metrics for match
     return !(castMetricFromStringToType(metric_name) == query_information->metric);
 }
@@ -85,72 +77,56 @@ float ANNCondition::getComparisonDistanceForWhereQuery() const
 {
     if (index_is_useful && query_information.has_value()
         && query_information->query_type == ANNQueryInformation::Type::Where)
-    {
         return query_information->distance;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Not supported method for this query type");
 }
 
 UInt64 ANNCondition::getLimit() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->limit;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "No LIMIT section in query, not supported");
 }
 
 std::vector<float> ANNCondition::getTargetVector() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->target;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Target vector was requested for useless or uninitialized index.");
 }
 
 size_t ANNCondition::getNumOfDimensions() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->target.size();
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Number of dimensions was requested for useless or uninitialized index.");
 }
 
 String ANNCondition::getColumnName() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->column_name;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Column name was requested for useless or uninitialized index.");
 }
 
 ANNQueryInformation::Metric ANNCondition::getMetricType() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->metric;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Metric name was requested for useless or uninitialized index.");
 }
 
 float ANNCondition::getPValueForLpDistance() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->p_for_lp_dist;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "P from LPDistance was requested for useless or uninitialized index.");
 }
 
 ANNQueryInformation::Type ANNCondition::getQueryType() const
 {
     if (index_is_useful && query_information.has_value())
-    {
         return query_information->query_type;
-    }
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Query type was requested for useless or uninitialized index.");
 }
 
@@ -171,24 +147,16 @@ bool ANNCondition::checkQueryStructure(const SelectQueryInfo & query)
     const auto & select = query.query->as<ASTSelectQuery &>();
 
     if (select.prewhere()) // If query has PREWHERE clause
-    {
         traverseAST(select.prewhere(), rpn_prewhere_clause);
-    }
 
     if (select.where()) // If query has WHERE clause
-    {
         traverseAST(select.where(), rpn_where_clause);
-    }
 
     if (select.limitLength()) // If query has LIMIT clause
-    {
         traverseAtomAST(select.limitLength(), rpn_limit);
-    }
 
     if (select.orderBy()) // If query has ORDERBY clause
-    {
         traverseOrderByAST(select.orderBy(), rpn_order_by_clause);
-    }
 
     // Reverse RPNs for conveniences during parsing
     std::reverse(rpn_prewhere_clause.begin(), rpn_prewhere_clause.end());
@@ -203,29 +171,21 @@ bool ANNCondition::checkQueryStructure(const SelectQueryInfo & query)
 
     // Query without a LIMIT clause or with a limit greater than a restriction is not supported
     if (!limit_is_valid || limit_restriction < limit)
-    {
         return false;
-    }
 
     // Search type query in both sections isn't supported
     if (prewhere_is_valid && where_is_valid)
-    {
         return false;
-    }
 
     // Search type should be in WHERE or PREWHERE clause
     if (prewhere_is_valid || where_is_valid)
-    {
         query_information = std::move(prewhere_is_valid ? prewhere_info : where_info);
-    }
 
     if (order_by_is_valid)
     {
         // Query with valid where and order by type is not supported
         if (query_information.has_value())
-        {
             return false;
-        }
 
         query_information = std::move(order_by_info);
     }
@@ -244,17 +204,13 @@ void ANNCondition::traverseAST(const ASTPtr & node, RPN & rpn)
         const ASTs & children = func->arguments->children;
         // Traverse children nodes
         for (const auto& child : children)
-        {
             traverseAST(child, rpn);
-        }
     }
 
     RPNElement element;
     // Get the data behind node
     if (!traverseAtomAST(node, element))
-    {
         element.function = RPNElement::FUNCTION_UNKNOWN;
-    }
 
     rpn.emplace_back(std::move(element));
 }
@@ -273,32 +229,20 @@ bool ANNCondition::traverseAtomAST(const ASTPtr & node, RPNElement & out)
             function->name == "cosineDistance" ||
             function->name == "dotProduct" ||
             function->name == "LpDistance")
-        {
             out.function = RPNElement::FUNCTION_DISTANCE;
-        }
         else if (function->name == "tuple")
-        {
             out.function = RPNElement::FUNCTION_TUPLE;
-        }
         else if (function->name == "array")
-        {
             out.function = RPNElement::FUNCTION_ARRAY;
-        }
         else if (function->name == "less" ||
                  function->name == "greater" ||
                  function->name == "lessOrEquals" ||
                  function->name == "greaterOrEquals")
-        {
             out.function = RPNElement::FUNCTION_COMPARISON;
-        }
         else if (function->name == "_CAST")
-        {
             out.function = RPNElement::FUNCTION_CAST;
-        }
         else
-        {
             return false;
-        }
 
         return true;
     }
@@ -378,12 +322,8 @@ bool ANNCondition::tryCastToConstType(const ASTPtr & node, RPNElement & out)
 void ANNCondition::traverseOrderByAST(const ASTPtr & node, RPN & rpn)
 {
     if (const auto * expr_list = node->as<ASTExpressionList>())
-    {
         if (const auto * order_by_element = expr_list->children.front()->as<ASTOrderByElement>())
-        {
             traverseAST(order_by_element->children.front(), rpn);
-        }
-    }
 }
 
 // Returns true and stores ANNQueryInformation if the query has valid WHERE clause
@@ -395,17 +335,13 @@ bool ANNCondition::matchRPNWhere(RPN & rpn, ANNQueryInformation & expr)
     // WHERE section must have at least 5 expressions
     // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(TargetVector(floats))
     if (rpn.size() < 5)
-    {
         return false;
-    }
 
     auto iter = rpn.begin();
 
     // Query starts from operator less
     if (iter->function != RPNElement::FUNCTION_COMPARISON)
-    {
         return false;
-    }
 
     const bool greater_case = iter->func_name == "greater" || iter->func_name == "greaterOrEquals";
     const bool less_case = iter->func_name == "less" || iter->func_name == "lessOrEquals";
@@ -415,9 +351,7 @@ bool ANNCondition::matchRPNWhere(RPN & rpn, ANNQueryInformation & expr)
     if (less_case)
     {
         if (iter->function != RPNElement::FUNCTION_FLOAT_LITERAL)
-        {
             return false;
-        }
 
         expr.distance = getFloatOrIntLiteralOrPanic(iter);
         if (expr.distance < 0)
@@ -427,22 +361,16 @@ bool ANNCondition::matchRPNWhere(RPN & rpn, ANNQueryInformation & expr)
 
     }
     else if (!greater_case)
-    {
         return false;
-    }
 
     auto end = rpn.end();
     if (!matchMainParts(iter, end, expr))
-    {
         return false;
-    }
 
     if (greater_case)
     {
         if (expr.target.size() < 2)
-        {
             return false;
-        }
         expr.distance = expr.target.back();
         if (expr.distance < 0)
             throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", expr.distance);
@@ -461,9 +389,7 @@ bool ANNCondition::matchRPNOrderBy(RPN & rpn, ANNQueryInformation & expr)
 
     // ORDER BY clause must have at least 3 expressions
     if (rpn.size() < 3)
-    {
         return false;
-    }
 
     auto iter = rpn.begin();
     auto end = rpn.end();
@@ -490,9 +416,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
 
     // Matches DistanceFunc->[Column]->[Tuple(array)Func]->TargetVector(floats)->[Column]
     if (iter->function != RPNElement::FUNCTION_DISTANCE)
-    {
         return false;
-    }
 
     expr.metric = castMetricFromStringToType(iter->func_name);
     ++iter;
@@ -501,9 +425,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
     {
         if (iter->function != RPNElement::FUNCTION_FLOAT_LITERAL &&
             iter->function != RPNElement::FUNCTION_INT_LITERAL)
-        {
             return false;
-        }
         expr.p_for_lp_dist = getFloatOrIntLiteralOrPanic(iter);
         ++iter;
     }
@@ -516,9 +438,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
     }
 
     if (iter->function == RPNElement::FUNCTION_TUPLE || iter->function == RPNElement::FUNCTION_ARRAY)
-    {
         ++iter;
-    }
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
     {
@@ -539,9 +459,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
         ++iter;
         /// Cast should be made to array or tuple
         if (!iter->func_name.starts_with("Array") && !iter->func_name.starts_with("Tuple"))
-        {
             return false;
-        }
         ++iter;
         if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
         {
@@ -554,31 +472,23 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
             ++iter;
         }
         else
-        {
             return false;
-        }
     }
 
     while (iter != end)
     {
         if (iter->function == RPNElement::FUNCTION_FLOAT_LITERAL ||
             iter->function == RPNElement::FUNCTION_INT_LITERAL)
-        {
             expr.target.emplace_back(getFloatOrIntLiteralOrPanic(iter));
-        }
         else if (iter->function == RPNElement::FUNCTION_IDENTIFIER)
         {
             if (identifier_found)
-            {
                 return false;
-            }
             expr.column_name = std::move(iter->identifier.value());
             identifier_found = true;
         }
         else
-        {
             return false;
-        }
 
         ++iter;
     }
@@ -591,13 +501,9 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
 float ANNCondition::getFloatOrIntLiteralOrPanic(const RPN::iterator& iter)
 {
     if (iter->float_literal.has_value())
-    {
         return iter->float_literal.value();
-    }
     if (iter->int_literal.has_value())
-    {
         return static_cast<float>(iter->int_literal.value());
-    }
     throw Exception(ErrorCodes::INCORRECT_QUERY, "Wrong parsed AST in buildRPN\n");
 }
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index f64d6104ac6..0b7e1f29f03 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -219,17 +219,11 @@ bool MergeTreeIndexConditionAnnoy::alwaysUnknownOrTrue() const
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const
 {
     if (distance_name == "L2Distance")
-    {
         return getUsefulRangesImpl<::Annoy::Euclidean>(idx_granule);
-    }
     else if (distance_name == "cosineDistance")
-    {
         return getUsefulRangesImpl<::Annoy::Angular>(idx_granule);
-    }
     else
-    {
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
-    }
 }
 
 
@@ -297,26 +291,18 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
 {
     if (distance_name == "L2Distance")
-    {
         return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Euclidean> >(index.name, index.sample_block);
-    }
-    if (distance_name == "cosineDistance")
-    {
+    else if (distance_name == "cosineDistance")
         return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Angular> >(index.name, index.sample_block);
-    }
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
 MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 {
     if (distance_name == "L2Distance")
-    {
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean> >(index.name, index.sample_block, number_of_trees);
-    }
     if (distance_name == "cosineDistance")
-    {
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular> >(index.name, index.sample_block, number_of_trees);
-    }
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
@@ -331,16 +317,10 @@ MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
     uint64_t param = 100;
     String distance_name = "L2Distance";
     if (!index.arguments.empty() && !index.arguments[0].tryGet<uint64_t>(param))
-    {
         if (!index.arguments[0].tryGet<String>(distance_name))
-        {
             throw Exception(ErrorCodes::INCORRECT_DATA, "Can't parse first argument");
-        }
-    }
     if (index.arguments.size() > 1 && !index.arguments[1].tryGet<String>(distance_name))
-    {
         throw Exception(ErrorCodes::INCORRECT_DATA, "Can't parse second argument");
-    }
     return std::make_shared<MergeTreeIndexAnnoy>(index, param, distance_name);
 }
 
@@ -381,18 +361,14 @@ static void assertIndexColumnsType(const Block & header)
 void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 {
     if (index.arguments.size() > 2)
-    {
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index must not have more than two parameters");
-    }
+
     if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::UInt64
         && index.arguments[0].getType() != Field::Types::String)
-    {
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String.");
-    }
+
     if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::String)
-    {
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String.");
-    }
 
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
@@ -401,4 +377,5 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 }
 
 }
+
 #endif // ENABLE_ANNOY

From edad92a7f224732c52f9d57d062e46c23396d19a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:36:27 +0000
Subject: [PATCH 0373/1478] Cosmetics: Minor aesthetic fixes

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 45 ++++++++++---------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  | 20 +++------
 2 files changed, 30 insertions(+), 35 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 0b7e1f29f03..b31779ff71c 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -18,10 +18,10 @@ namespace DB
 namespace ApproximateNearestNeighbour
 {
 
-template<typename Dist>
-void AnnoyIndex<Dist>::serialize(WriteBuffer& ostr) const
+template<typename Distance>
+void AnnoyIndex<Distance>::serialize(WriteBuffer& ostr) const
 {
-    assert(Base::_built);
+    chassert(Base::_built);
     writeIntBinary(Base::_s, ostr);
     writeIntBinary(Base::_n_items, ostr);
     writeIntBinary(Base::_n_nodes, ostr);
@@ -32,10 +32,10 @@ void AnnoyIndex<Dist>::serialize(WriteBuffer& ostr) const
     ostr.write(reinterpret_cast<const char*>(Base::_nodes), Base::_s * Base::_n_nodes);
 }
 
-template<typename Dist>
-void AnnoyIndex<Dist>::deserialize(ReadBuffer& istr)
+template<typename Distance>
+void AnnoyIndex<Distance>::deserialize(ReadBuffer& istr)
 {
-    assert(!Base::_built);
+    chassert(!Base::_built);
     readIntBinary(Base::_s, istr);
     readIntBinary(Base::_n_items, istr);
     readIntBinary(Base::_n_nodes, istr);
@@ -54,8 +54,8 @@ void AnnoyIndex<Dist>::deserialize(ReadBuffer& istr)
     Base::_built = true;
 }
 
-template<typename Dist>
-uint64_t AnnoyIndex<Dist>::getNumOfDimensions() const
+template<typename Distance>
+uint64_t AnnoyIndex<Distance>::getNumOfDimensions() const
 {
     return Base::get_f();
 }
@@ -84,16 +84,16 @@ template <typename Distance>
 MergeTreeIndexGranuleAnnoy<Distance>::MergeTreeIndexGranuleAnnoy(
     const String & index_name_,
     const Block & index_sample_block_,
-    AnnoyIndexPtr index_base_)
+    AnnoyIndexPtr index_)
     : index_name(index_name_)
     , index_sample_block(index_sample_block_)
-    , index(std::move(index_base_))
+    , index(std::move(index_))
 {}
 
 template <typename Distance>
 void MergeTreeIndexGranuleAnnoy<Distance>::serializeBinary(WriteBuffer & ostr) const
 {
-    /// number of dimensions is required in the constructor,
+    /// 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
     index->serialize(ostr);
@@ -123,7 +123,7 @@ MergeTreeIndexGranulePtr MergeTreeIndexAggregatorAnnoy<Distance>::getGranuleAndR
 {
     // NOLINTNEXTLINE(*)
     index->build(static_cast<int>(number_of_trees), /*number_of_threads=*/1);
-    auto granule = std::make_shared<MergeTreeIndexGranuleAnnoy<Distance> >(index_name, index_sample_block, index);
+    auto granule = std::make_shared<MergeTreeIndexGranuleAnnoy<Distance>>(index_name, index_sample_block, index);
     index = nullptr;
     return granule;
 }
@@ -202,7 +202,8 @@ MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     const SelectQueryInfo & query,
     ContextPtr context,
     const String& distance_name_)
-    : condition(query, context), distance_name(distance_name_)
+    : condition(query, context)
+    , distance_name(distance_name_)
 {}
 
 
@@ -232,15 +233,16 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 {
     UInt64 limit = condition.getLimit();
     UInt64 index_granularity = condition.getIndexGranularity();
-    std::optional<float> comp_dist = condition.getQueryType() == ApproximateNearestNeighbour::ANNQueryInformation::Type::Where ?
-     std::optional<float>(condition.getComparisonDistanceForWhereQuery()) : std::nullopt;
+    std::optional<float> comp_dist = condition.getQueryType() == ApproximateNearestNeighbour::ANNQueryInformation::Type::Where
+        ? std::optional<float>(condition.getComparisonDistanceForWhereQuery())
+        : std::nullopt;
 
     if (comp_dist && comp_dist.value() < 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to optimize query with where without distance");
 
     std::vector<float> target_vec = condition.getTargetVector();
 
-    auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance> >(idx_granule);
+    auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance>>(idx_granule);
     if (granule == nullptr)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Granule has the wrong type");
 
@@ -291,18 +293,19 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
 {
     if (distance_name == "L2Distance")
-        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Euclidean> >(index.name, index.sample_block);
+        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block);
     else if (distance_name == "cosineDistance")
-        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Angular> >(index.name, index.sample_block);
+        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Angular>>(index.name, index.sample_block);
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
 MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 {
+    /// TODO: Support more metrics. Available metrics: https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
     if (distance_name == "L2Distance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean> >(index.name, index.sample_block, number_of_trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block, number_of_trees);
     if (distance_name == "cosineDistance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular> >(index.name, index.sample_block, number_of_trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular>>(index.name, index.sample_block, number_of_trees);
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
@@ -378,4 +381,4 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 
 }
 
-#endif // ENABLE_ANNOY
+#endif
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index b349c0567ef..d591187fc64 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -15,17 +15,13 @@ namespace DB
 namespace ApproximateNearestNeighbour
 {
 
-using AnnoyIndexThreadedBuildPolicy = ::Annoy::AnnoyIndexMultiThreadedBuildPolicy;
-
-// TODO: Support different metrics. List of available metrics can be taken from here:
-// https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
 template <typename Distance>
-class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>
+class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>
 {
-    using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, AnnoyIndexThreadedBuildPolicy>;
+    using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
 
 public:
-    explicit AnnoyIndex(const uint64_t dim) : Base::AnnoyIndex(dim) {}
+    explicit AnnoyIndex(uint64_t dim) : Base::AnnoyIndex(dim) {}
     void serialize(WriteBuffer& ostr) const;
     void deserialize(ReadBuffer& istr);
     uint64_t getNumOfDimensions() const;
@@ -40,10 +36,7 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
     using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
 
     MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_);
-    MergeTreeIndexGranuleAnnoy(
-        const String & index_name_,
-        const Block & index_sample_block_,
-        AnnoyIndexPtr index_base_);
+    MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_, AnnoyIndexPtr index_);
 
     ~MergeTreeIndexGranuleAnnoy() override = default;
 
@@ -118,8 +111,7 @@ public:
     MergeTreeIndexGranulePtr createIndexGranule() const override;
     MergeTreeIndexAggregatorPtr createIndexAggregator() const override;
 
-    MergeTreeIndexConditionPtr createIndexCondition(
-        const SelectQueryInfo & query, ContextPtr context) const override;
+    MergeTreeIndexConditionPtr createIndexCondition(const SelectQueryInfo & query, ContextPtr context) const override;
 
     bool mayBenefitFromIndexForIn(const ASTPtr & /*node*/) const override { return false; }
 
@@ -131,4 +123,4 @@ private:
 
 }
 
-#endif // ENABLE_ANNOY
+#endif

From 1018677f464756f0fcb4a1c26e7143e07d30dfe7 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:39:04 +0000
Subject: [PATCH 0374/1478] Cosmetics: Move ctors into cpp file

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 12 ++++++++++++
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   |  8 ++------
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index b31779ff71c..e82f279c412 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -18,6 +18,12 @@ namespace DB
 namespace ApproximateNearestNeighbour
 {
 
+template <typename Distance>
+AnnoyIndex<Distance>::AnnoyIndex(uint64_t dim)
+    : Base::AnnoyIndex(dim)
+{
+}
+
 template<typename Distance>
 void AnnoyIndex<Distance>::serialize(WriteBuffer& ostr) const
 {
@@ -290,6 +296,12 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     return result_vector;
 }
 
+MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t number_of_trees_, const String& distance_name_)
+    : IMergeTreeIndex(index_)
+    , number_of_trees(number_of_trees_)
+    , distance_name(distance_name_)
+{}
+
 MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
 {
     if (distance_name == "L2Distance")
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index d591187fc64..2ccb3527b18 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -21,7 +21,7 @@ class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy
     using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
 
 public:
-    explicit AnnoyIndex(uint64_t dim) : Base::AnnoyIndex(dim) {}
+    explicit AnnoyIndex(uint64_t dim);
     void serialize(WriteBuffer& ostr) const;
     void deserialize(ReadBuffer& istr);
     uint64_t getNumOfDimensions() const;
@@ -100,11 +100,7 @@ class MergeTreeIndexAnnoy : public IMergeTreeIndex
 {
 public:
 
-    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t number_of_trees_, const String& distance_name_)
-        : IMergeTreeIndex(index_)
-        , number_of_trees(number_of_trees_)
-        , distance_name(distance_name_)
-    {}
+    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t number_of_trees_, const String& distance_name_);
 
     ~MergeTreeIndexAnnoy() override = default;
 

From 4631595cf658ae007e70b563a4631b2a95fd2439 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:44:20 +0000
Subject: [PATCH 0375/1478] Cosmetics: number_of_trees --> trees

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 14 +++++++-------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   |  8 ++++----
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index e82f279c412..946889066b1 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -118,17 +118,17 @@ template <typename Distance>
 MergeTreeIndexAggregatorAnnoy<Distance>::MergeTreeIndexAggregatorAnnoy(
     const String & index_name_,
     const Block & index_sample_block_,
-    uint64_t number_of_trees_)
+    uint64_t trees_)
     : index_name(index_name_)
     , index_sample_block(index_sample_block_)
-    , number_of_trees(number_of_trees_)
+    , trees(trees_)
 {}
 
 template <typename Distance>
 MergeTreeIndexGranulePtr MergeTreeIndexAggregatorAnnoy<Distance>::getGranuleAndReset()
 {
     // NOLINTNEXTLINE(*)
-    index->build(static_cast<int>(number_of_trees), /*number_of_threads=*/1);
+    index->build(static_cast<int>(trees), /*number_of_threads=*/1);
     auto granule = std::make_shared<MergeTreeIndexGranuleAnnoy<Distance>>(index_name, index_sample_block, index);
     index = nullptr;
     return granule;
@@ -296,9 +296,9 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     return result_vector;
 }
 
-MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t number_of_trees_, const String& distance_name_)
+MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String& distance_name_)
     : IMergeTreeIndex(index_)
-    , number_of_trees(number_of_trees_)
+    , trees(trees_)
     , distance_name(distance_name_)
 {}
 
@@ -315,9 +315,9 @@ MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 {
     /// TODO: Support more metrics. Available metrics: https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
     if (distance_name == "L2Distance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block, number_of_trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block, trees);
     if (distance_name == "cosineDistance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular>>(index.name, index.sample_block, number_of_trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular>>(index.name, index.sample_block, trees);
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 2ccb3527b18..2c41cf457ce 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -56,7 +56,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
     using AnnoyIndex = ApproximateNearestNeighbour::AnnoyIndex<Distance>;
     using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
 
-    MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, uint64_t number_of_trees);
+    MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, uint64_t trees);
     ~MergeTreeIndexAggregatorAnnoy() override = default;
 
     bool empty() const override { return !index || index->get_n_items() == 0; }
@@ -65,7 +65,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 
     String index_name;
     Block index_sample_block;
-    const uint64_t number_of_trees;
+    const uint64_t trees;
     AnnoyIndexPtr index;
 };
 
@@ -100,7 +100,7 @@ class MergeTreeIndexAnnoy : public IMergeTreeIndex
 {
 public:
 
-    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t number_of_trees_, const String& distance_name_);
+    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String& distance_name_);
 
     ~MergeTreeIndexAnnoy() override = default;
 
@@ -112,7 +112,7 @@ public:
     bool mayBenefitFromIndexForIn(const ASTPtr & /*node*/) const override { return false; }
 
 private:
-    const uint64_t number_of_trees;
+    const uint64_t trees;
     const String distance_name;
 };
 

From a8bf7af2918bf3101600cec4465c20e3a3faec0b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:47:05 +0000
Subject: [PATCH 0376/1478] Cosmetics: Move ErrorCodes to top

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 946889066b1..54df6f46ef2 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -15,6 +15,16 @@
 namespace DB
 {
 
+namespace ErrorCodes
+{
+    extern const int ILLEGAL_COLUMN;
+    extern const int INCORRECT_DATA;
+    extern const int INCORRECT_NUMBER_OF_COLUMNS;
+    extern const int INCORRECT_QUERY;
+    extern const int LOGICAL_ERROR;
+    extern const int BAD_ARGUMENTS;
+}
+
 namespace ApproximateNearestNeighbour
 {
 
@@ -69,16 +79,6 @@ uint64_t AnnoyIndex<Distance>::getNumOfDimensions() const
 }
 
 
-namespace ErrorCodes
-{
-    extern const int ILLEGAL_COLUMN;
-    extern const int INCORRECT_DATA;
-    extern const int INCORRECT_NUMBER_OF_COLUMNS;
-    extern const int INCORRECT_QUERY;
-    extern const int LOGICAL_ERROR;
-    extern const int BAD_ARGUMENTS;
-}
-
 template <typename Distance>
 MergeTreeIndexGranuleAnnoy<Distance>::MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_)
     : index_name(index_name_)

From f8c1f2bd33898e2fbc1bb4a963458a781778f722 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:48:12 +0000
Subject: [PATCH 0377/1478] Cosmetics: Remove absolute namespace qualification
 of Annoy library internals

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 54df6f46ef2..716624b7453 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -226,9 +226,9 @@ bool MergeTreeIndexConditionAnnoy::alwaysUnknownOrTrue() const
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const
 {
     if (distance_name == "L2Distance")
-        return getUsefulRangesImpl<::Annoy::Euclidean>(idx_granule);
+        return getUsefulRangesImpl<Annoy::Euclidean>(idx_granule);
     else if (distance_name == "cosineDistance")
-        return getUsefulRangesImpl<::Annoy::Angular>(idx_granule);
+        return getUsefulRangesImpl<Annoy::Angular>(idx_granule);
     else
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
@@ -305,9 +305,9 @@ MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64
 MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
 {
     if (distance_name == "L2Distance")
-        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block);
+        return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Euclidean>>(index.name, index.sample_block);
     else if (distance_name == "cosineDistance")
-        return std::make_shared<MergeTreeIndexGranuleAnnoy<::Annoy::Angular>>(index.name, index.sample_block);
+        return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Angular>>(index.name, index.sample_block);
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 
@@ -315,9 +315,9 @@ MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 {
     /// TODO: Support more metrics. Available metrics: https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
     if (distance_name == "L2Distance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Euclidean>>(index.name, index.sample_block, trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Euclidean>>(index.name, index.sample_block, trees);
     if (distance_name == "cosineDistance")
-        return std::make_shared<MergeTreeIndexAggregatorAnnoy<::Annoy::Angular>>(index.name, index.sample_block, trees);
+        return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Angular>>(index.name, index.sample_block, trees);
     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
 }
 

From e373cf682ade101bcc2fd288263e547690834ff8 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:50:59 +0000
Subject: [PATCH 0378/1478] Cosmetics: Unwrap Annoy index from nested namespace

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp |  4 ----
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   | 11 ++---------
 2 files changed, 2 insertions(+), 13 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 716624b7453..cbeb6540721 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -25,8 +25,6 @@ namespace ErrorCodes
     extern const int BAD_ARGUMENTS;
 }
 
-namespace ApproximateNearestNeighbour
-{
 
 template <typename Distance>
 AnnoyIndex<Distance>::AnnoyIndex(uint64_t dim)
@@ -76,8 +74,6 @@ uint64_t AnnoyIndex<Distance>::getNumOfDimensions() const
     return Base::get_f();
 }
 
-}
-
 
 template <typename Distance>
 MergeTreeIndexGranuleAnnoy<Distance>::MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_)
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 2c41cf457ce..44f5f8d8eb7 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -10,11 +10,6 @@
 namespace DB
 {
 
-// auxiliary namespace for working with spotify-annoy library
-// mainly for serialization and deserialization of the index
-namespace ApproximateNearestNeighbour
-{
-
 template <typename Distance>
 class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>
 {
@@ -27,12 +22,10 @@ public:
     uint64_t getNumOfDimensions() const;
 };
 
-}
-
 template <typename Distance>
 struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 {
-    using AnnoyIndex = ApproximateNearestNeighbour::AnnoyIndex<Distance>;
+    using AnnoyIndex = AnnoyIndex<Distance>;
     using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
 
     MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_);
@@ -53,7 +46,7 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 template <typename Distance>
 struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 {
-    using AnnoyIndex = ApproximateNearestNeighbour::AnnoyIndex<Distance>;
+    using AnnoyIndex = AnnoyIndex<Distance>;
     using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
 
     MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, uint64_t trees);

From dc88d4e7422e9b0c19873297a9b7e2d3107ed052 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:53:07 +0000
Subject: [PATCH 0379/1478] Cosmetics: Factorize repeated typedefs into a
 single typedef

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp |  8 ++++----
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   | 15 ++++++---------
 2 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index cbeb6540721..58c59028075 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -86,7 +86,7 @@ template <typename Distance>
 MergeTreeIndexGranuleAnnoy<Distance>::MergeTreeIndexGranuleAnnoy(
     const String & index_name_,
     const Block & index_sample_block_,
-    AnnoyIndexPtr index_)
+    AnnoyIndexPtr<Distance> index_)
     : index_name(index_name_)
     , index_sample_block(index_sample_block_)
     , index(std::move(index_))
@@ -106,7 +106,7 @@ void MergeTreeIndexGranuleAnnoy<Distance>::deserializeBinary(ReadBuffer & istr,
 {
     uint64_t dimension;
     readIntBinary(dimension, istr);
-    index = std::make_shared<AnnoyIndex>(dimension);
+    index = std::make_shared<AnnoyIndex<Distance>>(dimension);
     index->deserialize(istr);
 }
 
@@ -164,7 +164,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
             if (offsets[i + 1] - offsets[i] != size)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "Arrays should have same length");
 
-        index = std::make_shared<AnnoyIndex>(size);
+        index = std::make_shared<AnnoyIndex<Distance>>(size);
 
         index->add_item(index->get_n_items(), array.data());
         /// add all rows from 1 to num_rows - 1 (this is the same as the beginning of the last element)
@@ -190,7 +190,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         }
         assert(!data.empty());
         if (!index)
-            index = std::make_shared<AnnoyIndex>(data[0].size());
+            index = std::make_shared<AnnoyIndex<Distance>>(data[0].size());
         for (const auto& item : data)
             index->add_item(index->get_n_items(), item.data());
     }
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 44f5f8d8eb7..bb0d1883fc2 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -22,14 +22,14 @@ public:
     uint64_t getNumOfDimensions() const;
 };
 
+template <typename Distance>
+using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex<Distance>>;
+
 template <typename Distance>
 struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 {
-    using AnnoyIndex = AnnoyIndex<Distance>;
-    using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
-
     MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_);
-    MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_, AnnoyIndexPtr index_);
+    MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_, AnnoyIndexPtr<Distance> index_);
 
     ~MergeTreeIndexGranuleAnnoy() override = default;
 
@@ -40,15 +40,12 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 
     String index_name;
     Block index_sample_block;
-    AnnoyIndexPtr index;
+    AnnoyIndexPtr<Distance> index;
 };
 
 template <typename Distance>
 struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 {
-    using AnnoyIndex = AnnoyIndex<Distance>;
-    using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex>;
-
     MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, uint64_t trees);
     ~MergeTreeIndexAggregatorAnnoy() override = default;
 
@@ -59,7 +56,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
     String index_name;
     Block index_sample_block;
     const uint64_t trees;
-    AnnoyIndexPtr index;
+    AnnoyIndexPtr<Distance> index;
 };
 
 

From 594572b0de48f7bd3be39f3abcb057f708b7fcf9 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 19:55:01 +0000
Subject: [PATCH 0380/1478] Cosmetics: AnnoyIndex -->
 AnnoyIndexWithSerialization

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 16 ++++++++--------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   | 12 ++++++------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 58c59028075..60b9efcaf67 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -27,13 +27,13 @@ namespace ErrorCodes
 
 
 template <typename Distance>
-AnnoyIndex<Distance>::AnnoyIndex(uint64_t dim)
+AnnoyIndexWithSerialization<Distance>::AnnoyIndexWithSerialization(uint64_t dim)
     : Base::AnnoyIndex(dim)
 {
 }
 
 template<typename Distance>
-void AnnoyIndex<Distance>::serialize(WriteBuffer& ostr) const
+void AnnoyIndexWithSerialization<Distance>::serialize(WriteBuffer& ostr) const
 {
     chassert(Base::_built);
     writeIntBinary(Base::_s, ostr);
@@ -47,7 +47,7 @@ void AnnoyIndex<Distance>::serialize(WriteBuffer& ostr) const
 }
 
 template<typename Distance>
-void AnnoyIndex<Distance>::deserialize(ReadBuffer& istr)
+void AnnoyIndexWithSerialization<Distance>::deserialize(ReadBuffer& istr)
 {
     chassert(!Base::_built);
     readIntBinary(Base::_s, istr);
@@ -69,7 +69,7 @@ void AnnoyIndex<Distance>::deserialize(ReadBuffer& istr)
 }
 
 template<typename Distance>
-uint64_t AnnoyIndex<Distance>::getNumOfDimensions() const
+uint64_t AnnoyIndexWithSerialization<Distance>::getNumOfDimensions() const
 {
     return Base::get_f();
 }
@@ -86,7 +86,7 @@ template <typename Distance>
 MergeTreeIndexGranuleAnnoy<Distance>::MergeTreeIndexGranuleAnnoy(
     const String & index_name_,
     const Block & index_sample_block_,
-    AnnoyIndexPtr<Distance> index_)
+    AnnoyIndexWithSerializationPtr<Distance> index_)
     : index_name(index_name_)
     , index_sample_block(index_sample_block_)
     , index(std::move(index_))
@@ -106,7 +106,7 @@ void MergeTreeIndexGranuleAnnoy<Distance>::deserializeBinary(ReadBuffer & istr,
 {
     uint64_t dimension;
     readIntBinary(dimension, istr);
-    index = std::make_shared<AnnoyIndex<Distance>>(dimension);
+    index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(dimension);
     index->deserialize(istr);
 }
 
@@ -164,7 +164,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
             if (offsets[i + 1] - offsets[i] != size)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "Arrays should have same length");
 
-        index = std::make_shared<AnnoyIndex<Distance>>(size);
+        index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(size);
 
         index->add_item(index->get_n_items(), array.data());
         /// add all rows from 1 to num_rows - 1 (this is the same as the beginning of the last element)
@@ -190,7 +190,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         }
         assert(!data.empty());
         if (!index)
-            index = std::make_shared<AnnoyIndex<Distance>>(data[0].size());
+            index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(data[0].size());
         for (const auto& item : data)
             index->add_item(index->get_n_items(), item.data());
     }
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index bb0d1883fc2..c5520ab5673 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -11,25 +11,25 @@ namespace DB
 {
 
 template <typename Distance>
-class AnnoyIndex : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>
+class AnnoyIndexWithSerialization : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>
 {
     using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
 
 public:
-    explicit AnnoyIndex(uint64_t dim);
+    explicit AnnoyIndexWithSerialization(uint64_t dim);
     void serialize(WriteBuffer& ostr) const;
     void deserialize(ReadBuffer& istr);
     uint64_t getNumOfDimensions() const;
 };
 
 template <typename Distance>
-using AnnoyIndexPtr = std::shared_ptr<AnnoyIndex<Distance>>;
+using AnnoyIndexWithSerializationPtr = std::shared_ptr<AnnoyIndexWithSerialization<Distance>>;
 
 template <typename Distance>
 struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 {
     MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_);
-    MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_, AnnoyIndexPtr<Distance> index_);
+    MergeTreeIndexGranuleAnnoy(const String & index_name_, const Block & index_sample_block_, AnnoyIndexWithSerializationPtr<Distance> index_);
 
     ~MergeTreeIndexGranuleAnnoy() override = default;
 
@@ -40,7 +40,7 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 
     String index_name;
     Block index_sample_block;
-    AnnoyIndexPtr<Distance> index;
+    AnnoyIndexWithSerializationPtr<Distance> index;
 };
 
 template <typename Distance>
@@ -56,7 +56,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
     String index_name;
     Block index_sample_block;
     const uint64_t trees;
-    AnnoyIndexPtr<Distance> index;
+    AnnoyIndexWithSerializationPtr<Distance> index;
 };
 
 

From c5ededdc5badab8fd18c6a321008157f2d1bbad5 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:03:51 +0000
Subject: [PATCH 0381/1478] Cosmetics: Switch arguments in MTIConditionAnnoy
 ctor

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 6 +++---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 60b9efcaf67..b7346e540d2 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -202,8 +202,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
 MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     const IndexDescription & /*index*/,
     const SelectQueryInfo & query,
-    ContextPtr context,
-    const String& distance_name_)
+    const String& distance_name_,
+    ContextPtr context)
     : condition(query, context)
     , distance_name(distance_name_)
 {}
@@ -320,7 +320,7 @@ MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(
     const SelectQueryInfo & query, ContextPtr context) const
 {
-    return std::make_shared<MergeTreeIndexConditionAnnoy>(index, query, context, distance_name);
+    return std::make_shared<MergeTreeIndexConditionAnnoy>(index, query, distance_name, context);
 };
 
 MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index c5520ab5673..9ebaa335542 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -66,8 +66,8 @@ public:
     MergeTreeIndexConditionAnnoy(
         const IndexDescription & index,
         const SelectQueryInfo & query,
-        ContextPtr context,
-        const String& distance_name);
+        const String& distance_name,
+        ContextPtr context);
 
     bool alwaysUnknownOrTrue() const override;
 

From 3b77e4090221b9977fc98bef1e7fac5cf035eb6a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:05:25 +0000
Subject: [PATCH 0382/1478] Cosmetics: Remove dots from exception messages

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index b7346e540d2..e13ea91e56c 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -345,7 +345,7 @@ static void assertIndexColumnsType(const Block & header)
         if (!WhichDataType(nested_type_index).isFloat32())
             throw Exception(
                 ErrorCodes::ILLEGAL_COLUMN,
-                "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported.",
+                "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
                 column_data_type_ptr->getName());
     }
     else if (const auto * tuple_type = typeid_cast<const DataTypeTuple *>(column_data_type_ptr.get()))
@@ -357,14 +357,14 @@ static void assertIndexColumnsType(const Block & header)
             if (!WhichDataType(nested_type_index).isFloat32())
                 throw Exception(
                     ErrorCodes::ILLEGAL_COLUMN,
-                    "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported.",
+                    "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
                     column_data_type_ptr->getName());
         }
     }
     else
         throw Exception(
             ErrorCodes::ILLEGAL_COLUMN,
-            "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported.",
+            "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
             column_data_type_ptr->getName());
 
 }
@@ -376,10 +376,10 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 
     if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::UInt64
         && index.arguments[0].getType() != Field::Types::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String.");
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String");
 
     if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String.");
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String");
 
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");

From 423f69228239503b420153054a7c878b14aa2f47 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:07:43 +0000
Subject: [PATCH 0383/1478] Cosmetics: Remove unnecessary toString()

---
 src/Storages/MergeTree/MergeTreeIndexAggregatorBloomFilter.cpp | 2 +-
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp                 | 2 +-
 src/Storages/MergeTree/MergeTreeIndexFullText.cpp              | 2 +-
 src/Storages/MergeTree/MergeTreeIndexInverted.cpp              | 2 +-
 src/Storages/MergeTree/MergeTreeIndexMinMax.cpp                | 2 +-
 src/Storages/MergeTree/MergeTreeIndexSet.cpp                   | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAggregatorBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexAggregatorBloomFilter.cpp
index fe5a2a861f6..ef98accfbc6 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAggregatorBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAggregatorBloomFilter.cpp
@@ -42,7 +42,7 @@ void MergeTreeIndexAggregatorBloomFilter::update(const Block & block, size_t * p
 {
     if (*pos >= block.rows())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "The provided position is not less than the number of block rows. "
-                        "Position: {}, Block rows: {}.", toString(*pos), toString(block.rows()));
+                        "Position: {}, Block rows: {}.", *pos, block.rows());
 
     Block granule_index_block;
     size_t max_read_rows = std::min(block.rows() - *pos, limit);
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index e13ea91e56c..133c0a9a58a 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -137,7 +137,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "The provided position is not less than the number of block rows. Position: {}, Block rows: {}.",
-            toString(*pos), toString(block.rows()));
+            *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
     if (rows_read == 0)
diff --git a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
index 06fddd51cb8..b15bf4d6811 100644
--- a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
@@ -92,7 +92,7 @@ void MergeTreeIndexAggregatorFullText::update(const Block & block, size_t * pos,
 {
     if (*pos >= block.rows())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "The provided position is not less than the number of block rows. "
-                "Position: {}, Block rows: {}.", toString(*pos), toString(block.rows()));
+                "Position: {}, Block rows: {}.", *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
index baa11368c8b..e19187646cd 100644
--- a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
@@ -123,7 +123,7 @@ void MergeTreeIndexAggregatorInverted::update(const Block & block, size_t * pos,
 {
     if (*pos >= block.rows())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "The provided position is not less than the number of block rows. "
-                "Position: {}, Block rows: {}.", toString(*pos), toString(block.rows()));
+                "Position: {}, Block rows: {}.", *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
     auto row_id = store->getNextRowIDRange(rows_read);
diff --git a/src/Storages/MergeTree/MergeTreeIndexMinMax.cpp b/src/Storages/MergeTree/MergeTreeIndexMinMax.cpp
index d80f7521430..3b011837cb3 100644
--- a/src/Storages/MergeTree/MergeTreeIndexMinMax.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexMinMax.cpp
@@ -122,7 +122,7 @@ void MergeTreeIndexAggregatorMinMax::update(const Block & block, size_t * pos, s
 {
     if (*pos >= block.rows())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "The provided position is not less than the number of block rows. "
-                "Position: {}, Block rows: {}.", toString(*pos), toString(block.rows()));
+                "Position: {}, Block rows: {}.", *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexSet.cpp b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
index 901636a2de9..120b3e43472 100644
--- a/src/Storages/MergeTree/MergeTreeIndexSet.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
@@ -146,7 +146,7 @@ void MergeTreeIndexAggregatorSet::update(const Block & block, size_t * pos, size
 {
     if (*pos >= block.rows())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "The provided position is not less than the number of block rows. "
-                "Position: {}, Block rows: {}.", toString(*pos), toString(block.rows()));
+                "Position: {}, Block rows: {}.", *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
 

From 7608e08eed5cb80f6be097ca572827a5090a0469 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:09:03 +0000
Subject: [PATCH 0384/1478] Cosmetics: more constness

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 9ebaa335542..cde61af2891 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -38,8 +38,8 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 
     bool empty() const override { return !index.get(); }
 
-    String index_name;
-    Block index_sample_block;
+    const String index_name;
+    const Block index_sample_block;
     AnnoyIndexWithSerializationPtr<Distance> index;
 };
 
@@ -53,8 +53,8 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
     MergeTreeIndexGranulePtr getGranuleAndReset() override;
     void update(const Block & block, size_t * pos, size_t limit) override;
 
-    String index_name;
-    Block index_sample_block;
+    const String index_name;
+    const Block index_sample_block;
     const uint64_t trees;
     AnnoyIndexWithSerializationPtr<Distance> index;
 };
@@ -81,7 +81,7 @@ private:
     template <typename Distance>
     std::vector<size_t> getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const;
 
-    ApproximateNearestNeighbour::ANNCondition condition;
+    const ApproximateNearestNeighbour::ANNCondition condition;
     const String distance_name;
 };
 

From a3d4ede26cc57b80a74061072a8b4e7fbe2832bf Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:11:10 +0000
Subject: [PATCH 0385/1478] Cosmetics: Update exception messages

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

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 133c0a9a58a..cd094bbeeac 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -144,7 +144,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         return;
 
     if (index_sample_block.columns() > 1)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Only one column is supported");
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected block with single column");
 
     auto index_column_name = index_sample_block.getByPosition(0).name;
     const auto & column_cut = block.getByName(index_column_name).column->cut(*pos, rows_read);
@@ -162,7 +162,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         size_t size = offsets[0];
         for (size_t i = 0; i < num_rows - 1; ++i)
             if (offsets[i + 1] - offsets[i] != size)
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Arrays should have same length");
+                throw Exception(ErrorCodes::INCORRECT_DATA, "All arrays in column {} must have equal length", index_column_name);
 
         index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(size);
 

From 2b74daaa1744588c44414f5e87578107fd0e1b84 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:12:29 +0000
Subject: [PATCH 0386/1478] Cosmetics: make input switch a bit more idiomatic

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index cd094bbeeac..048200eb57f 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -148,8 +148,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
 
     auto index_column_name = index_sample_block.getByPosition(0).name;
     const auto & column_cut = block.getByName(index_column_name).column->cut(*pos, rows_read);
-    const auto & column_array = typeid_cast<const ColumnArray*>(column_cut.get());
-    if (column_array)
+
+    if (const auto & column_array = typeid_cast<const ColumnArray*>(column_cut.get()))
     {
         const auto & data = column_array->getData();
         const auto & array = typeid_cast<const ColumnFloat32&>(data).getData();
@@ -171,14 +171,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         for (size_t current_row = 1; current_row < num_rows; ++current_row)
             index->add_item(index->get_n_items(), &array[offsets[current_row - 1]]);
     }
-    else
+    else if (const auto & column_tuple = typeid_cast<const ColumnTuple*>(column_cut.get()))
     {
-        /// Other possible type of column is Tuple
-        const auto & column_tuple = typeid_cast<const ColumnTuple*>(column_cut.get());
-
-        if (!column_tuple)
-            throw Exception(ErrorCodes::INCORRECT_QUERY, "Wrong type was given to index.");
-
         const auto & columns = column_tuple->getColumns();
 
         std::vector<std::vector<Float32>> data{column_tuple->size(), std::vector<Float32>()};
@@ -194,6 +188,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         for (const auto& item : data)
             index->add_item(index->get_n_items(), item.data());
     }
+    else
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected Array or Tuple column");
 
     *pos += rows_read;
 }

From 68ad903f4c9a6bc04f6847d586dd6e8ff08c4aae Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:13:22 +0000
Subject: [PATCH 0387/1478] Cosmetics: unglue * and &

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 048200eb57f..80c56a299be 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -149,10 +149,10 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
     auto index_column_name = index_sample_block.getByPosition(0).name;
     const auto & column_cut = block.getByName(index_column_name).column->cut(*pos, rows_read);
 
-    if (const auto & column_array = typeid_cast<const ColumnArray*>(column_cut.get()))
+    if (const auto & column_array = typeid_cast<const ColumnArray *>(column_cut.get()))
     {
         const auto & data = column_array->getData();
-        const auto & array = typeid_cast<const ColumnFloat32&>(data).getData();
+        const auto & array = typeid_cast<const ColumnFloat32 &>(data).getData();
         if (array.empty())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Array has 0 rows, {} rows expected", rows_read);
         const auto & offsets = column_array->getOffsets();
@@ -171,21 +171,21 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
         for (size_t current_row = 1; current_row < num_rows; ++current_row)
             index->add_item(index->get_n_items(), &array[offsets[current_row - 1]]);
     }
-    else if (const auto & column_tuple = typeid_cast<const ColumnTuple*>(column_cut.get()))
+    else if (const auto & column_tuple = typeid_cast<const ColumnTuple *>(column_cut.get()))
     {
         const auto & columns = column_tuple->getColumns();
 
         std::vector<std::vector<Float32>> data{column_tuple->size(), std::vector<Float32>()};
-        for (const auto& column : columns)
+        for (const auto & column : columns)
         {
-            const auto& pod_array = typeid_cast<const ColumnFloat32*>(column.get())->getData();
+            const auto & pod_array = typeid_cast<const ColumnFloat32 *>(column.get())->getData();
             for (size_t i = 0; i < pod_array.size(); ++i)
                 data[i].push_back(pod_array[i]);
         }
         assert(!data.empty());
         if (!index)
             index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(data[0].size());
-        for (const auto& item : data)
+        for (const auto & item : data)
             index->add_item(index->get_n_items(), item.data());
     }
     else

From 15c9e235c44785a8dc67544728d607271fe10436 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:19:44 +0000
Subject: [PATCH 0388/1478] Cosmetics: add some comments + minor changes

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 80c56a299be..ea284892754 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -140,6 +140,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
             *pos, block.rows());
 
     size_t rows_read = std::min(limit, block.rows() - *pos);
+
     if (rows_read == 0)
         return;
 
@@ -153,10 +154,12 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
     {
         const auto & data = column_array->getData();
         const auto & array = typeid_cast<const ColumnFloat32 &>(data).getData();
+
         if (array.empty())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Array has 0 rows, {} rows expected", rows_read);
+
         const auto & offsets = column_array->getOffsets();
-        size_t num_rows = offsets.size();
+        const size_t num_rows = offsets.size();
 
         /// Check all sizes are the same
         size_t size = offsets[0];
@@ -166,8 +169,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
 
         index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(size);
 
+        /// Add all rows of block
         index->add_item(index->get_n_items(), array.data());
-        /// add all rows from 1 to num_rows - 1 (this is the same as the beginning of the last element)
         for (size_t current_row = 1; current_row < num_rows; ++current_row)
             index->add_item(index->get_n_items(), &array[offsets[current_row - 1]]);
     }
@@ -175,6 +178,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
     {
         const auto & columns = column_tuple->getColumns();
 
+        /// TODO check if calling index->add_item() directly on the block's tuples is faster than materializing everything
         std::vector<std::vector<Float32>> data{column_tuple->size(), std::vector<Float32>()};
         for (const auto & column : columns)
         {
@@ -182,9 +186,12 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
             for (size_t i = 0; i < pod_array.size(); ++i)
                 data[i].push_back(pod_array[i]);
         }
-        assert(!data.empty());
-        if (!index)
-            index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(data[0].size());
+
+        if (data.empty())
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Tuple has 0 rows, {} rows expected", rows_read);
+
+        index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(data[0].size());
+
         for (const auto & item : data)
             index->add_item(index->get_n_items(), item.data());
     }

From 828155ebefde62b610e9866a45a6d7fd71eb14b7 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:21:47 +0000
Subject: [PATCH 0389/1478] Cosmetics: Move assertIndexColumnsType() into
 annoyIndexValidator()

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 36 ++++++++-----------
 1 file changed, 15 insertions(+), 21 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index ea284892754..636fd384248 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -338,9 +338,22 @@ MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
     return std::make_shared<MergeTreeIndexAnnoy>(index, param, distance_name);
 }
 
-static void assertIndexColumnsType(const Block & header)
+void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 {
-    DataTypePtr column_data_type_ptr = header.getDataTypes()[0];
+    if (index.arguments.size() > 2)
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index must not have more than two parameters");
+
+    if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::UInt64
+        && index.arguments[0].getType() != Field::Types::String)
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String");
+
+    if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::String)
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String");
+
+    if (index.column_names.size() != 1 || index.data_types.size() != 1)
+        throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
+
+    DataTypePtr column_data_type_ptr = index.sample_block.getDataTypes()[0];
 
     if (const auto * array_type = typeid_cast<const DataTypeArray *>(column_data_type_ptr.get()))
     {
@@ -369,25 +382,6 @@ static void assertIndexColumnsType(const Block & header)
             ErrorCodes::ILLEGAL_COLUMN,
             "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
             column_data_type_ptr->getName());
-
-}
-
-void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
-{
-    if (index.arguments.size() > 2)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index must not have more than two parameters");
-
-    if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::UInt64
-        && index.arguments[0].getType() != Field::Types::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String");
-
-    if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String");
-
-    if (index.column_names.size() != 1 || index.data_types.size() != 1)
-        throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
-
-    assertIndexColumnsType(index.sample_block);
 }
 
 }

From 0854d913723d967e07105857924f788817ac48c5 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:27:01 +0000
Subject: [PATCH 0390/1478] Cosmetics: Rename variable

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 636fd384248..d75f4978f08 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -353,35 +353,35 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
 
-    DataTypePtr column_data_type_ptr = index.sample_block.getDataTypes()[0];
+    DataTypePtr data_type = index.sample_block.getDataTypes()[0];
 
-    if (const auto * array_type = typeid_cast<const DataTypeArray *>(column_data_type_ptr.get()))
+    if (const auto * data_type_array = typeid_cast<const DataTypeArray *>(data_type.get()))
     {
-        TypeIndex nested_type_index = array_type->getNestedType()->getTypeId();
+        TypeIndex nested_type_index = data_type_array->getNestedType()->getTypeId();
         if (!WhichDataType(nested_type_index).isFloat32())
             throw Exception(
                 ErrorCodes::ILLEGAL_COLUMN,
                 "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-                column_data_type_ptr->getName());
+                data_type->getName());
     }
-    else if (const auto * tuple_type = typeid_cast<const DataTypeTuple *>(column_data_type_ptr.get()))
+    else if (const auto * data_type_tuple = typeid_cast<const DataTypeTuple *>(data_type.get()))
     {
-        const DataTypes & nested_types = tuple_type->getElements();
-        for (const auto & type : nested_types)
+        const DataTypes & inner_types = data_type_tuple->getElements();
+        for (const auto & inner_type : inner_types)
         {
-            TypeIndex nested_type_index = type->getTypeId();
+            TypeIndex nested_type_index = inner_type->getTypeId();
             if (!WhichDataType(nested_type_index).isFloat32())
                 throw Exception(
                     ErrorCodes::ILLEGAL_COLUMN,
-                    "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-                    column_data_type_ptr->getName());
+                    "Unexpected inner_type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
+                    data_type->getName());
         }
     }
     else
         throw Exception(
             ErrorCodes::ILLEGAL_COLUMN,
             "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-            column_data_type_ptr->getName());
+            data_type->getName());
 }
 
 }

From 62c8b9a7a11c0a3aae75a10a2a0ad61db5d63b55 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:28:20 +0000
Subject: [PATCH 0391/1478] Cosmetics: Factorize throw into lambda

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 23 +++++++++----------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index d75f4978f08..d35f435c391 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -353,16 +353,21 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
 
+    auto throw_unsupported_underlying_column_exception = [](DataTypePtr data_type)
+    {
+        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());
+    };
+
     DataTypePtr data_type = index.sample_block.getDataTypes()[0];
 
     if (const auto * data_type_array = typeid_cast<const DataTypeArray *>(data_type.get()))
     {
         TypeIndex nested_type_index = data_type_array->getNestedType()->getTypeId();
         if (!WhichDataType(nested_type_index).isFloat32())
-            throw Exception(
-                ErrorCodes::ILLEGAL_COLUMN,
-                "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-                data_type->getName());
+            throw_unsupported_underlying_column_exception(data_type);
     }
     else if (const auto * data_type_tuple = typeid_cast<const DataTypeTuple *>(data_type.get()))
     {
@@ -371,17 +376,11 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
         {
             TypeIndex nested_type_index = inner_type->getTypeId();
             if (!WhichDataType(nested_type_index).isFloat32())
-                throw Exception(
-                    ErrorCodes::ILLEGAL_COLUMN,
-                    "Unexpected inner_type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-                    data_type->getName());
+                throw_unsupported_underlying_column_exception(data_type);
         }
     }
     else
-        throw Exception(
-            ErrorCodes::ILLEGAL_COLUMN,
-            "Unexpected type {} of Annoy index. Only Array(Float32) and Tuple(Float32) are supported",
-            data_type->getName());
+        throw_unsupported_underlying_column_exception(data_type);
 }
 
 }

From 5d871c7fa09637eb89b69680ba5e5d256bddbdd7 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:29:51 +0000
Subject: [PATCH 0392/1478] Cosmetics: +comments

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index d35f435c391..8f0cad48dc0 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -340,6 +340,8 @@ MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
 
 void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
 {
+    /// Check number and type of Annoy index arguments:
+
     if (index.arguments.size() > 2)
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index must not have more than two parameters");
 
@@ -350,9 +352,13 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::String)
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be String");
 
+    /// Check that the index is created on a single column
+
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
 
+    /// Check data type of indexed column:
+
     auto throw_unsupported_underlying_column_exception = [](DataTypePtr data_type)
     {
         throw Exception(

From f577bf35fc53262290e3c6e18352d1a446cbb642 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:35:38 +0000
Subject: [PATCH 0393/1478] Simplify Annoy parameterization

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 25 ++++---
 tests/queries/0_stateless/02354_annoy.sh      | 73 +------------------
 .../0_stateless/02354_annoy_index.reference   |  1 +
 .../queries/0_stateless/02354_annoy_index.sql | 26 +++++++
 4 files changed, 42 insertions(+), 83 deletions(-)
 create mode 100644 tests/queries/0_stateless/02354_annoy_index.reference
 create mode 100644 tests/queries/0_stateless/02354_annoy_index.sql

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 8f0cad48dc0..dc353c97143 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -328,14 +328,16 @@ MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(
 
 MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
 {
-    uint64_t param = 100;
+    uint64_t trees = 100;
     String distance_name = "L2Distance";
-    if (!index.arguments.empty() && !index.arguments[0].tryGet<uint64_t>(param))
-        if (!index.arguments[0].tryGet<String>(distance_name))
-            throw Exception(ErrorCodes::INCORRECT_DATA, "Can't parse first argument");
-    if (index.arguments.size() > 1 && !index.arguments[1].tryGet<String>(distance_name))
-        throw Exception(ErrorCodes::INCORRECT_DATA, "Can't parse second argument");
-    return std::make_shared<MergeTreeIndexAnnoy>(index, param, distance_name);
+
+    if (!index.arguments.empty())
+        distance_name = index.arguments[0].get<String>();
+
+    if (index.arguments.size() > 1)
+        trees = index.arguments[1].get<uint64_t>();
+
+    return std::make_shared<MergeTreeIndexAnnoy>(index, trees, distance_name);
 }
 
 void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
@@ -345,12 +347,11 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     if (index.arguments.size() > 2)
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index must not have more than two parameters");
 
-    if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::UInt64
-        && index.arguments[0].getType() != Field::Types::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index first argument must be UInt64 or String");
+    if (!index.arguments.empty() && index.arguments[0].getType() != Field::Types::String)
+        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::String)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Annoy index second argument must be 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");
 
     /// Check that the index is created on a single column
 
diff --git a/tests/queries/0_stateless/02354_annoy.sh b/tests/queries/0_stateless/02354_annoy.sh
index 87258debf0f..1031ea81946 100755
--- a/tests/queries/0_stateless/02354_annoy.sh
+++ b/tests/queries/0_stateless/02354_annoy.sh
@@ -91,7 +91,7 @@ CREATE TABLE 02354_annoy_cosine
 (
     id Int32,
     embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy(100, 'cosineDistance') GRANULARITY 1
+    INDEX annoy_index embedding TYPE annoy('cosineDistance', 100) GRANULARITY 1
 )
 ENGINE = MergeTree
 ORDER BY id
@@ -120,7 +120,7 @@ CREATE TABLE 02354_annoy_cosine
 (
     id Int32,
     embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy(100, 'cosineDistance') GRANULARITY 1
+    INDEX annoy_index embedding TYPE annoy('cosineDistance', 100) GRANULARITY 1
 )
 ENGINE = MergeTree
 ORDER BY id
@@ -141,72 +141,3 @@ ORDER BY cosineDistance(embedding, [0.0, 0.0, 10.0])
 LIMIT 3;
 DROP TABLE IF EXISTS 02354_annoy_cosine;
 " | grep "annoy_index"
-
-# # Check that weird base columns are rejected
-$CLICKHOUSE_CLIENT -nm --allow_experimental_annoy_index=1 -q "
-DROP TABLE IF EXISTS 02354_annoy;
-
--- Index spans >1 column
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Array(Float32),
-    INDEX annoy_index (embedding, id) TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 7 }
-
--- Index must be created on Array(Float32) or Tuple(Float32)
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Float32,
-    INDEX annoy_index embedding TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 44 }
-
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Array(Float64),
-    INDEX annoy_index embedding TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 44 }
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Tuple(Float32, Float64),
-    INDEX annoy_index embedding TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 44 }
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Array(LowCardinality(Float32)),
-    INDEX annoy_index embedding TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 44 }
-
-CREATE TABLE 02354_annoy
-(
-    id Int32,
-    embedding Array(Nullable(Float32)),
-    INDEX annoy_index embedding TYPE annoy(100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi'; -- {serverError 44 }"
diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
new file mode 100644
index 00000000000..2d162500f67
--- /dev/null
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -0,0 +1 @@
+Negative tests
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
new file mode 100644
index 00000000000..8df9af1ee73
--- /dev/null
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -0,0 +1,26 @@
+-- Tags: no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
+
+SET allow_experimental_annoy_index = 1;
+
+DROP TABLE IF EXISTS tab;
+
+SELECT 'Negative tests';
+
+-- 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 }
+
+-- first argument must be UInt64
+CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy(3)) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
+
+-- 2nd argument must be String
+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 }
+
+-- 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 }
+
+-- 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 }

From 03b6856556c67fe1c0f7c1df0b28b19556fd3fcc Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:39:57 +0000
Subject: [PATCH 0394/1478] Cosmetics: distance_name --> distance_function

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 41 +++++++++----------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  8 ++--
 2 files changed, 24 insertions(+), 25 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index dc353c97143..a9679453655 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -205,31 +205,31 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
 MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     const IndexDescription & /*index*/,
     const SelectQueryInfo & query,
-    const String& distance_name_,
+    const String & distance_function_,
     ContextPtr context)
     : condition(query, context)
-    , distance_name(distance_name_)
+    , distance_function(distance_function_)
 {}
 
 
-bool MergeTreeIndexConditionAnnoy::mayBeTrueOnGranule(MergeTreeIndexGranulePtr /* idx_granule */) const
+bool MergeTreeIndexConditionAnnoy::mayBeTrueOnGranule(MergeTreeIndexGranulePtr /*idx_granule*/) const
 {
     throw Exception(ErrorCodes::LOGICAL_ERROR, "mayBeTrueOnGranule is not supported for ANN skip indexes");
 }
 
 bool MergeTreeIndexConditionAnnoy::alwaysUnknownOrTrue() const
 {
-    return condition.alwaysUnknownOrTrue(distance_name);
+    return condition.alwaysUnknownOrTrue(distance_function);
 }
 
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const
 {
-    if (distance_name == "L2Distance")
+    if (distance_function == "L2Distance")
         return getUsefulRangesImpl<Annoy::Euclidean>(idx_granule);
-    else if (distance_name == "cosineDistance")
+    else if (distance_function == "cosineDistance")
         return getUsefulRangesImpl<Annoy::Angular>(idx_granule);
     else
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
 }
 
 
@@ -295,49 +295,48 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     return result_vector;
 }
 
-MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String& distance_name_)
+MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String & distance_function_)
     : IMergeTreeIndex(index_)
     , trees(trees_)
-    , distance_name(distance_name_)
+    , distance_function(distance_function_)
 {}
 
 MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
 {
-    if (distance_name == "L2Distance")
+    if (distance_function == "L2Distance")
         return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Euclidean>>(index.name, index.sample_block);
-    else if (distance_name == "cosineDistance")
+    else if (distance_function == "cosineDistance")
         return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Angular>>(index.name, index.sample_block);
-    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
+    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
 }
 
 MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
 {
     /// TODO: Support more metrics. Available metrics: https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
-    if (distance_name == "L2Distance")
+    if (distance_function == "L2Distance")
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Euclidean>>(index.name, index.sample_block, trees);
-    if (distance_name == "cosineDistance")
+    if (distance_function == "cosineDistance")
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Angular>>(index.name, index.sample_block, trees);
-    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_name);
+    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
 }
 
-MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(
-    const SelectQueryInfo & query, ContextPtr context) const
+MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(const SelectQueryInfo & query, ContextPtr context) const
 {
-    return std::make_shared<MergeTreeIndexConditionAnnoy>(index, query, distance_name, context);
+    return std::make_shared<MergeTreeIndexConditionAnnoy>(index, query, distance_function, context);
 };
 
 MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
 {
     uint64_t trees = 100;
-    String distance_name = "L2Distance";
+    String distance_function = "L2Distance";
 
     if (!index.arguments.empty())
-        distance_name = index.arguments[0].get<String>();
+        distance_function = index.arguments[0].get<String>();
 
     if (index.arguments.size() > 1)
         trees = index.arguments[1].get<uint64_t>();
 
-    return std::make_shared<MergeTreeIndexAnnoy>(index, trees, distance_name);
+    return std::make_shared<MergeTreeIndexAnnoy>(index, trees, distance_function);
 }
 
 void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index cde61af2891..9741412e3fa 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -66,7 +66,7 @@ public:
     MergeTreeIndexConditionAnnoy(
         const IndexDescription & index,
         const SelectQueryInfo & query,
-        const String& distance_name,
+        const String& distance_function,
         ContextPtr context);
 
     bool alwaysUnknownOrTrue() const override;
@@ -82,7 +82,7 @@ private:
     std::vector<size_t> getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const;
 
     const ApproximateNearestNeighbour::ANNCondition condition;
-    const String distance_name;
+    const String distance_function;
 };
 
 
@@ -90,7 +90,7 @@ class MergeTreeIndexAnnoy : public IMergeTreeIndex
 {
 public:
 
-    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String& distance_name_);
+    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String & distance_function_);
 
     ~MergeTreeIndexAnnoy() override = default;
 
@@ -103,7 +103,7 @@ public:
 
 private:
     const uint64_t trees;
-    const String distance_name;
+    const String distance_function;
 };
 
 

From 18304f5aeff627b47965ffd5c07ae6c5d61bface Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:51:21 +0000
Subject: [PATCH 0395/1478] Check distance function in CREATE TABLE instead of
 first INSERT

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp  | 13 +++++++++++--
 tests/queries/0_stateless/02354_annoy_index.sql |  3 +++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index a9679453655..12446623c30 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -307,7 +307,7 @@ MergeTreeIndexGranulePtr MergeTreeIndexAnnoy::createIndexGranule() const
         return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Euclidean>>(index.name, index.sample_block);
     else if (distance_function == "cosineDistance")
         return std::make_shared<MergeTreeIndexGranuleAnnoy<Annoy::Angular>>(index.name, index.sample_block);
-    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
+    std::unreachable();
 }
 
 MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
@@ -317,7 +317,7 @@ MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Euclidean>>(index.name, index.sample_block, trees);
     if (distance_function == "cosineDistance")
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Angular>>(index.name, index.sample_block, trees);
-    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
+    std::unreachable();
 }
 
 MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(const SelectQueryInfo & query, ContextPtr context) const
@@ -357,6 +357,15 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     if (index.column_names.size() != 1 || index.data_types.size() != 1)
         throw Exception(ErrorCodes::INCORRECT_NUMBER_OF_COLUMNS, "Annoy indexes must be created on a single column");
 
+    /// Check that a supported metric was passed as first argument
+
+    if (!index.arguments.empty())
+    {
+        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);
+    }
+
     /// Check data type of indexed column:
 
     auto throw_unsupported_underlying_column_exception = [](DataTypePtr data_type)
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 8df9af1ee73..3a5fb6817ff 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -24,3 +24,6 @@ CREATE TABLE tab(id Int32, embedding Float32, INDEX annoy_index embedding TYPE a
 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 }
+
+-- 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 }

From d3158a28770339f36f9c0e69acb6d271ced351f6 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 20:56:27 +0000
Subject: [PATCH 0396/1478] Cosmetics: Consolidate parameters

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

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 6a0833aef60..8055e9b4880 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -719,7 +719,6 @@ class IColumn;
     \
     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) \
     M(Bool, count_distinct_optimization, false, "Rewrite count distinct to subquery of group by", 0) \
     M(Bool, throw_if_no_data_to_insert, true, "Enables or disables empty INSERTs, enabled by default", 0) \
     M(Bool, compatibility_ignore_auto_increment_in_create_table, false, "Ignore AUTO_INCREMENT keyword in column declaration if true, otherwise return error. It simplifies migration from MySQL", 0) \
@@ -742,7 +741,8 @@ class IColumn;
     M(Bool, allow_experimental_hash_functions, false, "Enable experimental hash functions (hashid, etc)", 0) \
     M(Bool, allow_experimental_object_type, false, "Allow Object and JSON data types", 0) \
     M(Bool, allow_experimental_annoy_index, false, "Allows to use Annoy index. Disabled by default because this feature is experimental", 0) \
-    M(UInt64, max_limit_for_ann_queries, 1000000, "Maximum limit value for using ANN indexes is used to prevent memory overflow in search queries for indexes", 0) \
+    M(UInt64, max_limit_for_ann_queries, 1'000'000, "SELECT queries with LIMIT bigger than this setting cannot use ANN indexes. Helps to prevent memory overflows in ANN search indexs.", 0) \
+    M(String, ann_index_select_query_params, "", "Parameters passed to ANN indexes in SELECT queries, the format is 'param1=x, param2=y, ...'", 0) \
     M(Bool, throw_on_unsupported_query_inside_transaction, true, "Throw exception if unsupported query is used inside transaction", 0) \
     M(TransactionsWaitCSNMode, wait_changes_become_visible_after_commit_mode, TransactionsWaitCSNMode::WAIT_UNKNOWN, "Wait for committed changes to become actually visible in the latest snapshot", 0) \
     M(Bool, implicit_transaction, false, "If enabled and not already inside a transaction, wraps the query inside a full transaction (begin + commit or rollback)", 0) \

From a973ac5dbb99e7fc624742b34fc507935cd792e4 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:03:50 +0000
Subject: [PATCH 0397/1478] Replace weird generic ANN setting by Annoy-specific
 parameter

---
 .../mergetree-family/annindexes.md            |  3 ++-
 src/Core/Settings.h                           |  2 +-
 src/Storages/MergeTree/CommonANNIndexes.cpp   |  1 -
 src/Storages/MergeTree/CommonANNIndexes.h     |  7 ------
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 18 +++-----------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  5 ++--
 .../0_stateless/02354_annoy_index.reference   | 12 ++++++++++
 .../queries/0_stateless/02354_annoy_index.sql | 24 +++++++++++++++++++
 8 files changed, 45 insertions(+), 27 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 03617a1a709..9b4de150235 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -135,7 +135,8 @@ ORDER BY id;
 
 Annoy supports `L2Distance` and `cosineDistance`.
 
-In the `SELECT` in the settings (`ann_index_select_query_params`) you can specify the size of the internal buffer (more details in the description above or in the [original repository](https://github.com/spotify/annoy)). During the query it will inspect up to `search_k` nodes which defaults to `n_trees * n` if not provided. `search_k` gives you a run-time trade-off between better accuracy and speed.
+Setting `search_k` (default `LIMIT * NumTrees`) determines how many nodes the Annoy index will inspect during SELECT queries. The setting
+can be used to balance performance and accuracy at runtime.
 
 __Example__:
 ``` sql
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 8055e9b4880..3e10f48a2fb 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -742,7 +742,7 @@ class IColumn;
     M(Bool, allow_experimental_object_type, false, "Allow Object and JSON data types", 0) \
     M(Bool, allow_experimental_annoy_index, false, "Allows to use Annoy index. Disabled by default because this feature is experimental", 0) \
     M(UInt64, max_limit_for_ann_queries, 1'000'000, "SELECT queries with LIMIT bigger than this setting cannot use ANN indexes. Helps to prevent memory overflows in ANN search indexs.", 0) \
-    M(String, ann_index_select_query_params, "", "Parameters passed to ANN indexes in SELECT queries, the format is 'param1=x, param2=y, ...'", 0) \
+    M(Int64, annoy_index_search_k_nodes, -1, "SELECT queries search up to this many nodes in Annoy indexes.", 0) \
     M(Bool, throw_on_unsupported_query_inside_transaction, true, "Throw exception if unsupported query is used inside transaction", 0) \
     M(TransactionsWaitCSNMode, wait_changes_become_visible_after_commit_mode, TransactionsWaitCSNMode::WAIT_UNKNOWN, "Wait for committed changes to become actually visible in the latest snapshot", 0) \
     M(Bool, implicit_transaction, false, "If enabled and not already inside a transaction, wraps the query inside a full transaction (begin + commit or rollback)", 0) \
diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index f0c6f256f73..4748c869f83 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -60,7 +60,6 @@ namespace ApproximateNearestNeighbour
 ANNCondition::ANNCondition(const SelectQueryInfo & query_info,
                                  ContextPtr context) :
     block_with_constants{KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context)},
-    ann_index_select_query_params{context->getSettings().get("ann_index_select_query_params").get<String>()},
     index_granularity{context->getMergeTreeSettings().get("index_granularity").get<UInt64>()},
     limit_restriction{context->getSettings().get("max_limit_for_ann_queries").get<UInt64>()},
     index_is_useful{checkQueryStructure(query_info)} {}
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index fefb9584863..4253bce703a 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -82,8 +82,6 @@ struct ANNQueryInformation
     * spaceDimension(which is targetVector's components count)
     * column
     * objects count from LIMIT clause(for both queries)
-    * settings str, if query has settings section with new 'ann_index_select_query_params' value,
-        than you can get the new value(empty by default) calling method getSettingsStr
     * queryHasOrderByClause and queryHasWhereClause return true if query matches the type
 
     Search query type is also recognized for PREWHERE clause
@@ -121,11 +119,7 @@ public:
     // length's value from LIMIT clause
     UInt64 getLimit() const;
 
-    // value of 'ann_index_select_query_params' if have in SETTINGS clause, empty string otherwise
-    String getParamsStr() const { return ann_index_select_query_params; }
-
 private:
-
     struct RPNElement
     {
         enum Function
@@ -217,7 +211,6 @@ private:
     std::optional<ANNQueryInformation> query_information;
 
     // Get from settings ANNIndex parameters
-    String ann_index_select_query_params;
     UInt64 index_granularity;
     /// only queries with a lower limit can be considered to avoid memory overflow
     UInt64 limit_restriction;
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 12446623c30..6ffb7aecb7f 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -7,6 +7,7 @@
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
 #include <Interpreters/castColumn.h>
+#include <Interpreters/Context.h>
 #include <Columns/ColumnArray.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/DataTypeTuple.h>
@@ -209,6 +210,7 @@ MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     ContextPtr context)
     : condition(query, context)
     , distance_function(distance_function_)
+    , search_k(context->getSettings().get("annoy_index_search_k_nodes").get<Int64>())
 {}
 
 
@@ -264,21 +266,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     neighbors.reserve(limit);
     distances.reserve(limit);
 
-    int k_search = -1;
-    String params_str = condition.getParamsStr();
-    if (!params_str.empty())
-    {
-        try
-        {
-            /// k_search=... (algorithm will inspect up to search_k nodes which defaults to n_trees * n if not provided)
-            k_search = std::stoi(params_str.data() + 9);
-        }
-        catch (...)
-        {
-            throw Exception(ErrorCodes::INCORRECT_QUERY, "Setting of the annoy index should be int");
-        }
-    }
-    annoy->get_nns_by_vector(target_vec.data(), limit, k_search, &neighbors, &distances);
+    annoy->get_nns_by_vector(target_vec.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
     std::unordered_set<size_t> granule_numbers;
     for (size_t i = 0; i < neighbors.size(); ++i)
     {
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 9741412e3fa..fbc6b21fa6b 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -69,20 +69,21 @@ public:
         const String& distance_function,
         ContextPtr context);
 
+    ~MergeTreeIndexConditionAnnoy() override = default;
+
     bool alwaysUnknownOrTrue() const override;
 
     bool mayBeTrueOnGranule(MergeTreeIndexGranulePtr idx_granule) const override;
 
     std::vector<size_t> getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const override;
 
-    ~MergeTreeIndexConditionAnnoy() override = default;
-
 private:
     template <typename Distance>
     std::vector<size_t> getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const;
 
     const ApproximateNearestNeighbour::ANNCondition condition;
     const String distance_function;
+    const Int64 search_k;
 };
 
 
diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 2d162500f67..7da442cb905 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -1 +1,13 @@
+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: 1/1
 Negative tests
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 3a5fb6817ff..3590b7d316e 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -4,6 +4,30 @@ SET allow_experimental_annoy_index = 1;
 
 DROP TABLE IF EXISTS tab;
 
+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, index_granularity_bytes = '10Mi';
+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 '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;
+
+DROP TABLE IF EXISTS tab;
+
 SELECT 'Negative tests';
 
 -- must have at most 2 arguments

From 6d3431d2ff0325282ea373bfeafed6a2e1946577 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:12:40 +0000
Subject: [PATCH 0398/1478] Cosmetics: Sort includes

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 6ffb7aecb7f..fe3ea322b91 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -2,15 +2,15 @@
 
 #include <Storages/MergeTree/MergeTreeIndexAnnoy.h>
 
+#include <Columns/ColumnArray.h>
 #include <Common/typeid_cast.h>
 #include <Core/Field.h>
-#include <IO/ReadHelpers.h>
-#include <IO/WriteHelpers.h>
-#include <Interpreters/castColumn.h>
-#include <Interpreters/Context.h>
-#include <Columns/ColumnArray.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/DataTypeTuple.h>
+#include <IO/ReadHelpers.h>
+#include <IO/WriteHelpers.h>
+#include <Interpreters/Context.h>
+#include <Interpreters/castColumn.h>
 
 
 namespace DB

From f800940639bbe490e619594db62a83f7f8f2f80d Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:13:33 +0000
Subject: [PATCH 0399/1478] Cosmetics: Shuffle statements

---
 src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 16b27c2c820..aa340d6afc1 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -1686,7 +1686,6 @@ MarkRanges MergeTreeDataSelectExecutor::filterMarksUsingIndex(
         {
             if (index_mark != index_range.begin || !granule || last_index_mark != index_range.begin)
                 granule = reader.read();
-            const auto * gin_filter_condition = dynamic_cast<const MergeTreeConditionInverted *>(&*condition);
             // Cast to Ann condition
             auto ann_condition = std::dynamic_pointer_cast<ApproximateNearestNeighbour::IMergeTreeIndexConditionAnn>(condition);
             if (ann_condition != nullptr)
@@ -1714,6 +1713,7 @@ MarkRanges MergeTreeDataSelectExecutor::filterMarksUsingIndex(
             }
 
             bool result = false;
+            const auto * gin_filter_condition = dynamic_cast<const MergeTreeConditionInverted *>(&*condition);
             if (!gin_filter_condition)
                 result = condition->mayBeTrueOnGranule(granule);
             else

From 660760782ad6357c34f55113f3a9522e94b30dd3 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:16:03 +0000
Subject: [PATCH 0400/1478] Rewrite ANN docs

---
 .../mergetree-family/annindexes.md            | 140 ++++++++++--------
 1 file changed, 78 insertions(+), 62 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 9b4de150235..0cc1cff2dad 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -1,78 +1,89 @@
 # Approximate Nearest Neighbor Search Indexes [experimental] {#table_engines-ANNIndex}
 
-The main task that indexes achieve is to quickly find nearest neighbors for multidimensional data. An example of such a problem can be finding similar pictures (texts) for a given picture (text). That problem can be reduced to finding the nearest [embeddings](https://cloud.google.com/architecture/overview-extracting-and-serving-feature-embeddings-for-machine-learning). They can be created from data using [UDF](/docs/en/sql-reference/functions/index.md/#executable-user-defined-functions).
+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.
 
-The next queries find the closest neighbors in N-dimensional space using the L2 (Euclidean) distance:
-``` sql 
-SELECT * 
-FROM table_name 
-WHERE L2Distance(Column, Point) < MaxDistance 
+In terms of SQL, the problem can be expressed as follows:
+
+``` sql
+SELECT *
+FROM table
+WHERE L2Distance(column, Point) < MaxDistance
 LIMIT N
 ```
 
-``` sql 
-SELECT * 
-FROM table_name 
-ORDER BY L2Distance(Column, Point)
+``` sql
+SELECT *
+FROM table
+ORDER BY L2Distance(column, Point)
 LIMIT N
 ```
-But it will take some time for execution because of the long calculation of the distance between `TargetEmbedding` and all other vectors. This is where ANN indexes can help. They store a compact approximation of the search space (e.g. using clustering, search trees, etc.) and are able to compute approximate neighbors quickly.
+
+The queries are expensive because the L2 distance (Euclidean distance) between all points in `column` and `Point` must be computed. To speed this process up, ANN indexes store a compact representation of the search space (using clustering, search trees, etc.) which allows to compute an approximate answer quickly.
 
 ## Indexes Structure
 
-Approximate Nearest Neighbor Search Indexes (`ANNIndexes`) are similar to skip indexes. They are constructed by some granules and determine which of them should be skipped. Compared to skip indices, ANN indices use their results not only to skip some group of granules, but also to select particular granules from a set of granules.
+Approximate Nearest Neighbor Search Indexes (or `ANNIndexes`) are similar to skip indexes. They are constructed over granules and determine which granules can be skipped. Compared to skip indices, ANN indices are not only able to skip granules, they can also to select particular granules from a set of granules.
 
-`ANNIndexes` are designed to speed up two types of queries:
+`ANNIndexes` support two types of queries:
 
-- ######  Type 1: Where 
-   ``` sql 
-   SELECT * 
-   FROM table_name 
-   WHERE DistanceFunction(Column, Point) < MaxDistance 
+- WHERE queries:
+   ``` sql
+   SELECT *
+   FROM table
+   WHERE DistanceFunction(column, Point) < MaxDistance
    LIMIT N
    ```
-- ###### Type 2: Order by
+
+- ORDER BY queries:
   ``` sql
-  SELECT * 
-  FROM table_name [WHERE ...] 
-  ORDER BY DistanceFunction(Column, Point) 
+  SELECT *
+  FROM table [WHERE ...]
+  ORDER BY DistanceFunction(column, Point)
   LIMIT N
   ```
 
-In these queries, `DistanceFunction` is selected from [distance functions](/docs/en/sql-reference/functions/distance-functions.md). `Point` is a known vector (something like `(0.1, 0.1, ... )`). To avoid writing large vectors, use [client parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters). `Value` - a float value that will bound the neighbourhood.
+`DistanceFunction` is a [distance functions](/docs/en/sql-reference/functions/distance-functions.md), `Point` is a given vector (e.g. `(0.17, 0.33, ...)`) and `MaxDistance` is a float value which restricts the size of the neighbourhood.
 
-:::note
-ANN index can't speed up query that satisfies both types (`where + order by`, only one of them). All queries must have the limit, as algorithms are used to find nearest neighbors and need a specific number of them.
-:::
+To avoid writing large vectors, you can also use [query parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
 
-:::note
-Indexes are applied only to queries with a limit less than the `max_limit_for_ann_queries` setting. This helps to avoid memory overflows in queries with a large limit. `max_limit_for_ann_queries` setting can be changed if you know you can provide enough memory. The default value is `1000000`.
-:::
+```bash
+clickhouse-client --param_vec='hello' --query="SELECT * FROM table WHERE L2Distance(embedding, {vec: Array(Float32)}) < 1.0"
+```
 
-Both types of queries are handled the same way. The indexes get `n` neighbors (where `n` is taken from the `LIMIT` clause) and work with them. In `ORDER BY` query they remember the numbers of all parts of the granule that have at least one of neighbor. In `WHERE` query they remember only those parts that satisfy the requirements.
+ANN index cannot speed up query that contain both `WHERE` and `ORDER BY`. Queries must have a limit, as the approximate algorithms used to determine the nearest neighbors require a specific number of them.
+
+Indexes are only used for queries with a `LIMIT` value smaller than setting `max_limit_for_ann_queries` (default: 1 million rows). This helps to prevent memory overflows in queries with a large limit.
+
+Both types of queries are processed similarly. The indexes are passed the number of neighbors `N`. In `ORDER BY` query they remember the numbers of all parts of the granule that have at least one of neighbor. In `WHERE` query they remember only those parts that satisfy the requirements.
 
 
-## Create table with ANNIndex
+## Creating Tables with an ANN Index
 
-This feature is disabled by default. To enable it, set `allow_experimental_annoy_index` to 1. Also, this feature is disabled on ARM, due to likely problems with the algorithm.
+As long as ANN indexes are experimental, you first need to `SET allow_experimental_annoy_index = 1`.
+
+Syntax:
 
 ```sql
-CREATE TABLE t
+CREATE TABLE table
 (
   `id` Int64,
-  `data` Tuple(Float32, Float32, Float32),
-  INDEX ann_index_name data TYPE ann_index_type(ann_index_parameters) GRANULARITY N
+  `embedding` Tuple(Float32, Float32, Float32),
+  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY N
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
 ```sql
-CREATE TABLE t
+CREATE TABLE table
 (
   `id` Int64,
-  `data` Array(Float32),
-  INDEX ann_index_name data TYPE ann_index_type(ann_index_parameters) GRANULARITY N
+  `embedding` Array(Float32),
+  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY N
 )
 ENGINE = MergeTree
 ORDER BY id;
@@ -80,69 +91,74 @@ ORDER BY id;
 
 With greater `GRANULARITY` indexes remember the data structure better. The `GRANULARITY` indicates how many granules will be used to construct the index. The more data is provided for the index, the more of it can be handled by one index and the more chances that with the right hyper parameters the index will remember the data structure better. But some indexes can't be built if they don't have enough data, so this granule will always participate in the query. For more information, see the description of indexes.
 
-As the indexes are built only during insertions into table, `INSERT` and `OPTIMIZE` queries are slower than for ordinary table. At this stage indexes remember all the information about the given data. ANNIndexes should be used if you have immutable or rarely changed data and many read requests.
-
-You can create your table with index which uses certain algorithm. Now only indices based on the following algorithms are supported:
+Note that ANN indexes are built during column insertion and merge, i.e. `INSERT` and `OPTIMIZE` statements are slower than for ordinary tables. ANNIndexes are ideally used only with immutable or rarely changing data in conjunction with many read requests.
 
 # Index list
+
 - [Annoy](/docs/en/engines/table-engines/mergetree-family/annindexes.md#annoy-annoy)
 
 # Annoy {#annoy}
-Implementation of the algorithm was taken from [this repository](https://github.com/spotify/annoy).
+
+(currently disabled on ARM due to problems with the algorithm)
+
+This ANN index type implements [Annoy indexes](https://github.com/spotify/annoy).
 
 Short description of the algorithm:
 The algorithm recursively divides in half all space by random linear surfaces (lines in 2D, planes in 3D etc.). Thus it makes tree of polyhedrons and points that they contains. Repeating the operation several times for greater accuracy it creates a forest.
 To find K Nearest Neighbours it goes down through the trees and fills the buffer of closest points using the priority queue of polyhedrons. Next, it sorts buffer and return the nearest K points.
 
-__Examples__:
+Examples:
+
 ```sql
-CREATE TABLE t
+CREATE TABLE table
 (
   id Int64,
-  data Tuple(Float32, Float32, Float32),
-  INDEX ann_index_name data TYPE annoy(NumTrees, DistanceName) GRANULARITY N
+  embedding Tuple(Float32, Float32, Float32),
+  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, NumTrees]]) GRANULARITY N
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
 ```sql
-CREATE TABLE t
+CREATE TABLE table
 (
   id Int64,
-  data Array(Float32),
-  INDEX ann_index_name data TYPE annoy(NumTrees, DistanceName) GRANULARITY N
+  embedding Array(Float32),
+  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, NumTrees]]) GRANULARITY N
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
 :::note
-Table with array field will work faster, but 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(data) = 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(embedding) = 256`.
 :::
 
-Parameter `NumTrees` is the number of trees which the algorithm will create. The bigger it is, the slower (approximately linear) it works (in both `CREATE` and `SELECT` requests), but the better accuracy you get (adjusted for randomness). By default it is set to `100`. Parameter `DistanceName` is name of distance function. By default it is set to `L2Distance`. It can be set without changing first parameter, for example
+Parameter `DistanceName` is name of a distance function with default `L2Distance`. 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.
+
 ```sql
-CREATE TABLE t
+CREATE TABLE table
 (
   id Int64,
-  data Array(Float32),
-  INDEX ann_index_name data TYPE annoy('cosineDistance') GRANULARITY N
+  embedding Array(Float32),
+  INDEX ann_index_name embedding TYPE annoy('cosineDistance') GRANULARITY N
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
-Annoy supports `L2Distance` and `cosineDistance`.
+Annoy currently supports `L2Distance` and `cosineDistance` as distance functions.
 
-Setting `search_k` (default `LIMIT * NumTrees`) determines how many nodes the Annoy index will inspect during SELECT queries. The setting
-can be used to balance performance and accuracy at runtime.
+Setting `annoy_index_search_k_nodes` (default: `NumTrees * LIMIT`) determines how many nodes are inspected during SELECTs. It can be used to
+balance runtime and accuracy at runtime.
+
+Example:
 
-__Example__:
 ``` sql
-SELECT * 
-FROM table_name [WHERE ...] 
-ORDER BY L2Distance(Column, Point) 
+SELECT *
+FROM table_name [WHERE ...]
+ORDER BY L2Distance(column, Point)
 LIMIT N
-SETTING ann_index_select_query_params=`k_search=100`
+SETTINGS annoy_index_search_k_nodes=100
 ```

From 662b0fb822e6e297c1e490fef8e2c09e22f4af09 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:31:33 +0000
Subject: [PATCH 0401/1478] Cosmetics: Unwrap common ANN code from nested
 namespace

---
 src/Storages/MergeTree/CommonANNIndexes.cpp   | 75 +++++++++----------
 src/Storages/MergeTree/CommonANNIndexes.h     | 27 +++----
 .../MergeTree/MergeTreeDataSelectExecutor.cpp |  2 +-
 .../MergeTree/MergeTreeIndexAnnoy.cpp         |  3 +-
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  4 +-
 5 files changed, 50 insertions(+), 61 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 4748c869f83..5c42774fb24 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -24,10 +24,8 @@ namespace ErrorCodes
 namespace
 {
 
-namespace ANN = ApproximateNearestNeighbour;
-
 template <typename Literal>
-void extractTargetVectorFromLiteral(ANN::ANNQueryInformation::Embedding & target, Literal literal)
+void extractTargetVectorFromLiteral(ApproximateNearestNeighborInformation::Embedding & target, Literal literal)
 {
     Float64 float_element_of_target_vector;
     Int64 int_element_of_target_vector;
@@ -43,28 +41,25 @@ void extractTargetVectorFromLiteral(ANN::ANNQueryInformation::Embedding & target
     }
 }
 
-ANN::ANNQueryInformation::Metric castMetricFromStringToType(String metric_name)
+ApproximateNearestNeighborInformation::Metric castMetricFromStringToType(String metric_name)
 {
     if (metric_name == "L2Distance")
-        return ANN::ANNQueryInformation::Metric::L2;
+        return ApproximateNearestNeighborInformation::Metric::L2;
     if (metric_name == "LpDistance")
-        return ANN::ANNQueryInformation::Metric::Lp;
-    return ANN::ANNQueryInformation::Metric::Unknown;
+        return ApproximateNearestNeighborInformation::Metric::Lp;
+    return ApproximateNearestNeighborInformation::Metric::Unknown;
 }
 
 }
 
-namespace ApproximateNearestNeighbour
-{
-
-ANNCondition::ANNCondition(const SelectQueryInfo & query_info,
+ApproximateNearestNeighborCondition::ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
                                  ContextPtr context) :
     block_with_constants{KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context)},
     index_granularity{context->getMergeTreeSettings().get("index_granularity").get<UInt64>()},
     limit_restriction{context->getSettings().get("max_limit_for_ann_queries").get<UInt64>()},
     index_is_useful{checkQueryStructure(query_info)} {}
 
-bool ANNCondition::alwaysUnknownOrTrue(String metric_name) const
+bool ApproximateNearestNeighborCondition::alwaysUnknownOrTrue(String metric_name) const
 {
     if (!index_is_useful)
         return true; // Query isn't supported
@@ -72,64 +67,64 @@ bool ANNCondition::alwaysUnknownOrTrue(String metric_name) const
     return !(castMetricFromStringToType(metric_name) == query_information->metric);
 }
 
-float ANNCondition::getComparisonDistanceForWhereQuery() const
+float ApproximateNearestNeighborCondition::getComparisonDistanceForWhereQuery() const
 {
     if (index_is_useful && query_information.has_value()
-        && query_information->query_type == ANNQueryInformation::Type::Where)
+        && query_information->query_type == ApproximateNearestNeighborInformation::Type::Where)
         return query_information->distance;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Not supported method for this query type");
 }
 
-UInt64 ANNCondition::getLimit() const
+UInt64 ApproximateNearestNeighborCondition::getLimit() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->limit;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "No LIMIT section in query, not supported");
 }
 
-std::vector<float> ANNCondition::getTargetVector() const
+std::vector<float> ApproximateNearestNeighborCondition::getTargetVector() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->target;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Target vector was requested for useless or uninitialized index.");
 }
 
-size_t ANNCondition::getNumOfDimensions() const
+size_t ApproximateNearestNeighborCondition::getNumOfDimensions() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->target.size();
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Number of dimensions was requested for useless or uninitialized index.");
 }
 
-String ANNCondition::getColumnName() const
+String ApproximateNearestNeighborCondition::getColumnName() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->column_name;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Column name was requested for useless or uninitialized index.");
 }
 
-ANNQueryInformation::Metric ANNCondition::getMetricType() const
+ApproximateNearestNeighborInformation::Metric ApproximateNearestNeighborCondition::getMetricType() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->metric;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Metric name was requested for useless or uninitialized index.");
 }
 
-float ANNCondition::getPValueForLpDistance() const
+float ApproximateNearestNeighborCondition::getPValueForLpDistance() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->p_for_lp_dist;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "P from LPDistance was requested for useless or uninitialized index.");
 }
 
-ANNQueryInformation::Type ANNCondition::getQueryType() const
+ApproximateNearestNeighborInformation::Type ApproximateNearestNeighborCondition::getQueryType() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->query_type;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Query type was requested for useless or uninitialized index.");
 }
 
-bool ANNCondition::checkQueryStructure(const SelectQueryInfo & query)
+bool ApproximateNearestNeighborCondition::checkQueryStructure(const SelectQueryInfo & query)
 {
     // RPN-s for different sections of the query
     RPN rpn_prewhere_clause;
@@ -138,9 +133,9 @@ bool ANNCondition::checkQueryStructure(const SelectQueryInfo & query)
     RPNElement rpn_limit;
     UInt64 limit;
 
-    ANNQueryInformation prewhere_info;
-    ANNQueryInformation where_info;
-    ANNQueryInformation order_by_info;
+    ApproximateNearestNeighborInformation prewhere_info;
+    ApproximateNearestNeighborInformation where_info;
+    ApproximateNearestNeighborInformation order_by_info;
 
     // Build rpns for query sections
     const auto & select = query.query->as<ASTSelectQuery &>();
@@ -195,7 +190,7 @@ bool ANNCondition::checkQueryStructure(const SelectQueryInfo & query)
     return query_information.has_value();
 }
 
-void ANNCondition::traverseAST(const ASTPtr & node, RPN & rpn)
+void ApproximateNearestNeighborCondition::traverseAST(const ASTPtr & node, RPN & rpn)
 {
     // If the node is ASTFunction, it may have children nodes
     if (const auto * func = node->as<ASTFunction>())
@@ -214,7 +209,7 @@ void ANNCondition::traverseAST(const ASTPtr & node, RPN & rpn)
     rpn.emplace_back(std::move(element));
 }
 
-bool ANNCondition::traverseAtomAST(const ASTPtr & node, RPNElement & out)
+bool ApproximateNearestNeighborCondition::traverseAtomAST(const ASTPtr & node, RPNElement & out)
 {
     // Match Functions
     if (const auto * function = node->as<ASTFunction>())
@@ -259,7 +254,7 @@ bool ANNCondition::traverseAtomAST(const ASTPtr & node, RPNElement & out)
     return tryCastToConstType(node, out);
 }
 
-bool ANNCondition::tryCastToConstType(const ASTPtr & node, RPNElement & out)
+bool ApproximateNearestNeighborCondition::tryCastToConstType(const ASTPtr & node, RPNElement & out)
 {
     Field const_value;
     DataTypePtr const_type;
@@ -318,18 +313,18 @@ bool ANNCondition::tryCastToConstType(const ASTPtr & node, RPNElement & out)
     return false;
 }
 
-void ANNCondition::traverseOrderByAST(const ASTPtr & node, RPN & rpn)
+void ApproximateNearestNeighborCondition::traverseOrderByAST(const ASTPtr & node, RPN & rpn)
 {
     if (const auto * expr_list = node->as<ASTExpressionList>())
         if (const auto * order_by_element = expr_list->children.front()->as<ASTOrderByElement>())
             traverseAST(order_by_element->children.front(), rpn);
 }
 
-// Returns true and stores ANNQueryInformation if the query has valid WHERE clause
-bool ANNCondition::matchRPNWhere(RPN & rpn, ANNQueryInformation & expr)
+// Returns true and stores ApproximateNearestNeighborInformation if the query has valid WHERE clause
+bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & expr)
 {
     /// Fill query type field
-    expr.query_type = ANNQueryInformation::Type::Where;
+    expr.query_type = ApproximateNearestNeighborInformation::Type::Where;
 
     // WHERE section must have at least 5 expressions
     // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(TargetVector(floats))
@@ -381,10 +376,10 @@ bool ANNCondition::matchRPNWhere(RPN & rpn, ANNQueryInformation & expr)
 }
 
 // Returns true and stores ANNExpr if the query has valid ORDERBY clause
-bool ANNCondition::matchRPNOrderBy(RPN & rpn, ANNQueryInformation & expr)
+bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & expr)
 {
     /// Fill query type field
-    expr.query_type = ANNQueryInformation::Type::OrderBy;
+    expr.query_type = ApproximateNearestNeighborInformation::Type::OrderBy;
 
     // ORDER BY clause must have at least 3 expressions
     if (rpn.size() < 3)
@@ -393,11 +388,11 @@ bool ANNCondition::matchRPNOrderBy(RPN & rpn, ANNQueryInformation & expr)
     auto iter = rpn.begin();
     auto end = rpn.end();
 
-    return ANNCondition::matchMainParts(iter, end, expr);
+    return ApproximateNearestNeighborCondition::matchMainParts(iter, end, expr);
 }
 
 // Returns true and stores Length if we have valid LIMIT clause in query
-bool ANNCondition::matchRPNLimit(RPNElement & rpn, UInt64 & limit)
+bool ApproximateNearestNeighborCondition::matchRPNLimit(RPNElement & rpn, UInt64 & limit)
 {
     if (rpn.function == RPNElement::FUNCTION_INT_LITERAL)
     {
@@ -409,7 +404,7 @@ bool ANNCondition::matchRPNLimit(RPNElement & rpn, UInt64 & limit)
 }
 
 /* Matches dist function, target vector, column name */
-bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ANNQueryInformation & expr)
+bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & expr)
 {
     bool identifier_found = false;
 
@@ -420,7 +415,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
     expr.metric = castMetricFromStringToType(iter->func_name);
     ++iter;
 
-    if (expr.metric == ANN::ANNQueryInformation::Metric::Lp)
+    if (expr.metric == ApproximateNearestNeighborInformation::Metric::Lp)
     {
         if (iter->function != RPNElement::FUNCTION_FLOAT_LITERAL &&
             iter->function != RPNElement::FUNCTION_INT_LITERAL)
@@ -497,7 +492,7 @@ bool ANNCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & en
 }
 
 // Gets float or int from AST node
-float ANNCondition::getFloatOrIntLiteralOrPanic(const RPN::iterator& iter)
+float ApproximateNearestNeighborCondition::getFloatOrIntLiteralOrPanic(const RPN::iterator& iter)
 {
     if (iter->float_literal.has_value())
         return iter->float_literal.value();
@@ -507,5 +502,3 @@ float ANNCondition::getFloatOrIntLiteralOrPanic(const RPN::iterator& iter)
 }
 
 }
-
-}
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 4253bce703a..37695586515 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -9,9 +9,6 @@
 namespace DB
 {
 
-namespace ApproximateNearestNeighbour
-{
-
 /**
  * Queries for Approximate Nearest Neighbour Search
  * have similar structure:
@@ -25,7 +22,7 @@ namespace ApproximateNearestNeighbour
  *    1) p for LpDistance function
  *    2) distance to compare with (only for where queries)
  */
-struct ANNQueryInformation
+struct ApproximateNearestNeighborInformation
 {
     using Embedding = std::vector<float>;
 
@@ -51,7 +48,7 @@ struct ANNQueryInformation
 };
 
 /**
-    Class ANNCondition, is responsible for recognizing special query types which
+    Class ApproximateNearestNeighborCondition, is responsible for recognizing special query types which
     can be speeded up by ANN Indexes. It parses the SQL query and checks
     if it matches ANNIndexes. The recognizing method - alwaysUnknownOrTrue
     returns false if we can speed up the query, and true otherwise.
@@ -87,10 +84,10 @@ struct ANNQueryInformation
     Search query type is also recognized for PREWHERE clause
 */
 
-class ANNCondition
+class ApproximateNearestNeighborCondition
 {
 public:
-    ANNCondition(const SelectQueryInfo & query_info,
+    ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
                     ContextPtr context);
 
     // false if query can be speeded up, true otherwise
@@ -107,12 +104,12 @@ public:
 
     String getColumnName() const;
 
-    ANNQueryInformation::Metric getMetricType() const;
+    ApproximateNearestNeighborInformation::Metric getMetricType() const;
 
     // the P- value if the metric is 'LpDistance'
     float getPValueForLpDistance() const;
 
-    ANNQueryInformation::Type getQueryType() const;
+    ApproximateNearestNeighborInformation::Type getQueryType() const;
 
     UInt64 getIndexGranularity() const { return index_granularity; }
 
@@ -191,16 +188,16 @@ private:
     void traverseOrderByAST(const ASTPtr & node, RPN & rpn);
 
     // Returns true and stores ANNExpr if the query has valid WHERE section
-    static bool matchRPNWhere(RPN & rpn, ANNQueryInformation & expr);
+    static bool matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & expr);
 
     // Returns true and stores ANNExpr if the query has valid ORDERBY section
-    static bool matchRPNOrderBy(RPN & rpn, ANNQueryInformation & expr);
+    static bool matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & expr);
 
     // Returns true and stores Length if we have valid LIMIT clause in query
     static bool matchRPNLimit(RPNElement & rpn, UInt64 & limit);
 
     /* Matches dist function, target vector, column name */
-    static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ANNQueryInformation & expr);
+    static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & expr);
 
     // Gets float or int from AST node
     static float getFloatOrIntLiteralOrPanic(const RPN::iterator& iter);
@@ -208,7 +205,7 @@ private:
     Block block_with_constants;
 
     // true if we have one of two supported query types
-    std::optional<ANNQueryInformation> query_information;
+    std::optional<ApproximateNearestNeighborInformation> query_information;
 
     // Get from settings ANNIndex parameters
     UInt64 index_granularity;
@@ -218,12 +215,10 @@ private:
 };
 
 // condition interface for Ann indexes. Returns vector of indexes of ranges in granule which are useful for query.
-class IMergeTreeIndexConditionAnn : public IMergeTreeIndexCondition
+class IMergeTreeIndexConditionApproximateNearestNeighbor : public IMergeTreeIndexCondition
 {
 public:
     virtual std::vector<size_t> getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const = 0;
 };
 
 }
-
-}
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index aa340d6afc1..3d290ea12ac 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -1687,7 +1687,7 @@ MarkRanges MergeTreeDataSelectExecutor::filterMarksUsingIndex(
             if (index_mark != index_range.begin || !granule || last_index_mark != index_range.begin)
                 granule = reader.read();
             // Cast to Ann condition
-            auto ann_condition = std::dynamic_pointer_cast<ApproximateNearestNeighbour::IMergeTreeIndexConditionAnn>(condition);
+            auto ann_condition = std::dynamic_pointer_cast<IMergeTreeIndexConditionApproximateNearestNeighbor>(condition);
             if (ann_condition != nullptr)
             {
                 // vector of indexes of useful ranges
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index fe3ea322b91..190f76fba5e 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -240,7 +240,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 {
     UInt64 limit = condition.getLimit();
     UInt64 index_granularity = condition.getIndexGranularity();
-    std::optional<float> comp_dist = condition.getQueryType() == ApproximateNearestNeighbour::ANNQueryInformation::Type::Where
+    std::optional<float> comp_dist = condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
         ? std::optional<float>(condition.getComparisonDistanceForWhereQuery())
         : std::nullopt;
 
@@ -267,6 +267,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     distances.reserve(limit);
 
     annoy->get_nns_by_vector(target_vec.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
+
     std::unordered_set<size_t> granule_numbers;
     for (size_t i = 0; i < neighbors.size(); ++i)
     {
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index fbc6b21fa6b..95041ea31fb 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -60,7 +60,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 };
 
 
-class MergeTreeIndexConditionAnnoy final : public ApproximateNearestNeighbour::IMergeTreeIndexConditionAnn
+class MergeTreeIndexConditionAnnoy final : public IMergeTreeIndexConditionApproximateNearestNeighbor
 {
 public:
     MergeTreeIndexConditionAnnoy(
@@ -81,7 +81,7 @@ private:
     template <typename Distance>
     std::vector<size_t> getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const;
 
-    const ApproximateNearestNeighbour::ANNCondition condition;
+    const ApproximateNearestNeighborCondition condition;
     const String distance_function;
     const Int64 search_k;
 };

From 999e4c33065279f4337387ece0343da36ca03098 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:37:20 +0000
Subject: [PATCH 0402/1478] Cosmetics: Less generic variable naming

---
 src/Storages/MergeTree/CommonANNIndexes.cpp | 52 ++++++++++-----------
 src/Storages/MergeTree/CommonANNIndexes.h   |  6 +--
 2 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 5c42774fb24..669055068b8 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -321,10 +321,10 @@ void ApproximateNearestNeighborCondition::traverseOrderByAST(const ASTPtr & node
 }
 
 // Returns true and stores ApproximateNearestNeighborInformation if the query has valid WHERE clause
-bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & expr)
+bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
-    expr.query_type = ApproximateNearestNeighborInformation::Type::Where;
+    ann_info.query_type = ApproximateNearestNeighborInformation::Type::Where;
 
     // WHERE section must have at least 5 expressions
     // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(TargetVector(floats))
@@ -347,9 +347,9 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
         if (iter->function != RPNElement::FUNCTION_FLOAT_LITERAL)
             return false;
 
-        expr.distance = getFloatOrIntLiteralOrPanic(iter);
-        if (expr.distance < 0)
-            throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", expr.distance);
+        ann_info.distance = getFloatOrIntLiteralOrPanic(iter);
+        if (ann_info.distance < 0)
+            throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", ann_info.distance);
 
         ++iter;
 
@@ -358,17 +358,17 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
         return false;
 
     auto end = rpn.end();
-    if (!matchMainParts(iter, end, expr))
+    if (!matchMainParts(iter, end, ann_info))
         return false;
 
     if (greater_case)
     {
-        if (expr.target.size() < 2)
+        if (ann_info.target.size() < 2)
             return false;
-        expr.distance = expr.target.back();
-        if (expr.distance < 0)
-            throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", expr.distance);
-        expr.target.pop_back();
+        ann_info.distance = ann_info.target.back();
+        if (ann_info.distance < 0)
+            throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", ann_info.distance);
+        ann_info.target.pop_back();
     }
 
     // query is ok
@@ -376,10 +376,10 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
 }
 
 // Returns true and stores ANNExpr if the query has valid ORDERBY clause
-bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & expr)
+bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
-    expr.query_type = ApproximateNearestNeighborInformation::Type::OrderBy;
+    ann_info.query_type = ApproximateNearestNeighborInformation::Type::OrderBy;
 
     // ORDER BY clause must have at least 3 expressions
     if (rpn.size() < 3)
@@ -388,7 +388,7 @@ bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, Approximate
     auto iter = rpn.begin();
     auto end = rpn.end();
 
-    return ApproximateNearestNeighborCondition::matchMainParts(iter, end, expr);
+    return ApproximateNearestNeighborCondition::matchMainParts(iter, end, ann_info);
 }
 
 // Returns true and stores Length if we have valid LIMIT clause in query
@@ -404,7 +404,7 @@ bool ApproximateNearestNeighborCondition::matchRPNLimit(RPNElement & rpn, UInt64
 }
 
 /* Matches dist function, target vector, column name */
-bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & expr)
+bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info)
 {
     bool identifier_found = false;
 
@@ -412,22 +412,22 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     if (iter->function != RPNElement::FUNCTION_DISTANCE)
         return false;
 
-    expr.metric = castMetricFromStringToType(iter->func_name);
+    ann_info.metric = castMetricFromStringToType(iter->func_name);
     ++iter;
 
-    if (expr.metric == ApproximateNearestNeighborInformation::Metric::Lp)
+    if (ann_info.metric == ApproximateNearestNeighborInformation::Metric::Lp)
     {
         if (iter->function != RPNElement::FUNCTION_FLOAT_LITERAL &&
             iter->function != RPNElement::FUNCTION_INT_LITERAL)
             return false;
-        expr.p_for_lp_dist = getFloatOrIntLiteralOrPanic(iter);
+        ann_info.p_for_lp_dist = getFloatOrIntLiteralOrPanic(iter);
         ++iter;
     }
 
     if (iter->function == RPNElement::FUNCTION_IDENTIFIER)
     {
         identifier_found = true;
-        expr.column_name = std::move(iter->identifier.value());
+        ann_info.column_name = std::move(iter->identifier.value());
         ++iter;
     }
 
@@ -436,13 +436,13 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
     {
-        extractTargetVectorFromLiteral(expr.target, iter->tuple_literal);
+        extractTargetVectorFromLiteral(ann_info.target, iter->tuple_literal);
         ++iter;
     }
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
     {
-        extractTargetVectorFromLiteral(expr.target, iter->array_literal);
+        extractTargetVectorFromLiteral(ann_info.target, iter->array_literal);
         ++iter;
     }
 
@@ -457,12 +457,12 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
         ++iter;
         if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
         {
-            extractTargetVectorFromLiteral(expr.target, iter->tuple_literal);
+            extractTargetVectorFromLiteral(ann_info.target, iter->tuple_literal);
             ++iter;
         }
         else if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
         {
-            extractTargetVectorFromLiteral(expr.target, iter->array_literal);
+            extractTargetVectorFromLiteral(ann_info.target, iter->array_literal);
             ++iter;
         }
         else
@@ -473,12 +473,12 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     {
         if (iter->function == RPNElement::FUNCTION_FLOAT_LITERAL ||
             iter->function == RPNElement::FUNCTION_INT_LITERAL)
-            expr.target.emplace_back(getFloatOrIntLiteralOrPanic(iter));
+            ann_info.target.emplace_back(getFloatOrIntLiteralOrPanic(iter));
         else if (iter->function == RPNElement::FUNCTION_IDENTIFIER)
         {
             if (identifier_found)
                 return false;
-            expr.column_name = std::move(iter->identifier.value());
+            ann_info.column_name = std::move(iter->identifier.value());
             identifier_found = true;
         }
         else
@@ -488,7 +488,7 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     }
 
     // Final checks of correctness
-    return identifier_found && !expr.target.empty();
+    return identifier_found && !ann_info.target.empty();
 }
 
 // Gets float or int from AST node
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 37695586515..0b207585048 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -188,16 +188,16 @@ private:
     void traverseOrderByAST(const ASTPtr & node, RPN & rpn);
 
     // Returns true and stores ANNExpr if the query has valid WHERE section
-    static bool matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & expr);
+    static bool matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & ann_info);
 
     // Returns true and stores ANNExpr if the query has valid ORDERBY section
-    static bool matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & expr);
+    static bool matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & ann_info);
 
     // Returns true and stores Length if we have valid LIMIT clause in query
     static bool matchRPNLimit(RPNElement & rpn, UInt64 & limit);
 
     /* Matches dist function, target vector, column name */
-    static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & expr);
+    static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info);
 
     // Gets float or int from AST node
     static float getFloatOrIntLiteralOrPanic(const RPN::iterator& iter);

From 567d54a26848ba0f5bf4ad38d226def02a92280b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:38:00 +0000
Subject: [PATCH 0403/1478] Cosmetics: more constness

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

diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 0b207585048..68ed217ef45 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -208,9 +208,9 @@ private:
     std::optional<ApproximateNearestNeighborInformation> query_information;
 
     // Get from settings ANNIndex parameters
-    UInt64 index_granularity;
+    const UInt64 index_granularity;
     /// only queries with a lower limit can be considered to avoid memory overflow
-    UInt64 limit_restriction;
+    const UInt64 limit_restriction;
     bool index_is_useful = false;
 };
 

From 6fe208832d6c3ba8340fd73d5728efad567188ba Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:42:46 +0000
Subject: [PATCH 0404/1478] Cosmetics: target vector --> reference vector

---
 src/Storages/MergeTree/CommonANNIndexes.cpp   | 48 +++++++++----------
 src/Storages/MergeTree/CommonANNIndexes.h     | 22 ++++-----
 .../MergeTree/MergeTreeIndexAnnoy.cpp         |  6 +--
 3 files changed, 38 insertions(+), 38 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 669055068b8..20707a148ae 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -25,19 +25,19 @@ namespace
 {
 
 template <typename Literal>
-void extractTargetVectorFromLiteral(ApproximateNearestNeighborInformation::Embedding & target, Literal literal)
+void extraceReferenceVectorFromLiteral(ApproximateNearestNeighborInformation::Embedding & reference_vector, Literal literal)
 {
-    Float64 float_element_of_target_vector;
-    Int64 int_element_of_target_vector;
+    Float64 float_element_of_reference_vector;
+    Int64 int_element_of_reference_vector;
 
     for (const auto & value : literal.value())
     {
-        if (value.tryGet(float_element_of_target_vector))
-            target.emplace_back(float_element_of_target_vector);
-        else if (value.tryGet(int_element_of_target_vector))
-            target.emplace_back(static_cast<float>(int_element_of_target_vector));
+        if (value.tryGet(float_element_of_reference_vector))
+            reference_vector.emplace_back(float_element_of_reference_vector);
+        else if (value.tryGet(int_element_of_reference_vector))
+            reference_vector.emplace_back(static_cast<float>(int_element_of_reference_vector));
         else
-            throw Exception(ErrorCodes::INCORRECT_QUERY, "Wrong type of elements in target vector. Only float or int are supported.");
+            throw Exception(ErrorCodes::INCORRECT_QUERY, "Wrong type of elements in reference vector. Only float or int are supported.");
     }
 }
 
@@ -82,17 +82,17 @@ UInt64 ApproximateNearestNeighborCondition::getLimit() const
     throw Exception(ErrorCodes::LOGICAL_ERROR, "No LIMIT section in query, not supported");
 }
 
-std::vector<float> ApproximateNearestNeighborCondition::getTargetVector() const
+std::vector<float> ApproximateNearestNeighborCondition::getReferenceVector() const
 {
     if (index_is_useful && query_information.has_value())
-        return query_information->target;
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "Target vector was requested for useless or uninitialized index.");
+        return query_information->reference_vector;
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "Reference vector was requested for useless or uninitialized index.");
 }
 
 size_t ApproximateNearestNeighborCondition::getNumOfDimensions() const
 {
     if (index_is_useful && query_information.has_value())
-        return query_information->target.size();
+        return query_information->reference_vector.size();
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Number of dimensions was requested for useless or uninitialized index.");
 }
 
@@ -327,7 +327,7 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
     ann_info.query_type = ApproximateNearestNeighborInformation::Type::Where;
 
     // WHERE section must have at least 5 expressions
-    // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(TargetVector(floats))
+    // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(ReferenceVector(floats))
     if (rpn.size() < 5)
         return false;
 
@@ -363,12 +363,12 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
 
     if (greater_case)
     {
-        if (ann_info.target.size() < 2)
+        if (ann_info.reference_vector.size() < 2)
             return false;
-        ann_info.distance = ann_info.target.back();
+        ann_info.distance = ann_info.reference_vector.back();
         if (ann_info.distance < 0)
             throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance can't be negative. Got {}", ann_info.distance);
-        ann_info.target.pop_back();
+        ann_info.reference_vector.pop_back();
     }
 
     // query is ok
@@ -403,12 +403,12 @@ bool ApproximateNearestNeighborCondition::matchRPNLimit(RPNElement & rpn, UInt64
     return false;
 }
 
-/* Matches dist function, target vector, column name */
+/* Matches dist function, referencer vector, column name */
 bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info)
 {
     bool identifier_found = false;
 
-    // Matches DistanceFunc->[Column]->[Tuple(array)Func]->TargetVector(floats)->[Column]
+    // Matches DistanceFunc->[Column]->[Tuple(array)Func]->ReferenceVector(floats)->[Column]
     if (iter->function != RPNElement::FUNCTION_DISTANCE)
         return false;
 
@@ -436,13 +436,13 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
     {
-        extractTargetVectorFromLiteral(ann_info.target, iter->tuple_literal);
+        extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
         ++iter;
     }
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
     {
-        extractTargetVectorFromLiteral(ann_info.target, iter->array_literal);
+        extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
         ++iter;
     }
 
@@ -457,12 +457,12 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
         ++iter;
         if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
         {
-            extractTargetVectorFromLiteral(ann_info.target, iter->tuple_literal);
+            extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
             ++iter;
         }
         else if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
         {
-            extractTargetVectorFromLiteral(ann_info.target, iter->array_literal);
+            extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
             ++iter;
         }
         else
@@ -473,7 +473,7 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     {
         if (iter->function == RPNElement::FUNCTION_FLOAT_LITERAL ||
             iter->function == RPNElement::FUNCTION_INT_LITERAL)
-            ann_info.target.emplace_back(getFloatOrIntLiteralOrPanic(iter));
+            ann_info.reference_vector.emplace_back(getFloatOrIntLiteralOrPanic(iter));
         else if (iter->function == RPNElement::FUNCTION_IDENTIFIER)
         {
             if (identifier_found)
@@ -488,7 +488,7 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     }
 
     // Final checks of correctness
-    return identifier_found && !ann_info.target.empty();
+    return identifier_found && !ann_info.reference_vector.empty();
 }
 
 // Gets float or int from AST node
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 68ed217ef45..9c075139707 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -12,7 +12,7 @@ namespace DB
 /**
  * Queries for Approximate Nearest Neighbour Search
  * have similar structure:
- *    1) target vector from which all distances are calculated
+ *    1) reference vector from which all distances are calculated
  *    2) metric name (e.g L2Distance, LpDistance, etc.)
  *    3) name of column with embeddings
  *    4) type of query
@@ -27,7 +27,7 @@ struct ApproximateNearestNeighborInformation
     using Embedding = std::vector<float>;
 
     // Extracted data from valid query
-    Embedding target;
+    Embedding reference_vector;
     enum class Metric
     {
         Unknown,
@@ -56,14 +56,14 @@ struct ApproximateNearestNeighborInformation
     There are two main patterns of queries being supported
 
     1) Search query type
-    SELECT * FROM * WHERE DistanceFunc(column, target_vector) < floatLiteral LIMIT count
+    SELECT * FROM * WHERE DistanceFunc(column, reference) < floatLiteral LIMIT count
 
     2) OrderBy query type
-    SELECT * FROM * WHERE * ORDERBY DistanceFunc(column, target_vector) LIMIT count
+    SELECT * FROM * WHERE * ORDERBY DistanceFunc(column, reference) LIMIT count
 
     *Query without LIMIT count is not supported*
 
-    target_vector(should have float coordinates) examples:
+    reference(should have float coordinates) examples:
         tuple(0.1, 0.1, ...., 0.1) or (0.1, 0.1, ...., 0.1)
         [the word tuple is not needed]
 
@@ -72,11 +72,11 @@ struct ApproximateNearestNeighborInformation
     returns true.
 
     From matching query it extracts
-    * targetVector
+    * referenceVector
     * metricName(DistanceFunction)
     * dimension size if query uses LpDistance
     * distance to compare(ONLY for search types, otherwise you get exception)
-    * spaceDimension(which is targetVector's components count)
+    * spaceDimension(which is reference vector's components count)
     * column
     * objects count from LIMIT clause(for both queries)
     * queryHasOrderByClause and queryHasWhereClause return true if query matches the type
@@ -96,10 +96,10 @@ public:
     // returns the distance to compare with for search query
     float getComparisonDistanceForWhereQuery() const;
 
-    // distance should be calculated regarding to targetVector
-    std::vector<float> getTargetVector() const;
+    // distance should be calculated regarding to reference vector
+    std::vector<float> getReferenceVector() const;
 
-    // targetVector dimension size
+    // reference vector's dimension size
     size_t getNumOfDimensions() const;
 
     String getColumnName() const;
@@ -196,7 +196,7 @@ private:
     // Returns true and stores Length if we have valid LIMIT clause in query
     static bool matchRPNLimit(RPNElement & rpn, UInt64 & limit);
 
-    /* Matches dist function, target vector, column name */
+    /* Matches dist function, reference vector, column name */
     static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info);
 
     // Gets float or int from AST node
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 190f76fba5e..9dcfd421ba5 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -247,7 +247,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     if (comp_dist && comp_dist.value() < 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to optimize query with where without distance");
 
-    std::vector<float> target_vec = condition.getTargetVector();
+    std::vector<float> reference_vector = condition.getReferenceVector();
 
     auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance>>(idx_granule);
     if (granule == nullptr)
@@ -260,13 +260,13 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
                         "does not match with the dimension in the index ({})",
                         toString(condition.getNumOfDimensions()), toString(annoy->getNumOfDimensions()));
 
-    /// neighbors contain indexes of dots which were closest to target vector
+    /// neighbors contain indexes of dots which were closest to the reference vector
     std::vector<UInt64> neighbors;
     std::vector<Float32> distances;
     neighbors.reserve(limit);
     distances.reserve(limit);
 
-    annoy->get_nns_by_vector(target_vec.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
+    annoy->get_nns_by_vector(reference_vector.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
 
     std::unordered_set<size_t> granule_numbers;
     for (size_t i = 0; i < neighbors.size(); ++i)

From 8cc382121a3b7580136eaf7514957dd0e08f3283 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:48:36 +0000
Subject: [PATCH 0405/1478] Cosmetics: Update comments

---
 src/Storages/MergeTree/CommonANNIndexes.cpp |  57 ++++----
 src/Storages/MergeTree/CommonANNIndexes.h   | 152 ++++++++++----------
 2 files changed, 103 insertions(+), 106 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 20707a148ae..f4a0e9bf728 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -126,7 +126,7 @@ ApproximateNearestNeighborInformation::Type ApproximateNearestNeighborCondition:
 
 bool ApproximateNearestNeighborCondition::checkQueryStructure(const SelectQueryInfo & query)
 {
-    // RPN-s for different sections of the query
+    /// RPN-s for different sections of the query
     RPN rpn_prewhere_clause;
     RPN rpn_where_clause;
     RPN rpn_order_by_clause;
@@ -137,47 +137,50 @@ bool ApproximateNearestNeighborCondition::checkQueryStructure(const SelectQueryI
     ApproximateNearestNeighborInformation where_info;
     ApproximateNearestNeighborInformation order_by_info;
 
-    // Build rpns for query sections
+    /// Build rpns for query sections
     const auto & select = query.query->as<ASTSelectQuery &>();
 
-    if (select.prewhere()) // If query has PREWHERE clause
+    /// If query has PREWHERE clause
+    if (select.prewhere())
         traverseAST(select.prewhere(), rpn_prewhere_clause);
 
-    if (select.where()) // If query has WHERE clause
+    /// If query has WHERE clause
+    if (select.where())
         traverseAST(select.where(), rpn_where_clause);
 
-    if (select.limitLength()) // If query has LIMIT clause
+    /// If query has LIMIT clause
+    if (select.limitLength())
         traverseAtomAST(select.limitLength(), rpn_limit);
 
     if (select.orderBy()) // If query has ORDERBY clause
         traverseOrderByAST(select.orderBy(), rpn_order_by_clause);
 
-    // Reverse RPNs for conveniences during parsing
+    /// Reverse RPNs for conveniences during parsing
     std::reverse(rpn_prewhere_clause.begin(), rpn_prewhere_clause.end());
     std::reverse(rpn_where_clause.begin(), rpn_where_clause.end());
     std::reverse(rpn_order_by_clause.begin(), rpn_order_by_clause.end());
 
-    // Match rpns with supported types and extract information
+    /// Match rpns with supported types and extract information
     const bool prewhere_is_valid = matchRPNWhere(rpn_prewhere_clause, prewhere_info);
     const bool where_is_valid = matchRPNWhere(rpn_where_clause, where_info);
     const bool order_by_is_valid = matchRPNOrderBy(rpn_order_by_clause, order_by_info);
     const bool limit_is_valid = matchRPNLimit(rpn_limit, limit);
 
-    // Query without a LIMIT clause or with a limit greater than a restriction is not supported
+    /// Query without a LIMIT clause or with a limit greater than a restriction is not supported
     if (!limit_is_valid || limit_restriction < limit)
         return false;
 
-    // Search type query in both sections isn't supported
+    /// Search type query in both sections isn't supported
     if (prewhere_is_valid && where_is_valid)
         return false;
 
-    // Search type should be in WHERE or PREWHERE clause
+    /// Search type should be in WHERE or PREWHERE clause
     if (prewhere_is_valid || where_is_valid)
         query_information = std::move(prewhere_is_valid ? prewhere_info : where_info);
 
     if (order_by_is_valid)
     {
-        // Query with valid where and order by type is not supported
+        /// Query with valid where and order by type is not supported
         if (query_information.has_value())
             return false;
 
@@ -202,7 +205,7 @@ void ApproximateNearestNeighborCondition::traverseAST(const ASTPtr & node, RPN &
     }
 
     RPNElement element;
-    // Get the data behind node
+    /// Get the data behind node
     if (!traverseAtomAST(node, element))
         element.function = RPNElement::FUNCTION_UNKNOWN;
 
@@ -211,10 +214,10 @@ void ApproximateNearestNeighborCondition::traverseAST(const ASTPtr & node, RPN &
 
 bool ApproximateNearestNeighborCondition::traverseAtomAST(const ASTPtr & node, RPNElement & out)
 {
-    // Match Functions
+    /// Match Functions
     if (const auto * function = node->as<ASTFunction>())
     {
-        // Set the name
+        /// Set the name
         out.func_name = function->name;
 
         if (function->name == "L1Distance" ||
@@ -240,7 +243,7 @@ bool ApproximateNearestNeighborCondition::traverseAtomAST(const ASTPtr & node, R
 
         return true;
     }
-    // Match identifier
+    /// Match identifier
     else if (const auto * identifier = node->as<ASTIdentifier>())
     {
         out.function = RPNElement::FUNCTION_IDENTIFIER;
@@ -250,7 +253,7 @@ bool ApproximateNearestNeighborCondition::traverseAtomAST(const ASTPtr & node, R
         return true;
     }
 
-    // Check if we have constants behind the node
+    /// Check if we have constants behind the node
     return tryCastToConstType(node, out);
 }
 
@@ -320,20 +323,20 @@ void ApproximateNearestNeighborCondition::traverseOrderByAST(const ASTPtr & node
             traverseAST(order_by_element->children.front(), rpn);
 }
 
-// Returns true and stores ApproximateNearestNeighborInformation if the query has valid WHERE clause
+/// Returns true and stores ApproximateNearestNeighborInformation if the query has valid WHERE clause
 bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
     ann_info.query_type = ApproximateNearestNeighborInformation::Type::Where;
 
-    // WHERE section must have at least 5 expressions
-    // Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(ReferenceVector(floats))
+    /// WHERE section must have at least 5 expressions
+    /// Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(ReferenceVector(floats))
     if (rpn.size() < 5)
         return false;
 
     auto iter = rpn.begin();
 
-    // Query starts from operator less
+    /// Query starts from operator less
     if (iter->function != RPNElement::FUNCTION_COMPARISON)
         return false;
 
@@ -371,11 +374,11 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
         ann_info.reference_vector.pop_back();
     }
 
-    // query is ok
+    /// query is ok
     return true;
 }
 
-// Returns true and stores ANNExpr if the query has valid ORDERBY clause
+/// Returns true and stores ANNExpr if the query has valid ORDERBY clause
 bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
@@ -391,7 +394,7 @@ bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, Approximate
     return ApproximateNearestNeighborCondition::matchMainParts(iter, end, ann_info);
 }
 
-// Returns true and stores Length if we have valid LIMIT clause in query
+/// Returns true and stores Length if we have valid LIMIT clause in query
 bool ApproximateNearestNeighborCondition::matchRPNLimit(RPNElement & rpn, UInt64 & limit)
 {
     if (rpn.function == RPNElement::FUNCTION_INT_LITERAL)
@@ -403,12 +406,12 @@ bool ApproximateNearestNeighborCondition::matchRPNLimit(RPNElement & rpn, UInt64
     return false;
 }
 
-/* Matches dist function, referencer vector, column name */
+/// Matches dist function, referencer vector, column name
 bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info)
 {
     bool identifier_found = false;
 
-    // Matches DistanceFunc->[Column]->[Tuple(array)Func]->ReferenceVector(floats)->[Column]
+    /// Matches DistanceFunc->[Column]->[Tuple(array)Func]->ReferenceVector(floats)->[Column]
     if (iter->function != RPNElement::FUNCTION_DISTANCE)
         return false;
 
@@ -487,11 +490,11 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
         ++iter;
     }
 
-    // Final checks of correctness
+    /// Final checks of correctness
     return identifier_found && !ann_info.reference_vector.empty();
 }
 
-// Gets float or int from AST node
+/// Gets float or int from AST node
 float ApproximateNearestNeighborCondition::getFloatOrIntLiteralOrPanic(const RPN::iterator& iter)
 {
     if (iter->float_literal.has_value())
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 9c075139707..2ac9384a884 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -9,31 +9,31 @@
 namespace DB
 {
 
-/**
- * Queries for Approximate Nearest Neighbour Search
- * have similar structure:
- *    1) reference vector from which all distances are calculated
- *    2) metric name (e.g L2Distance, LpDistance, etc.)
- *    3) name of column with embeddings
- *    4) type of query
- *    5) Number of elements, that should be taken (limit)
- *
- * And two optional parameters:
- *    1) p for LpDistance function
- *    2) distance to compare with (only for where queries)
- */
+/// Approximate Nearest Neighbour queries have a similar structure:
+/// - reference vector from which all distances are calculated
+/// - metric name (e.g L2Distance, LpDistance, etc.)
+/// - name of column with embeddings
+/// - type of query
+/// - maximum number of returned elements (LIMIT)
+///
+/// And two optional parameters:
+/// - p for LpDistance function
+/// - distance to compare with (only for where queries)
+///
+/// This struct holds all these components.
 struct ApproximateNearestNeighborInformation
 {
     using Embedding = std::vector<float>;
-
-    // Extracted data from valid query
     Embedding reference_vector;
+
     enum class Metric
     {
         Unknown,
         L2,
         Lp
-    } metric;
+    };
+    Metric metric;
+
     String column_name;
     UInt64 limit;
 
@@ -41,79 +41,71 @@ struct ApproximateNearestNeighborInformation
     {
         OrderBy,
         Where
-    } query_type;
+    };
+    Type query_type;
 
     float p_for_lp_dist = -1.0;
     float distance = -1.0;
 };
 
-/**
-    Class ApproximateNearestNeighborCondition, is responsible for recognizing special query types which
-    can be speeded up by ANN Indexes. It parses the SQL query and checks
-    if it matches ANNIndexes. The recognizing method - alwaysUnknownOrTrue
-    returns false if we can speed up the query, and true otherwise.
-    It has only one argument, name of the metric with which index was built.
-    There are two main patterns of queries being supported
-
-    1) Search query type
-    SELECT * FROM * WHERE DistanceFunc(column, reference) < floatLiteral LIMIT count
-
-    2) OrderBy query type
-    SELECT * FROM * WHERE * ORDERBY DistanceFunc(column, reference) LIMIT count
-
-    *Query without LIMIT count is not supported*
-
-    reference(should have float coordinates) examples:
-        tuple(0.1, 0.1, ...., 0.1) or (0.1, 0.1, ...., 0.1)
-        [the word tuple is not needed]
-
-    If the query matches one of these two types, than the class extracts useful information
-    from the query. If the query has both 1 and 2 types, than we can't speed and alwaysUnknownOrTrue
-    returns true.
-
-    From matching query it extracts
-    * referenceVector
-    * metricName(DistanceFunction)
-    * dimension size if query uses LpDistance
-    * distance to compare(ONLY for search types, otherwise you get exception)
-    * spaceDimension(which is reference vector's components count)
-    * column
-    * objects count from LIMIT clause(for both queries)
-    * queryHasOrderByClause and queryHasWhereClause return true if query matches the type
-
-    Search query type is also recognized for PREWHERE clause
-*/
 
+// Class ANNCondition, is responsible for recognizing if the query is an ANN queries which can utilize ANN indexes. It parses the SQL query
+/// and checks if it matches ANNIndexes. Method alwaysUnknownOrTrue returns false if we can speed up the query, and true otherwise. It has
+/// only one argument, the name of the metric with which index was built. Two main patterns of queries are supported
+///
+/// - 1. WHERE queries:
+///   SELECT * FROM * WHERE DistanceFunc(column, reference_vector) < floatLiteral LIMIT count
+///
+/// - 2. ORDER BY queries:
+///   SELECT * FROM * WHERE * ORDER BY DistanceFunc(column, reference_vector) LIMIT count
+///
+/// Queries without LIMIT count are not supported
+/// If the query is both of type 1. and 2., than we can't use the index and alwaysUnknownOrTrue returns true.
+/// reference_vector should have float coordinates, e.g. (0.2, 0.1, .., 0.5)
+///
+/// If the query matches one of these two types, then this class extracts the main information needed for ANN indexes from the query.
+///
+/// From matching query it extracts
+/// - referenceVector
+/// - metricName(DistanceFunction)
+/// - dimension size if query uses LpDistance
+/// - distance to compare(ONLY for search types, otherwise you get exception)
+/// - spaceDimension(which is referenceVector's components count)
+/// - column
+/// - objects count from LIMIT clause(for both queries)
+/// - queryHasOrderByClause and queryHasWhereClause return true if query matches the type
+///
+/// Search query type is also recognized for PREWHERE clause
 class ApproximateNearestNeighborCondition
 {
 public:
     ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
                     ContextPtr context);
 
-    // false if query can be speeded up, true otherwise
+    /// Returns false if query can be speeded up by an ANN index, true otherwise.
     bool alwaysUnknownOrTrue(String metric_name) const;
 
-    // returns the distance to compare with for search query
+    /// Returns the distance to compare with for search query
     float getComparisonDistanceForWhereQuery() const;
 
-    // distance should be calculated regarding to reference vector
+    /// Distance should be calculated regarding to referenceVector
     std::vector<float> getReferenceVector() const;
 
-    // reference vector's dimension size
+    /// Reference vector's dimension size
     size_t getNumOfDimensions() const;
 
     String getColumnName() const;
 
     ApproximateNearestNeighborInformation::Metric getMetricType() const;
 
-    // the P- value if the metric is 'LpDistance'
+    /// The P- value if the metric is 'LpDistance'
     float getPValueForLpDistance() const;
 
     ApproximateNearestNeighborInformation::Type getQueryType() const;
 
     UInt64 getIndexGranularity() const { return index_granularity; }
 
-    // length's value from LIMIT clause
+    /// Length's value from LIMIT clause
     UInt64 getLimit() const;
 
 private:
@@ -121,7 +113,7 @@ private:
     {
         enum Function
         {
-            // DistanceFunctions
+            /// DistanceFunctions
             FUNCTION_DISTANCE,
 
             //tuple(0.1, ..., 0.1)
@@ -130,31 +122,31 @@ private:
             //array(0.1, ..., 0.1)
             FUNCTION_ARRAY,
 
-            // Operators <, >, <=, >=
+            /// Operators <, >, <=, >=
             FUNCTION_COMPARISON,
 
-            // Numeric float value
+            /// Numeric float value
             FUNCTION_FLOAT_LITERAL,
 
-            // Numeric int value
+            /// Numeric int value
             FUNCTION_INT_LITERAL,
 
-            // Column identifier
+            /// Column identifier
             FUNCTION_IDENTIFIER,
 
-            // Unknown, can be any value
+            /// Unknown, can be any value
             FUNCTION_UNKNOWN,
 
-            // (0.1, ...., 0.1) vector without word 'tuple'
+            /// (0.1, ...., 0.1) vector without word 'tuple'
             FUNCTION_LITERAL_TUPLE,
 
-            // [0.1, ...., 0.1] vector without word 'array'
+            /// [0.1, ...., 0.1] vector without word 'array'
             FUNCTION_LITERAL_ARRAY,
 
-            // if client parameters are used, cast will always be in the query
+            /// if client parameters are used, cast will always be in the query
             FUNCTION_CAST,
 
-            // name of type in cast function
+            /// name of type in cast function
             FUNCTION_STRING_LITERAL,
         };
 
@@ -178,33 +170,33 @@ private:
 
     bool checkQueryStructure(const SelectQueryInfo & query);
 
-    // Util functions for the traversal of AST, parses AST and builds rpn
+    /// Util functions for the traversal of AST, parses AST and builds rpn
     void traverseAST(const ASTPtr & node, RPN & rpn);
-    // Return true if we can identify our node type
+    /// Return true if we can identify our node type
     bool traverseAtomAST(const ASTPtr & node, RPNElement & out);
-    // Checks if the AST stores ConstType expression
+    /// Checks if the AST stores ConstType expression
     bool tryCastToConstType(const ASTPtr & node, RPNElement & out);
-    // Traverses the AST of ORDERBY section
+    /// Traverses the AST of ORDERBY section
     void traverseOrderByAST(const ASTPtr & node, RPN & rpn);
 
-    // Returns true and stores ANNExpr if the query has valid WHERE section
+    /// Returns true and stores ANNExpr if the query has valid WHERE section
     static bool matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & ann_info);
 
-    // Returns true and stores ANNExpr if the query has valid ORDERBY section
+    /// Returns true and stores ANNExpr if the query has valid ORDERBY section
     static bool matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & ann_info);
 
-    // Returns true and stores Length if we have valid LIMIT clause in query
+    /// Returns true and stores Length if we have valid LIMIT clause in query
     static bool matchRPNLimit(RPNElement & rpn, UInt64 & limit);
 
     /* Matches dist function, reference vector, column name */
     static bool matchMainParts(RPN::iterator & iter, const RPN::iterator & end, ApproximateNearestNeighborInformation & ann_info);
 
-    // Gets float or int from AST node
+    /// Gets float or int from AST node
     static float getFloatOrIntLiteralOrPanic(const RPN::iterator& iter);
 
     Block block_with_constants;
 
-    // true if we have one of two supported query types
+    /// true if we have one of two supported query types
     std::optional<ApproximateNearestNeighborInformation> query_information;
 
     // Get from settings ANNIndex parameters
@@ -214,10 +206,12 @@ private:
     bool index_is_useful = false;
 };
 
-// condition interface for Ann indexes. Returns vector of indexes of ranges in granule which are useful for query.
+
+/// Common interface of ANN indexes.
 class IMergeTreeIndexConditionApproximateNearestNeighbor : public IMergeTreeIndexCondition
 {
 public:
+    /// Returns vector of indexes of ranges in granule which are useful for query.
     virtual std::vector<size_t> getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const = 0;
 };
 

From 6580d2c326021cf476a274bce79b0b5d82bb92e4 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:52:14 +0000
Subject: [PATCH 0406/1478] Cosmetics: castMetricFromStringToType -->
 stringToMetric

---
 src/Storages/MergeTree/CommonANNIndexes.cpp   |  24 +--
 src/Storages/MergeTree/CommonANNIndexes.h     |   2 +-
 .../queries/0_stateless/02354_annoy.reference |  26 ----
 tests/queries/0_stateless/02354_annoy.sh      | 143 ------------------
 4 files changed, 14 insertions(+), 181 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02354_annoy.reference
 delete mode 100755 tests/queries/0_stateless/02354_annoy.sh

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index f4a0e9bf728..2e2eb4e19ea 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -41,30 +41,32 @@ void extraceReferenceVectorFromLiteral(ApproximateNearestNeighborInformation::Em
     }
 }
 
-ApproximateNearestNeighborInformation::Metric castMetricFromStringToType(String metric_name)
+ApproximateNearestNeighborInformation::Metric stringToMetric(std::string_view metric)
 {
-    if (metric_name == "L2Distance")
+    if (metric == "L2Distance")
         return ApproximateNearestNeighborInformation::Metric::L2;
-    if (metric_name == "LpDistance")
+    else if (metric == "LpDistance")
         return ApproximateNearestNeighborInformation::Metric::Lp;
-    return ApproximateNearestNeighborInformation::Metric::Unknown;
+    else
+        return ApproximateNearestNeighborInformation::Metric::Unknown;
 }
 
 }
 
 ApproximateNearestNeighborCondition::ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
                                  ContextPtr context) :
-    block_with_constants{KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context)},
-    index_granularity{context->getMergeTreeSettings().get("index_granularity").get<UInt64>()},
-    limit_restriction{context->getSettings().get("max_limit_for_ann_queries").get<UInt64>()},
-    index_is_useful{checkQueryStructure(query_info)} {}
+    block_with_constants(KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context)),
+    index_granularity(context->getMergeTreeSettings().get("index_granularity").get<UInt64>()),
+    limit_restriction(context->getSettings().get("max_limit_for_ann_queries").get<UInt64>()),
+    index_is_useful(checkQueryStructure(query_info))
+{}
 
-bool ApproximateNearestNeighborCondition::alwaysUnknownOrTrue(String metric_name) const
+bool ApproximateNearestNeighborCondition::alwaysUnknownOrTrue(String metric) const
 {
     if (!index_is_useful)
         return true; // Query isn't supported
     // If query is supported, check metrics for match
-    return !(castMetricFromStringToType(metric_name) == query_information->metric);
+    return !(stringToMetric(metric) == query_information->metric);
 }
 
 float ApproximateNearestNeighborCondition::getComparisonDistanceForWhereQuery() const
@@ -415,7 +417,7 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
     if (iter->function != RPNElement::FUNCTION_DISTANCE)
         return false;
 
-    ann_info.metric = castMetricFromStringToType(iter->func_name);
+    ann_info.metric = stringToMetric(iter->func_name);
     ++iter;
 
     if (ann_info.metric == ApproximateNearestNeighborInformation::Metric::Lp)
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/CommonANNIndexes.h
index 2ac9384a884..6b094a40b26 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.h
+++ b/src/Storages/MergeTree/CommonANNIndexes.h
@@ -83,7 +83,7 @@ public:
                     ContextPtr context);
 
     /// Returns false if query can be speeded up by an ANN index, true otherwise.
-    bool alwaysUnknownOrTrue(String metric_name) const;
+    bool alwaysUnknownOrTrue(String metric) const;
 
     /// Returns the distance to compare with for search query
     float getComparisonDistanceForWhereQuery() const;
diff --git a/tests/queries/0_stateless/02354_annoy.reference b/tests/queries/0_stateless/02354_annoy.reference
deleted file mode 100644
index 38678fb67c9..00000000000
--- a/tests/queries/0_stateless/02354_annoy.reference
+++ /dev/null
@@ -1,26 +0,0 @@
-1	[0,0,10]
-2	[0,0,10.5]
-3	[0,0,9.5]
-4	[0,0,9.7]
-5	[0,0,10.2]
-1	[0,0,10]
-5	[0,0,10.2]
-4	[0,0,9.7]
-1	[0,0,10]
-2	[0,0,10.5]
-3	[0,0,9.5]
-4	[0,0,9.7]
-5	[0,0,10.2]
-1	[0,0,10]
-5	[0,0,10.2]
-4	[0,0,9.7]
-        Name: annoy_index
-            Name: annoy_index
-1	[0,0,10]
-2	[0.2,0,10]
-3	[-0.3,0,10]
-1	[0,0,10]
-2	[0.2,0,10]
-3	[-0.3,0,10]
-        Name: annoy_index
-            Name: annoy_index
diff --git a/tests/queries/0_stateless/02354_annoy.sh b/tests/queries/0_stateless/02354_annoy.sh
deleted file mode 100755
index 1031ea81946..00000000000
--- a/tests/queries/0_stateless/02354_annoy.sh
+++ /dev/null
@@ -1,143 +0,0 @@
-#!/usr/bin/env bash
-# Tags: no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
-
-CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CURDIR"/../shell_config.sh
-
-# Check that index works correctly for L2Distance and with client parameters
-$CLICKHOUSE_CLIENT -nm --allow_experimental_annoy_index=1 -q "
-DROP TABLE IF EXISTS 02354_annoy_l2;
-
-CREATE TABLE 02354_annoy_l2
-(
-    id Int32,
-    embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy() GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi';
-
-INSERT INTO 02354_annoy_l2 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 *
-FROM 02354_annoy_l2
-WHERE L2Distance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 5;
-
-SELECT *
-FROM 02354_annoy_l2
-ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-
-SET param_02354_target_vector='[0.0, 0.0, 10.0]';
-
-SELECT *
-FROM 02354_annoy_l2
-WHERE L2Distance(embedding, {02354_target_vector: Array(Float32)}) < 1.0
-LIMIT 5;
-
-SELECT *
-FROM 02354_annoy_l2
-ORDER BY L2Distance(embedding, {02354_target_vector: Array(Float32)})
-LIMIT 3;
-
-SELECT *
-FROM 02354_annoy_l2
-ORDER BY L2Distance(embedding, [0.0, 0.0])
-LIMIT 3; -- { serverError 80 }
-
-
-DROP TABLE IF EXISTS 02354_annoy_l2;
-"
-
-# Check that indexes are used
-$CLICKHOUSE_CLIENT -nm --allow_experimental_annoy_index=1 -q "
-DROP TABLE IF EXISTS 02354_annoy_l2;
-
-CREATE TABLE 02354_annoy_l2
-(
-    id Int32,
-    embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy() GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi';
-
-INSERT INTO 02354_annoy_l2 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]);
-
-EXPLAIN indexes=1
-SELECT *
-FROM 02354_annoy_l2
-WHERE L2Distance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 5;
-
-EXPLAIN indexes=1
-SELECT *
-FROM 02354_annoy_l2
-ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-DROP TABLE IF EXISTS 02354_annoy_l2;
-" | grep "annoy_index"
-
-
-# # Check that index works correctly for cosineDistance
-$CLICKHOUSE_CLIENT -nm --allow_experimental_annoy_index=1 -q "
-DROP TABLE IF EXISTS 02354_annoy_cosine;
-
-CREATE TABLE 02354_annoy_cosine
-(
-    id Int32,
-    embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy('cosineDistance', 100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi';
-
-INSERT INTO 02354_annoy_cosine VALUES (1, [0.0, 0.0, 10.0]), (2, [0.2, 0.0, 10.0]), (3, [-0.3, 0.0, 10.0]), (4, [0.5, 0.0, 10.1]), (5, [0.8, 0.0, 10.0]), (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 *
-FROM 02354_annoy_cosine
-WHERE cosineDistance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 3;
-
-SELECT *
-FROM 02354_annoy_cosine
-ORDER BY cosineDistance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-
-DROP TABLE IF EXISTS 02354_annoy_cosine;
-"
-
-# # Check that indexes are used
-$CLICKHOUSE_CLIENT -nm --allow_experimental_annoy_index=1 -q "
-DROP TABLE IF EXISTS 02354_annoy_cosine;
-
-CREATE TABLE 02354_annoy_cosine
-(
-    id Int32,
-    embedding Array(Float32),
-    INDEX annoy_index embedding TYPE annoy('cosineDistance', 100) GRANULARITY 1
-)
-ENGINE = MergeTree
-ORDER BY id
-SETTINGS index_granularity=5, index_granularity_bytes = '10Mi';
-
-INSERT INTO 02354_annoy_cosine VALUES (1, [0.0, 0.0, 10.0]), (2, [0.2, 0.0, 10.0]), (3, [-0.3, 0.0, 10.0]), (4, [0.5, 0.0, 10.1]), (5, [0.8, 0.0, 10.0]), (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]);
-
-EXPLAIN indexes=1
-SELECT *
-FROM 02354_annoy_cosine
-WHERE cosineDistance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 3;
-
-EXPLAIN indexes=1
-SELECT *
-FROM 02354_annoy_cosine
-ORDER BY cosineDistance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-DROP TABLE IF EXISTS 02354_annoy_cosine;
-" | grep "annoy_index"

From ee5b49c3fd71fddae0ca1d0e2ee96f3dadfb82f1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 21:57:17 +0000
Subject: [PATCH 0407/1478] Consolidate Annoy index tests

---
 .../0_stateless/02354_annoy_index.reference   | 41 +++++++++++++++++++
 .../queries/0_stateless/02354_annoy_index.sql | 34 +++++++++++++++
 2 files changed, 75 insertions(+)

diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 7da442cb905..5f3b523fbe4 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -1,3 +1,44 @@
+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]
+Reference ARRAYs with non-matching dimension are rejected
+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: 1/1
+      Skip
+        Name: annoy_index
+        Description: annoy GRANULARITY 1
+        Parts: 1/1
+        Granules: 1/1
+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: 1/1
+          Skip
+            Name: annoy_index
+            Description: annoy GRANULARITY 1
+            Parts: 1/1
+            Granules: 1/1
 parameter annoy_index_search_k_nodes
 parameter max_limit_for_ann_queries
 Expression (Projection)
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 3590b7d316e..3e1c176f3f6 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -9,6 +9,40 @@ CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding
 -- SETTINGS index_granularity=5, index_granularity_bytes = '10Mi';
 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 '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

From 55256f4664c6226174fc249a652336b8d14a5251 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 25 May 2023 22:12:54 +0000
Subject: [PATCH 0408/1478] Cosmetics: Fix typo

---
 src/Storages/MergeTree/CommonANNIndexes.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/CommonANNIndexes.cpp
index 2e2eb4e19ea..45d86e54ea2 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/CommonANNIndexes.cpp
@@ -25,7 +25,7 @@ namespace
 {
 
 template <typename Literal>
-void extraceReferenceVectorFromLiteral(ApproximateNearestNeighborInformation::Embedding & reference_vector, Literal literal)
+void extractReferenceVectorFromLiteral(ApproximateNearestNeighborInformation::Embedding & reference_vector, Literal literal)
 {
     Float64 float_element_of_reference_vector;
     Int64 int_element_of_reference_vector;
@@ -441,13 +441,13 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
     {
-        extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
+        extractReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
         ++iter;
     }
 
     if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
     {
-        extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
+        extractReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
         ++iter;
     }
 
@@ -462,12 +462,12 @@ bool ApproximateNearestNeighborCondition::matchMainParts(RPN::iterator & iter, c
         ++iter;
         if (iter->function == RPNElement::FUNCTION_LITERAL_TUPLE)
         {
-            extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
+            extractReferenceVectorFromLiteral(ann_info.reference_vector, iter->tuple_literal);
             ++iter;
         }
         else if (iter->function == RPNElement::FUNCTION_LITERAL_ARRAY)
         {
-            extraceReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
+            extractReferenceVectorFromLiteral(ann_info.reference_vector, iter->array_literal);
             ++iter;
         }
         else

From 879b70a594fdc42421f04ff1f757a518b67c6956 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 26 May 2023 08:50:36 +0000
Subject: [PATCH 0409/1478] CommonANNIndexes.h/cpp -->
 ApproximateNearestNeighborIndexesCommon.h/cpp

---
 ...es.cpp => ApproximateNearestNeighborIndexesCommon.cpp} | 8 +++-----
 ...ndexes.h => ApproximateNearestNeighborIndexesCommon.h} | 0
 src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp    | 2 +-
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h              | 2 +-
 4 files changed, 5 insertions(+), 7 deletions(-)
 rename src/Storages/MergeTree/{CommonANNIndexes.cpp => ApproximateNearestNeighborIndexesCommon.cpp} (99%)
 rename src/Storages/MergeTree/{CommonANNIndexes.h => ApproximateNearestNeighborIndexesCommon.h} (100%)

diff --git a/src/Storages/MergeTree/CommonANNIndexes.cpp b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
similarity index 99%
rename from src/Storages/MergeTree/CommonANNIndexes.cpp
rename to src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
index 45d86e54ea2..4f0bcd7ff81 100644
--- a/src/Storages/MergeTree/CommonANNIndexes.cpp
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
@@ -1,17 +1,15 @@
-#include <Storages/MergeTree/CommonANNIndexes.h>
-#include <Storages/MergeTree/KeyCondition.h>
+#include <Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h>
 
+#include <Interpreters/Context.h>
 #include <Parsers/ASTFunction.h>
 #include <Parsers/ASTIdentifier.h>
 #include <Parsers/ASTLiteral.h>
 #include <Parsers/ASTOrderByElement.h>
 #include <Parsers/ASTSelectQuery.h>
 #include <Parsers/ASTSetQuery.h>
-
+#include <Storages/MergeTree/KeyCondition.h>
 #include <Storages/MergeTree/MergeTreeSettings.h>
 
-#include <Interpreters/Context.h>
-
 namespace DB
 {
 
diff --git a/src/Storages/MergeTree/CommonANNIndexes.h b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
similarity index 100%
rename from src/Storages/MergeTree/CommonANNIndexes.h
rename to src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 3d290ea12ac..fb11fabfac1 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -45,7 +45,7 @@
 
 #include <IO/WriteBufferFromOStream.h>
 
-#include <Storages/MergeTree/CommonANNIndexes.h>
+#include <Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h>
 
 namespace CurrentMetrics
 {
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 95041ea31fb..0ff676cf11f 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -2,7 +2,7 @@
 
 #ifdef ENABLE_ANNOY
 
-#include <Storages/MergeTree/CommonANNIndexes.h>
+#include <Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h>
 
 #include <annoylib.h>
 #include <kissrandom.h>

From 8213e366fae75c7079f814944d163e2e5d9b9b54 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 26 May 2023 08:57:35 +0000
Subject: [PATCH 0410/1478]  Cosmetics: Remove absolute namespace qualification
 of Annoy library internals, pt. II

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

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 0ff676cf11f..2c78ff536ae 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -11,9 +11,9 @@ namespace DB
 {
 
 template <typename Distance>
-class AnnoyIndexWithSerialization : public ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>
+class AnnoyIndexWithSerialization : public Annoy::AnnoyIndex<UInt64, Float32, Distance, Annoy::Kiss64Random, Annoy::AnnoyIndexMultiThreadedBuildPolicy>
 {
-    using Base = ::Annoy::AnnoyIndex<UInt64, Float32, Distance, ::Annoy::Kiss64Random, ::Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
+    using Base = Annoy::AnnoyIndex<UInt64, Float32, Distance, Annoy::Kiss64Random, Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
 
 public:
     explicit AnnoyIndexWithSerialization(uint64_t dim);

From 0c26123fd5cf1b848a14eff86d0e5a97461d4c16 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 26 May 2023 09:39:06 +0000
Subject: [PATCH 0411/1478] Cosmetics: limit_restriction -->
 max_limit_for_ann_queries

---
 .../ApproximateNearestNeighborIndexesCommon.cpp     | 13 ++++++-------
 .../ApproximateNearestNeighborIndexesCommon.h       |  5 ++---
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
index 4f0bcd7ff81..252035f3335 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
@@ -51,12 +51,11 @@ ApproximateNearestNeighborInformation::Metric stringToMetric(std::string_view me
 
 }
 
-ApproximateNearestNeighborCondition::ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
-                                 ContextPtr context) :
-    block_with_constants(KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context)),
-    index_granularity(context->getMergeTreeSettings().get("index_granularity").get<UInt64>()),
-    limit_restriction(context->getSettings().get("max_limit_for_ann_queries").get<UInt64>()),
-    index_is_useful(checkQueryStructure(query_info))
+ApproximateNearestNeighborCondition::ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info, ContextPtr context)
+    : block_with_constants(KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context))
+    , index_granularity(context->getMergeTreeSettings().get("index_granularity").get<UInt64>())
+    , max_limit_for_ann_queries(context->getSettings().get("max_limit_for_ann_queries").get<UInt64>())
+    , index_is_useful(checkQueryStructure(query_info))
 {}
 
 bool ApproximateNearestNeighborCondition::alwaysUnknownOrTrue(String metric) const
@@ -167,7 +166,7 @@ bool ApproximateNearestNeighborCondition::checkQueryStructure(const SelectQueryI
     const bool limit_is_valid = matchRPNLimit(rpn_limit, limit);
 
     /// Query without a LIMIT clause or with a limit greater than a restriction is not supported
-    if (!limit_is_valid || limit_restriction < limit)
+    if (!limit_is_valid || max_limit_for_ann_queries < limit)
         return false;
 
     /// Search type query in both sections isn't supported
diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
index 6b094a40b26..513a86c42d8 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
@@ -79,8 +79,7 @@ struct ApproximateNearestNeighborInformation
 class ApproximateNearestNeighborCondition
 {
 public:
-    ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info,
-                    ContextPtr context);
+    ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info, ContextPtr context);
 
     /// Returns false if query can be speeded up by an ANN index, true otherwise.
     bool alwaysUnknownOrTrue(String metric) const;
@@ -202,7 +201,7 @@ private:
     // Get from settings ANNIndex parameters
     const UInt64 index_granularity;
     /// only queries with a lower limit can be considered to avoid memory overflow
-    const UInt64 limit_restriction;
+    const UInt64 max_limit_for_ann_queries;
     bool index_is_useful = false;
 };
 

From 146668a850234394d34c03c2d0246bbed7855549 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 29 May 2023 15:34:43 +0000
Subject: [PATCH 0412/1478] Cosmetics: query_type --> type

---
 .../ApproximateNearestNeighborIndexesCommon.cpp        |  8 ++++----
 .../ApproximateNearestNeighborIndexesCommon.h          | 10 ++++++++--
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
index 252035f3335..c47e53788a7 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
@@ -69,7 +69,7 @@ bool ApproximateNearestNeighborCondition::alwaysUnknownOrTrue(String metric) con
 float ApproximateNearestNeighborCondition::getComparisonDistanceForWhereQuery() const
 {
     if (index_is_useful && query_information.has_value()
-        && query_information->query_type == ApproximateNearestNeighborInformation::Type::Where)
+        && query_information->type == ApproximateNearestNeighborInformation::Type::Where)
         return query_information->distance;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Not supported method for this query type");
 }
@@ -119,7 +119,7 @@ float ApproximateNearestNeighborCondition::getPValueForLpDistance() const
 ApproximateNearestNeighborInformation::Type ApproximateNearestNeighborCondition::getQueryType() const
 {
     if (index_is_useful && query_information.has_value())
-        return query_information->query_type;
+        return query_information->type;
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Query type was requested for useless or uninitialized index.");
 }
 
@@ -326,7 +326,7 @@ void ApproximateNearestNeighborCondition::traverseOrderByAST(const ASTPtr & node
 bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
-    ann_info.query_type = ApproximateNearestNeighborInformation::Type::Where;
+    ann_info.type = ApproximateNearestNeighborInformation::Type::Where;
 
     /// WHERE section must have at least 5 expressions
     /// Operator->Distance(float)->DistanceFunc->Column->Tuple(Array)Func(ReferenceVector(floats))
@@ -381,7 +381,7 @@ bool ApproximateNearestNeighborCondition::matchRPNWhere(RPN & rpn, ApproximateNe
 bool ApproximateNearestNeighborCondition::matchRPNOrderBy(RPN & rpn, ApproximateNearestNeighborInformation & ann_info)
 {
     /// Fill query type field
-    ann_info.query_type = ApproximateNearestNeighborInformation::Type::OrderBy;
+    ann_info.type = ApproximateNearestNeighborInformation::Type::OrderBy;
 
     // ORDER BY clause must have at least 3 expressions
     if (rpn.size() < 3)
diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
index 513a86c42d8..4fb95c3f492 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
@@ -42,7 +42,7 @@ struct ApproximateNearestNeighborInformation
         OrderBy,
         Where
     };
-    Type query_type;
+    Type type;
 
     float p_for_lp_dist = -1.0;
     float distance = -1.0;
@@ -150,7 +150,11 @@ private:
         };
 
         explicit RPNElement(Function function_ = FUNCTION_UNKNOWN)
-        : function(function_), func_name("Unknown"), float_literal(std::nullopt), identifier(std::nullopt) {}
+            : function(function_)
+            , func_name("Unknown")
+            , float_literal(std::nullopt)
+            , identifier(std::nullopt)
+        {}
 
         Function function;
         String func_name;
@@ -200,8 +204,10 @@ private:
 
     // Get from settings ANNIndex parameters
     const UInt64 index_granularity;
+
     /// only queries with a lower limit can be considered to avoid memory overflow
     const UInt64 max_limit_for_ann_queries;
+
     bool index_is_useful = false;
 };
 

From c94ec9f5ddb8d047c370749f3249374fb746ed06 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 29 May 2023 15:35:14 +0000
Subject: [PATCH 0413/1478] Cosmetics: Fix typo

---
 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 3e10f48a2fb..df4cf5ff087 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -741,7 +741,7 @@ class IColumn;
     M(Bool, allow_experimental_hash_functions, false, "Enable experimental hash functions (hashid, etc)", 0) \
     M(Bool, allow_experimental_object_type, false, "Allow Object and JSON data types", 0) \
     M(Bool, allow_experimental_annoy_index, false, "Allows to use Annoy index. Disabled by default because this feature is experimental", 0) \
-    M(UInt64, max_limit_for_ann_queries, 1'000'000, "SELECT queries with LIMIT bigger than this setting cannot use ANN indexes. Helps to prevent memory overflows in ANN search indexs.", 0) \
+    M(UInt64, max_limit_for_ann_queries, 1'000'000, "SELECT queries with LIMIT bigger than this setting cannot use ANN indexes. Helps to prevent memory overflows in ANN search indexes.", 0) \
     M(Int64, annoy_index_search_k_nodes, -1, "SELECT queries search up to this many nodes in Annoy indexes.", 0) \
     M(Bool, throw_on_unsupported_query_inside_transaction, true, "Throw exception if unsupported query is used inside transaction", 0) \
     M(TransactionsWaitCSNMode, wait_changes_become_visible_after_commit_mode, TransactionsWaitCSNMode::WAIT_UNKNOWN, "Wait for committed changes to become actually visible in the latest snapshot", 0) \

From 4e9a5331781166160feaf71ca8944a4f1b733846 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 2 Jun 2023 09:53:20 +0000
Subject: [PATCH 0414/1478] Cosmetics: condition --> ann_condition

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 20 +++++++++----------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  2 +-
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 9dcfd421ba5..9afaba6e521 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -208,12 +208,11 @@ MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     const SelectQueryInfo & query,
     const String & distance_function_,
     ContextPtr context)
-    : condition(query, context)
+    : ann_condition(query, context)
     , distance_function(distance_function_)
     , search_k(context->getSettings().get("annoy_index_search_k_nodes").get<Int64>())
 {}
 
-
 bool MergeTreeIndexConditionAnnoy::mayBeTrueOnGranule(MergeTreeIndexGranulePtr /*idx_granule*/) const
 {
     throw Exception(ErrorCodes::LOGICAL_ERROR, "mayBeTrueOnGranule is not supported for ANN skip indexes");
@@ -221,7 +220,7 @@ bool MergeTreeIndexConditionAnnoy::mayBeTrueOnGranule(MergeTreeIndexGranulePtr /
 
 bool MergeTreeIndexConditionAnnoy::alwaysUnknownOrTrue() const
 {
-    return condition.alwaysUnknownOrTrue(distance_function);
+    return ann_condition.alwaysUnknownOrTrue(distance_function);
 }
 
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const
@@ -234,20 +233,19 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndex
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
 }
 
-
 template <typename Distance>
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const
 {
-    UInt64 limit = condition.getLimit();
-    UInt64 index_granularity = condition.getIndexGranularity();
-    std::optional<float> comp_dist = condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
-        ? std::optional<float>(condition.getComparisonDistanceForWhereQuery())
+    UInt64 limit = ann_condition.getLimit();
+    UInt64 index_granularity = ann_condition.getIndexGranularity();
+    std::optional<float> comp_dist = ann_condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
+        ? std::optional<float>(ann_condition.getComparisonDistanceForWhereQuery())
         : std::nullopt;
 
     if (comp_dist && comp_dist.value() < 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to optimize query with where without distance");
 
-    std::vector<float> reference_vector = condition.getReferenceVector();
+    std::vector<float> reference_vector = ann_condition.getReferenceVector();
 
     auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance>>(idx_granule);
     if (granule == nullptr)
@@ -255,10 +253,10 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 
     auto annoy = granule->index;
 
-    if (condition.getNumOfDimensions() != annoy->getNumOfDimensions())
+    if (ann_condition.getNumOfDimensions() != annoy->getNumOfDimensions())
         throw Exception(ErrorCodes::INCORRECT_QUERY, "The dimension of the space in the request ({}) "
                         "does not match with the dimension in the index ({})",
-                        toString(condition.getNumOfDimensions()), toString(annoy->getNumOfDimensions()));
+                        toString(ann_condition.getNumOfDimensions()), toString(annoy->getNumOfDimensions()));
 
     /// neighbors contain indexes of dots which were closest to the reference vector
     std::vector<UInt64> neighbors;
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 2c78ff536ae..457a505d909 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -81,7 +81,7 @@ private:
     template <typename Distance>
     std::vector<size_t> getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const;
 
-    const ApproximateNearestNeighborCondition condition;
+    const ApproximateNearestNeighborCondition ann_condition;
     const String distance_function;
     const Int64 search_k;
 };

From 397715bfa501e89de741e2b8edfbafdd0cede707 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 2 Jun 2023 09:55:37 +0000
Subject: [PATCH 0415/1478] Cosmetics: comp_dist --> comparison_distance

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 9afaba6e521..7808f07511b 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -238,11 +238,11 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 {
     UInt64 limit = ann_condition.getLimit();
     UInt64 index_granularity = ann_condition.getIndexGranularity();
-    std::optional<float> comp_dist = ann_condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
+    std::optional<float> comparison_distance = ann_condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
         ? std::optional<float>(ann_condition.getComparisonDistanceForWhereQuery())
         : std::nullopt;
 
-    if (comp_dist && comp_dist.value() < 0)
+    if (comparison_distance && comparison_distance.value() < 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to optimize query with where without distance");
 
     std::vector<float> reference_vector = ann_condition.getReferenceVector();
@@ -269,7 +269,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     std::unordered_set<size_t> granule_numbers;
     for (size_t i = 0; i < neighbors.size(); ++i)
     {
-        if (comp_dist && distances[i] > comp_dist)
+        if (comparison_distance && distances[i] > comparison_distance)
             continue;
         granule_numbers.insert(neighbors[i] / index_granularity);
     }

From 06329fb08b8418e347d5c64a37beeb51d5504376 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 08:35:59 +0000
Subject: [PATCH 0416/1478] Minor: Make unique by sort/erase (should be a bit
 faster)

---
 .../MergeTree/MergeTreeIndexAnnoy.cpp         | 31 +++++++++----------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  2 +-
 2 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 7808f07511b..d1715b2c4c1 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -148,8 +148,8 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
     if (index_sample_block.columns() > 1)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected block with single column");
 
-    auto index_column_name = index_sample_block.getByPosition(0).name;
-    const auto & column_cut = block.getByName(index_column_name).column->cut(*pos, rows_read);
+    const String & index_column_name = index_sample_block.getByPosition(0).name;
+    ColumnPtr column_cut = block.getByName(index_column_name).column->cut(*pos, rows_read);
 
     if (const auto & column_array = typeid_cast<const ColumnArray *>(column_cut.get()))
     {
@@ -204,7 +204,7 @@ void MergeTreeIndexAggregatorAnnoy<Distance>::update(const Block & block, size_t
 
 
 MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
-    const IndexDescription & /*index*/,
+    const IndexDescription & /*index_description*/,
     const SelectQueryInfo & query,
     const String & distance_function_,
     ContextPtr context)
@@ -251,35 +251,34 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     if (granule == nullptr)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Granule has the wrong type");
 
-    auto annoy = granule->index;
+    const AnnoyIndexWithSerializationPtr<Distance> & annoy = granule->index;
 
     if (ann_condition.getNumOfDimensions() != annoy->getNumOfDimensions())
         throw Exception(ErrorCodes::INCORRECT_QUERY, "The dimension of the space in the request ({}) "
-                        "does not match with the dimension in the index ({})",
-                        toString(ann_condition.getNumOfDimensions()), toString(annoy->getNumOfDimensions()));
+                        "does not match the dimension in the index ({})",
+                        ann_condition.getNumOfDimensions(), annoy->getNumOfDimensions());
 
-    /// neighbors contain indexes of dots which were closest to the reference vector
-    std::vector<UInt64> neighbors;
+    std::vector<UInt64> neighbors; /// indexes of dots which were closest to the reference vector
     std::vector<Float32> distances;
     neighbors.reserve(limit);
     distances.reserve(limit);
 
     annoy->get_nns_by_vector(reference_vector.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
 
-    std::unordered_set<size_t> granule_numbers;
+    std::vector<size_t> granule_numbers;
+    granule_numbers.reserve(neighbors.size());
     for (size_t i = 0; i < neighbors.size(); ++i)
     {
         if (comparison_distance && distances[i] > comparison_distance)
             continue;
-        granule_numbers.insert(neighbors[i] / index_granularity);
+        granule_numbers.push_back(neighbors[i] / index_granularity);
     }
 
-    std::vector<size_t> result_vector;
-    result_vector.reserve(granule_numbers.size());
-    for (auto granule_number : granule_numbers)
-        result_vector.push_back(granule_number);
+    /// make unique
+    std::sort(granule_numbers.begin(), granule_numbers.end());
+    granule_numbers.erase(std::unique(granule_numbers.begin(), granule_numbers.end()), granule_numbers.end());
 
-    return result_vector;
+    return granule_numbers;
 }
 
 MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String & distance_function_)
@@ -302,7 +301,7 @@ MergeTreeIndexAggregatorPtr MergeTreeIndexAnnoy::createIndexAggregator() const
     /// TODO: Support more metrics. Available metrics: https://github.com/spotify/annoy/blob/master/src/annoymodule.cc#L151-L171
     if (distance_function == "L2Distance")
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Euclidean>>(index.name, index.sample_block, trees);
-    if (distance_function == "cosineDistance")
+    else if (distance_function == "cosineDistance")
         return std::make_shared<MergeTreeIndexAggregatorAnnoy<Annoy::Angular>>(index.name, index.sample_block, trees);
     std::unreachable();
 }
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 457a505d909..bca06edd0f8 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -64,7 +64,7 @@ class MergeTreeIndexConditionAnnoy final : public IMergeTreeIndexConditionApprox
 {
 public:
     MergeTreeIndexConditionAnnoy(
-        const IndexDescription & index,
+        const IndexDescription & index_description,
         const SelectQueryInfo & query,
         const String& distance_function,
         ContextPtr context);

From ece96f54e96b526693e58b859c9c835f17eff5f4 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Mon, 5 Jun 2023 09:47:58 +0000
Subject: [PATCH 0417/1478] Fix tests

---
 src/Coordination/KeeperSnapshotManager.cpp    | 8 +++-----
 src/Coordination/tests/gtest_coordination.cpp | 2 ++
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 44e990c7b95..d10df0fd785 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -62,7 +62,7 @@ namespace
 
     std::string getSnapshotFileName(uint64_t up_to_log_idx, bool compress_zstd)
     {
-        auto base = std::string{"snapshot_"} + std::to_string(up_to_log_idx) + ".bin";
+        auto base = fmt::format("snapshot_{}.bin", up_to_log_idx);
         if (compress_zstd)
             base += ".zstd";
         return base;
@@ -567,10 +567,8 @@ KeeperSnapshotManager::KeeperSnapshotManager(
                 continue;
             }
 
-            if (clean_incomplete_file(it->path()))
-                continue;
-
-            snapshot_files.push_back(it->path());
+            if (it->name().starts_with("snapshot_") && !clean_incomplete_file(it->path()))
+                snapshot_files.push_back(it->path());
         }
 
         for (const auto & snapshot_file : snapshot_files)
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index ff7d545ecdd..50e81eca8ca 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -1944,6 +1944,8 @@ TEST_P(CoordinationTest, TestCompressedLogsMultipleRewrite)
         changelog1.end_of_append_batch(0, 0);
     }
 
+    waitDurableLogs(changelog1);
+
     DB::KeeperLogStore changelog2(
         DB::LogFileSettings{.force_sync = true, .compress_logs = test_params.enable_compression, .rotate_interval = 100}, keeper_context);
     changelog2.init(0, 3);

From 22110ac7427abc4feac120a1cfa5cd29850def8b Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Mon, 5 Jun 2023 11:59:49 +0200
Subject: [PATCH 0418/1478] Fix exception message

---
 src/Interpreters/Cache/Metadata.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 9dff77e2af8..d0780202121 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -374,7 +374,7 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
         fs::remove(path);
     }
     else if (file_segment->downloaded_size)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist");
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist", path);
 
     file_segment->detach(segment_lock, *this);
     return key_metadata->erase(it);

From 3082029406846dd92f1d9018156fc0bf9fee8d7c Mon Sep 17 00:00:00 2001
From: ismailakpolat <ismailakpolat@users.noreply.github.com>
Date: Mon, 5 Jun 2023 13:03:17 +0300
Subject: [PATCH 0419/1478] Update rabbitmq.md

Duplicate parameter name in definition
---
 docs/en/engines/table-engines/integrations/rabbitmq.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/en/engines/table-engines/integrations/rabbitmq.md b/docs/en/engines/table-engines/integrations/rabbitmq.md
index 08062278904..7620cd22767 100644
--- a/docs/en/engines/table-engines/integrations/rabbitmq.md
+++ b/docs/en/engines/table-engines/integrations/rabbitmq.md
@@ -42,7 +42,6 @@ CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
     [rabbitmq_queue_consume = false,]
     [rabbitmq_address = '',]
     [rabbitmq_vhost = '/',]
-    [rabbitmq_queue_consume = false,]
     [rabbitmq_username = '',]
     [rabbitmq_password = '',]
     [rabbitmq_commit_on_select = false,]

From a224c8936ccebc243ab82b7338ddd93a10f3c099 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 10:18:07 +0000
Subject: [PATCH 0420/1478] Fix minor issues in documentation

---
 docs/en/operations/system-tables/processes.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/operations/system-tables/processes.md b/docs/en/operations/system-tables/processes.md
index 2e729920ed0..ffa37357053 100644
--- a/docs/en/operations/system-tables/processes.md
+++ b/docs/en/operations/system-tables/processes.md
@@ -10,14 +10,14 @@ Columns:
 - `user` (String) – The user who made the query. Keep in mind that for distributed processing, queries are sent to remote servers under the `default` user. The field contains the username for a specific query, not for a query that this query initiated.
 - `address` (String) – The IP address the request was made from. The same for distributed processing. To track where a distributed query was originally made from, look at `system.processes` on the query requestor server.
 - `elapsed` (Float64) – The time in seconds since request execution started.
-- `rows_read` (UInt64) – The number of rows read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
-- `bytes_read` (UInt64) – The number of uncompressed bytes read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
+- `read_rows` (UInt64) – The number of rows read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
+- `read_bytes` (UInt64) – The number of uncompressed bytes read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
 - `total_rows_approx` (UInt64) – The approximation of the total number of rows that should be read. For distributed processing, on the requestor server, this is the total for all remote servers. It can be updated during request processing, when new sources to process become known.
-- `memory_usage` (UInt64) – Amount of RAM the request uses. It might not include some types of dedicated memory. See the [max_memory_usage](../../operations/settings/query-complexity.md#settings_max_memory_usage) setting.
+- `memory_usage` (Int64) – Amount of RAM the request uses. It might not include some types of dedicated memory. See the [max_memory_usage](../../operations/settings/query-complexity.md#settings_max_memory_usage) setting.
 - `query` (String) – The query text. For `INSERT`, it does not include the data to insert.
 - `query_id` (String) – Query ID, if defined.
-- `is_cancelled` (Int8) – Was query cancelled.
-- `is_all_data_sent` (Int8) – Was all data sent to the client (in other words query had been finished on the server).
+- `is_cancelled` (UInt8) – Was query cancelled.
+- `is_all_data_sent` (UInt8) – Was all data sent to the client (in other words query had been finished on the server).
 
 ```sql
 SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;

From 256f713d6b75bf971203f24bb6db0fcab6fa9aec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 10:18:25 +0000
Subject: [PATCH 0421/1478] Add docs for `system.user_processes`

---
 .../system-tables/user_processes.md           | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/en/operations/system-tables/user_processes.md

diff --git a/docs/en/operations/system-tables/user_processes.md b/docs/en/operations/system-tables/user_processes.md
new file mode 100644
index 00000000000..a9b97390ed6
--- /dev/null
+++ b/docs/en/operations/system-tables/user_processes.md
@@ -0,0 +1,28 @@
+---
+slug: /en/operations/system-tables/user_processes
+---
+# user_processes
+
+This system table is used for implementing the `SHOW USER PROCESSES` query.
+
+Columns:
+
+- `user` ([String](../../sql-reference/data-types/string.md)) — User name.
+- `memory_usage` ([Int64](../../sql-reference/data-types/int-uint#int-ranges)) – Sum of RAM used by all processes of the user. It might not include some types of dedicated memory. See the [max_memory_usage](../../operations/settings/query-complexity.md#settings_max_memory_usage) setting.
+- `peak_memory_usage` ([Int64](../../sql-reference/data-types/int-uint#int-ranges)) — The peak of memory usage of the user. It can be reset when no queries are run for the user.
+- `ProfileEvents` ([Map(String, UInt64)](../../sql-reference/data-types/map)) – Summary of ProfileEvents that measure different metrics for the user. The description of them could be found in the table [system.events](../../operations/system-tables/events.md#system_tables-events)
+
+```sql
+SELECT * FROM system.user_processes LIMIT 10 FORMAT Vertical;
+```
+
+```response
+Row 1:
+──────
+user:              default
+memory_usage:      9832
+peak_memory_usage: 9832
+ProfileEvents:     {'Query':5,'SelectQuery':5,'QueriesWithSubqueries':38,'SelectQueriesWithSubqueries':38,'QueryTimeMicroseconds':842048,'SelectQueryTimeMicroseconds':842048,'ReadBufferFromFileDescriptorRead':6,'ReadBufferFromFileDescriptorReadBytes':234,'IOBufferAllocs':3,'IOBufferAllocBytes':98493,'ArenaAllocChunks':283,'ArenaAllocBytes':1482752,'FunctionExecute':670,'TableFunctionExecute':16,'DiskReadElapsedMicroseconds':19,'NetworkSendElapsedMicroseconds':684,'NetworkSendBytes':139498,'SelectedRows':6076,'SelectedBytes':685802,'ContextLock':1140,'RWLockAcquiredReadLocks':193,'RWLockReadersWaitMilliseconds':4,'RealTimeMicroseconds':1585163,'UserTimeMicroseconds':889767,'SystemTimeMicroseconds':13630,'SoftPageFaults':1947,'OSCPUWaitMicroseconds':6,'OSCPUVirtualTimeMicroseconds':903251,'OSReadChars':28631,'OSWriteChars':28888,'QueryProfilerRuns':3,'LogTrace':79,'LogDebug':24}
+
+1 row in set. Elapsed: 0.010 sec.
+```

From e140cad10c0e0ab1a3a291b0ceef37a72bcb4295 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 10:18:36 +0000
Subject: [PATCH 0422/1478] Clean up includes

---
 src/Storages/System/StorageSystemUserProcesses.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Storages/System/StorageSystemUserProcesses.cpp b/src/Storages/System/StorageSystemUserProcesses.cpp
index 5973f9e2af3..de34fede0ac 100644
--- a/src/Storages/System/StorageSystemUserProcesses.cpp
+++ b/src/Storages/System/StorageSystemUserProcesses.cpp
@@ -2,7 +2,6 @@
 #include <Columns/ColumnsNumber.h>
 #include <Core/Settings.h>
 #include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeFactory.h>
 #include <DataTypes/DataTypeMap.h>
 #include <DataTypes/DataTypeString.h>
 #include <DataTypes/DataTypesNumber.h>
@@ -10,8 +9,6 @@
 #include <Interpreters/ProcessList.h>
 #include <Interpreters/ProfileEventsExt.h>
 #include <Storages/System/StorageSystemUserProcesses.h>
-#include <Common/IPv6ToBinary.h>
-#include <Common/typeid_cast.h>
 
 
 namespace DB

From cdb5997339f20f27d6c6ad628c341579ffcf9264 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 10:22:34 +0000
Subject: [PATCH 0423/1478] Cosmetics: add assert

---
 src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp | 2 --
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp         | 4 +++-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index fb11fabfac1..c6b7232be4a 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -1693,9 +1693,7 @@ MarkRanges MergeTreeDataSelectExecutor::filterMarksUsingIndex(
                 // vector of indexes of useful ranges
                 auto result = ann_condition->getUsefulRanges(granule);
                 if (result.empty())
-                {
                     ++granules_dropped;
-                }
 
                 for (auto range : result)
                 {
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index d1715b2c4c1..cf7fbb3bab3 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -251,7 +251,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     if (granule == nullptr)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Granule has the wrong type");
 
-    const AnnoyIndexWithSerializationPtr<Distance> & annoy = granule->index;
+    AnnoyIndexWithSerializationPtr<Distance> annoy = granule->index;
 
     if (ann_condition.getNumOfDimensions() != annoy->getNumOfDimensions())
         throw Exception(ErrorCodes::INCORRECT_QUERY, "The dimension of the space in the request ({}) "
@@ -265,6 +265,8 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 
     annoy->get_nns_by_vector(reference_vector.data(), limit, static_cast<int>(search_k), &neighbors, &distances);
 
+    chassert(neighbors.size() == distances.size());
+
     std::vector<size_t> granule_numbers;
     granule_numbers.reserve(neighbors.size());
     for (size_t i = 0; i < neighbors.size(); ++i)

From 7d659fdca2bf80c6f045333f531a8a4f058d33d8 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 10:26:45 +0000
Subject: [PATCH 0424/1478] Tests: Decrease granule size

---
 tests/queries/0_stateless/02354_annoy_index.reference | 10 +++++-----
 tests/queries/0_stateless/02354_annoy_index.sql       |  7 +------
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 5f3b523fbe4..5b37c32d914 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -17,12 +17,12 @@ Expression ((Projection + Before ORDER BY))
       PrimaryKey
         Condition: true
         Parts: 1/1
-        Granules: 1/1
+        Granules: 3/3
       Skip
         Name: annoy_index
         Description: annoy GRANULARITY 1
         Parts: 1/1
-        Granules: 1/1
+        Granules: 1/3
 ORDER BY type, L2Distance, check that index is used
 Expression (Projection)
   Limit (preliminary LIMIT (without OFFSET))
@@ -33,12 +33,12 @@ Expression (Projection)
           PrimaryKey
             Condition: true
             Parts: 1/1
-            Granules: 1/1
+            Granules: 3/3
           Skip
             Name: annoy_index
             Description: annoy GRANULARITY 1
             Parts: 1/1
-            Granules: 1/1
+            Granules: 3/3
 parameter annoy_index_search_k_nodes
 parameter max_limit_for_ann_queries
 Expression (Projection)
@@ -50,5 +50,5 @@ Expression (Projection)
           PrimaryKey
             Condition: true
             Parts: 1/1
-            Granules: 1/1
+            Granules: 3/3
 Negative tests
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 3e1c176f3f6..2c40653667d 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -3,10 +3,7 @@
 SET allow_experimental_annoy_index = 1;
 
 DROP TABLE IF EXISTS tab;
-
-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, index_granularity_bytes = '10Mi';
+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';
@@ -21,14 +18,12 @@ FROM tab
 ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
 LIMIT 3;
 
-
 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 de503dc5d20bb8ddd8816c9639686c2c6089fdbe Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 10:49:45 +0000
Subject: [PATCH 0425/1478] Add tests for tuple + add tests for custom distance
 metric / tree count

---
 .../0_stateless/02354_annoy_index.reference   | 67 ++++++++++++++-
 .../queries/0_stateless/02354_annoy_index.sql | 81 +++++++++++++++++--
 2 files changed, 140 insertions(+), 8 deletions(-)

diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 5b37c32d914..5bd1377d6f4 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -1,3 +1,4 @@
+--- Test with Array ---
 WHERE type, L2Distance
 1	[0,0,10]
 2	[0,0,10.5]
@@ -51,4 +52,68 @@ Expression (Projection)
             Condition: true
             Parts: 1/1
             Granules: 3/3
-Negative tests
+--- 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 ---
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 2c40653667d..170c048d420 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -2,6 +2,8 @@
 
 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]);
@@ -55,19 +57,87 @@ SETTINGS max_limit_for_ann_queries=2; -- doesn't use the ann index
 
 DROP TABLE tab;
 
-DROP TABLE IF EXISTS tab;
+SELECT '--- Test with Tuple ---';
 
-SELECT 'Negative tests';
+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;
+
+SELECT '--- Negative tests ---';
 
 -- 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 }
 
--- first argument must be UInt64
+-- 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 }
 
--- 2nd argument must be String
+-- 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 }
+
 -- 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 }
 
@@ -77,6 +147,3 @@ CREATE TABLE tab(id Int32, embedding Float32, INDEX annoy_index embedding TYPE a
 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 }
-
--- 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 }

From 8f60423daa828d9f4ce8f13b90e1c42de22f9edd Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 10:55:05 +0000
Subject: [PATCH 0426/1478] Cosmetics: more constness

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 12 ++++++------
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h   |  5 +----
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index cf7fbb3bab3..72dd92ead5e 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -236,22 +236,22 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndex
 template <typename Distance>
 std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeIndexGranulePtr idx_granule) const
 {
-    UInt64 limit = ann_condition.getLimit();
-    UInt64 index_granularity = ann_condition.getIndexGranularity();
-    std::optional<float> comparison_distance = ann_condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
+    const UInt64 limit = ann_condition.getLimit();
+    const UInt64 index_granularity = ann_condition.getIndexGranularity();
+    const std::optional<float> comparison_distance = ann_condition.getQueryType() == ApproximateNearestNeighborInformation::Type::Where
         ? std::optional<float>(ann_condition.getComparisonDistanceForWhereQuery())
         : std::nullopt;
 
     if (comparison_distance && comparison_distance.value() < 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to optimize query with where without distance");
 
-    std::vector<float> reference_vector = ann_condition.getReferenceVector();
+    const std::vector<float> reference_vector = ann_condition.getReferenceVector();
 
-    auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance>>(idx_granule);
+    const auto granule = std::dynamic_pointer_cast<MergeTreeIndexGranuleAnnoy<Distance>>(idx_granule);
     if (granule == nullptr)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Granule has the wrong type");
 
-    AnnoyIndexWithSerializationPtr<Distance> annoy = granule->index;
+    const AnnoyIndexWithSerializationPtr<Distance> annoy = granule->index;
 
     if (ann_condition.getNumOfDimensions() != annoy->getNumOfDimensions())
         throw Exception(ErrorCodes::INCORRECT_QUERY, "The dimension of the space in the request ({}) "
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index bca06edd0f8..5204ff07b27 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -66,15 +66,13 @@ public:
     MergeTreeIndexConditionAnnoy(
         const IndexDescription & index_description,
         const SelectQueryInfo & query,
-        const String& distance_function,
+        const String & distance_function,
         ContextPtr context);
 
     ~MergeTreeIndexConditionAnnoy() override = default;
 
     bool alwaysUnknownOrTrue() const override;
-
     bool mayBeTrueOnGranule(MergeTreeIndexGranulePtr idx_granule) const override;
-
     std::vector<size_t> getUsefulRanges(MergeTreeIndexGranulePtr idx_granule) const override;
 
 private:
@@ -97,7 +95,6 @@ public:
 
     MergeTreeIndexGranulePtr createIndexGranule() const override;
     MergeTreeIndexAggregatorPtr createIndexAggregator() const override;
-
     MergeTreeIndexConditionPtr createIndexCondition(const SelectQueryInfo & query, ContextPtr context) const override;
 
     bool mayBenefitFromIndexForIn(const ASTPtr & /*node*/) const override { return false; }

From d9a6e36685f71ed592af24a7e951272a688b9eea Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 5 Jun 2023 11:02:23 +0000
Subject: [PATCH 0427/1478] Add comments

---
 src/Analyzer/TableNode.cpp          | 3 +++
 src/Planner/PlannerJoinTree.cpp     | 3 +++
 src/Planner/Utils.cpp               | 3 +++
 src/Storages/StorageDistributed.cpp | 5 +++--
 4 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/Analyzer/TableNode.cpp b/src/Analyzer/TableNode.cpp
index 17d12bd6afa..f899c1ae6fe 100644
--- a/src/Analyzer/TableNode.cpp
+++ b/src/Analyzer/TableNode.cpp
@@ -91,6 +91,9 @@ ASTPtr TableNode::toASTImpl(const ConvertToASTOptions & /* options */) const
     if (!temporary_table_name.empty())
         return std::make_shared<ASTTableIdentifier>(temporary_table_name);
 
+    // In case of cross-replication we don't know what database is used for the table.
+    // `storage_id.hasDatabase()` can return false only on the initiator node.
+    // Each shard will use the default database (in the case of cross-replication shards may have different defaults).
     if (!storage_id.hasDatabase())
         return std::make_shared<ASTTableIdentifier>(storage_id.getTableName());
     return std::make_shared<ASTTableIdentifier>(storage_id.getDatabaseName(), storage_id.getTableName());
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index 4a1708f96d3..8bd674f5b67 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -106,6 +106,9 @@ void checkAccessRights(const TableNode & table_node, const Names & column_names,
             storage_id.getFullTableName());
     }
 
+    // In case of cross-replication we don't know what database is used for the table.
+    // `storage_id.hasDatabase()` can return false only on the initiator node.
+    // Each shard will use the default database (in the case of cross-replication shards may have different defaults).
     if (storage_id.hasDatabase())
         query_context->checkAccess(AccessType::SELECT, storage_id, column_names);
 }
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index cd4fb9182e9..94f3bbf6440 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -107,6 +107,9 @@ Block buildCommonHeaderForUnion(const Blocks & queries_headers, SelectUnionMode
 ASTPtr queryNodeToSelectQuery(const QueryTreeNodePtr & query_node)
 {
     auto & query_node_typed = query_node->as<QueryNode &>();
+
+    // In case of cross-replication we don't know what database is used for the table.
+    // Each shard will use the default database (in the case of cross-replication shards may have different defaults).
     auto result_ast = query_node_typed.toAST({ .fully_qualified_identifiers = false });
 
     while (true)
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index b9625ce2ab7..969c117cb28 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -30,8 +30,6 @@
 #include <Common/randomSeed.h>
 #include <Common/formatReadable.h>
 #include <Common/CurrentMetrics.h>
-#include "Analyzer/IQueryTreeNode.h"
-#include "Analyzer/MatcherNode.h"
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -946,6 +944,9 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
     else
     {
         auto resolved_remote_storage_id = remote_storage_id;
+        // In case of cross-replication we don't know what database is used for the table.
+        // `storage_id.hasDatabase()` can return false only on the initiator node.
+        // Each shard will use the default database (in the case of cross-replication shards may have different defaults).
         if (remote_storage_id.hasDatabase())
             resolved_remote_storage_id = query_context->resolveStorageID(remote_storage_id);
 

From f3a8517a447daeafd6c5bad0b819a2122cf6161c Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 5 Jun 2023 13:07:07 +0200
Subject: [PATCH 0428/1478] Fix

---
 src/Interpreters/Cache/FileCache.cpp |  2 +-
 src/Interpreters/Cache/Metadata.cpp  | 10 ++++++++++
 src/Interpreters/Cache/Metadata.h    |  2 +-
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 65dca790183..5ccbe6ad72d 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -123,7 +123,7 @@ FileSegments FileCache::getImpl(const LockedKey & locked_key, const FileSegment:
     auto add_to_result = [&](const FileSegmentMetadata & file_segment_metadata)
     {
         FileSegmentPtr file_segment;
-        if (file_segment_metadata.valid())
+        if (!file_segment_metadata.evicting())
         {
             file_segment = file_segment_metadata.file_segment;
             if (file_segment->isDownloaded())
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 843ffd45b63..fea552c4071 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -346,6 +346,16 @@ void LockedKey::removeAllReleasable()
             ++it;
             continue;
         }
+        else if (it->second.evicting())
+        {
+            /// File segment is currently a removal candidate,
+            /// we do not know if it will be removed or not yet,
+            /// but its size is currently accounted as potentially removed,
+            /// so if we remove file segment now, we break the freeable_count
+            /// calculation in tryReserve.
+            ++it;
+            continue;
+        }
 
         auto file_segment = it->second->file_segment;
         it = removeFileSegment(file_segment->offset(), file_segment->lock());
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 2e015b07ed0..4732123fabc 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -22,7 +22,7 @@ struct FileSegmentMetadata : private boost::noncopyable
 
     size_t size() const;
 
-    bool valid() const { return !removal_candidate.load(); }
+    bool evicting() const { return !removal_candidate.load(); }
 
     Priority::Iterator getQueueIterator() const { return file_segment->getQueueIterator(); }
 

From 2866bac08932a841595fb788e84bc9be3b07a32f Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Mon, 5 Jun 2023 14:03:19 +0200
Subject: [PATCH 0429/1478] Add named collections and remove host filter
 support

---
 src/Storages/StorageAzure.cpp                 | 78 ++++++++++++++++++-
 src/Storages/StorageAzure.h                   |  9 +--
 .../configs/named_collections.xml             | 15 ++++
 .../test_storage_azure_blob_storage/test.py   | 14 ++++
 4 files changed, 106 insertions(+), 10 deletions(-)
 create mode 100644 tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 7b4bc9e6769..8ce8a923c33 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -18,6 +18,7 @@
 #include <re2/re2.h>
 
 #include <azure/identity/managed_identity_credential.hpp>
+#include  <azure/storage/common/storage_credential.hpp>
 #include <Processors/Transforms/AddingDefaultsTransform.h>
 #include <Processors/Formats/IOutputFormat.h>
 #include <Processors/Formats/IInputFormat.h>
@@ -45,11 +46,61 @@ namespace ErrorCodes
     extern const int DATABASE_ACCESS_DENIED;
 }
 
+namespace
+{
+
+static const std::unordered_set<std::string_view> required_configuration_keys = {
+    "blob_path",
+    "container",
+};
+
+static const std::unordered_set<std::string_view> optional_configuration_keys = {
+    "format",
+    "compression",
+    "compression_method",
+    "account_name",
+    "account_key",
+    "connection_string",
+    "storage_account_url",
+};
+
 bool isConnectionString(const std::string & candidate)
 {
     return candidate.starts_with("DefaultEndpointsProtocol");
 }
 
+
+void processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection)
+{
+    validateNamedCollection(collection, required_configuration_keys, optional_configuration_keys);
+
+    if (collection.has("connection_string"))
+    {
+        configuration.connection_url = collection.get<String>("connection_string");
+        configuration.is_connection_string = true;
+    }
+
+    if (collection.has("storage_account_url"))
+    {
+        configuration.connection_url = collection.get<String>("storage_account_url");
+        configuration.is_connection_string = false;
+    }
+
+    configuration.container = collection.get<String>("container");
+    configuration.blob_path = collection.get<String>("blob_path");
+
+    if (collection.has("account_name"))
+        configuration.account_name = collection.get<String>("account_name");
+
+    if (collection.has("account_key"))
+        configuration.account_key = collection.get<String>("account_key");
+
+    configuration.format = collection.getOrDefault<String>("format", configuration.format);
+    configuration.compression_method = collection.getOrDefault<String>("compression_method", collection.getOrDefault<String>("compression", "auto"));
+}
+
+}
+
 StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
 {
     StorageAzure::Configuration configuration;
@@ -57,6 +108,19 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
     /// Supported signatures:
     ///
     /// Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])
+    ///
+
+    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, local_context))
+    {
+        processNamedCollectionResult(configuration, *named_collection);
+
+        configuration.blobs_paths = {configuration.blob_path};
+
+        if (configuration.format == "auto" && get_format_from_file)
+            configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+        return configuration;
+    }
 
     if (engine_args.size() < 3 || engine_args.size() > 7)
         throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
@@ -274,10 +338,20 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
     return result;
 }
 
+Poco::URI StorageAzure::Configuration::getConnectionURL() const
+{
+    if (!is_connection_string)
+        return Poco::URI(connection_url);
+
+    auto parsed_connection_string = Azure::Storage::_internal::ParseConnectionString(connection_url);
+    return Poco::URI(parsed_connection_string.BlobServiceUrl.GetAbsoluteUrl());
+}
+
+
 StorageAzure::StorageAzure(
     const Configuration & configuration_,
     std::unique_ptr<AzureObjectStorage> && object_storage_,
-    ContextPtr,
+    ContextPtr context,
     const StorageID & table_id_,
     const ColumnsDescription & columns_,
     const ConstraintsDescription & constraints_,
@@ -293,7 +367,7 @@ StorageAzure::StorageAzure(
     , partition_by(partition_by_)
 {
     FormatFactory::instance().checkFormatName(configuration.format);
-    //context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(configuration.getConnectionURL()));
+    context->getGlobalContext()->getRemoteHostFilter().checkURL(configuration.getConnectionURL());
 
     StorageInMemoryMetadata storage_metadata;
     if (columns_.empty())
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index 6bf18d91265..03a9abf2ce6 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -51,13 +51,7 @@ public:
             return blobs_paths.back().find(PARTITION_ID_WILDCARD) != String::npos;
         }
 
-        std::string getConnectionURL() const
-        {
-            if (!is_connection_string)
-                return connection_url;
-
-            throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Connection string not implemented yet");
-        }
+        Poco::URI getConnectionURL() const;
 
         std::string connection_url;
         bool is_connection_string;
@@ -121,7 +115,6 @@ private:
     const bool distributed_processing;
     std::optional<FormatSettings> format_settings;
     ASTPtr partition_by;
-
 };
 
 }
diff --git a/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml b/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml
new file mode 100644
index 00000000000..dc70895bc05
--- /dev/null
+++ b/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml
@@ -0,0 +1,15 @@
+<clickhouse>
+    <named_collections>
+        <azure_conf1>
+            <connection_string>DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;</connection_string>
+            <container>cont</container>
+            <blob_path>test_simple_write_named.csv</blob_path>
+            <format>CSV</format>
+        </azure_conf1>
+        <azure_conf2>
+            <storage_account_url>http://azurite1:10000/devstoreaccount1</storage_account_url>
+            <account_name>devstoreaccount1</account_name>
+            <account_key>Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==</account_key>
+        </azure_conf2>
+    </named_collections>
+</clickhouse>
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 94b059fe4fe..11404602f58 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -23,6 +23,7 @@ def cluster():
         cluster = ClickHouseCluster(__file__)
         cluster.add_instance(
             "node",
+            main_configs=["configs/named_collections.xml"],
             with_azurite=True,
         )
         cluster.start()
@@ -80,6 +81,19 @@ def test_simple_write_connection_string(cluster):
     print(get_azure_file_content('test_simple_write_c.csv'))
     assert get_azure_file_content('test_simple_write_c.csv') == '1,"a"\n'
 
+def test_simple_write_named_collection_1(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)")
+    azure_query(node, "INSERT INTO test_simple_write_named_collection_1 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'
+
+def test_simple_write_named_collection_2(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')")
+    azure_query(node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')")
+    print(get_azure_file_content('test_simple_write_named_2.csv'))
+    assert get_azure_file_content('test_simple_write_named_2.csv') == '1,"a"\n'
 
 def test_partition_by(cluster):
     node = cluster.instances["node"]

From 1713dbe6318b310ba4414e8f8804fe5e0c8a155f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 12:07:05 +0000
Subject: [PATCH 0430/1478] Grant select on system tables to test user

---
 tests/queries/0_stateless/02771_system_user_processes.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/02771_system_user_processes.sh b/tests/queries/0_stateless/02771_system_user_processes.sh
index f0e5b2a6987..8e2fbfb5287 100755
--- a/tests/queries/0_stateless/02771_system_user_processes.sh
+++ b/tests/queries/0_stateless/02771_system_user_processes.sh
@@ -16,6 +16,7 @@ fi
 
 $CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS $USER"
 $CLICKHOUSE_CLIENT -q "CREATE USER $USER"
+$CLICKHOUSE_CLIENT -q "GRANT SELECT ON system.* TO $USER"
 $CLICKHOUSE_CLIENT -u "$USER" -q "SELECT * FROM system.numbers LIMIT 1"
 $CLICKHOUSE_CLIENT -u "$USER" -q "SELECT * FROM system.numbers LIMIT 1"
 $CLICKHOUSE_CLIENT -q "SELECT user, toBool(ProfileEvents['SelectQuery'] > 0), toBool(ProfileEvents['Query'] > 0) FROM system.user_processes WHERE user='default'"

From c8d85a43c70f96de5c5ce922a43897425566aa00 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 5 Jun 2023 12:22:32 +0000
Subject: [PATCH 0431/1478] Fix unit tests

---
 src/Analyzer/ColumnNode.cpp   | 4 ++--
 src/Analyzer/IQueryTreeNode.h | 5 ++++-
 src/Planner/Utils.cpp         | 2 +-
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/Analyzer/ColumnNode.cpp b/src/Analyzer/ColumnNode.cpp
index dd41522ac7d..3d9f5d1640e 100644
--- a/src/Analyzer/ColumnNode.cpp
+++ b/src/Analyzer/ColumnNode.cpp
@@ -96,7 +96,7 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
     std::vector<std::string> column_identifier_parts;
 
     auto column_source = getColumnSourceOrNull();
-    if (column_source)
+    if (column_source && options.fully_qualified_identifiers)
     {
         auto node_type = column_source->getNodeType();
         if (node_type == QueryTreeNodeType::TABLE ||
@@ -117,7 +117,7 @@ ASTPtr ColumnNode::toASTImpl(const ConvertToASTOptions & options) const
                 else
                 {
                     const auto & table_storage_id = table_node->getStorageID();
-                    if (table_storage_id.hasDatabase() && options.fully_qualified_identifiers)
+                    if (table_storage_id.hasDatabase() && options.qualify_indentifiers_with_database)
                         column_identifier_parts = { table_storage_id.getDatabaseName(), table_storage_id.getTableName() };
                     else
                         column_identifier_parts = { table_storage_id.getTableName() };
diff --git a/src/Analyzer/IQueryTreeNode.h b/src/Analyzer/IQueryTreeNode.h
index 351d03bc8cb..763963b734a 100644
--- a/src/Analyzer/IQueryTreeNode.h
+++ b/src/Analyzer/IQueryTreeNode.h
@@ -187,10 +187,13 @@ public:
 
         /// Identifiers are fully qualified (`database.table.column`), otherwise names are just column names (`column`)
         bool fully_qualified_identifiers = true;
+
+        /// Identifiers are qualified but database name is not added (`table.column`) if set to false.
+        bool qualify_indentifiers_with_database = true;
     };
 
     /// Convert query tree to AST
-    ASTPtr toAST(const ConvertToASTOptions & options = { .add_cast_for_constants = true, .fully_qualified_identifiers = true }) const;
+    ASTPtr toAST(const ConvertToASTOptions & options = { .add_cast_for_constants = true, .fully_qualified_identifiers = true, .qualify_indentifiers_with_database = true }) const;
 
     /// Convert query tree to AST and then format it for error message.
     String formatConvertedASTForErrorMessage() const;
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index 94f3bbf6440..733db0f00bc 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -110,7 +110,7 @@ ASTPtr queryNodeToSelectQuery(const QueryTreeNodePtr & query_node)
 
     // In case of cross-replication we don't know what database is used for the table.
     // Each shard will use the default database (in the case of cross-replication shards may have different defaults).
-    auto result_ast = query_node_typed.toAST({ .fully_qualified_identifiers = false });
+    auto result_ast = query_node_typed.toAST({ .qualify_indentifiers_with_database = false });
 
     while (true)
     {

From 90e9df9109433971d70d544e848eeead361b96f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 12:27:46 +0000
Subject: [PATCH 0432/1478] Revert "Add `SHOW USER PROCESSES` query"

This reverts commit d28b4181e94c5602b5512af8ed541dcc2a1a55f2.
---
 src/Interpreters/InterpreterFactory.cpp       |  6 ----
 .../InterpreterShowUserProcessesQuery.cpp     | 18 -----------
 .../InterpreterShowUserProcessesQuery.h       | 30 -----------------
 src/Parsers/ASTShowUserProcessesQuery.h       | 17 ----------
 src/Parsers/ParserQueryWithOutput.cpp         |  5 +--
 src/Parsers/ParserShowUserProcessesQuery.h    | 32 -------------------
 6 files changed, 1 insertion(+), 107 deletions(-)
 delete mode 100644 src/Interpreters/InterpreterShowUserProcessesQuery.cpp
 delete mode 100644 src/Interpreters/InterpreterShowUserProcessesQuery.h
 delete mode 100644 src/Parsers/ASTShowUserProcessesQuery.h
 delete mode 100644 src/Parsers/ParserShowUserProcessesQuery.h

diff --git a/src/Interpreters/InterpreterFactory.cpp b/src/Interpreters/InterpreterFactory.cpp
index c31e3801478..9cd1f2a251c 100644
--- a/src/Interpreters/InterpreterFactory.cpp
+++ b/src/Interpreters/InterpreterFactory.cpp
@@ -23,7 +23,6 @@
 #include <Parsers/ASTShowTablesQuery.h>
 #include <Parsers/ASTShowColumnsQuery.h>
 #include <Parsers/ASTShowIndexesQuery.h>
-#include <Parsers/ASTShowUserProcessesQuery.h>
 #include <Parsers/ASTUseQuery.h>
 #include <Parsers/ASTWatchQuery.h>
 #include <Parsers/ASTCreateNamedCollectionQuery.h>
@@ -82,7 +81,6 @@
 #include <Interpreters/InterpreterShowEngineQuery.h>
 #include <Interpreters/InterpreterShowProcesslistQuery.h>
 #include <Interpreters/InterpreterShowTablesQuery.h>
-#include <Interpreters/InterpreterShowUserProcessesQuery.h>
 #include <Interpreters/InterpreterShowColumnsQuery.h>
 #include <Interpreters/InterpreterShowIndexesQuery.h>
 #include <Interpreters/InterpreterSystemQuery.h>
@@ -268,10 +266,6 @@ std::unique_ptr<IInterpreter> InterpreterFactory::get(ASTPtr & query, ContextMut
     {
         return std::make_unique<InterpreterShowProcesslistQuery>(query, context);
     }
-    else if (query->as<ASTShowUserProcessesQuery>())
-    {
-        return std::make_unique<InterpreterShowUserProcessesQuery>(query, context);
-    }
     else if (query->as<ASTAlterQuery>())
     {
         return std::make_unique<InterpreterAlterQuery>(query, context);
diff --git a/src/Interpreters/InterpreterShowUserProcessesQuery.cpp b/src/Interpreters/InterpreterShowUserProcessesQuery.cpp
deleted file mode 100644
index 51287a7ad5b..00000000000
--- a/src/Interpreters/InterpreterShowUserProcessesQuery.cpp
+++ /dev/null
@@ -1,18 +0,0 @@
-#include <IO/ReadBufferFromString.h>
-
-#include <Interpreters/Context.h>
-#include <Interpreters/executeQuery.h>
-#include <Interpreters/InterpreterShowUserProcessesQuery.h>
-
-#include <Parsers/ASTQueryWithOutput.h>
-
-
-namespace DB
-{
-
-BlockIO InterpreterShowUserProcessesQuery::execute()
-{
-    return executeQuery("SELECT * FROM system.user_processes ORDER BY user DESC", getContext(), true);
-}
-
-}
diff --git a/src/Interpreters/InterpreterShowUserProcessesQuery.h b/src/Interpreters/InterpreterShowUserProcessesQuery.h
deleted file mode 100644
index a1c385dc82f..00000000000
--- a/src/Interpreters/InterpreterShowUserProcessesQuery.h
+++ /dev/null
@@ -1,30 +0,0 @@
-#pragma once
-
-#include <Interpreters/IInterpreter.h>
-#include <Parsers/IAST_fwd.h>
-
-
-namespace DB
-{
-
-/** Return list of currently executing queries.
-TODO(antaljanosbenjamin)
-  */
-class InterpreterShowUserProcessesQuery : public IInterpreter, WithMutableContext
-{
-public:
-    InterpreterShowUserProcessesQuery(const ASTPtr & query_ptr_, ContextMutablePtr context_)
-        : WithMutableContext(context_), query_ptr(query_ptr_) {}
-
-    BlockIO execute() override;
-
-    /// We ignore the quota and limits here because execute() will rewrite a show query as a SELECT query and then
-    /// the SELECT query will checks the quota and limits.
-    bool ignoreQuota() const override { return true; }
-    bool ignoreLimits() const override { return true; }
-
-private:
-    ASTPtr query_ptr;
-};
-
-}
diff --git a/src/Parsers/ASTShowUserProcessesQuery.h b/src/Parsers/ASTShowUserProcessesQuery.h
deleted file mode 100644
index cd522c152b6..00000000000
--- a/src/Parsers/ASTShowUserProcessesQuery.h
+++ /dev/null
@@ -1,17 +0,0 @@
-#pragma once
-
-#include <Parsers/ASTQueryWithOutput.h>
-
-
-namespace DB
-{
-
-struct ASTShowUserProcessesIDAndQueryNames
-{
-    static constexpr auto ID = "ShowUserProcesses";
-    static constexpr auto Query = "SHOW USER PROCESSES";
-};
-
-using ASTShowUserProcessesQuery = ASTQueryWithOutputImpl<ASTShowUserProcessesIDAndQueryNames>;
-
-}
diff --git a/src/Parsers/ParserQueryWithOutput.cpp b/src/Parsers/ParserQueryWithOutput.cpp
index d5293e5f709..6796f4528c4 100644
--- a/src/Parsers/ParserQueryWithOutput.cpp
+++ b/src/Parsers/ParserQueryWithOutput.cpp
@@ -15,7 +15,6 @@
 #include <Parsers/ParserSelectWithUnionQuery.h>
 #include <Parsers/ParserSetQuery.h>
 #include <Parsers/ParserShowProcesslistQuery.h>
-#include <Parsers/ParserShowUserProcessesQuery.h>
 #include <Parsers/ParserShowTablesQuery.h>
 #include <Parsers/ParserShowColumnsQuery.h>
 #include <Parsers/ParserShowEngineQuery.h>
@@ -62,7 +61,6 @@ bool ParserQueryWithOutput::parseImpl(Pos & pos, ASTPtr & node, Expected & expec
     ParserShowGrantsQuery show_grants_p;
     ParserShowPrivilegesQuery show_privileges_p;
     ParserExplainQuery explain_p(end, allow_settings_after_format_in_insert);
-    ParserShowUserProcessesQuery show_user_processes_p;
 
     ASTPtr query;
 
@@ -90,8 +88,7 @@ bool ParserQueryWithOutput::parseImpl(Pos & pos, ASTPtr & node, Expected & expec
         || show_access_p.parse(pos, query, expected)
         || show_access_entities_p.parse(pos, query, expected)
         || show_grants_p.parse(pos, query, expected)
-        || show_privileges_p.parse(pos, query, expected)
-        || show_user_processes_p.parse(pos, query, expected);
+        || show_privileges_p.parse(pos, query, expected);
 
     if (!parsed)
         return false;
diff --git a/src/Parsers/ParserShowUserProcessesQuery.h b/src/Parsers/ParserShowUserProcessesQuery.h
deleted file mode 100644
index be484e74d5d..00000000000
--- a/src/Parsers/ParserShowUserProcessesQuery.h
+++ /dev/null
@@ -1,32 +0,0 @@
-#pragma once
-
-#include <Parsers/ASTShowUserProcessesQuery.h>
-#include <Parsers/CommonParsers.h>
-#include <Parsers/ExpressionElementParsers.h>
-#include <Parsers/IParserBase.h>
-
-
-namespace DB
-{
-
-/** Query SHOW USER PROCESSES
-  */
-class ParserShowUserProcessesQuery : public IParserBase
-{
-protected:
-    const char * getName() const override { return "SHOW USER PROCESSES query"; }
-
-    bool parseImpl(Pos & pos, ASTPtr & node, Expected & expected) override
-    {
-        auto query = std::make_shared<ASTShowUserProcessesQuery>();
-
-        if (!ParserKeyword("SHOW USER PROCESSES").ignore(pos, expected))
-            return false;
-
-        node = query;
-
-        return true;
-    }
-};
-
-}

From 28eb9562b8a8904941a4b59e8ecf1c5b97aa70cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 12:29:11 +0000
Subject: [PATCH 0433/1478] Remove the usage of `SHOW USER PROCESSES` from
 tests

---
 .../0_stateless/02771_system_user_processes.reference      | 1 -
 tests/queries/0_stateless/02771_system_user_processes.sh   | 7 -------
 2 files changed, 8 deletions(-)

diff --git a/tests/queries/0_stateless/02771_system_user_processes.reference b/tests/queries/0_stateless/02771_system_user_processes.reference
index 8c8ca8abb52..a55207ff3f4 100644
--- a/tests/queries/0_stateless/02771_system_user_processes.reference
+++ b/tests/queries/0_stateless/02771_system_user_processes.reference
@@ -1,4 +1,3 @@
-SHOW USER PROCESSES query succeeded!
 0
 0
 default	true	true
diff --git a/tests/queries/0_stateless/02771_system_user_processes.sh b/tests/queries/0_stateless/02771_system_user_processes.sh
index 8e2fbfb5287..c680283d36e 100755
--- a/tests/queries/0_stateless/02771_system_user_processes.sh
+++ b/tests/queries/0_stateless/02771_system_user_processes.sh
@@ -7,13 +7,6 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 USER_POSTFIX=`random_str 10`
 USER="test_user_02771_$USER_POSTFIX"
 
-if $CLICKHOUSE_CLIENT -q "SHOW USER PROCESSES" &>"${CLICKHOUSE_TMP}/test_output"
-then
-    echo "SHOW USER PROCESSES query succeeded!"
-else
-    cat "${CLICKHOUSE_TMP}/test_output"
-fi
-
 $CLICKHOUSE_CLIENT -q "DROP USER IF EXISTS $USER"
 $CLICKHOUSE_CLIENT -q "CREATE USER $USER"
 $CLICKHOUSE_CLIENT -q "GRANT SELECT ON system.* TO $USER"

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 0434/1478] 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 5cb2d8b4e2849b015682ea05f2105258162f3335 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 12:32:25 +0000
Subject: [PATCH 0435/1478] Update failing tests

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

diff --git a/tests/queries/0_stateless/01399_http_request_headers.reference b/tests/queries/0_stateless/01399_http_request_headers.reference
index 90a10a9818d..92ea6606a12 100644
--- a/tests/queries/0_stateless/01399_http_request_headers.reference
+++ b/tests/queries/0_stateless/01399_http_request_headers.reference
@@ -6,6 +6,7 @@ Code: 516
 1
 Code: 516
 processes
+processes
 Code: 81
 [1]
 Code: 73

From c3d6e4c9155b22fe24018ad0099eef2ccd787f5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 5 Jun 2023 12:36:19 +0000
Subject: [PATCH 0436/1478] Fix docs

---
 docs/en/operations/system-tables/user_processes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/system-tables/user_processes.md b/docs/en/operations/system-tables/user_processes.md
index a9b97390ed6..94c153fb683 100644
--- a/docs/en/operations/system-tables/user_processes.md
+++ b/docs/en/operations/system-tables/user_processes.md
@@ -3,7 +3,7 @@ slug: /en/operations/system-tables/user_processes
 ---
 # user_processes
 
-This system table is used for implementing the `SHOW USER PROCESSES` query.
+This system table can be used to get overview of memory usage and ProfileEvents of users.
 
 Columns:
 

From 4f0adf5f61fca0162184e5d4858c75fdb0a10e2e Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 12:40:54 +0000
Subject: [PATCH 0437/1478] Better support for avro decimals

---
 .../Formats/Impl/AvroRowInputFormat.cpp           |   5 +++--
 .../0_stateless/02782_avro_decimals.reference     |  13 +++++++++++++
 tests/queries/0_stateless/02782_avro_decimals.sh  |  10 ++++++++++
 tests/queries/0_stateless/data_avro/decimals.avro | Bin 0 -> 295 bytes
 4 files changed, 26 insertions(+), 2 deletions(-)
 create mode 100644 tests/queries/0_stateless/02782_avro_decimals.reference
 create mode 100755 tests/queries/0_stateless/02782_avro_decimals.sh
 create mode 100644 tests/queries/0_stateless/data_avro/decimals.avro

diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index c2602a4d1d5..267f9e522e2 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -176,14 +176,15 @@ static AvroDeserializer::DeserializeFn createDecimalDeserializeFn(const avro::No
     {
         static constexpr size_t field_type_size = sizeof(typename DecimalType::FieldType);
         decoder.decodeString(tmp);
-        if (tmp.size() != field_type_size)
+        if (tmp.size() > field_type_size)
             throw ParsingException(
                 ErrorCodes::CANNOT_PARSE_UUID,
-                "Cannot parse type {}, expected binary data with size {}, got {}",
+                "Cannot parse type {}, expected binary data with size less then {}, got {}",
                 target_type->getName(),
                 field_type_size,
                 tmp.size());
 
+        tmp = std::string(field_type_size - tmp.size(), '\0') + tmp;
         typename DecimalType::FieldType field;
         ReadBufferFromString buf(tmp);
         readBinaryBigEndian(field.value, buf);
diff --git a/tests/queries/0_stateless/02782_avro_decimals.reference b/tests/queries/0_stateless/02782_avro_decimals.reference
new file mode 100644
index 00000000000..ed46f1c3758
--- /dev/null
+++ b/tests/queries/0_stateless/02782_avro_decimals.reference
@@ -0,0 +1,13 @@
+d	Decimal(14, 4)					
+0
+1
+1.1
+12.12
+123.123
+1234.1234
+12345.1234
+123456.1234
+1234567.1234
+12345678.1234
+123456789.1234
+1234567890.1234
diff --git a/tests/queries/0_stateless/02782_avro_decimals.sh b/tests/queries/0_stateless/02782_avro_decimals.sh
new file mode 100755
index 00000000000..5b754965806
--- /dev/null
+++ b/tests/queries/0_stateless/02782_avro_decimals.sh
@@ -0,0 +1,10 @@
+#!/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 "desc file('$CUR_DIR/data_avro/decimals.avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$CUR_DIR/data_avro/decimals.avro')"
+
diff --git a/tests/queries/0_stateless/data_avro/decimals.avro b/tests/queries/0_stateless/data_avro/decimals.avro
new file mode 100644
index 0000000000000000000000000000000000000000..5c29ac235d59003696735c8c8092eed5bcce41b2
GIT binary patch
literal 295
zcmeZI%3@>@Nh~YM*GtY%NloU+E6vFf1M`cMGg5OCFECXr<t65(Dp@Hgxuhm%<|gJ8
zE9oeJ#fl3Olfe=tsl_EA!IH`XFuy1@Ilm|cB$Aeynv+rt)Etd41}p(pS`F8eR0%W%
zq$MXmJu^8mCj@F1&`}^uK{5qEb2E!G^Yeh_8JYkEih=4t7Mj%7#?~_AEaAzxcHwdN
z?!Ese>B@y<NE9(Ku&4{LX#HSgyjj2|bh3_vVUPbO4)*BnNgSS2UtHp1x_|qh6PL`s
Y8NWC2Fv=JH=2YV0wkkfS{|VhF0C#F;n*aa+

literal 0
HcmV?d00001


From 55345d5a256cd0c65ce8630fb06f6e5773d8e5c4 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 12:43:38 +0000
Subject: [PATCH 0438/1478] Fix exception message

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

diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index 267f9e522e2..ae65960a372 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -179,7 +179,7 @@ static AvroDeserializer::DeserializeFn createDecimalDeserializeFn(const avro::No
         if (tmp.size() > field_type_size)
             throw ParsingException(
                 ErrorCodes::CANNOT_PARSE_UUID,
-                "Cannot parse type {}, expected binary data with size less then {}, got {}",
+                "Cannot parse type {}, expected binary data with size equal to or less than {}, got {}",
                 target_type->getName(),
                 field_type_size,
                 tmp.size());

From aa20935cb9913d628df08e80b793ad853363203a Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 12:45:14 +0000
Subject: [PATCH 0439/1478] Better

---
 src/Processors/Formats/Impl/AvroRowInputFormat.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index ae65960a372..201845177a5 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -183,8 +183,10 @@ static AvroDeserializer::DeserializeFn createDecimalDeserializeFn(const avro::No
                 target_type->getName(),
                 field_type_size,
                 tmp.size());
+        else if (tmp.size() != field_type_size)
+            /// Add padding with 0-bytes.
+            tmp = std::string(field_type_size - tmp.size(), '\0') + tmp;
 
-        tmp = std::string(field_type_size - tmp.size(), '\0') + tmp;
         typename DecimalType::FieldType field;
         ReadBufferFromString buf(tmp);
         readBinaryBigEndian(field.value, buf);

From bc8ee56a19489bd2d42fd06fdca82ff1948236ca Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Mon, 5 Jun 2023 14:46:52 +0200
Subject: [PATCH 0440/1478] Support settings, test truncate

---
 src/Core/Settings.h                           |  5 +++
 src/Storages/StorageAzure.cpp                 | 37 ++++++++++++++++---
 src/Storages/StorageAzure.h                   |  8 ++++
 .../test_storage_azure_blob_storage/test.py   |  9 +++++
 4 files changed, 53 insertions(+), 6 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 6a0833aef60..a484e8e816d 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -81,7 +81,9 @@ class IColumn;
     M(UInt64, s3_upload_part_size_multiply_parts_count_threshold, 500, "Each time this number of parts was uploaded to S3 s3_min_upload_part_size multiplied by s3_upload_part_size_multiply_factor.", 0) \
     M(UInt64, s3_max_inflight_parts_for_one_file, 20, "The maximum number of a concurrent loaded parts in multipart upload request. 0 means unlimited. You ", 0) \
     M(UInt64, s3_max_single_part_upload_size, 32*1024*1024, "The maximum size of object to upload using singlepart upload to S3.", 0) \
+    M(UInt64, azure_max_single_part_upload_size, 100*1024*1024, "The maximum size of object to upload using singlepart upload to Azure blob storage.", 0) \
     M(UInt64, s3_max_single_read_retries, 4, "The maximum number of retries during single S3 read.", 0) \
+    M(UInt64, azure_max_single_read_retries, 4, "The maximum number of retries during single S3 read.", 0) \
     M(UInt64, s3_max_unexpected_write_error_retries, 4, "The maximum number of retries in case of unexpected errors during S3 write.", 0) \
     M(UInt64, s3_max_redirects, 10, "Max number of S3 redirects hops allowed.", 0) \
     M(UInt64, s3_max_connections, 1024, "The maximum number of connections per server.", 0) \
@@ -90,8 +92,11 @@ class IColumn;
     M(UInt64, s3_max_put_rps, 0, "Limit on S3 PUT request per second rate before throttling. Zero means unlimited.", 0) \
     M(UInt64, s3_max_put_burst, 0, "Max number of requests that can be issued simultaneously before hitting request per second limit. By default (0) equals to `s3_max_put_rps`", 0) \
     M(UInt64, s3_list_object_keys_size, 1000, "Maximum number of files that could be returned in batch by ListObject request", 0) \
+    M(UInt64, azure_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, azure_truncate_on_insert, false, "Enables or disables truncate before insert in azure 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, azure_create_new_file_on_insert, false, "Enables or disables creating a new file on each insert in azure engine tables", 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) \
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 8ce8a923c33..3d519ade3dc 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -255,9 +255,15 @@ void registerStorageAzure(StorageFactory & factory)
         if (args.storage_def->partition_by)
             partition_by = args.storage_def->partition_by->clone();
 
+        const auto & context_settings = args.getContext()->getSettingsRef();
+        auto settings = std::make_unique<AzureObjectStorageSettings>();
+        settings->max_single_part_upload_size = context_settings.azure_max_single_part_upload_size;
+        settings->max_single_read_retries = context_settings.azure_max_single_read_retries;
+        settings->list_object_keys_size = static_cast<int32_t>(context_settings.azure_list_object_keys_size);
+
         return std::make_shared<StorageAzure>(
             std::move(configuration),
-            std::make_unique<AzureObjectStorage>("AzureStorage", std::move(client), std::make_unique<AzureObjectStorageSettings>()),
+            std::make_unique<AzureObjectStorage>("AzureStorage", std::move(client), std::move(settings)),
             args.getContext(),
             args.table_id,
             args.columns,
@@ -395,7 +401,6 @@ StorageAzure::StorageAzure(
 
 void StorageAzure::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
 {
-
     if (configuration.withGlobs())
     {
         throw Exception(
@@ -577,12 +582,12 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
             throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED,
                             "Azure key '{}' contains globs, so the table is in readonly mode", configuration.blob_path);
 
-        bool truncate_in_insert = local_context->getSettingsRef().s3_truncate_on_insert;
+        bool truncate_in_insert = local_context->getSettingsRef().azure_truncate_on_insert;
 
         if (!truncate_in_insert && object_storage->exists(StoredObject(configuration.blob_path)))
         {
 
-            if (local_context->getSettingsRef().s3_create_new_file_on_insert)
+            if (local_context->getSettingsRef().azure_create_new_file_on_insert)
             {
                 size_t index = configuration.blobs_paths.size();
                 const auto & first_key = configuration.blobs_paths[0];
@@ -603,8 +608,8 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
                 throw Exception(
                     ErrorCodes::BAD_ARGUMENTS,
                     "Object in bucket {} with key {} already exists. "
-                    "If you want to overwrite it, enable setting s3_truncate_on_insert, if you "
-                    "want to create a new file on each insert, enable setting s3_create_new_file_on_insert",
+                    "If you want to overwrite it, enable setting azure_truncate_on_insert, if you "
+                    "want to create a new file on each insert, enable setting azure_create_new_file_on_insert",
                     configuration.container, configuration.blobs_paths.back());
             }
         }
@@ -630,6 +635,26 @@ bool StorageAzure::supportsPartitionBy() const
     return true;
 }
 
+bool StorageAzure::supportsSubcolumns() const
+{
+    return FormatFactory::instance().checkIfFormatSupportsSubcolumns(configuration.format);
+}
+
+bool StorageAzure::supportsSubsetOfColumns() const
+{
+    return FormatFactory::instance().checkIfFormatSupportsSubsetOfColumns(configuration.format);
+}
+
+bool StorageAzure::prefersLargeBlocks() const
+{
+    return FormatFactory::instance().checkIfOutputFormatPrefersLargeBlocks(configuration.format);
+}
+
+bool StorageAzure::parallelizeOutputAfterReading(ContextPtr context) const
+{
+    return FormatFactory::instance().checkParallelizeOutputAfterReading(configuration.format, context);
+}
+
 }
 
 #endif
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index 03a9abf2ce6..255d7e713e7 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -103,6 +103,14 @@ public:
 
     bool supportsPartitionBy() const override;
 
+    bool supportsSubcolumns() const override;
+
+    bool supportsSubsetOfColumns() const override;
+
+    bool prefersLargeBlocks() const override;
+
+    bool parallelizeOutputAfterReading(ContextPtr context) const override;
+
     static SchemaCache & getSchemaCache(const ContextPtr & ctx);
 
 private:
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 11404602f58..e78fa185b17 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -134,3 +134,12 @@ def test_partition_by_const_column(cluster):
     azure_query(node, f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
     azure_query(node, f"INSERT INTO test_partitioned_const_write VALUES {values}")
     assert values_csv == get_azure_file_content("test_88.csv")
+
+def test_truncate(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "CREATE TABLE test_truncate (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_truncate.csv', format='CSV')")
+    azure_query(node, "INSERT INTO test_truncate VALUES (1, 'a')")
+    assert get_azure_file_content('test_truncate.csv') == '1,"a"\n'
+    azure_query(node, "TRUNCATE TABLE test_truncate")
+    with pytest.raises(Exception):
+        print(get_azure_file_content('test_truncate.csv'))

From 638775e5802df2393c020d9409855ab58d7ff54b Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 5 Jun 2023 12:48:54 +0000
Subject: [PATCH 0441/1478] Analyzer: fix 01487_distributed_in_not_default_db

---
 tests/broken_tests.txt                                        | 1 -
 .../0_stateless/01487_distributed_in_not_default_db.sql       | 4 ++++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index 02935712325..da2493faa1e 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -37,7 +37,6 @@
 01319_optimize_skip_unused_shards_nesting
 01353_low_cardinality_join_types
 01455_shard_leaf_max_rows_bytes_to_read
-01487_distributed_in_not_default_db
 01495_subqueries_in_with_statement
 01504_rocksdb
 01527_dist_sharding_key_dictGet_reload
diff --git a/tests/queries/0_stateless/01487_distributed_in_not_default_db.sql b/tests/queries/0_stateless/01487_distributed_in_not_default_db.sql
index ccd2c571290..cd027530ac8 100644
--- a/tests/queries/0_stateless/01487_distributed_in_not_default_db.sql
+++ b/tests/queries/0_stateless/01487_distributed_in_not_default_db.sql
@@ -25,6 +25,10 @@ CREATE TABLE d AS t ENGINE = Distributed(test_cluster_two_shards_different_datab
 USE test_01487;
 DROP DATABASE test_01487;
 
+-- After the default database is dropped QueryAnalysisPass cannot process the following SELECT query.
+-- That query is invalid on the initiator node.
+set allow_experimental_analyzer = 0;
+
 SELECT * FROM main_01487.d WHERE value IN (SELECT l.value FROM l) ORDER BY value;
 
 USE main_01487;

From c4e1dc55458cfc53ad3eee1406e6bac61bfe32d7 Mon Sep 17 00:00:00 2001
From: Daniel Kutenin <kutdanila@yandex.ru>
Date: Mon, 5 Jun 2023 14:10:53 +0100
Subject: [PATCH 0442/1478] Enable FAST_DEC_LOOP for Arm LZ4 to get 5% of
 decomp speed

It's disabled for clang because of mobile

https://github.com/lz4/lz4/blob/e82198428c8061372d5adef1f9bfff4203f6081e/lib/lz4.c#L471
---
 contrib/lz4-cmake/CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/contrib/lz4-cmake/CMakeLists.txt b/contrib/lz4-cmake/CMakeLists.txt
index 94def029410..c0fd574134f 100644
--- a/contrib/lz4-cmake/CMakeLists.txt
+++ b/contrib/lz4-cmake/CMakeLists.txt
@@ -12,6 +12,7 @@ add_library (_lz4 ${SRCS})
 add_library (ch_contrib::lz4 ALIAS _lz4)
 
 target_compile_definitions (_lz4 PUBLIC LZ4_DISABLE_DEPRECATE_WARNINGS=1)
+target_compile_definitions (_lz4 PUBLIC LZ4_FAST_DEC_LOOP=1)
 if (SANITIZE STREQUAL "undefined")
     target_compile_options (_lz4 PRIVATE -fno-sanitize=undefined)
 endif ()

From 4c88b7bbb725245060067b101593688f470ee399 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 5 Jun 2023 13:13:49 +0000
Subject: [PATCH 0443/1478] Further improve ANN index docs

---
 .../mergetree-family/annindexes.md            | 152 +++++++++---------
 1 file changed, 72 insertions(+), 80 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 0cc1cff2dad..58655c11321 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -22,15 +22,53 @@ ORDER BY L2Distance(column, Point)
 LIMIT N
 ```
 
-The queries are expensive because the L2 distance (Euclidean distance) between all points in `column` and `Point` must be computed. To speed this process up, ANN indexes store a compact representation of the search space (using clustering, search trees, etc.) which allows to compute an approximate answer quickly.
+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.
 
-## Indexes Structure
+# Creating ANN Indexes
 
-Approximate Nearest Neighbor Search Indexes (or `ANNIndexes`) are similar to skip indexes. They are constructed over granules and determine which granules can be skipped. Compared to skip indices, ANN indices are not only able to skip granules, they can also to select particular granules from a set of granules.
+As long as ANN indexes are experimental, you first need to `SET allow_experimental_annoy_index = 1`.
 
-`ANNIndexes` support two types of queries:
+Syntax to create an ANN index over an `Array` column:
+
+```sql
+CREATE TABLE table
+(
+  `id` Int64,
+  `embedding` Array(Float32),
+  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY <N>
+)
+ENGINE = MergeTree
+ORDER BY id;
+```
+
+Syntax to create an ANN index over a `Tuple` 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>
+)
+ENGINE = MergeTree
+ORDER BY id;
+```
+
+ANN indexes are built during column insertion and merge and `INSERT` and `OPTIMIZE` statements will slower than for ordinary tables. ANNIndexes are ideally used only with immutable or rarely changed data, respectively comparatively many 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 support two types of queries:
 
 - WHERE queries:
+
    ``` sql
    SELECT *
    FROM table
@@ -39,86 +77,40 @@ Approximate Nearest Neighbor Search Indexes (or `ANNIndexes`) are similar to ski
    ```
 
 - ORDER BY queries:
+
   ``` sql
   SELECT *
-  FROM table [WHERE ...]
+  FROM table
+  [WHERE ...]
   ORDER BY DistanceFunction(column, Point)
   LIMIT N
   ```
 
-`DistanceFunction` is a [distance functions](/docs/en/sql-reference/functions/distance-functions.md), `Point` is a given vector (e.g. `(0.17, 0.33, ...)`) and `MaxDistance` is a float value which restricts the size of the neighbourhood.
+`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.
 
-To avoid writing large vectors, you can also use [query parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
+:::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.
 
 ```bash
 clickhouse-client --param_vec='hello' --query="SELECT * FROM table WHERE L2Distance(embedding, {vec: Array(Float32)}) < 1.0"
 ```
+:::
 
-ANN index cannot speed up query that contain both `WHERE` and `ORDER BY`. Queries must have a limit, as the approximate algorithms used to determine the nearest neighbors require a specific number of them.
+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.
 
-Indexes are only used for queries with a `LIMIT` value smaller than setting `max_limit_for_ann_queries` (default: 1 million rows). This helps to prevent memory overflows in queries with a large limit.
+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.
 
-Both types of queries are processed similarly. The indexes are passed the number of neighbors `N`. In `ORDER BY` query they remember the numbers of all parts of the granule that have at least one of neighbor. In `WHERE` query they remember only those parts that satisfy the requirements.
-
-
-## Creating Tables with an ANN Index
-
-As long as ANN indexes are experimental, you first need to `SET allow_experimental_annoy_index = 1`.
-
-Syntax:
-
-```sql
-CREATE TABLE table
-(
-  `id` Int64,
-  `embedding` Tuple(Float32, Float32, Float32),
-  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY N
-)
-ENGINE = MergeTree
-ORDER BY id;
-```
-
-```sql
-CREATE TABLE table
-(
-  `id` Int64,
-  `embedding` Array(Float32),
-  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY N
-)
-ENGINE = MergeTree
-ORDER BY id;
-```
-
-With greater `GRANULARITY` indexes remember the data structure better. The `GRANULARITY` indicates how many granules will be used to construct the index. The more data is provided for the index, the more of it can be handled by one index and the more chances that with the right hyper parameters the index will remember the data structure better. But some indexes can't be built if they don't have enough data, so this granule will always participate in the query. For more information, see the description of indexes.
-
-Note that ANN indexes are built during column insertion and merge, i.e. `INSERT` and `OPTIMIZE` statements are slower than for ordinary tables. ANNIndexes are ideally used only with immutable or rarely changing data in conjunction with many read requests.
-
-# Index list
+# Available ANN Indexes
 
 - [Annoy](/docs/en/engines/table-engines/mergetree-family/annindexes.md#annoy-annoy)
 
-# Annoy {#annoy}
+## Annoy {#annoy}
 
-(currently disabled on ARM due to problems with the algorithm)
+(currently disabled on ARM due to memory safety problems with the algorithm)
 
-This ANN index type implements [Annoy indexes](https://github.com/spotify/annoy).
+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.).
 
-Short description of the algorithm:
-The algorithm recursively divides in half all space by random linear surfaces (lines in 2D, planes in 3D etc.). Thus it makes tree of polyhedrons and points that they contains. Repeating the operation several times for greater accuracy it creates a forest.
-To find K Nearest Neighbours it goes down through the trees and fills the buffer of closest points using the priority queue of polyhedrons. Next, it sorts buffer and return the nearest K points.
-
-Examples:
-
-```sql
-CREATE TABLE table
-(
-  id Int64,
-  embedding Tuple(Float32, Float32, Float32),
-  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, NumTrees]]) GRANULARITY N
-)
-ENGINE = MergeTree
-ORDER BY id;
-```
+Syntax to create a Annoy index over a `Array` column:
 
 ```sql
 CREATE TABLE table
@@ -131,26 +123,26 @@ ENGINE = MergeTree
 ORDER BY id;
 ```
 
+Syntax to create a Annoy index over a `Tuple` column:
+
+```sql
+CREATE TABLE table
+(
+  id Int64,
+  embedding Tuple(Float32[, Float32[, ...]]),
+  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, 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.
+
 :::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`.
 :::
 
-Parameter `DistanceName` is name of a distance function with default `L2Distance`. 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.
-
-```sql
-CREATE TABLE table
-(
-  id Int64,
-  embedding Array(Float32),
-  INDEX ann_index_name embedding TYPE annoy('cosineDistance') GRANULARITY N
-)
-ENGINE = MergeTree
-ORDER BY id;
-```
-
-Annoy currently supports `L2Distance` and `cosineDistance` as distance functions.
-
-Setting `annoy_index_search_k_nodes` (default: `NumTrees * LIMIT`) determines how many nodes are inspected during SELECTs. It can be used to
+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:

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 0444/1478] 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 0445/1478] 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 2b3db1d33c8be5dcfef3ba189a292d469f0f9676 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Mon, 5 Jun 2023 17:05:06 +0200
Subject: [PATCH 0446/1478] Update Metadata.cpp

---
 src/Interpreters/Cache/Metadata.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index fea552c4071..5b6561a665e 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -346,7 +346,7 @@ void LockedKey::removeAllReleasable()
             ++it;
             continue;
         }
-        else if (it->second.evicting())
+        else if (it->second->evicting())
         {
             /// File segment is currently a removal candidate,
             /// we do not know if it will be removed or not yet,

From 3938309374cef05afb618c36d932bd380abb1651 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 5 Jun 2023 08:18:03 -0700
Subject: [PATCH 0447/1478] Implement review comments

---
 .../Serializations/SerializationUUID.cpp      |  2 +-
 src/IO/ReadHelpers.cpp                        | 27 ++++++++++---------
 src/IO/ReadHelpers.h                          |  1 -
 src/IO/WriteHelpers.cpp                       | 25 ++++++++---------
 src/IO/WriteHelpers.h                         |  7 +++--
 .../Formats/Impl/AvroRowInputFormat.cpp       |  2 +-
 .../Formats/Impl/AvroRowOutputFormat.cpp      |  4 +--
 7 files changed, 35 insertions(+), 33 deletions(-)

diff --git a/src/DataTypes/Serializations/SerializationUUID.cpp b/src/DataTypes/Serializations/SerializationUUID.cpp
index 13313111b2b..76be273d7dc 100644
--- a/src/DataTypes/Serializations/SerializationUUID.cpp
+++ b/src/DataTypes/Serializations/SerializationUUID.cpp
@@ -51,7 +51,7 @@ void SerializationUUID::deserializeTextQuoted(IColumn & column, ReadBuffer & ist
     {
         assertChar('\'', istr);
         char * next_pos = find_first_symbols<'\\', '\''>(istr.position(), istr.buffer().end());
-        const auto len = next_pos - istr.position();
+        const size_t len = next_pos - istr.position();
         if ((len == 32 || len == 36) && istr.position()[len] == '\'')
         {
             uuid = parseUUID(std::span(reinterpret_cast<const UInt8 *>(istr.position()), len));
diff --git a/src/IO/ReadHelpers.cpp b/src/IO/ReadHelpers.cpp
index a85a057f2b3..99b3e4b514b 100644
--- a/src/IO/ReadHelpers.cpp
+++ b/src/IO/ReadHelpers.cpp
@@ -31,6 +31,7 @@ namespace ErrorCodes
     extern const int CANNOT_PARSE_QUOTED_STRING;
     extern const int CANNOT_PARSE_DATETIME;
     extern const int CANNOT_PARSE_DATE;
+    extern const int CANNOT_PARSE_UUID;
     extern const int INCORRECT_DATA;
     extern const int ATTEMPT_TO_READ_AFTER_EOF;
     extern const int LOGICAL_ERROR;
@@ -51,33 +52,35 @@ UUID parseUUID(std::span<const UInt8> src)
     UUID uuid;
     const auto * src_ptr = src.data();
     auto * dst = reinterpret_cast<UInt8 *>(&uuid);
-    if (const auto size = src.size(); size == 36)
+    const auto size = src.size();
+    if (size == 36)
     {
-#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
-        parseHex<4>(src_ptr, dst);
-        parseHex<2>(src_ptr + 9, dst + 4);
-        parseHex<2>(src_ptr + 14, dst + 6);
-        parseHex<2>(src_ptr + 19, dst + 8);
-        parseHex<6>(src_ptr + 24, dst + 10);
-#else
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
         const std::reverse_iterator dst_it(dst + sizeof(UUID));
-        /// FIXME This code looks like trash.
         parseHex<4>(src_ptr, dst + 8);
         parseHex<2>(src_ptr + 9, dst + 12);
         parseHex<2>(src_ptr + 14, dst + 14);
         parseHex<2>(src_ptr + 19, dst);
         parseHex<6>(src_ptr + 24, dst + 2);
+#else
+        parseHex<4>(src_ptr, dst);
+        parseHex<2>(src_ptr + 9, dst + 4);
+        parseHex<2>(src_ptr + 14, dst + 6);
+        parseHex<2>(src_ptr + 19, dst + 8);
+        parseHex<6>(src_ptr + 24, dst + 10);
 #endif
     }
     else if (size == 32)
     {
-#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
-        parseHex<16>(src_ptr, dst);
-#else
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
         parseHex<8>(src_ptr, dst + 8);
         parseHex<8>(src_ptr + 16, dst);
+#else
+        parseHex<16>(src_ptr, dst);
 #endif
     }
+    else
+        throw Exception(ErrorCodes::CANNOT_PARSE_UUID, "Unexpected length when trying to parse UUID ({})", size);
 
     return uuid;
 }
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 7e293944d19..804dab16db9 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -765,7 +765,6 @@ inline bool tryReadDateText(ExtendedDayNum & date, ReadBuffer & buf)
     return readDateTextImpl<bool>(date, buf);
 }
 
-/// If string is not like UUID - implementation specific behaviour.
 UUID parseUUID(std::span<const UInt8> src);
 
 template <typename ReturnType = void>
diff --git a/src/IO/WriteHelpers.cpp b/src/IO/WriteHelpers.cpp
index 6023d4c9d5b..4f1a95181d4 100644
--- a/src/IO/WriteHelpers.cpp
+++ b/src/IO/WriteHelpers.cpp
@@ -20,25 +20,12 @@ void formatHex(IteratorSrc src, IteratorDst dst, size_t num_bytes)
     }
 }
 
-/** Function used when byte ordering is important when parsing uuid
- *  ex: When we create an UUID type
- */
 std::array<char, 36> formatUUID(const UUID & uuid)
 {
     std::array<char, 36> dst;
     const auto * src_ptr = reinterpret_cast<const UInt8 *>(&uuid);
     auto * dst_ptr = dst.data();
-#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
-    formatHex(src_ptr, dst_ptr, 4);
-    dst[8] = '-';
-    formatHex(src_ptr + 4, dst_ptr + 9, 2);
-    dst[13] = '-';
-    formatHex(src_ptr + 6, dst_ptr + 14, 2);
-    dst[18] = '-';
-    formatHex(src_ptr + 8, dst_ptr + 19, 2);
-    dst[23] = '-';
-    formatHex(src_ptr + 10, dst_ptr + 24, 6);
-#else
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
     const std::reverse_iterator src_it(src_ptr + 16);
     formatHex(src_it + 8, dst_ptr, 4);
     dst[8] = '-';
@@ -49,6 +36,16 @@ std::array<char, 36> formatUUID(const UUID & uuid)
     formatHex(src_it, dst_ptr + 19, 2);
     dst[23] = '-';
     formatHex(src_it + 2, dst_ptr + 24, 6);
+#else
+    formatHex(src_ptr, dst_ptr, 4);
+    dst[8] = '-';
+    formatHex(src_ptr + 4, dst_ptr + 9, 2);
+    dst[13] = '-';
+    formatHex(src_ptr + 6, dst_ptr + 14, 2);
+    dst[18] = '-';
+    formatHex(src_ptr + 8, dst_ptr + 19, 2);
+    dst[23] = '-';
+    formatHex(src_ptr + 10, dst_ptr + 24, 6);
 #endif
 
     return dst;
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 923684c4249..056c2ca1b50 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -625,12 +625,15 @@ inline void writeXMLStringForTextElement(std::string_view s, WriteBuffer & buf)
     writeXMLStringForTextElement(s.data(), s.data() + s.size(), buf);
 }
 
+/// @brief Serialize `uuid` into an array of characters in big-endian byte order.
+/// @param uuid UUID to serialize.
+/// @return Array of characters in big-endian byte order.
 std::array<char, 36> formatUUID(const UUID & uuid);
 
 inline void writeUUIDText(const UUID & uuid, WriteBuffer & buf)
 {
-    const auto text = formatUUID(uuid);
-    buf.write(text.data(), text.size());
+    const auto serialized_uuid = formatUUID(uuid);
+    buf.write(serialized_uuid.data(), serialized_uuid.size());
 }
 
 void writeIPv4Text(const IPv4 & ip, WriteBuffer & buf);
diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index 974b198a483..a4d4e374f4f 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -256,7 +256,7 @@ AvroDeserializer::DeserializeFn AvroDeserializer::createDeserializeFn(const avro
                     if (tmp.length() != 36)
                         throw ParsingException(ErrorCodes::CANNOT_PARSE_UUID, "Cannot parse uuid {}", tmp);
 
-                    const auto uuid = parseUUID({reinterpret_cast<const UInt8 *>(tmp.data()), tmp.length()});
+                    const UUID uuid = parseUUID({reinterpret_cast<const UInt8 *>(tmp.data()), tmp.length()});
                     assert_cast<DataTypeUUID::ColumnType &>(column).insertValue(uuid);
                     return true;
                 };
diff --git a/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp b/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
index 2b163164d56..f0985e7cffc 100644
--- a/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowOutputFormat.cpp
@@ -329,8 +329,8 @@ AvroSerializer::SchemaWithSerializeFn AvroSerializer::createSchemaWithSerializeF
             return {schema, [](const IColumn & column, size_t row_num, avro::Encoder & encoder)
             {
                 const auto & uuid = assert_cast<const DataTypeUUID::ColumnType &>(column).getElement(row_num);
-                const auto text = formatUUID(uuid);
-                encoder.encodeBytes(reinterpret_cast<const uint8_t *>(text.data()), text.size());
+                const auto serialized_uuid = formatUUID(uuid);
+                encoder.encodeBytes(reinterpret_cast<const uint8_t *>(serialized_uuid.data()), serialized_uuid.size());
             }};
         }
         case TypeIndex::Array:

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 0448/1478] 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 0449/1478] 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 0832cb2d7a3bdd2c5e4721c8d8d71a14ce4485ee Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Mon, 5 Jun 2023 17:51:12 +0200
Subject: [PATCH 0450/1478] Update Metadata.h

---
 src/Interpreters/Cache/Metadata.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 4732123fabc..64f91595822 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -22,7 +22,7 @@ struct FileSegmentMetadata : private boost::noncopyable
 
     size_t size() const;
 
-    bool evicting() const { return !removal_candidate.load(); }
+    bool evicting() const { return removal_candidate.load(); }
 
     Priority::Iterator getQueueIterator() const { return file_segment->getQueueIterator(); }
 

From 654aee209f616aeef350e39cc3c3909862fa14e2 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Mon, 5 Jun 2023 11:55:04 -0400
Subject: [PATCH 0451/1478] add video

---
 .../mergetree-family/invertedindexes.md              | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/en/engines/table-engines/mergetree-family/invertedindexes.md b/docs/en/engines/table-engines/mergetree-family/invertedindexes.md
index 31f5a87a2b6..db3d6d0a479 100644
--- a/docs/en/engines/table-engines/mergetree-family/invertedindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/invertedindexes.md
@@ -15,6 +15,18 @@ tokenized cells of the string column. For example, the string cell "I will be a
 " wi", "wil", "ill", "ll ", "l b", " be" etc. The more fine-granular the input strings are tokenized, the bigger but also the more
 useful the resulting inverted index will be.
 
+<div class='vimeo-container'>
+  <iframe src="//www.youtube.com/embed/O_MnyUkrIq8"
+    width="640"
+    height="360"
+    frameborder="0"
+    allow="autoplay;
+    fullscreen;
+    picture-in-picture"
+    allowfullscreen>
+  </iframe>
+</div>
+
 :::note
 Inverted indexes are experimental and should not be used in production environments yet. They may change in the future in backward-incompatible
 ways, for example with respect to their DDL/DQL syntax or performance/compression characteristics.

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 0452/1478] 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 0453/1478] 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 35439a8b06501460fe9162e09eae0fa9b334d1a1 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 5 Jun 2023 10:47:52 -0700
Subject: [PATCH 0454/1478] Use reverse iterator for little-endian version

---
 src/IO/ReadHelpers.cpp | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/src/IO/ReadHelpers.cpp b/src/IO/ReadHelpers.cpp
index 99b3e4b514b..1bd67e240c9 100644
--- a/src/IO/ReadHelpers.cpp
+++ b/src/IO/ReadHelpers.cpp
@@ -53,15 +53,18 @@ UUID parseUUID(std::span<const UInt8> src)
     const auto * src_ptr = src.data();
     auto * dst = reinterpret_cast<UInt8 *>(&uuid);
     const auto size = src.size();
+
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
+    const std::reverse_iterator dst_it(dst + sizeof(UUID));
+#endif
     if (size == 36)
     {
 #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
-        const std::reverse_iterator dst_it(dst + sizeof(UUID));
-        parseHex<4>(src_ptr, dst + 8);
-        parseHex<2>(src_ptr + 9, dst + 12);
-        parseHex<2>(src_ptr + 14, dst + 14);
-        parseHex<2>(src_ptr + 19, dst);
-        parseHex<6>(src_ptr + 24, dst + 2);
+        parseHex<4>(src_ptr, dst_it + 8);
+        parseHex<2>(src_ptr + 9, dst_it + 12);
+        parseHex<2>(src_ptr + 14, dst_it + 14);
+        parseHex<2>(src_ptr + 19, dst_it);
+        parseHex<6>(src_ptr + 24, dst_it + 2);
 #else
         parseHex<4>(src_ptr, dst);
         parseHex<2>(src_ptr + 9, dst + 4);
@@ -73,8 +76,8 @@ UUID parseUUID(std::span<const UInt8> src)
     else if (size == 32)
     {
 #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
-        parseHex<8>(src_ptr, dst + 8);
-        parseHex<8>(src_ptr + 16, dst);
+        parseHex<8>(src_ptr, dst_it + 8);
+        parseHex<8>(src_ptr + 16, dst_it);
 #else
         parseHex<16>(src_ptr, dst);
 #endif

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 0455/1478] 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 0456/1478] 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 dedb9067ce695bc8324997484aa627722a64ebbd Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Mon, 5 Jun 2023 20:36:17 +0200
Subject: [PATCH 0457/1478] WIP : Azure Table Function, added read and
 StorageAzureSource

---
 src/Common/ProfileEvents.cpp                  |   3 +
 src/Interpreters/ActionsDAG.cpp               |   2 +
 src/Storages/StorageAzure.cpp                 | 116 ++++++++++++++++-
 src/Storages/StorageAzure.h                   |  39 +++++-
 src/TableFunctions/CMakeLists.txt             |   2 +-
 src/TableFunctions/ITableFunctionCluster.h    |   1 +
 src/TableFunctions/TableFunctionAzure.cpp     | 118 ++++++++++++++++++
 src/TableFunctions/TableFunctionAzure.h       |  72 +++++++++++
 src/TableFunctions/registerTableFunctions.cpp |   6 +
 src/TableFunctions/registerTableFunctions.h   |   4 +
 10 files changed, 354 insertions(+), 9 deletions(-)
 create mode 100644 src/TableFunctions/TableFunctionAzure.cpp
 create mode 100644 src/TableFunctions/TableFunctionAzure.h

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index fdee9902634..3cc41c1972d 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -348,6 +348,9 @@ The server successfully detected this situation and will download merged part fr
     M(S3PutObject, "Number of S3 API PutObject calls.") \
     M(S3GetObject, "Number of S3 API GetObject calls.") \
     \
+    M(AzureDeleteObjects, "Number of S3 API DeleteObject(s) calls.") \
+    M(AzureListObjects, "Number of S3 API ListObjects calls.") \
+    \
     M(DiskS3DeleteObjects, "Number of DiskS3 API DeleteObject(s) calls.") \
     M(DiskS3CopyObject, "Number of DiskS3 API CopyObject calls.") \
     M(DiskS3ListObjects, "Number of DiskS3 API ListObjects calls.") \
diff --git a/src/Interpreters/ActionsDAG.cpp b/src/Interpreters/ActionsDAG.cpp
index cbf6cc1cbe3..94bdca60e69 100644
--- a/src/Interpreters/ActionsDAG.cpp
+++ b/src/Interpreters/ActionsDAG.cpp
@@ -598,6 +598,8 @@ Block ActionsDAG::updateHeader(Block header) const
     }
 
     ColumnsWithTypeAndName result_columns;
+
+
     result_columns.reserve(outputs.size());
 
     struct Frame
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 30fd3fcbe95..683da3a9825 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -15,6 +15,7 @@
 #include <Formats/FormatFactory.h>
 #include <Formats/ReadSchemaUtils.h>
 #include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypesNumber.h>
 #include <re2/re2.h>
 
 #include <azure/identity/managed_identity_credential.hpp>
@@ -32,6 +33,9 @@
 #include <Storages/NamedCollectionsHelpers.h>
 #include <Storages/ReadFromStorageProgress.h>
 
+#include <QueryPipeline/QueryPipelineBuilder.h>
+#include <QueryPipeline/Pipe.h>
+
 
 using namespace Azure::Storage::Blobs;
 
@@ -52,6 +56,8 @@ bool isConnectionString(const std::string & candidate)
 
 StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
 {
+    LOG_INFO(&Poco::Logger::get("StorageAzure"), "get_format_from_file  = {}", get_format_from_file);
+
     StorageAzure::Configuration configuration;
 
     /// Supported signatures:
@@ -74,6 +80,11 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
     configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
     configuration.blob_path = checkAndGetLiteralArgument<String>(engine_args[2], "blobpath");
 
+    LOG_INFO(&Poco::Logger::get("StorageAzure"), "connection_url  = {}", configuration.connection_url);
+    LOG_INFO(&Poco::Logger::get("StorageAzure"), "container  = {}", configuration.container);
+    LOG_INFO(&Poco::Logger::get("StorageAzure"), "blobpath  = {}", configuration.blob_path);
+
+
     auto is_format_arg = [] (const std::string & s) -> bool
     {
         return s == "auto" || FormatFactory::instance().getAllFormats().contains(s);
@@ -81,6 +92,7 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 
     if (engine_args.size() == 4)
     {
+        //'c1 UInt64, c2 UInt64
         auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
         if (is_format_arg(fourth_arg))
         {
@@ -143,8 +155,13 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 
     configuration.blobs_paths = {configuration.blob_path};
 
-    if (configuration.format == "auto" && get_format_from_file)
-        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+    LOG_INFO(&Poco::Logger::get("StorageAzure"), "get_format_from_file  = {}", get_format_from_file);
+
+//    if (configuration.format == "auto" && get_format_from_file)
+//        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+    configuration.format = "TSV";
 
     return configuration;
 }
@@ -215,6 +232,7 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
 
     if (configuration.is_connection_string)
     {
+        LOG_INFO(&Poco::Logger::get("StorageAzure"), "createClient is_connection_string ");
         result = std::make_unique<BlobContainerClient>(BlobContainerClient::CreateFromConnectionString(configuration.connection_url, configuration.container));
     }
     else
@@ -228,8 +246,14 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
         auto managed_identity_credential = std::make_shared<Azure::Identity::ManagedIdentityCredential>();
 
         result = std::make_unique<BlobContainerClient>(configuration.connection_url, managed_identity_credential);
+
+        LOG_INFO(&Poco::Logger::get("StorageAzure"), "createClient account_name & account_key ");
     }
 
+
+
+
+
     return result;
 }
 
@@ -251,15 +275,13 @@ StorageAzure::StorageAzure(
     , format_settings(format_settings_)
     , partition_by(partition_by_)
 {
-    FormatFactory::instance().checkFormatName(configuration.format);
+//    FormatFactory::instance().checkFormatName(configuration.format);
     context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(configuration.getConnectionURL()));
 
     StorageInMemoryMetadata storage_metadata;
     if (columns_.empty())
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Schema inference is not supported yet");
-        //auto columns = getTableStructureFromDataImpl(configuration, format_settings, context_);
-        //storage_metadata.setColumns(columns);
     }
     else
         storage_metadata.setColumns(columns_);
@@ -268,11 +290,28 @@ StorageAzure::StorageAzure(
     storage_metadata.setComment(comment);
     setInMemoryMetadata(storage_metadata);
 
+    StoredObjects objects;
+    for (const auto & key : configuration.blobs_paths)
+        objects.emplace_back(key);
+
+    for (auto obj : objects)
+    {
+        LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor obj.remote_paths  = {}", obj.remote_path);
+        if (object_storage->exists(obj))
+        {
+            LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor exists  obj.remote_paths  = {}", obj.remote_path);
+//            auto read_buffer = object_storage->readObject(obj);
+//            LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor read size  obj.remote_paths  = {} , size = {}", obj.remote_path, read_buffer->getFileSize());
+        }
+    }
+
+
     auto default_virtuals = NamesAndTypesList{
         {"_path", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())},
         {"_file", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())}};
 
     auto columns = storage_metadata.getSampleBlock().getNamesAndTypesList();
+
     virtual_columns = getVirtualsForStorage(columns, default_virtuals);
     for (const auto & column : virtual_columns)
         virtual_block.insert({column.type->createColumn(), column.type, column.name});
@@ -435,6 +474,35 @@ private:
 
 }
 
+
+Pipe StorageAzure::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*/)
+{
+    Pipes pipes;
+
+    StoredObjects objects;
+    for (const auto & key : configuration.blobs_paths)
+        objects.emplace_back(key);
+
+    auto reader = object_storage->readObjects(objects);
+    auto block_for_format = storage_snapshot->metadata->getSampleBlock();
+
+    for (auto col : block_for_format.getColumns())
+        LOG_INFO(&Poco::Logger::get("StorageAzure"), "read col  = {}",col->getName());
+
+
+    pipes.emplace_back(std::make_shared<StorageAzureSource>(std::move(reader), context, block_for_format, max_block_size));
+
+
+    return Pipe::unitePipes(std::move(pipes));
+}
+
 SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
 {
     auto sample_block = metadata_snapshot->getSampleBlock();
@@ -513,6 +581,44 @@ bool StorageAzure::supportsPartitionBy() const
     return true;
 }
 
+
+StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase> && read_buffer_, ContextPtr context_,
+                                       const Block & sample_block_,UInt64 max_block_size_)
+    :ISource(Block())
+    , WithContext(context_)
+    , read_buffer(std::move(read_buffer_))
+    , sample_block(sample_block_)
+    , max_block_size(max_block_size_)
+{
+    auto format = "TSV";
+
+    auto input_format = FormatFactory::instance().getInput(
+        format, *read_buffer, sample_block, getContext(), max_block_size);
+
+    QueryPipelineBuilder builder;
+    builder.init(Pipe(input_format));
+
+    pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
+    reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
+}
+
+
+Chunk StorageAzureSource::generate()
+{
+    Chunk chunk;
+    if (reader->pull(chunk))
+    {
+        LOG_INFO(&Poco::Logger::get("StorageAzureSource"), "pulled chunk rows = {}", chunk.getNumRows());
+
+    }
+    return chunk;
+}
+
+String StorageAzureSource::getName() const
+{
+    return "StorageAzureSource";
+}
+
 }
 
 #endif
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index b99df2e89a5..b93501ce2f2 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -48,10 +48,9 @@ public:
 
         std::string getConnectionURL() const
         {
-            if (!is_connection_string)
+//            if (!is_connection_string)
                 return connection_url;
-
-            throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Connection string not implemented yet");
+            //throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Connection string not implemented yet");
         }
 
         std::string connection_url;
@@ -78,6 +77,11 @@ public:
 
     static StorageAzure::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
     static AzureClientPtr createClient(StorageAzure::Configuration configuration);
+    static AzureObjectStorage::SettingsPtr createSettings(StorageAzure::Configuration configuration);
+    static ColumnsDescription getTableStructureFromData(
+        const StorageAzure::Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
+        ContextPtr ctx);
 
     String getName() const override
     {
@@ -114,6 +118,35 @@ private:
     std::optional<FormatSettings> format_settings;
     ASTPtr partition_by;
 
+    static ColumnsDescription getTableStructureFromDataImpl(
+        const Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
+        ContextPtr ctx);
+
+};
+
+class StorageAzureSource : public ISource, WithContext
+{
+public:
+    StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase> && read_buffer_, ContextPtr context_, const Block & sample_block_, UInt64 max_block_size_);
+    ~StorageAzureSource() override {}
+
+    Chunk generate() override;
+    String getName() const override;
+
+
+private:
+//    std::unique_ptr<ReadBufferFromFileBase> read_buffer;
+
+    String path;
+    std::unique_ptr<ReadBufferFromFileBase> read_buffer;
+//    std::unique_ptr<ReadBuffer> read_buf;
+    std::unique_ptr<QueryPipeline> pipeline;
+    std::unique_ptr<PullingPipelineExecutor> reader;
+    Block sample_block;
+    UInt64 max_block_size;
+
+//    void createReader();
 };
 
 }
diff --git a/src/TableFunctions/CMakeLists.txt b/src/TableFunctions/CMakeLists.txt
index b1fa61a72ee..3544c5bf8b4 100644
--- a/src/TableFunctions/CMakeLists.txt
+++ b/src/TableFunctions/CMakeLists.txt
@@ -17,5 +17,5 @@ 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)
+    target_link_libraries(clickhouse_table_functions PRIVATE ch_contrib::hivemetastore ch_contrib::hdfs ch_contrib::parquet ch_contrib::azure_sdk)
 endif ()
diff --git a/src/TableFunctions/ITableFunctionCluster.h b/src/TableFunctions/ITableFunctionCluster.h
index ad88d7b54f0..f68558596ca 100644
--- a/src/TableFunctions/ITableFunctionCluster.h
+++ b/src/TableFunctions/ITableFunctionCluster.h
@@ -4,6 +4,7 @@
 
 #include <TableFunctions/ITableFunction.h>
 #include <TableFunctions/TableFunctionS3.h>
+#include <TableFunctions/TableFunctionAzure.h>
 #include <Storages/StorageS3Cluster.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Interpreters/Context.h>
diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzure.cpp
new file mode 100644
index 00000000000..eb67ed9a983
--- /dev/null
+++ b/src/TableFunctions/TableFunctionAzure.cpp
@@ -0,0 +1,118 @@
+#include "config.h"
+
+#if USE_AZURE_BLOB_STORAGE
+
+//#include <IO/S3Common.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Interpreters/Context.h>
+#include <TableFunctions/TableFunctionFactory.h>
+#include <TableFunctions/TableFunctionS3.h>
+#include <TableFunctions/TableFunctionAzure.h>
+#include <Interpreters/parseColumnsListForTableFunction.h>
+#include <Access/Common/AccessFlags.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/ASTIdentifier.h>
+#include <Parsers/ASTFunction.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+#include <Storages/StorageAzure.h>
+#include <Storages/StorageS3.h>
+#include <Storages/StorageURL.h>
+#include <Storages/NamedCollectionsHelpers.h>
+#include <Formats/FormatFactory.h>
+#include "registerTableFunctions.h"
+#include <Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h>
+#include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypesNumber.h>
+
+#include <boost/algorithm/string.hpp>
+
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+    extern const int LOGICAL_ERROR;
+}
+
+
+void TableFunctionAzure::parseArgumentsImpl(ASTs & args, const ContextPtr & context)
+{
+    if (args.size() != 5)
+        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);
+
+    configuration.connection_url = checkAndGetLiteralArgument<String>(args[0], "connection_url");
+    configuration.container = checkAndGetLiteralArgument<String>(args[1], "container");
+    configuration.blob_path = checkAndGetLiteralArgument<String>(args[2], "blob_path");
+    configuration.format = checkAndGetLiteralArgument<String>(args[3], "format");
+    configuration.structure = checkAndGetLiteralArgument<String>(args[4], "structure");
+}
+
+void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr context)
+{
+    LOG_INFO(&Poco::Logger::get("TableFunctionAzure"), "parseArguments = {}", ast_function->dumpTree());
+
+    ASTs & args_func = ast_function->children;
+
+    if (args_func.size() != 1)
+        throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "Table function '{}' must have arguments.", getName());
+
+    auto & args = args_func.at(0)->children;
+
+    parseArgumentsImpl(args, context);
+}
+
+ColumnsDescription TableFunctionAzure::getActualTableStructure(ContextPtr context) const
+{
+    return parseColumnsListFromString(configuration.structure, context);
+}
+
+bool TableFunctionAzure::supportsReadingSubsetOfColumns()
+{
+    return FormatFactory::instance().checkIfFormatSupportsSubsetOfColumns(configuration.format);
+}
+
+StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
+{
+    LOG_INFO(&Poco::Logger::get("TableFunctionAzure"), "executeImpl  = {}", table_name);
+
+    ColumnsDescription columns;
+    columns = parseColumnsListFromString(configuration.structure, context);
+
+    configuration.is_connection_string = true;
+    configuration.blobs_paths = {configuration.blob_path};
+
+    auto client = StorageAzure::createClient(configuration);
+
+    StoragePtr storage = std::make_shared<StorageAzure>(
+        configuration,
+        std::make_unique<AzureObjectStorage>(table_name, std::move(client), std::make_unique<AzureObjectStorageSettings>()),
+        context,
+        StorageID(getDatabaseName(), table_name),
+        columns,
+        ConstraintsDescription{},
+        String{},
+        /// No format_settings for table function Azure
+        std::nullopt, nullptr);
+
+    storage->startup();
+
+    return storage;
+}
+
+void registerTableFunctionAzure(TableFunctionFactory & factory)
+{
+    factory.registerFunction<TableFunctionAzure>(
+        {.documentation
+         = {.description=R"(The table function can be used to read the data stored on Azure Blob Storage.)",
+            .examples{{"azure_blob", "SELECT * FROM  azure_blob(connection, container, blob_path, format, structure)", ""}}},
+         .allow_readonly = false});
+}
+
+}
+
+#endif
diff --git a/src/TableFunctions/TableFunctionAzure.h b/src/TableFunctions/TableFunctionAzure.h
new file mode 100644
index 00000000000..a6fb5415113
--- /dev/null
+++ b/src/TableFunctions/TableFunctionAzure.h
@@ -0,0 +1,72 @@
+#pragma once
+
+#include "config.h"
+
+#if USE_AZURE_BLOB_STORAGE
+
+#include <TableFunctions/ITableFunction.h>
+#include <Storages/StorageAzure.h>
+
+
+namespace DB
+{
+
+class Context;
+
+/* AzureBlob(source, [access_key_id, secret_access_key,] [format, structure, compression]) - creates a temporary storage for a file in AzureBlob.
+ */
+class TableFunctionAzure : public ITableFunction
+{
+public:
+    static constexpr auto name = "azure_blob";
+    static constexpr auto signature = "- connection_url, container, blob, format, structure\n";
+
+    static size_t getMaxNumberOfArguments() { return 5; }
+
+    String getName() const override
+    {
+        return name;
+    }
+
+    virtual String getSignature() const
+    {
+        return signature;
+    }
+
+    bool hasStaticStructure() const override { return configuration.structure != "auto"; }
+
+    bool needStructureHint() const override { return configuration.structure == "auto"; }
+
+    void setStructureHint(const ColumnsDescription & structure_hint_) override { structure_hint = structure_hint_; }
+
+    bool supportsReadingSubsetOfColumns() override;
+
+    std::unordered_set<String> getVirtualsToCheckBeforeUsingStructureHint() const override
+    {
+        return {"_path", "_file"};
+    }
+
+    virtual void parseArgumentsImpl(ASTs & args, const ContextPtr & context);
+
+    static void addColumnsStructureToArguments(ASTs & args, const String & structure, const ContextPtr & context);
+
+protected:
+
+    StoragePtr executeImpl(
+        const ASTPtr & ast_function,
+        ContextPtr context,
+        const std::string & table_name,
+        ColumnsDescription cached_columns) const override;
+
+    const char * getStorageTypeName() const override { return "Azure"; }
+
+    ColumnsDescription getActualTableStructure(ContextPtr context) const override;
+    void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
+
+    mutable StorageAzure::Configuration configuration;
+    ColumnsDescription structure_hint;
+};
+
+}
+
+#endif
diff --git a/src/TableFunctions/registerTableFunctions.cpp b/src/TableFunctions/registerTableFunctions.cpp
index 4f3411df4c5..e0114368e44 100644
--- a/src/TableFunctions/registerTableFunctions.cpp
+++ b/src/TableFunctions/registerTableFunctions.cpp
@@ -71,6 +71,12 @@ void registerTableFunctions()
 
     registerTableFunctionFormat(factory);
     registerTableFunctionExplain(factory);
+
+#if USE_AZURE_BLOB_STORAGE
+    registerTableFunctionAzure(factory);
+#endif
+
+
 }
 
 }
diff --git a/src/TableFunctions/registerTableFunctions.h b/src/TableFunctions/registerTableFunctions.h
index c51522a5e99..fa4fec2b03a 100644
--- a/src/TableFunctions/registerTableFunctions.h
+++ b/src/TableFunctions/registerTableFunctions.h
@@ -69,6 +69,10 @@ void registerTableFunctionFormat(TableFunctionFactory & factory);
 
 void registerTableFunctionExplain(TableFunctionFactory & factory);
 
+#if USE_AZURE_BLOB_STORAGE
+void registerTableFunctionAzure(TableFunctionFactory & factory);
+#endif
+
 void registerTableFunctions();
 
 }

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 0458/1478] 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 4da37a731962ab452ef6a7fb75025f0a6f4e2a51 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:19:50 -0300
Subject: [PATCH 0459/1478] Update argmax.md

---
 .../aggregate-functions/reference/argmax.md   | 60 ++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 65c43ab04c0..9aaa35dc6d8 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -5,7 +5,8 @@ sidebar_position: 106
 
 # argMax
 
-Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered.
+Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered. 
+Both parts the `arg` and the `max` behave as aggregate functions, they skip `Null` during processing and return not-Null values if not-Null values are available.
 
 **Syntax**
 
@@ -49,3 +50,60 @@ Result:
 │ director             │
 └──────────────────────┘
 ```
+
+**Extended example**
+
+```sql
+CREATE TABLE test
+(
+    a Nullable(String),
+    b Nullable(Int64)
+)
+ENGINE = Memory AS
+SELECT *
+FROM values(('a', 1), ('b', 2), ('c', 2), (NULL, 3), (NULL, NULL), ('d', NULL));
+
+select * from test;
+┌─a────┬────b─┐
+│ a    │    1 │
+│ b    │    2 │
+│ c    │    2 │
+│ ᴺᵁᴸᴸ │    3 │
+│ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │
+│ d    │ ᴺᵁᴸᴸ │
+└──────┴──────┘
+
+select argMax(a, b), max(b) from test;
+┌─argMax(a, b)─┬─max(b)─┐
+│ b            │      3 │ -- argMax = b because it the first not-Null value, max(b) is from another row!
+└──────────────┴────────┘
+
+select argMax(tuple(a), b) from test;
+┌─argMax(tuple(a), b)─┐
+│ (NULL)              │ -- Tuple allows to get Null value.
+└─────────────────────┘
+
+select (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB from test;
+┌─argMaxA─┬─argMaxB─┐
+│ ᴺᵁᴸᴸ    │       3 │ -- you can use Tuple and get both (all - tuple(*) ) columns for the according max(b)
+└─────────┴─────────┘
+
+select argMax(a, b), max(b) from test where a is Null and b is Null;
+┌─argMax(a, b)─┬─max(b)─┐
+│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- Nulls are not skipped because only Null values are available
+└──────────────┴────────┘
+
+select argMax(a, (b,a)) from test;
+┌─argMax(a, tuple(b, a))─┐
+│ c                      │ -- There are two rows with b=2, Tuple in the `Max` allows to get not the first `arg`
+└────────────────────────┘
+
+select argMax(a, tuple(b)) from test;
+┌─argMax(a, tuple(b))─┐
+│ b                   │ -- Tuple can be used `Max` to not skip Nulls in `Max`
+└─────────────────────┘
+```
+
+**See also**
+
+- [Tuple](../../sql-reference/data-types/tuple.md)

From 6741a6d7c81ab9a17042170c182327295a6de356 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:21:09 -0300
Subject: [PATCH 0460/1478] Update argmax.md

---
 docs/en/sql-reference/aggregate-functions/reference/argmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 9aaa35dc6d8..7800e90eec7 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -106,4 +106,4 @@ select argMax(a, tuple(b)) from test;
 
 **See also**
 
-- [Tuple](../../sql-reference/data-types/tuple.md)
+- [Tuple](../../data-types/tuple.md)

From 113ce8c7574f3e8348cf3ba7981e9a837460ff8b Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:43:07 -0300
Subject: [PATCH 0461/1478] Update argmin.md

---
 .../aggregate-functions/reference/argmin.md   | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index a7c21e3f15b..7972bdf84b8 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -6,6 +6,7 @@ sidebar_position: 105
 # argMin
 
 Calculates the `arg` value for a minimum `val` value. If there are several different values of `arg` for minimum values of `val`, returns the first of these values encountered.
+Both parts the `arg` and the `min` behave as [aggregate functions](../aggregate-functions/index.md), they both [skip `Null`](../aggregate-functions/index.md#null-processing) during processing and return not-Null values if not-Null values are available.
 
 **Syntax**
 
@@ -49,3 +50,65 @@ Result:
 │ worker               │
 └──────────────────────┘
 ```
+
+**Extended example**
+
+```sql
+CREATE TABLE test
+(
+    a Nullable(String),
+    b Nullable(Int64)
+)
+ENGINE = Memory AS
+SELECT *
+FROM values((NULL, 0), ('a', 1), ('b', 2), ('c', 2), (NULL, NULL), ('d', NULL));
+
+select * from test;
+┌─a────┬────b─┐
+│ ᴺᵁᴸᴸ │    0 │
+│ a    │    1 │
+│ b    │    2 │
+│ c    │    2 │
+│ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │
+│ d    │ ᴺᵁᴸᴸ │
+└──────┴──────┘
+
+select argMin(a, b), min(b) from test;
+┌─argMin(a, b)─┬─min(b)─┐
+│ a            │      0 │ -- argMin = a because it the first not-Null value, min(b) is from another row!
+└──────────────┴────────┘
+
+select argMin(tuple(a), b) from test;
+┌─argMin(tuple(a), b)─┐
+│ (NULL)              │ -- Tuple allows to get Null value.
+└─────────────────────┘
+
+select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
+┌─argMinA─┬─argMinB─┐
+│ ᴺᵁᴸᴸ    │       0 │ -- you can use Tuple and get both (all - tuple(*) ) columns for the according max(b)
+└─────────┴─────────┘
+
+select argMin(a, b), min(b) from test where a is Null and b is Null;
+┌─argMin(a, b)─┬─min(b)─┐
+│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- Nulls are not skipped because only Null values are available
+└──────────────┴────────┘
+
+select argMin(a, (b, a)), min(tuple(b, a)) from test;
+┌─argMin(a, tuple(b, a))─┬─min(tuple(b, a))─┐
+│ d                      │ (NULL,NULL)      │ 'd' is the first Not null value for the min
+└────────────────────────┴──────────────────┘
+
+select argMin((a, b), (b, a)), min(tuple(b, a)) from test;
+┌─argMin(tuple(a, b), tuple(b, a))─┬─min(tuple(b, a))─┐
+│ (NULL,NULL)                      │ (NULL,NULL)      │
+└──────────────────────────────────┴──────────────────┘
+
+select argMin(a, tuple(b)) from test;
+┌─argMax(a, tuple(b))─┐
+│ b                   │ -- Tuple can be used in `Min` to not skip Nulls in `Min`
+└─────────────────────┘
+```
+
+**See also**
+
+- [Tuple](../../data-types/tuple.md)

From 40986539775f5d74659521000fe4aa05ca47b06b Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:43:47 -0300
Subject: [PATCH 0462/1478] Update argmin.md

---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 7972bdf84b8..a481157784b 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -6,7 +6,7 @@ sidebar_position: 105
 # argMin
 
 Calculates the `arg` value for a minimum `val` value. If there are several different values of `arg` for minimum values of `val`, returns the first of these values encountered.
-Both parts the `arg` and the `min` behave as [aggregate functions](../aggregate-functions/index.md), they both [skip `Null`](../aggregate-functions/index.md#null-processing) during processing and return not-Null values if not-Null values are available.
+Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not-Null values if not-Null values are available.
 
 **Syntax**
 

From a175e4628e640376bc49ceabcebb278159e6d55f Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:44:42 -0300
Subject: [PATCH 0463/1478] Update argmax.md

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

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 7800e90eec7..a736804c8dc 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -6,7 +6,7 @@ sidebar_position: 106
 # argMax
 
 Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered. 
-Both parts the `arg` and the `max` behave as aggregate functions, they skip `Null` during processing and return not-Null values if not-Null values are available.
+Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not-Null values if not-Null values are available.
 
 **Syntax**
 
@@ -100,7 +100,7 @@ select argMax(a, (b,a)) from test;
 
 select argMax(a, tuple(b)) from test;
 ┌─argMax(a, tuple(b))─┐
-│ b                   │ -- Tuple can be used `Max` to not skip Nulls in `Max`
+│ b                   │ -- Tuple can be used in `Max` to not skip Nulls in `Max`
 └─────────────────────┘
 ```
 

From 3e444790af079c3d486ac943b29d4900f4d0576f Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:52:51 -0300
Subject: [PATCH 0464/1478] Update index.md

---
 docs/en/sql-reference/aggregate-functions/index.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index 8951ac4ee6a..019e1cab873 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -72,3 +72,15 @@ FROM t_null_big
 │ 2.3333333333333335 │                 1.4 │
 └────────────────────┴─────────────────────┘
 ```
+
+Also you can use [Tuple](../data-types/tuple.md) to change NULL skipping behavior.
+
+```sql
+select groupArray(b), groupArray(tuple(b)) from t_null_big;
+┌─groupArray(b)─┬─groupArray(tuple(b))────────┐
+│ [2,2,3]       │ [(2),(NULL),(2),(3),(NULL)] │
+└───────────────┴─────────────────────────────┘
+```
+
+
+

From b4c0d68d0f7a17702d074a9a2f216bbda524c94d Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:53:37 -0300
Subject: [PATCH 0465/1478] Update index.md

---
 docs/en/sql-reference/aggregate-functions/index.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index 019e1cab873..a3808335168 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -76,10 +76,11 @@ FROM t_null_big
 Also you can use [Tuple](../data-types/tuple.md) to change NULL skipping behavior.
 
 ```sql
-select groupArray(b), groupArray(tuple(b)) from t_null_big;
-┌─groupArray(b)─┬─groupArray(tuple(b))────────┐
-│ [2,2,3]       │ [(2),(NULL),(2),(3),(NULL)] │
-└───────────────┴─────────────────────────────┘
+select groupArray(b), groupArray(tuple(b)).1 from t_null_big;
+
+┌─groupArray(b)─┬─tupleElement(groupArray(tuple(b)), 1)─┐
+│ [2,2,3]       │ [2,NULL,2,3,NULL]                     │
+└───────────────┴───────────────────────────────────────┘
 ```
 
 

From e37cd36db7316c5d2a90df8ca8d8bee8fa016e4a Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:57:28 -0300
Subject: [PATCH 0466/1478] Update argmin.md

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

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index a481157784b..067c81f56cf 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -85,7 +85,7 @@ select argMin(tuple(a), b) from test;
 
 select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
 ┌─argMinA─┬─argMinB─┐
-│ ᴺᵁᴸᴸ    │       0 │ -- you can use Tuple and get both (all - tuple(*) ) columns for the according max(b)
+│ ᴺᵁᴸᴸ    │       0 │ -- you can use Tuple and get both (all - tuple(*)) columns for the according max(b)
 └─────────┴─────────┘
 
 select argMin(a, b), min(b) from test where a is Null and b is Null;
@@ -95,7 +95,7 @@ select argMin(a, b), min(b) from test where a is Null and b is Null;
 
 select argMin(a, (b, a)), min(tuple(b, a)) from test;
 ┌─argMin(a, tuple(b, a))─┬─min(tuple(b, a))─┐
-│ d                      │ (NULL,NULL)      │ 'd' is the first Not null value for the min
+│ d                      │ (NULL,NULL)      │ -- 'd' is the first Not null value for the min
 └────────────────────────┴──────────────────┘
 
 select argMin((a, b), (b, a)), min(tuple(b, a)) from test;

From 15fcad190933aa7b885bdeacb9b2f277104433ac Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 5 Jun 2023 16:57:42 -0300
Subject: [PATCH 0467/1478] Update argmax.md

---
 docs/en/sql-reference/aggregate-functions/reference/argmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index a736804c8dc..8a84f361589 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -85,7 +85,7 @@ select argMax(tuple(a), b) from test;
 
 select (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB from test;
 ┌─argMaxA─┬─argMaxB─┐
-│ ᴺᵁᴸᴸ    │       3 │ -- you can use Tuple and get both (all - tuple(*) ) columns for the according max(b)
+│ ᴺᵁᴸᴸ    │       3 │ -- you can use Tuple and get both (all - tuple(*)) columns for the according max(b)
 └─────────┴─────────┘
 
 select argMax(a, b), max(b) from test where a is Null and b is Null;

From 3023eb73d02fe7825626a1b5767827432f1513c1 Mon Sep 17 00:00:00 2001
From: Misz606 <113922942+Misz606@users.noreply.github.com>
Date: Mon, 5 Jun 2023 21:02:27 +0100
Subject: [PATCH 0468/1478] Update aggregatingmergetree.md

Grammatical update in docs
---
 .../table-engines/mergetree-family/aggregatingmergetree.md      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/aggregatingmergetree.md b/docs/en/engines/table-engines/mergetree-family/aggregatingmergetree.md
index 2b8b43802ea..62191d9b5e4 100644
--- a/docs/en/engines/table-engines/mergetree-family/aggregatingmergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/aggregatingmergetree.md
@@ -109,7 +109,7 @@ INSERT INTO test.visits (StartDate, CounterID, Sign, UserID)
  VALUES (1667446031, 1, 6, 3)
 ```
 
-The data are inserted in both the table and the materialized view `test.mv_visits`.
+The data is inserted in both the table and the materialized view `test.mv_visits`.
 
 To get the aggregated data, we need to execute a query such as `SELECT ... GROUP BY ...` from the materialized view `test.mv_visits`:
 

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 0469/1478] 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 aa6f4e43c5ea0fa4d6c84f121eba766d89a6efdf Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Mon, 5 Jun 2023 23:15:13 +0200
Subject: [PATCH 0470/1478] Fixed COLUMN_NOT_FOUND in block issue

---
 src/Storages/StorageAzure.cpp             | 35 ++++++++++++++---------
 src/Storages/StorageAzure.h               |  3 +-
 src/Storages/StorageS3.cpp                |  3 ++
 src/TableFunctions/TableFunctionAzure.cpp |  5 ++--
 src/TableFunctions/TableFunctionS3.cpp    |  5 ++++
 5 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 683da3a9825..76e9130bda3 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -476,7 +476,7 @@ private:
 
 
 Pipe StorageAzure::read(
-    const Names & /*column_names*/ ,
+    const Names & column_names ,
     const StorageSnapshotPtr &  storage_snapshot,
     SelectQueryInfo & /*query_info*/,
     ContextPtr context,
@@ -491,13 +491,11 @@ Pipe StorageAzure::read(
         objects.emplace_back(key);
 
     auto reader = object_storage->readObjects(objects);
-    auto block_for_format = storage_snapshot->metadata->getSampleBlock();
-
-    for (auto col : block_for_format.getColumns())
-        LOG_INFO(&Poco::Logger::get("StorageAzure"), "read col  = {}",col->getName());
+    auto columns_description = storage_snapshot->getDescriptionForColumns(column_names);
+    auto block_for_format = storage_snapshot->getSampleBlockForColumns(columns_description.getNamesOfPhysical());
 
 
-    pipes.emplace_back(std::make_shared<StorageAzureSource>(std::move(reader), context, block_for_format, max_block_size));
+    pipes.emplace_back(std::make_shared<StorageAzureSource>(std::move(reader), context, block_for_format, max_block_size, columns_description));
 
 
     return Pipe::unitePipes(std::move(pipes));
@@ -583,12 +581,13 @@ bool StorageAzure::supportsPartitionBy() const
 
 
 StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase> && read_buffer_, ContextPtr context_,
-                                       const Block & sample_block_,UInt64 max_block_size_)
-    :ISource(Block())
+                                       const Block & sample_block_,UInt64 max_block_size_, const ColumnsDescription & columns_)
+    :ISource(sample_block_)
     , WithContext(context_)
     , read_buffer(std::move(read_buffer_))
     , sample_block(sample_block_)
     , max_block_size(max_block_size_)
+    , columns_desc(columns_)
 {
     auto format = "TSV";
 
@@ -598,6 +597,13 @@ StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase>
     QueryPipelineBuilder builder;
     builder.init(Pipe(input_format));
 
+    if (columns_desc.hasDefaults())
+    {
+        builder.addSimpleTransform(
+            [&](const Block & header)
+            { return std::make_shared<AddingDefaultsTransform>(header, columns_desc, *input_format, getContext()); });
+    }
+
     pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
     reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
 }
@@ -605,13 +611,16 @@ StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase>
 
 Chunk StorageAzureSource::generate()
 {
-    Chunk chunk;
-    if (reader->pull(chunk))
+    while(true)
     {
-        LOG_INFO(&Poco::Logger::get("StorageAzureSource"), "pulled chunk rows = {}", chunk.getNumRows());
-
+        Chunk chunk;
+        if (reader->pull(chunk))
+        {
+            LOG_INFO(&Poco::Logger::get("StorageAzureSource"), "pulled chunk rows = {}", chunk.getNumRows());
+        }
+        return chunk;
     }
-    return chunk;
+//    return {};
 }
 
 String StorageAzureSource::getName() const
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index b93501ce2f2..61237fcc2f9 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -128,7 +128,7 @@ private:
 class StorageAzureSource : public ISource, WithContext
 {
 public:
-    StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase> && read_buffer_, ContextPtr context_, const Block & sample_block_, UInt64 max_block_size_);
+    StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase> && read_buffer_, ContextPtr context_, const Block & sample_block_, UInt64 max_block_size_, const ColumnsDescription & columns_);
     ~StorageAzureSource() override {}
 
     Chunk generate() override;
@@ -145,6 +145,7 @@ private:
     std::unique_ptr<PullingPipelineExecutor> reader;
     Block sample_block;
     UInt64 max_block_size;
+    ColumnsDescription columns_desc;
 
 //    void createReader();
 };
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 2d8aaec0f07..7d6254b2551 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -957,6 +957,9 @@ StorageS3::StorageS3(
         {"_file", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())}};
 
     auto columns = storage_metadata.getSampleBlock().getNamesAndTypesList();
+
+    LOG_INFO(&Poco::Logger::get("StorageS3"), "constructor columns  = {}", columns.toString());
+
     virtual_columns = getVirtualsForStorage(columns, default_virtuals);
     for (const auto & column : virtual_columns)
         virtual_block.insert({column.type->createColumn(), column.type, column.name});
diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzure.cpp
index eb67ed9a983..f565a365a13 100644
--- a/src/TableFunctions/TableFunctionAzure.cpp
+++ b/src/TableFunctions/TableFunctionAzure.cpp
@@ -54,7 +54,8 @@ void TableFunctionAzure::parseArgumentsImpl(ASTs & args, const ContextPtr & cont
 
 void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr context)
 {
-    LOG_INFO(&Poco::Logger::get("TableFunctionAzure"), "parseArguments = {}", ast_function->dumpTree());
+    /// Clone ast function, because we can modify its arguments like removing headers.
+    auto ast_copy = ast_function->clone();
 
     ASTs & args_func = ast_function->children;
 
@@ -78,8 +79,6 @@ bool TableFunctionAzure::supportsReadingSubsetOfColumns()
 
 StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
 {
-    LOG_INFO(&Poco::Logger::get("TableFunctionAzure"), "executeImpl  = {}", table_name);
-
     ColumnsDescription columns;
     columns = parseColumnsListFromString(configuration.structure, context);
 
diff --git a/src/TableFunctions/TableFunctionS3.cpp b/src/TableFunctions/TableFunctionS3.cpp
index c8cc0cddd30..7f283afd6b4 100644
--- a/src/TableFunctions/TableFunctionS3.cpp
+++ b/src/TableFunctions/TableFunctionS3.cpp
@@ -294,6 +294,8 @@ void TableFunctionS3::addColumnsStructureToArguments(ASTs & args, const String &
 
 ColumnsDescription TableFunctionS3::getActualTableStructure(ContextPtr context) const
 {
+    LOG_INFO(&Poco::Logger::get("TableFunctionS3"), "getActualTableStructure    configuration.structure = {}  ",configuration.structure);
+
     if (configuration.structure == "auto")
     {
         context->checkAccess(getSourceAccessType());
@@ -319,6 +321,9 @@ StoragePtr TableFunctionS3::executeImpl(const ASTPtr & /*ast_function*/, Context
     else if (!structure_hint.empty())
         columns = structure_hint;
 
+    LOG_INFO(&Poco::Logger::get("TableFunctionS3"), "executeImpl structre  = {}  structure_hint = {} ",configuration.structure, structure_hint.getAll().toString());
+
+
     StoragePtr storage = std::make_shared<StorageS3>(
         configuration,
         context,

From bd6b0ff1c005aaa8f976103762e6848e3b3448d8 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Mon, 5 Jun 2023 23:32:26 +0200
Subject: [PATCH 0471/1478] Updated to read only 1st object

---
 src/Storages/StorageAzure.cpp | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 76e9130bda3..c8d13cbf242 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -490,13 +490,16 @@ Pipe StorageAzure::read(
     for (const auto & key : configuration.blobs_paths)
         objects.emplace_back(key);
 
-    auto reader = object_storage->readObjects(objects);
-    auto columns_description = storage_snapshot->getDescriptionForColumns(column_names);
-    auto block_for_format = storage_snapshot->getSampleBlockForColumns(columns_description.getNamesOfPhysical());
+    if (objects.size() > 1)
+    {
+        auto reader = object_storage->readObject(objects[0]);
+        auto columns_description = storage_snapshot->getDescriptionForColumns(column_names);
+        auto block_for_format = storage_snapshot->getSampleBlockForColumns(columns_description.getNamesOfPhysical());
 
 
-    pipes.emplace_back(std::make_shared<StorageAzureSource>(std::move(reader), context, block_for_format, max_block_size, columns_description));
-
+        pipes.emplace_back(
+            std::make_shared<StorageAzureSource>(std::move(reader), context, block_for_format, max_block_size, columns_description));
+    }
 
     return Pipe::unitePipes(std::move(pipes));
 }
@@ -592,7 +595,9 @@ StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase>
     auto format = "TSV";
 
     auto input_format = FormatFactory::instance().getInput(
-        format, *read_buffer, sample_block, getContext(), max_block_size);
+        format, *read_buffer, sample_block, getContext(), max_block_size,
+        FormatSettings(), std::nullopt, std::nullopt,
+        true);
 
     QueryPipelineBuilder builder;
     builder.init(Pipe(input_format));
@@ -611,6 +616,7 @@ StorageAzureSource::StorageAzureSource (std::unique_ptr<ReadBufferFromFileBase>
 
 Chunk StorageAzureSource::generate()
 {
+    LOG_INFO(&Poco::Logger::get("StorageAzureSource"), "generate");
     while(true)
     {
         Chunk chunk;

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 0472/1478] 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 cf9936ad327b4f94903e5993a1189c149c9c61dd Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 5 Jun 2023 23:58:43 +0000
Subject: [PATCH 0473/1478] Automatic style fix

---
 .../test_storage_azure_blob_storage/test.py   | 91 ++++++++++++++-----
 1 file changed, 68 insertions(+), 23 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index e78fa185b17..6a3c915cdc5 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -17,6 +17,7 @@ from helpers.network import PartitionManager
 from helpers.mock_servers import start_mock_servers
 from helpers.test_tools import exec_query_with_retry
 
+
 @pytest.fixture(scope="module")
 def cluster():
     try:
@@ -32,6 +33,7 @@ def cluster():
     finally:
         cluster.shutdown()
 
+
 def azure_query(node, query, try_num=3, settings={}):
     for i in range(try_num):
         try:
@@ -50,6 +52,7 @@ def azure_query(node, query, try_num=3, settings={}):
                 raise Exception(ex)
             continue
 
+
 def get_azure_file_content(filename):
     container_name = "cont"
     connection_string = "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;"
@@ -57,43 +60,72 @@ def get_azure_file_content(filename):
     container_client = blob_service_client.get_container_client(container_name)
     blob_client = container_client.get_blob_client(filename)
     download_stream = blob_client.download_blob()
-    return download_stream.readall().decode('utf-8')
+    return download_stream.readall().decode("utf-8")
+
 
 def test_create_table_connection_string(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_create_table_conn_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 'cont', 'test_create_connection_string', 'CSV')")
+    azure_query(
+        node,
+        "CREATE TABLE test_create_table_conn_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 'cont', 'test_create_connection_string', 'CSV')",
+    )
+
 
 def test_create_table_account_string(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_create_table_account_url (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1',  'cont', 'test_create_connection_string', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')")
+    azure_query(
+        node,
+        "CREATE TABLE test_create_table_account_url (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1',  'cont', 'test_create_connection_string', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
+    )
+
 
 def test_simple_write_account_string(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_simple_write (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')")
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
+    )
     azure_query(node, "INSERT INTO test_simple_write VALUES (1, 'a')")
-    print(get_azure_file_content('test_simple_write.csv'))
-    assert get_azure_file_content('test_simple_write.csv') == '1,"a"\n'
+    print(get_azure_file_content("test_simple_write.csv"))
+    assert get_azure_file_content("test_simple_write.csv") == '1,"a"\n'
+
 
 def test_simple_write_connection_string(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')")
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')",
+    )
     azure_query(node, "INSERT INTO test_simple_write_connection_string VALUES (1, 'a')")
-    print(get_azure_file_content('test_simple_write_c.csv'))
-    assert get_azure_file_content('test_simple_write_c.csv') == '1,"a"\n'
+    print(get_azure_file_content("test_simple_write_c.csv"))
+    assert get_azure_file_content("test_simple_write_c.csv") == '1,"a"\n'
+
 
 def test_simple_write_named_collection_1(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)")
-    azure_query(node, "INSERT INTO test_simple_write_named_collection_1 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'
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)",
+    )
+    azure_query(
+        node, "INSERT INTO test_simple_write_named_collection_1 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'
+
 
 def test_simple_write_named_collection_2(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')")
-    azure_query(node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')")
-    print(get_azure_file_content('test_simple_write_named_2.csv'))
-    assert get_azure_file_content('test_simple_write_named_2.csv') == '1,"a"\n'
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')",
+    )
+    azure_query(
+        node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')"
+    )
+    print(get_azure_file_content("test_simple_write_named_2.csv"))
+    assert get_azure_file_content("test_simple_write_named_2.csv") == '1,"a"\n'
+
 
 def test_partition_by(cluster):
     node = cluster.instances["node"]
@@ -102,7 +134,10 @@ def test_partition_by(cluster):
     values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
     filename = "test_{_partition_id}.csv"
 
-    azure_query(node, f"CREATE TABLE test_partitioned_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(
+        node,
+        f"CREATE TABLE test_partitioned_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+    )
     azure_query(node, f"INSERT INTO test_partitioned_write VALUES {values}")
 
     assert "1,2,3\n" == get_azure_file_content("test_3.csv")
@@ -116,7 +151,10 @@ def test_partition_by_string_column(cluster):
     partition_by = "col_str"
     values = "(1, 'foo/bar'), (3, 'йцук'), (78, '你好')"
     filename = "test_{_partition_id}.csv"
-    azure_query(node, f"CREATE TABLE test_partitioned_string_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(
+        node,
+        f"CREATE TABLE test_partitioned_string_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+    )
     azure_query(node, f"INSERT INTO test_partitioned_string_write VALUES {values}")
 
     assert '1,"foo/bar"\n' == get_azure_file_content("test_foo/bar.csv")
@@ -131,15 +169,22 @@ def test_partition_by_const_column(cluster):
     partition_by = "'88'"
     values_csv = "1,2,3\n3,2,1\n78,43,45\n"
     filename = "test_{_partition_id}.csv"
-    azure_query(node, f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}")
+    azure_query(
+        node,
+        f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+    )
     azure_query(node, f"INSERT INTO test_partitioned_const_write VALUES {values}")
     assert values_csv == get_azure_file_content("test_88.csv")
 
+
 def test_truncate(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "CREATE TABLE test_truncate (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_truncate.csv', format='CSV')")
+    azure_query(
+        node,
+        "CREATE TABLE test_truncate (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_truncate.csv', format='CSV')",
+    )
     azure_query(node, "INSERT INTO test_truncate VALUES (1, 'a')")
-    assert get_azure_file_content('test_truncate.csv') == '1,"a"\n'
+    assert get_azure_file_content("test_truncate.csv") == '1,"a"\n'
     azure_query(node, "TRUNCATE TABLE test_truncate")
     with pytest.raises(Exception):
-        print(get_azure_file_content('test_truncate.csv'))
+        print(get_azure_file_content("test_truncate.csv"))

From 9f80900d6f587383780d2a40f8173093dce68a5a Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Thu, 1 Jun 2023 22:02:17 +0000
Subject: [PATCH 0474/1478] Changes related to an internal feature

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp           | 2 +-
 src/Disks/IO/ReadBufferFromRemoteFSGather.cpp             | 2 +-
 src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp   | 7 +++++--
 src/Disks/ObjectStorages/Cached/CachedObjectStorage.h     | 4 +++-
 src/IO/ReadSettings.h                                     | 2 ++
 src/Interpreters/Cache/FileSegment.h                      | 2 +-
 src/Interpreters/Cache/IFileCachePriority.h               | 1 +
 src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp      | 7 +++++++
 src/Storages/MergeTree/DataPartStorageOnDiskBase.h        | 1 +
 src/Storages/MergeTree/IDataPartStorage.h                 | 1 +
 .../configs/config.d/storage_conf.xml                     | 1 +
 .../configs/config.d/users.xml                            | 7 +++++++
 .../test_replicated_merge_tree_s3_zero_copy/test.py       | 8 ++++++--
 13 files changed, 37 insertions(+), 8 deletions(-)
 create mode 100644 tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/users.xml

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 7c497baa450..877d8ff9bb7 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -1219,7 +1219,7 @@ off_t CachedOnDiskReadBufferFromFile::getPosition()
 
 void CachedOnDiskReadBufferFromFile::assertCorrectness() const
 {
-    if (!CachedObjectStorage::canUseReadThroughCache()
+    if (!CachedObjectStorage::canUseReadThroughCache(settings)
         && !settings.read_from_filesystem_cache_if_exists_otherwise_bypass_cache)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Cache usage is not allowed (query_id: {})", query_id);
 }
diff --git a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
index 12fbbbcf747..04030fe5f8f 100644
--- a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
+++ b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
@@ -36,7 +36,7 @@ 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);
+        && (!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)
diff --git a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
index 1d24d9d5411..3e73e45638b 100644
--- a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
@@ -57,7 +57,7 @@ ReadSettings CachedObjectStorage::patchSettings(const ReadSettings & read_settin
     ReadSettings modified_settings{read_settings};
     modified_settings.remote_fs_cache = cache;
 
-    if (!canUseReadThroughCache())
+    if (!canUseReadThroughCache(read_settings))
         modified_settings.read_from_filesystem_cache_if_exists_otherwise_bypass_cache = true;
 
     return object_storage->patchSettings(modified_settings);
@@ -227,8 +227,11 @@ String CachedObjectStorage::getObjectsNamespace() const
     return object_storage->getObjectsNamespace();
 }
 
-bool CachedObjectStorage::canUseReadThroughCache()
+bool CachedObjectStorage::canUseReadThroughCache(const ReadSettings & settings)
 {
+    if (!settings.avoid_readthrough_cache_outside_query_context)
+        return true;
+
     return CurrentThread::isInitialized()
         && CurrentThread::get().getQueryContext()
         && !CurrentThread::getQueryId().empty();
diff --git a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
index b5186d39c32..ba9fbd02d94 100644
--- a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
+++ b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
@@ -112,7 +112,9 @@ public:
 
     WriteSettings getAdjustedSettingsFromMetadataFile(const WriteSettings & settings, const std::string & path) const override;
 
-    static bool canUseReadThroughCache();
+    const FileCacheSettings & getCacheSettings() const { return cache_settings; }
+
+    static bool canUseReadThroughCache(const ReadSettings & settings);
 
 private:
     FileCache::Key getCacheKey(const std::string & path) const;
diff --git a/src/IO/ReadSettings.h b/src/IO/ReadSettings.h
index e43ecd7f275..dae4261e92c 100644
--- a/src/IO/ReadSettings.h
+++ b/src/IO/ReadSettings.h
@@ -99,6 +99,8 @@ struct ReadSettings
     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;
 
     size_t filesystem_cache_max_download_size = (128UL * 1024 * 1024 * 1024);
     bool skip_download_if_exceeds_query_cache = true;
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 163a15fcfda..75395a671f4 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -85,7 +85,7 @@ public:
         EMPTY,
         /**
          * A newly created file segment never has DOWNLOADING state until call to getOrSetDownloader
-         * because each cache user might acquire multiple file segments and reads them one by one,
+         * because each cache user might acquire multiple file segments and read them one by one,
          * so only user which actually needs to read this segment earlier than others - becomes a downloader.
          */
         DOWNLOADING,
diff --git a/src/Interpreters/Cache/IFileCachePriority.h b/src/Interpreters/Cache/IFileCachePriority.h
index ad63dcc7ea5..93343398783 100644
--- a/src/Interpreters/Cache/IFileCachePriority.h
+++ b/src/Interpreters/Cache/IFileCachePriority.h
@@ -85,6 +85,7 @@ public:
 
     virtual void removeAll(const CacheGuard::Lock &) = 0;
 
+    /// From lowest to highest priority.
     virtual void iterate(IterateFunc && func, const CacheGuard::Lock &) = 0;
 
 private:
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
index cfc3ff58f81..30776a8bc50 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
@@ -202,6 +202,13 @@ bool DataPartStorageOnDiskBase::isStoredOnRemoteDisk() const
     return volume->getDisk()->isRemote();
 }
 
+std::optional<String> DataPartStorageOnDiskBase::getCacheName() const
+{
+    if (volume->getDisk()->supportsCache())
+        return volume->getDisk()->getCacheName();
+    return std::nullopt;
+}
+
 bool DataPartStorageOnDiskBase::supportZeroCopyReplication() const
 {
     return volume->getDisk()->supportZeroCopyReplication();
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskBase.h b/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
index 6b27b7296fc..043953eb20c 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
@@ -36,6 +36,7 @@ public:
     std::string getDiskName() const override;
     std::string getDiskType() const override;
     bool isStoredOnRemoteDisk() const override;
+    std::optional<String> getCacheName() const override;
     bool supportZeroCopyReplication() const override;
     bool supportParallelWrite() const override;
     bool isBroken() const override;
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index f160254350d..933c9bd9958 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -149,6 +149,7 @@ public:
     virtual std::string getDiskName() const = 0;
     virtual std::string getDiskType() const = 0;
     virtual bool isStoredOnRemoteDisk() const { return false; }
+    virtual std::optional<String> getCacheName() const { return std::nullopt; }
     virtual bool supportZeroCopyReplication() const { return false; }
     virtual bool supportParallelWrite() const = 0;
     virtual bool isBroken() const = 0;
diff --git a/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/storage_conf.xml b/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/storage_conf.xml
index 15239041478..96d59d5633e 100644
--- a/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/storage_conf.xml
+++ b/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/storage_conf.xml
@@ -12,6 +12,7 @@
                 <disk>s3</disk>
                 <max_size>100000000</max_size>
                 <path>./cache_s3/</path>
+                <cache_on_write_operations>1</cache_on_write_operations>
             </cache_s3>
         </disks>
         <policies>
diff --git a/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/users.xml b/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/users.xml
new file mode 100644
index 00000000000..5de169edc1e
--- /dev/null
+++ b/tests/integration/test_replicated_merge_tree_s3_zero_copy/configs/config.d/users.xml
@@ -0,0 +1,7 @@
+<clickhouse>
+    <profiles>
+        <default>
+            <enable_filesystem_cache_on_write_operations>1</enable_filesystem_cache_on_write_operations>
+        </default>
+    </profiles>
+</clickhouse>
diff --git a/tests/integration/test_replicated_merge_tree_s3_zero_copy/test.py b/tests/integration/test_replicated_merge_tree_s3_zero_copy/test.py
index eca18820016..72a01d278d8 100644
--- a/tests/integration/test_replicated_merge_tree_s3_zero_copy/test.py
+++ b/tests/integration/test_replicated_merge_tree_s3_zero_copy/test.py
@@ -19,6 +19,7 @@ def cluster():
         cluster.add_instance(
             "node1",
             main_configs=["configs/config.d/storage_conf.xml"],
+            user_configs=["configs/config.d/users.xml"],
             macros={"replica": "1"},
             with_minio=True,
             with_zookeeper=True,
@@ -26,12 +27,14 @@ def cluster():
         cluster.add_instance(
             "node2",
             main_configs=["configs/config.d/storage_conf.xml"],
+            user_configs=["configs/config.d/users.xml"],
             macros={"replica": "2"},
             with_zookeeper=True,
         )
         cluster.add_instance(
             "node3",
             main_configs=["configs/config.d/storage_conf.xml"],
+            user_configs=["configs/config.d/users.xml"],
             macros={"replica": "3"},
             with_zookeeper=True,
         )
@@ -74,7 +77,7 @@ def generate_values(date_str, count, sign=1):
 
 def create_table(cluster, additional_settings=None):
     create_table_statement = """
-        CREATE TABLE s3_test ON CLUSTER cluster(
+        CREATE TABLE s3_test ON CLUSTER cluster (
             dt Date,
             id Int64,
             data String,
@@ -95,7 +98,8 @@ def create_table(cluster, additional_settings=None):
 def drop_table(cluster):
     yield
     for node in list(cluster.instances.values()):
-        node.query("DROP TABLE IF EXISTS s3_test")
+        node.query("DROP TABLE IF EXISTS s3_test SYNC")
+        node.query("DROP TABLE IF EXISTS test_drop_table SYNC")
 
     minio = cluster.minio_client
     # Remove extra objects to prevent tests cascade failing

From 760483d8d3a012b4b6456b9bdf14afd2d052a514 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Tue, 6 Jun 2023 04:18:51 +0000
Subject: [PATCH 0475/1478] multiple fixes

---
 base/base/IPv4andIPv6.h                       |  4 ++-
 .../AggregateFunctionMap.cpp                  |  1 +
 src/AggregateFunctions/AggregateFunctionMap.h | 26 +++++++++++++++++++
 .../AggregateFunctionUniq.cpp                 |  2 +-
 .../AggregateFunctionUniq.h                   | 12 +++++++++
 src/IO/ReadHelpers.h                          | 14 ++++++++++
 src/IO/WriteHelpers.h                         |  8 ++++++
 7 files changed, 65 insertions(+), 2 deletions(-)

diff --git a/base/base/IPv4andIPv6.h b/base/base/IPv4andIPv6.h
index 4aee2329572..e2f93b54124 100644
--- a/base/base/IPv4andIPv6.h
+++ b/base/base/IPv4andIPv6.h
@@ -2,6 +2,7 @@
 
 #include <base/strong_typedef.h>
 #include <base/extended_types.h>
+#include <Common/formatIPv6.h>
 #include <Common/memcmpSmall.h>
 
 namespace DB
@@ -55,12 +56,13 @@ namespace DB
 
 namespace std
 {
+    /// For historical reasons we hash IPv6 as a FixedString(16)
     template <>
     struct hash<DB::IPv6>
     {
         size_t operator()(const DB::IPv6 & x) const
         {
-            return std::hash<DB::IPv6::UnderlyingType>()(x.toUnderType());
+            return std::hash<std::string_view>{}(std::string_view(reinterpret_cast<const char*>(&x.toUnderType()), IPV6_BINARY_LENGTH));
         }
     };
 
diff --git a/src/AggregateFunctions/AggregateFunctionMap.cpp b/src/AggregateFunctions/AggregateFunctionMap.cpp
index 38e4f49d9a2..b957b541fe1 100644
--- a/src/AggregateFunctions/AggregateFunctionMap.cpp
+++ b/src/AggregateFunctions/AggregateFunctionMap.cpp
@@ -103,6 +103,7 @@ public:
                 case TypeIndex::IPv4:
                     return std::make_shared<AggregateFunctionMap<IPv4>>(nested_function, arguments);
                 case TypeIndex::IPv6:
+                    return std::make_shared<AggregateFunctionMap<IPv6>>(nested_function, arguments);
                 case TypeIndex::FixedString:
                 case TypeIndex::String:
                     return std::make_shared<AggregateFunctionMap<String>>(nested_function, arguments);
diff --git a/src/AggregateFunctions/AggregateFunctionMap.h b/src/AggregateFunctions/AggregateFunctionMap.h
index 4a4ae92735b..7b9bb088d8f 100644
--- a/src/AggregateFunctions/AggregateFunctionMap.h
+++ b/src/AggregateFunctions/AggregateFunctionMap.h
@@ -21,6 +21,7 @@
 #include "DataTypes/Serializations/ISerialization.h"
 #include <base/IPv4andIPv6.h>
 #include "base/types.h"
+#include <Common/formatIPv6.h>
 #include <Common/Arena.h>
 #include "AggregateFunctions/AggregateFunctionFactory.h"
 
@@ -70,6 +71,31 @@ struct AggregateFunctionMapCombinatorData<String>
     }
 };
 
+/// Specialization for IPv6 - for historical reasons it should be stored as FixedString(16)
+template <>
+struct AggregateFunctionMapCombinatorData<IPv6>
+{
+    struct IPv6Hash
+    {
+        using hash_type = std::hash<IPv6>;
+        using is_transparent = void;
+
+        size_t operator()(const IPv6 & ip) const { return hash_type{}(ip); }
+    };
+
+    using SearchType = IPv6;
+    std::unordered_map<IPv6, AggregateDataPtr, IPv6Hash, std::equal_to<>> merged_maps;
+
+    static void writeKey(const IPv6 & key, WriteBuffer & buf)
+    {
+        writeIPv6Binary(key, buf);
+    }
+    static void readKey(IPv6 & key, ReadBuffer & buf)
+    {
+        readIPv6Binary(key, buf);
+    }
+};
+
 template <typename KeyType>
 class AggregateFunctionMap final
     : public IAggregateFunctionDataHelper<AggregateFunctionMapCombinatorData<KeyType>, AggregateFunctionMap<KeyType>>
diff --git a/src/AggregateFunctions/AggregateFunctionUniq.cpp b/src/AggregateFunctions/AggregateFunctionUniq.cpp
index f5147daa97b..748a232641e 100644
--- a/src/AggregateFunctions/AggregateFunctionUniq.cpp
+++ b/src/AggregateFunctions/AggregateFunctionUniq.cpp
@@ -117,7 +117,7 @@ createAggregateFunctionUniq(const std::string & name, const DataTypes & argument
         else if (which.isIPv4())
             return std::make_shared<AggregateFunctionUniq<DataTypeIPv4::FieldType, Data<DataTypeIPv4::FieldType, is_able_to_parallelize_merge>>>(argument_types);
         else if (which.isIPv6())
-            return std::make_shared<AggregateFunctionUniq<DataTypeIPv6::FieldType, Data<String, is_able_to_parallelize_merge>>>(argument_types);
+            return std::make_shared<AggregateFunctionUniq<DataTypeIPv6::FieldType, Data<DataTypeIPv6::FieldType, is_able_to_parallelize_merge>>>(argument_types);
         else if (which.isTuple())
         {
             if (use_exact_hash_function)
diff --git a/src/AggregateFunctions/AggregateFunctionUniq.h b/src/AggregateFunctions/AggregateFunctionUniq.h
index 0524dd53ec0..03d999b47e2 100644
--- a/src/AggregateFunctions/AggregateFunctionUniq.h
+++ b/src/AggregateFunctions/AggregateFunctionUniq.h
@@ -101,6 +101,18 @@ struct AggregateFunctionUniqHLL12Data<UUID, false>
     static String getName() { return "uniqHLL12"; }
 };
 
+template <>
+struct AggregateFunctionUniqHLL12Data<IPv6, false>
+{
+    using Set = HyperLogLogWithSmallSetOptimization<UInt64, 16, 12>;
+    Set set;
+
+    constexpr static bool is_able_to_parallelize_merge = false;
+    constexpr static bool is_variadic = false;
+
+    static String getName() { return "uniqHLL12"; }
+};
+
 template <bool is_exact_, bool argument_is_tuple_, bool is_able_to_parallelize_merge_>
 struct AggregateFunctionUniqHLL12DataForVariadic
 {
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 32338552b66..1aa294f76bf 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -61,6 +61,7 @@ namespace ErrorCodes
     extern const int INCORRECT_DATA;
     extern const int TOO_LARGE_STRING_SIZE;
     extern const int TOO_LARGE_ARRAY_SIZE;
+    extern const int SIZE_OF_FIXED_STRING_DOESNT_MATCH;
 }
 
 /// Helper functions for formatted input.
@@ -136,6 +137,19 @@ inline void readStringBinary(std::string & s, ReadBuffer & buf, size_t max_strin
     buf.readStrict(s.data(), size);
 }
 
+/// For historical reasons we store IPv6 as a String
+inline void readIPv6Binary(IPv6 & ip, ReadBuffer & buf)
+{
+    size_t size = 0;
+    readVarUInt(size, buf);
+
+    if (size != IPV6_BINARY_LENGTH)
+        throw Exception(ErrorCodes::SIZE_OF_FIXED_STRING_DOESNT_MATCH,
+                        "Size of the string {} doesn't match size of binary IPv6 {}", size, IPV6_BINARY_LENGTH);
+
+    buf.readStrict(reinterpret_cast<char*>(&ip.toUnderType()), size);
+}
+
 template <typename T>
 void readVectorBinary(std::vector<T> & v, ReadBuffer & buf)
 {
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index cdbc952690c..505a2f988f0 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -10,6 +10,7 @@
 
 #include <pcg-random/pcg_random.hpp>
 
+#include "Common/formatIPv6.h"
 #include <Common/DateLUT.h>
 #include <Common/LocalDate.h>
 #include <Common/LocalDateTime.h>
@@ -104,6 +105,13 @@ inline void writeStringBinary(const std::string & s, WriteBuffer & buf)
     buf.write(s.data(), s.size());
 }
 
+/// For historical reasons we store IPv6 as a String
+inline void writeIPv6Binary(const IPv6 & ip, WriteBuffer & buf)
+{
+    writeVarUInt(IPV6_BINARY_LENGTH, buf);
+    buf.write(reinterpret_cast<const char *>(&ip.toUnderType()), IPV6_BINARY_LENGTH);
+}
+
 inline void writeStringBinary(StringRef s, WriteBuffer & buf)
 {
     writeVarUInt(s.size, buf);

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 0476/1478] 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 614451998d60d4ffcb1e06096ab64882dc97d7ea Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 08:06:24 +0200
Subject: [PATCH 0477/1478] Fixed build by adding StorageAzureSource
 constructor and getHeader function implementation

---
 src/Storages/StorageAzure.cpp | 49 +++++++++++++++++++++++++++++++++++
 src/Storages/StorageAzure.h   | 16 ++++++------
 2 files changed, 57 insertions(+), 8 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 166c1156c49..3e29fa43383 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -43,6 +43,12 @@
 
 using namespace Azure::Storage::Blobs;
 
+namespace CurrentMetrics
+{
+    extern const Metric ObjectStorageAzureThreads;
+    extern const Metric ObjectStorageAzureThreadsActive;
+}
+
 namespace DB
 {
 
@@ -1038,6 +1044,49 @@ Chunk StorageAzureSource::generate()
     return {};
 }
 
+Block StorageAzureSource::getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns)
+{
+    for (const auto & virtual_column : requested_virtual_columns)
+        sample_block.insert({virtual_column.type->createColumn(), virtual_column.type, virtual_column.name});
+
+    return sample_block;
+}
+
+StorageAzureSource::StorageAzureSource(
+    const std::vector<NameAndTypePair> & requested_virtual_columns_,
+    const String & format_,
+    String name_,
+    const Block & sample_block_,
+    ContextPtr context_,
+    std::optional<FormatSettings> format_settings_,
+    const ColumnsDescription & columns_,
+    UInt64 max_block_size_,
+    String compression_hint_,
+    AzureObjectStorage * object_storage_,
+    const String & container_,
+    std::shared_ptr<Iterator> file_iterator_)
+    :ISource(getHeader(sample_block_, requested_virtual_columns_))
+    , WithContext(context_)
+    , requested_virtual_columns(requested_virtual_columns_)
+    , format(format_)
+    , name(std::move(name_))
+    , sample_block(sample_block_)
+    , format_settings(format_settings_)
+    , columns_desc(columns_)
+    , max_block_size(max_block_size_)
+    , compression_hint(compression_hint_)
+    , object_storage(std::move(object_storage_))
+    , container(container_)
+    , file_iterator(file_iterator_)
+    , create_reader_pool(CurrentMetrics::ObjectStorageAzureThreads, CurrentMetrics::ObjectStorageAzureThreadsActive, 1)
+    , create_reader_scheduler(threadPoolCallbackRunner<ReaderHolder>(create_reader_pool, "CreateAzureReader"))
+{
+    reader = createReader();
+    if (reader)
+        reader_future = createReaderAsync();
+}
+
+
 StorageAzureSource::~StorageAzureSource()
 {
     create_reader_pool.wait();
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index b7f5eba343f..168015cf5d9 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -198,17 +198,17 @@ public:
     static Block getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns);
 
 private:
-    String name;
-    String container;
-    String format;
     std::vector<NameAndTypePair> requested_virtual_columns;
-    ColumnsDescription columns_desc;
-    AzureObjectStorage * object_storage;
-    std::shared_ptr<Iterator> file_iterator;
-    UInt64 max_block_size;
-    String compression_hint;
+    String format;
+    String name;
     Block sample_block;
     std::optional<FormatSettings> format_settings;
+    ColumnsDescription columns_desc;
+    UInt64 max_block_size;
+    String compression_hint;
+    AzureObjectStorage * object_storage;
+    String container;
+    std::shared_ptr<Iterator> file_iterator;
 
     struct ReaderHolder
     {

From 0bc31a72888da7ccf50caee845abef4141077220 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Tue, 6 Jun 2023 07:17:30 +0000
Subject: [PATCH 0478/1478] Fix jepsen runs in PRs

---
 tests/ci/jepsen_check.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/tests/ci/jepsen_check.py b/tests/ci/jepsen_check.py
index 9d35d2d6e35..c21fafa2605 100644
--- a/tests/ci/jepsen_check.py
+++ b/tests/ci/jepsen_check.py
@@ -25,6 +25,7 @@ from stopwatch import Stopwatch
 from tee_popen import TeePopen
 from upload_result_helper import upload_results
 from version_helper import get_version_from_repo
+from build_check import get_release_or_pr
 
 JEPSEN_GROUP_NAME = "jepsen_group"
 
@@ -210,12 +211,7 @@ if __name__ == "__main__":
 
     build_name = get_build_name_for_check(check_name)
 
-    if pr_info.number == 0:
-        version = get_version_from_repo()
-        release_or_pr = f"{version.major}.{version.minor}"
-    else:
-        # PR number for anything else
-        release_or_pr = str(pr_info.number)
+    release_or_pr, _ = get_release_or_pr(pr_info, get_version_from_repo())
 
     # This check run separately from other checks because it requires exclusive
     # run (see .github/workflows/jepsen.yml) So we cannot add explicit

From ce8b39487e5416b018ce9d03feef4a8114e04f9b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 09:55:50 +0200
Subject: [PATCH 0479/1478] Update
 docs/en/engines/table-engines/mergetree-family/annindexes.md

Co-authored-by: Nikita Taranov <nickita.taranov@gmail.com>
---
 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 58655c11321..f600f9a015c 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 @@ ENGINE = MergeTree
 ORDER BY id;
 ```
 
-ANN indexes are built during column insertion and merge and `INSERT` and `OPTIMIZE` statements will slower than for ordinary tables. ANNIndexes are ideally used only with immutable or rarely changed data, respectively comparatively many more read requests than write requests.
+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`,

From 0b18b75bec6f29e687b6d9cce91fc2cc6c906221 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 08:06:03 +0000
Subject: [PATCH 0480/1478] Cosmetics: Use abbreviated syntax to read settings

---
 .../MergeTree/ApproximateNearestNeighborIndexesCommon.cpp     | 4 ++--
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp                | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
index c47e53788a7..bf277c55863 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
@@ -53,8 +53,8 @@ ApproximateNearestNeighborInformation::Metric stringToMetric(std::string_view me
 
 ApproximateNearestNeighborCondition::ApproximateNearestNeighborCondition(const SelectQueryInfo & query_info, ContextPtr context)
     : block_with_constants(KeyCondition::getBlockWithConstants(query_info.query, query_info.syntax_analyzer_result, context))
-    , index_granularity(context->getMergeTreeSettings().get("index_granularity").get<UInt64>())
-    , max_limit_for_ann_queries(context->getSettings().get("max_limit_for_ann_queries").get<UInt64>())
+    , index_granularity(context->getMergeTreeSettings().index_granularity)
+    , max_limit_for_ann_queries(context->getSettings().max_limit_for_ann_queries)
     , index_is_useful(checkQueryStructure(query_info))
 {}
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 72dd92ead5e..0a2df639b69 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -210,7 +210,7 @@ MergeTreeIndexConditionAnnoy::MergeTreeIndexConditionAnnoy(
     ContextPtr context)
     : ann_condition(query, context)
     , distance_function(distance_function_)
-    , search_k(context->getSettings().get("annoy_index_search_k_nodes").get<Int64>())
+    , search_k(context->getSettings().annoy_index_search_k_nodes)
 {}
 
 bool MergeTreeIndexConditionAnnoy::mayBeTrueOnGranule(MergeTreeIndexGranulePtr /*idx_granule*/) const

From 2c5c0c5c9f82963903a618e7686c39a59899f020 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 08:14:50 +0000
Subject: [PATCH 0481/1478] Cosmetics: Remove exception path for something
 checked elsewhere already

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 0a2df639b69..b15b1bb1a91 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -229,8 +229,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRanges(MergeTreeIndex
         return getUsefulRangesImpl<Annoy::Euclidean>(idx_granule);
     else if (distance_function == "cosineDistance")
         return getUsefulRangesImpl<Annoy::Angular>(idx_granule);
-    else
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown distance name. Must be 'L2Distance' or 'cosineDistance'. Got {}", distance_function);
+    std::unreachable();
 }
 
 template <typename Distance>

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 0482/1478] 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 1506545db0f062787ac779f997e30b0e07a55736 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 11:47:29 +0200
Subject: [PATCH 0483/1478] Fix merge conflicts

---
 src/Storages/StorageAzure.cpp | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 3e29fa43383..1e128bfed66 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -230,13 +230,10 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 
     configuration.blobs_paths = {configuration.blob_path};
 
-
     LOG_INFO(&Poco::Logger::get("StorageAzure"), "get_format_from_file  = {}", get_format_from_file);
 
-//    if (configuration.format == "auto" && get_format_from_file)
-//        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
-
-    configuration.format = "TSV";
+    if (configuration.format == "auto" && get_format_from_file)
+        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
 
     return configuration;
 }
@@ -367,11 +364,6 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
                 }
             }
         }
-        auto managed_identity_credential = std::make_shared<Azure::Identity::ManagedIdentityCredential>();
-
-        result = std::make_unique<BlobContainerClient>(configuration.connection_url, managed_identity_credential);
-
-        LOG_INFO(&Poco::Logger::get("StorageAzure"), "createClient account_name & account_key ");
     }
 
     return result;
@@ -613,7 +605,7 @@ Pipe StorageAzure::read(
     size_t num_streams)
 {
     if (partition_by && configuration.withWildcard())
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Reading from a partitioned S3 storage is not implemented yet");
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Reading from a partitioned Azure storage is not implemented yet");
 
     Pipes pipes;
 
@@ -1079,7 +1071,7 @@ StorageAzureSource::StorageAzureSource(
     , container(container_)
     , file_iterator(file_iterator_)
     , create_reader_pool(CurrentMetrics::ObjectStorageAzureThreads, CurrentMetrics::ObjectStorageAzureThreadsActive, 1)
-    , create_reader_scheduler(threadPoolCallbackRunner<ReaderHolder>(create_reader_pool, "CreateAzureReader"))
+    , create_reader_scheduler(threadPoolCallbackRunner<ReaderHolder>(create_reader_pool, "AzureReader"))
 {
     reader = createReader();
     if (reader)

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 0484/1478] 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 8028184e301f58aab5c4674226abbb39c5b8b745 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 12:27:40 +0200
Subject: [PATCH 0485/1478] Fix read

---
 src/Storages/StorageAzure.cpp                 | 41 ++-----------------
 src/Storages/StorageAzure.h                   |  1 -
 .../test_storage_azure_blob_storage/test.py   | 13 ++++++
 3 files changed, 16 insertions(+), 39 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 1e128bfed66..2f0029947f5 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -1096,6 +1096,7 @@ StorageAzureSource::ReaderHolder StorageAzureSource::createReader()
         return {};
 
     size_t object_size = info.size_bytes != 0 ? info.size_bytes : object_storage->getObjectMetadata(current_key).size_bytes;
+    LOG_DEBUG(log, "SIZE {}", object_size);
     auto compression_method = chooseCompressionMethod(current_key, compression_hint);
 
     auto read_buf = createAzureReadBuffer(current_key, object_size);
@@ -1104,6 +1105,7 @@ StorageAzureSource::ReaderHolder StorageAzureSource::createReader()
             format_settings, std::nullopt, std::nullopt,
             /* is_remote_fs */ true, compression_method);
 
+    LOG_DEBUG(log, "FORMAT {}", format);
     QueryPipelineBuilder builder;
     builder.init(Pipe(input_format));
 
@@ -1138,50 +1140,13 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
     if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
     {
         LOG_TRACE(log, "Downloading object of size {} from S3 with initial prefetch", object_size);
-        return createAsyncAzureReadBuffer(key, read_settings, object_size);
+        return object_storage->readObjects({StoredObject(key)}, read_settings, {}, object_size);
     }
 
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }
 
 
-std::unique_ptr<ReadBuffer> StorageAzureSource::createAsyncAzureReadBuffer(
-    const String & key, const ReadSettings & read_settings, size_t object_size)
-{
-    auto context = getContext();
-    auto read_buffer_creator =
-        [this, read_settings, object_size]
-        (const std::string & path, size_t read_until_position) -> std::unique_ptr<ReadBufferFromFileBase>
-    {
-        auto buffer = object_storage->readObject(StoredObject(path), read_settings, {}, object_size);
-        buffer->setReadUntilPosition(read_until_position);
-        return buffer;
-    };
-
-    auto s3_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator),
-        StoredObjects{StoredObject{key, object_size}},
-        read_settings,
-        /* cache_log */nullptr);
-
-    auto modified_settings{read_settings};
-    /// FIXME: Changing this setting to default value breaks something around parquet reading
-    modified_settings.remote_read_min_bytes_for_seek = modified_settings.remote_fs_buffer_size;
-
-    auto & pool_reader = context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-
-    auto async_reader = std::make_unique<AsynchronousBoundedReadBuffer>(
-        std::move(s3_impl), pool_reader, modified_settings,
-        context->getAsyncReadCounters(), context->getFilesystemReadPrefetchesLog());
-
-    async_reader->setReadUntilEnd();
-    if (read_settings.remote_fs_prefetch)
-        async_reader->prefetch(DEFAULT_PREFETCH_PRIORITY);
-
-    return async_reader;
-}
-
-
 }
 
 #endif
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index 168015cf5d9..f114184c336 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -274,7 +274,6 @@ private:
     std::future<ReaderHolder> createReaderAsync();
 
     std::unique_ptr<ReadBuffer> createAzureReadBuffer(const String & key, size_t object_size);
-    std::unique_ptr<ReadBuffer> createAsyncAzureReadBuffer(const String & key, const ReadSettings & read_settings, size_t object_size);
 };
 
 }
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 6a3c915cdc5..8fa87c4e286 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -188,3 +188,16 @@ def test_truncate(cluster):
     azure_query(node, "TRUNCATE TABLE test_truncate")
     with pytest.raises(Exception):
         print(get_azure_file_content("test_truncate.csv"))
+
+
+def test_simple_read_write(cluster):
+    node = cluster.instances["node"]
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_read_write (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_read_write.csv', format='CSV')",
+    )
+
+    azure_query(node, "INSERT INTO test_simple_read_write VALUES (1, 'a')")
+    assert get_azure_file_content("test_simple_read_write.csv") == '1,"a"\n'
+
+    print(azure_query(node, "SELECT * FROM test_simple_read_write"))

From 3d99abee436b95fd16d8d4011283d12fb9aebb5f Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 12:40:28 +0200
Subject: [PATCH 0486/1478] Remove async reads

---
 src/Storages/StorageAzure.cpp | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 2f0029947f5..804476a1842 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -1131,17 +1131,17 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
 {
     auto read_settings = getContext()->getReadSettings().adjustBufferSize(object_size);
     read_settings.enable_filesystem_cache = false;
-    auto download_buffer_size = getContext()->getSettings().max_download_buffer_size;
-    const bool object_too_small = object_size <= 2 * download_buffer_size;
+    //auto download_buffer_size = getContext()->getSettings().max_download_buffer_size;
+    //const bool object_too_small = object_size <= 2 * download_buffer_size;
 
     // Create a read buffer that will prefetch the first ~1 MB of the file.
     // When reading lots of tiny files, this prefetching almost doubles the throughput.
     // For bigger files, parallel reading is more useful.
-    if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
-    {
-        LOG_TRACE(log, "Downloading object of size {} from S3 with initial prefetch", object_size);
-        return object_storage->readObjects({StoredObject(key)}, read_settings, {}, object_size);
-    }
+    //if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
+    //{
+    //    LOG_TRACE(log, "Downloading object {} of size {} from S3 with initial prefetch", key, object_size);
+    //    return object_storage->readObjects({StoredObject(key)}, read_settings, {}, object_size);
+    //}
 
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }

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 0487/1478] 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 d497562a07b64434dc0c6b892e666776c51fa693 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 13:01:21 +0200
Subject: [PATCH 0488/1478] Copy and paste

---
 .../IO/ReadBufferFromAzureBlobStorage.cpp     | 60 +++++++++++++++++--
 src/Disks/IO/ReadBufferFromAzureBlobStorage.h |  9 +++
 src/Storages/StorageAzure.cpp                 |  2 +-
 .../test_storage_azure_blob_storage/test.py   | 24 +++++++-
 4 files changed, 89 insertions(+), 6 deletions(-)

diff --git a/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp b/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
index 0f197c2ff06..a086eb0a6df 100644
--- a/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
+++ b/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
@@ -35,6 +35,7 @@ ReadBufferFromAzureBlobStorage::ReadBufferFromAzureBlobStorage(
     size_t max_single_read_retries_,
     size_t max_single_download_retries_,
     bool use_external_buffer_,
+    bool restricted_seek_,
     size_t read_until_position_)
     : ReadBufferFromFileBase(use_external_buffer_ ? 0 : read_settings_.remote_fs_buffer_size, nullptr, 0)
     , blob_container_client(blob_container_client_)
@@ -44,6 +45,7 @@ ReadBufferFromAzureBlobStorage::ReadBufferFromAzureBlobStorage(
     , read_settings(read_settings_)
     , tmp_buffer_size(read_settings.remote_fs_buffer_size)
     , use_external_buffer(use_external_buffer_)
+    , restricted_seek(restricted_seek_)
     , read_until_position(read_until_position_)
 {
     if (!use_external_buffer)
@@ -118,8 +120,17 @@ bool ReadBufferFromAzureBlobStorage::nextImpl()
 
 off_t ReadBufferFromAzureBlobStorage::seek(off_t offset_, int whence)
 {
-    if (initialized)
-        throw Exception(ErrorCodes::CANNOT_SEEK_THROUGH_FILE, "Seek is allowed only before first read attempt from the buffer.");
+    if (offset_ == getPosition() && whence == SEEK_SET)
+        return offset_;
+
+    if (initialized && restricted_seek)
+    {
+        throw Exception(
+            ErrorCodes::CANNOT_SEEK_THROUGH_FILE,
+            "Seek is allowed only before first read attempt from the buffer (current offset: "
+            "{}, new offset: {}, reading until position: {}, available: {})",
+            getPosition(), offset_, read_until_position, available());
+    }
 
     if (whence != SEEK_SET)
         throw Exception(ErrorCodes::CANNOT_SEEK_THROUGH_FILE, "Only SEEK_SET mode is allowed.");
@@ -127,8 +138,36 @@ off_t ReadBufferFromAzureBlobStorage::seek(off_t offset_, int whence)
     if (offset_ < 0)
         throw Exception(ErrorCodes::SEEK_POSITION_OUT_OF_BOUND, "Seek position is out of bounds. Offset: {}", offset_);
 
-    offset = offset_;
+    if (!restricted_seek)
+    {
+        if (!working_buffer.empty()
+            && static_cast<size_t>(offset_) >= offset - working_buffer.size()
+            && offset_ < offset)
+        {
+            pos = working_buffer.end() - (offset - offset_);
+            assert(pos >= working_buffer.begin());
+            assert(pos < working_buffer.end());
 
+            return getPosition();
+        }
+
+        off_t position = getPosition();
+        if (initialized && offset_ > position)
+        {
+            size_t diff = offset_ - position;
+            if (diff < read_settings.remote_read_min_bytes_for_seek)
+            {
+                ignore(diff);
+                return offset_;
+            }
+        }
+
+        resetWorkingBuffer();
+        if (initialized)
+            initialized = false;
+    }
+
+    offset = offset_;
     return offset;
 }
 
@@ -152,7 +191,8 @@ void ReadBufferFromAzureBlobStorage::initialize()
 
     download_options.Range = {static_cast<int64_t>(offset), length};
 
-    blob_client = std::make_unique<Azure::Storage::Blobs::BlobClient>(blob_container_client->GetBlobClient(path));
+    if (!blob_client)
+        blob_client = std::make_unique<Azure::Storage::Blobs::BlobClient>(blob_container_client->GetBlobClient(path));
 
     size_t sleep_time_with_backoff_milliseconds = 100;
     for (size_t i = 0; i < max_single_download_retries; ++i)
@@ -182,6 +222,18 @@ void ReadBufferFromAzureBlobStorage::initialize()
     initialized = true;
 }
 
+size_t ReadBufferFromAzureBlobStorage::getFileSize()
+{
+    if (!blob_client)
+        blob_client = std::make_unique<Azure::Storage::Blobs::BlobClient>(blob_container_client->GetBlobClient(path));
+
+    if (file_size.has_value())
+        return *file_size;
+
+    file_size = blob_client->GetProperties().Value.BlobSize;
+    return *file_size;
+}
+
 }
 
 #endif
diff --git a/src/Disks/IO/ReadBufferFromAzureBlobStorage.h b/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
index 6164a005773..599ecba1dd1 100644
--- a/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
+++ b/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
@@ -24,6 +24,7 @@ public:
         size_t max_single_read_retries_,
         size_t max_single_download_retries_,
         bool use_external_buffer_ = false,
+        bool restricted_seek_ = false,
         size_t read_until_position_ = 0);
 
     off_t seek(off_t off, int whence) override;
@@ -40,6 +41,8 @@ public:
 
     bool supportsRightBoundedReads() const override { return true; }
 
+    size_t getFileSize() override;
+
 private:
 
     void initialize();
@@ -55,6 +58,12 @@ private:
     std::vector<char> tmp_buffer;
     size_t tmp_buffer_size;
     bool use_external_buffer;
+
+    /// There is different seek policy for disk seek and for non-disk seek
+    /// (non-disk seek is applied for seekable input formats: orc, arrow, parquet).
+    bool restricted_seek;
+
+
     off_t read_until_position = 0;
 
     off_t offset = 0;
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 804476a1842..d83dc90e6ed 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -453,7 +453,7 @@ void StorageAzure::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextP
     for (const auto & key : configuration.blobs_paths)
         objects.emplace_back(key);
 
-    object_storage->removeObjects(objects);
+    object_storage->removeObjectsIfExist(objects);
 }
 
 namespace
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 8fa87c4e286..bcf5d068057 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -199,5 +199,27 @@ def test_simple_read_write(cluster):
 
     azure_query(node, "INSERT INTO test_simple_read_write VALUES (1, 'a')")
     assert get_azure_file_content("test_simple_read_write.csv") == '1,"a"\n'
-
     print(azure_query(node, "SELECT * FROM test_simple_read_write"))
+    assert azure_query(node, "SELECT * FROM test_simple_read_write") == "1\ta\n"
+
+
+def test_create_new_files_on_insert(cluster):
+
+    node = cluster.instances["node"]
+
+    azure_query(node, f"create table test_multiple_inserts(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet', format='Parquet')")
+    azure_query(node, "truncate table test_multiple_inserts")
+    azure_query(node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(10) settings azure_truncate_on_insert=1"
+    )
+    azure_query(node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(20) settings azure_create_new_file_on_insert=1"
+    )
+    azure_query(node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(30) settings azure_create_new_file_on_insert=1"
+    )
+
+    result = azure_query(node, f"select count() from test_multiple_inserts")
+    assert int(result) == 60
+
+    azure_query(node, f"drop table test_multiple_inserts")

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 0489/1478] 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 18decb090ca6f85826dcddde2d61b53fa460ee4c Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 6 Jun 2023 11:11:50 +0000
Subject: [PATCH 0490/1478] Automatic style fix

---
 .../test_storage_azure_blob_storage/test.py   | 21 ++++++++++++-------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index bcf5d068057..7e66b6fb198 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -204,19 +204,24 @@ def test_simple_read_write(cluster):
 
 
 def test_create_new_files_on_insert(cluster):
-
     node = cluster.instances["node"]
 
-    azure_query(node, f"create table test_multiple_inserts(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet', format='Parquet')")
+    azure_query(
+        node,
+        f"create table test_multiple_inserts(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet', format='Parquet')",
+    )
     azure_query(node, "truncate table test_multiple_inserts")
-    azure_query(node,
-        f"insert into test_multiple_inserts select number, randomString(100) from numbers(10) settings azure_truncate_on_insert=1"
+    azure_query(
+        node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(10) settings azure_truncate_on_insert=1",
     )
-    azure_query(node,
-        f"insert into test_multiple_inserts select number, randomString(100) from numbers(20) settings azure_create_new_file_on_insert=1"
+    azure_query(
+        node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(20) settings azure_create_new_file_on_insert=1",
     )
-    azure_query(node,
-        f"insert into test_multiple_inserts select number, randomString(100) from numbers(30) settings azure_create_new_file_on_insert=1"
+    azure_query(
+        node,
+        f"insert into test_multiple_inserts select number, randomString(100) from numbers(30) settings azure_create_new_file_on_insert=1",
     )
 
     result = azure_query(node, f"select count() from test_multiple_inserts")

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 0491/1478] 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 e87348010d3e77d60b8ccd85e7bd4574bec9600b Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
Date: Tue, 6 Jun 2023 14:42:56 +0200
Subject: [PATCH 0492/1478] Rework loading and removing of data parts for
 MergeTree tables. (#49474)

Co-authored-by: Sergei Trifonov <sergei@clickhouse.com>
---
 programs/local/LocalServer.cpp                |  24 +-
 programs/server/Server.cpp                    |  53 +++-
 src/Backups/BackupIO_S3.cpp                   |   8 +-
 src/Common/CurrentMetrics.cpp                 |   2 +
 src/Core/ServerSettings.h                     |   4 +-
 src/Formats/FormatFactory.cpp                 |   2 +-
 src/IO/SharedThreadPools.cpp                  | 151 ++++++----
 src/IO/SharedThreadPools.h                    |  74 +++--
 src/Interpreters/threadPoolCallbackRunner.h   |   3 +
 src/Storages/MergeTree/MergeTreeData.cpp      | 284 +++++++-----------
 src/Storages/MergeTree/MergeTreeData.h        |   6 +-
 src/Storages/MergeTree/MergeTreeSettings.h    |   5 +-
 src/Storages/MergeTree/MergeTreeSource.cpp    |   2 +-
 src/Storages/StorageS3.cpp                    |   2 +-
 .../System/StorageSystemDetachedParts.cpp     |   2 +-
 .../00988_parallel_parts_removal.sql          |   2 +-
 .../00989_parallel_parts_loading.sql          |   2 +-
 .../01810_max_part_removal_threads_long.sh    |  11 +-
 .../02432_s3_parallel_parts_cleanup.sql       |   5 +-
 19 files changed, 352 insertions(+), 290 deletions(-)

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 96c1ca261b5..caca7cfb50d 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -130,15 +130,31 @@ void LocalServer::initialize(Poco::Util::Application & self)
     });
 #endif
 
-    IOThreadPool::initialize(
+    getIOThreadPool().initialize(
         config().getUInt("max_io_thread_pool_size", 100),
         config().getUInt("max_io_thread_pool_free_size", 0),
         config().getUInt("io_thread_pool_queue_size", 10000));
 
-    OutdatedPartsLoadingThreadPool::initialize(
-        config().getUInt("max_outdated_parts_loading_thread_pool_size", 16),
+
+    const size_t active_parts_loading_threads = config().getUInt("max_active_parts_loading_thread_pool_size", 64);
+    getActivePartsLoadingThreadPool().initialize(
+        active_parts_loading_threads,
         0, // We don't need any threads one all the parts will be loaded
-        config().getUInt("max_outdated_parts_loading_thread_pool_size", 16));
+        active_parts_loading_threads);
+
+    const size_t outdated_parts_loading_threads = config().getUInt("max_outdated_parts_loading_thread_pool_size", 32);
+    getOutdatedPartsLoadingThreadPool().initialize(
+        outdated_parts_loading_threads,
+        0, // We don't need any threads one all the parts will be loaded
+        outdated_parts_loading_threads);
+
+    getOutdatedPartsLoadingThreadPool().setMaxTurboThreads(active_parts_loading_threads);
+
+    const size_t cleanup_threads = config().getUInt("max_parts_cleaning_thread_pool_size", 128);
+    getPartsCleaningThreadPool().initialize(
+        cleanup_threads,
+        0, // We don't need any threads one all the parts will be deleted
+        cleanup_threads);
 }
 
 
diff --git a/programs/server/Server.cpp b/programs/server/Server.cpp
index 9eb3e6c9ebc..d0fc8aca5e8 100644
--- a/programs/server/Server.cpp
+++ b/programs/server/Server.cpp
@@ -683,21 +683,36 @@ try
     });
 #endif
 
-    IOThreadPool::initialize(
+    getIOThreadPool().initialize(
         server_settings.max_io_thread_pool_size,
         server_settings.max_io_thread_pool_free_size,
         server_settings.io_thread_pool_queue_size);
 
-    BackupsIOThreadPool::initialize(
+    getBackupsIOThreadPool().initialize(
         server_settings.max_backups_io_thread_pool_size,
         server_settings.max_backups_io_thread_pool_free_size,
         server_settings.backups_io_thread_pool_queue_size);
 
-    OutdatedPartsLoadingThreadPool::initialize(
+    getActivePartsLoadingThreadPool().initialize(
+        server_settings.max_active_parts_loading_thread_pool_size,
+        0, // We don't need any threads once all the parts will be loaded
+        server_settings.max_active_parts_loading_thread_pool_size);
+
+    getOutdatedPartsLoadingThreadPool().initialize(
         server_settings.max_outdated_parts_loading_thread_pool_size,
-        0, // We don't need any threads one all the parts will be loaded
+        0, // We don't need any threads once all the parts will be loaded
         server_settings.max_outdated_parts_loading_thread_pool_size);
 
+    /// It could grow if we need to synchronously wait until all the data parts will be loaded.
+    getOutdatedPartsLoadingThreadPool().setMaxTurboThreads(
+        server_settings.max_active_parts_loading_thread_pool_size
+    );
+
+    getPartsCleaningThreadPool().initialize(
+        server_settings.max_parts_cleaning_thread_pool_size,
+        0, // We don't need any threads one all the parts will be deleted
+        server_settings.max_parts_cleaning_thread_pool_size);
+
     /// Initialize global local cache for remote filesystem.
     if (config().has("local_cache_for_remote_fs"))
     {
@@ -1226,6 +1241,36 @@ try
             global_context->getMessageBrokerSchedulePool().increaseThreadsCount(server_settings_.background_message_broker_schedule_pool_size);
             global_context->getDistributedSchedulePool().increaseThreadsCount(server_settings_.background_distributed_schedule_pool_size);
 
+            getIOThreadPool().reloadConfiguration(
+                server_settings.max_io_thread_pool_size,
+                server_settings.max_io_thread_pool_free_size,
+                server_settings.io_thread_pool_queue_size);
+
+            getBackupsIOThreadPool().reloadConfiguration(
+                server_settings.max_backups_io_thread_pool_size,
+                server_settings.max_backups_io_thread_pool_free_size,
+                server_settings.backups_io_thread_pool_queue_size);
+
+            getActivePartsLoadingThreadPool().reloadConfiguration(
+                server_settings.max_active_parts_loading_thread_pool_size,
+                0, // We don't need any threads once all the parts will be loaded
+                server_settings.max_active_parts_loading_thread_pool_size);
+
+            getOutdatedPartsLoadingThreadPool().reloadConfiguration(
+                server_settings.max_outdated_parts_loading_thread_pool_size,
+                0, // We don't need any threads once all the parts will be loaded
+                server_settings.max_outdated_parts_loading_thread_pool_size);
+
+            /// It could grow if we need to synchronously wait until all the data parts will be loaded.
+            getOutdatedPartsLoadingThreadPool().setMaxTurboThreads(
+                server_settings.max_active_parts_loading_thread_pool_size
+            );
+
+            getPartsCleaningThreadPool().reloadConfiguration(
+                server_settings.max_parts_cleaning_thread_pool_size,
+                0, // We don't need any threads one all the parts will be deleted
+                server_settings.max_parts_cleaning_thread_pool_size);
+
             if (config->has("resources"))
             {
                 global_context->getResourceManager()->updateConfiguration(*config);
diff --git a/src/Backups/BackupIO_S3.cpp b/src/Backups/BackupIO_S3.cpp
index f1fd276e34b..967beba4bf5 100644
--- a/src/Backups/BackupIO_S3.cpp
+++ b/src/Backups/BackupIO_S3.cpp
@@ -161,7 +161,7 @@ void BackupReaderS3::copyFileToDisk(const String & path_in_backup, size_t file_s
                 /* dest_key= */ blob_path[0],
                 request_settings,
                 object_attributes,
-                threadPoolCallbackRunner<void>(BackupsIOThreadPool::get(), "BackupReaderS3"),
+                threadPoolCallbackRunner<void>(getBackupsIOThreadPool().get(), "BackupReaderS3"),
                 /* for_disk_s3= */ true);
 
             return file_size;
@@ -212,7 +212,7 @@ void BackupWriterS3::copyFileFromDisk(const String & path_in_backup, DiskPtr src
                 fs::path(s3_uri.key) / path_in_backup,
                 request_settings,
                 {},
-                threadPoolCallbackRunner<void>(BackupsIOThreadPool::get(), "BackupWriterS3"));
+                threadPoolCallbackRunner<void>(getBackupsIOThreadPool().get(), "BackupWriterS3"));
             return; /// copied!
         }
     }
@@ -224,7 +224,7 @@ void BackupWriterS3::copyFileFromDisk(const String & path_in_backup, DiskPtr src
 void BackupWriterS3::copyDataToFile(const String & path_in_backup, const CreateReadBufferFunction & create_read_buffer, UInt64 start_pos, UInt64 length)
 {
     copyDataToS3File(create_read_buffer, start_pos, length, client, s3_uri.bucket, fs::path(s3_uri.key) / path_in_backup, request_settings, {},
-                     threadPoolCallbackRunner<void>(BackupsIOThreadPool::get(), "BackupWriterS3"));
+                     threadPoolCallbackRunner<void>(getBackupsIOThreadPool().get(), "BackupWriterS3"));
 }
 
 BackupWriterS3::~BackupWriterS3() = default;
@@ -258,7 +258,7 @@ std::unique_ptr<WriteBuffer> BackupWriterS3::writeFile(const String & file_name)
         DBMS_DEFAULT_BUFFER_SIZE,
         request_settings,
         std::nullopt,
-        threadPoolCallbackRunner<void>(BackupsIOThreadPool::get(), "BackupWriterS3"),
+        threadPoolCallbackRunner<void>(getBackupsIOThreadPool().get(), "BackupWriterS3"),
         write_settings);
 }
 
diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 956487a300e..61725d079bf 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -137,6 +137,8 @@
     M(ObjectStorageAzureThreadsActive, "Number of threads in the AzureObjectStorage thread pool running a task.") \
     M(MergeTreePartsLoaderThreads, "Number of threads in the MergeTree parts loader thread pool.") \
     M(MergeTreePartsLoaderThreadsActive, "Number of threads in the MergeTree parts loader thread pool running a task.") \
+    M(MergeTreeOutdatedPartsLoaderThreads, "Number of threads in the threadpool for loading Outdated data parts.") \
+    M(MergeTreeOutdatedPartsLoaderThreadsActive, "Number of active threads in the threadpool for loading Outdated data parts.") \
     M(MergeTreePartsCleanerThreads, "Number of threads in the MergeTree parts cleaner thread pool.") \
     M(MergeTreePartsCleanerThreadsActive, "Number of threads in the MergeTree parts cleaner thread pool running a task.") \
     M(SystemReplicasThreads, "Number of threads in the system.replicas thread pool.") \
diff --git a/src/Core/ServerSettings.h b/src/Core/ServerSettings.h
index cb43d62ecd1..1a9f226041b 100644
--- a/src/Core/ServerSettings.h
+++ b/src/Core/ServerSettings.h
@@ -21,7 +21,9 @@ namespace DB
     M(UInt64, max_io_thread_pool_size, 100, "The maximum number of threads that would be used for IO operations", 0) \
     M(UInt64, max_io_thread_pool_free_size, 0, "Max free size for IO thread pool.", 0) \
     M(UInt64, io_thread_pool_queue_size, 10000, "Queue size for IO thread pool.", 0) \
-    M(UInt64, max_outdated_parts_loading_thread_pool_size, 32, "The maximum number of threads that would be used for loading outdated data parts on startup", 0) \
+    M(UInt64, max_active_parts_loading_thread_pool_size, 64, "The number of threads to load active set of data parts (Active ones) at startup.", 0) \
+    M(UInt64, max_outdated_parts_loading_thread_pool_size, 32, "The number of threads to load inactive set of data parts (Outdated ones) at startup.", 0) \
+    M(UInt64, max_parts_cleaning_thread_pool_size, 128, "The number of threads for concurrent removal of inactive data parts.", 0) \
     M(UInt64, max_replicated_fetches_network_bandwidth_for_server, 0, "The maximum speed of data exchange over the network in bytes per second for replicated fetches. Zero means unlimited.", 0) \
     M(UInt64, max_replicated_sends_network_bandwidth_for_server, 0, "The maximum speed of data exchange over the network in bytes per second for replicated sends. Zero means unlimited.", 0) \
     M(UInt64, max_remote_read_network_bandwidth_for_server, 0, "The maximum speed of data exchange over the network in bytes per second for read. Zero means unlimited.", 0) \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 6f2974c49c6..39b28e025a6 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -364,7 +364,7 @@ std::unique_ptr<ReadBuffer> FormatFactory::wrapReadBufferIfNeeded(
             settings.max_download_buffer_size);
 
         res = wrapInParallelReadBufferIfSupported(
-            buf, threadPoolCallbackRunner<void>(IOThreadPool::get(), "ParallelRead"),
+            buf, threadPoolCallbackRunner<void>(getIOThreadPool().get(), "ParallelRead"),
             max_download_threads, settings.max_download_buffer_size, file_size);
     }
 
diff --git a/src/IO/SharedThreadPools.cpp b/src/IO/SharedThreadPools.cpp
index b7b6aea1567..6a0e953f0ef 100644
--- a/src/IO/SharedThreadPools.cpp
+++ b/src/IO/SharedThreadPools.cpp
@@ -9,8 +9,12 @@ namespace CurrentMetrics
     extern const Metric IOThreadsActive;
     extern const Metric BackupsIOThreads;
     extern const Metric BackupsIOThreadsActive;
-    extern const Metric OutdatedPartsLoadingThreads;
-    extern const Metric OutdatedPartsLoadingThreadsActive;
+    extern const Metric MergeTreePartsLoaderThreads;
+    extern const Metric MergeTreePartsLoaderThreadsActive;
+    extern const Metric MergeTreePartsCleanerThreads;
+    extern const Metric MergeTreePartsCleanerThreadsActive;
+    extern const Metric MergeTreeOutdatedPartsLoaderThreads;
+    extern const Metric MergeTreeOutdatedPartsLoaderThreadsActive;
 }
 
 namespace DB
@@ -21,88 +25,117 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-std::unique_ptr<ThreadPool> IOThreadPool::instance;
 
-void IOThreadPool::initialize(size_t max_threads, size_t max_free_threads, size_t queue_size)
+StaticThreadPool::StaticThreadPool(
+    const String & name_,
+    CurrentMetrics::Metric threads_metric_,
+    CurrentMetrics::Metric threads_active_metric_)
+    : name(name_)
+    , threads_metric(threads_metric_)
+    , threads_active_metric(threads_active_metric_)
+{
+}
+
+void StaticThreadPool::initialize(size_t max_threads, size_t max_free_threads, size_t queue_size)
 {
     if (instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The IO thread pool is initialized twice");
-    }
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is initialized twice", name);
 
+    /// By default enabling "turbo mode" won't affect the number of threads anyhow
+    max_threads_turbo = max_threads;
+    max_threads_normal = max_threads;
     instance = std::make_unique<ThreadPool>(
-        CurrentMetrics::IOThreads,
-        CurrentMetrics::IOThreadsActive,
+        threads_metric,
+        threads_active_metric,
         max_threads,
         max_free_threads,
         queue_size,
         /* shutdown_on_exception= */ false);
 }
 
-ThreadPool & IOThreadPool::get()
+void StaticThreadPool::reloadConfiguration(size_t max_threads, size_t max_free_threads, size_t queue_size)
 {
     if (!instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The IO thread pool is not initialized");
-    }
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is not initialized", name);
+
+    instance->setMaxThreads(turbo_mode_enabled > 0 ? max_threads_turbo : max_threads);
+    instance->setMaxFreeThreads(max_free_threads);
+    instance->setQueueSize(queue_size);
+}
+
+
+ThreadPool & StaticThreadPool::get()
+{
+    if (!instance)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is not initialized", name);
 
     return *instance;
 }
 
-std::unique_ptr<ThreadPool> BackupsIOThreadPool::instance;
-
-void BackupsIOThreadPool::initialize(size_t max_threads, size_t max_free_threads, size_t queue_size)
-{
-    if (instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The BackupsIO thread pool is initialized twice");
-    }
-
-    instance = std::make_unique<ThreadPool>(
-        CurrentMetrics::BackupsIOThreads,
-        CurrentMetrics::BackupsIOThreadsActive,
-        max_threads,
-        max_free_threads,
-        queue_size,
-        /* shutdown_on_exception= */ false);
-}
-
-ThreadPool & BackupsIOThreadPool::get()
+void StaticThreadPool::enableTurboMode()
 {
     if (!instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The BackupsIO thread pool is not initialized");
-    }
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is not initialized", name);
 
-    return *instance;
+    std::lock_guard lock(mutex);
+
+    ++turbo_mode_enabled;
+    if (turbo_mode_enabled == 1)
+        instance->setMaxThreads(max_threads_turbo);
 }
 
-std::unique_ptr<ThreadPool> OutdatedPartsLoadingThreadPool::instance;
-
-void OutdatedPartsLoadingThreadPool::initialize(size_t max_threads, size_t max_free_threads, size_t queue_size)
-{
-    if (instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The PartsLoadingThreadPool thread pool is initialized twice");
-    }
-
-    instance = std::make_unique<ThreadPool>(
-        CurrentMetrics::OutdatedPartsLoadingThreads,
-        CurrentMetrics::OutdatedPartsLoadingThreadsActive,
-        max_threads,
-        max_free_threads,
-        queue_size,
-        /* shutdown_on_exception= */ false);
-}
-
-ThreadPool & OutdatedPartsLoadingThreadPool::get()
+void StaticThreadPool::disableTurboMode()
 {
     if (!instance)
-    {
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "The PartsLoadingThreadPool thread pool is not initialized");
-    }
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is not initialized", name);
 
-    return *instance;
+    std::lock_guard lock(mutex);
+
+    --turbo_mode_enabled;
+    if (turbo_mode_enabled == 0)
+        instance->setMaxThreads(max_threads_normal);
+}
+
+void StaticThreadPool::setMaxTurboThreads(size_t max_threads_turbo_)
+{
+    if (!instance)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "The {} is not initialized", name);
+
+    std::lock_guard lock(mutex);
+
+    max_threads_turbo = max_threads_turbo_;
+    if (turbo_mode_enabled > 0)
+        instance->setMaxThreads(max_threads_turbo);
+}
+
+StaticThreadPool & getIOThreadPool()
+{
+    static StaticThreadPool instance("IOThreadPool", CurrentMetrics::IOThreads, CurrentMetrics::IOThreadsActive);
+    return instance;
+}
+
+StaticThreadPool & getBackupsIOThreadPool()
+{
+    static StaticThreadPool instance("BackupsIOThreadPool", CurrentMetrics::BackupsIOThreads, CurrentMetrics::BackupsIOThreadsActive);
+    return instance;
+}
+
+StaticThreadPool & getActivePartsLoadingThreadPool()
+{
+    static StaticThreadPool instance("MergeTreePartsLoaderThreadPool", CurrentMetrics::MergeTreePartsLoaderThreads, CurrentMetrics::MergeTreePartsLoaderThreadsActive);
+    return instance;
+}
+
+StaticThreadPool & getPartsCleaningThreadPool()
+{
+    static StaticThreadPool instance("MergeTreePartsCleanerThreadPool", CurrentMetrics::MergeTreePartsCleanerThreads, CurrentMetrics::MergeTreePartsCleanerThreadsActive);
+    return instance;
+}
+
+StaticThreadPool & getOutdatedPartsLoadingThreadPool()
+{
+    static StaticThreadPool instance("MergeTreeOutdatedPartsLoaderThreadPool", CurrentMetrics::MergeTreeOutdatedPartsLoaderThreads, CurrentMetrics::MergeTreeOutdatedPartsLoaderThreadsActive);
+    return instance;
 }
 
 }
diff --git a/src/IO/SharedThreadPools.h b/src/IO/SharedThreadPools.h
index 1b43dfe778c..188a2a4f003 100644
--- a/src/IO/SharedThreadPools.h
+++ b/src/IO/SharedThreadPools.h
@@ -1,48 +1,64 @@
 #pragma once
 
+#include <base/types.h>
 #include <Common/ThreadPool_fwd.h>
+#include <Common/CurrentMetrics.h>
+
 #include <cstdlib>
 #include <memory>
+#include <mutex>
 
 namespace DB
 {
 
-/*
- * ThreadPool used for the IO.
- */
-class IOThreadPool
+class StaticThreadPool
 {
-    static std::unique_ptr<ThreadPool> instance;
-
 public:
-    static void initialize(size_t max_threads, size_t max_free_threads, size_t queue_size);
-    static ThreadPool & get();
+    StaticThreadPool(
+        const String & name_,
+        CurrentMetrics::Metric threads_metric_,
+        CurrentMetrics::Metric threads_active_metric_);
+
+    ThreadPool & get();
+
+    void initialize(size_t max_threads, size_t max_free_threads, size_t queue_size);
+    void reloadConfiguration(size_t max_threads, size_t max_free_threads, size_t queue_size);
+
+    /// At runtime we can increase the number of threads up the specified limit
+    /// This is needed to utilize as much a possible resources to accomplish some task.
+    void setMaxTurboThreads(size_t max_threads_turbo_);
+    void enableTurboMode();
+    void disableTurboMode();
+
+private:
+    const String name;
+    const CurrentMetrics::Metric threads_metric;
+    const CurrentMetrics::Metric threads_active_metric;
+
+    std::unique_ptr<ThreadPool> instance;
+    std::mutex mutex;
+    size_t max_threads_turbo = 0;
+    size_t max_threads_normal = 0;
+    /// If this counter is > 0 - this specific mode is enabled
+    size_t turbo_mode_enabled = 0;
 };
 
+/// ThreadPool used for the IO.
+StaticThreadPool & getIOThreadPool();
 
-/*
- * ThreadPool used for the Backup IO.
- */
-class BackupsIOThreadPool
-{
-    static std::unique_ptr<ThreadPool> instance;
+/// ThreadPool used for the Backup IO.
+StaticThreadPool & getBackupsIOThreadPool();
 
-public:
-    static void initialize(size_t max_threads, size_t max_free_threads, size_t queue_size);
-    static ThreadPool & get();
-};
+/// ThreadPool used for the loading of Outdated data parts for MergeTree tables.
+StaticThreadPool & getActivePartsLoadingThreadPool();
 
+/// ThreadPool used for deleting data parts for MergeTree tables.
+StaticThreadPool & getPartsCleaningThreadPool();
 
-/*
- * ThreadPool used for the loading of Outdated data parts for MergeTree tables.
- */
-class OutdatedPartsLoadingThreadPool
-{
-    static std::unique_ptr<ThreadPool> instance;
-
-public:
-    static void initialize(size_t max_threads, size_t max_free_threads, size_t queue_size);
-    static ThreadPool & get();
-};
+/// This ThreadPool is used for the loading of Outdated data parts for MergeTree tables.
+/// Normally we will just load Outdated data parts concurrently in background, but in
+/// case when we need to synchronously wait for the loading to be finished, we can increase
+/// the number of threads by calling enableTurboMode() :-)
+StaticThreadPool & getOutdatedPartsLoadingThreadPool();
 
 }
diff --git a/src/Interpreters/threadPoolCallbackRunner.h b/src/Interpreters/threadPoolCallbackRunner.h
index f7324bfafe6..eb90b61cf31 100644
--- a/src/Interpreters/threadPoolCallbackRunner.h
+++ b/src/Interpreters/threadPoolCallbackRunner.h
@@ -44,6 +44,9 @@ ThreadPoolCallbackRunner<Result, Callback> threadPoolCallbackRunner(ThreadPool &
 
         auto future = task->get_future();
 
+        /// ThreadPool is using "bigger is higher priority" instead of "smaller is more priority".
+        /// Note: calling method scheduleOrThrowOnError in intentional, because we don't want to throw exceptions
+        /// in critical places where this callback runner is used (e.g. loading or deletion of parts)
         my_pool->scheduleOrThrowOnError([my_task = std::move(task)]{ (*my_task)(); }, priority);
 
         return future;
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 32665429051..e806e1bb93f 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -130,10 +130,6 @@ namespace ProfileEvents
 namespace CurrentMetrics
 {
     extern const Metric DelayedInserts;
-    extern const Metric MergeTreePartsLoaderThreads;
-    extern const Metric MergeTreePartsLoaderThreadsActive;
-    extern const Metric MergeTreePartsCleanerThreads;
-    extern const Metric MergeTreePartsCleanerThreadsActive;
 }
 
 
@@ -1425,71 +1421,17 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPartWithRetries(
     UNREACHABLE();
 }
 
-std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(
-    ThreadPool & pool,
-    size_t num_parts,
-    std::queue<PartLoadingTreeNodes> & parts_queue,
-    const MergeTreeSettingsPtr & settings)
+std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(PartLoadingTreeNodes & parts_to_load)
 {
-    /// Parallel loading of data parts.
-    pool.setMaxThreads(std::min(static_cast<size_t>(settings->max_part_loading_threads), num_parts));
-    size_t num_threads = pool.getMaxThreads();
-    LOG_DEBUG(log, "Going to use {} threads to load parts", num_threads);
+    const size_t num_parts = parts_to_load.size();
 
-    std::vector<size_t> parts_per_thread(num_threads, num_parts / num_threads);
-    for (size_t i = 0ul; i < num_parts % num_threads; ++i)
-        ++parts_per_thread[i];
+    LOG_DEBUG(log, "Will load {} number of parts using {} threads", num_parts, getActivePartsLoadingThreadPool().get().getMaxThreads());
 
-    /// Prepare data parts for parallel loading. Threads will focus on given disk first, then steal
-    /// others' tasks when finish current disk part loading process.
-    std::vector<PartLoadingTreeNodes> threads_parts(num_threads);
-    std::set<size_t> remaining_thread_parts;
-    std::queue<size_t> threads_queue;
+    /// 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);
 
-    for (size_t i = 0; i < num_threads; ++i)
-    {
-        remaining_thread_parts.insert(i);
-        threads_queue.push(i);
-    }
-
-    while (!parts_queue.empty())
-    {
-        assert(!threads_queue.empty());
-        size_t i = threads_queue.front();
-        auto & need_parts = parts_per_thread[i];
-        assert(need_parts > 0);
-
-        auto & thread_parts = threads_parts[i];
-        auto & current_parts = parts_queue.front();
-        assert(!current_parts.empty());
-
-        auto parts_to_grab = std::min(need_parts, current_parts.size());
-        thread_parts.insert(thread_parts.end(), current_parts.end() - parts_to_grab, current_parts.end());
-        current_parts.resize(current_parts.size() - parts_to_grab);
-        need_parts -= parts_to_grab;
-
-        /// Before processing next thread, change disk if possible.
-        /// Different threads will likely start loading parts from different disk,
-        /// which may improve read parallelism for JBOD.
-
-        /// If current disk still has some parts, push it to the tail.
-        if (!current_parts.empty())
-            parts_queue.push(std::move(current_parts));
-
-        parts_queue.pop();
-
-        /// If current thread still want some parts, push it to the tail.
-        if (need_parts > 0)
-            threads_queue.push(i);
-
-        threads_queue.pop();
-    }
-
-    assert(threads_queue.empty());
-    assert(std::all_of(threads_parts.begin(), threads_parts.end(), [](const auto & parts)
-    {
-        return !parts.empty();
-    }));
+    auto runner = threadPoolCallbackRunner<void>(getActivePartsLoadingThreadPool().get(), "ActiveParts");
+    std::vector<std::future<void>> parts_futures;
 
     std::mutex part_select_mutex;
     std::mutex part_loading_mutex;
@@ -1498,81 +1440,77 @@ std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(
 
     try
     {
-        for (size_t thread = 0; thread < num_threads; ++thread)
+        while (true)
         {
-            pool.scheduleOrThrowOnError([&, thread, thread_group = CurrentThread::getGroup()]
+            bool are_parts_to_load_empty = false;
             {
-                SCOPE_EXIT_SAFE(
-                    if (thread_group)
-                        CurrentThread::detachFromGroupIfNotDetached();
-                );
-                if (thread_group)
-                    CurrentThread::attachToGroupIfDetached(thread_group);
+                std::lock_guard lock(part_select_mutex);
+                are_parts_to_load_empty = parts_to_load.empty();
+            }
 
-                while (true)
+            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();
+                /// 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.
+            }
+
+            PartLoadingTree::NodePtr current_part;
+            {
+                std::lock_guard lock(part_select_mutex);
+                if (parts_to_load.empty())
+                    break;
+
+                current_part = parts_to_load.back();
+                parts_to_load.pop_back();
+            }
+
+            parts_futures.push_back(runner(
+                [&, part = std::move(current_part)]()
                 {
-                    PartLoadingTree::NodePtr thread_part;
-                    size_t thread_idx = thread;
-
-                    {
-                        std::lock_guard lock{part_select_mutex};
-
-                        if (remaining_thread_parts.empty())
-                            return;
-
-                        /// Steal task if nothing to do
-                        if (threads_parts[thread].empty())
-                        {
-                            // Try random steal tasks from the next thread
-                            std::uniform_int_distribution<size_t> distribution(0, remaining_thread_parts.size() - 1);
-                            auto it = remaining_thread_parts.begin();
-                            std::advance(it, distribution(thread_local_rng));
-                            thread_idx = *it;
-                        }
-
-                        auto & thread_parts = threads_parts[thread_idx];
-                        thread_part = thread_parts.back();
-                        thread_parts.pop_back();
-                        if (thread_parts.empty())
-                            remaining_thread_parts.erase(thread_idx);
-                    }
-
                     /// Pass a separate mutex to guard the set of parts, because this lambda
                     /// is called concurrently but with already locked @data_parts_mutex.
                     auto res = loadDataPartWithRetries(
-                        thread_part->info, thread_part->name, thread_part->disk,
+                        part->info, part->name, part->disk,
                         DataPartState::Active, part_loading_mutex, loading_parts_initial_backoff_ms,
                         loading_parts_max_backoff_ms, loading_parts_max_tries);
 
-                    thread_part->is_loaded = true;
+                    part->is_loaded = true;
                     bool is_active_part = res.part->getState() == DataPartState::Active;
 
                     /// If part is broken or duplicate or should be removed according to transaction
                     /// and it has any covered parts then try to load them to replace this part.
-                    if (!is_active_part && !thread_part->children.empty())
+                    if (!is_active_part && !part->children.empty())
                     {
                         std::lock_guard lock{part_select_mutex};
-                        for (const auto & [_, node] : thread_part->children)
-                            threads_parts[thread].push_back(node);
-                        remaining_thread_parts.insert(thread);
+                        for (const auto & [_, node] : part->children)
+                            parts_to_load.push_back(node);
                     }
 
                     {
                         std::lock_guard lock(part_loading_mutex);
                         loaded_parts.push_back(std::move(res));
                     }
-                }
-            });
+                }, Priority{0}));
         }
     }
     catch (...)
     {
-        /// If this is not done, then in case of an exception, tasks will be destroyed before the threads are completed, and it will be bad.
-        pool.wait();
+        /// Wait for all scheduled tasks
+        /// A future becomes invalid after .get() call
+        /// + .wait() method is used not to throw any exception here.
+        for (auto & future: parts_futures)
+            if (future.valid())
+                future.wait();
+
         throw;
     }
 
-    pool.wait();
     return loaded_parts;
 }
 
@@ -1679,9 +1617,12 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
         }
     }
 
-    ThreadPool pool(CurrentMetrics::MergeTreePartsLoaderThreads, CurrentMetrics::MergeTreePartsLoaderThreadsActive, disks.size());
+    auto runner = threadPoolCallbackRunner<void>(getActivePartsLoadingThreadPool().get(), "ActiveParts");
     std::vector<PartLoadingTree::PartLoadingInfos> parts_to_load_by_disk(disks.size());
 
+    std::vector<std::future<void>> disks_futures;
+    disks_futures.reserve(disks.size());
+
     for (size_t i = 0; i < disks.size(); ++i)
     {
         const auto & disk_ptr = disks[i];
@@ -1690,7 +1631,7 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
 
         auto & disk_parts = parts_to_load_by_disk[i];
 
-        pool.scheduleOrThrowOnError([&, disk_ptr]()
+        disks_futures.push_back(runner([&, disk_ptr]()
         {
             for (auto it = disk_ptr->iterateDirectory(relative_data_path); it->isValid(); it->next())
             {
@@ -1703,38 +1644,31 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
                 if (auto part_info = MergeTreePartInfo::tryParsePartName(it->name(), format_version))
                     disk_parts.emplace_back(*part_info, it->name(), disk_ptr);
             }
-        });
+        }, Priority{0}));
     }
 
-    pool.wait();
+    /// For iteration to be completed
+    /// Any exception will be re-thrown.
+    for (auto & future : disks_futures)
+        future.get();
+    disks_futures.clear();
 
     PartLoadingTree::PartLoadingInfos parts_to_load;
     for (auto & disk_parts : parts_to_load_by_disk)
         std::move(disk_parts.begin(), disk_parts.end(), std::back_inserter(parts_to_load));
 
     auto loading_tree = PartLoadingTree::build(std::move(parts_to_load));
-    /// Collect parts by disks' names.
-    std::map<String, PartLoadingTreeNodes> disk_part_map;
+
+    size_t num_parts = 0;
+    PartLoadingTreeNodes active_parts;
 
     /// Collect only "the most covering" parts from the top level of the tree.
     loading_tree.traverse(/*recursive=*/ false, [&](const auto & node)
     {
-        disk_part_map[node->disk->getName()].emplace_back(node);
+        active_parts.emplace_back(node);
     });
 
-    size_t num_parts = 0;
-    std::queue<PartLoadingTreeNodes> parts_queue;
-
-    for (auto & [disk_name, disk_parts] : disk_part_map)
-    {
-        LOG_INFO(log, "Found {} parts for disk '{}' to load", disk_parts.size(), disk_name);
-
-        if (disk_parts.empty())
-            continue;
-
-        num_parts += disk_parts.size();
-        parts_queue.push(std::move(disk_parts));
-    }
+    num_parts += active_parts.size();
 
     auto part_lock = lockParts();
     LOG_TEST(log, "loadDataParts: clearing data_parts_indexes (had {} parts)", data_parts_indexes.size());
@@ -1754,7 +1688,7 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
 
     if (num_parts > 0)
     {
-        auto loaded_parts = loadDataPartsFromDisk(pool, num_parts, parts_queue, settings);
+        auto loaded_parts = loadDataPartsFromDisk(active_parts);
 
         for (const auto & res : loaded_parts)
         {
@@ -1783,10 +1717,12 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
 
     if (settings->in_memory_parts_enable_wal)
     {
-        pool.setMaxThreads(disks.size());
         std::vector<MutableDataPartsVector> disks_wal_parts(disks.size());
         std::mutex wal_init_lock;
 
+        std::vector<std::future<void>> wal_disks_futures;
+        wal_disks_futures.reserve(disks.size());
+
         for (size_t i = 0; i < disks.size(); ++i)
         {
             const auto & disk_ptr = disks[i];
@@ -1795,7 +1731,7 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
 
             auto & disk_wal_parts = disks_wal_parts[i];
 
-            pool.scheduleOrThrowOnError([&, disk_ptr]()
+            wal_disks_futures.push_back(runner([&, disk_ptr]()
             {
                 for (auto it = disk_ptr->iterateDirectory(relative_data_path); it->isValid(); it->next())
                 {
@@ -1821,10 +1757,14 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
                             disk_wal_parts.push_back(std::move(part));
                     }
                 }
-            });
+            }, Priority{0}));
         }
 
-        pool.wait();
+        /// For for iteration to be completed
+        /// Any exception will be re-thrown.
+        for (auto & future : wal_disks_futures)
+            future.get();
+        wal_disks_futures.clear();
 
         MutableDataPartsVector parts_from_wal;
         for (auto & disk_wal_parts : disks_wal_parts)
@@ -1925,7 +1865,7 @@ try
 
     std::atomic_size_t num_loaded_parts = 0;
 
-    auto runner = threadPoolCallbackRunner<void>(OutdatedPartsLoadingThreadPool::get(), "OutdatedParts");
+    auto runner = threadPoolCallbackRunner<void>(getOutdatedPartsLoadingThreadPool().get(), "OutdatedParts");
     std::vector<std::future<void>> parts_futures;
 
     while (true)
@@ -1938,8 +1878,10 @@ try
             if (is_async && outdated_data_parts_loading_canceled)
             {
                 /// 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.wait();
+                    future.get();
+                parts_futures.clear();
 
                 LOG_DEBUG(log,
                     "Stopped loading outdated data parts because task was canceled. "
@@ -1973,7 +1915,7 @@ try
 
     /// Wait for every scheduled task
     for (auto & future : parts_futures)
-        future.wait();
+        future.get();
 
     LOG_DEBUG(log, "Loaded {} outdated data parts {}",
         num_loaded_parts, is_async ? "asynchronously" : "synchronously");
@@ -1999,6 +1941,13 @@ void MergeTreeData::waitForOutdatedPartsToBeLoaded() const TSA_NO_THREAD_SAFETY_
     if (isStaticStorage())
         return;
 
+    /// We need to load parts as fast as possible
+    getOutdatedPartsLoadingThreadPool().enableTurboMode();
+    SCOPE_EXIT({
+        /// Let's lower the number of threads e.g. for later ATTACH queries to behave as usual
+        getOutdatedPartsLoadingThreadPool().disableTurboMode();
+    });
+
     LOG_TRACE(log, "Will wait for outdated data parts to be loaded");
 
     std::unique_lock lock(outdated_data_parts_mutex);
@@ -2420,20 +2369,15 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
         }
     };
 
-    if (settings->max_part_removal_threads <= 1 || parts_to_remove.size() <= settings->concurrent_part_removal_threshold)
+    if (parts_to_remove.size() <= settings->concurrent_part_removal_threshold)
     {
         remove_single_thread();
         return;
     }
 
     /// Parallel parts removal.
-    size_t num_threads = settings->max_part_removal_threads;
-    if (!num_threads)
-        num_threads = getNumberOfPhysicalCPUCores() * 2;
-    num_threads = std::min<size_t>(num_threads, parts_to_remove.size());
     std::mutex part_names_mutex;
-    ThreadPool pool(CurrentMetrics::MergeTreePartsCleanerThreads, CurrentMetrics::MergeTreePartsCleanerThreadsActive,
-                    num_threads, num_threads, /* unlimited queue size */ 0);
+    auto runner = threadPoolCallbackRunner<void>(getPartsCleaningThreadPool().get(), "PartsCleaning");
 
     /// This flag disallow straightforward concurrent parts removal. It's required only in case
     /// when we have parts on zero-copy disk + at least some of them were mutated.
@@ -2453,27 +2397,27 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
         LOG_DEBUG(
             log, "Removing {} parts from filesystem (concurrently): Parts: [{}]", parts_to_remove.size(), fmt::join(parts_to_remove, ", "));
 
+        std::vector<std::future<void>> parts_to_remove_futures;
+        parts_to_remove_futures.reserve(parts_to_remove.size());
+
         for (const DataPartPtr & part : parts_to_remove)
         {
-            pool.scheduleOrThrowOnError([&part, &part_names_mutex, part_names_succeed, thread_group = CurrentThread::getGroup()]
+            parts_to_remove_futures.push_back(runner([&part, &part_names_mutex, part_names_succeed, thread_group = CurrentThread::getGroup()]
             {
-                SCOPE_EXIT_SAFE(
-                    if (thread_group)
-                        CurrentThread::detachFromGroupIfNotDetached();
-                );
-                if (thread_group)
-                    CurrentThread::attachToGroupIfDetached(thread_group);
-
                 asMutableDeletingPart(part)->remove();
                 if (part_names_succeed)
                 {
                     std::lock_guard lock(part_names_mutex);
                     part_names_succeed->insert(part->name);
                 }
-            });
+            }, Priority{0}));
         }
 
-        pool.wait();
+        /// Any exception will be re-thrown.
+        for (auto & future : parts_to_remove_futures)
+            future.get();
+        parts_to_remove_futures.clear();
+
         return;
     }
 
@@ -2544,20 +2488,15 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
         return independent_ranges;
     };
 
-    auto schedule_parts_removal = [this, &pool, &part_names_mutex, part_names_succeed](
+    std::vector<std::future<void>> part_removal_futures;
+
+    auto schedule_parts_removal = [this, &runner, &part_names_mutex, part_names_succeed, &part_removal_futures](
         const MergeTreePartInfo & range, DataPartsVector && parts_in_range)
     {
         /// Below, range should be captured by copy to avoid use-after-scope on exception from pool
-        pool.scheduleOrThrowOnError(
-            [this, range, &part_names_mutex, part_names_succeed, thread_group = CurrentThread::getGroup(), batch = std::move(parts_in_range)]
+        part_removal_futures.push_back(runner(
+            [this, range, &part_names_mutex, part_names_succeed, batch = std::move(parts_in_range)]
         {
-            SCOPE_EXIT_SAFE(
-                if (thread_group)
-                    CurrentThread::detachFromGroupIfNotDetached();
-            );
-            if (thread_group)
-                CurrentThread::attachToGroupIfDetached(thread_group);
-
             LOG_TRACE(log, "Removing {} parts in blocks range {}", batch.size(), range.getPartNameForLogs());
 
             for (const auto & part : batch)
@@ -2569,7 +2508,7 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
                     part_names_succeed->insert(part->name);
                 }
             }
-        });
+        }, Priority{0}));
     };
 
     RemovalRanges independent_ranges = split_into_independent_ranges(parts_to_remove, /* split_times */ 0);
@@ -2632,7 +2571,11 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
     LOG_TRACE(log, "Will remove {} big parts separately: {}", excluded_parts.size(), fmt::join(excluded_parts, ", "));
 
     independent_ranges = split_into_independent_ranges(excluded_parts, /* split_times */ 0);
-    pool.wait();
+
+    /// Any exception will be re-thrown.
+    for (auto & future : part_removal_futures)
+        future.get();
+    part_removal_futures.clear();
 
     for (size_t i = 0; i < independent_ranges.infos.size(); ++i)
     {
@@ -2641,7 +2584,10 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
         schedule_parts_removal(range, std::move(parts_in_range));
     }
 
-    pool.wait();
+    /// Any exception will be re-thrown.
+    for (auto & future : part_removal_futures)
+        future.get();
+    part_removal_futures.clear();
 
     if (parts_to_remove.size() != sum_of_ranges + excluded_parts.size())
         throw Exception(ErrorCodes::LOGICAL_ERROR,
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 1c41de6fa19..2f254f9a787 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -1519,11 +1519,7 @@ private:
         size_t max_backoff_ms,
         size_t max_tries);
 
-    std::vector<LoadPartResult> loadDataPartsFromDisk(
-        ThreadPool & pool,
-        size_t num_parts,
-        std::queue<PartLoadingTreeNodes> & parts_queue,
-        const MergeTreeSettingsPtr & settings);
+    std::vector<LoadPartResult> loadDataPartsFromDisk(PartLoadingTreeNodes & parts_to_load);
 
     void loadDataPartsFromWAL(MutableDataPartsVector & parts_from_wal);
 
diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index 5ea99009756..33aea358078 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -143,8 +143,6 @@ struct Settings;
     M(Bool, ttl_only_drop_parts, false, "Only drop altogether the expired parts and not partially prune them.", 0) \
     M(Bool, materialize_ttl_recalculate_only, false, "Only recalculate ttl info when MATERIALIZE TTL", 0) \
     M(Bool, enable_mixed_granularity_parts, true, "Enable parts with adaptive and non adaptive granularity", 0) \
-    M(MaxThreads, max_part_loading_threads, 0, "The number of threads to load data parts at startup.", 0) \
-    M(MaxThreads, max_part_removal_threads, 0, "The number of threads for concurrent removal of inactive data parts. One is usually enough, but in 'Google Compute Environment SSD Persistent Disks' file removal (unlink) operation is extraordinarily slow and you probably have to increase this number (recommended is up to 16).", 0) \
     M(UInt64, concurrent_part_removal_threshold, 100, "Activate concurrent part removal (see 'max_part_removal_threads') only if the number of inactive data parts is at least this.", 0) \
     M(UInt64, zero_copy_concurrent_part_removal_max_split_times, 5, "Max recursion depth for splitting independent Outdated parts ranges into smaller subranges (highly not recommended to change)", 0) \
     M(Float, zero_copy_concurrent_part_removal_max_postpone_ratio, static_cast<Float32>(0.05), "Max percentage of top level parts to postpone removal in order to get smaller independent ranges (highly not recommended to change)", 0) \
@@ -192,6 +190,9 @@ struct Settings;
     M(UInt64, write_ahead_log_bytes_to_fsync, 100ULL * 1024 * 1024, "Obsolete setting, does nothing.", 0) \
     M(UInt64, write_ahead_log_interval_ms_to_fsync, 100, "Obsolete setting, does nothing.", 0) \
     M(Bool, in_memory_parts_insert_sync, false, "Obsolete setting, does nothing.", 0) \
+    M(MaxThreads, max_part_loading_threads, 0, "Obsolete setting, does nothing.", 0) \
+    M(MaxThreads, max_part_removal_threads, 0, "Obsolete setting, does nothing.", 0) \
+
     /// Settings that should not change after the creation of a table.
     /// NOLINTNEXTLINE
 #define APPLY_FOR_IMMUTABLE_MERGE_TREE_SETTINGS(M) \
diff --git a/src/Storages/MergeTree/MergeTreeSource.cpp b/src/Storages/MergeTree/MergeTreeSource.cpp
index b65f044a13b..69fbdd5a64d 100644
--- a/src/Storages/MergeTree/MergeTreeSource.cpp
+++ b/src/Storages/MergeTree/MergeTreeSource.cpp
@@ -105,7 +105,7 @@ struct MergeTreeSource::AsyncReadingState
     AsyncReadingState()
     {
         control = std::make_shared<Control>();
-        callback_runner = threadPoolCallbackRunner<void>(IOThreadPool::get(), "MergeTreeRead");
+        callback_runner = threadPoolCallbackRunner<void>(getIOThreadPool().get(), "MergeTreeRead");
     }
 
     ~AsyncReadingState()
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 2d8aaec0f07..f1a7bcb71a2 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -766,7 +766,7 @@ public:
                 DBMS_DEFAULT_BUFFER_SIZE,
                 configuration_.request_settings,
                 std::nullopt,
-                threadPoolCallbackRunner<void>(IOThreadPool::get(), "S3ParallelWrite"),
+                threadPoolCallbackRunner<void>(getIOThreadPool().get(), "S3ParallelWrite"),
                 context->getWriteSettings()),
             compression_method,
             3);
diff --git a/src/Storages/System/StorageSystemDetachedParts.cpp b/src/Storages/System/StorageSystemDetachedParts.cpp
index 9f80b994051..97af4094e42 100644
--- a/src/Storages/System/StorageSystemDetachedParts.cpp
+++ b/src/Storages/System/StorageSystemDetachedParts.cpp
@@ -194,7 +194,7 @@ private:
             futures.push_back(
                         scheduleFromThreadPool<void>(
                             std::move(worker),
-                            IOThreadPool::get(),
+                            getIOThreadPool().get(),
                             "DP_BytesOnDisk"));
         }
 
diff --git a/tests/queries/0_stateless/00988_parallel_parts_removal.sql b/tests/queries/0_stateless/00988_parallel_parts_removal.sql
index bff9bbe6d8d..8f79276782b 100644
--- a/tests/queries/0_stateless/00988_parallel_parts_removal.sql
+++ b/tests/queries/0_stateless/00988_parallel_parts_removal.sql
@@ -1,6 +1,6 @@
 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 cleanup_delay_period = 1, cleanup_delay_period_random_add = 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/00989_parallel_parts_loading.sql b/tests/queries/0_stateless/00989_parallel_parts_loading.sql
index 13cd56e1924..a05515cf756 100644
--- a/tests/queries/0_stateless/00989_parallel_parts_loading.sql
+++ b/tests/queries/0_stateless/00989_parallel_parts_loading.sql
@@ -2,7 +2,7 @@
 
 DROP TABLE IF EXISTS mt;
 
-CREATE TABLE mt (x UInt64) ENGINE = MergeTree ORDER BY x SETTINGS max_part_loading_threads = 16, parts_to_delay_insert = 100000, parts_to_throw_insert = 100000;
+CREATE TABLE mt (x UInt64) ENGINE = MergeTree ORDER BY x SETTINGS parts_to_delay_insert = 100000, parts_to_throw_insert = 100000;
 
 SYSTEM STOP MERGES mt;
 
diff --git a/tests/queries/0_stateless/01810_max_part_removal_threads_long.sh b/tests/queries/0_stateless/01810_max_part_removal_threads_long.sh
index f8f49816479..87153a4bd58 100755
--- a/tests/queries/0_stateless/01810_max_part_removal_threads_long.sh
+++ b/tests/queries/0_stateless/01810_max_part_removal_threads_long.sh
@@ -11,6 +11,9 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CUR_DIR"/../shell_config.sh
 
+# The number of threads removing data parts should be between 1 and 129.
+# Because max_parts_cleaning_thread_pool_size is 128 by default
+
 $CLICKHOUSE_CLIENT --allow_deprecated_database_ordinary=1 -nm -q "create database ordinary_$CLICKHOUSE_DATABASE engine=Ordinary"
 
 # MergeTree
@@ -22,7 +25,7 @@ $CLICKHOUSE_CLIENT -nm -q """
     Engine=MergeTree()
     order by key
     partition by key%100
-    settings max_part_removal_threads=10, concurrent_part_removal_threshold=99, min_bytes_for_wide_part=0;
+    settings concurrent_part_removal_threshold=99, min_bytes_for_wide_part=0;
 
     insert into data_01810 select * from numbers(100);
     drop table data_01810 settings log_queries=1;
@@ -30,7 +33,7 @@ $CLICKHOUSE_CLIENT -nm -q """
 
     -- sometimes the same thread can be used to remove part, due to ThreadPool,
     -- hence we cannot compare strictly.
-    select throwIf(not(length(thread_ids) between 1 and 11))
+    select throwIf(not(length(thread_ids) between 1 and 129))
     from system.query_log
     where
         event_date >= yesterday() and
@@ -49,7 +52,7 @@ $CLICKHOUSE_CLIENT -nm -q """
     Engine=ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/rep_data_01810', '1')
     order by key
     partition by key%100
-    settings max_part_removal_threads=10, concurrent_part_removal_threshold=99, min_bytes_for_wide_part=0;
+    settings concurrent_part_removal_threshold=99, min_bytes_for_wide_part=0;
 
     SET insert_keeper_max_retries=1000;
     SET insert_keeper_retry_max_backoff_ms=10;
@@ -60,7 +63,7 @@ $CLICKHOUSE_CLIENT -nm -q """
 
     -- sometimes the same thread can be used to remove part, due to ThreadPool,
     -- hence we cannot compare strictly.
-    select throwIf(not(length(thread_ids) between 1 and 11))
+    select throwIf(not(length(thread_ids) between 1 and 129))
     from system.query_log
     where
         event_date >= yesterday() and
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..5b9342972f4 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,
+        concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1,
         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,
+        concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1,
         min_bytes_for_wide_part=0, min_rows_for_wide_part=0, max_replicated_merges_in_queue=1,
         old_parts_lifetime=0;
 
@@ -66,4 +66,3 @@ drop table rmt2;
 system flush logs;
 select count() > 0 from system.text_log where yesterday() <= event_date and logger_name like '%' || currentDatabase() || '%' and message like '%Removing % parts from filesystem (concurrently): Parts:%';
 select count() > 1, countDistinct(thread_id) > 1 from system.text_log where yesterday() <= event_date and logger_name like '%' || currentDatabase() || '%' and message like '%Removing % parts in blocks range%';
-

From 36d298ceef12daf6689ae648b7efdedf2ee83d79 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@clickhouse.com>
Date: Tue, 6 Jun 2023 14:45:58 +0200
Subject: [PATCH 0493/1478] Fix commit for DiskObjectStorage (#50599)

---
 src/Disks/ObjectStorages/DiskObjectStorage.cpp            | 3 ++-
 src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp | 2 --
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/Disks/ObjectStorages/DiskObjectStorage.cpp b/src/Disks/ObjectStorages/DiskObjectStorage.cpp
index 129f1ab1ef7..005d115a277 100644
--- a/src/Disks/ObjectStorages/DiskObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/DiskObjectStorage.cpp
@@ -596,7 +596,8 @@ void DiskObjectStorage::writeFileUsingBlobWritingFunction(const String & path, W
 {
     LOG_TEST(log, "Write file: {}", path);
     auto transaction = createObjectStorageTransaction();
-    return transaction->writeFileUsingBlobWritingFunction(path, mode, std::move(write_blob_function));
+    transaction->writeFileUsingBlobWritingFunction(path, mode, std::move(write_blob_function));
+    transaction->commit();
 }
 
 void DiskObjectStorage::applyNewSettings(
diff --git a/src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp b/src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
index 257a6fdf2ea..bd66ada492f 100644
--- a/src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
+++ b/src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
@@ -710,8 +710,6 @@ void DiskObjectStorageTransaction::writeFileUsingBlobWritingFunction(
         metadata_transaction->createMetadataFile(path, blob_name, object_size);
     else
         metadata_transaction->addBlobToMetadata(path, blob_name, object_size);
-
-    metadata_transaction->commit();
 }
 
 

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 0494/1478] 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 a1f3bd9e231ade5a88e3bb53dd4c96caa583d835 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 14:55:17 +0200
Subject: [PATCH 0495/1478] Fix reads

---
 .../AzureBlobStorage/AzureObjectStorage.cpp   |  15 +-
 .../ObjectStorages/ObjectStorageIterator.cpp  |   2 +-
 .../ObjectStorages/ObjectStorageIterator.h    |  12 +-
 .../ObjectStorageIteratorAsync.cpp            |  41 +++--
 .../ObjectStorageIteratorAsync.h              |   8 +-
 src/Storages/StorageAzure.cpp                 |  25 ++-
 .../test_storage_azure_blob_storage/test.py   | 145 ++++++++++++++++++
 7 files changed, 216 insertions(+), 32 deletions(-)

diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
index 23a0da39dd3..07173e65448 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
@@ -52,15 +52,18 @@ public:
 
         options.Prefix = path_prefix;
         options.PageSizeHint = static_cast<int>(max_list_size);
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITER PREFIX {}", path_prefix);
     }
 
 private:
     bool getBatchAndCheckNext(RelativePathsWithMetadata & batch) override
     {
+        batch.clear();
         auto outcome = client->ListBlobs(options);
         auto blob_list_response = client->ListBlobs(options);
         auto blobs_list = blob_list_response.Blobs;
 
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BLOB LIST SIZE {}", blobs_list.size());
         for (const auto & blob : blobs_list)
         {
             batch.emplace_back(
@@ -73,11 +76,15 @@ private:
                     {}});
         }
 
-        options.ContinuationToken = blob_list_response.NextPageToken;
-        if (blob_list_response.HasPage())
-            return true;
+        if (!blob_list_response.NextPageToken.HasValue() || blob_list_response.NextPageToken.Value().empty())
+        {
+            LOG_DEBUG(&Poco::Logger::get("DEBUG"), "RETURN FALSE {}", blobs_list.size());
+            return false;
+        }
 
-        return false;
+        options.ContinuationToken = blob_list_response.NextPageToken;
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "RETURN TRUE {}", blobs_list.size());
+        return true;
     }
 
     std::shared_ptr<const Azure::Storage::Blobs::BlobContainerClient> client;
diff --git a/src/Disks/ObjectStorages/ObjectStorageIterator.cpp b/src/Disks/ObjectStorages/ObjectStorageIterator.cpp
index 188b743958c..72ec6e0e500 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIterator.cpp
+++ b/src/Disks/ObjectStorages/ObjectStorageIterator.cpp
@@ -9,7 +9,7 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-RelativePathWithMetadata ObjectStorageIteratorFromList::current() const
+RelativePathWithMetadata ObjectStorageIteratorFromList::current()
 {
     if (!isValid())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
diff --git a/src/Disks/ObjectStorages/ObjectStorageIterator.h b/src/Disks/ObjectStorages/ObjectStorageIterator.h
index e562d92e1fb..2ff5ce60acc 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIterator.h
+++ b/src/Disks/ObjectStorages/ObjectStorageIterator.h
@@ -11,9 +11,9 @@ class IObjectStorageIterator
 public:
     virtual void next() = 0;
     virtual void nextBatch() = 0;
-    virtual bool isValid() const = 0;
-    virtual RelativePathWithMetadata current() const = 0;
-    virtual RelativePathsWithMetadata currentBatch() const = 0;
+    virtual bool isValid() = 0;
+    virtual RelativePathWithMetadata current() = 0;
+    virtual RelativePathsWithMetadata currentBatch() = 0;
     virtual size_t getAccumulatedSize() const = 0;
 
     virtual ~IObjectStorageIterator() = default;
@@ -41,14 +41,14 @@ public:
         batch_iterator = batch.end();
     }
 
-    bool isValid() const override
+    bool isValid() override
     {
         return batch_iterator != batch.end();
     }
 
-    RelativePathWithMetadata current() const override;
+    RelativePathWithMetadata current() override;
 
-    RelativePathsWithMetadata currentBatch() const override
+    RelativePathsWithMetadata currentBatch() override
     {
         return batch;
     }
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
index c97a941f7be..fd6452b7c2a 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
@@ -1,5 +1,7 @@
 #include <Disks/ObjectStorages/ObjectStorageIteratorAsync.h>
 
+#include <Common/logger_useful.h>
+
 namespace DB
 {
 
@@ -13,17 +15,26 @@ void IObjectStorageIteratorAsync::nextBatch()
     std::lock_guard lock(mutex);
     if (!is_finished)
     {
-        if (outcome_future.valid())
+        if (!is_initialized)
         {
-            BatchAndHasNext next_batch = outcome_future.get();
-            current_batch = std::move(next_batch.batch);
-            accumulated_size.fetch_add(current_batch.size(), std::memory_order_relaxed);
-            current_batch_iterator = current_batch.begin();
-            if (next_batch.has_next)
-                outcome_future = scheduleBatch();
-            else
-                is_finished = true;
+            outcome_future = scheduleBatch();
+            is_initialized = true;
         }
+
+         BatchAndHasNext next_batch = outcome_future.get();
+         current_batch = std::move(next_batch.batch);
+         accumulated_size.fetch_add(current_batch.size(), std::memory_order_relaxed);
+         current_batch_iterator = current_batch.begin();
+         LOG_DEBUG(&Poco::Logger::get("DEBUG"), "HAS NEXT {}", next_batch.has_next);
+         if (next_batch.has_next)
+             outcome_future = scheduleBatch();
+         else
+             is_finished = true;
+    }
+    else
+    {
+        current_batch.clear();
+        current_batch_iterator = current_batch.begin();
     }
 }
 
@@ -62,12 +73,15 @@ std::future<IObjectStorageIteratorAsync::BatchAndHasNext> IObjectStorageIterator
 }
 
 
-bool IObjectStorageIteratorAsync::isValid() const
+bool IObjectStorageIteratorAsync::isValid()
 {
+    if (!is_initialized)
+        nextBatch();
+
     return current_batch_iterator != current_batch.end();
 }
 
-RelativePathWithMetadata IObjectStorageIteratorAsync::current() const
+RelativePathWithMetadata IObjectStorageIteratorAsync::current()
 {
     if (!isValid())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
@@ -76,9 +90,12 @@ RelativePathWithMetadata IObjectStorageIteratorAsync::current() const
 }
 
 
-RelativePathsWithMetadata IObjectStorageIteratorAsync::currentBatch() const
+RelativePathsWithMetadata IObjectStorageIteratorAsync::currentBatch()
 {
     std::lock_guard lock(mutex);
+    if (!isValid())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
+
     return current_batch;
 }
 
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
index 3f3f41e7e77..a2b06da9a91 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
@@ -19,14 +19,13 @@ public:
         : list_objects_pool(threads_metric, threads_active_metric, 1)
         , list_objects_scheduler(threadPoolCallbackRunner<BatchAndHasNext>(list_objects_pool, thread_name))
     {
-        nextBatch();
     }
 
     void next() override;
     void nextBatch() override;
-    bool isValid() const override;
-    RelativePathWithMetadata current() const override;
-    RelativePathsWithMetadata currentBatch() const override;
+    bool isValid() override;
+    RelativePathWithMetadata current() override;
+    RelativePathsWithMetadata currentBatch() override;
     size_t getAccumulatedSize() const override;
 
     ~IObjectStorageIteratorAsync() override
@@ -46,6 +45,7 @@ protected:
 
     std::future<BatchAndHasNext> scheduleBatch();
 
+    bool is_initialized{false};
     bool is_finished{false};
 
     mutable std::mutex mutex;
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index d83dc90e6ed..e0a1d8c514e 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -858,6 +858,7 @@ StorageAzureSource::Iterator::Iterator(
     }
     else
     {
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "GLOBS BRANCH");
         const String key_prefix = blob_path_with_globs->substr(0, blob_path_with_globs->find_first_of("*?{"));
 
         /// We don't have to list bucket, because there is no asterisks.
@@ -868,7 +869,11 @@ StorageAzureSource::Iterator::Iterator(
             return;
         }
 
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "KEY PREFIX {}", key_prefix);
         object_storage_iterator = object_storage->iterate(key_prefix);
+
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BLOBS BLOBS{}", *blob_path_with_globs);
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "REGEXP PATTERN {}", makeRegexpPatternFromGlobs(*blob_path_with_globs));
         matcher = std::make_unique<re2::RE2>(makeRegexpPatternFromGlobs(*blob_path_with_globs));
 
         if (!matcher->ok())
@@ -898,27 +903,37 @@ RelativePathWithMetadata StorageAzureSource::Iterator::next()
     }
     else
     {
+        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "GLOBS IN NEXt");
         if (!blobs_with_metadata || index >= blobs_with_metadata->size())
         {
+            LOG_DEBUG(&Poco::Logger::get("DEBUG"), "INITIALIZING BLOBS BATCH");
             RelativePathsWithMetadata new_batch;
             while (new_batch.empty())
             {
                 if (object_storage_iterator->isValid())
                 {
+                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR VALID FETCHING BATCH");
                     new_batch = object_storage_iterator->currentBatch();
+                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BATCH SIZE {}", new_batch.size());
                     object_storage_iterator->nextBatch();
                 }
                 else
                 {
+                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR INVALID");
                     is_finished = true;
                     return {};
                 }
 
-                for (auto it = new_batch.begin(); it != new_batch.end(); ++it)
+                for (auto it = new_batch.begin(); it != new_batch.end();)
                 {
+                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR FILTER {} MATCH {}", it->relative_path, re2::RE2::FullMatch(it->relative_path, *matcher));
                     if (!recursive && !re2::RE2::FullMatch(it->relative_path, *matcher))
                         it = new_batch.erase(it);
+                    else
+                        ++it;
                 }
+
+                LOG_DEBUG(&Poco::Logger::get("DEBUG"), "NEW BATCH AFTER FILTEr {}", new_batch.size());
             }
 
             index.store(0, std::memory_order_relaxed);
@@ -1092,11 +1107,11 @@ String StorageAzureSource::getName() const
 StorageAzureSource::ReaderHolder StorageAzureSource::createReader()
 {
     auto [current_key, info] = file_iterator->next();
+    LOG_DEBUG(log, "KEY {} SIZE {}", current_key, info.size_bytes);
     if (current_key.empty())
         return {};
 
     size_t object_size = info.size_bytes != 0 ? info.size_bytes : object_storage->getObjectMetadata(current_key).size_bytes;
-    LOG_DEBUG(log, "SIZE {}", object_size);
     auto compression_method = chooseCompressionMethod(current_key, compression_hint);
 
     auto read_buf = createAzureReadBuffer(current_key, object_size);
@@ -1134,9 +1149,9 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
     //auto download_buffer_size = getContext()->getSettings().max_download_buffer_size;
     //const bool object_too_small = object_size <= 2 * download_buffer_size;
 
-    // Create a read buffer that will prefetch the first ~1 MB of the file.
-    // When reading lots of tiny files, this prefetching almost doubles the throughput.
-    // For bigger files, parallel reading is more useful.
+    ///// Create a read buffer that will prefetch the first ~1 MB of the file.
+    ///// When reading lots of tiny files, this prefetching almost doubles the throughput.
+    ///// For bigger files, parallel reading is more useful.
     //if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
     //{
     //    LOG_TRACE(log, "Downloading object {} of size {} from S3 with initial prefetch", key, object_size);
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index bcf5d068057..b5cd7cb4566 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -62,6 +62,20 @@ def get_azure_file_content(filename):
     download_stream = blob_client.download_blob()
     return download_stream.readall().decode("utf-8")
 
+def put_azure_file_content(filename, data):
+    container_name = "cont"
+    connection_string = "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;"
+    blob_service_client = BlobServiceClient.from_connection_string(connection_string)
+    try:
+        container_client = blob_service_client.create_container(container_name)
+    except:
+        container_client = blob_service_client.get_container_client(container_name)
+
+    blob_client = container_client.get_blob_client(filename)
+    buf = io.BytesIO(data)
+    blob_client.upload_blob(buf)
+
+
 
 def test_create_table_connection_string(cluster):
     node = cluster.instances["node"]
@@ -223,3 +237,134 @@ def test_create_new_files_on_insert(cluster):
     assert int(result) == 60
 
     azure_query(node, f"drop table test_multiple_inserts")
+
+def test_overwrite(cluster):
+
+    node = cluster.instances["node"]
+
+    azure_query(node, f"create table test_overwrite(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet_overwrite', format='Parquet')")
+    azure_query(node, "truncate table test_overwrite")
+
+    azure_query(node,
+        f"insert into test_overwrite select number, randomString(100) from numbers(50) settings azure_truncate_on_insert=1"
+    )
+    node.query_and_get_error(
+        f"insert into test_overwrite select number, randomString(100) from numbers(100)"
+    )
+    azure_query(node,
+        f"insert into test_overwrite select number, randomString(100) from numbers(200) settings azure_truncate_on_insert=1"
+    )
+
+    result = azure_query(node, f"select count() from test_overwrite")
+    assert int(result) == 200
+
+def test_insert_with_path_with_globs(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, f"create table test_insert_globs(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_insert_with_globs*', format='Parquet')")
+    node.query_and_get_error(
+        f"insert into table function test_insert_globs SELECT number, randomString(100) FROM numbers(500)"
+    )
+
+def test_put_get_with_globs(cluster):
+    # type: (ClickHouseCluster) -> None
+    unique_prefix = random.randint(1, 10000)
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    max_path = ""
+    for i in range(10):
+        for j in range(10):
+            path = "{}/{}_{}/{}.csv".format(
+                unique_prefix, i, random.choice(["a", "b", "c", "d"]), j
+            )
+            max_path = max(path, max_path)
+            values = f"({i},{j},{i + j})"
+
+            azure_query(node, f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')")
+
+            query = f"insert into test_{i}_{j} VALUES {values}"
+            azure_query(node, query)
+
+
+    azure_query(node, f"CREATE TABLE test_glob_select ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV')")
+    query = "select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from test_glob_select"
+    assert azure_query(node, query).splitlines() == [
+        "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
+            bucket='cont', max_path=max_path
+        )
+    ]
+
+def test_azure_glob_scheherazade(cluster):
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    values = "(1, 1, 1)"
+    nights_per_job = 1001 // 30
+    jobs = []
+    for night in range(0, 1001, nights_per_job):
+
+        def add_tales(start, end):
+            for i in range(start, end):
+                path = "night_{}/tale.csv".format(i)
+                unique_num = random.randint(1, 10000)
+                azure_query(node, f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')")
+                query = f"insert into test_{i}_{unique_num} VALUES {values}"
+                azure_query(node, query)
+
+        jobs.append(
+            threading.Thread(
+                target=add_tales, args=(night, min(night + nights_per_job, 1001))
+            )
+        )
+        jobs[-1].start()
+
+    for job in jobs:
+        job.join()
+
+
+    azure_query(node, f"CREATE TABLE test_glob_select_scheherazade ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='night_*/tale.csv', format='CSV')")
+    query = "select count(), sum(column1), sum(column2), sum(column3) from test_glob_select_scheherazade"
+    assert azure_query(node, query).splitlines() == ["1001\t1001\t1001\t1001"]
+
+@pytest.mark.parametrize(
+    "extension,method",
+    [pytest.param("bin", "gzip", id="bin"), pytest.param("gz", "auto", id="gz")],
+)
+def test_storage_azure_get_gzip(cluster, extension, method):
+    node = cluster.instances["node"]
+    filename = f"test_get_gzip.{extension}"
+    name = f"test_get_gzip_{extension}"
+    data = [
+        "Sophia Intrieri,55",
+        "Jack Taylor,71",
+        "Christopher Silva,66",
+        "Clifton Purser,35",
+        "Richard Aceuedo,43",
+        "Lisa Hensley,31",
+        "Alice Wehrley,1",
+        "Mary Farmer,47",
+        "Samara Ramirez,19",
+        "Shirley Lloyd,51",
+        "Santos Cowger,0",
+        "Richard Mundt,88",
+        "Jerry Gonzalez,15",
+        "Angela James,10",
+        "Norman Ortega,33",
+        "",
+    ]
+    azure_query(node, f"DROP TABLE IF EXISTS {name}")
+
+    buf = io.BytesIO()
+    compressed = gzip.GzipFile(fileobj=buf, mode="wb")
+    compressed.write(("\n".join(data)).encode())
+    compressed.close()
+    put_azure_file_content(filename, buf.getvalue())
+
+    azure_query(
+        node,
+        f"""CREATE TABLE {name} (name String, id UInt32) ENGINE = Azure(
+                                azure_conf2, container='cont', blob_path ='{filename}',
+                                format='CSV',
+                                compression='{method}')""",
+    )
+
+    assert azure_query(node, f"SELECT sum(id) FROM {name}").splitlines() == ["565"]
+    azure_query(node, f"DROP TABLE {name}")

From ad2b926248a4fd464f6f278045c9103a75d92ca7 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Tue, 6 Jun 2023 07:17:30 +0000
Subject: [PATCH 0496/1478] Fix jepsen runs in PRs

---
 tests/ci/jepsen_check.py                            | 8 ++------
 tests/jepsen.clickhouse/resources/keeper_config.xml | 8 ++++----
 2 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/tests/ci/jepsen_check.py b/tests/ci/jepsen_check.py
index 9d35d2d6e35..c21fafa2605 100644
--- a/tests/ci/jepsen_check.py
+++ b/tests/ci/jepsen_check.py
@@ -25,6 +25,7 @@ from stopwatch import Stopwatch
 from tee_popen import TeePopen
 from upload_result_helper import upload_results
 from version_helper import get_version_from_repo
+from build_check import get_release_or_pr
 
 JEPSEN_GROUP_NAME = "jepsen_group"
 
@@ -210,12 +211,7 @@ if __name__ == "__main__":
 
     build_name = get_build_name_for_check(check_name)
 
-    if pr_info.number == 0:
-        version = get_version_from_repo()
-        release_or_pr = f"{version.major}.{version.minor}"
-    else:
-        # PR number for anything else
-        release_or_pr = str(pr_info.number)
+    release_or_pr, _ = get_release_or_pr(pr_info, get_version_from_repo())
 
     # This check run separately from other checks because it requires exclusive
     # run (see .github/workflows/jepsen.yml) So we cannot add explicit
diff --git a/tests/jepsen.clickhouse/resources/keeper_config.xml b/tests/jepsen.clickhouse/resources/keeper_config.xml
index 52f2a0dbdc2..1972ef6b917 100644
--- a/tests/jepsen.clickhouse/resources/keeper_config.xml
+++ b/tests/jepsen.clickhouse/resources/keeper_config.xml
@@ -13,19 +13,19 @@
         <disks>
             <log_local>
                 <type>local</type>
-                <path>/var/lib/clickhouse/coordination/logs/</path>
+                <path>/home/robot-clickhouse/db/coordination/logs/</path>
             </log_local>
             <latest_log_local>
                 <type>local</type>
-                <path>/var/lib/clickhouse/coordination/latest_log/</path>
+                <path>/home/robot-clickhouse/db/coordination/latest_log/</path>
             </latest_log_local>
             <snapshot_local>
                 <type>local</type>
-                <path>/var/lib/clickhouse/coordination/snapshots/</path>
+                <path>/home/robot-clickhouse/db/coordination/snapshots/</path>
             </snapshot_local>
             <latest_snapshot_local>
                 <type>local</type>
-                <path>/var/lib/clickhouse/coordination/latest_snapshot/</path>
+                <path>/home/robot-clickhouse/db/coordination/latest_snapshot/</path>
             </latest_snapshot_local>
         </disks>
     </storage_configuration>

From e054fbccd83dd20a5f748b62e3c40002eb95c551 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 6 Jun 2023 13:09:53 +0000
Subject: [PATCH 0497/1478] Automatic style fix

---
 .../test_storage_azure_blob_storage/test.py   | 52 +++++++++++++------
 1 file changed, 37 insertions(+), 15 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 221005e414b..81560fb0da1 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -62,6 +62,7 @@ def get_azure_file_content(filename):
     download_stream = blob_client.download_blob()
     return download_stream.readall().decode("utf-8")
 
+
 def put_azure_file_content(filename, data):
     container_name = "cont"
     connection_string = "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;"
@@ -76,7 +77,6 @@ def put_azure_file_content(filename, data):
     blob_client.upload_blob(buf)
 
 
-
 def test_create_table_connection_string(cluster):
     node = cluster.instances["node"]
     azure_query(
@@ -243,33 +243,43 @@ def test_create_new_files_on_insert(cluster):
 
     azure_query(node, f"drop table test_multiple_inserts")
 
-def test_overwrite(cluster):
 
+def test_overwrite(cluster):
     node = cluster.instances["node"]
 
-    azure_query(node, f"create table test_overwrite(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet_overwrite', format='Parquet')")
+    azure_query(
+        node,
+        f"create table test_overwrite(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet_overwrite', format='Parquet')",
+    )
     azure_query(node, "truncate table test_overwrite")
 
-    azure_query(node,
-        f"insert into test_overwrite select number, randomString(100) from numbers(50) settings azure_truncate_on_insert=1"
+    azure_query(
+        node,
+        f"insert into test_overwrite select number, randomString(100) from numbers(50) settings azure_truncate_on_insert=1",
     )
     node.query_and_get_error(
         f"insert into test_overwrite select number, randomString(100) from numbers(100)"
     )
-    azure_query(node,
-        f"insert into test_overwrite select number, randomString(100) from numbers(200) settings azure_truncate_on_insert=1"
+    azure_query(
+        node,
+        f"insert into test_overwrite select number, randomString(100) from numbers(200) settings azure_truncate_on_insert=1",
     )
 
     result = azure_query(node, f"select count() from test_overwrite")
     assert int(result) == 200
 
+
 def test_insert_with_path_with_globs(cluster):
     node = cluster.instances["node"]
-    azure_query(node, f"create table test_insert_globs(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_insert_with_globs*', format='Parquet')")
+    azure_query(
+        node,
+        f"create table test_insert_globs(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_insert_with_globs*', format='Parquet')",
+    )
     node.query_and_get_error(
         f"insert into table function test_insert_globs SELECT number, randomString(100) FROM numbers(500)"
     )
 
+
 def test_put_get_with_globs(cluster):
     # type: (ClickHouseCluster) -> None
     unique_prefix = random.randint(1, 10000)
@@ -284,20 +294,26 @@ def test_put_get_with_globs(cluster):
             max_path = max(path, max_path)
             values = f"({i},{j},{i + j})"
 
-            azure_query(node, f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')")
+            azure_query(
+                node,
+                f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+            )
 
             query = f"insert into test_{i}_{j} VALUES {values}"
             azure_query(node, query)
 
-
-    azure_query(node, f"CREATE TABLE test_glob_select ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV')")
+    azure_query(
+        node,
+        f"CREATE TABLE test_glob_select ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV')",
+    )
     query = "select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from test_glob_select"
     assert azure_query(node, query).splitlines() == [
         "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
-            bucket='cont', max_path=max_path
+            bucket="cont", max_path=max_path
         )
     ]
 
+
 def test_azure_glob_scheherazade(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
@@ -310,7 +326,10 @@ def test_azure_glob_scheherazade(cluster):
             for i in range(start, end):
                 path = "night_{}/tale.csv".format(i)
                 unique_num = random.randint(1, 10000)
-                azure_query(node, f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')")
+                azure_query(
+                    node,
+                    f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+                )
                 query = f"insert into test_{i}_{unique_num} VALUES {values}"
                 azure_query(node, query)
 
@@ -324,11 +343,14 @@ def test_azure_glob_scheherazade(cluster):
     for job in jobs:
         job.join()
 
-
-    azure_query(node, f"CREATE TABLE test_glob_select_scheherazade ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='night_*/tale.csv', format='CSV')")
+    azure_query(
+        node,
+        f"CREATE TABLE test_glob_select_scheherazade ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='night_*/tale.csv', format='CSV')",
+    )
     query = "select count(), sum(column1), sum(column2), sum(column3) from test_glob_select_scheherazade"
     assert azure_query(node, query).splitlines() == ["1001\t1001\t1001\t1001"]
 
+
 @pytest.mark.parametrize(
     "extension,method",
     [pytest.param("bin", "gzip", id="bin"), pytest.param("gz", "auto", id="gz")],

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 0498/1478] 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 a96c1ea86f1fa662e8e775faeaf4b3a8053c6eb2 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 6 Jun 2023 15:15:51 +0200
Subject: [PATCH 0499/1478] Fix

---
 src/Interpreters/Cache/FileSegment.cpp | 2 +-
 src/Interpreters/Cache/Metadata.cpp    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 1b7fe54a769..7b82c58080c 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -381,7 +381,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
             const auto file_size = fs::file_size(file_segment_path);
             chassert(downloaded_size <= file_size);
             chassert(reserved_size >= file_size);
-            chassert(file_size <= range().right + 1);
+            chassert(file_size <= range().size());
             if (downloaded_size != file_size)
                 downloaded_size = file_size;
         }
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 9dff77e2af8..4794d1b3264 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -370,8 +370,8 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     bool exists = fs::exists(path);
     if (exists)
     {
-        LOG_TEST(log, "Removed file segment at path: {}", path);
         fs::remove(path);
+        LOG_TEST(log, "Removed file segment at path: {}", path);
     }
     else if (file_segment->downloaded_size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist");

From 9ae4d929eacac5ae4681cce91ec2f65b198cf3c9 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Tue, 6 Jun 2023 15:16:18 +0200
Subject: [PATCH 0500/1478] Update
 src/Interpreters/tests/gtest_convertFieldToType.cpp

---
 src/Interpreters/tests/gtest_convertFieldToType.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/tests/gtest_convertFieldToType.cpp b/src/Interpreters/tests/gtest_convertFieldToType.cpp
index 5421c192ac7..f4de36cbecc 100644
--- a/src/Interpreters/tests/gtest_convertFieldToType.cpp
+++ b/src/Interpreters/tests/gtest_convertFieldToType.cpp
@@ -56,7 +56,7 @@ TEST_P(ConvertFieldToTypeTest, convert)
     }
 }
 
-// Basically nuber of seconds in a day, works for UTC here
+// Basically, the number of seconds in a day works for UTC here
 const long long int Day = 24 * 60 * 60;
 
 // 123 is arbitrary value here

From 4ca902ddddc36dbe54b7a6e0f4a7e8185d0b35ca Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:16:56 -0300
Subject: [PATCH 0501/1478] Update
 docs/en/sql-reference/aggregate-functions/index.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/index.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index a3808335168..050142fdd99 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -76,9 +76,12 @@ FROM t_null_big
 Also you can use [Tuple](../data-types/tuple.md) to change NULL skipping behavior.
 
 ```sql
-select groupArray(b), groupArray(tuple(b)).1 from t_null_big;
+SELECT
+    groupArray(y),
+    groupArray(tuple(y)).1
+FROM t_null_big;
 
-┌─groupArray(b)─┬─tupleElement(groupArray(tuple(b)), 1)─┐
+┌─groupArray(y)─┬─tupleElement(groupArray(tuple(y)), 1)─┐
 │ [2,2,3]       │ [2,NULL,2,3,NULL]                     │
 └───────────────┴───────────────────────────────────────┘
 ```

From 5d7b8b3d13502a2eb842dfbfe3b1b704b638badb Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:17:04 -0300
Subject: [PATCH 0502/1478] Update
 docs/en/sql-reference/aggregate-functions/index.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/index.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index 050142fdd99..25f9d05a76c 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -85,6 +85,3 @@ FROM t_null_big;
 │ [2,2,3]       │ [2,NULL,2,3,NULL]                     │
 └───────────────┴───────────────────────────────────────┘
 ```
-
-
-

From 2a9792cebd6e15818a65bd6566cf683bcb623225 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:17:21 -0300
Subject: [PATCH 0503/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmax.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 8a84f361589..5e80131df4c 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -90,7 +90,7 @@ select (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB from test;
 
 select argMax(a, b), max(b) from test where a is Null and b is Null;
 ┌─argMax(a, b)─┬─max(b)─┐
-│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- Nulls are not skipped because only Null values are available
+│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- All aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
 └──────────────┴────────┘
 
 select argMax(a, (b,a)) from test;

From cda9535554fa28c76d11115fdf276c25e0449f04 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:17:46 -0300
Subject: [PATCH 0504/1478] Update
 docs/en/sql-reference/aggregate-functions/index.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index 25f9d05a76c..ea270e83a3c 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -73,7 +73,7 @@ FROM t_null_big
 └────────────────────┴─────────────────────┘
 ```
 
-Also you can use [Tuple](../data-types/tuple.md) to change NULL skipping behavior.
+Also you can use [Tuple](../data-types/tuple.md) to work around NULL skipping behavior. The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value.
 
 ```sql
 SELECT

From 1a517bb332f01da3b5b64dadbb481339b6bdf7ac Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:17:55 -0300
Subject: [PATCH 0505/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmax.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 5e80131df4c..76b9e206abe 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -80,7 +80,7 @@ select argMax(a, b), max(b) from test;
 
 select argMax(tuple(a), b) from test;
 ┌─argMax(tuple(a), b)─┐
-│ (NULL)              │ -- Tuple allows to get Null value.
+│ (NULL)              │ -- The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value
 └─────────────────────┘
 
 select (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB from test;

From 5308abb93a22cf19d10078e533a3b09741a713f7 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:18:13 -0300
Subject: [PATCH 0506/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmin.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 067c81f56cf..304abf512da 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -90,7 +90,7 @@ select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
 
 select argMin(a, b), min(b) from test where a is Null and b is Null;
 ┌─argMin(a, b)─┬─min(b)─┐
-│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- Nulls are not skipped because only Null values are available
+│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- ll aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
 └──────────────┴────────┘
 
 select argMin(a, (b, a)), min(tuple(b, a)) from test;

From f992d10ae7af2cd7d37da65055be4f26fdfa9957 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:18:22 -0300
Subject: [PATCH 0507/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmin.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 304abf512da..816dd9fcac1 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -75,7 +75,7 @@ select * from test;
 
 select argMin(a, b), min(b) from test;
 ┌─argMin(a, b)─┬─min(b)─┐
-│ a            │      0 │ -- argMin = a because it the first not-Null value, min(b) is from another row!
+│ a            │      0 │ -- argMin = a because it the first not Null value, min(b) is from another row!
 └──────────────┴────────┘
 
 select argMin(tuple(a), b) from test;

From 41be2fcbc7bd2227df9c506d2cbde82ded06e690 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:18:34 -0300
Subject: [PATCH 0508/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmin.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 816dd9fcac1..df4b28b070c 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -95,7 +95,7 @@ select argMin(a, b), min(b) from test where a is Null and b is Null;
 
 select argMin(a, (b, a)), min(tuple(b, a)) from test;
 ┌─argMin(a, tuple(b, a))─┬─min(tuple(b, a))─┐
-│ d                      │ (NULL,NULL)      │ -- 'd' is the first Not null value for the min
+│ d                      │ (NULL,NULL)      │ -- 'd' is the first not Null value for the min
 └────────────────────────┴──────────────────┘
 
 select argMin((a, b), (b, a)), min(tuple(b, a)) from test;

From 834918dc1cef6af6eca60d57953a82b982f993aa Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:19:08 -0300
Subject: [PATCH 0509/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmin.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index df4b28b070c..4db656f7e54 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -105,7 +105,7 @@ select argMin((a, b), (b, a)), min(tuple(b, a)) from test;
 
 select argMin(a, tuple(b)) from test;
 ┌─argMax(a, tuple(b))─┐
-│ b                   │ -- Tuple can be used in `Min` to not skip Nulls in `Min`
+│ d                   │ -- Tuple can be used in `min` to not skip rows with Null values as b. 
 └─────────────────────┘
 ```
 

From 9a1f6ac719b0018aa050c0c8ad099bcd65111721 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:20:42 -0300
Subject: [PATCH 0510/1478] Update argmax.md

---
 docs/en/sql-reference/aggregate-functions/reference/argmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 76b9e206abe..91b85bce2ff 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -6,7 +6,7 @@ sidebar_position: 106
 # argMax
 
 Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered. 
-Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not-Null values if not-Null values are available.
+Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not Null values if not Null values are available.
 
 **Syntax**
 

From d6ee50577a5d77887612a74bd43f7bd66a10e666 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:25:32 -0300
Subject: [PATCH 0511/1478] Update argmin.md

---
 .../sql-reference/aggregate-functions/reference/argmin.md   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 4db656f7e54..a5208f11de6 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -6,7 +6,7 @@ sidebar_position: 105
 # argMin
 
 Calculates the `arg` value for a minimum `val` value. If there are several different values of `arg` for minimum values of `val`, returns the first of these values encountered.
-Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not-Null values if not-Null values are available.
+Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not Null values if not Null values are available.
 
 **Syntax**
 
@@ -90,7 +90,7 @@ select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
 
 select argMin(a, b), min(b) from test where a is Null and b is Null;
 ┌─argMin(a, b)─┬─min(b)─┐
-│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- ll aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
+│ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- All aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
 └──────────────┴────────┘
 
 select argMin(a, (b, a)), min(tuple(b, a)) from test;
@@ -100,7 +100,7 @@ select argMin(a, (b, a)), min(tuple(b, a)) from test;
 
 select argMin((a, b), (b, a)), min(tuple(b, a)) from test;
 ┌─argMin(tuple(a, b), tuple(b, a))─┬─min(tuple(b, a))─┐
-│ (NULL,NULL)                      │ (NULL,NULL)      │
+│ (NULL,NULL)                      │ (NULL,NULL)      │ -- argMin returns (NULL,NULL) here because Tuple allows to don't skip Nulls and min(tuple(b, a)) in this case is minimal value for this dataset
 └──────────────────────────────────┴──────────────────┘
 
 select argMin(a, tuple(b)) from test;

From 496bc25bff11c023ecc7f05420889538ff59779e Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:26:35 -0300
Subject: [PATCH 0512/1478] Update
 docs/en/sql-reference/aggregate-functions/reference/argmin.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: János Benjamin Antal <antaljanosbenjamin@users.noreply.github.com>
---
 docs/en/sql-reference/aggregate-functions/reference/argmin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index a5208f11de6..3787c028564 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -80,7 +80,7 @@ select argMin(a, b), min(b) from test;
 
 select argMin(tuple(a), b) from test;
 ┌─argMin(tuple(a), b)─┐
-│ (NULL)              │ -- Tuple allows to get Null value.
+│ (NULL)              │ -- The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value
 └─────────────────────┘
 
 select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;

From e63fc91e73a5d718f3daf6383114978ce93a3b40 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:30:10 -0300
Subject: [PATCH 0513/1478] Update argmax.md

---
 .../aggregate-functions/reference/argmax.md   | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 91b85bce2ff..93e1fac6d67 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -6,7 +6,7 @@ sidebar_position: 106
 # argMax
 
 Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered. 
-Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not Null values if not Null values are available.
+Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
 
 **Syntax**
 
@@ -61,7 +61,7 @@ CREATE TABLE test
 )
 ENGINE = Memory AS
 SELECT *
-FROM values(('a', 1), ('b', 2), ('c', 2), (NULL, 3), (NULL, NULL), ('d', NULL));
+FROM VALUES(('a', 1), ('b', 2), ('c', 2), (NULL, 3), (NULL, NULL), ('d', NULL));
 
 select * from test;
 ┌─a────┬────b─┐
@@ -73,34 +73,34 @@ select * from test;
 │ d    │ ᴺᵁᴸᴸ │
 └──────┴──────┘
 
-select argMax(a, b), max(b) from test;
+SELECT argMax(a, b), max(b) FROM test;
 ┌─argMax(a, b)─┬─max(b)─┐
-│ b            │      3 │ -- argMax = b because it the first not-Null value, max(b) is from another row!
+│ b            │      3 │ -- argMax = 'b' because it the first not Null value, max(b) is from another row!
 └──────────────┴────────┘
 
-select argMax(tuple(a), b) from test;
+SELECT argMax(tuple(a), b) FROM test;
 ┌─argMax(tuple(a), b)─┐
 │ (NULL)              │ -- The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value
 └─────────────────────┘
 
-select (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB from test;
+SELECT (argMax((a, b), b) as t).1 argMaxA, t.2 argMaxB FROM test;
 ┌─argMaxA─┬─argMaxB─┐
 │ ᴺᵁᴸᴸ    │       3 │ -- you can use Tuple and get both (all - tuple(*)) columns for the according max(b)
 └─────────┴─────────┘
 
-select argMax(a, b), max(b) from test where a is Null and b is Null;
+SELECT argMax(a, b), max(b) FROM test WHERE a IS NULL AND b IS NULL;
 ┌─argMax(a, b)─┬─max(b)─┐
 │ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- All aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
 └──────────────┴────────┘
 
-select argMax(a, (b,a)) from test;
+SELECT argMax(a, (b,a)) FROM test;
 ┌─argMax(a, tuple(b, a))─┐
-│ c                      │ -- There are two rows with b=2, Tuple in the `Max` allows to get not the first `arg`
+│ c                      │ -- There are two rows with b=2, `Tuple` in the `Max` allows to get not the first `arg`
 └────────────────────────┘
 
-select argMax(a, tuple(b)) from test;
+SELECT argMax(a, tuple(b)) FROM test;
 ┌─argMax(a, tuple(b))─┐
-│ b                   │ -- Tuple can be used in `Max` to not skip Nulls in `Max`
+│ b                   │ -- `Tuple` can be used in `Max` to not skip Nulls in `Max`
 └─────────────────────┘
 ```
 

From 67a6623a3896b4deae5d69cdf84742da5b24da3b Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:32:10 -0300
Subject: [PATCH 0514/1478] Update argmin.md

---
 .../aggregate-functions/reference/argmin.md   | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 3787c028564..4e549e5b04c 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -6,7 +6,7 @@ sidebar_position: 105
 # argMin
 
 Calculates the `arg` value for a minimum `val` value. If there are several different values of `arg` for minimum values of `val`, returns the first of these values encountered.
-Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not Null values if not Null values are available.
+Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
 
 **Syntax**
 
@@ -61,7 +61,7 @@ CREATE TABLE test
 )
 ENGINE = Memory AS
 SELECT *
-FROM values((NULL, 0), ('a', 1), ('b', 2), ('c', 2), (NULL, NULL), ('d', NULL));
+FROM VALUES((NULL, 0), ('a', 1), ('b', 2), ('c', 2), (NULL, NULL), ('d', NULL));
 
 select * from test;
 ┌─a────┬────b─┐
@@ -73,39 +73,39 @@ select * from test;
 │ d    │ ᴺᵁᴸᴸ │
 └──────┴──────┘
 
-select argMin(a, b), min(b) from test;
+SELECT argMin(a, b), min(b) FROM test;
 ┌─argMin(a, b)─┬─min(b)─┐
-│ a            │      0 │ -- argMin = a because it the first not Null value, min(b) is from another row!
+│ a            │      0 │ -- argMin = a because it the first not `NULL` value, min(b) is from another row!
 └──────────────┴────────┘
 
-select argMin(tuple(a), b) from test;
+SELECT argMin(tuple(a), b) FROM test;
 ┌─argMin(tuple(a), b)─┐
 │ (NULL)              │ -- The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value
 └─────────────────────┘
 
-select (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
+SELECT (argMin((a, b), b) as t).1 argMinA, t.2 argMinB from test;
 ┌─argMinA─┬─argMinB─┐
-│ ᴺᵁᴸᴸ    │       0 │ -- you can use Tuple and get both (all - tuple(*)) columns for the according max(b)
+│ ᴺᵁᴸᴸ    │       0 │ -- you can use `Tuple` and get both (all - tuple(*)) columns for the according max(b)
 └─────────┴─────────┘
 
-select argMin(a, b), min(b) from test where a is Null and b is Null;
+SELECT argMin(a, b), min(b) FROM test WHERE a IS NULL and b IS NULL;
 ┌─argMin(a, b)─┬─min(b)─┐
 │ ᴺᵁᴸᴸ         │   ᴺᵁᴸᴸ │ -- All aggregated rows contains at least one `NULL` value because of the filter, so all rows are skipped, therefore the result will be `NULL`
 └──────────────┴────────┘
 
-select argMin(a, (b, a)), min(tuple(b, a)) from test;
+SELECT argMin(a, (b, a)), min(tuple(b, a)) FROM test;
 ┌─argMin(a, tuple(b, a))─┬─min(tuple(b, a))─┐
-│ d                      │ (NULL,NULL)      │ -- 'd' is the first not Null value for the min
+│ d                      │ (NULL,NULL)      │ -- 'd' is the first not `NULL` value for the min
 └────────────────────────┴──────────────────┘
 
-select argMin((a, b), (b, a)), min(tuple(b, a)) from test;
+SELECT argMin((a, b), (b, a)), min(tuple(b, a)) FROM test;
 ┌─argMin(tuple(a, b), tuple(b, a))─┬─min(tuple(b, a))─┐
-│ (NULL,NULL)                      │ (NULL,NULL)      │ -- argMin returns (NULL,NULL) here because Tuple allows to don't skip Nulls and min(tuple(b, a)) in this case is minimal value for this dataset
+│ (NULL,NULL)                      │ (NULL,NULL)      │ -- argMin returns (NULL,NULL) here because `Tuple` allows to don't skip `NULL` and min(tuple(b, a)) in this case is minimal value for this dataset
 └──────────────────────────────────┴──────────────────┘
 
 select argMin(a, tuple(b)) from test;
 ┌─argMax(a, tuple(b))─┐
-│ d                   │ -- Tuple can be used in `min` to not skip rows with Null values as b. 
+│ d                   │ -- `Tuple` can be used in `min` to not skip rows with `NULL` values as b. 
 └─────────────────────┘
 ```
 

From 68a9ea72dee4ff94ac061544f366ce9a10fc2053 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Tue, 6 Jun 2023 16:10:01 +0200
Subject: [PATCH 0515/1478] Revert "Merge pull request #50307 from
 ZhiguoZh/20230527-toyyyymm"

This reverts commit 17261e52da18a739b59895e9cd97dff3e72b66b8, reversing
changes made to d302eae85efc7f4c1d29993484c7d8b068e1be62.
---
 .../OptimizeDateFilterVisitor.cpp             | 33 ++-------
 ..._date_filter_predicate_optimizer.reference | 69 -------------------
 .../02764_date_filter_predicate_optimizer.sql | 23 -------
 3 files changed, 5 insertions(+), 120 deletions(-)

diff --git a/src/Interpreters/OptimizeDateFilterVisitor.cpp b/src/Interpreters/OptimizeDateFilterVisitor.cpp
index aec2dec19c8..58e1b3335f9 100644
--- a/src/Interpreters/OptimizeDateFilterVisitor.cpp
+++ b/src/Interpreters/OptimizeDateFilterVisitor.cpp
@@ -10,37 +10,14 @@
 namespace DB
 {
 
-ASTPtr generateOptimizedDateFilterAST(const String & comparator, const String & converter, const String & column, UInt64 compare_to)
+ASTPtr generateOptimizedDateFilterAST(const String & comparator, const String & converter, const String & column, UInt64 year)
 {
     const DateLUTImpl & date_lut = DateLUT::instance();
 
-    String start_date;
-    String end_date;
+    if (converter != "toYear") return {};
 
-    if (converter == "toYear")
-    {
-        UInt64 year = compare_to;
-        start_date = date_lut.dateToString(date_lut.makeDayNum(year, 1, 1));
-        end_date = date_lut.dateToString(date_lut.makeDayNum(year, 12, 31));
-    }
-    else if (converter == "toYYYYMM")
-    {
-        UInt64 year = compare_to / 100;
-        UInt64 month = compare_to % 100;
-
-        if (month == 0 || month > 12) return {};
-
-        static constexpr UInt8 days_of_month[] = {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};
-
-        bool leap_year = (year & 3) == 0 && (year % 100 || (year % 400 == 0 && year));
-
-        start_date = date_lut.dateToString(date_lut.makeDayNum(year, month, 1));
-        end_date = date_lut.dateToString(date_lut.makeDayNum(year, month, days_of_month[month - 1] + (leap_year && month == 2)));
-    }
-    else
-    {
-        return {};
-    }
+    String start_date = date_lut.dateToString(date_lut.makeDayNum(year, 1, 1));
+    String end_date = date_lut.dateToString(date_lut.makeDayNum(year, 12, 31));
 
     if (comparator == "equals")
     {
@@ -105,7 +82,7 @@ bool rewritePredicateInPlace(ASTFunction & function, ASTPtr & ast)
     {
         if (const auto * func = function.arguments->children[i]->as<ASTFunction>(); func)
         {
-            if (func->name == "toYear" || func->name == "toYYYYMM")
+            if (func->name == "toYear")
             {
                 func_id = i;
             }
diff --git a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
index 54704fb3b3e..e5c608ddc1a 100644
--- a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
+++ b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
@@ -37,72 +37,3 @@ WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')) AND ((id >= 1) A
 SELECT value1
 FROM t
 WHERE ((id >= 1) AND (id <= 3)) AND ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\'))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1900-02-01\') AND (date1 <= \'1900-02-28\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1992-02-01\') AND (date1 <= \'1992-02-29\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'2000-02-01\') AND (date1 <= \'2000-02-29\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (toYYYYMM(date1) = 199300) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-01-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-02-01\') AND (date1 <= \'1993-02-28\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-03-01\') AND (date1 <= \'1993-03-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-04-01\') AND (date1 <= \'1993-04-30\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-05-01\') AND (date1 <= \'1993-05-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-06-01\') AND (date1 <= \'1993-06-30\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-07-01\') AND (date1 <= \'1993-07-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-08-01\') AND (date1 <= \'1993-08-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-09-01\') AND (date1 <= \'1993-09-30\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-10-01\') AND (date1 <= \'1993-10-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-11-01\') AND (date1 <= \'1993-11-30\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-12-01\') AND (date1 <= \'1993-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (toYYYYMM(date1) = 199313) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 < \'1992-03-01\') OR (date1 > \'1992-03-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 < \'1992-03-01\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 > \'1992-03-31\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 <= \'1992-03-31\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 >= \'1992-03-01\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1992-03-01\') OR ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\'))) AND ((id >= 1) AND (id <= 3))
diff --git a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql
index a04273bbb18..563468d4f82 100644
--- a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql
+++ b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql
@@ -13,28 +13,5 @@ EXPLAIN SYNTAX SELECT value1, toYear(date1) as year1 FROM t WHERE year1 = 1993 A
 EXPLAIN SYNTAX SELECT value1 FROM t WHERE 1993 > toYear(date1) AND id BETWEEN 1 AND 3;
 EXPLAIN SYNTAX SELECT value1 FROM t PREWHERE toYear(date1) = 1993 WHERE id BETWEEN 1 AND 3;
 EXPLAIN SYNTAX SELECT value1 FROM t WHERE id BETWEEN 1 AND 3 HAVING toYear(date1) = 1993;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 190002 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199202 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 200002 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199300 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199301 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199302 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199303 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199304 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199305 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199306 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199307 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199308 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199309 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199310 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199311 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199312 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) = 199313 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) <> 199203 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) < 199203 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) > 199203 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) <= 199203 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYYYYMM(date1) >= 199203 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE (toYYYYMM(date1) >= 199203 OR toYear(date1) = 1993) AND id BETWEEN 1 AND 3;
 
 DROP TABLE t;

From 8d2b8683125b3ba1e2ccddff078c3af9820a19af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Tue, 6 Jun 2023 16:10:22 +0200
Subject: [PATCH 0516/1478] Revert "Merge pull request #50062 from
 ZhiguoZh/20230511-toyear"

This reverts commit 55c2dbcc2d1068dae78e7be0929b193edb23d75c, reversing
changes made to 23f894b995feb4d0045ba24593bd457e39b7d11d.
---
 .../OptimizeDateFilterVisitor.cpp             | 121 ------------------
 src/Interpreters/OptimizeDateFilterVisitor.h  |  20 ---
 src/Interpreters/TreeOptimizer.cpp            |  19 ---
 ..._date_filter_predicate_optimizer.reference |  39 ------
 .../02764_date_filter_predicate_optimizer.sql |  17 ---
 5 files changed, 216 deletions(-)
 delete mode 100644 src/Interpreters/OptimizeDateFilterVisitor.cpp
 delete mode 100644 src/Interpreters/OptimizeDateFilterVisitor.h
 delete mode 100644 tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
 delete mode 100644 tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql

diff --git a/src/Interpreters/OptimizeDateFilterVisitor.cpp b/src/Interpreters/OptimizeDateFilterVisitor.cpp
deleted file mode 100644
index 58e1b3335f9..00000000000
--- a/src/Interpreters/OptimizeDateFilterVisitor.cpp
+++ /dev/null
@@ -1,121 +0,0 @@
-#include <Interpreters/OptimizeDateFilterVisitor.h>
-
-#include <Common/DateLUT.h>
-#include <Common/DateLUTImpl.h>
-#include <Parsers/ASTIdentifier.h>
-#include <Parsers/ASTLiteral.h>
-#include <Parsers/ASTFunction.h>
-
-
-namespace DB
-{
-
-ASTPtr generateOptimizedDateFilterAST(const String & comparator, const String & converter, const String & column, UInt64 year)
-{
-    const DateLUTImpl & date_lut = DateLUT::instance();
-
-    if (converter != "toYear") return {};
-
-    String start_date = date_lut.dateToString(date_lut.makeDayNum(year, 1, 1));
-    String end_date = date_lut.dateToString(date_lut.makeDayNum(year, 12, 31));
-
-    if (comparator == "equals")
-    {
-        return makeASTFunction("and",
-                                makeASTFunction("greaterOrEquals",
-                                            std::make_shared<ASTIdentifier>(column),
-                                            std::make_shared<ASTLiteral>(start_date)
-                                            ),
-                                makeASTFunction("lessOrEquals",
-                                            std::make_shared<ASTIdentifier>(column),
-                                            std::make_shared<ASTLiteral>(end_date)
-                                            )
-                                );
-    }
-    else if (comparator == "notEquals")
-    {
-        return makeASTFunction("or",
-                                makeASTFunction("less",
-                                            std::make_shared<ASTIdentifier>(column),
-                                            std::make_shared<ASTLiteral>(start_date)
-                                            ),
-                                makeASTFunction("greater",
-                                            std::make_shared<ASTIdentifier>(column),
-                                            std::make_shared<ASTLiteral>(end_date)
-                                            )
-                                );
-    }
-    else if (comparator == "less" || comparator == "greaterOrEquals")
-    {
-        return makeASTFunction(comparator,
-                    std::make_shared<ASTIdentifier>(column),
-                    std::make_shared<ASTLiteral>(start_date)
-                    );
-    }
-    else
-    {
-        return makeASTFunction(comparator,
-                    std::make_shared<ASTIdentifier>(column),
-                    std::make_shared<ASTLiteral>(end_date)
-                    );
-    }
-}
-
-bool rewritePredicateInPlace(ASTFunction & function, ASTPtr & ast)
-{
-    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 false;
-
-    if (!function.arguments || function.arguments->children.size() != 2) return false;
-
-    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)
-        {
-            if (func->name == "toYear")
-            {
-                func_id = i;
-            }
-        }
-    }
-
-    if (func_id == function.arguments->children.size()) return false;
-
-    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 false;
-
-    UInt64 compare_to = literal->value.get<UInt64>();
-    String comparator = literal_id > func_id ? function.name : swap_relations.at(function.name);
-
-    const auto * func = function.arguments->children[func_id]->as<ASTFunction>();
-    const auto * column_id = func->arguments->children.at(0)->as<ASTIdentifier>();
-
-    if (!column_id) return false;
-
-    String column = column_id->name();
-
-    const auto new_ast = generateOptimizedDateFilterAST(comparator, func->name, column, compare_to);
-
-    if (!new_ast) return false;
-
-    ast = new_ast;
-    return true;
-}
-
-void OptimizeDateFilterInPlaceData::visit(ASTFunction & function, ASTPtr & ast) const
-{
-    rewritePredicateInPlace(function, ast);
-}
-}
diff --git a/src/Interpreters/OptimizeDateFilterVisitor.h b/src/Interpreters/OptimizeDateFilterVisitor.h
deleted file mode 100644
index 84394372901..00000000000
--- a/src/Interpreters/OptimizeDateFilterVisitor.h
+++ /dev/null
@@ -1,20 +0,0 @@
-#pragma once
-
-#include <Interpreters/InDepthNodeVisitor.h>
-
-namespace DB
-{
-
-class ASTFunction;
-
-/// Rewrite the predicates in place
-class OptimizeDateFilterInPlaceData
-{
-public:
-    using TypeToVisit = ASTFunction;
-    void visit(ASTFunction & function, ASTPtr & ast) const;
-};
-
-using OptimizeDateFilterInPlaceMatcher = OneTypeMatcher<OptimizeDateFilterInPlaceData>;
-using OptimizeDateFilterInPlaceVisitor = InDepthNodeVisitor<OptimizeDateFilterInPlaceMatcher, true>;
-}
diff --git a/src/Interpreters/TreeOptimizer.cpp b/src/Interpreters/TreeOptimizer.cpp
index 825114b20b7..c38b3c79026 100644
--- a/src/Interpreters/TreeOptimizer.cpp
+++ b/src/Interpreters/TreeOptimizer.cpp
@@ -25,7 +25,6 @@
 #include <Interpreters/GatherFunctionQuantileVisitor.h>
 #include <Interpreters/RewriteSumIfFunctionVisitor.h>
 #include <Interpreters/RewriteArrayExistsFunctionVisitor.h>
-#include <Interpreters/OptimizeDateFilterVisitor.h>
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -678,21 +677,6 @@ void optimizeInjectiveFunctionsInsideUniq(ASTPtr & query, ContextPtr context)
     RemoveInjectiveFunctionsVisitor(data).visit(query);
 }
 
-void optimizeDateFilters(ASTSelectQuery * select_query)
-{
-    /// Predicates in HAVING clause has been moved to WHERE clause.
-    if (select_query->where())
-    {
-        OptimizeDateFilterInPlaceVisitor::Data data;
-        OptimizeDateFilterInPlaceVisitor(data).visit(select_query->refWhere());
-    }
-    if (select_query->prewhere())
-    {
-        OptimizeDateFilterInPlaceVisitor::Data data;
-        OptimizeDateFilterInPlaceVisitor(data).visit(select_query->refPrewhere());
-    }
-}
-
 void transformIfStringsIntoEnum(ASTPtr & query)
 {
     std::unordered_set<String> function_names = {"if", "transform"};
@@ -796,9 +780,6 @@ 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, toISOWeek, etc.
-    optimizeDateFilters(select_query);
-
     /// GROUP BY injective function elimination.
     optimizeGroupBy(select_query, context);
 
diff --git a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
deleted file mode 100644
index e5c608ddc1a..00000000000
--- a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.reference
+++ /dev/null
@@ -1,39 +0,0 @@
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 < \'1993-01-01\') OR (date1 > \'1993-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 < \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 > \'1993-12-31\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 <= \'1993-12-31\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 >= \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1997-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')) OR ((date1 >= \'1994-01-01\') AND (date1 <= \'1994-12-31\'))) AND ((id >= 1) AND (id <= 3))
-SELECT
-    value1,
-    toYear(date1) AS year1
-FROM t
-WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE (date1 < \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-PREWHERE (date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')
-WHERE ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\')) AND ((id >= 1) AND (id <= 3))
-SELECT value1
-FROM t
-WHERE ((id >= 1) AND (id <= 3)) AND ((date1 >= \'1993-01-01\') AND (date1 <= \'1993-12-31\'))
diff --git a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql b/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql
deleted file mode 100644
index 563468d4f82..00000000000
--- a/tests/queries/0_stateless/02764_date_filter_predicate_optimizer.sql
+++ /dev/null
@@ -1,17 +0,0 @@
-DROP TABLE IF EXISTS t;
-CREATE TABLE t (id UInt32, value1 String, date1 Date) ENGINE ReplacingMergeTree() ORDER BY id;
-
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) = 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) <> 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) < 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) > 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) <= 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) >= 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE toYear(date1) BETWEEN 1993 AND 1997 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE (toYear(date1) = 1993 OR toYear(date1) = 1994) AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1, toYear(date1) as year1 FROM t WHERE year1 = 1993 AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE 1993 > toYear(date1) AND id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t PREWHERE toYear(date1) = 1993 WHERE id BETWEEN 1 AND 3;
-EXPLAIN SYNTAX SELECT value1 FROM t WHERE id BETWEEN 1 AND 3 HAVING toYear(date1) = 1993;
-
-DROP TABLE t;

From 1910d6580e6a6cd7ad985976ed08885b3b091219 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Tue, 6 Jun 2023 16:13:51 +0200
Subject: [PATCH 0517/1478] Add test for the reverted broken optimizations

---
 .../02783_date_predicate_optimizations.reference    |  2 ++
 .../02783_date_predicate_optimizations.sql          | 13 +++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 tests/queries/0_stateless/02783_date_predicate_optimizations.reference
 create mode 100644 tests/queries/0_stateless/02783_date_predicate_optimizations.sql

diff --git a/tests/queries/0_stateless/02783_date_predicate_optimizations.reference b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
new file mode 100644
index 00000000000..cd689b93034
--- /dev/null
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
@@ -0,0 +1,2 @@
+2021-12-31 23:00:00	0
+2021-12-31 23:00:00	0
diff --git a/tests/queries/0_stateless/02783_date_predicate_optimizations.sql b/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
new file mode 100644
index 00000000000..abb13f1005e
--- /dev/null
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
@@ -0,0 +1,13 @@
+CREATE TABLE source
+(
+    `ts` DateTime('UTC'),
+    `n` Int32
+)
+ENGINE = MergeTree
+PARTITION BY toYYYYMM(ts)
+ORDER BY tuple();
+
+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;

From 88f2f4f5fc9a0a8b400d74064c44997b2304d27c Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 16:16:49 +0200
Subject: [PATCH 0518/1478] Added createAsyncAzureReadBuffer

---
 .../AzureBlobStorage/AzureObjectStorage.h     |  2 +
 src/Storages/StorageAzure.cpp                 | 89 ++++++++++++-------
 src/Storages/StorageAzure.h                   |  2 +
 3 files changed, 63 insertions(+), 30 deletions(-)

diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index b3cda54e752..f5918f9d598 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -127,6 +127,8 @@ public:
 
     bool isRemote() const override { return true; }
 
+    MultiVersion<Azure::Storage::Blobs::BlobContainerClient> getClient() { return client; }
+
 private:
     const String name;
     /// client used to access the files in the Blob Storage cloud
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index e0a1d8c514e..95d3ae95a76 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -40,6 +40,9 @@
 #include <QueryPipeline/QueryPipelineBuilder.h>
 #include <QueryPipeline/Pipe.h>
 
+#include <Disks/IO/ReadBufferFromAzureBlobStorage.h>
+#include <Disks/IO/WriteBufferFromAzureBlobStorage.h>
+
 
 using namespace Azure::Storage::Blobs;
 
@@ -154,11 +157,6 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
     configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
     configuration.blob_path = checkAndGetLiteralArgument<String>(engine_args[2], "blobpath");
 
-    LOG_INFO(&Poco::Logger::get("StorageAzure"), "connection_url  = {}", configuration.connection_url);
-    LOG_INFO(&Poco::Logger::get("StorageAzure"), "container  = {}", configuration.container);
-    LOG_INFO(&Poco::Logger::get("StorageAzure"), "blobpath  = {}", configuration.blob_path);
-
-
     auto is_format_arg = [] (const std::string & s) -> bool
     {
         return s == "auto" || FormatFactory::instance().getAllFormats().contains(s);
@@ -230,8 +228,6 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 
     configuration.blobs_paths = {configuration.blob_path};
 
-    LOG_INFO(&Poco::Logger::get("StorageAzure"), "get_format_from_file  = {}", get_format_from_file);
-
     if (configuration.format == "auto" && get_format_from_file)
         configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
 
@@ -310,7 +306,6 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
 
     if (configuration.is_connection_string)
     {
-        LOG_INFO(&Poco::Logger::get("StorageAzure"), "createClient is_connection_string ");
         result = std::make_unique<BlobContainerClient>(BlobContainerClient::CreateFromConnectionString(configuration.connection_url, configuration.container));
         result->CreateIfNotExists();
     }
@@ -416,18 +411,6 @@ StorageAzure::StorageAzure(
     for (const auto & key : configuration.blobs_paths)
         objects.emplace_back(key);
 
-    for (auto obj : objects)
-    {
-        LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor obj.remote_paths  = {}", obj.remote_path);
-        if (object_storage->exists(obj))
-        {
-            LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor exists  obj.remote_paths  = {}", obj.remote_path);
-//            auto read_buffer = object_storage->readObject(obj);
-//            LOG_INFO(&Poco::Logger::get("StorageAzure"), "constructor read size  obj.remote_paths  = {} , size = {}", obj.remote_path, read_buffer->getFileSize());
-        }
-    }
-
-
     auto default_virtuals = NamesAndTypesList{
         {"_path", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())},
         {"_file", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())}};
@@ -1146,22 +1129,68 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
 {
     auto read_settings = getContext()->getReadSettings().adjustBufferSize(object_size);
     read_settings.enable_filesystem_cache = false;
-    //auto download_buffer_size = getContext()->getSettings().max_download_buffer_size;
-    //const bool object_too_small = object_size <= 2 * download_buffer_size;
+    auto download_buffer_size = getContext()->getSettings().max_download_buffer_size;
+    const bool object_too_small = object_size <= 2 * download_buffer_size;
 
-    ///// Create a read buffer that will prefetch the first ~1 MB of the file.
-    ///// When reading lots of tiny files, this prefetching almost doubles the throughput.
-    ///// For bigger files, parallel reading is more useful.
-    //if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
-    //{
-    //    LOG_TRACE(log, "Downloading object {} of size {} from S3 with initial prefetch", key, object_size);
-    //    return object_storage->readObjects({StoredObject(key)}, read_settings, {}, object_size);
-    //}
+    // Create a read buffer that will prefetch the first ~1 MB of the file.
+    // When reading lots of tiny files, this prefetching almost doubles the throughput.
+    // For bigger files, parallel reading is more useful.
+    if (object_too_small && read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
+    {
+        LOG_TRACE(log, "Downloading object of size {} from Azure with initial prefetch", object_size);
+        return createAsyncAzureReadBuffer(key, read_settings, object_size);
+    }
 
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }
 
 
+std::unique_ptr<ReadBuffer> StorageAzureSource::createAsyncAzureReadBuffer(
+    const String & key, const ReadSettings & read_settings, size_t object_size)
+{
+    auto context = getContext();
+
+    const auto & context_settings = context->getSettingsRef();
+    auto max_single_part_upload_size = context_settings.azure_max_single_part_upload_size;
+    auto max_single_read_retries = context_settings.azure_max_single_read_retries;
+
+    auto read_buffer_creator =
+        [this, read_settings, max_single_part_upload_size, max_single_read_retries]
+        (const std::string & path, size_t read_until_position) -> std::unique_ptr<ReadBufferFromFileBase>
+    {
+        return std::make_unique<ReadBufferFromAzureBlobStorage>(
+            object_storage->getClient().get(),
+            path,
+            read_settings,
+            max_single_part_upload_size,
+            max_single_read_retries,
+            /* use_external_buffer */true,
+            read_until_position);
+    };
+
+    auto azure_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
+        std::move(read_buffer_creator),
+        StoredObjects{StoredObject{key, object_size}},
+        read_settings,
+        /* cache_log */nullptr);
+
+    auto modified_settings{read_settings};
+    /// FIXME: Changing this setting to default value breaks something around parquet reading
+    modified_settings.remote_read_min_bytes_for_seek = modified_settings.remote_fs_buffer_size;
+
+    auto & pool_reader = context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
+
+    auto async_reader = std::make_unique<AsynchronousBoundedReadBuffer>(
+        std::move(azure_impl), pool_reader, modified_settings,
+        context->getAsyncReadCounters(), context->getFilesystemReadPrefetchesLog());
+
+    async_reader->setReadUntilEnd();
+    if (read_settings.remote_fs_prefetch)
+        async_reader->prefetch(DEFAULT_PREFETCH_PRIORITY);
+
+    return async_reader;
+}
+
 }
 
 #endif
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index f114184c336..cf3ed5e2596 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -274,6 +274,8 @@ private:
     std::future<ReaderHolder> createReaderAsync();
 
     std::unique_ptr<ReadBuffer> createAzureReadBuffer(const String & key, size_t object_size);
+    std::unique_ptr<ReadBuffer> createAsyncAzureReadBuffer(
+        const String & key, const ReadSettings & read_settings, size_t object_size);
 };
 
 }

From 75d0f9fc97f284a47eb8b4e8b03c3089631c46d4 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 16:32:05 +0200
Subject: [PATCH 0519/1478] Updated to use readObjects for async

---
 src/Storages/StorageAzure.cpp | 34 +---------------------------------
 1 file changed, 1 insertion(+), 33 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 95d3ae95a76..c98430858eb 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -1148,41 +1148,9 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
 std::unique_ptr<ReadBuffer> StorageAzureSource::createAsyncAzureReadBuffer(
     const String & key, const ReadSettings & read_settings, size_t object_size)
 {
-    auto context = getContext();
-
-    const auto & context_settings = context->getSettingsRef();
-    auto max_single_part_upload_size = context_settings.azure_max_single_part_upload_size;
-    auto max_single_read_retries = context_settings.azure_max_single_read_retries;
-
-    auto read_buffer_creator =
-        [this, read_settings, max_single_part_upload_size, max_single_read_retries]
-        (const std::string & path, size_t read_until_position) -> std::unique_ptr<ReadBufferFromFileBase>
-    {
-        return std::make_unique<ReadBufferFromAzureBlobStorage>(
-            object_storage->getClient().get(),
-            path,
-            read_settings,
-            max_single_part_upload_size,
-            max_single_read_retries,
-            /* use_external_buffer */true,
-            read_until_position);
-    };
-
-    auto azure_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator),
-        StoredObjects{StoredObject{key, object_size}},
-        read_settings,
-        /* cache_log */nullptr);
-
     auto modified_settings{read_settings};
-    /// FIXME: Changing this setting to default value breaks something around parquet reading
     modified_settings.remote_read_min_bytes_for_seek = modified_settings.remote_fs_buffer_size;
-
-    auto & pool_reader = context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-
-    auto async_reader = std::make_unique<AsynchronousBoundedReadBuffer>(
-        std::move(azure_impl), pool_reader, modified_settings,
-        context->getAsyncReadCounters(), context->getFilesystemReadPrefetchesLog());
+    auto async_reader = object_storage->readObjects(StoredObjects{StoredObject{key, object_size}}, modified_settings);
 
     async_reader->setReadUntilEnd();
     if (read_settings.remote_fs_prefetch)

From cbe4ea67aec5f285e3cb3fd905917679041ced0a Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 16:42:56 +0200
Subject: [PATCH 0520/1478] Removed unwanted code & debug lines

---
 .../ObjectStorages/AzureBlobStorage/AzureObjectStorage.h      | 2 --
 src/TableFunctions/TableFunctionS3.cpp                        | 4 ----
 2 files changed, 6 deletions(-)

diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index f5918f9d598..b3cda54e752 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -127,8 +127,6 @@ public:
 
     bool isRemote() const override { return true; }
 
-    MultiVersion<Azure::Storage::Blobs::BlobContainerClient> getClient() { return client; }
-
 private:
     const String name;
     /// client used to access the files in the Blob Storage cloud
diff --git a/src/TableFunctions/TableFunctionS3.cpp b/src/TableFunctions/TableFunctionS3.cpp
index 7f283afd6b4..e63f32b1cbc 100644
--- a/src/TableFunctions/TableFunctionS3.cpp
+++ b/src/TableFunctions/TableFunctionS3.cpp
@@ -294,8 +294,6 @@ void TableFunctionS3::addColumnsStructureToArguments(ASTs & args, const String &
 
 ColumnsDescription TableFunctionS3::getActualTableStructure(ContextPtr context) const
 {
-    LOG_INFO(&Poco::Logger::get("TableFunctionS3"), "getActualTableStructure    configuration.structure = {}  ",configuration.structure);
-
     if (configuration.structure == "auto")
     {
         context->checkAccess(getSourceAccessType());
@@ -321,8 +319,6 @@ StoragePtr TableFunctionS3::executeImpl(const ASTPtr & /*ast_function*/, Context
     else if (!structure_hint.empty())
         columns = structure_hint;
 
-    LOG_INFO(&Poco::Logger::get("TableFunctionS3"), "executeImpl structre  = {}  structure_hint = {} ",configuration.structure, structure_hint.getAll().toString());
-
 
     StoragePtr storage = std::make_shared<StorageS3>(
         configuration,

From ebae79f7d410dd67879e041d2db4395d852bcae3 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 16:57:51 +0200
Subject: [PATCH 0521/1478] Schema inference

---
 src/Core/Settings.h                           |   1 +
 src/Storages/StorageAzure.cpp                 | 145 ++++++++++++++++--
 src/Storages/StorageAzure.h                   |  28 ++--
 .../test_storage_azure_blob_storage/test.py   |  48 ++++++
 4 files changed, 200 insertions(+), 22 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index a484e8e816d..b95dc9a26b3 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -710,6 +710,7 @@ class IColumn;
     \
     M(Bool, schema_inference_use_cache_for_file, true, "Use cache in schema inference while using file table function", 0) \
     M(Bool, schema_inference_use_cache_for_s3, true, "Use cache in schema inference while using s3 table function", 0) \
+    M(Bool, schema_inference_use_cache_for_azure, true, "Use cache in schema inference while using azure table function", 0) \
     M(Bool, schema_inference_use_cache_for_hdfs, true, "Use cache in schema inference while using hdfs table function", 0) \
     M(Bool, schema_inference_use_cache_for_url, true, "Use cache in schema inference while using url table function", 0) \
     M(Bool, schema_inference_cache_require_modification_time_for_url, true, "Use schema from cache for URL with last modification time validation (for urls with Last-Modified header)", 0) \
diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index e0a1d8c514e..4c47fe318c6 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -58,6 +58,7 @@ namespace ErrorCodes
     extern const int BAD_ARGUMENTS;
     extern const int DATABASE_ACCESS_DENIED;
     extern const int CANNOT_COMPILE_REGEXP;
+    extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
 }
 
 namespace
@@ -403,7 +404,8 @@ StorageAzure::StorageAzure(
     StorageInMemoryMetadata storage_metadata;
     if (columns_.empty())
     {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Schema inference is not supported yet");
+        auto columns = getTableStructureFromDataImpl(context);
+        storage_metadata.setColumns(columns);
     }
     else
         storage_metadata.setColumns(columns_);
@@ -624,13 +626,13 @@ Pipe StorageAzure::read(
         /// Iterate through disclosed globs and make a source for each file
         iterator_wrapper = std::make_shared<StorageAzureSource::Iterator>(
             object_storage.get(), configuration.container, std::nullopt,
-            configuration.blob_path, query_info.query, virtual_block, local_context);
+            configuration.blob_path, query_info.query, virtual_block, local_context, nullptr);
     }
     else
     {
         iterator_wrapper = std::make_shared<StorageAzureSource::Iterator>(
             object_storage.get(), configuration.container, configuration.blobs_paths,
-            std::nullopt, query_info.query, virtual_block, local_context);
+            std::nullopt, query_info.query, virtual_block, local_context, nullptr);
     }
 
     ColumnsDescription columns_description;
@@ -800,7 +802,8 @@ StorageAzureSource::Iterator::Iterator(
     std::optional<String> blob_path_with_globs_,
     ASTPtr query_,
     const Block & virtual_header_,
-    ContextPtr context_)
+    ContextPtr context_,
+    RelativePathsWithMetadata * outer_blobs_)
     : WithContext(context_)
     , object_storage(object_storage_)
     , container(container_)
@@ -808,6 +811,7 @@ StorageAzureSource::Iterator::Iterator(
     , blob_path_with_globs(blob_path_with_globs_)
     , query(query_)
     , virtual_header(virtual_header_)
+    , outer_blobs(outer_blobs_)
 {
     if (keys.has_value() && blob_path_with_globs.has_value())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot specify keys and glob simulatenously it's a bug");
@@ -854,6 +858,8 @@ StorageAzureSource::Iterator::Iterator(
             ObjectMetadata object_metadata = object_storage->getObjectMetadata(key);
             total_size += object_metadata.size_bytes;
             blobs_with_metadata->emplace_back(RelativePathWithMetadata{key, object_metadata});
+            if (outer_blobs)
+                outer_blobs->emplace_back(blobs_with_metadata->back());
         }
     }
     else
@@ -866,6 +872,8 @@ StorageAzureSource::Iterator::Iterator(
         {
             ObjectMetadata object_metadata = object_storage->getObjectMetadata(*blob_path_with_globs);
             blobs_with_metadata->emplace_back(*blob_path_with_globs, object_metadata);
+            if (outer_blobs)
+                outer_blobs->emplace_back(blobs_with_metadata->back());
             return;
         }
 
@@ -903,37 +911,29 @@ RelativePathWithMetadata StorageAzureSource::Iterator::next()
     }
     else
     {
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "GLOBS IN NEXt");
         if (!blobs_with_metadata || index >= blobs_with_metadata->size())
         {
-            LOG_DEBUG(&Poco::Logger::get("DEBUG"), "INITIALIZING BLOBS BATCH");
             RelativePathsWithMetadata new_batch;
             while (new_batch.empty())
             {
                 if (object_storage_iterator->isValid())
                 {
-                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR VALID FETCHING BATCH");
                     new_batch = object_storage_iterator->currentBatch();
-                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BATCH SIZE {}", new_batch.size());
                     object_storage_iterator->nextBatch();
                 }
                 else
                 {
-                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR INVALID");
                     is_finished = true;
                     return {};
                 }
 
                 for (auto it = new_batch.begin(); it != new_batch.end();)
                 {
-                    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITERATOR FILTER {} MATCH {}", it->relative_path, re2::RE2::FullMatch(it->relative_path, *matcher));
                     if (!recursive && !re2::RE2::FullMatch(it->relative_path, *matcher))
                         it = new_batch.erase(it);
                     else
                         ++it;
                 }
-
-                LOG_DEBUG(&Poco::Logger::get("DEBUG"), "NEW BATCH AFTER FILTEr {}", new_batch.size());
             }
 
             index.store(0, std::memory_order_relaxed);
@@ -958,10 +958,15 @@ RelativePathWithMetadata StorageAzureSource::Iterator::next()
                 {
                     total_size.fetch_add(new_batch[idx].metadata.size_bytes, std::memory_order_relaxed);
                     blobs_with_metadata->emplace_back(std::move(new_batch[idx]));
+                    if (outer_blobs)
+                        outer_blobs->emplace_back(blobs_with_metadata->back());
                 }
             }
             else
             {
+                if (outer_blobs)
+                    outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
+
                 blobs_with_metadata = std::move(new_batch);
                 for (const auto & [_, info] : *blobs_with_metadata)
                     total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
@@ -1161,6 +1166,122 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }
 
+ColumnsDescription StorageAzure::getTableStructureFromDataImpl(ContextPtr ctx)
+{
+    RelativePathsWithMetadata read_keys;
+    std::shared_ptr<StorageAzureSource::Iterator> file_iterator;
+    if (configuration.withGlobs())
+    {
+        file_iterator = std::make_shared<StorageAzureSource::Iterator>(
+            object_storage.get(), configuration.container, std::nullopt,
+            configuration.blob_path, nullptr, virtual_block, ctx, &read_keys);
+    }
+    else
+    {
+        file_iterator = std::make_shared<StorageAzureSource::Iterator>(
+            object_storage.get(), configuration.container, configuration.blobs_paths,
+            std::nullopt, nullptr, virtual_block, ctx, &read_keys);
+    }
+
+    std::optional<ColumnsDescription> columns_from_cache;
+    size_t prev_read_keys_size = read_keys.size();
+    if (ctx->getSettingsRef().schema_inference_use_cache_for_azure)
+        columns_from_cache = tryGetColumnsFromCache(read_keys.begin(), read_keys.end(), ctx);
+
+    ReadBufferIterator read_buffer_iterator = [&, first = true](ColumnsDescription & cached_columns) mutable -> std::unique_ptr<ReadBuffer>
+    {
+        auto [key, metadata] = file_iterator->next();
+
+        if (key.empty())
+        {
+            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. You must specify table structure manually", configuration.format);
+
+            return nullptr;
+        }
+
+        /// S3 file iterator could get new keys after new iteration, check them in schema cache.
+        if (ctx->getSettingsRef().schema_inference_use_cache_for_azure && read_keys.size() > prev_read_keys_size)
+        {
+            columns_from_cache = tryGetColumnsFromCache(read_keys.begin() + prev_read_keys_size, read_keys.end(), ctx);
+            prev_read_keys_size = read_keys.size();
+            if (columns_from_cache)
+            {
+                cached_columns = *columns_from_cache;
+                return nullptr;
+            }
+        }
+
+        first = false;
+        int zstd_window_log_max = static_cast<int>(ctx->getSettingsRef().zstd_window_log_max);
+        return wrapReadBufferWithCompressionMethod(
+            object_storage->readObject(StoredObject(key), ctx->getReadSettings(), {}, metadata.size_bytes),
+            chooseCompressionMethod(key, configuration.compression_method),
+            zstd_window_log_max);
+    };
+
+    ColumnsDescription columns;
+    if (columns_from_cache)
+        columns = *columns_from_cache;
+    else
+        columns = readSchemaFromFormat(configuration.format, format_settings, read_buffer_iterator, configuration.withGlobs(), ctx);
+
+    if (ctx->getSettingsRef().schema_inference_use_cache_for_azure)
+        addColumnsToCache(read_keys, columns, configuration.format, ctx);
+
+    return columns;
+
+}
+
+std::optional<ColumnsDescription> StorageAzure::tryGetColumnsFromCache(
+        const RelativePathsWithMetadata::const_iterator & begin,
+        const RelativePathsWithMetadata::const_iterator & end,
+        const ContextPtr & ctx)
+{
+    auto & schema_cache = getSchemaCache(ctx);
+    for (auto it = begin; it < end; ++it)
+    {
+        auto get_last_mod_time = [&] -> time_t
+        {
+            return it->metadata.last_modified->epochTime();
+        };
+
+        auto host_and_bucket = configuration.connection_url + '/' + configuration.container;
+        String source = host_and_bucket + '/' + it->relative_path;
+        auto cache_key = getKeyForSchemaCache(source, configuration.format, format_settings, ctx);
+        auto columns = schema_cache.tryGet(cache_key, get_last_mod_time);
+        if (columns)
+            return columns;
+    }
+
+    return std::nullopt;
+
+}
+
+void StorageAzure::addColumnsToCache(
+    const RelativePathsWithMetadata & keys,
+    const ColumnsDescription & columns,
+    const String & format_name,
+    const ContextPtr & ctx)
+{
+    auto host_and_bucket = configuration.connection_url + '/' + configuration.container;
+    Strings sources;
+    sources.reserve(keys.size());
+    std::transform(keys.begin(), keys.end(), std::back_inserter(sources), [&](const auto & elem){ return host_and_bucket + '/' + elem.relative_path; });
+    auto cache_keys = getKeysForSchemaCache(sources, format_name, format_settings, ctx);
+    auto & schema_cache = getSchemaCache(ctx);
+    schema_cache.addMany(cache_keys, columns);
+}
+
+SchemaCache & StorageAzure::getSchemaCache(const ContextPtr & ctx)
+{
+    static SchemaCache schema_cache(ctx->getConfigRef().getUInt("schema_inference_cache_max_elements_for_azure", DEFAULT_SCHEMA_CACHE_ELEMENTS));
+    return schema_cache;
+}
+
 
 }
 
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index f114184c336..83bcb874efc 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -79,10 +79,6 @@ public:
     static StorageAzure::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
     static AzureClientPtr createClient(StorageAzure::Configuration configuration);
     static AzureObjectStorage::SettingsPtr createSettings(StorageAzure::Configuration configuration);
-    static ColumnsDescription getTableStructureFromData(
-        const StorageAzure::Configuration & configuration,
-        const std::optional<FormatSettings> & format_settings,
-        ContextPtr ctx);
 
     String getName() const override
     {
@@ -127,10 +123,19 @@ private:
     std::optional<FormatSettings> format_settings;
     ASTPtr partition_by;
 
-    static ColumnsDescription getTableStructureFromDataImpl(
-        const Configuration & configuration,
-        const std::optional<FormatSettings> & format_settings,
-        ContextPtr ctx);
+    ColumnsDescription getTableStructureFromDataImpl(ContextPtr ctx);
+
+    std::optional<ColumnsDescription> tryGetColumnsFromCache(
+        const RelativePathsWithMetadata::const_iterator & begin,
+        const RelativePathsWithMetadata::const_iterator & end,
+        const ContextPtr & ctx);
+
+    void addColumnsToCache(
+        const RelativePathsWithMetadata & keys,
+        const ColumnsDescription & columns,
+        const String & format_name,
+        const ContextPtr & ctx);
+
 
 };
 
@@ -147,12 +152,14 @@ public:
             std::optional<String> blob_path_with_globs_,
             ASTPtr query_,
             const Block & virtual_header_,
-            ContextPtr context_);
+            ContextPtr context_,
+            RelativePathsWithMetadata * outer_blobs_);
 
         RelativePathWithMetadata next();
         size_t getTotalSize() const;
         ~Iterator() = default;
-    private:
+
+     private:
         AzureObjectStorage * object_storage;
         std::string container;
         std::optional<Strings> keys;
@@ -165,6 +172,7 @@ public:
         std::atomic<size_t> total_size = 0;
 
         std::optional<RelativePathsWithMetadata> blobs_with_metadata;
+        RelativePathsWithMetadata * outer_blobs;
         ObjectStorageIteratorPtr object_storage_iterator;
         bool recursive{false};
 
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 221005e414b..83a7bf71181 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -373,3 +373,51 @@ def test_storage_azure_get_gzip(cluster, extension, method):
 
     assert azure_query(node, f"SELECT sum(id) FROM {name}").splitlines() == ["565"]
     azure_query(node, f"DROP TABLE {name}")
+
+
+def test_schema_inference_no_globs(cluster):
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 String, column3 UInt32"
+    azure_query(node, f"CREATE TABLE test_schema_inference_src ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv', format='CSVWithNames')")
+
+    query = f"insert into test_schema_inference_src SELECT number, toString(number), number * number FROM numbers(1000)"
+    azure_query(node, query)
+
+    azure_query(node, f"CREATE TABLE test_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv')")
+
+    print(node.query("SHOW CREATE TABLE test_select_inference"))
+
+    query = "select sum(column1), sum(length(column2)), sum(column3), min(_file), max(_path) from test_select_inference"
+    assert azure_query(node, query).splitlines() == ['499500\t2890\t332833500\ttest_schema_inference_no_globs.csv\tcont/test_schema_inference_no_globs.csv']
+
+
+def test_schema_inference_from_globs(cluster):
+    node = cluster.instances["node"]
+    unique_prefix = random.randint(1, 10000)
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    max_path = ""
+    for i in range(10):
+        for j in range(10):
+            path = "{}/{}_{}/{}.csv".format(
+                unique_prefix, i, random.choice(["a", "b", "c", "d"]), j
+            )
+            max_path = max(path, max_path)
+            values = f"({i},{j},{i + j})"
+
+            azure_query(node, f"CREATE TABLE test_schema_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames')")
+
+            query = f"insert into test_schema_{i}_{j} VALUES {values}"
+            azure_query(node, query)
+
+
+    azure_query(node, f"CREATE TABLE test_glob_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')")
+
+    print(node.query("SHOW CREATE TABLE test_glob_select_inference"))
+
+    query = "select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from test_glob_select_inference"
+    assert azure_query(node, query).splitlines() == [
+        "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
+            bucket='cont', max_path=max_path
+        )
+    ]

From 3bda231203644989f0be3edcc390271f14d72cb4 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 6 Jun 2023 15:11:21 +0000
Subject: [PATCH 0522/1478] Automatic style fix

---
 .../test_storage_azure_blob_storage/test.py   | 27 ++++++++++++++-----
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 9b71ff1a490..621af773160 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -400,17 +400,25 @@ def test_storage_azure_get_gzip(cluster, extension, method):
 def test_schema_inference_no_globs(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 String, column3 UInt32"
-    azure_query(node, f"CREATE TABLE test_schema_inference_src ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv', format='CSVWithNames')")
+    azure_query(
+        node,
+        f"CREATE TABLE test_schema_inference_src ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv', format='CSVWithNames')",
+    )
 
     query = f"insert into test_schema_inference_src SELECT number, toString(number), number * number FROM numbers(1000)"
     azure_query(node, query)
 
-    azure_query(node, f"CREATE TABLE test_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv')")
+    azure_query(
+        node,
+        f"CREATE TABLE test_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv')",
+    )
 
     print(node.query("SHOW CREATE TABLE test_select_inference"))
 
     query = "select sum(column1), sum(length(column2)), sum(column3), min(_file), max(_path) from test_select_inference"
-    assert azure_query(node, query).splitlines() == ['499500\t2890\t332833500\ttest_schema_inference_no_globs.csv\tcont/test_schema_inference_no_globs.csv']
+    assert azure_query(node, query).splitlines() == [
+        "499500\t2890\t332833500\ttest_schema_inference_no_globs.csv\tcont/test_schema_inference_no_globs.csv"
+    ]
 
 
 def test_schema_inference_from_globs(cluster):
@@ -427,19 +435,24 @@ def test_schema_inference_from_globs(cluster):
             max_path = max(path, max_path)
             values = f"({i},{j},{i + j})"
 
-            azure_query(node, f"CREATE TABLE test_schema_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames')")
+            azure_query(
+                node,
+                f"CREATE TABLE test_schema_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames')",
+            )
 
             query = f"insert into test_schema_{i}_{j} VALUES {values}"
             azure_query(node, query)
 
-
-    azure_query(node, f"CREATE TABLE test_glob_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')")
+    azure_query(
+        node,
+        f"CREATE TABLE test_glob_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')",
+    )
 
     print(node.query("SHOW CREATE TABLE test_glob_select_inference"))
 
     query = "select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from test_glob_select_inference"
     assert azure_query(node, query).splitlines() == [
         "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
-            bucket='cont', max_path=max_path
+            bucket="cont", max_path=max_path
         )
     ]

From 6c82ee45e2f1886219967dbadcde8e6a59bd84b1 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Tue, 6 Jun 2023 18:27:16 +0200
Subject: [PATCH 0523/1478] Fix build

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

diff --git a/src/Interpreters/tests/gtest_convertFieldToType.cpp b/src/Interpreters/tests/gtest_convertFieldToType.cpp
index f4de36cbecc..e259418d1c3 100644
--- a/src/Interpreters/tests/gtest_convertFieldToType.cpp
+++ b/src/Interpreters/tests/gtest_convertFieldToType.cpp
@@ -9,7 +9,6 @@
 #include <gtest/gtest.h>
 #include "base/Decimal.h"
 #include "base/types.h"
-#include "gtest/gtest.h"
 
 using namespace DB;
 

From 38edd6c3e778aad7a5a8a38c294c0c1e340990a1 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Tue, 6 Jun 2023 18:28:34 +0200
Subject: [PATCH 0524/1478] Update
 src/Interpreters/tests/gtest_convertFieldToType.cpp

---
 src/Interpreters/tests/gtest_convertFieldToType.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/tests/gtest_convertFieldToType.cpp b/src/Interpreters/tests/gtest_convertFieldToType.cpp
index e259418d1c3..cda9311dcbe 100644
--- a/src/Interpreters/tests/gtest_convertFieldToType.cpp
+++ b/src/Interpreters/tests/gtest_convertFieldToType.cpp
@@ -56,7 +56,7 @@ TEST_P(ConvertFieldToTypeTest, convert)
 }
 
 // Basically, the number of seconds in a day works for UTC here
-const long long int Day = 24 * 60 * 60;
+const Int64 Day = 24 * 60 * 60;
 
 // 123 is arbitrary value here
 

From 473743b49fa7f37ee869d694e9233b4678efbd98 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Tue, 6 Jun 2023 18:38:32 +0200
Subject: [PATCH 0525/1478] Disable pure parallel replicas if trivial count
 optimization is possible (#50594)

---
 src/Interpreters/InterpreterSelectQuery.cpp   | 116 ++++++++++--------
 src/Interpreters/InterpreterSelectQuery.h     |   2 +
 src/Planner/PlannerJoinTree.cpp               |  19 ++-
 ...licas_trivial_count_optimization.reference |  12 ++
 ...lel_replicas_trivial_count_optimization.sh |  95 ++++++++++++++
 5 files changed, 191 insertions(+), 53 deletions(-)
 create mode 100644 tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.reference
 create mode 100755 tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh

diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index d2be48dafb3..e84a400a220 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -833,6 +833,19 @@ InterpreterSelectQuery::InterpreterSelectQuery(
         need_analyze_again = true;
     }
 
+    if (can_analyze_again
+        && settings.max_parallel_replicas > 1
+        && settings.allow_experimental_parallel_reading_from_replicas > 0
+        && settings.parallel_replicas_custom_key.value.empty()
+        && getTrivialCount(0).has_value())
+    {
+        /// The query could use trivial count if it didn't use parallel replicas, so let's disable it and reanalyze
+        context->setSetting("allow_experimental_parallel_reading_from_replicas", Field(0));
+        context->setSetting("max_parallel_replicas", UInt64{0});
+        need_analyze_again = true;
+        LOG_TRACE(log, "Disabling parallel replicas to be able to use a trivial count optimization");
+    }
+
     if (need_analyze_again)
     {
         size_t current_query_analyze_count = context->getQueryContext()->kitchen_sink.analyze_counter.load();
@@ -2254,79 +2267,84 @@ void InterpreterSelectQuery::addPrewhereAliasActions()
     }
 }
 
-void InterpreterSelectQuery::executeFetchColumns(QueryProcessingStage::Enum processing_stage, QueryPlan & query_plan)
+/// Based on the query analysis, check if optimizing the count trivial count to use totalRows is possible
+std::optional<UInt64> InterpreterSelectQuery::getTrivialCount(UInt64 max_parallel_replicas)
 {
-    auto & query = getSelectQuery();
     const Settings & settings = context->getSettingsRef();
-
-    /// Optimization for trivial query like SELECT count() FROM table.
     bool optimize_trivial_count =
         syntax_analyzer_result->optimize_trivial_count
-        && (settings.max_parallel_replicas <= 1)
+        && (max_parallel_replicas <= 1)
         && !settings.allow_experimental_query_deduplication
         && !settings.empty_result_for_aggregation_by_empty_set
         && storage
         && storage->getName() != "MaterializedMySQL"
         && !storage->hasLightweightDeletedMask()
         && query_info.filter_asts.empty()
-        && processing_stage == QueryProcessingStage::FetchColumns
         && query_analyzer->hasAggregation()
         && (query_analyzer->aggregates().size() == 1)
         && typeid_cast<const AggregateFunctionCount *>(query_analyzer->aggregates()[0].function.get());
 
-    if (optimize_trivial_count)
+    if (!optimize_trivial_count)
+        return {};
+
+    auto & query = getSelectQuery();
+    if (!query.prewhere() && !query.where() && !context->getCurrentTransaction())
+    {
+        return storage->totalRows(settings);
+    }
+    else
+    {
+        // It's possible to optimize count() given only partition predicates
+        SelectQueryInfo temp_query_info;
+        temp_query_info.query = query_ptr;
+        temp_query_info.syntax_analyzer_result = syntax_analyzer_result;
+        temp_query_info.prepared_sets = query_analyzer->getPreparedSets();
+
+        return storage->totalRowsByPartitionPredicate(temp_query_info, context);
+    }
+}
+
+void InterpreterSelectQuery::executeFetchColumns(QueryProcessingStage::Enum processing_stage, QueryPlan & query_plan)
+{
+    auto & query = getSelectQuery();
+    const Settings & settings = context->getSettingsRef();
+    std::optional<UInt64> num_rows;
+
+    /// Optimization for trivial query like SELECT count() FROM table.
+    if (processing_stage == QueryProcessingStage::FetchColumns && (num_rows = getTrivialCount(settings.max_parallel_replicas)))
     {
         const auto & desc = query_analyzer->aggregates()[0];
         const auto & func = desc.function;
-        std::optional<UInt64> num_rows{};
+        const AggregateFunctionCount & agg_count = static_cast<const AggregateFunctionCount &>(*func);
 
-        if (!query.prewhere() && !query.where() && !context->getCurrentTransaction())
-        {
-            num_rows = storage->totalRows(settings);
-        }
-        else // It's possible to optimize count() given only partition predicates
-        {
-            SelectQueryInfo temp_query_info;
-            temp_query_info.query = query_ptr;
-            temp_query_info.syntax_analyzer_result = syntax_analyzer_result;
-            temp_query_info.prepared_sets = query_analyzer->getPreparedSets();
+        /// We will process it up to "WithMergeableState".
+        std::vector<char> state(agg_count.sizeOfData());
+        AggregateDataPtr place = state.data();
 
-            num_rows = storage->totalRowsByPartitionPredicate(temp_query_info, context);
-        }
+        agg_count.create(place);
+        SCOPE_EXIT_MEMORY_SAFE(agg_count.destroy(place));
 
-        if (num_rows)
-        {
-            const AggregateFunctionCount & agg_count = static_cast<const AggregateFunctionCount &>(*func);
+        agg_count.set(place, *num_rows);
 
-            /// We will process it up to "WithMergeableState".
-            std::vector<char> state(agg_count.sizeOfData());
-            AggregateDataPtr place = state.data();
+        auto column = ColumnAggregateFunction::create(func);
+        column->insertFrom(place);
 
-            agg_count.create(place);
-            SCOPE_EXIT_MEMORY_SAFE(agg_count.destroy(place));
+        Block header = analysis_result.before_aggregation->getResultColumns();
+        size_t arguments_size = desc.argument_names.size();
+        DataTypes argument_types(arguments_size);
+        for (size_t j = 0; j < arguments_size; ++j)
+            argument_types[j] = header.getByName(desc.argument_names[j]).type;
 
-            agg_count.set(place, *num_rows);
+        Block block_with_count{
+            {std::move(column), std::make_shared<DataTypeAggregateFunction>(func, argument_types, desc.parameters), desc.column_name}};
 
-            auto column = ColumnAggregateFunction::create(func);
-            column->insertFrom(place);
-
-            Block header = analysis_result.before_aggregation->getResultColumns();
-            size_t arguments_size = desc.argument_names.size();
-            DataTypes argument_types(arguments_size);
-            for (size_t j = 0; j < arguments_size; ++j)
-                argument_types[j] = header.getByName(desc.argument_names[j]).type;
-
-            Block block_with_count{
-                {std::move(column), std::make_shared<DataTypeAggregateFunction>(func, argument_types, desc.parameters), desc.column_name}};
-
-            auto source = std::make_shared<SourceFromSingleChunk>(block_with_count);
-            auto prepared_count = std::make_unique<ReadFromPreparedSource>(Pipe(std::move(source)));
-            prepared_count->setStepDescription("Optimized trivial count");
-            query_plan.addStep(std::move(prepared_count));
-            from_stage = QueryProcessingStage::WithMergeableState;
-            analysis_result.first_stage = false;
-            return;
-        }
+        auto source = std::make_shared<SourceFromSingleChunk>(block_with_count);
+        auto prepared_count = std::make_unique<ReadFromPreparedSource>(Pipe(std::move(source)));
+        prepared_count->setStepDescription("Optimized trivial count");
+        query_plan.addStep(std::move(prepared_count));
+        from_stage = QueryProcessingStage::WithMergeableState;
+        analysis_result.first_stage = false;
+        return;
     }
 
     /// Limitation on the number of columns to read.
diff --git a/src/Interpreters/InterpreterSelectQuery.h b/src/Interpreters/InterpreterSelectQuery.h
index e39dd675136..0739e818cd6 100644
--- a/src/Interpreters/InterpreterSelectQuery.h
+++ b/src/Interpreters/InterpreterSelectQuery.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <memory>
+#include <optional>
 
 #include <Access/EnabledRowPolicies.h>
 #include <Core/QueryProcessingStage.h>
@@ -187,6 +188,7 @@ private:
     void executeExtremes(QueryPlan & query_plan);
     void executeSubqueriesInSetsAndJoins(QueryPlan & query_plan);
     bool autoFinalOnQuery(ASTSelectQuery & select_query);
+    std::optional<UInt64> getTrivialCount(UInt64 max_parallel_replicas);
 
     enum class Modificator
     {
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index 4f091f73187..9672738ae6b 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -170,7 +170,7 @@ bool applyTrivialCountIfPossible(
     QueryPlan & query_plan,
     const TableNode & table_node,
     const QueryTreeNodePtr & query_tree,
-    const ContextPtr & query_context,
+    ContextMutablePtr & query_context,
     const Names & columns_names)
 {
     const auto & settings = query_context->getSettingsRef();
@@ -208,8 +208,7 @@ bool applyTrivialCountIfPossible(
     if (storage->hasLightweightDeletedMask())
         return false;
 
-    if (settings.max_parallel_replicas > 1 ||
-        settings.allow_experimental_query_deduplication
+    if (settings.allow_experimental_query_deduplication
         || settings.empty_result_for_aggregation_by_empty_set)
         return false;
 
@@ -228,6 +227,18 @@ bool applyTrivialCountIfPossible(
     if (!num_rows)
         return false;
 
+    if (settings.max_parallel_replicas > 1)
+    {
+        if (!settings.parallel_replicas_custom_key.value.empty() || settings.allow_experimental_parallel_reading_from_replicas == 0)
+            return false;
+
+        /// The query could use trivial count if it didn't use parallel replicas, so let's disable it
+        query_context->setSetting("allow_experimental_parallel_reading_from_replicas", Field(0));
+        query_context->setSetting("max_parallel_replicas", UInt64{0});
+        LOG_TRACE(&Poco::Logger::get("Planner"), "Disabling parallel replicas to be able to use a trivial count optimization");
+
+    }
+
     /// Set aggregation state
     const AggregateFunctionCount & agg_count = *count_func;
     std::vector<char> state(agg_count.sizeOfData());
@@ -619,7 +630,7 @@ JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expres
             is_single_table_expression &&
             table_node &&
             select_query_info.has_aggregates &&
-            applyTrivialCountIfPossible(query_plan, *table_node, select_query_info.query_tree, planner_context->getQueryContext(), table_expression_data.getColumnNames());
+            applyTrivialCountIfPossible(query_plan, *table_node, select_query_info.query_tree, planner_context->getMutableQueryContext(), table_expression_data.getColumnNames());
 
         if (is_trivial_count_applied)
         {
diff --git a/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.reference b/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.reference
new file mode 100644
index 00000000000..48795e2cd39
--- /dev/null
+++ b/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.reference
@@ -0,0 +1,12 @@
+100000
+100000
+100000
+100000
+100000
+100000
+02783_count-default_0_disabled	Not parallel	1	16
+02783_count-default_0_pure	Not parallel	1	16
+02783_count-default_0_pure_analyzer	Not parallel	1	16
+02783_count-default_1_disabled	Not parallel	1	16
+02783_count-default_1_pure	Not parallel	1	16
+02783_count-default_1_pure_analyzer	Not parallel	1	16
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
new file mode 100755
index 00000000000..4c29e513183
--- /dev/null
+++ b/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh
@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+function has_used_parallel_replicas () {
+    $CLICKHOUSE_CLIENT --query "
+        SELECT
+            initial_query_id,
+            if(count() != 2, 'Used parallel', 'Not parallel'),
+            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%'
+    GROUP BY initial_query_id
+    ORDER BY min(event_time_microseconds) ASC
+    FORMAT TSV"
+}
+
+function run_query_with_pure_parallel_replicas () {
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_disabled" \
+        --max_parallel_replicas 0
+
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_pure" \
+        --max_parallel_replicas 3 \
+        --prefer_localhost_replica 1 \
+        --use_hedged_requests 0 \
+        --cluster_for_parallel_replicas 'test_cluster_one_shard_three_replicas_localhost' \
+        --allow_experimental_parallel_reading_from_replicas 1 \
+        --allow_experimental_analyzer 0
+
+    # Not implemented yet
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_pure_analyzer" \
+        --max_parallel_replicas 3 \
+        --prefer_localhost_replica 1 \
+        --use_hedged_requests 0 \
+        --cluster_for_parallel_replicas 'test_cluster_one_shard_three_replicas_localhost' \
+        --allow_experimental_parallel_reading_from_replicas 1 \
+        --allow_experimental_analyzer 1
+}
+
+function run_query_with_custom_key_parallel_replicas () {
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_disabled" \
+        --max_parallel_replicas 0
+
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_custom_key" \
+        --max_parallel_replicas 3 \
+        --use_hedged_requests 0 \
+        --parallel_replicas_custom_key_filter_type 'default' \
+        --parallel_replicas_custom_key "$2" \
+        --allow_experimental_analyzer 0
+
+    $CLICKHOUSE_CLIENT \
+        --query "$2" \
+        --query_id "${1}_custom_key_analyzer" \
+        --max_parallel_replicas 3 \
+        --use_hedged_requests 0 \
+        --parallel_replicas_custom_key_filter_type 'default' \
+        --parallel_replicas_custom_key "$2" \
+        --allow_experimental_analyzer 1
+}
+
+$CLICKHOUSE_CLIENT --query "
+    CREATE TABLE replicated_numbers
+    (
+        number Int64,
+    )
+    ENGINE=ReplicatedMergeTree('/clickhouse/tables/{database}/replicated_numbers', 'r1')
+    ORDER BY (number)
+    AS SELECT number FROM numbers(100000);
+"
+
+query_id_base="02783_count-$CLICKHOUSE_DATABASE"
+
+run_query_with_pure_parallel_replicas "${query_id_base}_0" "SELECT count() FROM replicated_numbers"
+run_query_with_pure_parallel_replicas "${query_id_base}_1" "SELECT * FROM (SELECT count() FROM replicated_numbers) LIMIT 20"
+
+# Not implemented yet as the query fails to execute correctly to begin with
+#run_query_with_custom_key_parallel_replicas "${query_id_base}_2" "SELECT count() FROM cluster(test_cluster_one_shard_three_replicas_localhost, currentDatabase(), replicated_numbers)" "sipHash64(number)"
+#run_query_with_custom_key_parallel_replicas "${query_id_base}_3" "SELECT * FROM (SELECT count() FROM cluster(test_cluster_one_shard_three_replicas_localhost, currentDatabase(), replicated_numbers)) LIMIT 20" "sipHash64(number)"
+
+
+$CLICKHOUSE_CLIENT --query "SYSTEM FLUSH LOGS"
+has_used_parallel_replicas "${query_id_base}"

From c910f0034b20fcdbe3c336d6851fdd1c7bb21138 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 18:48:20 +0200
Subject: [PATCH 0526/1478] Some code for table function

---
 src/Storages/StorageAzure.cpp             |  52 ++++---
 src/Storages/StorageAzure.h               |  22 ++-
 src/TableFunctions/TableFunctionAzure.cpp | 175 ++++++++++++++++++++--
 src/TableFunctions/TableFunctionAzure.h   |   8 +-
 4 files changed, 214 insertions(+), 43 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index e725aa17dd6..e3051236118 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -67,12 +67,12 @@ namespace ErrorCodes
 namespace
 {
 
-static const std::unordered_set<std::string_view> required_configuration_keys = {
+const std::unordered_set<std::string_view> required_configuration_keys = {
     "blob_path",
     "container",
 };
 
-static const std::unordered_set<std::string_view> optional_configuration_keys = {
+const std::unordered_set<std::string_view> optional_configuration_keys = {
     "format",
     "compression",
     "compression_method",
@@ -87,8 +87,9 @@ bool isConnectionString(const std::string & candidate)
     return candidate.starts_with("DefaultEndpointsProtocol");
 }
 
+}
 
-void processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection)
+void StorageAzure::processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection)
 {
     validateNamedCollection(collection, required_configuration_keys, optional_configuration_keys);
 
@@ -113,11 +114,11 @@ void processNamedCollectionResult(StorageAzure::Configuration & configuration, c
     if (collection.has("account_key"))
         configuration.account_key = collection.get<String>("account_key");
 
+    configuration.structure = collection.getOrDefault<String>("structure", "auto");
     configuration.format = collection.getOrDefault<String>("format", configuration.format);
     configuration.compression_method = collection.getOrDefault<String>("compression_method", collection.getOrDefault<String>("compression", "auto"));
 }
 
-}
 
 StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
 {
@@ -236,6 +237,17 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 }
 
 
+AzureObjectStorage::SettingsPtr StorageAzure::createSettings(ContextPtr local_context)
+{
+    const auto & context_settings = local_context->getSettingsRef();
+    auto settings_ptr = std::make_unique<AzureObjectStorageSettings>();
+    settings_ptr->max_single_part_upload_size = context_settings.azure_max_single_part_upload_size;
+    settings_ptr->max_single_read_retries = context_settings.azure_max_single_read_retries;
+    settings_ptr->list_object_keys_size = static_cast<int32_t>(context_settings.azure_list_object_keys_size);
+
+    return settings_ptr;
+}
+
 void registerStorageAzure(StorageFactory & factory)
 {
     factory.registerStorage("Azure", [](const StorageFactory::Arguments & args)
@@ -276,11 +288,7 @@ void registerStorageAzure(StorageFactory & factory)
         if (args.storage_def->partition_by)
             partition_by = args.storage_def->partition_by->clone();
 
-        const auto & context_settings = args.getContext()->getSettingsRef();
-        auto settings = std::make_unique<AzureObjectStorageSettings>();
-        settings->max_single_part_upload_size = context_settings.azure_max_single_part_upload_size;
-        settings->max_single_read_retries = context_settings.azure_max_single_read_retries;
-        settings->list_object_keys_size = static_cast<int32_t>(context_settings.azure_list_object_keys_size);
+        auto settings = StorageAzure::createSettings(args.getContext());
 
         return std::make_shared<StorageAzure>(
             std::move(configuration),
@@ -399,7 +407,7 @@ StorageAzure::StorageAzure(
     StorageInMemoryMetadata storage_metadata;
     if (columns_.empty())
     {
-        auto columns = getTableStructureFromDataImpl(context);
+        auto columns = getTableStructureFromData(object_storage.get(), configuration, format_settings, context);
         storage_metadata.setColumns(columns);
     }
     else
@@ -1149,27 +1157,31 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }
 
-ColumnsDescription StorageAzure::getTableStructureFromDataImpl(ContextPtr ctx)
+ColumnsDescription StorageAzure::getTableStructureFromData(
+    AzureObjectStorage * object_storage,
+    const Configuration & configuration,
+    const std::optional<FormatSettings> & format_settings,
+    ContextPtr ctx)
 {
     RelativePathsWithMetadata read_keys;
     std::shared_ptr<StorageAzureSource::Iterator> file_iterator;
     if (configuration.withGlobs())
     {
         file_iterator = std::make_shared<StorageAzureSource::Iterator>(
-            object_storage.get(), configuration.container, std::nullopt,
-            configuration.blob_path, nullptr, virtual_block, ctx, &read_keys);
+            object_storage, configuration.container, std::nullopt,
+            configuration.blob_path, nullptr, Block{}, ctx, &read_keys);
     }
     else
     {
         file_iterator = std::make_shared<StorageAzureSource::Iterator>(
-            object_storage.get(), configuration.container, configuration.blobs_paths,
-            std::nullopt, nullptr, virtual_block, ctx, &read_keys);
+            object_storage, configuration.container, configuration.blobs_paths,
+            std::nullopt, nullptr, Block{}, ctx, &read_keys);
     }
 
     std::optional<ColumnsDescription> columns_from_cache;
     size_t prev_read_keys_size = read_keys.size();
     if (ctx->getSettingsRef().schema_inference_use_cache_for_azure)
-        columns_from_cache = tryGetColumnsFromCache(read_keys.begin(), read_keys.end(), ctx);
+        columns_from_cache = tryGetColumnsFromCache(read_keys.begin(), read_keys.end(), configuration, format_settings, ctx);
 
     ReadBufferIterator read_buffer_iterator = [&, first = true](ColumnsDescription & cached_columns) mutable -> std::unique_ptr<ReadBuffer>
     {
@@ -1189,7 +1201,7 @@ ColumnsDescription StorageAzure::getTableStructureFromDataImpl(ContextPtr ctx)
         /// S3 file iterator could get new keys after new iteration, check them in schema cache.
         if (ctx->getSettingsRef().schema_inference_use_cache_for_azure && read_keys.size() > prev_read_keys_size)
         {
-            columns_from_cache = tryGetColumnsFromCache(read_keys.begin() + prev_read_keys_size, read_keys.end(), ctx);
+            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)
             {
@@ -1213,7 +1225,7 @@ ColumnsDescription StorageAzure::getTableStructureFromDataImpl(ContextPtr ctx)
         columns = readSchemaFromFormat(configuration.format, format_settings, read_buffer_iterator, configuration.withGlobs(), ctx);
 
     if (ctx->getSettingsRef().schema_inference_use_cache_for_azure)
-        addColumnsToCache(read_keys, columns, configuration.format, ctx);
+        addColumnsToCache(read_keys, columns, configuration, format_settings, configuration.format, ctx);
 
     return columns;
 
@@ -1222,6 +1234,8 @@ ColumnsDescription StorageAzure::getTableStructureFromDataImpl(ContextPtr ctx)
 std::optional<ColumnsDescription> StorageAzure::tryGetColumnsFromCache(
         const RelativePathsWithMetadata::const_iterator & begin,
         const RelativePathsWithMetadata::const_iterator & end,
+        const StorageAzure::Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
         const ContextPtr & ctx)
 {
     auto & schema_cache = getSchemaCache(ctx);
@@ -1247,6 +1261,8 @@ std::optional<ColumnsDescription> StorageAzure::tryGetColumnsFromCache(
 void StorageAzure::addColumnsToCache(
     const RelativePathsWithMetadata & keys,
     const ColumnsDescription & columns,
+    const StorageAzure::Configuration & configuration,
+    const std::optional<FormatSettings> & format_settings,
     const String & format_name,
     const ContextPtr & ctx)
 {
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index f20da74c2a8..8341026b624 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -10,6 +10,7 @@
 #include <Storages/Cache/SchemaCache.h>
 #include <Storages/StorageConfiguration.h>
 #include <Processors/Executors/PullingPipelineExecutor.h>
+#include <Storages/NamedCollectionsHelpers.h>
 
 namespace DB
 {
@@ -31,6 +32,7 @@ using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConn
 class StorageAzure : public IStorage
 {
 public:
+
     using AzureClient = Azure::Storage::Blobs::BlobContainerClient;
     using AzureClientPtr = std::unique_ptr<Azure::Storage::Blobs::BlobContainerClient>;
 
@@ -78,7 +80,10 @@ public:
 
     static StorageAzure::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
     static AzureClientPtr createClient(StorageAzure::Configuration configuration);
-    static AzureObjectStorage::SettingsPtr createSettings(StorageAzure::Configuration configuration);
+
+    static AzureObjectStorage::SettingsPtr createSettings(ContextPtr local_context);
+
+    static void processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection);
 
     String getName() const override
     {
@@ -112,6 +117,12 @@ public:
 
     static SchemaCache & getSchemaCache(const ContextPtr & ctx);
 
+    static ColumnsDescription getTableStructureFromData(
+        AzureObjectStorage * object_storage,
+        const Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
+        ContextPtr ctx);
+
 private:
     std::string name;
     Configuration configuration;
@@ -123,16 +134,19 @@ private:
     std::optional<FormatSettings> format_settings;
     ASTPtr partition_by;
 
-    ColumnsDescription getTableStructureFromDataImpl(ContextPtr ctx);
 
-    std::optional<ColumnsDescription> tryGetColumnsFromCache(
+    static std::optional<ColumnsDescription> tryGetColumnsFromCache(
         const RelativePathsWithMetadata::const_iterator & begin,
         const RelativePathsWithMetadata::const_iterator & end,
+        const StorageAzure::Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
         const ContextPtr & ctx);
 
-    void addColumnsToCache(
+    static void addColumnsToCache(
         const RelativePathsWithMetadata & keys,
         const ColumnsDescription & columns,
+        const Configuration & configuration,
+        const std::optional<FormatSettings> & format_settings,
         const String & format_name,
         const ContextPtr & ctx);
 
diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzure.cpp
index f565a365a13..ac3fa1cc8af 100644
--- a/src/TableFunctions/TableFunctionAzure.cpp
+++ b/src/TableFunctions/TableFunctionAzure.cpp
@@ -36,20 +36,148 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-
-void TableFunctionAzure::parseArgumentsImpl(ASTs & args, const ContextPtr & context)
+namespace
 {
-    if (args.size() != 5)
-        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);
+bool isConnectionString(const std::string & candidate)
+{
+    return candidate.starts_with("DefaultEndpointsProtocol");
+}
 
-    configuration.connection_url = checkAndGetLiteralArgument<String>(args[0], "connection_url");
-    configuration.container = checkAndGetLiteralArgument<String>(args[1], "container");
-    configuration.blob_path = checkAndGetLiteralArgument<String>(args[2], "blob_path");
-    configuration.format = checkAndGetLiteralArgument<String>(args[3], "format");
-    configuration.structure = checkAndGetLiteralArgument<String>(args[4], "structure");
+}
+
+StorageAzure::Configuration TableFunctionAzure::parseArgumentsImpl(ASTs & engine_args, const ContextPtr & local_context, bool get_format_from_file)
+{
+    StorageAzure::Configuration configuration;
+
+    /// Supported signatures:
+    ///
+    /// Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])
+    ///
+
+    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, local_context))
+    {
+        StorageAzure::processNamedCollectionResult(configuration, *named_collection);
+
+        configuration.blobs_paths = {configuration.blob_path};
+
+        if (configuration.format == "auto" && get_format_from_file)
+            configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+        return configuration;
+    }
+
+    if (engine_args.size() < 3 || engine_args.size() > 8)
+        throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
+                        "Storage Azure requires 3 to 7 arguments: "
+                        "Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])");
+
+    for (auto & engine_arg : engine_args)
+        engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, local_context);
+
+    std::unordered_map<std::string_view, size_t> engine_args_to_idx;
+
+    configuration.connection_url = checkAndGetLiteralArgument<String>(engine_args[0], "connection_string/storage_account_url");
+    configuration.is_connection_string = isConnectionString(configuration.connection_url);
+
+    configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
+    configuration.blob_path = checkAndGetLiteralArgument<String>(engine_args[2], "blobpath");
+
+    auto is_format_arg = [] (const std::string & s) -> bool
+    {
+        return s == "auto" || FormatFactory::instance().getAllFormats().contains(s);
+    };
+
+    if (engine_args.size() == 4)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name/structure");
+        if (is_format_arg(fourth_arg))
+        {
+            configuration.format = fourth_arg;
+        }
+        else
+        {
+            configuration.structure = fourth_arg;
+        }
+    }
+    else if (engine_args.size() == 5)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            configuration.format = fourth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[4], "compression");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+        }
+    }
+    else if (engine_args.size() == 6)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            configuration.format = fourth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[4], "compression");
+            configuration.structure = checkAndGetLiteralArgument<String>(engine_args[5], "structure");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+            auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
+            if (!is_format_arg(sixth_arg))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format {}", sixth_arg);
+            configuration.format = sixth_arg;
+        }
+    }
+    else if (engine_args.size() == 7)
+    {
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Format, compression and structure must be last arguments");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+            auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
+            if (!is_format_arg(sixth_arg))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format {}", sixth_arg);
+            configuration.format = sixth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[6], "compression");
+        }
+    }
+    else if (engine_args.size() == 8)
+    {
+
+        auto fourth_arg = checkAndGetLiteralArgument<String>(engine_args[3], "format/account_name");
+        if (is_format_arg(fourth_arg))
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Format and compression must be last arguments");
+        }
+        else
+        {
+            configuration.account_name = fourth_arg;
+            configuration.account_key = checkAndGetLiteralArgument<String>(engine_args[4], "account_key");
+            auto sixth_arg = checkAndGetLiteralArgument<String>(engine_args[5], "format/account_name");
+            if (!is_format_arg(sixth_arg))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown format {}", sixth_arg);
+            configuration.format = sixth_arg;
+            configuration.compression_method = checkAndGetLiteralArgument<String>(engine_args[6], "compression");
+            configuration.structure = checkAndGetLiteralArgument<String>(engine_args[7], "structure");
+        }
+    }
+
+    configuration.blobs_paths = {configuration.blob_path};
+
+    if (configuration.format == "auto" && get_format_from_file)
+        configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
+
+    return configuration;
 }
 
 void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr context)
@@ -69,6 +197,16 @@ void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr
 
 ColumnsDescription TableFunctionAzure::getActualTableStructure(ContextPtr context) const
 {
+    if (configuration.structure == "auto")
+    {
+        context->checkAccess(getSourceAccessType());
+        auto client = StorageAzure::createClient(configuration);
+        auto settings = StorageAzure::createSettings(context);
+
+        auto object_storage = std::make_unique<AzureObjectStorage>("AzureTableFunction", std::move(client), std::move(settings));
+        return StorageAzure::getTableStructureFromData(object_storage.get(), configuration, std::nullopt, context);
+    }
+
     return parseColumnsListFromString(configuration.structure, context);
 }
 
@@ -79,24 +217,29 @@ bool TableFunctionAzure::supportsReadingSubsetOfColumns()
 
 StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
 {
-    ColumnsDescription columns;
-    columns = parseColumnsListFromString(configuration.structure, context);
-
     configuration.is_connection_string = true;
     configuration.blobs_paths = {configuration.blob_path};
 
     auto client = StorageAzure::createClient(configuration);
+    auto settings = StorageAzure::createSettings(context);
+
+    ColumnsDescription columns;
+    if (configuration.structure != "auto")
+        columns = parseColumnsListFromString(configuration.structure, context);
+    else if (!structure_hint.empty())
+        columns = structure_hint;
 
     StoragePtr storage = std::make_shared<StorageAzure>(
         configuration,
-        std::make_unique<AzureObjectStorage>(table_name, std::move(client), std::make_unique<AzureObjectStorageSettings>()),
+        std::make_unique<AzureObjectStorage>(table_name, std::move(client), std::move(settings)),
         context,
         StorageID(getDatabaseName(), table_name),
         columns,
         ConstraintsDescription{},
         String{},
         /// No format_settings for table function Azure
-        std::nullopt, nullptr);
+        std::nullopt,
+        nullptr);
 
     storage->startup();
 
diff --git a/src/TableFunctions/TableFunctionAzure.h b/src/TableFunctions/TableFunctionAzure.h
index a6fb5415113..b3508e7f95c 100644
--- a/src/TableFunctions/TableFunctionAzure.h
+++ b/src/TableFunctions/TableFunctionAzure.h
@@ -19,9 +19,9 @@ class TableFunctionAzure : public ITableFunction
 {
 public:
     static constexpr auto name = "azure_blob";
-    static constexpr auto signature = "- connection_url, container, blob, format, structure\n";
+    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 5; }
+    static size_t getMaxNumberOfArguments() { return 8; }
 
     String getName() const override
     {
@@ -46,9 +46,7 @@ public:
         return {"_path", "_file"};
     }
 
-    virtual void parseArgumentsImpl(ASTs & args, const ContextPtr & context);
-
-    static void addColumnsStructureToArguments(ASTs & args, const String & structure, const ContextPtr & context);
+    static StorageAzure::Configuration parseArgumentsImpl(ASTs & args, const ContextPtr & context, bool get_format_from_file = true);
 
 protected:
 

From e76a7022fcc26f02cb98214e72f039b12b04423f Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 18:50:45 +0200
Subject: [PATCH 0527/1478] Add some tests

---
 .../test_storage_azure_blob_storage/test.py   | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 9b71ff1a490..d4a5f6e24bb 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -443,3 +443,46 @@ def test_schema_inference_from_globs(cluster):
             bucket='cont', max_path=max_path
         )
     ]
+
+def test_simple_write_account_string_table_function(cluster):
+    node = cluster.instances["node"]
+    azure_query(node, "INSERT INTO azure_blob('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'
+
+
+def test_simple_write_connection_string_table_function(cluster):
+    node = cluster.instances["node"]
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')",
+    )
+    azure_query(node, "INSERT INTO test_simple_write_connection_string VALUES (1, 'a')")
+    print(get_azure_file_content("test_simple_write_c.csv"))
+    assert get_azure_file_content("test_simple_write_c.csv") == '1,"a"\n'
+
+
+def test_simple_write_named_collection_1_table_function(cluster):
+    node = cluster.instances["node"]
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)",
+    )
+    azure_query(
+        node, "INSERT INTO test_simple_write_named_collection_1 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'
+
+
+def test_simple_write_named_collection_2_table_function(cluster):
+    node = cluster.instances["node"]
+    azure_query(
+        node,
+        "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')",
+    )
+    azure_query(
+        node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')"
+    )
+    print(get_azure_file_content("test_simple_write_named_2.csv"))
+    assert get_azure_file_content("test_simple_write_named_2.csv") == '1,"a"\n'

From 2a756a7e6c7d564aae6e4895b53e4b2d6f18cfbd Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 17:05:23 +0000
Subject: [PATCH 0528/1478] Cosmetics: Make default tree count / distance
 function constants

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index b15b1bb1a91..e6c11c839fe 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -314,12 +314,14 @@ MergeTreeIndexConditionPtr MergeTreeIndexAnnoy::createIndexCondition(const Selec
 
 MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
 {
-    uint64_t trees = 100;
-    String distance_function = "L2Distance";
+    static constexpr auto default_trees = 100uz;
+    static constexpr auto default_distance_function = "L2Distance";
 
+    String distance_function = default_distance_function;
     if (!index.arguments.empty())
         distance_function = index.arguments[0].get<String>();
 
+    uint64_t trees = default_trees;
     if (index.arguments.size() > 1)
         trees = index.arguments[1].get<uint64_t>();
 

From a74d3ca3289806eccf6cd66ac29725bc3655bbe8 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 17:06:47 +0000
Subject: [PATCH 0529/1478] Fix style check

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index e6c11c839fe..1a28f28f746 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -23,7 +23,6 @@ namespace ErrorCodes
     extern const int INCORRECT_NUMBER_OF_COLUMNS;
     extern const int INCORRECT_QUERY;
     extern const int LOGICAL_ERROR;
-    extern const int BAD_ARGUMENTS;
 }
 
 

From ae97f45c1c9bc8e3f55c01fc57bab5179964b36b Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 6 Jun 2023 17:10:48 +0000
Subject: [PATCH 0530/1478] Automatic style fix

---
 tests/integration/test_storage_azure_blob_storage/test.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 23d1b44daf2..b431837bccb 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -457,9 +457,13 @@ def test_schema_inference_from_globs(cluster):
         )
     ]
 
+
 def test_simple_write_account_string_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "INSERT INTO azure_blob('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write_tf.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')")
+    azure_query(
+        node,
+        "INSERT INTO azure_blob('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'
 

From 6a96cf441e24a5994aa38839ea69dad60b2ecd83 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 19:19:17 +0200
Subject: [PATCH 0531/1478] Renamed to azure_blob_storage

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index b431837bccb..b81730fb24a 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -462,7 +462,7 @@ def test_simple_write_account_string_table_function(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "INSERT INTO azure_blob('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 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')",
     )
     print(get_azure_file_content("test_simple_write_tf.csv"))
     assert get_azure_file_content("test_simple_write_tf.csv") == '1,"a"\n'

From b2db6b47896c03aa728c4fe66d9271eb1a34c529 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 19:19:56 +0200
Subject: [PATCH 0532/1478] Renamed to azure_blob_storage

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

diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzure.cpp
index ac3fa1cc8af..27137bda9ff 100644
--- a/src/TableFunctions/TableFunctionAzure.cpp
+++ b/src/TableFunctions/TableFunctionAzure.cpp
@@ -251,7 +251,7 @@ void registerTableFunctionAzure(TableFunctionFactory & factory)
     factory.registerFunction<TableFunctionAzure>(
         {.documentation
          = {.description=R"(The table function can be used to read the data stored on Azure Blob Storage.)",
-            .examples{{"azure_blob", "SELECT * FROM  azure_blob(connection, container, blob_path, format, structure)", ""}}},
+            .examples{{"azure_blob_storage", "SELECT * FROM  azure_blob_storage(connection, container, blob_path, format, structure)", ""}}},
          .allow_readonly = false});
 }
 
diff --git a/src/TableFunctions/TableFunctionAzure.h b/src/TableFunctions/TableFunctionAzure.h
index b3508e7f95c..e2815973010 100644
--- a/src/TableFunctions/TableFunctionAzure.h
+++ b/src/TableFunctions/TableFunctionAzure.h
@@ -18,7 +18,7 @@ class Context;
 class TableFunctionAzure : public ITableFunction
 {
 public:
-    static constexpr auto name = "azure_blob";
+    static constexpr auto name = "azure_blob_storage";
     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; }

From 7100bc51526c5d88cf3aa84b932ede4e9f1ad15f Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 19:31:50 +0200
Subject: [PATCH 0533/1478] Fixes for azure table function

---
 src/Storages/StorageAzure.cpp                 |   3 +-
 src/TableFunctions/TableFunctionAzure.cpp     |   7 +-
 .../configs/named_collections.xml             |   1 +
 .../test_storage_azure_blob_storage/test.py   | 107 ++++++++++++++----
 4 files changed, 89 insertions(+), 29 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index e3051236118..c6001f59b6f 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -75,6 +75,7 @@ const std::unordered_set<std::string_view> required_configuration_keys = {
 const std::unordered_set<std::string_view> optional_configuration_keys = {
     "format",
     "compression",
+    "structure",
     "compression_method",
     "account_name",
     "account_key",
@@ -1193,7 +1194,7 @@ ColumnsDescription StorageAzure::getTableStructureFromData(
                 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 AzureBlobStorage. You must specify table structure manually", configuration.format);
 
             return nullptr;
         }
diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzure.cpp
index ac3fa1cc8af..8b18ed42d71 100644
--- a/src/TableFunctions/TableFunctionAzure.cpp
+++ b/src/TableFunctions/TableFunctionAzure.cpp
@@ -78,6 +78,7 @@ StorageAzure::Configuration TableFunctionAzure::parseArgumentsImpl(ASTs & engine
     std::unordered_map<std::string_view, size_t> engine_args_to_idx;
 
     configuration.connection_url = checkAndGetLiteralArgument<String>(engine_args[0], "connection_string/storage_account_url");
+    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "CONFIGURATION {}", configuration.connection_url);
     configuration.is_connection_string = isConnectionString(configuration.connection_url);
 
     configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
@@ -192,7 +193,8 @@ void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr
 
     auto & args = args_func.at(0)->children;
 
-    parseArgumentsImpl(args, context);
+    configuration = parseArgumentsImpl(args, context);
+    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "CONFIGURATION {}", configuration.connection_url);
 }
 
 ColumnsDescription TableFunctionAzure::getActualTableStructure(ContextPtr context) const
@@ -217,9 +219,6 @@ bool TableFunctionAzure::supportsReadingSubsetOfColumns()
 
 StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
 {
-    configuration.is_connection_string = true;
-    configuration.blobs_paths = {configuration.blob_path};
-
     auto client = StorageAzure::createClient(configuration);
     auto settings = StorageAzure::createSettings(context);
 
diff --git a/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml b/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml
index dc70895bc05..e0c18d11940 100644
--- a/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml
+++ b/tests/integration/test_storage_azure_blob_storage/configs/named_collections.xml
@@ -4,6 +4,7 @@
             <connection_string>DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;</connection_string>
             <container>cont</container>
             <blob_path>test_simple_write_named.csv</blob_path>
+            <structure>key UInt64, data String</structure>
             <format>CSV</format>
         </azure_conf1>
         <azure_conf2>
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 23d1b44daf2..ad96d2d304a 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -459,43 +459,102 @@ def test_schema_inference_from_globs(cluster):
 
 def test_simple_write_account_string_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "INSERT INTO azure_blob('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write_tf.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')")
+    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob('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'
 
 
 def test_simple_write_connection_string_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(
-        node,
-        "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')",
-    )
-    azure_query(node, "INSERT INTO test_simple_write_connection_string VALUES (1, 'a')")
-    print(get_azure_file_content("test_simple_write_c.csv"))
-    assert get_azure_file_content("test_simple_write_c.csv") == '1,"a"\n'
+    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob('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'
 
 
 def test_simple_write_named_collection_1_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(
-        node,
-        "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)",
-    )
-    azure_query(
-        node, "INSERT INTO test_simple_write_named_collection_1 VALUES (1, 'a')"
-    )
+    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob(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'
 
 
 def test_simple_write_named_collection_2_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(
-        node,
-        "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')",
-    )
-    azure_query(
-        node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')"
-    )
-    print(get_azure_file_content("test_simple_write_named_2.csv"))
-    assert get_azure_file_content("test_simple_write_named_2.csv") == '1,"a"\n'
+
+    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob(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'
+
+def test_put_get_with_globs_tf(cluster):
+    # type: (ClickHouseCluster) -> None
+    unique_prefix = random.randint(1, 10000)
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    max_path = ""
+    for i in range(10):
+        for j in range(10):
+            path = "{}/{}_{}/{}.csv".format(
+                unique_prefix, i, random.choice(["a", "b", "c", "d"]), j
+            )
+            max_path = max(path, max_path)
+            values = f"({i},{j},{i + j})"
+
+            azure_query(
+                node,
+                f"INSERT INTO TABLE FUNCTION azure_blob(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(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
+        )
+    ]
+
+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(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(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"
+    ]
+
+def test_schema_inference_from_globs_tf(cluster):
+    node = cluster.instances["node"]
+    unique_prefix = random.randint(1, 10000)
+    node = cluster.instances["node"]  # type: ClickHouseInstance
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    max_path = ""
+    for i in range(10):
+        for j in range(10):
+            path = "{}/{}_{}/{}.csv".format(
+                unique_prefix, i, random.choice(["a", "b", "c", "d"]), j
+            )
+            max_path = max(path, max_path)
+            values = f"({i},{j},{i + j})"
+
+            query = f"insert into table function azure_blob(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(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
+        )
+    ]
+
+def test_partition_by_tf(cluster):
+    node = cluster.instances["node"]
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    partition_by = "column3"
+    values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
+    filename = "test_tf_{_partition_id}.csv"
+
+    azure_query(node, f"INSERT INTO TABLE FUNCTION azure_blob('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")
+    assert "3,2,1\n" == get_azure_file_content("test_tf_1.csv")
+    assert "78,43,45\n" == get_azure_file_content("test_tf_45.csv")

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 0534/1478] 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 b6c8ce30ec5d8eeff846b273ed8aa2e6b00241f0 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Tue, 6 Jun 2023 19:38:11 +0200
Subject: [PATCH 0535/1478] Disable 01676_clickhouse_client_autocomplete under
 UBSan

---
 .../queries/0_stateless/01676_clickhouse_client_autocomplete.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01676_clickhouse_client_autocomplete.sh b/tests/queries/0_stateless/01676_clickhouse_client_autocomplete.sh
index 42ae5e84f44..db62dedb5b4 100755
--- a/tests/queries/0_stateless/01676_clickhouse_client_autocomplete.sh
+++ b/tests/queries/0_stateless/01676_clickhouse_client_autocomplete.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: long
+# Tags: long, no-ubsan
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From d902592703757c161c8502dd07793c7da62f9b17 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 19:38:15 +0200
Subject: [PATCH 0536/1478] Fix new tests

---
 .../test_storage_azure_blob_storage/test.py   | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 17817ca4e8e..e4e459428d0 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -467,14 +467,14 @@ def test_simple_write_account_string_table_function(cluster):
 
 def test_simple_write_connection_string_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob('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')")
+    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')")
     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'
 
 
 def test_simple_write_named_collection_1_table_function(cluster):
     node = cluster.instances["node"]
-    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob(azure_conf1) VALUES (1, 'a')")
+    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob_storage(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'
 
@@ -482,7 +482,7 @@ def test_simple_write_named_collection_1_table_function(cluster):
 def test_simple_write_named_collection_2_table_function(cluster):
     node = cluster.instances["node"]
 
-    azure_query(node, "INSERT INTO TABLE FUNCTION azure_blob(azure_conf2, container='cont', blob_path='test_simple_write_named_2_tf.csv', format='CSV', structure='key UInt64, data String') VALUES (1, 'a')")
+    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')")
     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'
 
@@ -502,9 +502,9 @@ def test_put_get_with_globs_tf(cluster):
 
             azure_query(
                 node,
-                f"INSERT INTO TABLE FUNCTION azure_blob(azure_conf2, container='cont', blob_path='{path}', format='CSV', compression='auto', structure='{table_format}') VALUES {values}",
+                f"INSERT INTO TABLE FUNCTION azure_blob_storage(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(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 azure_blob_storage(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
@@ -515,10 +515,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(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 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)"
     azure_query(node, query)
 
-    query = "select sum(column1), sum(length(column2)), sum(column3), min(_file), max(_path) from azure_blob(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 azure_blob_storage(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"
     ]
@@ -537,10 +537,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(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames', structure='{table_format}') VALUES {values}"
+            query = f"insert into table function azure_blob_storage(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(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 azure_blob_storage(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
@@ -554,7 +554,7 @@ def test_partition_by_tf(cluster):
     values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
     filename = "test_tf_{_partition_id}.csv"
 
-    azure_query(node, f"INSERT INTO TABLE FUNCTION azure_blob('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', '{table_format}') PARTITION BY {partition_by} VALUES {values}")
+    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}")
 
     assert "1,2,3\n" == get_azure_file_content("test_tf_3.csv")
     assert "3,2,1\n" == get_azure_file_content("test_tf_1.csv")

From 934df5e5bb3714cf031104deff914cde9987eb31 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 19:44:41 +0200
Subject: [PATCH 0537/1478] Rename to AzureBlobStorage

---
 src/Storages/StorageAzure.cpp                 |  2 +-
 .../test_storage_azure_blob_storage/test.py   | 46 +++++++++----------
 2 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index c6001f59b6f..46446940f75 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -251,7 +251,7 @@ AzureObjectStorage::SettingsPtr StorageAzure::createSettings(ContextPtr local_co
 
 void registerStorageAzure(StorageFactory & factory)
 {
-    factory.registerStorage("Azure", [](const StorageFactory::Arguments & args)
+    factory.registerStorage("AzureBlobStorage", [](const StorageFactory::Arguments & args)
     {
         auto & engine_args = args.engine_args;
         if (engine_args.empty())
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index e4e459428d0..9dea5d24686 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -81,7 +81,7 @@ def test_create_table_connection_string(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_create_table_conn_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 'cont', 'test_create_connection_string', 'CSV')",
+        "CREATE TABLE test_create_table_conn_string (key UInt64, data String) Engine = AzureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 'cont', 'test_create_connection_string', 'CSV')",
     )
 
 
@@ -89,7 +89,7 @@ def test_create_table_account_string(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_create_table_account_url (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1',  'cont', 'test_create_connection_string', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
+        "CREATE TABLE test_create_table_account_url (key UInt64, data String) Engine = AzureBlobStorage('http://azurite1:10000/devstoreaccount1',  'cont', 'test_create_connection_string', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
     )
 
 
@@ -97,7 +97,7 @@ def test_simple_write_account_string(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_simple_write (key UInt64, data String) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
+        "CREATE TABLE test_simple_write (key UInt64, data String) Engine = AzureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV')",
     )
     azure_query(node, "INSERT INTO test_simple_write VALUES (1, 'a')")
     print(get_azure_file_content("test_simple_write.csv"))
@@ -108,7 +108,7 @@ def test_simple_write_connection_string(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = Azure('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')",
+        "CREATE TABLE test_simple_write_connection_string (key UInt64, data String) Engine = AzureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_c.csv', 'CSV')",
     )
     azure_query(node, "INSERT INTO test_simple_write_connection_string VALUES (1, 'a')")
     print(get_azure_file_content("test_simple_write_c.csv"))
@@ -119,7 +119,7 @@ def test_simple_write_named_collection_1(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = Azure(azure_conf1)",
+        "CREATE TABLE test_simple_write_named_collection_1 (key UInt64, data String) Engine = AzureBlobStorage(azure_conf1)",
     )
     azure_query(
         node, "INSERT INTO test_simple_write_named_collection_1 VALUES (1, 'a')"
@@ -132,7 +132,7 @@ def test_simple_write_named_collection_2(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')",
+        "CREATE TABLE test_simple_write_named_collection_2 (key UInt64, data String) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_simple_write_named_2.csv', format='CSV')",
     )
     azure_query(
         node, "INSERT INTO test_simple_write_named_collection_2 VALUES (1, 'a')"
@@ -150,7 +150,7 @@ def test_partition_by(cluster):
 
     azure_query(
         node,
-        f"CREATE TABLE test_partitioned_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+        f"CREATE TABLE test_partitioned_write ({table_format}) Engine = AzureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
     )
     azure_query(node, f"INSERT INTO test_partitioned_write VALUES {values}")
 
@@ -167,7 +167,7 @@ def test_partition_by_string_column(cluster):
     filename = "test_{_partition_id}.csv"
     azure_query(
         node,
-        f"CREATE TABLE test_partitioned_string_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+        f"CREATE TABLE test_partitioned_string_write ({table_format}) Engine = AzureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
     )
     azure_query(node, f"INSERT INTO test_partitioned_string_write VALUES {values}")
 
@@ -185,7 +185,7 @@ def test_partition_by_const_column(cluster):
     filename = "test_{_partition_id}.csv"
     azure_query(
         node,
-        f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = Azure('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
+        f"CREATE TABLE test_partitioned_const_write ({table_format}) Engine = AzureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV') PARTITION BY {partition_by}",
     )
     azure_query(node, f"INSERT INTO test_partitioned_const_write VALUES {values}")
     assert values_csv == get_azure_file_content("test_88.csv")
@@ -195,7 +195,7 @@ def test_truncate(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_truncate (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_truncate.csv', format='CSV')",
+        "CREATE TABLE test_truncate (key UInt64, data String) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_truncate.csv', format='CSV')",
     )
     azure_query(node, "INSERT INTO test_truncate VALUES (1, 'a')")
     assert get_azure_file_content("test_truncate.csv") == '1,"a"\n'
@@ -208,7 +208,7 @@ def test_simple_read_write(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "CREATE TABLE test_simple_read_write (key UInt64, data String) Engine = Azure(azure_conf2, container='cont', blob_path='test_simple_read_write.csv', format='CSV')",
+        "CREATE TABLE test_simple_read_write (key UInt64, data String) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_simple_read_write.csv', format='CSV')",
     )
 
     azure_query(node, "INSERT INTO test_simple_read_write VALUES (1, 'a')")
@@ -222,7 +222,7 @@ def test_create_new_files_on_insert(cluster):
 
     azure_query(
         node,
-        f"create table test_multiple_inserts(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet', format='Parquet')",
+        f"create table test_multiple_inserts(a Int32, b String) ENGINE = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_parquet', format='Parquet')",
     )
     azure_query(node, "truncate table test_multiple_inserts")
     azure_query(
@@ -249,7 +249,7 @@ def test_overwrite(cluster):
 
     azure_query(
         node,
-        f"create table test_overwrite(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_parquet_overwrite', format='Parquet')",
+        f"create table test_overwrite(a Int32, b String) ENGINE = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_parquet_overwrite', format='Parquet')",
     )
     azure_query(node, "truncate table test_overwrite")
 
@@ -273,7 +273,7 @@ def test_insert_with_path_with_globs(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        f"create table test_insert_globs(a Int32, b String) ENGINE = Azure(azure_conf2, container='cont', blob_path='test_insert_with_globs*', format='Parquet')",
+        f"create table test_insert_globs(a Int32, b String) ENGINE = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_insert_with_globs*', format='Parquet')",
     )
     node.query_and_get_error(
         f"insert into table function test_insert_globs SELECT number, randomString(100) FROM numbers(500)"
@@ -296,7 +296,7 @@ def test_put_get_with_globs(cluster):
 
             azure_query(
                 node,
-                f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+                f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
             )
 
             query = f"insert into test_{i}_{j} VALUES {values}"
@@ -304,7 +304,7 @@ def test_put_get_with_globs(cluster):
 
     azure_query(
         node,
-        f"CREATE TABLE test_glob_select ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV')",
+        f"CREATE TABLE test_glob_select ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV')",
     )
     query = "select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from test_glob_select"
     assert azure_query(node, query).splitlines() == [
@@ -328,7 +328,7 @@ def test_azure_glob_scheherazade(cluster):
                 unique_num = random.randint(1, 10000)
                 azure_query(
                     node,
-                    f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+                    f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
                 )
                 query = f"insert into test_{i}_{unique_num} VALUES {values}"
                 azure_query(node, query)
@@ -345,7 +345,7 @@ def test_azure_glob_scheherazade(cluster):
 
     azure_query(
         node,
-        f"CREATE TABLE test_glob_select_scheherazade ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='night_*/tale.csv', format='CSV')",
+        f"CREATE TABLE test_glob_select_scheherazade ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='night_*/tale.csv', format='CSV')",
     )
     query = "select count(), sum(column1), sum(column2), sum(column3) from test_glob_select_scheherazade"
     assert azure_query(node, query).splitlines() == ["1001\t1001\t1001\t1001"]
@@ -387,7 +387,7 @@ def test_storage_azure_get_gzip(cluster, extension, method):
 
     azure_query(
         node,
-        f"""CREATE TABLE {name} (name String, id UInt32) ENGINE = Azure(
+        f"""CREATE TABLE {name} (name String, id UInt32) ENGINE = AzureBlobStorage(
                                 azure_conf2, container='cont', blob_path ='{filename}',
                                 format='CSV',
                                 compression='{method}')""",
@@ -402,7 +402,7 @@ def test_schema_inference_no_globs(cluster):
     table_format = "column1 UInt32, column2 String, column3 UInt32"
     azure_query(
         node,
-        f"CREATE TABLE test_schema_inference_src ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv', format='CSVWithNames')",
+        f"CREATE TABLE test_schema_inference_src ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv', format='CSVWithNames')",
     )
 
     query = f"insert into test_schema_inference_src SELECT number, toString(number), number * number FROM numbers(1000)"
@@ -410,7 +410,7 @@ def test_schema_inference_no_globs(cluster):
 
     azure_query(
         node,
-        f"CREATE TABLE test_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv')",
+        f"CREATE TABLE test_select_inference Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs.csv')",
     )
 
     print(node.query("SHOW CREATE TABLE test_select_inference"))
@@ -437,7 +437,7 @@ def test_schema_inference_from_globs(cluster):
 
             azure_query(
                 node,
-                f"CREATE TABLE test_schema_{i}_{j} ({table_format}) Engine = Azure(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames')",
+                f"CREATE TABLE test_schema_{i}_{j} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames')",
             )
 
             query = f"insert into test_schema_{i}_{j} VALUES {values}"
@@ -445,7 +445,7 @@ def test_schema_inference_from_globs(cluster):
 
     azure_query(
         node,
-        f"CREATE TABLE test_glob_select_inference Engine = Azure(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')",
+        f"CREATE TABLE test_glob_select_inference Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')",
     )
 
     print(node.query("SHOW CREATE TABLE test_glob_select_inference"))

From e9c267ed696f30d440b35ed3bb215d550eb8aec7 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 6 Jun 2023 17:51:53 +0000
Subject: [PATCH 0538/1478] Fix converting Null to LowCardinality(Nullable) in
 values table function

---
 src/Interpreters/convertFieldToType.cpp                         | 2 +-
 .../0_stateless/02782_values_null_to_lc_nullable.reference      | 1 +
 tests/queries/0_stateless/02782_values_null_to_lc_nullable.sql  | 2 ++
 3 files changed, 4 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02782_values_null_to_lc_nullable.reference
 create mode 100644 tests/queries/0_stateless/02782_values_null_to_lc_nullable.sql

diff --git a/src/Interpreters/convertFieldToType.cpp b/src/Interpreters/convertFieldToType.cpp
index dc61e748db6..3e8fab80aaf 100644
--- a/src/Interpreters/convertFieldToType.cpp
+++ b/src/Interpreters/convertFieldToType.cpp
@@ -534,7 +534,7 @@ Field convertFieldToType(const Field & from_value, const IDataType & to_type, co
 Field convertFieldToTypeOrThrow(const Field & from_value, const IDataType & to_type, const IDataType * from_type_hint)
 {
     bool is_null = from_value.isNull();
-    if (is_null && !to_type.isNullable())
+    if (is_null && !to_type.isNullable() && !to_type.isLowCardinalityNullable())
         throw Exception(ErrorCodes::TYPE_MISMATCH, "Cannot convert NULL to {}", to_type.getName());
 
     Field converted = convertFieldToType(from_value, to_type, from_type_hint);
diff --git a/tests/queries/0_stateless/02782_values_null_to_lc_nullable.reference b/tests/queries/0_stateless/02782_values_null_to_lc_nullable.reference
new file mode 100644
index 00000000000..dec7d2fabd2
--- /dev/null
+++ b/tests/queries/0_stateless/02782_values_null_to_lc_nullable.reference
@@ -0,0 +1 @@
+\N
diff --git a/tests/queries/0_stateless/02782_values_null_to_lc_nullable.sql b/tests/queries/0_stateless/02782_values_null_to_lc_nullable.sql
new file mode 100644
index 00000000000..250fe6b7551
--- /dev/null
+++ b/tests/queries/0_stateless/02782_values_null_to_lc_nullable.sql
@@ -0,0 +1,2 @@
+select * from values('s LowCardinality(Nullable(String))', (NULL));
+

From 95b054b42523f3e8271a095bbb570c1d02181ccd Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 6 Jun 2023 18:01:22 +0000
Subject: [PATCH 0539/1478] Automatic style fix

---
 .../test_storage_azure_blob_storage/test.py   | 29 +++++++++++++++----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 9dea5d24686..8a0a68f5200 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -460,21 +460,30 @@ def test_schema_inference_from_globs(cluster):
 
 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')")
+    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')",
+    )
     print(get_azure_file_content("test_simple_write_tf.csv"))
     assert get_azure_file_content("test_simple_write_tf.csv") == '1,"a"\n'
 
 
 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')")
+    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')",
+    )
     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'
 
 
 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')")
+    azure_query(
+        node,
+        "INSERT INTO TABLE FUNCTION azure_blob_storage(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'
 
@@ -482,10 +491,14 @@ def test_simple_write_named_collection_1_table_function(cluster):
 def test_simple_write_named_collection_2_table_function(cluster):
     node = cluster.instances["node"]
 
-    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')")
+    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')",
+    )
     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'
 
+
 def test_put_get_with_globs_tf(cluster):
     # type: (ClickHouseCluster) -> None
     unique_prefix = random.randint(1, 10000)
@@ -511,6 +524,7 @@ def test_put_get_with_globs_tf(cluster):
         )
     ]
 
+
 def test_schema_inference_no_globs_tf(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 String, column3 UInt32"
@@ -523,6 +537,7 @@ def test_schema_inference_no_globs_tf(cluster):
         "499500\t2890\t332833500\ttest_schema_inference_no_globs_tf.csv\tcont/test_schema_inference_no_globs_tf.csv"
     ]
 
+
 def test_schema_inference_from_globs_tf(cluster):
     node = cluster.instances["node"]
     unique_prefix = random.randint(1, 10000)
@@ -547,6 +562,7 @@ def test_schema_inference_from_globs_tf(cluster):
         )
     ]
 
+
 def test_partition_by_tf(cluster):
     node = cluster.instances["node"]
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
@@ -554,7 +570,10 @@ def test_partition_by_tf(cluster):
     values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
     filename = "test_tf_{_partition_id}.csv"
 
-    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}")
+    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}",
+    )
 
     assert "1,2,3\n" == get_azure_file_content("test_tf_3.csv")
     assert "3,2,1\n" == get_azure_file_content("test_tf_1.csv")

From 49b019b26dfb674d31fa752335711c135377df4c Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 20:23:20 +0200
Subject: [PATCH 0540/1478] Refactored TableFunction name to
 TableFunctionAzureBlobStorage

---
 src/TableFunctions/ITableFunctionCluster.h    | 10 ++++-----
 ....cpp => TableFunctionAzureBlobStorage.cpp} | 22 +++++++++----------
 ...zure.h => TableFunctionAzureBlobStorage.h} |  2 +-
 src/TableFunctions/registerTableFunctions.cpp |  2 +-
 src/TableFunctions/registerTableFunctions.h   |  2 +-
 5 files changed, 19 insertions(+), 19 deletions(-)
 rename src/TableFunctions/{TableFunctionAzure.cpp => TableFunctionAzureBlobStorage.cpp} (88%)
 rename src/TableFunctions/{TableFunctionAzure.h => TableFunctionAzureBlobStorage.h} (97%)

diff --git a/src/TableFunctions/ITableFunctionCluster.h b/src/TableFunctions/ITableFunctionCluster.h
index f68558596ca..a8329684ee6 100644
--- a/src/TableFunctions/ITableFunctionCluster.h
+++ b/src/TableFunctions/ITableFunctionCluster.h
@@ -2,13 +2,13 @@
 
 #include "config.h"
 
-#include <TableFunctions/ITableFunction.h>
-#include <TableFunctions/TableFunctionS3.h>
-#include <TableFunctions/TableFunctionAzure.h>
-#include <Storages/StorageS3Cluster.h>
-#include <Interpreters/evaluateConstantExpression.h>
 #include <Interpreters/Context.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Storages/StorageS3Cluster.h>
 #include <Storages/checkAndGetLiteralArgument.h>
+#include <TableFunctions/ITableFunction.h>
+#include <TableFunctions/TableFunctionAzureBlobStorage.h>
+#include <TableFunctions/TableFunctionS3.h>
 
 
 namespace DB
diff --git a/src/TableFunctions/TableFunctionAzure.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
similarity index 88%
rename from src/TableFunctions/TableFunctionAzure.cpp
rename to src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index e2d88a85eec..07bdb0f8393 100644
--- a/src/TableFunctions/TableFunctionAzure.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -7,7 +7,7 @@
 #include <Interpreters/Context.h>
 #include <TableFunctions/TableFunctionFactory.h>
 #include <TableFunctions/TableFunctionS3.h>
-#include <TableFunctions/TableFunctionAzure.h>
+#include <TableFunctions/TableFunctionAzureBlobStorage.h>
 #include <Interpreters/parseColumnsListForTableFunction.h>
 #include <Access/Common/AccessFlags.h>
 #include <Parsers/ASTLiteral.h>
@@ -46,13 +46,13 @@ bool isConnectionString(const std::string & candidate)
 
 }
 
-StorageAzure::Configuration TableFunctionAzure::parseArgumentsImpl(ASTs & engine_args, const ContextPtr & local_context, bool get_format_from_file)
+StorageAzure::Configuration TableFunctionAzureBlobStorage::parseArgumentsImpl(ASTs & engine_args, const ContextPtr & local_context, bool get_format_from_file)
 {
     StorageAzure::Configuration configuration;
 
     /// Supported signatures:
     ///
-    /// Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])
+    /// AzureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])
     ///
 
     if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, local_context))
@@ -70,7 +70,7 @@ StorageAzure::Configuration TableFunctionAzure::parseArgumentsImpl(ASTs & engine
     if (engine_args.size() < 3 || engine_args.size() > 8)
         throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
                         "Storage Azure requires 3 to 7 arguments: "
-                        "Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])");
+                        "AzureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])");
 
     for (auto & engine_arg : engine_args)
         engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, local_context);
@@ -181,7 +181,7 @@ StorageAzure::Configuration TableFunctionAzure::parseArgumentsImpl(ASTs & engine
     return configuration;
 }
 
-void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr context)
+void TableFunctionAzureBlobStorage::parseArguments(const ASTPtr & ast_function, ContextPtr context)
 {
     /// Clone ast function, because we can modify its arguments like removing headers.
     auto ast_copy = ast_function->clone();
@@ -197,7 +197,7 @@ void TableFunctionAzure::parseArguments(const ASTPtr & ast_function, ContextPtr
     LOG_DEBUG(&Poco::Logger::get("DEBUG"), "CONFIGURATION {}", configuration.connection_url);
 }
 
-ColumnsDescription TableFunctionAzure::getActualTableStructure(ContextPtr context) const
+ColumnsDescription TableFunctionAzureBlobStorage::getActualTableStructure(ContextPtr context) const
 {
     if (configuration.structure == "auto")
     {
@@ -205,19 +205,19 @@ ColumnsDescription TableFunctionAzure::getActualTableStructure(ContextPtr contex
         auto client = StorageAzure::createClient(configuration);
         auto settings = StorageAzure::createSettings(context);
 
-        auto object_storage = std::make_unique<AzureObjectStorage>("AzureTableFunction", std::move(client), std::move(settings));
+        auto object_storage = std::make_unique<AzureObjectStorage>("AzureBlobStorageTableFunction", std::move(client), std::move(settings));
         return StorageAzure::getTableStructureFromData(object_storage.get(), configuration, std::nullopt, context);
     }
 
     return parseColumnsListFromString(configuration.structure, context);
 }
 
-bool TableFunctionAzure::supportsReadingSubsetOfColumns()
+bool TableFunctionAzureBlobStorage::supportsReadingSubsetOfColumns()
 {
     return FormatFactory::instance().checkIfFormatSupportsSubsetOfColumns(configuration.format);
 }
 
-StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
+StoragePtr TableFunctionAzureBlobStorage::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
 {
     auto client = StorageAzure::createClient(configuration);
     auto settings = StorageAzure::createSettings(context);
@@ -245,9 +245,9 @@ StoragePtr TableFunctionAzure::executeImpl(const ASTPtr & /*ast_function*/, Cont
     return storage;
 }
 
-void registerTableFunctionAzure(TableFunctionFactory & factory)
+void registerTableFunctionAzureBlobStorage(TableFunctionFactory & factory)
 {
-    factory.registerFunction<TableFunctionAzure>(
+    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)", ""}}},
diff --git a/src/TableFunctions/TableFunctionAzure.h b/src/TableFunctions/TableFunctionAzureBlobStorage.h
similarity index 97%
rename from src/TableFunctions/TableFunctionAzure.h
rename to src/TableFunctions/TableFunctionAzureBlobStorage.h
index e2815973010..6f3a3422958 100644
--- a/src/TableFunctions/TableFunctionAzure.h
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.h
@@ -15,7 +15,7 @@ class Context;
 
 /* AzureBlob(source, [access_key_id, secret_access_key,] [format, structure, compression]) - creates a temporary storage for a file in AzureBlob.
  */
-class TableFunctionAzure : public ITableFunction
+class TableFunctionAzureBlobStorage : public ITableFunction
 {
 public:
     static constexpr auto name = "azure_blob_storage";
diff --git a/src/TableFunctions/registerTableFunctions.cpp b/src/TableFunctions/registerTableFunctions.cpp
index e0114368e44..0499524a912 100644
--- a/src/TableFunctions/registerTableFunctions.cpp
+++ b/src/TableFunctions/registerTableFunctions.cpp
@@ -73,7 +73,7 @@ void registerTableFunctions()
     registerTableFunctionExplain(factory);
 
 #if USE_AZURE_BLOB_STORAGE
-    registerTableFunctionAzure(factory);
+    registerTableFunctionAzureBlobStorage(factory);
 #endif
 
 
diff --git a/src/TableFunctions/registerTableFunctions.h b/src/TableFunctions/registerTableFunctions.h
index fa4fec2b03a..393bc080a3d 100644
--- a/src/TableFunctions/registerTableFunctions.h
+++ b/src/TableFunctions/registerTableFunctions.h
@@ -70,7 +70,7 @@ void registerTableFunctionFormat(TableFunctionFactory & factory);
 void registerTableFunctionExplain(TableFunctionFactory & factory);
 
 #if USE_AZURE_BLOB_STORAGE
-void registerTableFunctionAzure(TableFunctionFactory & factory);
+void registerTableFunctionAzureBlobStorage(TableFunctionFactory & factory);
 #endif
 
 void registerTableFunctions();

From ceab5117a923be20e8caf46d6330cdb76e0f9a6b Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 20:39:54 +0200
Subject: [PATCH 0541/1478] Fxi style

---
 src/Storages/StorageAzure.cpp | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index 46446940f75..f683a62e8e1 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -12,7 +12,6 @@
 #include <IO/SharedThreadPools.h>
 
 #include <Parsers/ASTCreateQuery.h>
-#include <Formats/FormatFactory.h>
 #include <Formats/ReadSchemaUtils.h>
 #include <DataTypes/DataTypeString.h>
 #include <DataTypes/DataTypesNumber.h>
@@ -29,7 +28,6 @@
 #include <Storages/PartitionedSink.h>
 #include <Storages/VirtualColumnUtils.h>
 #include <Storages/getVirtualsForStorage.h>
-#include <Storages/checkAndGetLiteralArgument.h>
 #include <Storages/StorageURL.h>
 #include <Storages/NamedCollectionsHelpers.h>
 #include <Storages/ReadFromStorageProgress.h>
@@ -806,7 +804,7 @@ StorageAzureSource::Iterator::Iterator(
     , outer_blobs(outer_blobs_)
 {
     if (keys.has_value() && blob_path_with_globs.has_value())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot specify keys and glob simulatenously it's a bug");
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot specify keys and glob simultaneously it's a bug");
 
     if (!keys.has_value() && !blob_path_with_globs.has_value())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Both keys and glob mask are not specified");

From 5637858182e98070a9435e858c83ccaca316dd0a Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 21:06:45 +0200
Subject: [PATCH 0542/1478] Fix the most important check in the world

---
 src/Storages/StorageAzure.cpp                        | 3 +++
 src/Storages/StorageAzure.h                          | 5 -----
 src/Storages/registerStorages.cpp                    | 4 ----
 src/TableFunctions/TableFunctionAzureBlobStorage.cpp | 2 +-
 4 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzure.cpp
index f683a62e8e1..ac7ae8a4b36 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzure.cpp
@@ -60,6 +60,9 @@ namespace ErrorCodes
     extern const int DATABASE_ACCESS_DENIED;
     extern const int CANNOT_COMPILE_REGEXP;
     extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
+    extern const int LOGICAL_ERROR;
+    extern const int NOT_IMPLEMENTED;
+
 }
 
 namespace
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzure.h
index 8341026b624..826582ccaa5 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzure.h
@@ -20,11 +20,6 @@ struct AzureSimpleAccountConfiguration
     std::string storage_account_url;
 };
 
-namespace ErrorCodes
-{
-    extern const int NOT_IMPLEMENTED;
-}
-
 using AzureConnectionString = std::string;
 
 using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConnectionString>;
diff --git a/src/Storages/registerStorages.cpp b/src/Storages/registerStorages.cpp
index 03bd4dbb310..c66cf85a29b 100644
--- a/src/Storages/registerStorages.cpp
+++ b/src/Storages/registerStorages.cpp
@@ -94,14 +94,10 @@ void registerStorageFileLog(StorageFactory & factory);
 void registerStorageSQLite(StorageFactory & factory);
 #endif
 
-
-
 void registerStorageKeeperMap(StorageFactory & factory);
 
 #if USE_AZURE_BLOB_STORAGE
-
 void registerStorageAzure(StorageFactory & factory);
-
 #endif
 
 void registerStorages()
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index 07bdb0f8393..96131bd884a 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -33,7 +33,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
-    extern const int LOGICAL_ERROR;
+    extern const int BAD_ARGUMENTS;
 }
 
 namespace

From 42c054789561920adf7ce4770968ba303a70f244 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 6 Jun 2023 19:25:43 +0000
Subject: [PATCH 0543/1478] Remove clang-tidy exclude

---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 1a28f28f746..ffed9e01df0 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -123,7 +123,6 @@ MergeTreeIndexAggregatorAnnoy<Distance>::MergeTreeIndexAggregatorAnnoy(
 template <typename Distance>
 MergeTreeIndexGranulePtr MergeTreeIndexAggregatorAnnoy<Distance>::getGranuleAndReset()
 {
-    // NOLINTNEXTLINE(*)
     index->build(static_cast<int>(trees), /*number_of_threads=*/1);
     auto granule = std::make_shared<MergeTreeIndexGranuleAnnoy<Distance>>(index_name, index_sample_block, index);
     index = nullptr;

From 99f0be8ef507b197f12f285548d94bbf1f4dc3c2 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 6 Jun 2023 21:58:54 +0200
Subject: [PATCH 0544/1478] Refactored to StorageAzureBlob

---
 ...{StorageAzure.cpp => StorageAzureBlob.cpp} | 124 +++++++++---------
 .../{StorageAzure.h => StorageAzureBlob.h}    |  18 +--
 .../TableFunctionAzureBlobStorage.cpp         |  20 +--
 .../TableFunctionAzureBlobStorage.h           |   6 +-
 4 files changed, 84 insertions(+), 84 deletions(-)
 rename src/Storages/{StorageAzure.cpp => StorageAzureBlob.cpp} (90%)
 rename src/Storages/{StorageAzure.h => StorageAzureBlob.h} (93%)

diff --git a/src/Storages/StorageAzure.cpp b/src/Storages/StorageAzureBlob.cpp
similarity index 90%
rename from src/Storages/StorageAzure.cpp
rename to src/Storages/StorageAzureBlob.cpp
index ac7ae8a4b36..17374ba2d92 100644
--- a/src/Storages/StorageAzure.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -1,4 +1,4 @@
-#include <Storages/StorageAzure.h>
+#include <Storages/StorageAzureBlob.h>
 
 
 #if USE_AZURE_BLOB_STORAGE
@@ -91,7 +91,7 @@ bool isConnectionString(const std::string & candidate)
 
 }
 
-void StorageAzure::processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection)
+void StorageAzureBlob::processNamedCollectionResult(StorageAzureBlob::Configuration & configuration, const NamedCollection & collection)
 {
     validateNamedCollection(collection, required_configuration_keys, optional_configuration_keys);
 
@@ -122,15 +122,15 @@ void StorageAzure::processNamedCollectionResult(StorageAzure::Configuration & co
 }
 
 
-StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
+StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
 {
-    LOG_INFO(&Poco::Logger::get("StorageAzure"), "get_format_from_file  = {}", get_format_from_file);
+    LOG_INFO(&Poco::Logger::get("StorageAzureBlob"), "get_format_from_file  = {}", get_format_from_file);
 
-    StorageAzure::Configuration configuration;
+    StorageAzureBlob::Configuration configuration;
 
     /// Supported signatures:
     ///
-    /// Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])
+    /// AzureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])
     ///
 
     if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, local_context))
@@ -147,8 +147,8 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 
     if (engine_args.size() < 3 || engine_args.size() > 7)
         throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
-                        "Storage Azure requires 3 to 7 arguments: "
-                        "Azure(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])");
+                        "Storage AzureBlobStorage requires 3 to 7 arguments: "
+                        "AzureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])");
 
     for (auto & engine_arg : engine_args)
         engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, local_context);
@@ -239,7 +239,7 @@ StorageAzure::Configuration StorageAzure::getConfiguration(ASTs & engine_args, C
 }
 
 
-AzureObjectStorage::SettingsPtr StorageAzure::createSettings(ContextPtr local_context)
+AzureObjectStorage::SettingsPtr StorageAzureBlob::createSettings(ContextPtr local_context)
 {
     const auto & context_settings = local_context->getSettingsRef();
     auto settings_ptr = std::make_unique<AzureObjectStorageSettings>();
@@ -250,7 +250,7 @@ AzureObjectStorage::SettingsPtr StorageAzure::createSettings(ContextPtr local_co
     return settings_ptr;
 }
 
-void registerStorageAzure(StorageFactory & factory)
+void registerStorageAzureBlob(StorageFactory & factory)
 {
     factory.registerStorage("AzureBlobStorage", [](const StorageFactory::Arguments & args)
     {
@@ -258,8 +258,8 @@ void registerStorageAzure(StorageFactory & factory)
         if (engine_args.empty())
             throw Exception(ErrorCodes::BAD_ARGUMENTS, "External data source must have arguments");
 
-        auto configuration = StorageAzure::getConfiguration(engine_args, args.getLocalContext());
-        auto client = StorageAzure::createClient(configuration);
+        auto configuration = StorageAzureBlob::getConfiguration(engine_args, args.getLocalContext());
+        auto client = StorageAzureBlob::createClient(configuration);
         // Use format settings from global server context + settings from
         // the SETTINGS clause of the create query. Settings from current
         // session and user are ignored.
@@ -290,11 +290,11 @@ void registerStorageAzure(StorageFactory & factory)
         if (args.storage_def->partition_by)
             partition_by = args.storage_def->partition_by->clone();
 
-        auto settings = StorageAzure::createSettings(args.getContext());
+        auto settings = StorageAzureBlob::createSettings(args.getContext());
 
-        return std::make_shared<StorageAzure>(
+        return std::make_shared<StorageAzureBlob>(
             std::move(configuration),
-            std::make_unique<AzureObjectStorage>("AzureStorage", std::move(client), std::move(settings)),
+            std::make_unique<AzureObjectStorage>("AzureBlobStorage", std::move(client), std::move(settings)),
             args.getContext(),
             args.table_id,
             args.columns,
@@ -311,7 +311,7 @@ void registerStorageAzure(StorageFactory & factory)
     });
 }
 
-AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configuration)
+AzureClientPtr StorageAzureBlob::createClient(StorageAzureBlob::Configuration configuration)
 {
     AzureClientPtr result;
 
@@ -375,7 +375,7 @@ AzureClientPtr StorageAzure::createClient(StorageAzure::Configuration configurat
     return result;
 }
 
-Poco::URI StorageAzure::Configuration::getConnectionURL() const
+Poco::URI StorageAzureBlob::Configuration::getConnectionURL() const
 {
     if (!is_connection_string)
         return Poco::URI(connection_url);
@@ -385,7 +385,7 @@ Poco::URI StorageAzure::Configuration::getConnectionURL() const
 }
 
 
-StorageAzure::StorageAzure(
+StorageAzureBlob::StorageAzureBlob(
     const Configuration & configuration_,
     std::unique_ptr<AzureObjectStorage> && object_storage_,
     ContextPtr context,
@@ -434,7 +434,7 @@ StorageAzure::StorageAzure(
         virtual_block.insert({column.type->createColumn(), column.type, column.name});
 }
 
-void StorageAzure::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
+void StorageAzureBlob::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
 {
     if (configuration.withGlobs())
     {
@@ -454,10 +454,10 @@ void StorageAzure::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextP
 namespace
 {
 
-class StorageAzureSink : public SinkToStorage
+class StorageAzureBlobSink : public SinkToStorage
 {
 public:
-    StorageAzureSink(
+    StorageAzureBlobSink(
         const String & format,
         const Block & sample_block_,
         ContextPtr context,
@@ -474,7 +474,7 @@ public:
         writer = FormatFactory::instance().getOutputFormatParallelIfPossible(format, *write_buf, sample_block, context, format_settings);
     }
 
-    String getName() const override { return "StorageS3Sink"; }
+    String getName() const override { return "StorageAzureBlobSink"; }
 
     void consume(Chunk chunk) override
     {
@@ -532,10 +532,10 @@ private:
     std::mutex cancel_mutex;
 };
 
-class PartitionedStorageAzureSink : public PartitionedSink
+class PartitionedStorageAzureBlobSink : public PartitionedSink
 {
 public:
-    PartitionedStorageAzureSink(
+    PartitionedStorageAzureBlobSink(
         const ASTPtr & partition_by,
         const String & format_,
         const Block & sample_block_,
@@ -560,7 +560,7 @@ public:
         auto partition_key = replaceWildcards(blob, partition_id);
         validateKey(partition_key);
 
-        return std::make_shared<StorageAzureSink>(
+        return std::make_shared<StorageAzureBlobSink>(
             format,
             sample_block,
             context,
@@ -590,7 +590,7 @@ private:
 
 }
 
-Pipe StorageAzure::read(
+Pipe StorageAzureBlob::read(
     const Names & column_names,
     const StorageSnapshotPtr &  storage_snapshot,
     SelectQueryInfo & query_info,
@@ -613,17 +613,17 @@ Pipe StorageAzure::read(
             requested_virtual_columns.push_back(virtual_column);
     }
 
-    std::shared_ptr<StorageAzureSource::Iterator> iterator_wrapper;
+    std::shared_ptr<StorageAzureBlobSource::Iterator> iterator_wrapper;
     if (configuration.withGlobs())
     {
         /// Iterate through disclosed globs and make a source for each file
-        iterator_wrapper = std::make_shared<StorageAzureSource::Iterator>(
+        iterator_wrapper = std::make_shared<StorageAzureBlobSource::Iterator>(
             object_storage.get(), configuration.container, std::nullopt,
             configuration.blob_path, query_info.query, virtual_block, local_context, nullptr);
     }
     else
     {
-        iterator_wrapper = std::make_shared<StorageAzureSource::Iterator>(
+        iterator_wrapper = std::make_shared<StorageAzureBlobSource::Iterator>(
             object_storage.get(), configuration.container, configuration.blobs_paths,
             std::nullopt, query_info.query, virtual_block, local_context, nullptr);
     }
@@ -653,7 +653,7 @@ Pipe StorageAzure::read(
 
     for (size_t i = 0; i < num_streams; ++i)
     {
-        pipes.emplace_back(std::make_shared<StorageAzureSource>(
+        pipes.emplace_back(std::make_shared<StorageAzureBlobSource>(
             requested_virtual_columns,
             configuration.format,
             getName(),
@@ -671,7 +671,7 @@ Pipe StorageAzure::read(
     return Pipe::unitePipes(std::move(pipes));
 }
 
-SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageAzureBlob::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
 {
     auto sample_block = metadata_snapshot->getSampleBlock();
     auto chosen_compression_method = chooseCompressionMethod(configuration.blobs_paths.back(), configuration.compression_method);
@@ -682,7 +682,7 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
 
     if (is_partitioned_implementation)
     {
-        return std::make_shared<PartitionedStorageAzureSink>(
+        return std::make_shared<PartitionedStorageAzureBlobSink>(
             partition_by_ast,
             configuration.format,
             sample_block,
@@ -696,7 +696,7 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
     {
         if (configuration.withGlobs())
             throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED,
-                            "Azure key '{}' contains globs, so the table is in readonly mode", configuration.blob_path);
+                            "AzureBlobStorage key '{}' contains globs, so the table is in readonly mode", configuration.blob_path);
 
         bool truncate_in_insert = local_context->getSettingsRef().azure_truncate_on_insert;
 
@@ -730,7 +730,7 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
             }
         }
 
-        return std::make_shared<StorageAzureSink>(
+        return std::make_shared<StorageAzureBlobSink>(
             configuration.format,
             sample_block,
             local_context,
@@ -741,32 +741,32 @@ SinkToStoragePtr StorageAzure::write(const ASTPtr & query, const StorageMetadata
     }
 }
 
-NamesAndTypesList StorageAzure::getVirtuals() const
+NamesAndTypesList StorageAzureBlob::getVirtuals() const
 {
     return virtual_columns;
 }
 
-bool StorageAzure::supportsPartitionBy() const
+bool StorageAzureBlob::supportsPartitionBy() const
 {
     return true;
 }
 
-bool StorageAzure::supportsSubcolumns() const
+bool StorageAzureBlob::supportsSubcolumns() const
 {
     return FormatFactory::instance().checkIfFormatSupportsSubcolumns(configuration.format);
 }
 
-bool StorageAzure::supportsSubsetOfColumns() const
+bool StorageAzureBlob::supportsSubsetOfColumns() const
 {
     return FormatFactory::instance().checkIfFormatSupportsSubsetOfColumns(configuration.format);
 }
 
-bool StorageAzure::prefersLargeBlocks() const
+bool StorageAzureBlob::prefersLargeBlocks() const
 {
     return FormatFactory::instance().checkIfOutputFormatPrefersLargeBlocks(configuration.format);
 }
 
-bool StorageAzure::parallelizeOutputAfterReading(ContextPtr context) const
+bool StorageAzureBlob::parallelizeOutputAfterReading(ContextPtr context) const
 {
     return FormatFactory::instance().checkParallelizeOutputAfterReading(configuration.format, context);
 }
@@ -788,7 +788,7 @@ static void addPathToVirtualColumns(Block & block, const String & path, size_t i
     block.getByName("_idx").column->assumeMutableRef().insert(idx);
 }
 
-StorageAzureSource::Iterator::Iterator(
+StorageAzureBlobSource::Iterator::Iterator(
     AzureObjectStorage * object_storage_,
     const std::string & container_,
     std::optional<Strings> keys_,
@@ -886,7 +886,7 @@ StorageAzureSource::Iterator::Iterator(
 
 }
 
-RelativePathWithMetadata StorageAzureSource::Iterator::next()
+RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
 {
     if (is_finished)
         return {};
@@ -971,13 +971,13 @@ RelativePathWithMetadata StorageAzureSource::Iterator::next()
     }
 }
 
-size_t StorageAzureSource::Iterator::getTotalSize() const
+size_t StorageAzureBlobSource::Iterator::getTotalSize() const
 {
     return total_size.load(std::memory_order_relaxed);
 }
 
 
-void StorageAzureSource::Iterator::createFilterAST(const String & any_key)
+void StorageAzureBlobSource::Iterator::createFilterAST(const String & any_key)
 {
     if (!query || !virtual_header)
         return;
@@ -992,7 +992,7 @@ void StorageAzureSource::Iterator::createFilterAST(const String & any_key)
 }
 
 
-Chunk StorageAzureSource::generate()
+Chunk StorageAzureBlobSource::generate()
 {
     while (true)
     {
@@ -1049,7 +1049,7 @@ Chunk StorageAzureSource::generate()
     return {};
 }
 
-Block StorageAzureSource::getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns)
+Block StorageAzureBlobSource::getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns)
 {
     for (const auto & virtual_column : requested_virtual_columns)
         sample_block.insert({virtual_column.type->createColumn(), virtual_column.type, virtual_column.name});
@@ -1057,7 +1057,7 @@ Block StorageAzureSource::getHeader(Block sample_block, const std::vector<NameAn
     return sample_block;
 }
 
-StorageAzureSource::StorageAzureSource(
+StorageAzureBlobSource::StorageAzureBlobSource(
     const std::vector<NameAndTypePair> & requested_virtual_columns_,
     const String & format_,
     String name_,
@@ -1092,17 +1092,17 @@ StorageAzureSource::StorageAzureSource(
 }
 
 
-StorageAzureSource::~StorageAzureSource()
+StorageAzureBlobSource::~StorageAzureBlobSource()
 {
     create_reader_pool.wait();
 }
 
-String StorageAzureSource::getName() const
+String StorageAzureBlobSource::getName() const
 {
     return name;
 }
 
-StorageAzureSource::ReaderHolder StorageAzureSource::createReader()
+StorageAzureBlobSource::ReaderHolder StorageAzureBlobSource::createReader()
 {
     auto [current_key, info] = file_iterator->next();
     LOG_DEBUG(log, "KEY {} SIZE {}", current_key, info.size_bytes);
@@ -1135,12 +1135,12 @@ StorageAzureSource::ReaderHolder StorageAzureSource::createReader()
     return ReaderHolder{fs::path(container) / current_key, std::move(read_buf), std::move(pipeline), std::move(current_reader)};
 }
 
-std::future<StorageAzureSource::ReaderHolder> StorageAzureSource::createReaderAsync()
+std::future<StorageAzureBlobSource::ReaderHolder> StorageAzureBlobSource::createReaderAsync()
 {
     return create_reader_scheduler([this] { return createReader(); }, Priority{});
 }
 
-std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const String & key, size_t object_size)
+std::unique_ptr<ReadBuffer> StorageAzureBlobSource::createAzureReadBuffer(const String & key, size_t object_size)
 {
     auto read_settings = getContext()->getReadSettings().adjustBufferSize(object_size);
     read_settings.enable_filesystem_cache = false;
@@ -1159,23 +1159,23 @@ std::unique_ptr<ReadBuffer> StorageAzureSource::createAzureReadBuffer(const Stri
     return object_storage->readObject(StoredObject(key), read_settings, {}, object_size);
 }
 
-ColumnsDescription StorageAzure::getTableStructureFromData(
+ColumnsDescription StorageAzureBlob::getTableStructureFromData(
     AzureObjectStorage * object_storage,
     const Configuration & configuration,
     const std::optional<FormatSettings> & format_settings,
     ContextPtr ctx)
 {
     RelativePathsWithMetadata read_keys;
-    std::shared_ptr<StorageAzureSource::Iterator> file_iterator;
+    std::shared_ptr<StorageAzureBlobSource::Iterator> file_iterator;
     if (configuration.withGlobs())
     {
-        file_iterator = std::make_shared<StorageAzureSource::Iterator>(
+        file_iterator = std::make_shared<StorageAzureBlobSource::Iterator>(
             object_storage, configuration.container, std::nullopt,
             configuration.blob_path, nullptr, Block{}, ctx, &read_keys);
     }
     else
     {
-        file_iterator = std::make_shared<StorageAzureSource::Iterator>(
+        file_iterator = std::make_shared<StorageAzureBlobSource::Iterator>(
             object_storage, configuration.container, configuration.blobs_paths,
             std::nullopt, nullptr, Block{}, ctx, &read_keys);
     }
@@ -1233,10 +1233,10 @@ ColumnsDescription StorageAzure::getTableStructureFromData(
 
 }
 
-std::optional<ColumnsDescription> StorageAzure::tryGetColumnsFromCache(
+std::optional<ColumnsDescription> StorageAzureBlob::tryGetColumnsFromCache(
         const RelativePathsWithMetadata::const_iterator & begin,
         const RelativePathsWithMetadata::const_iterator & end,
-        const StorageAzure::Configuration & configuration,
+        const StorageAzureBlob::Configuration & configuration,
         const std::optional<FormatSettings> & format_settings,
         const ContextPtr & ctx)
 {
@@ -1260,10 +1260,10 @@ std::optional<ColumnsDescription> StorageAzure::tryGetColumnsFromCache(
 
 }
 
-void StorageAzure::addColumnsToCache(
+void StorageAzureBlob::addColumnsToCache(
     const RelativePathsWithMetadata & keys,
     const ColumnsDescription & columns,
-    const StorageAzure::Configuration & configuration,
+    const StorageAzureBlob::Configuration & configuration,
     const std::optional<FormatSettings> & format_settings,
     const String & format_name,
     const ContextPtr & ctx)
@@ -1277,14 +1277,14 @@ void StorageAzure::addColumnsToCache(
     schema_cache.addMany(cache_keys, columns);
 }
 
-SchemaCache & StorageAzure::getSchemaCache(const ContextPtr & ctx)
+SchemaCache & StorageAzureBlob::getSchemaCache(const ContextPtr & ctx)
 {
     static SchemaCache schema_cache(ctx->getConfigRef().getUInt("schema_inference_cache_max_elements_for_azure", DEFAULT_SCHEMA_CACHE_ELEMENTS));
     return schema_cache;
 }
 
 
-std::unique_ptr<ReadBuffer> StorageAzureSource::createAsyncAzureReadBuffer(
+std::unique_ptr<ReadBuffer> StorageAzureBlobSource::createAsyncAzureReadBuffer(
     const String & key, const ReadSettings & read_settings, size_t object_size)
 {
     auto modified_settings{read_settings};
diff --git a/src/Storages/StorageAzure.h b/src/Storages/StorageAzureBlob.h
similarity index 93%
rename from src/Storages/StorageAzure.h
rename to src/Storages/StorageAzureBlob.h
index 826582ccaa5..6e4dfaf19eb 100644
--- a/src/Storages/StorageAzure.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -24,7 +24,7 @@ using AzureConnectionString = std::string;
 
 using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConnectionString>;
 
-class StorageAzure : public IStorage
+class StorageAzureBlob : public IStorage
 {
 public:
 
@@ -62,7 +62,7 @@ public:
         std::vector<String> blobs_paths;
     };
 
-    StorageAzure(
+    StorageAzureBlob(
         const Configuration & configuration_,
         std::unique_ptr<AzureObjectStorage> && object_storage_,
         ContextPtr context_,
@@ -73,12 +73,12 @@ public:
         std::optional<FormatSettings> format_settings_,
         ASTPtr partition_by_);
 
-    static StorageAzure::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
-    static AzureClientPtr createClient(StorageAzure::Configuration configuration);
+    static StorageAzureBlob::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
+    static AzureClientPtr createClient(StorageAzureBlob::Configuration configuration);
 
     static AzureObjectStorage::SettingsPtr createSettings(ContextPtr local_context);
 
-    static void processNamedCollectionResult(StorageAzure::Configuration & configuration, const NamedCollection & collection);
+    static void processNamedCollectionResult(StorageAzureBlob::Configuration & configuration, const NamedCollection & collection);
 
     String getName() const override
     {
@@ -133,7 +133,7 @@ private:
     static std::optional<ColumnsDescription> tryGetColumnsFromCache(
         const RelativePathsWithMetadata::const_iterator & begin,
         const RelativePathsWithMetadata::const_iterator & end,
-        const StorageAzure::Configuration & configuration,
+        const StorageAzureBlob::Configuration & configuration,
         const std::optional<FormatSettings> & format_settings,
         const ContextPtr & ctx);
 
@@ -148,7 +148,7 @@ private:
 
 };
 
-class StorageAzureSource : public ISource, WithContext
+class StorageAzureBlobSource : public ISource, WithContext
 {
 public:
     class Iterator : WithContext
@@ -192,7 +192,7 @@ public:
         bool is_initialized = false;
     };
 
-    StorageAzureSource(
+    StorageAzureBlobSource(
         const std::vector<NameAndTypePair> & requested_virtual_columns_,
         const String & format_,
         String name_,
@@ -206,7 +206,7 @@ public:
         const String & container_,
         std::shared_ptr<Iterator> file_iterator_);
 
-    ~StorageAzureSource() override;
+    ~StorageAzureBlobSource() override;
 
     Chunk generate() override;
 
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index 96131bd884a..986ad07fdde 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -14,7 +14,7 @@
 #include <Parsers/ASTIdentifier.h>
 #include <Parsers/ASTFunction.h>
 #include <Storages/checkAndGetLiteralArgument.h>
-#include <Storages/StorageAzure.h>
+#include <Storages/StorageAzureBlob.h>
 #include <Storages/StorageS3.h>
 #include <Storages/StorageURL.h>
 #include <Storages/NamedCollectionsHelpers.h>
@@ -46,9 +46,9 @@ bool isConnectionString(const std::string & candidate)
 
 }
 
-StorageAzure::Configuration TableFunctionAzureBlobStorage::parseArgumentsImpl(ASTs & engine_args, const ContextPtr & local_context, bool get_format_from_file)
+StorageAzureBlob::Configuration TableFunctionAzureBlobStorage::parseArgumentsImpl(ASTs & engine_args, const ContextPtr & local_context, bool get_format_from_file)
 {
-    StorageAzure::Configuration configuration;
+    StorageAzureBlob::Configuration configuration;
 
     /// Supported signatures:
     ///
@@ -57,7 +57,7 @@ StorageAzure::Configuration TableFunctionAzureBlobStorage::parseArgumentsImpl(AS
 
     if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, local_context))
     {
-        StorageAzure::processNamedCollectionResult(configuration, *named_collection);
+        StorageAzureBlob::processNamedCollectionResult(configuration, *named_collection);
 
         configuration.blobs_paths = {configuration.blob_path};
 
@@ -202,11 +202,11 @@ ColumnsDescription TableFunctionAzureBlobStorage::getActualTableStructure(Contex
     if (configuration.structure == "auto")
     {
         context->checkAccess(getSourceAccessType());
-        auto client = StorageAzure::createClient(configuration);
-        auto settings = StorageAzure::createSettings(context);
+        auto client = StorageAzureBlob::createClient(configuration);
+        auto settings = StorageAzureBlob::createSettings(context);
 
         auto object_storage = std::make_unique<AzureObjectStorage>("AzureBlobStorageTableFunction", std::move(client), std::move(settings));
-        return StorageAzure::getTableStructureFromData(object_storage.get(), configuration, std::nullopt, context);
+        return StorageAzureBlob::getTableStructureFromData(object_storage.get(), configuration, std::nullopt, context);
     }
 
     return parseColumnsListFromString(configuration.structure, context);
@@ -219,8 +219,8 @@ bool TableFunctionAzureBlobStorage::supportsReadingSubsetOfColumns()
 
 StoragePtr TableFunctionAzureBlobStorage::executeImpl(const ASTPtr & /*ast_function*/, ContextPtr context, const std::string & table_name, ColumnsDescription /*cached_columns*/) const
 {
-    auto client = StorageAzure::createClient(configuration);
-    auto settings = StorageAzure::createSettings(context);
+    auto client = StorageAzureBlob::createClient(configuration);
+    auto settings = StorageAzureBlob::createSettings(context);
 
     ColumnsDescription columns;
     if (configuration.structure != "auto")
@@ -228,7 +228,7 @@ StoragePtr TableFunctionAzureBlobStorage::executeImpl(const ASTPtr & /*ast_funct
     else if (!structure_hint.empty())
         columns = structure_hint;
 
-    StoragePtr storage = std::make_shared<StorageAzure>(
+    StoragePtr storage = std::make_shared<StorageAzureBlob>(
         configuration,
         std::make_unique<AzureObjectStorage>(table_name, std::move(client), std::move(settings)),
         context,
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.h b/src/TableFunctions/TableFunctionAzureBlobStorage.h
index 6f3a3422958..0bb872de3f3 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.h
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.h
@@ -5,7 +5,7 @@
 #if USE_AZURE_BLOB_STORAGE
 
 #include <TableFunctions/ITableFunction.h>
-#include <Storages/StorageAzure.h>
+#include <Storages/StorageAzureBlob.h>
 
 
 namespace DB
@@ -46,7 +46,7 @@ public:
         return {"_path", "_file"};
     }
 
-    static StorageAzure::Configuration parseArgumentsImpl(ASTs & args, const ContextPtr & context, bool get_format_from_file = true);
+    static StorageAzureBlob::Configuration parseArgumentsImpl(ASTs & args, const ContextPtr & context, bool get_format_from_file = true);
 
 protected:
 
@@ -61,7 +61,7 @@ protected:
     ColumnsDescription getActualTableStructure(ContextPtr context) const override;
     void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
 
-    mutable StorageAzure::Configuration configuration;
+    mutable StorageAzureBlob::Configuration configuration;
     ColumnsDescription structure_hint;
 };
 

From 6ab2a50c393696cf0444fda405ffce6453ecbd09 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Tue, 6 Jun 2023 22:48:53 +0200
Subject: [PATCH 0545/1478] Fix two tests and build

---
 src/Storages/registerStorages.cpp                           | 4 ++--
 tests/queries/0_stateless/01271_show_privileges.reference   | 1 +
 .../0_stateless/02117_show_create_table_system.reference    | 6 +++---
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/Storages/registerStorages.cpp b/src/Storages/registerStorages.cpp
index c66cf85a29b..5606e6728d4 100644
--- a/src/Storages/registerStorages.cpp
+++ b/src/Storages/registerStorages.cpp
@@ -97,7 +97,7 @@ void registerStorageSQLite(StorageFactory & factory);
 void registerStorageKeeperMap(StorageFactory & factory);
 
 #if USE_AZURE_BLOB_STORAGE
-void registerStorageAzure(StorageFactory & factory);
+void registerStorageAzureBlob(StorageFactory & factory);
 #endif
 
 void registerStorages()
@@ -197,7 +197,7 @@ void registerStorages()
     registerStorageKeeperMap(factory);
 
     #if USE_AZURE_BLOB_STORAGE
-    registerStorageAzure(factory);
+    registerStorageAzureBlob(factory);
     #endif
 }
 
diff --git a/tests/queries/0_stateless/01271_show_privileges.reference b/tests/queries/0_stateless/01271_show_privileges.reference
index ec245d8b9e0..5d30da5d2ea 100644
--- a/tests/queries/0_stateless/01271_show_privileges.reference
+++ b/tests/queries/0_stateless/01271_show_privileges.reference
@@ -158,6 +158,7 @@ JDBC	[]	GLOBAL	SOURCES
 HDFS	[]	GLOBAL	SOURCES
 S3	[]	GLOBAL	SOURCES
 HIVE	[]	GLOBAL	SOURCES
+AZURE	[]	GLOBAL	SOURCES
 SOURCES	[]	\N	ALL
 CLUSTER	[]	GLOBAL	ALL
 ALL	['ALL PRIVILEGES']	\N	\N
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..e864ba85018 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, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'AZURE' = 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, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'AZURE' = 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, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'AZURE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164))
 )
 ENGINE = SystemPrivileges
 COMMENT 'SYSTEM TABLE is built on the fly.'

From be8e0487994d70c3c6350cb675475b12dffda8e5 Mon Sep 17 00:00:00 2001
From: johanngan <johanngan.us@gmail.com>
Date: Tue, 6 Jun 2023 16:28:44 -0500
Subject: [PATCH 0546/1478] Revert invalid RegExpTreeDictionary optimization

This reverts the following commits:
- e77dd810369ad5fcf957393e4fc71a8a6220b04e
- e8527e720b2ab12b3327f1e3886aace402a292c6

Additionally, functional tests are added.

When scanning complex regexp nodes sequentially with RE2, the old code
has an optimization to break out of the loop early upon finding a leaf
node that matches. This is an invalid optimization because there's no
guarantee that it's actually a VALID match, because its parents might
NOT have matched. Semantically, a user would expect this match to be
discarded and for the search to continue. Instead, since we skipped
matching after the first false positive, subsequent nodes that would
have matched are missing from the output value. This affects both
dictGet and dictGetAll.

It's difficult to distinguish a true positive from a false positive
while looping through complex_regexp_nodes because we would have to scan
all the parents of a matching node to confirm a true positive. Trying to
do this might actually end up being slower than just scanning every
complex regexp node, because complex_regexp_nodes is only a subset of
all the tree nodes; we may end up duplicating work with scanning
that Vectorscan has already done, depending on whether the parent nodes
are "simple" or "complex". So instead of trying to fix this
optimization, just remove it entirely.
---
 src/Dictionaries/RegExpTreeDictionary.cpp     | 14 ----
 ...04_regexp_dictionary_yaml_source.reference | 16 +++++
 .../02504_regexp_dictionary_yaml_source.sh    | 64 +++++++++++++++++++
 3 files changed, 80 insertions(+), 14 deletions(-)

diff --git a/src/Dictionaries/RegExpTreeDictionary.cpp b/src/Dictionaries/RegExpTreeDictionary.cpp
index 8d0af9b0abf..3852cca6928 100644
--- a/src/Dictionaries/RegExpTreeDictionary.cpp
+++ b/src/Dictionaries/RegExpTreeDictionary.cpp
@@ -129,17 +129,6 @@ struct RegExpTreeDictionary::RegexTreeNode
         return searcher.Match(haystack, 0, size, re2_st::RE2::Anchor::UNANCHORED, nullptr, 0);
     }
 
-    /// check if this node can cover all the attributes from the query.
-    bool containsAll(const std::unordered_map<String, const DictionaryAttribute &> & matching_attributes) const
-    {
-        for (const auto & [key, value] : matching_attributes)
-        {
-            if (!attributes.contains(key))
-                return false;
-        }
-        return true;
-    }
-
     struct AttributeValue
     {
         Field field;
@@ -691,9 +680,6 @@ std::unordered_map<String, ColumnPtr> RegExpTreeDictionary::match(
             if (node_ptr->match(reinterpret_cast<const char *>(keys_data.data()) + offset, length))
             {
                 match_result.insertNodeID(node_ptr->id);
-                /// When this node is leaf and contains all the required attributes, it means a match.
-                if (node_ptr->containsAll(attributes) && node_ptr->children.empty())
-                    break;
             }
         }
 
diff --git a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
index 437012dd516..79871e3716c 100644
--- a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
+++ b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.reference
@@ -11,3 +11,19 @@
 (['ClickHouse Documentation','ClickHouse'],[0,1],['/en'],['ClickHouse'])
 (['Documentation','GitHub'],[2,3],[NULL],[])
 (['Documentation','GitHub'],[2,3],[NULL],[])
+ClickHouse
+['ClickHouse']
+ClickHouse Documentation
+['ClickHouse Documentation','ClickHouse','Documentation']
+GitHub Documentation
+['GitHub Documentation','GitHub']
+Documentation
+['Documentation']
+ClickHouse
+['ClickHouse']
+ClickHouse Documentation
+['ClickHouse Documentation','ClickHouse','Documentation']
+GitHub Documentation
+['GitHub Documentation','GitHub']
+Documentation
+['Documentation']
diff --git a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
index ac0793460a9..5e8985406ae 100755
--- a/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
+++ b/tests/queries/0_stateless/02504_regexp_dictionary_yaml_source.sh
@@ -175,6 +175,70 @@ select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'pare
 select dictGetAll('regexp_dict3', ('tag', 'topological_index', 'captured', 'parent'), 'github.com/clickhouse/tree/master/docs', 2);
 "
 
+# Test that things work the same for "simple" regexps that go through Hyperscan and "complex" regexps that go through RE2.
+# An easy way to force the use of RE2 is to disable Hyperscan.
+# This tree is constructed purposely so that text might (falsely) match leaf nodes without matching their corresponding parent nodes
+cat > "$yaml" <<EOL
+- regexp: 'clickhouse\.com'
+  tag: 'ClickHouse'
+  paths:
+    - regexp: 'docs'
+      tag: 'ClickHouse Documentation'
+
+- regexp: 'github\.com'
+  tag: 'GitHub'
+  paths:
+    - regexp: 'docs'
+      tag: 'GitHub Documentation'
+
+- regexp: '/docs(/|$)'
+  tag: 'Documentation'
+EOL
+
+$CLICKHOUSE_CLIENT -n --query="
+drop dictionary if exists regexp_dict3;
+create dictionary regexp_dict3
+(
+    regexp String,
+    tag String
+)
+PRIMARY KEY(regexp)
+SOURCE(YAMLRegExpTree(PATH '$yaml'))
+LIFETIME(0)
+LAYOUT(regexp_tree)
+SETTINGS(regexp_dict_allow_hyperscan = true);
+
+select dictGet('regexp_dict3', 'tag', 'clickhouse.com');
+select dictGetAll('regexp_dict3', 'tag', 'clickhouse.com');
+select dictGet('regexp_dict3', 'tag', 'clickhouse.com/docs');
+select dictGetAll('regexp_dict3', 'tag', 'clickhouse.com/docs');
+select dictGet('regexp_dict3', 'tag', 'docs.github.com');
+select dictGetAll('regexp_dict3', 'tag', 'docs.github.com');
+select dictGet('regexp_dict3', 'tag', '/docs');
+select dictGetAll('regexp_dict3', 'tag', '/docs');
+
+drop dictionary if exists regexp_dict3;
+create dictionary regexp_dict3
+(
+    regexp String,
+    tag String
+)
+PRIMARY KEY(regexp)
+SOURCE(YAMLRegExpTree(PATH '$yaml'))
+LIFETIME(0)
+LAYOUT(regexp_tree)
+SETTINGS(regexp_dict_allow_hyperscan = false);
+
+select dictGet('regexp_dict3', 'tag', 'clickhouse.com');
+select dictGetAll('regexp_dict3', 'tag', 'clickhouse.com');
+select dictGet('regexp_dict3', 'tag', 'clickhouse.com/docs');
+select dictGetAll('regexp_dict3', 'tag', 'clickhouse.com/docs');
+select dictGet('regexp_dict3', 'tag', 'docs.github.com');
+select dictGetAll('regexp_dict3', 'tag', 'docs.github.com');
+select dictGet('regexp_dict3', 'tag', '/docs');
+select dictGetAll('regexp_dict3', 'tag', '/docs');
+"
+
 $CLICKHOUSE_CLIENT -n --query="
 drop dictionary regexp_dict1;
 drop dictionary regexp_dict2;

From 195cc51c43424cef8e04eadbed3d3d442d70144d Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Tue, 6 Jun 2023 15:51:03 -0600
Subject: [PATCH 0547/1478] Style fix

---
 docs/en/sql-reference/functions/index.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/functions/index.md b/docs/en/sql-reference/functions/index.md
index 42d402e9d44..fd6434d21b6 100644
--- a/docs/en/sql-reference/functions/index.md
+++ b/docs/en/sql-reference/functions/index.md
@@ -10,7 +10,9 @@ There are at least\* two types of functions - regular functions (they are just c
 
 In this section we discuss regular functions. For aggregate functions, see the section “Aggregate functions”.
 
-\* - There is a third type of function that the ‘arrayJoin’ function belongs to; table functions can also be mentioned separately.\*
+:::note 
+There is a third type of function that the [‘arrayJoin’ function](/docs/en/sql-reference/functions/array-join.md) belongs to. And [table functions](/docs/en/sql-reference/table-functions.md) can also be mentioned separately.
+:::
 
 ## Strong Typing
 

From a89c129c49e18177cd09bcbd83c97f1657e9f925 Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Tue, 6 Jun 2023 15:54:57 -0600
Subject: [PATCH 0548/1478] Update nyc-taxi.md

Use gcs function (instead of s3) for the GCS files
---
 docs/en/getting-started/example-datasets/nyc-taxi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/getting-started/example-datasets/nyc-taxi.md b/docs/en/getting-started/example-datasets/nyc-taxi.md
index 9730faa873c..cac75fdc45a 100644
--- a/docs/en/getting-started/example-datasets/nyc-taxi.md
+++ b/docs/en/getting-started/example-datasets/nyc-taxi.md
@@ -75,7 +75,7 @@ SELECT
     payment_type,
     pickup_ntaname,
     dropoff_ntaname
-FROM s3(
+FROM gcs(
     'https://storage.googleapis.com/clickhouse-public-datasets/nyc-taxi/trips_{0..2}.gz',
     'TabSeparatedWithNames'
 );

From 5f48f02023ac655f4f2fb8a4ac1e0be636263eb9 Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Tue, 6 Jun 2023 16:10:22 -0600
Subject: [PATCH 0549/1478] Update index.md

---
 docs/en/sql-reference/functions/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/functions/index.md b/docs/en/sql-reference/functions/index.md
index fd6434d21b6..d07a5292431 100644
--- a/docs/en/sql-reference/functions/index.md
+++ b/docs/en/sql-reference/functions/index.md
@@ -11,7 +11,7 @@ There are at least\* two types of functions - regular functions (they are just c
 In this section we discuss regular functions. For aggregate functions, see the section “Aggregate functions”.
 
 :::note 
-There is a third type of function that the [‘arrayJoin’ function](/docs/en/sql-reference/functions/array-join.md) belongs to. And [table functions](/docs/en/sql-reference/table-functions.md) can also be mentioned separately.
+There is a third type of function that the [‘arrayJoin’ function](/docs/en/sql-reference/functions/array-join.md) belongs to. And [table functions](/docs/en/sql-reference/table-functions/index.md) can also be mentioned separately.
 :::
 
 ## Strong Typing

From 068b1fbbcc08a82363f08d37dd6b399ae22c234f Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Mon, 29 May 2023 13:46:27 -0700
Subject: [PATCH 0550/1478] Add ability to ignore index

---
 src/Core/Settings.h                           |  2 +
 .../MergeTree/MergeTreeDataSelectExecutor.cpp | 52 ++++++++++++++-----
 ...771_ignore_data_skipping_indices.reference | 44 ++++++++++++++++
 .../02771_ignore_data_skipping_indices.sql    | 26 ++++++++++
 4 files changed, 112 insertions(+), 12 deletions(-)
 create mode 100644 tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
 create mode 100644 tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 6a0833aef60..0037acedede 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -201,6 +201,8 @@ class IColumn;
     M(Bool, force_primary_key, false, "Throw an exception if there is primary key in a table, and it is not used.", 0) \
     M(Bool, use_skip_indexes, true, "Use data skipping indexes during query execution.", 0) \
     M(Bool, use_skip_indexes_if_final, false, "If query has FINAL, then skipping data based on indexes may produce incorrect result, hence disabled by default.", 0) \
+    M(String, ignore_data_skipping_indices, "", "Comma separated list of strings or literals with the name of the data skipping indices that should be excluded during query execution.", 0) \
+    \
     M(String, force_data_skipping_indices, "", "Comma separated list of strings or literals with the name of the data skipping indices that should be used during query execution, otherwise an exception will be thrown.", 0) \
     \
     M(Float, max_streams_to_max_threads_ratio, 1, "Allows you to use more sources than the number of threads - to more evenly distribute work across threads. It is assumed that this is a temporary solution, since it will be possible in the future to make the number of sources equal to the number of threads, but for each source to dynamically select available work for itself.", 0) \
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 16b27c2c820..ca6ab931499 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -16,6 +16,7 @@
 #include <Parsers/ASTLiteral.h>
 #include <Parsers/ASTFunction.h>
 #include <Parsers/ASTSampleRatio.h>
+#include <Parsers/ExpressionListParsers.h>
 #include <Parsers/parseIdentifierOrStringLiteral.h>
 #include <Interpreters/ExpressionAnalyzer.h>
 #include <Interpreters/InterpreterSelectQuery.h>
@@ -948,25 +949,52 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
 
     std::list<DataSkippingIndexAndCondition> useful_indices;
     std::map<std::pair<String, size_t>, MergedDataSkippingIndexAndCondition> merged_indices;
+    std::unordered_set<std::string> ignored_index_names;
+
+    if (use_skip_indexes && settings.ignore_data_skipping_indices.changed)
+    {
+        const auto & indices = settings.ignore_data_skipping_indices.toString();
+        Tokens tokens(indices.data(), &indices[indices.size()], settings.max_query_size);
+        IParser::Pos pos(tokens, static_cast<unsigned>(settings.max_parser_depth));
+        Expected expected;
+
+        /// Use an unordered list rather than string vector
+        auto parse_single_id_or_literal = [&]
+        {
+            String str;
+            if (!parseIdentifierOrStringLiteral(pos, expected, str))
+                return false;
+
+            ignored_index_names.insert(std::move(str));
+            return true;
+        };
+
+        if (!ParserList::parseUtil(pos, expected, parse_single_id_or_literal, false))
+            throw Exception(ErrorCodes::CANNOT_PARSE_TEXT, "Cannot parse ignore_data_skipping_indices ('{}')", indices);
+    }
 
     if (use_skip_indexes)
     {
         for (const auto & index : metadata_snapshot->getSecondaryIndices())
         {
-            auto index_helper = MergeTreeIndexFactory::instance().get(index);
-            if (index_helper->isMergeable())
-            {
-                auto [it, inserted] = merged_indices.try_emplace({index_helper->index.type, index_helper->getGranularity()});
-                if (inserted)
-                    it->second.condition = index_helper->createIndexMergedCondition(query_info, metadata_snapshot);
 
-                it->second.addIndex(index_helper);
-            }
-            else
+            auto index_helper = MergeTreeIndexFactory::instance().get(index);
+            if(!ignored_index_names.contains(index.name))
             {
-                auto condition = index_helper->createIndexCondition(query_info, context);
-                if (!condition->alwaysUnknownOrTrue())
-                    useful_indices.emplace_back(index_helper, condition);
+                if (index_helper->isMergeable())
+                {
+                    auto [it, inserted] = merged_indices.try_emplace({index_helper->index.type, index_helper->getGranularity()});
+                    if (inserted)
+                        it->second.condition = index_helper->createIndexMergedCondition(query_info, metadata_snapshot);
+
+                    it->second.addIndex(index_helper);
+                }
+                else
+                {
+                    auto condition = index_helper->createIndexCondition(query_info, context);
+                    if (!condition->alwaysUnknownOrTrue())
+                        useful_indices.emplace_back(index_helper, condition);
+                }
             }
         }
     }
diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
new file mode 100644
index 00000000000..af1fce5ba13
--- /dev/null
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
@@ -0,0 +1,44 @@
+1	2	3
+1	2	3
+1	2	3
+Expression ((Projection + Before ORDER BY))
+  Filter (WHERE)
+    ReadFromMergeTree (default.data_02771)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 1/1
+      Skip
+        Name: x_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/1
+        Granules: 0/1
+      Skip
+        Name: y_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
+      Skip
+        Name: xy_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
+Expression ((Projection + Before ORDER BY))
+  Filter (WHERE)
+    ReadFromMergeTree (default.data_02771)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 1/1
+      Skip
+        Name: x_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/1
+        Granules: 0/1
+      Skip
+        Name: y_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
new file mode 100644
index 00000000000..ab314ae5ea2
--- /dev/null
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
@@ -0,0 +1,26 @@
+DROP TABLE IF EXISTS data_02771;
+CREATE TABLE data_02771
+(
+    key Int,
+    x Int,
+    y Int,
+    INDEX x_idx x TYPE minmax GRANULARITY 1,
+    INDEX y_idx y TYPE minmax GRANULARITY 1,
+    INDEX xy_idx (x,y) TYPE minmax GRANULARITY 1
+)
+Engine=MergeTree()
+ORDER BY key;
+
+INSERT INTO data_02771 VALUES (1, 2, 3);
+
+SELECT * FROM data_02771;
+SELECT * FROM data_02771 SETTINGS ignore_data_skipping_indices=''; -- { serverError 6 }
+SELECT * FROM data_02771 SETTINGS ignore_data_skipping_indices='x_idx';
+SELECT * FROM data_02771 SETTINGS ignore_data_skipping_indices='na_idx';
+
+SELECT * FROM data_02771 WHERE x = 1 AND y = 1 SETTINGS ignore_data_skipping_indices='xy_idx',force_data_skipping_indices='xy_idx' ; -- { serverError 277 }
+SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
+EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2;
+EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
+
+DROP TABLE data_02771;

From f552b96451bd4c826a9e7d1bff669301c3c4bccc Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Mon, 29 May 2023 14:00:00 -0700
Subject: [PATCH 0551/1478] Add docs for ignore index

---
 docs/en/operations/settings/settings.md | 83 +++++++++++++++++++++++++
 1 file changed, 83 insertions(+)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 5730503a670..5b0c6b3c8c2 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -227,6 +227,89 @@ SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_
 SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ok.
 ```
 
+## ignore_data_skipping_indices {#settings-ignore_data_skipping_indices}
+
+Ignores the skipping indexes specified if used by the query.
+
+Consider the following example:
+
+```sql
+CREATE TABLE data
+(
+    key Int,
+    x Int,
+    y Int,
+    INDEX x_idx x TYPE minmax GRANULARITY 1,
+    INDEX y_idx y TYPE minmax GRANULARITY 1,
+    INDEX xy_idx (x,y) TYPE minmax GRANULARITY 1
+)
+Engine=MergeTree()
+ORDER BY key;
+
+INSERT INTO data VALUES (1, 2, 3);
+
+SELECT * FROM data;
+SELECT * FROM data SETTINGS ignore_data_skipping_indices=''; -- query will produce CANNOT_PARSE_TEXT error.
+SELECT * FROM data SETTINGS ignore_data_skipping_indices='x_idx'; -- Ok.
+SELECT * FROM data SETTINGS ignore_data_skipping_indices='na_idx'; -- Ok.
+
+SELECT * FROM data WHERE x = 1 AND y = 1 SETTINGS ignore_data_skipping_indices='xy_idx',force_data_skipping_indices='xy_idx' ; -- query will produce INDEX_NOT_USED error, since xy_idx is explictly ignored.
+SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
+```
+
+The query without ignoring any indexes:
+```sql
+EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2;
+
+Expression ((Projection + Before ORDER BY))
+  Filter (WHERE)
+    ReadFromMergeTree (default.data)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 1/1
+      Skip
+        Name: x_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/1
+        Granules: 0/1
+      Skip
+        Name: y_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
+      Skip
+        Name: xy_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
+```
+
+Ignoring the `xy_idx` index:
+```sql
+EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
+
+Expression ((Projection + Before ORDER BY))
+  Filter (WHERE)
+    ReadFromMergeTree (default.data)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 1/1
+      Skip
+        Name: x_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/1
+        Granules: 0/1
+      Skip
+        Name: y_idx
+        Description: minmax GRANULARITY 1
+        Parts: 0/0
+        Granules: 0/0
+```
+
 Works with tables in the MergeTree family.
 
 ## convert_query_to_cnf {#convert_query_to_cnf}

From 689e0cabe0ca3cfc4b710a7426dbb1d363437984 Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Tue, 30 May 2023 05:31:54 -0700
Subject: [PATCH 0552/1478] Add space to if

---
 src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index ca6ab931499..c07d887588b 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -979,7 +979,7 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
         {
 
             auto index_helper = MergeTreeIndexFactory::instance().get(index);
-            if(!ignored_index_names.contains(index.name))
+            if (!ignored_index_names.contains(index.name))
             {
                 if (index_helper->isMergeable())
                 {

From 7c2b88a00eb1972fbd27b534ad578c2e69486605 Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Thu, 1 Jun 2023 07:14:39 -0700
Subject: [PATCH 0553/1478] Make test invariant

---
 .../02771_ignore_data_skipping_indices.reference            | 4 ----
 .../0_stateless/02771_ignore_data_skipping_indices.sql      | 6 +++---
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
index af1fce5ba13..786360783fd 100644
--- a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.reference
@@ -1,8 +1,6 @@
 1	2	3
 1	2	3
 1	2	3
-Expression ((Projection + Before ORDER BY))
-  Filter (WHERE)
     ReadFromMergeTree (default.data_02771)
     Indexes:
       PrimaryKey
@@ -24,8 +22,6 @@ Expression ((Projection + Before ORDER BY))
         Description: minmax GRANULARITY 1
         Parts: 0/0
         Granules: 0/0
-Expression ((Projection + Before ORDER BY))
-  Filter (WHERE)
     ReadFromMergeTree (default.data_02771)
     Indexes:
       PrimaryKey
diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
index ab314ae5ea2..baa2d497863 100644
--- a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
@@ -20,7 +20,7 @@ SELECT * FROM data_02771 SETTINGS ignore_data_skipping_indices='na_idx';
 
 SELECT * FROM data_02771 WHERE x = 1 AND y = 1 SETTINGS ignore_data_skipping_indices='xy_idx',force_data_skipping_indices='xy_idx' ; -- { serverError 277 }
 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
-EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2;
-EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
+SELECT * from ( EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 ) WHERE explain NOT LIKE '%Expression%' AND explain NOT LIKE '%Filter%';
+SELECT * from ( EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx' ) WHERE explain NOT LIKE '%Expression%' AND explain NOT LIKE '%Filter%';
 
-DROP TABLE data_02771;
+DROP TABLE data_02771;
\ No newline at end of file

From 1fa1215d1549e5887695cfd0f6bf4aaa61101fec Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Fri, 2 Jun 2023 07:21:22 -0700
Subject: [PATCH 0554/1478] Avoid UB

---
 src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp          | 2 +-
 .../queries/0_stateless/02771_ignore_data_skipping_indices.sql  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index c07d887588b..4967de8424b 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -954,7 +954,7 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
     if (use_skip_indexes && settings.ignore_data_skipping_indices.changed)
     {
         const auto & indices = settings.ignore_data_skipping_indices.toString();
-        Tokens tokens(indices.data(), &indices[indices.size()], settings.max_query_size);
+        Tokens tokens(indices.data(), indices.data() + indices.size(), settings.max_query_size);
         IParser::Pos pos(tokens, static_cast<unsigned>(settings.max_parser_depth));
         Expected expected;
 
diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
index baa2d497863..289d5240b57 100644
--- a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
@@ -23,4 +23,4 @@ SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_ind
 SELECT * from ( EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 ) WHERE explain NOT LIKE '%Expression%' AND explain NOT LIKE '%Filter%';
 SELECT * from ( EXPLAIN indexes = 1 SELECT * FROM data_02771 WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx' ) WHERE explain NOT LIKE '%Expression%' AND explain NOT LIKE '%Filter%';
 
-DROP TABLE data_02771;
\ No newline at end of file
+DROP TABLE data_02771;

From 45d000b71780cb7a022c6c0694d978596ac8fb96 Mon Sep 17 00:00:00 2001
From: Boris Kuschel <Boris.Kuschel@ibm.com>
Date: Mon, 5 Jun 2023 05:27:44 -0700
Subject: [PATCH 0555/1478] Turn off analyzer for test

---
 .../0_stateless/02771_ignore_data_skipping_indices.sql        | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
index 289d5240b57..a49239e9de2 100644
--- a/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
+++ b/tests/queries/0_stateless/02771_ignore_data_skipping_indices.sql
@@ -1,4 +1,8 @@
+SET allow_experimental_analyzer = 0;
+
 DROP TABLE IF EXISTS data_02771;
+
+
 CREATE TABLE data_02771
 (
     key Int,

From f3959aa9e16fd50ad5e7081c12a9a9948113e898 Mon Sep 17 00:00:00 2001
From: Derek Chia <derek.chia@clickhouse.com>
Date: Wed, 7 Jun 2023 11:07:16 +0800
Subject: [PATCH 0556/1478] Update settings.md

`max_final_threads` is now set to the number of cores by default. See https://github.com/ClickHouse/ClickHouse/pull/47915
---
 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 5730503a670..8e2cd8d6027 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3155,7 +3155,7 @@ Possible values:
 - Positive integer.
 - 0 or 1 — Disabled. `SELECT` queries are executed in a single thread.
 
-Default value: `16`.
+Default value: the number of physical CPU cores.
 
 ## opentelemetry_start_trace_probability {#opentelemetry-start-trace-probability}
 

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 0557/1478] 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 0558/1478] 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 0559/1478] 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 0560/1478] 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 bea4e8e81f6a782edc3dc2a672ae3011843de305 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 7 Jun 2023 06:45:14 +0000
Subject: [PATCH 0561/1478] Add new files

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

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index f775e8a5a22..90f4f870df6 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -131,6 +131,8 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageTransaction.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageRemoteMetadataRestoreHelper.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/DiskObjectStorageCommon.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/ObjectStorageIterator.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/StoredObject.cpp
 
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/ObjectStorages/S3/registerDiskS3.cpp

From 4050b637f16554421423d92c501d9790deb42394 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 7 Jun 2023 09:01:20 +0000
Subject: [PATCH 0562/1478] ALTER TABLE ADD INDEX: Add default GRANULARITY
 argument for secondary indexes

- Related to #45451, which provides a default GRANULARITY when the
  skipping index is created in CREATE TABLE.
---
 docs/en/sql-reference/statements/alter/skipping-index.md | 2 +-
 src/Parsers/ParserCreateIndexQuery.cpp                   | 9 ++++++---
 src/Parsers/ParserCreateQuery.cpp                        | 2 +-
 .../0_stateless/02534_default_granularity.reference      | 1 +
 tests/queries/0_stateless/02534_default_granularity.sql  | 7 ++++++-
 5 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/en/sql-reference/statements/alter/skipping-index.md b/docs/en/sql-reference/statements/alter/skipping-index.md
index 67af76986da..4194731d33a 100644
--- a/docs/en/sql-reference/statements/alter/skipping-index.md
+++ b/docs/en/sql-reference/statements/alter/skipping-index.md
@@ -10,7 +10,7 @@ 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.
+- `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] 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).
 
diff --git a/src/Parsers/ParserCreateIndexQuery.cpp b/src/Parsers/ParserCreateIndexQuery.cpp
index ab31d3f9b7a..e878b347e62 100644
--- a/src/Parsers/ParserCreateIndexQuery.cpp
+++ b/src/Parsers/ParserCreateIndexQuery.cpp
@@ -36,17 +36,20 @@ bool ParserCreateIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected
     if (!data_type_p.parse(pos, type, expected))
         return false;
 
-    if (!s_granularity.ignore(pos, expected))
-        return false;
+    if (s_granularity.ignore(pos, expected))
+    {
+        if (!granularity_p.parse(pos, granularity, expected))
+            return false;
+    }
 
     if (!granularity_p.parse(pos, granularity, expected))
         return false;
 
     auto index = std::make_shared<ASTIndexDeclaration>();
     index->part_of_create_index_query = true;
-    index->granularity = granularity->as<ASTLiteral &>().value.safeGet<UInt64>();
     index->set(index->expr, expr);
     index->set(index->type, type);
+    index->granularity = granularity ? granularity->as<ASTLiteral &>().value.safeGet<UInt64>() : 1;
     node = index;
 
     return true;
diff --git a/src/Parsers/ParserCreateQuery.cpp b/src/Parsers/ParserCreateQuery.cpp
index 8cbfac91465..f975e8ba3c8 100644
--- a/src/Parsers/ParserCreateQuery.cpp
+++ b/src/Parsers/ParserCreateQuery.cpp
@@ -139,9 +139,9 @@ bool ParserIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected & expe
 
     auto index = std::make_shared<ASTIndexDeclaration>();
     index->name = name->as<ASTIdentifier &>().name();
-    index->granularity = granularity ? granularity->as<ASTLiteral &>().value.safeGet<UInt64>() : 1;
     index->set(index->expr, expr);
     index->set(index->type, type);
+    index->granularity = granularity ? granularity->as<ASTLiteral &>().value.safeGet<UInt64>() : 1;
     node = index;
 
     return true;
diff --git a/tests/queries/0_stateless/02534_default_granularity.reference b/tests/queries/0_stateless/02534_default_granularity.reference
index e60036653c9..0fe7fe0a1b3 100644
--- a/tests/queries/0_stateless/02534_default_granularity.reference
+++ b/tests/queries/0_stateless/02534_default_granularity.reference
@@ -1 +1,2 @@
 CREATE TABLE default.users_02534\n(\n    `id` Int16,\n    `name` String,\n    INDEX bf_idx name TYPE minmax GRANULARITY 1\n)\nENGINE = MergeTree\nORDER BY id\nSETTINGS index_granularity = 8192
+CREATE TABLE default.users_02534\n(\n    `id` Int16,\n    `name` String,\n    INDEX bf_idx name TYPE minmax GRANULARITY 1\n)\nENGINE = MergeTree\nORDER BY id\nSETTINGS index_granularity = 8192
diff --git a/tests/queries/0_stateless/02534_default_granularity.sql b/tests/queries/0_stateless/02534_default_granularity.sql
index 781df3ce934..e3de5fce7c8 100644
--- a/tests/queries/0_stateless/02534_default_granularity.sql
+++ b/tests/queries/0_stateless/02534_default_granularity.sql
@@ -1,4 +1,9 @@
 DROP TABLE IF EXISTS users_02534;
 CREATE TABLE users_02534 (id Int16, name String, INDEX bf_idx(name) TYPE minmax) ENGINE=MergeTree ORDER BY id;
 SHOW CREATE TABLE users_02534;
-DROP TABLE users_02534;
\ No newline at end of file
+DROP TABLE users_02534;
+
+CREATE TABLE users_02534 (id Int16, name String) ENGINE=MergeTree ORDER BY id;
+ALTER TABLE users_02534 ADD INDEX bf_idx(name) TYPE minmax;
+SHOW CREATE TABLE users_02534;
+DROP TABLE users_02534;

From c795eb03299f751dd4a0c69facb2d5a6bec101da Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 7 Jun 2023 09:46:10 +0000
Subject: [PATCH 0563/1478] Temporarily disable a test

---
 tests/queries/0_stateless/02354_annoy_index.sql | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 170c048d420..0168fa04c6f 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -20,11 +20,12 @@ FROM tab
 ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
 LIMIT 3;
 
-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 }
+-- 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

From 7c800468349e4aea2c125459f44b581d14391a10 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 7 Jun 2023 09:47:54 +0000
Subject: [PATCH 0564/1478] Revert "Remove clang-tidy exclude"

This reverts commit 42c054789561920adf7ce4770968ba303a70f244.
---
 src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index ffed9e01df0..1a28f28f746 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -123,6 +123,7 @@ MergeTreeIndexAggregatorAnnoy<Distance>::MergeTreeIndexAggregatorAnnoy(
 template <typename Distance>
 MergeTreeIndexGranulePtr MergeTreeIndexAggregatorAnnoy<Distance>::getGranuleAndReset()
 {
+    // NOLINTNEXTLINE(*)
     index->build(static_cast<int>(trees), /*number_of_threads=*/1);
     auto granule = std::make_shared<MergeTreeIndexGranuleAnnoy<Distance>>(index_name, index_sample_block, index);
     index = nullptr;

From e0bc695e2d95085e1927b44fc2ad5a9d3384c1d3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Wed, 7 Jun 2023 10:07:35 +0000
Subject: [PATCH 0565/1478] Use correct link format

---
 docs/en/sql-reference/aggregate-functions/index.md          | 4 ++--
 .../sql-reference/aggregate-functions/reference/argmax.md   | 6 +++---
 .../sql-reference/aggregate-functions/reference/argmin.md   | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/en/sql-reference/aggregate-functions/index.md b/docs/en/sql-reference/aggregate-functions/index.md
index ea270e83a3c..5d2229fbcce 100644
--- a/docs/en/sql-reference/aggregate-functions/index.md
+++ b/docs/en/sql-reference/aggregate-functions/index.md
@@ -4,7 +4,7 @@ sidebar_label: Aggregate Functions
 sidebar_position: 33
 ---
 
-# Aggregate Functions 
+# Aggregate Functions
 
 Aggregate functions work in the [normal](http://www.sql-tutorial.com/sql-aggregate-functions-sql-tutorial) way as expected by database experts.
 
@@ -73,7 +73,7 @@ FROM t_null_big
 └────────────────────┴─────────────────────┘
 ```
 
-Also you can use [Tuple](../data-types/tuple.md) to work around NULL skipping behavior. The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value.
+Also you can use [Tuple](/docs/en/sql-reference/data-types/tuple.md) to work around NULL skipping behavior. The a `Tuple` that contains only a `NULL` value is not `NULL`, so the aggregate functions won't skip that row because of that `NULL` value.
 
 ```sql
 SELECT
diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmax.md b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
index 93e1fac6d67..8f10318838b 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmax.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmax.md
@@ -5,8 +5,8 @@ sidebar_position: 106
 
 # argMax
 
-Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered. 
-Both parts the `arg` and the `max` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
+Calculates the `arg` value for a maximum `val` value. If there are several different values of `arg` for maximum values of `val`, returns the first of these values encountered.
+Both parts the `arg` and the `max` behave as [aggregate functions](/docs/en/sql-reference/aggregate-functions/index.md), they both [skip `Null`](/docs/en/sql-reference/aggregate-functions/index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
 
 **Syntax**
 
@@ -106,4 +106,4 @@ SELECT argMax(a, tuple(b)) FROM test;
 
 **See also**
 
-- [Tuple](../../data-types/tuple.md)
+- [Tuple](/docs/en/sql-reference/data-types/tuple.md)
diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 4e549e5b04c..47d4ab398de 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -6,7 +6,7 @@ sidebar_position: 105
 # argMin
 
 Calculates the `arg` value for a minimum `val` value. If there are several different values of `arg` for minimum values of `val`, returns the first of these values encountered.
-Both parts the `arg` and the `min` behave as [aggregate functions](../index.md), they both [skip `Null`](../index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
+Both parts the `arg` and the `min` behave as [aggregate functions](/docs/en/sql-reference/aggregate-functions/index.md), they both [skip `Null`](/docs/en/sql-reference/aggregate-functions/index.md#null-processing) during processing and return not `Null` values if not `Null` values are available.
 
 **Syntax**
 
@@ -111,4 +111,4 @@ select argMin(a, tuple(b)) from test;
 
 **See also**
 
-- [Tuple](../../data-types/tuple.md)
+- [Tuple](/docs/en/sql-reference/data-types/tuple.md)

From 35ef14482d785226a660c62fea558fdb91a1d26f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Wed, 7 Jun 2023 10:11:49 +0000
Subject: [PATCH 0566/1478] Fix keyword capitalization

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

diff --git a/docs/en/sql-reference/aggregate-functions/reference/argmin.md b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
index 47d4ab398de..fdfce0833e0 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/argmin.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/argmin.md
@@ -103,9 +103,9 @@ SELECT argMin((a, b), (b, a)), min(tuple(b, a)) FROM test;
 │ (NULL,NULL)                      │ (NULL,NULL)      │ -- argMin returns (NULL,NULL) here because `Tuple` allows to don't skip `NULL` and min(tuple(b, a)) in this case is minimal value for this dataset
 └──────────────────────────────────┴──────────────────┘
 
-select argMin(a, tuple(b)) from test;
+SELECT argMin(a, tuple(b)) FROM test;
 ┌─argMax(a, tuple(b))─┐
-│ d                   │ -- `Tuple` can be used in `min` to not skip rows with `NULL` values as b. 
+│ d                   │ -- `Tuple` can be used in `min` to not skip rows with `NULL` values as b.
 └─────────────────────┘
 ```
 

From 71ae54f089f51c396616842743e8ba0a7f38bc59 Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Wed, 7 Jun 2023 13:34:01 +0200
Subject: [PATCH 0567/1478] Fix args

---
 .../ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
index 07173e65448..20c60cfe8f5 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
@@ -52,7 +52,6 @@ public:
 
         options.Prefix = path_prefix;
         options.PageSizeHint = static_cast<int>(max_list_size);
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "ITER PREFIX {}", path_prefix);
     }
 
 private:
@@ -63,7 +62,6 @@ private:
         auto blob_list_response = client->ListBlobs(options);
         auto blobs_list = blob_list_response.Blobs;
 
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BLOB LIST SIZE {}", blobs_list.size());
         for (const auto & blob : blobs_list)
         {
             batch.emplace_back(
@@ -77,13 +75,9 @@ private:
         }
 
         if (!blob_list_response.NextPageToken.HasValue() || blob_list_response.NextPageToken.Value().empty())
-        {
-            LOG_DEBUG(&Poco::Logger::get("DEBUG"), "RETURN FALSE {}", blobs_list.size());
             return false;
-        }
 
         options.ContinuationToken = blob_list_response.NextPageToken;
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "RETURN TRUE {}", blobs_list.size());
         return true;
     }
 
@@ -222,6 +216,7 @@ std::unique_ptr<ReadBufferFromFileBase> AzureObjectStorage::readObjects( /// NOL
             settings_ptr->max_single_read_retries,
             settings_ptr->max_single_download_retries,
             /* use_external_buffer */true,
+            /* restricted_seek */true,
             read_until_position);
     };
 

From 036ddcd47baf88ab0c360efe647e01060d1ce636 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Wed, 7 Jun 2023 13:48:08 +0200
Subject: [PATCH 0568/1478] Fix excessive memory usage for FINAL (due to too
 much streams usage) (#50429)

Previously it could create MergeTreeInOrder for each mark, however this
could be very suboptimal, due to each MergeTreeInOrder has some memory
overhead.

Now, by collapsing all marks for one part together it is more memory
effiecient.

I've tried the query from the altinity wiki [1] and it decreases memory
usage twice:

    SELECT * FROM repl_tbl FINAL WHERE key IN (SELECT toUInt32(number) FROM numbers(1000000) WHERE number % 50000 = 0) FORMAT Null

- upstream: MemoryTracker: Peak memory usage (for query): 520.27 MiB.
- patched:  MemoryTracker: Peak memory usage (for query): 260.95 MiB.

  [1]: https://kb.altinity.com/engines/mergetree-table-engine-family/replacingmergetree/#multiple-keys

And it could be not 2x and even more or less, it depends on the gaps in
marks for reading (for example in my setup the memory usage increased a
lot, from ~16GiB of RAM to >64GiB due to lots of marks and gaps).

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Processors/QueryPlan/PartsSplitter.cpp    | 35 ++++++++++-----
 ...inal_streams_data_skipping_index.reference | 43 +++++++++++++++++++
 ...2780_final_streams_data_skipping_index.sql | 28 ++++++++++++
 3 files changed, 95 insertions(+), 11 deletions(-)
 create mode 100644 tests/queries/0_stateless/02780_final_streams_data_skipping_index.reference
 create mode 100644 tests/queries/0_stateless/02780_final_streams_data_skipping_index.sql

diff --git a/src/Processors/QueryPlan/PartsSplitter.cpp b/src/Processors/QueryPlan/PartsSplitter.cpp
index 936182f8c00..9796e696f6c 100644
--- a/src/Processors/QueryPlan/PartsSplitter.cpp
+++ b/src/Processors/QueryPlan/PartsSplitter.cpp
@@ -126,7 +126,9 @@ std::pair<std::vector<Values>, std::vector<RangesInDataParts>> split(RangesInDat
             return marks_in_current_layer < intersected_parts * 2;
         };
 
-        result_layers.emplace_back();
+        auto & current_layer = result_layers.emplace_back();
+        /// Map part_idx into index inside layer, used to merge marks from the same part into one reader
+        std::unordered_map<size_t, size_t> part_idx_in_layer;
 
         while (rows_in_current_layer < rows_per_layer || layers_intersection_is_too_big() || result_layers.size() == max_layers)
         {
@@ -140,11 +142,16 @@ std::pair<std::vector<Values>, std::vector<RangesInDataParts>> split(RangesInDat
 
                 if (current.event == PartsRangesIterator::EventType::RangeEnd)
                 {
-                    result_layers.back().emplace_back(
-                        parts[part_idx].data_part,
-                        parts[part_idx].alter_conversions,
-                        parts[part_idx].part_index_in_query,
-                        MarkRanges{{current_part_range_begin[part_idx], current.range.end}});
+                    const auto & mark = MarkRange{current_part_range_begin[part_idx], current.range.end};
+                    auto it = part_idx_in_layer.emplace(std::make_pair(part_idx, current_layer.size()));
+                    if (it.second)
+                        current_layer.emplace_back(
+                            parts[part_idx].data_part,
+                            parts[part_idx].alter_conversions,
+                            parts[part_idx].part_index_in_query,
+                            MarkRanges{mark});
+                    else
+                        current_layer[it.first->second].ranges.push_back(mark);
 
                     current_part_range_begin.erase(part_idx);
                     current_part_range_end.erase(part_idx);
@@ -170,11 +177,17 @@ std::pair<std::vector<Values>, std::vector<RangesInDataParts>> split(RangesInDat
         }
         for (const auto & [part_idx, last_mark] : current_part_range_end)
         {
-            result_layers.back().emplace_back(
-                parts[part_idx].data_part,
-                parts[part_idx].alter_conversions,
-                parts[part_idx].part_index_in_query,
-                MarkRanges{{current_part_range_begin[part_idx], last_mark + 1}});
+            const auto & mark = MarkRange{current_part_range_begin[part_idx], last_mark + 1};
+            auto it = part_idx_in_layer.emplace(std::make_pair(part_idx, current_layer.size()));
+
+            if (it.second)
+                result_layers.back().emplace_back(
+                    parts[part_idx].data_part,
+                    parts[part_idx].alter_conversions,
+                    parts[part_idx].part_index_in_query,
+                    MarkRanges{mark});
+            else
+                current_layer[it.first->second].ranges.push_back(mark);
 
             current_part_range_begin[part_idx] = current_part_range_end[part_idx];
         }
diff --git a/tests/queries/0_stateless/02780_final_streams_data_skipping_index.reference b/tests/queries/0_stateless/02780_final_streams_data_skipping_index.reference
new file mode 100644
index 00000000000..d7a540ae479
--- /dev/null
+++ b/tests/queries/0_stateless/02780_final_streams_data_skipping_index.reference
@@ -0,0 +1,43 @@
+-- { echoOn }
+EXPLAIN PIPELINE SELECT * FROM data FINAL WHERE v1 >= now() - INTERVAL 180 DAY
+SETTINGS max_threads=2, max_final_threads=2, force_data_skipping_indices='v1_index', use_skip_indexes_if_final=1
+FORMAT LineAsString;
+(Expression)
+ExpressionTransform × 2
+  (Filter)
+  FilterTransform × 2
+    (ReadFromMergeTree)
+    ExpressionTransform × 2
+      AggregatingSortedTransform 2 → 1
+        ExpressionTransform × 2
+          FilterSortedStreamByRange × 2
+          Description: filter values in [(999424), +inf)
+            ExpressionTransform × 2
+              MergeTreeInOrder × 2 0 → 1
+                AggregatingSortedTransform
+                  ExpressionTransform
+                    FilterSortedStreamByRange
+                    Description: filter values in [-inf, (999424))
+                      ExpressionTransform
+                        MergeTreeInOrder 0 → 1
+EXPLAIN PIPELINE SELECT * FROM data FINAL WHERE v1 >= now() - INTERVAL 180 DAY
+SETTINGS max_threads=2, max_final_threads=2, force_data_skipping_indices='v1_index', use_skip_indexes_if_final=0
+FORMAT LineAsString;
+(Expression)
+ExpressionTransform × 2
+  (Filter)
+  FilterTransform × 2
+    (ReadFromMergeTree)
+    ExpressionTransform × 2
+      AggregatingSortedTransform 2 → 1
+        ExpressionTransform × 2
+          FilterSortedStreamByRange × 2
+          Description: filter values in [(999424), +inf)
+            ExpressionTransform × 2
+              MergeTreeInOrder × 2 0 → 1
+                AggregatingSortedTransform
+                  ExpressionTransform
+                    FilterSortedStreamByRange
+                    Description: filter values in [-inf, (999424))
+                      ExpressionTransform
+                        MergeTreeInOrder 0 → 1
diff --git a/tests/queries/0_stateless/02780_final_streams_data_skipping_index.sql b/tests/queries/0_stateless/02780_final_streams_data_skipping_index.sql
new file mode 100644
index 00000000000..7de7a58e2e1
--- /dev/null
+++ b/tests/queries/0_stateless/02780_final_streams_data_skipping_index.sql
@@ -0,0 +1,28 @@
+-- Tags: no-random-merge-tree-settings, no-random-settings
+
+DROP TABLE IF EXISTS data;
+
+CREATE TABLE data
+(
+    key  Int,
+    v1   DateTime,
+    INDEX v1_index v1 TYPE minmax GRANULARITY 1
+) ENGINE=AggregatingMergeTree()
+ORDER BY key
+SETTINGS index_granularity=8192, min_bytes_for_wide_part=0, min_rows_for_wide_part=0;
+
+SYSTEM STOP MERGES data;
+
+-- generate 50% of marks that cannot be skipped with v1_index
+-- this will create a gap in marks
+INSERT INTO data SELECT number,     if(number/8192 % 2 == 0, now(), now() - INTERVAL 200 DAY) FROM numbers(1e6);
+INSERT INTO data SELECT number+1e6, if(number/8192 % 2 == 0, now(), now() - INTERVAL 200 DAY) FROM numbers(1e6);
+
+-- { echoOn }
+EXPLAIN PIPELINE SELECT * FROM data FINAL WHERE v1 >= now() - INTERVAL 180 DAY
+SETTINGS max_threads=2, max_final_threads=2, force_data_skipping_indices='v1_index', use_skip_indexes_if_final=1
+FORMAT LineAsString;
+
+EXPLAIN PIPELINE SELECT * FROM data FINAL WHERE v1 >= now() - INTERVAL 180 DAY
+SETTINGS max_threads=2, max_final_threads=2, force_data_skipping_indices='v1_index', use_skip_indexes_if_final=0
+FORMAT LineAsString;

From 81cd3defd79331fc0af016c4c40a957be15a227a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 7 Jun 2023 12:29:09 +0000
Subject: [PATCH 0569/1478] Fix expected results

---
 tests/queries/0_stateless/02354_annoy_index.reference | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 5bd1377d6f4..45515bc7733 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -9,7 +9,6 @@ ORDER BY type, L2Distance
 1	[0,0,10]
 5	[0,0,10.2]
 4	[0,0,9.7]
-Reference ARRAYs with non-matching dimension are rejected
 WHERE type, L2Distance, check that index is used
 Expression ((Projection + Before ORDER BY))
   Limit (preliminary LIMIT (without OFFSET))

From 87ac6b8b637e9931c32fffb8a273101295c161ba Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 7 Jun 2023 12:49:28 +0000
Subject: [PATCH 0570/1478] Fix reading negative decimals in avro format

---
 .../Formats/Impl/AvroRowInputFormat.cpp         |  10 ++++++++--
 .../0_stateless/02782_avro_decimals.reference   |  12 ++++++++++++
 .../queries/0_stateless/data_avro/decimals.avro | Bin 295 -> 353 bytes
 3 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index 60e541a0109..c8e4a499b81 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -184,8 +184,14 @@ static AvroDeserializer::DeserializeFn createDecimalDeserializeFn(const avro::No
                 field_type_size,
                 tmp.size());
         else if (tmp.size() != field_type_size)
-            /// Add padding with 0-bytes.
-            tmp = std::string(field_type_size - tmp.size(), '\0') + tmp;
+        {
+            /// Extent value to required size by adding paddinf.
+            /// Check if value is negative or positive.
+            if (tmp[0] & 128)
+                tmp = std::string(field_type_size - tmp.size(), 0xff) + tmp;
+            else
+                tmp = std::string(field_type_size - tmp.size(), 0) + tmp;
+        }
 
         typename DecimalType::FieldType field;
         ReadBufferFromString buf(tmp);
diff --git a/tests/queries/0_stateless/02782_avro_decimals.reference b/tests/queries/0_stateless/02782_avro_decimals.reference
index ed46f1c3758..a16e5e4ac56 100644
--- a/tests/queries/0_stateless/02782_avro_decimals.reference
+++ b/tests/queries/0_stateless/02782_avro_decimals.reference
@@ -11,3 +11,15 @@ d	Decimal(14, 4)
 12345678.1234
 123456789.1234
 1234567890.1234
+0
+-1
+-1.1
+-12.12
+-123.123
+-1234.1234
+-12345.1234
+-123456.1234
+-1234567.1234
+-12345678.1234
+-123456789.1234
+-1234567890.1234
diff --git a/tests/queries/0_stateless/data_avro/decimals.avro b/tests/queries/0_stateless/data_avro/decimals.avro
index 5c29ac235d59003696735c8c8092eed5bcce41b2..630d6864047e9638da9dc1437780c41bd820ca12 100644
GIT binary patch
delta 103
zcmZ3^^pI)78DSNbwU@s*w@gW!@aK?AzgoA!6UK@6EIpYRSZ;h^xyr%zPi+F*TeBvP
w|IQouIDRbgn8&d#OI(lZuYwBWKCZ`(=`4Oc{~q+Qe7nc<<!F!L1wM5105^OtQ~&?~

delta 45
ncmaFJw47<e8KImdJQ>$6Jnr7T_unL4xsVKrqKWq{1<*wS0^Syk


From cf947e6e01036d51ef0337378b12e868a07ecce2 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 7 Jun 2023 12:50:16 +0000
Subject: [PATCH 0571/1478] Fix typo

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

diff --git a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
index c8e4a499b81..1ec7491658e 100644
--- a/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/AvroRowInputFormat.cpp
@@ -185,7 +185,7 @@ static AvroDeserializer::DeserializeFn createDecimalDeserializeFn(const avro::No
                 tmp.size());
         else if (tmp.size() != field_type_size)
         {
-            /// Extent value to required size by adding paddinf.
+            /// Extent value to required size by adding padding.
             /// Check if value is negative or positive.
             if (tmp[0] & 128)
                 tmp = std::string(field_type_size - tmp.size(), 0xff) + tmp;

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 0572/1478] 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 0573/1478] 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 0574/1478] 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 0575/1478] 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 0576/1478] 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 0577/1478] 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 0578/1478] 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 0579/1478] 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 bf6900f64ca7614a686dfaa56f87c84c43408506 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 7 Jun 2023 17:08:18 +0200
Subject: [PATCH 0580/1478] Write 1 part and do not use OPTIMIZE FINAL

---
 ...e_row_level_policy_lightweight_delete.sql.j2 | 17 +----------------
 1 file changed, 1 insertion(+), 16 deletions(-)

diff --git a/tests/queries/0_stateless/02461_prewhere_row_level_policy_lightweight_delete.sql.j2 b/tests/queries/0_stateless/02461_prewhere_row_level_policy_lightweight_delete.sql.j2
index 1e4258cef7e..0ec6b2ed144 100644
--- a/tests/queries/0_stateless/02461_prewhere_row_level_policy_lightweight_delete.sql.j2
+++ b/tests/queries/0_stateless/02461_prewhere_row_level_policy_lightweight_delete.sql.j2
@@ -8,25 +8,10 @@ ORDER BY (SiteId, DateVisit)
 SETTINGS index_granularity = {{ index_granularity }}, min_bytes_for_wide_part = 0;
 
 -- Insert some data to have 110K rows in the range 2022-08-10 .. 2022-08-20 and some more rows before and after that range
-insert into url_na_log select 209, '2022-08-09' from numbers(10000);
-insert into url_na_log select 209, '2022-08-10' from numbers(10000);
-insert into url_na_log select 209, '2022-08-11' from numbers(10000);
-insert into url_na_log select 209, '2022-08-12' from numbers(10000);
-insert into url_na_log select 209, '2022-08-13' from numbers(10000);
-insert into url_na_log select 209, '2022-08-14' from numbers(10000);
-insert into url_na_log select 209, '2022-08-15' from numbers(10000);
-insert into url_na_log select 209, '2022-08-16' from numbers(10000);
-insert into url_na_log select 209, '2022-08-17' from numbers(10000);
-insert into url_na_log select 209, '2022-08-18' from numbers(10000);
-insert into url_na_log select 209, '2022-08-19' from numbers(10000);
-insert into url_na_log select 209, '2022-08-20' from numbers(10000);
-insert into url_na_log select 209, '2022-08-21' from numbers(10000);
-
+insert into url_na_log select 209, ('2022-08-09'::Date + INTERVAL intDiv(number,10000) DAY) from numbers(130000) SETTINGS max_insert_block_size=200000;
 
 SET mutations_sync=2;
 
-OPTIMIZE TABLE url_na_log FINAL;
-
 -- { echoOn }
 
 SELECT count() FROM url_na_log;

From a67dd6e47947295bd853ee1d26ad66a94861dabe Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Wed, 7 Jun 2023 17:25:48 +0200
Subject: [PATCH 0581/1478] Readuntilend

---
 src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp | 16 ++++++++++++++++
 src/Disks/IO/ReadBufferFromAzureBlobStorage.h   |  1 +
 2 files changed, 17 insertions(+)

diff --git a/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp b/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
index a086eb0a6df..129bb97be09 100644
--- a/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
+++ b/src/Disks/IO/ReadBufferFromAzureBlobStorage.cpp
@@ -56,6 +56,22 @@ ReadBufferFromAzureBlobStorage::ReadBufferFromAzureBlobStorage(
     }
 }
 
+
+void ReadBufferFromAzureBlobStorage::setReadUntilEnd()
+{
+    if (read_until_position)
+    {
+        read_until_position = 0;
+        if (initialized)
+        {
+            offset = getPosition();
+            resetWorkingBuffer();
+            initialized = false;
+        }
+    }
+
+}
+
 void ReadBufferFromAzureBlobStorage::setReadUntilPosition(size_t position)
 {
     read_until_position = position;
diff --git a/src/Disks/IO/ReadBufferFromAzureBlobStorage.h b/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
index 599ecba1dd1..4e21f543653 100644
--- a/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
+++ b/src/Disks/IO/ReadBufferFromAzureBlobStorage.h
@@ -38,6 +38,7 @@ public:
     String getFileName() const override { return path; }
 
     void setReadUntilPosition(size_t position) override;
+    void setReadUntilEnd() override;
 
     bool supportsRightBoundedReads() const override { return true; }
 

From cf65ac499c8f8cc8e49fa9654bc45723a99d3a6d Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Wed, 7 Jun 2023 17:34:26 +0200
Subject: [PATCH 0582/1478] Fix iterator

---
 src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
index fd6452b7c2a..f91c19f2fb9 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
@@ -25,7 +25,6 @@ void IObjectStorageIteratorAsync::nextBatch()
          current_batch = std::move(next_batch.batch);
          accumulated_size.fetch_add(current_batch.size(), std::memory_order_relaxed);
          current_batch_iterator = current_batch.begin();
-         LOG_DEBUG(&Poco::Logger::get("DEBUG"), "HAS NEXT {}", next_batch.has_next);
          if (next_batch.has_next)
              outcome_future = scheduleBatch();
          else
@@ -78,6 +77,7 @@ bool IObjectStorageIteratorAsync::isValid()
     if (!is_initialized)
         nextBatch();
 
+    std::lock_guard lock(mutex);
     return current_batch_iterator != current_batch.end();
 }
 
@@ -86,16 +86,17 @@ RelativePathWithMetadata IObjectStorageIteratorAsync::current()
     if (!isValid())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
 
+    std::lock_guard lock(mutex);
     return *current_batch_iterator;
 }
 
 
 RelativePathsWithMetadata IObjectStorageIteratorAsync::currentBatch()
 {
-    std::lock_guard lock(mutex);
     if (!isValid())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Trying to access invalid iterator");
 
+    std::lock_guard lock(mutex);
     return current_batch;
 }
 

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 0583/1478] 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 b78e330129575d9b77f9da5cb6511eee56d5deaf Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Wed, 7 Jun 2023 18:09:55 +0200
Subject: [PATCH 0584/1478] Better test

---
 .../integration/test_storage_azure_blob_storage/test.py  | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 8a0a68f5200..319500e6226 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -126,6 +126,7 @@ def test_simple_write_named_collection_1(cluster):
     )
     print(get_azure_file_content("test_simple_write_named.csv"))
     assert get_azure_file_content("test_simple_write_named.csv") == '1,"a"\n'
+    azure_query(node, "TRUNCATE TABLE test_simple_write_named_collection_1")
 
 
 def test_simple_write_named_collection_2(cluster):
@@ -487,6 +488,14 @@ def test_simple_write_named_collection_1_table_function(cluster):
     print(get_azure_file_content("test_simple_write_named.csv"))
     assert get_azure_file_content("test_simple_write_named.csv") == '1,"a"\n'
 
+    azure_query(
+        node,
+        "CREATE TABLE drop_table (key UInt64, data String) Engine = AzureBlobStorage(azure_conf1)",
+    )
+
+    azure_query(
+        node, "TRUNCATE TABLE drop_table",
+    )
 
 def test_simple_write_named_collection_2_table_function(cluster):
     node = cluster.instances["node"]

From 8d67296e3aee48f92ec82fd55637dfe16122c02d Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Wed, 7 Jun 2023 16:22:42 +0000
Subject: [PATCH 0585/1478] Automatic style fix

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 319500e6226..2c052c005ca 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -494,9 +494,11 @@ def test_simple_write_named_collection_1_table_function(cluster):
     )
 
     azure_query(
-        node, "TRUNCATE TABLE drop_table",
+        node,
+        "TRUNCATE TABLE drop_table",
     )
 
+
 def test_simple_write_named_collection_2_table_function(cluster):
     node = cluster.instances["node"]
 

From c12c62a7fb7072772f423c907c467c39762ec5a7 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 7 Jun 2023 18:22:53 +0200
Subject: [PATCH 0586/1478] Update src/Parsers/ParserCreateIndexQuery.cpp

Co-authored-by: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
---
 src/Parsers/ParserCreateIndexQuery.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Parsers/ParserCreateIndexQuery.cpp b/src/Parsers/ParserCreateIndexQuery.cpp
index e878b347e62..7323c5da141 100644
--- a/src/Parsers/ParserCreateIndexQuery.cpp
+++ b/src/Parsers/ParserCreateIndexQuery.cpp
@@ -42,9 +42,6 @@ bool ParserCreateIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected
             return false;
     }
 
-    if (!granularity_p.parse(pos, granularity, expected))
-        return false;
-
     auto index = std::make_shared<ASTIndexDeclaration>();
     index->part_of_create_index_query = true;
     index->set(index->expr, expr);

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 0587/1478] 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 0588/1478] 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 3cdbccd9ea2eefa230d70fb23506fcbe5c01148b Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 7 Jun 2023 16:50:04 +0000
Subject: [PATCH 0589/1478] Unify priorities: `IExecutableTask`s

---
 src/Storages/MergeTree/IExecutableTask.h             |  5 +++--
 src/Storages/MergeTree/MergeFromLogEntryTask.cpp     |  2 +-
 src/Storages/MergeTree/MergeFromLogEntryTask.h       |  4 ++--
 src/Storages/MergeTree/MergePlainMergeTreeTask.h     |  6 +++---
 src/Storages/MergeTree/MergeTreeBackgroundExecutor.h |  2 +-
 src/Storages/MergeTree/MutateFromLogEntryTask.cpp    |  2 +-
 src/Storages/MergeTree/MutateFromLogEntryTask.h      |  4 ++--
 src/Storages/MergeTree/MutatePlainMergeTreeTask.h    |  6 +++---
 src/Storages/MergeTree/MutateTask.cpp                |  7 ++++---
 src/Storages/MergeTree/tests/gtest_executor.cpp      | 10 +++++-----
 10 files changed, 25 insertions(+), 23 deletions(-)

diff --git a/src/Storages/MergeTree/IExecutableTask.h b/src/Storages/MergeTree/IExecutableTask.h
index 9617960c182..d0c2d4a840e 100644
--- a/src/Storages/MergeTree/IExecutableTask.h
+++ b/src/Storages/MergeTree/IExecutableTask.h
@@ -5,6 +5,7 @@
 
 #include <boost/noncopyable.hpp>
 #include <Interpreters/StorageID.h>
+#include <Common/Priority.h>
 
 namespace DB
 {
@@ -32,7 +33,7 @@ public:
     virtual bool executeStep() = 0;
     virtual void onCompleted() = 0;
     virtual StorageID getStorageID() = 0;
-    virtual UInt64 getPriority() = 0;
+    virtual Priority getPriority() = 0;
     virtual ~IExecutableTask() = default;
 };
 
@@ -63,7 +64,7 @@ public:
 
     void onCompleted() override { job_result_callback(!res); }
     StorageID getStorageID() override { return id; }
-    UInt64 getPriority() override
+    Priority getPriority() override
     {
         throw Exception(ErrorCodes::LOGICAL_ERROR, "getPriority() method is not supported by LambdaAdapter");
     }
diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
index a5b4a29cb18..5cee402f88c 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
@@ -291,7 +291,7 @@ ReplicatedMergeMutateTaskBase::PrepareResult MergeFromLogEntryTask::prepare()
 
     /// Adjust priority
     for (auto & item : future_merged_part->parts)
-        priority += item->getBytesOnDisk();
+        priority.value += item->getBytesOnDisk();
 
     return {true, true, [this, stopwatch = *stopwatch_ptr] (const ExecutionStatus & execution_status)
     {
diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.h b/src/Storages/MergeTree/MergeFromLogEntryTask.h
index 9d870cd9a4b..2c559c06d7e 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.h
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.h
@@ -22,7 +22,7 @@ public:
         StorageReplicatedMergeTree & storage_,
         IExecutableTask::TaskResultCallback & task_result_callback_);
 
-    UInt64 getPriority() override { return priority; }
+    Priority getPriority() override { return priority; }
 
 protected:
     /// Both return false if we can't execute merge.
@@ -44,7 +44,7 @@ private:
     StopwatchUniquePtr stopwatch_ptr{nullptr};
     MergeTreeData::MutableDataPartPtr part;
 
-    UInt64 priority{0};
+    Priority priority;
 
     MergeTaskPtr merge_task;
 };
diff --git a/src/Storages/MergeTree/MergePlainMergeTreeTask.h b/src/Storages/MergeTree/MergePlainMergeTreeTask.h
index 369b4390da7..95df8c90c9b 100644
--- a/src/Storages/MergeTree/MergePlainMergeTreeTask.h
+++ b/src/Storages/MergeTree/MergePlainMergeTreeTask.h
@@ -34,13 +34,13 @@ public:
         , task_result_callback(task_result_callback_)
     {
         for (auto & item : merge_mutate_entry->future_part->parts)
-            priority += item->getBytesOnDisk();
+            priority.value += item->getBytesOnDisk();
     }
 
     bool executeStep() override;
     void onCompleted() override;
     StorageID getStorageID() override;
-    UInt64 getPriority() override { return priority; }
+    Priority getPriority() override { return priority; }
 
     void setCurrentTransaction(MergeTreeTransactionHolder && txn_holder_, MergeTreeTransactionPtr && txn_)
     {
@@ -77,7 +77,7 @@ private:
     using MergeListEntryPtr = std::unique_ptr<MergeListEntry>;
     MergeListEntryPtr merge_list_entry;
 
-    UInt64 priority{0};
+    Priority priority;
 
     std::function<void(const ExecutionStatus &)> write_part_log;
     std::function<void()> transfer_profile_counters_to_initial_query;
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.h b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.h
index 8142e383d0c..552ed32e2d2 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.h
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.h
@@ -63,7 +63,7 @@ struct TaskRuntimeData
     /// This scenario in not possible in reality.
     Poco::Event is_done{/*autoreset=*/false};
     /// This is equal to task->getPriority() not to do useless virtual calls in comparator
-    UInt64 priority{0};
+    Priority priority;
 
     /// By default priority queue will have max element at top
     static bool comparePtrByPriority(const TaskRuntimeDataPtr & lhs, const TaskRuntimeDataPtr & rhs)
diff --git a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
index d0b85ee65b8..42dccef7e6f 100644
--- a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
@@ -184,7 +184,7 @@ ReplicatedMergeMutateTaskBase::PrepareResult MutateFromLogEntryTask::prepare()
 
     /// Adjust priority
     for (auto & item : future_mutated_part->parts)
-        priority += item->getBytesOnDisk();
+        priority.value += item->getBytesOnDisk();
 
     return {true, true, [this] (const ExecutionStatus & execution_status)
     {
diff --git a/src/Storages/MergeTree/MutateFromLogEntryTask.h b/src/Storages/MergeTree/MutateFromLogEntryTask.h
index 2a2cc308f85..42b4debcbf2 100644
--- a/src/Storages/MergeTree/MutateFromLogEntryTask.h
+++ b/src/Storages/MergeTree/MutateFromLogEntryTask.h
@@ -27,7 +27,7 @@ public:
         {}
 
 
-    UInt64 getPriority() override { return priority; }
+    Priority getPriority() override { return priority; }
 
 private:
 
@@ -40,7 +40,7 @@ private:
         return mutate_task->execute();
     }
 
-    UInt64 priority{0};
+    Priority priority;
 
     TableLockHolder table_lock_holder{nullptr};
     ReservationSharedPtr reserved_space{nullptr};
diff --git a/src/Storages/MergeTree/MutatePlainMergeTreeTask.h b/src/Storages/MergeTree/MutatePlainMergeTreeTask.h
index 823ea6d7a0f..bd03c276256 100644
--- a/src/Storages/MergeTree/MutatePlainMergeTreeTask.h
+++ b/src/Storages/MergeTree/MutatePlainMergeTreeTask.h
@@ -36,13 +36,13 @@ public:
         , task_result_callback(task_result_callback_)
     {
         for (auto & part : merge_mutate_entry->future_part->parts)
-            priority += part->getBytesOnDisk();
+            priority.value += part->getBytesOnDisk();
     }
 
     bool executeStep() override;
     void onCompleted() override;
     StorageID getStorageID() override;
-    UInt64 getPriority() override { return priority; }
+    Priority getPriority() override { return priority; }
 
 private:
 
@@ -66,7 +66,7 @@ private:
     std::unique_ptr<Stopwatch> stopwatch;
     MergeTreeData::MutableDataPartPtr new_part;
 
-    UInt64 priority{0};
+    Priority priority;
 
     using MergeListEntryPtr = std::unique_ptr<MergeListEntry>;
     MergeListEntryPtr merge_list_entry;
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index 76096d00641..31b3c249177 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -1,5 +1,6 @@
 #include <Storages/MergeTree/MutateTask.h>
 
+#include "Common/Priority.h"
 #include <Common/logger_useful.h>
 #include <Common/escapeForFileName.h>
 #include <Storages/MergeTree/DataPartStorageOnDiskFull.h>
@@ -961,7 +962,7 @@ public:
 
     void onCompleted() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
     StorageID getStorageID() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
-    UInt64 getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
+    Priority getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
 
     bool executeStep() override
     {
@@ -1283,7 +1284,7 @@ public:
 
     void onCompleted() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
     StorageID getStorageID() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
-    UInt64 getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
+    Priority getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
 
     bool executeStep() override
     {
@@ -1412,7 +1413,7 @@ public:
 
     void onCompleted() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
     StorageID getStorageID() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
-    UInt64 getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
+    Priority getPriority() override { throw Exception(ErrorCodes::LOGICAL_ERROR, "Not implemented"); }
 
     bool executeStep() override
     {
diff --git a/src/Storages/MergeTree/tests/gtest_executor.cpp b/src/Storages/MergeTree/tests/gtest_executor.cpp
index 3a4f147b456..5815b74284a 100644
--- a/src/Storages/MergeTree/tests/gtest_executor.cpp
+++ b/src/Storages/MergeTree/tests/gtest_executor.cpp
@@ -51,7 +51,7 @@ public:
             throw std::runtime_error("Unlucky...");
     }
 
-    UInt64 getPriority() override { return 0; }
+    Priority getPriority() override { return {}; }
 
 private:
     std::mt19937 generator;
@@ -65,11 +65,11 @@ using StepFunc = std::function<void(const String & name, size_t steps_left)>;
 class LambdaExecutableTask : public IExecutableTask
 {
 public:
-    explicit LambdaExecutableTask(const String & name_, size_t step_count_, StepFunc step_func_ = {}, UInt64 priority_ = 0)
+    explicit LambdaExecutableTask(const String & name_, size_t step_count_, StepFunc step_func_ = {}, Int64 priority_value = 0)
         : name(name_)
         , step_count(step_count_)
         , step_func(step_func_)
-        , priority(priority_)
+        , priority{priority_value}
     {}
 
     bool executeStep() override
@@ -86,13 +86,13 @@ public:
 
     void onCompleted() override {}
 
-    UInt64 getPriority() override { return priority; }
+    Priority getPriority() override { return priority; }
 
 private:
     String name;
     size_t step_count;
     StepFunc step_func;
-    UInt64 priority;
+    Priority priority;
 };
 
 

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 0590/1478] 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 0591/1478] 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 e1ceb01ad0b8988ec70818472740fdeff5acf112 Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
Date: Wed, 7 Jun 2023 19:45:27 +0200
Subject: [PATCH 0592/1478] Parallel replicas for short queries (#50639)

---
 src/Core/Settings.h                           |  1 +
 src/Storages/MergeTree/MergeTreeData.cpp      | 39 +++++++++++++++++++
 src/Storages/MergeTree/MergeTreeData.h        |  7 ++++
 tests/broken_tests.txt                        |  2 +-
 ...lel_replicas_automatic_disabling.reference |  2 +
 ..._parallel_replicas_automatic_disabling.sql | 15 +++++++
 6 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.reference
 create mode 100644 tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.sql

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 0037acedede..a87e321bed2 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -160,6 +160,7 @@ class IColumn;
     M(UInt64, allow_experimental_parallel_reading_from_replicas, 0, "Use all the replicas from a shard for SELECT query execution. Reading is parallelized and coordinated dynamically. 0 - disabled, 1 - enabled, silently disable them in case of failure, 2 - enabled, throw an exception in case of failure", 0) \
     M(Float, parallel_replicas_single_task_marks_count_multiplier, 2, "A multiplier which will be added during calculation for minimal number of marks to retrieve from coordinator. This will be applied only for remote replicas.", 0) \
     M(Bool, parallel_replicas_for_non_replicated_merge_tree, false, "If true, ClickHouse will use parallel replicas algorithm also for non-replicated MergeTree tables", 0) \
+    M(UInt64, parallel_replicas_min_number_of_granules_to_enable, 0, "If the number of marks to read is less than the value of this setting - parallel replicas will be disabled", 0) \
     \
     M(Bool, skip_unavailable_shards, false, "If true, ClickHouse silently skips unavailable shards and nodes unresolvable through DNS. Shard is marked as unavailable when none of the replicas can be reached.", 0) \
     \
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index e806e1bb93f..2f6870f8b41 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -7154,6 +7154,9 @@ QueryProcessingStage::Enum MergeTreeData::getQueryProcessingStage(
     /// Parallel replicas
     if (query_context->canUseParallelReplicasOnInitiator() && to_stage >= QueryProcessingStage::WithMergeableState)
     {
+        if (!canUseParallelReplicasBasedOnPKAnalysis(query_context, storage_snapshot, query_info))
+            return QueryProcessingStage::Enum::FetchColumns;
+
         /// ReplicatedMergeTree
         if (supportsReplication())
             return QueryProcessingStage::Enum::WithMergeableState;
@@ -7179,6 +7182,42 @@ QueryProcessingStage::Enum MergeTreeData::getQueryProcessingStage(
 }
 
 
+bool MergeTreeData::canUseParallelReplicasBasedOnPKAnalysis(
+    ContextPtr query_context,
+    const StorageSnapshotPtr & storage_snapshot,
+    SelectQueryInfo & query_info) const
+{
+    const auto & snapshot_data = assert_cast<const MergeTreeData::SnapshotData &>(*storage_snapshot->data);
+    const auto & parts = snapshot_data.parts;
+
+    MergeTreeDataSelectExecutor reader(*this);
+    auto result_ptr = reader.estimateNumMarksToRead(
+        parts,
+        query_info.prewhere_info,
+        storage_snapshot->getMetadataForQuery()->getColumns().getAll().getNames(),
+        storage_snapshot->metadata,
+        storage_snapshot->metadata,
+        query_info,
+        /*added_filter_nodes*/ActionDAGNodes{},
+        query_context,
+        query_context->getSettingsRef().max_threads);
+
+    if (result_ptr->error())
+        std::rethrow_exception(std::get<std::exception_ptr>(result_ptr->result));
+
+    LOG_TRACE(log, "Estimated number of granules to read is {}", result_ptr->marks());
+
+    bool decision = result_ptr->marks() >= query_context->getSettingsRef().parallel_replicas_min_number_of_granules_to_enable;
+
+    if (!decision)
+        LOG_DEBUG(log, "Parallel replicas will be disabled, because the estimated number of granules to read {} is less than the threshold which is {}",
+            result_ptr->marks(),
+            query_context->getSettingsRef().parallel_replicas_min_number_of_granules_to_enable);
+
+    return decision;
+}
+
+
 MergeTreeData & MergeTreeData::checkStructureAndGetMergeTreeData(IStorage & source_table, const StorageMetadataPtr & src_snapshot, const StorageMetadataPtr & my_snapshot) const
 {
     MergeTreeData * src_data = dynamic_cast<MergeTreeData *>(&source_table);
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 2f254f9a787..b1e1e43bd0b 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -1536,6 +1536,13 @@ private:
     static MutableDataPartPtr asMutableDeletingPart(const DataPartPtr & part);
 
     mutable TemporaryParts temporary_parts;
+
+    /// Estimate the number of marks to read to make a decision whether to enable parallel replicas (distributed processing) or not
+    /// Note: it could be very rough.
+    bool canUseParallelReplicasBasedOnPKAnalysis(
+        ContextPtr query_context,
+        const StorageSnapshotPtr & storage_snapshot,
+        SelectQueryInfo & query_info) const;
 };
 
 /// RAII struct to record big parts that are submerging or emerging.
diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index 02935712325..7ee497973b8 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -137,4 +137,4 @@
 02534_s3_cluster_insert_select_schema_inference
 02764_parallel_replicas_plain_merge_tree
 02765_parallel_replicas_final_modifier
-
+02784_parallel_replicas_automatic_disabling
diff --git a/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.reference b/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.reference
new file mode 100644
index 00000000000..af81158ecae
--- /dev/null
+++ b/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.reference
@@ -0,0 +1,2 @@
+10
+1
diff --git a/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.sql b/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.sql
new file mode 100644
index 00000000000..b2f674ddb64
--- /dev/null
+++ b/tests/queries/0_stateless/02784_parallel_replicas_automatic_disabling.sql
@@ -0,0 +1,15 @@
+DROP TABLE IF EXISTS test_parallel_replicas_automatic_disabling;
+CREATE TABLE test_parallel_replicas_automatic_disabling (n UInt64) ENGINE=MergeTree() ORDER BY tuple();
+INSERT INTO test_parallel_replicas_automatic_disabling SELECT * FROM numbers(10);
+
+SYSTEM FLUSH LOGS;
+
+SET skip_unavailable_shards=1, allow_experimental_parallel_reading_from_replicas=1, max_parallel_replicas=3, use_hedged_requests=0, cluster_for_parallel_replicas='parallel_replicas', parallel_replicas_for_non_replicated_merge_tree=1, parallel_replicas_min_number_of_granules_to_enable=10000;
+SET send_logs_level='error';
+SELECT count() FROM test_parallel_replicas_automatic_disabling WHERE NOT ignore(*);
+
+SYSTEM FLUSH LOGS;
+
+SELECT count() > 0 FROM system.text_log WHERE event_time >= now() - INTERVAL 2 MINUTE AND message LIKE '%Parallel replicas will be disabled, because the estimated number of granules to read%';
+
+DROP TABLE test_parallel_replicas_automatic_disabling;

From c0f2141bd0432c7ebcab5ee0ef033141194fd59d Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
Date: Wed, 7 Jun 2023 19:51:41 +0200
Subject: [PATCH 0593/1478] Revert "date_trunc function to always return
 DateTime type" (#50670)

---
 src/Functions/date_trunc.cpp                  | 98 ++++++++-----------
 .../00189_time_zones_long.reference           | 56 +++++------
 ...21_datetime64_compatibility_long.reference |  8 +-
 3 files changed, 71 insertions(+), 91 deletions(-)

diff --git a/src/Functions/date_trunc.cpp b/src/Functions/date_trunc.cpp
index 87fff0b7f3c..016b8f4da5e 100644
--- a/src/Functions/date_trunc.cpp
+++ b/src/Functions/date_trunc.cpp
@@ -1,6 +1,6 @@
 #include <Columns/ColumnConst.h>
-#include <Columns/ColumnString.h>
 #include <Columns/ColumnsNumber.h>
+#include <Columns/ColumnString.h>
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeDateTime.h>
 #include <DataTypes/DataTypeInterval.h>
@@ -25,7 +25,7 @@ class FunctionDateTrunc : public IFunction
 public:
     static constexpr auto name = "dateTrunc";
 
-    explicit FunctionDateTrunc(ContextPtr context_) : context(context_) { }
+    explicit FunctionDateTrunc(ContextPtr context_) : context(context_) {}
 
     static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionDateTrunc>(context); }
 
@@ -39,58 +39,51 @@ public:
     {
         /// The first argument is a constant string with the name of datepart.
 
-        intermediate_type_is_date = false;
+        auto result_type_is_date = false;
         String datepart_param;
-        auto check_first_argument = [&]
-        {
+        auto check_first_argument = [&] {
             const ColumnConst * datepart_column = checkAndGetColumnConst<ColumnString>(arguments[0].column.get());
             if (!datepart_column)
-                throw Exception(
-                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
-                    "First argument for function {} must be constant string: "
-                    "name of datepart",
-                    getName());
+                throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "First argument for function {} must be constant string: "
+                    "name of datepart", getName());
 
             datepart_param = datepart_column->getValue<String>();
             if (datepart_param.empty())
-                throw Exception(
-                    ErrorCodes::BAD_ARGUMENTS, "First argument (name of datepart) for function {} cannot be empty", getName());
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "First argument (name of datepart) for function {} cannot be empty",
+                    getName());
 
             if (!IntervalKind::tryParseString(datepart_param, datepart_kind))
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "{} doesn't look like datepart name in {}", datepart_param, getName());
 
-            intermediate_type_is_date = (datepart_kind == IntervalKind::Year) || (datepart_kind == IntervalKind::Quarter)
-                || (datepart_kind == IntervalKind::Month) || (datepart_kind == IntervalKind::Week);
+            result_type_is_date = (datepart_kind == IntervalKind::Year)
+                || (datepart_kind == IntervalKind::Quarter) || (datepart_kind == IntervalKind::Month)
+                || (datepart_kind == IntervalKind::Week);
         };
 
         bool second_argument_is_date = false;
-        auto check_second_argument = [&]
-        {
+        auto check_second_argument = [&] {
             if (!isDate(arguments[1].type) && !isDateTime(arguments[1].type) && !isDateTime64(arguments[1].type))
-                throw Exception(
-                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
-                    "Illegal type {} of 2nd argument of function {}. "
-                    "Should be a date or a date with time",
-                    arguments[1].type->getName(),
-                    getName());
+                throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of 2nd argument of function {}. "
+                    "Should be a date or a date with time", arguments[1].type->getName(), getName());
 
             second_argument_is_date = isDate(arguments[1].type);
 
-            if (second_argument_is_date
-                && ((datepart_kind == IntervalKind::Hour) || (datepart_kind == IntervalKind::Minute)
-                    || (datepart_kind == IntervalKind::Second)))
+            if (second_argument_is_date && ((datepart_kind == IntervalKind::Hour)
+                || (datepart_kind == IntervalKind::Minute) || (datepart_kind == IntervalKind::Second)))
                 throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type Date of argument for function {}", getName());
         };
 
-        auto check_timezone_argument = [&]
-        {
+        auto check_timezone_argument = [&] {
             if (!WhichDataType(arguments[2].type).isString())
-                throw Exception(
-                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
-                    "Illegal type {} of argument of function {}. "
+                throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of argument of function {}. "
                     "This argument is optional and must be a constant string with timezone name",
-                    arguments[2].type->getName(),
-                    getName());
+                    arguments[2].type->getName(), getName());
+
+            if (second_argument_is_date && result_type_is_date)
+                throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
+                                "The timezone argument of function {} with datepart '{}' "
+                                "is allowed only when the 2nd argument has the type DateTime",
+                                getName(), datepart_param);
         };
 
         if (arguments.size() == 2)
@@ -106,14 +99,15 @@ public:
         }
         else
         {
-            throw Exception(
-                ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
+            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
                 "Number of arguments for function {} doesn't match: passed {}, should be 2 or 3",
-                getName(),
-                arguments.size());
+                getName(), arguments.size());
         }
 
-        return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 1));
+        if (result_type_is_date)
+            return std::make_shared<DataTypeDate>();
+        else
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 1));
     }
 
     bool useDefaultImplementationForConstants() const override { return true; }
@@ -130,40 +124,26 @@ public:
 
         auto to_start_of_interval = FunctionFactory::instance().get("toStartOfInterval", context);
 
-        ColumnPtr truncated_column;
-        auto date_type = std::make_shared<DataTypeDate>();
-
         if (arguments.size() == 2)
-            truncated_column = to_start_of_interval->build(temp_columns)
-                                    ->execute(temp_columns, intermediate_type_is_date ? date_type : result_type, input_rows_count);
-        else
-        {
-            temp_columns[2] = arguments[2];
-            truncated_column = to_start_of_interval->build(temp_columns)
-                                    ->execute(temp_columns, intermediate_type_is_date ? date_type : result_type, input_rows_count);
-        }
+            return to_start_of_interval->build(temp_columns)->execute(temp_columns, result_type, input_rows_count);
 
-        if (!intermediate_type_is_date)
-            return truncated_column;
-
-        ColumnsWithTypeAndName temp_truncated_column(1);
-        temp_truncated_column[0] = {truncated_column, date_type, ""};
-
-        auto to_date_time_or_default = FunctionFactory::instance().get("toDateTime", context);
-        return to_date_time_or_default->build(temp_truncated_column)->execute(temp_truncated_column, result_type, input_rows_count);
+        temp_columns[2] = arguments[2];
+        return to_start_of_interval->build(temp_columns)->execute(temp_columns, result_type, input_rows_count);
     }
 
-    bool hasInformationAboutMonotonicity() const override { return true; }
+    bool hasInformationAboutMonotonicity() const override
+    {
+        return true;
+    }
 
     Monotonicity getMonotonicityForRange(const IDataType &, const Field &, const Field &) const override
     {
-        return {.is_monotonic = true, .is_always_monotonic = true};
+        return { .is_monotonic = true, .is_always_monotonic = true };
     }
 
 private:
     ContextPtr context;
     mutable IntervalKind::Kind datepart_kind = IntervalKind::Kind::Second;
-    mutable bool intermediate_type_is_date = false;
 };
 
 }
diff --git a/tests/queries/0_stateless/00189_time_zones_long.reference b/tests/queries/0_stateless/00189_time_zones_long.reference
index a4287217a19..7d2ad3c8a01 100644
--- a/tests/queries/0_stateless/00189_time_zones_long.reference
+++ b/tests/queries/0_stateless/00189_time_zones_long.reference
@@ -258,18 +258,18 @@ toUnixTimestamp
 1426415400
 1426415400
 date_trunc
-2019-01-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-10-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-12-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-12-30 00:00:00
-2019-12-30 00:00:00
-2019-12-30 00:00:00
+2019-01-01
+2020-01-01
+2020-01-01
+2019-10-01
+2020-01-01
+2020-01-01
+2019-12-01
+2020-01-01
+2020-01-01
+2019-12-30
+2019-12-30
+2019-12-30
 2019-12-31 00:00:00
 2020-01-01 00:00:00
 2020-01-02 00:00:00
@@ -282,18 +282,18 @@ date_trunc
 2019-12-31 20:11:22
 2020-01-01 12:11:22
 2020-01-02 05:11:22
-2019-01-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-10-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-12-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-12-30 00:00:00
-2019-12-30 00:00:00
-2019-12-30 00:00:00
+2019-01-01
+2020-01-01
+2020-01-01
+2019-10-01
+2020-01-01
+2020-01-01
+2019-12-01
+2020-01-01
+2020-01-01
+2019-12-30
+2019-12-30
+2019-12-30
 2019-12-31 00:00:00
 2020-01-01 00:00:00
 2020-01-02 00:00:00
@@ -306,8 +306,8 @@ date_trunc
 2019-12-31 20:11:22
 2020-01-01 12:11:22
 2020-01-02 05:11:22
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2020-01-01 00:00:00
-2019-12-30 00:00:00
+2020-01-01
+2020-01-01
+2020-01-01
+2019-12-30
 2020-01-01 00:00:00
diff --git a/tests/queries/0_stateless/00921_datetime64_compatibility_long.reference b/tests/queries/0_stateless/00921_datetime64_compatibility_long.reference
index 2f56230db37..a946a114bf4 100644
--- a/tests/queries/0_stateless/00921_datetime64_compatibility_long.reference
+++ b/tests/queries/0_stateless/00921_datetime64_compatibility_long.reference
@@ -135,13 +135,13 @@ Code: 43
 ------------------------------------------
 SELECT date_trunc(\'year\', N, \'Asia/Istanbul\')
 Code: 43
-"DateTime('Asia/Istanbul')","2019-01-01 00:00:00"
-"DateTime('Asia/Istanbul')","2019-01-01 00:00:00"
+"Date","2019-01-01"
+"Date","2019-01-01"
 ------------------------------------------
 SELECT date_trunc(\'month\', N, \'Asia/Istanbul\')
 Code: 43
-"DateTime('Asia/Istanbul')","2019-09-01 00:00:00"
-"DateTime('Asia/Istanbul')","2019-09-01 00:00:00"
+"Date","2019-09-01"
+"Date","2019-09-01"
 ------------------------------------------
 SELECT date_trunc(\'day\', N, \'Asia/Istanbul\')
 "DateTime('Asia/Istanbul')","2019-09-16 00:00:00"

From 7d5b98f0288fdebedf1984fce168260023448676 Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Wed, 7 Jun 2023 20:03:17 +0200
Subject: [PATCH 0594/1478] Remove logging add sleeps

---
 src/Storages/StorageAzureBlob.cpp                         | 8 --------
 src/TableFunctions/TableFunctionAzureBlobStorage.cpp      | 2 --
 tests/integration/test_storage_azure_blob_storage/test.py | 1 +
 3 files changed, 1 insertion(+), 10 deletions(-)

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 17374ba2d92..4901f6701fb 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -124,8 +124,6 @@ void StorageAzureBlob::processNamedCollectionResult(StorageAzureBlob::Configurat
 
 StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
 {
-    LOG_INFO(&Poco::Logger::get("StorageAzureBlob"), "get_format_from_file  = {}", get_format_from_file);
-
     StorageAzureBlob::Configuration configuration;
 
     /// Supported signatures:
@@ -857,7 +855,6 @@ StorageAzureBlobSource::Iterator::Iterator(
     }
     else
     {
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "GLOBS BRANCH");
         const String key_prefix = blob_path_with_globs->substr(0, blob_path_with_globs->find_first_of("*?{"));
 
         /// We don't have to list bucket, because there is no asterisks.
@@ -870,11 +867,8 @@ StorageAzureBlobSource::Iterator::Iterator(
             return;
         }
 
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "KEY PREFIX {}", key_prefix);
         object_storage_iterator = object_storage->iterate(key_prefix);
 
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "BLOBS BLOBS{}", *blob_path_with_globs);
-        LOG_DEBUG(&Poco::Logger::get("DEBUG"), "REGEXP PATTERN {}", makeRegexpPatternFromGlobs(*blob_path_with_globs));
         matcher = std::make_unique<re2::RE2>(makeRegexpPatternFromGlobs(*blob_path_with_globs));
 
         if (!matcher->ok())
@@ -1105,7 +1099,6 @@ String StorageAzureBlobSource::getName() const
 StorageAzureBlobSource::ReaderHolder StorageAzureBlobSource::createReader()
 {
     auto [current_key, info] = file_iterator->next();
-    LOG_DEBUG(log, "KEY {} SIZE {}", current_key, info.size_bytes);
     if (current_key.empty())
         return {};
 
@@ -1118,7 +1111,6 @@ StorageAzureBlobSource::ReaderHolder StorageAzureBlobSource::createReader()
             format_settings, std::nullopt, std::nullopt,
             /* is_remote_fs */ true, compression_method);
 
-    LOG_DEBUG(log, "FORMAT {}", format);
     QueryPipelineBuilder builder;
     builder.init(Pipe(input_format));
 
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index 986ad07fdde..265092ddefa 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -78,7 +78,6 @@ StorageAzureBlob::Configuration TableFunctionAzureBlobStorage::parseArgumentsImp
     std::unordered_map<std::string_view, size_t> engine_args_to_idx;
 
     configuration.connection_url = checkAndGetLiteralArgument<String>(engine_args[0], "connection_string/storage_account_url");
-    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "CONFIGURATION {}", configuration.connection_url);
     configuration.is_connection_string = isConnectionString(configuration.connection_url);
 
     configuration.container = checkAndGetLiteralArgument<String>(engine_args[1], "container");
@@ -194,7 +193,6 @@ void TableFunctionAzureBlobStorage::parseArguments(const ASTPtr & ast_function,
     auto & args = args_func.at(0)->children;
 
     configuration = parseArgumentsImpl(args, context);
-    LOG_DEBUG(&Poco::Logger::get("DEBUG"), "CONFIGURATION {}", configuration.connection_url);
 }
 
 ColumnsDescription TableFunctionAzureBlobStorage::getActualTableStructure(ContextPtr context) const
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 319500e6226..a7ca049e809 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -47,6 +47,7 @@ def azure_query(node, query, try_num=3, settings={}):
                 if error in str(ex):
                     retry = True
                     print(f"Try num: {i}. Having retriable error: {ex}")
+                    time.sleep(i)
                     break
             if not retry or i == try_num - 1:
                 raise Exception(ex)

From f3b5a87a66baa6ffed9cba8caa52e4c4a63cfc3d Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Tue, 6 Jun 2023 19:03:23 +0000
Subject: [PATCH 0595/1478] Fixing crash in anti/semi join

---
 src/Interpreters/HashJoin.cpp                 | 12 ++--
 src/Interpreters/TableJoin.h                  | 15 ++++-
 src/Planner/PlannerJoinTree.cpp               |  7 ++-
 .../02771_semi_join_use_nulls.reference       |  0
 .../02771_semi_join_use_nulls.sql.j2          | 60 +++++++++++++++++++
 5 files changed, 85 insertions(+), 9 deletions(-)
 create mode 100644 tests/queries/0_stateless/02771_semi_join_use_nulls.reference
 create mode 100644 tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2

diff --git a/src/Interpreters/HashJoin.cpp b/src/Interpreters/HashJoin.cpp
index 9306c9b99eb..191dd74928d 100644
--- a/src/Interpreters/HashJoin.cpp
+++ b/src/Interpreters/HashJoin.cpp
@@ -679,7 +679,7 @@ void HashJoin::initRightBlockStructure(Block & saved_block_sample)
     /// We could remove key columns for LEFT | INNER HashJoin but we should keep them for JoinSwitcher (if any).
     bool save_key_columns = table_join->isEnabledAlgorithm(JoinAlgorithm::AUTO) ||
                             table_join->isEnabledAlgorithm(JoinAlgorithm::GRACE_HASH) ||
-                            isRightOrFull(kind) ||
+                            isRightOrFull(kind) || strictness == JoinStrictness::Semi || strictness == JoinStrictness::Anti ||
                             multiple_disjuncts;
     if (save_key_columns)
     {
@@ -707,8 +707,9 @@ Block HashJoin::prepareRightBlock(const Block & block, const Block & saved_block
     for (const auto & sample_column : saved_block_sample_.getColumnsWithTypeAndName())
     {
         ColumnWithTypeAndName column = block.getByName(sample_column.name);
-        if (sample_column.column->isNullable())
-            JoinCommon::convertColumnToNullable(column);
+
+        /// There's no optimization for right side const columns. Remove constness if any.
+        column.column = recursiveRemoveSparse(column.column->convertToFullColumnIfConst());
 
         if (column.column->lowCardinality() && !sample_column.column->lowCardinality())
         {
@@ -716,8 +717,9 @@ Block HashJoin::prepareRightBlock(const Block & block, const Block & saved_block
             column.type = removeLowCardinality(column.type);
         }
 
-        /// There's no optimization for right side const columns. Remove constness if any.
-        column.column = recursiveRemoveSparse(column.column->convertToFullColumnIfConst());
+        if (sample_column.column->isNullable())
+            JoinCommon::convertColumnToNullable(column);
+
         structured_block.insert(std::move(column));
     }
 
diff --git a/src/Interpreters/TableJoin.h b/src/Interpreters/TableJoin.h
index 0e0c905e30c..4a020684793 100644
--- a/src/Interpreters/TableJoin.h
+++ b/src/Interpreters/TableJoin.h
@@ -232,8 +232,19 @@ public:
     bool allowParallelHashJoin() const;
 
     bool joinUseNulls() const { return join_use_nulls; }
-    bool forceNullableRight() const { return join_use_nulls && isLeftOrFull(kind()); }
-    bool forceNullableLeft() const { return join_use_nulls && isRightOrFull(kind()); }
+
+    /// Join use nulls doen't make sense for semi and anti joins
+    /// Only columns from corresponding table should be used, values in other table are undefined.
+    bool forceNullableRight() const
+    {
+        return join_use_nulls && isLeftOrFull(kind()) && strictness() != JoinStrictness::Semi && strictness() != JoinStrictness::Anti;
+    }
+
+    bool forceNullableLeft() const
+    {
+        return join_use_nulls && isRightOrFull(kind()) && strictness() != JoinStrictness::Semi && strictness() != JoinStrictness::Anti;
+    }
+
     size_t defaultMaxBytes() const { return default_max_bytes; }
     size_t maxJoinedBlockRows() const { return max_joined_block_rows; }
     size_t maxRowsInRightBlock() const { return partial_merge_join_rows_in_right_blocks; }
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index 9672738ae6b..c0c6d301d88 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -873,10 +873,11 @@ JoinTreeQueryPlan buildQueryPlanForJoinNode(const QueryTreeNodePtr & join_table_
 
     JoinClausesAndActions join_clauses_and_actions;
     JoinKind join_kind = join_node.getKind();
+    JoinStrictness join_strictness = join_node.getStrictness();
 
     std::optional<bool> join_constant;
 
-    if (join_node.getStrictness() == JoinStrictness::All)
+    if (join_strictness == JoinStrictness::All)
         join_constant = tryExtractConstantFromJoinNode(join_table_expression);
 
     if (join_constant)
@@ -996,7 +997,9 @@ JoinTreeQueryPlan buildQueryPlanForJoinNode(const QueryTreeNodePtr & join_table_
         plan_to_add_cast.addStep(std::move(cast_join_columns_step));
     };
 
-    if (join_use_nulls)
+    /// Join use nulls doen't make sense for semi and anti joins
+    /// Only columns from corresponding table should be used, values in other table are undefined.
+    if (join_use_nulls && join_strictness != JoinStrictness::Semi && join_strictness != JoinStrictness::Anti)
     {
         if (isFull(join_kind))
         {
diff --git a/tests/queries/0_stateless/02771_semi_join_use_nulls.reference b/tests/queries/0_stateless/02771_semi_join_use_nulls.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2 b/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2
new file mode 100644
index 00000000000..308df9a6094
--- /dev/null
+++ b/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2
@@ -0,0 +1,60 @@
+
+{% for allow_experimental_analyzer in [0, 1] -%}
+{% for join_use_nulls in [0, 1] -%}
+{% for kind in ['LEFT', 'RIGHT'] -%}
+{% for strictness in ['SEMI', 'ANTI'] -%}
+{% for maybe_materialize in ['', 'materialize'] -%}
+
+SET allow_experimental_analyzer = {{ allow_experimental_analyzer }};
+
+SET join_use_nulls = {{ join_use_nulls }};
+
+-- FORMAT Null is used because one side is undefined (e.g. for SEMI LEFT only columns from the left side contain values)
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
+USING (id)
+FORMAT Null
+;
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
+USING (id)
+FORMAT Null
+;
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id) AS d
+USING (id)
+FORMAT Null
+;
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id) AS d
+USING (id)
+FORMAT Null
+;
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(1)) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(2)) AS id) AS d
+USING (id)
+FORMAT Null
+;
+
+SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
+ON a.id = d.id
+FORMAT Null
+;
+
+SELECT id > 1, d.idd FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
+{{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS idd) AS d
+ON a.id = d.idd
+FORMAT Null
+;
+
+{% endfor -%}
+{% endfor -%}
+{% endfor -%}
+{% endfor -%}
+{% endfor -%}

From a268250aff8fad35828641d6242c9d6d0e9ee3a3 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Wed, 7 Jun 2023 13:25:06 +0000
Subject: [PATCH 0596/1478] Fixes for LowCardinality Nullable in HashJoin

---
 src/Columns/ColumnLowCardinality.cpp          |   5 +
 src/Columns/tests/gtest_low_cardinality.cpp   |  13 ++
 src/Interpreters/HashJoin.cpp                 |   2 +-
 src/Interpreters/JoinUtils.cpp                |  18 +--
 src/Interpreters/TableJoin.h                  |   6 +-
 src/Planner/PlannerJoinTree.cpp               |   4 +-
 .../02771_semi_join_use_nulls.reference       | 112 ++++++++++++++++++
 .../02771_semi_join_use_nulls.sql.j2          |   9 --
 8 files changed, 140 insertions(+), 29 deletions(-)

diff --git a/src/Columns/ColumnLowCardinality.cpp b/src/Columns/ColumnLowCardinality.cpp
index 4f9ab8215be..9269ea4ee4d 100644
--- a/src/Columns/ColumnLowCardinality.cpp
+++ b/src/Columns/ColumnLowCardinality.cpp
@@ -313,6 +313,11 @@ MutableColumnPtr ColumnLowCardinality::cloneResized(size_t size) const
 MutableColumnPtr ColumnLowCardinality::cloneNullable() const
 {
     auto res = cloneFinalized();
+    /* Compact required not to share dictionary.
+     * If `shared` flag is not set `cloneFinalized` will return shallow copy
+     * and `nestedToNullable` will mutate source column.
+     */
+    assert_cast<ColumnLowCardinality &>(*res).compactInplace();
     assert_cast<ColumnLowCardinality &>(*res).nestedToNullable();
     return res;
 }
diff --git a/src/Columns/tests/gtest_low_cardinality.cpp b/src/Columns/tests/gtest_low_cardinality.cpp
index 3ffc88f6a7d..5e01279b7df 100644
--- a/src/Columns/tests/gtest_low_cardinality.cpp
+++ b/src/Columns/tests/gtest_low_cardinality.cpp
@@ -48,3 +48,16 @@ TEST(ColumnLowCardinality, Insert)
     testLowCardinalityNumberInsert<Float32>(std::make_shared<DataTypeFloat32>());
     testLowCardinalityNumberInsert<Float64>(std::make_shared<DataTypeFloat64>());
 }
+
+TEST(ColumnLowCardinality, Clone)
+{
+    auto data_type = std::make_shared<DataTypeInt32>();
+    auto low_cardinality_type = std::make_shared<DataTypeLowCardinality>(data_type);
+    auto column = low_cardinality_type->createColumn();
+    ASSERT_FALSE(assert_cast<const ColumnLowCardinality &>(*column).nestedIsNullable());
+
+    auto nullable_column = assert_cast<const ColumnLowCardinality &>(*column).cloneNullable();
+
+    ASSERT_TRUE(assert_cast<const ColumnLowCardinality &>(*nullable_column).nestedIsNullable());
+    ASSERT_FALSE(assert_cast<const ColumnLowCardinality &>(*column).nestedIsNullable());
+}
diff --git a/src/Interpreters/HashJoin.cpp b/src/Interpreters/HashJoin.cpp
index 191dd74928d..c4d1615a119 100644
--- a/src/Interpreters/HashJoin.cpp
+++ b/src/Interpreters/HashJoin.cpp
@@ -679,7 +679,7 @@ void HashJoin::initRightBlockStructure(Block & saved_block_sample)
     /// We could remove key columns for LEFT | INNER HashJoin but we should keep them for JoinSwitcher (if any).
     bool save_key_columns = table_join->isEnabledAlgorithm(JoinAlgorithm::AUTO) ||
                             table_join->isEnabledAlgorithm(JoinAlgorithm::GRACE_HASH) ||
-                            isRightOrFull(kind) || strictness == JoinStrictness::Semi || strictness == JoinStrictness::Anti ||
+                            isRightOrFull(kind) ||
                             multiple_disjuncts;
     if (save_key_columns)
     {
diff --git a/src/Interpreters/JoinUtils.cpp b/src/Interpreters/JoinUtils.cpp
index a05b58e14a1..67ee2a64264 100644
--- a/src/Interpreters/JoinUtils.cpp
+++ b/src/Interpreters/JoinUtils.cpp
@@ -160,16 +160,14 @@ static ColumnPtr tryConvertColumnToNullable(ColumnPtr col)
 
     if (col->lowCardinality())
     {
-        auto mut_col = IColumn::mutate(std::move(col));
-        ColumnLowCardinality * col_lc = assert_cast<ColumnLowCardinality *>(mut_col.get());
-        if (col_lc->nestedIsNullable())
+        const ColumnLowCardinality & col_lc = assert_cast<const ColumnLowCardinality &>(*col);
+        if (col_lc.nestedIsNullable())
         {
-            return mut_col;
+            return col;
         }
-        else if (col_lc->nestedCanBeInsideNullable())
+        else if (col_lc.nestedCanBeInsideNullable())
         {
-            col_lc->nestedToNullable();
-            return mut_col;
+            return col_lc.cloneNullable();
         }
     }
     else if (const ColumnConst * col_const = checkAndGetColumn<ColumnConst>(*col))
@@ -232,11 +230,7 @@ void removeColumnNullability(ColumnWithTypeAndName & column)
 
         if (column.column && column.column->lowCardinality())
         {
-            auto mut_col = IColumn::mutate(std::move(column.column));
-            ColumnLowCardinality * col_as_lc = typeid_cast<ColumnLowCardinality *>(mut_col.get());
-            if (col_as_lc && col_as_lc->nestedIsNullable())
-                col_as_lc->nestedRemoveNullable();
-            column.column = std::move(mut_col);
+            column.column = assert_cast<const ColumnLowCardinality *>(column.column.get())->cloneWithDefaultOnNull();
         }
     }
     else
diff --git a/src/Interpreters/TableJoin.h b/src/Interpreters/TableJoin.h
index 4a020684793..6737cd8f13a 100644
--- a/src/Interpreters/TableJoin.h
+++ b/src/Interpreters/TableJoin.h
@@ -233,16 +233,14 @@ public:
 
     bool joinUseNulls() const { return join_use_nulls; }
 
-    /// Join use nulls doen't make sense for semi and anti joins
-    /// Only columns from corresponding table should be used, values in other table are undefined.
     bool forceNullableRight() const
     {
-        return join_use_nulls && isLeftOrFull(kind()) && strictness() != JoinStrictness::Semi && strictness() != JoinStrictness::Anti;
+        return join_use_nulls && isLeftOrFull(kind());
     }
 
     bool forceNullableLeft() const
     {
-        return join_use_nulls && isRightOrFull(kind()) && strictness() != JoinStrictness::Semi && strictness() != JoinStrictness::Anti;
+        return join_use_nulls && isRightOrFull(kind());
     }
 
     size_t defaultMaxBytes() const { return default_max_bytes; }
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index c0c6d301d88..d875cc38bce 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -997,9 +997,7 @@ JoinTreeQueryPlan buildQueryPlanForJoinNode(const QueryTreeNodePtr & join_table_
         plan_to_add_cast.addStep(std::move(cast_join_columns_step));
     };
 
-    /// Join use nulls doen't make sense for semi and anti joins
-    /// Only columns from corresponding table should be used, values in other table are undefined.
-    if (join_use_nulls && join_strictness != JoinStrictness::Semi && join_strictness != JoinStrictness::Anti)
+    if (join_use_nulls)
     {
         if (isFull(join_kind))
         {
diff --git a/tests/queries/0_stateless/02771_semi_join_use_nulls.reference b/tests/queries/0_stateless/02771_semi_join_use_nulls.reference
index e69de29bb2d..8d4b1a3a75e 100644
--- a/tests/queries/0_stateless/02771_semi_join_use_nulls.reference
+++ b/tests/queries/0_stateless/02771_semi_join_use_nulls.reference
@@ -0,0 +1,112 @@
+0	0
+0	0
+0	\N
+0	0
+0	0
+0	0
+0	0
+0	0
+0	\N
+0	0
+0	0
+0	0
+0	1
+0	1
+0	0
+0	0
+0	\N
+0	0
+0	0
+0	0
+0	0
+0	0
+0	\N
+0	0
+0	0
+0	0
+0	2
+0	2
+0	\N
+0	0
+0	\N
+0	0
+0	\N
+0	\N
+0	\N
+0	0
+0	\N
+0	0
+0	\N
+0	\N
+0	1
+0	1
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+\N	2
+\N	2
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	1
+0	1
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+1	2
+1	2
+0	\N
+0	0
+0	0
+0	0
+0	\N
+0	\N
+0	\N
+0	0
+0	0
+0	0
+0	\N
+0	\N
+0	1
+0	1
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+0	0
+1	2
+1	2
diff --git a/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2 b/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2
index 308df9a6094..37b2e63761b 100644
--- a/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2
+++ b/tests/queries/0_stateless/02771_semi_join_use_nulls.sql.j2
@@ -9,48 +9,39 @@ SET allow_experimental_analyzer = {{ allow_experimental_analyzer }};
 
 SET join_use_nulls = {{ join_use_nulls }};
 
--- FORMAT Null is used because one side is undefined (e.g. for SEMI LEFT only columns from the left side contain values)
-
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
 USING (id)
-FORMAT Null
 ;
 
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
 USING (id)
-FORMAT Null
 ;
 
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id) AS d
 USING (id)
-FORMAT Null
 ;
 
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(toNullable(0))) AS id) AS d
 USING (id)
-FORMAT Null
 ;
 
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(1)) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(2)) AS id) AS d
 USING (id)
-FORMAT Null
 ;
 
 SELECT id > 1, d.id FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id) AS d
 ON a.id = d.id
-FORMAT Null
 ;
 
 SELECT id > 1, d.idd FROM (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS id, 1 AS value) AS a
 {{ strictness }} {{ kind }} JOIN (SELECT {{ maybe_materialize }}(toLowCardinality(0)) AS idd) AS d
 ON a.id = d.idd
-FORMAT Null
 ;
 
 {% endfor -%}

From b11f744252b486ca0ba25deeb07181b4025e0edf Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Wed, 7 Jun 2023 20:33:08 +0200
Subject: [PATCH 0597/1478] Correctly disable async insert with deduplication
 when it's not needed (#50663)

* Correctly disable async insert when it's not used

* Better

* Add comment

* Better

* Fix tests

---------

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 src/Core/ExternalTable.cpp                    |  2 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |  2 +-
 src/Interpreters/InterpreterInsertQuery.cpp   |  4 +--
 .../Transforms/CreatingSetsTransform.cpp      |  2 +-
 .../Transforms/buildPushingToViewsChain.cpp   |  9 +++---
 .../Transforms/buildPushingToViewsChain.h     |  2 ++
 src/Server/GRPCServer.cpp                     |  2 +-
 src/Server/TCPHandler.cpp                     |  2 +-
 src/Storages/HDFS/StorageHDFS.cpp             |  2 +-
 src/Storages/HDFS/StorageHDFS.h               |  2 +-
 src/Storages/Hive/StorageHive.cpp             |  2 +-
 src/Storages/Hive/StorageHive.h               |  2 +-
 src/Storages/IStorage.h                       |  5 +++-
 src/Storages/Kafka/StorageKafka.cpp           |  2 +-
 src/Storages/Kafka/StorageKafka.h             |  3 +-
 .../MeiliSearch/StorageMeiliSearch.cpp        |  2 +-
 src/Storages/MeiliSearch/StorageMeiliSearch.h |  2 +-
 src/Storages/NATS/StorageNATS.cpp             |  2 +-
 src/Storages/NATS/StorageNATS.h               |  2 +-
 src/Storages/RabbitMQ/StorageRabbitMQ.cpp     |  2 +-
 src/Storages/RabbitMQ/StorageRabbitMQ.h       |  3 +-
 .../RocksDB/StorageEmbeddedRocksDB.cpp        |  2 +-
 src/Storages/RocksDB/StorageEmbeddedRocksDB.h |  2 +-
 src/Storages/StorageBuffer.cpp                |  2 +-
 src/Storages/StorageBuffer.h                  |  2 +-
 src/Storages/StorageDistributed.cpp           |  4 +--
 src/Storages/StorageDistributed.h             |  2 +-
 src/Storages/StorageFile.cpp                  |  3 +-
 src/Storages/StorageFile.h                    |  3 +-
 src/Storages/StorageJoin.cpp                  |  4 +--
 src/Storages/StorageJoin.h                    |  2 +-
 src/Storages/StorageKeeperMap.cpp             |  2 +-
 src/Storages/StorageKeeperMap.h               |  2 +-
 src/Storages/StorageLog.cpp                   |  2 +-
 src/Storages/StorageLog.h                     |  2 +-
 src/Storages/StorageMaterializedMySQL.h       |  2 +-
 src/Storages/StorageMaterializedView.cpp      |  4 +--
 src/Storages/StorageMaterializedView.h        |  2 +-
 src/Storages/StorageMemory.cpp                |  2 +-
 src/Storages/StorageMemory.h                  |  2 +-
 src/Storages/StorageMergeTree.cpp             |  2 +-
 src/Storages/StorageMergeTree.h               |  2 +-
 src/Storages/StorageMongoDB.cpp               |  2 +-
 src/Storages/StorageMongoDB.h                 |  3 +-
 src/Storages/StorageMySQL.cpp                 |  2 +-
 src/Storages/StorageMySQL.h                   |  2 +-
 src/Storages/StorageNull.h                    |  2 +-
 src/Storages/StoragePostgreSQL.cpp            |  2 +-
 src/Storages/StoragePostgreSQL.h              |  2 +-
 src/Storages/StorageProxy.h                   |  4 +--
 src/Storages/StorageReplicatedMergeTree.cpp   |  4 +--
 src/Storages/StorageReplicatedMergeTree.h     |  2 +-
 src/Storages/StorageS3.cpp                    |  2 +-
 src/Storages/StorageS3.h                      |  2 +-
 src/Storages/StorageSQLite.cpp                |  2 +-
 src/Storages/StorageSQLite.h                  |  2 +-
 src/Storages/StorageSet.cpp                   |  2 +-
 src/Storages/StorageSet.h                     |  2 +-
 src/Storages/StorageStripeLog.cpp             |  2 +-
 src/Storages/StorageStripeLog.h               |  2 +-
 src/Storages/StorageTableFunction.h           |  5 ++--
 src/Storages/StorageURL.cpp                   |  2 +-
 src/Storages/StorageURL.h                     |  2 +-
 src/Storages/StorageXDBC.cpp                  |  2 +-
 src/Storages/StorageXDBC.h                    |  2 +-
 .../System/StorageSystemZooKeeper.cpp         |  2 +-
 src/Storages/System/StorageSystemZooKeeper.h  |  2 +-
 src/Storages/WindowView/StorageWindowView.cpp |  2 +-
 src/Storages/tests/gtest_storage_log.cpp      |  2 +-
 ...sable_async_with_dedup_correctly.reference | 17 +++++++++++
 ...2784_disable_async_with_dedup_correctly.sh | 29 +++++++++++++++++++
 71 files changed, 136 insertions(+), 78 deletions(-)
 create mode 100644 tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.reference
 create mode 100755 tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.sh

diff --git a/src/Core/ExternalTable.cpp b/src/Core/ExternalTable.cpp
index 0f880ed967f..676af280cad 100644
--- a/src/Core/ExternalTable.cpp
+++ b/src/Core/ExternalTable.cpp
@@ -167,7 +167,7 @@ void ExternalTablesHandler::handlePart(const Poco::Net::MessageHeader & header,
     auto temporary_table = TemporaryTableHolder(getContext(), ColumnsDescription{columns}, {});
     auto storage = temporary_table.getTable();
     getContext()->addExternalTable(data->table_name, std::move(temporary_table));
-    auto sink = storage->write(ASTPtr(), storage->getInMemoryMetadataPtr(), getContext());
+    auto sink = storage->write(ASTPtr(), storage->getInMemoryMetadataPtr(), getContext(), /*async_insert=*/false);
 
     /// Write data
     auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*data->pipe));
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 08862032007..2901f2e23d0 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -170,7 +170,7 @@ public:
             else if (getContext()->getSettingsRef().use_index_for_in_with_subqueries)
             {
                 auto external_table = external_storage_holder->getTable();
-                auto table_out = external_table->write({}, external_table->getInMemoryMetadataPtr(), getContext());
+                auto table_out = external_table->write({}, external_table->getInMemoryMetadataPtr(), getContext(), /*async_insert=*/false);
                 auto io = interpreter->execute();
                 io.pipeline.complete(std::move(table_out));
                 CompletedPipelineExecutor executor(io.pipeline);
diff --git a/src/Interpreters/InterpreterInsertQuery.cpp b/src/Interpreters/InterpreterInsertQuery.cpp
index e87b16f0e9d..078499fb013 100644
--- a/src/Interpreters/InterpreterInsertQuery.cpp
+++ b/src/Interpreters/InterpreterInsertQuery.cpp
@@ -282,7 +282,7 @@ Chain InterpreterInsertQuery::buildSink(
     ///       Otherwise we'll get duplicates when MV reads same rows again from Kafka.
     if (table->noPushingToViews() && !no_destination)
     {
-        auto sink = table->write(query_ptr, metadata_snapshot, context_ptr);
+        auto sink = table->write(query_ptr, metadata_snapshot, context_ptr, async_insert);
         sink->setRuntimeData(thread_status, elapsed_counter_ms);
         out.addSource(std::move(sink));
     }
@@ -290,7 +290,7 @@ Chain InterpreterInsertQuery::buildSink(
     {
         out = buildPushingToViewsChain(table, metadata_snapshot, context_ptr,
             query_ptr, no_destination,
-            thread_status_holder, running_group, elapsed_counter_ms);
+            thread_status_holder, running_group, elapsed_counter_ms, async_insert);
     }
 
     return out;
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index e3ae2d4fd4e..c6ac8bea5ba 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -91,7 +91,7 @@ void CreatingSetsTransform::startSubquery()
 
     if (subquery.table)
         /// TODO: make via port
-        table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), getContext()));
+        table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), getContext(), /*async_insert=*/false));
 
     done_with_set = !subquery.set_in_progress;
     done_with_table = !subquery.table;
diff --git a/src/Processors/Transforms/buildPushingToViewsChain.cpp b/src/Processors/Transforms/buildPushingToViewsChain.cpp
index 31bab46b868..0d33f250b5d 100644
--- a/src/Processors/Transforms/buildPushingToViewsChain.cpp
+++ b/src/Processors/Transforms/buildPushingToViewsChain.cpp
@@ -196,6 +196,7 @@ Chain buildPushingToViewsChain(
     ThreadStatusesHolderPtr thread_status_holder,
     ThreadGroupPtr running_group,
     std::atomic_uint64_t * elapsed_counter_ms,
+    bool async_insert,
     const Block & live_view_header)
 {
     checkStackSize();
@@ -347,7 +348,7 @@ Chain buildPushingToViewsChain(
             out = buildPushingToViewsChain(
                 view, view_metadata_snapshot, insert_context, ASTPtr(),
                 /* no_destination= */ true,
-                thread_status_holder, running_group, view_counter_ms, storage_header);
+                thread_status_holder, running_group, view_counter_ms, async_insert, storage_header);
         }
         else if (auto * window_view = dynamic_cast<StorageWindowView *>(view.get()))
         {
@@ -356,13 +357,13 @@ Chain buildPushingToViewsChain(
             out = buildPushingToViewsChain(
                 view, view_metadata_snapshot, insert_context, ASTPtr(),
                 /* no_destination= */ true,
-                thread_status_holder, running_group, view_counter_ms);
+                thread_status_holder, running_group, view_counter_ms, async_insert);
         }
         else
             out = buildPushingToViewsChain(
                 view, view_metadata_snapshot, insert_context, ASTPtr(),
                 /* no_destination= */ false,
-                thread_status_holder, running_group, view_counter_ms);
+                thread_status_holder, running_group, view_counter_ms, async_insert);
 
         views_data->views.emplace_back(ViewRuntimeData{
             std::move(query),
@@ -444,7 +445,7 @@ Chain buildPushingToViewsChain(
     /// Do not push to destination table if the flag is set
     else if (!no_destination)
     {
-        auto sink = storage->write(query_ptr, metadata_snapshot, context);
+        auto sink = storage->write(query_ptr, metadata_snapshot, context, async_insert);
         metadata_snapshot->check(sink->getHeader().getColumnsWithTypeAndName());
         sink->setRuntimeData(thread_status, elapsed_counter_ms);
         result_chain.addSource(std::move(sink));
diff --git a/src/Processors/Transforms/buildPushingToViewsChain.h b/src/Processors/Transforms/buildPushingToViewsChain.h
index 0f413bee5c6..53aceeda1cc 100644
--- a/src/Processors/Transforms/buildPushingToViewsChain.h
+++ b/src/Processors/Transforms/buildPushingToViewsChain.h
@@ -69,6 +69,8 @@ Chain buildPushingToViewsChain(
     ThreadGroupPtr running_group,
     /// Counter to measure time spent separately per view. Should be improved.
     std::atomic_uint64_t * elapsed_counter_ms,
+    /// True if it's part of async insert flush
+    bool async_insert,
     /// LiveView executes query itself, it needs source block structure.
     const Block & live_view_header = {});
 
diff --git a/src/Server/GRPCServer.cpp b/src/Server/GRPCServer.cpp
index 7b8eaa21947..e335d247a82 100644
--- a/src/Server/GRPCServer.cpp
+++ b/src/Server/GRPCServer.cpp
@@ -1101,7 +1101,7 @@ namespace
                 {
                     /// The data will be written directly to the table.
                     auto metadata_snapshot = storage->getInMemoryMetadataPtr();
-                    auto sink = storage->write(ASTPtr(), metadata_snapshot, query_context);
+                    auto sink = storage->write(ASTPtr(), metadata_snapshot, query_context, /*async_insert=*/false);
 
                     std::unique_ptr<ReadBuffer> buf = std::make_unique<ReadBufferFromMemory>(external_table.data().data(), external_table.data().size());
                     buf = wrapReadBufferWithCompressionMethod(std::move(buf), chooseCompressionMethod("", external_table.compression_type()));
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 0522b6d8a48..1ded7d97248 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -1692,7 +1692,7 @@ bool TCPHandler::receiveData(bool scalar)
         }
         auto metadata_snapshot = storage->getInMemoryMetadataPtr();
         /// The data will be written directly to the table.
-        QueryPipeline temporary_table_out(storage->write(ASTPtr(), metadata_snapshot, query_context));
+        QueryPipeline temporary_table_out(storage->write(ASTPtr(), metadata_snapshot, query_context, /*async_insert=*/false));
         PushingPipelineExecutor executor(temporary_table_out);
         executor.start();
         executor.push(block);
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 98c2579e355..194a8f982d8 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -624,7 +624,7 @@ Pipe StorageHDFS::read(
     return Pipe::unitePipes(std::move(pipes));
 }
 
-SinkToStoragePtr StorageHDFS::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context_)
+SinkToStoragePtr StorageHDFS::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context_, bool /*async_insert*/)
 {
     String current_uri = uris.back();
 
diff --git a/src/Storages/HDFS/StorageHDFS.h b/src/Storages/HDFS/StorageHDFS.h
index b123834e981..c6226c2618d 100644
--- a/src/Storages/HDFS/StorageHDFS.h
+++ b/src/Storages/HDFS/StorageHDFS.h
@@ -41,7 +41,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override;
 
     void truncate(
         const ASTPtr & query,
diff --git a/src/Storages/Hive/StorageHive.cpp b/src/Storages/Hive/StorageHive.cpp
index f554a14ec75..00c942fd56b 100644
--- a/src/Storages/Hive/StorageHive.cpp
+++ b/src/Storages/Hive/StorageHive.cpp
@@ -905,7 +905,7 @@ HiveFiles StorageHive::collectHiveFiles(
     return hive_files;
 }
 
-SinkToStoragePtr StorageHive::write(const ASTPtr & /*query*/, const StorageMetadataPtr & /* metadata_snapshot*/, ContextPtr /*context*/)
+SinkToStoragePtr StorageHive::write(const ASTPtr & /*query*/, const StorageMetadataPtr & /* metadata_snapshot*/, ContextPtr /*context*/, bool /*async_insert*/)
 {
     throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is not implemented for StorageHive");
 }
diff --git a/src/Storages/Hive/StorageHive.h b/src/Storages/Hive/StorageHive.h
index b4afb2421b1..604df70f4d0 100644
--- a/src/Storages/Hive/StorageHive.h
+++ b/src/Storages/Hive/StorageHive.h
@@ -61,7 +61,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/) override;
+    SinkToStoragePtr write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/, bool async_insert) override;
 
     NamesAndTypesList getVirtuals() const override;
 
diff --git a/src/Storages/IStorage.h b/src/Storages/IStorage.h
index c163e8107ac..d44772850fd 100644
--- a/src/Storages/IStorage.h
+++ b/src/Storages/IStorage.h
@@ -402,11 +402,14 @@ public:
       * passed in all parts of the returned streams. Storage metadata can be
       * changed during lifetime of the returned streams, but the snapshot is
       * guaranteed to be immutable.
+      *
+      * async_insert - set to true if the write is part of async insert flushing
       */
     virtual SinkToStoragePtr write(
         const ASTPtr & /*query*/,
         const StorageMetadataPtr & /*metadata_snapshot*/,
-        ContextPtr /*context*/)
+        ContextPtr /*context*/,
+        bool /*async_insert*/)
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is not supported by storage {}", getName());
     }
diff --git a/src/Storages/Kafka/StorageKafka.cpp b/src/Storages/Kafka/StorageKafka.cpp
index 7d504833a0a..2aba76c1a3f 100644
--- a/src/Storages/Kafka/StorageKafka.cpp
+++ b/src/Storages/Kafka/StorageKafka.cpp
@@ -374,7 +374,7 @@ Pipe StorageKafka::read(
 }
 
 
-SinkToStoragePtr StorageKafka::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageKafka::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto modified_context = Context::createCopy(local_context);
     modified_context->applySettingsChanges(settings_adjustments);
diff --git a/src/Storages/Kafka/StorageKafka.h b/src/Storages/Kafka/StorageKafka.h
index 3559129cf74..09aa091ef18 100644
--- a/src/Storages/Kafka/StorageKafka.h
+++ b/src/Storages/Kafka/StorageKafka.h
@@ -60,7 +60,8 @@ public:
     SinkToStoragePtr write(
         const ASTPtr & query,
         const StorageMetadataPtr & /*metadata_snapshot*/,
-        ContextPtr context) override;
+        ContextPtr context,
+        bool async_insert) override;
 
     /// We want to control the number of rows in a chunk inserted into Kafka
     bool prefersLargeBlocks() const override { return false; }
diff --git a/src/Storages/MeiliSearch/StorageMeiliSearch.cpp b/src/Storages/MeiliSearch/StorageMeiliSearch.cpp
index e7350d38a20..5d77fc080a4 100644
--- a/src/Storages/MeiliSearch/StorageMeiliSearch.cpp
+++ b/src/Storages/MeiliSearch/StorageMeiliSearch.cpp
@@ -137,7 +137,7 @@ Pipe StorageMeiliSearch::read(
     return Pipe(std::make_shared<MeiliSearchSource>(config, sample_block, max_block_size, route, kv_pairs_params));
 }
 
-SinkToStoragePtr StorageMeiliSearch::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageMeiliSearch::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     LOG_TRACE(log, "Trying update index: {}", config.index);
     return std::make_shared<SinkMeiliSearch>(config, metadata_snapshot->getSampleBlock(), local_context);
diff --git a/src/Storages/MeiliSearch/StorageMeiliSearch.h b/src/Storages/MeiliSearch/StorageMeiliSearch.h
index 41c1db53437..77cd2afb80a 100644
--- a/src/Storages/MeiliSearch/StorageMeiliSearch.h
+++ b/src/Storages/MeiliSearch/StorageMeiliSearch.h
@@ -26,7 +26,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool async_insert) override;
 
     static MeiliSearchConfiguration getConfiguration(ASTs engine_args, ContextPtr context);
 
diff --git a/src/Storages/NATS/StorageNATS.cpp b/src/Storages/NATS/StorageNATS.cpp
index aa4ec77b0d8..a3478069356 100644
--- a/src/Storages/NATS/StorageNATS.cpp
+++ b/src/Storages/NATS/StorageNATS.cpp
@@ -353,7 +353,7 @@ void StorageNATS::read(
 }
 
 
-SinkToStoragePtr StorageNATS::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageNATS::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto modified_context = addSettings(local_context);
     std::string subject = modified_context->getSettingsRef().stream_like_engine_insert_queue.changed
diff --git a/src/Storages/NATS/StorageNATS.h b/src/Storages/NATS/StorageNATS.h
index 518d81fb145..efe54243ee9 100644
--- a/src/Storages/NATS/StorageNATS.h
+++ b/src/Storages/NATS/StorageNATS.h
@@ -51,7 +51,7 @@ public:
         size_t /* max_block_size */,
         size_t /* num_streams */) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override;
 
     /// We want to control the number of rows in a chunk inserted into NATS
     bool prefersLargeBlocks() const override { return false; }
diff --git a/src/Storages/RabbitMQ/StorageRabbitMQ.cpp b/src/Storages/RabbitMQ/StorageRabbitMQ.cpp
index e84f5c963a8..651c63e1b91 100644
--- a/src/Storages/RabbitMQ/StorageRabbitMQ.cpp
+++ b/src/Storages/RabbitMQ/StorageRabbitMQ.cpp
@@ -764,7 +764,7 @@ void StorageRabbitMQ::read(
 }
 
 
-SinkToStoragePtr StorageRabbitMQ::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageRabbitMQ::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto producer = std::make_unique<RabbitMQProducer>(
         configuration, routing_keys, exchange_name, exchange_type, producer_id.fetch_add(1), persistent, shutdown_called, log);
diff --git a/src/Storages/RabbitMQ/StorageRabbitMQ.h b/src/Storages/RabbitMQ/StorageRabbitMQ.h
index c531026d83a..dc410c4f298 100644
--- a/src/Storages/RabbitMQ/StorageRabbitMQ.h
+++ b/src/Storages/RabbitMQ/StorageRabbitMQ.h
@@ -57,7 +57,8 @@ public:
     SinkToStoragePtr write(
         const ASTPtr & query,
         const StorageMetadataPtr & metadata_snapshot,
-        ContextPtr context) override;
+        ContextPtr context,
+        bool async_insert) override;
 
     /// We want to control the number of rows in a chunk inserted into RabbitMQ
     bool prefersLargeBlocks() const override { return false; }
diff --git a/src/Storages/RocksDB/StorageEmbeddedRocksDB.cpp b/src/Storages/RocksDB/StorageEmbeddedRocksDB.cpp
index d1195a9132e..27e8de78b0f 100644
--- a/src/Storages/RocksDB/StorageEmbeddedRocksDB.cpp
+++ b/src/Storages/RocksDB/StorageEmbeddedRocksDB.cpp
@@ -461,7 +461,7 @@ Pipe StorageEmbeddedRocksDB::read(
 }
 
 SinkToStoragePtr StorageEmbeddedRocksDB::write(
-    const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/)
+    const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/, bool /*async_insert*/)
 {
     return std::make_shared<EmbeddedRocksDBSink>(*this, metadata_snapshot);
 }
diff --git a/src/Storages/RocksDB/StorageEmbeddedRocksDB.h b/src/Storages/RocksDB/StorageEmbeddedRocksDB.h
index 32d7740009e..97fd07626a8 100644
--- a/src/Storages/RocksDB/StorageEmbeddedRocksDB.h
+++ b/src/Storages/RocksDB/StorageEmbeddedRocksDB.h
@@ -48,7 +48,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
     void truncate(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr, TableExclusiveLockHolder &) override;
 
     void checkMutationIsPossible(const MutationCommands & commands, const Settings & settings) const override;
diff --git a/src/Storages/StorageBuffer.cpp b/src/Storages/StorageBuffer.cpp
index a4cb15d5711..d021667f771 100644
--- a/src/Storages/StorageBuffer.cpp
+++ b/src/Storages/StorageBuffer.cpp
@@ -656,7 +656,7 @@ private:
 };
 
 
-SinkToStoragePtr StorageBuffer::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/)
+SinkToStoragePtr StorageBuffer::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/, bool /*async_insert*/)
 {
     return std::make_shared<BufferSink>(*this, metadata_snapshot);
 }
diff --git a/src/Storages/StorageBuffer.h b/src/Storages/StorageBuffer.h
index 83d2376216b..8f089a4d580 100644
--- a/src/Storages/StorageBuffer.h
+++ b/src/Storages/StorageBuffer.h
@@ -88,7 +88,7 @@ public:
 
     bool supportsSubcolumns() const override { return true; }
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool /*async_insert*/) override;
 
     void startup() override;
     /// Flush all buffers into the subordinate table and stop background thread.
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index bcf6f68d00d..d86e735f4b4 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -897,7 +897,7 @@ QueryTreeNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
     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);
+    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);
@@ -1132,7 +1132,7 @@ void StorageDistributed::read(
 }
 
 
-SinkToStoragePtr StorageDistributed::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageDistributed::write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto cluster = getCluster();
     const auto & settings = local_context->getSettingsRef();
diff --git a/src/Storages/StorageDistributed.h b/src/Storages/StorageDistributed.h
index 417fb6447bf..f45286341cf 100644
--- a/src/Storages/StorageDistributed.h
+++ b/src/Storages/StorageDistributed.h
@@ -118,7 +118,7 @@ public:
     bool supportsParallelInsert() const override { return true; }
     std::optional<UInt64> totalBytes(const Settings &) const override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool /*async_insert*/) override;
 
     std::optional<QueryPipeline> distributedWrite(const ASTInsertQuery & query, ContextPtr context) override;
 
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 052775aefca..72347789790 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -1049,7 +1049,8 @@ private:
 SinkToStoragePtr StorageFile::write(
     const ASTPtr & query,
     const StorageMetadataPtr & metadata_snapshot,
-    ContextPtr context)
+    ContextPtr context,
+    bool /*async_insert*/)
 {
     if (format_name == "Distributed")
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is not implemented for Distributed format");
diff --git a/src/Storages/StorageFile.h b/src/Storages/StorageFile.h
index 53ce7eeaaf6..9eb0d4b4383 100644
--- a/src/Storages/StorageFile.h
+++ b/src/Storages/StorageFile.h
@@ -50,7 +50,8 @@ public:
     SinkToStoragePtr write(
         const ASTPtr & query,
         const StorageMetadataPtr & /*metadata_snapshot*/,
-        ContextPtr context) override;
+        ContextPtr context,
+        bool async_insert) override;
 
     void truncate(
         const ASTPtr & /*query*/,
diff --git a/src/Storages/StorageJoin.cpp b/src/Storages/StorageJoin.cpp
index 5113320548d..a238e9ef26c 100644
--- a/src/Storages/StorageJoin.cpp
+++ b/src/Storages/StorageJoin.cpp
@@ -89,10 +89,10 @@ RWLockImpl::LockHolder StorageJoin::tryLockForCurrentQueryTimedWithContext(const
     return lock->getLock(type, query_id, acquire_timeout, false);
 }
 
-SinkToStoragePtr StorageJoin::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context)
+SinkToStoragePtr StorageJoin::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool /*async_insert*/)
 {
     std::lock_guard mutate_lock(mutate_mutex);
-    return StorageSetOrJoinBase::write(query, metadata_snapshot, context);
+    return StorageSetOrJoinBase::write(query, metadata_snapshot, context, /*async_insert=*/false);
 }
 
 void StorageJoin::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr context, TableExclusiveLockHolder &)
diff --git a/src/Storages/StorageJoin.h b/src/Storages/StorageJoin.h
index a5e85d8788a..5559b5d1ec8 100644
--- a/src/Storages/StorageJoin.h
+++ b/src/Storages/StorageJoin.h
@@ -59,7 +59,7 @@ public:
     /// (but not during processing whole query, it's safe for joinGet that doesn't involve `used_flags` from HashJoin)
     ColumnWithTypeAndName joinGet(const Block & block, const Block & block_with_columns_to_add, ContextPtr context) const;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override;
 
     Pipe read(
         const Names & column_names,
diff --git a/src/Storages/StorageKeeperMap.cpp b/src/Storages/StorageKeeperMap.cpp
index deebb9e0096..f2b1b907832 100644
--- a/src/Storages/StorageKeeperMap.cpp
+++ b/src/Storages/StorageKeeperMap.cpp
@@ -524,7 +524,7 @@ Pipe StorageKeeperMap::read(
     return process_keys(std::move(filtered_keys));
 }
 
-SinkToStoragePtr StorageKeeperMap::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageKeeperMap::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     checkTable<true>();
     return std::make_shared<StorageKeeperMapSink>(*this, metadata_snapshot->getSampleBlock(), local_context);
diff --git a/src/Storages/StorageKeeperMap.h b/src/Storages/StorageKeeperMap.h
index 552e6b35fe8..ad7b719e972 100644
--- a/src/Storages/StorageKeeperMap.h
+++ b/src/Storages/StorageKeeperMap.h
@@ -42,7 +42,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override;
 
     void truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &) override;
     void drop() override;
diff --git a/src/Storages/StorageLog.cpp b/src/Storages/StorageLog.cpp
index 02dc4843660..ac68de43332 100644
--- a/src/Storages/StorageLog.cpp
+++ b/src/Storages/StorageLog.cpp
@@ -855,7 +855,7 @@ Pipe StorageLog::read(
     return Pipe::unitePipes(std::move(pipes));
 }
 
-SinkToStoragePtr StorageLog::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageLog::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     WriteLock lock{rwlock, getLockTimeout(local_context)};
     if (!lock)
diff --git a/src/Storages/StorageLog.h b/src/Storages/StorageLog.h
index a2b1356f240..f1d05ed39ac 100644
--- a/src/Storages/StorageLog.h
+++ b/src/Storages/StorageLog.h
@@ -55,7 +55,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool async_insert) override;
 
     void rename(const String & new_path_to_table_data, const StorageID & new_table_id) override;
 
diff --git a/src/Storages/StorageMaterializedMySQL.h b/src/Storages/StorageMaterializedMySQL.h
index 9896265b576..08fbb61960f 100644
--- a/src/Storages/StorageMaterializedMySQL.h
+++ b/src/Storages/StorageMaterializedMySQL.h
@@ -32,7 +32,7 @@ public:
         QueryProcessingStage::Enum processed_stage,
         size_t max_block_size, size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr &, const StorageMetadataPtr &, ContextPtr) override { throwNotAllowed(); }
+    SinkToStoragePtr write(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, bool) override { throwNotAllowed(); }
 
     NamesAndTypesList getVirtuals() const override;
     ColumnSizeByName getColumnSizes() const override;
diff --git a/src/Storages/StorageMaterializedView.cpp b/src/Storages/StorageMaterializedView.cpp
index b96c132d601..16d724d54d8 100644
--- a/src/Storages/StorageMaterializedView.cpp
+++ b/src/Storages/StorageMaterializedView.cpp
@@ -192,13 +192,13 @@ void StorageMaterializedView::read(
     }
 }
 
-SinkToStoragePtr StorageMaterializedView::write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr local_context)
+SinkToStoragePtr StorageMaterializedView::write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr local_context, bool async_insert)
 {
     auto storage = getTargetTable();
     auto lock = storage->lockForShare(local_context->getCurrentQueryId(), local_context->getSettingsRef().lock_acquire_timeout);
 
     auto metadata_snapshot = storage->getInMemoryMetadataPtr();
-    auto sink = storage->write(query, metadata_snapshot, local_context);
+    auto sink = storage->write(query, metadata_snapshot, local_context, async_insert);
 
     sink->addTableLock(lock);
     return sink;
diff --git a/src/Storages/StorageMaterializedView.h b/src/Storages/StorageMaterializedView.h
index f7876005c49..3ec789aa7e3 100644
--- a/src/Storages/StorageMaterializedView.h
+++ b/src/Storages/StorageMaterializedView.h
@@ -39,7 +39,7 @@ public:
         return target_table->mayBenefitFromIndexForIn(left_in_operand, query_context, metadata_snapshot);
     }
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     void drop() override;
     void dropInnerTableIfAny(bool sync, ContextPtr local_context) override;
diff --git a/src/Storages/StorageMemory.cpp b/src/Storages/StorageMemory.cpp
index caeefa5d96d..1b45b9ae3f4 100644
--- a/src/Storages/StorageMemory.cpp
+++ b/src/Storages/StorageMemory.cpp
@@ -159,7 +159,7 @@ void StorageMemory::read(
 }
 
 
-SinkToStoragePtr StorageMemory::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr context)
+SinkToStoragePtr StorageMemory::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool /*async_insert*/)
 {
     return std::make_shared<MemorySink>(*this, metadata_snapshot, context);
 }
diff --git a/src/Storages/StorageMemory.h b/src/Storages/StorageMemory.h
index ce8a59b8bcd..c4f4331ca64 100644
--- a/src/Storages/StorageMemory.h
+++ b/src/Storages/StorageMemory.h
@@ -64,7 +64,7 @@ public:
 
     bool hasEvenlyDistributedRead() const override { return true; }
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override;
 
     void drop() override;
 
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index 3da4724471d..a2a46229660 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -274,7 +274,7 @@ std::optional<UInt64> StorageMergeTree::totalBytes(const Settings &) const
 }
 
 SinkToStoragePtr
-StorageMergeTree::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+StorageMergeTree::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     const auto & settings = local_context->getSettingsRef();
     return std::make_shared<MergeTreeSink>(
diff --git a/src/Storages/StorageMergeTree.h b/src/Storages/StorageMergeTree.h
index be9f5426bbd..8099f9c16aa 100644
--- a/src/Storages/StorageMergeTree.h
+++ b/src/Storages/StorageMergeTree.h
@@ -71,7 +71,7 @@ public:
     std::optional<UInt64> totalRowsByPartitionPredicate(const SelectQueryInfo &, ContextPtr) const override;
     std::optional<UInt64> totalBytes(const Settings &) const override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     /** Perform the next step in combining the parts.
       */
diff --git a/src/Storages/StorageMongoDB.cpp b/src/Storages/StorageMongoDB.cpp
index 63b8c2d00a1..ab52fde3e3d 100644
--- a/src/Storages/StorageMongoDB.cpp
+++ b/src/Storages/StorageMongoDB.cpp
@@ -165,7 +165,7 @@ Pipe StorageMongoDB::read(
     return Pipe(std::make_shared<MongoDBSource>(connection, createCursor(database_name, collection_name, sample_block), sample_block, max_block_size));
 }
 
-SinkToStoragePtr StorageMongoDB::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr /* context */)
+SinkToStoragePtr StorageMongoDB::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr /* context */, bool /*async_insert*/)
 {
     connectIfNotConnected();
     return std::make_shared<StorageMongoDBSink>(collection_name, database_name, metadata_snapshot, connection);
diff --git a/src/Storages/StorageMongoDB.h b/src/Storages/StorageMongoDB.h
index 2b77f076e7e..36090d4584e 100644
--- a/src/Storages/StorageMongoDB.h
+++ b/src/Storages/StorageMongoDB.h
@@ -41,7 +41,8 @@ public:
     SinkToStoragePtr write(
         const ASTPtr & query,
         const StorageMetadataPtr & /*metadata_snapshot*/,
-        ContextPtr context) override;
+        ContextPtr context,
+        bool async_insert) override;
 
     struct Configuration
     {
diff --git a/src/Storages/StorageMySQL.cpp b/src/Storages/StorageMySQL.cpp
index 2a96581d591..3e928c3a811 100644
--- a/src/Storages/StorageMySQL.cpp
+++ b/src/Storages/StorageMySQL.cpp
@@ -252,7 +252,7 @@ private:
 };
 
 
-SinkToStoragePtr StorageMySQL::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageMySQL::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     return std::make_shared<StorageMySQLSink>(
         *this,
diff --git a/src/Storages/StorageMySQL.h b/src/Storages/StorageMySQL.h
index 9f47f9925d5..a98afc7ac4d 100644
--- a/src/Storages/StorageMySQL.h
+++ b/src/Storages/StorageMySQL.h
@@ -49,7 +49,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     struct Configuration
     {
diff --git a/src/Storages/StorageNull.h b/src/Storages/StorageNull.h
index d35c6a0b8b5..f6dd7064a22 100644
--- a/src/Storages/StorageNull.h
+++ b/src/Storages/StorageNull.h
@@ -46,7 +46,7 @@ public:
 
     bool supportsParallelInsert() const override { return true; }
 
-    SinkToStoragePtr write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr) override
+    SinkToStoragePtr write(const ASTPtr &, const StorageMetadataPtr & metadata_snapshot, ContextPtr, bool) override
     {
         return std::make_shared<NullSinkToStorage>(metadata_snapshot->getSampleBlock());
     }
diff --git a/src/Storages/StoragePostgreSQL.cpp b/src/Storages/StoragePostgreSQL.cpp
index 5d7dc285c5d..3551ee36819 100644
--- a/src/Storages/StoragePostgreSQL.cpp
+++ b/src/Storages/StoragePostgreSQL.cpp
@@ -451,7 +451,7 @@ private:
 
 
 SinkToStoragePtr StoragePostgreSQL::write(
-        const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /* context */)
+        const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /* context */, bool /*async_insert*/)
 {
     return std::make_shared<PostgreSQLSink>(metadata_snapshot, pool->get(), remote_table_name, remote_table_schema, on_conflict);
 }
diff --git a/src/Storages/StoragePostgreSQL.h b/src/Storages/StoragePostgreSQL.h
index be6bbc5ec63..fb8b5a22df2 100644
--- a/src/Storages/StoragePostgreSQL.h
+++ b/src/Storages/StoragePostgreSQL.h
@@ -46,7 +46,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     struct Configuration
     {
diff --git a/src/Storages/StorageProxy.h b/src/Storages/StorageProxy.h
index e8a664a6382..14b7fc15af2 100644
--- a/src/Storages/StorageProxy.h
+++ b/src/Storages/StorageProxy.h
@@ -68,9 +68,9 @@ public:
         return getNested()->read(query_plan, column_names, storage_snapshot, query_info, context, processed_stage, max_block_size, num_streams);
     }
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context) override
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool async_insert) override
     {
-        return getNested()->write(query, metadata_snapshot, context);
+        return getNested()->write(query, metadata_snapshot, context, async_insert);
     }
 
     void drop() override { getNested()->drop(); }
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index db9c209a5fd..f9c9e958258 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -4822,7 +4822,7 @@ void StorageReplicatedMergeTree::assertNotReadonly() const
 }
 
 
-SinkToStoragePtr StorageReplicatedMergeTree::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageReplicatedMergeTree::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool async_insert)
 {
     if (!initialization_done)
         throw Exception(ErrorCodes::NOT_INITIALIZED, "Table is not initialized yet");
@@ -4839,7 +4839,7 @@ SinkToStoragePtr StorageReplicatedMergeTree::write(const ASTPtr & /*query*/, con
     const auto storage_settings_ptr = getSettings();
     const Settings & query_settings = local_context->getSettingsRef();
     bool deduplicate = storage_settings_ptr->replicated_deduplication_window != 0 && query_settings.insert_deduplicate;
-    bool async_deduplicate = query_settings.async_insert && query_settings.async_insert_deduplicate && storage_settings_ptr->replicated_deduplication_window_for_async_inserts != 0 && query_settings.insert_deduplicate;
+    bool async_deduplicate = async_insert && query_settings.async_insert_deduplicate && storage_settings_ptr->replicated_deduplication_window_for_async_inserts != 0 && query_settings.insert_deduplicate;
     if (async_deduplicate)
         return std::make_shared<ReplicatedMergeTreeSinkWithAsyncDeduplicate>(
             *this, metadata_snapshot, query_settings.insert_quorum.valueOr(0),
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index dd7ea84f76b..c0d9e36a8a7 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -138,7 +138,7 @@ public:
     std::optional<UInt64> totalRowsByPartitionPredicate(const SelectQueryInfo & query_info, ContextPtr context) const override;
     std::optional<UInt64> totalBytes(const Settings & settings) const override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     std::optional<QueryPipeline> distributedWrite(const ASTInsertQuery & /*query*/, ContextPtr /*context*/) override;
 
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index f1a7bcb71a2..c3ed0f1af16 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -1086,7 +1086,7 @@ Pipe StorageS3::read(
     return Pipe::unitePipes(std::move(pipes));
 }
 
-SinkToStoragePtr StorageS3::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageS3::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto query_configuration = updateConfigurationAndGetCopy(local_context);
 
diff --git a/src/Storages/StorageS3.h b/src/Storages/StorageS3.h
index a4c120b99a6..9c2728c785d 100644
--- a/src/Storages/StorageS3.h
+++ b/src/Storages/StorageS3.h
@@ -293,7 +293,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     void truncate(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, TableExclusiveLockHolder &) override;
 
diff --git a/src/Storages/StorageSQLite.cpp b/src/Storages/StorageSQLite.cpp
index bd445217979..d5ae6f2383f 100644
--- a/src/Storages/StorageSQLite.cpp
+++ b/src/Storages/StorageSQLite.cpp
@@ -169,7 +169,7 @@ private:
 };
 
 
-SinkToStoragePtr StorageSQLite::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr)
+SinkToStoragePtr StorageSQLite::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/, bool /*async_insert*/)
 {
     if (!sqlite_db)
         sqlite_db = openSQLiteDB(database_path, getContext(), /* throw_on_error */true);
diff --git a/src/Storages/StorageSQLite.h b/src/Storages/StorageSQLite.h
index 323c29ac8bb..9da040cbd5c 100644
--- a/src/Storages/StorageSQLite.h
+++ b/src/Storages/StorageSQLite.h
@@ -40,7 +40,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     static ColumnsDescription getTableStructureFromData(
         const SQLitePtr & sqlite_db_,
diff --git a/src/Storages/StorageSet.cpp b/src/Storages/StorageSet.cpp
index 00b5dbfc5e3..f90539689e6 100644
--- a/src/Storages/StorageSet.cpp
+++ b/src/Storages/StorageSet.cpp
@@ -106,7 +106,7 @@ void SetOrJoinSink::onFinish()
 }
 
 
-SinkToStoragePtr StorageSetOrJoinBase::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr context)
+SinkToStoragePtr StorageSetOrJoinBase::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool /*async_insert*/)
 {
     UInt64 id = ++increment;
     return std::make_shared<SetOrJoinSink>(
diff --git a/src/Storages/StorageSet.h b/src/Storages/StorageSet.h
index ccd1eb9912b..b310f817eb9 100644
--- a/src/Storages/StorageSet.h
+++ b/src/Storages/StorageSet.h
@@ -24,7 +24,7 @@ class StorageSetOrJoinBase : public IStorage
 public:
     void rename(const String & new_path_to_table_data, const StorageID & new_table_id) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     bool storesDataOnDisk() const override { return true; }
     Strings getDataPaths() const override { return {path}; }
diff --git a/src/Storages/StorageStripeLog.cpp b/src/Storages/StorageStripeLog.cpp
index b2e7c202800..5c704d877d1 100644
--- a/src/Storages/StorageStripeLog.cpp
+++ b/src/Storages/StorageStripeLog.cpp
@@ -394,7 +394,7 @@ Pipe StorageStripeLog::read(
 }
 
 
-SinkToStoragePtr StorageStripeLog::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageStripeLog::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     WriteLock lock{rwlock, getLockTimeout(local_context)};
     if (!lock)
diff --git a/src/Storages/StorageStripeLog.h b/src/Storages/StorageStripeLog.h
index 3f1b4ed0ad5..f889a1de71b 100644
--- a/src/Storages/StorageStripeLog.h
+++ b/src/Storages/StorageStripeLog.h
@@ -49,7 +49,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool async_insert) override;
 
     void rename(const String & new_path_to_table_data, const StorageID & new_table_id) override;
 
diff --git a/src/Storages/StorageTableFunction.h b/src/Storages/StorageTableFunction.h
index ccec087a8d9..26cbe1f0233 100644
--- a/src/Storages/StorageTableFunction.h
+++ b/src/Storages/StorageTableFunction.h
@@ -130,7 +130,8 @@ public:
     SinkToStoragePtr write(
             const ASTPtr & query,
             const StorageMetadataPtr & metadata_snapshot,
-            ContextPtr context) override
+            ContextPtr context,
+            bool async_insert) override
     {
         auto storage = getNested();
         auto cached_structure = metadata_snapshot->getSampleBlock();
@@ -139,7 +140,7 @@ public:
         {
             throw Exception(ErrorCodes::INCOMPATIBLE_COLUMNS, "Source storage and table function have different structure");
         }
-        return storage->write(query, metadata_snapshot, context);
+        return storage->write(query, metadata_snapshot, context, async_insert);
     }
 
     void renameInMemory(const StorageID & new_table_id) override
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index efc44a069dd..520576d3961 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -803,7 +803,7 @@ Pipe StorageURLWithFailover::read(
 }
 
 
-SinkToStoragePtr IStorageURLBase::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context)
+SinkToStoragePtr IStorageURLBase::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool /*async_insert*/)
 {
     if (http_method.empty())
         http_method = Poco::Net::HTTPRequest::HTTP_POST;
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index 316b142aec0..e80e19621e8 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -41,7 +41,7 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     bool supportsPartitionBy() const override { return true; }
 
diff --git a/src/Storages/StorageXDBC.cpp b/src/Storages/StorageXDBC.cpp
index 9b3e203e337..b532d1c91f0 100644
--- a/src/Storages/StorageXDBC.cpp
+++ b/src/Storages/StorageXDBC.cpp
@@ -116,7 +116,7 @@ Pipe StorageXDBC::read(
     return IStorageURLBase::read(column_names, storage_snapshot, query_info, local_context, processed_stage, max_block_size, num_streams);
 }
 
-SinkToStoragePtr StorageXDBC::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageXDBC::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     bridge_helper->startBridgeSync();
 
diff --git a/src/Storages/StorageXDBC.h b/src/Storages/StorageXDBC.h
index aa313e024ca..d7a1138c710 100644
--- a/src/Storages/StorageXDBC.h
+++ b/src/Storages/StorageXDBC.h
@@ -38,7 +38,7 @@ public:
         ContextPtr context_,
         BridgeHelperPtr bridge_helper_);
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr context, bool async_insert) override;
 
     std::string getName() const override;
 private:
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 6ca74406b17..cef2feedcc5 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -215,7 +215,7 @@ void StorageSystemZooKeeper::read(
     query_plan.addStep(std::move(read_step));
 }
 
-SinkToStoragePtr StorageSystemZooKeeper::write(const ASTPtr &, const StorageMetadataPtr &, ContextPtr context)
+SinkToStoragePtr StorageSystemZooKeeper::write(const ASTPtr &, const StorageMetadataPtr &, ContextPtr context, bool /*async_insert*/)
 {
     if (!context->getConfigRef().getBool("allow_zookeeper_write", false))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Prohibit writing to system.zookeeper, unless config `allow_zookeeper_write` as true");
diff --git a/src/Storages/System/StorageSystemZooKeeper.h b/src/Storages/System/StorageSystemZooKeeper.h
index c8988d787a0..a016d3ad74c 100644
--- a/src/Storages/System/StorageSystemZooKeeper.h
+++ b/src/Storages/System/StorageSystemZooKeeper.h
@@ -20,7 +20,7 @@ public:
 
     static NamesAndTypesList getNamesAndTypes();
 
-    SinkToStoragePtr write(const ASTPtr & /*query*/, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr /*context*/) override;
+    SinkToStoragePtr write(const ASTPtr & /*query*/, const StorageMetadataPtr & /*metadata_snapshot*/, ContextPtr /*context*/, bool /*async_insert*/) override;
 
     void read(
         QueryPlan & query_plan,
diff --git a/src/Storages/WindowView/StorageWindowView.cpp b/src/Storages/WindowView/StorageWindowView.cpp
index 94d5db170a8..7fca9b5f078 100644
--- a/src/Storages/WindowView/StorageWindowView.cpp
+++ b/src/Storages/WindowView/StorageWindowView.cpp
@@ -1549,7 +1549,7 @@ void StorageWindowView::writeIntoWindowView(
     auto lock = inner_table->lockForShare(
         local_context->getCurrentQueryId(), local_context->getSettingsRef().lock_acquire_timeout);
     auto metadata_snapshot = inner_table->getInMemoryMetadataPtr();
-    auto output = inner_table->write(window_view.getMergeableQuery(), metadata_snapshot, local_context);
+    auto output = inner_table->write(window_view.getMergeableQuery(), metadata_snapshot, local_context, /*async_insert=*/false);
     output->addTableLock(lock);
 
     if (!blocksHaveEqualStructure(builder.getHeader(), output->getHeader()))
diff --git a/src/Storages/tests/gtest_storage_log.cpp b/src/Storages/tests/gtest_storage_log.cpp
index b63de6a66ef..352c44554bd 100644
--- a/src/Storages/tests/gtest_storage_log.cpp
+++ b/src/Storages/tests/gtest_storage_log.cpp
@@ -95,7 +95,7 @@ std::string writeData(int rows, DB::StoragePtr & table, const DB::ContextPtr con
         block.insert(column);
     }
 
-    QueryPipeline pipeline(table->write({}, metadata_snapshot, context));
+    QueryPipeline pipeline(table->write({}, metadata_snapshot, context, /*async_insert=*/false));
 
     PushingPipelineExecutor executor(pipeline);
     executor.push(block);
diff --git a/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.reference b/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.reference
new file mode 100644
index 00000000000..014be4ce1a9
--- /dev/null
+++ b/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.reference
@@ -0,0 +1,17 @@
+0
+1
+1
+1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
diff --git a/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.sh b/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.sh
new file mode 100755
index 00000000000..40e7c9feabf
--- /dev/null
+++ b/tests/queries/0_stateless/02784_disable_async_with_dedup_correctly.sh
@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT -q "DROP TABLE IF EXISTS 02784_async_table_with_dedup"
+
+$CLICKHOUSE_CLIENT -q "CREATE TABLE 02784_async_table_with_dedup (a Int64) ENGINE = ReplicatedMergeTree('/clickhouse/tables/{database}/02784_async_table_with_dedup', 'r1') ORDER BY a"
+
+CLICKHOUSE_CLIENT_WITH_LOG=$(echo ${CLICKHOUSE_CLIENT} | sed 's/'"--send_logs_level=${CLICKHOUSE_CLIENT_SERVER_LOGS_LEVEL}"'/--send_logs_level=trace/g')
+
+function insert_with_log_check() {
+    $CLICKHOUSE_CLIENT_WITH_LOG --async-insert=1 --async_insert_deduplicate=1 --wait_for_async_insert=1 -q "$1" 2>&1 | grep -Fc "Setting async_insert=1, but INSERT query will be executed synchronously"
+}
+
+insert_with_log_check "INSERT INTO 02784_async_table_with_dedup VALUES (1), (2)"
+insert_with_log_check "INSERT INTO 02784_async_table_with_dedup SELECT number as a FROM system.numbers LIMIT 10 OFFSET 3"
+
+DATA_FILE=test_02784_async_$CLICKHOUSE_TEST_UNIQUE_NAME.csv
+echo -e '13\n14' > $DATA_FILE
+
+insert_with_log_check "INSERT INTO 02784_async_table_with_dedup FROM INFILE '$DATA_FILE' FORMAT CSV"
+
+$CLICKHOUSE_CLIENT -q "SELECT a FROM 02784_async_table_with_dedup ORDER BY a"
+
+$CLICKHOUSE_CLIENT -q "DROP TABLE 02784_async_table_with_dedup"
+
+rm $DATA_FILE
\ No newline at end of file

From 129473ae744b7d8516e35ada5293e4b54be6f094 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 7 Jun 2023 20:48:03 +0200
Subject: [PATCH 0598/1478] Fix

---
 .../IO/CachedOnDiskWriteBufferFromFile.cpp    | 30 ++++++++++---------
 .../IO/CachedOnDiskWriteBufferFromFile.h      |  4 +--
 src/Interpreters/Cache/FileSegment.h          |  6 ----
 3 files changed, 18 insertions(+), 22 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
index 9153af90312..b7727555480 100644
--- a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
@@ -52,18 +52,20 @@ bool FileSegmentRangeWriter::write(const char * data, size_t size, size_t offset
 
     FileSegment * file_segment;
 
-    if (file_segments.empty() || file_segments.back().isDownloaded())
+    if (!file_segments || file_segments->empty() || file_segments->front().isDownloaded())
     {
         file_segment = &allocateFileSegment(expected_write_offset, segment_kind);
     }
     else
     {
-        file_segment = &file_segments.back();
+        file_segment = &file_segments->front();
     }
 
     SCOPE_EXIT({
-        if (file_segments.back().isDownloader())
-            file_segments.back().completePartAndResetDownloader();
+        if (!file_segments || file_segments->empty())
+            return;
+        if (file_segments->front().isDownloader())
+            file_segments->front().completePartAndResetDownloader();
     });
 
     while (size > 0)
@@ -71,7 +73,7 @@ bool FileSegmentRangeWriter::write(const char * data, size_t size, size_t offset
         size_t available_size = file_segment->range().size() - file_segment->getDownloadedSize(false);
         if (available_size == 0)
         {
-            completeFileSegment(*file_segment);
+            completeFileSegment();
             file_segment = &allocateFileSegment(expected_write_offset, segment_kind);
             continue;
         }
@@ -114,10 +116,7 @@ void FileSegmentRangeWriter::finalize()
     if (finalized)
         return;
 
-    if (file_segments.empty())
-        return;
-
-    completeFileSegment(file_segments.back());
+    completeFileSegment();
     finalized = true;
 }
 
@@ -145,10 +144,9 @@ FileSegment & FileSegmentRangeWriter::allocateFileSegment(size_t offset, FileSeg
 
     /// We set max_file_segment_size to be downloaded,
     /// if we have less size to write, file segment will be resized in complete() method.
-    auto holder = cache->set(key, offset, cache->getMaxFileSegmentSize(), create_settings);
-    chassert(holder->size() == 1);
-    holder->moveTo(file_segments);
-    return file_segments.back();
+    file_segments = cache->set(key, offset, cache->getMaxFileSegmentSize(), create_settings);
+    chassert(file_segments->size() == 1);
+    return file_segments->front();
 }
 
 void FileSegmentRangeWriter::appendFilesystemCacheLog(const FileSegment & file_segment)
@@ -176,8 +174,12 @@ void FileSegmentRangeWriter::appendFilesystemCacheLog(const FileSegment & file_s
     cache_log->add(elem);
 }
 
-void FileSegmentRangeWriter::completeFileSegment(FileSegment & file_segment)
+void FileSegmentRangeWriter::completeFileSegment()
 {
+    if (!file_segments || file_segments->empty())
+        return;
+
+    auto & file_segment = file_segments->front();
     /// File segment can be detached if space reservation failed.
     if (file_segment.isDetached() || file_segment.isCompleted())
         return;
diff --git a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
index 194afe88d88..8642886d6de 100644
--- a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
+++ b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
@@ -43,7 +43,7 @@ private:
 
     void appendFilesystemCacheLog(const FileSegment & file_segment);
 
-    void completeFileSegment(FileSegment & file_segment);
+    void completeFileSegment();
 
     FileCache * cache;
     FileSegment::Key key;
@@ -53,7 +53,7 @@ private:
     String query_id;
     String source_path;
 
-    FileSegmentsHolder file_segments{};
+    FileSegmentsHolderPtr file_segments;
 
     size_t expected_write_offset = 0;
 
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 163a15fcfda..186c65f12d9 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -360,12 +360,6 @@ struct FileSegmentsHolder : private boost::noncopyable
     FileSegments::const_iterator begin() const { return file_segments.begin(); }
     FileSegments::const_iterator end() const { return file_segments.end(); }
 
-    void moveTo(FileSegmentsHolder & holder)
-    {
-        holder.file_segments.insert(holder.file_segments.end(), file_segments.begin(), file_segments.end());
-        file_segments.clear();
-    }
-
 private:
     FileSegments file_segments{};
     const bool complete_on_dtor = true;

From c2fc0713f2882e3ac09cc1f1c290180a29de180f Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 7 Jun 2023 21:08:48 +0200
Subject: [PATCH 0599/1478] Update FileCache_fwd.h

---
 src/Interpreters/Cache/FileCache_fwd.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/FileCache_fwd.h b/src/Interpreters/Cache/FileCache_fwd.h
index dbb85fa0e7a..01f518d0c4e 100644
--- a/src/Interpreters/Cache/FileCache_fwd.h
+++ b/src/Interpreters/Cache/FileCache_fwd.h
@@ -5,7 +5,7 @@ namespace DB
 {
 
 static constexpr int FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE = 8 * 1024 * 1024;
-static constexpr int FILECACHE_DEFAULT_MAX_ELEMENTS = 1024 * 1024;
+static constexpr int FILECACHE_DEFAULT_MAX_ELEMENTS = 10000000;
 static constexpr int FILECACHE_DEFAULT_HITS_THRESHOLD = 0;
 static constexpr size_t FILECACHE_BYPASS_THRESHOLD = 256 * 1024 * 1024;
 static constexpr size_t FILECACHE_DELAYED_CLEANUP_INTERVAL_MS = 1000 * 60; /// 1 min

From 1e4bcd0d5d6ed04a02ad27ebb89ebd46f8b46e4c Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 7 Jun 2023 21:44:57 +0200
Subject: [PATCH 0600/1478] Test to repro asan issue

---
 ...conditions_to_prewhere_analyzer_asan.reference |  4 ++++
 ...e_all_conditions_to_prewhere_analyzer_asan.sql | 15 +++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.reference
 create mode 100644 tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.sql

diff --git a/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.reference b/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.reference
new file mode 100644
index 00000000000..a08e8a1d440
--- /dev/null
+++ b/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.reference
@@ -0,0 +1,4 @@
+0	0
+0	0
+0	0
+0	0
diff --git a/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.sql b/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.sql
new file mode 100644
index 00000000000..44b9ce4fdc1
--- /dev/null
+++ b/tests/queries/0_stateless/02784_move_all_conditions_to_prewhere_analyzer_asan.sql
@@ -0,0 +1,15 @@
+DROP TABLE IF EXISTS t_02784;
+
+CREATE TABLE t_02784 (c1 UInt64, c2 UInt64) ENGINE=MergeTree() ORDER BY c1 SETTINGS min_bytes_for_wide_part=1;
+
+INSERT INTO t_02784 SELECT number, number FROM numbers(1);
+
+SET allow_experimental_analyzer=1;
+SET move_all_conditions_to_prewhere=1;
+
+SELECT c1, c2 FROM t_02784 WHERE c1 = 0 AND c2 = 0;
+SELECT c1, c2 FROM t_02784 WHERE c2 = 0 AND c1 = 0;
+SELECT c2, c1 FROM t_02784 WHERE c1 = 0 AND c2 = 0;
+SELECT c2, c1 FROM t_02784 WHERE c2 = 0 AND c1 = 0;
+
+DROP TABLE t_02784;

From 03b031eb401cbb46a5c25c0d66b9a8fae169b447 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 7 Jun 2023 21:48:54 +0200
Subject: [PATCH 0601/1478] Fix for using frame reference after stack was
 updated by previous optimizaton

---
 .../QueryPlan/Optimizations/optimizeTree.cpp  | 45 ++++++++++---------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
index dd17c1b5a30..091eecf99e5 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
@@ -114,32 +114,35 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
 
     while (!stack.empty())
     {
-        auto & frame = stack.back();
-
-        if (frame.next_child == 0)
         {
-            has_reading_from_mt |= typeid_cast<const ReadFromMergeTree *>(frame.node->step.get()) != nullptr;
+            /// NOTE: frame cannot be safely used after adding new elements to stack
+            auto & frame = stack.back();
 
-            if (optimization_settings.read_in_order)
-                optimizeReadInOrder(*frame.node, nodes);
+            if (frame.next_child == 0)
+            {
+                has_reading_from_mt |= typeid_cast<const ReadFromMergeTree *>(frame.node->step.get()) != nullptr;
 
-            if (optimization_settings.optimize_projection)
-                num_applied_projection += optimizeUseAggregateProjections(*frame.node, nodes);
+                if (optimization_settings.read_in_order)
+                    optimizeReadInOrder(*frame.node, nodes);
 
-            if (optimization_settings.aggregation_in_order)
-                optimizeAggregationInOrder(*frame.node, nodes);
+                if (optimization_settings.optimize_projection)
+                    num_applied_projection += optimizeUseAggregateProjections(*frame.node, nodes);
 
-            if (optimization_settings.distinct_in_order)
-                tryDistinctReadInOrder(frame.node);
-        }
+                if (optimization_settings.aggregation_in_order)
+                    optimizeAggregationInOrder(*frame.node, nodes);
 
-        /// Traverse all children first.
-        if (frame.next_child < frame.node->children.size())
-        {
-            auto next_frame = Frame{.node = frame.node->children[frame.next_child]};
-            ++frame.next_child;
-            stack.push_back(next_frame);
-            continue;
+                if (optimization_settings.distinct_in_order)
+                    tryDistinctReadInOrder(frame.node);
+            }
+
+            /// Traverse all children first.
+            if (frame.next_child < frame.node->children.size())
+            {
+                auto next_frame = Frame{.node = frame.node->children[frame.next_child]};
+                ++frame.next_child;
+                stack.push_back(next_frame);
+                continue;
+            }
         }
 
         if (optimization_settings.optimize_projection)
@@ -162,7 +165,7 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
 
         optimizePrewhere(stack, nodes);
         optimizePrimaryKeyCondition(stack);
-        enableMemoryBoundMerging(*frame.node, nodes);
+        enableMemoryBoundMerging(*stack.back().node, nodes);
 
         stack.pop_back();
     }

From 92c87dedad043a17a1612f24b9fb43f175214b3f Mon Sep 17 00:00:00 2001
From: flynn <fenglv15@mails.ucas.ac.cn>
Date: Thu, 8 Jun 2023 06:41:32 +0800
Subject: [PATCH 0602/1478] Add parallel state merge for some other combinator
 except If (#50413)

* Add parallel state merge for some other combinator except If

* add test

* update test
---
 src/AggregateFunctions/AggregateFunctionArray.h | 7 +++++++
 src/AggregateFunctions/AggregateFunctionMerge.h | 7 +++++++
 src/AggregateFunctions/AggregateFunctionNull.h  | 7 +++++++
 src/AggregateFunctions/AggregateFunctionState.h | 7 +++++++
 tests/performance/uniqExactIf.xml               | 6 +++++-
 5 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/src/AggregateFunctions/AggregateFunctionArray.h b/src/AggregateFunctions/AggregateFunctionArray.h
index 21394e3ce05..7f38453f86b 100644
--- a/src/AggregateFunctions/AggregateFunctionArray.h
+++ b/src/AggregateFunctions/AggregateFunctionArray.h
@@ -141,6 +141,13 @@ public:
         nested_func->merge(place, rhs, arena);
     }
 
+    bool isAbleToParallelizeMerge() const override { return nested_func->isAbleToParallelizeMerge(); }
+
+    void merge(AggregateDataPtr __restrict place, ConstAggregateDataPtr rhs, ThreadPool & thread_pool, Arena * arena) const override
+    {
+        nested_func->merge(place, rhs, thread_pool, arena);
+    }
+
     void serialize(ConstAggregateDataPtr __restrict place, WriteBuffer & buf, std::optional<size_t> version) const override
     {
         nested_func->serialize(place, buf, version);
diff --git a/src/AggregateFunctions/AggregateFunctionMerge.h b/src/AggregateFunctions/AggregateFunctionMerge.h
index 0cb44259816..5b9e8e606af 100644
--- a/src/AggregateFunctions/AggregateFunctionMerge.h
+++ b/src/AggregateFunctions/AggregateFunctionMerge.h
@@ -110,6 +110,13 @@ public:
         nested_func->merge(place, rhs, arena);
     }
 
+    bool isAbleToParallelizeMerge() const override { return nested_func->isAbleToParallelizeMerge(); }
+
+    void merge(AggregateDataPtr __restrict place, ConstAggregateDataPtr rhs, ThreadPool & thread_pool, Arena * arena) const override
+    {
+        nested_func->merge(place, rhs, thread_pool, arena);
+    }
+
     void serialize(ConstAggregateDataPtr __restrict place, WriteBuffer & buf, std::optional<size_t> version) const override
     {
         nested_func->serialize(place, buf, version);
diff --git a/src/AggregateFunctions/AggregateFunctionNull.h b/src/AggregateFunctions/AggregateFunctionNull.h
index b817bad82fa..de7b190c949 100644
--- a/src/AggregateFunctions/AggregateFunctionNull.h
+++ b/src/AggregateFunctions/AggregateFunctionNull.h
@@ -148,6 +148,13 @@ public:
         nested_function->merge(nestedPlace(place), nestedPlace(rhs), arena);
     }
 
+    bool isAbleToParallelizeMerge() const override { return nested_function->isAbleToParallelizeMerge(); }
+
+    void merge(AggregateDataPtr __restrict place, ConstAggregateDataPtr rhs, ThreadPool & thread_pool, Arena * arena) const override
+    {
+        nested_function->merge(nestedPlace(place), nestedPlace(rhs), thread_pool, arena);
+    }
+
     void serialize(ConstAggregateDataPtr __restrict place, WriteBuffer & buf, std::optional<size_t> version) const override
     {
         bool flag = getFlag(place);
diff --git a/src/AggregateFunctions/AggregateFunctionState.h b/src/AggregateFunctions/AggregateFunctionState.h
index 625fe1f36bc..8335d21cb1e 100644
--- a/src/AggregateFunctions/AggregateFunctionState.h
+++ b/src/AggregateFunctions/AggregateFunctionState.h
@@ -91,6 +91,13 @@ public:
         nested_func->merge(place, rhs, arena);
     }
 
+    bool isAbleToParallelizeMerge() const override { return nested_func->isAbleToParallelizeMerge(); }
+
+    void merge(AggregateDataPtr __restrict place, ConstAggregateDataPtr rhs, ThreadPool & thread_pool, Arena * arena) const override
+    {
+        nested_func->merge(place, rhs, thread_pool, arena);
+    }
+
     void serialize(ConstAggregateDataPtr __restrict place, WriteBuffer & buf, std::optional<size_t> version) const override
     {
         nested_func->serialize(place, buf, version);
diff --git a/tests/performance/uniqExactIf.xml b/tests/performance/uniqExactIf.xml
index 409be257737..263fa75382c 100644
--- a/tests/performance/uniqExactIf.xml
+++ b/tests/performance/uniqExactIf.xml
@@ -1,3 +1,7 @@
 <test>
-    <query>SELECT uniqExactIf(number, 1) FROM numbers_mt(1e6)</query>
+    <query>SELECT uniqExactIf(number, 1) FROM numbers_mt(1e7)</query>
+    <query>SELECT uniqExactState(number) FROM numbers_mt(1e7) Format Null</query>
+    <query>SELECT uniqExactArray([number]) FROM numbers_mt(1e7) Format Null</query>
+    <query>with (SELECT uniqExactState(number) FROM numbers_mt(1e7)) as a select uniqExactMerge(a)</query>
+    <query>SELECT uniqExactOrNull(number) FROM numbers_mt(1e7)</query>
 </test>

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 0603/1478] 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 0604/1478] 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 286f3b247b33b08b17bd76320604d9b2b1c282b4 Mon Sep 17 00:00:00 2001
From: Derek Chia <derek.chia@clickhouse.com>
Date: Thu, 8 Jun 2023 11:28:44 +0800
Subject: [PATCH 0605/1478] 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 8e2cd8d6027..3968751d5ee 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3155,7 +3155,7 @@ Possible values:
 - Positive integer.
 - 0 or 1 — Disabled. `SELECT` queries are executed in a single thread.
 
-Default value: the number of physical CPU cores.
+Default value: `max_threads`.
 
 ## opentelemetry_start_trace_probability {#opentelemetry-start-trace-probability}
 

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 0606/1478] 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 0607/1478] 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 2297995c1a46240145df4b04ba7fff727944f5e7 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 8 Jun 2023 07:15:11 +0000
Subject: [PATCH 0608/1478] Disable grace_hash join in stress tests

Until https://github.com/ClickHouse/ClickHouse/issues/50220 is fixed
---
 tests/ci/stress.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/tests/ci/stress.py b/tests/ci/stress.py
index b9044874071..e370ddbdd21 100755
--- a/tests/ci/stress.py
+++ b/tests/ci/stress.py
@@ -37,9 +37,6 @@ def get_options(i, upgrade_check):
             client_options.append("join_algorithm='partial_merge'")
         if join_alg_num % 5 == 2:
             client_options.append("join_algorithm='full_sorting_merge'")
-        if join_alg_num % 5 == 3 and not upgrade_check:
-            # Some crashes are not fixed in 23.2 yet, so ignore the setting in Upgrade check
-            client_options.append("join_algorithm='grace_hash'")
         if join_alg_num % 5 == 4:
             client_options.append("join_algorithm='auto'")
             client_options.append("max_rows_in_join=1000")

From b878ddb35fce2247d657e3d2c2156023b4c67bdd Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 8 Jun 2023 11:02:09 +0200
Subject: [PATCH 0609/1478] Fix test

---
 tests/queries/0_stateless/02344_describe_cache.reference | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02344_describe_cache.reference b/tests/queries/0_stateless/02344_describe_cache.reference
index a803ca1fab1..d8a2ffab1fa 100644
--- a/tests/queries/0_stateless/02344_describe_cache.reference
+++ b/tests/queries/0_stateless/02344_describe_cache.reference
@@ -1,2 +1,2 @@
-134217728	1048576	8388608	1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0
-134217728	1048576	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/	0
+134217728	10000000	104857600	0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0

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 0610/1478] 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 15b6651df6f10e7f623ec74dd3aaa42b82df90a5 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 8 Jun 2023 09:40:11 +0000
Subject: [PATCH 0611/1478] Revert "Merge pull request #49816 from
 bigo-sg/grace_hash_reserve_hash_table"

This reverts commit 3f892ceb12b868b1b9deb0607a7df2dde5f1a139, reversing
changes made to 32ffa2ae0b781af5c7ae3e5cbf975d3e9b74d86f.
---
 src/Interpreters/GraceHashJoin.cpp | 17 +++++------------
 src/Interpreters/GraceHashJoin.h   |  3 +--
 src/Interpreters/HashJoin.cpp      |  8 +++-----
 src/Interpreters/HashJoin.h        | 30 ++----------------------------
 4 files changed, 11 insertions(+), 47 deletions(-)

diff --git a/src/Interpreters/GraceHashJoin.cpp b/src/Interpreters/GraceHashJoin.cpp
index f54ee9d85c7..4a4c69ff473 100644
--- a/src/Interpreters/GraceHashJoin.cpp
+++ b/src/Interpreters/GraceHashJoin.cpp
@@ -571,13 +571,7 @@ IBlocksStreamPtr GraceHashJoin::getDelayedBlocks()
 
     size_t bucket_idx = current_bucket->idx;
 
-    size_t prev_keys_num = 0;
-    // If there is only one bucket, don't take this check.
-    if (hash_join && buckets.size() > 1)
-    {
-        // Use previous hash_join's keys number to estimate next hash_join's size is reasonable.
-        prev_keys_num = hash_join->getTotalRowCount();
-    }
+    hash_join = makeInMemoryJoin();
 
     for (bucket_idx = bucket_idx + 1; bucket_idx < buckets.size(); ++bucket_idx)
     {
@@ -591,7 +585,6 @@ IBlocksStreamPtr GraceHashJoin::getDelayedBlocks()
             continue;
         }
 
-        hash_join = makeInMemoryJoin(prev_keys_num);
         auto right_reader = current_bucket->startJoining();
         size_t num_rows = 0; /// count rows that were written and rehashed
         while (Block block = right_reader.read())
@@ -611,9 +604,9 @@ IBlocksStreamPtr GraceHashJoin::getDelayedBlocks()
     return nullptr;
 }
 
-GraceHashJoin::InMemoryJoinPtr GraceHashJoin::makeInMemoryJoin(size_t reserve_num)
+GraceHashJoin::InMemoryJoinPtr GraceHashJoin::makeInMemoryJoin()
 {
-    return std::make_unique<InMemoryJoin>(table_join, right_sample_block, any_take_last_row, reserve_num);
+    return std::make_unique<InMemoryJoin>(table_join, right_sample_block, any_take_last_row);
 }
 
 Block GraceHashJoin::prepareRightBlock(const Block & block)
@@ -653,7 +646,6 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
             if (!current_block.rows())
                 return;
         }
-        auto prev_keys_num = hash_join->getTotalRowCount();
         hash_join->addJoinedBlock(current_block, /* check_limits = */ false);
 
         if (!hasMemoryOverflow(hash_join))
@@ -662,6 +654,7 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
         current_block = {};
 
         auto right_blocks = hash_join->releaseJoinedBlocks(/* restructure */ false);
+        hash_join = nullptr;
 
         buckets_snapshot = rehashBuckets(buckets_snapshot.size() * 2);
 
@@ -681,7 +674,7 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
                 current_block = concatenateBlocks(current_blocks);
         }
 
-        hash_join = makeInMemoryJoin(prev_keys_num);
+        hash_join = makeInMemoryJoin();
 
         if (current_block.rows() > 0)
             hash_join->addJoinedBlock(current_block, /* check_limits = */ false);
diff --git a/src/Interpreters/GraceHashJoin.h b/src/Interpreters/GraceHashJoin.h
index ec611f373ed..eb39ee09208 100644
--- a/src/Interpreters/GraceHashJoin.h
+++ b/src/Interpreters/GraceHashJoin.h
@@ -90,8 +90,7 @@ public:
 private:
     void initBuckets();
     /// Create empty join for in-memory processing.
-    /// reserve_num for reserving space in hash table.
-    InMemoryJoinPtr makeInMemoryJoin(size_t reserve_num = 0);
+    InMemoryJoinPtr makeInMemoryJoin();
 
     /// Add right table block to the @join. Calls @rehash on overflow.
     void addJoinedBlockImpl(Block block);
diff --git a/src/Interpreters/HashJoin.cpp b/src/Interpreters/HashJoin.cpp
index 146b57049a6..0af33a8bd20 100644
--- a/src/Interpreters/HashJoin.cpp
+++ b/src/Interpreters/HashJoin.cpp
@@ -217,7 +217,7 @@ static void correctNullabilityInplace(ColumnWithTypeAndName & column, bool nulla
         JoinCommon::removeColumnNullability(column);
 }
 
-HashJoin::HashJoin(std::shared_ptr<TableJoin> table_join_, const Block & right_sample_block_, bool any_take_last_row_, size_t reserve_num)
+HashJoin::HashJoin(std::shared_ptr<TableJoin> table_join_, const Block & right_sample_block_, bool any_take_last_row_)
     : table_join(table_join_)
     , kind(table_join->kind())
     , strictness(table_join->strictness())
@@ -302,7 +302,7 @@ HashJoin::HashJoin(std::shared_ptr<TableJoin> table_join_, const Block & right_s
     }
 
     for (auto & maps : data->maps)
-        dataMapInit(maps, reserve_num);
+        dataMapInit(maps);
 }
 
 HashJoin::Type HashJoin::chooseMethod(JoinKind kind, const ColumnRawPtrs & key_columns, Sizes & key_sizes)
@@ -454,15 +454,13 @@ struct KeyGetterForType
     using Type = typename KeyGetterForTypeImpl<type, Value, Mapped>::Type;
 };
 
-void HashJoin::dataMapInit(MapsVariant & map, size_t reserve_num)
+void HashJoin::dataMapInit(MapsVariant & map)
 {
 
     if (kind == JoinKind::Cross)
         return;
     joinDispatchInit(kind, strictness, map);
     joinDispatch(kind, strictness, map, [&](auto, auto, auto & map_) { map_.create(data->type); });
-    if (reserve_num)
-        joinDispatch(kind, strictness, map, [&](auto, auto, auto & map_) { map_.reserve(data->type, reserve_num); });
 }
 
 bool HashJoin::empty() const
diff --git a/src/Interpreters/HashJoin.h b/src/Interpreters/HashJoin.h
index 58e47432d41..50eda4482bd 100644
--- a/src/Interpreters/HashJoin.h
+++ b/src/Interpreters/HashJoin.h
@@ -146,7 +146,7 @@ public:
 class HashJoin : public IJoin
 {
 public:
-    HashJoin(std::shared_ptr<TableJoin> table_join_, const Block & right_sample_block, bool any_take_last_row_ = false, size_t reserve_num = 0);
+    HashJoin(std::shared_ptr<TableJoin> table_join_, const Block & right_sample_block, bool any_take_last_row_ = false);
 
     ~HashJoin() override;
 
@@ -217,16 +217,6 @@ public:
         M(keys256)                     \
         M(hashed)
 
-    /// Only for maps using hash table.
-    #define APPLY_FOR_HASH_JOIN_VARIANTS(M) \
-        M(key32)                            \
-        M(key64)                            \
-        M(key_string)                       \
-        M(key_fixed_string)                 \
-        M(keys128)                          \
-        M(keys256)                          \
-        M(hashed)
-
 
     /// Used for reading from StorageJoin and applying joinGet function
     #define APPLY_FOR_JOIN_VARIANTS_LIMITED(M) \
@@ -276,22 +266,6 @@ public:
             }
         }
 
-        void reserve(Type which, size_t num)
-        {
-            switch (which)
-            {
-                case Type::EMPTY:            break;
-                case Type::CROSS:            break;
-                case Type::key8:             break;
-                case Type::key16:            break;
-
-            #define M(NAME) \
-                case Type::NAME: NAME->reserve(num); break;
-                APPLY_FOR_HASH_JOIN_VARIANTS(M)
-            #undef M
-            }
-        }
-
         size_t getTotalRowCount(Type which) const
         {
             switch (which)
@@ -435,7 +409,7 @@ private:
     /// If set HashJoin instance is not available for modification (addJoinedBlock)
     TableLockHolder storage_join_lock = nullptr;
 
-    void dataMapInit(MapsVariant &, size_t);
+    void dataMapInit(MapsVariant &);
 
     void initRightBlockStructure(Block & saved_block_sample);
 

From f0a1c8afa208cbc0ec7a0b056a7d2036d62e10e0 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 8 Jun 2023 09:40:41 +0000
Subject: [PATCH 0612/1478] Revert "Merge pull request #49483 from
 bigo-sg/grace_hash_full_join"

This reverts commit fa93c388b1d17f3561c63e9265c8aefde1b2d5d0, reversing
changes made to a2c0a65344f4197c6c2849f800423309fd4b22b4.
---
 docs/en/operations/settings/settings.md       |  2 -
 src/Interpreters/GraceHashJoin.cpp            | 55 +++++---------
 src/Interpreters/GraceHashJoin.h              |  3 +-
 .../Transforms/JoiningTransform.cpp           | 73 ++-----------------
 src/Processors/Transforms/JoiningTransform.h  | 25 +------
 src/QueryPipeline/QueryPipelineBuilder.cpp    |  2 +-
 ...01721_join_implicit_cast_long.reference.j2 | 40 ++++++++++
 .../01721_join_implicit_cast_long.sql.j2      |  1 +
 .../02273_full_sort_join.reference.j2         | 18 ++++-
 .../0_stateless/02273_full_sort_join.sql.j2   |  4 +-
 ...274_full_sort_join_nodistinct.reference.j2 | 34 ++++++++-
 .../02274_full_sort_join_nodistinct.sql.j2    |  6 +-
 .../02275_full_sort_join_long.reference       | 24 +-----
 .../02275_full_sort_join_long.sql.j2          |  9 ++-
 14 files changed, 138 insertions(+), 158 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 4f3b4e43358..f674fe1781e 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -452,8 +452,6 @@ Possible values:
 
  The first phase of a grace join reads the right table and splits it into N buckets depending on the hash value of key columns (initially, N is `grace_hash_join_initial_buckets`). This is done in a way to ensure that each bucket can be processed independently. Rows from the first bucket are added to an in-memory hash table while the others are saved to disk. If the hash table grows beyond the memory limit (e.g., as set by [`max_bytes_in_join`](/docs/en/operations/settings/query-complexity.md/#settings-max_bytes_in_join)), the number of buckets is increased and the assigned bucket for each row. Any rows which don’t belong to the current bucket are flushed and reassigned.
 
- Supports `INNER/LEFT/RIGHT/FULL ALL/ANY JOIN`.
-
 - hash
 
  [Hash join algorithm](https://en.wikipedia.org/wiki/Hash_join) is used. The most generic implementation that supports all combinations of kind and strictness and multiple join keys that are combined with `OR` in the `JOIN ON` section.
diff --git a/src/Interpreters/GraceHashJoin.cpp b/src/Interpreters/GraceHashJoin.cpp
index 4a4c69ff473..7795061072c 100644
--- a/src/Interpreters/GraceHashJoin.cpp
+++ b/src/Interpreters/GraceHashJoin.cpp
@@ -304,10 +304,8 @@ void GraceHashJoin::initBuckets()
 
 bool GraceHashJoin::isSupported(const std::shared_ptr<TableJoin> & table_join)
 {
-
     bool is_asof = (table_join->strictness() == JoinStrictness::Asof);
-    auto kind = table_join->kind();
-    return !is_asof && (isInner(kind) || isLeft(kind) || isRight(kind) || isFull(kind)) && table_join->oneDisjunct();
+    return !is_asof && isInnerOrLeft(table_join->kind()) && table_join->oneDisjunct();
 }
 
 GraceHashJoin::~GraceHashJoin() = default;
@@ -327,6 +325,7 @@ bool GraceHashJoin::hasMemoryOverflow(size_t total_rows, size_t total_bytes) con
     /// One row can't be split, avoid loop
     if (total_rows < 2)
         return false;
+
     bool has_overflow = !table_join->sizeLimits().softCheck(total_rows, total_bytes);
 
     if (has_overflow)
@@ -471,30 +470,18 @@ bool GraceHashJoin::alwaysReturnsEmptySet() const
 
     return hash_join_is_empty;
 }
-/// Each bucket are handled by the following steps
-/// 1. build hash_join by the right side blocks.
-/// 2. join left side with the hash_join,
-/// 3. read right non-joined blocks from hash_join.
-/// buckets are handled one by one, each hash_join will not be release before the right non-joined blocks are emitted.
-///
-/// There is a finished counter in JoiningTransform/DelayedJoinedBlocksWorkerTransform,
-/// only one processor could take the non-joined blocks from right stream, and ensure all rows from
-/// left stream have been emitted before this.
-IBlocksStreamPtr
-GraceHashJoin::getNonJoinedBlocks(const Block & left_sample_block_, const Block & result_sample_block_, UInt64 max_block_size_) const
+
+IBlocksStreamPtr GraceHashJoin::getNonJoinedBlocks(const Block &, const Block &, UInt64) const
 {
-    return hash_join->getNonJoinedBlocks(left_sample_block_, result_sample_block_, max_block_size_);
+    /// We do no support returning non joined blocks here.
+    /// TODO: They _should_ be reported by getDelayedBlocks instead
+    return nullptr;
 }
 
 class GraceHashJoin::DelayedBlocks : public IBlocksStream
 {
 public:
-    explicit DelayedBlocks(
-        size_t current_bucket_,
-        Buckets buckets_,
-        InMemoryJoinPtr hash_join_,
-        const Names & left_key_names_,
-        const Names & right_key_names_)
+    explicit DelayedBlocks(size_t current_bucket_, Buckets buckets_, InMemoryJoinPtr hash_join_, const Names & left_key_names_, const Names & right_key_names_)
         : current_bucket(current_bucket_)
         , buckets(std::move(buckets_))
         , hash_join(std::move(hash_join_))
@@ -512,15 +499,12 @@ public:
 
         do
         {
-            // One DelayedBlocks is shared among multiple DelayedJoinedBlocksWorkerTransform.
-            // There is a lock inside left_reader.read().
             block = left_reader.read();
             if (!block)
             {
                 return {};
             }
 
-            // block comes from left_reader, need to join with right table to get the result.
             Blocks blocks = JoinCommon::scatterBlockByHash(left_key_names, block, num_buckets);
             block = std::move(blocks[current_idx]);
 
@@ -571,6 +555,16 @@ IBlocksStreamPtr GraceHashJoin::getDelayedBlocks()
 
     size_t bucket_idx = current_bucket->idx;
 
+    if (hash_join)
+    {
+        auto right_blocks = hash_join->releaseJoinedBlocks(/* restructure */ false);
+        for (auto & block : right_blocks)
+        {
+            Blocks blocks = JoinCommon::scatterBlockByHash(right_key_names, block, buckets.size());
+            flushBlocksToBuckets<JoinTableSide::Right>(blocks, buckets, bucket_idx);
+        }
+    }
+
     hash_join = makeInMemoryJoin();
 
     for (bucket_idx = bucket_idx + 1; bucket_idx < buckets.size(); ++bucket_idx)
@@ -595,6 +589,7 @@ IBlocksStreamPtr GraceHashJoin::getDelayedBlocks()
 
         LOG_TRACE(log, "Loaded bucket {} with {}(/{}) rows",
             bucket_idx, hash_join->getTotalRowCount(), num_rows);
+
         return std::make_unique<DelayedBlocks>(current_bucket->idx, buckets, hash_join, left_key_names, right_key_names);
     }
 
@@ -634,18 +629,6 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
         if (!hash_join)
             hash_join = makeInMemoryJoin();
 
-        // buckets size has been changed in other threads. Need to scatter current_block again.
-        // rehash could only happen under hash_join_mutex's scope.
-        auto current_buckets = getCurrentBuckets();
-        if (buckets_snapshot.size() != current_buckets.size())
-        {
-            LOG_TRACE(log, "mismatch buckets size. previous:{}, current:{}", buckets_snapshot.size(), getCurrentBuckets().size());
-            Blocks blocks = JoinCommon::scatterBlockByHash(right_key_names, current_block, current_buckets.size());
-            flushBlocksToBuckets<JoinTableSide::Right>(blocks, current_buckets, bucket_index);
-            current_block = std::move(blocks[bucket_index]);
-            if (!current_block.rows())
-                return;
-        }
         hash_join->addJoinedBlock(current_block, /* check_limits = */ false);
 
         if (!hasMemoryOverflow(hash_join))
diff --git a/src/Interpreters/GraceHashJoin.h b/src/Interpreters/GraceHashJoin.h
index eb39ee09208..b8d83f4cad0 100644
--- a/src/Interpreters/GraceHashJoin.h
+++ b/src/Interpreters/GraceHashJoin.h
@@ -13,6 +13,7 @@
 
 namespace DB
 {
+
 class TableJoin;
 class HashJoin;
 
@@ -78,7 +79,7 @@ public:
     bool supportTotals() const override { return false; }
 
     IBlocksStreamPtr
-    getNonJoinedBlocks(const Block & left_sample_block_, const Block & result_sample_block_, UInt64 max_block_size) const override;
+    getNonJoinedBlocks(const Block & left_sample_block, const Block & result_sample_block, UInt64 max_block_size) const override;
 
     /// Open iterator over joined blocks.
     /// Must be called after all @joinBlock calls.
diff --git a/src/Processors/Transforms/JoiningTransform.cpp b/src/Processors/Transforms/JoiningTransform.cpp
index 256ef66a27d..bba8ec6fa16 100644
--- a/src/Processors/Transforms/JoiningTransform.cpp
+++ b/src/Processors/Transforms/JoiningTransform.cpp
@@ -189,6 +189,7 @@ void JoiningTransform::transform(Chunk & chunk)
     }
     else
         block = readExecute(chunk);
+
     auto num_rows = block.rows();
     chunk.setColumns(block.getColumns(), num_rows);
 }
@@ -310,16 +311,8 @@ void FillingRightJoinSideTransform::work()
 }
 
 
-DelayedJoinedBlocksWorkerTransform::DelayedJoinedBlocksWorkerTransform(
-    Block left_header_,
-    Block output_header_,
-    size_t max_block_size_,
-    JoinPtr join_)
-    : IProcessor(InputPorts{Block()}, OutputPorts{output_header_})
-    , left_header(left_header_)
-    , output_header(output_header_)
-    , max_block_size(max_block_size_)
-    , join(join_)
+DelayedJoinedBlocksWorkerTransform::DelayedJoinedBlocksWorkerTransform(Block output_header)
+    : IProcessor(InputPorts{Block()}, OutputPorts{output_header})
 {
 }
 
@@ -373,7 +366,6 @@ IProcessor::Status DelayedJoinedBlocksWorkerTransform::prepare()
         if (!data.chunk.hasChunkInfo())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "DelayedJoinedBlocksWorkerTransform must have chunk info");
         task = std::dynamic_pointer_cast<const DelayedBlocksTask>(data.chunk.getChunkInfo());
-
     }
     else
     {
@@ -394,24 +386,12 @@ void DelayedJoinedBlocksWorkerTransform::work()
 {
     if (!task)
         return;
-    Block block;
-    if (!left_delayed_stream_finished)
-    {
-        block = task->delayed_blocks->next();
 
-        if (!block)
-        {
-            left_delayed_stream_finished = true;
-            block = nextNonJoinedBlock();
-        }
-    }
-    else
-    {
-        block = nextNonJoinedBlock();
-    }
+    Block block = task->delayed_blocks->next();
+
     if (!block)
     {
-        resetTask();
+        task.reset();
         return;
     }
 
@@ -420,38 +400,6 @@ void DelayedJoinedBlocksWorkerTransform::work()
     output_chunk.setColumns(block.getColumns(), rows);
 }
 
-void DelayedJoinedBlocksWorkerTransform::resetTask()
-{
-    task.reset();
-    left_delayed_stream_finished = false;
-    setup_non_joined_stream = false;
-    non_joined_delayed_stream = nullptr;
-}
-
-Block DelayedJoinedBlocksWorkerTransform::nextNonJoinedBlock()
-{
-    if (!setup_non_joined_stream)
-    {
-        setup_non_joined_stream = true;
-        // Before read from non-joined stream, all blocks in left file reader must have been joined.
-        // For example, in HashJoin, it may return invalid mismatch rows from non-joined stream before
-        // the all blocks in left file reader have been finished, since the used flags are incomplete.
-        // To make only one processor could read from non-joined stream seems be a easy way.
-        if (task && task->left_delayed_stream_finish_counter->isLast())
-        {
-            if (!non_joined_delayed_stream)
-            {
-                non_joined_delayed_stream = join->getNonJoinedBlocks(left_header, output_header, max_block_size);
-            }
-        }
-    }
-    if (non_joined_delayed_stream)
-    {
-        return non_joined_delayed_stream->next();
-    }
-    return {};
-}
-
 DelayedJoinedBlocksTransform::DelayedJoinedBlocksTransform(size_t num_streams, JoinPtr join_)
     : IProcessor(InputPorts{}, OutputPorts(num_streams, Block()))
     , join(std::move(join_))
@@ -485,9 +433,6 @@ IProcessor::Status DelayedJoinedBlocksTransform::prepare()
 
     if (finished)
     {
-        // Since have memory limit, cannot handle all buckets parallelly by different
-        // DelayedJoinedBlocksWorkerTransform. So send the same task to all outputs.
-        // Wait for all DelayedJoinedBlocksWorkerTransform be idle before getting next bucket.
         for (auto & output : outputs)
         {
             if (output.isFinished())
@@ -503,14 +448,10 @@ IProcessor::Status DelayedJoinedBlocksTransform::prepare()
 
     if (delayed_blocks)
     {
-        // This counter is used to ensure that only the last DelayedJoinedBlocksWorkerTransform
-        // could read right non-joined blocks from the join.
-        auto left_delayed_stream_finished_counter = std::make_shared<JoiningTransform::FinishCounter>(outputs.size());
         for (auto & output : outputs)
         {
             Chunk chunk;
-            auto task = std::make_shared<DelayedBlocksTask>(delayed_blocks, left_delayed_stream_finished_counter);
-            chunk.setChunkInfo(task);
+            chunk.setChunkInfo(std::make_shared<DelayedBlocksTask>(delayed_blocks));
             output.push(std::move(chunk));
         }
         delayed_blocks = nullptr;
diff --git a/src/Processors/Transforms/JoiningTransform.h b/src/Processors/Transforms/JoiningTransform.h
index 3577906b26a..e7edff40c56 100644
--- a/src/Processors/Transforms/JoiningTransform.h
+++ b/src/Processors/Transforms/JoiningTransform.h
@@ -116,14 +116,9 @@ class DelayedBlocksTask : public ChunkInfo
 public:
 
     explicit DelayedBlocksTask() : finished(true) {}
-    explicit DelayedBlocksTask(IBlocksStreamPtr delayed_blocks_, JoiningTransform::FinishCounterPtr left_delayed_stream_finish_counter_)
-        : delayed_blocks(std::move(delayed_blocks_))
-        , left_delayed_stream_finish_counter(left_delayed_stream_finish_counter_)
-    {
-    }
+    explicit DelayedBlocksTask(IBlocksStreamPtr delayed_blocks_) : delayed_blocks(std::move(delayed_blocks_)) {}
 
     IBlocksStreamPtr delayed_blocks = nullptr;
-    JoiningTransform::FinishCounterPtr left_delayed_stream_finish_counter = nullptr;
 
     bool finished = false;
 };
@@ -152,11 +147,7 @@ private:
 class DelayedJoinedBlocksWorkerTransform : public IProcessor
 {
 public:
-    explicit DelayedJoinedBlocksWorkerTransform(
-        Block left_header_,
-        Block output_header_,
-        size_t max_block_size_,
-        JoinPtr join_);
+    explicit DelayedJoinedBlocksWorkerTransform(Block output_header);
 
     String getName() const override { return "DelayedJoinedBlocksWorkerTransform"; }
 
@@ -164,20 +155,10 @@ public:
     void work() override;
 
 private:
-    Block left_header;
-    Block output_header;
-    size_t max_block_size;
-    JoinPtr join;
     DelayedBlocksTaskPtr task;
     Chunk output_chunk;
 
-    /// All joined and non-joined rows from left stream are emitted, only right non-joined rows are left
-    bool left_delayed_stream_finished = false;
-    bool setup_non_joined_stream = false;
-    IBlocksStreamPtr non_joined_delayed_stream = nullptr;
-
-    void resetTask();
-    Block nextNonJoinedBlock();
+    bool finished = false;
 };
 
 }
diff --git a/src/QueryPipeline/QueryPipelineBuilder.cpp b/src/QueryPipeline/QueryPipelineBuilder.cpp
index 764997e7b7e..a4edf107b2f 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.cpp
+++ b/src/QueryPipeline/QueryPipelineBuilder.cpp
@@ -491,7 +491,7 @@ std::unique_ptr<QueryPipelineBuilder> QueryPipelineBuilder::joinPipelinesRightLe
         if (delayed_root)
         {
             // Process delayed joined blocks when all JoiningTransform are finished.
-            auto delayed = std::make_shared<DelayedJoinedBlocksWorkerTransform>(left_header, joined_header, max_block_size, join);
+            auto delayed = std::make_shared<DelayedJoinedBlocksWorkerTransform>(joined_header);
             if (delayed->getInputs().size() != 1 || delayed->getOutputs().size() != 1)
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "DelayedJoinedBlocksWorkerTransform should have one input and one output");
 
diff --git a/tests/queries/0_stateless/01721_join_implicit_cast_long.reference.j2 b/tests/queries/0_stateless/01721_join_implicit_cast_long.reference.j2
index ae43aa7195c..e9f32087439 100644
--- a/tests/queries/0_stateless/01721_join_implicit_cast_long.reference.j2
+++ b/tests/queries/0_stateless/01721_join_implicit_cast_long.reference.j2
@@ -1,6 +1,7 @@
 {% for join_algorithm in ['hash', 'partial_merge', 'auto', 'full_sorting_merge', 'grace_hash'] -%}
 === {{ join_algorithm }} ===
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 -4	0	196
 -3	0	197
 -2	0	198
@@ -16,6 +17,7 @@
 8	108	\N
 9	109	\N
 10	110	\N
+{% endif -%}
 = left =
 1	101	201
 2	102	202
@@ -28,6 +30,7 @@
 9	109	\N
 10	110	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 -4	0	196
 -3	0	197
 -2	0	198
@@ -38,6 +41,7 @@
 3	103	203
 4	104	204
 5	105	205
+{% endif -%}
 = inner =
 1	101	201
 2	102	202
@@ -45,6 +49,7 @@
 4	104	204
 5	105	205
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4
 0	0	-3
 0	0	-2
@@ -60,6 +65,7 @@
 8	8	0
 9	9	0
 10	10	0
+{% endif -%}
 = left =
 1	1	1
 2	2	2
@@ -72,6 +78,7 @@
 9	9	0
 10	10	0
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4
 0	0	-3
 0	0	-2
@@ -82,6 +89,7 @@
 3	3	3
 4	4	4
 5	5	5
+{% endif -%}
 = inner =
 1	1	1
 2	2	2
@@ -90,6 +98,7 @@
 5	5	5
 = join on =
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4	196
 0	0	-3	197
 0	0	-2	198
@@ -105,6 +114,7 @@
 8	108	0	\N
 9	109	0	\N
 10	110	0	\N
+{% endif -%}
 = left =
 1	101	1	201
 2	102	2	202
@@ -117,6 +127,7 @@
 9	109	0	\N
 10	110	0	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4	196
 0	0	-3	197
 0	0	-2	198
@@ -127,6 +138,7 @@
 3	103	3	203
 4	104	4	204
 5	105	5	205
+{% endif -%}
 = inner =
 1	101	1	201
 2	102	2	202
@@ -134,6 +146,7 @@
 4	104	4	204
 5	105	5	205
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4	196
 0	0	-3	197
 0	0	-2	198
@@ -149,6 +162,7 @@
 8	108	0	\N
 9	109	0	\N
 10	110	0	\N
+{% endif -%}
 = left =
 1	101	1	201
 2	102	2	202
@@ -161,6 +175,7 @@
 9	109	0	\N
 10	110	0	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 0	0	-4	196
 0	0	-3	197
 0	0	-2	198
@@ -171,6 +186,7 @@
 3	103	3	203
 4	104	4	204
 5	105	5	205
+{% endif -%}
 = inner =
 1	101	1	201
 2	102	2	202
@@ -180,6 +196,7 @@
 = agg =
 1
 1
+{% if join_algorithm not in ['grace_hash'] -%}
 1
 1
 1
@@ -188,11 +205,13 @@
 1	55	1055
 0	0	-10	0	990
 1	55	15	1055	1015
+{% endif -%}
 = types =
 1
 1
 1
 1
+{% if join_algorithm not in ['grace_hash'] -%}
 1
 1
 1
@@ -200,9 +219,11 @@
 1
 1
 1
+{% endif -%}
 {% if join_algorithm not in ['full_sorting_merge'] -%}
 === join use nulls ===
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 -4	\N	196
 -3	\N	197
 -2	\N	198
@@ -218,6 +239,7 @@
 8	108	\N
 9	109	\N
 10	110	\N
+{% endif -%}
 = left =
 1	101	201
 2	102	202
@@ -230,6 +252,7 @@
 9	109	\N
 10	110	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 -4	\N	196
 -3	\N	197
 -2	\N	198
@@ -240,6 +263,7 @@
 3	103	203
 4	104	204
 5	105	205
+{% endif -%}
 = inner =
 1	101	201
 2	102	202
@@ -247,6 +271,7 @@
 4	104	204
 5	105	205
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	1	1
 2	2	2
 3	3	3
@@ -262,6 +287,7 @@
 \N	\N	-2
 \N	\N	-1
 \N	\N	0
+{% endif -%}
 = left =
 1	1	1
 2	2	2
@@ -274,6 +300,7 @@
 9	9	\N
 10	10	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	1	1
 2	2	2
 3	3	3
@@ -284,6 +311,7 @@
 \N	\N	-2
 \N	\N	-1
 \N	\N	0
+{% endif -%}
 = inner =
 1	1	1
 2	2	2
@@ -292,6 +320,7 @@
 5	5	5
 = join on =
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	101	1	201
 2	102	2	202
 3	103	3	203
@@ -307,6 +336,7 @@
 \N	\N	-2	198
 \N	\N	-1	199
 \N	\N	0	200
+{% endif -%}
 = left =
 1	101	1	201
 2	102	2	202
@@ -319,6 +349,7 @@
 9	109	\N	\N
 10	110	\N	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	101	1	201
 2	102	2	202
 3	103	3	203
@@ -329,6 +360,7 @@
 \N	\N	-2	198
 \N	\N	-1	199
 \N	\N	0	200
+{% endif -%}
 = inner =
 1	101	1	201
 2	102	2	202
@@ -336,6 +368,7 @@
 4	104	4	204
 5	105	5	205
 = full =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	101	1	201
 2	102	2	202
 3	103	3	203
@@ -351,6 +384,7 @@
 \N	\N	-2	198
 \N	\N	-1	199
 \N	\N	0	200
+{% endif -%}
 = left =
 1	101	1	201
 2	102	2	202
@@ -363,6 +397,7 @@
 9	109	\N	\N
 10	110	\N	\N
 = right =
+{% if join_algorithm not in ['grace_hash'] -%}
 1	101	1	201
 2	102	2	202
 3	103	3	203
@@ -373,6 +408,7 @@
 \N	\N	-2	198
 \N	\N	-1	199
 \N	\N	0	200
+{% endif -%}
 = inner =
 1	101	1	201
 2	102	2	202
@@ -382,6 +418,7 @@
 = agg =
 1
 1
+{% if join_algorithm not in ['grace_hash'] -%}
 1
 1
 1
@@ -390,11 +427,13 @@
 1	55	1055
 1	55	15	1055	1015
 \N	\N	-10	\N	990
+{% endif -%}
 = types =
 1
 1
 1
 1
+{% if join_algorithm not in ['grace_hash'] -%}
 1
 1
 1
@@ -403,4 +442,5 @@
 1
 1
 {% endif -%}
+{% endif -%}
 {% endfor -%}
diff --git a/tests/queries/0_stateless/01721_join_implicit_cast_long.sql.j2 b/tests/queries/0_stateless/01721_join_implicit_cast_long.sql.j2
index 38f71f4c5ec..f5321939f28 100644
--- a/tests/queries/0_stateless/01721_join_implicit_cast_long.sql.j2
+++ b/tests/queries/0_stateless/01721_join_implicit_cast_long.sql.j2
@@ -10,6 +10,7 @@ INSERT INTO t1 SELECT number as a, 100 + number as b FROM system.numbers LIMIT 1
 INSERT INTO t2 SELECT number - 5 as a, 200 + number - 5 as b FROM system.numbers LIMIT 1, 10;
 
 {% macro is_implemented(join_algorithm) -%}
+{% if join_algorithm == 'grace_hash' %} -- { serverError NOT_IMPLEMENTED } {% endif %}
 {% endmacro -%}
 
 {% for join_algorithm in ['hash', 'partial_merge', 'auto', 'full_sorting_merge', 'grace_hash'] -%}
diff --git a/tests/queries/0_stateless/02273_full_sort_join.reference.j2 b/tests/queries/0_stateless/02273_full_sort_join.reference.j2
index 0af4158e971..98bfd9d9b2b 100644
--- a/tests/queries/0_stateless/02273_full_sort_join.reference.j2
+++ b/tests/queries/0_stateless/02273_full_sort_join.reference.j2
@@ -1,7 +1,7 @@
 {% set table_size = 15 -%}
 {% for join_algorithm in ['default', 'full_sorting_merge', 'grace_hash'] -%}
 -- {{ join_algorithm }} --
-{% for block_size in range(1, table_size + 1, 4) -%}
+{% for block_size in range(1, table_size + 1) -%}
 ALL INNER USING | bs = {{ block_size }}
 4	0	0
 5	0	0
@@ -50,6 +50,7 @@ ALL LEFT | bs = {{ block_size }}
 14	14	val9	0
 14	14	val9	0
 ALL RIGHT | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 4	4	0	val10
 5	5	0	val6
 6	6	0	val8
@@ -63,6 +64,7 @@ ALL RIGHT | bs = {{ block_size }}
 13	13	0	val9
 14	14	0	val3
 14	14	0	val7
+{% endif -%}
 ALL INNER | bs = {{ block_size }} | copmosite key
 2	2	2	2	2	2	0	0
 2	2	2	2	2	2	0	0
@@ -83,6 +85,7 @@ ALL LEFT | bs = {{ block_size }} | copmosite key
 2	2	2	2	2	2	val12	0
 2	2	2	2	2	2	val9	0
 ALL RIGHT | bs = {{ block_size }} | copmosite key
+{% if join_algorithm != 'grace_hash' -%}
 0	\N	0	1	1	1	1	val2
 0	\N	0	1	1	1	1	val7
 0	\N	0	1	1	2	1	val5
@@ -96,6 +99,7 @@ ALL RIGHT | bs = {{ block_size }} | copmosite key
 0	\N	0	2	2	\N	1	val9
 2	2	2	2	2	2	0	val4
 2	2	2	2	2	2	0	val4
+{% endif -%}
 ANY INNER USING | bs = {{ block_size }}
 4	0	0
 5	0	0
@@ -133,6 +137,7 @@ ANY LEFT | bs = {{ block_size }}
 13	13	val13	0
 14	14	val9	0
 ANY RIGHT | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 4	4	0	val10
 5	5	0	val6
 6	6	0	val8
@@ -145,6 +150,7 @@ ANY RIGHT | bs = {{ block_size }}
 13	13	0	val9
 14	14	0	val3
 14	14	0	val7
+{% endif -%}
 ANY INNER | bs = {{ block_size }} | copmosite key
 2	2	2	2	2	2	0	0
 ANY LEFT | bs = {{ block_size }} | copmosite key
@@ -164,6 +170,7 @@ ANY LEFT | bs = {{ block_size }} | copmosite key
 2	2	2	2	2	2	val12	0
 2	2	2	2	2	2	val9	0
 ANY RIGHT | bs = {{ block_size }} | copmosite key
+{% if join_algorithm != 'grace_hash' -%}
 0	\N	0	1	1	1	1	val2
 0	\N	0	1	1	1	1	val7
 0	\N	0	1	1	2	1	val5
@@ -176,6 +183,7 @@ ANY RIGHT | bs = {{ block_size }} | copmosite key
 0	\N	0	2	1	\N	1	val3
 0	\N	0	2	2	\N	1	val9
 2	2	2	2	2	2	0	val4
+{% endif -%}
 {% endfor -%}
 ALL INNER | join_use_nulls = 1
 4	4	0	0
@@ -211,6 +219,7 @@ ALL LEFT | join_use_nulls = 1
 14	14	val9	0
 14	14	val9	0
 ALL RIGHT | join_use_nulls = 1
+{% if join_algorithm != 'grace_hash' -%}
 4	4	0	val10
 5	5	0	val6
 6	6	0	val8
@@ -224,6 +233,7 @@ ALL RIGHT | join_use_nulls = 1
 13	13	0	val9
 14	14	0	val3
 14	14	0	val7
+{% endif -%}
 ALL INNER | join_use_nulls = 1 | copmosite key
 2	2	2	2	2	2	0	0
 2	2	2	2	2	2	0	0
@@ -244,6 +254,7 @@ ALL LEFT | join_use_nulls = 1 | copmosite key
 2	2	2	2	2	2	val12	0
 2	2	2	2	2	2	val9	0
 ALL RIGHT | join_use_nulls = 1 | copmosite key
+{% if join_algorithm != 'grace_hash' -%}
 2	2	2	2	2	2	0	val4
 2	2	2	2	2	2	0	val4
 \N	\N	\N	1	1	1	\N	val2
@@ -257,6 +268,7 @@ ALL RIGHT | join_use_nulls = 1 | copmosite key
 \N	\N	\N	2	1	2	\N	val8
 \N	\N	\N	2	1	\N	\N	val3
 \N	\N	\N	2	2	\N	\N	val9
+{% endif -%}
 ANY INNER | join_use_nulls = 1
 4	4	0	0
 5	5	0	0
@@ -284,6 +296,7 @@ ANY LEFT | join_use_nulls = 1
 13	13	val13	0
 14	14	val9	0
 ANY RIGHT | join_use_nulls = 1
+{% if join_algorithm != 'grace_hash' -%}
 4	4	0	val10
 5	5	0	val6
 6	6	0	val8
@@ -296,6 +309,7 @@ ANY RIGHT | join_use_nulls = 1
 13	13	0	val9
 14	14	0	val3
 14	14	0	val7
+{% endif -%}
 ANY INNER | join_use_nulls = 1 | copmosite key
 2	2	2	2	2	2	0	0
 ANY LEFT | join_use_nulls = 1 | copmosite key
@@ -315,6 +329,7 @@ ANY LEFT | join_use_nulls = 1 | copmosite key
 2	2	2	2	2	2	val12	0
 2	2	2	2	2	2	val9	0
 ANY RIGHT | join_use_nulls = 1 | copmosite key
+{% if join_algorithm != 'grace_hash' -%}
 2	2	2	2	2	2	0	val4
 \N	\N	\N	1	1	1	\N	val2
 \N	\N	\N	1	1	1	\N	val7
@@ -327,4 +342,5 @@ ANY RIGHT | join_use_nulls = 1 | copmosite key
 \N	\N	\N	2	1	2	\N	val8
 \N	\N	\N	2	1	\N	\N	val3
 \N	\N	\N	2	2	\N	\N	val9
+{% endif -%}
 {% endfor -%}
diff --git a/tests/queries/0_stateless/02273_full_sort_join.sql.j2 b/tests/queries/0_stateless/02273_full_sort_join.sql.j2
index 6500306356c..8b739330364 100644
--- a/tests/queries/0_stateless/02273_full_sort_join.sql.j2
+++ b/tests/queries/0_stateless/02273_full_sort_join.sql.j2
@@ -26,7 +26,9 @@ INSERT INTO t2
         'val' || toString(number) as s
     FROM numbers_mt({{ table_size - 3 }});
 
+
 {% macro is_implemented(join_algorithm) -%}
+{% if join_algorithm == 'grace_hash' %} -- { serverError NOT_IMPLEMENTED } {% endif %}
 {% endmacro -%}
 
 {% for join_algorithm in ['default', 'full_sorting_merge', 'grace_hash'] -%}
@@ -36,7 +38,7 @@ SET max_bytes_in_join = '{% if join_algorithm == 'grace_hash' %}10K{% else %}0{%
 SELECT '-- {{ join_algorithm }} --';
 SET join_algorithm = '{{ join_algorithm }}';
 
-{% for block_size in range(1, table_size + 1, 4) -%}
+{% for block_size in range(1, table_size + 1) -%}
 {% for kind in ['ALL', 'ANY'] -%}
 
 SET max_block_size = {{ block_size }};
diff --git a/tests/queries/0_stateless/02274_full_sort_join_nodistinct.reference.j2 b/tests/queries/0_stateless/02274_full_sort_join_nodistinct.reference.j2
index df968e86e8d..2cc6c6e85d6 100644
--- a/tests/queries/0_stateless/02274_full_sort_join_nodistinct.reference.j2
+++ b/tests/queries/0_stateless/02274_full_sort_join_nodistinct.reference.j2
@@ -1,6 +1,6 @@
 {% for join_algorithm in ['full_sorting_merge', 'grace_hash'] -%}
 --- {{ join_algorithm }} ---
-{% for block_size in range(1, 11, 4) -%}
+{% for block_size in range(1, 11) -%}
 t1 ALL INNER JOIN t2 | bs = {{ block_size }}
 1	1	4	5
 1	1	4	5
@@ -108,6 +108,7 @@ t1 ALL LEFT JOIN t2 | bs = {{ block_size }}
 2	2	val27	5
 3	3	val3	4
 t1 ALL RIGHT JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 2	2	5	val22
@@ -160,6 +161,7 @@ t1 ALL RIGHT JOIN t2 | bs = {{ block_size }}
 2	2	5	val28
 2	2	5	val28
 3	3	4	val3
+{% endif -%}
 t1 ANY INNER JOIN t2 | bs = {{ block_size }}
 1	1	4	5
 2	2	5	5
@@ -175,6 +177,7 @@ t1 ANY LEFT JOIN t2 | bs = {{ block_size }}
 2	2	val27	5
 3	3	val3	4
 t1 ANY RIGHT JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 2	2	5	val22
@@ -185,7 +188,9 @@ t1 ANY RIGHT JOIN t2 | bs = {{ block_size }}
 2	2	5	val27
 2	2	5	val28
 3	3	4	val3
+{% endif -%}
 t1 ALL FULL JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	5
 1	1	4	5
 2	2	5	5
@@ -238,7 +243,9 @@ t1 ALL FULL JOIN t2 | bs = {{ block_size }}
 2	2	5	5
 2	2	5	5
 3	3	4	4
+{% endif -%}
 t1 ALL FULL JOIN USING t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	4	5
 1	4	5
 2	5	5
@@ -291,6 +298,7 @@ t1 ALL FULL JOIN USING t2 | bs = {{ block_size }}
 2	5	5
 2	5	5
 3	4	4
+{% endif -%}
 t1 ALL INNER JOIN tn2 | bs = {{ block_size }}
 1	1	4	5
 1	1	4	5
@@ -307,6 +315,7 @@ t1 ALL LEFT JOIN tn2 | bs = {{ block_size }}
 2	\N	val27	0
 3	3	val3	4
 t1 ALL RIGHT JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 0	\N	0	val22
 0	\N	0	val23
 0	\N	0	val24
@@ -317,6 +326,7 @@ t1 ALL RIGHT JOIN tn2 | bs = {{ block_size }}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
+{% endif -%}
 t1 ANY INNER JOIN tn2 | bs = {{ block_size }}
 1	1	4	5
 3	3	4	4
@@ -331,6 +341,7 @@ t1 ANY LEFT JOIN tn2 | bs = {{ block_size }}
 2	\N	val27	0
 3	3	val3	4
 t1 ANY RIGHT JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 0	\N	0	val22
 0	\N	0	val23
 0	\N	0	val24
@@ -341,7 +352,9 @@ t1 ANY RIGHT JOIN tn2 | bs = {{ block_size }}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
+{% endif -%}
 t1 ALL FULL JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 0	\N	0	5
 0	\N	0	5
 0	\N	0	5
@@ -359,8 +372,9 @@ t1 ALL FULL JOIN tn2 | bs = {{ block_size }}
 2	\N	5	0
 2	\N	5	0
 3	3	4	4
-{% if join_algorithm != 'grace_hash' -%}
+{% endif -%}
 t1 ALL FULL JOIN USING tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	4	5
 1	4	5
 2	5	0
@@ -395,6 +409,7 @@ tn1 ALL LEFT JOIN t2 | bs = {{ block_size }}
 \N	0	val26	0
 \N	0	val27	0
 tn1 ALL RIGHT JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
@@ -405,6 +420,7 @@ tn1 ALL RIGHT JOIN t2 | bs = {{ block_size }}
 \N	2	0	val26
 \N	2	0	val27
 \N	2	0	val28
+{% endif -%}
 tn1 ANY INNER JOIN t2 | bs = {{ block_size }}
 1	1	4	5
 3	3	4	4
@@ -419,6 +435,7 @@ tn1 ANY LEFT JOIN t2 | bs = {{ block_size }}
 \N	0	val26	0
 \N	0	val27	0
 tn1 ANY RIGHT JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
@@ -429,7 +446,9 @@ tn1 ANY RIGHT JOIN t2 | bs = {{ block_size }}
 \N	2	0	val26
 \N	2	0	val27
 \N	2	0	val28
+{% endif -%}
 tn1 ALL FULL JOIN t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	5
 1	1	4	5
 3	3	4	4
@@ -447,7 +466,9 @@ tn1 ALL FULL JOIN t2 | bs = {{ block_size }}
 \N	2	0	5
 \N	2	0	5
 \N	2	0	5
+{% endif -%}
 tn1 ALL FULL JOIN USING t2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	4	5
 1	4	5
 2	0	5
@@ -465,6 +486,7 @@ tn1 ALL FULL JOIN USING t2 | bs = {{ block_size }}
 \N	5	0
 \N	5	0
 \N	5	0
+{% endif -%}
 tn1 ALL INNER JOIN tn2 | bs = {{ block_size }}
 1	1	4	5
 1	1	4	5
@@ -481,6 +503,7 @@ tn1 ALL LEFT JOIN tn2 | bs = {{ block_size }}
 \N	\N	val26	0
 \N	\N	val27	0
 tn1 ALL RIGHT JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
@@ -491,6 +514,7 @@ tn1 ALL RIGHT JOIN tn2 | bs = {{ block_size }}
 \N	\N	0	val26
 \N	\N	0	val27
 \N	\N	0	val28
+{% endif -%}
 tn1 ANY INNER JOIN tn2 | bs = {{ block_size }}
 1	1	4	5
 3	3	4	4
@@ -505,6 +529,7 @@ tn1 ANY LEFT JOIN tn2 | bs = {{ block_size }}
 \N	\N	val26	0
 \N	\N	val27	0
 tn1 ANY RIGHT JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	val11
 1	1	4	val12
 3	3	4	val3
@@ -515,7 +540,9 @@ tn1 ANY RIGHT JOIN tn2 | bs = {{ block_size }}
 \N	\N	0	val26
 \N	\N	0	val27
 \N	\N	0	val28
+{% endif -%}
 tn1 ALL FULL JOIN tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	1	4	5
 1	1	4	5
 3	3	4	4
@@ -533,8 +560,9 @@ tn1 ALL FULL JOIN tn2 | bs = {{ block_size }}
 \N	\N	5	0
 \N	\N	5	0
 \N	\N	5	0
-{% if join_algorithm != 'grace_hash' -%}
+{% endif -%}
 tn1 ALL FULL JOIN USING tn2 | bs = {{ block_size }}
+{% if join_algorithm != 'grace_hash' -%}
 1	4	5
 1	4	5
 3	4	4
diff --git a/tests/queries/0_stateless/02274_full_sort_join_nodistinct.sql.j2 b/tests/queries/0_stateless/02274_full_sort_join_nodistinct.sql.j2
index f8eb4b1a53e..613da65421e 100644
--- a/tests/queries/0_stateless/02274_full_sort_join_nodistinct.sql.j2
+++ b/tests/queries/0_stateless/02274_full_sort_join_nodistinct.sql.j2
@@ -16,6 +16,7 @@ INSERT INTO t2 VALUES (1, 'val11'), (1, 'val12'), (2, 'val22'), (2, 'val23'), (2
 INSERT INTO tn2 VALUES (1, 'val11'), (1, 'val12'), (NULL, 'val22'), (NULL, 'val23'), (NULL, 'val24'), (NULL, 'val25'), (NULL, 'val26'), (NULL, 'val27'), (NULL, 'val28'), (3, 'val3');
 
 {% macro is_implemented(join_algorithm) -%}
+{% if join_algorithm == 'grace_hash' %} -- { serverError NOT_IMPLEMENTED } {% endif %}
 {% endmacro -%}
 
 {% for join_algorithm in ['full_sorting_merge', 'grace_hash'] -%}
@@ -26,7 +27,7 @@ SET join_algorithm = '{{ join_algorithm }}';
 
 SELECT '--- {{ join_algorithm }} ---';
 
-{% for block_size in range(1, 11, 4) -%}
+{% for block_size in range(1, 11) -%}
 SET max_block_size = {{ block_size }};
 
 {% for t1, t2 in [('t1', 't2'), ('t1', 'tn2'), ('tn1', 't2'), ('tn1', 'tn2')]  -%}
@@ -46,10 +47,9 @@ SELECT t1.key, t2.key, length(t1.s), t2.s FROM {{ t1 }} AS t1 {{ kind }} RIGHT J
 SELECT '{{ t1 }} ALL FULL JOIN {{ t2 }} | bs = {{ block_size }}';
 SELECT t1.key, t2.key, length(t1.s), length(t2.s) FROM {{ t1 }} AS t1 {{ kind }} FULL JOIN {{ t2 }} AS t2 ON t1.key == t2.key ORDER BY t1.key, t2.key, length(t1.s), length(t2.s); {{ is_implemented(join_algorithm) }}
 
-{% if join_algorithm == 'full_sorting_merge' or t2 != 'tn2' -%}
 SELECT '{{ t1 }} ALL FULL JOIN USING {{ t2 }} | bs = {{ block_size }}';
 SELECT key, length(t1.s), length(t2.s) FROM {{ t1 }} AS t1 ALL FULL JOIN {{ t2 }} AS t2 USING (key) ORDER BY key, length(t1.s), length(t2.s); {{ is_implemented(join_algorithm) }}
-{% endif -%}
+
 {% endfor -%}
 {% endfor -%}
 SET max_bytes_in_join = 0;
diff --git a/tests/queries/0_stateless/02275_full_sort_join_long.reference b/tests/queries/0_stateless/02275_full_sort_join_long.reference
index 73482358d12..9ec06aea3e6 100644
--- a/tests/queries/0_stateless/02275_full_sort_join_long.reference
+++ b/tests/queries/0_stateless/02275_full_sort_join_long.reference
@@ -41,34 +41,16 @@ ALL INNER
 ALL LEFT
 50195752660639	500353531835	10369589	10369589	1000342
 ALL RIGHT
-500353531835	684008812186	1367170	1000342	1367170
+skipped
 ALL INNER
 500353531835	500353531835	1000342	1000342	1000342
 ALL LEFT
 50195752660639	500353531835	10369589	10369589	1000342
 ALL RIGHT
-500353531835	684008812186	1367170	1000342	1367170
+skipped
 ALL INNER
 500353531835	500353531835	1000342	1000342	1000342
 ALL LEFT
 50195752660639	500353531835	10369589	10369589	1000342
 ALL RIGHT
-500353531835	684008812186	1367170	1000342	1367170
-ANY INNER
-199622811843	199622811843	399458	399458	399458
-ANY LEFT
-50010619420459	315220291655	10000000	10000000	630753
-ANY RIGHT
-316611844056	500267124407	1000000	633172	1000000
-ANY INNER
-199622811843	199622811843	399458	399458	399458
-ANY LEFT
-50010619420459	315220291655	10000000	10000000	630753
-ANY RIGHT
-316611844056	500267124407	1000000	633172	1000000
-ANY INNER
-199622811843	199622811843	399458	399458	399458
-ANY LEFT
-50010619420459	315220291655	10000000	10000000	630753
-ANY RIGHT
-316611844056	500267124407	1000000	633172	1000000
+skipped
diff --git a/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2 b/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
index 0b28fd67050..98cc46c9cb4 100644
--- a/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
+++ b/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
@@ -22,6 +22,11 @@ INSERT INTO t2
     FROM numbers_mt({{ rtable_size }})
 ;
 
+{% macro is_implemented(join_algorithm) -%}
+{% if join_algorithm == 'grace_hash' %} -- { serverError NOT_IMPLEMENTED }
+SELECT 'skipped';
+{% endif -%}
+{% endmacro -%}
 
 {% for join_algorithm in ['full_sorting_merge', 'grace_hash'] -%}
 
@@ -35,6 +40,7 @@ SET join_algorithm = '{{ join_algorithm }}';
 
 SET max_block_size = {{ block_size }};
 
+{% if not (kind == 'ANY' and join_algorithm == 'grace_hash') -%}
 
 SELECT '{{ kind }} INNER';
 SELECT sum(t1.key), sum(t2.key), count(), countIf(t1.key != 0), countIf(t2.key != 0) FROM t1
@@ -52,8 +58,9 @@ SELECT '{{ kind }} RIGHT';
 SELECT sum(t1.key), sum(t2.key), count(), countIf(t1.key != 0), countIf(t2.key != 0) FROM t1
 {{ kind }} RIGHT JOIN t2
 ON t1.key == t2.key
-;
+; {{ is_implemented(join_algorithm) }}
 
+{% endif -%}
 
 {% endfor -%}
 {% endfor -%}

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 0613/1478] 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 0614/1478] 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 32d1acb3a57b0c1e942c64b7c434701f37fa1910 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 8 Jun 2023 12:29:26 +0200
Subject: [PATCH 0615/1478] Add changelog for 23.5

---
 CHANGELOG.md | 253 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 253 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1ccd4f9846d..f2ffdad9a7c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,5 @@
 ### Table of Contents
+**[ClickHouse release v23.5, 2023-06-08](#235)**<br/>
 **[ClickHouse release v23.4, 2023-04-26](#234)**<br/>
 **[ClickHouse release v23.3 LTS, 2023-03-30](#233)**<br/>
 **[ClickHouse release v23.2, 2023-02-23](#232)**<br/>
@@ -7,6 +8,258 @@
 
 # 2023 Changelog
 
+### <a id="235"></a> ClickHouse release 23.5, 2023-06-08
+
+#### Upgrade Notes
+* Compress marks and primary key by default. It significantly reduces the cold query time. Upgrade notes: the support for compressed marks and primary key has been added in version 22.9. If you turned on compressed marks or primary key or installed version 23.5 or newer, which has compressed marks or primary key on by default, you will not be able to downgrade to version 22.8 or earlier. You can also explicitly disable compressed marks or primary keys by specifying the `compress_marks` and `compress_primary_key` settings in the `<merge_tree>` section of the server configuration file. **Upgrade notes:** If you upgrade from versions prior to 22.9, you should either upgrade all replicas at once or disable the compression before upgrade, or upgrade through an intermediate version, where the compressed marks are supported but not enabled by default, such as 23.3. [#42587](https://github.com/ClickHouse/ClickHouse/pull/42587) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Make local object storage work consistently with s3 object storage, fix problem with append (closes [#48465](https://github.com/ClickHouse/ClickHouse/issues/48465)), make it configurable as independent storage. The change is backward incompatible because the cache on top of local object storage is not incompatible to previous versions. [#48791](https://github.com/ClickHouse/ClickHouse/pull/48791) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* The experimental feature "in-memory data parts" is removed. The data format is still supported, but the settings are no-op, and compact or wide parts will be used instead. This closes [#45409](https://github.com/ClickHouse/ClickHouse/issues/45409). [#49429](https://github.com/ClickHouse/ClickHouse/pull/49429) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Changed default values of settings `parallelize_output_from_storages` and `input_format_parquet_preserve_order`. This allows ClickHouse to reorder rows when reading from files (e.g. CSV or Parquet), greatly improving performance in many cases. To restore the old behavior of preserving order, use `parallelize_output_from_storages = 0`, `input_format_parquet_preserve_order = 1`. [#49479](https://github.com/ClickHouse/ClickHouse/pull/49479) ([Michael Kolupaev](https://github.com/al13n321)).
+* Make projections production-ready. Add the `optimize_use_projections` setting to control whether the projections will be selected for SELECT queries. The setting `allow_experimental_projection_optimization` is obsolete and does nothing. [#49719](https://github.com/ClickHouse/ClickHouse/pull/49719) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Mark `joinGet` as non deterministic (so as `dictGet`). It allows using them in mutations without an extra setting. [#49843](https://github.com/ClickHouse/ClickHouse/pull/49843) ([Azat Khuzhin](https://github.com/azat)).
+* Revert the "`groupArray` returns cannot be nullable" change (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)).
+* 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 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)).
+* Geographical data types (`Point`, `Ring`, `Polygon`, and `MultiPolygon`) are production-ready. [#50022](https://github.com/ClickHouse/ClickHouse/pull/50022) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add schema inference to PostgreSQL, MySQL, MeiliSearch, and SQLite table engines. Closes [#49972](https://github.com/ClickHouse/ClickHouse/issues/49972). [#50000](https://github.com/ClickHouse/ClickHouse/pull/50000) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Password type in queries like `CREATE USER u IDENTIFIED BY 'p'` will be automatically set according to the setting `default_password_type` in the `config.xml` on the server. Closes [#42915](https://github.com/ClickHouse/ClickHouse/issues/42915). [#44674](https://github.com/ClickHouse/ClickHouse/pull/44674) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Add bcrypt password authentication type. Closes [#34599](https://github.com/ClickHouse/ClickHouse/issues/34599). [#44905](https://github.com/ClickHouse/ClickHouse/pull/44905) ([Nikolay Degterinsky](https://github.com/evillique)).
+* 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)).
+* 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)).
+* Support statement `SHOW INDEX` to improve compatibility with MySQL. [#49158](https://github.com/ClickHouse/ClickHouse/pull/49158) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add virtual column `_file` and `_path` support to table function `url`. - Impove error message for table function `url`. - resolves [#49231](https://github.com/ClickHouse/ClickHouse/issues/49231) - resolves [#49232](https://github.com/ClickHouse/ClickHouse/issues/49232). [#49356](https://github.com/ClickHouse/ClickHouse/pull/49356) ([Ziyi Tan](https://github.com/Ziy1-Tan)).
+* Adding the `grants` field in the users.xml file, which allows specifying grants for users. [#49381](https://github.com/ClickHouse/ClickHouse/pull/49381) ([pufit](https://github.com/pufit)).
+* Support full/right join by using grace hash join algorithm. [#49483](https://github.com/ClickHouse/ClickHouse/pull/49483) ([lgbo](https://github.com/lgbo-ustc)).
+* `WITH FILL` modifier groups filling by sorting prefix. Controlled by `use_with_fill_by_sorting_prefix` setting (enabled by default). Related to [#33203](https://github.com/ClickHouse/ClickHouse/issues/33203)#issuecomment-1418736794. [#49503](https://github.com/ClickHouse/ClickHouse/pull/49503) ([Igor Nikonov](https://github.com/devcrafter)).
+* Clickhouse-client now accepts queries after "--multiquery" when "--query" (or "-q") is absent. example: clickhouse-client --multiquery "select 1; select 2;". [#49870](https://github.com/ClickHouse/ClickHouse/pull/49870) ([Alexey Gerasimchuk](https://github.com/Demilivor)).
+* Add separate `handshake_timeout` for receiving Hello packet from replica. Closes [#48854](https://github.com/ClickHouse/ClickHouse/issues/48854). [#49948](https://github.com/ClickHouse/ClickHouse/pull/49948) ([Kruglov Pavel](https://github.com/Avogar)).
+* Added a function "space" which repeats a space as many times as specified. [#50103](https://github.com/ClickHouse/ClickHouse/pull/50103) ([Robert Schulze](https://github.com/rschu1ze)).
+* Added --input_format_csv_trim_whitespaces option. [#50215](https://github.com/ClickHouse/ClickHouse/pull/50215) ([Alexey Gerasimchuk](https://github.com/Demilivor)).
+* Allow the `dictGetAll` function for regexp tree dictionaries to return values from multiple matches as arrays. Closes [#50254](https://github.com/ClickHouse/ClickHouse/issues/50254). [#50255](https://github.com/ClickHouse/ClickHouse/pull/50255) ([Johann Gan](https://github.com/johanngan)).
+* Added `toLastDayOfWeek` function to round a date or a date with time up to the nearest Saturday or Sunday. [#50315](https://github.com/ClickHouse/ClickHouse/pull/50315) ([Victor Krasnov](https://github.com/sirvickr)).
+* Ability to ignore a skip index by specifying `ignore_data_skipping_indices`. [#50329](https://github.com/ClickHouse/ClickHouse/pull/50329) ([Boris Kuschel](https://github.com/bkuschel)).
+* Add `system.user_processes` table and `SHOW USER PROCESSES` query to show memory info and ProfileEvents on user level. [#50492](https://github.com/ClickHouse/ClickHouse/pull/50492) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)).
+* Add server and format settings `display_secrets_in_show_and_select` for displaying secrets of tables, databases, table functions, and dictionaries. Add privilege `displaySecretsInShowAndSelect` controlling which users can view secrets. [#46528](https://github.com/ClickHouse/ClickHouse/pull/46528) ([Mike Kot](https://github.com/myrrc)).
+* Allow to set up a ROW POLICY for all tables that belong to a DATABASE. [#47640](https://github.com/ClickHouse/ClickHouse/pull/47640) ([Ilya Golshtein](https://github.com/ilejn)).
+
+#### Performance Improvement
+* Compress marks and primary key by default. It significantly reduces the cold query time. Upgrade notes: the support for compressed marks and primary key has been added in version 22.9. If you turned on compressed marks or primary key or installed version 23.5 or newer, which has compressed marks or primary key on by default, you will not be able to downgrade to version 22.8 or earlier. You can also explicitly disable compressed marks or primary keys by specifying the `compress_marks` and `compress_primary_key` settings in the `<merge_tree>` section of the server configuration file. [#42587](https://github.com/ClickHouse/ClickHouse/pull/42587) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* New setting s3_max_inflight_parts_for_one_file sets the limit of concurrently loaded parts with multipart upload request in scope of one file. [#49961](https://github.com/ClickHouse/ClickHouse/pull/49961) ([Sema Checherinda](https://github.com/CheSema)).
+* When reading from multiple files reduce parallel parsing threads for each file. Resolves [#42192](https://github.com/ClickHouse/ClickHouse/issues/42192). [#46661](https://github.com/ClickHouse/ClickHouse/pull/46661) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Use aggregate projection only if it reads fewer granules than normal reading. It should help in case if query hits the PK of the table, but not the projection. Fixes [#49150](https://github.com/ClickHouse/ClickHouse/issues/49150). [#49417](https://github.com/ClickHouse/ClickHouse/pull/49417) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Do not store blocks in `ANY` hash join if nothing is inserted. [#48633](https://github.com/ClickHouse/ClickHouse/pull/48633) ([vdimir](https://github.com/vdimir)).
+* Fixes aggregate combinator `-If` when JIT compiled, and enable JIT compilation for aggregate functions. Closes [#48120](https://github.com/ClickHouse/ClickHouse/issues/48120). [#49083](https://github.com/ClickHouse/ClickHouse/pull/49083) ([Igor Nikonov](https://github.com/devcrafter)).
+* For reading from remote tables we use smaller tasks (instead of reading the whole part) to make tasks stealing work * task size is determined by size of columns to read * always use 1mb buffers for reading from s3 * boundaries of cache segments aligned to 1mb so they have decent size even with small tasks. it also should prevent fragmentation. [#49287](https://github.com/ClickHouse/ClickHouse/pull/49287) ([Nikita Taranov](https://github.com/nickitat)).
+* Introduced settings: - `merge_max_block_size_bytes` to limit the amount of memory used for background operations. - `vertical_merge_algorithm_min_bytes_to_activate` to add another condition to activate vertical merges. [#49313](https://github.com/ClickHouse/ClickHouse/pull/49313) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Default size of a read buffer for reading from local filesystem changed to a slightly better value. Also two new settings are introduced: `max_read_buffer_size_local_fs` and `max_read_buffer_size_remote_fs`. [#49321](https://github.com/ClickHouse/ClickHouse/pull/49321) ([Nikita Taranov](https://github.com/nickitat)).
+* Improve memory usage and speed of `SPARSE_HASHED`/`HASHED` dictionaries (e.g. `SPARSE_HASHED` now eats 2.6x less memory, and is ~2x faster). [#49380](https://github.com/ClickHouse/ClickHouse/pull/49380) ([Azat Khuzhin](https://github.com/azat)).
+* Optimize the `system.query_log` and `system.query_thread_log` tables by applying `LowCardinality` when appropriate. The queries over these tables will be faster. [#49530](https://github.com/ClickHouse/ClickHouse/pull/49530) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Better performance when reading local `Parquet` files (through parallel reading). [#49539](https://github.com/ClickHouse/ClickHouse/pull/49539) ([Michael Kolupaev](https://github.com/al13n321)).
+* Improve the performance of `RIGHT/FULL JOIN` by up to 2 times in certain scenarios, especially when joining a small left table with a large right table. [#49585](https://github.com/ClickHouse/ClickHouse/pull/49585) ([lgbo](https://github.com/lgbo-ustc)).
+* Improve performance of BLAKE3 by 11% by enabling LTO for Rust. [#49600](https://github.com/ClickHouse/ClickHouse/pull/49600) ([Azat Khuzhin](https://github.com/azat)). Now it is on par with C++.
+* Optimize the structure of the `system.opentelemetry_span_log`. Use `LowCardinality` where appropriate. Although this table is generally stupid (it is using the Map data type even for common attributes), it will be slightly better. [#49647](https://github.com/ClickHouse/ClickHouse/pull/49647) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Try to reserve hash table's size in `grace_hash` join. [#49816](https://github.com/ClickHouse/ClickHouse/pull/49816) ([lgbo](https://github.com/lgbo-ustc)).
+* As is addresed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as `toYear`, `toYYYYMM`, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. The [prototype](https://github.com/ZhiguoZh/ClickHouse/commit/c7f1753f0c9363a19d95fa46f1cfed1d9f505ee0) shows that, with all identified date converters optimized, the overall QPS of the 13 queries is enhanced by **~11%** on the ICX server (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads). [#50062](https://github.com/ClickHouse/ClickHouse/pull/50062) [#50307](https://github.com/ClickHouse/ClickHouse/pull/50307) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
+* Parallel merge of `uniqExactIf` states. Closes [#49885](https://github.com/ClickHouse/ClickHouse/issues/49885). [#50285](https://github.com/ClickHouse/ClickHouse/pull/50285) ([flynn](https://github.com/ucasfl)).
+* Keeper improvement: add `CheckNotExists` request to Keeper, which allows to improve the performance of Replicated tables. [#48897](https://github.com/ClickHouse/ClickHouse/pull/48897) ([Antonio Andelic](https://github.com/antonio2368)).
+* Keeper performance improvements: avoid serializing same request twice while processing. Cache deserialization results of large requests. Controlled by new coordination setting `min_request_size_for_cache`. [#49004](https://github.com/ClickHouse/ClickHouse/pull/49004) ([Antonio Andelic](https://github.com/antonio2368)).
+* Reduced number of `List` ZooKeeper requests when selecting parts to merge and a lot of partitions do not have anything to merge. [#49637](https://github.com/ClickHouse/ClickHouse/pull/49637) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Rework locking in the FS cache [#44985](https://github.com/ClickHouse/ClickHouse/pull/44985) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Disable pure parallel replicas if trivial count optimization is possible. [#50594](https://github.com/ClickHouse/ClickHouse/pull/50594) ([Raúl Marín](https://github.com/Algunenano)).
+* Don't send head request for all keys in Iceberg schema inference, only for keys that are used for reaing data. [#50203](https://github.com/ClickHouse/ClickHouse/pull/50203) ([Kruglov Pavel](https://github.com/Avogar)).
+* Setting `enable_memory_bound_merging_of_aggregation_results` is enabled by default. [#50319](https://github.com/ClickHouse/ClickHouse/pull/50319) ([Nikita Taranov](https://github.com/nickitat)).
+
+#### Experimental Feature
+* `DEFLATE_QPL` codec lower the minimum simd version to SSE 4.2. [doc change in qpl](https://github.com/intel/qpl/commit/3f8f5cea27739f5261e8fd577dc233ffe88bf679) - Intel® QPL relies on a run-time kernels dispatcher and cpuid check to choose the best available implementation(sse/avx2/avx512) - restructured cmakefile for qpl build in clickhouse to align with latest upstream qpl. [#49811](https://github.com/ClickHouse/ClickHouse/pull/49811) ([jasperzhu](https://github.com/jinjunzh)).
+* Add initial support to do JOINs with pure parallel replicas. [#49544](https://github.com/ClickHouse/ClickHouse/pull/49544) ([Raúl Marín](https://github.com/Algunenano)).
+* More parallelism on `Outdated` parts removal with "zero-copy replication". [#49630](https://github.com/ClickHouse/ClickHouse/pull/49630) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Parallel Replicas: 1) Fixed an error `NOT_FOUND_COLUMN_IN_BLOCK` in case of using parallel replicas with non-replicated storage with disabled setting `parallel_replicas_for_non_replicated_merge_tree` 2) Now `allow_experimental_parallel_reading_from_replicas` have 3 possible values - 0, 1 and 2. 0 - disabled, 1 - enabled, silently disable them in case of failure (in case of FINAL or JOIN), 2 - enabled, throw an expection in case of failure. 3) If FINAL modifier is used in SELECT query and parallel replicas are enabled, ClickHouse will try to disable them if `allow_experimental_parallel_reading_from_replicas` is set to 1 and throw an exception otherwise. [#50195](https://github.com/ClickHouse/ClickHouse/pull/50195) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* When parallel replicas are enabled they will always skip unavailable servers (the behavior is controlled by the setting `skip_unavailable_shards`, enabled by default and can be only disabled). This closes: [#48565](https://github.com/ClickHouse/ClickHouse/issues/48565). [#50293](https://github.com/ClickHouse/ClickHouse/pull/50293) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+
+#### Improvement
+* The `BACKUP` command will not decrypt data from encrypted disks while making a backup. Instead the data will be stored in a backup in encrypted form. Such backups can be restored only to an encrypted disk with the same (or extended) list of encryption keys. [#48896](https://github.com/ClickHouse/ClickHouse/pull/48896) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Added possibility to use temporary tables in FROM part of ATTACH PARTITION FROM and REPLACE PARTITION FROM. [#49436](https://github.com/ClickHouse/ClickHouse/pull/49436) ([Roman Vasin](https://github.com/rvasin)).
+* Added setting `async_insert` for `MergeTree` tables. It has the same meaning as query-level setting `async_insert` and enables asynchronous inserts for specific table. Note: it doesn't take effect for insert queries from `clickhouse-client`, use query-level setting in that case. [#49122](https://github.com/ClickHouse/ClickHouse/pull/49122) ([Anton Popov](https://github.com/CurtizJ)).
+* Add support for size suffixes in quota creation statement parameters. [#49087](https://github.com/ClickHouse/ClickHouse/pull/49087) ([Eridanus](https://github.com/Eridanus117)).
+* Extend `first_value` and `last_value` to accept NULL. [#46467](https://github.com/ClickHouse/ClickHouse/pull/46467) ([lgbo](https://github.com/lgbo-ustc)).
+* Add alias `str_to_map` and `mapFromString` for `extractKeyValuePairs`. closes https://github.com/clickhouse/clickhouse/issues/47185. [#49466](https://github.com/ClickHouse/ClickHouse/pull/49466) ([flynn](https://github.com/ucasfl)).
+* Add support for CGroup version 2 for asynchronous metrics about the memory usage and availability. This closes [#37983](https://github.com/ClickHouse/ClickHouse/issues/37983). [#45999](https://github.com/ClickHouse/ClickHouse/pull/45999) ([sichenzhao](https://github.com/sichenzhao)).
+* Cluster table functions should always skip unavailable shards. close [#46314](https://github.com/ClickHouse/ClickHouse/issues/46314). [#46765](https://github.com/ClickHouse/ClickHouse/pull/46765) ([zk_kiger](https://github.com/zk-kiger)).
+* Allow CSV file to contain empty columns in its header. [#47496](https://github.com/ClickHouse/ClickHouse/pull/47496) ([你不要过来啊](https://github.com/iiiuwioajdks)).
+* Add Google Cloud Storage S3 compatible table function `gcs`. Like the `oss` and `cosn` functions, it is just an alias over the `s3` table function, and it does not bring any new features. [#47815](https://github.com/ClickHouse/ClickHouse/pull/47815) ([Kuba Kaflik](https://github.com/jkaflik)).
+* Add ability to use strict parts size for S3 (compatibility with CloudFlare R2 S3 Storage). [#48492](https://github.com/ClickHouse/ClickHouse/pull/48492) ([Azat Khuzhin](https://github.com/azat)).
+* Added new columns with info about `Replicated` database replicas to `system.clusters`: `database_shard_name`, `database_replica_name`, `is_active`. Added an optional `FROM SHARD` clause to `SYSTEM DROP DATABASE REPLICA` query. [#48548](https://github.com/ClickHouse/ClickHouse/pull/48548) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Add a new column `zookeeper_name` in system.replicas, to indicate on which (auxiliary) zookeeper cluster the replicated table's metadata is stored. [#48549](https://github.com/ClickHouse/ClickHouse/pull/48549) ([cangyin](https://github.com/cangyin)).
+* `IN` operator support the comparison of `Date` and `Date32`. Closes [#48736](https://github.com/ClickHouse/ClickHouse/issues/48736). [#48806](https://github.com/ClickHouse/ClickHouse/pull/48806) ([flynn](https://github.com/ucasfl)).
+* Support for erasure codes in `HDFS`, author: @M1eyu2018, @tomscut. [#48833](https://github.com/ClickHouse/ClickHouse/pull/48833) ([M1eyu](https://github.com/M1eyu2018)).
+* Implement SYSTEM DROP REPLICA from auxillary ZooKeeper clusters, may be close [#48931](https://github.com/ClickHouse/ClickHouse/issues/48931). [#48932](https://github.com/ClickHouse/ClickHouse/pull/48932) ([wangxiaobo](https://github.com/wzb5212)).
+* Add Array data type to MongoDB. Closes [#48598](https://github.com/ClickHouse/ClickHouse/issues/48598). [#48983](https://github.com/ClickHouse/ClickHouse/pull/48983) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Support storing `Interval` data types in tables. [#49085](https://github.com/ClickHouse/ClickHouse/pull/49085) ([larryluogit](https://github.com/larryluogit)).
+* Allow using `ntile` window function without explicit window frame definition: `ntile(3) OVER (ORDER BY a)`, close [#46763](https://github.com/ClickHouse/ClickHouse/issues/46763). [#49093](https://github.com/ClickHouse/ClickHouse/pull/49093) ([vdimir](https://github.com/vdimir)).
+* Added settings (`number_of_mutations_to_delay`, `number_of_mutations_to_throw`) to delay or throw `ALTER` queries that create mutations (`ALTER UPDATE`, `ALTER DELETE`, `ALTER MODIFY COLUMN`, ...) in case when table already has a lot of unfinished mutations. [#49117](https://github.com/ClickHouse/ClickHouse/pull/49117) ([Anton Popov](https://github.com/CurtizJ)).
+* Catch exception from `create_directories` in filesystem cache. [#49203](https://github.com/ClickHouse/ClickHouse/pull/49203) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Copies embedded examples to a new field `example` in `system.functions` to supplement the field `description`. [#49222](https://github.com/ClickHouse/ClickHouse/pull/49222) ([Dan Roscigno](https://github.com/DanRoscigno)).
+* Enable connection options for the MongoDB dictionary. Example: ``` xml <source> <mongodb> <host>localhost</host> <port>27017</port> <user></user> <password></password> <db>test</db> <collection>dictionary_source</collection> <options>ssl=true</options> </mongodb> </source> ``` ### Documentation entry for user-facing changes. [#49225](https://github.com/ClickHouse/ClickHouse/pull/49225) ([MikhailBurdukov](https://github.com/MikhailBurdukov)).
+* Added an alias `asymptotic` for `asymp` computational method for `kolmogorovSmirnovTest`. Improved documentation. [#49286](https://github.com/ClickHouse/ClickHouse/pull/49286) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Aggregation function groupBitAnd/Or/Xor now work on signed integer data. This makes them consistent with the behavior of scalar functions bitAnd/Or/Xor. [#49292](https://github.com/ClickHouse/ClickHouse/pull/49292) ([exmy](https://github.com/exmy)).
+* Split function-documentation into more fine-granular fields. [#49300](https://github.com/ClickHouse/ClickHouse/pull/49300) ([Robert Schulze](https://github.com/rschu1ze)).
+* Use multiple threads shared between all tables within a server to load outdated data parts. The the size of the pool and its queue is controlled by `max_outdated_parts_loading_thread_pool_size` and `outdated_part_loading_thread_pool_queue_size` settings. [#49317](https://github.com/ClickHouse/ClickHouse/pull/49317) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Don't overestimate the size of processed data for `LowCardinality` columns when they share dictionaries between blocks. This closes [#49322](https://github.com/ClickHouse/ClickHouse/issues/49322). See also [#48745](https://github.com/ClickHouse/ClickHouse/issues/48745). [#49323](https://github.com/ClickHouse/ClickHouse/pull/49323) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Parquet writer now uses reasonable row group size when invoked through `OUTFILE`. [#49325](https://github.com/ClickHouse/ClickHouse/pull/49325) ([Michael Kolupaev](https://github.com/al13n321)).
+* Allow restricted keywords like `ARRAY` as an alias if the alias is quoted. Closes [#49324](https://github.com/ClickHouse/ClickHouse/issues/49324). [#49360](https://github.com/ClickHouse/ClickHouse/pull/49360) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Data parts loading and deletion jobs were moved to shared server-wide pools instead of per-table pools. Pools sizes are controlled via settings `max_active_parts_loading_thread_pool_size`, `max_outdated_parts_loading_thread_pool_size` and `max_parts_cleaning_thread_pool_size` in top-level config. Table-level settings `max_part_loading_threads` and `max_part_removal_threads` became obsolete. [#49474](https://github.com/ClickHouse/ClickHouse/pull/49474) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Allow `?password=pass` in URL of the Play UI. Password is replaced in browser history. [#49505](https://github.com/ClickHouse/ClickHouse/pull/49505) ([Mike Kot](https://github.com/myrrc)).
+* Allow reading zero-size objects from remote filesystems. (because empty files are not backup'd, so we might end up with zero blobs in metadata file). Closes [#49480](https://github.com/ClickHouse/ClickHouse/issues/49480). [#49519](https://github.com/ClickHouse/ClickHouse/pull/49519) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Attach thread MemoryTracker to `total_memory_tracker` after `ThreadGroup` detached. [#49527](https://github.com/ClickHouse/ClickHouse/pull/49527) ([Dmitry Novik](https://github.com/novikd)).
+* Fix parameterized views when a query parameter is used multiple times in the query. [#49556](https://github.com/ClickHouse/ClickHouse/pull/49556) ([Azat Khuzhin](https://github.com/azat)).
+* Release memory allocated for the last sent ProfileEvents snapshot in the context of a query. Followup [#47564](https://github.com/ClickHouse/ClickHouse/issues/47564). [#49561](https://github.com/ClickHouse/ClickHouse/pull/49561) ([Dmitry Novik](https://github.com/novikd)).
+* Function "makeDate" now provides a MySQL-compatible overload (year & day of the year argument). [#49603](https://github.com/ClickHouse/ClickHouse/pull/49603) ([Robert Schulze](https://github.com/rschu1ze)).
+* Support `dictionary` table function for `RegExpTreeDictionary`. [#49666](https://github.com/ClickHouse/ClickHouse/pull/49666) ([Han Fei](https://github.com/hanfei1991)).
+* Added weighted fair IO scheduling policy. Added dynamic resource manager, which allows IO scheduling hierarchy to be updated in runtime w/o server restarts. [#49671](https://github.com/ClickHouse/ClickHouse/pull/49671) ([Sergei Trifonov](https://github.com/serxa)).
+* Add compose request after multipart upload to GCS. This enables the usage of copy operation on objects uploaded with the multipart upload. It's recommended to set `s3_strict_upload_part_size` to some value because compose request can fail on objects created with parts of different sizes. [#49693](https://github.com/ClickHouse/ClickHouse/pull/49693) ([Antonio Andelic](https://github.com/antonio2368)).
+* For the `extractKeyValuePairs` function: improve the "best-effort" parsing logic to accept `key_value_delimiter` as a valid part of the value. This also simplifies branching and might even speed up things a bit. [#49760](https://github.com/ClickHouse/ClickHouse/pull/49760) ([Arthur Passos](https://github.com/arthurpassos)).
+* Add `initial_query_id` field for system.processors_profile_log [#49777](https://github.com/ClickHouse/ClickHouse/pull/49777) ([helifu](https://github.com/helifu)).
+* System log tables can now have custom sorting keys. [#49778](https://github.com/ClickHouse/ClickHouse/pull/49778) ([helifu](https://github.com/helifu)).
+* A new field `partitions` to `system.query_log` is used to indicate which partitions are participating in the calculation. [#49779](https://github.com/ClickHouse/ClickHouse/pull/49779) ([helifu](https://github.com/helifu)).
+* Added `enable_the_endpoint_id_with_zookeeper_name_prefix` setting for `ReplicatedMergeTree` (disabled by default). When enabled, it adds ZooKeeper cluster name to table's interserver communication endpoint. It avoids `Duplicate interserver IO endpoint` errors when having replicated tables with the same path, but different auxiliary ZooKeepers. [#49780](https://github.com/ClickHouse/ClickHouse/pull/49780) ([helifu](https://github.com/helifu)).
+* Add query parameters to `clickhouse-local`. Closes [#46561](https://github.com/ClickHouse/ClickHouse/issues/46561). [#49785](https://github.com/ClickHouse/ClickHouse/pull/49785) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Allow loading dictionaries and functions from YAML by default. In previous versions, it required editing the `dictionaries_config` or `user_defined_executable_functions_config` in the configuration file, as they expected `*.xml` files. [#49812](https://github.com/ClickHouse/ClickHouse/pull/49812) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* The Kafka table engine now allows to use alias columns. [#49824](https://github.com/ClickHouse/ClickHouse/pull/49824) ([Aleksandr Musorin](https://github.com/AVMusorin)).
+* Add setting to limit the max number of pairs produced by `extractKeyValuePairs`, a safeguard to avoid using way too much memory. [#49836](https://github.com/ClickHouse/ClickHouse/pull/49836) ([Arthur Passos](https://github.com/arthurpassos)).
+* 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)).
+* `bitHammingDistance` function support `String` and `FixedString` data type. Closes [#48827](https://github.com/ClickHouse/ClickHouse/issues/48827). [#49858](https://github.com/ClickHouse/ClickHouse/pull/49858) ([flynn](https://github.com/ucasfl)).
+* Fix timeout resetting errors in the client on OS X. [#49863](https://github.com/ClickHouse/ClickHouse/pull/49863) ([alekar](https://github.com/alekar)).
+* Add support for big integers, such as UInt128, Int128, UInt256, and Int256 in the function `bitCount`. This enables Hamming distance over large bit masks for AI applications. [#49867](https://github.com/ClickHouse/ClickHouse/pull/49867) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fingerprints to be used instead of key IDs in encrypted disks. This simplifies the configuration of encrypted disks. [#49882](https://github.com/ClickHouse/ClickHouse/pull/49882) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Add UUID data type to PostgreSQL. Closes [#49739](https://github.com/ClickHouse/ClickHouse/issues/49739). [#49894](https://github.com/ClickHouse/ClickHouse/pull/49894) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Function `toUnixTimestamp` now accepts `Date` and `Date32` arguments. [#49989](https://github.com/ClickHouse/ClickHouse/pull/49989) ([Victor Krasnov](https://github.com/sirvickr)).
+* Charge only server memory for dictionaries. [#49995](https://github.com/ClickHouse/ClickHouse/pull/49995) ([Azat Khuzhin](https://github.com/azat)).
+* The server will allow using the `SQL_*` settings such as `SQL_AUTO_IS_NULL` as no-ops for MySQL compatibility. This closes [#49927](https://github.com/ClickHouse/ClickHouse/issues/49927). [#50013](https://github.com/ClickHouse/ClickHouse/pull/50013) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Preserve initial_query_id for ON CLUSTER queries, which is useful for introspection (under `distributed_ddl_entry_format_version=5`). [#50015](https://github.com/ClickHouse/ClickHouse/pull/50015) ([Azat Khuzhin](https://github.com/azat)).
+* Preserve backward incompatibility for renamed settings by using aliases (`allow_experimental_projection_optimization` for `optimize_use_projections`, `allow_experimental_lightweight_delete` for `enable_lightweight_delete`). [#50044](https://github.com/ClickHouse/ClickHouse/pull/50044) ([Azat Khuzhin](https://github.com/azat)).
+* Support passing FQDN through setting my_hostname to register cluster node in keeper. Add setting of invisible to support multi compute groups. A compute group as a cluster, is invisible to other compute groups. [#50186](https://github.com/ClickHouse/ClickHouse/pull/50186) ([Yangkuan Liu](https://github.com/LiuYangkuan)).
+* Fix PostgreSQL reading all the data even though `LIMIT n` could be specified. [#50187](https://github.com/ClickHouse/ClickHouse/pull/50187) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Add new profile events for queries with subqueries (`QueriesWithSubqueries`/`SelectQueriesWithSubqueries`/`InsertQueriesWithSubqueries`). [#50204](https://github.com/ClickHouse/ClickHouse/pull/50204) ([Azat Khuzhin](https://github.com/azat)).
+* Adding the roles field in the users.xml file, which allows specifying roles with grants via a config file. [#50278](https://github.com/ClickHouse/ClickHouse/pull/50278) ([pufit](https://github.com/pufit)).
+* Report `CGroupCpuCfsPeriod` and `CGroupCpuCfsQuota` in AsynchronousMetrics. - Respect cgroup v2 memory limits during server startup. [#50379](https://github.com/ClickHouse/ClickHouse/pull/50379) ([alekar](https://github.com/alekar)).
+* Add a signal handler for SIGQUIT to work the same way as SIGINT. Closes [#50298](https://github.com/ClickHouse/ClickHouse/issues/50298). [#50435](https://github.com/ClickHouse/ClickHouse/pull/50435) ([Nikolay Degterinsky](https://github.com/evillique)).
+* In case JSON parse fails due to the large size of the object output the last position to allow debugging. [#50474](https://github.com/ClickHouse/ClickHouse/pull/50474) ([Valentin Alexeev](https://github.com/valentinalexeev)).
+* Support decimals with not fixed size. Closes [#49130](https://github.com/ClickHouse/ClickHouse/issues/49130). [#50586](https://github.com/ClickHouse/ClickHouse/pull/50586) ([Kruglov Pavel](https://github.com/Avogar)).
+
+#### Build/Testing/Packaging Improvement
+* New and improved `keeper-bench`. Everything can be customized from YAML/XML file: - request generator - each type of request generator can have a specific set of fields - multi requests can be generated just by doing the same under `multi` key - for each request or subrequest in multi a `weight` field can be defined to control distribution - define trees that need to be setup for a test run - hosts can be defined with all timeouts customizable and it's possible to control how many sessions to generate for each host - integers defined with `min_value` and `max_value` fields are random number generators. [#48547](https://github.com/ClickHouse/ClickHouse/pull/48547) ([Antonio Andelic](https://github.com/antonio2368)).
+* Io_uring is not supported on macos, don't choose it when running tests on local to avoid occassional failures. [#49250](https://github.com/ClickHouse/ClickHouse/pull/49250) ([Frank Chen](https://github.com/FrankChen021)).
+* Support named fault injection for testing. [#49361](https://github.com/ClickHouse/ClickHouse/pull/49361) ([Han Fei](https://github.com/hanfei1991)).
+* Allow running ClickHouse in the OS where the `prctl` (process control) syscall is not available, such as AWS Lambda. [#49538](https://github.com/ClickHouse/ClickHouse/pull/49538) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fixed the issue of build conflict between contrib/isa-l and isa-l in qpl [49296](https://github.com/ClickHouse/ClickHouse/issues/49296). [#49584](https://github.com/ClickHouse/ClickHouse/pull/49584) ([jasperzhu](https://github.com/jinjunzh)).
+* Utilities are now only build if explicitly requested ("-DENABLE_UTILS=1") instead of by default, this reduces link times in typical development builds. [#49620](https://github.com/ClickHouse/ClickHouse/pull/49620) ([Robert Schulze](https://github.com/rschu1ze)).
+* Pull build description of idxd-config into a separate CMake file to avoid accidental removal in future. [#49651](https://github.com/ClickHouse/ClickHouse/pull/49651) ([jasperzhu](https://github.com/jinjunzh)).
+* Add CI check with an enabled analyzer in the master. Follow-up [#49562](https://github.com/ClickHouse/ClickHouse/issues/49562). [#49668](https://github.com/ClickHouse/ClickHouse/pull/49668) ([Dmitry Novik](https://github.com/novikd)).
+* Switch to LLVM/clang 16. [#49678](https://github.com/ClickHouse/ClickHouse/pull/49678) ([Azat Khuzhin](https://github.com/azat)).
+* Allow building ClickHouse with clang-17. [#49851](https://github.com/ClickHouse/ClickHouse/pull/49851) ([Alexey Milovidov](https://github.com/alexey-milovidov)). [#50410](https://github.com/ClickHouse/ClickHouse/pull/50410) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* ClickHouse is now easier to be integrated into other cmake projects. [#49991](https://github.com/ClickHouse/ClickHouse/pull/49991) ([Amos Bird](https://github.com/amosbird)). (Which is strongly discouraged - Alexey Milovidov).
+* Fix strange additional QEMU logging after [#47151](https://github.com/ClickHouse/ClickHouse/issues/47151), see https://s3.amazonaws.com/clickhouse-test-reports/50078/a4743996ee4f3583884d07bcd6501df0cfdaa346/stateless_tests__release__databasereplicated__[3_4].html. [#50442](https://github.com/ClickHouse/ClickHouse/pull/50442) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* ClickHouse can work on Linux RISC-V 6.1.22. This closes [#50456](https://github.com/ClickHouse/ClickHouse/issues/50456). [#50457](https://github.com/ClickHouse/ClickHouse/pull/50457) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Bump internal protobuf to v3.18 (fixes bogus CVE-2022-1941). [#50400](https://github.com/ClickHouse/ClickHouse/pull/50400) ([Robert Schulze](https://github.com/rschu1ze)).
+* Bump internal libxml2 to v2.10.4 (fixes bogus CVE-2023-28484 and bogus CVE-2023-29469). [#50402](https://github.com/ClickHouse/ClickHouse/pull/50402) ([Robert Schulze](https://github.com/rschu1ze)).
+* Bump c-ares to v1.19.1 (bogus CVE-2023-32067, bogus CVE-2023-31130, bogus CVE-2023-31147). [#50403](https://github.com/ClickHouse/ClickHouse/pull/50403) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix bogus CVE-2022-2469 in libgsasl. [#50404](https://github.com/ClickHouse/ClickHouse/pull/50404) ([Robert Schulze](https://github.com/rschu1ze)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* ActionsDAG: fix wrong optimization [#47584](https://github.com/ClickHouse/ClickHouse/pull/47584) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+* Correctly handle concurrent snapshots in Keeper [#48466](https://github.com/ClickHouse/ClickHouse/pull/48466) ([Antonio Andelic](https://github.com/antonio2368)).
+* MergeTreeMarksLoader holds DataPart instead of DataPartStorage [#48515](https://github.com/ClickHouse/ClickHouse/pull/48515) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Sequence state fix [#48603](https://github.com/ClickHouse/ClickHouse/pull/48603) ([Ilya Golshtein](https://github.com/ilejn)).
+* Back/Restore concurrency check on previous fails [#48726](https://github.com/ClickHouse/ClickHouse/pull/48726) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix Attaching a table with non-existent ZK path does not increase the ReadonlyReplica metric [#48954](https://github.com/ClickHouse/ClickHouse/pull/48954) ([wangxiaobo](https://github.com/wzb5212)).
+* Fix possible terminate called for uncaught exception in some places [#49112](https://github.com/ClickHouse/ClickHouse/pull/49112) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix key not found error for queries with multiple StorageJoin [#49137](https://github.com/ClickHouse/ClickHouse/pull/49137) ([vdimir](https://github.com/vdimir)).
+* Fix wrong query result when using nullable primary key [#49172](https://github.com/ClickHouse/ClickHouse/pull/49172) ([Duc Canh Le](https://github.com/canhld94)).
+* Fix reinterpretAs*() on big endian machines [#49198](https://github.com/ClickHouse/ClickHouse/pull/49198) ([Suzy Wang](https://github.com/SuzyWangIBMer)).
+* (Experimental zero-copy replication) Lock zero copy parts more atomically [#49211](https://github.com/ClickHouse/ClickHouse/pull/49211) ([alesapin](https://github.com/alesapin)).
+* Fix race on Outdated parts loading [#49223](https://github.com/ClickHouse/ClickHouse/pull/49223) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix all key value is null and group use rollup return wrong answer [#49282](https://github.com/ClickHouse/ClickHouse/pull/49282) ([Shuai li](https://github.com/loneylee)).
+* Fix calculating load_factor for HASHED dictionaries with SHARDS [#49319](https://github.com/ClickHouse/ClickHouse/pull/49319) ([Azat Khuzhin](https://github.com/azat)).
+* Disallow configuring compression CODECs for alias columns [#49363](https://github.com/ClickHouse/ClickHouse/pull/49363) ([Timur Solodovnikov](https://github.com/tsolodov)).
+* Fix bug in removal of existing part directory [#49365](https://github.com/ClickHouse/ClickHouse/pull/49365) ([alesapin](https://github.com/alesapin)).
+* Properly fix GCS when HMAC is used [#49390](https://github.com/ClickHouse/ClickHouse/pull/49390) ([Antonio Andelic](https://github.com/antonio2368)).
+* 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)).
+* Invert `shutdown_wait_unfinished_queries` [#49427](https://github.com/ClickHouse/ClickHouse/pull/49427) ([Konstantin Bogdanov](https://github.com/thevar1able)).
+* (Experimental zero-copy replication) Fix another zero copy bug [#49473](https://github.com/ClickHouse/ClickHouse/pull/49473) ([alesapin](https://github.com/alesapin)).
+* Fix postgres database setting [#49481](https://github.com/ClickHouse/ClickHouse/pull/49481) ([Mal Curtis](https://github.com/snikch)).
+* Correctly handle `s3Cluster` arguments [#49490](https://github.com/ClickHouse/ClickHouse/pull/49490) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix bug in TraceCollector destructor. [#49508](https://github.com/ClickHouse/ClickHouse/pull/49508) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Fix AsynchronousReadIndirectBufferFromRemoteFS breaking on short seeks [#49525](https://github.com/ClickHouse/ClickHouse/pull/49525) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix dictionaries loading order [#49560](https://github.com/ClickHouse/ClickHouse/pull/49560) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Forbid the change of data type of Object('json') column [#49563](https://github.com/ClickHouse/ClickHouse/pull/49563) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Fix stress test (Logical error: Expected 7134 >= 11030) [#49623](https://github.com/ClickHouse/ClickHouse/pull/49623) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix bug in DISTINCT [#49628](https://github.com/ClickHouse/ClickHouse/pull/49628) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix: DISTINCT in order with zero values in non-sorted columns [#49636](https://github.com/ClickHouse/ClickHouse/pull/49636) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix one-off error in big integers found by UBSan with fuzzer [#49645](https://github.com/ClickHouse/ClickHouse/pull/49645) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix reading from sparse columns after restart [#49660](https://github.com/ClickHouse/ClickHouse/pull/49660) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix assert in SpanHolder::finish() with fibers [#49673](https://github.com/ClickHouse/ClickHouse/pull/49673) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix short circuit functions and mutations with sparse arguments [#49716](https://github.com/ClickHouse/ClickHouse/pull/49716) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix writing appended files to incremental backups [#49725](https://github.com/ClickHouse/ClickHouse/pull/49725) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Ignore LWD column in checkPartDynamicColumns [#49737](https://github.com/ClickHouse/ClickHouse/pull/49737) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix msan issue in randomStringUTF8(uneven number) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix aggregate function kolmogorovSmirnovTest [#49768](https://github.com/ClickHouse/ClickHouse/pull/49768) ([FFFFFFFHHHHHHH](https://github.com/FFFFFFFHHHHHHH)).
+* Fix settings aliases in native protocol [#49776](https://github.com/ClickHouse/ClickHouse/pull/49776) ([Azat Khuzhin](https://github.com/azat)).
+* Fix `arrayMap` with array of tuples with single argument [#49789](https://github.com/ClickHouse/ClickHouse/pull/49789) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix per-query IO/BACKUPs throttling settings [#49797](https://github.com/ClickHouse/ClickHouse/pull/49797) ([Azat Khuzhin](https://github.com/azat)).
+* Fix setting NULL in profile definition [#49831](https://github.com/ClickHouse/ClickHouse/pull/49831) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Fix a bug with projections and the aggregate_functions_null_for_empty setting (for query_plan_optimize_projection) [#49873](https://github.com/ClickHouse/ClickHouse/pull/49873) ([Amos Bird](https://github.com/amosbird)).
+* Fix processing pending batch for Distributed async INSERT after restart [#49884](https://github.com/ClickHouse/ClickHouse/pull/49884) ([Azat Khuzhin](https://github.com/azat)).
+* Fix assertion in CacheMetadata::doCleanup [#49914](https://github.com/ClickHouse/ClickHouse/pull/49914) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* fix `is_prefix` in OptimizeRegularExpression [#49919](https://github.com/ClickHouse/ClickHouse/pull/49919) ([Han Fei](https://github.com/hanfei1991)).
+* Fix metrics `WriteBufferFromS3Bytes`, `WriteBufferFromS3Microseconds` and `WriteBufferFromS3RequestsErrors` [#49930](https://github.com/ClickHouse/ClickHouse/pull/49930) ([Aleksandr Musorin](https://github.com/AVMusorin)).
+* Fix IPv6 encoding in protobuf [#49933](https://github.com/ClickHouse/ClickHouse/pull/49933) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Fix possible Logical error on bad Nullable parsing for text formats [#49960](https://github.com/ClickHouse/ClickHouse/pull/49960) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add setting output_format_parquet_compliant_nested_types to produce more compatible Parquet files [#50001](https://github.com/ClickHouse/ClickHouse/pull/50001) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix logical error in stress test "Not enough space to add ..." [#50021](https://github.com/ClickHouse/ClickHouse/pull/50021) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* 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)).
+* Add proper escaping for DDL OpenTelemetry context serialization [#50045](https://github.com/ClickHouse/ClickHouse/pull/50045) ([Azat Khuzhin](https://github.com/azat)).
+* Fix reporting broken projection parts [#50052](https://github.com/ClickHouse/ClickHouse/pull/50052) ([Amos Bird](https://github.com/amosbird)).
+* 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 invalid index analysis for date related keys [#50153](https://github.com/ClickHouse/ClickHouse/pull/50153) ([Amos Bird](https://github.com/amosbird)).
+* do not allow modify order by when there are no order by cols [#50154](https://github.com/ClickHouse/ClickHouse/pull/50154) ([Han Fei](https://github.com/hanfei1991)).
+* 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)).
+* clickhouse-client: disallow usage of `--query` and `--queries-file` at the same time [#50210](https://github.com/ClickHouse/ClickHouse/pull/50210) ([Alexey Gerasimchuk](https://github.com/Demilivor)).
+* Fix UB for INTO OUTFILE extensions (APPEND / AND STDOUT) and WATCH EVENTS [#50216](https://github.com/ClickHouse/ClickHouse/pull/50216) ([Azat Khuzhin](https://github.com/azat)).
+* Fix skipping spaces at end of row in CustomSeparatedIgnoreSpaces format [#50224](https://github.com/ClickHouse/ClickHouse/pull/50224) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix iceberg metadata parsing [#50232](https://github.com/ClickHouse/ClickHouse/pull/50232) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix nested distributed SELECT in WITH clause [#50234](https://github.com/ClickHouse/ClickHouse/pull/50234) ([Azat Khuzhin](https://github.com/azat)).
+* Fix msan issue in keyed siphash [#50245](https://github.com/ClickHouse/ClickHouse/pull/50245) ([Robert Schulze](https://github.com/rschu1ze)).
+* 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)).
+* Fix checksum calculation for backup entries [#50264](https://github.com/ClickHouse/ClickHouse/pull/50264) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Comparison functions NaN fix [#50287](https://github.com/ClickHouse/ClickHouse/pull/50287) ([Maksim Kita](https://github.com/kitaisreal)).
+* JIT aggregation nullable key fix [#50291](https://github.com/ClickHouse/ClickHouse/pull/50291) ([Maksim Kita](https://github.com/kitaisreal)).
+* Fix clickhouse-local crashing when writing empty Arrow or Parquet output [#50328](https://github.com/ClickHouse/ClickHouse/pull/50328) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix crash when Pool::Entry::disconnect() is called [#50334](https://github.com/ClickHouse/ClickHouse/pull/50334) ([Val Doroshchuk](https://github.com/valbok)).
+* Improved fetch part by holding directory lock longer [#50339](https://github.com/ClickHouse/ClickHouse/pull/50339) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix bitShift* functions with both constant arguments [#50343](https://github.com/ClickHouse/ClickHouse/pull/50343) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+* Fix hashing of const integer values [#50421](https://github.com/ClickHouse/ClickHouse/pull/50421) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix merge_tree_min_rows_for_seek/merge_tree_min_bytes_for_seek for data skipping indexes [#50432](https://github.com/ClickHouse/ClickHouse/pull/50432) ([Azat Khuzhin](https://github.com/azat)).
+* Limit the number of in-flight tasks for loading outdated parts [#50450](https://github.com/ClickHouse/ClickHouse/pull/50450) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Keeper fix: apply uncommitted state after snapshot install [#50483](https://github.com/ClickHouse/ClickHouse/pull/50483) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix incorrect constant folding [#50536](https://github.com/ClickHouse/ClickHouse/pull/50536) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix logical error in stress test (Not enough space to add ...) [#50583](https://github.com/ClickHouse/ClickHouse/pull/50583) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix converting Null to LowCardinality(Nullable) in values table function [#50637](https://github.com/ClickHouse/ClickHouse/pull/50637) ([Kruglov Pavel](https://github.com/Avogar)).
+* Revert invalid RegExpTreeDictionary optimization [#50642](https://github.com/ClickHouse/ClickHouse/pull/50642) ([Johann Gan](https://github.com/johanngan)).
+
 ### <a id="234"></a> ClickHouse release 23.4, 2023-04-26
 
 #### Backward Incompatible Change

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 0616/1478] 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 0617/1478] 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 0618/1478] 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 c37b80593c0db79b064bf5e54a817ef90238a343 Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Thu, 8 Jun 2023 13:22:55 +0200
Subject: [PATCH 0619/1478] MaterializedMySQL: Add support of `TRUNCATE
 db.table` (#50624)

Additional to `TRUNCATE TABLE db.table`.

Co-authored-by: Alexander Tokmakov <tavplubix@clickhouse.com>
---
 src/Parsers/MySQL/ASTDropQuery.cpp            |  3 +-
 .../materialize_with_ddl.py                   | 40 +++++++++++++++++++
 2 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/src/Parsers/MySQL/ASTDropQuery.cpp b/src/Parsers/MySQL/ASTDropQuery.cpp
index fb76d93363a..890451e3e55 100644
--- a/src/Parsers/MySQL/ASTDropQuery.cpp
+++ b/src/Parsers/MySQL/ASTDropQuery.cpp
@@ -44,8 +44,9 @@ bool ParserDropQuery::parseImpl(IParser::Pos & pos, ASTPtr & node, Expected & ex
     bool if_exists = false;
     bool is_truncate = false;
 
-    if (s_truncate.ignore(pos, expected) && s_table.ignore(pos, expected))
+    if (s_truncate.ignore(pos, expected))
     {
+        s_table.ignore(pos, expected);
         is_truncate = true;
         query->kind = ASTDropQuery::Kind::Table;
         ASTDropQuery::QualifiedName name;
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 97e2de49ceb..2bbbe9a3f13 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
@@ -379,6 +379,46 @@ def drop_table_with_materialized_mysql_database(
         "",
     )
 
+    mysql_node.query(
+        "CREATE TABLE test_database_drop.test_table_3 (id INT NOT NULL PRIMARY KEY) ENGINE = InnoDB"
+    )
+    mysql_node.query("INSERT INTO test_database_drop.test_table_3 VALUES(1), (2)")
+    check_query(
+        clickhouse_node,
+        "SHOW TABLES FROM test_database_drop FORMAT TSV",
+        "test_table_2\ntest_table_3\n",
+    )
+    check_query(
+        clickhouse_node,
+        "SELECT * FROM test_database_drop.test_table_3 ORDER BY id FORMAT TSV",
+        "1\n2\n",
+    )
+    mysql_node.query("TRUNCATE test_database_drop.test_table_3")
+    check_query(
+        clickhouse_node,
+        "SELECT * FROM test_database_drop.test_table_3 ORDER BY id FORMAT TSV",
+        "",
+    )
+
+    mysql_node.query(
+        "CREATE TABLE test_database_drop.test_table_4 (id INT NOT NULL PRIMARY KEY) ENGINE = InnoDB"
+    )
+    mysql_node.query("INSERT INTO test_database_drop.test_table_4 VALUES(1), (2)")
+    check_query(
+        clickhouse_node,
+        "SELECT * FROM test_database_drop.test_table_4 ORDER BY id FORMAT TSV",
+        "1\n2\n",
+    )
+    with mysql_node.alloc_connection() as mysql:
+        mysql.query("USE test_database_drop")
+        mysql.query("TRUNCATE test_table_4")
+
+    check_query(
+        clickhouse_node,
+        "SELECT * FROM test_database_drop.test_table_4 ORDER BY id FORMAT TSV",
+        "",
+    )
+
     clickhouse_node.query("DROP DATABASE test_database_drop")
     mysql_node.query("DROP DATABASE test_database_drop")
 

From 6b49816079016e362110da78e4e8b660894e9b6a Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 8 Jun 2023 14:25:49 +0300
Subject: [PATCH 0620/1478] Update CHANGELOG.md

Co-authored-by: Alexander Gololobov <440544+davenger@users.noreply.github.com>
---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f2ffdad9a7c..959a7bad5dd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -210,7 +210,7 @@
 * Fix assert in SpanHolder::finish() with fibers [#49673](https://github.com/ClickHouse/ClickHouse/pull/49673) ([Kruglov Pavel](https://github.com/Avogar)).
 * Fix short circuit functions and mutations with sparse arguments [#49716](https://github.com/ClickHouse/ClickHouse/pull/49716) ([Anton Popov](https://github.com/CurtizJ)).
 * Fix writing appended files to incremental backups [#49725](https://github.com/ClickHouse/ClickHouse/pull/49725) ([Vitaly Baranov](https://github.com/vitlibar)).
-* Ignore LWD column in checkPartDynamicColumns [#49737](https://github.com/ClickHouse/ClickHouse/pull/49737) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix "There is no physical column _row_exists in table" error occurring during lightweight delete mutation on a table with Object column. [#49737](https://github.com/ClickHouse/ClickHouse/pull/49737) ([Alexander Gololobov](https://github.com/davenger)).
 * Fix msan issue in randomStringUTF8(uneven number) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
 * Fix aggregate function kolmogorovSmirnovTest [#49768](https://github.com/ClickHouse/ClickHouse/pull/49768) ([FFFFFFFHHHHHHH](https://github.com/FFFFFFFHHHHHHH)).
 * Fix settings aliases in native protocol [#49776](https://github.com/ClickHouse/ClickHouse/pull/49776) ([Azat Khuzhin](https://github.com/azat)).

From c6b2ed234dcde2802020f730dc84101d7ad84f65 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 8 Jun 2023 13:27:13 +0200
Subject: [PATCH 0621/1478] Fix typos

---
 CHANGELOG.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f2ffdad9a7c..c674af5852a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,7 +16,7 @@
 * The experimental feature "in-memory data parts" is removed. The data format is still supported, but the settings are no-op, and compact or wide parts will be used instead. This closes [#45409](https://github.com/ClickHouse/ClickHouse/issues/45409). [#49429](https://github.com/ClickHouse/ClickHouse/pull/49429) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Changed default values of settings `parallelize_output_from_storages` and `input_format_parquet_preserve_order`. This allows ClickHouse to reorder rows when reading from files (e.g. CSV or Parquet), greatly improving performance in many cases. To restore the old behavior of preserving order, use `parallelize_output_from_storages = 0`, `input_format_parquet_preserve_order = 1`. [#49479](https://github.com/ClickHouse/ClickHouse/pull/49479) ([Michael Kolupaev](https://github.com/al13n321)).
 * Make projections production-ready. Add the `optimize_use_projections` setting to control whether the projections will be selected for SELECT queries. The setting `allow_experimental_projection_optimization` is obsolete and does nothing. [#49719](https://github.com/ClickHouse/ClickHouse/pull/49719) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
-* Mark `joinGet` as non deterministic (so as `dictGet`). It allows using them in mutations without an extra setting. [#49843](https://github.com/ClickHouse/ClickHouse/pull/49843) ([Azat Khuzhin](https://github.com/azat)).
+* Mark `joinGet` as non-deterministic (so as `dictGet`). It allows using them in mutations without an extra setting. [#49843](https://github.com/ClickHouse/ClickHouse/pull/49843) ([Azat Khuzhin](https://github.com/azat)).
 * Revert the "`groupArray` returns cannot be nullable" change (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)).
 * 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)).
 
@@ -68,7 +68,7 @@
 * Improve performance of BLAKE3 by 11% by enabling LTO for Rust. [#49600](https://github.com/ClickHouse/ClickHouse/pull/49600) ([Azat Khuzhin](https://github.com/azat)). Now it is on par with C++.
 * Optimize the structure of the `system.opentelemetry_span_log`. Use `LowCardinality` where appropriate. Although this table is generally stupid (it is using the Map data type even for common attributes), it will be slightly better. [#49647](https://github.com/ClickHouse/ClickHouse/pull/49647) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Try to reserve hash table's size in `grace_hash` join. [#49816](https://github.com/ClickHouse/ClickHouse/pull/49816) ([lgbo](https://github.com/lgbo-ustc)).
-* As is addresed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as `toYear`, `toYYYYMM`, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. The [prototype](https://github.com/ZhiguoZh/ClickHouse/commit/c7f1753f0c9363a19d95fa46f1cfed1d9f505ee0) shows that, with all identified date converters optimized, the overall QPS of the 13 queries is enhanced by **~11%** on the ICX server (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads). [#50062](https://github.com/ClickHouse/ClickHouse/pull/50062) [#50307](https://github.com/ClickHouse/ClickHouse/pull/50307) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
+* As is addressed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as `toYear`, `toYYYYMM`, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. The [prototype](https://github.com/ZhiguoZh/ClickHouse/commit/c7f1753f0c9363a19d95fa46f1cfed1d9f505ee0) shows that, with all identified date converters optimized, the overall QPS of the 13 queries is enhanced by **~11%** on the ICX server (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads). [#50062](https://github.com/ClickHouse/ClickHouse/pull/50062) [#50307](https://github.com/ClickHouse/ClickHouse/pull/50307) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
 * Parallel merge of `uniqExactIf` states. Closes [#49885](https://github.com/ClickHouse/ClickHouse/issues/49885). [#50285](https://github.com/ClickHouse/ClickHouse/pull/50285) ([flynn](https://github.com/ucasfl)).
 * Keeper improvement: add `CheckNotExists` request to Keeper, which allows to improve the performance of Replicated tables. [#48897](https://github.com/ClickHouse/ClickHouse/pull/48897) ([Antonio Andelic](https://github.com/antonio2368)).
 * Keeper performance improvements: avoid serializing same request twice while processing. Cache deserialization results of large requests. Controlled by new coordination setting `min_request_size_for_cache`. [#49004](https://github.com/ClickHouse/ClickHouse/pull/49004) ([Antonio Andelic](https://github.com/antonio2368)).

From 2aaaec2abebe4860120bd5db1cf6a1b38c28a12b Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 8 Jun 2023 11:51:57 +0200
Subject: [PATCH 0622/1478] Catch issues with dockerd during the build

---
 tests/ci/build_check.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/tests/ci/build_check.py b/tests/ci/build_check.py
index 4bc61c79fc0..35b98a7c3bb 100644
--- a/tests/ci/build_check.py
+++ b/tests/ci/build_check.py
@@ -343,6 +343,15 @@ def main():
         f"sudo chown -R ubuntu:ubuntu {build_output_path}", shell=True
     )
     logging.info("Build finished with %s, log path %s", success, log_path)
+    if not success:
+        # We check if docker works, because if it's down, it's infrastructure
+        try:
+            subprocess.check_call("docker info", shell=True)
+        except subprocess.CalledProcessError:
+            logging.error(
+                "The dockerd looks down, won't upload anything and generate report"
+            )
+            sys.exit(1)
 
     # FIXME performance
     performance_urls = []

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 0623/1478] 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 64783194138fe4f823da38deb749bef44e15bf68 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Thu, 8 Jun 2023 09:24:11 -0300
Subject: [PATCH 0624/1478] Update CHANGELOG.md

---
 CHANGELOG.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a5b6dd85941..4cf1023cac2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -68,7 +68,6 @@
 * Improve performance of BLAKE3 by 11% by enabling LTO for Rust. [#49600](https://github.com/ClickHouse/ClickHouse/pull/49600) ([Azat Khuzhin](https://github.com/azat)). Now it is on par with C++.
 * Optimize the structure of the `system.opentelemetry_span_log`. Use `LowCardinality` where appropriate. Although this table is generally stupid (it is using the Map data type even for common attributes), it will be slightly better. [#49647](https://github.com/ClickHouse/ClickHouse/pull/49647) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Try to reserve hash table's size in `grace_hash` join. [#49816](https://github.com/ClickHouse/ClickHouse/pull/49816) ([lgbo](https://github.com/lgbo-ustc)).
-* As is addressed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as `toYear`, `toYYYYMM`, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. The [prototype](https://github.com/ZhiguoZh/ClickHouse/commit/c7f1753f0c9363a19d95fa46f1cfed1d9f505ee0) shows that, with all identified date converters optimized, the overall QPS of the 13 queries is enhanced by **~11%** on the ICX server (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads). [#50062](https://github.com/ClickHouse/ClickHouse/pull/50062) [#50307](https://github.com/ClickHouse/ClickHouse/pull/50307) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
 * Parallel merge of `uniqExactIf` states. Closes [#49885](https://github.com/ClickHouse/ClickHouse/issues/49885). [#50285](https://github.com/ClickHouse/ClickHouse/pull/50285) ([flynn](https://github.com/ucasfl)).
 * Keeper improvement: add `CheckNotExists` request to Keeper, which allows to improve the performance of Replicated tables. [#48897](https://github.com/ClickHouse/ClickHouse/pull/48897) ([Antonio Andelic](https://github.com/antonio2368)).
 * Keeper performance improvements: avoid serializing same request twice while processing. Cache deserialization results of large requests. Controlled by new coordination setting `min_request_size_for_cache`. [#49004](https://github.com/ClickHouse/ClickHouse/pull/49004) ([Antonio Andelic](https://github.com/antonio2368)).

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 0625/1478] 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 0626/1478] 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 d35573a2063f2c6f3091001c238f8ba7ac96a44c Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Thu, 8 Jun 2023 14:40:58 +0200
Subject: [PATCH 0627/1478] Removed logs and small name fixes

---
 src/Common/ProfileEvents.cpp                         | 4 ++--
 src/Core/Settings.h                                  | 2 +-
 src/Storages/StorageS3.cpp                           | 3 ---
 src/TableFunctions/TableFunctionAzureBlobStorage.cpp | 2 --
 src/TableFunctions/TableFunctionS3.cpp               | 1 -
 5 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index 3cc41c1972d..f66f7bc6465 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -348,8 +348,8 @@ The server successfully detected this situation and will download merged part fr
     M(S3PutObject, "Number of S3 API PutObject calls.") \
     M(S3GetObject, "Number of S3 API GetObject calls.") \
     \
-    M(AzureDeleteObjects, "Number of S3 API DeleteObject(s) calls.") \
-    M(AzureListObjects, "Number of S3 API ListObjects calls.") \
+    M(AzureDeleteObjects, "Number of Azure blob storage API DeleteObject(s) calls.") \
+    M(AzureListObjects, "Number of Azure blob storage API ListObjects calls.") \
     \
     M(DiskS3DeleteObjects, "Number of DiskS3 API DeleteObject(s) calls.") \
     M(DiskS3CopyObject, "Number of DiskS3 API CopyObject calls.") \
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 6abc2e1f697..25ad58e22fa 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -83,7 +83,7 @@ class IColumn;
     M(UInt64, s3_max_single_part_upload_size, 32*1024*1024, "The maximum size of object to upload using singlepart upload to S3.", 0) \
     M(UInt64, azure_max_single_part_upload_size, 100*1024*1024, "The maximum size of object to upload using singlepart upload to Azure blob storage.", 0) \
     M(UInt64, s3_max_single_read_retries, 4, "The maximum number of retries during single S3 read.", 0) \
-    M(UInt64, azure_max_single_read_retries, 4, "The maximum number of retries during single S3 read.", 0) \
+    M(UInt64, azure_max_single_read_retries, 4, "The maximum number of retries during single Azure blob storage read.", 0) \
     M(UInt64, s3_max_unexpected_write_error_retries, 4, "The maximum number of retries in case of unexpected errors during S3 write.", 0) \
     M(UInt64, s3_max_redirects, 10, "Max number of S3 redirects hops allowed.", 0) \
     M(UInt64, s3_max_connections, 1024, "The maximum number of connections per server.", 0) \
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 1c9efc31898..f1a7bcb71a2 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -957,9 +957,6 @@ StorageS3::StorageS3(
         {"_file", std::make_shared<DataTypeLowCardinality>(std::make_shared<DataTypeString>())}};
 
     auto columns = storage_metadata.getSampleBlock().getNamesAndTypesList();
-
-    LOG_INFO(&Poco::Logger::get("StorageS3"), "constructor columns  = {}", columns.toString());
-
     virtual_columns = getVirtualsForStorage(columns, default_virtuals);
     for (const auto & column : virtual_columns)
         virtual_block.insert({column.type->createColumn(), column.type, column.name});
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index 265092ddefa..38d9362894a 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -2,7 +2,6 @@
 
 #if USE_AZURE_BLOB_STORAGE
 
-//#include <IO/S3Common.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Interpreters/Context.h>
 #include <TableFunctions/TableFunctionFactory.h>
@@ -15,7 +14,6 @@
 #include <Parsers/ASTFunction.h>
 #include <Storages/checkAndGetLiteralArgument.h>
 #include <Storages/StorageAzureBlob.h>
-#include <Storages/StorageS3.h>
 #include <Storages/StorageURL.h>
 #include <Storages/NamedCollectionsHelpers.h>
 #include <Formats/FormatFactory.h>
diff --git a/src/TableFunctions/TableFunctionS3.cpp b/src/TableFunctions/TableFunctionS3.cpp
index e63f32b1cbc..c8cc0cddd30 100644
--- a/src/TableFunctions/TableFunctionS3.cpp
+++ b/src/TableFunctions/TableFunctionS3.cpp
@@ -319,7 +319,6 @@ StoragePtr TableFunctionS3::executeImpl(const ASTPtr & /*ast_function*/, Context
     else if (!structure_hint.empty())
         columns = structure_hint;
 
-
     StoragePtr storage = std::make_shared<StorageS3>(
         configuration,
         context,

From 6fcc4158d2ed912e0dcf34ca6e8f00060ec47dc0 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 8 Jun 2023 12:46:49 +0000
Subject: [PATCH 0628/1478] Add SHOW INDICES as alias for statement SHOW
 INDEX/INDEXES/KEYS

---
 docs/en/sql-reference/statements/show.md               | 2 +-
 src/Parsers/ParserShowIndexesQuery.cpp                 | 2 +-
 tests/queries/0_stateless/02724_show_indexes.reference | 5 +++++
 tests/queries/0_stateless/02724_show_indexes.sql       | 1 +
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/statements/show.md b/docs/en/sql-reference/statements/show.md
index 21c0010498a..f96eb55aa45 100644
--- a/docs/en/sql-reference/statements/show.md
+++ b/docs/en/sql-reference/statements/show.md
@@ -273,7 +273,7 @@ SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
 Displays a list of primary and data skipping indexes of a table.
 
 ```sql
-SHOW [EXTENDED] {INDEX | INDEXES | KEYS } {FROM | IN} <table> [{FROM | IN} <db>] [WHERE <expr>] [INTO OUTFILE <filename>] [FORMAT <format>]
+SHOW [EXTENDED] {INDEX | INDEXES | INDICES | KEYS } {FROM | IN} <table> [{FROM | IN} <db>] [WHERE <expr>] [INTO OUTFILE <filename>] [FORMAT <format>]
 ```
 
 The database and table name can be specified in abbreviated form as `<db>.<table>`, i.e. `FROM tab FROM db` and `FROM db.tab` are
diff --git a/src/Parsers/ParserShowIndexesQuery.cpp b/src/Parsers/ParserShowIndexesQuery.cpp
index fe08b463069..7852ed9806d 100644
--- a/src/Parsers/ParserShowIndexesQuery.cpp
+++ b/src/Parsers/ParserShowIndexesQuery.cpp
@@ -28,7 +28,7 @@ bool ParserShowIndexesQuery::parseImpl(Pos & pos, ASTPtr & node, Expected & expe
     if (ParserKeyword("EXTENDED").ignore(pos, expected))
         query->extended = true;
 
-    if (!(ParserKeyword("INDEX").ignore(pos, expected) || ParserKeyword("INDEXES").ignore(pos, expected) || ParserKeyword("KEYS").ignore(pos, expected)))
+    if (!(ParserKeyword("INDEX").ignore(pos, expected) || ParserKeyword("INDEXES").ignore(pos, expected) || ParserKeyword("INDICES").ignore(pos, expected) || ParserKeyword("KEYS").ignore(pos, expected)))
         return false;
 
     if (ParserKeyword("FROM").ignore(pos, expected) || ParserKeyword("IN").ignore(pos, expected))
diff --git a/tests/queries/0_stateless/02724_show_indexes.reference b/tests/queries/0_stateless/02724_show_indexes.reference
index 20af3954fa5..8365ade3231 100644
--- a/tests/queries/0_stateless/02724_show_indexes.reference
+++ b/tests/queries/0_stateless/02724_show_indexes.reference
@@ -14,6 +14,11 @@ tbl	0	mm1_idx	\N	\N	\N	\N	\N	\N	\N	minmax	\N	\N	YES	a, c, d
 tbl	0	mm2_idx	\N	\N	\N	\N	\N	\N	\N	minmax	\N	\N	YES	c, d, e
 tbl	0	PRIMARY	\N	\N	A	\N	\N	\N	\N	primary	\N	\N	YES	c, a
 tbl	0	set_idx	\N	\N	\N	\N	\N	\N	\N	set	\N	\N	YES	e
+tbl	0	blf_idx	\N	\N	\N	\N	\N	\N	\N	bloom_filter	\N	\N	YES	d, b
+tbl	0	mm1_idx	\N	\N	\N	\N	\N	\N	\N	minmax	\N	\N	YES	a, c, d
+tbl	0	mm2_idx	\N	\N	\N	\N	\N	\N	\N	minmax	\N	\N	YES	c, d, e
+tbl	0	PRIMARY	\N	\N	A	\N	\N	\N	\N	primary	\N	\N	YES	c, a
+tbl	0	set_idx	\N	\N	\N	\N	\N	\N	\N	set	\N	\N	YES	e
 --- EXTENDED
 tbl	0	blf_idx	\N	\N	\N	\N	\N	\N	\N	bloom_filter	\N	\N	YES	d, b
 tbl	0	mm1_idx	\N	\N	\N	\N	\N	\N	\N	minmax	\N	\N	YES	a, c, d
diff --git a/tests/queries/0_stateless/02724_show_indexes.sql b/tests/queries/0_stateless/02724_show_indexes.sql
index ce8ed67c524..04a481fea4e 100644
--- a/tests/queries/0_stateless/02724_show_indexes.sql
+++ b/tests/queries/0_stateless/02724_show_indexes.sql
@@ -22,6 +22,7 @@ PRIMARY KEY (c, a);
 SELECT '--- Aliases of SHOW INDEX';
 SHOW INDEX FROM tbl;
 SHOW INDEXES FROM tbl;
+SHOW INDICES FROM tbl;
 SHOW KEYS FROM tbl;
 
 SELECT '--- EXTENDED';

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 0629/1478] 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 5344ff2516d8f135c2a65f3979bf18109d76a10b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 8 Jun 2023 15:13:12 +0200
Subject: [PATCH 0630/1478] Temporarily disable annoy index tests (flaky for
 analyzer) (#50714)

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

diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index 0168fa04c6f..abee5e8a6e4 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -1,4 +1,4 @@
--- Tags: no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
+-- Tags: disabled, no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
 
 SET allow_experimental_annoy_index = 1;
 

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 0631/1478] 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 a918f88c744aa1fe171b500e3b56bfe6a3e13a2c Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Thu, 8 Jun 2023 16:11:27 +0200
Subject: [PATCH 0632/1478] Fixes

---
 src/Storages/StorageAzureBlob.cpp              | 18 ++++++++++++++----
 src/Storages/StorageAzureBlob.h                | 12 ++----------
 .../configs/disable_profilers.xml              |  9 +++++++++
 .../test_storage_azure_blob_storage/test.py    |  6 ++++--
 4 files changed, 29 insertions(+), 16 deletions(-)
 create mode 100644 tests/integration/test_storage_azure_blob_storage/configs/disable_profilers.xml

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 4901f6701fb..ce6c864f7ea 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -122,7 +122,7 @@ void StorageAzureBlob::processNamedCollectionResult(StorageAzureBlob::Configurat
 }
 
 
-StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file)
+StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine_args, ContextPtr local_context)
 {
     StorageAzureBlob::Configuration configuration;
 
@@ -137,7 +137,7 @@ StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine
 
         configuration.blobs_paths = {configuration.blob_path};
 
-        if (configuration.format == "auto" && get_format_from_file)
+        if (configuration.format == "auto")
             configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
 
         return configuration;
@@ -230,7 +230,7 @@ StorageAzureBlob::Configuration StorageAzureBlob::getConfiguration(ASTs & engine
 
     configuration.blobs_paths = {configuration.blob_path};
 
-    if (configuration.format == "auto" && get_format_from_file)
+    if (configuration.format == "auto")
         configuration.format = FormatFactory::instance().getFormatFromFileName(configuration.blob_path, true);
 
     return configuration;
@@ -898,7 +898,13 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
     }
     else
     {
-        if (!blobs_with_metadata || index >= blobs_with_metadata->size())
+        bool need_new_batch = false;
+        {
+            std::lock_guard lock(next_mutex);
+            need_new_batch = !blobs_with_metadata || index >= blobs_with_metadata->size();
+        }
+
+        if (need_new_batch)
         {
             RelativePathsWithMetadata new_batch;
             while (new_batch.empty())
@@ -939,6 +945,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
                 const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
 
+                std::lock_guard lock(next_mutex);
                 blob_path_with_globs.reset();
                 blob_path_with_globs.emplace();
                 for (UInt64 idx : idxs.getData())
@@ -954,6 +961,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 if (outer_blobs)
                     outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
 
+                std::lock_guard lock(next_mutex);
                 blobs_with_metadata = std::move(new_batch);
                 for (const auto & [_, info] : *blobs_with_metadata)
                     total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
@@ -961,6 +969,8 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
         }
 
         size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
+
+        std::lock_guard lock(next_mutex);
         return (*blobs_with_metadata)[current_index];
     }
 }
diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index 6e4dfaf19eb..c0380d7c065 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -15,15 +15,6 @@
 namespace DB
 {
 
-struct AzureSimpleAccountConfiguration
-{
-    std::string storage_account_url;
-};
-
-using AzureConnectionString = std::string;
-
-using AzureCredentials = std::variant<AzureSimpleAccountConfiguration, AzureConnectionString>;
-
 class StorageAzureBlob : public IStorage
 {
 public:
@@ -73,7 +64,7 @@ public:
         std::optional<FormatSettings> format_settings_,
         ASTPtr partition_by_);
 
-    static StorageAzureBlob::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context, bool get_format_from_file = true);
+    static StorageAzureBlob::Configuration getConfiguration(ASTs & engine_args, ContextPtr local_context);
     static AzureClientPtr createClient(StorageAzureBlob::Configuration configuration);
 
     static AzureObjectStorage::SettingsPtr createSettings(ContextPtr local_context);
@@ -190,6 +181,7 @@ public:
         void createFilterAST(const String & any_key);
         bool is_finished = false;
         bool is_initialized = false;
+        std::mutex next_mutex;
     };
 
     StorageAzureBlobSource(
diff --git a/tests/integration/test_storage_azure_blob_storage/configs/disable_profilers.xml b/tests/integration/test_storage_azure_blob_storage/configs/disable_profilers.xml
new file mode 100644
index 00000000000..a39badbf8ec
--- /dev/null
+++ b/tests/integration/test_storage_azure_blob_storage/configs/disable_profilers.xml
@@ -0,0 +1,9 @@
+<!-- Sometime azurite is super slow, profiler make it even worse -->
+<clickhouse>
+    <profiles>
+        <default>
+            <query_profiler_real_time_period_ns>0</query_profiler_real_time_period_ns>
+            <query_profiler_cpu_time_period_ns>0</query_profiler_cpu_time_period_ns>
+        </default>
+    </profiles>
+</clickhouse>
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index de7c662127c..f0934d3aa80 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -25,6 +25,7 @@ def cluster():
         cluster.add_instance(
             "node",
             main_configs=["configs/named_collections.xml"],
+            user_configs=["configs/disable_profilers.xml"],
             with_azurite=True,
         )
         cluster.start()
@@ -34,13 +35,14 @@ def cluster():
         cluster.shutdown()
 
 
-def azure_query(node, query, try_num=3, settings={}):
+def azure_query(node, query, try_num=10, settings={}):
     for i in range(try_num):
         try:
             return node.query(query, settings=settings)
         except Exception as ex:
             retriable_errors = [
-                "DB::Exception: Azure::Core::Http::TransportException: Connection was closed by the server while trying to read a response"
+                "DB::Exception: Azure::Core::Http::TransportException: Connection was closed by the server while trying to read a response",
+                "DB::Exception: Azure::Core::Http::TransportException: Connection closed before getting full response or response is less than expected",
             ]
             retry = False
             for error in retriable_errors:

From 964e0d042ca4fb10629da2437eae5efa9559955f Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 8 Jun 2023 16:21:45 +0200
Subject: [PATCH 0633/1478] Fix

---
 src/Interpreters/Cache/FileCache.cpp | 9 +++++----
 src/Interpreters/Cache/Metadata.cpp  | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 8d6146b4eea..cd0f96d8e0e 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -988,17 +988,18 @@ void FileCache::cleanup()
 
 void FileCache::cleanupThreadFunc()
 {
-#ifndef NDEBUG
-    assertCacheCorrectness();
-#endif
-
     try
     {
+#ifdef ABORT_ON_LOGICAL_ERROR
+        assertCacheCorrectness();
+#endif
+
         cleanup();
     }
     catch (...)
     {
         tryLogCurrentException(__PRETTY_FUNCTION__);
+        chassert(false);
     }
 
     cleanup_task->scheduleAfter(delayed_cleanup_interval_ms);
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 5b6561a665e..cd3b4e4f09f 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -278,7 +278,7 @@ void CacheMetadata::doCleanup()
         try
         {
             if (fs::exists(key_prefix_directory) && fs::is_empty(key_prefix_directory))
-                fs::remove_all(key_prefix_directory);
+                fs::remove(key_prefix_directory);
         }
         catch (const fs::filesystem_error & e)
         {

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 0634/1478] 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 caabbfd5b16249652fc247e37fe1b2318c9c9994 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Thu, 8 Jun 2023 16:25:55 +0200
Subject: [PATCH 0635/1478] Fix one more race

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

diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index c0380d7c065..1f91e47ddbe 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -179,8 +179,8 @@ public:
         std::unique_ptr<re2::RE2> matcher;
 
         void createFilterAST(const String & any_key);
-        bool is_finished = false;
-        bool is_initialized = false;
+        std::atomic<bool> is_finished = false;
+        std::atomic<bool> is_initialized = false;
         std::mutex next_mutex;
     };
 

From 9b04e8513700996d3c9e558c910913ab96016af5 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 8 Jun 2023 16:43:27 +0200
Subject: [PATCH 0636/1478] Fix

---
 src/Interpreters/tests/gtest_lru_file_cache.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index fe9e3a18024..8c8e715ce92 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -467,6 +467,7 @@ TEST_F(FileCacheTest, get)
                 cv.notify_one();
 
                 file_segment2.wait(file_segment2.range().left);
+                file_segment2.complete();
                 ASSERT_TRUE(file_segment2.state() == State::DOWNLOADED);
             });
 

From 116df09b5df6dd7362b36c9eea6f08b16a3e1b2b Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Thu, 8 Jun 2023 17:06:15 +0200
Subject: [PATCH 0637/1478] Fix build

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

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index ce6c864f7ea..3ee176a68b7 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -669,7 +669,7 @@ Pipe StorageAzureBlob::read(
     return Pipe::unitePipes(std::move(pipes));
 }
 
-SinkToStoragePtr StorageAzureBlob::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context)
+SinkToStoragePtr StorageAzureBlob::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, bool /*async_insert*/)
 {
     auto sample_block = metadata_snapshot->getSampleBlock();
     auto chosen_compression_method = chooseCompressionMethod(configuration.blobs_paths.back(), configuration.compression_method);
diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index 1f91e47ddbe..e2001fa24ae 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -85,7 +85,7 @@ public:
         size_t,
         size_t) override;
 
-    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /* metadata_snapshot */, ContextPtr context) override;
+    SinkToStoragePtr write(const ASTPtr & query, const StorageMetadataPtr & /* metadata_snapshot */, ContextPtr context, bool /*async_insert*/) override;
 
     void truncate(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr local_context, TableExclusiveLockHolder &) override;
 

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 0638/1478] 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 0639/1478] 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 b6e32cd5e3ba632805905c2c1ea8493471053f9f Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 8 Jun 2023 15:30:23 +0000
Subject: [PATCH 0640/1478] Do not read all the columns from right GLOBAL JOIN
 table.

---
 src/Interpreters/ExpressionAnalyzer.cpp       | 11 ++------
 src/Interpreters/GlobalSubqueriesVisitor.h    | 28 +++++++++++++++----
 src/Interpreters/TableJoin.cpp                |  9 ++++++
 src/Interpreters/TableJoin.h                  |  2 ++
 ...785_global_join_too_many_columns.reference |  1 +
 .../02785_global_join_too_many_columns.sql    | 14 ++++++++++
 6 files changed, 51 insertions(+), 14 deletions(-)
 create mode 100644 tests/queries/0_stateless/02785_global_join_too_many_columns.reference
 create mode 100644 tests/queries/0_stateless/02785_global_join_too_many_columns.sql

diff --git a/src/Interpreters/ExpressionAnalyzer.cpp b/src/Interpreters/ExpressionAnalyzer.cpp
index c7c66f6f414..307b46b3a0b 100644
--- a/src/Interpreters/ExpressionAnalyzer.cpp
+++ b/src/Interpreters/ExpressionAnalyzer.cpp
@@ -444,7 +444,7 @@ void ExpressionAnalyzer::initGlobalSubqueriesAndExternalTables(bool do_global, b
     if (do_global)
     {
         GlobalSubqueriesVisitor::Data subqueries_data(
-            getContext(), subquery_depth, isRemoteStorage(), is_explain, external_tables, prepared_sets, has_global_subqueries);
+            getContext(), subquery_depth, isRemoteStorage(), is_explain, external_tables, prepared_sets, has_global_subqueries, syntax->analyzed_join.get());
         GlobalSubqueriesVisitor(subqueries_data).visit(query);
     }
 }
@@ -1056,13 +1056,6 @@ JoinPtr SelectQueryExpressionAnalyzer::appendJoin(
     return join;
 }
 
-static ActionsDAGPtr createJoinedBlockActions(ContextPtr context, const TableJoin & analyzed_join)
-{
-    ASTPtr expression_list = analyzed_join.rightKeysList();
-    auto syntax_result = TreeRewriter(context).analyze(expression_list, analyzed_join.columnsFromJoinedTable());
-    return ExpressionAnalyzer(expression_list, syntax_result, context).getActionsDAG(true, false);
-}
-
 std::shared_ptr<DirectKeyValueJoin> tryKeyValueJoin(std::shared_ptr<TableJoin> analyzed_join, const Block & right_sample_block);
 
 
@@ -1144,7 +1137,7 @@ static std::unique_ptr<QueryPlan> buildJoinedPlan(
     SelectQueryOptions query_options)
 {
     /// Actions which need to be calculated on joined block.
-    auto joined_block_actions = createJoinedBlockActions(context, analyzed_join);
+    auto joined_block_actions = analyzed_join.createJoinedBlockActions(context);
     NamesWithAliases required_columns_with_aliases = analyzed_join.getRequiredColumns(
         Block(joined_block_actions->getResultColumns()), joined_block_actions->getRequiredColumns().getNames());
 
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 2901f2e23d0..f5b837fc7f7 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -9,6 +9,7 @@
 #include <Interpreters/InDepthNodeVisitor.h>
 #include <Interpreters/interpretSubquery.h>
 #include <Interpreters/PreparedSets.h>
+#include <Interpreters/TableJoin.h>
 #include <Parsers/ASTFunction.h>
 #include <Parsers/ASTIdentifier.h>
 #include <Parsers/ASTLiteral.h>
@@ -43,6 +44,7 @@ public:
         TemporaryTablesMapping & external_tables;
         PreparedSetsPtr prepared_sets;
         bool & has_global_subqueries;
+        TableJoin * table_join;
 
         Data(
             ContextPtr context_,
@@ -51,7 +53,8 @@ public:
             bool is_explain_,
             TemporaryTablesMapping & tables,
             PreparedSetsPtr prepared_sets_,
-            bool & has_global_subqueries_)
+            bool & has_global_subqueries_,
+            TableJoin * table_join_)
             : WithContext(context_)
             , subquery_depth(subquery_depth_)
             , is_remote(is_remote_)
@@ -59,10 +62,11 @@ public:
             , external_tables(tables)
             , prepared_sets(prepared_sets_)
             , has_global_subqueries(has_global_subqueries_)
+            , table_join(table_join_)
         {
         }
 
-        void addExternalStorage(ASTPtr & ast, bool set_alias = false)
+        void addExternalStorage(ASTPtr & ast, const Names & required_columns, bool set_alias = false)
         {
             /// With nondistributed queries, creating temporary tables does not make sense.
             if (!is_remote)
@@ -145,7 +149,7 @@ public:
             if (external_tables.contains(external_table_name))
                 return;
 
-            auto interpreter = interpretSubquery(subquery_or_table_name, getContext(), subquery_depth, {});
+            auto interpreter = interpretSubquery(subquery_or_table_name, getContext(), subquery_depth, required_columns);
 
             Block sample = interpreter->getSampleBlock();
             NamesAndTypesList columns = sample.getNamesAndTypesList();
@@ -238,7 +242,7 @@ private:
                 return;
             }
 
-            data.addExternalStorage(ast);
+            data.addExternalStorage(ast, {});
             data.has_global_subqueries = true;
         }
     }
@@ -249,7 +253,21 @@ private:
         if (table_elem.table_join
             && (table_elem.table_join->as<ASTTableJoin &>().locality == JoinLocality::Global || shouldBeExecutedGlobally(data)))
         {
-            data.addExternalStorage(table_elem.table_expression, true);
+            Names required_columns;
+
+            /// Fill required columns for GLOBAL JOIN.
+            /// This code is partial copy-paste from ExpressionAnalyzer.
+            if (data.table_join)
+            {
+                auto joined_block_actions = data.table_join->createJoinedBlockActions(data.getContext());
+                NamesWithAliases required_columns_with_aliases = data.table_join->getRequiredColumns(
+                    Block(joined_block_actions->getResultColumns()), joined_block_actions->getRequiredColumns().getNames());
+
+                for (auto & pr : required_columns_with_aliases)
+                    required_columns.push_back(pr.first);
+            }
+
+            data.addExternalStorage(table_elem.table_expression, required_columns, true);
             data.has_global_subqueries = true;
         }
     }
diff --git a/src/Interpreters/TableJoin.cpp b/src/Interpreters/TableJoin.cpp
index 5a23fbd00ff..c56d1e6039e 100644
--- a/src/Interpreters/TableJoin.cpp
+++ b/src/Interpreters/TableJoin.cpp
@@ -14,6 +14,8 @@
 #include <Dictionaries/DictionaryStructure.h>
 
 #include <Interpreters/ExternalDictionariesLoader.h>
+#include <Interpreters/TreeRewriter.h>
+#include <Interpreters/ExpressionAnalyzer.h>
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -760,4 +762,11 @@ bool TableJoin::allowParallelHashJoin() const
     return true;
 }
 
+ActionsDAGPtr TableJoin::createJoinedBlockActions(ContextPtr context)
+{
+    ASTPtr expression_list = rightKeysList();
+    auto syntax_result = TreeRewriter(context).analyze(expression_list, columnsFromJoinedTable());
+    return ExpressionAnalyzer(expression_list, syntax_result, context).getActionsDAG(true, false);
+}
+
 }
diff --git a/src/Interpreters/TableJoin.h b/src/Interpreters/TableJoin.h
index 6737cd8f13a..096e58d1292 100644
--- a/src/Interpreters/TableJoin.h
+++ b/src/Interpreters/TableJoin.h
@@ -217,6 +217,8 @@ public:
     const SizeLimits & sizeLimits() const { return size_limits; }
     VolumePtr getGlobalTemporaryVolume() { return tmp_volume; }
 
+    ActionsDAGPtr createJoinedBlockActions(ContextPtr context);
+
     bool isEnabledAlgorithm(JoinAlgorithm val) const
     {
         /// When join_algorithm = 'default' (not specified by user) we use hash or direct algorithm.
diff --git a/tests/queries/0_stateless/02785_global_join_too_many_columns.reference b/tests/queries/0_stateless/02785_global_join_too_many_columns.reference
new file mode 100644
index 00000000000..425151f3a41
--- /dev/null
+++ b/tests/queries/0_stateless/02785_global_join_too_many_columns.reference
@@ -0,0 +1 @@
+40
diff --git a/tests/queries/0_stateless/02785_global_join_too_many_columns.sql b/tests/queries/0_stateless/02785_global_join_too_many_columns.sql
new file mode 100644
index 00000000000..a49aae25f1c
--- /dev/null
+++ b/tests/queries/0_stateless/02785_global_join_too_many_columns.sql
@@ -0,0 +1,14 @@
+drop table if exists local;
+drop table if exists distr;
+
+create table local (a UInt64, b UInt64, c UInt64, d UInt64, e UInt64, f UInt64, g UInt64, h UInt64) engine = Log;
+create table distr as local engine = Distributed('test_cluster_two_shards', currentDatabase(), local);
+
+insert into local (a) select number from numbers(10);
+
+set max_columns_to_read=1;
+select count() from distr as l global all left join distr as r on l.a = r.a;
+
+drop table if exists local;
+drop table if exists distr;
+

From 01873e9e6d9aeaaa8ae8dd2e78bd9f75ea5c70e6 Mon Sep 17 00:00:00 2001
From: Jordi Villar <jrdi.villar@gmail.com>
Date: Thu, 8 Jun 2023 14:09:01 +0200
Subject: [PATCH 0641/1478] Add async insert system tables documentation

---
 .../settings.md                               | 26 ++++++++
 .../system-tables/asynchronous_insert_log.md  | 63 +++++++++++++++++++
 .../system-tables/asynchronous_inserts.md     | 45 +++++++++++++
 3 files changed, 134 insertions(+)
 create mode 100644 docs/en/operations/system-tables/asynchronous_insert_log.md
 create mode 100644 docs/en/operations/system-tables/asynchronous_inserts.md

diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index f93ab264511..3398c7afb67 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -1881,6 +1881,32 @@ The default server configuration file `config.xml` contains the following settin
 </trace_log>
 ```
 
+## asynchronous_insert_log {#server_configuration_parameters-asynchronous_insert_log}
+
+Settings for the [asynchronous_insert_log](../../operations/system-tables/asynchronous_insert_log.md#system_tables-asynchronous_insert_log) system table for logging async inserts.
+
+Parameters:
+
+- `database` — Database name.
+- `table` — Table name.
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) for a system table. Can't be used if `partition_by` defined.
+- `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table.
+- `storage_policy` – Name of storage policy to use for the table (optional)
+
+**Example**
+```xml
+<clickhouse>
+    <asynchronous_insert_log>
+        <database>system</database>
+        <table>asynchronous_insert_log</table>
+        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
+        <partition_by>toYYYYMM(event_date)</partition_by>
+        <!-- <engine>Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day</engine> -->
+    </asynchronous_insert_log>
+</clickhouse>
+```
+
 ## query_masking_rules {#query-masking-rules}
 
 Regexp-based rules, which will be applied to queries as well as all log messages before storing them in server logs,
diff --git a/docs/en/operations/system-tables/asynchronous_insert_log.md b/docs/en/operations/system-tables/asynchronous_insert_log.md
new file mode 100644
index 00000000000..8b0509d7000
--- /dev/null
+++ b/docs/en/operations/system-tables/asynchronous_insert_log.md
@@ -0,0 +1,63 @@
+---
+slug: /en/operations/system-tables/asynchronous_insert_log
+---
+# asynchronous_insert_log
+
+Contains information about async inserts. Each entry represents an insert query buffered into an async insert query.
+
+To start logging configure parameters in the [asynchronous_insert_log](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-asynchronous_insert_log) section.
+
+The flushing period of data is set in `flush_interval_milliseconds` parameter of the [asynchronous_insert_log](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-asynchronous_insert_log) server settings section. To force flushing, use the [SYSTEM FLUSH LOGS](../../sql-reference/statements/system.md#query_language-system-flush_logs) query.
+
+ClickHouse does not delete data from the table automatically. See [Introduction](../../operations/system-tables/index.md#system-tables-introduction) for more details.
+
+Columns:
+
+- `event_date` ([Date](../../sql-reference/data-types/date.md)) — The date when the async insert happened.
+- `event_time` ([DateTime](../../sql-reference/data-types/datetime.md)) — The date and time when the async insert finished execution.
+- `event_time_microseconds` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — The date and time when the async insert finished execution with microseconds precision.
+- `query` ([String](../../sql-reference/data-types/string.md)) — Query string.
+- `database` ([String](../../sql-reference/data-types/string.md)) — The name of the database the table is in.
+- `table` ([String](../../sql-reference/data-types/string.md)) — Table name.
+- `format` ([String](/docs/en/sql-reference/data-types/string.md)) — Format name.
+- `query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the initial query.
+- `bytes` ([UInt64](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Number of inserted bytes.
+- `exception` ([String](../../sql-reference/data-types/string.md)) — Exception message.
+- `status` ([Enum8](../../sql-reference/data-types/enum.md)) — Status of the view. Values:
+    - `'Ok' = 1` — Successful insert.
+    - `'ParsingError' = 2` — Exception when parsing the data.
+    - `'FlushError' = 3` — Exception when flushing the data.
+- `flush_time` ([DateTime](../../sql-reference/data-types/datetime.md)) — The date and time when the flush happened.
+- `flush_time_microseconds` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — The date and time when the flush happened with microseconds precision.
+- `flush_query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the flush query.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT * FROM system.asynchronous_insert_log LIMIT 1 \G;
+```
+
+Result:
+
+``` text
+event_date:              2023-06-08
+event_time:              2023-06-08 10:08:53
+event_time_microseconds: 2023-06-08 10:08:53.199516
+query:                   INSERT INTO public.data_guess (user_id, datasource_id, timestamp, path, type, num, str) FORMAT CSV
+database:                public
+table:                   data_guess
+format:                  CSV
+query_id:                b46cd4c4-0269-4d0b-99f5-d27668c6102e
+bytes:                   133223
+exception:
+status:                  Ok
+flush_time:              2023-06-08 10:08:55
+flush_time_microseconds: 2023-06-08 10:08:55.139676
+flush_query_id:          cd2c1e43-83f5-49dc-92e4-2fbc7f8d3716
+
+**See Also**
+
+- [system.query_log](../../operations/system-tables/query_log.md#system_tables-query_log) — Description of the `query_log` system table which contains common information about queries execution.
+- [system.asynchronous_inserts](../../operations/system-tables/asynchronous_inserts.md#system_tables-asynchronous_inserts) — This table contains information about pending asynchronous inserts in queue.
diff --git a/docs/en/operations/system-tables/asynchronous_inserts.md b/docs/en/operations/system-tables/asynchronous_inserts.md
new file mode 100644
index 00000000000..8fd5f2bb520
--- /dev/null
+++ b/docs/en/operations/system-tables/asynchronous_inserts.md
@@ -0,0 +1,45 @@
+---
+slug: /en/operations/system-tables/asynchronous_inserts
+---
+# asynchronous_inserts
+
+Contains information about pending asynchronous inserts in queue.
+
+Columns:
+
+- `query` ([String](../../sql-reference/data-types/string.md)) — Query string.
+- `database` ([String](../../sql-reference/data-types/string.md)) — The name of the database the table is in.
+- `table` ([String](../../sql-reference/data-types/string.md)) — Table name.
+- `format` ([String](/docs/en/sql-reference/data-types/string.md)) — Format name.
+- `first_update` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — First insert time with microseconds resolution.
+- `total_bytes` ([UInt64](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Total number of bytes waiting in the queue.
+- `entries.query_id` ([Array(String)](../../sql-reference/data-types/array.md)) - Array of query ids of the inserts waiting in the queue.
+- `entries.bytes` ([Array(UInt64)](../../sql-reference/data-types/array.md)) - Array of bytes of each insert query waiting in the queue.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT * FROM system.asynchronous_inserts LIMIT 1 \G;
+```
+
+Result:
+
+``` text
+Row 1:
+──────
+query:            INSERT INTO public.data_guess (user_id, datasource_id, timestamp, path, type, num, str) FORMAT CSV
+database:         public
+table:            data_guess
+format:           CSV
+first_update:     2023-06-08 10:08:54.199606
+total_bytes:      133223
+entries.query_id: ['b46cd4c4-0269-4d0b-99f5-d27668c6102e']
+entries.bytes:    [133223]
+```
+
+**See Also**
+
+- [system.query_log](../../operations/system-tables/query_log.md#system_tables-query_log) — Description of the `query_log` system table which contains common information about queries execution.
+- [system.asynchronous_insert_log](../../operations/system-tables/asynchronous_insert_log.md#system_tables-asynchronous_insert_log) — This table contains information about async inserts performed.

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 0642/1478] 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 314df9a6da2ca03cfea6952b5aa47654d974666e Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 8 Jun 2023 16:25:06 +0000
Subject: [PATCH 0643/1478] Fixing test.

---
 .../0_stateless/02731_parallel_replicas_join_subquery.reference | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02731_parallel_replicas_join_subquery.reference b/tests/queries/0_stateless/02731_parallel_replicas_join_subquery.reference
index df606679523..9b08e69b9d3 100644
--- a/tests/queries/0_stateless/02731_parallel_replicas_join_subquery.reference
+++ b/tests/queries/0_stateless/02731_parallel_replicas_join_subquery.reference
@@ -39,6 +39,6 @@ U	c	10
 UlI+1		10
 bX?}ix [	Ny]2 G	10
 t<iT	X48q:Z]t0	10
-0	3	SELECT `key`, `value1`, `value2`, toUInt64(min(`time`)) AS `start_ts` FROM `default`.`join_inner_table` PREWHERE (`id` = \'833c9e22-c245-4eb5-8745-117a9a1f26b1\') AND (`number` > toUInt64(\'1610517366120\')) GROUP BY `key`, `value1`, `value2`
+0	3	SELECT `key`, `value1`, `value2` FROM `default`.`join_inner_table` PREWHERE (`id` = \'833c9e22-c245-4eb5-8745-117a9a1f26b1\') AND (`number` > toUInt64(\'1610517366120\')) GROUP BY `key`, `value1`, `value2`
 0	3	SELECT `value1`, `value2`, count() AS `count` FROM `default`.`join_outer_table` ALL INNER JOIN `_data_11888098645495698704_17868075224240210014` USING (`key`) GROUP BY `key`, `value1`, `value2`
 1	1	-- Parallel full query\nSELECT\n    value1,\n    value2,\n    avg(count) AS avg\nFROM\n    (\n        SELECT\n            key,\n            value1,\n            value2,\n            count() AS count\n        FROM join_outer_table\n        INNER JOIN\n        (\n            SELECT\n                key,\n                value1,\n                value2,\n                toUInt64(min(time)) AS start_ts\n            FROM join_inner_table\n            PREWHERE (id = \'833c9e22-c245-4eb5-8745-117a9a1f26b1\') AND (number > toUInt64(\'1610517366120\'))\n            GROUP BY key, value1, value2\n        ) USING (key)\n        GROUP BY key, value1, value2\n        )\nGROUP BY value1, value2\nORDER BY value1, value2\nSETTINGS allow_experimental_parallel_reading_from_replicas = 1;

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 0644/1478] 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 43cb2024a733fd5cbd7e0593ce317fad5e223130 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Thu, 8 Jun 2023 19:20:32 +0200
Subject: [PATCH 0645/1478] Better comments

Co-authored-by: Dmitry Novik <n0vik@clickhouse.com>
---
 src/Processors/QueryPlan/Optimizations/optimizeTree.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
index 091eecf99e5..de4916797e9 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
@@ -163,6 +163,7 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
             }
         }
 
+        /// NOTE: optimizePrewhere can modify the stack.
         optimizePrewhere(stack, nodes);
         optimizePrimaryKeyCondition(stack);
         enableMemoryBoundMerging(*stack.back().node, nodes);

From dc08583ba492b7ec4b38c0e1fa4c38fc3310f630 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Thu, 8 Jun 2023 19:20:40 +0200
Subject: [PATCH 0646/1478] Better comments

Co-authored-by: Dmitry Novik <n0vik@clickhouse.com>
---
 src/Processors/QueryPlan/Optimizations/optimizeTree.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
index de4916797e9..73632d34671 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
@@ -115,7 +115,7 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
     while (!stack.empty())
     {
         {
-            /// NOTE: frame cannot be safely used after adding new elements to stack
+            /// NOTE: frame cannot be safely used after stack was modified.
             auto & frame = stack.back();
 
             if (frame.next_child == 0)

From f4bf42cc42a6a2d8966d711874286427956d51d7 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Thu, 8 Jun 2023 17:29:51 +0000
Subject: [PATCH 0647/1478] more fixes

---
 .../AggregateFunctionGroupArray.cpp           |   1 +
 .../AggregateFunctionGroupUniqArray.cpp       |  11 ++
 .../AggregateFunctionTopK.cpp                 |  19 ++
 .../AggregateFunctionUniq.h                   |  31 +++-
 .../AggregateFunctionUniqCombined.cpp         |   5 +
 .../AggregateFunctionUniqCombined.h           |  16 +-
 ...es_aggregate_functions_states.reference.j2 | 172 ++++++++++++++++++
 ...ip_types_aggregate_functions_states.sql.j2 | 123 +++++++++++++
 8 files changed, 366 insertions(+), 12 deletions(-)
 create mode 100644 tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
 create mode 100644 tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2

diff --git a/src/AggregateFunctions/AggregateFunctionGroupArray.cpp b/src/AggregateFunctions/AggregateFunctionGroupArray.cpp
index 15f500b8bb6..bb1368b9ff8 100644
--- a/src/AggregateFunctions/AggregateFunctionGroupArray.cpp
+++ b/src/AggregateFunctions/AggregateFunctionGroupArray.cpp
@@ -25,6 +25,7 @@ IAggregateFunction * createWithNumericOrTimeType(const IDataType & argument_type
     WhichDataType which(argument_type);
     if (which.idx == TypeIndex::Date) return new AggregateFunctionTemplate<UInt16, Data>(std::forward<TArgs>(args)...);
     if (which.idx == TypeIndex::DateTime) return new AggregateFunctionTemplate<UInt32, Data>(std::forward<TArgs>(args)...);
+    if (which.idx == TypeIndex::IPv4) return new AggregateFunctionTemplate<IPv4, Data>(std::forward<TArgs>(args)...);
     return createWithNumericType<AggregateFunctionTemplate, Data, TArgs...>(argument_type, std::forward<TArgs>(args)...);
 }
 
diff --git a/src/AggregateFunctions/AggregateFunctionGroupUniqArray.cpp b/src/AggregateFunctions/AggregateFunctionGroupUniqArray.cpp
index 16f2feb71bf..9e8060d44cc 100644
--- a/src/AggregateFunctions/AggregateFunctionGroupUniqArray.cpp
+++ b/src/AggregateFunctions/AggregateFunctionGroupUniqArray.cpp
@@ -4,6 +4,7 @@
 #include <AggregateFunctions/FactoryHelpers.h>
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeDateTime.h>
+#include <DataTypes/DataTypeIPv4andIPv6.h>
 
 
 namespace DB
@@ -39,12 +40,22 @@ public:
     static DataTypePtr createResultType() { return std::make_shared<DataTypeArray>(std::make_shared<DataTypeDateTime>()); }
 };
 
+template <typename HasLimit>
+class AggregateFunctionGroupUniqArrayIPv4 : public AggregateFunctionGroupUniqArray<DataTypeIPv4::FieldType, HasLimit>
+{
+public:
+    explicit AggregateFunctionGroupUniqArrayIPv4(const DataTypePtr & argument_type, const Array & parameters_, UInt64 max_elems_ = std::numeric_limits<UInt64>::max())
+        : AggregateFunctionGroupUniqArray<DataTypeIPv4::FieldType, HasLimit>(argument_type, parameters_, createResultType(), max_elems_) {}
+    static DataTypePtr createResultType() { return std::make_shared<DataTypeArray>(std::make_shared<DataTypeIPv4>()); }
+};
+
 template <typename HasLimit, typename ... TArgs>
 IAggregateFunction * createWithExtraTypes(const DataTypePtr & argument_type, TArgs && ... args)
 {
     WhichDataType which(argument_type);
     if (which.idx == TypeIndex::Date) return new AggregateFunctionGroupUniqArrayDate<HasLimit>(argument_type, std::forward<TArgs>(args)...);
     else if (which.idx == TypeIndex::DateTime) return new AggregateFunctionGroupUniqArrayDateTime<HasLimit>(argument_type, std::forward<TArgs>(args)...);
+    else if (which.idx == TypeIndex::IPv4) return new AggregateFunctionGroupUniqArrayIPv4<HasLimit>(argument_type, std::forward<TArgs>(args)...);
     else
     {
         /// Check that we can use plain version of AggregateFunctionGroupUniqArrayGeneric
diff --git a/src/AggregateFunctions/AggregateFunctionTopK.cpp b/src/AggregateFunctions/AggregateFunctionTopK.cpp
index e568694df02..8f6652223cc 100644
--- a/src/AggregateFunctions/AggregateFunctionTopK.cpp
+++ b/src/AggregateFunctions/AggregateFunctionTopK.cpp
@@ -5,6 +5,7 @@
 #include <Common/FieldVisitorConvertToNumber.h>
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeDateTime.h>
+#include <DataTypes/DataTypeIPv4andIPv6.h>
 
 
 static inline constexpr UInt64 TOP_K_MAX_SIZE = 0xFFFFFF;
@@ -60,6 +61,22 @@ public:
     {}
 };
 
+template <bool is_weighted>
+class AggregateFunctionTopKIPv4 : public AggregateFunctionTopK<DataTypeIPv4::FieldType, is_weighted>
+{
+public:
+    using AggregateFunctionTopK<DataTypeIPv4::FieldType, is_weighted>::AggregateFunctionTopK;
+
+    AggregateFunctionTopKIPv4(UInt64 threshold_, UInt64 load_factor, const DataTypes & argument_types_, const Array & params)
+        : AggregateFunctionTopK<DataTypeIPv4::FieldType, is_weighted>(
+            threshold_,
+            load_factor,
+            argument_types_,
+            params,
+            std::make_shared<DataTypeArray>(std::make_shared<DataTypeIPv4>()))
+    {}
+};
+
 
 template <bool is_weighted>
 IAggregateFunction * createWithExtraTypes(const DataTypes & argument_types, UInt64 threshold, UInt64 load_factor, const Array & params)
@@ -72,6 +89,8 @@ IAggregateFunction * createWithExtraTypes(const DataTypes & argument_types, UInt
         return new AggregateFunctionTopKDate<is_weighted>(threshold, load_factor, argument_types, params);
     if (which.idx == TypeIndex::DateTime)
         return new AggregateFunctionTopKDateTime<is_weighted>(threshold, load_factor, argument_types, params);
+    if (which.idx == TypeIndex::IPv4)
+        return new AggregateFunctionTopKIPv4<is_weighted>(threshold, load_factor, argument_types, params);
 
     /// Check that we can use plain version of AggregateFunctionTopKGeneric
     if (argument_types[0]->isValueUnambiguouslyRepresentedInContiguousMemoryRegion())
diff --git a/src/AggregateFunctions/AggregateFunctionUniq.h b/src/AggregateFunctions/AggregateFunctionUniq.h
index 03d999b47e2..de68e9076a0 100644
--- a/src/AggregateFunctions/AggregateFunctionUniq.h
+++ b/src/AggregateFunctions/AggregateFunctionUniq.h
@@ -167,6 +167,25 @@ struct AggregateFunctionUniqExactData<String, is_able_to_parallelize_merge_>
     static String getName() { return "uniqExact"; }
 };
 
+/// For historical reasons IPv6 is treated as FixedString(16)
+template <bool is_able_to_parallelize_merge_>
+struct AggregateFunctionUniqExactData<IPv6, is_able_to_parallelize_merge_>
+{
+    using Key = UInt128;
+
+    /// When creating, the hash table must be small.
+    using SingleLevelSet = HashSet<Key, UInt128TrivialHash, HashTableGrower<3>, HashTableAllocatorWithStackMemory<sizeof(Key) * (1 << 3)>>;
+    using TwoLevelSet = TwoLevelHashSet<Key, UInt128TrivialHash>;
+    using Set = UniqExactSet<SingleLevelSet, TwoLevelSet>;
+
+    Set set;
+
+    constexpr static bool is_able_to_parallelize_merge = is_able_to_parallelize_merge_;
+    constexpr static bool is_variadic = false;
+
+    static String getName() { return "uniqExact"; }
+};
+
 template <bool is_exact_, bool argument_is_tuple_, bool is_able_to_parallelize_merge_>
 struct AggregateFunctionUniqExactDataForVariadic : AggregateFunctionUniqExactData<String, is_able_to_parallelize_merge_>
 {
@@ -275,12 +294,7 @@ struct Adder
         else if constexpr (std::is_same_v<Data, AggregateFunctionUniqExactData<T, Data::is_able_to_parallelize_merge>>)
         {
             const auto & column = *columns[0];
-            if constexpr (!std::is_same_v<T, String>)
-            {
-                data.set.template insert<const T &, use_single_level_hash_table>(
-                    assert_cast<const ColumnVector<T> &>(column).getData()[row_num]);
-            }
-            else
+            if constexpr (std::is_same_v<T, String> || std::is_same_v<T, IPv6>)
             {
                 StringRef value = column.getDataAt(row_num);
 
@@ -291,6 +305,11 @@ struct Adder
 
                 data.set.template insert<const UInt128 &, use_single_level_hash_table>(key);
             }
+            else
+            {
+                data.set.template insert<const T &, use_single_level_hash_table>(
+                    assert_cast<const ColumnVector<T> &>(column).getData()[row_num]);
+            }
         }
 #if USE_DATASKETCHES
         else if constexpr (std::is_same_v<Data, AggregateFunctionUniqThetaData>)
diff --git a/src/AggregateFunctions/AggregateFunctionUniqCombined.cpp b/src/AggregateFunctions/AggregateFunctionUniqCombined.cpp
index 1c59da59e83..8c2cb6ea0de 100644
--- a/src/AggregateFunctions/AggregateFunctionUniqCombined.cpp
+++ b/src/AggregateFunctions/AggregateFunctionUniqCombined.cpp
@@ -8,6 +8,7 @@
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeDate32.h>
 #include <DataTypes/DataTypeDateTime.h>
+#include <DataTypes/DataTypeIPv4andIPv6.h>
 
 #include <functional>
 
@@ -60,6 +61,10 @@ namespace
                 return std::make_shared<typename WithK<K, HashValueType>::template AggregateFunction<String>>(argument_types, params);
             else if (which.isUUID())
                 return std::make_shared<typename WithK<K, HashValueType>::template AggregateFunction<DataTypeUUID::FieldType>>(argument_types, params);
+            else if (which.isIPv4())
+                return std::make_shared<typename WithK<K, HashValueType>::template AggregateFunction<DataTypeIPv4::FieldType>>(argument_types, params);
+            else if (which.isIPv6())
+                return std::make_shared<typename WithK<K, HashValueType>::template AggregateFunction<DataTypeIPv6::FieldType>>(argument_types, params);
             else if (which.isTuple())
             {
                 if (use_exact_hash_function)
diff --git a/src/AggregateFunctions/AggregateFunctionUniqCombined.h b/src/AggregateFunctions/AggregateFunctionUniqCombined.h
index d879e3b3dde..5e8fa69f9de 100644
--- a/src/AggregateFunctions/AggregateFunctionUniqCombined.h
+++ b/src/AggregateFunctions/AggregateFunctionUniqCombined.h
@@ -119,6 +119,10 @@ struct AggregateFunctionUniqCombinedData<String, K, HashValueType> : public Aggr
 {
 };
 
+template <UInt8 K, typename HashValueType>
+struct AggregateFunctionUniqCombinedData<IPv6, K, HashValueType> : public AggregateFunctionUniqCombinedDataWithKey<UInt64 /*always*/, K>
+{
+};
 
 template <typename T, UInt8 K, typename HashValueType>
 class AggregateFunctionUniqCombined final
@@ -141,16 +145,16 @@ public:
 
     void add(AggregateDataPtr __restrict place, const IColumn ** columns, size_t row_num, Arena *) const override
     {
-        if constexpr (!std::is_same_v<T, String>)
-        {
-            const auto & value = assert_cast<const ColumnVector<T> &>(*columns[0]).getElement(row_num);
-            this->data(place).set.insert(detail::AggregateFunctionUniqCombinedTraits<T, HashValueType>::hash(value));
-        }
-        else
+        if constexpr (std::is_same_v<T, String> || std::is_same_v<T, IPv6>)
         {
             StringRef value = columns[0]->getDataAt(row_num);
             this->data(place).set.insert(CityHash_v1_0_2::CityHash64(value.data, value.size));
         }
+        else
+        {
+            const auto & value = assert_cast<const ColumnVector<T> &>(*columns[0]).getElement(row_num);
+            this->data(place).set.insert(detail::AggregateFunctionUniqCombinedTraits<T, HashValueType>::hash(value));
+        }
     }
 
     void merge(AggregateDataPtr __restrict place, ConstAggregateDataPtr rhs, Arena *) const override
diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
new file mode 100644
index 00000000000..481dd723b66
--- /dev/null
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
@@ -0,0 +1,172 @@
+----- hash / State / ip4 -----
+Row 1:
+──────
+minState:            12535288824949910799
+maxState:            18210943739258811465
+first_valueState:    12535288824949910799
+last_valueState:     18210943739258811465
+topKState:           1594227852744382511
+groupArrayState:     8025417272361615478
+groupUniqArrayState: 919082878249747568
+uniqState:           14828781561416784358
+uniqExactState:      11391659146320471795
+uniqCombinedState:   9631896280254268221
+uniqCombined64State: 5156097536649078816
+uniqHLL12State:      9696624347265201099
+uniqThetaState:      10464560810701154023
+----- hash / State / ip6 -----
+Row 1:
+──────
+minState:            9428555662807296659
+maxState:            18253481702148601156
+first_valueState:    9428555662807296659
+last_valueState:     18253481702148601156
+topKState:           8045294331733869941
+groupArrayState:     10451014709837753966
+groupUniqArrayState: 1954028114836070615
+uniqState:           14986562136250471284
+uniqExactState:      10032843621916709112
+uniqCombinedState:   6379274083567016598
+uniqCombined64State: 6379274083567016598
+uniqHLL12State:      9181286681186915812
+uniqThetaState:      2415188383468008881
+----- finalizeAggregation / State / ip4 -----
+Row 1:
+──────
+min:            59.154.201.255
+max:            59.154.202.48
+first_value:    59.154.201.255
+last_value:     59.154.202.48
+topK:           ['59.154.202.48','59.154.202.5','59.154.202.26','59.154.202.25','59.154.202.24','59.154.202.23','59.154.202.22','59.154.202.21','59.154.202.27','59.154.202.19']
+groupArray:     ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8','59.154.202.9','59.154.202.10','59.154.202.11','59.154.202.12','59.154.202.13','59.154.202.14','59.154.202.15','59.154.202.16','59.154.202.17','59.154.202.18','59.154.202.19','59.154.202.20','59.154.202.21','59.154.202.22','59.154.202.23','59.154.202.24','59.154.202.25','59.154.202.26','59.154.202.27','59.154.202.28','59.154.202.29','59.154.202.30','59.154.202.31','59.154.202.32','59.154.202.33','59.154.202.34','59.154.202.35','59.154.202.36','59.154.202.37','59.154.202.38','59.154.202.39','59.154.202.40','59.154.202.41','59.154.202.42','59.154.202.43','59.154.202.44','59.154.202.45','59.154.202.46','59.154.202.47','59.154.202.48']
+groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.48','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
+uniq:           50
+uniqExact:      50
+uniqCombined:   50
+uniqCombined64: 50
+uniqHLL12:      49
+uniqTheta:      50
+----- finalizeAggregation / State / ip6 -----
+Row 1:
+──────
+min:            8c:333c::8c:333c:0:0
+max:            ff8b:333c::ff8b:333c:0:0
+first_value:    8c:333c::8c:333c:0:0
+last_value:     ff8b:333c::ff8b:333c:0:0
+topK:           ['ff8b:333c::ff8b:333c:0:0','68c:333c::68c:333c:0:0','e98b:333c::e98b:333c:0:0','e88b:333c::e88b:333c:0:0','e78b:333c::e78b:333c:0:0','e68b:333c::e68b:333c:0:0','e58b:333c::e58b:333c:0:0','e48b:333c::e48b:333c:0:0','ea8b:333c::ea8b:333c:0:0','e28b:333c::e28b:333c:0:0']
+groupArray:     ['8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','e8c:333c::e8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e8c:333c::e8c:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+uniq:           50
+uniqExact:      50
+uniqCombined:   50
+uniqCombined64: 50
+uniqHLL12:      50
+uniqTheta:      50
+----- hash / IfState / ip4 -----
+Row 1:
+──────
+minIfState:            12535288824949910799
+maxIfState:            18210943739258811465
+first_valueIfState:    12535288824949910799
+last_valueIfState:     18210943739258811465
+topKIfState:           1594227852744382511
+groupArrayIfState:     8025417272361615478
+groupUniqArrayIfState: 919082878249747568
+uniqIfState:           14828781561416784358
+uniqExactIfState:      11391659146320471795
+uniqCombinedIfState:   9631896280254268221
+uniqCombined64IfState: 5156097536649078816
+uniqHLL12IfState:      9696624347265201099
+uniqThetaIfState:      10464560810701154023
+----- hash / IfState / ip6 -----
+Row 1:
+──────
+minIfState:            9428555662807296659
+maxIfState:            18253481702148601156
+first_valueIfState:    9428555662807296659
+last_valueIfState:     18253481702148601156
+topKIfState:           8045294331733869941
+groupArrayIfState:     10451014709837753966
+groupUniqArrayIfState: 1954028114836070615
+uniqIfState:           14986562136250471284
+uniqExactIfState:      10032843621916709112
+uniqCombinedIfState:   6379274083567016598
+uniqCombined64IfState: 6379274083567016598
+uniqHLL12IfState:      9181286681186915812
+uniqThetaIfState:      2415188383468008881
+----- finalizeAggregation / IfState / ip4 -----
+Row 1:
+──────
+min:            59.154.201.255
+max:            59.154.202.48
+first_value:    59.154.201.255
+last_value:     59.154.202.48
+topK:           ['59.154.202.48','59.154.202.5','59.154.202.26','59.154.202.25','59.154.202.24','59.154.202.23','59.154.202.22','59.154.202.21','59.154.202.27','59.154.202.19']
+groupArray:     ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8','59.154.202.9','59.154.202.10','59.154.202.11','59.154.202.12','59.154.202.13','59.154.202.14','59.154.202.15','59.154.202.16','59.154.202.17','59.154.202.18','59.154.202.19','59.154.202.20','59.154.202.21','59.154.202.22','59.154.202.23','59.154.202.24','59.154.202.25','59.154.202.26','59.154.202.27','59.154.202.28','59.154.202.29','59.154.202.30','59.154.202.31','59.154.202.32','59.154.202.33','59.154.202.34','59.154.202.35','59.154.202.36','59.154.202.37','59.154.202.38','59.154.202.39','59.154.202.40','59.154.202.41','59.154.202.42','59.154.202.43','59.154.202.44','59.154.202.45','59.154.202.46','59.154.202.47','59.154.202.48']
+groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.48','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
+uniq:           50
+uniqExact:      50
+uniqCombined:   50
+uniqCombined64: 50
+uniqHLL12:      49
+uniqTheta:      50
+----- finalizeAggregation / IfState / ip6 -----
+Row 1:
+──────
+min:            8c:333c::8c:333c:0:0
+max:            ff8b:333c::ff8b:333c:0:0
+first_value:    8c:333c::8c:333c:0:0
+last_value:     ff8b:333c::ff8b:333c:0:0
+topK:           ['ff8b:333c::ff8b:333c:0:0','68c:333c::68c:333c:0:0','e98b:333c::e98b:333c:0:0','e88b:333c::e88b:333c:0:0','e78b:333c::e78b:333c:0:0','e68b:333c::e68b:333c:0:0','e58b:333c::e58b:333c:0:0','e48b:333c::e48b:333c:0:0','ea8b:333c::ea8b:333c:0:0','e28b:333c::e28b:333c:0:0']
+groupArray:     ['8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','e8c:333c::e8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e8c:333c::e8c:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+uniq:           50
+uniqExact:      50
+uniqCombined:   50
+uniqCombined64: 50
+uniqHLL12:      50
+uniqTheta:      50
+----- Arg / hash / State / ip4 -----
+Row 1:
+──────
+argMinState: 13774589216353164344
+argMaxState: 9177365218111013695
+----- Arg / hash / State / ip6 -----
+Row 1:
+──────
+argMinState: 7320668278649617037
+argMaxState: 16598449636475438091
+----- Arg / finalizeAggregation / State / ip4 -----
+Row 1:
+──────
+argMinState: 59.154.201.255
+argMaxState: 59.154.202.48
+----- Arg / finalizeAggregation / State / ip6 -----
+Row 1:
+──────
+argMinState: 8c:333c::8c:333c:0:0
+argMaxState: ff8b:333c::ff8b:333c:0:0
+----- hash / State / ip4 -----
+Row 1:
+──────
+anyState:      12535288824949910799
+anyHeavyState: 9327034461443333306
+anyLastState:  12535288824949910799
+----- hash / State / ip6 -----
+Row 1:
+──────
+anyState:      1383994153676807399
+anyHeavyState: 15555709096566410627
+anyLastState:  1383994153676807399
+----- finalizeAggregation / State / ip4 -----
+Row 1:
+──────
+any:      59.154.201.255
+anyHeavy: 59.154.201.255
+anyLast:  59.154.201.255
+----- finalizeAggregation / State / ip6 -----
+Row 1:
+──────
+any:      dd8b:333c::dd8b:333c:0:0
+anyHeavy: dd8b:333c::dd8b:333c:0:0
+anyLast:  dd8b:333c::dd8b:333c:0:0
diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
new file mode 100644
index 00000000000..133d5287fdb
--- /dev/null
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
@@ -0,0 +1,123 @@
+{# this test checks backward compatibility of aggregate functions States against IPv4, IPv6 types #}
+
+{% set ip4_generator = "select number::UInt32::IPv4 ip from numbers(999999999,50) order by ip" %}
+{% set ip6_generator = "SELECT toIPv6(IPv6NumToString(toFixedString(reinterpretAsFixedString(number)||reinterpretAsFixedString(number), 16))) AS ip FROM numbers(1010011101, 50) order by ip" %}
+{% set ip_generators = {'ip4': ip4_generator, 'ip6': ip6_generator} %}
+
+
+{% set agg_func_list = [ "min", "max", "first_value", "last_value", "topK", "groupArray", "groupUniqArray", "uniq", "uniqExact", "uniqCombined", "uniqCombined64", "uniqHLL12", "uniqTheta" ] %}
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- hash / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     cityHash64(hex( {{ func }}State(ip) )) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- finalizeAggregation / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     finalizeAggregation( {{ func }}State(ip) ) AS {{ func }}{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- hash / IfState / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     cityHash64(hex( {{ func }}IfState(ip, 1) )) AS {{ func }}IfState{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- finalizeAggregation / IfState / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     finalizeAggregation( {{ func }}IfState(ip, 1) ) AS {{ func }}{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+
+{% set agg_func_list = [ "argMin", "argMax" ] %}
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Arg / hash / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     cityHash64(hex( {{ func }}State(ip, ip) )) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Arg / finalizeAggregation / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     finalizeAggregation( {{ func }}State(ip, ip) ) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+{# let's test functions with not deterministic result against 1 row, to make it deterministic #}
+{% set ip4_generator = "select number::UInt32::IPv4 ip from numbers(999999999,1) order by ip" %}
+{% set ip6_generator = "SELECT toIPv6(IPv6NumToString(toFixedString(reinterpretAsFixedString(number)||reinterpretAsFixedString(number), 16))) AS ip FROM numbers(1010011101, 1) order by ip" %}
+
+{% set ip_generators = {'ip4': ip4_generator, 'ip6': ip6_generator} %}
+
+{% set agg_func_list = [ "any", "anyHeavy", "anyLast" ] %}
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- hash / State / {{ generator_name }} -----';
+select
+  {% for func in  agg_func_list  -%}
+     cityHash64(hex( {{ func }}State(ip) )) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- finalizeAggregation / State / {{ generator_name }} -----';
+select
+  {% for func in  agg_func_list  -%}
+     finalizeAggregation( {{ func }}State(ip) ) AS {{ func }}{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+

From 350becba5dcabe9c2cea48dc5ec6ac07033c04e2 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 8 Jun 2023 17:56:35 +0000
Subject: [PATCH 0648/1478] Fixing build.

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

diff --git a/src/Interpreters/TableJoin.cpp b/src/Interpreters/TableJoin.cpp
index c56d1e6039e..cabd0be1aa3 100644
--- a/src/Interpreters/TableJoin.cpp
+++ b/src/Interpreters/TableJoin.cpp
@@ -762,7 +762,7 @@ bool TableJoin::allowParallelHashJoin() const
     return true;
 }
 
-ActionsDAGPtr TableJoin::createJoinedBlockActions(ContextPtr context)
+ActionsDAGPtr TableJoin::createJoinedBlockActions(ContextPtr context) const
 {
     ASTPtr expression_list = rightKeysList();
     auto syntax_result = TreeRewriter(context).analyze(expression_list, columnsFromJoinedTable());
diff --git a/src/Interpreters/TableJoin.h b/src/Interpreters/TableJoin.h
index 096e58d1292..ba3befab59b 100644
--- a/src/Interpreters/TableJoin.h
+++ b/src/Interpreters/TableJoin.h
@@ -217,7 +217,7 @@ public:
     const SizeLimits & sizeLimits() const { return size_limits; }
     VolumePtr getGlobalTemporaryVolume() { return tmp_volume; }
 
-    ActionsDAGPtr createJoinedBlockActions(ContextPtr context);
+    ActionsDAGPtr createJoinedBlockActions(ContextPtr context) const;
 
     bool isEnabledAlgorithm(JoinAlgorithm val) const
     {

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 0649/1478] 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 c96989ca14415707e5dc37958ca36093e8292f46 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Thu, 8 Jun 2023 19:37:52 +0000
Subject: [PATCH 0650/1478] no-fasttest because uniqTheta

---
 .../02751_ip_types_aggregate_functions_states.sql.j2           | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
index 133d5287fdb..708eeab7724 100644
--- a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
@@ -1,3 +1,6 @@
+-- Tags: no-fasttest
+-- no-fasttest because uniqTheta
+
 {# this test checks backward compatibility of aggregate functions States against IPv4, IPv6 types #}
 
 {% set ip4_generator = "select number::UInt32::IPv4 ip from numbers(999999999,50) order by ip" %}

From 172dd4af730e5f592353728eed24535b1a5ea672 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 8 Jun 2023 21:04:00 +0000
Subject: [PATCH 0651/1478] Show correct staleness value in system.query_cache

---
 src/Storages/System/StorageSystemQueryCache.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/System/StorageSystemQueryCache.cpp b/src/Storages/System/StorageSystemQueryCache.cpp
index 245f4b7fd26..3dfc5cf298a 100644
--- a/src/Storages/System/StorageSystemQueryCache.cpp
+++ b/src/Storages/System/StorageSystemQueryCache.cpp
@@ -47,7 +47,7 @@ void StorageSystemQueryCache::fillData(MutableColumns & res_columns, ContextPtr
         res_columns[0]->insert(key.queryStringFromAst()); /// approximates the original query string
         res_columns[1]->insert(QueryCache::QueryCacheEntryWeight()(*query_result));
         res_columns[2]->insert(key.expires_at < std::chrono::system_clock::now());
-        res_columns[3]->insert(!key.is_shared);
+        res_columns[3]->insert(key.is_shared);
         res_columns[4]->insert(key.is_compressed);
         res_columns[5]->insert(std::chrono::system_clock::to_time_t(key.expires_at));
         res_columns[6]->insert(key.ast->getTreeHash().first);

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 0652/1478] 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 0653/1478] 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 0654/1478] 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 0655/1478] 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 0656/1478] 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 0657/1478] 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 0658/1478] 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 96d9b88a201a3ee1b79874e60becc0fc62a10ba3 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Fri, 9 Jun 2023 10:48:13 +0200
Subject: [PATCH 0659/1478] Fix build

---
 contrib/azure-cmake/CMakeLists.txt                             | 2 +-
 src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h | 3 ---
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 1e2a4c97824..9c361db47ca 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)
+if (NOT ENABLE_AZURE_BLOB_STORAGE OR BUILD_STANDALONE_KEEPER OR OS_FREEBSD OR ARCH_PPC64LE)
     message(STATUS "Not using Azure blob storage")
     return()
 endif()
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index b3cda54e752..5a34adb384a 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -8,10 +8,7 @@
 #include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/ObjectStorages/IObjectStorage.h>
 #include <Common/MultiVersion.h>
-
-#if USE_AZURE_BLOB_STORAGE
 #include <azure/storage/blobs.hpp>
-#endif
 
 namespace Poco
 {

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 0660/1478] 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 7ac4349d969819b59555a47d42e92ae070c2faa7 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Fri, 9 Jun 2023 11:21:10 +0200
Subject: [PATCH 0661/1478] Hacking azure function

---
 .../table-functions/azure_blob_storage.md             | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 docs/en/sql-reference/table-functions/azure_blob_storage.md

diff --git a/docs/en/sql-reference/table-functions/azure_blob_storage.md b/docs/en/sql-reference/table-functions/azure_blob_storage.md
new file mode 100644
index 00000000000..f86307b3b85
--- /dev/null
+++ b/docs/en/sql-reference/table-functions/azure_blob_storage.md
@@ -0,0 +1,11 @@
+---
+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).
+

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 0662/1478] 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 0663/1478] 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 0664/1478] 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 16a6190446e7cfc35bfc13f1077c6f32ba430184 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Fri, 9 Jun 2023 13:25:50 +0200
Subject: [PATCH 0665/1478] More strict build Aarch64

---
 contrib/azure-cmake/CMakeLists.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 9c361db47ca..968882dbfcd 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 ARCH_PPC64LE)
+if (NOT ENABLE_AZURE_BLOB_STORAGE OR BUILD_STANDALONE_KEEPER OR OS_FREEBSD OR NOT ARCH_AMD64)
     message(STATUS "Not using Azure blob storage")
     return()
 endif()

From 430a19bb80e497d8c4f5d02af604d78a3d8016c5 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Fri, 9 Jun 2023 13:26:53 +0200
Subject: [PATCH 0666/1478] Better

---
 contrib/azure-cmake/CMakeLists.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 968882dbfcd..887122e7653 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 OR (NOT ARCH_AMD64))
     message(STATUS "Not using Azure blob storage")
     return()
 endif()

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 0667/1478] 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 8f9c74debb002b74180ad534e828714b49bba44a Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 9 Jun 2023 14:31:49 +0300
Subject: [PATCH 0668/1478] Support OPTIMIZE for temporary tables  (#50710)

* Update InterpreterOptimizeQuery.cpp

* Update 02525_different_engines_in_temporary_tables.sql

* Update MergeTreeData.cpp
---
 src/Interpreters/InterpreterOptimizeQuery.cpp                 | 2 +-
 src/Storages/MergeTree/MergeTreeData.cpp                      | 2 +-
 .../02525_different_engines_in_temporary_tables.sql           | 4 +++-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/Interpreters/InterpreterOptimizeQuery.cpp b/src/Interpreters/InterpreterOptimizeQuery.cpp
index a4507391c4e..ae456e8b31d 100644
--- a/src/Interpreters/InterpreterOptimizeQuery.cpp
+++ b/src/Interpreters/InterpreterOptimizeQuery.cpp
@@ -34,7 +34,7 @@ BlockIO InterpreterOptimizeQuery::execute()
 
     getContext()->checkAccess(getRequiredAccess());
 
-    auto table_id = getContext()->resolveStorageID(ast, Context::ResolveOrdinary);
+    auto table_id = getContext()->resolveStorageID(ast);
     StoragePtr table = DatabaseCatalog::instance().getTable(table_id, getContext());
     checkStorageSupportsTransactionsIfNeeded(table, getContext());
     auto metadata_snapshot = table->getInMemoryMetadataPtr();
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 2f6870f8b41..9cca471fddb 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -4789,7 +4789,7 @@ void MergeTreeData::checkAlterPartitionIsPossible(
                 if (partition_ast && partition_ast->all)
                 {
                     if (command.type != PartitionCommand::DROP_PARTITION)
-                        throw DB::Exception(ErrorCodes::SUPPORT_IS_DISABLED, "Only support DETACH PARTITION ALL currently");
+                        throw DB::Exception(ErrorCodes::SUPPORT_IS_DISABLED, "Only support DROP/DETACH PARTITION ALL currently");
                 }
                 else
                     getPartitionIDFromQuery(command.partition, getContext());
diff --git a/tests/queries/0_stateless/02525_different_engines_in_temporary_tables.sql b/tests/queries/0_stateless/02525_different_engines_in_temporary_tables.sql
index 7ebc05dfece..58e9ecab30c 100644
--- a/tests/queries/0_stateless/02525_different_engines_in_temporary_tables.sql
+++ b/tests/queries/0_stateless/02525_different_engines_in_temporary_tables.sql
@@ -7,7 +7,9 @@ CREATE TEMPORARY TABLE table_merge_tree_02525
 ENGINE = MergeTree
 ORDER BY id
 PRIMARY KEY id;
-INSERT INTO table_merge_tree_02525 VALUES (1, 'a'), (2, 'b'), (3, 'c');
+INSERT INTO table_merge_tree_02525 VALUES (1, 'a'), (2, 'b');
+INSERT INTO table_merge_tree_02525 VALUES (3, 'c');
+OPTIMIZE TABLE table_merge_tree_02525 FINAL;
 SELECT * FROM table_merge_tree_02525;
 -- Check that temporary table with MergeTree is not sent to remote servers
 -- The query with remote() should not fail

From ad74189bc2ed4039b0cf129928141e13f6db435b Mon Sep 17 00:00:00 2001
From: flynn <fenglv15@mails.ucas.ac.cn>
Date: Fri, 9 Jun 2023 19:32:45 +0800
Subject: [PATCH 0669/1478] Fix Log family table return wrong rows count after
 truncate (#50585)

* Fix Log family table return wrong rows count after truncate

* fix test

* update test

* update test
---
 src/Storages/StorageLog.cpp                   |  2 ++
 src/Storages/StorageStripeLog.cpp             |  2 ++
 .../02771_log_faminy_truncate_count.reference |  2 ++
 .../02771_log_faminy_truncate_count.sql       | 26 +++++++++++++++++++
 4 files changed, 32 insertions(+)
 create mode 100644 tests/queries/0_stateless/02771_log_faminy_truncate_count.reference
 create mode 100644 tests/queries/0_stateless/02771_log_faminy_truncate_count.sql

diff --git a/src/Storages/StorageLog.cpp b/src/Storages/StorageLog.cpp
index ac68de43332..d8065b8bb3c 100644
--- a/src/Storages/StorageLog.cpp
+++ b/src/Storages/StorageLog.cpp
@@ -775,6 +775,8 @@ void StorageLog::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr
 
     marks_loaded = true;
     num_marks_saved = 0;
+    total_rows = 0;
+    total_bytes = 0;
     getContext()->dropMMappedFileCache();
 }
 
diff --git a/src/Storages/StorageStripeLog.cpp b/src/Storages/StorageStripeLog.cpp
index 5c704d877d1..d8bbd523cbf 100644
--- a/src/Storages/StorageStripeLog.cpp
+++ b/src/Storages/StorageStripeLog.cpp
@@ -424,6 +424,8 @@ void StorageStripeLog::truncate(const ASTPtr &, const StorageMetadataPtr &, Cont
 
     indices_loaded = true;
     num_indices_saved = 0;
+    total_rows = 0;
+    total_bytes = 0;
     getContext()->dropMMappedFileCache();
 }
 
diff --git a/tests/queries/0_stateless/02771_log_faminy_truncate_count.reference b/tests/queries/0_stateless/02771_log_faminy_truncate_count.reference
new file mode 100644
index 00000000000..aa47d0d46d4
--- /dev/null
+++ b/tests/queries/0_stateless/02771_log_faminy_truncate_count.reference
@@ -0,0 +1,2 @@
+0
+0
diff --git a/tests/queries/0_stateless/02771_log_faminy_truncate_count.sql b/tests/queries/0_stateless/02771_log_faminy_truncate_count.sql
new file mode 100644
index 00000000000..3fb22837f5b
--- /dev/null
+++ b/tests/queries/0_stateless/02771_log_faminy_truncate_count.sql
@@ -0,0 +1,26 @@
+DROP TABLE IF EXISTS test_log;
+CREATE TABLE test_log
+(
+    `crypto_name` String,
+    `trade_date` Date
+)
+ENGINE = Log;
+
+INSERT INTO test_log (crypto_name, trade_date) VALUES ('abc', '2021-01-01'), ('def', '2022-02-02');
+
+TRUNCATE TABLE test_log;
+SELECT count() FROM  test_log;
+
+DROP TABLE IF EXISTS test_log;
+CREATE TABLE test_log
+(
+    `crypto_name` String,
+    `trade_date` Date
+)
+ENGINE = StripeLog;
+
+INSERT INTO test_log (crypto_name, trade_date) VALUES ('abc', '2021-01-01'), ('def', '2022-02-02');
+
+TRUNCATE TABLE test_log;
+SELECT count() FROM  test_log;
+DROP TABLE test_log;

From bc2af59278bdd0addeda2bdaedff411117f23f04 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 9 Jun 2023 13:38:30 +0200
Subject: [PATCH 0670/1478] Update autogenerated version to 23.6.1.1 and
 contributors

---
 cmake/autogenerated_versions.txt              | 10 ++--
 .../StorageSystemContributors.generated.cpp   | 49 +++++++++++++++++++
 2 files changed, 54 insertions(+), 5 deletions(-)

diff --git a/cmake/autogenerated_versions.txt b/cmake/autogenerated_versions.txt
index 462529fbc13..015037b2de6 100644
--- a/cmake/autogenerated_versions.txt
+++ b/cmake/autogenerated_versions.txt
@@ -2,11 +2,11 @@
 
 # NOTE: has nothing common with DBMS_TCP_PROTOCOL_VERSION,
 # only DBMS_TCP_PROTOCOL_VERSION should be incremented on protocol changes.
-SET(VERSION_REVISION 54474)
+SET(VERSION_REVISION 54475)
 SET(VERSION_MAJOR 23)
-SET(VERSION_MINOR 5)
+SET(VERSION_MINOR 6)
 SET(VERSION_PATCH 1)
-SET(VERSION_GITHASH 3920eb987f7ed837ada5de8907284adf123f0583)
-SET(VERSION_DESCRIBE v23.5.1.1-testing)
-SET(VERSION_STRING 23.5.1.1)
+SET(VERSION_GITHASH 2fec796e73efda10a538a03af3205ce8ffa1b2de)
+SET(VERSION_DESCRIBE v23.6.1.1-testing)
+SET(VERSION_STRING 23.6.1.1)
 # end of autochange
diff --git a/src/Storages/System/StorageSystemContributors.generated.cpp b/src/Storages/System/StorageSystemContributors.generated.cpp
index 0f307650c9c..f83ee3197fe 100644
--- a/src/Storages/System/StorageSystemContributors.generated.cpp
+++ b/src/Storages/System/StorageSystemContributors.generated.cpp
@@ -83,6 +83,8 @@ const char * auto_contributors[] {
     "Alexey Boykov",
     "Alexey Dushechkin",
     "Alexey Elymanov",
+    "Alexey Gerasimchuck",
+    "Alexey Gerasimchuk",
     "Alexey Gusev",
     "Alexey Ilyukhov",
     "Alexey Ivanov",
@@ -143,6 +145,7 @@ const char * auto_contributors[] {
     "Anmol Arora",
     "Anna",
     "Anna Shakhova",
+    "AnneClickHouse",
     "Anselmo D. Adams",
     "Anthony N. Simon",
     "Anton Ivashkin",
@@ -305,6 +308,7 @@ const char * auto_contributors[] {
     "Dr. Strange Looker",
     "Duc Canh Le",
     "DuckSoft",
+    "Duyet Le",
     "Egor O'Sten",
     "Egor Savin",
     "Eirik",
@@ -321,6 +325,7 @@ const char * auto_contributors[] {
     "Eric",
     "Eric Daniel",
     "Eric Thomas",
+    "Eridanus",
     "Erixonich",
     "Ernest Poletaev",
     "Eugene Galkin",
@@ -347,6 +352,7 @@ const char * auto_contributors[] {
     "Federico Ceratto",
     "Federico Rodriguez",
     "FeehanG",
+    "Feng Kaiyu",
     "FgoDt",
     "Filatenkov Artur",
     "Filipe Caixeta",
@@ -444,6 +450,7 @@ const char * auto_contributors[] {
     "Ivan Milov",
     "Ivan Remen",
     "Ivan Starkov",
+    "Ivan Takarlikov",
     "Ivan Zhukov",
     "Jachen Duschletta",
     "Jack Song",
@@ -477,6 +484,7 @@ const char * auto_contributors[] {
     "John Skopis",
     "Jonatas Freitas",
     "Jonathan-Ackerman",
+    "Jordi",
     "Jordi Villar",
     "Joris Giovannangeli",
     "Jose",
@@ -489,6 +497,7 @@ const char * auto_contributors[] {
     "Jus",
     "Justin Hilliard",
     "Justin de Guzman",
+    "János Benjamin Antal",
     "Kang Liu",
     "Karl Pietrzak",
     "Keiji Yoshida",
@@ -523,6 +532,7 @@ const char * auto_contributors[] {
     "Kruglov Pavel",
     "Krzysztof Góralski",
     "Kseniia Sumarokova",
+    "Kuba Kaflik",
     "Kunal Gurnani",
     "Kuz Le",
     "Ky Li",
@@ -540,6 +550,7 @@ const char * auto_contributors[] {
     "Leopold Schabel",
     "Lev Borodin",
     "Lewinma",
+    "Li Shuai",
     "Li Yin",
     "Liu Cong",
     "LiuCong",
@@ -549,12 +560,14 @@ const char * auto_contributors[] {
     "Lopatin Konstantin",
     "Lorenzo Mangani",
     "Loud_Scream",
+    "Lucas Chang",
     "Lucid Dreams",
     "Luck-Chang",
     "Luis Bosque",
     "Lv Feng",
     "Léo Ercolanelli",
     "M0r64n",
+    "M1eyu2018",
     "MEX7",
     "MaceWindu",
     "MagiaGroz",
@@ -564,8 +577,10 @@ const char * auto_contributors[] {
     "Maksim Fedotov",
     "Maksim Kita",
     "Maksym Sobolyev",
+    "Mal Curtis",
     "Mallik Hassan",
     "Malte",
+    "Manas Alekar",
     "Manuel de la Peña",
     "Marat IDRISOV",
     "Marcelo Rodriguez",
@@ -650,7 +665,9 @@ const char * auto_contributors[] {
     "Milad Arabi",
     "Mingliang Pan",
     "Misko Lee",
+    "Misz606",
     "Mohamad Fadhil",
+    "Mohammad Arab Anvari",
     "Mohammad Hossein Sekhavat",
     "Mojtaba Yaghoobzadeh",
     "Mostafa Dahab",
@@ -764,6 +781,7 @@ const char * auto_contributors[] {
     "Rajkumar Varada",
     "Ramazan Polat",
     "Rami Dridi",
+    "Raqbit",
     "Ravengg",
     "Raúl Marín",
     "Realist007",
@@ -791,6 +809,7 @@ const char * auto_contributors[] {
     "Roman Peshkurov",
     "Roman Tsisyk",
     "Roman Vasin",
+    "Roman Vlasenko",
     "Roman Zhukov",
     "Roy Bellingan",
     "Ruslan",
@@ -825,6 +844,8 @@ const char * auto_contributors[] {
     "Sergey Demurin",
     "Sergey Elantsev",
     "Sergey Fedorov",
+    "Sergey Kazmin",
+    "Sergey Kislov",
     "Sergey Kononenko",
     "Sergey Lazarev",
     "Sergey Magidovich",
@@ -840,6 +861,7 @@ const char * auto_contributors[] {
     "Sergio Tulentsev",
     "SevaCode",
     "Seyed Mehrshad Hosseini",
+    "Shane Andrade",
     "Sherry Wang",
     "Shoh Jahon",
     "Sichen Zhao",
@@ -857,6 +879,8 @@ const char * auto_contributors[] {
     "SmitaRKulkarni",
     "Snow",
     "Sofia Antipushina",
+    "Sorck",
+    "Stanislav Dobrovolschii",
     "Stanislav Pavlovichev",
     "Stas Kelvich",
     "Stas Pavlovichev",
@@ -922,6 +946,8 @@ const char * auto_contributors[] {
     "Vadym Chekan",
     "Vage Ogannisian",
     "Val",
+    "Val Doroshchuk",
+    "Valentin Alexeev",
     "Valera Ryaboshapko",
     "Varinara",
     "Vasily Kozhukhovskiy",
@@ -935,8 +961,10 @@ const char * auto_contributors[] {
     "Veselkov Konstantin",
     "Viachaslau Boben",
     "Victor",
+    "Victor Krasnov",
     "Victor Tarnavsky",
     "Viktor Taranenko",
+    "Vincent",
     "Vincent Bernat",
     "Vitalii S",
     "Vitaliy",
@@ -1018,12 +1046,14 @@ const char * auto_contributors[] {
     "Yuriy Korzhenevskiy",
     "Yury Karpovich",
     "Yury Stankevich",
+    "Yusuke Tanaka",
     "ZhiYong Wang",
     "Zhichang Yu",
     "Zhichun Wu",
     "Zhiguo Zhou",
     "Zhipeng",
     "Zijie Lu",
+    "Ziy1-Tan",
     "Zoran Pandovski",
     "[데이터플랫폼팀] 이호선",
     "a.palagashvili",
@@ -1039,6 +1069,7 @@ const char * auto_contributors[] {
     "akazz",
     "akonyaev",
     "akuzm",
+    "alekar",
     "alekseik1",
     "alekseygolub",
     "alesapin",
@@ -1072,6 +1103,7 @@ const char * auto_contributors[] {
     "asiana21",
     "atereh",
     "attack204",
+    "auxten",
     "avasiliev",
     "avogar",
     "avoiderboi",
@@ -1094,6 +1126,7 @@ const char * auto_contributors[] {
     "caipengxiang",
     "candiduslynx",
     "canenoneko",
+    "cangyin",
     "caspian",
     "cekc",
     "centos7",
@@ -1131,6 +1164,7 @@ const char * auto_contributors[] {
     "damozhaeva",
     "dankondr",
     "daoready",
+    "darkkeks",
     "dasmfm",
     "davydovska",
     "decaseal",
@@ -1189,6 +1223,7 @@ const char * auto_contributors[] {
     "franklee",
     "fredchenbj",
     "freedomDR",
+    "frinkr",
     "fuqi",
     "fuwhu",
     "fuzhe1989",
@@ -1236,6 +1271,7 @@ const char * auto_contributors[] {
     "ikopylov",
     "imgbot[bot]",
     "ip",
+    "ismailakpolat",
     "it1804",
     "ivan-klass",
     "ivan-kush",
@@ -1255,6 +1291,7 @@ const char * auto_contributors[] {
     "jianmei zhang",
     "jinjunzh",
     "jkuklis",
+    "johanngan",
     "jthmath",
     "jun won",
     "jus1096",
@@ -1280,6 +1317,7 @@ const char * auto_contributors[] {
     "kst-morozov",
     "l",
     "l1tsolaiki",
+    "laimuxi",
     "lalex",
     "lanfz",
     "larryluogit",
@@ -1298,8 +1336,10 @@ const char * auto_contributors[] {
     "liang.huang",
     "liangqian",
     "libenwang",
+    "libin",
     "lichengxiang",
     "liding1992",
+    "lihaibo42",
     "linceyou",
     "lincion",
     "lingo-xp",
@@ -1341,6 +1381,7 @@ const char * auto_contributors[] {
     "mastertheknife",
     "mateng0915",
     "mateng915",
+    "mauidude",
     "maxim",
     "maxim-babenko",
     "maxkuzn",
@@ -1352,6 +1393,7 @@ const char * auto_contributors[] {
     "meo",
     "meoww-bot",
     "mergify[bot]",
+    "merlllle",
     "metahys",
     "mf5137",
     "mfridental",
@@ -1398,6 +1440,7 @@ const char * auto_contributors[] {
     "olevino",
     "olevino999",
     "olgarev",
+    "ongkong",
     "orantius",
     "p0ny",
     "palasonicq",
@@ -1473,6 +1516,7 @@ const char * auto_contributors[] {
     "spongedc",
     "spume",
     "spyros87",
+    "sslouis",
     "stan",
     "stavrolia",
     "stepenhu",
@@ -1518,6 +1562,7 @@ const char * auto_contributors[] {
     "vicdashkov",
     "vicgao",
     "vinity",
+    "vitac",
     "vitstn",
     "vivarum",
     "vladimir golovchenko",
@@ -1527,6 +1572,7 @@ const char * auto_contributors[] {
     "vzakaznikov",
     "wangchao",
     "wangdh15",
+    "wangxiaobo",
     "weeds085490",
     "whysage",
     "wineternity",
@@ -1537,6 +1583,7 @@ const char * auto_contributors[] {
     "xieyichen",
     "xinhuitian",
     "xlwh",
+    "xmy",
     "yakkomajuri",
     "yakov-olkhovskiy",
     "yandd",
@@ -1589,6 +1636,7 @@ const char * auto_contributors[] {
     "zvvr",
     "zxc111",
     "zxealous",
+    "zy-kkk",
     "zzsmdfj",
     "Šimon Podlipský",
     "Александр",
@@ -1605,6 +1653,7 @@ const char * auto_contributors[] {
     "Сундуков Алексей",
     "万康",
     "何李夫",
+    "你不要过来啊",
     "凌涛",
     "刘浩林",
     "刘陶峰",

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 0671/1478] 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 0672/1478] 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 61a20468f7429866c3125bd7c55627072de7ea5d Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Fri, 9 Jun 2023 11:53:29 +0000
Subject: [PATCH 0673/1478] Update version_date.tsv and changelogs after
 v23.5.1.3174-stable

---
 SECURITY.md                            |   3 +-
 docker/keeper/Dockerfile               |   2 +-
 docker/server/Dockerfile.alpine        |   2 +-
 docker/server/Dockerfile.ubuntu        |   2 +-
 docs/changelogs/v23.5.1.3174-stable.md | 599 +++++++++++++++++++++++++
 utils/list-versions/version_date.tsv   |   1 +
 6 files changed, 605 insertions(+), 4 deletions(-)
 create mode 100644 docs/changelogs/v23.5.1.3174-stable.md

diff --git a/SECURITY.md b/SECURITY.md
index 75c1a9d7d6a..1864eb6e9e5 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -13,9 +13,10 @@ The following versions of ClickHouse server are currently being supported with s
 
 | Version | Supported |
 |:-|:-|
+| 23.5 | ✔️ |
 | 23.4 | ✔️ |
 | 23.3 | ✔️ |
-| 23.2 | ✔️ |
+| 23.2 | ❌ |
 | 23.1 | ❌ |
 | 22.12 | ❌ |
 | 22.11 | ❌ |
diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 73da4515ff4..7190ef4d649 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.4.2.11"
+ARG VERSION="23.5.1.3174"
 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 1a5d2071f6b..ca966b16a2d 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.4.2.11"
+ARG VERSION="23.5.1.3174"
 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 8792d419a16..c82ac592120 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.4.2.11"
+ARG VERSION="23.5.1.3174"
 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.1.3174-stable.md b/docs/changelogs/v23.5.1.3174-stable.md
new file mode 100644
index 00000000000..01e5425de71
--- /dev/null
+++ b/docs/changelogs/v23.5.1.3174-stable.md
@@ -0,0 +1,599 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.5.1.3174-stable (2fec796e73e) FIXME as compared to v23.4.1.1943-stable (3920eb987f7)
+
+#### Backward Incompatible Change
+* Make local object storage work consistently with s3 object storage, fix problem with append (closes [#48465](https://github.com/ClickHouse/ClickHouse/issues/48465)), make it configurable as independent storage. The change is backward incompatible because cache on top of local object storage is not incompatible to previous versions. [#48791](https://github.com/ClickHouse/ClickHouse/pull/48791) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Date_trunc function to always return datetime type. [#48851](https://github.com/ClickHouse/ClickHouse/pull/48851) ([Shane Andrade](https://github.com/mauidude)).
+* Remove the experimental feature "in-memory data parts". The data format is still supported, but the settings are no-op, and compact or wide parts will be used instead. This closes [#45409](https://github.com/ClickHouse/ClickHouse/issues/45409). [#49429](https://github.com/ClickHouse/ClickHouse/pull/49429) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Changed default values of settings parallelize_output_from_storages and input_format_parquet_preserve_order. This allows ClickHouse to reorder rows when reading from files (e.g. CSV or Parquet), greatly improving performance in many cases. To restore the old behavior of preserving order, use `parallelize_output_from_storages = 0`, `input_format_parquet_preserve_order = 1`. [#49479](https://github.com/ClickHouse/ClickHouse/pull/49479) ([Michael Kolupaev](https://github.com/al13n321)).
+* Make projections production-ready. Add the `optimize_use_projections` setting to control whether the projections will be selected for SELECT queries. The setting `allow_experimental_projection_optimization` is obsolete and does nothing. [#49719](https://github.com/ClickHouse/ClickHouse/pull/49719) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Mark joinGet() as non deterministic (so as dictGet). [#49843](https://github.com/ClickHouse/ClickHouse/pull/49843) ([Azat Khuzhin](https://github.com/azat)).
+* 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)).
+
+#### New Feature
+* Password type in queries like `CREATE USER u IDENTIFIED BY 'p'` will be automatically set according to the setting `default_password_type` in the `config.xml` on the server. Closes [#42915](https://github.com/ClickHouse/ClickHouse/issues/42915). [#44674](https://github.com/ClickHouse/ClickHouse/pull/44674) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Add bcrypt password authentication type. Closes [#34599](https://github.com/ClickHouse/ClickHouse/issues/34599). [#44905](https://github.com/ClickHouse/ClickHouse/pull/44905) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Added `system.zookeeper_connection` table that shows information about ZooKeeper connections. [#45245](https://github.com/ClickHouse/ClickHouse/pull/45245) ([mateng915](https://github.com/mateng0915)).
+* 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)).
+* Extend `first_value` and `last_value` to accept null. [#46467](https://github.com/ClickHouse/ClickHouse/pull/46467) ([lgbo](https://github.com/lgbo-ustc)).
+* Add server and format settings `display_secrets_in_show_and_select` for displaying secrets of tables, databases, table functions, and dictionaries. Add privilege `displaySecretsInShowAndSelect` controlling which users can view secrets. [#46528](https://github.com/ClickHouse/ClickHouse/pull/46528) ([Mike Kot](https://github.com/myrrc)).
+* 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)).
+* Added native ClickHouse Keeper CLI Client. [#47414](https://github.com/ClickHouse/ClickHouse/pull/47414) ([pufit](https://github.com/pufit)).
+* The query cache can now be used for production workloads. [#47977](https://github.com/ClickHouse/ClickHouse/pull/47977) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix a bug that prevented the use of `CASE` without an `ELSE` branch and extended `transform` to deal with more types. Also fix some bugs 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)).
+* 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)).
+* Support statement `SHOW INDEX` to improve compatibility with MySQL. [#49158](https://github.com/ClickHouse/ClickHouse/pull/49158) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add virtual column `_file` and `_path` support to table function `url`. - Impove error message for table function `url`. - resolves [#49231](https://github.com/ClickHouse/ClickHouse/issues/49231) - resolves [#49232](https://github.com/ClickHouse/ClickHouse/issues/49232). [#49356](https://github.com/ClickHouse/ClickHouse/pull/49356) ([Ziyi Tan](https://github.com/Ziy1-Tan)).
+* Adding the `grants` field in the users.xml file, which allows specifying grants for users. [#49381](https://github.com/ClickHouse/ClickHouse/pull/49381) ([pufit](https://github.com/pufit)).
+* Add alias `str_to_map` and `mapfromstring` for `extractkeyvaluepairs`. closes [#47185](https://github.com/ClickHouse/ClickHouse/issues/47185). [#49466](https://github.com/ClickHouse/ClickHouse/pull/49466) ([flynn](https://github.com/ucasfl)).
+* Support full/right join by using grace hash join algorithm. [#49483](https://github.com/ClickHouse/ClickHouse/pull/49483) ([lgbo](https://github.com/lgbo-ustc)).
+* `WITH FILL` modifier groups filling by sorting prefix. Controlled by `use_with_fill_by_sorting_prefix` setting (enabled by default). Related to [#33203](https://github.com/ClickHouse/ClickHouse/issues/33203)#issuecomment-1418736794. [#49503](https://github.com/ClickHouse/ClickHouse/pull/49503) ([Igor Nikonov](https://github.com/devcrafter)).
+* Add SQL functions for entropy-learned hashing. [#49656](https://github.com/ClickHouse/ClickHouse/pull/49656) ([Robert Schulze](https://github.com/rschu1ze)).
+* Clickhouse-client now accepts queries after "--multiquery" when "--query" (or "-q") is absent. example: clickhouse-client --multiquery "select 1; select 2;". [#49870](https://github.com/ClickHouse/ClickHouse/pull/49870) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Add separate `handshake_timeout` for receiving Hello packet from replica. Closes [#48854](https://github.com/ClickHouse/ClickHouse/issues/48854). [#49948](https://github.com/ClickHouse/ClickHouse/pull/49948) ([Kruglov Pavel](https://github.com/Avogar)).
+* New setting s3_max_inflight_parts_for_one_file sets the limit of concurrently loaded parts with multipart upload request in scope of one file. [#49961](https://github.com/ClickHouse/ClickHouse/pull/49961) ([Sema Checherinda](https://github.com/CheSema)).
+* Geographical data types (`Point`, `Ring`, `Polygon`, and `MultiPolygon`) are production-ready. [#50022](https://github.com/ClickHouse/ClickHouse/pull/50022) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Added a function "space()" which repeats a space as many times as specified. [#50103](https://github.com/ClickHouse/ClickHouse/pull/50103) ([Robert Schulze](https://github.com/rschu1ze)).
+* Added --input_format_csv_trim_whitespaces option. [#50215](https://github.com/ClickHouse/ClickHouse/pull/50215) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Added the dictGetAll function for regexp tree dictionaries to return values from multiple matches as arrays. Closes [#50254](https://github.com/ClickHouse/ClickHouse/issues/50254). [#50255](https://github.com/ClickHouse/ClickHouse/pull/50255) ([Johann Gan](https://github.com/johanngan)).
+* Added toLastDayOfWeek() function to round a date or a date with time up to the nearest Saturday or Sunday. [#50315](https://github.com/ClickHouse/ClickHouse/pull/50315) ([Victor Krasnov](https://github.com/sirvickr)).
+* Ability to ignore a skip index by specifying `ignore_data_skipping_indices`. [#50329](https://github.com/ClickHouse/ClickHouse/pull/50329) ([Boris Kuschel](https://github.com/bkuschel)).
+* Revert 'Add SQL functions for entropy-learned hashing'. [#50416](https://github.com/ClickHouse/ClickHouse/pull/50416) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add `system.user_processes` table and `SHOW USER PROCESSES` query to show memory info and ProfileEvents on user level. [#50492](https://github.com/ClickHouse/ClickHouse/pull/50492) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)).
+* Added storage engine `AzureBlobStorage` and `azure_blob_storage` table function. The supported set of features is very similar to storage/table function `S3`. Implements [#19307](https://github.com/ClickHouse/ClickHouse/issues/19307). [#50604](https://github.com/ClickHouse/ClickHouse/pull/50604) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+
+#### Performance Improvement
+* Compress marks and primary key by default. It significantly reduces the cold query time. Upgrade notes: the support for compressed marks and primary key has been added in version 22.9. If you turned on compressed marks or primary key or installed version 23.5 or newer, which has compressed marks or primary key on by default, you will not be able to downgrade to version 22.8 or earlier. You can also explicitly disable compressed marks or primary keys by specifying the `compress_marks` and `compress_primary_key` settings in the `<merge_tree>` section of the server configuration file. **Upgrade notes:** If you upgrade from versions prior to 22.9, you should either upgrade all replicas at once or disable the compression before upgrade, or upgrade through an intermediate version, where the compressed marks are supported but not enabled by default, such as 23.3. [#42587](https://github.com/ClickHouse/ClickHouse/pull/42587) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* When reading from multiple files reduce parallel parsing threads for each file resolves [#42192](https://github.com/ClickHouse/ClickHouse/issues/42192). [#46661](https://github.com/ClickHouse/ClickHouse/pull/46661) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Do not store blocks in `ANY` hash join if nothing is inserted. [#48633](https://github.com/ClickHouse/ClickHouse/pull/48633) ([vdimir](https://github.com/vdimir)).
+* Fixes aggregate combinator `-If` when JIT compiled. Closes [#48120](https://github.com/ClickHouse/ClickHouse/issues/48120). [#49083](https://github.com/ClickHouse/ClickHouse/pull/49083) ([Igor Nikonov](https://github.com/devcrafter)).
+* For reading from remote tables we use smaller tasks (instead of reading the whole part) to make tasks stealing work * task size is determined by size of columns to read * always use 1mb buffers for reading from s3 * boundaries of cache segments aligned to 1mb so they have decent size even with small tasks. it also should prevent fragmentation. [#49287](https://github.com/ClickHouse/ClickHouse/pull/49287) ([Nikita Taranov](https://github.com/nickitat)).
+* Default size of a read buffer for reading from local filesystem changed to a slightly better value. Also two new settings are introduced: `max_read_buffer_size_local_fs` and `max_read_buffer_size_remote_fs`. [#49321](https://github.com/ClickHouse/ClickHouse/pull/49321) ([Nikita Taranov](https://github.com/nickitat)).
+* Improve memory usage and speed of `SPARSE_HASHED`/`HASHED` dictionaries (e.g. `SPARSE_HASHED` now eats 2.6x less memory, and is ~2x faster). [#49380](https://github.com/ClickHouse/ClickHouse/pull/49380) ([Azat Khuzhin](https://github.com/azat)).
+* Use aggregate projection only if it reads fewer granules than normal reading. It should help in case if query hits the PK of the table, but not the projection. Fixes [#49150](https://github.com/ClickHouse/ClickHouse/issues/49150). [#49417](https://github.com/ClickHouse/ClickHouse/pull/49417) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Optimize PODArray::resize_fill() callers. [#49459](https://github.com/ClickHouse/ClickHouse/pull/49459) ([Azat Khuzhin](https://github.com/azat)).
+* Optimize the system.query_log and system.query_thread_log tables by applying LowCardinality when appropriate. The queries over these tables will be faster. [#49530](https://github.com/ClickHouse/ClickHouse/pull/49530) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Better performance when reading local Parquet files (through parallel reading). [#49539](https://github.com/ClickHouse/ClickHouse/pull/49539) ([Michael Kolupaev](https://github.com/al13n321)).
+* Improve the performance of `RIGHT/FULL JOIN` by up to 2 times in certain scenarios, especially when joining a small left table with a large right table. [#49585](https://github.com/ClickHouse/ClickHouse/pull/49585) ([lgbo](https://github.com/lgbo-ustc)).
+* Improve performance of BLAKE3 by 11% by enabling LTO for Rust. [#49600](https://github.com/ClickHouse/ClickHouse/pull/49600) ([Azat Khuzhin](https://github.com/azat)).
+* Optimize the structure of the `system.opentelemetry_span_log`. Use `LowCardinality` where appropriate. Although this table is generally stupid (it is using the Map data type even for common attributes), it will be slightly better. [#49647](https://github.com/ClickHouse/ClickHouse/pull/49647) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Try to reserve hash table's size in `grace_hash` join. [#49816](https://github.com/ClickHouse/ClickHouse/pull/49816) ([lgbo](https://github.com/lgbo-ustc)).
+* As is addresed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as **toYear, toYYYYMM**, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. The [prototype](https://github.com/ZhiguoZh/ClickHouse/commit/c7f1753f0c9363a19d95fa46f1cfed1d9f505ee0) shows that, with all identified date converters optimized, the overall QPS of the 13 queries is enhanced by **~11%** on the ICX server (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads). [#50062](https://github.com/ClickHouse/ClickHouse/pull/50062) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
+* Parallel merge of `uniqExactIf` states. Closes [#49885](https://github.com/ClickHouse/ClickHouse/issues/49885). [#50285](https://github.com/ClickHouse/ClickHouse/pull/50285) ([flynn](https://github.com/ucasfl)).
+* As is addresed in issue [#49748](https://github.com/ClickHouse/ClickHouse/issues/49748), the predicates with date converters, such as toYear, toYYYYMM, could be rewritten with the equivalent date (YYYY-MM-DD) comparisons at the AST level. And this transformation could bring performance improvement as it is free from the expensive date converter and the comparison between dates (or integers in the low level representation) is quite low-cost. [#50307](https://github.com/ClickHouse/ClickHouse/pull/50307) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
+* Parallel merging supported for `uniqExact` with modifiers `-Array`, `-Merge`, `-OrNull`, `-State`. [#50413](https://github.com/ClickHouse/ClickHouse/pull/50413) ([flynn](https://github.com/ucasfl)).
+* Enable LZ4_FAST_DEC_LOOP for Arm LZ4 to get 5% of decompression speed. [#50588](https://github.com/ClickHouse/ClickHouse/pull/50588) ([Daniel Kutenin](https://github.com/danlark1)).
+
+#### Improvement
+* Add support for CGroup version 2 for asynchronous metrics about the memory usage and availability. This closes [#37983](https://github.com/ClickHouse/ClickHouse/issues/37983). [#45999](https://github.com/ClickHouse/ClickHouse/pull/45999) ([sichenzhao](https://github.com/sichenzhao)).
+* Cluster table functions should always skip unavailable shards. close [#46314](https://github.com/ClickHouse/ClickHouse/issues/46314). [#46765](https://github.com/ClickHouse/ClickHouse/pull/46765) ([zk_kiger](https://github.com/zk-kiger)).
+* When your csv file contains empty columns, like： ```. [#47496](https://github.com/ClickHouse/ClickHouse/pull/47496) ([你不要过来啊](https://github.com/iiiuwioajdks)).
+* ROW POLICY for all tables that belong to a DATABASE. [#47640](https://github.com/ClickHouse/ClickHouse/pull/47640) ([Ilya Golshtein](https://github.com/ilejn)).
+* Add Google Cloud Storage S3 compatible table function `gcs`. Like the `oss` and `cosn` functions, it is just an alias over the `s3` table function, and it does not bring any new features. [#47815](https://github.com/ClickHouse/ClickHouse/pull/47815) ([Kuba Kaflik](https://github.com/jkaflik)).
+* Add ability to use strict parts size for S3 (compatibility with CloudFlare R2 S3 Storage). [#48492](https://github.com/ClickHouse/ClickHouse/pull/48492) ([Azat Khuzhin](https://github.com/azat)).
+* Added new columns with info about `Replicated` database replicas to `system.clusters`: `database_shard_name`, `database_replica_name`, `is_active`. Added an optional `FROM SHARD` clause to `SYSTEM DROP DATABASE REPLICA` query. [#48548](https://github.com/ClickHouse/ClickHouse/pull/48548) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Add a new column `zookeeper_name` in system.replicas, to indicate on which (auxiliary) zookeeper cluster the replicated table's metadata is stored. [#48549](https://github.com/ClickHouse/ClickHouse/pull/48549) ([cangyin](https://github.com/cangyin)).
+* `IN` operator support compare `Date` and `Date32`. Closes [#48736](https://github.com/ClickHouse/ClickHouse/issues/48736). [#48806](https://github.com/ClickHouse/ClickHouse/pull/48806) ([flynn](https://github.com/ucasfl)).
+* Support for erasure codes in HDFS, author: @M1eyu2018, @tomscut. [#48833](https://github.com/ClickHouse/ClickHouse/pull/48833) ([M1eyu](https://github.com/M1eyu2018)).
+* The query cache can now supports queries with totals and extremes modifier. [#48853](https://github.com/ClickHouse/ClickHouse/pull/48853) ([Robert Schulze](https://github.com/rschu1ze)).
+* Introduces new keyword `INTO OUTFILE 'file.txt' APPEND`. [#48880](https://github.com/ClickHouse/ClickHouse/pull/48880) ([alekar](https://github.com/alekar)).
+* The `BACKUP` command will not decrypt data from encrypted disks while making a backup. Instead the data will be stored in a backup in encrypted form. Such backups can be restored only to an encrypted disk with the same (or extended) list of encryption keys. [#48896](https://github.com/ClickHouse/ClickHouse/pull/48896) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Keeper improvement: add `CheckNotExists` request to Keeper. [#48897](https://github.com/ClickHouse/ClickHouse/pull/48897) ([Antonio Andelic](https://github.com/antonio2368)).
+* Implement SYSTEM DROP REPLICA from auxillary ZooKeeper clusters, may be close [#48931](https://github.com/ClickHouse/ClickHouse/issues/48931). [#48932](https://github.com/ClickHouse/ClickHouse/pull/48932) ([wangxiaobo](https://github.com/wzb5212)).
+* Add Array data type to MongoDB. Closes [#48598](https://github.com/ClickHouse/ClickHouse/issues/48598). [#48983](https://github.com/ClickHouse/ClickHouse/pull/48983) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Keeper performance improvements: avoid serializing same request twice while processing. Cache deserialization results of large requests. Controlled by new coordination setting `min_request_size_for_cache`. [#49004](https://github.com/ClickHouse/ClickHouse/pull/49004) ([Antonio Andelic](https://github.com/antonio2368)).
+* Support storing `Interval` data types in tables. [#49085](https://github.com/ClickHouse/ClickHouse/pull/49085) ([larryluogit](https://github.com/larryluogit)).
+* Add support for size suffixes in quota creation statement parameters. [#49087](https://github.com/ClickHouse/ClickHouse/pull/49087) ([Eridanus](https://github.com/Eridanus117)).
+* Allow using `ntile` window function without explicit window frame definition: `ntile(3) OVER (ORDER BY a)`, close [#46763](https://github.com/ClickHouse/ClickHouse/issues/46763). [#49093](https://github.com/ClickHouse/ClickHouse/pull/49093) ([vdimir](https://github.com/vdimir)).
+* Added settings (`number_of_mutations_to_delay`, `number_of_mutations_to_throw`) to delay or throw `ALTER` queries that create mutations (`ALTER UPDATE`, `ALTER DELETE`, `ALTER MODIFY COLUMN`, ...) in case when table already has a lot of unfinished mutations. [#49117](https://github.com/ClickHouse/ClickHouse/pull/49117) ([Anton Popov](https://github.com/CurtizJ)).
+* Added setting `async_insert` for `MergeTables`. It has the same meaning as query-level setting `async_insert` and enables asynchronous inserts for specific table. Note: it doesn't take effect for insert queries from `clickhouse-client`, use query-level setting in that case. [#49122](https://github.com/ClickHouse/ClickHouse/pull/49122) ([Anton Popov](https://github.com/CurtizJ)).
+* Catch exception from `create_directories` in filesystem cache. [#49203](https://github.com/ClickHouse/ClickHouse/pull/49203) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Copies embedded examples to a new field `example` in `system.functions` to supplement the field `description`. [#49222](https://github.com/ClickHouse/ClickHouse/pull/49222) ([Dan Roscigno](https://github.com/DanRoscigno)).
+* Enable connection options for the MongoDB dictionary. Example: ``` xml <source> <mongodb> <host>localhost</host> <port>27017</port> <user></user> <password></password> <db>test</db> <collection>dictionary_source</collection> <options>ssl=true</options> </mongodb> </source> ``` ### Documentation entry for user-facing changes. [#49225](https://github.com/ClickHouse/ClickHouse/pull/49225) ([MikhailBurdukov](https://github.com/MikhailBurdukov)).
+* Added an alias `asymptotic` for `asymp` computational method for `kolmogorovSmirnovTest`. Improved documentation. [#49286](https://github.com/ClickHouse/ClickHouse/pull/49286) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Aggregation function groupBitAnd/Or/Xor now work on signed integer data. This makes them consistent with the behavior of scalar functions bitAnd/Or/Xor. [#49292](https://github.com/ClickHouse/ClickHouse/pull/49292) ([exmy](https://github.com/exmy)).
+* Split function-documentation into more fine-granular fields. [#49300](https://github.com/ClickHouse/ClickHouse/pull/49300) ([Robert Schulze](https://github.com/rschu1ze)).
+* Introduced settings: - `merge_max_block_size_bytes` to limit the amount of memory used for background operations. - `vertical_merge_algorithm_min_bytes_to_activate` to add another condition to activate vertical merges. [#49313](https://github.com/ClickHouse/ClickHouse/pull/49313) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Use multiple threads shared between all tables within a server to load outdated data parts. The the size of the pool and its queue is controlled by `max_outdated_parts_loading_thread_pool_size` and `outdated_part_loading_thread_pool_queue_size` settings. [#49317](https://github.com/ClickHouse/ClickHouse/pull/49317) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Don't overestimate the size of processed data for `LowCardinality` columns when they share dictionaries between blocks. This closes [#49322](https://github.com/ClickHouse/ClickHouse/issues/49322). See also [#48745](https://github.com/ClickHouse/ClickHouse/issues/48745). [#49323](https://github.com/ClickHouse/ClickHouse/pull/49323) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Parquet writer now uses reasonable row group size when invoked through OUTFILE. [#49325](https://github.com/ClickHouse/ClickHouse/pull/49325) ([Michael Kolupaev](https://github.com/al13n321)).
+* Allow restricted keywords like `ARRAY` as an alias if the alias is quoted. Closes [#49324](https://github.com/ClickHouse/ClickHouse/issues/49324). [#49360](https://github.com/ClickHouse/ClickHouse/pull/49360) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Added possibility to use temporary tables in FROM part of ATTACH PARTITION FROM and REPLACE PARTITION FROM. [#49436](https://github.com/ClickHouse/ClickHouse/pull/49436) ([Roman Vasin](https://github.com/rvasin)).
+* Data parts loading and deletion jobs were moved to shared server-wide pools instead of per-table pools. Pools sizes are controlled via settings `max_active_parts_loading_thread_pool_size`, `max_outdated_parts_loading_thread_pool_size` and `max_parts_cleaning_thread_pool_size` in top-level config. Table-level settings `max_part_loading_threads` and `max_part_removal_threads` became obsolete. [#49474](https://github.com/ClickHouse/ClickHouse/pull/49474) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Allow `?password=pass` in URL. Password is replaced in browser history. [#49505](https://github.com/ClickHouse/ClickHouse/pull/49505) ([Mike Kot](https://github.com/myrrc)).
+* Allow zero objects in ReadBufferFromRemoteFSGather (because empty files are not backuped, so we might end up with zero blobs in metadata file). Closes [#49480](https://github.com/ClickHouse/ClickHouse/issues/49480). [#49519](https://github.com/ClickHouse/ClickHouse/pull/49519) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Attach thread MemoryTracker to `total_memory_tracker` after `ThreadGroup` detached. [#49527](https://github.com/ClickHouse/ClickHouse/pull/49527) ([Dmitry Novik](https://github.com/novikd)).
+* Make `Pretty` formats prettier: squash blocks if not much time passed since the output of the previous block. This is controlled by a new setting `output_format_pretty_squash_ms` (100ms by default). This closes [#49153](https://github.com/ClickHouse/ClickHouse/issues/49153). [#49537](https://github.com/ClickHouse/ClickHouse/pull/49537) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add initial support to do JOINs with pure parallel replicas. [#49544](https://github.com/ClickHouse/ClickHouse/pull/49544) ([Raúl Marín](https://github.com/Algunenano)).
+* Fix parameterized views when query parameter used multiple times in the query. [#49556](https://github.com/ClickHouse/ClickHouse/pull/49556) ([Azat Khuzhin](https://github.com/azat)).
+* Release memory allocated for the last sent ProfileEvents snapshot in the context of a query. Followup [#47564](https://github.com/ClickHouse/ClickHouse/issues/47564). [#49561](https://github.com/ClickHouse/ClickHouse/pull/49561) ([Dmitry Novik](https://github.com/novikd)).
+* Function "makeDate" now provides a MySQL-compatible overload (year & day of the year argument). [#49603](https://github.com/ClickHouse/ClickHouse/pull/49603) ([Robert Schulze](https://github.com/rschu1ze)).
+* More parallelism on `Outdated` parts removal with "zero-copy replication". [#49630](https://github.com/ClickHouse/ClickHouse/pull/49630) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Reduced number of `List` ZooKeeper requests when selecting parts to merge and a lot of partitions do not have anything to merge. [#49637](https://github.com/ClickHouse/ClickHouse/pull/49637) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Support `dictionary` table function for `RegExpTreeDictionary`. [#49666](https://github.com/ClickHouse/ClickHouse/pull/49666) ([Han Fei](https://github.com/hanfei1991)).
+* Added weighted fair IO scheduling policy. Added dynamic resource manager, which allows IO scheduling hierarchy to be updated in runtime w/o server restarts. [#49671](https://github.com/ClickHouse/ClickHouse/pull/49671) ([Sergei Trifonov](https://github.com/serxa)).
+* Add compose request after multipart upload to GCS. This enables the usage of copy operation on objects uploaded with the multipart upload. It's recommended to set `s3_strict_upload_part_size` to some value because compose request can fail on objects created with parts of different sizes. [#49693](https://github.com/ClickHouse/ClickHouse/pull/49693) ([Antonio Andelic](https://github.com/antonio2368)).
+* Improve the "best-effort" parsing logic to accept `key_value_delimiter` as a valid part of the value. This also simplifies branching and might even speed up things a bit. [#49760](https://github.com/ClickHouse/ClickHouse/pull/49760) ([Arthur Passos](https://github.com/arthurpassos)).
+* Facilitate profile data association and aggregation for the same query. [#49777](https://github.com/ClickHouse/ClickHouse/pull/49777) ([helifu](https://github.com/helifu)).
+* System log tables can now have custom sorting keys. [#49778](https://github.com/ClickHouse/ClickHouse/pull/49778) ([helifu](https://github.com/helifu)).
+* A new field 'partitions' is used to indicate which partitions are participating in the calculation. [#49779](https://github.com/ClickHouse/ClickHouse/pull/49779) ([helifu](https://github.com/helifu)).
+* Added `enable_the_endpoint_id_with_zookeeper_name_prefix` setting for `ReplicatedMergeTree` (disabled by default). When enabled, it adds ZooKeeper cluster name to table's interserver communication endpoint. It avoids `Duplicate interserver IO endpoint` errors when having replicated tables with the same path, but different auxiliary ZooKeepers. [#49780](https://github.com/ClickHouse/ClickHouse/pull/49780) ([helifu](https://github.com/helifu)).
+* Add query parameters to clickhouse-local. Closes [#46561](https://github.com/ClickHouse/ClickHouse/issues/46561). [#49785](https://github.com/ClickHouse/ClickHouse/pull/49785) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Qpl_deflate codec lower the minimum simd version to sse 4.2. [doc change in qpl](https://github.com/intel/qpl/commit/3f8f5cea27739f5261e8fd577dc233ffe88bf679) - intel® qpl relies on a run-time kernels dispatcher and cpuid check to choose the best available implementation(sse/avx2/avx512) - restructured cmakefile for qpl build in clickhouse to align with latest upstream qpl. [#49811](https://github.com/ClickHouse/ClickHouse/pull/49811) ([jasperzhu](https://github.com/jinjunzh)).
+* Allow loading dictionaries and functions from YAML by default. In previous versions, it required editing the `dictionaries_config` or `user_defined_executable_functions_config` in the configuration file, as they expected `*.xml` files. [#49812](https://github.com/ClickHouse/ClickHouse/pull/49812) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* The Kafka table engine now allows to use alias columns. [#49824](https://github.com/ClickHouse/ClickHouse/pull/49824) ([Aleksandr Musorin](https://github.com/AVMusorin)).
+* Add setting to limit the max number of pairs produced by extractKeyValuePairs, safeguard to avoid using way too much memory. [#49836](https://github.com/ClickHouse/ClickHouse/pull/49836) ([Arthur Passos](https://github.com/arthurpassos)).
+* 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)).
+* `bitHammingDistance` function support `String` and `FixedString` data type. Closes [#48827](https://github.com/ClickHouse/ClickHouse/issues/48827). [#49858](https://github.com/ClickHouse/ClickHouse/pull/49858) ([flynn](https://github.com/ucasfl)).
+* Fix timeout resetting errors in the client on OS X. [#49863](https://github.com/ClickHouse/ClickHouse/pull/49863) ([alekar](https://github.com/alekar)).
+* Add support for big integers, such as UInt128, Int128, UInt256, and Int256 in the function `bitCount`. This enables Hamming distance over large bit masks for AI applications. [#49867](https://github.com/ClickHouse/ClickHouse/pull/49867) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* This PR makes fingerprints to be used instead of key IDs in encrypted disks. [#49882](https://github.com/ClickHouse/ClickHouse/pull/49882) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Add UUID data type to PostgreSQL. Closes [#49739](https://github.com/ClickHouse/ClickHouse/issues/49739). [#49894](https://github.com/ClickHouse/ClickHouse/pull/49894) ([Nikolay Degterinsky](https://github.com/evillique)).
+* 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)).
+* Function toUnixTimestamp() now accepts Date and Date32 arguments. [#49989](https://github.com/ClickHouse/ClickHouse/pull/49989) ([Victor Krasnov](https://github.com/sirvickr)).
+* Charge only server memory for dictionaries. [#49995](https://github.com/ClickHouse/ClickHouse/pull/49995) ([Azat Khuzhin](https://github.com/azat)).
+* Add schema inference to PostgreSQL, MySQL, MeiliSearch, and SQLite table engines. Closes [#49972](https://github.com/ClickHouse/ClickHouse/issues/49972). [#50000](https://github.com/ClickHouse/ClickHouse/pull/50000) ([Nikolay Degterinsky](https://github.com/evillique)).
+* The server will allow using the `SQL_*` settings such as `SQL_AUTO_IS_NULL` as no-ops for MySQL compatibility. This closes [#49927](https://github.com/ClickHouse/ClickHouse/issues/49927). [#50013](https://github.com/ClickHouse/ClickHouse/pull/50013) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Preserve initial_query_id for ON CLUSTER queries, which is useful for introspection (under `distributed_ddl_entry_format_version=5`). [#50015](https://github.com/ClickHouse/ClickHouse/pull/50015) ([Azat Khuzhin](https://github.com/azat)).
+* Preserve backward incompatibility for renamed settings by using aliases (`allow_experimental_projection_optimization` for `optimize_use_projections`, `allow_experimental_lightweight_delete` for `enable_lightweight_delete`). [#50044](https://github.com/ClickHouse/ClickHouse/pull/50044) ([Azat Khuzhin](https://github.com/azat)).
+* Support cross-replication in distributed queries using the new infrastructure. [#50097](https://github.com/ClickHouse/ClickHouse/pull/50097) ([Dmitry Novik](https://github.com/novikd)).
+* Support passing fqdn through setting my_hostname to register cluster node in keeper. Add setting of invisible to support multi compute groups. A compute group as a cluster, is invisible to other compute groups. [#50186](https://github.com/ClickHouse/ClickHouse/pull/50186) ([Yangkuan Liu](https://github.com/LiuYangkuan)).
+* Fix PostgreSQL reading all the data even though `LIMIT n` could be specified. [#50187](https://github.com/ClickHouse/ClickHouse/pull/50187) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* 1) Fixed an error `NOT_FOUND_COLUMN_IN_BLOCK` in case of using parallel replicas with non-replicated storage with disabled setting `parallel_replicas_for_non_replicated_merge_tree` 2) Now `allow_experimental_parallel_reading_from_replicas` have 3 possible values - 0, 1 and 2. 0 - disabled, 1 - enabled, silently disable them in case of failure (in case of FINAL or JOIN), 2 - enabled, throw an expection in case of failure. 3) If FINAL modifier is used in SELECT query and parallel replicas are enabled, ClickHouse will try to disable them if `allow_experimental_parallel_reading_from_replicas` is set to 1 and throw an exception otherwise. [#50195](https://github.com/ClickHouse/ClickHouse/pull/50195) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Don't send head request for all keys in Iceberg schema inference, only for keys that are used for reaing data. [#50203](https://github.com/ClickHouse/ClickHouse/pull/50203) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add new profile events for queries with subqueries (`QueriesWithSubqueries`/`SelectQueriesWithSubqueries`/`InsertQueriesWithSubqueries`). [#50204](https://github.com/ClickHouse/ClickHouse/pull/50204) ([Azat Khuzhin](https://github.com/azat)).
+* Adding the roles field in the users.xml file, which allows specifying roles with grants via a config file. [#50278](https://github.com/ClickHouse/ClickHouse/pull/50278) ([pufit](https://github.com/pufit)).
+* When parallel replicas are enabled they will always skip unavailable servers (the behavior is controlled by the setting `skip_unavailable_shards`, enabled by default and can be only disabled). This closes: [#48565](https://github.com/ClickHouse/ClickHouse/issues/48565). [#50293](https://github.com/ClickHouse/ClickHouse/pull/50293) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Fix a typo. [#50306](https://github.com/ClickHouse/ClickHouse/pull/50306) ([helifu](https://github.com/helifu)).
+* 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)).
+* Report `CGroupCpuCfsPeriod` and `CGroupCpuCfsQuota` in AsynchronousMetrics. - Respect cgroup v2 memory limits during server startup. [#50379](https://github.com/ClickHouse/ClickHouse/pull/50379) ([alekar](https://github.com/alekar)).
+* Bump internal protobuf to v3.18 (fixes CVE-2022-1941). [#50400](https://github.com/ClickHouse/ClickHouse/pull/50400) ([Robert Schulze](https://github.com/rschu1ze)).
+* Bump internal libxml2 to v2.10.4 (fixes CVE-2023-28484 and CVE-2023-29469). [#50402](https://github.com/ClickHouse/ClickHouse/pull/50402) ([Robert Schulze](https://github.com/rschu1ze)).
+* Bump c-ares to v1.19.1 (CVE-2023-32067, CVE-2023-31130, CVE-2023-31147). [#50403](https://github.com/ClickHouse/ClickHouse/pull/50403) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix CVE-2022-2469 in libgsasl. [#50404](https://github.com/ClickHouse/ClickHouse/pull/50404) ([Robert Schulze](https://github.com/rschu1ze)).
+* Make filter push down through cross join. [#50430](https://github.com/ClickHouse/ClickHouse/pull/50430) ([Han Fei](https://github.com/hanfei1991)).
+* Add a signal handler for SIGQUIT to work the same way as SIGINT. Closes [#50298](https://github.com/ClickHouse/ClickHouse/issues/50298). [#50435](https://github.com/ClickHouse/ClickHouse/pull/50435) ([Nikolay Degterinsky](https://github.com/evillique)).
+* In case JSON parse fails due to the large size of the object output the last position to allow debugging. [#50474](https://github.com/ClickHouse/ClickHouse/pull/50474) ([Valentin Alexeev](https://github.com/valentinalexeev)).
+* Support decimals with not fixed size. Closes [#49130](https://github.com/ClickHouse/ClickHouse/issues/49130). [#50586](https://github.com/ClickHouse/ClickHouse/pull/50586) ([Kruglov Pavel](https://github.com/Avogar)).
+* Disable pure parallel replicas if trivial count optimization is possible. [#50594](https://github.com/ClickHouse/ClickHouse/pull/50594) ([Raúl Marín](https://github.com/Algunenano)).
+* Added support of TRUNCATE db.table additional to TRUNCATE TABLE db.table in MaterializedMySQL. [#50624](https://github.com/ClickHouse/ClickHouse/pull/50624) ([Val Doroshchuk](https://github.com/valbok)).
+* Disable parallel replicas automatically when the estimated number of granules is less than threshold. The behavior is controlled by a setting `parallel_replicas_min_number_of_granules_to_enable`. [#50639](https://github.com/ClickHouse/ClickHouse/pull/50639) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* When creating skipping indexes via "ALTER TABLE table ADD INDEX", the "GRANULARITY" clause can now be omitted. In that case, GRANULARITY is assumed to be 1. [#50658](https://github.com/ClickHouse/ClickHouse/pull/50658) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix slow cache in presence of big inserts. [#50680](https://github.com/ClickHouse/ClickHouse/pull/50680) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Set default max_elements limit in filesystem cache to 10000000. [#50682](https://github.com/ClickHouse/ClickHouse/pull/50682) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* SHOW INDICES is now an alias of statement SHOW INDEX/INDEXES/KEYS. [#50713](https://github.com/ClickHouse/ClickHouse/pull/50713) ([Robert Schulze](https://github.com/rschu1ze)).
+
+#### Build/Testing/Packaging Improvement
+* New and improved keeper-bench. Everything can be customized from yaml/XML file: - request generator - each type of request generator can have a specific set of fields - multi requests can be generated just by doing the same under `multi` key - for each request or subrequest in multi a `weight` field can be defined to control distribution - define trees that need to be setup for a test run - hosts can be defined with all timeouts customizable and it's possible to control how many sessions to generate for each host - integers defined with `min_value` and `max_value` fields are random number generators. [#48547](https://github.com/ClickHouse/ClickHouse/pull/48547) ([Antonio Andelic](https://github.com/antonio2368)).
+* ... Add a test to check max_rows_to_read_leaf behaviour. [#48950](https://github.com/ClickHouse/ClickHouse/pull/48950) ([Sean Haynes](https://github.com/seandhaynes)).
+* Io_uring is not supported on macos, don't choose it when running tests on local to avoid occassional failures. [#49250](https://github.com/ClickHouse/ClickHouse/pull/49250) ([Frank Chen](https://github.com/FrankChen021)).
+* Support named fault injection for testing. [#49361](https://github.com/ClickHouse/ClickHouse/pull/49361) ([Han Fei](https://github.com/hanfei1991)).
+* Fix the 01193_metadata_loading test to match the query execution time specific to s390x. [#49455](https://github.com/ClickHouse/ClickHouse/pull/49455) ([MeenaRenganathan22](https://github.com/MeenaRenganathan22)).
+* Use the RapidJSONParser library to parse the JSON float values in case of s390x. [#49457](https://github.com/ClickHouse/ClickHouse/pull/49457) ([MeenaRenganathan22](https://github.com/MeenaRenganathan22)).
+* Allow running ClickHouse in the OS where the `prctl` (process control) syscall is not available, such as AWS Lambda. [#49538](https://github.com/ClickHouse/ClickHouse/pull/49538) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Improve CI check with an enabled analyzer. Now it should be green if only tests from `tests/broken_tests.txt` are broken. [#49562](https://github.com/ClickHouse/ClickHouse/pull/49562) ([Dmitry Novik](https://github.com/novikd)).
+* Fixed the issue of build conflict between contrib/isa-l and isa-l in qpl [49296](https://github.com/ClickHouse/ClickHouse/issues/49296). [#49584](https://github.com/ClickHouse/ClickHouse/pull/49584) ([jasperzhu](https://github.com/jinjunzh)).
+* Utilities are now only build if explicitly requested ("-DENABLE_UTILS=1") instead of by default, this reduces link times in typical development builds. [#49620](https://github.com/ClickHouse/ClickHouse/pull/49620) ([Robert Schulze](https://github.com/rschu1ze)).
+* Pull build description of idxd-config into a separate CMake file to avoid accidental removal in future. [#49651](https://github.com/ClickHouse/ClickHouse/pull/49651) ([jasperzhu](https://github.com/jinjunzh)).
+* Add CI check with an enabled analyzer in the master. Followup [#49562](https://github.com/ClickHouse/ClickHouse/issues/49562). [#49668](https://github.com/ClickHouse/ClickHouse/pull/49668) ([Dmitry Novik](https://github.com/novikd)).
+* Switch to LLVM/clang 16. [#49678](https://github.com/ClickHouse/ClickHouse/pull/49678) ([Azat Khuzhin](https://github.com/azat)).
+* Fixed DefaultHash64 for non-64 bit integers on s390x. [#49833](https://github.com/ClickHouse/ClickHouse/pull/49833) ([Harry Lee](https://github.com/HarryLeeIBM)).
+* Allow building ClickHouse with clang-17. [#49851](https://github.com/ClickHouse/ClickHouse/pull/49851) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* ClickHouse is now easier to be integrated into other cmake projects. [#49991](https://github.com/ClickHouse/ClickHouse/pull/49991) ([Amos Bird](https://github.com/amosbird)).
+* Link `boost::context` library to `clickhouse_common_io`. This closes: [#50381](https://github.com/ClickHouse/ClickHouse/issues/50381). [#50385](https://github.com/ClickHouse/ClickHouse/pull/50385) ([HaiBo Li](https://github.com/marising)).
+* Add support for building with clang-17. [#50410](https://github.com/ClickHouse/ClickHouse/pull/50410) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix strange additional QEMU logging after [#47151](https://github.com/ClickHouse/ClickHouse/issues/47151), see https://s3.amazonaws.com/clickhouse-test-reports/50078/a4743996ee4f3583884d07bcd6501df0cfdaa346/stateless_tests__release__databasereplicated__[3_4].html. [#50442](https://github.com/ClickHouse/ClickHouse/pull/50442) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* ClickHouse can work on Linux RISC-V 6.1.22. This closes [#50456](https://github.com/ClickHouse/ClickHouse/issues/50456). [#50457](https://github.com/ClickHouse/ClickHouse/pull/50457) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* ActionsDAG: fix wrong optimization [#47584](https://github.com/ClickHouse/ClickHouse/pull/47584) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+* Correctly handle concurrent snapshots in Keeper [#48466](https://github.com/ClickHouse/ClickHouse/pull/48466) ([Antonio Andelic](https://github.com/antonio2368)).
+* MergeTreeMarksLoader holds DataPart instead of DataPartStorage [#48515](https://github.com/ClickHouse/ClickHouse/pull/48515) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* sequence state fix [#48603](https://github.com/ClickHouse/ClickHouse/pull/48603) ([Ilya Golshtein](https://github.com/ilejn)).
+* Back/Restore concurrency check on previous fails [#48726](https://github.com/ClickHouse/ClickHouse/pull/48726) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix Attaching a table with non-existent ZK path does not increase the ReadonlyReplica metric [#48954](https://github.com/ClickHouse/ClickHouse/pull/48954) ([wangxiaobo](https://github.com/wzb5212)).
+* Fix possible terminate called for uncaught exception in some places [#49112](https://github.com/ClickHouse/ClickHouse/pull/49112) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix key not found error for queries with multiple StorageJoin [#49137](https://github.com/ClickHouse/ClickHouse/pull/49137) ([vdimir](https://github.com/vdimir)).
+* Fix wrong query result when using nullable primary key [#49172](https://github.com/ClickHouse/ClickHouse/pull/49172) ([Duc Canh Le](https://github.com/canhld94)).
+* Revert "Fix GCS native copy ([#48981](https://github.com/ClickHouse/ClickHouse/issues/48981))" [#49194](https://github.com/ClickHouse/ClickHouse/pull/49194) ([Raúl Marín](https://github.com/Algunenano)).
+* Fix reinterpretAs*() on big endian machines [#49198](https://github.com/ClickHouse/ClickHouse/pull/49198) ([Suzy Wang](https://github.com/SuzyWangIBMer)).
+* Lock zero copy parts more atomically [#49211](https://github.com/ClickHouse/ClickHouse/pull/49211) ([alesapin](https://github.com/alesapin)).
+* Fix race on Outdated parts loading [#49223](https://github.com/ClickHouse/ClickHouse/pull/49223) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix all key value is null and group use rollup return wrong answer [#49282](https://github.com/ClickHouse/ClickHouse/pull/49282) ([Shuai li](https://github.com/loneylee)).
+* Fix calculating load_factor for HASHED dictionaries with SHARDS [#49319](https://github.com/ClickHouse/ClickHouse/pull/49319) ([Azat Khuzhin](https://github.com/azat)).
+* Disallow configuring compression CODECs for alias columns [#49363](https://github.com/ClickHouse/ClickHouse/pull/49363) ([Timur Solodovnikov](https://github.com/tsolodov)).
+* Fix bug in removal of existing part directory [#49365](https://github.com/ClickHouse/ClickHouse/pull/49365) ([alesapin](https://github.com/alesapin)).
+* Properly fix GCS when HMAC is used [#49390](https://github.com/ClickHouse/ClickHouse/pull/49390) ([Antonio Andelic](https://github.com/antonio2368)).
+* 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)).
+* Invert `shutdown_wait_unfinished_queries` [#49427](https://github.com/ClickHouse/ClickHouse/pull/49427) ([Konstantin Bogdanov](https://github.com/thevar1able)).
+* Fix another zero copy bug [#49473](https://github.com/ClickHouse/ClickHouse/pull/49473) ([alesapin](https://github.com/alesapin)).
+* Fix postgres database setting [#49481](https://github.com/ClickHouse/ClickHouse/pull/49481) ([Mal Curtis](https://github.com/snikch)).
+* Correctly handle s3Cluster arguments [#49490](https://github.com/ClickHouse/ClickHouse/pull/49490) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix bug in TraceCollector destructor. [#49508](https://github.com/ClickHouse/ClickHouse/pull/49508) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Fix AsynchronousReadIndirectBufferFromRemoteFS breaking on short seeks [#49525](https://github.com/ClickHouse/ClickHouse/pull/49525) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix dictionaries loading order [#49560](https://github.com/ClickHouse/ClickHouse/pull/49560) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Forbid the change of data type of Object('json') column [#49563](https://github.com/ClickHouse/ClickHouse/pull/49563) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Fix stress test (Logical error: Expected 7134 >= 11030) [#49623](https://github.com/ClickHouse/ClickHouse/pull/49623) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix bug in DISTINCT [#49628](https://github.com/ClickHouse/ClickHouse/pull/49628) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix: DISTINCT in order with zero values in non-sorted columns [#49636](https://github.com/ClickHouse/ClickHouse/pull/49636) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix one-off error in big integers found by UBSan with fuzzer [#49645](https://github.com/ClickHouse/ClickHouse/pull/49645) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix reading from sparse columns after restart [#49660](https://github.com/ClickHouse/ClickHouse/pull/49660) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix assert in SpanHolder::finish() with fibers [#49673](https://github.com/ClickHouse/ClickHouse/pull/49673) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix short circuit functions and mutations with sparse arguments [#49716](https://github.com/ClickHouse/ClickHouse/pull/49716) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix writing appended files to incremental backups [#49725](https://github.com/ClickHouse/ClickHouse/pull/49725) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Ignore LWD column in checkPartDynamicColumns [#49737](https://github.com/ClickHouse/ClickHouse/pull/49737) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix msan issue in randomStringUTF8(<uneven number>) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix aggregate function kolmogorovSmirnovTest [#49768](https://github.com/ClickHouse/ClickHouse/pull/49768) ([FFFFFFFHHHHHHH](https://github.com/FFFFFFFHHHHHHH)).
+* Fix settings aliases in native protocol [#49776](https://github.com/ClickHouse/ClickHouse/pull/49776) ([Azat Khuzhin](https://github.com/azat)).
+* Fix `arrayMap` with array of tuples with single argument [#49789](https://github.com/ClickHouse/ClickHouse/pull/49789) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix per-query IO/BACKUPs throttling settings [#49797](https://github.com/ClickHouse/ClickHouse/pull/49797) ([Azat Khuzhin](https://github.com/azat)).
+* Fix setting NULL in profile definition [#49831](https://github.com/ClickHouse/ClickHouse/pull/49831) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Fix a bug with projections and the aggregate_functions_null_for_empty setting (for query_plan_optimize_projection) [#49873](https://github.com/ClickHouse/ClickHouse/pull/49873) ([Amos Bird](https://github.com/amosbird)).
+* Fix processing pending batch for Distributed async INSERT after restart [#49884](https://github.com/ClickHouse/ClickHouse/pull/49884) ([Azat Khuzhin](https://github.com/azat)).
+* Fix assertion in CacheMetadata::doCleanup [#49914](https://github.com/ClickHouse/ClickHouse/pull/49914) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* fix `is_prefix` in OptimizeRegularExpression [#49919](https://github.com/ClickHouse/ClickHouse/pull/49919) ([Han Fei](https://github.com/hanfei1991)).
+* Fix metrics `WriteBufferFromS3Bytes`, `WriteBufferFromS3Microseconds` and `WriteBufferFromS3RequestsErrors` [#49930](https://github.com/ClickHouse/ClickHouse/pull/49930) ([Aleksandr Musorin](https://github.com/AVMusorin)).
+* Fix IPv6 encoding in protobuf [#49933](https://github.com/ClickHouse/ClickHouse/pull/49933) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Fix possible Logical error on bad Nullable parsing for text formats [#49960](https://github.com/ClickHouse/ClickHouse/pull/49960) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add setting output_format_parquet_compliant_nested_types to produce more compatible Parquet files [#50001](https://github.com/ClickHouse/ClickHouse/pull/50001) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix logical error in stress test "Not enough space to add ..." [#50021](https://github.com/ClickHouse/ClickHouse/pull/50021) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* 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)).
+* Add proper escaping for DDL OpenTelemetry context serialization [#50045](https://github.com/ClickHouse/ClickHouse/pull/50045) ([Azat Khuzhin](https://github.com/azat)).
+* Fix reporting broken projection parts [#50052](https://github.com/ClickHouse/ClickHouse/pull/50052) ([Amos Bird](https://github.com/amosbird)).
+* 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 invalid index analysis for date related keys [#50153](https://github.com/ClickHouse/ClickHouse/pull/50153) ([Amos Bird](https://github.com/amosbird)).
+* do not allow modify order by when there are no order by cols [#50154](https://github.com/ClickHouse/ClickHouse/pull/50154) ([Han Fei](https://github.com/hanfei1991)).
+* 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)).
+* clickhouse-client: disallow usage of `--query` and `--queries-file` at the same time [#50210](https://github.com/ClickHouse/ClickHouse/pull/50210) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Fix UB for INTO OUTFILE extensions (APPEND / AND STDOUT) and WATCH EVENTS [#50216](https://github.com/ClickHouse/ClickHouse/pull/50216) ([Azat Khuzhin](https://github.com/azat)).
+* Fix skipping spaces at end of row in CustomSeparatedIgnoreSpaces format [#50224](https://github.com/ClickHouse/ClickHouse/pull/50224) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix iceberg metadata parsing [#50232](https://github.com/ClickHouse/ClickHouse/pull/50232) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix nested distributed SELECT in WITH clause [#50234](https://github.com/ClickHouse/ClickHouse/pull/50234) ([Azat Khuzhin](https://github.com/azat)).
+* 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)).
+* Fix msan issue in keyed siphash [#50245](https://github.com/ClickHouse/ClickHouse/pull/50245) ([Robert Schulze](https://github.com/rschu1ze)).
+* 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)).
+* Fix checksum calculation for backup entries [#50264](https://github.com/ClickHouse/ClickHouse/pull/50264) ([Vitaly Baranov](https://github.com/vitlibar)).
+* 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)).
+* Comparison functions NaN fix [#50287](https://github.com/ClickHouse/ClickHouse/pull/50287) ([Maksim Kita](https://github.com/kitaisreal)).
+* JIT aggregation nullable key fix [#50291](https://github.com/ClickHouse/ClickHouse/pull/50291) ([Maksim Kita](https://github.com/kitaisreal)).
+* Fix clickhouse-local crashing when writing empty Arrow or Parquet output [#50328](https://github.com/ClickHouse/ClickHouse/pull/50328) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix crash when Pool::Entry::disconnect() is called [#50334](https://github.com/ClickHouse/ClickHouse/pull/50334) ([Val Doroshchuk](https://github.com/valbok)).
+* Improved fetch part by holding directory lock longer [#50339](https://github.com/ClickHouse/ClickHouse/pull/50339) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix bitShift* functions with both constant arguments [#50343](https://github.com/ClickHouse/ClickHouse/pull/50343) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+* Fix hashing of const integer values [#50421](https://github.com/ClickHouse/ClickHouse/pull/50421) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix excessive memory usage for FINAL (due to too much streams usage) [#50429](https://github.com/ClickHouse/ClickHouse/pull/50429) ([Azat Khuzhin](https://github.com/azat)).
+* Fix merge_tree_min_rows_for_seek/merge_tree_min_bytes_for_seek for data skipping indexes [#50432](https://github.com/ClickHouse/ClickHouse/pull/50432) ([Azat Khuzhin](https://github.com/azat)).
+* Limit the number of in-flight tasks for loading outdated parts [#50450](https://github.com/ClickHouse/ClickHouse/pull/50450) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Keeper fix: apply uncommitted state after snapshot install [#50483](https://github.com/ClickHouse/ClickHouse/pull/50483) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix incorrect constant folding [#50536](https://github.com/ClickHouse/ClickHouse/pull/50536) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix logical error in stress test (Not enough space to add ...) [#50583](https://github.com/ClickHouse/ClickHouse/pull/50583) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix converting Null to LowCardinality(Nullable) in values table function [#50637](https://github.com/ClickHouse/ClickHouse/pull/50637) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix crash in anti/semi join [#50638](https://github.com/ClickHouse/ClickHouse/pull/50638) ([vdimir](https://github.com/vdimir)).
+* Revert invalid RegExpTreeDictionary optimization [#50642](https://github.com/ClickHouse/ClickHouse/pull/50642) ([Johann Gan](https://github.com/johanngan)).
+* Correctly disable async insert with deduplication when it's not needed [#50663](https://github.com/ClickHouse/ClickHouse/pull/50663) ([Antonio Andelic](https://github.com/antonio2368)).
+
+#### Build Improvement
+
+* Fixed Functional Test 00870_t64_codec, 00871_t64_codec_signed, 00872_t64_bit_codec. [#49658](https://github.com/ClickHouse/ClickHouse/pull/49658) ([Sanjam Panda](https://github.com/saitama951)).
+
+#### NO CL ENTRY
+
+* NO CL ENTRY:  'Fix user MemoryTracker counter in async inserts'. [#47630](https://github.com/ClickHouse/ClickHouse/pull/47630) ([Dmitry Novik](https://github.com/novikd)).
+* NO CL ENTRY:  'Revert "Make `Pretty` formats even prettier."'. [#49850](https://github.com/ClickHouse/ClickHouse/pull/49850) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* NO CL ENTRY:  'Update first_value.md:remove redundant 's''. [#50331](https://github.com/ClickHouse/ClickHouse/pull/50331) ([sslouis](https://github.com/savezed)).
+* NO CL ENTRY:  'Revert "less logs in WriteBufferFromS3"'. [#50390](https://github.com/ClickHouse/ClickHouse/pull/50390) ([Alexander Tokmakov](https://github.com/tavplubix)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Attempt to fix the "system.stack_trace" test [#44627](https://github.com/ClickHouse/ClickHouse/pull/44627) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* rework WriteBufferFromS3, add tests, add abortion [#44869](https://github.com/ClickHouse/ClickHouse/pull/44869) ([Sema Checherinda](https://github.com/CheSema)).
+* Rework locking in fs cache [#44985](https://github.com/ClickHouse/ClickHouse/pull/44985) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update ubuntu_ami_for_ci.sh [#47151](https://github.com/ClickHouse/ClickHouse/pull/47151) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* 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)).
+* Fix some tests [#48792](https://github.com/ClickHouse/ClickHouse/pull/48792) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Bug Fix for 02432_s3_parallel_parts_cleanup.sql with zero copy replication [#48865](https://github.com/ClickHouse/ClickHouse/pull/48865) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Add AsyncLoader with dependency tracking and runtime prioritization [#48923](https://github.com/ClickHouse/ClickHouse/pull/48923) ([Sergei Trifonov](https://github.com/serxa)).
+* Fix incorrect createColumn call on join clause [#48998](https://github.com/ClickHouse/ClickHouse/pull/48998) ([Ongkong](https://github.com/ongkong)).
+* Try fix flaky 01346_alter_enum_partition_key_replicated_zookeeper_long [#49099](https://github.com/ClickHouse/ClickHouse/pull/49099) ([Sergei Trifonov](https://github.com/serxa)).
+* Fix possible logical error "Cannot cancel. Either no query sent or already cancelled" [#49106](https://github.com/ClickHouse/ClickHouse/pull/49106) ([Kruglov Pavel](https://github.com/Avogar)).
+* Refactor ColumnLowCardinality::cutAndCompact [#49111](https://github.com/ClickHouse/ClickHouse/pull/49111) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix tests with enabled analyzer [#49116](https://github.com/ClickHouse/ClickHouse/pull/49116) ([Dmitry Novik](https://github.com/novikd)).
+* Use `SharedMutex` instead of `UpgradableMutex` [#49139](https://github.com/ClickHouse/ClickHouse/pull/49139) ([Sergei Trifonov](https://github.com/serxa)).
+* Don't add metadata_version file if it doesn't exist [#49146](https://github.com/ClickHouse/ClickHouse/pull/49146) ([alesapin](https://github.com/alesapin)).
+* clearing s3 between tests in a robust way [#49157](https://github.com/ClickHouse/ClickHouse/pull/49157) ([Sema Checherinda](https://github.com/CheSema)).
+* Align connect timeout with aws sdk default [#49161](https://github.com/ClickHouse/ClickHouse/pull/49161) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix test_encrypted_disk_replication [#49193](https://github.com/ClickHouse/ClickHouse/pull/49193) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Allow using function `concat` with `Map` type [#49200](https://github.com/ClickHouse/ClickHouse/pull/49200) ([Anton Popov](https://github.com/CurtizJ)).
+* Slight improvements to coordinator logging [#49204](https://github.com/ClickHouse/ClickHouse/pull/49204) ([Raúl Marín](https://github.com/Algunenano)).
+* Fix some typos in conversion functions [#49221](https://github.com/ClickHouse/ClickHouse/pull/49221) ([Raúl Marín](https://github.com/Algunenano)).
+* CMake: Remove some GCC-specific code [#49224](https://github.com/ClickHouse/ClickHouse/pull/49224) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix oss-fuzz build errors [#49236](https://github.com/ClickHouse/ClickHouse/pull/49236) ([Nikita Taranov](https://github.com/nickitat)).
+* Update version after release [#49237](https://github.com/ClickHouse/ClickHouse/pull/49237) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Update version_date.tsv and changelogs after v23.4.1.1943-stable [#49239](https://github.com/ClickHouse/ClickHouse/pull/49239) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Merge [#24050](https://github.com/ClickHouse/ClickHouse/issues/24050) [#49240](https://github.com/ClickHouse/ClickHouse/pull/49240) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add file name to exception raised during decompression [#49241](https://github.com/ClickHouse/ClickHouse/pull/49241) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Disable ISA-L on aarch64 architectures [#49256](https://github.com/ClickHouse/ClickHouse/pull/49256) ([Jordi Villar](https://github.com/jrdi)).
+* Add a comment in FileCache.cpp [#49260](https://github.com/ClickHouse/ClickHouse/pull/49260) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix garbage [#48719](https://github.com/ClickHouse/ClickHouse/issues/48719) [#49263](https://github.com/ClickHouse/ClickHouse/pull/49263) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Update build for nasm [#49288](https://github.com/ClickHouse/ClickHouse/pull/49288) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix race in `waitForProcessingQueue` [#49302](https://github.com/ClickHouse/ClickHouse/pull/49302) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix stress test [#49309](https://github.com/ClickHouse/ClickHouse/pull/49309) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix 02516_join_with_totals_and_subquery_bug with new analyzer [#49310](https://github.com/ClickHouse/ClickHouse/pull/49310) ([Dmitry Novik](https://github.com/novikd)).
+* Fallback auth gh api [#49314](https://github.com/ClickHouse/ClickHouse/pull/49314) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Unpoison stack frame ptrs from libunwind for msan [#49316](https://github.com/ClickHouse/ClickHouse/pull/49316) ([Robert Schulze](https://github.com/rschu1ze)).
+* Respect projections in 01600_parts [#49318](https://github.com/ClickHouse/ClickHouse/pull/49318) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* move pipe compute into initializePipeline [#49326](https://github.com/ClickHouse/ClickHouse/pull/49326) ([Konstantin Morozov](https://github.com/k-morozov)).
+* Fix compiling average example (suppress -Wframe-larger-than) [#49358](https://github.com/ClickHouse/ClickHouse/pull/49358) ([Azat Khuzhin](https://github.com/azat)).
+* Fix join_use_nulls in analyzer [#49359](https://github.com/ClickHouse/ClickHouse/pull/49359) ([vdimir](https://github.com/vdimir)).
+* Fix 02680_mysql_ast_logical_err in analyzer [#49362](https://github.com/ClickHouse/ClickHouse/pull/49362) ([vdimir](https://github.com/vdimir)).
+* Remove wrong assertion in cache [#49376](https://github.com/ClickHouse/ClickHouse/pull/49376) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* A better way of excluding ISA-L on non-x86 [#49378](https://github.com/ClickHouse/ClickHouse/pull/49378) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix decimal aggregates test for s390x [#49382](https://github.com/ClickHouse/ClickHouse/pull/49382) ([Harry Lee](https://github.com/HarryLeeIBM)).
+* Move logging one line higher [#49387](https://github.com/ClickHouse/ClickHouse/pull/49387) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Improve CI: status commit, auth for get_gh_api [#49388](https://github.com/ClickHouse/ClickHouse/pull/49388) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fix printing hung queries in clickhouse-test. [#49389](https://github.com/ClickHouse/ClickHouse/pull/49389) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Correctly stop CNF convert for too many atomics in new analyzer [#49402](https://github.com/ClickHouse/ClickHouse/pull/49402) ([Antonio Andelic](https://github.com/antonio2368)).
+* Remove 02707_complex_query_fails_analyzer test [#49403](https://github.com/ClickHouse/ClickHouse/pull/49403) ([Dmitry Novik](https://github.com/novikd)).
+* Update FileSegment.cpp [#49411](https://github.com/ClickHouse/ClickHouse/pull/49411) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Switch Block::NameMap to google::dense_hash_map over HashMap [#49412](https://github.com/ClickHouse/ClickHouse/pull/49412) ([Azat Khuzhin](https://github.com/azat)).
+* Slightly reduce inter-header dependencies [#49413](https://github.com/ClickHouse/ClickHouse/pull/49413) ([Azat Khuzhin](https://github.com/azat)).
+* Update WithFileName.cpp [#49414](https://github.com/ClickHouse/ClickHouse/pull/49414) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Fix some assertions failing in stress test [#49415](https://github.com/ClickHouse/ClickHouse/pull/49415) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Correctly cleanup sequential node in ZooKeeperWithFaultInjection [#49418](https://github.com/ClickHouse/ClickHouse/pull/49418) ([vdimir](https://github.com/vdimir)).
+* Throw an exception for non-parametric functions in new analyzer [#49419](https://github.com/ClickHouse/ClickHouse/pull/49419) ([Dmitry Novik](https://github.com/novikd)).
+* Fix some bad error messages [#49420](https://github.com/ClickHouse/ClickHouse/pull/49420) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Update version_date.tsv and changelogs after v23.4.2.11-stable [#49422](https://github.com/ClickHouse/ClickHouse/pull/49422) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Remove trash [#49423](https://github.com/ClickHouse/ClickHouse/pull/49423) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Whitespaces [#49424](https://github.com/ClickHouse/ClickHouse/pull/49424) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove dependency from DB::Context in remote/cache readers [#49426](https://github.com/ClickHouse/ClickHouse/pull/49426) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Merging [#49066](https://github.com/ClickHouse/ClickHouse/issues/49066) (Better error handling during loading of parts) [#49430](https://github.com/ClickHouse/ClickHouse/pull/49430) ([Anton Popov](https://github.com/CurtizJ)).
+* all s3-blobs removed when merge aborted, remove part from failed fetch without unlock keper [#49432](https://github.com/ClickHouse/ClickHouse/pull/49432) ([Sema Checherinda](https://github.com/CheSema)).
+* Make INSERT do more things in parallel to avoid getting bottlenecked on one thread [#49434](https://github.com/ClickHouse/ClickHouse/pull/49434) ([Michael Kolupaev](https://github.com/al13n321)).
+* Make 'exceptions shorter than 30' test less noisy [#49435](https://github.com/ClickHouse/ClickHouse/pull/49435) ([Michael Kolupaev](https://github.com/al13n321)).
+* Build fixes for ENABLE_LIBRARIES=OFF [#49437](https://github.com/ClickHouse/ClickHouse/pull/49437) ([Azat Khuzhin](https://github.com/azat)).
+* Add image for docker-server jepsen [#49452](https://github.com/ClickHouse/ClickHouse/pull/49452) ([alesapin](https://github.com/alesapin)).
+* Follow-up to [#48792](https://github.com/ClickHouse/ClickHouse/issues/48792) [#49458](https://github.com/ClickHouse/ClickHouse/pull/49458) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Add method `getCurrentAvailabilityZone` to `AWSEC2MetadataClient` [#49464](https://github.com/ClickHouse/ClickHouse/pull/49464) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Add an integration test for `shutdown_wait_unfinished_queries` [#49469](https://github.com/ClickHouse/ClickHouse/pull/49469) ([Konstantin Bogdanov](https://github.com/thevar1able)).
+* Replace `NO DELAY` with `SYNC` in tests [#49470](https://github.com/ClickHouse/ClickHouse/pull/49470) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Check the PRs body directly in lambda, without rerun. Fix RCE in the CI [#49475](https://github.com/ClickHouse/ClickHouse/pull/49475) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Minor changes for setThreadName [#49476](https://github.com/ClickHouse/ClickHouse/pull/49476) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Static cast std::atomic<size_t> to uint64_t to serialize. [#49482](https://github.com/ClickHouse/ClickHouse/pull/49482) ([alekar](https://github.com/alekar)).
+* Fix logical error in stress test, add some logging [#49491](https://github.com/ClickHouse/ClickHouse/pull/49491) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fixes in server jepsen image [#49492](https://github.com/ClickHouse/ClickHouse/pull/49492) ([alesapin](https://github.com/alesapin)).
+* Fix UserTimeMicroseconds and SystemTimeMicroseconds descriptions [#49521](https://github.com/ClickHouse/ClickHouse/pull/49521) ([Sergei Trifonov](https://github.com/serxa)).
+* Remove garbage from HDFS [#49531](https://github.com/ClickHouse/ClickHouse/pull/49531) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Split ReadWriteBufferFromHTTP.h into .h and .cpp file [#49533](https://github.com/ClickHouse/ClickHouse/pull/49533) ([Michael Kolupaev](https://github.com/al13n321)).
+* Remove garbage from Pretty format [#49534](https://github.com/ClickHouse/ClickHouse/pull/49534) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Make input_format_parquet_preserve_order imply !parallelize_output_from_storages [#49536](https://github.com/ClickHouse/ClickHouse/pull/49536) ([Michael Kolupaev](https://github.com/al13n321)).
+* Remove extra semicolons [#49545](https://github.com/ClickHouse/ClickHouse/pull/49545) ([Bulat Gaifullin](https://github.com/bgaifullin)).
+* Fix 00597_push_down_predicate_long for analyzer [#49551](https://github.com/ClickHouse/ClickHouse/pull/49551) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix stress test (assertion 'key_metadata.lock()') [#49554](https://github.com/ClickHouse/ClickHouse/pull/49554) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix writeAnyEscapedString if quote_character is a meta character [#49558](https://github.com/ClickHouse/ClickHouse/pull/49558) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add CMake option for BOOST_USE_UCONTEXT [#49564](https://github.com/ClickHouse/ClickHouse/pull/49564) ([ltrk2](https://github.com/ltrk2)).
+* Fix 01655_plan_optimizations_optimize_read_in_window_order for analyzer [#49565](https://github.com/ClickHouse/ClickHouse/pull/49565) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix `ThreadPool::wait` [#49572](https://github.com/ClickHouse/ClickHouse/pull/49572) ([Anton Popov](https://github.com/CurtizJ)).
+* Query cache: disable for internal queries [#49573](https://github.com/ClickHouse/ClickHouse/pull/49573) ([Robert Schulze](https://github.com/rschu1ze)).
+* Remove `test_merge_tree_s3_restore` [#49576](https://github.com/ClickHouse/ClickHouse/pull/49576) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix bad test [#49578](https://github.com/ClickHouse/ClickHouse/pull/49578) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove obsolete test about deprecated feature [#49579](https://github.com/ClickHouse/ClickHouse/pull/49579) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Avoid error found by AST Fuzzer [#49580](https://github.com/ClickHouse/ClickHouse/pull/49580) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix wrong assert [#49581](https://github.com/ClickHouse/ClickHouse/pull/49581) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Flaky test 02723_zookeeper_name.sql [#49592](https://github.com/ClickHouse/ClickHouse/pull/49592) ([Sema Checherinda](https://github.com/CheSema)).
+* Query Cache: Safeguard against empty chunks [#49593](https://github.com/ClickHouse/ClickHouse/pull/49593) ([Robert Schulze](https://github.com/rschu1ze)).
+* 02723_zookeeper_name: Force a deterministic result order [#49594](https://github.com/ClickHouse/ClickHouse/pull/49594) ([Robert Schulze](https://github.com/rschu1ze)).
+* Remove dangerous code (stringstream) [#49595](https://github.com/ClickHouse/ClickHouse/pull/49595) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove some code [#49596](https://github.com/ClickHouse/ClickHouse/pull/49596) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove "locale" [#49597](https://github.com/ClickHouse/ClickHouse/pull/49597) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* CMake: Cleanup utils build [#49598](https://github.com/ClickHouse/ClickHouse/pull/49598) ([Robert Schulze](https://github.com/rschu1ze)).
+* Follow-up for [#49580](https://github.com/ClickHouse/ClickHouse/issues/49580) [#49604](https://github.com/ClickHouse/ClickHouse/pull/49604) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix typo [#49605](https://github.com/ClickHouse/ClickHouse/pull/49605) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix bad test 01660_system_parts_smoke [#49611](https://github.com/ClickHouse/ClickHouse/pull/49611) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Minor changes [#49612](https://github.com/ClickHouse/ClickHouse/pull/49612) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Follow-up for [#49576](https://github.com/ClickHouse/ClickHouse/issues/49576) [#49615](https://github.com/ClickHouse/ClickHouse/pull/49615) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix error in [#48300](https://github.com/ClickHouse/ClickHouse/issues/48300) [#49616](https://github.com/ClickHouse/ClickHouse/pull/49616) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix typo: "as much slots" -> "as many slots" [#49617](https://github.com/ClickHouse/ClickHouse/pull/49617) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Better concurrent parts removal with zero copy [#49619](https://github.com/ClickHouse/ClickHouse/pull/49619) ([alesapin](https://github.com/alesapin)).
+* CMake: Remove legacy switch for ccache [#49627](https://github.com/ClickHouse/ClickHouse/pull/49627) ([Robert Schulze](https://github.com/rschu1ze)).
+* Try to fix integration test 'test_ssl_cert_authentication' [#49632](https://github.com/ClickHouse/ClickHouse/pull/49632) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Unflake 01660_system_parts_smoke [#49633](https://github.com/ClickHouse/ClickHouse/pull/49633) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add trash [#49634](https://github.com/ClickHouse/ClickHouse/pull/49634) ([Robert Schulze](https://github.com/rschu1ze)).
+* Remove commented code [#49635](https://github.com/ClickHouse/ClickHouse/pull/49635) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add flaky test [#49646](https://github.com/ClickHouse/ClickHouse/pull/49646) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix race in `Context::createCopy` [#49663](https://github.com/ClickHouse/ClickHouse/pull/49663) ([Anton Popov](https://github.com/CurtizJ)).
+* Disable 01710_projection_aggregation_in_order.sql [#49667](https://github.com/ClickHouse/ClickHouse/pull/49667) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix flaky 02684_bson.sql [#49674](https://github.com/ClickHouse/ClickHouse/pull/49674) ([Kruglov Pavel](https://github.com/Avogar)).
+* Some cache cleanup after rework locking [#49675](https://github.com/ClickHouse/ClickHouse/pull/49675) ([Igor Nikonov](https://github.com/devcrafter)).
+* Correctly update log pointer during database replica recovery [#49676](https://github.com/ClickHouse/ClickHouse/pull/49676) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Enable distinct in order after fix [#49636](https://github.com/ClickHouse/ClickHouse/issues/49636) [#49677](https://github.com/ClickHouse/ClickHouse/pull/49677) ([Igor Nikonov](https://github.com/devcrafter)).
+* Build fixes for RISCV64 [#49688](https://github.com/ClickHouse/ClickHouse/pull/49688) ([Azat Khuzhin](https://github.com/azat)).
+* Add some logging [#49690](https://github.com/ClickHouse/ClickHouse/pull/49690) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix a wrong built generator removal, use `depth=1` [#49692](https://github.com/ClickHouse/ClickHouse/pull/49692) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fix member call on null pointer in AST fuzzer [#49696](https://github.com/ClickHouse/ClickHouse/pull/49696) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Improve woboq codebrowser pipeline [#49701](https://github.com/ClickHouse/ClickHouse/pull/49701) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Enable `do_not_evict_index_and_mark_files` by default [#49702](https://github.com/ClickHouse/ClickHouse/pull/49702) ([Nikita Taranov](https://github.com/nickitat)).
+* Backport fix for UBSan error in musl/logf.c [#49705](https://github.com/ClickHouse/ClickHouse/pull/49705) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix flaky test for `kolmogorovSmirnovTest` function [#49710](https://github.com/ClickHouse/ClickHouse/pull/49710) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Update clickhouse-test [#49712](https://github.com/ClickHouse/ClickHouse/pull/49712) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* IBM s390x: ip encoding fix [#49713](https://github.com/ClickHouse/ClickHouse/pull/49713) ([Suzy Wang](https://github.com/SuzyWangIBMer)).
+* Remove not used ErrorCodes [#49715](https://github.com/ClickHouse/ClickHouse/pull/49715) ([Sergei Trifonov](https://github.com/serxa)).
+* Disable mmap for StorageFile in clickhouse-server [#49717](https://github.com/ClickHouse/ClickHouse/pull/49717) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix typo [#49718](https://github.com/ClickHouse/ClickHouse/pull/49718) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Do not launch workflows for PRs w/o "can be tested" [#49726](https://github.com/ClickHouse/ClickHouse/pull/49726) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Move assertions after logging [#49729](https://github.com/ClickHouse/ClickHouse/pull/49729) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Docs: Fix sidebar label for dictionary table function [#49730](https://github.com/ClickHouse/ClickHouse/pull/49730) ([Robert Schulze](https://github.com/rschu1ze)).
+* Do not allocate own buffer in CachedOnDiskReadBufferFromFile when `use_external_buffer == true` [#49733](https://github.com/ClickHouse/ClickHouse/pull/49733) ([Nikita Taranov](https://github.com/nickitat)).
+* fix convertation [#49749](https://github.com/ClickHouse/ClickHouse/pull/49749) ([Sema Checherinda](https://github.com/CheSema)).
+* fix flaky test 02504_regexp_dictionary_ua_parser [#49753](https://github.com/ClickHouse/ClickHouse/pull/49753) ([Han Fei](https://github.com/hanfei1991)).
+* Fix unit test `ExceptionFromWait` [#49755](https://github.com/ClickHouse/ClickHouse/pull/49755) ([Anton Popov](https://github.com/CurtizJ)).
+* Add forgotten lock (addition to [#49117](https://github.com/ClickHouse/ClickHouse/issues/49117)) [#49757](https://github.com/ClickHouse/ClickHouse/pull/49757) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix typo [#49762](https://github.com/ClickHouse/ClickHouse/pull/49762) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix build of `libfiu` on clang-16 [#49766](https://github.com/ClickHouse/ClickHouse/pull/49766) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Update README.md [#49782](https://github.com/ClickHouse/ClickHouse/pull/49782) ([Tyler Hannan](https://github.com/tylerhannan)).
+* Analyzer: fix column not found for optimized prewhere with sample by [#49784](https://github.com/ClickHouse/ClickHouse/pull/49784) ([vdimir](https://github.com/vdimir)).
+* Typo: demange.cpp --> demangle.cpp [#49799](https://github.com/ClickHouse/ClickHouse/pull/49799) ([Robert Schulze](https://github.com/rschu1ze)).
+* Analyzer: apply _CAST to constants only once [#49800](https://github.com/ClickHouse/ClickHouse/pull/49800) ([Dmitry Novik](https://github.com/novikd)).
+* Use CLOCK_MONOTONIC_RAW over CLOCK_MONOTONIC on Linux (fixes non monotonic clock) [#49819](https://github.com/ClickHouse/ClickHouse/pull/49819) ([Azat Khuzhin](https://github.com/azat)).
+* README.md: 4 --> 5 [#49822](https://github.com/ClickHouse/ClickHouse/pull/49822) ([Robert Schulze](https://github.com/rschu1ze)).
+* Allow ASOF JOIN over nullable right column [#49826](https://github.com/ClickHouse/ClickHouse/pull/49826) ([vdimir](https://github.com/vdimir)).
+* Make 01533_multiple_nested test more reliable [#49828](https://github.com/ClickHouse/ClickHouse/pull/49828) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+* What happens if I remove everything in msan_suppressions? [#49829](https://github.com/ClickHouse/ClickHouse/pull/49829) ([Robert Schulze](https://github.com/rschu1ze)).
+* Update README.md [#49832](https://github.com/ClickHouse/ClickHouse/pull/49832) ([AnneClickHouse](https://github.com/AnneClickHouse)).
+* Randomize enable_multiple_prewhere_read_steps setting [#49834](https://github.com/ClickHouse/ClickHouse/pull/49834) ([Alexander Gololobov](https://github.com/davenger)).
+* Analyzer: do not optimize GROUP BY keys with ROLLUP and CUBE [#49838](https://github.com/ClickHouse/ClickHouse/pull/49838) ([Dmitry Novik](https://github.com/novikd)).
+* Clearable hash table and zero values [#49846](https://github.com/ClickHouse/ClickHouse/pull/49846) ([Igor Nikonov](https://github.com/devcrafter)).
+* Reset vectorscan reference to an "official" repo [#49848](https://github.com/ClickHouse/ClickHouse/pull/49848) ([Robert Schulze](https://github.com/rschu1ze)).
+* Enable few slow clang-tidy checks for clangd [#49855](https://github.com/ClickHouse/ClickHouse/pull/49855) ([Azat Khuzhin](https://github.com/azat)).
+* Update QPL docs [#49857](https://github.com/ClickHouse/ClickHouse/pull/49857) ([Robert Schulze](https://github.com/rschu1ze)).
+* Small-ish .clang-tidy update [#49859](https://github.com/ClickHouse/ClickHouse/pull/49859) ([Robert Schulze](https://github.com/rschu1ze)).
+* Follow-up for clang-tidy [#49861](https://github.com/ClickHouse/ClickHouse/pull/49861) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix "reference to local binding" after fixes for clang-17 [#49874](https://github.com/ClickHouse/ClickHouse/pull/49874) ([Azat Khuzhin](https://github.com/azat)).
+* fix typo [#49876](https://github.com/ClickHouse/ClickHouse/pull/49876) ([JackyWoo](https://github.com/JackyWoo)).
+* Log with warning if the server was terminated forcefully [#49881](https://github.com/ClickHouse/ClickHouse/pull/49881) ([Azat Khuzhin](https://github.com/azat)).
+* Fix some tests [#49889](https://github.com/ClickHouse/ClickHouse/pull/49889) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* use chassert in MergeTreeDeduplicationLog to have better log info [#49891](https://github.com/ClickHouse/ClickHouse/pull/49891) ([Han Fei](https://github.com/hanfei1991)).
+* Multiple pools support for AsyncLoader [#49893](https://github.com/ClickHouse/ClickHouse/pull/49893) ([Sergei Trifonov](https://github.com/serxa)).
+* Fix stack-use-after-scope in resource manager test [#49908](https://github.com/ClickHouse/ClickHouse/pull/49908) ([Sergei Trifonov](https://github.com/serxa)).
+* Retry connection expired in test_rename_column/test.py [#49911](https://github.com/ClickHouse/ClickHouse/pull/49911) ([alesapin](https://github.com/alesapin)).
+* Try to fix flaky test_distributed_load_balancing tests [#49912](https://github.com/ClickHouse/ClickHouse/pull/49912) ([Kruglov Pavel](https://github.com/Avogar)).
+* Remove unused code [#49918](https://github.com/ClickHouse/ClickHouse/pull/49918) ([alesapin](https://github.com/alesapin)).
+* Fix flakiness of test_distributed_load_balancing test [#49921](https://github.com/ClickHouse/ClickHouse/pull/49921) ([Azat Khuzhin](https://github.com/azat)).
+* Add some logging [#49925](https://github.com/ClickHouse/ClickHouse/pull/49925) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Support hardlinking parts transactionally [#49931](https://github.com/ClickHouse/ClickHouse/pull/49931) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix for analyzer: 02377_ optimize_sorting_by_input_stream_properties_e… [#49943](https://github.com/ClickHouse/ClickHouse/pull/49943) ([Igor Nikonov](https://github.com/devcrafter)).
+* Follow up to [#49429](https://github.com/ClickHouse/ClickHouse/issues/49429) [#49964](https://github.com/ClickHouse/ClickHouse/pull/49964) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix flaky test_ssl_cert_authentication to use urllib3 [#49982](https://github.com/ClickHouse/ClickHouse/pull/49982) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix woboq codebrowser build with -Wno-poison-system-directories [#49992](https://github.com/ClickHouse/ClickHouse/pull/49992) ([Azat Khuzhin](https://github.com/azat)).
+* test for [#46128](https://github.com/ClickHouse/ClickHouse/issues/46128) [#49993](https://github.com/ClickHouse/ClickHouse/pull/49993) ([Denny Crane](https://github.com/den-crane)).
+* Fix test_insert_same_partition_and_merge failing if one Azure request attempt fails [#49996](https://github.com/ClickHouse/ClickHouse/pull/49996) ([Michael Kolupaev](https://github.com/al13n321)).
+* Check return value of `ftruncate` in Keeper [#50020](https://github.com/ClickHouse/ClickHouse/pull/50020) ([Antonio Andelic](https://github.com/antonio2368)).
+* Add some assertions [#50025](https://github.com/ClickHouse/ClickHouse/pull/50025) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update 02441_alter_delete_and_drop_column.sql [#50027](https://github.com/ClickHouse/ClickHouse/pull/50027) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Move some common code to common [#50028](https://github.com/ClickHouse/ClickHouse/pull/50028) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Add method getCredentials() to S3::Client [#50030](https://github.com/ClickHouse/ClickHouse/pull/50030) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update query_log.md [#50032](https://github.com/ClickHouse/ClickHouse/pull/50032) ([Sergei Trifonov](https://github.com/serxa)).
+* Get rid of indirect write buffer in object storages [#50033](https://github.com/ClickHouse/ClickHouse/pull/50033) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Load balancing bugfixes [#50036](https://github.com/ClickHouse/ClickHouse/pull/50036) ([Sergei Trifonov](https://github.com/serxa)).
+* Update S3 sdk to v1.11.61 [#50037](https://github.com/ClickHouse/ClickHouse/pull/50037) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix 02735_system_zookeeper_connection for DatabaseReplicated [#50047](https://github.com/ClickHouse/ClickHouse/pull/50047) ([Azat Khuzhin](https://github.com/azat)).
+* Add more profile events for distributed connections [#50051](https://github.com/ClickHouse/ClickHouse/pull/50051) ([Sergei Trifonov](https://github.com/serxa)).
+* FileCache: simple tryReserve() cleanup [#50059](https://github.com/ClickHouse/ClickHouse/pull/50059) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix hashed/sparse_hashed dictionaries max_load_factor upper range [#50065](https://github.com/ClickHouse/ClickHouse/pull/50065) ([Azat Khuzhin](https://github.com/azat)).
+* Clearer coordinator log [#50101](https://github.com/ClickHouse/ClickHouse/pull/50101) ([Raúl Marín](https://github.com/Algunenano)).
+* Analyzer: Do not execute table functions multiple times [#50105](https://github.com/ClickHouse/ClickHouse/pull/50105) ([Dmitry Novik](https://github.com/novikd)).
+* Update default settings for Replicated database [#50108](https://github.com/ClickHouse/ClickHouse/pull/50108) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Make async prefetched buffer work with arbitrary impl [#50109](https://github.com/ClickHouse/ClickHouse/pull/50109) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update github.com/distribution/distribution [#50114](https://github.com/ClickHouse/ClickHouse/pull/50114) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Docs: Update clickhouse-local arguments [#50138](https://github.com/ClickHouse/ClickHouse/pull/50138) ([Robert Schulze](https://github.com/rschu1ze)).
+* Change fields destruction order in AsyncTaskExecutor [#50151](https://github.com/ClickHouse/ClickHouse/pull/50151) ([Kruglov Pavel](https://github.com/Avogar)).
+* Follow-up to [#49889](https://github.com/ClickHouse/ClickHouse/issues/49889) [#50152](https://github.com/ClickHouse/ClickHouse/pull/50152) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Clarification comment on retries controller behavior [#50155](https://github.com/ClickHouse/ClickHouse/pull/50155) ([Igor Nikonov](https://github.com/devcrafter)).
+* Switch to upstream repository of vectorscan [#50159](https://github.com/ClickHouse/ClickHouse/pull/50159) ([Azat Khuzhin](https://github.com/azat)).
+* Refactor lambdas, prepare to prio runners [#50160](https://github.com/ClickHouse/ClickHouse/pull/50160) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Speed-up the shellcheck with parallel xargs [#50164](https://github.com/ClickHouse/ClickHouse/pull/50164) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update an exception message [#50180](https://github.com/ClickHouse/ClickHouse/pull/50180) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Upgrade boost submodule [#50188](https://github.com/ClickHouse/ClickHouse/pull/50188) ([ltrk2](https://github.com/ltrk2)).
+* Implement a uniform way to query processor core IDs [#50190](https://github.com/ClickHouse/ClickHouse/pull/50190) ([ltrk2](https://github.com/ltrk2)).
+* Don't replicate delete through DDL worker if there is just 1 shard [#50193](https://github.com/ClickHouse/ClickHouse/pull/50193) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix codebrowser by using clang-15 image [#50197](https://github.com/ClickHouse/ClickHouse/pull/50197) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Add comments to build reports [#50200](https://github.com/ClickHouse/ClickHouse/pull/50200) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Automatic backports of important fixes to cloud-release [#50202](https://github.com/ClickHouse/ClickHouse/pull/50202) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Unify priorities: lower value means higher priority [#50205](https://github.com/ClickHouse/ClickHouse/pull/50205) ([Sergei Trifonov](https://github.com/serxa)).
+* Use transactions for encrypted disks [#50206](https://github.com/ClickHouse/ClickHouse/pull/50206) ([alesapin](https://github.com/alesapin)).
+* Get detailed error instead of unknown error for function test [#50207](https://github.com/ClickHouse/ClickHouse/pull/50207) ([Suzy Wang](https://github.com/SuzyWangIBMer)).
+* README.md: Remove Berlin Meetup from upcoming events [#50218](https://github.com/ClickHouse/ClickHouse/pull/50218) ([Robert Schulze](https://github.com/rschu1ze)).
+* Minor adjustment of clickhouse-client/local parameter docs [#50219](https://github.com/ClickHouse/ClickHouse/pull/50219) ([Robert Schulze](https://github.com/rschu1ze)).
+* Unify priorities: rework IO scheduling subsystem [#50231](https://github.com/ClickHouse/ClickHouse/pull/50231) ([Sergei Trifonov](https://github.com/serxa)).
+* Add new metrics BrokenDistributedBytesToInsert/DistributedBytesToInsert [#50238](https://github.com/ClickHouse/ClickHouse/pull/50238) ([Azat Khuzhin](https://github.com/azat)).
+* Fix URL in backport comment [#50241](https://github.com/ClickHouse/ClickHouse/pull/50241) ([pufit](https://github.com/pufit)).
+* Fix `02535_max_parallel_replicas_custom_key` [#50242](https://github.com/ClickHouse/ClickHouse/pull/50242) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fixes for MergeTree with readonly disks [#50244](https://github.com/ClickHouse/ClickHouse/pull/50244) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Yet another refactoring [#50257](https://github.com/ClickHouse/ClickHouse/pull/50257) ([Anton Popov](https://github.com/CurtizJ)).
+* Unify priorities: rework AsyncLoader [#50272](https://github.com/ClickHouse/ClickHouse/pull/50272) ([Sergei Trifonov](https://github.com/serxa)).
+* buffers d-tor finalize free [#50275](https://github.com/ClickHouse/ClickHouse/pull/50275) ([Sema Checherinda](https://github.com/CheSema)).
+* Fix 02767_into_outfile_extensions_msan under analyzer [#50290](https://github.com/ClickHouse/ClickHouse/pull/50290) ([Azat Khuzhin](https://github.com/azat)).
+* QPL: Add a comment about isal [#50308](https://github.com/ClickHouse/ClickHouse/pull/50308) ([Robert Schulze](https://github.com/rschu1ze)).
+* Avoid clang 15 crash [#50310](https://github.com/ClickHouse/ClickHouse/pull/50310) ([Raúl Marín](https://github.com/Algunenano)).
+* Cleanup Annoy index [#50312](https://github.com/ClickHouse/ClickHouse/pull/50312) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix flaky `AsyncLoader.StaticPriorities` unit test [#50313](https://github.com/ClickHouse/ClickHouse/pull/50313) ([Sergei Trifonov](https://github.com/serxa)).
+* Update gtest_async_loader.cpp [#50317](https://github.com/ClickHouse/ClickHouse/pull/50317) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix IS (NOT) NULL operator priority [#50327](https://github.com/ClickHouse/ClickHouse/pull/50327) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Update README.md [#50340](https://github.com/ClickHouse/ClickHouse/pull/50340) ([Tyler Hannan](https://github.com/tylerhannan)).
+* do not fix the event list in test [#50342](https://github.com/ClickHouse/ClickHouse/pull/50342) ([Sema Checherinda](https://github.com/CheSema)).
+* less logs in WriteBufferFromS3 [#50347](https://github.com/ClickHouse/ClickHouse/pull/50347) ([Sema Checherinda](https://github.com/CheSema)).
+* Remove legacy install scripts superseded by universal.sh [#50360](https://github.com/ClickHouse/ClickHouse/pull/50360) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fail perf tests when too many queries slowed down [#50361](https://github.com/ClickHouse/ClickHouse/pull/50361) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix after [#50109](https://github.com/ClickHouse/ClickHouse/issues/50109) [#50362](https://github.com/ClickHouse/ClickHouse/pull/50362) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix log message [#50363](https://github.com/ClickHouse/ClickHouse/pull/50363) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Compare functions NaN update test [#50366](https://github.com/ClickHouse/ClickHouse/pull/50366) ([Maksim Kita](https://github.com/kitaisreal)).
+* Add re-creation for cherry-pick PRs [#50373](https://github.com/ClickHouse/ClickHouse/pull/50373) ([pufit](https://github.com/pufit)).
+*  Without applying `prepareRightBlock` will cause mismatch block structrue [#50383](https://github.com/ClickHouse/ClickHouse/pull/50383) ([lgbo](https://github.com/lgbo-ustc)).
+* fix hung in unit tests [#50391](https://github.com/ClickHouse/ClickHouse/pull/50391) ([Sema Checherinda](https://github.com/CheSema)).
+* Fix poll timeout in MaterializedMySQL [#50392](https://github.com/ClickHouse/ClickHouse/pull/50392) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Compile aggregate expressions enable by default [#50401](https://github.com/ClickHouse/ClickHouse/pull/50401) ([Maksim Kita](https://github.com/kitaisreal)).
+* Update app.py [#50407](https://github.com/ClickHouse/ClickHouse/pull/50407) ([Nikita Taranov](https://github.com/nickitat)).
+* reuse s3_mocks, rewrite test test_paranoid_check_in_logs [#50408](https://github.com/ClickHouse/ClickHouse/pull/50408) ([Sema Checherinda](https://github.com/CheSema)).
+* test for [#42610](https://github.com/ClickHouse/ClickHouse/issues/42610) [#50409](https://github.com/ClickHouse/ClickHouse/pull/50409) ([Denny Crane](https://github.com/den-crane)).
+* Remove something [#50411](https://github.com/ClickHouse/ClickHouse/pull/50411) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Mark the builds without results as pending [#50415](https://github.com/ClickHouse/ClickHouse/pull/50415) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Revert "Fix msan issue in keyed siphash" [#50426](https://github.com/ClickHouse/ClickHouse/pull/50426) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Revert "Revert "less logs in WriteBufferFromS3" ([#50390](https://github.com/ClickHouse/ClickHouse/issues/50390))" [#50444](https://github.com/ClickHouse/ClickHouse/pull/50444) ([Sema Checherinda](https://github.com/CheSema)).
+* Paranoid fix for removing parts from ZooKeeper [#50448](https://github.com/ClickHouse/ClickHouse/pull/50448) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Add timeout for unit tests [#50449](https://github.com/ClickHouse/ClickHouse/pull/50449) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Changes related to an internal feature [#50453](https://github.com/ClickHouse/ClickHouse/pull/50453) ([Michael Kolupaev](https://github.com/al13n321)).
+* Don't crash if config doesn't have logger section [#50455](https://github.com/ClickHouse/ClickHouse/pull/50455) ([Michael Kolupaev](https://github.com/al13n321)).
+* Update function docs [#50466](https://github.com/ClickHouse/ClickHouse/pull/50466) ([Robert Schulze](https://github.com/rschu1ze)).
+* Revert "make filter push down through cross join" [#50467](https://github.com/ClickHouse/ClickHouse/pull/50467) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Add some assertions [#50470](https://github.com/ClickHouse/ClickHouse/pull/50470) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* CI: Enable aspell on nested docs [#50476](https://github.com/ClickHouse/ClickHouse/pull/50476) ([Robert Schulze](https://github.com/rschu1ze)).
+* Try fix flaky test test_async_query_sending [#50480](https://github.com/ClickHouse/ClickHouse/pull/50480) ([Kruglov Pavel](https://github.com/Avogar)).
+* Disable 00534_functions_bad_arguments with msan [#50481](https://github.com/ClickHouse/ClickHouse/pull/50481) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Typos: Follow-up to [#50476](https://github.com/ClickHouse/ClickHouse/issues/50476) [#50482](https://github.com/ClickHouse/ClickHouse/pull/50482) ([Robert Schulze](https://github.com/rschu1ze)).
+* Remove unneeded Keeper test [#50485](https://github.com/ClickHouse/ClickHouse/pull/50485) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix KeyError in cherry-pick [#50493](https://github.com/ClickHouse/ClickHouse/pull/50493) ([pufit](https://github.com/pufit)).
+* Make typeid_cast for pointers noexcept [#50495](https://github.com/ClickHouse/ClickHouse/pull/50495) ([Sergey Kazmin ](https://github.com/yerseg)).
+* less traces in logs [#50518](https://github.com/ClickHouse/ClickHouse/pull/50518) ([Sema Checherinda](https://github.com/CheSema)).
+* Implement endianness-independent serialization for UUID [#50519](https://github.com/ClickHouse/ClickHouse/pull/50519) ([ltrk2](https://github.com/ltrk2)).
+* Remove strange object storage methods [#50521](https://github.com/ClickHouse/ClickHouse/pull/50521) ([alesapin](https://github.com/alesapin)).
+* Fix low quality code around metadata in RocksDB (experimental feature never used in production) [#50527](https://github.com/ClickHouse/ClickHouse/pull/50527) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Function if constant folding [#50529](https://github.com/ClickHouse/ClickHouse/pull/50529) ([Maksim Kita](https://github.com/kitaisreal)).
+* Add profile events for fs cache eviction [#50533](https://github.com/ClickHouse/ClickHouse/pull/50533) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* QueryNode small fix [#50535](https://github.com/ClickHouse/ClickHouse/pull/50535) ([Maksim Kita](https://github.com/kitaisreal)).
+* Control memory usage in generateRandom [#50538](https://github.com/ClickHouse/ClickHouse/pull/50538) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Disable skim (Rust library) under memory sanitizer [#50539](https://github.com/ClickHouse/ClickHouse/pull/50539) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* MSan support for Rust [#50541](https://github.com/ClickHouse/ClickHouse/pull/50541) ([Azat Khuzhin](https://github.com/azat)).
+* Make 01565_query_loop_after_client_error slightly more robust [#50542](https://github.com/ClickHouse/ClickHouse/pull/50542) ([Azat Khuzhin](https://github.com/azat)).
+* Resize BufferFromVector underlying vector only pos_offset == vector.size() [#50546](https://github.com/ClickHouse/ClickHouse/pull/50546) ([auxten](https://github.com/auxten)).
+* Add async iteration to object storage [#50548](https://github.com/ClickHouse/ClickHouse/pull/50548) ([alesapin](https://github.com/alesapin)).
+* skip extracting darwin toolchain in builder when unncessary [#50550](https://github.com/ClickHouse/ClickHouse/pull/50550) ([SuperDJY](https://github.com/cmsxbc)).
+* Remove flaky test [#50558](https://github.com/ClickHouse/ClickHouse/pull/50558) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Revert "Disable skim (Rust library) under memory sanitizer" [#50574](https://github.com/ClickHouse/ClickHouse/pull/50574) ([Azat Khuzhin](https://github.com/azat)).
+* Analyzer: fix 01487_distributed_in_not_default_db [#50587](https://github.com/ClickHouse/ClickHouse/pull/50587) ([Dmitry Novik](https://github.com/novikd)).
+* Fix commit for DiskObjectStorage [#50599](https://github.com/ClickHouse/ClickHouse/pull/50599) ([alesapin](https://github.com/alesapin)).
+* Fix Jepsen runs in PRs [#50615](https://github.com/ClickHouse/ClickHouse/pull/50615) ([Antonio Andelic](https://github.com/antonio2368)).
+* Revert incorrect optimizations [#50629](https://github.com/ClickHouse/ClickHouse/pull/50629) ([Raúl Marín](https://github.com/Algunenano)).
+* Disable 01676_clickhouse_client_autocomplete under UBSan [#50636](https://github.com/ClickHouse/ClickHouse/pull/50636) ([Nikita Taranov](https://github.com/nickitat)).
+* Merging [#50329](https://github.com/ClickHouse/ClickHouse/issues/50329) [#50660](https://github.com/ClickHouse/ClickHouse/pull/50660) ([Anton Popov](https://github.com/CurtizJ)).
+* Revert "date_trunc function to always return DateTime type" [#50670](https://github.com/ClickHouse/ClickHouse/pull/50670) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Fix flaky test 02461_prewhere_row_level_policy_lightweight_delete [#50674](https://github.com/ClickHouse/ClickHouse/pull/50674) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix asan issue with analyzer and prewhere [#50685](https://github.com/ClickHouse/ClickHouse/pull/50685) ([Alexander Gololobov](https://github.com/davenger)).
+* Catch issues with dockerd during the build [#50700](https://github.com/ClickHouse/ClickHouse/pull/50700) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Temporarily disable annoy index tests (flaky for analyzer) [#50714](https://github.com/ClickHouse/ClickHouse/pull/50714) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix assertion from stress test [#50718](https://github.com/ClickHouse/ClickHouse/pull/50718) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix flaky unit test [#50719](https://github.com/ClickHouse/ClickHouse/pull/50719) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Show correct sharing state in system.query_cache [#50728](https://github.com/ClickHouse/ClickHouse/pull/50728) ([Robert Schulze](https://github.com/rschu1ze)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 653a0cd5388..9704c68be54 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,3 +1,4 @@
+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.2.37-lts	2023-04-22

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 0674/1478] 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 0675/1478] 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 0676/1478] 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 4009b5fef1db916eb6baa265f305ef412cffc8e3 Mon Sep 17 00:00:00 2001
From: Ilya Yatsishin <2159081+qoega@users.noreply.github.com>
Date: Fri, 9 Jun 2023 14:34:05 +0200
Subject: [PATCH 0677/1478] Update CHANGELOG.md

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a5b6dd85941..09c832f0c04 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,7 +12,7 @@
 
 #### Upgrade Notes
 * Compress marks and primary key by default. It significantly reduces the cold query time. Upgrade notes: the support for compressed marks and primary key has been added in version 22.9. If you turned on compressed marks or primary key or installed version 23.5 or newer, which has compressed marks or primary key on by default, you will not be able to downgrade to version 22.8 or earlier. You can also explicitly disable compressed marks or primary keys by specifying the `compress_marks` and `compress_primary_key` settings in the `<merge_tree>` section of the server configuration file. **Upgrade notes:** If you upgrade from versions prior to 22.9, you should either upgrade all replicas at once or disable the compression before upgrade, or upgrade through an intermediate version, where the compressed marks are supported but not enabled by default, such as 23.3. [#42587](https://github.com/ClickHouse/ClickHouse/pull/42587) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
-* Make local object storage work consistently with s3 object storage, fix problem with append (closes [#48465](https://github.com/ClickHouse/ClickHouse/issues/48465)), make it configurable as independent storage. The change is backward incompatible because the cache on top of local object storage is not incompatible to previous versions. [#48791](https://github.com/ClickHouse/ClickHouse/pull/48791) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Make local object storage work consistently with s3 object storage, fix problem with append (closes [#48465](https://github.com/ClickHouse/ClickHouse/issues/48465)), make it configurable as independent storage. The change is backward incompatible because the cache on top of local object storage is not compatible to previous versions. [#48791](https://github.com/ClickHouse/ClickHouse/pull/48791) ([Kseniia Sumarokova](https://github.com/kssenii)).
 * The experimental feature "in-memory data parts" is removed. The data format is still supported, but the settings are no-op, and compact or wide parts will be used instead. This closes [#45409](https://github.com/ClickHouse/ClickHouse/issues/45409). [#49429](https://github.com/ClickHouse/ClickHouse/pull/49429) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Changed default values of settings `parallelize_output_from_storages` and `input_format_parquet_preserve_order`. This allows ClickHouse to reorder rows when reading from files (e.g. CSV or Parquet), greatly improving performance in many cases. To restore the old behavior of preserving order, use `parallelize_output_from_storages = 0`, `input_format_parquet_preserve_order = 1`. [#49479](https://github.com/ClickHouse/ClickHouse/pull/49479) ([Michael Kolupaev](https://github.com/al13n321)).
 * Make projections production-ready. Add the `optimize_use_projections` setting to control whether the projections will be selected for SELECT queries. The setting `allow_experimental_projection_optimization` is obsolete and does nothing. [#49719](https://github.com/ClickHouse/ClickHouse/pull/49719) ([Alexey Milovidov](https://github.com/alexey-milovidov)).

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 0678/1478] 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 0679/1478] 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 0680/1478] 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 0681/1478] 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 0682/1478] 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 0683/1478] 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 0684/1478] 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 0685/1478] 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 0686/1478] 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 0687/1478] 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 0688/1478] 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 0689/1478] 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 0690/1478] 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 0691/1478] 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 8c4c82abd65753dcbe887c78baec2ab9c1f960d9 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Fri, 9 Jun 2023 15:11:07 +0200
Subject: [PATCH 0692/1478] Update lz4 to enable cutting-edge optimisations
 (#50621)

---
 contrib/lz4 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/lz4 b/contrib/lz4
index 4c9431e9af5..e82198428c8 160000
--- a/contrib/lz4
+++ b/contrib/lz4
@@ -1 +1 @@
-Subproject commit 4c9431e9af596af0556e5da0ae99305bafb2b10b
+Subproject commit e82198428c8061372d5adef1f9bfff4203f6081e

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 0693/1478] 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 ab0a01e4649d54bed7e3a5e1bc7ca22f97c9cec6 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 9 Jun 2023 09:14:50 -0400
Subject: [PATCH 0694/1478] close result block

---
 docs/en/operations/system-tables/asynchronous_insert_log.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/operations/system-tables/asynchronous_insert_log.md b/docs/en/operations/system-tables/asynchronous_insert_log.md
index 8b0509d7000..c3aaa8e6c41 100644
--- a/docs/en/operations/system-tables/asynchronous_insert_log.md
+++ b/docs/en/operations/system-tables/asynchronous_insert_log.md
@@ -56,6 +56,7 @@ status:                  Ok
 flush_time:              2023-06-08 10:08:55
 flush_time_microseconds: 2023-06-08 10:08:55.139676
 flush_query_id:          cd2c1e43-83f5-49dc-92e4-2fbc7f8d3716
+```
 
 **See Also**
 

From 05cab78dd288c839d0d5bcafda070f8397c1fc53 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Fri, 9 Jun 2023 15:15:41 +0200
Subject: [PATCH 0695/1478] Fix bug in `uniqExact` parallel merging (#50590)

* impl

* disable test under sanitizers
---
 src/AggregateFunctions/UniqExactSet.h         | 51 +++++++++++--------
 ..._uniq_exact_parallel_merging_bug.reference |  0
 .../02782_uniq_exact_parallel_merging_bug.sh  | 21 ++++++++
 3 files changed, 51 insertions(+), 21 deletions(-)
 create mode 100644 tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.reference
 create mode 100755 tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.sh

diff --git a/src/AggregateFunctions/UniqExactSet.h b/src/AggregateFunctions/UniqExactSet.h
index 916dfe4a424..90cfe700179 100644
--- a/src/AggregateFunctions/UniqExactSet.h
+++ b/src/AggregateFunctions/UniqExactSet.h
@@ -1,10 +1,11 @@
 #pragma once
 
+#include <exception>
 #include <Common/CurrentThread.h>
 #include <Common/HashTable/HashSet.h>
 #include <Common/ThreadPool.h>
-#include <Common/setThreadName.h>
 #include <Common/scope_guard_safe.h>
+#include <Common/setThreadName.h>
 
 
 namespace DB
@@ -48,30 +49,38 @@ public:
             }
             else
             {
-                auto next_bucket_to_merge = std::make_shared<std::atomic_uint32_t>(0);
-
-                auto thread_func = [&lhs, &rhs, next_bucket_to_merge, thread_group = CurrentThread::getGroup()]()
+                try
                 {
-                    SCOPE_EXIT_SAFE(
-                        if (thread_group)
-                            CurrentThread::detachFromGroupIfNotDetached();
-                    );
-                    if (thread_group)
-                        CurrentThread::attachToGroupIfDetached(thread_group);
-                    setThreadName("UniqExactMerger");
+                    auto next_bucket_to_merge = std::make_shared<std::atomic_uint32_t>(0);
 
-                    while (true)
+                    auto thread_func = [&lhs, &rhs, next_bucket_to_merge, thread_group = CurrentThread::getGroup()]()
                     {
-                        const auto bucket = next_bucket_to_merge->fetch_add(1);
-                        if (bucket >= rhs.NUM_BUCKETS)
-                            return;
-                        lhs.impls[bucket].merge(rhs.impls[bucket]);
-                    }
-                };
+                        SCOPE_EXIT_SAFE(
+                            if (thread_group)
+                                CurrentThread::detachFromGroupIfNotDetached();
+                        );
+                        if (thread_group)
+                            CurrentThread::attachToGroupIfDetached(thread_group);
+                        setThreadName("UniqExactMerger");
 
-                for (size_t i = 0; i < std::min<size_t>(thread_pool->getMaxThreads(), rhs.NUM_BUCKETS); ++i)
-                    thread_pool->scheduleOrThrowOnError(thread_func);
-                thread_pool->wait();
+                        while (true)
+                        {
+                            const auto bucket = next_bucket_to_merge->fetch_add(1);
+                            if (bucket >= rhs.NUM_BUCKETS)
+                                return;
+                            lhs.impls[bucket].merge(rhs.impls[bucket]);
+                        }
+                    };
+
+                    for (size_t i = 0; i < std::min<size_t>(thread_pool->getMaxThreads(), rhs.NUM_BUCKETS); ++i)
+                        thread_pool->scheduleOrThrowOnError(thread_func);
+                    thread_pool->wait();
+                }
+                catch (...)
+                {
+                    thread_pool->wait();
+                    throw;
+                }
             }
         }
     }
diff --git a/tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.reference b/tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.sh b/tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.sh
new file mode 100755
index 00000000000..d84ffd21b87
--- /dev/null
+++ b/tests/queries/0_stateless/02782_uniq_exact_parallel_merging_bug.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Tags: long, no-random-settings, no-tsan, no-asan, no-ubsan, no-msan
+
+# shellcheck disable=SC2154
+
+unset CLICKHOUSE_LOG_COMMENT
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+
+clickhouse-client -q "
+    CREATE TABLE ${CLICKHOUSE_DATABASE}.t(s String)
+    ENGINE = MergeTree
+    ORDER BY tuple();
+"
+
+clickhouse-client -q "insert into ${CLICKHOUSE_DATABASE}.t select number%10==0 ? toString(number) : '' from numbers_mt(1e7)"
+
+clickhouse-benchmark -q "select count(distinct s) from ${CLICKHOUSE_DATABASE}.t settings max_memory_usage = '50Mi'" --ignore-error -c 16 -i 1000 2>/dev/null

From 07582d56f32d72a3f13d9e7303310ff1753c97f5 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 9 Jun 2023 13:18:13 +0000
Subject: [PATCH 0696/1478] Add config for pinning api version

---
 src/Coordination/FourLetterCommand.cpp        |  2 +-
 src/Coordination/KeeperConstants.h            |  4 +-
 src/Coordination/KeeperContext.cpp            | 37 ++++++++
 src/Coordination/KeeperContext.h              |  6 ++
 src/Coordination/KeeperServer.cpp             |  2 +
 src/Coordination/KeeperSnapshotManager.cpp    |  2 +-
 src/Coordination/KeeperStorage.cpp            |  2 +-
 src/Coordination/tests/gtest_coordination.cpp |  2 +-
 .../__init__.py                               |  0
 .../configs/enable_keeper.xml                 | 31 +++++++
 .../test_keeper_api_version_config/test.py    | 87 +++++++++++++++++++
 11 files changed, 169 insertions(+), 6 deletions(-)
 create mode 100644 src/Coordination/KeeperContext.cpp
 create mode 100644 tests/integration/test_keeper_api_version_config/__init__.py
 create mode 100644 tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml
 create mode 100644 tests/integration/test_keeper_api_version_config/test.py

diff --git a/src/Coordination/FourLetterCommand.cpp b/src/Coordination/FourLetterCommand.cpp
index 7077e792fd8..a64969e3d31 100644
--- a/src/Coordination/FourLetterCommand.cpp
+++ b/src/Coordination/FourLetterCommand.cpp
@@ -486,7 +486,7 @@ String RecoveryCommand::run()
 
 String ApiVersionCommand::run()
 {
-    return toString(static_cast<uint8_t>(Coordination::current_keeper_api_version));
+    return toString(static_cast<uint8_t>(Coordination::latest_keeper_api_version));
 }
 
 String CreateSnapshotCommand::run()
diff --git a/src/Coordination/KeeperConstants.h b/src/Coordination/KeeperConstants.h
index 4b5a5b54be0..42161eee908 100644
--- a/src/Coordination/KeeperConstants.h
+++ b/src/Coordination/KeeperConstants.h
@@ -13,7 +13,7 @@ enum class KeeperApiVersion : uint8_t
     WITH_CHECK_NOT_EXISTS,
 };
 
-inline constexpr auto current_keeper_api_version = KeeperApiVersion::WITH_CHECK_NOT_EXISTS;
+inline constexpr auto latest_keeper_api_version = KeeperApiVersion::WITH_CHECK_NOT_EXISTS;
 
 const std::string keeper_system_path = "/keeper";
 const std::string keeper_api_version_path = keeper_system_path + "/api_version";
@@ -21,7 +21,7 @@ const std::string keeper_api_version_path = keeper_system_path + "/api_version";
 using PathWithData = std::pair<std::string_view, std::string>;
 const std::vector<PathWithData> child_system_paths_with_data
 {
-    {keeper_api_version_path, toString(static_cast<uint8_t>(current_keeper_api_version))}
+    {keeper_api_version_path, toString(static_cast<uint8_t>(latest_keeper_api_version))}
 };
 
 }
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
new file mode 100644
index 00000000000..d420242e670
--- /dev/null
+++ b/src/Coordination/KeeperContext.cpp
@@ -0,0 +1,37 @@
+#include <Coordination/KeeperContext.h>
+#include <Coordination/KeeperConstants.h>
+#include <Core/SettingsEnums.h>
+#include <Common/ErrorCodes.h>
+#include <Common/logger_useful.h>
+#include <Core/SettingsFields.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int BAD_ARGUMENTS;
+}
+
+DECLARE_SETTING_ENUM(KeeperApiVersion);
+IMPLEMENT_SETTING_ENUM(KeeperApiVersion, ErrorCodes::BAD_ARGUMENTS,
+    {{"ZOOKEEPER_COMPATIBLE", KeeperApiVersion::ZOOKEEPER_COMPATIBLE},
+     {"WITH_FILTERED_LIST", KeeperApiVersion::WITH_FILTERED_LIST},
+     {"WITH_MULTI_READ", KeeperApiVersion::WITH_MULTI_READ},
+     {"WITH_CHECK_NOT_EXISTS", KeeperApiVersion::WITH_CHECK_NOT_EXISTS}});
+
+void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
+{
+    for (const auto & [path, data] : child_system_paths_with_data)
+        system_nodes_with_data[std::string{path}] = data;
+    
+    if (config.has("keeper_server.api_version"))
+    {
+        auto version_string = config.getString("keeper_server.api_version");
+        auto api_version = SettingFieldKeeperApiVersionTraits::fromString(version_string);
+        LOG_INFO(&Poco::Logger::get("KeeperContext"), "API version override used: {}", version_string);
+        system_nodes_with_data[keeper_api_version_path] = toString(static_cast<uint8_t>(api_version));
+    }
+}
+
+}
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index 64fa8cea6ec..f26009c9af0 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -1,10 +1,14 @@
 #pragma once
 
+#include <Poco/Util/AbstractConfiguration.h>
+
 namespace DB
 {
 
 struct KeeperContext
 {
+    void initialize(const Poco::Util::AbstractConfiguration & config);
+
     enum class Phase : uint8_t
     {
         INIT,
@@ -16,6 +20,8 @@ struct KeeperContext
 
     bool ignore_system_path_on_startup{false};
     bool digest_enabled{true};
+
+    std::unordered_map<std::string, std::string> system_nodes_with_data;
 };
 
 using KeeperContextPtr = std::shared_ptr<KeeperContext>;
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 45db9e85fa5..897d7e05671 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -119,6 +119,8 @@ KeeperServer::KeeperServer(
     if (coordination_settings->quorum_reads)
         LOG_WARNING(log, "Quorum reads enabled, Keeper will work slower.");
 
+    keeper_context->initialize(config);
+
     keeper_context->digest_enabled = config.getBool("keeper_server.digest_enabled", false);
     keeper_context->ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
 
diff --git a/src/Coordination/KeeperSnapshotManager.cpp b/src/Coordination/KeeperSnapshotManager.cpp
index 8b80db3e520..a2d9d8136cd 100644
--- a/src/Coordination/KeeperSnapshotManager.cpp
+++ b/src/Coordination/KeeperSnapshotManager.cpp
@@ -185,7 +185,7 @@ void KeeperStorageSnapshot::serialize(const KeeperStorageSnapshot & snapshot, Wr
     }
 
     /// Serialize data tree
-    writeBinary(snapshot.snapshot_container_size - child_system_paths_with_data.size(), out);
+    writeBinary(snapshot.snapshot_container_size - keeper_context->system_nodes_with_data.size(), out);
     size_t counter = 0;
     for (auto it = snapshot.begin; counter < snapshot.snapshot_container_size; ++counter)
     {
diff --git a/src/Coordination/KeeperStorage.cpp b/src/Coordination/KeeperStorage.cpp
index 66d6b0f5843..8abcd062b7f 100644
--- a/src/Coordination/KeeperStorage.cpp
+++ b/src/Coordination/KeeperStorage.cpp
@@ -283,7 +283,7 @@ void KeeperStorage::initializeSystemNodes()
     }
 
     // insert child system nodes
-    for (const auto & [path, data] : child_system_paths_with_data)
+    for (const auto & [path, data] : keeper_context->system_nodes_with_data)
     {
         assert(keeper_api_version_path.starts_with(keeper_system_path));
         Node child_system_node;
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index 453fd0f2e60..005c67ad261 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -2357,7 +2357,7 @@ TEST_P(CoordinationTest, TestCurrentApiVersion)
     uint8_t keeper_version{0};
     DB::ReadBufferFromOwnString buf(get_response.data);
     DB::readIntText(keeper_version, buf);
-    EXPECT_EQ(keeper_version, static_cast<uint8_t>(current_keeper_api_version));
+    EXPECT_EQ(keeper_version, static_cast<uint8_t>(latest_keeper_api_version));
 }
 
 TEST_P(CoordinationTest, TestSystemNodeModify)
diff --git a/tests/integration/test_keeper_api_version_config/__init__.py b/tests/integration/test_keeper_api_version_config/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml b/tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml
new file mode 100644
index 00000000000..c153d025598
--- /dev/null
+++ b/tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml
@@ -0,0 +1,31 @@
+<clickhouse>
+    <keeper_server>
+        <tcp_port>9181</tcp_port>
+        <server_id>1</server_id>
+        <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
+        <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
+
+        <coordination_settings>
+            <snapshot_distance>10</snapshot_distance>
+            <reserved_log_items>5</reserved_log_items>
+            <operation_timeout_ms>5000</operation_timeout_ms>
+            <session_timeout_ms>10000</session_timeout_ms>
+            <raft_logs_level>trace</raft_logs_level>
+
+            <!-- For instant start in single node configuration -->
+            <heart_beat_interval_ms>0</heart_beat_interval_ms>
+            <election_timeout_lower_bound_ms>0</election_timeout_lower_bound_ms>
+            <election_timeout_upper_bound_ms>0</election_timeout_upper_bound_ms>
+        </coordination_settings>
+
+        <!-- API VERSION -->
+
+        <raft_configuration>
+            <server>
+                <id>1</id>
+                <hostname>localhost</hostname>
+                <port>9234</port>
+            </server>
+        </raft_configuration>
+    </keeper_server>
+</clickhouse>
diff --git a/tests/integration/test_keeper_api_version_config/test.py b/tests/integration/test_keeper_api_version_config/test.py
new file mode 100644
index 00000000000..34d3acc4f04
--- /dev/null
+++ b/tests/integration/test_keeper_api_version_config/test.py
@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+
+import pytest
+import os
+from helpers.cluster import ClickHouseCluster
+import helpers.keeper_utils as keeper_utils
+from kazoo.client import KazooClient, KazooState
+
+CURRENT_TEST_DIR = os.path.dirname(os.path.abspath(__file__))
+cluster = ClickHouseCluster(__file__)
+
+# clickhouse itself will use external zookeeper
+node = cluster.add_instance(
+    "node",
+    main_configs=["configs/enable_keeper.xml"],
+    stay_alive=True,
+)
+
+
+@pytest.fixture(scope="module")
+def started_cluster():
+    try:
+        cluster.start()
+
+        yield cluster
+
+    finally:
+        cluster.shutdown()
+
+
+def get_connection_zk(nodename, timeout=30.0):
+    _fake_zk_instance = KazooClient(
+        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
+    )
+    _fake_zk_instance.start()
+    return _fake_zk_instance
+
+
+def restart_clickhouse(api_version=None, expect_fail=True):
+    node.stop_clickhouse()
+    node.copy_file_to_container(
+        os.path.join(CURRENT_TEST_DIR, "configs/enable_keeper.xml"),
+        "/etc/clickhouse-server/config.d/enable_keeper.xml",
+    )
+
+    if api_version:
+        node.replace_in_config(
+            "/etc/clickhouse-server/config.d/enable_keeper.xml",
+            "<!-- API VERSION -->",
+            f"<api_version>{api_version}<\\/api_version>",
+        )
+
+    node.start_clickhouse(retry_start=not expect_fail)
+    keeper_utils.wait_until_connected(cluster, node)
+
+
+def test_keeper_api_version(started_cluster):
+    restart_clickhouse()
+
+    def assert_version(string_version, version_number):
+        node.wait_for_log_line(
+            f"Detected server's API version: {string_version}", look_behind_lines=1000
+        )
+
+        try:
+            node_zk = get_connection_zk(node.name)
+            assert node_zk.get("/keeper/api_version")[0] == str(version_number).encode()
+        finally:
+            if node_zk:
+                node_zk.stop()
+                node_zk.close()
+
+    assert_version("WITH_CHECK_NOT_EXISTS", 3)
+
+    for i, version in enumerate(
+        [
+            "ZOOKEEPER_COMPATIBLE",
+            "WITH_FILTERED_LIST",
+            "WITH_MULTI_READ",
+            "WITH_CHECK_NOT_EXISTS",
+        ]
+    ):
+        restart_clickhouse(version)
+        assert_version(version, i)
+
+    with pytest.raises(Exception):
+        restart_clickhouse("INVALID_VERSION", expect_fail=True)

From b8b70d78e15948dd278d298d42bc1e4ef2d4fc0d Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 9 Jun 2023 13:34:27 +0000
Subject: [PATCH 0697/1478] Build fix

---
 contrib/azure-cmake/CMakeLists.txt | 2 +-
 programs/keeper/CMakeLists.txt     | 1 +
 src/Coordination/KeeperContext.cpp | 7 +++++--
 src/Coordination/KeeperContext.h   | 2 ++
 4 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 9c361db47ca..23e38e6b63d 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 ARCH_PPC64LE)
+if (NOT ENABLE_AZURE_BLOB_STORAGE OR OS_FREEBSD OR ARCH_PPC64LE)
     message(STATUS "Not using Azure blob storage")
     return()
 endif()
diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 1f1138f49eb..4f74cc06801 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -43,6 +43,7 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperDispatcher.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperLogStore.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperServer.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperContext.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManager.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManagerS3.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStateMachine.cpp
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index d420242e670..a750f2e1860 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -20,11 +20,14 @@ IMPLEMENT_SETTING_ENUM(KeeperApiVersion, ErrorCodes::BAD_ARGUMENTS,
      {"WITH_MULTI_READ", KeeperApiVersion::WITH_MULTI_READ},
      {"WITH_CHECK_NOT_EXISTS", KeeperApiVersion::WITH_CHECK_NOT_EXISTS}});
 
-void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
+KeeperContext::KeeperContext()
 {
     for (const auto & [path, data] : child_system_paths_with_data)
         system_nodes_with_data[std::string{path}] = data;
-    
+}
+
+void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
+{
     if (config.has("keeper_server.api_version"))
     {
         auto version_string = config.getString("keeper_server.api_version");
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index f26009c9af0..de502b6c566 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -7,6 +7,8 @@ namespace DB
 
 struct KeeperContext
 {
+    KeeperContext();
+
     void initialize(const Poco::Util::AbstractConfiguration & config);
 
     enum class Phase : uint8_t

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 0698/1478] 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 af153399bf19d9dbb22253d6224fca37616401e3 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Fri, 9 Jun 2023 15:26:13 +0000
Subject: [PATCH 0699/1478] Update version_date.tsv and changelogs after
 v23.2.7.32-stable

---
 docs/changelogs/v23.2.7.32-stable.md | 35 ++++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 2 files changed, 36 insertions(+)
 create mode 100644 docs/changelogs/v23.2.7.32-stable.md

diff --git a/docs/changelogs/v23.2.7.32-stable.md b/docs/changelogs/v23.2.7.32-stable.md
new file mode 100644
index 00000000000..db5e9e76311
--- /dev/null
+++ b/docs/changelogs/v23.2.7.32-stable.md
@@ -0,0 +1,35 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.2.7.32-stable (934f6a2aa0e) FIXME as compared to v23.2.6.34-stable (570190045b0)
+
+#### Performance Improvement
+* Backported in [#49218](https://github.com/ClickHouse/ClickHouse/issues/49218): 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 [#49208](https://github.com/ClickHouse/ClickHouse/issues/49208): 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 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 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 Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* 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 9704c68be54..2aeeb5db35c 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -3,6 +3,7 @@ v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
+v23.2.7.32-stable	2023-06-09
 v23.2.6.34-stable	2023-04-23
 v23.2.5.46-stable	2023-04-03
 v23.2.4.12-stable	2023-03-10

From f8dc408ccbb600bd0c387feeedf899448501b8b1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 9 Jun 2023 16:23:22 +0000
Subject: [PATCH 0700/1478] Desctructing --> Destructing

---
 src/Interpreters/Context.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index 8fb06e21d22..995e78d8f0b 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -377,7 +377,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing remote fs threadpool reader");
+                LOG_DEBUG(log, "Destructing remote fs threadpool reader");
                 asynchronous_remote_fs_reader->wait();
                 asynchronous_remote_fs_reader.reset();
             }
@@ -391,7 +391,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing local fs threadpool reader");
+                LOG_DEBUG(log, "Destructing local fs threadpool reader");
                 asynchronous_local_fs_reader->wait();
                 asynchronous_local_fs_reader.reset();
             }
@@ -405,7 +405,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing local fs threadpool reader");
+                LOG_DEBUG(log, "Destructing local fs threadpool reader");
                 synchronous_local_fs_reader->wait();
                 synchronous_local_fs_reader.reset();
             }
@@ -419,7 +419,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing threadpool writer");
+                LOG_DEBUG(log, "Destructing threadpool writer");
                 threadpool_writer->wait();
                 threadpool_writer.reset();
             }
@@ -433,7 +433,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing marks loader");
+                LOG_DEBUG(log, "Destructing marks loader");
                 load_marks_threadpool->wait();
                 load_marks_threadpool.reset();
             }
@@ -447,7 +447,7 @@ struct ContextSharedPart : boost::noncopyable
         {
             try
             {
-                LOG_DEBUG(log, "Desctructing prefetch threadpool");
+                LOG_DEBUG(log, "Destructing prefetch threadpool");
                 prefetch_threadpool->wait();
                 prefetch_threadpool.reset();
             }

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 0701/1478] 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 0702/1478] 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 9a4043a4b4c97bcfb7eb345e0753b27228c2f4f7 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 9 Jun 2023 17:51:59 +0000
Subject: [PATCH 0703/1478] Fixing more tests.

---
 src/Analyzer/Passes/QueryAnalysisPass.cpp |   1 -
 src/Interpreters/PreparedSets.h           |   6 ++
 src/Planner/CollectSets.cpp               |  25 +++---
 src/Planner/CollectSets.h                 |   2 +-
 src/Planner/Planner.cpp                   | 103 +++++++++++-----------
 src/Planner/Utils.cpp                     |   4 +-
 src/Storages/StorageDistributed.cpp       |  11 ++-
 7 files changed, 82 insertions(+), 70 deletions(-)

diff --git a/src/Analyzer/Passes/QueryAnalysisPass.cpp b/src/Analyzer/Passes/QueryAnalysisPass.cpp
index b39aff86d32..bab64480901 100644
--- a/src/Analyzer/Passes/QueryAnalysisPass.cpp
+++ b/src/Analyzer/Passes/QueryAnalysisPass.cpp
@@ -2333,7 +2333,6 @@ QueryTreeNodePtr QueryAnalyzer::tryResolveTableIdentifierFromDatabaseCatalog(con
 
     auto storage_lock = storage->lockForShare(context->getInitialQueryId(), context->getSettingsRef().lock_acquire_timeout);
     auto storage_snapshot = storage->getStorageSnapshot(storage->getInMemoryMetadataPtr(), context);
-
     auto result = std::make_shared<TableNode>(std::move(storage), std::move(storage_lock), std::move(storage_snapshot));
     if (is_temporary_table)
         result->setTemporaryTableName(table_name);
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index fa7f7069994..a119c24ad10 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -29,6 +29,9 @@ class Set;
 using SetPtr = std::shared_ptr<Set>;
 class InterpreterSelectWithUnionQuery;
 
+class IQueryTreeNode;
+using QueryTreeNodePtr = std::shared_ptr<IQueryTreeNode>;
+
 /// Represents a set in a query that might be referenced at analysis time and built later during execution.
 /// Also it can represent a constant set that is ready to use.
 /// At analysis stage the FutureSets are created but not necessarily filled. Then for non-constant sets there
@@ -131,6 +134,7 @@ public:
 
     /// The source is obtained using the InterpreterSelectQuery subquery.
     std::unique_ptr<QueryPlan> source;
+    QueryTreeNodePtr query_tree;
 };
 
 class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_this<FutureSetFromSubquery>
@@ -153,6 +157,8 @@ public:
 
     // void addStorage(StoragePtr storage) { subquery.table = std::move(storage); }
 
+    SubqueryForSet & getSubquery() { return subquery; }
+
 private:
     //SetPtr set;
     SubqueryForSet subquery;
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 5f44994c14b..b3e3f5f472a 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -28,9 +28,9 @@ namespace
 class CollectSetsVisitor : public ConstInDepthQueryTreeVisitor<CollectSetsVisitor>
 {
 public:
-    explicit CollectSetsVisitor(PlannerContext & planner_context_, const SelectQueryOptions & select_query_options_)
+    explicit CollectSetsVisitor(PlannerContext & planner_context_) //, const SelectQueryOptions & select_query_options_)
         : planner_context(planner_context_)
-        , select_query_options(select_query_options_)
+        //, select_query_options(select_query_options_)
     {}
 
     void visitImpl(const QueryTreeNodePtr & node)
@@ -95,12 +95,12 @@ public:
             if (sets.getFuture(set_key))
                 return;
 
-            auto subquery_options = select_query_options.subquery();
-            Planner subquery_planner(
-                in_second_argument,
-                subquery_options,
-                planner_context.getGlobalPlannerContext());
-            subquery_planner.buildQueryPlanIfNeeded();
+            // auto subquery_options = select_query_options.subquery();
+            // Planner subquery_planner(
+            //     in_second_argument,
+            //     subquery_options,
+            //     planner_context.getGlobalPlannerContext());
+            // subquery_planner.buildQueryPlanIfNeeded();
 
             // const auto & settings = planner_context.getQueryContext()->getSettingsRef();
             // SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
@@ -109,7 +109,8 @@ public:
 
             SubqueryForSet subquery_for_set;
             subquery_for_set.key = planner_context.createSetKey(in_second_argument);
-            subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+            subquery_for_set.query_tree = in_second_argument;
+            //subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
 
             /// TODO
             sets.addFromSubquery(set_key, std::move(subquery_for_set), settings, nullptr);
@@ -132,14 +133,14 @@ public:
 
 private:
     PlannerContext & planner_context;
-    const SelectQueryOptions & select_query_options;
+    //const SelectQueryOptions & select_query_options;
 };
 
 }
 
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context, const SelectQueryOptions & select_query_options)
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context) //, const SelectQueryOptions & select_query_options)
 {
-    CollectSetsVisitor visitor(planner_context, select_query_options);
+    CollectSetsVisitor visitor(planner_context); //, select_query_options);
     visitor.visit(node);
 }
 
diff --git a/src/Planner/CollectSets.h b/src/Planner/CollectSets.h
index 57e662a392e..e0db802d3b4 100644
--- a/src/Planner/CollectSets.h
+++ b/src/Planner/CollectSets.h
@@ -12,6 +12,6 @@ struct SelectQueryOptions;
 /** Collect prepared sets and sets for subqueries that are necessary to execute IN function and its variations.
   * Collected sets are registered in planner context.
   */
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context, const SelectQueryOptions & select_query_options);
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context); //, const SelectQueryOptions & select_query_options);
 
 }
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index 3184e229c15..30510d05840 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -3,6 +3,7 @@
 #include <Core/ProtocolDefines.h>
 #include <Common/logger_useful.h>
 #include <Common/ProfileEvents.h>
+#include <Columns/ColumnSet.h>
 
 #include <DataTypes/DataTypeString.h>
 
@@ -893,50 +894,62 @@ void addOffsetStep(QueryPlan & query_plan, const QueryAnalysisResult & query_ana
     query_plan.addStep(std::move(offsets_step));
 }
 
-// void addBuildSubqueriesForSetsStepIfNeeded(QueryPlan & query_plan,
-//     const SelectQueryOptions & select_query_options,
-//     const PlannerContextPtr & planner_context,
-//     const std::vector<ActionsDAGPtr> & result_actions_to_execute)
-// {
-//     PreparedSets::SubqueriesForSets subqueries_for_sets;
+void addBuildSubqueriesForSetsStepIfNeeded(
+    QueryPlan & query_plan,
+    const SelectQueryOptions & select_query_options,
+    const PlannerContextPtr & planner_context,
+    const std::vector<ActionsDAGPtr> & result_actions_to_execute)
+{
+    auto subqueries = planner_context->getPreparedSets().detachSubqueries();
+    std::unordered_set<const FutureSet *> useful_sets;
 
-//     for (const auto & actions_to_execute : result_actions_to_execute)
-//     {
-//         for (const auto & node : actions_to_execute->getNodes())
-//         {
-//             const auto & set_key = node.result_name;
-//             auto * planner_set = planner_context->getSetOrNull(set_key);
-//             if (!planner_set)
-//                 continue;
+    PreparedSets::SubqueriesForSets subqueries_for_sets;
 
-//             if (planner_set->getSet().isCreated() || !planner_set->getSubqueryNode())
-//                 continue;
+    for (const auto & actions_to_execute : result_actions_to_execute)
+    {
+        for (const auto & node : actions_to_execute->getNodes())
+        {
+            if (node.column)
+            {
+                const IColumn * column = node.column.get();
+                if (const auto * column_const = typeid_cast<const ColumnConst *>(column))
+                    column = &column_const->getDataColumn();
 
-//             auto subquery_options = select_query_options.subquery();
-//             Planner subquery_planner(
-//                 planner_set->getSubqueryNode(),
-//                 subquery_options,
-//                 planner_context->getGlobalPlannerContext());
-//             subquery_planner.buildQueryPlanIfNeeded();
+                if (const auto * column_set = typeid_cast<const ColumnSet *>(column))
+                    useful_sets.insert(column_set->getData().get());
+            }
+        }
+    }
 
-//             const auto & settings = planner_context->getQueryContext()->getSettingsRef();
-//             SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
-//             bool tranform_null_in = settings.transform_null_in;
-//             auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, tranform_null_in);
+    auto predicate = [&useful_sets](const auto & set) { return !useful_sets.contains(set.set.get()); };
+    auto it = std::remove_if(subqueries.begin(), subqueries.end(), std::move(predicate));
+    subqueries.erase(it, subqueries.end());
 
-//             SubqueryForSet subquery_for_set;
-//             subquery_for_set.key = set_key;
-//             subquery_for_set.set_in_progress = set;
-//             subquery_for_set.set = planner_set->getSet();
-//             subquery_for_set.promise_to_fill_set = planner_set->extractPromiseToBuildSet();
-//             subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+    for (auto & subquery : subqueries)
+    {
+        auto & subquery_for_set = subquery.set->getSubquery();
+        auto subquery_options = select_query_options.subquery();
+        Planner subquery_planner(
+            subquery_for_set.query_tree,
+            subquery_options,
+            planner_context->getGlobalPlannerContext());
+        subquery_planner.buildQueryPlanIfNeeded();
 
-//             subqueries_for_sets.emplace(set_key, std::move(subquery_for_set));
-//         }
-//     }
+        subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+    }
 
-//     addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
-// }
+    //addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
+
+    if (!subqueries.empty())
+    {
+        auto step = std::make_unique<DelayedCreatingSetsStep>(
+            query_plan.getCurrentDataStream(),
+            std::move(subqueries),
+            planner_context->getQueryContext());
+
+        query_plan.addStep(std::move(step));
+    }
+}
 
 /// Support for `additional_result_filter` setting
 void addAdditionalFilterStepIfNeeded(QueryPlan & query_plan,
@@ -1197,7 +1210,7 @@ void Planner::buildPlanForQueryNode()
     }
 
     checkStoragesSupportTransactions(planner_context);
-    collectSets(query_tree, *planner_context, select_query_options);
+    collectSets(query_tree, *planner_context); //, select_query_options);
     collectTableExpressionData(query_tree, planner_context);
 
     const auto & settings = query_context->getSettingsRef();
@@ -1497,20 +1510,8 @@ void Planner::buildPlanForQueryNode()
 
     if (!select_query_options.only_analyze)
     {
-        auto subqueries = planner_context->getPreparedSets().detachSubqueries();
-
-        if (!subqueries.empty())
-        {
-            auto step = std::make_unique<DelayedCreatingSetsStep>(
-                query_plan.getCurrentDataStream(),
-                std::move(subqueries),
-                planner_context->getQueryContext());
-
-            query_plan.addStep(std::move(step));
-        }
-
         //addCreatingSetsStep(query_plan, planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()), planner_context->getQueryContext());
-        //addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
+        addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
     }
 }
 
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index 2b4febf58ea..372bb15822a 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -426,7 +426,7 @@ SelectQueryInfo buildSelectQueryInfo(const QueryTreeNodePtr & query_tree, const
 FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
         const QueryTreeNodePtr & table_expression,
         PlannerContextPtr & planner_context,
-        const SelectQueryOptions & select_query_options,
+        [[maybe_unused]] const SelectQueryOptions & select_query_options,
         NameSet table_expression_required_names_without_filter)
 {
     const auto & query_context = planner_context->getQueryContext();
@@ -444,7 +444,7 @@ FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
     }
 
     collectSourceColumns(filter_query_tree, planner_context);
-    collectSets(filter_query_tree, *planner_context, select_query_options);
+    collectSets(filter_query_tree, *planner_context); //, select_query_options);
 
     auto filter_actions_dag = std::make_shared<ActionsDAG>();
 
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index b0fb07d69ce..64a621e5710 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -30,6 +30,7 @@
 #include <Common/randomSeed.h>
 #include <Common/formatReadable.h>
 #include <Common/CurrentMetrics.h>
+#include <QueryPipeline/printPipeline.h>
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -898,9 +899,13 @@ QueryTreeNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
     temporary_table_expression_node->setTemporaryTableName(temporary_table_name);
 
     auto table_out = external_storage->write({}, external_storage->getInMemoryMetadataPtr(), mutable_context);
-    auto io = interpreter.execute();
-    io.pipeline.complete(std::move(table_out));
-    CompletedPipelineExecutor executor(io.pipeline);
+
+    auto optimization_settings = QueryPlanOptimizationSettings::fromContext(mutable_context);
+    auto build_pipeline_settings = BuildQueryPipelineSettings::fromContext(mutable_context);
+    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*query_plan.buildQueryPipeline(optimization_settings, build_pipeline_settings)));
+
+    pipeline.complete(std::move(table_out));
+    CompletedPipelineExecutor executor(pipeline);
     executor.execute();
 
     mutable_context->addExternalTable(temporary_table_name, std::move(external_storage_holder));

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 0704/1478] 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 e094bf3247b82c94098567a4f8f172e57fcdc017 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Fri, 9 Jun 2023 18:30:47 +0000
Subject: [PATCH 0705/1478] Resolving conflicts.

---
 src/Planner/CollectSets.cpp                   | 33 ++++++++++-
 .../QueryPlan/ReadFromMergeTree.cpp           | 58 ++++++++++++++-----
 2 files changed, 76 insertions(+), 15 deletions(-)

diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index be4cb0e2e2b..68ad1ab78d3 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -8,6 +8,7 @@
 #include <Analyzer/Utils.h>
 #include <Analyzer/SetUtils.h>
 #include <Analyzer/InDepthQueryTreeVisitor.h>
+#include <Analyzer/ColumnNode.h>
 #include <Analyzer/ConstantNode.h>
 #include <Analyzer/FunctionNode.h>
 #include <Analyzer/TableNode.h>
@@ -96,6 +97,36 @@ public:
             if (sets.getFuture(set_key))
                 return;
 
+            auto subquery_to_execute = in_second_argument;
+
+            if (auto * table_node = in_second_argument->as<TableNode>())
+            {
+                auto storage_snapshot = table_node->getStorageSnapshot();
+                auto columns_to_select = storage_snapshot->getColumns(GetColumnsOptions(GetColumnsOptions::Ordinary));
+
+                size_t columns_to_select_size = columns_to_select.size();
+
+                auto column_nodes_to_select = std::make_shared<ListNode>();
+                column_nodes_to_select->getNodes().reserve(columns_to_select_size);
+
+                NamesAndTypes projection_columns;
+                projection_columns.reserve(columns_to_select_size);
+
+                for (auto & column : columns_to_select)
+                {
+                    column_nodes_to_select->getNodes().emplace_back(std::make_shared<ColumnNode>(column, subquery_to_execute));
+                    projection_columns.emplace_back(column.name, column.type);
+                }
+
+                auto subquery_for_table = std::make_shared<QueryNode>(Context::createCopy(planner_context.getQueryContext()));
+                subquery_for_table->setIsSubquery(true);
+                subquery_for_table->getProjectionNode() = std::move(column_nodes_to_select);
+                subquery_for_table->getJoinTree() = std::move(subquery_to_execute);
+                subquery_for_table->resolveProjectionColumns(std::move(projection_columns));
+
+                subquery_to_execute = std::move(subquery_for_table);
+            }
+
             // auto subquery_options = select_query_options.subquery();
             // Planner subquery_planner(
             //     in_second_argument,
@@ -110,7 +141,7 @@ public:
 
             SubqueryForSet subquery_for_set;
             subquery_for_set.key = planner_context.createSetKey(in_second_argument);
-            subquery_for_set.query_tree = in_second_argument;
+            subquery_for_set.query_tree = std::move(subquery_to_execute);
             //subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
 
             /// TODO
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 8483df797ef..8f610eb4380 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -37,6 +37,8 @@
 #include <Common/JSONBuilder.h>
 #include <Common/isLocalAddress.h>
 #include <Common/logger_useful.h>
+#include <Parsers/parseIdentifierOrStringLiteral.h>
+#include <Parsers/ExpressionListParsers.h>
 
 #include <algorithm>
 #include <functional>
@@ -100,6 +102,7 @@ namespace ErrorCodes
     extern const int INDEX_NOT_USED;
     extern const int LOGICAL_ERROR;
     extern const int TOO_MANY_ROWS;
+    extern const int CANNOT_PARSE_TEXT;
 }
 
 static MergeTreeReaderSettings getMergeTreeReaderSettings(
@@ -1245,29 +1248,56 @@ static void buildIndexes(
         info = &*info_copy;
     }
 
+    std::unordered_set<std::string> ignored_index_names;
+
+    if (settings.ignore_data_skipping_indices.changed)
+    {
+        const auto & indices = settings.ignore_data_skipping_indices.toString();
+        Tokens tokens(indices.data(), indices.data() + indices.size(), settings.max_query_size);
+        IParser::Pos pos(tokens, static_cast<unsigned>(settings.max_parser_depth));
+        Expected expected;
+
+        /// Use an unordered list rather than string vector
+        auto parse_single_id_or_literal = [&]
+        {
+            String str;
+            if (!parseIdentifierOrStringLiteral(pos, expected, str))
+                return false;
+
+            ignored_index_names.insert(std::move(str));
+            return true;
+        };
+
+        if (!ParserList::parseUtil(pos, expected, parse_single_id_or_literal, false))
+            throw Exception(ErrorCodes::CANNOT_PARSE_TEXT, "Cannot parse ignore_data_skipping_indices ('{}')", indices);
+    }
+
     UsefulSkipIndexes skip_indexes;
     using Key = std::pair<String, size_t>;
     std::map<Key, size_t> merged;
 
     for (const auto & index : metadata_snapshot->getSecondaryIndices())
     {
-        auto index_helper = MergeTreeIndexFactory::instance().get(index);
-        if (index_helper->isMergeable())
+        if (!ignored_index_names.contains(index.name))
         {
-            auto [it, inserted] = merged.emplace(Key{index_helper->index.type, index_helper->getGranularity()}, skip_indexes.merged_indices.size());
-            if (inserted)
+            auto index_helper = MergeTreeIndexFactory::instance().get(index);
+            if (index_helper->isMergeable())
             {
-                skip_indexes.merged_indices.emplace_back();
-                skip_indexes.merged_indices.back().condition = index_helper->createIndexMergedCondition(*info, metadata_snapshot);
-            }
+                auto [it, inserted] = merged.emplace(Key{index_helper->index.type, index_helper->getGranularity()}, skip_indexes.merged_indices.size());
+                if (inserted)
+                {
+                    skip_indexes.merged_indices.emplace_back();
+                    skip_indexes.merged_indices.back().condition = index_helper->createIndexMergedCondition(*info, metadata_snapshot);
+                }
 
-            skip_indexes.merged_indices[it->second].addIndex(index_helper);
-        }
-        else
-        {
-            auto condition = index_helper->createIndexCondition(*info, context);
-            if (!condition->alwaysUnknownOrTrue())
-                skip_indexes.useful_indices.emplace_back(index_helper, condition);
+                skip_indexes.merged_indices[it->second].addIndex(index_helper);
+            }
+            else
+            {
+                auto condition = index_helper->createIndexCondition(*info, context);
+                if (!condition->alwaysUnknownOrTrue())
+                    skip_indexes.useful_indices.emplace_back(index_helper, condition);
+            }
         }
     }
 

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 0706/1478] 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 0707/1478] 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 0708/1478] 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 0709/1478] 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 41c34aaf5ef747c98fb98fdb0c08c17bcb35bc78 Mon Sep 17 00:00:00 2001
From: Hongbin Ma <mahongbin@apache.org>
Date: Mon, 22 May 2023 19:54:08 +0800
Subject: [PATCH 0710/1478] optimize parquet write performance for parallel
 threads

fix CI

fix review comments and CI
---
 .../Formats/Impl/ArrowBlockOutputFormat.cpp   |   4 +-
 .../Formats/Impl/CHColumnToArrowColumn.cpp    |  99 ++++++----
 .../Formats/Impl/CHColumnToArrowColumn.h      |   2 +-
 .../Formats/Impl/ParquetBlockOutputFormat.cpp | 179 +++++++++---------
 .../Formats/Impl/ParquetBlockOutputFormat.h   |   9 +-
 5 files changed, 154 insertions(+), 139 deletions(-)

diff --git a/src/Processors/Formats/Impl/ArrowBlockOutputFormat.cpp b/src/Processors/Formats/Impl/ArrowBlockOutputFormat.cpp
index 1e72c949b09..8bd1cf3897d 100644
--- a/src/Processors/Formats/Impl/ArrowBlockOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/ArrowBlockOutputFormat.cpp
@@ -58,7 +58,9 @@ void ArrowBlockOutputFormat::consume(Chunk chunk)
             format_settings.arrow.output_fixed_string_as_fixed_byte_array);
     }
 
-    ch_column_to_arrow_column->chChunkToArrowTable(arrow_table, chunk, columns_num);
+    auto chunks = std::vector<Chunk>();
+    chunks.push_back(std::move(chunk));
+    ch_column_to_arrow_column->chChunkToArrowTable(arrow_table, chunks, columns_num);
 
     if (!writer)
         prepareWriter(arrow_table->schema());
diff --git a/src/Processors/Formats/Impl/CHColumnToArrowColumn.cpp b/src/Processors/Formats/Impl/CHColumnToArrowColumn.cpp
index 19b2dcccf64..c3685e813d3 100644
--- a/src/Processors/Formats/Impl/CHColumnToArrowColumn.cpp
+++ b/src/Processors/Formats/Impl/CHColumnToArrowColumn.cpp
@@ -976,56 +976,75 @@ namespace DB
 
     void CHColumnToArrowColumn::chChunkToArrowTable(
         std::shared_ptr<arrow::Table> & res,
-        const Chunk & chunk,
+        const std::vector<Chunk> & chunks,
         size_t columns_num)
     {
-        /// For arrow::Schema and arrow::Table creation
-        std::vector<std::shared_ptr<arrow::Array>> arrow_arrays;
-        arrow_arrays.reserve(columns_num);
-        for (size_t column_i = 0; column_i < columns_num; ++column_i)
+        std::shared_ptr<arrow::Schema> arrow_schema;
+        std::vector<arrow::ArrayVector> table_data(columns_num);
+
+        for (const auto & chunk : chunks)
         {
-            const ColumnWithTypeAndName & header_column = header_columns[column_i];
-            auto column = chunk.getColumns()[column_i];
-
-            if (!low_cardinality_as_dictionary)
-                column = recursiveRemoveLowCardinality(column);
-
-            if (!is_arrow_fields_initialized)
+            /// For arrow::Schema and arrow::Table creation
+            for (size_t column_i = 0; column_i < columns_num; ++column_i)
             {
-                bool is_column_nullable = false;
-                auto arrow_type = getArrowType(header_column.type, column, header_column.name, format_name, output_string_as_string, output_fixed_string_as_fixed_byte_array, &is_column_nullable);
-                arrow_fields.emplace_back(std::make_shared<arrow::Field>(header_column.name, arrow_type, is_column_nullable));
+                const ColumnWithTypeAndName & header_column = header_columns[column_i];
+                auto column = chunk.getColumns()[column_i];
+
+                if (!low_cardinality_as_dictionary)
+                    column = recursiveRemoveLowCardinality(column);
+
+                if (!is_arrow_fields_initialized)
+                {
+                    bool is_column_nullable = false;
+                    auto arrow_type = getArrowType(
+                        header_column.type,
+                        column,
+                        header_column.name,
+                        format_name,
+                        output_string_as_string,
+                        output_fixed_string_as_fixed_byte_array,
+                        &is_column_nullable);
+                    arrow_fields.emplace_back(std::make_shared<arrow::Field>(header_column.name, arrow_type, is_column_nullable));
+                }
+
+                arrow::MemoryPool * pool = arrow::default_memory_pool();
+                std::unique_ptr<arrow::ArrayBuilder> array_builder;
+                arrow::Status status = MakeBuilder(pool, arrow_fields[column_i]->type(), &array_builder);
+                checkStatus(status, column->getName(), format_name);
+
+                fillArrowArray(
+                    header_column.name,
+                    column,
+                    header_column.type,
+                    nullptr,
+                    array_builder.get(),
+                    format_name,
+                    0,
+                    column->size(),
+                    output_string_as_string,
+                    output_fixed_string_as_fixed_byte_array,
+                    dictionary_values);
+
+                std::shared_ptr<arrow::Array> arrow_array;
+                status = array_builder->Finish(&arrow_array);
+                checkStatus(status, column->getName(), format_name);
+
+                table_data.at(column_i).emplace_back(std::move(arrow_array));
             }
 
-            arrow::MemoryPool* pool = arrow::default_memory_pool();
-            std::unique_ptr<arrow::ArrayBuilder> array_builder;
-            arrow::Status status = MakeBuilder(pool, arrow_fields[column_i]->type(), &array_builder);
-            checkStatus(status, column->getName(), format_name);
-
-            fillArrowArray(
-                header_column.name,
-                column,
-                header_column.type,
-                nullptr,
-                array_builder.get(),
-                format_name,
-                0,
-                column->size(),
-                output_string_as_string,
-                output_fixed_string_as_fixed_byte_array,
-                dictionary_values);
-
-            std::shared_ptr<arrow::Array> arrow_array;
-            status = array_builder->Finish(&arrow_array);
-            checkStatus(status, column->getName(), format_name);
-            arrow_arrays.emplace_back(std::move(arrow_array));
+            is_arrow_fields_initialized = true;
+            if (!arrow_schema)
+                arrow_schema = std::make_shared<arrow::Schema>(arrow_fields);
         }
 
-        std::shared_ptr<arrow::Schema> arrow_schema = std::make_shared<arrow::Schema>(arrow_fields);
+        std::vector<std::shared_ptr<arrow::ChunkedArray>> columns;
+        columns.reserve(columns_num);
+        for (size_t column_i = 0; column_i < columns_num; ++column_i)
+            columns.emplace_back(std::make_shared<arrow::ChunkedArray>(table_data.at(column_i)));
 
-        res = arrow::Table::Make(arrow_schema, arrow_arrays);
-        is_arrow_fields_initialized = true;
+        res = arrow::Table::Make(arrow_schema, columns);
     }
+
 }
 
 #endif
diff --git a/src/Processors/Formats/Impl/CHColumnToArrowColumn.h b/src/Processors/Formats/Impl/CHColumnToArrowColumn.h
index 3649d0eed9b..02766e299a0 100644
--- a/src/Processors/Formats/Impl/CHColumnToArrowColumn.h
+++ b/src/Processors/Formats/Impl/CHColumnToArrowColumn.h
@@ -16,7 +16,7 @@ class CHColumnToArrowColumn
 public:
     CHColumnToArrowColumn(const Block & header, const std::string & format_name_, bool low_cardinality_as_dictionary_, bool output_string_as_string_, bool output_fixed_string_as_fixed_byte_array_);
 
-    void chChunkToArrowTable(std::shared_ptr<arrow::Table> & res, const Chunk & chunk, size_t columns_num);
+    void chChunkToArrowTable(std::shared_ptr<arrow::Table> & res, const std::vector<Chunk> & chunk, size_t columns_num);
 
 private:
     ColumnsWithTypeAndName header_columns;
diff --git a/src/Processors/Formats/Impl/ParquetBlockOutputFormat.cpp b/src/Processors/Formats/Impl/ParquetBlockOutputFormat.cpp
index 031e499b545..91840cd2c50 100644
--- a/src/Processors/Formats/Impl/ParquetBlockOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/ParquetBlockOutputFormat.cpp
@@ -20,47 +20,47 @@ namespace ErrorCodes
 namespace
 {
 
-parquet::ParquetVersion::type getParquetVersion(const FormatSettings & settings)
-{
-    switch (settings.parquet.output_version)
+    parquet::ParquetVersion::type getParquetVersion(const FormatSettings & settings)
     {
-        case FormatSettings::ParquetVersion::V1_0:
-            return parquet::ParquetVersion::PARQUET_1_0;
-        case FormatSettings::ParquetVersion::V2_4:
-            return parquet::ParquetVersion::PARQUET_2_4;
-        case FormatSettings::ParquetVersion::V2_6:
-            return parquet::ParquetVersion::PARQUET_2_6;
-        case FormatSettings::ParquetVersion::V2_LATEST:
-            return parquet::ParquetVersion::PARQUET_2_LATEST;
+        switch (settings.parquet.output_version)
+        {
+            case FormatSettings::ParquetVersion::V1_0:
+                return parquet::ParquetVersion::PARQUET_1_0;
+            case FormatSettings::ParquetVersion::V2_4:
+                return parquet::ParquetVersion::PARQUET_2_4;
+            case FormatSettings::ParquetVersion::V2_6:
+                return parquet::ParquetVersion::PARQUET_2_6;
+            case FormatSettings::ParquetVersion::V2_LATEST:
+                return parquet::ParquetVersion::PARQUET_2_LATEST;
+        }
     }
-}
 
-parquet::Compression::type getParquetCompression(FormatSettings::ParquetCompression method)
-{
-    if (method == FormatSettings::ParquetCompression::NONE)
-        return parquet::Compression::type::UNCOMPRESSED;
+    parquet::Compression::type getParquetCompression(FormatSettings::ParquetCompression method)
+    {
+        if (method == FormatSettings::ParquetCompression::NONE)
+            return parquet::Compression::type::UNCOMPRESSED;
 
 #if USE_SNAPPY
-    if (method == FormatSettings::ParquetCompression::SNAPPY)
-        return parquet::Compression::type::SNAPPY;
+        if (method == FormatSettings::ParquetCompression::SNAPPY)
+            return parquet::Compression::type::SNAPPY;
 #endif
 
 #if USE_BROTLI
-    if (method == FormatSettings::ParquetCompression::BROTLI)
-        return parquet::Compression::type::BROTLI;
+        if (method == FormatSettings::ParquetCompression::BROTLI)
+            return parquet::Compression::type::BROTLI;
 #endif
 
-    if (method == FormatSettings::ParquetCompression::ZSTD)
-        return parquet::Compression::type::ZSTD;
+        if (method == FormatSettings::ParquetCompression::ZSTD)
+            return parquet::Compression::type::ZSTD;
 
-    if (method == FormatSettings::ParquetCompression::LZ4)
-        return parquet::Compression::type::LZ4;
+        if (method == FormatSettings::ParquetCompression::LZ4)
+            return parquet::Compression::type::LZ4;
 
-    if (method == FormatSettings::ParquetCompression::GZIP)
-        return parquet::Compression::type::GZIP;
+        if (method == FormatSettings::ParquetCompression::GZIP)
+            return parquet::Compression::type::GZIP;
 
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Unsupported compression method");
-}
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Unsupported compression method");
+    }
 
 }
 
@@ -69,70 +69,9 @@ ParquetBlockOutputFormat::ParquetBlockOutputFormat(WriteBuffer & out_, const Blo
 {
 }
 
-void ParquetBlockOutputFormat::consume(Chunk chunk)
+void ParquetBlockOutputFormat::consumeStaged()
 {
-    /// Do something like SquashingTransform to produce big enough row groups.
-    /// Because the real SquashingTransform is only used for INSERT, not for SELECT ... INTO OUTFILE.
-    /// The latter doesn't even have a pipeline where a transform could be inserted, so it's more
-    /// convenient to do the squashing here.
-
-    appendToAccumulatedChunk(std::move(chunk));
-
-    if (!accumulated_chunk)
-        return;
-
-    const size_t target_rows = std::max(static_cast<UInt64>(1), format_settings.parquet.row_group_rows);
-
-    if (accumulated_chunk.getNumRows() < target_rows &&
-        accumulated_chunk.bytes() < format_settings.parquet.row_group_bytes)
-        return;
-
-    /// Increase row group size slightly (by < 2x) to avoid adding a small row groups for the
-    /// remainder of the new chunk.
-    /// E.g. suppose input chunks are 70K rows each, and max_rows = 1M. Then we'll have
-    /// getNumRows() = 1.05M. We want to write all 1.05M as one row group instead of 1M and 0.05M.
-    size_t num_row_groups = std::max(static_cast<UInt64>(1), accumulated_chunk.getNumRows() / target_rows);
-    size_t row_group_size = (accumulated_chunk.getNumRows() - 1) / num_row_groups + 1; // round up
-
-    write(std::move(accumulated_chunk), row_group_size);
-    accumulated_chunk.clear();
-}
-
-void ParquetBlockOutputFormat::finalizeImpl()
-{
-    if (accumulated_chunk)
-        write(std::move(accumulated_chunk), format_settings.parquet.row_group_rows);
-
-    if (!file_writer)
-    {
-        Block header = materializeBlock(getPort(PortKind::Main).getHeader());
-        write(Chunk(header.getColumns(), 0), 1);
-    }
-
-    auto status = file_writer->Close();
-    if (!status.ok())
-        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION, "Error while closing a table: {}", status.ToString());
-}
-
-void ParquetBlockOutputFormat::resetFormatterImpl()
-{
-    file_writer.reset();
-}
-
-void ParquetBlockOutputFormat::appendToAccumulatedChunk(Chunk chunk)
-{
-    if (!accumulated_chunk)
-    {
-        accumulated_chunk = std::move(chunk);
-        return;
-    }
-    chassert(accumulated_chunk.getNumColumns() == chunk.getNumColumns());
-    accumulated_chunk.append(chunk);
-}
-
-void ParquetBlockOutputFormat::write(Chunk chunk, size_t row_group_size)
-{
-    const size_t columns_num = chunk.getNumColumns();
+    const size_t columns_num = staging_chunks.at(0).getNumColumns();
     std::shared_ptr<arrow::Table> arrow_table;
 
     if (!ch_column_to_arrow_column)
@@ -146,7 +85,7 @@ void ParquetBlockOutputFormat::write(Chunk chunk, size_t row_group_size)
             format_settings.parquet.output_fixed_string_as_fixed_byte_array);
     }
 
-    ch_column_to_arrow_column->chChunkToArrowTable(arrow_table, chunk, columns_num);
+    ch_column_to_arrow_column->chChunkToArrowTable(arrow_table, staging_chunks, columns_num);
 
     if (!file_writer)
     {
@@ -173,12 +112,66 @@ void ParquetBlockOutputFormat::write(Chunk chunk, size_t row_group_size)
         file_writer = std::move(result.ValueOrDie());
     }
 
-    auto status = file_writer->WriteTable(*arrow_table, row_group_size);
+    // TODO: calculate row_group_size depending on a number of rows and table size
+
+    // allow slightly bigger than row_group_size to avoid a very small tail row group
+    auto status = file_writer->WriteTable(*arrow_table, std::max<size_t>(format_settings.parquet.row_group_rows, staging_rows));
 
     if (!status.ok())
         throw Exception(ErrorCodes::UNKNOWN_EXCEPTION, "Error while writing a table: {}", status.ToString());
 }
 
+void ParquetBlockOutputFormat::consume(Chunk chunk)
+{
+    /// Do something like SquashingTransform to produce big enough row groups.
+    /// Because the real SquashingTransform is only used for INSERT, not for SELECT ... INTO OUTFILE.
+    /// The latter doesn't even have a pipeline where a transform could be inserted, so it's more
+    /// convenient to do the squashing here.
+    staging_rows += chunk.getNumRows();
+    staging_bytes += chunk.bytes();
+    staging_chunks.push_back(std::move(chunk));
+    chassert(staging_chunks.back().getNumColumns() == staging_chunks.front().getNumColumns());
+    if (staging_rows < format_settings.parquet.row_group_rows &&
+        staging_bytes < format_settings.parquet.row_group_bytes)
+    {
+        return;
+    }
+    else
+    {
+        consumeStaged();
+        staging_chunks.clear();
+        staging_rows = 0;
+        staging_bytes = 0;
+    }
+}
+
+void ParquetBlockOutputFormat::finalizeImpl()
+{
+    if (!file_writer && staging_chunks.empty())
+    {
+        Block header = materializeBlock(getPort(PortKind::Main).getHeader());
+
+        consume(Chunk(header.getColumns(), 0)); // this will make staging_chunks non-empty
+    }
+
+    if (!staging_chunks.empty())
+    {
+        consumeStaged();
+        staging_chunks.clear();
+        staging_rows = 0;
+        staging_bytes = 0;
+    }
+
+    auto status = file_writer->Close();
+    if (!status.ok())
+        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION, "Error while closing a table: {}", status.ToString());
+}
+
+void ParquetBlockOutputFormat::resetFormatterImpl()
+{
+    file_writer.reset();
+}
+
 void registerOutputFormatParquet(FormatFactory & factory)
 {
     factory.registerOutputFormat(
diff --git a/src/Processors/Formats/Impl/ParquetBlockOutputFormat.h b/src/Processors/Formats/Impl/ParquetBlockOutputFormat.h
index 0fb7013e6d6..482c778bc52 100644
--- a/src/Processors/Formats/Impl/ParquetBlockOutputFormat.h
+++ b/src/Processors/Formats/Impl/ParquetBlockOutputFormat.h
@@ -34,18 +34,19 @@ public:
     String getContentType() const override { return "application/octet-stream"; }
 
 private:
+    void consumeStaged();
     void consume(Chunk) override;
-    void appendToAccumulatedChunk(Chunk chunk);
-    void write(Chunk chunk, size_t row_group_size);
     void finalizeImpl() override;
     void resetFormatterImpl() override;
 
+    std::vector<Chunk> staging_chunks;
+    size_t staging_rows = 0;
+    size_t staging_bytes = 0;
+
     const FormatSettings format_settings;
 
     std::unique_ptr<parquet::arrow::FileWriter> file_writer;
     std::unique_ptr<CHColumnToArrowColumn> ch_column_to_arrow_column;
-
-    Chunk accumulated_chunk;
 };
 
 }

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 0711/1478] 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 0712/1478] 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 0713/1478] 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 0714/1478] 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 0715/1478] 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 0716/1478] 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 0717/1478] 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 0718/1478] 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 0719/1478] 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 0720/1478] 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 0721/1478] 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 0722/1478] 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 0723/1478] 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 0724/1478] 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 0725/1478] 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 0726/1478] 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 0727/1478] 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 0728/1478] 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 0729/1478] 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 0730/1478] 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 0731/1478] 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 0732/1478] 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 0733/1478] 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 0734/1478] 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 0735/1478] 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 0736/1478] 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 0737/1478] 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 0738/1478] 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 0739/1478] 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 0740/1478] 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 0741/1478] 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 0742/1478] 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 0743/1478] 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 0744/1478] 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 0745/1478] 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 0746/1478] 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 0747/1478] 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 0748/1478] 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 0749/1478] 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 b634012feb40445079145639d23c44967c00547e Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Mon, 12 Jun 2023 10:57:03 +0000
Subject: [PATCH 0750/1478] Add feature flags for Keeper API

---
 src/Common/ZooKeeper/IKeeper.h                |   4 +-
 src/Common/ZooKeeper/TestKeeper.h             |   5 +-
 src/Common/ZooKeeper/ZooKeeper.cpp            |   4 +-
 src/Common/ZooKeeper/ZooKeeper.h              |   7 +-
 src/Common/ZooKeeper/ZooKeeperArgs.cpp        |   1 +
 src/Common/ZooKeeper/ZooKeeperImpl.cpp        |  60 +++++++----
 src/Common/ZooKeeper/ZooKeeperImpl.h          |   7 +-
 .../ZooKeeper/ZooKeeperWithFaultInjection.h   |   4 +-
 src/Coordination/CoordinationSettings.cpp     |   2 +-
 src/Coordination/FourLetterCommand.cpp        |  27 ++++-
 src/Coordination/FourLetterCommand.h          |  12 +++
 src/Coordination/KeeperConstants.h            |   9 +-
 src/Coordination/KeeperContext.cpp            |  46 ++++----
 src/Coordination/KeeperContext.h              |   3 +
 src/Coordination/KeeperDispatcher.cpp         |  47 ++++----
 src/Coordination/KeeperDispatcher.h           |   8 ++
 src/Coordination/KeeperFeatureFlags.cpp       | 102 ++++++++++++++++++
 src/Coordination/KeeperFeatureFlags.h         |  49 +++++++++
 src/Coordination/KeeperServer.cpp             |   8 +-
 src/Coordination/KeeperServer.h               |   1 +
 src/Coordination/KeeperStorage.cpp            |   4 +-
 src/Coordination/tests/gtest_coordination.cpp |  15 +--
 .../StorageSystemZooKeeperConnection.cpp      |   4 +-
 .../test_keeper_api_version_config/test.py    |  87 ---------------
 .../__init__.py                               |   0
 .../configs/enable_keeper.xml                 |   2 +-
 .../test_keeper_feature_flags_config/test.py  |  92 ++++++++++++++++
 27 files changed, 422 insertions(+), 188 deletions(-)
 create mode 100644 src/Coordination/KeeperFeatureFlags.cpp
 create mode 100644 src/Coordination/KeeperFeatureFlags.h
 delete mode 100644 tests/integration/test_keeper_api_version_config/test.py
 rename tests/integration/{test_keeper_api_version_config => test_keeper_feature_flags_config}/__init__.py (100%)
 rename tests/integration/{test_keeper_api_version_config => test_keeper_feature_flags_config}/configs/enable_keeper.xml (97%)
 create mode 100644 tests/integration/test_keeper_feature_flags_config/test.py

diff --git a/src/Common/ZooKeeper/IKeeper.h b/src/Common/ZooKeeper/IKeeper.h
index 3eb5819df90..369aacf16c7 100644
--- a/src/Common/ZooKeeper/IKeeper.h
+++ b/src/Common/ZooKeeper/IKeeper.h
@@ -2,7 +2,7 @@
 
 #include <base/types.h>
 #include <Common/Exception.h>
-#include <Coordination/KeeperConstants.h>
+#include <Coordination/KeeperFeatureFlags.h>
 #include <Poco/Net/SocketAddress.h>
 
 #include <vector>
@@ -530,7 +530,7 @@ public:
         const Requests & requests,
         MultiCallback callback) = 0;
 
-    virtual DB::KeeperApiVersion getApiVersion() const = 0;
+    virtual bool isFeatureEnabled(DB::KeeperFeatureFlag feature_flag) const = 0;
 
     /// Expire session and finish all pending requests
     virtual void finalize(const String & reason) = 0;
diff --git a/src/Common/ZooKeeper/TestKeeper.h b/src/Common/ZooKeeper/TestKeeper.h
index 4bffa4e1d4f..9bbd018cfb1 100644
--- a/src/Common/ZooKeeper/TestKeeper.h
+++ b/src/Common/ZooKeeper/TestKeeper.h
@@ -11,6 +11,7 @@
 #include <Common/ZooKeeper/ZooKeeperArgs.h>
 #include <Common/ThreadPool.h>
 #include <Common/ConcurrentBoundedQueue.h>
+#include <Coordination/KeeperFeatureFlags.h>
 
 
 namespace Coordination
@@ -92,9 +93,9 @@ public:
 
     void finalize(const String & reason) override;
 
-    DB::KeeperApiVersion getApiVersion() const override
+    bool isFeatureEnabled(DB::KeeperFeatureFlag) const override
     {
-        return KeeperApiVersion::ZOOKEEPER_COMPATIBLE;
+        return false;
     }
 
     struct Node
diff --git a/src/Common/ZooKeeper/ZooKeeper.cpp b/src/Common/ZooKeeper/ZooKeeper.cpp
index a587ad6caf4..826032fc56b 100644
--- a/src/Common/ZooKeeper/ZooKeeper.cpp
+++ b/src/Common/ZooKeeper/ZooKeeper.cpp
@@ -865,9 +865,9 @@ bool ZooKeeper::expired()
     return impl->isExpired();
 }
 
-DB::KeeperApiVersion ZooKeeper::getApiVersion() const
+bool ZooKeeper::isFeatureEnabled(DB::KeeperFeatureFlag feature_flag) const
 {
-    return impl->getApiVersion();
+    return impl->isFeatureEnabled(feature_flag);
 }
 
 Int64 ZooKeeper::getClientID()
diff --git a/src/Common/ZooKeeper/ZooKeeper.h b/src/Common/ZooKeeper/ZooKeeper.h
index 96f9914b597..a4a631b9d5a 100644
--- a/src/Common/ZooKeeper/ZooKeeper.h
+++ b/src/Common/ZooKeeper/ZooKeeper.h
@@ -15,6 +15,7 @@
 #include <Common/ZooKeeper/ZooKeeperConstants.h>
 #include <Common/ZooKeeper/ZooKeeperArgs.h>
 #include <Common/thread_local_rng.h>
+#include <Coordination/KeeperFeatureFlags.h>
 #include <unistd.h>
 #include <random>
 
@@ -215,7 +216,7 @@ public:
     /// Returns true, if the session has expired.
     bool expired();
 
-    DB::KeeperApiVersion getApiVersion() const;
+    bool isFeatureEnabled(DB::KeeperFeatureFlag feature_flag) const;
 
     /// Create a znode.
     /// Throw an exception if something went wrong.
@@ -553,7 +554,7 @@ private:
     template <typename TResponse, bool try_multi, typename TIter>
     MultiReadResponses<TResponse, try_multi> multiRead(TIter start, TIter end, RequestFactory request_factory, AsyncFunction<TResponse> async_fun)
     {
-        if (getApiVersion() >= DB::KeeperApiVersion::WITH_MULTI_READ)
+        if (isFeatureEnabled(DB::KeeperFeatureFlag::MULTI_READ))
         {
             Coordination::Requests requests;
             for (auto it = start; it != end; ++it)
@@ -685,7 +686,7 @@ String getZooKeeperConfigName(const Poco::Util::AbstractConfiguration & config);
 template <typename Client>
 void addCheckNotExistsRequest(Coordination::Requests & requests, const Client & client, const std::string & path)
 {
-    if (client.getApiVersion() >= DB::KeeperApiVersion::WITH_CHECK_NOT_EXISTS)
+    if (client.isFeatureEnabled(DB::KeeperFeatureFlag::CHECK_NOT_EXISTS))
     {
         auto request = std::make_shared<Coordination::CheckRequest>();
         request->path = path;
diff --git a/src/Common/ZooKeeper/ZooKeeperArgs.cpp b/src/Common/ZooKeeper/ZooKeeperArgs.cpp
index 0ebc7f667cb..e99285b0056 100644
--- a/src/Common/ZooKeeper/ZooKeeperArgs.cpp
+++ b/src/Common/ZooKeeper/ZooKeeperArgs.cpp
@@ -4,6 +4,7 @@
 #include <base/getFQDNOrHostName.h>
 #include <Poco/Util/AbstractConfiguration.h>
 #include <Common/isLocalAddress.h>
+#include <Common/StringUtils/StringUtils.h>
 #include <Poco/String.h>
 
 namespace DB
diff --git a/src/Common/ZooKeeper/ZooKeeperImpl.cpp b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
index 7f23ac00efe..bf0d1871244 100644
--- a/src/Common/ZooKeeper/ZooKeeperImpl.cpp
+++ b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
@@ -354,7 +354,8 @@ ZooKeeper::ZooKeeper(
         send_thread = ThreadFromGlobalPool([this] { sendThread(); });
         receive_thread = ThreadFromGlobalPool([this] { receiveThread(); });
 
-        initApiVersion();
+        initFeatureFlags();
+        keeper_feature_flags.logFlags(log);
 
         ProfileEvents::increment(ProfileEvents::ZooKeeperInit);
     }
@@ -1089,41 +1090,58 @@ void ZooKeeper::pushRequest(RequestInfo && info)
     ProfileEvents::increment(ProfileEvents::ZooKeeperTransactions);
 }
 
-KeeperApiVersion ZooKeeper::getApiVersion() const
+bool ZooKeeper::isFeatureEnabled(KeeperFeatureFlag feature_flag) const
 {
-    return keeper_api_version;
+    return keeper_feature_flags.isEnabled(feature_flag);
 }
 
-void ZooKeeper::initApiVersion()
+void ZooKeeper::initFeatureFlags()
 {
-    auto promise = std::make_shared<std::promise<Coordination::GetResponse>>();
-    auto future = promise->get_future();
-
-    auto callback = [promise](const Coordination::GetResponse & response) mutable
+    const auto try_get = [&](const std::string & path, const std::string & description) -> std::optional<std::string>
     {
-        promise->set_value(response);
+        auto promise = std::make_shared<std::promise<Coordination::GetResponse>>();
+        auto future = promise->get_future();
+
+        auto callback = [promise](const Coordination::GetResponse & response) mutable
+        {
+            promise->set_value(response);
+        };
+
+        get(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 {}: timeout", description);
+            return std::nullopt;
+        }
+
+        auto response = future.get();
+
+        if (response.error != Coordination::Error::ZOK)
+        {
+            LOG_TRACE(log, "Failed to get {}", description);
+            return std::nullopt;
+        }
+
+        return std::move(response.data);
     };
 
-    get(keeper_api_version_path, std::move(callback), {});
-    if (future.wait_for(std::chrono::milliseconds(args.operation_timeout_ms)) != std::future_status::ready)
+    if (auto feature_flags = try_get(keeper_api_feature_flags_path, "feature flags"); feature_flags.has_value())
     {
-        LOG_TRACE(log, "Failed to get API version: timeout");
+        keeper_feature_flags.setFeatureFlags(std::move(*feature_flags));
         return;
     }
 
-    auto response = future.get();
+    auto keeper_api_version_string = try_get(keeper_api_version_path, "API version");
 
-    if (response.error != Coordination::Error::ZOK)
-    {
-        LOG_TRACE(log, "Failed to get API version");
+    if (!keeper_api_version_string.has_value())
         return;
-    }
 
+    DB::ReadBufferFromOwnString buf(*keeper_api_version_string);
     uint8_t keeper_version{0};
-    DB::ReadBufferFromOwnString buf(response.data);
     DB::readIntText(keeper_version, buf);
-    keeper_api_version = static_cast<DB::KeeperApiVersion>(keeper_version);
+    auto keeper_api_version = static_cast<DB::KeeperApiVersion>(keeper_version);
     LOG_TRACE(log, "Detected server's API version: {}", keeper_api_version);
+    keeper_feature_flags.fromApiVersion(keeper_api_version);
 }
 
 
@@ -1243,7 +1261,7 @@ void ZooKeeper::list(
     WatchCallback watch)
 {
     std::shared_ptr<ZooKeeperListRequest> request{nullptr};
-    if (keeper_api_version < Coordination::KeeperApiVersion::WITH_FILTERED_LIST)
+    if (!isFeatureEnabled(KeeperFeatureFlag::FILTERED_LIST))
     {
         if (list_request_type != ListRequestType::ALL)
             throw Exception(Error::ZBADARGUMENTS, "Filtered list request type cannot be used because it's not supported by the server");
@@ -1308,7 +1326,7 @@ void ZooKeeper::multi(
 {
     ZooKeeperMultiRequest request(requests, default_acls);
 
-    if (request.getOpNum() == OpNum::MultiRead && keeper_api_version < Coordination::KeeperApiVersion::WITH_MULTI_READ)
+    if (request.getOpNum() == OpNum::MultiRead && !isFeatureEnabled(KeeperFeatureFlag::MULTI_READ))
             throw Exception(Error::ZBADARGUMENTS, "MultiRead request type cannot be used because it's not supported by the server");
 
     RequestInfo request_info;
diff --git a/src/Common/ZooKeeper/ZooKeeperImpl.h b/src/Common/ZooKeeper/ZooKeeperImpl.h
index 944c5032fac..ae6bef067e3 100644
--- a/src/Common/ZooKeeper/ZooKeeperImpl.h
+++ b/src/Common/ZooKeeper/ZooKeeperImpl.h
@@ -9,6 +9,7 @@
 #include <Common/ZooKeeper/ZooKeeperCommon.h>
 #include <Common/ZooKeeper/ZooKeeperArgs.h>
 #include <Coordination/KeeperConstants.h>
+#include <Coordination/KeeperFeatureFlags.h>
 
 #include <IO/ReadBuffer.h>
 #include <IO/WriteBuffer.h>
@@ -181,7 +182,7 @@ public:
         const Requests & requests,
         MultiCallback callback) override;
 
-    DB::KeeperApiVersion getApiVersion() const override;
+    bool isFeatureEnabled(KeeperFeatureFlag feature_flag) const override;
 
     /// Without forcefully invalidating (finalizing) ZooKeeper session before
     /// establishing a new one, there was a possibility that server is using
@@ -312,12 +313,12 @@ private:
 
     void logOperationIfNeeded(const ZooKeeperRequestPtr & request, const ZooKeeperResponsePtr & response = nullptr, bool finalize = false, UInt64 elapsed_ms = 0);
 
-    void initApiVersion();
+    void initFeatureFlags();
 
     CurrentMetrics::Increment active_session_metric_increment{CurrentMetrics::ZooKeeperSession};
     std::shared_ptr<ZooKeeperLog> zk_log;
 
-    DB::KeeperApiVersion keeper_api_version{DB::KeeperApiVersion::ZOOKEEPER_COMPATIBLE};
+    DB::KeeperFeatureFlags keeper_feature_flags;
 };
 
 }
diff --git a/src/Common/ZooKeeper/ZooKeeperWithFaultInjection.h b/src/Common/ZooKeeper/ZooKeeperWithFaultInjection.h
index bf99cb76798..9d02d674010 100644
--- a/src/Common/ZooKeeper/ZooKeeperWithFaultInjection.h
+++ b/src/Common/ZooKeeper/ZooKeeperWithFaultInjection.h
@@ -402,9 +402,9 @@ public:
         ephemeral_nodes.clear();
     }
 
-    KeeperApiVersion getApiVersion() const
+    bool isFeatureEnabled(KeeperFeatureFlag feature_flag) const
     {
-        return keeper->getApiVersion();
+        return keeper->isFeatureEnabled(feature_flag);
     }
 
 private:
diff --git a/src/Coordination/CoordinationSettings.cpp b/src/Coordination/CoordinationSettings.cpp
index 7a66134f43f..edbdfd4f9fc 100644
--- a/src/Coordination/CoordinationSettings.cpp
+++ b/src/Coordination/CoordinationSettings.cpp
@@ -36,7 +36,7 @@ void CoordinationSettings::loadFromConfig(const String & config_elem, const Poco
 }
 
 
-const String KeeperConfigurationAndSettings::DEFAULT_FOUR_LETTER_WORD_CMD = "conf,cons,crst,envi,ruok,srst,srvr,stat,wchs,dirs,mntr,isro,rcvr,apiv,csnp,lgif,rqld,rclc,clrs";
+const String KeeperConfigurationAndSettings::DEFAULT_FOUR_LETTER_WORD_CMD = "conf,cons,crst,envi,ruok,srst,srvr,stat,wchs,dirs,mntr,isro,rcvr,apiv,csnp,lgif,rqld,rclc,clrs,ftfl";
 
 KeeperConfigurationAndSettings::KeeperConfigurationAndSettings()
     : server_id(NOT_EXIST)
diff --git a/src/Coordination/FourLetterCommand.cpp b/src/Coordination/FourLetterCommand.cpp
index a64969e3d31..55120e70d99 100644
--- a/src/Coordination/FourLetterCommand.cpp
+++ b/src/Coordination/FourLetterCommand.cpp
@@ -9,6 +9,7 @@
 #include <Common/getCurrentProcessFDCount.h>
 #include <Common/getMaxFileDescriptorCount.h>
 #include <Common/StringUtils/StringUtils.h>
+#include "Coordination/KeeperFeatureFlags.h"
 #include <Coordination/Keeper4LWInfo.h>
 #include <IO/WriteHelpers.h>
 #include <IO/Operators.h>
@@ -153,6 +154,9 @@ void FourLetterCommandFactory::registerCommands(KeeperDispatcher & keeper_dispat
         FourLetterCommandPtr clean_resources_command = std::make_shared<CleanResourcesCommand>(keeper_dispatcher);
         factory.registerCommand(clean_resources_command);
 
+        FourLetterCommandPtr feature_flags_command = std::make_shared<FeatureFlagsCommand>(keeper_dispatcher);
+        factory.registerCommand(feature_flags_command);
+
         factory.initializeAllowList(keeper_dispatcher);
         factory.setInitialize(true);
     }
@@ -486,7 +490,7 @@ String RecoveryCommand::run()
 
 String ApiVersionCommand::run()
 {
-    return toString(static_cast<uint8_t>(Coordination::latest_keeper_api_version));
+    return toString(0);
 }
 
 String CreateSnapshotCommand::run()
@@ -535,4 +539,25 @@ String CleanResourcesCommand::run()
     return "ok";
 }
 
+String FeatureFlagsCommand::run()
+{
+    const auto & feature_flags = keeper_dispatcher.getKeeperContext()->feature_flags;
+
+    StringBuffer ret;
+
+    auto append = [&ret] (String key, uint8_t value) -> void
+    {
+        writeText(key, ret);
+        writeText('\t', ret);
+        writeText(std::to_string(value), ret);
+        writeText('\n', ret);
+    };
+
+    for (const auto feature : all_keeper_feature_flags)
+        append(SettingFieldKeeperFeatureFlagTraits::toString(feature), feature_flags.isEnabled(feature));
+
+    return ret.str();
+
+}
+
 }
diff --git a/src/Coordination/FourLetterCommand.h b/src/Coordination/FourLetterCommand.h
index c1a91303c05..eb2cf9419ae 100644
--- a/src/Coordination/FourLetterCommand.h
+++ b/src/Coordination/FourLetterCommand.h
@@ -401,4 +401,16 @@ struct CleanResourcesCommand : public IFourLetterCommand
     ~CleanResourcesCommand() override = default;
 };
 
+struct FeatureFlagsCommand : public IFourLetterCommand
+{
+    explicit FeatureFlagsCommand(KeeperDispatcher & keeper_dispatcher_)
+        : IFourLetterCommand(keeper_dispatcher_)
+    {
+    }
+
+    String name() override { return "ftfl"; }
+    String run() override;
+    ~FeatureFlagsCommand() override = default;
+};
+
 }
diff --git a/src/Coordination/KeeperConstants.h b/src/Coordination/KeeperConstants.h
index 42161eee908..6d9c03ca8a9 100644
--- a/src/Coordination/KeeperConstants.h
+++ b/src/Coordination/KeeperConstants.h
@@ -5,6 +5,7 @@
 namespace DB
 {
 
+/// left for backwards compatibility
 enum class KeeperApiVersion : uint8_t
 {
     ZOOKEEPER_COMPATIBLE = 0,
@@ -13,15 +14,9 @@ enum class KeeperApiVersion : uint8_t
     WITH_CHECK_NOT_EXISTS,
 };
 
-inline constexpr auto latest_keeper_api_version = KeeperApiVersion::WITH_CHECK_NOT_EXISTS;
 
 const std::string keeper_system_path = "/keeper";
 const std::string keeper_api_version_path = keeper_system_path + "/api_version";
-
-using PathWithData = std::pair<std::string_view, std::string>;
-const std::vector<PathWithData> child_system_paths_with_data
-{
-    {keeper_api_version_path, toString(static_cast<uint8_t>(latest_keeper_api_version))}
-};
+const std::string keeper_api_feature_flags_path = keeper_system_path + "/feature_flags";
 
 }
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index a750f2e1860..dc408afc19a 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -1,40 +1,42 @@
 #include <Coordination/KeeperContext.h>
 #include <Coordination/KeeperConstants.h>
-#include <Core/SettingsEnums.h>
-#include <Common/ErrorCodes.h>
 #include <Common/logger_useful.h>
-#include <Core/SettingsFields.h>
 
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int BAD_ARGUMENTS;
-}
-
-DECLARE_SETTING_ENUM(KeeperApiVersion);
-IMPLEMENT_SETTING_ENUM(KeeperApiVersion, ErrorCodes::BAD_ARGUMENTS,
-    {{"ZOOKEEPER_COMPATIBLE", KeeperApiVersion::ZOOKEEPER_COMPATIBLE},
-     {"WITH_FILTERED_LIST", KeeperApiVersion::WITH_FILTERED_LIST},
-     {"WITH_MULTI_READ", KeeperApiVersion::WITH_MULTI_READ},
-     {"WITH_CHECK_NOT_EXISTS", KeeperApiVersion::WITH_CHECK_NOT_EXISTS}});
-
 KeeperContext::KeeperContext()
 {
-    for (const auto & [path, data] : child_system_paths_with_data)
-        system_nodes_with_data[std::string{path}] = data;
+    /// enable by default some feature flags
+    feature_flags.enableFeatureFlag(KeeperFeatureFlag::FILTERED_LIST);
+    feature_flags.enableFeatureFlag(KeeperFeatureFlag::MULTI_READ);
+    system_nodes_with_data[keeper_api_feature_flags_path] = feature_flags.getFeatureFlags();
 }
 
 void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
 {
-    if (config.has("keeper_server.api_version"))
+    digest_enabled = config.getBool("keeper_server.digest_enabled", false);
+    ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
+
+    static const std::string feature_flags_key = "keeper_server.feature_flags";
+    if (config.has(feature_flags_key))
     {
-        auto version_string = config.getString("keeper_server.api_version");
-        auto api_version = SettingFieldKeeperApiVersionTraits::fromString(version_string);
-        LOG_INFO(&Poco::Logger::get("KeeperContext"), "API version override used: {}", version_string);
-        system_nodes_with_data[keeper_api_version_path] = toString(static_cast<uint8_t>(api_version));
+        Poco::Util::AbstractConfiguration::Keys keys;
+        config.keys(feature_flags_key, keys);
+        for (const auto & key : keys)
+        {
+            auto feature_flag = SettingFieldKeeperFeatureFlagTraits::fromString(key);
+            auto is_enabled = config.getBool(feature_flags_key + "." + key);
+            if (is_enabled)
+                feature_flags.enableFeatureFlag(feature_flag);
+            else
+                feature_flags.disableFeatureFlag(feature_flag);
+        }
+
+        system_nodes_with_data[keeper_api_feature_flags_path] = feature_flags.getFeatureFlags();
     }
+
+    feature_flags.logFlags(&Poco::Logger::get("KeeperContext"));
 }
 
 }
diff --git a/src/Coordination/KeeperContext.h b/src/Coordination/KeeperContext.h
index de502b6c566..9b7000fa726 100644
--- a/src/Coordination/KeeperContext.h
+++ b/src/Coordination/KeeperContext.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <Poco/Util/AbstractConfiguration.h>
+#include <Coordination/KeeperFeatureFlags.h>
 
 namespace DB
 {
@@ -24,6 +25,8 @@ struct KeeperContext
     bool digest_enabled{true};
 
     std::unordered_map<std::string, std::string> system_nodes_with_data;
+
+    KeeperFeatureFlags feature_flags;
 };
 
 using KeeperContextPtr = std::shared_ptr<KeeperContext>;
diff --git a/src/Coordination/KeeperDispatcher.cpp b/src/Coordination/KeeperDispatcher.cpp
index d64134f3024..7318a492b35 100644
--- a/src/Coordination/KeeperDispatcher.cpp
+++ b/src/Coordination/KeeperDispatcher.cpp
@@ -336,28 +336,39 @@ void KeeperDispatcher::initialize(const Poco::Util::AbstractConfiguration & conf
 
     snapshot_s3.startup(config, macros);
 
-    server = std::make_unique<KeeperServer>(configuration_and_settings, config, responses_queue, snapshots_queue, snapshot_s3, [this](const KeeperStorage::RequestForSession & request_for_session)
-    {
-        /// check if we have queue of read requests depending on this request to be committed
-        std::lock_guard lock(read_request_queue_mutex);
-        if (auto it = read_request_queue.find(request_for_session.session_id); it != read_request_queue.end())
+    keeper_context = std::make_shared<KeeperContext>();
+    keeper_context->initialize(config);
+
+    server = std::make_unique<KeeperServer>(
+        configuration_and_settings,
+        config,
+        responses_queue,
+        snapshots_queue,
+        keeper_context,
+        snapshot_s3,
+        [this](const KeeperStorage::RequestForSession & request_for_session)
         {
-            auto & xid_to_request_queue = it->second;
-
-            if (auto request_queue_it = xid_to_request_queue.find(request_for_session.request->xid); request_queue_it != xid_to_request_queue.end())
+            /// check if we have queue of read requests depending on this request to be committed
+            std::lock_guard lock(read_request_queue_mutex);
+            if (auto it = read_request_queue.find(request_for_session.session_id); it != read_request_queue.end())
             {
-                for (const auto & read_request : request_queue_it->second)
-                {
-                    if (server->isLeaderAlive())
-                        server->putLocalReadRequest(read_request);
-                    else
-                        addErrorResponses({read_request}, Coordination::Error::ZCONNECTIONLOSS);
-                }
+                auto & xid_to_request_queue = it->second;
 
-                xid_to_request_queue.erase(request_queue_it);
+                if (auto request_queue_it = xid_to_request_queue.find(request_for_session.request->xid);
+                    request_queue_it != xid_to_request_queue.end())
+                {
+                    for (const auto & read_request : request_queue_it->second)
+                    {
+                        if (server->isLeaderAlive())
+                            server->putLocalReadRequest(read_request);
+                        else
+                            addErrorResponses({read_request}, Coordination::Error::ZCONNECTIONLOSS);
+                    }
+
+                    xid_to_request_queue.erase(request_queue_it);
+                }
             }
-        }
-    });
+        });
 
     try
     {
diff --git a/src/Coordination/KeeperDispatcher.h b/src/Coordination/KeeperDispatcher.h
index 4b8b134cf8f..1759f55d981 100644
--- a/src/Coordination/KeeperDispatcher.h
+++ b/src/Coordination/KeeperDispatcher.h
@@ -81,6 +81,8 @@ private:
 
     KeeperSnapshotManagerS3 snapshot_s3;
 
+    KeeperContextPtr keeper_context;
+
     /// Thread put requests to raft
     void requestThread();
     /// Thread put responses for subscribed sessions
@@ -198,6 +200,12 @@ public:
         return configuration_and_settings;
     }
 
+    const KeeperContextPtr & getKeeperContext() const
+    {
+        return keeper_context;
+    }
+
+
     void incrementPacketsSent()
     {
         keeper_stats.incrementPacketsSent();
diff --git a/src/Coordination/KeeperFeatureFlags.cpp b/src/Coordination/KeeperFeatureFlags.cpp
new file mode 100644
index 00000000000..216dca014d4
--- /dev/null
+++ b/src/Coordination/KeeperFeatureFlags.cpp
@@ -0,0 +1,102 @@
+#include <Coordination/KeeperFeatureFlags.h>
+#include <Common/ErrorCodes.h>
+#include <Common/Exception.h>
+#include <Common/logger_useful.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int BAD_ARGUMENTS;
+}
+
+namespace
+{
+
+std::pair<size_t, size_t> getByteAndBitIndex(size_t num)
+{
+    size_t byte_idx = num / 8;
+    auto bit_idx = (7 - num % 8);
+    return {byte_idx, bit_idx};
+}
+
+}
+
+IMPLEMENT_SETTING_ENUM(KeeperFeatureFlag, ErrorCodes::BAD_ARGUMENTS,
+     {{"filtered_list", KeeperFeatureFlag::FILTERED_LIST},
+     {"multi_read", KeeperFeatureFlag::MULTI_READ},
+     {"check_not_exists", KeeperFeatureFlag::CHECK_NOT_EXISTS}});
+
+KeeperFeatureFlags::KeeperFeatureFlags()
+{
+    /// get byte idx of largest value
+    auto [byte_idx, _] = getByteAndBitIndex(all_keeper_feature_flags.size() - 1);
+    feature_flags = std::string(byte_idx + 1, 0);
+}
+
+KeeperFeatureFlags::KeeperFeatureFlags(std::string feature_flags_)
+    : feature_flags(std::move(feature_flags_))
+{}
+
+void KeeperFeatureFlags::fromApiVersion(KeeperApiVersion keeper_api_version)
+{
+    if (keeper_api_version == KeeperApiVersion::ZOOKEEPER_COMPATIBLE)
+        return;
+
+    if (keeper_api_version >= KeeperApiVersion::WITH_FILTERED_LIST)
+        enableFeatureFlag(KeeperFeatureFlag::FILTERED_LIST);
+
+    if (keeper_api_version >= KeeperApiVersion::WITH_MULTI_READ)
+        enableFeatureFlag(KeeperFeatureFlag::MULTI_READ);
+
+    if (keeper_api_version >= KeeperApiVersion::WITH_CHECK_NOT_EXISTS)
+        enableFeatureFlag(KeeperFeatureFlag::CHECK_NOT_EXISTS);
+}
+
+bool KeeperFeatureFlags::isEnabled(KeeperFeatureFlag feature_flag) const
+{
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+
+    if (byte_idx > feature_flags.size())
+        return false;
+
+    return feature_flags[byte_idx] & (1 << bit_idx);
+}
+
+void KeeperFeatureFlags::setFeatureFlags(std::string feature_flags_)
+{
+    feature_flags = std::move(feature_flags_);
+}
+
+void KeeperFeatureFlags::enableFeatureFlag(KeeperFeatureFlag feature_flag)
+{
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+    chassert(byte_idx < feature_flags.size());
+
+    feature_flags[byte_idx] |= (1 << bit_idx);
+}
+
+void KeeperFeatureFlags::disableFeatureFlag(KeeperFeatureFlag feature_flag)
+{
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+    chassert(byte_idx < feature_flags.size());
+
+    feature_flags[byte_idx] &= ~(1 << bit_idx);
+}
+
+const std::string & KeeperFeatureFlags::getFeatureFlags() const
+{
+    return feature_flags;
+}
+
+void KeeperFeatureFlags::logFlags(Poco::Logger * log) const
+{
+    for (const auto & feature_flag : all_keeper_feature_flags)
+    {
+        auto is_enabled = isEnabled(feature_flag);
+        LOG_INFO(log, "Keeper feature flag {}: {}", SettingFieldKeeperFeatureFlagTraits::toString(feature_flag), is_enabled ? "enabled" : "disabled");
+    }
+}
+
+}
diff --git a/src/Coordination/KeeperFeatureFlags.h b/src/Coordination/KeeperFeatureFlags.h
new file mode 100644
index 00000000000..cdd4704a7ca
--- /dev/null
+++ b/src/Coordination/KeeperFeatureFlags.h
@@ -0,0 +1,49 @@
+#pragma once
+
+#include <Core/SettingsEnums.h>
+#include <Core/SettingsFields.h>
+#include <Coordination/KeeperConstants.h>
+
+namespace DB
+{
+
+enum KeeperFeatureFlag
+{
+    FILTERED_LIST = 0,
+    MULTI_READ,
+    CHECK_NOT_EXISTS,
+};
+
+static inline constexpr std::array all_keeper_feature_flags
+{
+    KeeperFeatureFlag::FILTERED_LIST,
+    KeeperFeatureFlag::MULTI_READ,
+    KeeperFeatureFlag::CHECK_NOT_EXISTS,
+};
+
+DECLARE_SETTING_ENUM(KeeperFeatureFlag);
+
+class KeeperFeatureFlags
+{
+public:
+    KeeperFeatureFlags();
+
+    explicit KeeperFeatureFlags(std::string feature_flags_);
+
+    /// backwards compatibility
+    void fromApiVersion(KeeperApiVersion keeper_api_version);
+
+    bool isEnabled(KeeperFeatureFlag feature) const;
+
+    void setFeatureFlags(std::string feature_flags_);
+    const std::string & getFeatureFlags() const;
+
+    void enableFeatureFlag(KeeperFeatureFlag feature);
+    void disableFeatureFlag(KeeperFeatureFlag feature);
+
+    void logFlags(Poco::Logger * log) const;
+private:
+    std::string feature_flags;
+};
+
+}
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index b3150f11cfb..43719e5a69e 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -108,23 +108,19 @@ KeeperServer::KeeperServer(
     const Poco::Util::AbstractConfiguration & config,
     ResponsesQueue & responses_queue_,
     SnapshotsQueue & snapshots_queue_,
+    KeeperContextPtr keeper_context_,
     KeeperSnapshotManagerS3 & snapshot_manager_s3,
     KeeperStateMachine::CommitCallback commit_callback)
     : server_id(configuration_and_settings_->server_id)
     , coordination_settings(configuration_and_settings_->coordination_settings)
     , log(&Poco::Logger::get("KeeperServer"))
     , is_recovering(config.getBool("keeper_server.force_recovery", false))
-    , keeper_context{std::make_shared<KeeperContext>()}
+    , keeper_context{std::move(keeper_context_)}
     , create_snapshot_on_exit(config.getBool("keeper_server.create_snapshot_on_exit", true))
 {
     if (coordination_settings->quorum_reads)
         LOG_WARNING(log, "Quorum reads enabled, Keeper will work slower.");
 
-    keeper_context->initialize(config);
-
-    keeper_context->digest_enabled = config.getBool("keeper_server.digest_enabled", false);
-    keeper_context->ignore_system_path_on_startup = config.getBool("keeper_server.ignore_system_path_on_startup", false);
-
     state_machine = nuraft::cs_new<KeeperStateMachine>(
         responses_queue_,
         snapshots_queue_,
diff --git a/src/Coordination/KeeperServer.h b/src/Coordination/KeeperServer.h
index db4e9c1962e..8f416b1f48c 100644
--- a/src/Coordination/KeeperServer.h
+++ b/src/Coordination/KeeperServer.h
@@ -72,6 +72,7 @@ public:
         const Poco::Util::AbstractConfiguration & config_,
         ResponsesQueue & responses_queue_,
         SnapshotsQueue & snapshots_queue_,
+        KeeperContextPtr keeper_context_,
         KeeperSnapshotManagerS3 & snapshot_manager_s3,
         KeeperStateMachine::CommitCallback commit_callback);
 
diff --git a/src/Coordination/KeeperStorage.cpp b/src/Coordination/KeeperStorage.cpp
index 8abcd062b7f..ecf795f4068 100644
--- a/src/Coordination/KeeperStorage.cpp
+++ b/src/Coordination/KeeperStorage.cpp
@@ -285,7 +285,7 @@ void KeeperStorage::initializeSystemNodes()
     // insert child system nodes
     for (const auto & [path, data] : keeper_context->system_nodes_with_data)
     {
-        assert(keeper_api_version_path.starts_with(keeper_system_path));
+        assert(path.starts_with(keeper_system_path));
         Node child_system_node;
         child_system_node.setData(data);
         auto [map_key, _] = container.insert(std::string{path}, child_system_node);
@@ -1060,7 +1060,7 @@ struct KeeperStorageGetRequestProcessor final : public KeeperStorageRequestProce
         ProfileEvents::increment(ProfileEvents::KeeperGetRequest);
         Coordination::ZooKeeperGetRequest & request = dynamic_cast<Coordination::ZooKeeperGetRequest &>(*zk_request);
 
-        if (request.path == Coordination::keeper_api_version_path)
+        if (request.path == Coordination::keeper_api_feature_flags_path)
             return {};
 
         if (!storage.uncommitted_state.getNode(request.path))
diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index 005c67ad261..2793b23c572 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -2,7 +2,9 @@
 #include <gtest/gtest.h>
 #include "Common/ZooKeeper/IKeeper.h"
 
+#include "Coordination/KeeperConstants.h"
 #include "Coordination/KeeperContext.h"
+#include "Coordination/KeeperFeatureFlags.h"
 #include "Coordination/KeeperStorage.h"
 #include "Core/Defines.h"
 #include "IO/WriteHelpers.h"
@@ -2346,18 +2348,19 @@ TEST_P(CoordinationTest, TestDurableState)
     }
 }
 
-TEST_P(CoordinationTest, TestCurrentApiVersion)
+TEST_P(CoordinationTest, TestFeatureFlags)
 {
     using namespace Coordination;
     KeeperStorage storage{500, "", keeper_context};
     auto request = std::make_shared<ZooKeeperGetRequest>();
-    request->path = DB::keeper_api_version_path;
+    request->path = DB::keeper_api_feature_flags_path;
     auto responses = storage.processRequest(request, 0, std::nullopt, true, true);
     const auto & get_response = getSingleResponse<ZooKeeperGetResponse>(responses);
-    uint8_t keeper_version{0};
-    DB::ReadBufferFromOwnString buf(get_response.data);
-    DB::readIntText(keeper_version, buf);
-    EXPECT_EQ(keeper_version, static_cast<uint8_t>(latest_keeper_api_version));
+    DB::KeeperFeatureFlags feature_flags;
+    feature_flags.setFeatureFlags(get_response.data);
+    ASSERT_TRUE(feature_flags.isEnabled(KeeperFeatureFlag::FILTERED_LIST));
+    ASSERT_TRUE(feature_flags.isEnabled(KeeperFeatureFlag::MULTI_READ));
+    ASSERT_FALSE(feature_flags.isEnabled(KeeperFeatureFlag::CHECK_NOT_EXISTS));
 }
 
 TEST_P(CoordinationTest, TestSystemNodeModify)
diff --git a/src/Storages/System/StorageSystemZooKeeperConnection.cpp b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
index 559e12ad5ee..9a6a592f2c4 100644
--- a/src/Storages/System/StorageSystemZooKeeperConnection.cpp
+++ b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
@@ -31,7 +31,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
     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[6]->insert(0);
     res_columns[7]->insert(context->getZooKeeper()->getClientID());
 
     for (const auto & elem : context->getAuxiliaryZooKeepers())
@@ -42,7 +42,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
         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[6]->insert(0);
         res_columns[7]->insert(elem.second->getClientID());
     }
 
diff --git a/tests/integration/test_keeper_api_version_config/test.py b/tests/integration/test_keeper_api_version_config/test.py
deleted file mode 100644
index 34d3acc4f04..00000000000
--- a/tests/integration/test_keeper_api_version_config/test.py
+++ /dev/null
@@ -1,87 +0,0 @@
-#!/usr/bin/env python3
-
-import pytest
-import os
-from helpers.cluster import ClickHouseCluster
-import helpers.keeper_utils as keeper_utils
-from kazoo.client import KazooClient, KazooState
-
-CURRENT_TEST_DIR = os.path.dirname(os.path.abspath(__file__))
-cluster = ClickHouseCluster(__file__)
-
-# clickhouse itself will use external zookeeper
-node = cluster.add_instance(
-    "node",
-    main_configs=["configs/enable_keeper.xml"],
-    stay_alive=True,
-)
-
-
-@pytest.fixture(scope="module")
-def started_cluster():
-    try:
-        cluster.start()
-
-        yield cluster
-
-    finally:
-        cluster.shutdown()
-
-
-def get_connection_zk(nodename, timeout=30.0):
-    _fake_zk_instance = KazooClient(
-        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
-    )
-    _fake_zk_instance.start()
-    return _fake_zk_instance
-
-
-def restart_clickhouse(api_version=None, expect_fail=True):
-    node.stop_clickhouse()
-    node.copy_file_to_container(
-        os.path.join(CURRENT_TEST_DIR, "configs/enable_keeper.xml"),
-        "/etc/clickhouse-server/config.d/enable_keeper.xml",
-    )
-
-    if api_version:
-        node.replace_in_config(
-            "/etc/clickhouse-server/config.d/enable_keeper.xml",
-            "<!-- API VERSION -->",
-            f"<api_version>{api_version}<\\/api_version>",
-        )
-
-    node.start_clickhouse(retry_start=not expect_fail)
-    keeper_utils.wait_until_connected(cluster, node)
-
-
-def test_keeper_api_version(started_cluster):
-    restart_clickhouse()
-
-    def assert_version(string_version, version_number):
-        node.wait_for_log_line(
-            f"Detected server's API version: {string_version}", look_behind_lines=1000
-        )
-
-        try:
-            node_zk = get_connection_zk(node.name)
-            assert node_zk.get("/keeper/api_version")[0] == str(version_number).encode()
-        finally:
-            if node_zk:
-                node_zk.stop()
-                node_zk.close()
-
-    assert_version("WITH_CHECK_NOT_EXISTS", 3)
-
-    for i, version in enumerate(
-        [
-            "ZOOKEEPER_COMPATIBLE",
-            "WITH_FILTERED_LIST",
-            "WITH_MULTI_READ",
-            "WITH_CHECK_NOT_EXISTS",
-        ]
-    ):
-        restart_clickhouse(version)
-        assert_version(version, i)
-
-    with pytest.raises(Exception):
-        restart_clickhouse("INVALID_VERSION", expect_fail=True)
diff --git a/tests/integration/test_keeper_api_version_config/__init__.py b/tests/integration/test_keeper_feature_flags_config/__init__.py
similarity index 100%
rename from tests/integration/test_keeper_api_version_config/__init__.py
rename to tests/integration/test_keeper_feature_flags_config/__init__.py
diff --git a/tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml b/tests/integration/test_keeper_feature_flags_config/configs/enable_keeper.xml
similarity index 97%
rename from tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml
rename to tests/integration/test_keeper_feature_flags_config/configs/enable_keeper.xml
index c153d025598..53a169c4c3c 100644
--- a/tests/integration/test_keeper_api_version_config/configs/enable_keeper.xml
+++ b/tests/integration/test_keeper_feature_flags_config/configs/enable_keeper.xml
@@ -18,7 +18,7 @@
             <election_timeout_upper_bound_ms>0</election_timeout_upper_bound_ms>
         </coordination_settings>
 
-        <!-- API VERSION -->
+        <!-- FEATURE FLAGS -->
 
         <raft_configuration>
             <server>
diff --git a/tests/integration/test_keeper_feature_flags_config/test.py b/tests/integration/test_keeper_feature_flags_config/test.py
new file mode 100644
index 00000000000..432c413cbe8
--- /dev/null
+++ b/tests/integration/test_keeper_feature_flags_config/test.py
@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+
+import pytest
+import os
+from helpers.cluster import ClickHouseCluster
+import helpers.keeper_utils as keeper_utils
+from kazoo.client import KazooClient, KazooState
+
+CURRENT_TEST_DIR = os.path.dirname(os.path.abspath(__file__))
+cluster = ClickHouseCluster(__file__)
+
+# clickhouse itself will use external zookeeper
+node = cluster.add_instance(
+    "node",
+    main_configs=["configs/enable_keeper.xml"],
+    stay_alive=True,
+)
+
+
+@pytest.fixture(scope="module")
+def started_cluster():
+    try:
+        cluster.start()
+
+        yield cluster
+
+    finally:
+        cluster.shutdown()
+
+
+def get_connection_zk(nodename, timeout=30.0):
+    _fake_zk_instance = KazooClient(
+        hosts=cluster.get_instance_ip(nodename) + ":9181", timeout=timeout
+    )
+    _fake_zk_instance.start()
+    return _fake_zk_instance
+
+
+def restart_clickhouse(feature_flags=[], expect_fail=True):
+    node.stop_clickhouse()
+    node.copy_file_to_container(
+        os.path.join(CURRENT_TEST_DIR, "configs/enable_keeper.xml"),
+        "/etc/clickhouse-server/config.d/enable_keeper.xml",
+    )
+
+    if len(feature_flags) > 0:
+        feature_flags_config = "<feature_flags>"
+        
+        for feature, is_enabled in feature_flags:
+            feature_flags_config += f"<{feature}>{is_enabled}<\\/{feature}>"
+
+        feature_flags_config += "<\\/feature_flags>"
+
+        node.replace_in_config(
+            "/etc/clickhouse-server/config.d/enable_keeper.xml",
+            "<!-- FEATURE FLAGS -->",
+            feature_flags_config
+        )
+
+    node.start_clickhouse(retry_start=not expect_fail)
+    keeper_utils.wait_until_connected(cluster, node)
+
+
+def test_keeper_feature_flags(started_cluster):
+    restart_clickhouse()
+
+    def assert_feature_flags(feature_flags):
+        res = keeper_utils.send_4lw_cmd(started_cluster, node, "ftfl")
+
+        for feature, is_enabled in feature_flags:
+            node.wait_for_log_line(
+                f"ZooKeeperClient: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}", look_behind_lines=1000
+            )
+
+            node.wait_for_log_line(
+                f"KeeperContext: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}", look_behind_lines=1000
+            )
+
+            assert f"{feature}\t{1 if is_enabled else 0}" in res
+
+    assert_feature_flags([("filtered_list", 1), ("multi_read", 1), ("check_not_exists", 0)])
+
+    feature_flags = [("multi_read", 0), ("check_not_exists", 1)]
+    restart_clickhouse(feature_flags)
+    assert_feature_flags(feature_flags + [("filtered_list", 1)])
+
+    feature_flags = [("multi_read", 0), ("check_not_exists", 0), ("filtered_list", 0)]
+    restart_clickhouse(feature_flags)
+    assert_feature_flags(feature_flags)
+
+    with pytest.raises(Exception):
+        restart_clickhouse([("invalid_feature", 1)], expect_fail=True)

From eb16745033fd34b5c9c32124b6bb870f7c795f9c Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Mon, 12 Jun 2023 11:04:07 +0000
Subject: [PATCH 0751/1478] Collect sets from indexHint actions as well.

---
 src/Planner/Planner.cpp | 44 ++++++++++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 14 deletions(-)

diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index c1f472bb5a8..4ac81e28f92 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -9,6 +9,7 @@
 
 #include <Functions/FunctionFactory.h>
 #include <Functions/CastOverloadResolver.h>
+#include <Functions/indexHint.h>
 
 #include <QueryPipeline/Pipe.h>
 #include <Processors/Sources/SourceFromSingleChunk.h>
@@ -895,6 +896,34 @@ void addOffsetStep(QueryPlan & query_plan, const QueryAnalysisResult & query_ana
     query_plan.addStep(std::move(offsets_step));
 }
 
+void collectSetsFromActionsDAG(const ActionsDAGPtr & dag, std::unordered_set<const FutureSet *> & useful_sets)
+{
+    for (const auto & node : dag->getNodes())
+    {
+        if (node.column)
+        {
+            const IColumn * column = node.column.get();
+            if (const auto * column_const = typeid_cast<const ColumnConst *>(column))
+                column = &column_const->getDataColumn();
+
+            if (const auto * column_set = typeid_cast<const ColumnSet *>(column))
+                useful_sets.insert(column_set->getData().get());
+        }
+
+        if (node.type == ActionsDAG::ActionType::FUNCTION && node.function_base->getName() == "indexHint")
+        {
+            ActionsDAG::NodeRawConstPtrs children;
+            if (const auto * adaptor = typeid_cast<const FunctionToFunctionBaseAdaptor *>(node.function_base.get()))
+            {
+                if (const auto * index_hint = typeid_cast<const FunctionIndexHint *>(adaptor->getFunction().get()))
+                {
+                    collectSetsFromActionsDAG(index_hint->getActions(), useful_sets);
+                }
+            }
+        }
+    }
+}
+
 void addBuildSubqueriesForSetsStepIfNeeded(
     QueryPlan & query_plan,
     const SelectQueryOptions & select_query_options,
@@ -907,20 +936,7 @@ void addBuildSubqueriesForSetsStepIfNeeded(
     PreparedSets::SubqueriesForSets subqueries_for_sets;
 
     for (const auto & actions_to_execute : result_actions_to_execute)
-    {
-        for (const auto & node : actions_to_execute->getNodes())
-        {
-            if (node.column)
-            {
-                const IColumn * column = node.column.get();
-                if (const auto * column_const = typeid_cast<const ColumnConst *>(column))
-                    column = &column_const->getDataColumn();
-
-                if (const auto * column_set = typeid_cast<const ColumnSet *>(column))
-                    useful_sets.insert(column_set->getData().get());
-            }
-        }
-    }
+        collectSetsFromActionsDAG(actions_to_execute, useful_sets);
 
     auto predicate = [&useful_sets](const auto & set) { return !useful_sets.contains(set.set.get()); };
     auto it = std::remove_if(subqueries.begin(), subqueries.end(), std::move(predicate));

From 708a99a6ea63409ce33f83d450592eaa42411ebb Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 12 Jun 2023 11:19:38 +0000
Subject: [PATCH 0752/1478] Automatic style fix

---
 .../test_keeper_feature_flags_config/test.py       | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/tests/integration/test_keeper_feature_flags_config/test.py b/tests/integration/test_keeper_feature_flags_config/test.py
index 432c413cbe8..bb7252e9ec8 100644
--- a/tests/integration/test_keeper_feature_flags_config/test.py
+++ b/tests/integration/test_keeper_feature_flags_config/test.py
@@ -45,7 +45,7 @@ def restart_clickhouse(feature_flags=[], expect_fail=True):
 
     if len(feature_flags) > 0:
         feature_flags_config = "<feature_flags>"
-        
+
         for feature, is_enabled in feature_flags:
             feature_flags_config += f"<{feature}>{is_enabled}<\\/{feature}>"
 
@@ -54,7 +54,7 @@ def restart_clickhouse(feature_flags=[], expect_fail=True):
         node.replace_in_config(
             "/etc/clickhouse-server/config.d/enable_keeper.xml",
             "<!-- FEATURE FLAGS -->",
-            feature_flags_config
+            feature_flags_config,
         )
 
     node.start_clickhouse(retry_start=not expect_fail)
@@ -69,16 +69,20 @@ def test_keeper_feature_flags(started_cluster):
 
         for feature, is_enabled in feature_flags:
             node.wait_for_log_line(
-                f"ZooKeeperClient: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}", look_behind_lines=1000
+                f"ZooKeeperClient: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}",
+                look_behind_lines=1000,
             )
 
             node.wait_for_log_line(
-                f"KeeperContext: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}", look_behind_lines=1000
+                f"KeeperContext: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}",
+                look_behind_lines=1000,
             )
 
             assert f"{feature}\t{1 if is_enabled else 0}" in res
 
-    assert_feature_flags([("filtered_list", 1), ("multi_read", 1), ("check_not_exists", 0)])
+    assert_feature_flags(
+        [("filtered_list", 1), ("multi_read", 1), ("check_not_exists", 0)]
+    )
 
     feature_flags = [("multi_read", 0), ("check_not_exists", 1)]
     restart_clickhouse(feature_flags)

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 0753/1478] 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 0754/1478] 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 0755/1478] 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 0756/1478] 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 0757/1478] 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 0758/1478] 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 0759/1478] 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 0760/1478] 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 a7e6264d567ffa7456d00df017675f0acf4ca90f Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Mon, 12 Jun 2023 13:05:44 +0000
Subject: [PATCH 0761/1478] Add backward compatibility

---
 programs/keeper/CMakeLists.txt                           | 1 +
 src/Common/ZooKeeper/CMakeLists.txt                      | 2 ++
 src/Coordination/FourLetterCommand.cpp                   | 2 +-
 src/Coordination/KeeperConstants.h                       | 1 -
 src/Coordination/KeeperContext.cpp                       | 4 ++++
 src/Storages/System/StorageSystemZooKeeperConnection.cpp | 4 ++--
 6 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 4f74cc06801..555c6431865 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -44,6 +44,7 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperLogStore.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperServer.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperContext.cpp
+        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperFeatureFlags.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManager.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperSnapshotManagerS3.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Coordination/KeeperStateMachine.cpp
diff --git a/src/Common/ZooKeeper/CMakeLists.txt b/src/Common/ZooKeeper/CMakeLists.txt
index a9a335d1461..3f7e87ff4a7 100644
--- a/src/Common/ZooKeeper/CMakeLists.txt
+++ b/src/Common/ZooKeeper/CMakeLists.txt
@@ -2,6 +2,8 @@ include("${ClickHouse_SOURCE_DIR}/cmake/dbms_glob_sources.cmake")
 
 add_headers_and_sources(clickhouse_common_zookeeper .)
 
+list(APPEND clickhouse_common_zookeeper_sources ${CMAKE_CURRENT_SOURCE_DIR}/../../../src/Coordination/KeeperFeatureFlags.cpp)
+
 # for clickhouse server
 add_library(clickhouse_common_zookeeper ${clickhouse_common_zookeeper_headers} ${clickhouse_common_zookeeper_sources})
 target_compile_definitions (clickhouse_common_zookeeper PRIVATE -DZOOKEEPER_LOG)
diff --git a/src/Coordination/FourLetterCommand.cpp b/src/Coordination/FourLetterCommand.cpp
index 55120e70d99..10d13657fb0 100644
--- a/src/Coordination/FourLetterCommand.cpp
+++ b/src/Coordination/FourLetterCommand.cpp
@@ -490,7 +490,7 @@ String RecoveryCommand::run()
 
 String ApiVersionCommand::run()
 {
-    return toString(0);
+    return toString(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
 }
 
 String CreateSnapshotCommand::run()
diff --git a/src/Coordination/KeeperConstants.h b/src/Coordination/KeeperConstants.h
index 6d9c03ca8a9..84cbb0ab7c5 100644
--- a/src/Coordination/KeeperConstants.h
+++ b/src/Coordination/KeeperConstants.h
@@ -14,7 +14,6 @@ enum class KeeperApiVersion : uint8_t
     WITH_CHECK_NOT_EXISTS,
 };
 
-
 const std::string keeper_system_path = "/keeper";
 const std::string keeper_api_version_path = keeper_system_path + "/api_version";
 const std::string keeper_api_feature_flags_path = keeper_system_path + "/feature_flags";
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index dc408afc19a..e6f30c81310 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -11,6 +11,10 @@ KeeperContext::KeeperContext()
     feature_flags.enableFeatureFlag(KeeperFeatureFlag::FILTERED_LIST);
     feature_flags.enableFeatureFlag(KeeperFeatureFlag::MULTI_READ);
     system_nodes_with_data[keeper_api_feature_flags_path] = feature_flags.getFeatureFlags();
+
+
+    /// for older clients, the default is equivalent to WITH_MULTI_READ version
+    system_nodes_with_data[keeper_api_version_path] = toString(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
 }
 
 void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
diff --git a/src/Storages/System/StorageSystemZooKeeperConnection.cpp b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
index 9a6a592f2c4..99872be6ba0 100644
--- a/src/Storages/System/StorageSystemZooKeeperConnection.cpp
+++ b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
@@ -31,7 +31,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
     res_columns[3]->insert(context->getZooKeeper()->getConnectedZooKeeperIndex());
     res_columns[4]->insert(context->getZooKeeperSessionUptime());
     res_columns[5]->insert(context->getZooKeeper()->expired());
-    res_columns[6]->insert(0);
+    res_columns[6]->insert(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
     res_columns[7]->insert(context->getZooKeeper()->getClientID());
 
     for (const auto & elem : context->getAuxiliaryZooKeepers())
@@ -42,7 +42,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
         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(0);
+        res_columns[6]->insert(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
         res_columns[7]->insert(elem.second->getClientID());
     }
 

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 0762/1478] 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 25f08f8d194f77d0ee56e7c5132b9d5c4244a30f Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Mon, 12 Jun 2023 15:35:44 +0200
Subject: [PATCH 0763/1478] Remove duplicate include

---
 src/Coordination/Changelog.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index cc2ea491e17..ffa22a6b888 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -14,7 +14,6 @@
 #include <Common/SipHash.h>
 #include <Common/filesystemHelpers.h>
 #include <Common/logger_useful.h
-#include <base/errnoToString.h>
 #include <libnuraft/log_val_type.hxx>
 
 

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 0764/1478] 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 0765/1478] 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 0766/1478] 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 0767/1478] 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 0768/1478] 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 0769/1478] 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 0770/1478] 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 0771/1478] 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 0772/1478] 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 0773/1478] 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 0774/1478] 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 0775/1478] 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 0776/1478] 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 70252321750b6a8d3ab6c41f658b76705a2e55b9 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Mon, 12 Jun 2023 18:59:07 +0000
Subject: [PATCH 0777/1478] Fixing cache for sets.

---
 src/Processors/Transforms/CreatingSetsTransform.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index a1e43525ab1..3139fa5ed98 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -86,7 +86,7 @@ void CreatingSetsTransform::startSubquery()
         }
     }
 
-    if (subquery.set)
+    if (subquery.set && !set_from_cache)
         LOG_TRACE(log, "Creating set, key: {}", subquery.key);
     if (subquery.table)
         LOG_TRACE(log, "Filling temporary table.");
@@ -97,7 +97,7 @@ void CreatingSetsTransform::startSubquery()
         /// TODO: make via port
         table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), nullptr, /*async_insert=*/false));
 
-    done_with_set = !subquery.set;
+    done_with_set = !subquery.set || set_from_cache;
     done_with_table = !subquery.table;
 
     if ((done_with_set && !set_from_cache) /*&& done_with_join*/ && done_with_table)
@@ -175,10 +175,10 @@ void CreatingSetsTransform::consume(Chunk chunk)
 
 Chunk CreatingSetsTransform::generate()
 {
-    if (subquery.set)
+    if (subquery.set && !set_from_cache)
     {
         subquery.set->finishInsert();
-        subquery.promise_to_fill_set.set_value(subquery.set);
+        //subquery.promise_to_fill_set.set_value(subquery.set);
         if (promise_to_build)
             promise_to_build->set_value(subquery.set);
     }

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 0778/1478] 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 0779/1478] 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 0780/1478] 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 0781/1478] 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 0782/1478] 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 0783/1478] 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 0784/1478] 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 0785/1478] 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 6f1c4865372b408d0f773a8dd9b1db8e63b5e4bb Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Tue, 13 Jun 2023 10:25:53 +0200
Subject: [PATCH 0786/1478] Fix build

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

diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index ffa22a6b888..94062140bac 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -13,7 +13,7 @@
 #include <Common/Exception.h>
 #include <Common/SipHash.h>
 #include <Common/filesystemHelpers.h>
-#include <Common/logger_useful.h
+#include <Common/logger_useful.h>
 #include <libnuraft/log_val_type.hxx>
 
 

From bf69755adab474fbd166209ab7675537d1a9aeeb Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Tue, 13 Jun 2023 01:18:36 -0700
Subject: [PATCH 0787/1478] Address some usability issues with INTO OUTFILE
 usage.

---
 src/Client/ClientBase.cpp             | 20 ++++++++++++++++++++
 src/Parsers/ASTQueryWithOutput.cpp    |  2 ++
 src/Parsers/ASTQueryWithOutput.h      |  1 +
 src/Parsers/ParserQueryWithOutput.cpp |  6 ++++++
 4 files changed, 29 insertions(+)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 6f295c11070..fc108b8f57d 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -568,6 +568,13 @@ try
                 CompressionMethod compression_method = chooseCompressionMethod(out_file, compression_method_string);
                 UInt64 compression_level = 3;
 
+                if (query_with_output->is_outfile_append && query_with_output->is_outfile_truncate)
+                {
+                    throw Exception(
+                        ErrorCodes::BAD_ARGUMENTS,
+                        "Cannot use INTO OUTFILE with APPEND and TRUNCATE simultaneously.");
+                }
+
                 if (query_with_output->is_outfile_append && compression_method != CompressionMethod::None)
                 {
                     throw Exception(
@@ -589,9 +596,22 @@ try
                             range.second);
                 }
 
+                std::error_code ec;
+                if (std::filesystem::is_regular_file(out_file, ec))
+                {
+                    if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
+                    {
+                        throw Exception(
+                            ErrorCodes::CANNOT_OPEN_FILE,
+                            "File {} exists, consider using 'INTO OUTFILE ... APPEND' or 'INTO OUTFILE ... TRUNCATE' if appropriate.",
+                            out_file);
+                    }
+                }
                 auto flags = O_WRONLY | O_EXCL;
                 if (query_with_output->is_outfile_append)
                     flags |= O_APPEND;
+                else if (query_with_output->is_outfile_truncate)
+                    flags |= O_TRUNC;
                 else
                     flags |= O_CREAT;
 
diff --git a/src/Parsers/ASTQueryWithOutput.cpp b/src/Parsers/ASTQueryWithOutput.cpp
index 5f717715a69..4bf1e6cb231 100644
--- a/src/Parsers/ASTQueryWithOutput.cpp
+++ b/src/Parsers/ASTQueryWithOutput.cpp
@@ -39,6 +39,8 @@ void ASTQueryWithOutput::formatImpl(const FormatSettings & s, FormatState & stat
         s.ostr << (s.hilite ? hilite_keyword : "");
         if (is_outfile_append)
             s.ostr << " APPEND";
+        if (is_outfile_truncate)
+            s.ostr << " TRUNCATE";
         if (is_into_outfile_with_stdout)
             s.ostr << " AND STDOUT";
         s.ostr << (s.hilite ? hilite_none : "");
diff --git a/src/Parsers/ASTQueryWithOutput.h b/src/Parsers/ASTQueryWithOutput.h
index 7db021405e7..6f9cafc89a9 100644
--- a/src/Parsers/ASTQueryWithOutput.h
+++ b/src/Parsers/ASTQueryWithOutput.h
@@ -17,6 +17,7 @@ public:
     ASTPtr out_file;
     bool is_into_outfile_with_stdout = false;
     bool is_outfile_append = false;
+    bool is_outfile_truncate = false;
     ASTPtr format;
     ASTPtr settings_ast;
     ASTPtr compression;
diff --git a/src/Parsers/ParserQueryWithOutput.cpp b/src/Parsers/ParserQueryWithOutput.cpp
index 6796f4528c4..2bfe7353be4 100644
--- a/src/Parsers/ParserQueryWithOutput.cpp
+++ b/src/Parsers/ParserQueryWithOutput.cpp
@@ -109,6 +109,12 @@ bool ParserQueryWithOutput::parseImpl(Pos & pos, ASTPtr & node, Expected & expec
             query_with_output.is_outfile_append = true;
         }
 
+        ParserKeyword s_truncate("TRUNCATE");
+        if (s_truncate.ignore(pos, expected))
+        {
+            query_with_output.is_outfile_truncate = true;
+        }
+
         ParserKeyword s_stdout("AND STDOUT");
         if (s_stdout.ignore(pos, expected))
         {

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 0788/1478] 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 0789/1478] 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 0790/1478] 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 0791/1478] 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 0792/1478] 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 0793/1478] 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 4ac090b12212567f7b9d30cb27132f566ae438c4 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Tue, 13 Jun 2023 11:01:44 +0000
Subject: [PATCH 0794/1478] Fix tests

---
 src/Coordination/tests/gtest_coordination.cpp | 22 +++++++++----------
 .../StorageSystemZooKeeperConnection.cpp      |  4 ++--
 tests/config/config.d/keeper_port.xml         |  4 ++++
 .../test_keeper_four_word_command/test.py     |  8 +++----
 ...2735_system_zookeeper_connection.reference |  2 +-
 5 files changed, 22 insertions(+), 18 deletions(-)

diff --git a/src/Coordination/tests/gtest_coordination.cpp b/src/Coordination/tests/gtest_coordination.cpp
index 2793b23c572..b29d5bca43d 100644
--- a/src/Coordination/tests/gtest_coordination.cpp
+++ b/src/Coordination/tests/gtest_coordination.cpp
@@ -1193,7 +1193,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotSimple)
 
     EXPECT_EQ(snapshot.snapshot_meta->get_last_log_idx(), 2);
     EXPECT_EQ(snapshot.session_id, 7);
-    EXPECT_EQ(snapshot.snapshot_container_size, 5);
+    EXPECT_EQ(snapshot.snapshot_container_size, 6);
     EXPECT_EQ(snapshot.session_and_timeout.size(), 2);
 
     auto buf = manager.serializeSnapshotToBuffer(snapshot);
@@ -1205,7 +1205,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotSimple)
 
     auto [restored_storage, snapshot_meta, _] = manager.deserializeSnapshotFromBuffer(debuf);
 
-    EXPECT_EQ(restored_storage->container.size(), 5);
+    EXPECT_EQ(restored_storage->container.size(), 6);
     EXPECT_EQ(restored_storage->container.getValue("/").getChildren().size(), 2);
     EXPECT_EQ(restored_storage->container.getValue("/hello").getChildren().size(), 1);
     EXPECT_EQ(restored_storage->container.getValue("/hello/somepath").getChildren().size(), 0);
@@ -1237,14 +1237,14 @@ TEST_P(CoordinationTest, TestStorageSnapshotMoreWrites)
 
     DB::KeeperStorageSnapshot snapshot(&storage, 50);
     EXPECT_EQ(snapshot.snapshot_meta->get_last_log_idx(), 50);
-    EXPECT_EQ(snapshot.snapshot_container_size, 53);
+    EXPECT_EQ(snapshot.snapshot_container_size, 54);
 
     for (size_t i = 50; i < 100; ++i)
     {
         addNode(storage, "/hello_" + std::to_string(i), "world_" + std::to_string(i));
     }
 
-    EXPECT_EQ(storage.container.size(), 103);
+    EXPECT_EQ(storage.container.size(), 104);
 
     auto buf = manager.serializeSnapshotToBuffer(snapshot);
     manager.serializeSnapshotBufferToDisk(*buf, 50);
@@ -1254,7 +1254,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotMoreWrites)
     auto debuf = manager.deserializeSnapshotBufferFromDisk(50);
     auto [restored_storage, meta, _] = manager.deserializeSnapshotFromBuffer(debuf);
 
-    EXPECT_EQ(restored_storage->container.size(), 53);
+    EXPECT_EQ(restored_storage->container.size(), 54);
     for (size_t i = 0; i < 50; ++i)
     {
         EXPECT_EQ(restored_storage->container.getValue("/hello_" + std::to_string(i)).getData(), "world_" + std::to_string(i));
@@ -1293,7 +1293,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotManySnapshots)
 
     auto [restored_storage, meta, _] = manager.restoreFromLatestSnapshot();
 
-    EXPECT_EQ(restored_storage->container.size(), 253);
+    EXPECT_EQ(restored_storage->container.size(), 254);
 
     for (size_t i = 0; i < 250; ++i)
     {
@@ -1327,16 +1327,16 @@ TEST_P(CoordinationTest, TestStorageSnapshotMode)
             if (i % 2 == 0)
                 storage.container.erase("/hello_" + std::to_string(i));
         }
-        EXPECT_EQ(storage.container.size(), 28);
-        EXPECT_EQ(storage.container.snapshotSizeWithVersion().first, 104);
+        EXPECT_EQ(storage.container.size(), 29);
+        EXPECT_EQ(storage.container.snapshotSizeWithVersion().first, 105);
         EXPECT_EQ(storage.container.snapshotSizeWithVersion().second, 1);
         auto buf = manager.serializeSnapshotToBuffer(snapshot);
         manager.serializeSnapshotBufferToDisk(*buf, 50);
     }
     EXPECT_TRUE(fs::exists("./snapshots/snapshot_50.bin" + params.extension));
-    EXPECT_EQ(storage.container.size(), 28);
+    EXPECT_EQ(storage.container.size(), 29);
     storage.clearGarbageAfterSnapshot();
-    EXPECT_EQ(storage.container.snapshotSizeWithVersion().first, 28);
+    EXPECT_EQ(storage.container.snapshotSizeWithVersion().first, 29);
     for (size_t i = 0; i < 50; ++i)
     {
         if (i % 2 != 0)
@@ -1865,7 +1865,7 @@ TEST_P(CoordinationTest, TestStorageSnapshotDifferentCompressions)
 
     auto [restored_storage, snapshot_meta, _] = new_manager.deserializeSnapshotFromBuffer(debuf);
 
-    EXPECT_EQ(restored_storage->container.size(), 5);
+    EXPECT_EQ(restored_storage->container.size(), 6);
     EXPECT_EQ(restored_storage->container.getValue("/").getChildren().size(), 2);
     EXPECT_EQ(restored_storage->container.getValue("/hello").getChildren().size(), 1);
     EXPECT_EQ(restored_storage->container.getValue("/hello/somepath").getChildren().size(), 0);
diff --git a/src/Storages/System/StorageSystemZooKeeperConnection.cpp b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
index 99872be6ba0..9a6a592f2c4 100644
--- a/src/Storages/System/StorageSystemZooKeeperConnection.cpp
+++ b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
@@ -31,7 +31,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
     res_columns[3]->insert(context->getZooKeeper()->getConnectedZooKeeperIndex());
     res_columns[4]->insert(context->getZooKeeperSessionUptime());
     res_columns[5]->insert(context->getZooKeeper()->expired());
-    res_columns[6]->insert(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
+    res_columns[6]->insert(0);
     res_columns[7]->insert(context->getZooKeeper()->getClientID());
 
     for (const auto & elem : context->getAuxiliaryZooKeepers())
@@ -42,7 +42,7 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
         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(static_cast<uint8_t>(KeeperApiVersion::WITH_MULTI_READ));
+        res_columns[6]->insert(0);
         res_columns[7]->insert(elem.second->getClientID());
     }
 
diff --git a/tests/config/config.d/keeper_port.xml b/tests/config/config.d/keeper_port.xml
index cffd325e968..7db174c5419 100644
--- a/tests/config/config.d/keeper_port.xml
+++ b/tests/config/config.d/keeper_port.xml
@@ -28,5 +28,9 @@
                 <port>9234</port>
             </server>
         </raft_configuration>
+
+        <feature_flags>
+            <check_not_exists>1</check_not_exists>
+        </feature_flags>
     </keeper_server>
 </clickhouse>
diff --git a/tests/integration/test_keeper_four_word_command/test.py b/tests/integration/test_keeper_four_word_command/test.py
index 2098daea5fe..adc29abb584 100644
--- a/tests/integration/test_keeper_four_word_command/test.py
+++ b/tests/integration/test_keeper_four_word_command/test.py
@@ -183,8 +183,8 @@ def test_cmd_mntr(started_cluster):
         # contains:
         #   10 nodes created by test
         #   3 nodes created by clickhouse "/clickhouse/task_queue/ddl"
-        #   1 root node, 2 keeper system nodes
-        assert int(result["zk_znode_count"]) == 13
+        #   1 root node, 3 keeper system nodes
+        assert int(result["zk_znode_count"]) == 14
         assert int(result["zk_watch_count"]) == 2
         assert int(result["zk_ephemerals_count"]) == 2
         assert int(result["zk_approximate_data_size"]) > 0
@@ -329,7 +329,7 @@ def test_cmd_srvr(started_cluster):
         assert int(result["Connections"]) == 1
         assert int(result["Zxid"]) > 10
         assert result["Mode"] == "leader"
-        assert result["Node count"] == "13"
+        assert result["Node count"] == "14"
 
     finally:
         destroy_zk_client(zk)
@@ -369,7 +369,7 @@ def test_cmd_stat(started_cluster):
         assert int(result["Connections"]) == 1
         assert int(result["Zxid"]) >= 10
         assert result["Mode"] == "leader"
-        assert result["Node count"] == "13"
+        assert result["Node count"] == "14"
 
         # filter connection statistics
         cons = [n for n in data.split("\n") if "=" in n]
diff --git a/tests/queries/0_stateless/02735_system_zookeeper_connection.reference b/tests/queries/0_stateless/02735_system_zookeeper_connection.reference
index 1deabd88b88..55b3579f0dd 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
+default	::1	9181	0	0	0
 zookeeper2	::1	9181	0	0	0

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 0795/1478] 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 0796/1478] 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 0797/1478] 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 0798/1478] 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 0799/1478] 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 0800/1478] 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 0801/1478] 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 0802/1478] 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 0803/1478] 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 0804/1478] 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 0805/1478] 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 0806/1478] 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 0807/1478] 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 0808/1478] 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 0809/1478] 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 0810/1478] 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 7057e0e25fd55f8a9cb9708da223883aaa8fe902 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Tue, 13 Jun 2023 14:46:26 +0000
Subject: [PATCH 0811/1478] fix test

---
 .../02751_ip_types_aggregate_functions_states.sql.j2          | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
index 708eeab7724..7daff5a690f 100644
--- a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
@@ -3,8 +3,8 @@
 
 {# this test checks backward compatibility of aggregate functions States against IPv4, IPv6 types #}
 
-{% set ip4_generator = "select number::UInt32::IPv4 ip from numbers(999999999,50) order by ip" %}
-{% set ip6_generator = "SELECT toIPv6(IPv6NumToString(toFixedString(reinterpretAsFixedString(number)||reinterpretAsFixedString(number), 16))) AS ip FROM numbers(1010011101, 50) order by ip" %}
+{% set ip4_generator = "select num::UInt32::IPv4 ip from (select arrayJoin(range(999999999, number)) as num from numbers(999999999,50)) order by ip" %}
+{% set ip6_generator = "SELECT toIPv6(IPv6NumToString(toFixedString(reinterpretAsFixedString(num)||reinterpretAsFixedString(num), 16))) AS ip FROM (select arrayJoin(range(1010011101, number)) as num from numbers(1010011101,50)) order by ip" %}
 {% set ip_generators = {'ip4': ip4_generator, 'ip6': ip6_generator} %}
 
 

From 332893344d3cbca205b0d99671cd4c8ba26ec2da Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 16:50:10 +0200
Subject: [PATCH 0812/1478] Updated lock for accessing azure blob storage
 iterator

---
 src/Storages/StorageAzureBlob.cpp                         | 6 +-----
 tests/integration/test_storage_azure_blob_storage/test.py | 1 -
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 3ee176a68b7..b9d59f04001 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -882,6 +882,7 @@ StorageAzureBlobSource::Iterator::Iterator(
 
 RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
 {
+    std::lock_guard lock(next_mutex);
     if (is_finished)
         return {};
 
@@ -900,7 +901,6 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
     {
         bool need_new_batch = false;
         {
-            std::lock_guard lock(next_mutex);
             need_new_batch = !blobs_with_metadata || index >= blobs_with_metadata->size();
         }
 
@@ -945,7 +945,6 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
                 const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
 
-                std::lock_guard lock(next_mutex);
                 blob_path_with_globs.reset();
                 blob_path_with_globs.emplace();
                 for (UInt64 idx : idxs.getData())
@@ -961,7 +960,6 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 if (outer_blobs)
                     outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
 
-                std::lock_guard lock(next_mutex);
                 blobs_with_metadata = std::move(new_batch);
                 for (const auto & [_, info] : *blobs_with_metadata)
                     total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
@@ -969,8 +967,6 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
         }
 
         size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
-
-        std::lock_guard lock(next_mutex);
         return (*blobs_with_metadata)[current_index];
     }
 }
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index f9d337b6d86..bb25ac4b029 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -551,7 +551,6 @@ def test_schema_inference_no_globs_tf(cluster):
         "499500\t2890\t332833500\ttest_schema_inference_no_globs_tf.csv\tcont/test_schema_inference_no_globs_tf.csv"
     ]
 
-
 def test_schema_inference_from_globs_tf(cluster):
     node = cluster.instances["node"]
     unique_prefix = random.randint(1, 10000)

From 3fd9911efe37500094532d07a1f6e0eaddaca6dd Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Tue, 13 Jun 2023 14:58:55 +0000
Subject: [PATCH 0813/1478] fix test reference

---
 ...es_aggregate_functions_states.reference.j2 | 164 +++++++++---------
 1 file changed, 82 insertions(+), 82 deletions(-)

diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
index 481dd723b66..90f98cf63fd 100644
--- a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
@@ -2,18 +2,18 @@
 Row 1:
 ──────
 minState:            12535288824949910799
-maxState:            18210943739258811465
+maxState:            15790547582231549775
 first_valueState:    12535288824949910799
-last_valueState:     18210943739258811465
-topKState:           1594227852744382511
-groupArrayState:     8025417272361615478
-groupUniqArrayState: 919082878249747568
-uniqState:           14828781561416784358
-uniqExactState:      11391659146320471795
-uniqCombinedState:   9631896280254268221
-uniqCombined64State: 5156097536649078816
-uniqHLL12State:      9696624347265201099
-uniqThetaState:      10464560810701154023
+last_valueState:     15790547582231549775
+topKState:           4906125994014190470
+groupArrayState:     9875990674330641453
+groupUniqArrayState: 15788623094139372318
+uniqState:           13857072740564896081
+uniqExactState:      2764760571052675772
+uniqCombinedState:   927481020821507998
+uniqCombined64State: 11588178464185397904
+uniqHLL12State:      592773541433144605
+uniqThetaState:      12573391720108828030
 ----- hash / State / ip6 -----
 Row 1:
 ──────
@@ -21,31 +21,31 @@ minState:            9428555662807296659
 maxState:            18253481702148601156
 first_valueState:    9428555662807296659
 last_valueState:     18253481702148601156
-topKState:           8045294331733869941
-groupArrayState:     10451014709837753966
-groupUniqArrayState: 1954028114836070615
-uniqState:           14986562136250471284
-uniqExactState:      10032843621916709112
-uniqCombinedState:   6379274083567016598
-uniqCombined64State: 6379274083567016598
-uniqHLL12State:      9181286681186915812
-uniqThetaState:      2415188383468008881
+topKState:           4649040466816645853
+groupArrayState:     15334593495826890008
+groupUniqArrayState: 18179202420787216155
+uniqState:           1113473461736161202
+uniqExactState:      17291302630176581193
+uniqCombinedState:   7689865507370303115
+uniqCombined64State: 7689865507370303115
+uniqHLL12State:      12630756003012135681
+uniqThetaState:      11768246996604802350
 ----- finalizeAggregation / State / ip4 -----
 Row 1:
 ──────
 min:            59.154.201.255
-max:            59.154.202.48
+max:            59.154.202.47
 first_value:    59.154.201.255
-last_value:     59.154.202.48
-topK:           ['59.154.202.48','59.154.202.5','59.154.202.26','59.154.202.25','59.154.202.24','59.154.202.23','59.154.202.22','59.154.202.21','59.154.202.27','59.154.202.19']
-groupArray:     ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8','59.154.202.9','59.154.202.10','59.154.202.11','59.154.202.12','59.154.202.13','59.154.202.14','59.154.202.15','59.154.202.16','59.154.202.17','59.154.202.18','59.154.202.19','59.154.202.20','59.154.202.21','59.154.202.22','59.154.202.23','59.154.202.24','59.154.202.25','59.154.202.26','59.154.202.27','59.154.202.28','59.154.202.29','59.154.202.30','59.154.202.31','59.154.202.32','59.154.202.33','59.154.202.34','59.154.202.35','59.154.202.36','59.154.202.37','59.154.202.38','59.154.202.39','59.154.202.40','59.154.202.41','59.154.202.42','59.154.202.43','59.154.202.44','59.154.202.45','59.154.202.46','59.154.202.47','59.154.202.48']
-groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.48','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
-uniq:           50
-uniqExact:      50
-uniqCombined:   50
-uniqCombined64: 50
-uniqHLL12:      49
-uniqTheta:      50
+last_value:     59.154.202.47
+topK:           ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8']
+groupArray:     ['59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.44','59.154.202.44','59.154.202.44','59.154.202.44','59.154.202.45','59.154.202.45','59.154.202.45','59.154.202.46','59.154.202.46','59.154.202.47']
+groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
+uniq:           49
+uniqExact:      49
+uniqCombined:   49
+uniqCombined64: 49
+uniqHLL12:      48
+uniqTheta:      49
 ----- finalizeAggregation / State / ip6 -----
 Row 1:
 ──────
@@ -53,31 +53,31 @@ min:            8c:333c::8c:333c:0:0
 max:            ff8b:333c::ff8b:333c:0:0
 first_value:    8c:333c::8c:333c:0:0
 last_value:     ff8b:333c::ff8b:333c:0:0
-topK:           ['ff8b:333c::ff8b:333c:0:0','68c:333c::68c:333c:0:0','e98b:333c::e98b:333c:0:0','e88b:333c::e88b:333c:0:0','e78b:333c::e78b:333c:0:0','e68b:333c::e68b:333c:0:0','e58b:333c::e58b:333c:0:0','e48b:333c::e48b:333c:0:0','ea8b:333c::ea8b:333c:0:0','e28b:333c::e28b:333c:0:0']
-groupArray:     ['8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','e8c:333c::e8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
-groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e8c:333c::e8c:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
-uniq:           50
-uniqExact:      50
-uniqCombined:   50
-uniqCombined64: 50
-uniqHLL12:      50
-uniqTheta:      50
+topK:           ['dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0']
+groupArray:     ['8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','b8c:333c::b8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+uniq:           49
+uniqExact:      49
+uniqCombined:   49
+uniqCombined64: 49
+uniqHLL12:      49
+uniqTheta:      49
 ----- hash / IfState / ip4 -----
 Row 1:
 ──────
 minIfState:            12535288824949910799
-maxIfState:            18210943739258811465
+maxIfState:            15790547582231549775
 first_valueIfState:    12535288824949910799
-last_valueIfState:     18210943739258811465
-topKIfState:           1594227852744382511
-groupArrayIfState:     8025417272361615478
-groupUniqArrayIfState: 919082878249747568
-uniqIfState:           14828781561416784358
-uniqExactIfState:      11391659146320471795
-uniqCombinedIfState:   9631896280254268221
-uniqCombined64IfState: 5156097536649078816
-uniqHLL12IfState:      9696624347265201099
-uniqThetaIfState:      10464560810701154023
+last_valueIfState:     15790547582231549775
+topKIfState:           4906125994014190470
+groupArrayIfState:     9875990674330641453
+groupUniqArrayIfState: 15788623094139372318
+uniqIfState:           13857072740564896081
+uniqExactIfState:      2764760571052675772
+uniqCombinedIfState:   927481020821507998
+uniqCombined64IfState: 11588178464185397904
+uniqHLL12IfState:      592773541433144605
+uniqThetaIfState:      12573391720108828030
 ----- hash / IfState / ip6 -----
 Row 1:
 ──────
@@ -85,31 +85,31 @@ minIfState:            9428555662807296659
 maxIfState:            18253481702148601156
 first_valueIfState:    9428555662807296659
 last_valueIfState:     18253481702148601156
-topKIfState:           8045294331733869941
-groupArrayIfState:     10451014709837753966
-groupUniqArrayIfState: 1954028114836070615
-uniqIfState:           14986562136250471284
-uniqExactIfState:      10032843621916709112
-uniqCombinedIfState:   6379274083567016598
-uniqCombined64IfState: 6379274083567016598
-uniqHLL12IfState:      9181286681186915812
-uniqThetaIfState:      2415188383468008881
+topKIfState:           4649040466816645853
+groupArrayIfState:     15334593495826890008
+groupUniqArrayIfState: 18179202420787216155
+uniqIfState:           1113473461736161202
+uniqExactIfState:      17291302630176581193
+uniqCombinedIfState:   7689865507370303115
+uniqCombined64IfState: 7689865507370303115
+uniqHLL12IfState:      12630756003012135681
+uniqThetaIfState:      11768246996604802350
 ----- finalizeAggregation / IfState / ip4 -----
 Row 1:
 ──────
 min:            59.154.201.255
-max:            59.154.202.48
+max:            59.154.202.47
 first_value:    59.154.201.255
-last_value:     59.154.202.48
-topK:           ['59.154.202.48','59.154.202.5','59.154.202.26','59.154.202.25','59.154.202.24','59.154.202.23','59.154.202.22','59.154.202.21','59.154.202.27','59.154.202.19']
-groupArray:     ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8','59.154.202.9','59.154.202.10','59.154.202.11','59.154.202.12','59.154.202.13','59.154.202.14','59.154.202.15','59.154.202.16','59.154.202.17','59.154.202.18','59.154.202.19','59.154.202.20','59.154.202.21','59.154.202.22','59.154.202.23','59.154.202.24','59.154.202.25','59.154.202.26','59.154.202.27','59.154.202.28','59.154.202.29','59.154.202.30','59.154.202.31','59.154.202.32','59.154.202.33','59.154.202.34','59.154.202.35','59.154.202.36','59.154.202.37','59.154.202.38','59.154.202.39','59.154.202.40','59.154.202.41','59.154.202.42','59.154.202.43','59.154.202.44','59.154.202.45','59.154.202.46','59.154.202.47','59.154.202.48']
-groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.48','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
-uniq:           50
-uniqExact:      50
-uniqCombined:   50
-uniqCombined64: 50
-uniqHLL12:      49
-uniqTheta:      50
+last_value:     59.154.202.47
+topK:           ['59.154.201.255','59.154.202.0','59.154.202.1','59.154.202.2','59.154.202.3','59.154.202.4','59.154.202.5','59.154.202.6','59.154.202.7','59.154.202.8']
+groupArray:     ['59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.201.255','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.0','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.1','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.2','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.3','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.4','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.5','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.6','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.7','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.8','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.9','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.10','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.11','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.12','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.13','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.14','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.15','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.16','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.17','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.18','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.19','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.20','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.21','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.22','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.23','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.24','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.25','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.26','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.27','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.28','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.29','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.30','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.31','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.32','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.33','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.34','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.35','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.36','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.37','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.38','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.39','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.40','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.41','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.42','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.43','59.154.202.44','59.154.202.44','59.154.202.44','59.154.202.44','59.154.202.45','59.154.202.45','59.154.202.45','59.154.202.46','59.154.202.46','59.154.202.47']
+groupUniqArray: ['59.154.202.28','59.154.202.45','59.154.202.35','59.154.202.2','59.154.202.42','59.154.202.1','59.154.202.4','59.154.202.15','59.154.202.22','59.154.202.20','59.154.202.12','59.154.202.3','59.154.202.40','59.154.202.43','59.154.202.26','59.154.202.37','59.154.202.7','59.154.202.36','59.154.202.32','59.154.202.47','59.154.202.17','59.154.202.11','59.154.201.255','59.154.202.0','59.154.202.14','59.154.202.25','59.154.202.6','59.154.202.30','59.154.202.16','59.154.202.21','59.154.202.23','59.154.202.38','59.154.202.44','59.154.202.39','59.154.202.41','59.154.202.27','59.154.202.33','59.154.202.19','59.154.202.5','59.154.202.9','59.154.202.18','59.154.202.24','59.154.202.34','59.154.202.46','59.154.202.8','59.154.202.29','59.154.202.10','59.154.202.13','59.154.202.31']
+uniq:           49
+uniqExact:      49
+uniqCombined:   49
+uniqCombined64: 49
+uniqHLL12:      48
+uniqTheta:      49
 ----- finalizeAggregation / IfState / ip6 -----
 Row 1:
 ──────
@@ -117,20 +117,20 @@ min:            8c:333c::8c:333c:0:0
 max:            ff8b:333c::ff8b:333c:0:0
 first_value:    8c:333c::8c:333c:0:0
 last_value:     ff8b:333c::ff8b:333c:0:0
-topK:           ['ff8b:333c::ff8b:333c:0:0','68c:333c::68c:333c:0:0','e98b:333c::e98b:333c:0:0','e88b:333c::e88b:333c:0:0','e78b:333c::e78b:333c:0:0','e68b:333c::e68b:333c:0:0','e58b:333c::e58b:333c:0:0','e48b:333c::e48b:333c:0:0','ea8b:333c::ea8b:333c:0:0','e28b:333c::e28b:333c:0:0']
-groupArray:     ['8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','e8c:333c::e8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
-groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e8c:333c::e8c:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
-uniq:           50
-uniqExact:      50
-uniqCombined:   50
-uniqCombined64: 50
-uniqHLL12:      50
-uniqTheta:      50
+topK:           ['dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0']
+groupArray:     ['8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','8c:333c::8c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','18c:333c::18c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','28c:333c::28c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','38c:333c::38c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','48c:333c::48c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','58c:333c::58c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','68c:333c::68c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','78c:333c::78c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','88c:333c::88c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','98c:333c::98c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','a8c:333c::a8c:333c:0:0','b8c:333c::b8c:333c:0:0','b8c:333c::b8c:333c:0:0','b8c:333c::b8c:333c:0:0','c8c:333c::c8c:333c:0:0','c8c:333c::c8c:333c:0:0','d8c:333c::d8c:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','dd8b:333c::dd8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','de8b:333c::de8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','df8b:333c::df8b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e08b:333c::e08b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e18b:333c::e18b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e28b:333c::e28b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e48b:333c::e48b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e58b:333c::e58b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e68b:333c::e68b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e78b:333c::e78b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e88b:333c::e88b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','e98b:333c::e98b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ec8b:333c::ec8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ed8b:333c::ed8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f08b:333c::f08b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f18b:333c::f18b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f28b:333c::f28b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f38b:333c::f38b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f48b:333c::f48b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f58b:333c::f58b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f68b:333c::f68b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f78b:333c::f78b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f88b:333c::f88b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','f98b:333c::f98b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fa8b:333c::fa8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fc8b:333c::fc8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fd8b:333c::fd8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','fe8b:333c::fe8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+groupUniqArray: ['58c:333c::58c:333c:0:0','f78b:333c::f78b:333c:0:0','f38b:333c::f38b:333c:0:0','18c:333c::18c:333c:0:0','e78b:333c::e78b:333c:0:0','e38b:333c::e38b:333c:0:0','e48b:333c::e48b:333c:0:0','e08b:333c::e08b:333c:0:0','df8b:333c::df8b:333c:0:0','f48b:333c::f48b:333c:0:0','68c:333c::68c:333c:0:0','28c:333c::28c:333c:0:0','f08b:333c::f08b:333c:0:0','fa8b:333c::fa8b:333c:0:0','88c:333c::88c:333c:0:0','c8c:333c::c8c:333c:0:0','fe8b:333c::fe8b:333c:0:0','ea8b:333c::ea8b:333c:0:0','ee8b:333c::ee8b:333c:0:0','e98b:333c::e98b:333c:0:0','ed8b:333c::ed8b:333c:0:0','b8c:333c::b8c:333c:0:0','f98b:333c::f98b:333c:0:0','fd8b:333c::fd8b:333c:0:0','de8b:333c::de8b:333c:0:0','f58b:333c::f58b:333c:0:0','78c:333c::78c:333c:0:0','38c:333c::38c:333c:0:0','f18b:333c::f18b:333c:0:0','e58b:333c::e58b:333c:0:0','e18b:333c::e18b:333c:0:0','e68b:333c::e68b:333c:0:0','e28b:333c::e28b:333c:0:0','48c:333c::48c:333c:0:0','dd8b:333c::dd8b:333c:0:0','f68b:333c::f68b:333c:0:0','f28b:333c::f28b:333c:0:0','8c:333c::8c:333c:0:0','a8c:333c::a8c:333c:0:0','f88b:333c::f88b:333c:0:0','fc8b:333c::fc8b:333c:0:0','e88b:333c::e88b:333c:0:0','ec8b:333c::ec8b:333c:0:0','eb8b:333c::eb8b:333c:0:0','ef8b:333c::ef8b:333c:0:0','fb8b:333c::fb8b:333c:0:0','98c:333c::98c:333c:0:0','d8c:333c::d8c:333c:0:0','ff8b:333c::ff8b:333c:0:0']
+uniq:           49
+uniqExact:      49
+uniqCombined:   49
+uniqCombined64: 49
+uniqHLL12:      49
+uniqTheta:      49
 ----- Arg / hash / State / ip4 -----
 Row 1:
 ──────
 argMinState: 13774589216353164344
-argMaxState: 9177365218111013695
+argMaxState: 1131101663917664667
 ----- Arg / hash / State / ip6 -----
 Row 1:
 ──────
@@ -140,7 +140,7 @@ argMaxState: 16598449636475438091
 Row 1:
 ──────
 argMinState: 59.154.201.255
-argMaxState: 59.154.202.48
+argMaxState: 59.154.202.47
 ----- Arg / finalizeAggregation / State / ip6 -----
 Row 1:
 ──────

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 0814/1478] 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 478bad32376ff2787e83107c8274f4b743c569ac Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 13 Jun 2023 15:04:11 +0000
Subject: [PATCH 0815/1478] Automatic style fix

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index bb25ac4b029..f9d337b6d86 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -551,6 +551,7 @@ def test_schema_inference_no_globs_tf(cluster):
         "499500\t2890\t332833500\ttest_schema_inference_no_globs_tf.csv\tcont/test_schema_inference_no_globs_tf.csv"
     ]
 
+
 def test_schema_inference_from_globs_tf(cluster):
     node = cluster.instances["node"]
     unique_prefix = random.randint(1, 10000)

From bc4724490239ea34b4924da17ddabbb1f90e2bee Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 17:06:40 +0200
Subject: [PATCH 0816/1478] Updated tests for CI checks

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index f9d337b6d86..8ab5d416b03 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -558,6 +558,7 @@ def test_schema_inference_from_globs_tf(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
     max_path = ""
+    
     for i in range(10):
         for j in range(10):
             path = "{}/{}_{}/{}.csv".format(

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 0817/1478] 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 0818/1478] 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 8dde50eb3aeef2bd83a1c7c0ec244dfe1c66bf32 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 13 Jun 2023 15:19:16 +0000
Subject: [PATCH 0819/1478] Automatic style fix

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 8ab5d416b03..3d9c751be3c 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -558,7 +558,7 @@ def test_schema_inference_from_globs_tf(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
     max_path = ""
-    
+
     for i in range(10):
         for j in range(10):
             path = "{}/{}_{}/{}.csv".format(

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 0820/1478] 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 0821/1478] 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 0822/1478] 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 9a5c5c7e931c41f406e316cb20cc7659c40fccc5 Mon Sep 17 00:00:00 2001
From: Yuriy Chernyshov <thegeorg@yandex-team.com>
Date: Tue, 13 Jun 2023 19:29:41 +0300
Subject: [PATCH 0823/1478] Update contrib/re2 to 2023-06-02

---
 contrib/re2                               |  2 +-
 src/Common/OptimizedRegularExpression.cpp | 12 ++++++------
 src/Common/parseGlobs.cpp                 |  2 +-
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/contrib/re2 b/contrib/re2
index 13ebb377c6a..03da4fc0857 160000
--- a/contrib/re2
+++ b/contrib/re2
@@ -1 +1 @@
-Subproject commit 13ebb377c6ad763ca61d12dd6f88b1126bd0b911
+Subproject commit 03da4fc0857c285e3a26782f6bc8931c4c950df4
diff --git a/src/Common/OptimizedRegularExpression.cpp b/src/Common/OptimizedRegularExpression.cpp
index f2fe922ef19..5df9ce76098 100644
--- a/src/Common/OptimizedRegularExpression.cpp
+++ b/src/Common/OptimizedRegularExpression.cpp
@@ -669,16 +669,16 @@ unsigned OptimizedRegularExpressionImpl<thread_safe>::match(const char * subject
             matches.resize(limit);
             for (size_t i = 0; i < limit; ++i)
             {
-                if (pieces[i] != nullptr)
-                {
-                    matches[i].offset = pieces[i].data() - subject;
-                    matches[i].length = pieces[i].length();
-                }
-                else
+                if (pieces[i].empty())
                 {
                     matches[i].offset = std::string::npos;
                     matches[i].length = 0;
                 }
+                else
+                {
+                    matches[i].offset = pieces[i].data() - subject;
+                    matches[i].length = pieces[i].length();
+                }
             }
             return limit;
         }
diff --git a/src/Common/parseGlobs.cpp b/src/Common/parseGlobs.cpp
index f8d331c2b76..07cce38afff 100644
--- a/src/Common/parseGlobs.cpp
+++ b/src/Common/parseGlobs.cpp
@@ -40,7 +40,7 @@ std::string makeRegexpPatternFromGlobs(const std::string & initial_str_with_glob
     size_t current_index = 0;
     while (RE2::FindAndConsume(&input, enum_or_range, &matched))
     {
-        std::string buffer = matched.ToString();
+        std::string buffer{matched};
         oss_for_replacing << escaped_with_globs.substr(current_index, matched.data() - escaped_with_globs.data() - current_index - 1) << '(';
 
         if (buffer.find(',') == std::string::npos)

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 0824/1478] 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 0825/1478] 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 0826/1478] 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 0827/1478] 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 0828/1478] 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 0829/1478] 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 0830/1478] 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 0831/1478] 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 0832/1478] 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 e7d2cc4a1a44e9c52d16ede99612e28342735c15 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Tue, 13 Jun 2023 22:11:23 +0000
Subject: [PATCH 0833/1478] add map functions tests

---
 ...es_aggregate_functions_states.reference.j2 | 48 ++++++++++++++
 ...ip_types_aggregate_functions_states.sql.j2 | 64 ++++++++++++++++---
 2 files changed, 102 insertions(+), 10 deletions(-)

diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
index 90f98cf63fd..03b0e065151 100644
--- a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.reference.j2
@@ -170,3 +170,51 @@ Row 1:
 any:      dd8b:333c::dd8b:333c:0:0
 anyHeavy: dd8b:333c::dd8b:333c:0:0
 anyLast:  dd8b:333c::dd8b:333c:0:0
+----- Map/Map hash / State / ip4 -----
+Row 1:
+──────
+sumMapState: 9327034461443333306
+minMapState: 17403430892851901033
+maxMapState: 17403430892851901033
+----- Map/Map hash / State / ip6 -----
+Row 1:
+──────
+sumMapState: 5204122423200337352
+minMapState: 14534921151579960284
+maxMapState: 14534921151579960284
+----- Map/Map finalizeAggregation / State / ip4 -----
+Row 1:
+──────
+sumMap: {'59.154.201.255':1}
+minMap: {'59.154.201.255':1}
+maxMap: {'59.154.201.255':1}
+----- Map/Map finalizeAggregation / State / ip6 -----
+Row 1:
+──────
+sumMap: {'dd8b:333c::dd8b:333c:0:0':1}
+minMap: {'dd8b:333c::dd8b:333c:0:0':1}
+maxMap: {'dd8b:333c::dd8b:333c:0:0':1}
+----- Map/Array hash / State / ip4 -----
+Row 1:
+──────
+sumMapState: 9327034461443333306
+minMapState: 9327034461443333306
+maxMapState: 9327034461443333306
+----- Map/Array hash / State / ip6 -----
+Row 1:
+──────
+sumMapState: 15555709096566410627
+minMapState: 15555709096566410627
+maxMapState: 15555709096566410627
+----- Map/Array finalizeAggregation / State / ip4 -----
+Row 1:
+──────
+sumMap: (['59.154.201.255'],[1])
+minMap: (['59.154.201.255'],[1])
+maxMap: (['59.154.201.255'],[1])
+----- Map/Array finalizeAggregation / State / ip6 -----
+Row 1:
+──────
+sumMap: (['dd8b:333c::dd8b:333c:0:0'],[1])
+minMap: (['dd8b:333c::dd8b:333c:0:0'],[1])
+maxMap: (['dd8b:333c::dd8b:333c:0:0'],[1])
diff --git a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2 b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
index 7daff5a690f..7d030d4be2d 100644
--- a/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
+++ b/tests/queries/0_stateless/02751_ip_types_aggregate_functions_states.sql.j2
@@ -1,5 +1,4 @@
--- Tags: no-fasttest
--- no-fasttest because uniqTheta
+-- Tags: no-parallel, no-fasttest
 
 {# this test checks backward compatibility of aggregate functions States against IPv4, IPv6 types #}
 
@@ -22,7 +21,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
 {% for generator_name, ip_generator in ip_generators.items() %}
 
 select '----- finalizeAggregation / State / {{ generator_name }} -----';
@@ -35,7 +33,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
 {% for generator_name, ip_generator in ip_generators.items() %}
 
 select '----- hash / IfState / {{ generator_name }} -----';
@@ -48,7 +45,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
 {% for generator_name, ip_generator in ip_generators.items() %}
 
 select '----- finalizeAggregation / IfState / {{ generator_name }} -----';
@@ -61,8 +57,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
-
 {% set agg_func_list = [ "argMin", "argMax" ] %}
 
 {% for generator_name, ip_generator in ip_generators.items() %}
@@ -77,8 +71,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
-
 {% for generator_name, ip_generator in ip_generators.items() %}
 
 select '----- Arg / finalizeAggregation / State / {{ generator_name }} -----';
@@ -91,6 +83,8 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
+
+
 {# let's test functions with not deterministic result against 1 row, to make it deterministic #}
 {% set ip4_generator = "select number::UInt32::IPv4 ip from numbers(999999999,1) order by ip" %}
 {% set ip6_generator = "SELECT toIPv6(IPv6NumToString(toFixedString(reinterpretAsFixedString(number)||reinterpretAsFixedString(number), 16))) AS ip FROM numbers(1010011101, 1) order by ip" %}
@@ -112,7 +106,6 @@ from ( {{ ip_generator }} ) format Vertical;
 {% endfor -%}
 
 
-
 {% for generator_name, ip_generator in ip_generators.items() %}
 
 select '----- finalizeAggregation / State / {{ generator_name }} -----';
@@ -124,3 +117,54 @@ from ( {{ ip_generator }} ) format Vertical;
 
 {% endfor -%}
 
+
+
+{% set agg_func_list = [ "sumMap", "minMap", "maxMap" ] %}
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Map/Map hash / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list  -%}
+     cityHash64(hex( {{ func }}State(map(ip, 1::Int64)) )) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Map/Map finalizeAggregation / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     finalizeAggregation( {{ func }}State(map(ip, 1::Int64)) ) AS {{ func }}{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Map/Array hash / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     cityHash64(hex( {{ func }}State([ip], [1::Int64]) )) AS {{ func }}State{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}
+
+
+{% for generator_name, ip_generator in ip_generators.items() %}
+
+select '----- Map/Array finalizeAggregation / State / {{ generator_name }} -----';
+select
+  {% for func in agg_func_list -%}
+     finalizeAggregation( {{ func }}State([ip], [1::Int64]) ) AS {{ func }}{{ "," if not loop.last }}
+  {% endfor -%}
+from ( {{ ip_generator }} ) format Vertical;
+
+{% endfor -%}

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 0834/1478] 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 0835/1478] 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 0836/1478] 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 0837/1478] 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 0838/1478] 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 0839/1478] 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 0840/1478] 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 0841/1478] 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 0842/1478] 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 0843/1478] 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 0844/1478] 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 0845/1478] 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 0846/1478] 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 0847/1478] 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 0848/1478] 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 0849/1478] 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 0a1d0c4abd0f8ece5af6f3a3d5ccc5207dfff0f2 Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Tue, 13 Jun 2023 23:36:14 -0700
Subject: [PATCH 0850/1478] Fix one stateless test.

---
 src/Client/ClientBase.cpp                                  | 5 ++---
 tests/queries/0_stateless/02346_into_outfile_and_stdout.sh | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index fc108b8f57d..b746d46148c 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -596,14 +596,13 @@ try
                             range.second);
                 }
 
-                std::error_code ec;
-                if (std::filesystem::is_regular_file(out_file, ec))
+                if (fs::exists(out_file))
                 {
                     if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
                     {
                         throw Exception(
                             ErrorCodes::CANNOT_OPEN_FILE,
-                            "File {} exists, consider using 'INTO OUTFILE ... APPEND' or 'INTO OUTFILE ... TRUNCATE' if appropriate.",
+                            "File {} exists, consider using APPEND or TRUNCATE if appropriate.",
                             out_file);
                     }
                 }
diff --git a/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh b/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
index 021dc9125d4..8ec086c97ef 100755
--- a/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
+++ b/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
@@ -66,7 +66,7 @@ performBadQuery "bad_query_incorrect_usage" "SELECT 1, 2, 3 INTO OUTFILE AND STD
 
 performBadQuery "bad_query_no_into_outfile" "SELECT 1, 2, 3 AND STDOUT'" "SYNTAX_ERROR"
 
-performFileExists "bad_query_file_exists" "SELECT 1, 2, 3 INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists.out' AND STDOUT" "File exists. (CANNOT_OPEN_FILE)"
+performFileExists "bad_query_file_exists" "SELECT 1, 2, 3 INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists.out' AND STDOUT" "File ${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists exists, consider using APPEND or TRUNCATE if appropriate. (CANNOT_OPEN_FILE)"
 
 performCompression "compression" "SELECT * FROM (SELECT 'Hello, World! From clickhouse.') INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_compression.gz' AND STDOUT COMPRESSION 'GZ' FORMAT TabSeparated"
 

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 0851/1478] 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 0852/1478] 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 0853/1478] 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 0854/1478] 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 0855/1478] 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 1663905acdafcce577d58852a0835fdb760750e8 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Wed, 14 Jun 2023 08:48:16 +0000
Subject: [PATCH 0856/1478] Hold context in pipeline resources.

---
 src/Processors/QueryPlan/ReadFromMergeTree.cpp | 1 +
 src/QueryPipeline/QueryPipelineBuilder.h       | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 8f610eb4380..bbea1d38fb1 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1884,6 +1884,7 @@ void ReadFromMergeTree::initializePipeline(QueryPipelineBuilder & pipeline, cons
         processors.emplace_back(processor);
 
     pipeline.init(std::move(pipe));
+    pipeline.addContext(context);
     // Attach QueryIdHolder if needed
     if (query_id_holder)
         pipeline.setQueryIdHolder(std::move(query_id_holder));
diff --git a/src/QueryPipeline/QueryPipelineBuilder.h b/src/QueryPipeline/QueryPipelineBuilder.h
index da8443a7e33..134de59520d 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.h
+++ b/src/QueryPipeline/QueryPipelineBuilder.h
@@ -185,6 +185,7 @@ public:
 
     void addResources(QueryPlanResourceHolder resources_) { resources = std::move(resources_); }
     void setQueryIdHolder(std::shared_ptr<QueryIdHolder> query_id_holder) { resources.query_id_holders.emplace_back(std::move(query_id_holder)); }
+    void addContext(ContextPtr context) { resources.interpreter_context.emplace_back(std::move(context)); }
 
     /// Convert query pipeline to pipe.
     static Pipe getPipe(QueryPipelineBuilder pipeline, QueryPlanResourceHolder & resources);

From 918b8c4585025e8a357115945cce501c05d31be1 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Wed, 14 Jun 2023 10:51:59 +0200
Subject: [PATCH 0857/1478] Updated filename in test

---
 tests/integration/test_storage_azure_blob_storage/test.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 3d9c751be3c..e99ae72eb8b 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -583,13 +583,13 @@ def test_partition_by_tf(cluster):
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
     partition_by = "column3"
     values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
-    filename = "test_tf_{_partition_id}.csv"
+    filename = "test_partition_tf_{_partition_id}.csv"
 
     azure_query(
         node,
         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")
-    assert "3,2,1\n" == get_azure_file_content("test_tf_1.csv")
-    assert "78,43,45\n" == get_azure_file_content("test_tf_45.csv")
+    assert "1,2,3\n" == get_azure_file_content("test_partition_tf_3.csv")
+    assert "3,2,1\n" == get_azure_file_content("test_partition_tf_1.csv")
+    assert "78,43,45\n" == get_azure_file_content("test_partition_tfs_45.csv")

From c98a194b571e8c39504afc829fa91492f4dcbe2d Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Wed, 14 Jun 2023 11:00:11 +0200
Subject: [PATCH 0858/1478] Updated unique names for test to avoid same names
 by random numbers

---
 tests/integration/test_storage_azure_blob_storage/test.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index e99ae72eb8b..e2077f8face 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -300,10 +300,10 @@ def test_put_get_with_globs(cluster):
 
             azure_query(
                 node,
-                f"CREATE TABLE test_{i}_{j} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+                f"CREATE TABLE test_put_{i}_{j} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
             )
 
-            query = f"insert into test_{i}_{j} VALUES {values}"
+            query = f"insert into test_put_{i}_{j} VALUES {values}"
             azure_query(node, query)
 
     azure_query(
@@ -332,9 +332,9 @@ def test_azure_glob_scheherazade(cluster):
                 unique_num = random.randint(1, 10000)
                 azure_query(
                     node,
-                    f"CREATE TABLE test_{i}_{unique_num} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
+                    f"CREATE TABLE test_scheherazade_{i}_{unique_num} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
                 )
-                query = f"insert into test_{i}_{unique_num} VALUES {values}"
+                query = f"insert into test_scheherazade_{i}_{unique_num} VALUES {values}"
                 azure_query(node, query)
 
         jobs.append(

From f6bad2c064efeb997755be8b9f313a3859a6f81f Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Wed, 14 Jun 2023 09:13:38 +0000
Subject: [PATCH 0859/1478] Automatic style fix

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index e2077f8face..0002ccbf483 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -334,7 +334,9 @@ def test_azure_glob_scheherazade(cluster):
                     node,
                     f"CREATE TABLE test_scheherazade_{i}_{unique_num} ({table_format}) Engine = AzureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV')",
                 )
-                query = f"insert into test_scheherazade_{i}_{unique_num} VALUES {values}"
+                query = (
+                    f"insert into test_scheherazade_{i}_{unique_num} VALUES {values}"
+                )
                 azure_query(node, query)
 
         jobs.append(

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 0860/1478] 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 0861/1478] 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 f9f1e870c8468b829b4aa449c8a9b3736b733056 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Wed, 14 Jun 2023 10:09:01 +0000
Subject: [PATCH 0862/1478] Fix build

---
 contrib/azure-cmake/CMakeLists.txt | 2 +-
 programs/keeper/CMakeLists.txt     | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 887122e7653..a1dd4664e79 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 OS_FREEBSD OR (NOT ARCH_AMD64))
     message(STATUS "Not using Azure blob storage")
     return()
 endif()
diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 90f4f870df6..a3a8a769bff 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -148,7 +148,6 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferFromTemporaryFile.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/WriteBufferWithFinalizeCallback.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/AsynchronousBoundedReadBuffer.cpp
-        ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/getThreadPoolReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolRemoteFSReader.cpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Disks/IO/ThreadPoolReader.cpp

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 0863/1478] 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 0864/1478] 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 0865/1478] 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 739dc6739f085e097cb39dbabf6e24588722d8cb Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 13:31:02 +0200
Subject: [PATCH 0866/1478] Progress

---
 src/Interpreters/Cache/FileCache.cpp         |  22 +++-
 src/Interpreters/Cache/FileCache.h           |   5 +-
 src/Interpreters/Cache/FileCacheSettings.cpp |   8 +-
 src/Interpreters/Cache/FileCache_fwd.h       |   3 +-
 src/Interpreters/Cache/FileSegment.cpp       |  67 +++++-----
 src/Interpreters/Cache/Metadata.cpp          | 128 ++++++++++++++++++-
 src/Interpreters/Cache/Metadata.h            |  13 ++
 7 files changed, 201 insertions(+), 45 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index e6bc8b1f79b..65f8ecf7e89 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/ThreadPool.h>
 
 #include <filesystem>
 
@@ -49,9 +50,9 @@ FileCache::FileCache(const FileCacheSettings & settings)
     , 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)
+    , boundary_alignment(settings.boundary_alignment)
     , log(&Poco::Logger::get("FileCache"))
     , metadata(settings.base_path)
-    , boundary_alignment(settings.boundary_alignment)
 {
     main_priority = std::make_unique<LRUFileCachePriority>(settings.max_size, settings.max_elements);
 
@@ -124,7 +125,12 @@ void FileCache::initialize()
 
     is_initialized = true;
 
-    cleanup_task = Context::getGlobalContextInstance()->getSchedulePool().createTask("FileCacheCleanup", [this]{ cleanupThreadFunc(); });
+    size_t num_threads=2;
+    for (size_t i = 0; i < num_threads; ++i)
+         download_threads.emplace_back([this] { metadata.downloadThreadFunc(); });
+
+    auto & schedule_pool = Context::getGlobalContextInstance()->getSchedulePool();
+    cleanup_task = schedule_pool.createTask("FileCacheCleanup", [this]{ cleanupThreadFunc(); });
     cleanup_task->activate();
     cleanup_task->scheduleAfter(delayed_cleanup_interval_ms);
 }
@@ -412,7 +418,12 @@ FileSegmentsHolderPtr FileCache::set(
 }
 
 FileSegmentsHolderPtr
-FileCache::getOrSet(const Key & key, size_t offset, size_t size, size_t file_size, const CreateFileSegmentSettings & settings)
+FileCache::getOrSet(
+    const Key & key,
+    size_t offset,
+    size_t size,
+    size_t file_size,
+    const CreateFileSegmentSettings & settings)
 {
     assertInitialized();
 
@@ -979,6 +990,10 @@ void FileCache::deactivateBackgroundOperations()
 {
     if (cleanup_task)
         cleanup_task->deactivate();
+
+    metadata.cancelDownload();
+    for (auto & thread : download_threads)
+        thread.join();
 }
 
 void FileCache::cleanup()
@@ -1017,6 +1032,7 @@ FileSegmentsHolderPtr FileCache::getSnapshot()
     {
         for (const auto & [_, file_segment_metadata] : locked_key)
             file_segments.push_back(FileSegment::getSnapshot(file_segment_metadata->file_segment));
+        return true;
     });
     return std::make_unique<FileSegmentsHolder>(std::move(file_segments), /* complete_on_dtor */false);
 }
diff --git a/src/Interpreters/Cache/FileCache.h b/src/Interpreters/Cache/FileCache.h
index 71fc1722844..ed693b475ec 100644
--- a/src/Interpreters/Cache/FileCache.h
+++ b/src/Interpreters/Cache/FileCache.h
@@ -134,6 +134,7 @@ private:
     const bool allow_persistent_files;
     const size_t bypass_cache_threshold = 0;
     const size_t delayed_cleanup_interval_ms;
+    const size_t boundary_alignment;
 
     Poco::Logger * log;
 
@@ -178,9 +179,9 @@ private:
      */
     BackgroundSchedulePool::TaskHolder cleanup_task;
 
-    void assertInitialized() const;
+    std::vector<ThreadFromGlobalPool> download_threads;
 
-    size_t boundary_alignment;
+    void assertInitialized() const;
 
     void assertCacheCorrectness();
 
diff --git a/src/Interpreters/Cache/FileCacheSettings.cpp b/src/Interpreters/Cache/FileCacheSettings.cpp
index 1fe51bf5f3e..d41aa8ffcb9 100644
--- a/src/Interpreters/Cache/FileCacheSettings.cpp
+++ b/src/Interpreters/Cache/FileCacheSettings.cpp
@@ -31,10 +31,9 @@ void FileCacheSettings::loadFromConfig(const Poco::Util::AbstractConfiguration &
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Disk Cache requires non-empty `path` field (cache base path) in config");
 
     max_elements = config.getUInt64(config_prefix + ".max_elements", FILECACHE_DEFAULT_MAX_ELEMENTS);
+
     if (config.has(config_prefix + ".max_file_segment_size"))
         max_file_segment_size = parseWithSizeSuffix<uint64_t>(config.getString(config_prefix + ".max_file_segment_size"));
-    else
-        max_file_segment_size = FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE;
 
     cache_on_write_operations = config.getUInt64(config_prefix + ".cache_on_write_operations", false);
     enable_filesystem_query_cache_limit = config.getUInt64(config_prefix + ".enable_filesystem_query_cache_limit", false);
@@ -44,12 +43,11 @@ void FileCacheSettings::loadFromConfig(const Poco::Util::AbstractConfiguration &
 
     if (config.has(config_prefix + ".bypass_cache_threashold"))
         bypass_cache_threashold = parseWithSizeSuffix<uint64_t>(config.getString(config_prefix + ".bypass_cache_threashold"));
-    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);
+    if (config.has(config_prefix + ".boundary_alignment"))
+        boundary_alignment = parseWithSizeSuffix<uint64_t>(config.getString(config_prefix + ".boundary_alignment"));
 
     delayed_cleanup_interval_ms = config.getUInt64(config_prefix + ".delayed_cleanup_interval_ms", FILECACHE_DELAYED_CLEANUP_INTERVAL_MS);
 }
diff --git a/src/Interpreters/Cache/FileCache_fwd.h b/src/Interpreters/Cache/FileCache_fwd.h
index 01f518d0c4e..c791d08ed4f 100644
--- a/src/Interpreters/Cache/FileCache_fwd.h
+++ b/src/Interpreters/Cache/FileCache_fwd.h
@@ -4,7 +4,8 @@
 namespace DB
 {
 
-static constexpr int FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE = 8 * 1024 * 1024;
+static constexpr int FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE = 32 * 1024 * 1024; /// 32Mi
+static constexpr int FILECACHE_DEFAULT_MIN_FILE_SEGMENT_SIZE = 4 * 1024 * 1024; /// 4Mi
 static constexpr int FILECACHE_DEFAULT_MAX_ELEMENTS = 10000000;
 static constexpr int FILECACHE_DEFAULT_HITS_THRESHOLD = 0;
 static constexpr size_t FILECACHE_BYPASS_THRESHOLD = 256 * 1024 * 1024;
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 7b82c58080c..f95379ba07f 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -214,8 +214,10 @@ void FileSegment::resetDownloadingStateUnlocked(const FileSegmentGuard::Lock & l
     /// range().size() can equal 0 in case of write-though cache.
     if (!is_unbound && current_downloaded_size != 0 && current_downloaded_size == range().size())
         setDownloadedUnlocked(lock);
-    else
+    else if (current_downloaded_size)
         setDownloadState(State::PARTIALLY_DOWNLOADED, lock);
+    else
+        setDownloadState(State::EMPTY, lock);
 }
 
 void FileSegment::resetDownloader()
@@ -280,22 +282,9 @@ void FileSegment::resetRemoteFileReader()
 
 FileSegment::RemoteFileReaderPtr FileSegment::extractRemoteFileReader()
 {
-    auto locked_key = lockKeyMetadata(false);
-    if (!locked_key)
-    {
-        assert(isDetached());
+    if (download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
         return std::move(remote_file_reader);
-    }
-
-    auto segment_lock = segment_guard.lock();
-
-    assert(download_state != State::DETACHED);
-
-    bool is_last_holder = locked_key->isLastOwnerOfFileSegment(offset());
-    if (!downloader_id.empty() || !is_last_holder)
-        return nullptr;
-
-    return std::move(remote_file_reader);
+    return nullptr;
 }
 
 void FileSegment::setRemoteFileReader(RemoteFileReaderPtr remote_file_reader_)
@@ -607,22 +596,17 @@ void FileSegment::complete()
         resetDownloaderUnlocked(segment_lock);
     }
 
-    if (is_downloader || is_last_holder)
+    auto remove_from_cache = [&, this]()
     {
-        if (cache_writer)
-        {
-            cache_writer->finalize();
-            cache_writer.reset();
-        }
-        remote_file_reader.reset();
-    }
+        LOG_TEST(log, "Remove file segment {} (nothing downloaded)", range().toString());
+        locked_key->removeFileSegment(offset(), segment_lock);
+        setDetachedState(segment_lock);
+    };
 
     if (segment_kind == FileSegmentKind::Temporary && is_last_holder)
     {
         LOG_TEST(log, "Removing temporary file segment: {}", getInfoForLogUnlocked(segment_lock));
-        detach(segment_lock, *locked_key);
-        setDownloadState(State::DETACHED, segment_lock);
-        locked_key->removeFileSegment(offset(), segment_lock);
+        remove_from_cache();
         return;
     }
 
@@ -633,6 +617,7 @@ void FileSegment::complete()
             chassert(current_downloaded_size == range().size());
             chassert(current_downloaded_size == fs::file_size(getPathInLocalCache()));
             chassert(!cache_writer);
+            chassert(!remote_file_reader);
             break;
         }
         case State::DOWNLOADING:
@@ -640,8 +625,24 @@ void FileSegment::complete()
             chassert(!is_last_holder);
             break;
         }
-        case State::EMPTY:
         case State::PARTIALLY_DOWNLOADED:
+        {
+            if (is_last_holder)
+            {
+                LOG_TEST(
+                    log, "Submitted file segment for background download "
+                    "(having {}/{})", downloaded_size, range().size());
+
+                locked_key->addToDownloadQueue(offset(), segment_lock); /// Finish download in background.
+            }
+            break;
+        }
+        case State::EMPTY:
+        {
+            if (is_last_holder)
+                remove_from_cache();
+            break;
+        }
         case State::PARTIALLY_DOWNLOADED_NO_CONTINUATION:
         {
             chassert(current_downloaded_size != range().size());
@@ -650,10 +651,9 @@ void FileSegment::complete()
             {
                 if (current_downloaded_size == 0)
                 {
-                    LOG_TEST(log, "Remove file segment {} (nothing downloaded)", range().toString());
-                    locked_key->removeFileSegment(offset(), segment_lock);
+                    remove_from_cache();
                 }
-                else
+                else if (download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
                 {
                     LOG_TEST(log, "Resize file segment {} to downloaded: {}", range().toString(), current_downloaded_size);
 
@@ -672,9 +672,8 @@ void FileSegment::complete()
 
                     /// We mark current file segment with state DETACHED, even though the data is still in cache
                     /// (but a separate file segment) because is_last_holder is satisfied, so it does not matter.
+                    setDetachedState(segment_lock);
                 }
-
-                setDetachedState(segment_lock);
             }
             break;
         }
@@ -844,6 +843,8 @@ void FileSegment::setDetachedState(const FileSegmentGuard::Lock & lock)
     setDownloadState(State::DETACHED, lock);
     key_metadata.reset();
     cache = nullptr;
+    cache_writer.reset();
+    remote_file_reader.reset();
 }
 
 void FileSegment::detach(const FileSegmentGuard::Lock & lock, const LockedKey &)
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index c9a23d1c785..2a3803eb3d7 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -46,10 +46,12 @@ KeyMetadata::KeyMetadata(
     const Key & key_,
     const std::string & key_path_,
     CleanupQueue & cleanup_queue_,
+    DownloadQueue & download_queue_,
     bool created_base_directory_)
     : key(key_)
     , key_path(key_path_)
     , cleanup_queue(cleanup_queue_)
+    , download_queue(download_queue_)
     , created_base_directory(created_base_directory_)
 {
     if (created_base_directory)
@@ -123,6 +125,7 @@ private:
 CacheMetadata::CacheMetadata(const std::string & path_)
     : path(path_)
     , cleanup_queue(std::make_unique<CleanupQueue>())
+    , download_queue(std::make_unique<DownloadQueue>())
     , log(&Poco::Logger::get("CacheMetadata"))
 {
 }
@@ -175,7 +178,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, *download_queue, is_initial_load)).first;
         }
 
         key_metadata = it->second;
@@ -293,6 +296,121 @@ void CacheMetadata::doCleanup()
     }
 }
 
+class DownloadQueue
+{
+friend struct CacheMetadata;
+public:
+    void add(std::weak_ptr<FileSegment> file_segment)
+    {
+        {
+            std::lock_guard lock(mutex);
+            queue.push(file_segment);
+        }
+        cv.notify_one();
+    }
+
+private:
+    void cancel()
+    {
+        std::lock_guard lock(mutex);
+        cancelled = true;
+    }
+
+    std::mutex mutex;
+    std::condition_variable cv;
+    std::queue<std::weak_ptr<FileSegment>> queue;
+    bool cancelled = false;
+};
+
+void CacheMetadata::downloadThreadFunc()
+{
+    std::optional<Memory<>> memory;
+    while (true)
+    {
+        std::weak_ptr<FileSegment> file_segment_weak;
+        {
+            std::unique_lock lock(download_queue->mutex);
+
+            if (download_queue->cancelled)
+                return;
+
+            if (download_queue->queue.empty())
+            {
+                download_queue->cv.wait(lock);
+                continue;
+            }
+
+            file_segment_weak = download_queue->queue.front();
+            download_queue->queue.pop();
+        }
+
+        FileSegmentsHolderPtr holder;
+        {
+            auto file_segment = file_segment_weak.lock();
+            if (!file_segment
+                || file_segment->state() != FileSegment::State::PARTIALLY_DOWNLOADED)
+                continue;
+
+            auto lock = lockKeyMetadata(file_segment->key(), KeyNotFoundPolicy::RETURN_NULL);
+            if (!lock)
+                continue;
+
+            holder = std::make_unique<FileSegmentsHolder>(FileSegments{file_segment});
+        }
+
+        auto & file_segment = holder->front();
+        chassert(file_segment.assertCorrectness());
+
+        if (file_segment.getOrSetDownloader() != FileSegment::getCallerId())
+            continue;
+
+        LOG_TRACE(log, "Downloading file segment: {}", file_segment.getInfoForLog());
+
+        auto reader = file_segment.getRemoteFileReader();
+
+        /// If remote_fs_read_method == 'threadpool',
+        /// reader iteself does not allocate the buffer, but uses the buffer passed to it.
+        /// So will need to allocate a buffer here as well.
+        if (reader->buffer().begin() == nullptr)
+        {
+            if (!memory)
+                memory.emplace(DBMS_DEFAULT_BUFFER_SIZE);
+            reader->set(memory->data(), memory->size());
+        }
+
+        size_t offset = file_segment.getCurrentWriteOffset(false);
+        while (!reader->eof())
+        {
+            auto size = reader->available();
+
+            if (!file_segment.reserve(size))
+                return;
+
+            try
+            {
+                file_segment.write(reader->position(), size, offset);
+                offset += size;
+            }
+            catch (ErrnoException & e)
+            {
+                int code = e.getErrno();
+                if (code == /* No space left on device */28 || code == /* Quota exceeded */122)
+                {
+                    LOG_INFO(log, "Insert into cache is skipped due to insufficient disk space. ({})", e.displayText());
+                    continue;
+                }
+                throw;
+            }
+        }
+    }
+}
+
+void CacheMetadata::cancelDownload()
+{
+    download_queue->cancel();
+    download_queue->cv.notify_all();
+}
+
 LockedKey::LockedKey(std::shared_ptr<KeyMetadata> key_metadata_)
     : key_metadata(key_metadata_)
     , lock(key_metadata->guard.lock())
@@ -426,6 +544,14 @@ void LockedKey::shrinkFileSegmentToDownloadedSize(
     chassert(file_segment->assertCorrectnessUnlocked(segment_lock));
 }
 
+void LockedKey::addToDownloadQueue(size_t offset, const FileSegmentGuard::Lock &)
+{
+    auto it = key_metadata->find(offset);
+    if (it == key_metadata->end())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "There is not offset {}", offset);
+    key_metadata->download_queue.add(it->second->file_segment);
+}
+
 std::shared_ptr<const FileSegmentMetadata> LockedKey::getByOffset(size_t offset) const
 {
     auto it = key_metadata->find(offset);
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 3fd6176f201..f96243c3f1f 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -8,8 +8,12 @@
 
 namespace DB
 {
+
 class CleanupQueue;
 using CleanupQueuePtr = std::shared_ptr<CleanupQueue>;
+class DownloadQueue;
+using DownloadQueuePtr = std::shared_ptr<DownloadQueue>;
+using FileSegmentsHolderPtr = std::unique_ptr<FileSegmentsHolder>;
 
 
 struct FileSegmentMetadata : private boost::noncopyable
@@ -44,6 +48,7 @@ struct KeyMetadata : public std::map<size_t, FileSegmentMetadataPtr>,
         const Key & key_,
         const std::string & key_path_,
         CleanupQueue & cleanup_queue_,
+        DownloadQueue & download_queue_,
         bool created_base_directory_ = false);
 
     enum class KeyState
@@ -69,6 +74,7 @@ private:
     KeyState key_state = KeyState::ACTIVE;
     KeyGuard guard;
     CleanupQueue & cleanup_queue;
+    DownloadQueue & download_queue;
     std::atomic<bool> created_base_directory = false;
 };
 
@@ -109,10 +115,15 @@ public:
 
     void doCleanup();
 
+    void downloadThreadFunc();
+
+    void cancelDownload();
+
 private:
     const std::string path; /// Cache base path
     CacheMetadataGuard guard;
     const CleanupQueuePtr cleanup_queue;
+    const DownloadQueuePtr download_queue;
     Poco::Logger * log;
 };
 
@@ -159,6 +170,8 @@ struct LockedKey : private boost::noncopyable
 
     void shrinkFileSegmentToDownloadedSize(size_t offset, const FileSegmentGuard::Lock &);
 
+    void addToDownloadQueue(size_t offset, const FileSegmentGuard::Lock &);
+
     bool isLastOwnerOfFileSegment(size_t offset) const;
 
     void removeFromCleanupQueue();

From 4096c082b9f7bd49664e6341e4862c1aed3d7a73 Mon Sep 17 00:00:00 2001
From: Yuriy Chernyshov <thegeorg@yandex-team.com>
Date: Wed, 14 Jun 2023 15:09:17 +0300
Subject: [PATCH 0867/1478] Cleanup RE2_SOURCES

---
 contrib/re2-cmake/CMakeLists.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/contrib/re2-cmake/CMakeLists.txt b/contrib/re2-cmake/CMakeLists.txt
index 19939c11ebf..a081f92bc94 100644
--- a/contrib/re2-cmake/CMakeLists.txt
+++ b/contrib/re2-cmake/CMakeLists.txt
@@ -28,7 +28,6 @@ set(RE2_SOURCES
     ${SRC_DIR}/re2/regexp.cc
     ${SRC_DIR}/re2/set.cc
     ${SRC_DIR}/re2/simplify.cc
-    ${SRC_DIR}/re2/stringpiece.cc
     ${SRC_DIR}/re2/tostring.cc
     ${SRC_DIR}/re2/unicode_casefold.cc
     ${SRC_DIR}/re2/unicode_groups.cc

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 0868/1478] 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 0869/1478] 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 0870/1478] 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 011d666073968b1a8cbbd867513e4e8adec1362b Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Wed, 14 Jun 2023 14:55:34 +0200
Subject: [PATCH 0871/1478] Fixed typo in tests

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 0002ccbf483..0de325ccd14 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -594,4 +594,4 @@ def test_partition_by_tf(cluster):
 
     assert "1,2,3\n" == get_azure_file_content("test_partition_tf_3.csv")
     assert "3,2,1\n" == get_azure_file_content("test_partition_tf_1.csv")
-    assert "78,43,45\n" == get_azure_file_content("test_partition_tfs_45.csv")
+    assert "78,43,45\n" == get_azure_file_content("test_partition_tf_45.csv")

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 0872/1478] 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 0873/1478] 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 7f8162e3465318bb9847956edffcd67a4fdb2020 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
Date: Wed, 14 Jun 2023 10:42:20 -0400
Subject: [PATCH 0874/1478] add note regarding -MapState

---
 docs/en/sql-reference/aggregate-functions/combinators.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/sql-reference/aggregate-functions/combinators.md b/docs/en/sql-reference/aggregate-functions/combinators.md
index fd693430064..a395b350a55 100644
--- a/docs/en/sql-reference/aggregate-functions/combinators.md
+++ b/docs/en/sql-reference/aggregate-functions/combinators.md
@@ -97,6 +97,10 @@ Result:
 
 If you apply this combinator, the aggregate function does not return the resulting value (such as the number of unique values for the [uniq](../../sql-reference/aggregate-functions/reference/uniq.md#agg_function-uniq) function), but an intermediate state of the aggregation (for `uniq`, this is the hash table for calculating the number of unique values). This is an `AggregateFunction(...)` that can be used for further processing or stored in a table to finish aggregating later.
 
+:::note
+Please notice, that -MapState is not an invariant for the same data due to the fact that order of data in intermediate state can change, though it doesn't impact ingestion of this data.
+:::
+
 To work with these states, use:
 
 - [AggregatingMergeTree](../../engines/table-engines/mergetree-family/aggregatingmergetree.md) table engine.

From 0131ca8768efd5840f330b2ef11acc72c35a36a2 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
Date: Wed, 14 Jun 2023 10:49:20 -0400
Subject: [PATCH 0875/1478] add note regarding -MapState

---
 docs/ru/sql-reference/aggregate-functions/combinators.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/ru/sql-reference/aggregate-functions/combinators.md b/docs/ru/sql-reference/aggregate-functions/combinators.md
index 3a7ff571f99..99d5f11442c 100644
--- a/docs/ru/sql-reference/aggregate-functions/combinators.md
+++ b/docs/ru/sql-reference/aggregate-functions/combinators.md
@@ -66,6 +66,10 @@ WITH anySimpleState(number) AS c SELECT toTypeName(c), c FROM numbers(1);
 
 В случае применения этого комбинатора, агрегатная функция возвращает не готовое значение (например, в случае функции [uniq](reference/uniq.md#agg_function-uniq) — количество уникальных значений), а промежуточное состояние агрегации (например, в случае функции `uniq` — хэш-таблицу для расчёта количества уникальных значений), которое имеет тип `AggregateFunction(...)` и может использоваться для дальнейшей обработки или может быть сохранено в таблицу для последующей доагрегации.
 
+:::note
+Промежуточное состояние для -MapState не является инвариантом для одних и тех же исходных данные т.к. порядок данных может меняться. Это не влияет, тем не менее, на загрузку таких данных.
+:::
+
 Для работы с промежуточными состояниями предназначены:
 
 -   Движок таблиц [AggregatingMergeTree](../../engines/table-engines/mergetree-family/aggregatingmergetree.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 0876/1478] 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 0877/1478] 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 0878/1478] 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 0879/1478] 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 0880/1478] 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 0881/1478] 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 0882/1478] 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 0883/1478] 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 0884/1478] 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 96fb7f04cbc94c625229afd2958cea056c563920 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 15:11:43 +0200
Subject: [PATCH 0885/1478] Finish download of partially downloaded file
 segments in the background instead of resizing

---
 src/Common/CurrentMetrics.cpp                 |   1 +
 src/Interpreters/Cache/FileCache.cpp          |  38 ++---
 src/Interpreters/Cache/FileCache.h            |   1 +
 src/Interpreters/Cache/FileCacheSettings.cpp  |   3 +
 src/Interpreters/Cache/FileCacheSettings.h    |   3 +-
 src/Interpreters/Cache/FileCache_fwd.h        |   1 +
 src/Interpreters/Cache/FileSegment.cpp        |  20 ++-
 src/Interpreters/Cache/Metadata.cpp           | 154 ++++++++++++------
 src/Interpreters/Cache/Metadata.h             |   2 +
 ...02789_filesystem_cache_alignment.reference |   7 +
 .../02789_filesystem_cache_alignment.sh       | 125 ++++++++++++++
 11 files changed, 264 insertions(+), 91 deletions(-)
 create mode 100644 tests/queries/0_stateless/02789_filesystem_cache_alignment.reference
 create mode 100755 tests/queries/0_stateless/02789_filesystem_cache_alignment.sh

diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 61725d079bf..b479eac3021 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -188,6 +188,7 @@
     M(CacheDetachedFileSegments, "Number of existing detached cache file segments") \
     M(FilesystemCacheSize, "Filesystem cache size in bytes") \
     M(FilesystemCacheElements, "Filesystem cache elements (file segments)") \
+    M(FilesystemCacheDownloadQueueElements, "Filesystem cache elements in download queue") \
     M(AsyncInsertCacheSize, "Number of async insert hash id in cache") \
     M(S3Requests, "S3 requests") \
     M(KeeperAliveConnections, "Number of alive connections") \
diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 65f8ecf7e89..c090d3accd4 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -51,6 +51,7 @@ FileCache::FileCache(const FileCacheSettings & settings)
     , bypass_cache_threshold(settings.enable_bypass_cache_with_threashold ? settings.bypass_cache_threashold : 0)
     , delayed_cleanup_interval_ms(settings.delayed_cleanup_interval_ms)
     , boundary_alignment(settings.boundary_alignment)
+    , background_download_threads(settings.background_download_threads)
     , log(&Poco::Logger::get("FileCache"))
     , metadata(settings.base_path)
 {
@@ -125,12 +126,10 @@ void FileCache::initialize()
 
     is_initialized = true;
 
-    size_t num_threads=2;
-    for (size_t i = 0; i < num_threads; ++i)
+    for (size_t i = 0; i < background_download_threads; ++i)
          download_threads.emplace_back([this] { metadata.downloadThreadFunc(); });
 
-    auto & schedule_pool = Context::getGlobalContextInstance()->getSchedulePool();
-    cleanup_task = schedule_pool.createTask("FileCacheCleanup", [this]{ cleanupThreadFunc(); });
+    cleanup_task = Context::getGlobalContextInstance()->getSchedulePool().createTask("FileCacheCleanup", [this]{ cleanupThreadFunc(); });
     cleanup_task->activate();
     cleanup_task->scheduleAfter(delayed_cleanup_interval_ms);
 }
@@ -644,27 +643,14 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
 
         if (releasable)
         {
-            auto segment = segment_metadata->file_segment;
-            if (segment->state() == FileSegment::State::DOWNLOADED)
-            {
-                const auto & key = segment->key();
+            const auto & key = segment_metadata->file_segment->key();
+            auto it = to_delete.find(key);
+            if (it == to_delete.end())
+                it = to_delete.emplace(key, locked_key.getKeyMetadata()).first;
+            it->second.add(segment_metadata);
 
-                auto it = to_delete.find(key);
-                if (it == to_delete.end())
-                    it = to_delete.emplace(key, locked_key.getKeyMetadata()).first;
-                it->second.add(segment_metadata);
-
-                freeable_space += segment_metadata->size();
-                freeable_count += 1;
-
-                return PriorityIterationResult::CONTINUE;
-            }
-
-            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedFileSegments);
-            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->getDownloadedSize(false));
-
-            locked_key.removeFileSegment(segment->offset(), segment->lock());
-            return PriorityIterationResult::REMOVE_AND_CONTINUE;
+            freeable_space += segment_metadata->size();
+            freeable_count += 1;
         }
         return PriorityIterationResult::CONTINUE;
     };
@@ -1005,10 +991,6 @@ void FileCache::cleanupThreadFunc()
 {
     try
     {
-#ifdef ABORT_ON_LOGICAL_ERROR
-        assertCacheCorrectness();
-#endif
-
         cleanup();
     }
     catch (...)
diff --git a/src/Interpreters/Cache/FileCache.h b/src/Interpreters/Cache/FileCache.h
index ed693b475ec..931cecf607b 100644
--- a/src/Interpreters/Cache/FileCache.h
+++ b/src/Interpreters/Cache/FileCache.h
@@ -135,6 +135,7 @@ private:
     const size_t bypass_cache_threshold = 0;
     const size_t delayed_cleanup_interval_ms;
     const size_t boundary_alignment;
+    const size_t background_download_threads;
 
     Poco::Logger * log;
 
diff --git a/src/Interpreters/Cache/FileCacheSettings.cpp b/src/Interpreters/Cache/FileCacheSettings.cpp
index d41aa8ffcb9..bc6e641c869 100644
--- a/src/Interpreters/Cache/FileCacheSettings.cpp
+++ b/src/Interpreters/Cache/FileCacheSettings.cpp
@@ -49,6 +49,9 @@ void FileCacheSettings::loadFromConfig(const Poco::Util::AbstractConfiguration &
     if (config.has(config_prefix + ".boundary_alignment"))
         boundary_alignment = parseWithSizeSuffix<uint64_t>(config.getString(config_prefix + ".boundary_alignment"));
 
+    if (config.has(config_prefix + ".background_download_threads"))
+        background_download_threads = config.getUInt(config_prefix + ".background_download_threads");
+
     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..fcc5c02c52e 100644
--- a/src/Interpreters/Cache/FileCacheSettings.h
+++ b/src/Interpreters/Cache/FileCacheSettings.h
@@ -28,7 +28,8 @@ struct FileCacheSettings
     size_t bypass_cache_threashold = FILECACHE_BYPASS_THRESHOLD;
     size_t delayed_cleanup_interval_ms = FILECACHE_DELAYED_CLEANUP_INTERVAL_MS;
 
-    size_t boundary_alignment = DBMS_DEFAULT_BUFFER_SIZE;
+    size_t boundary_alignment = FILECACHE_DEFAULT_MIN_FILE_SEGMENT_SIZE;
+    size_t background_download_threads = FILECACHE_DEFAULT_BACKGROUND_DOWNLOAD_THREADS;
 
     void loadFromConfig(const Poco::Util::AbstractConfiguration & config, const std::string & config_prefix);
 };
diff --git a/src/Interpreters/Cache/FileCache_fwd.h b/src/Interpreters/Cache/FileCache_fwd.h
index c791d08ed4f..902a6ff42d0 100644
--- a/src/Interpreters/Cache/FileCache_fwd.h
+++ b/src/Interpreters/Cache/FileCache_fwd.h
@@ -6,6 +6,7 @@ namespace DB
 
 static constexpr int FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE = 32 * 1024 * 1024; /// 32Mi
 static constexpr int FILECACHE_DEFAULT_MIN_FILE_SEGMENT_SIZE = 4 * 1024 * 1024; /// 4Mi
+static constexpr int FILECACHE_DEFAULT_BACKGROUND_DOWNLOAD_THREADS = 2;
 static constexpr int FILECACHE_DEFAULT_MAX_ELEMENTS = 10000000;
 static constexpr int FILECACHE_DEFAULT_HITS_THRESHOLD = 0;
 static constexpr size_t FILECACHE_BYPASS_THRESHOLD = 256 * 1024 * 1024;
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index f95379ba07f..5dd35a720c1 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -282,8 +282,11 @@ void FileSegment::resetRemoteFileReader()
 
 FileSegment::RemoteFileReaderPtr FileSegment::extractRemoteFileReader()
 {
-    if (download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
+    if (isCompleted(false)
+        || download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
+    {
         return std::move(remote_file_reader);
+    }
     return nullptr;
 }
 
@@ -598,7 +601,6 @@ void FileSegment::complete()
 
     auto remove_from_cache = [&, this]()
     {
-        LOG_TEST(log, "Remove file segment {} (nothing downloaded)", range().toString());
         locked_key->removeFileSegment(offset(), segment_lock);
         setDetachedState(segment_lock);
     };
@@ -625,6 +627,12 @@ void FileSegment::complete()
             chassert(!is_last_holder);
             break;
         }
+        case State::EMPTY:
+        {
+            if (is_last_holder)
+                remove_from_cache();
+            break;
+        }
         case State::PARTIALLY_DOWNLOADED:
         {
             if (is_last_holder)
@@ -637,12 +645,6 @@ void FileSegment::complete()
             }
             break;
         }
-        case State::EMPTY:
-        {
-            if (is_last_holder)
-                remove_from_cache();
-            break;
-        }
         case State::PARTIALLY_DOWNLOADED_NO_CONTINUATION:
         {
             chassert(current_downloaded_size != range().size());
@@ -653,7 +655,7 @@ void FileSegment::complete()
                 {
                     remove_from_cache();
                 }
-                else if (download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
+                else
                 {
                     LOG_TEST(log, "Resize file segment {} to downloaded: {}", range().toString(), current_downloaded_size);
 
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 2a3803eb3d7..c3f428c3e08 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -1,11 +1,17 @@
 #include <Interpreters/Cache/Metadata.h>
 #include <Interpreters/Cache/FileCache.h>
 #include <Interpreters/Cache/FileSegment.h>
+#include "Common/Exception.h"
 #include <Common/logger_useful.h>
 #include <filesystem>
 
 namespace fs = std::filesystem;
 
+namespace CurrentMetrics
+{
+    extern const Metric FilesystemCacheDownloadQueueElements;
+}
+
 namespace DB
 {
 
@@ -256,6 +262,7 @@ void CacheMetadata::doCleanup()
             continue;
         }
 
+        chassert(it->second->empty());
         locked_metadata->markAsRemoved();
         erase(it);
         LOG_DEBUG(log, "Key {} is removed from metadata", cleanup_key);
@@ -306,6 +313,8 @@ public:
             std::lock_guard lock(mutex);
             queue.push(file_segment);
         }
+
+        CurrentMetrics::add(CurrentMetrics::FilesystemCacheDownloadQueueElements);
         cv.notify_one();
     }
 
@@ -324,10 +333,10 @@ private:
 
 void CacheMetadata::downloadThreadFunc()
 {
-    std::optional<Memory<>> memory;
     while (true)
     {
         std::weak_ptr<FileSegment> file_segment_weak;
+
         {
             std::unique_lock lock(download_queue->mutex);
 
@@ -344,67 +353,106 @@ void CacheMetadata::downloadThreadFunc()
             download_queue->queue.pop();
         }
 
+        CurrentMetrics::sub(CurrentMetrics::FilesystemCacheDownloadQueueElements);
+
         FileSegmentsHolderPtr holder;
+        try
         {
-            auto file_segment = file_segment_weak.lock();
-            if (!file_segment
-                || file_segment->state() != FileSegment::State::PARTIALLY_DOWNLOADED)
-                continue;
-
-            auto lock = lockKeyMetadata(file_segment->key(), KeyNotFoundPolicy::RETURN_NULL);
-            if (!lock)
-                continue;
-
-            holder = std::make_unique<FileSegmentsHolder>(FileSegments{file_segment});
-        }
-
-        auto & file_segment = holder->front();
-        chassert(file_segment.assertCorrectness());
-
-        if (file_segment.getOrSetDownloader() != FileSegment::getCallerId())
-            continue;
-
-        LOG_TRACE(log, "Downloading file segment: {}", file_segment.getInfoForLog());
-
-        auto reader = file_segment.getRemoteFileReader();
-
-        /// If remote_fs_read_method == 'threadpool',
-        /// reader iteself does not allocate the buffer, but uses the buffer passed to it.
-        /// So will need to allocate a buffer here as well.
-        if (reader->buffer().begin() == nullptr)
-        {
-            if (!memory)
-                memory.emplace(DBMS_DEFAULT_BUFFER_SIZE);
-            reader->set(memory->data(), memory->size());
-        }
-
-        size_t offset = file_segment.getCurrentWriteOffset(false);
-        while (!reader->eof())
-        {
-            auto size = reader->available();
-
-            if (!file_segment.reserve(size))
-                return;
-
-            try
             {
-                file_segment.write(reader->position(), size, offset);
-                offset += size;
-            }
-            catch (ErrnoException & e)
-            {
-                int code = e.getErrno();
-                if (code == /* No space left on device */28 || code == /* Quota exceeded */122)
-                {
-                    LOG_INFO(log, "Insert into cache is skipped due to insufficient disk space. ({})", e.displayText());
+                auto file_segment = file_segment_weak.lock();
+                if (!file_segment
+                    || file_segment->state() != FileSegment::State::PARTIALLY_DOWNLOADED)
                     continue;
-                }
-                throw;
+
+                auto lock = lockKeyMetadata(file_segment->key(), KeyNotFoundPolicy::RETURN_NULL);
+                if (!lock)
+                    continue;
+
+                holder = std::make_unique<FileSegmentsHolder>(FileSegments{file_segment});
+            }
+
+            downloadImpl(holder->front());
+        }
+        catch (...)
+        {
+            if (holder)
+            {
+                const auto & file_segment = holder->front();
+                LOG_ERROR(
+                    log, "Error during background download of {}:{} ({}): {}",
+                    file_segment.key(), file_segment.offset(),
+                    file_segment.getInfoForLog(), getCurrentExceptionMessage(true));
+            }
+            else
+            {
+                tryLogCurrentException(__PRETTY_FUNCTION__);
+                chassert(false);
             }
         }
     }
 }
 
+void CacheMetadata::downloadImpl(FileSegment & file_segment)
+{
+    chassert(file_segment.assertCorrectness());
+
+    if (file_segment.getOrSetDownloader() != FileSegment::getCallerId())
+        return;
+
+    LOG_TEST(
+        log, "Downloading {} bytes for file segment {}",
+        file_segment.range().size() - file_segment.getDownloadedSize(false), file_segment.getInfoForLog());
+
+    auto reader = file_segment.getRemoteFileReader();
+
+    /// If remote_fs_read_method == 'threadpool',
+    /// reader iteself bever owns/allocates the buffer.
+    std::optional<Memory<>> memory;
+    if (reader->internalBuffer().empty())
+    {
+        memory.emplace(DBMS_DEFAULT_BUFFER_SIZE);
+        reader->set(memory->data(), memory->size());
+    }
+
+    size_t offset = file_segment.getCurrentWriteOffset(false);
+    if (offset != static_cast<size_t>(reader->getPosition()))
+        reader->seek(offset, SEEK_SET);
+
+    while (!reader->eof())
+    {
+        auto size = reader->available();
+
+        if (!file_segment.reserve(size))
+        {
+            LOG_TEST(
+                log, "Failed to reserve space during background download "
+                "for {}:{} (downloaded size: {}/{})",
+                file_segment.key(), file_segment.offset(),
+                file_segment.getDownloadedSize(false), file_segment.range().size());
+            return;
+        }
+
+        try
+        {
+            file_segment.write(reader->position(), size, offset);
+            offset += size;
+            reader->position() += size;
+        }
+        catch (ErrnoException & e)
+        {
+            int code = e.getErrno();
+            if (code == /* No space left on device */28 || code == /* Quota exceeded */122)
+            {
+                LOG_INFO(log, "Insert into cache is skipped due to insufficient disk space. ({})", e.displayText());
+                return;
+            }
+            throw;
+        }
+    }
+
+    LOG_TEST(log, "Downloaded file segment: {}", file_segment.getInfoForLog());
+}
+
 void CacheMetadata::cancelDownload()
 {
     download_queue->cancel();
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index f96243c3f1f..7e8fdef6641 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -125,6 +125,8 @@ private:
     const CleanupQueuePtr cleanup_queue;
     const DownloadQueuePtr download_queue;
     Poco::Logger * log;
+
+    void downloadImpl(FileSegment & file_segment);
 };
 
 
diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.reference b/tests/queries/0_stateless/02789_filesystem_cache_alignment.reference
new file mode 100644
index 00000000000..70e1fca6a65
--- /dev/null
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.reference
@@ -0,0 +1,7 @@
+0
+OK
+OK
+0
+0
+OK
+OK
diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
new file mode 100755
index 00000000000..a8bb4440a4c
--- /dev/null
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, no-parallel
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT -nm -q "
+DROP TABLE IF EXISTS test;
+CREATE TABLE test (a Int32, b String)
+ENGINE = MergeTree()
+ORDER BY a
+SETTINGS disk = disk(type = cache,
+                     max_size = '1Gi',
+                     max_file_segment_size = '40Mi',
+                     boundary_alignment = '20Mi',
+                     path = '$CLICKHOUSE_TEST_UNIQUE_NAME',
+                     disk = 's3disk');
+
+INSERT INTO test SELECT number, randomString(100) FROM numbers(1000000);
+"
+
+QUERY_ID=$RANDOM
+$CLICKHOUSE_CLIENT --query_id "$QUERY_ID" -nm -q "
+SET enable_filesystem_cache_log = 1;
+SYSTEM DROP FILESYSTEM CACHE;
+SELECT * FROM test WHERE NOT ignore() LIMIT 1 FORMAT Null;
+SYSTEM FLUSH LOGS;
+"
+
+query="
+SELECT cache_path, file_size,
+    tupleElement(file_segment_range, 2) - tupleElement(file_segment_range, 1) + 1 as file_segment_size,
+    formatReadableSize(file_size) as formatted_file_size,
+    formatReadableSize(file_segment_size) as formatted_file_segment_size,
+    tupleElement(file_segment_range, 2) as end_offset
+FROM (
+    SELECT arrayJoin(cache_paths) AS cache_path,
+           local_path,
+           remote_path,
+           size as file_size
+    FROM system.remote_data_paths
+    WHERE endsWith(local_path, '.bin')
+) AS data_paths
+INNER JOIN system.filesystem_cache_log AS cache_log
+ON data_paths.remote_path = cache_log.source_file_path
+WHERE query_id = '$QUERY_ID' "
+
+# File segments cannot be less that 20Mi,
+# except for last file segment in a file or if file size is less.
+$CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query)
+WHERE file_segment_size < file_size
+AND end_offset + 1 != file_size
+AND file_segment_size < 20 * 1024 * 1024;
+"
+
+all=$($CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query)
+WHERE file_segment_size < file_size AND end_offset + 1 != file_size;
+")
+#echo $all
+
+if [ "$all" -gt "10" ]; then
+  echo "OK"
+else
+  echo "FAIL"
+fi
+
+count=$($CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query)
+WHERE file_segment_size < file_size
+AND end_offset + 1 != file_size
+AND formatted_file_segment_size in ('20.00 MiB', '40.00 MiB')
+")
+
+if [ "$count" = "$all" ]; then
+  echo "OK"
+else
+  echo "FAIL"
+fi
+
+query2="
+SELECT *
+FROM (SELECT * FROM ($query)) AS cache_log
+INNER JOIN system.filesystem_cache AS cache
+ON cache_log.cache_path = cache.cache_path "
+
+$CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query2)
+WHERE file_segment_range_begin - file_segment_range_end + 1 < file_size
+AND file_segment_range_end + 1 != file_size
+AND downloaded_size < 20 * 1024 * 1024;
+"
+
+$CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query2)
+WHERE file_segment_range_begin - file_segment_range_end + 1 < file_size
+AND file_segment_range_end + 1 != file_size
+AND formatReadableSize(downloaded_size) not in ('20.00 MiB', '40.00 MiB');
+"
+
+all=$($CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query2)
+WHERE file_segment_size < file_size AND file_segment_range_end + 1 != file_size;
+")
+
+if [ "$all" -gt "10" ]; then
+  echo "OK"
+else
+  echo "FAIL"
+fi
+
+count2=$($CLICKHOUSE_CLIENT -nm -q "
+SELECT count() FROM ($query2)
+WHERE file_segment_range_begin - file_segment_range_end + 1 < file_size
+AND file_segment_range_end + 1 != file_size
+AND formatReadableSize(downloaded_size) in ('20.00 MiB', '40.00 MiB');
+")
+
+if [ "$count2" = "$all" ]; then
+  echo "OK"
+else
+  echo "FAIL"
+fi

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 0886/1478] 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 0887/1478] 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 0888/1478] 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 d0d39c8f6142cf2b954b3125eca4491f82718524 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Wed, 14 Jun 2023 18:10:30 +0000
Subject: [PATCH 0889/1478] Trying to fix a test.

---
 src/Interpreters/ActionsVisitor.cpp           | 29 ++++++-
 .../InterpreterSelectQueryAnalyzer.h          |  2 +
 src/Interpreters/interpretSubquery.cpp        | 85 ++++++++++++-------
 src/Interpreters/interpretSubquery.h          |  5 ++
 src/Planner/CollectSets.cpp                   |  1 +
 5 files changed, 87 insertions(+), 35 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 59bbc74ca3a..34c3dab8926 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -3,7 +3,8 @@
 #include <Common/quoteString.h>
 #include <Common/typeid_cast.h>
 #include <Common/FieldVisitorsAccurateComparison.h>
-#include "Parsers/queryToString.h"
+#include <Analyzer/QueryNode.h>
+#include <Parsers/queryToString.h>
 
 #include <Core/ColumnNumbers.h>
 #include <Core/ColumnWithTypeAndName.h>
@@ -55,6 +56,7 @@
 #include <Interpreters/interpretSubquery.h>
 #include <Interpreters/DatabaseAndTableWithAlias.h>
 #include <Interpreters/IdentifierSemantic.h>
+#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <Functions/UserDefined/UserDefinedExecutableFunctionFactory.h>
 #include <Parsers/QueryParameterVisitor.h>
 
@@ -1394,7 +1396,18 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         if (no_subqueries)
             return {};
         //std::cerr << queryToString(right_in_operand) << std::endl;
-        auto set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
+        PreparedSetKey set_key;
+        if (data.getContext()->getSettingsRef().allow_experimental_analyzer)
+        {
+            InterpreterSelectQueryAnalyzer interpreter(right_in_operand, data.getContext(), SelectQueryOptions().analyze(true).subquery());
+            auto query_tree = interpreter.getQueryTree();
+            if (auto * query_node = query_tree->as<QueryNode>())
+                query_node->setIsSubquery(true);
+            // std::cerr << "============== " << interpreter.getQueryTree()->dumpTree() << std::endl;
+            set_key = PreparedSetKey::forSubquery(interpreter.getQueryTree()->getTreeHash());
+        }
+        else
+            set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
 
         // std::cerr << set_key.toString() << std::endl;
         // std::cerr << data.prepared_sets->getSets().size() << std::endl;
@@ -1446,8 +1459,16 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
           * Also it doesn't make sense if it is GLOBAL IN or ordinary IN.
           */
         {
-            auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
-            subquery_for_set.createSource(*interpreter);
+            if (data.getContext()->getSettingsRef().allow_experimental_analyzer)
+            {
+                auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth);
+                subquery_for_set.source = std::make_unique<QueryPlan>(std::move(*interpreter).extractQueryPlan());
+            }
+            else
+            {
+                auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
+                subquery_for_set.createSource(*interpreter);
+            }
         }
 
         return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), data.getContext()->getSettingsRef(), std::move(external_table_set));
diff --git a/src/Interpreters/InterpreterSelectQueryAnalyzer.h b/src/Interpreters/InterpreterSelectQueryAnalyzer.h
index 1e0ac737536..4434fabe746 100644
--- a/src/Interpreters/InterpreterSelectQueryAnalyzer.h
+++ b/src/Interpreters/InterpreterSelectQueryAnalyzer.h
@@ -69,6 +69,8 @@ public:
     const Planner & getPlanner() const { return planner; }
     Planner & getPlanner() { return planner; }
 
+    const QueryTreeNodePtr & getQueryTree() const { return query_tree; }
+
 private:
     ASTPtr query;
     ContextMutablePtr context;
diff --git a/src/Interpreters/interpretSubquery.cpp b/src/Interpreters/interpretSubquery.cpp
index 5f00be07fa5..b757127a14d 100644
--- a/src/Interpreters/interpretSubquery.cpp
+++ b/src/Interpreters/interpretSubquery.cpp
@@ -1,4 +1,5 @@
 #include <Common/typeid_cast.h>
+#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <IO/WriteHelpers.h>
 
 #include <Storages/IStorage.h>
@@ -21,37 +22,10 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns)
+static ASTPtr buildQueryAST(const ASTPtr & table_expression, const ContextPtr & context, SelectQueryOptions & subquery_options);
+
+static ContextPtr getSubqueryContext(const ContextPtr & context)
 {
-    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth);
-    return interpretSubquery(table_expression, context, required_source_columns, subquery_options);
-}
-
-std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, const Names & required_source_columns, const SelectQueryOptions & options)
-{
-    if (auto * expr = table_expression->as<ASTTableExpression>())
-    {
-        ASTPtr table;
-        if (expr->subquery)
-            table = expr->subquery;
-        else if (expr->table_function)
-            table = expr->table_function;
-        else if (expr->database_and_table_name)
-            table = expr->database_and_table_name;
-
-        return interpretSubquery(table, context, required_source_columns, options);
-    }
-
-    /// Subquery or table name. The name of the table is similar to the subquery `SELECT * FROM t`.
-    const auto * subquery = table_expression->as<ASTSubquery>();
-    const auto * function = table_expression->as<ASTFunction>();
-    const auto * table = table_expression->as<ASTTableIdentifier>();
-
-    if (!subquery && !table && !function)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Table expression is undefined, Method: ExpressionAnalyzer::interpretSubquery.");
-
     /** The subquery in the IN / JOIN section does not have any restrictions on the maximum size of the result.
       * Because the result of this query is not the result of the entire query.
       * Constraints work instead
@@ -67,7 +41,56 @@ std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
     subquery_settings.extremes = false;
     subquery_context->setSettings(subquery_settings);
 
+    return subquery_context;
+}
+
+std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns)
+{
+    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth);
+    return interpretSubquery(table_expression, context, required_source_columns, subquery_options);
+}
+
+std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, const Names & required_source_columns, const SelectQueryOptions & options)
+{
     auto subquery_options = options.subquery();
+    auto query = buildQueryAST(table_expression, context, subquery_options);
+    auto subquery_context = getSubqueryContext(context);
+    return std::make_shared<InterpreterSelectWithUnionQuery>(query, subquery_context, subquery_options, required_source_columns);
+}
+
+std::shared_ptr<InterpreterSelectQueryAnalyzer> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth)
+{
+    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth).subquery();
+    auto query = buildQueryAST(table_expression, context, subquery_options);
+    auto subquery_context = getSubqueryContext(context);
+    return std::make_shared<InterpreterSelectQueryAnalyzer>(query, subquery_context, subquery_options);
+}
+
+static ASTPtr buildQueryAST(const ASTPtr & table_expression, const ContextPtr & context, SelectQueryOptions & subquery_options)
+{
+    if (auto * expr = table_expression->as<ASTTableExpression>())
+    {
+        ASTPtr table;
+        if (expr->subquery)
+            table = expr->subquery;
+        else if (expr->table_function)
+            table = expr->table_function;
+        else if (expr->database_and_table_name)
+            table = expr->database_and_table_name;
+
+        return buildQueryAST(table, context, subquery_options);
+    }
+
+    /// Subquery or table name. The name of the table is similar to the subquery `SELECT * FROM t`.
+    const auto * subquery = table_expression->as<ASTSubquery>();
+    const auto * function = table_expression->as<ASTFunction>();
+    const auto * table = table_expression->as<ASTTableIdentifier>();
+
+    if (!subquery && !table && !function)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Table expression is undefined, Method: ExpressionAnalyzer::interpretSubquery.");
 
     ASTPtr query;
     if (table || function)
@@ -112,7 +135,7 @@ std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
         subquery_options.removeDuplicates();
     }
 
-    return std::make_shared<InterpreterSelectWithUnionQuery>(query, subquery_context, subquery_options, required_source_columns);
+    return query;
 }
 
 }
diff --git a/src/Interpreters/interpretSubquery.h b/src/Interpreters/interpretSubquery.h
index 3836d1f7664..02d2003ea5f 100644
--- a/src/Interpreters/interpretSubquery.h
+++ b/src/Interpreters/interpretSubquery.h
@@ -6,6 +6,11 @@
 namespace DB
 {
 
+class InterpreterSelectQueryAnalyzer;
+
+std::shared_ptr<InterpreterSelectQueryAnalyzer> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth);
+
 std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
     const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns);
 
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 68ad1ab78d3..90f3f074761 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -93,6 +93,7 @@ public:
             in_second_argument_node_type == QueryTreeNodeType::UNION ||
             in_second_argument_node_type == QueryTreeNodeType::TABLE)
         {
+            // std::cerr << "======2======= " << in_second_argument->dumpTree() << std::endl;
             auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
             if (sets.getFuture(set_key))
                 return;

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 0890/1478] 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 0891/1478] 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 0892/1478] 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 0aa363f5254455ea3a351c9fcc9adc7c99701c53 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 23:13:09 +0200
Subject: [PATCH 0893/1478] Fix style check

---
 src/Interpreters/Cache/Metadata.cpp                           | 2 +-
 tests/queries/0_stateless/02789_filesystem_cache_alignment.sh | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index c3f428c3e08..b0009c6abc1 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -406,7 +406,7 @@ void CacheMetadata::downloadImpl(FileSegment & file_segment)
     auto reader = file_segment.getRemoteFileReader();
 
     /// If remote_fs_read_method == 'threadpool',
-    /// reader iteself bever owns/allocates the buffer.
+    /// reader itself never owns/allocates the buffer.
     std::optional<Memory<>> memory;
     if (reader->internalBuffer().empty())
     {
diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
index a8bb4440a4c..ca459153c03 100755
--- a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
@@ -15,7 +15,7 @@ SETTINGS disk = disk(type = cache,
                      max_file_segment_size = '40Mi',
                      boundary_alignment = '20Mi',
                      path = '$CLICKHOUSE_TEST_UNIQUE_NAME',
-                     disk = 's3disk');
+                     disk = 's3_disk');
 
 INSERT INTO test SELECT number, randomString(100) FROM numbers(1000000);
 "

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 0894/1478] 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 8c610275c2e271cd3a506d207fd9cef938fcd258 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 23:30:21 +0200
Subject: [PATCH 0895/1478] Review fixes

---
 src/Interpreters/Cache/FileCache.cpp       |  1 -
 src/Interpreters/Cache/FileCacheSettings.h |  2 +-
 src/Interpreters/Cache/FileCache_fwd.h     |  2 +-
 src/Interpreters/Cache/Metadata.cpp        | 17 ++++++++++-------
 src/Interpreters/Cache/Metadata.h          |  2 +-
 5 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index c090d3accd4..3b5ae9acb1b 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -1014,7 +1014,6 @@ FileSegmentsHolderPtr FileCache::getSnapshot()
     {
         for (const auto & [_, file_segment_metadata] : locked_key)
             file_segments.push_back(FileSegment::getSnapshot(file_segment_metadata->file_segment));
-        return true;
     });
     return std::make_unique<FileSegmentsHolder>(std::move(file_segments), /* complete_on_dtor */false);
 }
diff --git a/src/Interpreters/Cache/FileCacheSettings.h b/src/Interpreters/Cache/FileCacheSettings.h
index fcc5c02c52e..6820aff61e3 100644
--- a/src/Interpreters/Cache/FileCacheSettings.h
+++ b/src/Interpreters/Cache/FileCacheSettings.h
@@ -28,7 +28,7 @@ struct FileCacheSettings
     size_t bypass_cache_threashold = FILECACHE_BYPASS_THRESHOLD;
     size_t delayed_cleanup_interval_ms = FILECACHE_DELAYED_CLEANUP_INTERVAL_MS;
 
-    size_t boundary_alignment = FILECACHE_DEFAULT_MIN_FILE_SEGMENT_SIZE;
+    size_t boundary_alignment = FILECACHE_DEFAULT_FILE_SEGMENT_ALIGNMENT;
     size_t background_download_threads = FILECACHE_DEFAULT_BACKGROUND_DOWNLOAD_THREADS;
 
     void loadFromConfig(const Poco::Util::AbstractConfiguration & config, const std::string & config_prefix);
diff --git a/src/Interpreters/Cache/FileCache_fwd.h b/src/Interpreters/Cache/FileCache_fwd.h
index 902a6ff42d0..4d4a1c1429c 100644
--- a/src/Interpreters/Cache/FileCache_fwd.h
+++ b/src/Interpreters/Cache/FileCache_fwd.h
@@ -5,7 +5,7 @@ namespace DB
 {
 
 static constexpr int FILECACHE_DEFAULT_MAX_FILE_SEGMENT_SIZE = 32 * 1024 * 1024; /// 32Mi
-static constexpr int FILECACHE_DEFAULT_MIN_FILE_SEGMENT_SIZE = 4 * 1024 * 1024; /// 4Mi
+static constexpr int FILECACHE_DEFAULT_FILE_SEGMENT_ALIGNMENT = 4 * 1024 * 1024; /// 4Mi
 static constexpr int FILECACHE_DEFAULT_BACKGROUND_DOWNLOAD_THREADS = 2;
 static constexpr int FILECACHE_DEFAULT_MAX_ELEMENTS = 10000000;
 static constexpr int FILECACHE_DEFAULT_HITS_THRESHOLD = 0;
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index b0009c6abc1..f94b8ae4db2 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -321,8 +321,11 @@ public:
 private:
     void cancel()
     {
-        std::lock_guard lock(mutex);
-        cancelled = true;
+        {
+            std::lock_guard lock(mutex);
+            cancelled = true;
+        }
+        cv.notify_all();
     }
 
     std::mutex mutex;
@@ -333,6 +336,7 @@ private:
 
 void CacheMetadata::downloadThreadFunc()
 {
+    std::optional<Memory<>> memory;
     while (true)
     {
         std::weak_ptr<FileSegment> file_segment_weak;
@@ -371,7 +375,7 @@ void CacheMetadata::downloadThreadFunc()
                 holder = std::make_unique<FileSegmentsHolder>(FileSegments{file_segment});
             }
 
-            downloadImpl(holder->front());
+            downloadImpl(holder->front(), memory);
         }
         catch (...)
         {
@@ -392,7 +396,7 @@ void CacheMetadata::downloadThreadFunc()
     }
 }
 
-void CacheMetadata::downloadImpl(FileSegment & file_segment)
+void CacheMetadata::downloadImpl(FileSegment & file_segment, std::optional<Memory<>> & memory)
 {
     chassert(file_segment.assertCorrectness());
 
@@ -407,10 +411,10 @@ void CacheMetadata::downloadImpl(FileSegment & file_segment)
 
     /// If remote_fs_read_method == 'threadpool',
     /// reader itself never owns/allocates the buffer.
-    std::optional<Memory<>> memory;
     if (reader->internalBuffer().empty())
     {
-        memory.emplace(DBMS_DEFAULT_BUFFER_SIZE);
+        if (!memory)
+            memory.emplace(DBMS_DEFAULT_BUFFER_SIZE);
         reader->set(memory->data(), memory->size());
     }
 
@@ -456,7 +460,6 @@ void CacheMetadata::downloadImpl(FileSegment & file_segment)
 void CacheMetadata::cancelDownload()
 {
     download_queue->cancel();
-    download_queue->cv.notify_all();
 }
 
 LockedKey::LockedKey(std::shared_ptr<KeyMetadata> key_metadata_)
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 7e8fdef6641..f9f7dfccaa5 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -126,7 +126,7 @@ private:
     const DownloadQueuePtr download_queue;
     Poco::Logger * log;
 
-    void downloadImpl(FileSegment & file_segment);
+    void downloadImpl(FileSegment & file_segment, std::optional<Memory<>> & memory);
 };
 
 

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 0896/1478] 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 0897/1478] 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 0898/1478] 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 0899/1478] 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 0900/1478] 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 0901/1478] 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 0902/1478] 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 0903/1478] 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 0904/1478] 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 0905/1478] 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 0906/1478] 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 0907/1478] 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 0023bf69cbaf2ec756bca883e3bb6e9338e574de Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 15 Jun 2023 12:22:50 +0200
Subject: [PATCH 0908/1478] Fix

---
 src/Interpreters/Cache/FileSegment.cpp        | 18 ++++++++++---
 src/Interpreters/Cache/Metadata.cpp           |  3 +++
 .../InterpreterDescribeCacheQuery.cpp         | 27 ++++++++++++-------
 .../02344_describe_cache.reference            |  4 +--
 4 files changed, 37 insertions(+), 15 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 5dd35a720c1..4cc5e4307ad 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -635,13 +635,23 @@ void FileSegment::complete()
         }
         case State::PARTIALLY_DOWNLOADED:
         {
+            chassert(current_downloaded_size > 0);
+
             if (is_last_holder)
             {
-                LOG_TEST(
-                    log, "Submitted file segment for background download "
-                    "(having {}/{})", downloaded_size, range().size());
+                if (remote_file_reader)
+                {
+                    LOG_TEST(
+                        log, "Submitting file segment for background download "
+                        "(having {}/{})", downloaded_size, range().size());
 
-                locked_key->addToDownloadQueue(offset(), segment_lock); /// Finish download in background.
+                    locked_key->addToDownloadQueue(offset(), segment_lock); /// Finish download in background.
+                }
+                else
+                {
+                    locked_key->shrinkFileSegmentToDownloadedSize(offset(), segment_lock);
+                    setDetachedState(segment_lock); /// See comment below.
+                }
             }
             break;
         }
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index f94b8ae4db2..fd590315ab1 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -403,6 +403,9 @@ void CacheMetadata::downloadImpl(FileSegment & file_segment, std::optional<Memor
     if (file_segment.getOrSetDownloader() != FileSegment::getCallerId())
         return;
 
+    if (file_segment.getDownloadedSize(false) == file_segment.range().size())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "File segment is already fully downloaded");
+
     LOG_TEST(
         log, "Downloading {} bytes for file segment {}",
         file_segment.range().size() - file_segment.getDownloadedSize(false), file_segment.getInfoForLog());
diff --git a/src/Interpreters/InterpreterDescribeCacheQuery.cpp b/src/Interpreters/InterpreterDescribeCacheQuery.cpp
index ca875ee57b2..1c69e8db451 100644
--- a/src/Interpreters/InterpreterDescribeCacheQuery.cpp
+++ b/src/Interpreters/InterpreterDescribeCacheQuery.cpp
@@ -19,12 +19,16 @@ static Block getSampleBlock()
         ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "max_size"},
         ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "max_elements"},
         ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "max_file_segment_size"},
+        ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "boundary_alignment"},
         ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt8>>(), "cache_on_write_operations"},
         ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt8>>(), "cache_hits_threshold"},
         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"},
+        ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt64>>(), "delayed_cleanup_interval_ms"},
+        ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt64>>(), "background_download_threads"},
+        ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt64>>(), "enable_bypass_cache_with_threshold"},
     };
     return Block(columns);
 }
@@ -41,15 +45,20 @@ BlockIO InterpreterDescribeCacheQuery::execute()
     const auto & settings = cache_data.settings;
     const auto & cache = cache_data.cache;
 
-    res_columns[0]->insert(settings.max_size);
-    res_columns[1]->insert(settings.max_elements);
-    res_columns[2]->insert(settings.max_file_segment_size);
-    res_columns[3]->insert(settings.cache_on_write_operations);
-    res_columns[4]->insert(settings.cache_hits_threshold);
-    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);
+    size_t i = 0;
+    res_columns[i++]->insert(settings.max_size);
+    res_columns[i++]->insert(settings.max_elements);
+    res_columns[i++]->insert(settings.max_file_segment_size);
+    res_columns[i++]->insert(settings.boundary_alignment);
+    res_columns[i++]->insert(settings.cache_on_write_operations);
+    res_columns[i++]->insert(settings.cache_hits_threshold);
+    res_columns[i++]->insert(cache->getUsedCacheSize());
+    res_columns[i++]->insert(cache->getFileSegmentsNum());
+    res_columns[i++]->insert(cache->getBasePath());
+    res_columns[i++]->insert(settings.do_not_evict_index_and_mark_files);
+    res_columns[i++]->insert(settings.delayed_cleanup_interval_ms);
+    res_columns[i++]->insert(settings.background_download_threads);
+    res_columns[i++]->insert(settings.enable_bypass_cache_with_threashold);
 
     BlockIO res;
     size_t num_rows = res_columns[0]->size();
diff --git a/tests/queries/0_stateless/02344_describe_cache.reference b/tests/queries/0_stateless/02344_describe_cache.reference
index d8a2ffab1fa..7496f754937 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	33554432	4194304   1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0   0   60000   2   0
+134217728	10000000	104857600	4194304   0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0   0   60000   2   0

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 0909/1478] 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 0910/1478] 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 b8a4a784debcfb4e739b2368bc5611885ffa2a51 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 15 Jun 2023 14:22:13 +0200
Subject: [PATCH 0911/1478] Fix unit test, add check

---
 src/Interpreters/Cache/Metadata.cpp             | 8 ++++++++
 src/Interpreters/tests/gtest_lru_file_cache.cpp | 4 ++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index fd590315ab1..987361c0537 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -412,6 +412,14 @@ void CacheMetadata::downloadImpl(FileSegment & file_segment, std::optional<Memor
 
     auto reader = file_segment.getRemoteFileReader();
 
+    if (!reader)
+    {
+        throw Exception(
+            ErrorCodes::LOGICAL_ERROR, "No reader. "
+            "File segment should not have been submitted for background download ({})",
+            file_segment.getInfoForLog());
+    }
+
     /// If remote_fs_read_method == 'threadpool',
     /// reader itself never owns/allocates the buffer.
     if (reader->internalBuffer().empty())
diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index 8c8e715ce92..d8baf1c0b45 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -533,8 +533,8 @@ TEST_F(FileCacheTest, get)
                 cv.notify_one();
 
                 file_segment2.wait(file_segment2.range().left);
-                ASSERT_TRUE(file_segment2.state() == DB::FileSegment::State::PARTIALLY_DOWNLOADED);
-                ASSERT_TRUE(file_segment2.getOrSetDownloader() == DB::FileSegment::getCallerId());
+                ASSERT_EQ(file_segment2.state(), DB::FileSegment::State::EMPTY);
+                ASSERT_EQ(file_segment2.getOrSetDownloader(), DB::FileSegment::getCallerId());
                 download(file_segment2);
             });
 

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 0912/1478] 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 0913/1478] 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 0914/1478] 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 0915/1478] 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 0916/1478] 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 0917/1478] 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 0918/1478] 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 0919/1478] 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 0920/1478] 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 0921/1478] 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 0922/1478] 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 35b7474ccfe009c0a2612f55bbca436eba9218a7 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
Date: Thu, 15 Jun 2023 10:22:58 -0400
Subject: [PATCH 0923/1478] add MapState 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..79b1c2ae4db 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -468,6 +468,7 @@ MSan
 MVCC
 MacBook
 MacOS
+MapState
 MarkCacheBytes
 MarkCacheFiles
 MarksLoaderThreads

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 0924/1478] 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 d34b6e5f35280b916627359d01cbf7a4d07f447b Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 15 Jun 2023 16:27:51 +0000
Subject: [PATCH 0925/1478] Try to fix analyzer tests.

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

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 34c3dab8926..393a25463ca 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1397,7 +1397,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             return {};
         //std::cerr << queryToString(right_in_operand) << std::endl;
         PreparedSetKey set_key;
-        if (data.getContext()->getSettingsRef().allow_experimental_analyzer)
+        if (data.getContext()->getSettingsRef().allow_experimental_analyzer && !identifier)
         {
             InterpreterSelectQueryAnalyzer interpreter(right_in_operand, data.getContext(), SelectQueryOptions().analyze(true).subquery());
             auto query_tree = interpreter.getQueryTree();

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 0926/1478] 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 1cb7ba4895e0666eeba8654a45ec8c124b904864 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Thu, 15 Jun 2023 16:42:38 +0000
Subject: [PATCH 0927/1478] Revert "Trying to fix a test."

This reverts commit d0d39c8f6142cf2b954b3125eca4491f82718524.
---
 src/Interpreters/ActionsVisitor.cpp    | 21 +++----
 src/Interpreters/interpretSubquery.cpp | 85 ++++++++++----------------
 src/Interpreters/interpretSubquery.h   |  5 --
 src/Planner/CollectSets.cpp            |  1 -
 4 files changed, 38 insertions(+), 74 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 393a25463ca..4b38f8c9434 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -3,8 +3,6 @@
 #include <Common/quoteString.h>
 #include <Common/typeid_cast.h>
 #include <Common/FieldVisitorsAccurateComparison.h>
-#include <Analyzer/QueryNode.h>
-#include <Parsers/queryToString.h>
 
 #include <Core/ColumnNumbers.h>
 #include <Core/ColumnWithTypeAndName.h>
@@ -56,10 +54,12 @@
 #include <Interpreters/interpretSubquery.h>
 #include <Interpreters/DatabaseAndTableWithAlias.h>
 #include <Interpreters/IdentifierSemantic.h>
-#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <Functions/UserDefined/UserDefinedExecutableFunctionFactory.h>
 #include <Parsers/QueryParameterVisitor.h>
 
+#include <Analyzer/QueryNode.h>
+#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
+#include <Parsers/queryToString.h>
 
 namespace DB
 {
@@ -1396,6 +1396,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         if (no_subqueries)
             return {};
         //std::cerr << queryToString(right_in_operand) << std::endl;
+
         PreparedSetKey set_key;
         if (data.getContext()->getSettingsRef().allow_experimental_analyzer && !identifier)
         {
@@ -1404,7 +1405,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             if (auto * query_node = query_tree->as<QueryNode>())
                 query_node->setIsSubquery(true);
             // std::cerr << "============== " << interpreter.getQueryTree()->dumpTree() << std::endl;
-            set_key = PreparedSetKey::forSubquery(interpreter.getQueryTree()->getTreeHash());
+            set_key = PreparedSetKey::forSubquery(query_tree->getTreeHash());
         }
         else
             set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
@@ -1459,16 +1460,8 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
           * Also it doesn't make sense if it is GLOBAL IN or ordinary IN.
           */
         {
-            if (data.getContext()->getSettingsRef().allow_experimental_analyzer)
-            {
-                auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth);
-                subquery_for_set.source = std::make_unique<QueryPlan>(std::move(*interpreter).extractQueryPlan());
-            }
-            else
-            {
-                auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
-                subquery_for_set.createSource(*interpreter);
-            }
+            auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
+            subquery_for_set.createSource(*interpreter);
         }
 
         return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), data.getContext()->getSettingsRef(), std::move(external_table_set));
diff --git a/src/Interpreters/interpretSubquery.cpp b/src/Interpreters/interpretSubquery.cpp
index b757127a14d..5f00be07fa5 100644
--- a/src/Interpreters/interpretSubquery.cpp
+++ b/src/Interpreters/interpretSubquery.cpp
@@ -1,5 +1,4 @@
 #include <Common/typeid_cast.h>
-#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <IO/WriteHelpers.h>
 
 #include <Storages/IStorage.h>
@@ -22,10 +21,37 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-static ASTPtr buildQueryAST(const ASTPtr & table_expression, const ContextPtr & context, SelectQueryOptions & subquery_options);
-
-static ContextPtr getSubqueryContext(const ContextPtr & context)
+std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns)
 {
+    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth);
+    return interpretSubquery(table_expression, context, required_source_columns, subquery_options);
+}
+
+std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
+    const ASTPtr & table_expression, ContextPtr context, const Names & required_source_columns, const SelectQueryOptions & options)
+{
+    if (auto * expr = table_expression->as<ASTTableExpression>())
+    {
+        ASTPtr table;
+        if (expr->subquery)
+            table = expr->subquery;
+        else if (expr->table_function)
+            table = expr->table_function;
+        else if (expr->database_and_table_name)
+            table = expr->database_and_table_name;
+
+        return interpretSubquery(table, context, required_source_columns, options);
+    }
+
+    /// Subquery or table name. The name of the table is similar to the subquery `SELECT * FROM t`.
+    const auto * subquery = table_expression->as<ASTSubquery>();
+    const auto * function = table_expression->as<ASTFunction>();
+    const auto * table = table_expression->as<ASTTableIdentifier>();
+
+    if (!subquery && !table && !function)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Table expression is undefined, Method: ExpressionAnalyzer::interpretSubquery.");
+
     /** The subquery in the IN / JOIN section does not have any restrictions on the maximum size of the result.
       * Because the result of this query is not the result of the entire query.
       * Constraints work instead
@@ -41,56 +67,7 @@ static ContextPtr getSubqueryContext(const ContextPtr & context)
     subquery_settings.extremes = false;
     subquery_context->setSettings(subquery_settings);
 
-    return subquery_context;
-}
-
-std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns)
-{
-    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth);
-    return interpretSubquery(table_expression, context, required_source_columns, subquery_options);
-}
-
-std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, const Names & required_source_columns, const SelectQueryOptions & options)
-{
     auto subquery_options = options.subquery();
-    auto query = buildQueryAST(table_expression, context, subquery_options);
-    auto subquery_context = getSubqueryContext(context);
-    return std::make_shared<InterpreterSelectWithUnionQuery>(query, subquery_context, subquery_options, required_source_columns);
-}
-
-std::shared_ptr<InterpreterSelectQueryAnalyzer> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth)
-{
-    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth).subquery();
-    auto query = buildQueryAST(table_expression, context, subquery_options);
-    auto subquery_context = getSubqueryContext(context);
-    return std::make_shared<InterpreterSelectQueryAnalyzer>(query, subquery_context, subquery_options);
-}
-
-static ASTPtr buildQueryAST(const ASTPtr & table_expression, const ContextPtr & context, SelectQueryOptions & subquery_options)
-{
-    if (auto * expr = table_expression->as<ASTTableExpression>())
-    {
-        ASTPtr table;
-        if (expr->subquery)
-            table = expr->subquery;
-        else if (expr->table_function)
-            table = expr->table_function;
-        else if (expr->database_and_table_name)
-            table = expr->database_and_table_name;
-
-        return buildQueryAST(table, context, subquery_options);
-    }
-
-    /// Subquery or table name. The name of the table is similar to the subquery `SELECT * FROM t`.
-    const auto * subquery = table_expression->as<ASTSubquery>();
-    const auto * function = table_expression->as<ASTFunction>();
-    const auto * table = table_expression->as<ASTTableIdentifier>();
-
-    if (!subquery && !table && !function)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Table expression is undefined, Method: ExpressionAnalyzer::interpretSubquery.");
 
     ASTPtr query;
     if (table || function)
@@ -135,7 +112,7 @@ static ASTPtr buildQueryAST(const ASTPtr & table_expression, const ContextPtr &
         subquery_options.removeDuplicates();
     }
 
-    return query;
+    return std::make_shared<InterpreterSelectWithUnionQuery>(query, subquery_context, subquery_options, required_source_columns);
 }
 
 }
diff --git a/src/Interpreters/interpretSubquery.h b/src/Interpreters/interpretSubquery.h
index 02d2003ea5f..3836d1f7664 100644
--- a/src/Interpreters/interpretSubquery.h
+++ b/src/Interpreters/interpretSubquery.h
@@ -6,11 +6,6 @@
 namespace DB
 {
 
-class InterpreterSelectQueryAnalyzer;
-
-std::shared_ptr<InterpreterSelectQueryAnalyzer> interpretSubquery(
-    const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth);
-
 std::shared_ptr<InterpreterSelectWithUnionQuery> interpretSubquery(
     const ASTPtr & table_expression, ContextPtr context, size_t subquery_depth, const Names & required_source_columns);
 
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 90f3f074761..68ad1ab78d3 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -93,7 +93,6 @@ public:
             in_second_argument_node_type == QueryTreeNodeType::UNION ||
             in_second_argument_node_type == QueryTreeNodeType::TABLE)
         {
-            // std::cerr << "======2======= " << in_second_argument->dumpTree() << std::endl;
             auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
             if (sets.getFuture(set_key))
                 return;

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 0928/1478] 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 0929/1478] 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 0930/1478] 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 0931/1478] 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 0932/1478] 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 0933/1478] 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 0934/1478] 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 f610645c077b9f96257a8d9ce7ced71d3ac6cbba Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Fri, 16 Jun 2023 01:10:06 -0700
Subject: [PATCH 0935/1478] Move outfile checks before query starts running.

---
 src/Client/ClientBase.cpp | 103 ++++++++++++++++++++++++++------------
 1 file changed, 70 insertions(+), 33 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index b746d46148c..08e14f83982 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -103,6 +103,7 @@ namespace ErrorCodes
     extern const int UNRECOGNIZED_ARGUMENTS;
     extern const int LOGICAL_ERROR;
     extern const int CANNOT_OPEN_FILE;
+    extern const int FILE_ALREADY_EXISTS;
 }
 
 }
@@ -568,44 +569,12 @@ try
                 CompressionMethod compression_method = chooseCompressionMethod(out_file, compression_method_string);
                 UInt64 compression_level = 3;
 
-                if (query_with_output->is_outfile_append && query_with_output->is_outfile_truncate)
-                {
-                    throw Exception(
-                        ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot use INTO OUTFILE with APPEND and TRUNCATE simultaneously.");
-                }
-
-                if (query_with_output->is_outfile_append && compression_method != CompressionMethod::None)
-                {
-                    throw Exception(
-                        ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot append to compressed file. Please use uncompressed file or remove APPEND keyword.");
-                }
-
                 if (query_with_output->compression_level)
                 {
                     const auto & compression_level_node = query_with_output->compression_level->as<ASTLiteral &>();
-                    bool res = compression_level_node.value.tryGet<UInt64>(compression_level);
-                    auto range = getCompressionLevelRange(compression_method);
-
-                    if (!res || compression_level < range.first || compression_level > range.second)
-                        throw Exception(
-                            ErrorCodes::BAD_ARGUMENTS,
-                            "Invalid compression level, must be positive integer in range {}-{}",
-                            range.first,
-                            range.second);
+                    compression_level_node.value.tryGet<UInt64>(compression_level);
                 }
 
-                if (fs::exists(out_file))
-                {
-                    if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
-                    {
-                        throw Exception(
-                            ErrorCodes::CANNOT_OPEN_FILE,
-                            "File {} exists, consider using APPEND or TRUNCATE if appropriate.",
-                            out_file);
-                    }
-                }
                 auto flags = O_WRONLY | O_EXCL;
                 if (query_with_output->is_outfile_append)
                     flags |= O_APPEND;
@@ -891,6 +860,74 @@ void ClientBase::processOrdinaryQuery(const String & query_to_execute, ASTPtr pa
         }
     }
 
+    // Run some local checks to make sure queries into output file will work before sending to server.
+    try
+    {
+        if (const auto * query_with_output = dynamic_cast<const ASTQueryWithOutput *>(parsed_query.get()))
+        {
+            String out_file;
+            if (query_with_output->out_file)
+            {
+                const auto & out_file_node = query_with_output->out_file->as<ASTLiteral &>();
+                out_file = out_file_node.value.safeGet<std::string>();
+
+                std::string compression_method_string;
+
+                if (query_with_output->compression)
+                {
+                    const auto & compression_method_node = query_with_output->compression->as<ASTLiteral &>();
+                    compression_method_string = compression_method_node.value.safeGet<std::string>();
+                }
+
+                CompressionMethod compression_method = chooseCompressionMethod(out_file, compression_method_string);
+                UInt64 compression_level = 3;
+
+                if (query_with_output->is_outfile_append && query_with_output->is_outfile_truncate)
+                {
+                    throw Exception(
+                        ErrorCodes::BAD_ARGUMENTS,
+                        "Cannot use INTO OUTFILE with APPEND and TRUNCATE simultaneously.");
+                }
+
+                if (query_with_output->is_outfile_append && compression_method != CompressionMethod::None)
+                {
+                    throw Exception(
+                        ErrorCodes::BAD_ARGUMENTS,
+                        "Cannot append to compressed file. Please use uncompressed file or remove APPEND keyword.");
+                }
+
+                if (query_with_output->compression_level)
+                {
+                    const auto & compression_level_node = query_with_output->compression_level->as<ASTLiteral &>();
+                    bool res = compression_level_node.value.tryGet<UInt64>(compression_level);
+                    auto range = getCompressionLevelRange(compression_method);
+
+                    if (!res || compression_level < range.first || compression_level > range.second)
+                        throw Exception(
+                            ErrorCodes::BAD_ARGUMENTS,
+                            "Invalid compression level, must be positive integer in range {}-{}",
+                            range.first,
+                            range.second);
+                }
+
+                if (fs::exists(out_file))
+                {
+                    if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
+                    {
+                        throw Exception(
+                            ErrorCodes::FILE_ALREADY_EXISTS,
+                            "File {} exists, consider using APPEND or TRUNCATE.",
+                            out_file);
+                    }
+                }
+            }
+        }
+    }
+    catch (...)
+    {
+        throw LocalFormatError(getCurrentExceptionMessageAndPattern(print_stack_trace), getCurrentExceptionCode());
+    }
+
     const auto & settings = global_context->getSettingsRef();
     const Int32 signals_before_stop = settings.partial_result_on_first_cancel ? 2 : 1;
 

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 0936/1478] 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 508e4906c08bf3e3c5a80335d5573cc38974b7e1 Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Fri, 16 Jun 2023 01:47:28 -0700
Subject: [PATCH 0937/1478] Avoid double-catching the exceptions.

---
 src/Client/ClientBase.cpp | 93 ++++++++++++++++++---------------------
 1 file changed, 43 insertions(+), 50 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 08e14f83982..ea51c5fd0f8 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -861,72 +861,65 @@ void ClientBase::processOrdinaryQuery(const String & query_to_execute, ASTPtr pa
     }
 
     // Run some local checks to make sure queries into output file will work before sending to server.
-    try
+    if (const auto * query_with_output = dynamic_cast<const ASTQueryWithOutput *>(parsed_query.get()))
     {
-        if (const auto * query_with_output = dynamic_cast<const ASTQueryWithOutput *>(parsed_query.get()))
+        String out_file;
+        if (query_with_output->out_file)
         {
-            String out_file;
-            if (query_with_output->out_file)
+            const auto & out_file_node = query_with_output->out_file->as<ASTLiteral &>();
+            out_file = out_file_node.value.safeGet<std::string>();
+
+            std::string compression_method_string;
+
+            if (query_with_output->compression)
             {
-                const auto & out_file_node = query_with_output->out_file->as<ASTLiteral &>();
-                out_file = out_file_node.value.safeGet<std::string>();
+                const auto & compression_method_node = query_with_output->compression->as<ASTLiteral &>();
+                compression_method_string = compression_method_node.value.safeGet<std::string>();
+            }
 
-                std::string compression_method_string;
+            CompressionMethod compression_method = chooseCompressionMethod(out_file, compression_method_string);
+            UInt64 compression_level = 3;
 
-                if (query_with_output->compression)
-                {
-                    const auto & compression_method_node = query_with_output->compression->as<ASTLiteral &>();
-                    compression_method_string = compression_method_node.value.safeGet<std::string>();
-                }
+            if (query_with_output->is_outfile_append && query_with_output->is_outfile_truncate)
+            {
+                throw Exception(
+                    ErrorCodes::BAD_ARGUMENTS,
+                    "Cannot use INTO OUTFILE with APPEND and TRUNCATE simultaneously.");
+            }
 
-                CompressionMethod compression_method = chooseCompressionMethod(out_file, compression_method_string);
-                UInt64 compression_level = 3;
+            if (query_with_output->is_outfile_append && compression_method != CompressionMethod::None)
+            {
+                throw Exception(
+                    ErrorCodes::BAD_ARGUMENTS,
+                    "Cannot append to compressed file. Please use uncompressed file or remove APPEND keyword.");
+            }
 
-                if (query_with_output->is_outfile_append && query_with_output->is_outfile_truncate)
-                {
+            if (query_with_output->compression_level)
+            {
+                const auto & compression_level_node = query_with_output->compression_level->as<ASTLiteral &>();
+                bool res = compression_level_node.value.tryGet<UInt64>(compression_level);
+                auto range = getCompressionLevelRange(compression_method);
+
+                if (!res || compression_level < range.first || compression_level > range.second)
                     throw Exception(
                         ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot use INTO OUTFILE with APPEND and TRUNCATE simultaneously.");
-                }
+                        "Invalid compression level, must be positive integer in range {}-{}",
+                        range.first,
+                        range.second);
+            }
 
-                if (query_with_output->is_outfile_append && compression_method != CompressionMethod::None)
+            if (fs::exists(out_file))
+            {
+                if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
                 {
                     throw Exception(
-                        ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot append to compressed file. Please use uncompressed file or remove APPEND keyword.");
-                }
-
-                if (query_with_output->compression_level)
-                {
-                    const auto & compression_level_node = query_with_output->compression_level->as<ASTLiteral &>();
-                    bool res = compression_level_node.value.tryGet<UInt64>(compression_level);
-                    auto range = getCompressionLevelRange(compression_method);
-
-                    if (!res || compression_level < range.first || compression_level > range.second)
-                        throw Exception(
-                            ErrorCodes::BAD_ARGUMENTS,
-                            "Invalid compression level, must be positive integer in range {}-{}",
-                            range.first,
-                            range.second);
-                }
-
-                if (fs::exists(out_file))
-                {
-                    if (!query_with_output->is_outfile_append && !query_with_output->is_outfile_truncate)
-                    {
-                        throw Exception(
-                            ErrorCodes::FILE_ALREADY_EXISTS,
-                            "File {} exists, consider using APPEND or TRUNCATE.",
-                            out_file);
-                    }
+                        ErrorCodes::FILE_ALREADY_EXISTS,
+                        "File {} exists, consider using APPEND or TRUNCATE.",
+                        out_file);
                 }
             }
         }
     }
-    catch (...)
-    {
-        throw LocalFormatError(getCurrentExceptionMessageAndPattern(print_stack_trace), getCurrentExceptionCode());
-    }
 
     const auto & settings = global_context->getSettingsRef();
     const Int32 signals_before_stop = settings.partial_result_on_first_cancel ? 2 : 1;

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 0938/1478] 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 0939/1478] 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 0940/1478] 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 0941/1478] 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 0942/1478] 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 0943/1478] 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 0944/1478] 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 0945/1478] 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 0946/1478] 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 0947/1478] 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 0948/1478] 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 0949/1478] 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 0950/1478] 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 ddc95796d3da99e0de3cf8b665c319f5305f39fe Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 16 Jun 2023 13:45:29 +0200
Subject: [PATCH 0951/1478] Fix tests

---
 tests/queries/0_stateless/02344_describe_cache.reference      | 4 ++--
 tests/queries/0_stateless/02789_filesystem_cache_alignment.sh | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/02344_describe_cache.reference b/tests/queries/0_stateless/02344_describe_cache.reference
index 7496f754937..97bcf240a16 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	33554432	4194304   1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0   0   60000   2   0
-134217728	10000000	104857600	4194304   0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0   0   60000   2   0
+134217728	10000000	33554432	4194304   1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0	0	100	2	0
+134217728	10000000	104857600	4194304   0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0	0	100	2	0
diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
index ca459153c03..b9f9548a7b3 100755
--- a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest, no-parallel
+# Tags: no-fasttest, no-parallel, no-random-settings
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

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 0952/1478] 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 0953/1478] 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 0954/1478] 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 0955/1478] 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 0956/1478] 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 0957/1478] 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 0958/1478] 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 0959/1478] 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 0960/1478] 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 0961/1478] 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 0962/1478] 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 0963/1478] 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 0964/1478] 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 0965/1478] 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 0966/1478] 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 0967/1478] 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 0968/1478] 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 0969/1478] 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 0970/1478] 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 0971/1478] 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 0972/1478] 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 afa74f697cd56be60254082e2febf42943166e73 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Fri, 16 Jun 2023 19:38:50 +0000
Subject: [PATCH 0973/1478] Refactor a bit.

---
 src/Interpreters/ConcurrentHashJoin.cpp       |   1 +
 src/Interpreters/PreparedSets.cpp             | 116 ++++++--------
 src/Interpreters/PreparedSets.h               | 147 ++----------------
 src/Interpreters/Set.cpp                      |   5 +-
 src/Interpreters/Set.h                        |  22 +--
 src/Planner/CollectSets.cpp                   |   1 +
 src/Planner/PlannerActionsVisitor.cpp         |   3 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |   2 +
 .../MergeTree/MergeTreeSequentialSource.cpp   |   1 +
 src/Storages/MergeTree/RPNBuilder.cpp         |  14 +-
 src/Storages/StorageAzureBlob.cpp             |   1 +
 src/Storages/StorageDistributed.cpp           |   1 +
 src/Storages/StorageDummy.cpp                 |   1 +
 src/Storages/StorageFile.cpp                  |   1 +
 src/Storages/StorageMemory.cpp                |   1 +
 src/Storages/StorageURL.cpp                   |   1 +
 .../System/StorageSystemZooKeeper.cpp         |   2 +
 src/Storages/VirtualColumnUtils.cpp           |  24 ++-
 18 files changed, 111 insertions(+), 233 deletions(-)

diff --git a/src/Interpreters/ConcurrentHashJoin.cpp b/src/Interpreters/ConcurrentHashJoin.cpp
index 03c173a73d9..fc24f0ae029 100644
--- a/src/Interpreters/ConcurrentHashJoin.cpp
+++ b/src/Interpreters/ConcurrentHashJoin.cpp
@@ -18,6 +18,7 @@
 #include <Common/Exception.h>
 #include <Common/WeakHash.h>
 #include <Common/typeid_cast.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 
 namespace DB
 {
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 6df7c748e60..c79b667789b 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -1,12 +1,23 @@
 #include <chrono>
 #include <variant>
 #include <Interpreters/PreparedSets.h>
+#include <Interpreters/Set.h>
 #include <Processors/QueryPlan/QueryPlan.h>
 #include <Interpreters/InterpreterSelectWithUnionQuery.h>
 #include <Interpreters/Set.h>
 #include <IO/Operators.h>
 #include "Common/logger_useful.h"
 #include "Processors/QueryPlan/CreatingSetsStep.h"
+#include "Processors/Executors/CompletedPipelineExecutor.h"
+#include "Processors/QueryPlan/BuildQueryPipelineSettings.h"
+#include "Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h"
+#include "Processors/Sinks/EmptySink.h"
+#include "Processors/Sinks/NullSink.h"
+#include <Processors/QueryPlan/QueryPlan.h>
+#include "Core/Block.h"
+#include <QueryPipeline/QueryPipelineBuilder.h>
+#include <DataTypes/DataTypeLowCardinality.h>
+#include <QueryPipeline/SizeLimits.h>
 
 namespace DB
 {
@@ -16,6 +27,35 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
+class FutureSetFromTuple final : public FutureSet
+{
+public:
+    FutureSetFromTuple(Block block, const Settings & settings);
+
+    bool isReady() const override { return true; }
+    SetPtr get() const override { return set; }
+
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
+
+    DataTypes getTypes() const override { return set->getElementsTypes(); }
+
+private:
+    SetPtr set;
+    SetKeyColumns set_key_columns;
+};
+
+
+FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
+bool FutureSetFromStorage::isReady() const { return set != nullptr; }
+SetPtr FutureSetFromStorage::get() const { return set; }
+DataTypes FutureSetFromStorage::getTypes() const { return set->getElementsTypes(); }
+
+SetPtr FutureSetFromStorage::buildOrderedSetInplace(const ContextPtr &)
+{
+    return set->hasExplicitSetElements() ? set : nullptr;
+}
+
+
 PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
 {
     /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
@@ -240,8 +280,6 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
         return nullptr;
     }
 
-    // std::cerr << "... external_table_set " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
-
     if (external_table_set)
         return subquery.set = external_table_set->buildOrderedSetInplace(context);
 
@@ -261,6 +299,13 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     return subquery.set;
 }
 
+bool FutureSetFromSubquery::isReady() const { return subquery.set != nullptr && subquery.set->isCreated(); }
+
+std::unique_ptr<QueryPlan> FutureSetFromSubquery::build(const ContextPtr & context)
+{
+    return buildPlan(context, false);
+}
+
 static SizeLimits getSizeLimitsForSet(const Settings & settings)
 {
     return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
@@ -271,25 +316,6 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     if (subquery.set)
         return nullptr;
 
-    // std::cerr << StackTrace().toString() << std::endl;
-
-    // auto set_cache = context->getPreparedSetsCache();
-    // if (set_cache)
-    // {
-    //     auto from_cache = set_cache->findOrPromiseToBuild(subquery.key);
-    //     if (from_cache.index() == 0)
-    //     {
-    //         subquery.promise_to_fill_set = std::move(std::get<0>(from_cache));
-    //     }
-    //     else
-    //     {
-    //         LOG_TRACE(&Poco::Logger::get("FutureSetFromSubquery"), "Waiting for set, key: {}", subquery.key);
-    //         set = std::get<1>(from_cache).get();
-    //         return nullptr;
-    //     }
-    // }
-
-
     const auto & settings = context->getSettingsRef();
     auto size_limits = getSizeLimitsForSet(settings);
 
@@ -298,10 +324,6 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     auto plan = subquery.detachSource();
     auto description = subquery.key;
 
-    // WriteBufferFromOwnString buf;
-    // plan->explainPlan(buf, {.header=true});
-    // std::cerr << buf.str() << std::endl;
-
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
             description,
@@ -314,20 +336,6 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     return plan;
 }
 
-// static SizeLimits getSizeLimitsForOrderedSet(const Settings & settings)
-// {
-//     if (settings.use_index_for_in_with_subqueries_max_values &&
-//         settings.use_index_for_in_with_subqueries_max_values < settings.max_rows_in_set)
-//         return getSizeLimitsForUnorderedSet(settings);
-
-//     return SizeLimits(settings.use_index_for_in_with_subqueries_max_values, settings.max_bytes_in_set, OverflowMode::BREAK);
-// }
-
-// SizeLimits FutureSet::getSizeLimitsForSet(const Settings & settings, bool ordered_set)
-// {
-//     return ordered_set ? getSizeLimitsForOrderedSet(settings) : getSizeLimitsForUnorderedSet(settings);
-// }
-
 FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
 {
     bool create_ordered_set = false;
@@ -342,10 +350,8 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
 
     set_key_columns.filter = ColumnUInt8::create(block.rows());
 
-    //set->initSetElements();
     set->insertFromColumns(columns, set_key_columns);
     set->finishInsert();
-    //block(std::move(block_))
 }
 
 FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_)
@@ -359,8 +365,6 @@ DataTypes FutureSetFromSubquery::getTypes() const
     return Set::getElementTypes(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName(), transform_null_in);
 }
 
-FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
-
 SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
 {
     if (set->hasExplicitSetElements())
@@ -378,30 +382,4 @@ SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
     return set;
 }
 
-std::unique_ptr<QueryPlan> FutureSetFromTuple::build(const ContextPtr &)
-{
-    // const auto & settings = context->getSettingsRef();
-    // auto size_limits = getSizeLimitsForSet(settings, false);
-    // fill(size_limits, settings.transform_null_in, false);
-    return nullptr;
-}
-
-// void FutureSetFromTuple::buildForTuple(SizeLimits size_limits, bool transform_null_in)
-// {
-//     fill(size_limits, transform_null_in, false);
-// }
-
-// void FutureSetFromTuple::fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set)
-// {
-//     //std::cerr << StackTrace().toString() << std::endl;
-
-//     if (set)
-//         return;
-
-//     set = std::make_shared<Set>(size_limits, create_ordered_set, transform_null_in);
-//     set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
-//     set->insertFromBlock(block.getColumnsWithTypeAndName());
-//     set->finishInsert();
-// }
-
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index a119c24ad10..f034aca747f 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -2,23 +2,13 @@
 
 #include <Parsers/IAST.h>
 #include <DataTypes/IDataType.h>
-#include <future>
 #include <memory>
 #include <unordered_map>
 #include <vector>
-#include <DataTypes/DataTypeLowCardinality.h>
+#include <future>
 #include <Storages/IStorage_fwd.h>
-#include <QueryPipeline/SizeLimits.h>
-#include <Processors/QueryPlan/QueryPlan.h>
-#include "Core/Block.h"
-#include "Interpreters/Context.h"
-#include "Interpreters/Set.h"
-#include "Processors/Executors/CompletedPipelineExecutor.h"
-#include "Processors/QueryPlan/BuildQueryPipelineSettings.h"
-#include "Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h"
-#include "Processors/Sinks/EmptySink.h"
-#include "Processors/Sinks/NullSink.h"
-#include <QueryPipeline/QueryPipelineBuilder.h>
+#include <Interpreters/Context_fwd.h>
+#include <Core/Settings.h>
 
 namespace DB
 {
@@ -32,80 +22,44 @@ class InterpreterSelectWithUnionQuery;
 class IQueryTreeNode;
 using QueryTreeNodePtr = std::shared_ptr<IQueryTreeNode>;
 
+struct Settings;
+
 /// Represents a set in a query that might be referenced at analysis time and built later during execution.
 /// Also it can represent a constant set that is ready to use.
 /// At analysis stage the FutureSets are created but not necessarily filled. Then for non-constant sets there
 /// must be an explicit step to build them before they can be used.
-/// FutureSet objects can be stored in PreparedSets and are not intended to be used from multiple threads.
-// class FutureSet final
-// {
-// public:
-//     FutureSet() = default;
-
-//     /// Create FutureSet from an object that will be created in the future.
-//     explicit FutureSet(const std::shared_future<SetPtr> & future_set_) : future_set(future_set_) {}
-
-//     /// Create FutureSet from a ready set.
-//     explicit FutureSet(SetPtr readySet);
-
-//     /// The set object will be ready in the future, as opposed to 'null' object  when FutureSet is default constructed.
-//     bool isValid() const { return future_set.valid(); }
-
-//     /// The the value of SetPtr is ready, but the set object might not have been filled yet.
-//     bool isReady() const;
-
-//     /// The set object is ready and filled.
-//     bool isCreated() const;
-
-//     SetPtr get() const { chassert(isReady()); return future_set.get(); }
-
-// private:
-//     std::shared_future<SetPtr> future_set;
-// };
-
+/// Set may be useful for indexes, in this case special ordered set with stored elements is build inplace.
 class FutureSet
 {
 public:
     virtual ~FutureSet() = default;
 
     virtual bool isReady() const = 0;
-    virtual bool isFilled() const = 0;
     virtual SetPtr get() const = 0;
 
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
-    virtual std::unique_ptr<QueryPlan> build(const ContextPtr & context) = 0;
 
     virtual DataTypes getTypes() const = 0;
-
-    // static SizeLimits getSizeLimitsForSet(const Settings & settings, bool ordered_set);
 };
 
 using FutureSetPtr = std::shared_ptr<FutureSet>;
 
-class FutureSetFromTuple final : public FutureSet
+
+class FutureSetFromStorage : public FutureSet
 {
 public:
-    FutureSetFromTuple(Block block, const Settings & settings);
+    FutureSetFromStorage(SetPtr set_);
 
-    bool isReady() const override { return true; }
-    bool isFilled() const override { return true; }
-    SetPtr get() const override { return set; }
-
-    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
-
-    std::unique_ptr<QueryPlan> build(const ContextPtr &) override;
-
-    DataTypes getTypes() const override { return set->getElementsTypes(); }
-
-///    void buildForTuple(SizeLimits size_limits, bool transform_null_in);
+    bool isReady() const override;
+    SetPtr get() const override;
+    SetPtr buildOrderedSetInplace(const ContextPtr &) override;
+    DataTypes getTypes() const override;
 
 private:
     SetPtr set;
-    Set::SetKeyColumns set_key_columns;
-
-    //void fill(SizeLimits size_limits, bool transform_null_in, bool create_ordered_set);
 };
 
+
 /// Information on how to build set for the [GLOBAL] IN section.
 class SubqueryForSet
 {
@@ -122,11 +76,6 @@ public:
     /// Build this set from the result of the subquery.
     String key;
     SetPtr set;
-    /// After set_in_progress is finished it will be put into promise_to_fill_set and thus all FutureSet's
-    /// that are referencing this set will be filled.
-
-    std::promise<SetPtr> promise_to_fill_set;
-    // FutureSet set = FutureSet{promise_to_fill_set.get_future()};
 
     /// If set, put the result into the table.
     /// This is a temporary table for transferring to remote servers for distributed query processing.
@@ -142,25 +91,18 @@ class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_t
 public:
     FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_);
 
-    bool isReady() const override { return subquery.set != nullptr && subquery.set->isCreated(); }
-    bool isFilled() const override { return isReady(); }
+    bool isReady() const override;
     SetPtr get() const override { return subquery.set; }
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
-    std::unique_ptr<QueryPlan> build(const ContextPtr & context) override
-    {
-        return buildPlan(context, false);
-    }
+    std::unique_ptr<QueryPlan> build(const ContextPtr & context);
 
     DataTypes getTypes() const override;
 
-    // void addStorage(StoragePtr storage) { subquery.table = std::move(storage); }
-
     SubqueryForSet & getSubquery() { return subquery; }
 
 private:
-    //SetPtr set;
     SubqueryForSet subquery;
     FutureSetPtr external_table_set;
     bool transform_null_in;
@@ -168,52 +110,6 @@ private:
     std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
 };
 
-class FutureSetFromStorage : public FutureSet
-{
-public:
-    FutureSetFromStorage(SetPtr set_); // : set(std::move(set_) {}
-
-    bool isReady() const override { return set != nullptr; }
-    bool isFilled() const override { return isReady(); }
-    SetPtr get() const override { return set; }
-
-    SetPtr buildOrderedSetInplace(const ContextPtr &) override
-    {
-        return set->hasExplicitSetElements() ? set : nullptr;
-    }
-
-    DataTypes getTypes() const override { return set->getElementsTypes(); }
-
-    std::unique_ptr<QueryPlan> build(const ContextPtr &) override { return nullptr; }
-
-private:
-    SetPtr set;
-};
-
-// class FutureSetFromFuture : public FutureSet
-// {
-// public:
-//     FutureSetFromFuture(std::shared_future<SetPtr> future_set_);
-
-//     bool isReady() const override { return future_set.wait_for(std::chrono::seconds(0)) == std::future_status::ready; }
-//     SetPtr get() const override { return future_set.get(); }
-
-//     SetPtr buildOrderedSetInplace(const ContextPtr &) override
-//     {
-//         fill(true);
-//         return set;
-//     }
-
-//     std::unique_ptr<QueryPlan> build(const ContextPtr &) override
-//     {
-//         fill(false);
-//         return nullptr;
-//     }
-
-// private:
-//     std::shared_future<SetPtr> future_set;
-// }
-
 struct PreparedSetKey
 {
     using Hash = std::pair<UInt64, UInt64>;
@@ -250,28 +146,17 @@ public:
     };
     using SubqueriesForSets = std::vector<SetAndName>;
 
-    // SubqueryForSet & createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
-    //                                      SizeLimits set_size_limit, bool transform_null_in);
-
     FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
     FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings);
     FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
 
-    //void addStorageToSubquery(const String & subquery_id, StoragePtr external_storage);
-
     FutureSetPtr getFuture(const PreparedSetKey & key) const;
-    //SubqueryForSet & getSubquery(const String & subquery_id);
-    // SetPtr get(const PreparedSetKey & key) const;
 
     /// Get subqueries and clear them.
     /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
     /// SetPtr would still be available for consumers of PreparedSets.
     SubqueriesForSets detachSubqueries();
 
-    /// Returns all sets that match the given ast hash not checking types
-    /// Used in KeyCondition and MergeTreeIndexConditionBloomFilter to make non exact match for types in PreparedSetKey
-    //std::vector<FutureSetPtr> getByTreeHash(IAST::Hash ast_hash) const;
-
     const std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hashing> & getSets() const { return sets; }
 
     bool empty() const;
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index 52e9a3a9bcb..83005f3d3a7 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -265,7 +265,10 @@ bool Set::insertFromColumns(const Columns & columns, SetKeyColumns & holder)
 
 void Set::appendSetElements(SetKeyColumns & holder)
 {
-    //std::cerr << "========= " << keys_size << ' ' << holder.key_columns.size() << std::endl;
+    if (holder.key_columns.size() != keys_size || set_elements.size() != keys_size)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid number of key columns for set. Expected {} got {} and {}",
+                        keys_size, holder.key_columns.size(), set_elements.size());
+
     size_t rows = holder.key_columns.at(0)->size();
     for (size_t i = 0; i < keys_size; ++i)
     {
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index 9b76ab30a1b..a6908d2bdd3 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -21,6 +21,17 @@ using FunctionBasePtr = std::shared_ptr<const IFunctionBase>;
 
 class Chunk;
 
+/// Prepared key columns for set which can be added to fill set elements.
+/// Used only to upgrade set from tuple.
+struct SetKeyColumns
+{
+    /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
+    ColumnRawPtrs key_columns;
+    Columns materialized_columns;
+    ColumnPtr null_map_holder;
+    ColumnUInt8::MutablePtr filter;
+};
+
 /** Data structure for implementation of IN expression.
   */
 class Set
@@ -48,17 +59,6 @@ public:
     bool insertFromColumns(const Columns & columns);
     bool insertFromBlock(const ColumnsWithTypeAndName & columns);
 
-
-    struct SetKeyColumns
-    {
-        //ColumnRawPtrs key_columns;
-        /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
-        ColumnRawPtrs key_columns;
-        Columns materialized_columns;
-        ColumnPtr null_map_holder;
-        ColumnUInt8::MutablePtr filter;
-    };
-
     void initSetElements();
     bool insertFromColumns(const Columns & columns, SetKeyColumns & holder);
     void appendSetElements(SetKeyColumns & holder);
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 68ad1ab78d3..84ab453c065 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -13,6 +13,7 @@
 #include <Analyzer/FunctionNode.h>
 #include <Analyzer/TableNode.h>
 #include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 #include <Planner/Planner.h>
 
 namespace DB
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index bbac9bf5c4b..087cd3000b9 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -17,6 +17,7 @@
 
 #include <Common/FieldVisitorToString.h>
 #include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 
 #include <Columns/ColumnSet.h>
 #include <Columns/ColumnConst.h>
@@ -663,7 +664,7 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
     column.name = planner_context->createSetKey(in_second_argument);
     column.type = std::make_shared<DataTypeSet>();
 
-    bool set_is_created = set->isFilled();
+    bool set_is_created = set->isReady();
     auto column_set = ColumnSet::create(1, std::move(set));
 
     if (set_is_created)
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 0909ee9f1eb..da27e7b1293 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -1,6 +1,8 @@
 #include <exception>
 #include <Processors/QueryPlan/CreatingSetsStep.h>
 #include <Processors/QueryPlan/QueryPlan.h>
+//#include <Processors/QueryPlan/BuildQueryPipelineSettings.h>
+#include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
 #include <QueryPipeline/QueryPipelineBuilder.h>
 #include <Processors/Transforms/CreatingSetsTransform.h>
 #include <IO/Operators.h>
diff --git a/src/Storages/MergeTree/MergeTreeSequentialSource.cpp b/src/Storages/MergeTree/MergeTreeSequentialSource.cpp
index e27354f9d16..5a6d59bf0be 100644
--- a/src/Storages/MergeTree/MergeTreeSequentialSource.cpp
+++ b/src/Storages/MergeTree/MergeTreeSequentialSource.cpp
@@ -8,6 +8,7 @@
 #include <QueryPipeline/Pipe.h>
 #include <Interpreters/Context.h>
 #include <Processors/Sources/NullSource.h>
+#include <Processors/QueryPlan/QueryPlan.h>
 #include <Processors/QueryPlan/FilterStep.h>
 #include <Common/logger_useful.h>
 
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index b82c350fa1a..1acc3ec6ce9 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -9,6 +9,7 @@
 
 #include <DataTypes/FieldToDataType.h>
 #include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 
 #include <Columns/ColumnConst.h>
 #include <Columns/ColumnSet.h>
@@ -301,26 +302,15 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
         auto hash = ast_node->getTreeHash();
         auto key = PreparedSetKey::forSubquery(hash);
 
-        // std::cerr << ".........Getting from AST \n" << ast_node->dumpTree() << std::endl
-        //   << key.toString() << std::endl;
-
         for (const auto & [k, v] : prepared_sets->getSets())
         {
-            // std::cerr << "........... " << k.toString() << std::endl;
             if (k.ast_hash == hash)
                 return v;
         }
-
-        //return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
     }
     else if (dag_node)
     {
-
-        // std::cerr << "...........Getting from DAG\n";
         const auto * node_without_alias = getNodeWithoutAlias(dag_node);
-        // std::cerr << ".......... node_without_alias : " << node_without_alias->result_name
-        //   << ' ' << node_without_alias->result_type->getName()
-        //   << ' ' << (node_without_alias->column ? node_without_alias->column->getName() : "") << std::endl;
         return tryGetSetFromDAGNode(node_without_alias);
     }
 
@@ -369,8 +359,6 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
             auto lhs = removeNullable(recursiveRemoveLowCardinality(data_types[i]));
             auto rhs = removeNullable(recursiveRemoveLowCardinality(set_types[indexes_mapping[i].tuple_index]));
 
-            // std::cerr << "============ " << lhs->getName() << ' ' << rhs->getName() << std::endl;
-
             if (!lhs->equals(*rhs))
                 return false;
         }
diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 3ee176a68b7..b80f41543b5 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -13,6 +13,7 @@
 
 #include <Parsers/ASTCreateQuery.h>
 #include <Formats/ReadSchemaUtils.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 #include <DataTypes/DataTypeString.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <re2/re2.h>
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 042492aba32..763dbac04cf 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -91,6 +91,7 @@
 #include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
 #include <Processors/QueryPlan/ReadFromPreparedSource.h>
 #include <Processors/QueryPlan/ExpressionStep.h>
+#include <QueryPipeline/QueryPipelineBuilder.h>
 #include <Processors/Sources/NullSource.h>
 #include <Processors/Sources/RemoteSource.h>
 #include <Processors/Sinks/EmptySink.h>
diff --git a/src/Storages/StorageDummy.cpp b/src/Storages/StorageDummy.cpp
index 4f2fb3883bf..e2396a54acb 100644
--- a/src/Storages/StorageDummy.cpp
+++ b/src/Storages/StorageDummy.cpp
@@ -5,6 +5,7 @@
 
 #include <Processors/Chunk.h>
 #include <Processors/Sources/SourceFromSingleChunk.h>
+#include <Processors/QueryPlan/QueryPlan.h>
 
 namespace DB
 {
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 72347789790..b3359dd3427 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -23,6 +23,7 @@
 #include <IO/WriteBufferFromFile.h>
 #include <IO/WriteHelpers.h>
 
+#include <DataTypes/DataTypeLowCardinality.h>
 #include <DataTypes/DataTypeString.h>
 #include <Formats/FormatFactory.h>
 #include <Formats/ReadSchemaUtils.h>
diff --git a/src/Storages/StorageMemory.cpp b/src/Storages/StorageMemory.cpp
index b7772d00776..6ed0583bd44 100644
--- a/src/Storages/StorageMemory.cpp
+++ b/src/Storages/StorageMemory.cpp
@@ -16,6 +16,7 @@
 #include <Processors/Sinks/SinkToStorage.h>
 #include <Processors/Executors/PullingPipelineExecutor.h>
 #include <Processors/QueryPlan/ReadFromMemoryStorageStep.h>
+#include <Processors/QueryPlan/QueryPlan.h>
 #include <Parsers/ASTCreateQuery.h>
 
 #include <Common/FileChecker.h>
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 520576d3961..2e72c957a24 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -39,6 +39,7 @@
 #include <Poco/Net/HTTPRequest.h>
 #include <regex>
 #include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 
 
 namespace DB
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 3f6575cb78d..d1c978d3469 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -15,12 +15,14 @@
 #include <Columns/ColumnSet.h>
 #include <Columns/ColumnConst.h>
 #include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 #include <Functions/IFunction.h>
 #include <Parsers/ASTSubquery.h>
 #include <Interpreters/Set.h>
 #include <Interpreters/interpretSubquery.h>
 #include <Processors/Executors/PullingPipelineExecutor.h>
 #include <Processors/Sinks/SinkToStorage.h>
+#include <Processors/QueryPlan/QueryPlan.h>
 #include <Processors/QueryPlan/SourceStepWithFilter.h>
 #include <QueryPipeline/QueryPipelineBuilder.h>
 #include <boost/algorithm/string/join.hpp>
diff --git a/src/Storages/VirtualColumnUtils.cpp b/src/Storages/VirtualColumnUtils.cpp
index be2206a78e9..58d00216dc7 100644
--- a/src/Storages/VirtualColumnUtils.cpp
+++ b/src/Storages/VirtualColumnUtils.cpp
@@ -20,6 +20,13 @@
 #include <Columns/ColumnsCommon.h>
 #include <Columns/FilterDescription.h>
 
+#include <Processors/QueryPlan/QueryPlan.h>
+#include <Processors/QueryPlan/BuildQueryPipelineSettings.h>
+#include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
+#include <Processors/Sinks/EmptySink.h>
+#include <Processors/Executors/CompletedPipelineExecutor.h>
+#include <QueryPipeline/QueryPipelineBuilder.h>
+
 #include <Storages/VirtualColumnUtils.h>
 #include <IO/WriteHelpers.h>
 #include <Common/typeid_cast.h>
@@ -215,15 +222,18 @@ void filterBlockWithQuery(const ASTPtr & query, Block & block, ContextPtr contex
             if (column_set)
             {
                 auto future_set = column_set->getData();
-                if (!future_set->isFilled())
+                if (!future_set->isReady())
                 {
-                    auto plan = future_set->build(context);
-                    auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
-                    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
-                    pipeline.complete(std::make_shared<EmptySink>(Block()));
+                    if (auto * set_from_subquery = typeid_cast<FutureSetFromSubquery *>(future_set.get()))
+                    {
+                        auto plan = set_from_subquery->build(context);
+                        auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
+                        auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
+                        pipeline.complete(std::make_shared<EmptySink>(Block()));
 
-                    CompletedPipelineExecutor executor(pipeline);
-                    executor.execute();
+                        CompletedPipelineExecutor executor(pipeline);
+                        executor.execute();
+                    }
                 }
             }
         }

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 0974/1478] 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 0975/1478] 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 0976/1478] 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 0977/1478] 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 0978/1478] 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 12f979dd2bcc66ba396f4a3eed6e03d280661c49 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Sat, 17 Jun 2023 02:08:11 +0200
Subject: [PATCH 0979/1478] Update .reference

---
 tests/queries/0_stateless/02344_describe_cache.reference | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02344_describe_cache.reference b/tests/queries/0_stateless/02344_describe_cache.reference
index 97bcf240a16..6f445dc13e7 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	33554432	4194304   1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0	0	100	2	0
-134217728	10000000	104857600	4194304   0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0	0	100	2	0
+134217728	10000000	33554432	4194304	1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0	100	2	0
+134217728	10000000	104857600	4194304	0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0	100	2	0

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 0980/1478] 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 0981/1478] 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 0982/1478] 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 0983/1478] 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
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%0A{mOUSj)`htuw
z9FK=5`=91poOUa_S1+5^dn<WFht({-dU<8_0ew-32ujgc#;|L7g*9p?mKdAP6Qu{w
zE3Bv_*hBnmlfY~OAMiwnT$`%iNY6ZJz4*H&|6(5I3ob0xGx?1qt}bdhXVFGJw6O@m
zF;AUkFju`UuDKq-#QC-31YhwSmQ-Z>UP^>|DhXz@6lU*$LP26GBIftqYS?OBdtu|n
zGr^<dIC?`b-X}&TCML3Q7E+W1>Foe3u_t1d66Z-Hjo$@P%zu7RZT{JA$48*@Yx#LN
zl_$^t9|#~DU`%U3z6ksU6by+DJu{>n5ug5pI)a+UAS*_qc$VIw_K5P~zs_4$AG85+
zLN<BsmbZoQ9i5hv*3)+cL?X5ahH?75festcTCiN@)*hivmaVd;ZX&&gdFF*)-jyl0
zi|(5Il$qZ%x$ROA1z*0msEup)5@B1K8S>X7kJZ+1Af8HyRU!wlqT)ix%Rz=qoWF#g
zrY28a_&sa?QWUp=17F17n}c*n_n6)5nW<HdL9I&}l8z;{s3jTmtX%WnVu6-0sC0go
z6xp(lRY%ErB}i^VKFXu;MA-%IUuEXh9N~*v{$avE!Q1=C>EUqz<lnqz2DZ|e92>5+
zX9*Egx7Pb?uzxAoudzA{uf*N!+b&-)weO2>P{hjRyfWV_YboO&;yMcRC_j=4)KKWa
z1&nbarc%}Mo<OuFGDhY)&C3F(McS0ywB2U$KPEHBtK@-Whc!A+1sH$_?%!C`3_h}O
zcnI`O2f><IpB5k9f-t?MA-_2(;eBfk%g3I}&Z2V9bs3Y#g{rW$`xqaq(veV*!q8kF
zALmsTvG7jtqJ&6mb~my4OW*aYBVLj7O1xFGBiXNpH1Ih<nQ75S;Zr`k{d-bW7c?iL
zJ`=Z~dttlC5Ani`ewv7e8VPIAo{mb59$oNusF<y`%fW$|$b9g$4@}*gcW>=1`{|Lz
zRhT_d{;0AVV2ABH?)GUL>c@FCN)~@kWxXS~Ptt~zq^y~q=@v6g7vxnHmmkteA()mn
ziZTGLt#K7I<s{}*xSn$YX(ND;Us5tSuEze05nQ69O?T<7+v3}EA;53@NQb&{cWA&F
z8$(MGpJq$`0Gq7%3FR&z8r%cDZHm+;3QsEf>~r7wP8>RePkCuf<B};es?(a(79G98
zMCv~}AOowZg|*+`bq~CDQKbLIx6E?nES|K~6LJAVxSfNMoH3D4KSe7Gtr^{n*)$A(
z5>;99u<F5&r)bL;Dq5{?5OsI+me;>+T!hkz#`TDK^=ZXWI31x+zMTlJzHz<uLEbYS
zD*h~vS7tl!io_D}Ma!&1pi|9`mI`WwII{aDB`$+~_W#~wM&I`n$+5`GJ5n95Mjzr;
z6S!1W#A(YH1u!n-5=RDeR;*9sOjZ%E*roU;f`tLSqIJ(&mGa3Pk7@xzM6lT#(vzZ_
zR>mqX^%(209!;3!Q$g5bFQ>stTw`nP=@o}=FKk9Zk=j|$wVB9+UEDjmDzgGJdZ}$z
zL4PBYDs43KUb#AAC=t)vS&glgF;SjdUGU<l4B!{;9#+Pr*;3e$lW)d)s?zBwhDoPX
z-6tfnm)#50qamHXna++t)Ce8<VJ7`72=5VuI>60qbNBB%(@G`82)xjE#<-7d5T708
z@WI&N{U61@Qhuw2vPl388+kbYL3F{G?BHYYuF!TkrIRl)KI<0Xr<*tRlUye`qoxnE
zdve(@6Yfa4KHocWrzdab2F3cK6gFTWTS)q8nQEfyc6eyMp`!zA6TU@`ln(5|A(fd}
z!(FgLmdZg4N_fMkEp4LIZXJhHcOYm~#j;$Hr$R&P2e02Ic1+sSGmm`Gmm&vV@<F{W
z%a-zaln=AI<OFV(cwhACLwA&DkbKk8<rQcJ>mThFjxyI|8ntq*7lz+WLeP%;;^wZF
zRwO;vFzk7=7^G?iiMTCUJnW@}szPFN5Qyi&h0c9tk;}5CP5t!W>n`0pB=kO*et)8b
zD$RN=NqbmFNt#?UG2hoYXN(VNMs&%R&D;r)L<oqev##ct5_dUI2TB>FW${wixJx-K
z7Hv0YFL7wmUY)VtRf6-U8In*<t?sN#m!V;#eG@hQBl);TkAcS+kbnz9=MQWk1V0zv
zkL0_uB+4$2;Q@)7^%99u;QP(E@fT|DYAtI(w-U!e#?N!g&?z+J^Kz&`XdV_9h^^;f
zh?AV&D+O%qErDhft_S~6IcS{)v;&uz5$j;aydeMbETa-Vbn=pnt$7gGhU%Pv7N}zy
z;l#`h(T*&1sv+MDxG_TTTXkXgal6tN*{{yE68reR>zW1Co&>o(r3gw@wVb(H%L3?J
z<KOveD!{Dq9yY^;s1PX4;kOexyd$Uh?g;bH$qc)xj!7LmF<~1_A@)q3nZ)#!E0Wut
z$8jSgfd1Y&b}ov*2)cxcZF(qsAXF#fF5MHe-3<X5<8<PXAgj~8x$BrOKa@}%TBo3*
zhGoAzSY|~>*+X<s4sbEMLePg0ehWP~>3EO(_LZk-MpJaWZmf1)&2GSlN+TZHqS5A{
z@F1h7oWF&m9zoIL-j`1Jf;Y#if#ubDDK<$mXy}DWX3A?y^i&TI@Is$$Zxf%;dmMj3
zT5ZB^$Y&Q<LZ{VJM0msQX&NJwR`dJKswoA+(E*R_*Z{W0#jHw+@3!HdVmidbO0?MD
zON7<T4~?`)pW|UYgYzUfkH%~%ydU8A)t|Hy97hJq4)bgZjSIX19npL#@u@zk^C@=7
z6C-;yxX*O$56&y#%UvGIUtyuBN?x4HCOmL6S$clCe=3OE{edd8oP7M@lI*LZCDAOi
zLDJa_7*1RrI-AMQv9uqKZI}sT^?>%qj)hi#<w&XWRLvuCYUGwZo9Li>s~g$R5NPD<
zH@u&-hw>=lK4yD3>l(T6kW*a?y{)l?eaHz_B4AX!*T_sIAr-qbE{$f$!Ob`u`UXx6
zgpc~zr}=L2Ig`ZdH(D0<;v^2*Usn#Tnv@^jqoZ#3v~8SO_zsX^@80cAoe-#HcYXpn
z5-BciZHaWvbmLjDgqIX(uuU;&i<0$T40Vk=P<__*WRqma%LwHNaUt&nl>F$@DP@}{
zKq#r!vqLM~a>TOnDbgfY^<9Bx73m2m5<w5>O;5;gCd^=k2LFFS7ApG!xnAq;z1~|0
zOew5jrZwxneYF1ew9QaRiY3Wx`_i^Hs<tzKOf#&tm$QhDpVY}rr{ayT@vF9v7*jUj
z*9uOn%bl~i8Qg?7;OMdUW>B|_py)<FiJv^76{}YXK>5ci;n`DdkWPgJ3cDePWv^TN
zUkrp6>=x0w28cQc9+qwC)%GAO=rCV#V4pV;RMMh--eX3YrHsNNmps(hLpXUt<Y#4H
zHCH?WQAS6zU*l9ldR(PR>z-_R;-R7CJx;7wQ44@R*l2fCF@jgXIr^?76uspPYvQ2K
zn_ks<!1JSJG9E%=bXOuc@uct|4yS|5QWY+lex<hL7^fzdf9Fl^g=lr4+DRG_<*Q3B
z7#{5vCVtSlm+~PRQnuY->9=6I5ea1rPSi;(G!I~x{yZLj1K+SCL>IDIoPSk$-dN}5
zc4lUY|ND!7RBjj;t%Ze&&xtT2;k?i~ob}>MAb5&JDEGICuCGFF4&>7uIwh;uSP2Zo
zI$_RJ^Hs)J?($xpy;^+v6Vv3C-71t5#+cnt=uTpBc^0?r{qY?SPP>Z_1%iTyegIQ*
z9%e{eJpOI_h1*uaTpN&b4s(mB+mAG4C;z7hVNM(xh;vb@m225I-t<u>{U9v~UelHP
zkF3wL)(+&<GDth{R;y>5<ze211}Gwb1-&U@?V{^CAb>RJLG8!Qqut7Y?<`?wr#S3?
zQKw>VfK1ZVRLjlqGhYP8jeeLHuTrao501s=C|{&CCsorHE40ajYV5RBE}UVSe`4YB
z55!J@TZoZwvT#@_pC)WPHp6AM6%H<0hj9V^KqCEUQMRNF&q2xabSCe5AwX|t4{X>G
zKYi0X1jEExP8M4dxj^YeW?02fGmmAkEWN%h-lwq06!^~g@c%j;AJS%q`{gEEiyX;M
z23`0+@BGf~omx0G>LjPr3>+a{?jy@cg(Oo#@8BBmeCd^wqv=ktBCip|U1$4X03qTr
zuT+1oE-Ugw5P*~gI*!KbM^hq>Iif#R^HYXlwhq(&i(6qQh;c9TN=1Nq+YUl+vtY7-
zOMT&?c*tD6P~#K07)dtuMVEn(SHG*9{<zTp|HFiN(DG(*5v-3oK{@HK6!~0MO1<cE
zN(aY;G#M>zpsrl{+_gb<k`*BCu8)W9XdCrJwgOh9>+Lxdy%PZ?8}l`o2SeROT=~;z
zU=3|I?6FNCsOOeWeo5=L`EthZYkti-9;BRk{6Ki-XL(zs=mRzvEn0;9OnPP4hPdlw
zJsgKJ&hKGXA2+ez#eNAJ*BZU;g+{5MwnPEQNCMin5|maeAi&-Ikqi27$<IR<#AWCR
z2W9!G+m~V4DD!xZ+L*@C@E&-2NqQX3@B#10U*_kh#Zye?CwoztLlY#B)b)&ZqvwWd
zXIR%-2*XpomxQ?LmXt8jsp|Ye8HHBX>4sk!C#<6;Hh4R1D`5<?xij|w@bat>nE9@b
z9*s))650_~IvEUzF<$>rfaVh~8a*ofnlx+Yl|}DDZ5N1U9fOMWfn&EJ?}26QxT!IN
zV|ymyWn-8&gEGWt;p}5Vy>1T}+oYrp!_M&0o8B*i{c<Un{MS3=Nq?Z_0IoIh7odhk
zE+d@Q!01t9<3Mve1V0WOsP-%P?iznQum-veiGH`p5dR1)s=WQ+wo`n_xB?rkaVR(+
zV!Dv5mE~#VO~|unt|vIAt`T&|xF%<B!aN!=lgH%IsNwm5RO%4SkkAO|252T2x4{~C
z0#hubfUvo+O=_w6EE>l?ydG1W=%#~EF`@uALC)AxioWNos5v_ay+D<QDyrm3Y~bqK
zB>41=WM^f(^@e#Ev+|HUrB)Rb>O66R&(ZQp94xz{{brT*#$@lsqGUVDdeN9C41|mp
z1w5XSN~l*Y0*Xg*Bm1ZHPOFNk5l+u`FSnO}tu9Z@);Tbq^}fjcK?GnLY)r57tFp#-
za@005VK1Bh+1}>^vOEP+lrwur4DGkBuPu)X*qH((EveMS)H8BKigkln9~UEAHi%Tj
z7_X&Nj?C%Qj2hOJY+`RU&6;@45u1}x4%t3`{4&H!1om|fkEFS>>aoXaIP%AyW?Ogo
zpD{}3+WXO=4FH@72CP6n1J$Bp+M+rh@S!hbL(IXeJi*{3PLsg+LEAdv@V;c3gLU1e
z$ST++Alw|Y_i*^^S$w)oP}~xMluWmutxEkLao6@#hO@&vMD0gM68v&+``P%=ZdXuu
zE|N>vdj^Y_`#s~RP|6J2hi&z#ODXL(SI45D8|6%t(%bcx1)_USadIZEkQ&^9pA5II
z#Xk2KVu#PGDh><8b`DDr7HYNaF}WjZ(Z6OY6+ATK);=kc-2KDIlVHdIoY+!xG0Pm7
zMlznEVh>DoOT8irL(h=@UL9+Umj<%>y##e|>>;bfwT30J)<Gq@E8k8^R|<5;kJNTy
zc}LBf8Jg&z&u6}8Y7cLQ`$X1kDRiF$zbz;-_9vb=zb79+%g=Tl&%RWs6ssnJ5a+0)
zC|Gkmsr|tV?dg!%maGF)Z~_{Qa8pS3V@~*y@3IrUua1R~LJX77(gHe=uwjzi#MQd`
zvApVx*r;A}PGprZ#gy4S>MS1<+Vpn%o}ZAiv199jhcJ9u{goeI!Kt&qL&5On*pMJx
zmp@t|>cB_>fsV`IuF|y|x4kw)63@JPD)dm+Zd-OZgZ7Y_C46meb}R^*Los3ErKq7A
zWd%vQ+Um*#5$4KRm80s@*!zRNT6295=Md}kyQX9Rh~zHPPJW%NhN}c|1)lfUj&SMy
zjwL%q$;g>m|F*g92YMqPiSH9GIKSH!k-q;O(qbVH5|8Ib_4x4T8a6VXI4@dmQ`A^(
zQ`o@ldmp!Sah&Fv>~PD;XHsJ+kp~@knYod(iPB|{q6woALGGN-8VC8N6AB)&N&_3C
z)lY?6H(<DLoJdoq41tgGm7yQq&PP1wBD4~lYy#>D(QjbSCqf>R#g?bIND*b7B|nOn
z!7i6z)VlV<KhK>3FL;gs(T`ErAvZ8BNxw3fuVU8Ne+g~Y5aTq%1@ndiQpV|z7rDe|
zb>$@YY~xJld_0dmU6&AkzOxe@lw9A?a{uf?Do#F7tYbR43`R(k_R=-sNt-5&jhAwY
zaMtR$$WvC0^6_t>PP$%s9TC|tZkTmWaspN`3}!wQ*_CRu4B?ZyrAo4fp7`3=d0W2m
zc(4Ej;OiHxQ2Q3;ZSEmdZDCZr1>Ja8Ha5N>7AA7-4jw;{2)bgt$P+5oZ+Dq(Fc<S9
zA#v20i6YKEi4R$yCi`OM7R1U&?R8O`vSE-XLSwnME%_HF*DFR0V;C<aHP`?rQV00v
zi{nCi{9wD7fUd1<iH<1y$$8T+FujLO<V0pve{BHg=^H=?F6Nmq?1e|uD|N$J)go4=
z*7vaGaoEA>7#mD+E~m~8&r|{fH*wFmfUyulDuquy%cZZ>LZ&uS5?5Qz;;#8sxlK{2
z(|ksfT?Eb`==&hwR+Xzz0Jh+S{@IZW<}16j55W2tI;?fEjF|@j_X7AQ^Ei-lztHjE
z^>7L5sC450>w3#n%bp*)xp=`=Bvzbu8{{rBM;v>|+80j8K7H)3ZK4We4k3M{6o`nK
zmlpUyk9J2&H*4xjCLFxIzu3qS!Rh&%k9>`lK_2WUrC`twYNnl|6qRD(!J<lgOA@DA
zYh_uY2}H&UMoaSjcy-22XdrjjJE$7^(ywoXh81)<V+JvjdYx`9EdO;q#V{L4&~s@?
zaAc*ZVRaWE`&;(MgzcV6hiJvUg+O(2&nt_#x%WB8$Yyp>Q5sjr!f_+3<q7o7Ooly|
zlFcas$@NDAC<&k+L(T*&xCsgkLLXacAmYLKvpkbKMA+yMZYg>ie#FVsed5{s>!pE}
z@>?h-1C^X69eR$GlBBvF{lq2=?czfjG>k~aE~6I?9+Slt;EXXvywHC%%kEGS0U;&o
zqS}jamG@xfq7EM2Ue&zx{&yF;7?PGWOIo;CxpML$_<s+k=&agO-7{&3D4H%$WmzF-
zXSzXC#3~3t&H(MuB6d)oWfa>~b2sg64Z^RD`QrcD=L9cp<7QMl*o?bPdkkw)UyAD6
z2{BqeF<3{2=lX&25^NC@rnD>SyXT!r-W~G7&1ft9?vm<4X7n8|!g;IKfyVgeE#!yA
z6u>4q##P$k^;1|Oh)V3DUiI1zl4C)EeSZ($zs~&!#1w8N|KDg++bY)pvr)TP5#xi8
zhDC|SUCT;S>azKN_qX&^lAGD$8Hd^U9QhvzWwo%d5<UhLN9iyk_SbMq-TW5ph1SGx
zynWSEwnau*O4a2u)2N|Z=gAB^@*RaYEMcsb7P#!rQhMVPaINiP&4d6vCsr0ET$n<C
zpNSXzUR|P3q2>_W#aF6+fQQu0g=kq#!A1F!_+3>!DW8`vYBNy2Emtn1)IzXO<jYf3
z^|$U|fMfRW!<nuL<n`)8SbhwT;K$~amXMnVortS<?_|kD%E&<bez_=S|Asp67g}-N
zK#VGQUO~9CYsyQ-u-;j~48$<KnPB?pp?K|W@gPH7$9O(%!#9U}Y~=|CCoB7#c;;=R
zSOmjYyi`lQGKMjdBA2CbQD>_<#5;%~|D^+DPYnppFH1EUjcs2jd25WWkC+rMf`>xN
z!Y^>D%da$Dt&IuFL&n>^sk#v7sX-H*Yc}M)Ga+x}^b#4UF4sx1Bh_@%r&*sQ#uJhT
zHHT5xu~(&ekJ;k@$BTL^kUnt!(5x>q=@95bl+2K)!woDD^(T}>o{-cP8~GEGqMv(V
zHh3)ZCv$S@+w98B-p5w6D}kWRsj7A)=F+80F|9FNppO;5B4p5R#~hkUAG*3*U}Y`E
z_Ut}cqOfNTMP~O@2@rR3^vf(L6GxXs>jhp$m1_1BndJV*RLJV-G3a5=pynvY^wpfo
z(}Zsg!x?S>DORVes2eeNJ#&_o>dq}C{=dr#YV45)o4UC_%2}WA@stgkV1ZMERGk$U
zzy_)>aEP%q9<^v-RvrS3IN8ZWx)?2cJ{mE^&ptPz{({EhZpgSWn<??8)ckcyga|9~
z9$fq#Zi5IY!QVH6IzYBx;Q&IlY@hns6cvFcEz?E)r8&8r5b*fJhO1X58bS$x&FbKE
z%BKI#o?T)9KK`D8HlIjz5r6y*x;clReG<P(-SyvXq>i&P>LAC7U?hJlxeBg~*l5BQ
zgU=2<%VZy6jNBtxDqX+T>_^j%*}B2&&J&YH`$vyea@UK5fiB=tqTvohALSq%{!SQ;
zWYPB+9$^&jlYtm@OBY68%4wsMkjkJG!XP9sNdCJ6p&UIcUJmR-3a>~5P6thuDDFk!
z$Z48C+MOIbCue95hq*j*BjPx%xJg4l(UbO$j+~F`dg%G1XN^)j7N-(EDs=na`dHnX
zb7^qi_P%t^=%1>--y^jEL@!Z$rmB~7^kzB+HEV~fWUKhR#sS6R?(XC7-=4p^BR;@o
zK+I#Hw@?3lDhSz<<(n~^VhAM9KgTacJnxS&J*}`KcN+e8;l?2f?O9FNVl-Yth44eV
z1j(a6kr^`dI%B0w4!O+2=IuyHzlBB`n(KxtFahvWSJ1ewe<%IPNyEjKsOhLWGDyZ^
z-X)P=z`Z^H=z^L~F0)oy!ICpr$`cN_n_u#;e5LnNlH}2Qke0Ae*Rd)qN!0SOtaWTI
z*^AlND2@3%;_Qj;+PJQz_|~lu|9dnvP^&jM2539_bnhK0j4V0yLcZ{$6sko8EXJ%O
z@N?G_c9YGQSwJ0{18KW)HMO*A=&f*vMm=(GP(C@|d&@Da3K4ZhKsaT7gFS@qEb16F
z2%$XX)0IhAv6TG5SIQo@=`}`CPX^Yxzoxp0SQE|s;`Td!faB=Rt?qS4^~I$+>aiRh
z`6d;!lytpgECB<2lqnHMEB~%fWp!}0^4cb9d_eEl<9L~=Nk{s;77=g?Nwz}q6|a?s
zQMnMPe)OhPY#ZqXXugWy#&+%@@EoUSLfItA6YidY`r3bE@tf!<3&L=#3ZBr}YLRv&
z^$J74es_t???%b56$+4amFmYoEPzWZ{91O_*<y)f8%DVg<yTPoT<LOk6us1x>-dyo
z39H}0ID7p$_~*HInb+hv8DtUc8>yt~1FKsPUwE%ADRNLhZ~!^HFbLt1FXuPNTnx-t
z=l0q#vl;4<8CT099Nqz0aKT3Zna!LmQpjc_e?9bj)fyMpFUy=;G1HJo(Xw&**PJXM
z;si*Zz#4<p=5<35++T%yICb1`VA+>9ilAz4XeV&kq_V3Q6*{8w)xCT|_$WMWxrL&K
zZdc*g9`Ny6S&M=9&wAS%kj_MfH_?BxzegBrE_wZT9@9ZvCs$u*f#EUm=IQ5vP?#$o
z4u*D&dKIfL>@^*j5#;Ij11X=0^(KPN?GB(*F(J3l4y&kztd{8`%iDZGP)EZ2O98m}
zsxMR-LF-8<a!aFuARo%SrlewT<#z4#6P5gs7MFo!XCcTc`P@h85Mw5|J#t|0J}hlj
zp2daSAW_sNh$c@#vbVu3x^WAPbbT@S94U6=HuS`}23iNNnUOX}IfsTFxVLE#YAVQ}
zKZM|qKy7#Y)!viEBSBIJ&T|!RQ7tIk+FBPth6=ZRd#vK)_Q$mT0iPm;<ZhdJw*#An
z^cGF&4F{jXUq!W{iS90<eHHD4>GPKPtNz~x6iDnQ>aB0?dt?otYgw4d8;~mi;UHZ4
z_Z!**9=%q%sYOQCIKtI=wWKhOe~nS>WyU@`Rr_MtTY&b7AA;sfpnc<nQ?>}iV*1bU
zC=244Rz4}GYL@Cle&J)yTwfNwght85^D)dn_TjBA2;IrhAk95FkCZ3^w)?EjbQx_c
zX{*0^uwI_cUbTAKz^p|ZjVcAHZOP54705|~drfz<`pVy46BTuho3u3Uw{ZzJe;JRz
z&H2E}M>Y~?!xdu4!dJqA`o0&`2j+vzrlet$<OrA@0$Ogq60;_pFsg(?wXFKAUai(^
zS?xI@m}S+vZ+~jUSAsxc?g!z41B;t1j2#0$SBc2c!!r@to?ijJP}7^0P#D1oIrYD!
zrRvgc+py(MGunc&Af*Y7I%Pq-jd|+zBAzc>iO0m`ob2?Gu8800a6{839i+UB=(i;o
zBMnYwC*i7dwcam_ZNGeWF9r)p%3;oCieLbm-%i^)pa6yDsq;g~B1F^<J7-7#!c!Fb
zd7n=*5R<GJ!z~nK3qBcnhYIVaU@VV~_HS=s7S(p)5<Ii>I2c5{*l2qPA?KwUNV=q`
zk@4UMcjQ;tkW)?LhaYj&_G3G;ELFqgxA5oD9qvGO?cJNA*Y74oG0x9StVLyP3r`S!
zZV6+5#x`1Twq0C~>$8-)la}+pMWa0Se9%s$FVWuwj}D|&p)c__;nXQ#_y=&>Oe22@
z%MrLR3E|-H9%(|+bP;^|yWOlqhk?JR=~d|{r@5*gn@`Cha5DVS+>&O%nOtL?f?yN*
zmJ|$=gZbigYu&!H0X5(<4<+tyIV6&^0K<9MZ%Kn}pRkdWnl_+Vllp0wi_#$BvTw?C
zsZ=G;Xp($e_Z?}1w{ikkA>L_aOllYaQ5Zo@`jC1MQ}<<Ysh(hP(cucR27z+KZn8|>
z=9eTve!zu+J$z8bP$l~^?Hxf`M<uFcg8`jMsiT|dA=;OB)l-85!h3j;WTbOgmRYSe
z4|TQ?OHe5`bkDE4LuMHrwmV#M{B9!J6oAYF9z;f0f0=%XL&vP|)!7(z2`i6Rn?<ru
zkHcRg<}&5wVwJAz5JaQvB~ew8FMXh`1X0=9KwlbO;UH`Bg2V5x0tUn4KEDW?P~5*L
z2u(_*!WLoRQlo<0%B_paux+KZIa{8;QNML+_^^y{v<Q(W&0J;Wa?EcD)ITMsDxb$B
zLz)=~p2JE>V82n<UXGh3zh=oq!ps5|Cprlw9(Ae+;CvJqh%yj^XQ%jbL(sb#cP0@Z
zO>byBpoae&EZ-m&e43036~Ihr<sM+TCK-xRl#OU-9vbc5@9@6V@wAj!P7Vgf(dGZZ
z&q|B~CWt&npIsr#%-JjVvprL2nB*H`1!kG&LiMEj8)fFEY0|)sTj0lSTorf1s28?A
znwQSD<AnQ@nlA^2iQcW5$3Ux+j5Ow1@}20V4Zs=}Z1Dcr2TDYnGURu!u%!*Mo;zFx
z7bu&$U1+!+`T)J%1zZv8t%!Z%o`9KnG1dt0nz~UiM{hA%1WST;&`3Ws!bi?A>WmXg
zwpGL1NM2i~f~l2U-WTo$%jlghE2z#L`-IU>wE_RM4;nznkLvC;;-{J_5~l|2z*=DQ
z)yK@B3o@h79Nb?pF3uA=H4ym|lQd0U7|2NHT?%a$*Da5(>(zt*MY;e;)P<f{$#(Ms
z_J|-VtGEQlKuQ64M1}$yui?zd#ND9;Nl>(GE4xp8lojK8M*HJa$e?8EQfi1WiT3>S
zE=*7>S_A~#Vu<b=|9)nNuGCIk_}()p1eJ}+q?At!BUEO%9|yDjQP#O&H{3!l@pDlZ
z4WlakXxCRC<|9<+K&UC;{w?^}TLf3T3%DMQSGT6R#J;AYgMoO1LN)quP$Unp!fjUs
zx(4)V_zp2G*sCz^y_ZoWZ@v;UMzOIDoXM!iQe6lFO{gn*YsoCJ2tG_@IL2@l9`#XI
zR1?9P@E!(@spWAo$k|J`O5YRwFzG^|UA(+o{-8K;Qwc8bJo8s75R;>j7*hnJ%2JcY
z`^B4_6GPg;OQW96r0Pnc+o?Q_FB7@^z8_rC*<9+xv?m=R_Y;Q!n#c%_|9@^r^&E8e
zx2Z;9=C?7Cq4&`7d|qWDG{c<nbY5(t;kug|f#{gi+3jbJ!srwyKP3-ssX|qpbJk<^
zL$X--w=cwwR1<xgtArC8j*JqUo_945@{wC(WJ;*u#1|}t@*oyKmq)W!p`+{mgWzLT
zoZ~$dpGtCIWC{~LI34m#7LlP8TXx9$KNETBBaja#y+4{***qAx`2}ETdOT9$bx;x*
z)ecOM`t>0mz*hm6C-hc=M8k}+2~t}}RhsG(`x%nO*J$Gzld8K>^d{qwwRxTm2FsZb
zHE+fXk|_zVioZ#C+K5FoZL>=l@x>dk*L7~yIuLBuY+wb7E|{rbh?7V3VZC!;@3*Af
ze1y2*;4zjL+-}i%3?O}C*2!}cw}?}-m+VP3SkgJ^ikIE#<Py<I4P?4uO@zGIJR-K%
z<N?;Z31<f5lj|VqR23S5eypAt@v{B#sdw|YZ4JhDaQM-`>1${e%f0@WoZO8v&|DUR
zRl#T-Ba}NP4xvCa?x-@%LfPJ<<BU4}axo7~xqw;M*nB+tlZt_qmt}}hupL;tcCrv{
z_DLGqF%olx*?ft;vHqXXUd*t5#eDb$t!xV@l$gZw9+bFiI2ksg(m6vxp4T6_l)XAq
zh;#K;&K1v{TRxYsaq4H*PGlmHiUCdo#+yB!XRT;?XOPhV7-dOA4wk~!l6uKO-a-x^
zEeHPoP~BQ*)3T<__xs+qYDM|iqgV^pYO@ee=t6&HQf+6c2f2uuWfGrHwG@lR_q4yl
zCuJb$YtP>Qow40ykdK3L)E86CzU-;Un%;#52fV#Q4=$Y=1ozN2IyUdq6<pV<=3x1r
z^ro(>6N1=E`?j2D@}&U7`It+{JRgw=Pz80fSl}`2^QZNTg!IuHO+>~_IJ3Lh3GU&b
zWx-?j(PkXM^04d(f45X|RBz@!HM5$p-t$r+3l-^DiPg+HOfq_+kkvd!o_4a@?&$19
za%@e?$aBM|A}T^vgJKD2bEw`|M|EA8x`6$%F23{FW(facX>Wor(bzgh%)t-MHt<?Q
zG*LVzKG0Ntf4UdA8Yd>JY3TDpz=aZBRuh-I+3tIUL(g4t5k3|zJ8@j3*}u{59gY@w
zl{Xm7&I&8$D^a7q4ZH#s^MqPUl{15wKk2y+a~7*nBTq)c;HwZH(@grP=UHjI@Hq=?
zjFJ$IDO$d~fdmK$P6uRPy+|&3!QY)1#7KjWu$aszB^4pwQjjTk-mU{}e?plzha3(Z
zz+eEcPH!Vcmrz*glFdIVwQAoOX;1mPSlW#o#=$F|tR!WGY1=dFe5AwyEOle)=XvLf
z<Vg#ul!yX|fkm=-GSKq)`!k%Vi*%oArL04dHEVvKrm#`PF7O0EI=I5AdNnZB^h41H
zrS(itfIB&0pf5v2bfb4w{TCf5gqgk+_v~N`Cf3iVu~vITVV8ZVvs7CXn<Nx8Hcf#D
zdThOTLcz4R6t?(UPfqnPMey?nx7e#p3+4=^jp-l2H0GfccV_07cHjw&9Sh8b6wduO
zHQUWoQz~})1V5KalUy?{>{>U~983%~L3&Lk6o3Z`<_<cn{1_U854IjTUEyNIbL@F@
z`|BRDnK{Ma?PlCNL6a+=Yqgdb)uqtz!6I{CG2gzTw&w0SFrgu&W=U#7lsSLbNWb3{
zCA@Qw*%@M(fyk}aZwHx6YdGa~n#xPsyK#_}ME74MTj%7}HYcPuF;%Nth5M+taIgA8
z)-0h4bEWticQGOheNX<8<GHbyOi*j<B}p;nlDr`UIhDXv$qV5`anXk&s6Beh;6Iu$
zXlxZWC*!VrX^dQ{r^m)jp4iaZ_vL`p*Q%`m=3H(;`jYf13s4QlI8@AR3;UOC7E7z`
zsp4@`{vZ%bGMe<7fPXu|`4pmhup5NUf(BDz7Ik0G(bYbSF2$b#t4Lc;e%$CNEY@cK
zEZArtb6&{2p-`jKb_eZPbjeWOt#_q`muoT1Rfd9T3|#4O%0NB);K9v>?3f9?2gh`K
zNR#adqObY>W%gFJHBdQdg8M4&2~+l(Y&KiL=)nv<#7~w!0K|&V%3A0~S8d5czMgN*
z-2a#l4{2Yb_l`^XlQ|@h(6Q+r!k$>K0(%ei9d;B2m%y9s0alhUtjJcRyvONIrQ{eG
zkZ7S{)M3wpDL&MAS93cvNCBo+^x|};r3`q6rr9or{sYG0s5*5*Me$_$6E{?=O@0fg
zhWK08Wj)5lkD0}cK)}te#*={V@JnvLU^0zsqS1|!=!Zetz`XQleKmOf%pO3{#rH5k
z&$cA5?x3myNB`aw?EQ_UVFiy8VUK2UtjlO_3K9V>`8whoser`fKr%&@xI(v;k!so^
z3JvH@6UQfGWRsiz(oOq_XDw;nt1wO)SZd`^AL|N;*6cPSG%QKz0!lO*n7^8vcGu$i
zFW95U+2k&!C2bXJ68H~f^CkAU%es@FT;menhnPYznz5=W{TNJB1@*r|z)MYes16kd
zr8W^7c|irt-G~R*cDR$iiT1ea^wfia9p<$2JD#4;uP)Ig@*L9#fmVkyy0qeHv3G1(
zgFo4Hb(P?hY|)j1En$jLP0Z{`-+X;rk5M{lP8|65UZP0+XINB*Qqr325UCWET$G<y
zlv!I#>VkqsItTs)WXpi(jHYlq4(d@E6U(7dGUE0)r#bWGq?)XM)tQ^HLxJt8Uf}3R
zW9%i5lVjK}Y7h}{bh#wGTF4*0B`@Dq%T@L`ORKQ}@#B&sFmHNHg@A&M7@v(xE878!
zb8o(@{`gB#-||N^k^i6;lle;uyP8jUlIBGpN5OkKp8?vTjv{*~Gwqs(5E3dqS}8=l
z!0-w$7(dqNdSLy7_=>sBxco(TiHgrHZ8|qnfy2|&OZ>8lTO<@WDb0_gjE8kZEl{9!
zt0dkcePgc9|3Zi|Pi63{3OpubgGWUmYO>9G3F@8Vp%c-*Ks~Urj!ZG-1C!KN?$gJu
z^c%oT2_2;2Ipbl{CrZ;h+E2;<CvqR_Z%p6qiyhCxP{iub1@GR@SRQ3B@{}1S$VFWL
z_coT{p?>a(5&M&Px<D~yGOzcl9yQyRNe(Yo_c1-s<73aIu~a$k$mvpMz(8C!HY2|`
z4yD^u*&6s{PXY-AD8x%BuUp=aZFX6C5@juYN@7iMUeCe}8tE6Cz~I^@AUSQ{Cj_zK
zJzu;mdbu(0$pJcxAYGVQ%vKwHRF%t_TNlB6SG&|OlaxsRVfS7TqX|bw>&kjX5fkaz
zaL)a$`uN2eO+zPII1s)=o*V&eOc(}PoVLL?1F(E&TqrR}x>w*J#34K6ManXGe5uaj
zFLoG|f^bxUD2~e0v+=wM7d{V6W)}^5bD10v`5@@<_X4dBTAf$H&M~zaH<MT&TgA~8
zH|)%MP@{I`Mx;+dt>tV|sHCTyUzW$`jjus{b%2J^@?;(zGzuy)Cfa6%8{Fn$(!vt3
z5Yw3N+y1D{`zk(*fJ$yD=i~|GKDkT(q-v~&Ysz>x6q-Ghv{zMU4(@9ZQr`k!9XKxQ
z<J8&Msl6nv=tuwa!NO3BCa_3B*#IP}A+gG3*l@3toJr7kB)0nx4#XeJNoU}4vZa1V
zB(9n@qIp;ETPwq>;;zHR2|`4z4e)#&CBKC(V)rf2Eynp5xL21F>|uZMgcF?BBKm?)
zvb?BMw)P;8Tyibh6E}7>+*cGaV073>#NYs5$Xnpq-a<Zw={mDGDh}-=icZ(~CLX>m
zTMccPdMx$`2KVC_>N<7D=3k(C&EFiV+vrFk{reg%hT&IrxV)Ib6^l`L)LLujT1fQl
zeNqI*q2_WGQ+;Pt)bErS|91p7DC*}vY)82@$Tef~6A+-SDVp5x2&<8Zw#G=i3EaXi
zW)v$6V&)HM2e-O<mgDZzkM@;pTaZa=()>z3-p+LQT6k3+%&0b~<o}E6hSvi=PHZax
zLO{L0ka2GB`Hdvi&j_Ml(_{Djg=ZEU$CF8n%;9?71hVXR;&5fbEI3^m<hwN!+$jq)
zP8_qH-g&g0@GCa`(M|nN66T(cm9n|#=LeIfgMK!g!L2vCyI2o@L&iMx^65uk@>z;)
z<HgL>Y`*}*I%@Hkt!h(ZJ>~)GM?~bVyUtk5EpDK5Eov=*de{b3p2Ek>lB52|e=lr`
zke()GF&yC){^G~JsuVQHAFOD?c6VbpYXNUb+;CI-3fbV%F@rAK>V-;+6P`{MjbV!^
znWWV9t{&?>tcypI-Dks04Psegj{<(e-$nQ3hwGE+C8M4|Bvg_$<NWO(Koo`_V&8Sk
z(4oB>q;-_gZDNKvOC7ScEYTw_cEN?Ze|ITuL~4SH*256vpkhCoLsZNMkB&L9Z{O87
zfUX&qaiO+VA96?Hg3F~tzV1BXj^$O_j)ATf{1`OuFJaF>jR$Q#+Xo<PIjcj`H=+cV
zHeQm4CmZIwNp8&=W<tnUn`@5ZA}>mS86a)PWBI+xfg20wl-F}Ij_;t?za9IFJFZJ`
zoe>86!B)O|sbP%t;3=CJCc43W9DI$>x_1XaG4TdB6O|eFxwkl19hYb~we6C`xzv1+
zI9W$P`yg!TU>2$v`FEp5N${X}Zpv+<xjI{*8^k+}Gh^ll*Zv+`#)!d_zI%W@XVwF7
zuS>e$deIX^$V15!KI)=;fA5^i^h^Xe9>bu8LutJ?eR+@Y)T(hDB+XGo0)Se%N%EKD
zWk9lX8n@Pg=sAJ&p+^53;(a3QR)|Sss?#3I@j#f+CmlJ>moUn?6W&0o`$8<G((NU1
zI2G$VW1!PkMiIk%Say?8Gd=e0pk2=?_@GMo=>SBqKDQwpZk?8JNt{h1y0m`E*F+4T
zorl*O)zwwakrI~F>FAz-b!)p_39<7+B4>$RXES{}0@0y{fbdAvTyXE`ke3y#w+&Xv
zN;FEuc2s}Gs`0q|^vMVOFN!b|z=1i(Jmh8!lNLz%W9L*A$R{+}lshQ3dnA|^fR*?2
zVg~HOuP69jo5-}v3}1HCcivF$2udfuQXQ8BoZ`dZw|bEFCVlAx1<tLQoHHwZZ0*fE
zUl1o2r9(o&6-Jbce{tk#3$Yqz^*=2HdO+Liegg}P$I#VI_IcxLgH7=|J=AGDSd=2C
zaSSXkG&RnM9MCq7K6POJ4Jw3y&4Y5>jUe`A<oby?$N52l;QIoc-310Gns0%I^>%M<
zi-o{vy%l2L_sb*&U_*gB@Sk<cD%5xm^Q<9HT#3YPNsVdC)a)XR6F%!B*}yA7dbCKn
zrb|}BR#{Q(XfQwa7wWXp6zEV14gSE1q^d(HZy%e3i7z-lLB01rS|BNncWIa2ch`>9
zG1!tiwO+Su*FbC6qd6LqC@yoUajqFSCLYF-9<Ym|8QH5(p_Nw>!7A>ckrV?U^wQ!t
zj4pVGINDpo-r?$xl!WXkySK0CLAWT(EEq;(WLYY+`jA`9RKBxI6yU^>kW5WE%*8y$
zvOT^F+lzm;NRk<P9-a*mc4|lN7;xos2@GxpN*7U(@WV?_Vc&rVSucZ&vwp87KQ^3P
z>neVon9(@o#*a^*p&BKs1Ex^Se}<1fef5I#p}-^*@6Xbn%elt~(04V^MKc1_)1CW9
z790|Lprmb9&nXv1C2((acqsI*%AxvSHffbc>ZHHS&HDtiuLF@WkJ?iL?q6z=_z|3P
znW{`zT`b;+ghu4c?Hn20?X~iLO7J{N+!7$5_1jyuJonFM$GBqDXI2Dw+eOc*o-b)y
z+~)*4$aTA%tyb3_u5?`E<a$HCV!D_049{2&dZLnqhI;Ws1$Ln}eo9Af&BX0C4y(Y4
zLI8k3gJ-NSx0_PXyD6ScZ`ob0n<rP(S?1Z=E?@!lLw_)A;bu#nrk>QH-jTx&wT>`^
z>HWh;%)F~J;?QLihe0@G`m>Mz+G7cO1pWKy-l06L;~xA_o<)ldpLwF#*&NkHgIr%i
zaSzkJBB5Hp+A{xh#_K6~mi0t(C-$Bg<1rhJ&hNuVIZ<h`>BC<SEWVoq*7E*A=Uz)4
z6l{J{fn6xsaf{eb6ES7I#|1Ze=*y8dnMUCli4_JY?IJ(j-V1+nhiF2V3U3Vm%z_ob
zE{!$NZ!393NZbb=XLc>wFxc$_tg{zSDDrA(gsvhd({`d*RgF=XS~J~8^T|`bIgJPS
zBKeiK`VIzxaS?Oya6pR-Aj}BjUCHpo--dLNAbb3goqa=VCx59+1H-1L?OoiU`VmyE
zW!i3$YoPg!k*-q6n26cq^gIbrsjW$}CJ6m^X#E#1mRc(c6$<<&r_yq}({5oMRt+Pj
zv9p)x3^89eX7YVM$yiFl-9z@^7{yE@#sn(Jks#Ao9ye@PuyDTnr0~?8!L+Lu-YE7Y
z+q+MQfA1t*79Kz30mlgu0I1P2(u?%<`x}KOe$f~<dQm*{INZwWbYa2tBOjR;@6bud
zr;Fz!BeVRc<X}LmsoO<L^wls9biIteFa?mO;~Q^KYC|fSG(=|vA$S<Jh>T1vvWr8%
z1fQ5(RQU<U)J$LPuZ17gBoN&DTPsQ1aoywl(V#V}t;Uj1M1wWED(0EbF3?7J(6h>~
z4*u`YAyHHpdc^5E<5s0)BazXiy~;CNI=8ol)P(T-T4k{T9^QB{ZrSCLKAXJ#3Xy_>
zvxbV0aiWETIM88Iv{BbgIcd6aGz#PjrPmgpxIN%M3FmPevM2(%h6dRxxCLP)5c_ip
zsdKjBr+<e#3{Y0_#tvm^6WN6Vk=8S*yvQBNDvQpBT`a#jG+BD#L3wCMm=vE3%WN_Y
zC>4X*>IXX1e?1<k@Pv$U=)eOmM8UBMINfFoZU6^89`w!B6zvJem@(Lf_173eqMrso
zm-XSLJA6SfiyL+<Br3#v%hhV?t?AcdOk27AJ`NVhFFfmMLU(l%S__L<mD9V#0@ns?
zJrwWYEo!RP!L`Q6I-GGb6Tb15t4E`$ALBZ0_+9G><0-?>Ev4I7{(g{V&UM<T7GPZ}
zYfC*ZrXS{{30BUSk`nHCV$`0|LG@;;YR^q<yc~Wk50`eOQr?+9PahEi;Aqu{X#wm!
zp2%R7Gr4EXa%QdO3xK$-#eW}qD$Y$+RCH#Ym!pQTm`m5vV|Pt=a2?&dx06Ha<iN&F
zNVX3tV(sJyd}f$UG`BM#un3?c&s8JwZ7F%ae%ygrS(w+|p9vLU<u0l$F+Zn%D4aR<
z_e2f7ycq5(n})<`q#TL3xhOcdMjk-CZP)h%x;9*eIT+&4AZj-GYzyIY`N>w1{~LnB
zh^_f>2uKR5N&&R9<L`f(Bx{vbGf~oM6-Dk-By0SGGUz-_UnYFI;D(oN_*w)Kz{<_<
z>~@>NaNZ0>v7sZp*6`_?T*x;`!^jfve~(tdr#g2Z|Dh4rdi1idBmx6)ky!{-j8qHe
z&rU6}Hyv4M9I*MY4O4AYVzjAWz$DwW51cgu8OMlsO(fK%cmSJ_(5QFq%$iN%ulp3&
z*n=QA21F}fdmojHW8t&`8`4GkJT3~O?;d%6(JtDyhaqY0rb4Eo?<(1IV#*RaHjL;P
z2Z%Md?F;>C+XLrE2jihQJ==Qa05D;uN)v}mD#i?ZUTXN_mPT3JzMSGKyp@G5#l!41
zzSy(PI+t})&PL|%BrszX>WZ9xkEgi_Sy~jOx~DCo*vt!g5krXFh&sS~NOGVbg|kmp
zt`O~Q3^4@Zd9?+A=dgLXks)v)jmOZ6aV3%Q@1zai3<&!hNGV{4$Xx4b?zu@-IxOt}
zTt0GSOki3QIt|R(DtI_;7(zF$5tCRZ(yeJk;VfXJw2TAXPG`Mx?5g*oN+)vIQk43H
zQ;E4<WFvc`^^5DPgJJN}u58$MB!#~n!>CT`5Hrf`IYa-ozfM24g4Z&>9?<F7KIe&Y
z8TyTfn7u8+%CH@X5D`DU27}hX01yn%MdmbliQy@RBknzXa#9r_WVTKMxR_uAnaM>{
ztKEVBto0P64xJ+FdB4W%Ct>En)471NG9u)8!ykl8GMjo?BhvzeA^LpYg<4*ZG8Ex$
zk})MIZobD<uYL|QKjQ%;3>u7Gq$yU0i$o{;6*<$v2*W5K(hk{m7*>xpO(i_}z+cDi
zt5>-ZUr}aBuV#S#wWUW%_{e+Me4`5`Q6bY9!4H-n4jSPHc2ehNb(N`xsH-g``@(PI
z|9=x1xpQOWgQJMm1@=#epjZefmn8bNHu2ebHM`uc*_5jRN@gPEq_AgBeCpQA&tlRG
z;^vx6aoq<Uq0={(_FwzGJsY+!wD~;F2PK$0bx(Rnu8jzwvfy-qtPoVB^??(0ls>e~
z$-1D)nejOZ7S0kyi-$&Oy4`wRs};+RT;IIHo1Fa)TXHV3D+qgb>e*C(r!-8r#}?Xy
zO{S{a^HDJHybyhC(qr{6vcxw<Ex5?@Kg;ohk^xC^w0B)3jf<8(z_=#>&Wd8F@%&i{
zj$uC2@b;AQRHF#O4-)H8E9j`j>HO_9ipl}_N-g&mYg<mO2~aE=SVt)!KX}fDU1bR=
z6^Cz=lB6tV-t>_+^}qoC`}hZBa_)qjMx8JA<HkP_&n+-)RJcYBJNu{>Tqh=7&U2sX
zz7RIn;^=>{-+QG0)xrsqYcNrC$&dxsalYBBGX<ia*h7awHK;{rgniNbi-i@0j9E<X
z`#(T`p<gS1R}!`9hGXGOT;$7^Fh@dviw`Ng4+rldp}!I7cLlrpOq=KfCetbnqyDMl
z@5^?-F#Qqmjp}<Zhk-%&z~M<>6GQ~Z|MhVTU1v@HlCZa7DRJ^RBdbEt=+xEqp4f-8
zoDk`T@z*GhKgibwZ})+8ruz##OLuol!cPl+2drh}c&|YGWfF@}C<#f1b$<LHR;#e`
zX@p!IIUeOc8XQx0s2Dr&_jkr)P^9hkB#nq^#h~DwRC~xlfoEKjP&QvQxImRf`A;n)
z7>}GccjBEkMO&|Z{j`(VRh0zJiTi-&lNjmUGpGKZ+t=*d20DDFqI@CfQqpfqp|`2G
zE=QsOm%;STlO2ysTF)~ehqsgX;$n`v)w*2z3GUF2JV-oWo~WksxEf5afy`NXHON#C
zP0)q-_}3uR9I>jxGM<gHju7fk#X`|6wWV3)iqaLYfGhoZE_i*SW=>+j#Q5A{`0y?k
zX!?&B1x!?*gPC6{uplKaPbM7Y-^6z^ZA7T=${jlo8HnGsnDmSjq=(~7x3{r%mRH~=
zB2}vWi7>mKOwCFQ#@`>QED(!E3K7gcCt$Se`q!?5Yd<ZNo;+P`Bt1NHp}D5p#GpCb
zgPx_;nWj4rYozyU{{!E}VQlJi`M8lOq-0c@COCm{I(CLQYx%1i{1a3N?w1f_2)!?!
z1OHt!c$0kC$ql?sE?TJpAYuzKS%{G8lbfd;rn-vC5AsMlWR@yt*h9@=5KO_DtWBYl
z6z)5jMXj@{$Rx^`@LF|Jzx_`B;cAP=(uG|>47Z^JD7f|2eL;Aj^}gF}kY=-no(^B8
zAm#)kbL9>0(<Zmf1#<EDzpw>bDYO$9G4gx<((Vzp>^kApF4fpahoKBsG(_pIj*~L{
z56kDxSm`mn=D<T?N)?p2XwnGdK){46Lhg%JLxzEZlF6|?w5>P2#leI?WOHtW*48Q#
zQ3<BdOeHN1DPuTaF<TL}3eHE62>)A46A>7n>goY0Xd$bwvm6vjWm1;`15lj<zxk8e
z(U~$okX6$eSY|!A(jCeeZ-_~-qHe(Yz1)&y3jnY=_2;JjK-~~aNZwI)ogf}O&YQBU
z0jYNnzse9CA#Y&{m+)wAA+OwtkzIZ+XF1$hL(e;8ZbhqaCS8*nD8?coGo9`gD5y5$
ztz}nb=RRo94!6f5j#uz#SHPJjIL!3_H9&E`s!xY3<xLF|L9YBZAu$4^+V3n0L)dr*
zUVLdIw;1k$8hnF!Khg&_=7r6HxZikhgR>Fqp}3po^ALe$9>}l$xJ!j@1$0dNF>rkB
z1pT$l>C<LQ-I4j`J(9GZp_GE*q{vY#sp{h@t$E;cHMc(DgTbAckPX9psZROEO{GW)
z&<aC2ov`gc+MvdS-x?)H*7Lh5oWBXEq-&SL7P*VPAiCfS%6Oj#IXt_<ZVUSv%6t_J
zia6@1pZLd%K~|x`<Xzn?tPc7^Ca#fdoc1i7+5;ky=MJ*5&tFLQ7~v~6iVqM!N<#aH
zx6IncI-6=N=jp2m2%<8&=?mC@<H7Cp{bkd=3D1OF2+Q0<<81Mxu8<IThkhRO#&acI
zw&>Ylh%kcYR86*XT9O%p@%AqZsBr;JDubZ2E8Ned%)c5+myf(Cb|gGsITS&ViH!RF
z#4&gdq-=t2|12IT{QxTPlkFa^GI?`{u<q0~v|#2g`&D7Mn4EwZw3_i*W2M-ihH_v9
zM?(c?OhwnFr^+s7LPXX?Qv00@aX{+WZH;YN&<(x3fF;pZ1vUgCbOcf<Sh1Ka=V|NK
zd4Lwhm{m2zeI_N{Z+bJ?Ja!iDU>potiF{t6zgv8P^duIB-IQ;F|BxBX(=HEF<K^c;
z){}%sV)ZJ_M$yQqO;bvyKmyd184Eo@fe@l#XnsI#&t21SuZZv*=)<YGsz|-wYCW=H
zkhCh?emBbl4J}F+g;PIR`XQ7Vo9SaDf-FqZ-0ipa%xsHl<&29Hx1RAh&^A5U0>hMG
zi7zACqx?QwD#vl1WOfT{xI$W9S=>u*?ZAli6SjDkdp9QdtQm8CVmG<whUz7Y91TmL
z8p(c}f*k}kjZ+byXM&rxRFA}ey(MMxBLBk1V7~)8%&J_SQ}eiFE5o4jm<t6NA2yhJ
z+aGO%AvgS_6o!x>9l#UNG+w~&yyq4i<+St!RU3xUBC{nbO(%Olz2BNdzprRZ7-^i4
zT~^ZVu8_UD3%9CX8O;uV(GQhxKfnMvHx&l#JfadYAgb|}!hdE$uSs%yrKj?PR~x-{
z^fCVBp=!tPi?nafwO1nxmVI-5)7O$iT7n&%UpecNHy!A89?)u}A9?J?zmH^s6vcGv
zqaPcA02<hV5O=&pbvSw^1;HEYQ*&eDWiLS$SY0zeuWXcmIfdrf&|MQZE3o)<Uo5!A
zmo51|H)2)sDf;qUQ|2FMj>VQT8WO;UDOU4u6^p@8jT(|tPMKU{8I?^N0wQEiD1~M^
zaUp9_HrdQ}zl|ZFd|t7KQfN-t7`}b2`s{6}KB1CHGB<C$x-E|=lJRG7*#6|S-M{7C
zNvP<hkDDh7BuCqZ*Edmd2^TGf&|h?QPSLgnHeGnfr~YX#RukcF*u5FViE{jn%XiVD
zvD!n`$JyS?=^vaVyVFshil3k4pdRiVtNe9J-f;awdk(}J^CCMlnD~JFQiVH4(jo$f
z%uXiwRQdKQtpbJamGeVNO)<UoYsP9hZxL=F;iXu-ZiyOxMRGCmi3V}Np;3+V^<e1c
zfKHpm_NrpC!PJK|ADBRsR88jBAWvk2f~B+|m_V}MoR6PA$M-;F_kt&7YdQ-7p$Bxc
zXr1t-L4WH1uaZmm&d(AdBbfZ%Pv87muAaWqtw)ipg5=s`r1EDowh<Z*!z&S6>WDJj
zTHU3<kaAJ-elCw?tR8$lAcLQ*-@2tO7`08M*t`aTBqtj%W}Xz9E$>!gltg-Hx|9Jb
zrR@mdb-?ur#O|8m?w?ckG{?v;<?5tTKc<`bxWlenxQcF$XRDM<NbyH$d2)&xtRzf#
zxP}gGHU?r{wXMlaz7LjnsvP!Z+XqaD>0dajGM3p*jt#f#iX_cDSmoN0#bd4c8_NEs
zo}N0V)ezCRC-rf_D878N@!Pmqn31j<^kX!5-^0}AGxU4zscCQ68efBv>0$aKVQ+nF
zmt`#wv>6k7inupH?@@l|Dk^-;d{fH-^V_Qq)xj|)Gwm2~GmC;om8a@9I5&6)x%oYS
z5Z!Sz5WiPml%h-ct#pVmDobirb0yYAAv&i{cv~-OzksBji6-aD$au*}_U6+?E$40p
z;yzvSCiRt)@wU=_KC^L;1{<*^(Yi_#xUq-jeGxIs2qBVa#DbcVc-#A7B@pA3wv?>-
z#tn$^fbdejHrrHpaS-r&jrl@?F}yDN$M=zaG;vVQ==61%GH;LmsE$FXo!SIpv$nQg
z;*s%!E#F=V(y46JTK&LkE*beENvmLFfK-$Jv-5&q3&o)+i0^?SjWzr*U94<JY)S2|
z`7+(whWNX_`XduYub6$LY2Esc<njzpu6iVU-tCBU+4H?In{6fwQ*dCrE3DQAAk0;$
z*f1F3d>3M_fr#}o^WZx^;fUQy^jYs6+QLykVi|QA2jE)@We$IX)tDi~`N^y8kwqt>
z9<e^w+lv!PcG7^mCJW+<i1Q|DmN=;(DT+rmY(w+!V4hf6KD=v`n|D!lFp#&mbZyGh
z;6xr-@jHwd2(WhZpy2n*bA76)IvmkZz-psI%4OedD$Z9{&#LZ+6fFB72F3R$KvyL*
z2h7dg&a_-WZXq`)5bY&Ctt6c8d*q)`KfD#DZS_>DlcCuX632j;K5lFRPi}v1gxlt9
ztRzkp-=y~6CZBV0y6svnP#>_0goZIq-FC^8HR6&JzqxH<s5Z_o2hjiLomxUL$j;J;
z2aH%vzT|e{<sY*_WI0z%SWey83nGqqH%I!<UJJ_&ihi{D=gxvv?Zb<>R<nJ(wlm?<
z*Y2}_h<EP`!H)km(0jdI2TxGa7oH2S6btVd#3fi9^XGLo(*p`NW4at>R4ih#oAQJv
z!;0I4;W2Rz5XL#)8lW7k#v6jdh*{-DxX+;<iD{%=xX??hj1NAoV@_c`5uqd9=v2gg
zL(B#VV2rZdk^$o%C`i9zk56_?i8dxu(otNyqg{J`QcgAVbTHQ2P+;{4P7*oYL%@<y
zz#*?*{<$+s)O2w`{dX!YR_Yg)!wqR&>_H0T-WoeWV@xc&SJumUPy>`#R`Nk(F*sgG
z3YA#3*@*@{PzA3VzMXSQydW~tig&O7PHnd6`fqr_sCndR>{&OkbfEG<L`a#OEkjWS
zBiNAROstjZ7VAuifnLK~zHp-myih3r-A8fR#m<NorkyCi3n_`e))}wdWROhX^|hi0
z`p%y@c4F{m9K1c8P7u-i$p=*r$?>>iZ1Rz-x{cc^;bVjb9F09nfu-yrLf@)K7v$z}
zrLOi_M!6^M@^bHxso9uU8Ugah#jJ;znw1`XB4`R4oZg58?l!f~l+@S{KLUszg8tzM
zw*1hOd;P&iXvJ@n^S!^AoMJl*=~O3YE8R^SiP`!nHu`yCKMBEaqe+UWf6aBoWM?Fz
zAI8Idw->ESL4<J?>P@8;_%7Aq$IJrW>7SG<uX}sI(3jYNxer;S!OV3@w=v_;^-t4B
z7lg!$)kMLIJdEukovOS>5bL2FDOYu<Z#V4rBMH<A2cf8K_?5^z?k2!QP(13bh()RY
zsEDjdr)TA78j~I})2Tm8DdRH_mq~o&l%*iytKKXzaG?#nHZajBO@j!dpZ<~5T(r2z
z`vXi=*?BCESI8zj(d3*g;xU}j>!>a;>h5evvOEHYmIJ`<n*kNuJ|j1_LR8dOjL|?g
zagT{ZwzG)UqF=gku@^=4RG?rp=3|>&41-kL4(EM<1+>oyDfPxZ30&{Q|57N<u9azF
zS38t}=M^u|acJJA&y8WP;T*;4ZMW!x8L~rkc3n8Wbl^+4%DYcrU#o@j0Ml|Tch+c5
zyGzP|TX00&N8lpqF#~!=khI;vOqv@@P59%o`+Xn_{e)2WuBglbu$jfye@D4VRYl0#
zd!V?>?sfM-8)wqBb*=kGx`@M#{f&C@4DlBcGu2pj?Y;@{N=&g;!6~R7g{b+`${{$v
zwI)Kw+L0QrU@T|X5;Gr`egAM}v`awojf5<h$ETub{GzUc8E}fyb>~(l8}|4FMNGI%
z5^cN4l(3Gj<aV+NzZmx3l1W&_jm<umV<CY70E#QF@gw(|KbG3f<P0}j@{R!fu{Q%6
zHxqTJ8hbxZ-n4C{itY;9Oh&KDUj%`qILt{0%QK~32y(sj2|Gk=B9COH+QO^+b_Fl4
zp$b-WW%5s^v$YAVTPB%103e#hFLE+-MFh0YPY{LAg?27_;=*X942{1Gq5c#bbwNji
zj+uNh_&<;e8N^%VvTHjlcD?h^*rOyexX3KQAMmF(nb|0kuN4uEf>v$l7SEnWlzoGg
z^wqITQM+(GBw=TqiS*f89-=z<!LG|ujF-@x7~9k#!7v0{jlakyKOX5Yo%PFDHz`T7
zVnM96(Y7}iuz`z^G-Q}#jZWKdj~`gRdS1s*)E~xEe<i}`#hZTv6jCmaC=ZTYyD&c~
zka3-tn0rWwn8e{d=}Q#9jhUMmFRwEcy84fucH^`SW$wX0vFvrf=p0CmVRB72_{%$j
zPXhO4=@gNAgjR#R1xz(T$FUMIA%NSX;j`kuI$}^H%?T#LvGZ6(Sb>pjb`ct61S3JA
z;|?))>Wk`R$$9y6iy|6w0h5+0gCsAlrsOfD;x%AN52o{g>SKFTTp2mo_Nys8aUA+4
ziQ?|zl(aG9_zZgUm?7Hrvc|~1Vz^JPgsLG)jhql|2|&CSH(7A1<D7Rs$K+Fr?N?WI
zWZy&N3YXZiBbeW*(~-_-|8f2T$|W*Tdn&6=*kO27jp6g+<p?SL9ZCO#gxiU(iJ|IA
z**y=c_IZ>m^)9(|r)ALMPe~F~juRj7XqK&nflB2a%Yqd`c~lE4uuMtis~w;9aX~^#
z3pThxkaUdNjMu**f*^LLOz9PH!Jk#HI7}`{m8uwfz7?5lMygYyB#9X?0Clq}O8leE
zT^HwnA4Jj-AaQYdqLqf<R&W_p{sS4?i~_B|e??^OwA~b~=T0t~zU;x#XAyVjG@x|W
zL#uP_i3<kdA2;kl1ab1WQfc&mCHsfxFoK$c!>&4uO7vs{`h9U)BLy4$d`wK*o>Dkn
zP=!Zehu6xS68*LoyP-p-qHjJF1|7oBVReR(CQq=r+y+Z!*QSr*0S#=*XlS{6u(gkU
zzfOwkfoeD?LkgX%LB&?Ff}G3wOxlgb4nsc<413Q!r_XyjlR}D2aPYfS$-*OXsP*V8
zej4yko(+kh@2$q%0Y;F*^*Lvu*LJJ3mS@(#N3U@l<W}m=mPDds`8Sac+xQ!v#P}rT
zqMr?t!eBlT$n>k!d7PH$LsnD{CP(@#=^RlqN=Tq!=<{|)$gn)Q@OaomgY9JlXiyC#
z0pfMlq0_AF%O1!b@hgmY$yprK>nGUd-wHy7eeh1?l^XB@C&U9&E@%n3sg}7(S*kYB
zDhD*mtYiJ`$h4obZu;rO%uvVOD#(mAL~H21Xebt3YJw;^_z|j;`r5u$`TjKcCs&lo
z2EVzdm{~vQP6W7=g<xXtuDlbqo5+>~o^m@ej#WUx`xJN;{%5`VEXE>+dI7T~=!nXK
ztxY*t6E5I2BYnZZbbEDEg&g8k1z)v(%z_Quok?|qs9){T-HoyH<S(ipxJ^uEMdg6m
ziRON!=mofyq0PDvx-ehm&cTNp<aPKdsR6RFb3o}v&{c^t8;FA8eh&dh7!bO<UkT_4
zEE-m{`c_mF4*v!tS)=#8Pt4`n$c3;t_X63=WGC(wbet8xSwfozdY3=!5UX3T6yP?{
zypC@*0aU&v%20%1V^TOQSY#hKXz>clEyOaO#qo@)T<$Jn4^qkd|5sq*$Q3gSk@H_Z
z8pAg5QVDSXb~~)Yu2ODBxEd<R5{|20CxyYB?i*A%c0REN=qf7JRz@7{>@Zm$)4Yah
zzxtt)$?B9Q7d+vbwnRrG;5TLWtoT!BE+lkOlm`jsaD+A;cisKbB^IAxU0V7Zf+ys|
zJ|vm~=&4C0o}xp@f5MDop$RBAycS<VX!36&9A2oVexT#gxcPG`RZ_$|fvf)I==xzb
zrHHu3)N0|?8kUQ96FQsSR%K)A7j+tjm3%#pr;Uv5iVl7x;O-UWb~i0zxXjmc74hk3
zW@<lREs9uXV8F;pd2+)meT7=%3x-=)reecVMdL@1f1=I$83p}Hz|F7{d4FmKq43ZY
zF#5wJz8ETBN{?)T@W=WaTp-oTvzED|tM5V}XSy&K1V|gH$aD)xW4@e_{*b}Hym4x?
zo?k=$=A{_%{l$4u2(BCgTZtF3gZ-5xlcS5>!XE(cbx2<tH57ILeW;ui=P{WMBGJA;
zvzxPdTlTn{+hPs#nRI5wA@{G6d8;T}re7+)QB5|a%y6P&`Y9|J3a1J@ccD8&D3|=N
z;lN2MR15#&9!tCP7=P1%s3HmkX!|(?p$MUi7OdDyYkL_bFx5h1r!yV%Huf{z1D846
zK$#PKydS@6nH%$L!D5@xbKXQfGo5*1oZ@#mNM)0a`y^;J#&8xol<k-Axi9Fr(yT;t
z!kgTr*Y>%jJuCy{T7PdD%3Ty6NzVNWwqqO42rL|RdDak6tR<Xs9$3SHm9LpPWr~g~
zKL~}R)}VJxsRGgscqI*Sr8*yf3sbmrG4XG%mK=G+o7pXz<r8%P58>+=AgPx#%l@Nb
z5oO^Ys+d`d?91-QrLGd7wa#mdnsN`uDJWIj@6~mR3?N0jPMY)=v`WRBJHi?c)a6FQ
zIU2Y)@YU?<kts(8)Xf0j4<|~8P<B;m@1>!LJV1vvww{63^bR^aQ^t;lhXNHx?tuHs
zPx5zu3BoXc*%lmOnC)(FEbh-j1}?7xo@6ra62t`woXO_ZjV$8QsN8K>=@3pCk_%;;
z$DOJ)bZqgC6%8>8X=O|H6+J{jXFH27Fb9k-;9+LsQQ*#Q?`}0oM!~HaBm)*g2T7CW
z653T*qU@WmIh@ksd4q=U18~;4Jj6~gIdi?OM_vyKKTj6jQE|k%E>`otK&kakk=K?r
zm-Q8<!?P!q`UgI4w7C|Qg7h#j_lwHEz&a>^(;_8*l^27ZP5u<qhV(furHVvRfvV2`
zi9VX_UC4Y+wHW*@JGuarv3GvLhaQxny9uh4bVR^pTX3Vn&b`e7=6RfLx^PHRIjxbH
zivnDopv_9j{?zNGe}~aS<wVAhdaL0qhwVfh#}VZ^+hQ)~9b!x+P2!>@#BQRVQBZ)1
zvTF!F#v}j?4Jcd{P9Ap)#2&oLx<%6G!v(6XOYtQTx+tbWWfXF2dh9un^e&p{hvL9K
z5EWjD6@YgTX5y2oa;U2sk}dWM@bZnl{|+fmmXPk=*mYH&1GX5(!g3{vCEH?;i60R5
z(d3|`bld0St(V`ozQgA;zC2Ory}#9FG4MpF@IXUNh>PZB53J@7h<t$CEM0)lTVTk*
z$Bxx=U|_^-pPBojz-8-yC+Q}9q9_IC^KB#xdZ}*f1tb)2UXA0+uSx=o(lc!sNbE+e
zo=WPNKq1>c(5?0YpX9YQ@vp^ShgSL@Ztz9Eg%eL;<kQ39r7B3|6N!<uur*>pgW7zF
z>h&V=|7OB#AEoiFD%s_O1?^R8;X4wHmEzn!oG7qOR{GN_hSo%jkuR-4z#rYK?P6B_
z(rWXeTY}Sqv&i&aykWbD1~z3AWpM^lVt^ea5+WsfE5cb667`_4;3$Jw{HI7?;gSlz
z647oJ@Z}X*dLR*`8RG971I(L7a*y8vEdUpRF9QAu0SRmUr5+*FgwOt38G1;Mr;=CZ
zchxM111el<HmG53zIBoiHM)}IG|rk=2=4VR7=;IwWl+LbpYJ-<Bg9QyW$GTAM!K2#
z(Wr3C2f|;Mrt&HRBs@BHAILmLaf!H$k!YcmtQ{I_a^DZ%u4XXjpMq80rqChdhq!y5
z_l8LM+h5+y7ZjH0_=NUUX))N$ETu(eQ+eH<P!fg_Zx>mQS_H=l??T3QHnCc0&KpAA
zNh#<d7&eM|a3r`3O{WRWvQYIrx4;7jzzF7rk=)U#v{HSwDfz)GDu<eNvKvr2=yBSD
zw^v0zM~_)319C)@1a^w5Nv^5p+c9Xr$?hFRDl+6I#*w&7E&HIMSAUI^(&fBVtf2dP
zDP?IazMj2Z<ZDO7ZsMOP^tI`+`xL^v+iC^Xp`6U-3?(2WO{=10U#oh1tPh>sC0yZM
zD~g*dTZOzqalX@)N9&j9c&%@YrhIRVk`!kj!RSgg_SP_|^~AoDd2dw=YtuEt#h)d^
zyi;=6=|C3wxe{{5ddk|1(Dcdhl({UIJvC+6gK4;M9v80<u!)U)7zr6r&-~H1l0fT#
zieo!s(`Y4loKhSvc1~a7|EyI-sf<++5@^GybkFj*%%FM_8R-kYoY-2Q7$d1x`7|dr
zbOd6m7K`U9$WiNDo1gm#p&w8$mqsi|VK#=FZr@~ix|$tjdED(!ZcGu0<!DoNFd7f^
zN^6ORF!fo6Y`KRgG|y4=s*XFoW9nE97b|=)c!##>p;Da_G(6#(hrkRy5)MPlgijED
zmHII>*4K*q=+uCwjmb+$W|PIse?Q4QTNw{65Yn*bOliH;j{&R_&aoQAZd)(Md|xG}
z@g&ZL?U#nRlfB&&dG0#r|5$OJBb#4Scl_8x7-=>*4rf>BDtLG+;1Y1OTG$KhVH*t;
zIaOJ3WK}(9eXm%C$Ze$^reU)4nzzn8!PguOj^B#2dax72I|EaKi7UDKV+_YMGD?nt
z*ozrwes%~>1GxTa683WXCNs6}&@&`N_?+$z|FT?-zQKLrgX;Zs#xB{M-r^TBlv>9S
zdx^n}nv)iZEd-Dw(2>pj8?q-H)bV$QXjI>8W2My7z5sPlT2n?drqVDVIK^8I0(B&C
z>`9v!;o1d+{Y8XkAqHH7BF+qSxNrE-oq(T~c;@TM7_!4gb3*Y=cE;!r<(C#Ym`skr
zA>8*En9D5R@;FA`djeyqWPH$Vq*m^D+3up&#0mwMVhHf*zeAC4I}kI4f=5?Y8b9J6
zrvB;_GNA!Vq6RaC#RXlal4RY7jQM;>fqz##Fvyj$B{E9Y&7+yNMjH_(c9zZ6xnAcq
z$*)aR9RqmoU+RH9p%g%NtmUqx)X2SaYa(Z7!Q0Pc6t==imKrO2-c#xZ@YjtzGRl$*
z-MpDM)B~=gDPUd7Jy=Nh3Z7$@rLw*leAdl_l2DI|t!-yx(HN14ZJjs+b*llzh)c3}
zDuCC$sK_o9I0a4BU$a1Y?5ztD%WZ0~VKP_<$q@12S6-;}KZ+m3Ao&fDtydNo=)CL7
z{o(!n1)~CX%_Hk<hJd8&gH3bL3SM+WQls<6GhAZ6(wsf~Qvt;0wNv+rUWn;f2A9;y
zQWsc*=ue3Br*Wt*H;QmKDv=((SYQ5^FJzrMR{QX*ik3M{05Zvf5aLHeioy(Bn5mmg
zHMfn%g*~r-mL|M^qGMFbF565|l&-5SnUxj|z3@&PngUj%mEZ)y!S=VYt({<s?+Hfb
zenssPP5U2iTlITNtTI$f3b;N9`ZDOaIveC@Bug_ODL;)xbkj*2scao(t4z$cpNy(&
zys>3mb_EFP#$m=n7(?w;@3n{&p4g$!Y3)`hIF{&^%-9lRQvV7~6ugL|U;sW|*^XSx
zwPw-*WtH6+wr@Zz4v1G!?`B*FiNip>bJxy@Lw^Z5Q=B8V{gcLZ@mp2)3OC3D3I1JA
z>5Q?{agMzO2z7y-ofdndZx;;Fmo1ConkK#1za{Up%r*nY_A=+V*7JJVUUMxy16kxh
zH5fhzU(a};{huwIZ-$}nIO|ZC7D2U3<xiny9Oq+(cl{}BuAmz%uGl;!OSKa8TE+O;
zXw?gaPtQlQL@u6&=LQtt=buyGa}F$zIbZN3%1MOMZCDSvZ?mS7c)#A?fStM|70YC}
zs9rtN@~v}k%%ye8_bQ4pL*UQ>64J3w6z|1SFPPG1s`o-{RGxYNJDmxs+o$X7eVqo8
zO7`|<E&zGM0wUb8F53uwK33aW=>*N2R1c>){<Iv}bGAH1={Om5Lp&*`yE@vkO5s7|
zn!n-QI2qNaprlV9Dz^&ajJ_}<8_s|Rw+4Y8b0$_v1PNDgTWj&APxx^I%)8F8M-Q7>
zXVNDO&zJjbIH4Q+^$&cK(|`$qzvoJud*f+cuts!l)a(BpHJ$IT?w4)hA36aN>=%jm
z@=+Xg94D`!c;*{9lVUnu9Van?eG*SlOZi?gJ&K0STH@9O%te|PlRHn0nD1(KDkUsq
zdOihHvzc=B+(77J?$3orBI5~ge%|Po78>83AXIF4Qaw<)3w$LOv0^|BF)39b#(e4%
zJ1T+$Y|xkvA`9giZqFqm3o25?J<bTcX@g=~J;x)$cE<N*9yzvYXNOxkXqkHh#Q3QM
z=Eai83_`F$12+0lCXyQyK7MOM`C({A?J>SjccD4;f&XL4xy~)(I5pAtYkg%R-~9$b
z%%4#-t)Q3){W^xcQF~@~l*oUwNmCy8{tv1Biek%q{0Kp5bpY8q0JA6~`z_?my;|$%
z{Zxih$Is+WIdpd@wbDDCrp9^1p$H=Xs>9{-HAo|MyU^N&|Jj#Qnia`fGKdSF;|LX)
z3$1OKU#U>7$)qka|Iv$7y>bk;iSf!Tm&t%UUsll&ewbT|;;Q_ub<4n4nI_LBRRvyw
zv&o$8G(ncEfpYo9M@c!M5J$Y8`N>ELc}_UNvc0UPUT^KYg{XzM|LIjh@?#lkVXEGv
z^ES#bl8*_f3xZBj0$M1$D0@ZLOoEg_@O{M=TUZ+2a!UnNi|W*KI+3CfvsYPx1j(CU
z8A=T~cod3>2?Cu|W48qA5X28hdBkLYN6aNgdFG3_H%18H%f&{0uu4MMEZ>$Ok42h=
zpZ^%s3AkUz79@&$5I@2`+!W_8TwLAn_RuAi5+aSw<r@^OUtNR?f0aZPbNiBMpza7X
zhKQD9z<{wFAl&Z~rd>_tQE3YLlNUSMPxq&dyL7~k#6iS<Fgq<&x9`_CF>pL{$6R`3
zmsMXl0CFAa!}nX*zF+VPf!^DM)LC8(Vzf4ICq~@EY(w3dpv$sY$Z3;lsAYHz?ePj{
z5yQ1;*`p-9?BRrraT0`tX+~!vIC}6f8*D>E#wCsc5Jpr?d~PX~*Af<?CK_JijZ+ft
zny*IuXSf@scYDcMMk`eA|09&AEke(#03#6T!^?80w$~Rl^r}U`)+VMJV=(#0!tH2W
zZfmC=sJIDwKApdjo`cPn^}IX*RpK^7@rVDD%}Pwpqo%0F)0)`$;%T*s>mo_Z6>CBB
znG{7lp6FZ`VNG_f21)?`@ydO&B-?TVgWkCF4Br=_+tkjKD5=dPsYi?8_n>cdfkzHk
z+oUP0IjGfQz^ES%(?et_UUl28qy~#glonXO()LxdgHz}e-a;U+ANGe&)x-2KxSe71
zc_YM7%L`%v%oLxD<LW-Oe+h5Gwf)xnN^D%OEc>iC!AB0>Nf6b&VEA(@^;G>1A;y)?
zotY-y#1~J6OWA>Ly=Yi`h_5zortCEua1<;KzGXG_95yDI{Na_LF1PNbQ5>bZzrz($
z`wueF+j-Td=xtJG*GVI_=%zT4&A;x|npAAU8)?{rHlp$oI@Ke3yL=F6qI-dCTB{I@
z+};PlN53}t=LJ21U-K6(&wudLYB24Or=!7CT*EN5IV?-lV<Kt&T>U#LLfRtYTUOy}
z;Oa1<^Sf4b=30jfAHs$_Q&#-4v~@iaMVVn<U9)^t8tP~K`!i0RG{HOX2HH%f>U9)I
zd-i4)V&@BjGALZ{%;k!~vn7OsG<4V7E7GtvQmxti-3cDnn-Ecsj}aQFbspnhthI3^
z_`Dl96*GXlcXlq8nAlSyV(Sapqf3OV!!rF>Mh}{hk8pxFxsb1G(RuLFzBaVCXTGGC
zu$7*X2FHE`!KDX9h32V&<~4}Pn~U7!bQniU44YbWBjlVd*`1_C>dT`xx5+(xFTw@-
z<m})k)w*)9Jq5Eq%cA!0UbAVVDm6H%Ik)9kaSA%i<+n&GRA?Dbz}R6ER0+d9PmFHd
zbK}+nesY@q?uI}Bcc&JMkdSS#e5{mg5A3<oj;gnJ5jcqqBr#zY4e%dgRYr`YPRzp`
zQ@ky0!uc^cUTI5y=QggdO|?6}LTF<6Ilk6jn3padMzTLr-9X8sjv^MS$D8XX>Bj|F
zA(CgZ15-ZCeVZI|62hY{pOw?5cOm_UHj|l2u&${aYsZVE6|vko(Dg?O!3G6r=<KWv
z=nG1$))KZ@wuMfSSu}=dL9cr1IsE(w4m=O65hB?UlYZN}q0KSE0%Mnm#|qR0f!q9G
zia+)nJKUjiCBF0c5Fq*&j?{j9RbNK&Jkl{>u+>!VP2cx(`zyB7f?wQIxfH0)#tmJd
zLo%9zNo0R}<5oY5f+w0yBIp!khb9E`0*x+#6w5==^X0H&SLn6Nsa$$fw{BafYT{V@
zgcY&q2f{&AFM0UU&G^byBai_T;`L27>V6H~6Uy8{M(Ibh)1ze+ar~0vi?L}T&XIKt
zW4vxCmGsW=U}oPE^SR3^HLF(lmo<<eS5W}=)h3@SC1~`=Upuo#5;E+X+s=-B^QJ`5
zZ{d7_fV%jE1KJROQhNmnmQg(6-cS2NNxbaN>ucv^=Bp<|x%U30oD-80li;)p5d2Q)
zV=O*#5oP0mWxzNmuAr{aXy^nr!rPoA^NAj=N63<A9jvKA_}$E$LKtT%Ou4#+gd$Ys
zkQem*a9N#b75%>JlsZ|gWZc2@>>g=>SYtXe$;xY1zsF%0xcmZMo#ob`T9XBHS8DIA
z+#5q#=No6*`jT?yVg2x>M8QyzA4bi#JYC7_9F%U2fBu}(>7hy1F8+eOEYgG=o8}*$
zd~?oeu+O`#2e#*4MN>V053HW2kPRC-WB_|`Zwdgj3o>`ro};~s3<)iJ2Xnr-wHo>K
z$tMs$O?DvSqyUiqp(I6G6S0}y{ubO2&_YLXgsw*8kv3*DGZfd1l(XRFD+7YHw$UF?
zIr$UHD`WT_dj)vtwaCea@9;Zz3Eil_h5baJSd?BJZkl1Qy9^q_MDx){dwrZ8HB1|t
zWL!EF9d08mGsWw}4arwGfafVMId-WCp$X*%sr=OwO@b$JDzvn?UmBmot@ZZuFlGuO
zYO8H`v+xX)k+X_<lP4bL$VS^oh$YsXwXtO-OZ-Rk$)6V7o-1mdfbR`iZnX>gQ-Vf0
zXw(hj4T;wbKIAck0CByQuAapeNwUmh^oMPg{M;213c&I0j3ym05hK-2fLtx4AN;(U
zSd-h+HoUyZ)&1y}F59GO**LC?hc`waC_>BGed#O8$e}km`_biisUM!(iZ>jkat#_l
zk0p}eVk)eyc_DQorCXll$-H;)tbD!r!H9KuTue@j$xj>aq23Y~tf4J}lUNbnPx2S9
z)s)byj19y_q*&`R=xZkiKt_%>CsZh(ZUB$}J8t}cdgw8(np`&sL$kE5QWeTQxCV`s
z%uPVm2*h0*+b=ZI;AQ!qeG!0VxX@H!(<SgS!kH+J100IV5ObpoHQqJfTN>|H0BJ?@
z)wYu=S#E`j*by({Dzr~b^4;7Y6N=FTNif0jk4s}eTxW8k%^LEYqL`p`7VnvBQuUFy
znFF&!Ko7yM?93GdqI6MZ;KjE1GZL5{v?Kl>zzmVKx_Av6UW!JIXD<l5Gi&F6`tsaz
zpRF$o%+;E{ZrL9N-fQp>E8abAD;~cWH?T6#>s$bBn$H)8N~x@gok!4qy&qUuZ*AxH
zmpnKYiL)Tbj=(H;g{0D^OnYn*x4^TqdrXeu2GM*nlzQjX2jPKx8Vq^+_9XDAH*9&%
zij5}fyda8tEOd4|Ngl~S$<g52Mv_;AWdz%t$?Dr@<-21d6Kb8@ULL{k`SPH1xwSg>
z-twK3HTFkaf0l|B6RzkZEjatl=MXI=B4)ff9)`BY25lTR6@|$cESNFVH%YKy_WpYz
zajN`G=gaC-14Kb&NkG9B#fBCZi)ItFS2PAH5u8cb6<>Zyc4(4NYlZ9rRhk<`07Dx{
zCB$|{{ekBB@4uxBAW_?q*v&HL-z?^8P~igv=Gp~Tt1qU13;$V;bUIoCcaW{}4pZQk
zF<d{mo3y9hT90xjJGsF_(rvIbe4B^rBb?%#sWbW0*Eh6kuUi;eiDD7h)cP9h1LC!T
z5={UqWo4T6wA#>9>NS8X0)1Ep)`4sI-F^qIbj!;W7nDEG4sM2F)&}gg`K+?yXMIWE
z9UOX}axF#!xDjxIV(7K&xp#?M?GFI&{K8v7GDAZjq1lz{0v?#k)B;8lz1F|?*;Fd}
zfshc|0NY_oU6`^878{6WBC_tRIxa?n<A!Hp9zf{n;Bc662vTE|)zZPXQ;vXrKfn_v
z1?g6&LUD0jHS%Fac5D-Q6H<7+@;gT+EoJIK2>)Ml7JN@A!O{t+HMeT-CM1#fzD;{z
zm@gDtZ8&xQ$Bx!>#>9n~BtebsQXZM6_>R(+TUMZszF@6a>z~Q9*H{2}5qbk;Hub_9
z`rnZ;)8#pk-GM1?hz2g*iOavMg*o_sk>dLTG<*x?!VFrk-y5&}SkWhwP5uIch)!2D
zCyT`@6{lZ!-hMRp(D*I)m0QngQ!p@bQ8fcv9LeHHk(T{Qxn);aq@vZ^!EF@;ObH$4
z<Hw>WXQI>*)rWcDAP7Dx^)DGqLO#fBpG4@<RKY&6q3k;|9497AVdy(hCuM+>FxVHk
z75XoTu~pTXgBlmVC%8boOlQ})XlW)vnGYn@>=(T^sI7&DBN)}?oYm@u1x&@JI0M3H
zQdZo`9<<w&hqqbiZb9kvj`zrmRii=?ACECsX)H$QM2*Her<!-aY3V_w%{1wZDkOH%
z>^wr9RlyyIy6M4~camYSM{K*|IAX8Iom%j^ck)(^`T0_MDv+}KsAKs{@THi0>ihE7
zAIH|v^%(JAX$%QMqg}uHCaKCG%xUU;#<1V2${7)Tr`=pF(sZtSD5)N220mvdg)aXq
zzRv(L!-rTuG%wWEsjh)#2pS(EMa7+wd~og01f^FuQ!fpMp-q#g%GI=;y-QEuSq>HW
z_LZH>x|cQ<)^u$LZcDTy4Fo}1&DkHY{h(RvJGc3Z#4N>q?IwnHx(z%7Ve*#hiZg<4
zyR4iU1e#rSx1oJvYG%%hpeoBR)C837dkE`z2C&j}+fuLeu7vJSl*P>0Rckq5zgRs<
zbL^6eN8tI$@$eV#{{Xk}oVyP#uQ5b?A@0#mX6nWt6|XuoZO>Qwlb7seaLtZn3g(&H
zW-(H?*<|b$s?=fpNFF)L0pBgp6(<_6V*bN297#99b7lHb^(yrs5+SZsz-`|@`Y_Y=
zfR-xW?PT4XUE5oi9;tYAUAI#}3L=uXXY__a3EQLA)&Jtj-+%0zB5<S`J_n5$uDmeQ
z6rEE#uP6YLTq@0Z+h%Z5lhlVkJ@~M$)4$Mn$j|HH^M{(T>zkZfOZgLfy_BIW-_0o&
zY!1J7S?84#U&wpDs1aXnAU0=D4-2q=|HBi+%*zyRM?;)@={4$Q1lK!GNd}Z4fBXg)
zQ)ZST+kk%fWEJ%tJMW~|X0;;{4Y0s7-Z2KKvbQ%%Qy7Gn=g(?yg5#I>;b@9MY_dNu
zaXZoG*=X-MQWcc~-{ToBbWDHs9dpkJymM=FjT6Io-zM63mhIX<Z&;x1Aa@w!waEPH
z`~zmMrBH6X39`N9QW4l$tPMFWm<HW#tCX6OeT3Al@)J%H)amn!$+t!R&%&dK6cV6V
z^k^n?b>U7OktZAP+YESc2;Lt?lc6PqHZNI=v#$wb2y09&D#~B+o*<4ut(<Q7a%U_0
z@a)Bhr3O~1l6IeID{tGKSiAWe-18G+325JT!c5704*)~I%6$uw*jf$d>a8~?Je&iy
z`B}=&_#T7l1KT8}UZwt36xo+*2Fd_MK)S!^V{P`w)rz9aT519<R;+<)jHV2}r(~jR
zupL}n=rQSHz&vdb_vXy)x}tW$EnAVI&}HtGU;7@EyEehNtC}lu!(sTLqjv5kM`i9(
zr)9}q7siBetc&9quM?z`y!Xg*5mpLP^RaWjQUyOw^NTb6gLYJ6sahHsk}L!s;(!sx
zEew2G7f)9?8u-o_z$18%1v;tOumDJA`jkhm+syK`jl&({>+3o9cUy2x9U3v&Om>1(
z!TXZINsIN)H=h12?e~<GRw&{J<yHl)cTS>HFy4Y@08)B?vKBbb9+e|t$UVsI_8h%K
z-ybh`jUkwgRo$XY2cIQb1dIzr0*jLeNFcfOIu58x<T?Mc@h0K648wKoCz@mFz@_`X
ze}#3vJZUcNw4k8W@OLPip6f@!MsZBgn41Z29oB`%nS{{X@2F_o<&afhwu82@Og%y^
zbM|<zD5}W4ua(Fsb?T$#5Cr$-akwI{`UVU0a7J*WO0<RrV*v~u`_4kO(;H5DOa0oY
zJ?$Ynjo#;+{iv`vo-#3zSPqL}WM&>-G686zP+`0>Bc9VEHpWz<%mD#{2G@2;k_Pjt
zNFw^vNj6CDJ@AJDBh@S*d#&#=%)1ZC|HwWpwup)rg0P^=)(u2K#gaxE!lTxfDu!ZN
z3kAJcMhGrBmp}56=!83<OIh084W}$f+vy4<nxK-9D%}N{m?CkHD3YXxJ;g9&7(ms0
zHgOOwpm1uWB03AIM`igd=^*h(Wu+Y7$uU2&t?i?n)EIG4Tzz5BxbgROZZ=*a?`2gm
zC73<995!Va>X|{6trV)adU*h!tNpUtC5+p=Xgk%;5>Ufuxrc%3m<92+AI72LbvRDf
z0A%;XI-to3sOdn0cAvq@B@X0dA?lv&XbvOc`hV97+{{_SDBSR-;q<__)dW1W9CTBC
zE;~p!J^B93VqT>@BrHDvMmJ^&oUX+s)3q)(=;*Eq8Cu%PiHTQNakI|js727|-Oe-T
zPM*B_oX=DdKHsc_Knn($rAGh=hdOCEprCOxt1}7f?0)S<NHLCcu5vScnoiN02WKw{
zi&$<xP^hgf#y_~G<c>)H3JT2xLA2w=V9v-lOSugkfrz4a@`YTwa`8i7Y~kC;C)Bb*
zIsWKJNda^+g;DejPf$|P^;*o1VYNXvl{vrwClJoh*G<Tyb7pRS_W-W*TZoj@+rJ!f
zUJP;=I??7y)t-2IS?NR-!h8VZW3P<%di2Mm7o>lkKgWv{kcP-ylN@>i_IeQR>3Ps8
z0sE>{ls^KEVmN9EI*mxj(G1x$i?VS7Sd(U2$<y^kZzvy3X4bKPU{Mh7?)S>0=-ZU>
zrtbV*;jEyDW$&PnZz+}drjV>8aAOM*o6Y*n{!p4jeo`hX17x7T`l8PLfXBIpf~cw!
zuzGvf`FBnJ5-}b1NS7X!&u(WczL0o7FX-Fv>ldaJoyWrkSIDHOcl(y?7MYP+!V*1a
zTd2jQ6Ew&id%PJT8HvB<-iY-Wsi8J>Dot2{td`+m2rT5nsFQGNS52W7<LRt>(%P%U
zZ&~?&8GiqHLlS9^`1om-`ydAME$YbHUz$s=Gy#}Qk!L_X4Uae)pVwzE1t9G8Ew5XV
z=Fkh7NU?fxpdv#K58+qIAPzo<8cBkjsEqC|I!UZpVF#`KV@=1WkO0wmdDAAHT5E)?
zk6&@@=FoARfGRFqTE8%UzM@F@jzSmfqBkD!XEj~^EplRvLVfICF?Ti0rL)y$dGvxn
z`-D+M%Oc1xri~gvDkiY_r(+{8`xEAN?7Y#uVcOn6f}w%-usz=>C@_x_auAL=UTMSv
z6Bl+?b87;`sK-l@doMF#6=F%4s0N5n`$Qqzn*syJnrCdF^N9cc7*7g%_hp!UkHF&r
zE37mk^GZQfhr`jxeUK|6w(3O#+z`guCx8lfYE*)~iSXnSMtVhyg4_>HbkFtdI1*7K
z1Eip-$q0GKKB$d;YgLpH)67OyNawEmJA;q&2D<|tfltb1%$p;dU$f6L2D<LTXvGWE
z0wb+(_2e8e=DU4C3F5C@Th!2el5%RMrY7y{-$f)PABnnS2v9L_=B#h1B<5N>L#>l1
z2uL?KJ07p>Fg7@mk$L;|O8;kDt9QG)2cBoMcBF9ken3wf?H3n~8YX*PY8JH;#jIZ2
zbtC{b=_^^V_`l`xUVoEYOW*hPhO=~6t*r8Ic4A$rzx5t>a{&Lcn(`2Tr9A(JQA;My
zEsw<!TM}gh)ljT^{=T6_D4^eos*GgLXdi!x?$&!OHK*J7=Ca|PfK_)xAkH6#RcpK~
z8Atk9PdE(KG;>9s4;Y86_kFUT$aScDIV95_c9dn5JgOU>)=seJnWi?B^&4b2M&b{y
zd=rl>x3ItJ*)I-pEmAZFVy|4#AlIhD66RFg{Vk-na@BRwArlylUiCmcXc$0YO=r}x
zEV_;+-^J&S3FYe#eN&8W+`hvAo|xKM>CS8fNf;k(SF+J$aOjZqUp)LHdKYGT<*V<1
zjbdGja$d_t412XZp0nLEJus)l>e6}=!*#vlkvZ`8K$d1I$R9;kl1bNiZ~_p7$7MEA
zE;s8V`e@tfGtd@+q+uF-RC#BVRJ}ruED<TGRkxJ<DadvxFMRi^dB3J;^SS71)x&yg
z8-O7`HpTY-p@y3;ib`Q$EPswnn(<7gd9)=g+JDG{M!#gNzuELx*4bJ33QJtToT04D
z6h$Fb6OR@H;&^r<Uh)!<*^ePuy#6aBtMzbt`CdnPf^^U8IbjA@u(p-BKM&P`=6fb$
zq(dYu)ED=6c|TwL&mtG_uWzvTltt^xZ1zD8Y^&FYFPqN{v)3v<)_?QnTue+4P+!ou
zl-Fo7%{kQvbL;fYFKtRyb@<3A2_KO)<aMCrNX;85&x;4>{?{aJAR6DlO?^KD<m=uc
zJtkG@x^pd5oXtk6-n3y|HnUt{a0RPJ{M6`;^V=xatk&WOH&|;G&6@q$2{ArQoq8LB
zUI#6U-XhT+^y5;h?}PP$#n4=-q$iMn-YUJ=qOT2wQP4QaF_W4S1$8}!Cd6jGueXxv
zCWcKM{0eV^^;sS_MAz19*NVpcRol#;>20F776)Va;_W5t{};!$GLRl-z&g*PcI{*z
zObwCVtQF&%CWOgD^%@6`&NQk+2gdJr@y=u&a)TvCskQtgki1mf`>GgP{TB6a6;27l
zu+OCipT3v9JYz%1h}G}lS6dp!harncjE3@Ska@9D9`*EoJ^EtQ9)|nw&3PK2fmm=p
zqeQd8wt-I|)x$nDmy%@4zl;w(2BSqwK<iK65k9f8|HPRUI;g73(HN|fAn(>PHfiE9
zg61cdc<ysdmNw~jdqz<kqHuEFW0AGC?v|<LYbynXFu1-O1vM#5+-uM(C_W2_(w)PJ
z)2Xf=e6^=9HQP}~w;+jNGpL`DU5x^bu|4*7W|}+3|G$ymwXO5Eom{~5=365?oW$Z<
z80p#IsZ{B6%l{>^)Q1wP{cxxDn8u;QZ!jW<dH2S6%P~eQm7ei!h@a0{q>c#_L}<|)
zGF!6V@!m?v&?nBlv4>sCze-*iiZ-rlhlBEGtV#v_F*g&i)Fzyn*(#O+&`)9_>4kkH
z(gEu}<F(BxI*Bg2RG=9Ym*`UZ?2@uNJ`LH4Pp$&E!-wni7JwD$pl&M2d^^b?1gl_Y
zS$v-!pQ=l&c+da9*d`<9O+~EeCBpkJWK^TCdmw&Gnf-fSgWcF7I=fLk3%BpS`eDs;
z{wjmRBM9qvnD1)$NCw-oBx~WI(M+4^s`AYm5)&X8fpK#r^aMldNEvF7du(Ga`&%MC
zwV73uk7fWVy~`pB4lL@`uPo?+w*I)whidJQ_kzvVnL7BNr^?%di{FP#uuZv9^CSda
z?B3dskSmjXCp!Cjp1?NG$IS>WascAm-Pl_BOtd&xWr2l~r}-;u4IiGHzKgmJB?%x0
z@O3PwDRMuMdSLBv_*y4lSHQQVz5p{!fv-q8^?Vl)l9cNiQ*QE_q5S_@qGkA<P4R%#
zk&a%iRTc_>6#Yhd(9BN$HMAz1$yPDzRBd-XABbmK+<{f-!GU#xq+=&b_jtNd`sY~1
z@jP3?qROwU@OC+^ld73MX2-JBQr|<SrCK$c2|$L@lzl;EVXBCYRfcXvc&r$3&m`EM
zEvkFJTPr-jBzDbR;M9&zmH+Itx_55NYTY1HY8~*R_GQ1N`0X9+@}dyut9Jao>3y1$
zbi=#I3oJMB^?7!<iK8VxN2f5(eiPIJFH=pJv~x~q4=T?Ey({WD9{V}tyZ9tnEw9gK
zP2lx76=({m+gt6k;iGWo2Z9O5Agc#6<83KxrLPT%qEs^E?GFslTD@<bbNBtUsVMFF
z0jo#D?7}<S_1nQZ3J8uFgMjQsG8=lg>IhHEE+3N=e`aGzJY+8f9wShC!b*4KE5KKm
z95X|hc7ldekliRct7f(u3yR!F9LRJj1oIOyh<+4HSs=5Qd>ZWqbhM1rAERvQrqz+U
zDyT<)kJAS735Ntx{H-Z1R!f4qQR0e0&q9NsVZh{~JApNfWFXN@HGtvT8G}>Tx+0I1
zE2Qyc%yOLST^c<B62|YmXIoyhWOnwG3@}%RcgcjB&1HJR#X3&`bgxdMiuFT70eu7g
zqpt3`W2g_Mgvm2l2mH4eK$Si0{8*?499}Tx`o(%@Q~h(1N+9I`3dyjmqvq5_<0wpS
zoprt?Qu*_9(MrmXV|k3l*s>437Gr&cL;GPVKQO<qYAB!F2Sf>p>rk^B`5$(;fy;c?
zx_UF#Js`MS#K#1Lj+ku^T7IRdGUB|G+{!U}&B9F0HlHd<n0G}Lv$e<ed{}6oX<xRL
z;!!^3H9`FM=v4l&CVu7>3rd{Fd?|c4gO5Q1R~@WUFXV^F;)iz#jJ1Ic4nV;SPtVEc
zm2(b%^LI5XFyeikSc4OH^}?62N-#&Y4k`&d9=Qa<0aGYv4m9{83oxTv0%eQ~#3{82
z=X4W@j~n@>zI<-sjL4O*<iDk6t+ru?$RlN>suli7j$<lgr&htR`Ho_ZIDQX*SX;D@
z4Us@%gC|&bxG>ML7E}rebwm2X@HSDhjbz)a>^xF3{5|ymfaMLnNBL}W$q@El5lD$z
z1FowTdV!473nIJOL%{EPl@AlsKy(SL{`;X{ejJYTda|1ZQ?rDi4&738(YK_Y3ug&8
zQ95;Bq6l4#ZTgQe>noSAu)qagd@-gfQgVe$*ezK5dGBv>VD*45@daGpuBt~cnjs7l
zWYsoz$Jt#UhEwC1hx5@=$+KM6xt8X9pGIY}$kBp1pkdCP5z#jaR<jfl{2rY!YK*BM
z{5w?Tc}Vqkm<J1#%1lGt8hKO#$Dt=Pd(Pt6_*7%vk?LqqH>Gv~3T^cOIe1dI>9qbD
zqh1U_*ctq%TmQMNI5XtFLZ8P)2bMkwxmBjZq{mM#r1bP4VwyBkAd7Q236mJX_d`3`
z-Ok@C>cbjmD2QYvjR7Rao}XQzgL+W?zR^cj<|qw8W(b?s6Z~T;^(OURu}eRBw*xZ@
zlu3Uni&xTrXU`aM<}2gGKPTqp-KT99A+**7k148V9OWx}lPptKvL6nI(gQ|oZ#%2R
zAaSqi<yI4--i}D2hfxTv%@62sxHaS`kPv2z_Gd#e)7?W$aHQKJA{{LqDL|=)xvq0>
z$N{^8>rF8V<P64@O!nbH@$7pf;z?wm;H7j5w{jrwb4{UZ?mWGA$(qI*d?k3Xm8Ug_
z4O}7Zb`rnfOnOg6z3+DZ7EXJ!1@Z@fYJ?K;lF>*5qZrZ&+F~j@_Y2L=177lDb{p#B
z^R{zdBhrF+w@_Vg_EJIRGwfC4a6_u;l*{H2;Uy}r{6ut-tVAWQ<ik#*1E#Kudl{Ry
zQ^q+&Lq<#-B|0I8Rw%o?Sxrpy2IE^6({ZvP0+nZBr~h8Klg=2DaYTj!k)&l*47oR8
zoEsp2LrbC@Q^j#(PIw@f9*q~1aFtV|^-F66y7<AH44ySe4<$Nm4_RsO?4w9+E78u*
zB+l72gX6yXk9gC1v?qw~N*rhd`Tq^9t3RkUXbdtHVN)owyS1gsZTdzPOT+(%uL6zh
zS-}W+)Ysa`5@c8uW16L{1UYi)82}n)HLw|Udi|T$X+Yz|ZD_XZI&B}#Rv!tA_SCj7
z^38BwF^5?v+LjS3$;1nt)VQBI?U~Wft<Id{Ktep#nW>C^gwWUi1VE%nZl%GK3W4LI
zXVfG9TC_m4g`o&%lK6eHWg?=SepZ$WA0%Iv2Ec}Bz9<>b@Ep7;dbxZ>J6b#&Qk?&*
zH=o2nkn;Z6FKwVDoc;-Oe17pxQ$pmm$sqXno*X}Tc@{~C`)JZ?$QBT^4FX?9ozWGq
z5Zq?kc+Lg7QG;CMsqy9me;&MXh?}+8!VGJt#$4qHFEaaPyf*jMeXa$iFIDV=8kFev
zv&FQsK+md3b9ArbC<%zDD20iHC9yEX1Y&O9!00H}*h=ydC(n?PpmDr&+SXi|yCjd~
zV)iP*(E+93PqL4FH+PFtyO%3yj7J^wLf_Ns1YM|%9x=r|X0CKw2PDs*MNNz?@rw^}
zzxMJbKN1u>bVe?DSJ+ctDQ5;st{(Fy^4E>#er|bHTbPE45@^Yf4XDkS(IO&M6GBbs
zn*uJWjBIFA`9}cZ$0e|b3y@{;N^e6k3eAv`4rU*@R6V3u;;n~m9~;%Ism9Y*Ax}F)
zrZNpwjH}404;IzS-_ZRAJ`>()VdYcb&^w(Ro%4eX7zEyWXj(!bQ*#P@@FS{tV!T+f
z_?-0OTCtlgty1CNJ0pYe>{wvrw<u@ufk{xHYT|T6J7Av#GtpGre%`99Ga|gswYc@G
z6|yvwFox`g+4W?V9;U!O_SPaDSM1FWbI1y6!{MAur_T=kt0H)}jK4IDe9?Dm!X$OU
z&M=aUHm)4jA$j@Fo6p^4!19^&Steim@u0KySS$6R!ZFZ0`ZU0wi^dek(flsi%#X9N
zY{&MwYe;+z0_^Vp4@AqW4dZG%H_j>u)O%J_ib5UV+}P8Iv58g-)8KMQok~~KjEXx6
zvv(7E?b8hF<v)9g9q&+Y2Hc`Kr|N{le2W6hn-h1^crzhstLaZ0yV`(#rG}VuDL*gQ
z1;B7W*yv}MyGO)VWnY{!vAzw3Z^1Oayw<)t?Mr_ajA1U<0LCmxQ)*hJi5TDOxqJfL
z*q>>~cC@^@Qr@FC%@UqTdpO0|2@g;~;VK8JxGO4i{Zz)~hrG&ljJ+?)>(75~9Cl=b
zNDdlz!-5CSYE)w5UEW|mEGAzcp2{QA3asxB)M9EktMLBide3jKTJj4I!6#I_t4zVo
zWO9qFhVm(VeOO<E#98arAec2Eac^OeljCh2_n6DRw8X9jOH67O0tJW^DZs4xX$|C0
z8tiH=*MJFuRQyVhlB|wV?Iv<h8!XTyL%s#lF|T1>_)D2?A9oU<G}L7IdCCeP+P<?<
zFozH1F3J;_&LC<@E7PWtbN1zeO7g<5q7ch7ge?d>R=&{QHQf5(nq`~^2S$_f6!Oct
z)q`d`O6fVW!X~6{k7a4>8#0b_d!(nL1IJ8EoM@Ivz-zL?nRv@F&`7`0XB0sU^Sme;
z15U0oR?7&*^7iHuNvDb;8Y#*ayY97p%l?@@;zi+4R=!gGJXeVJ1Bd5Ofa+AStE@tf
z70)2PO3H3#V70TY+M>^F0w70^Cg*RXdj%b~?sn|OcY;ORI7fx0dWzlB>%{oz4HE&z
zSO9JXvV+$?w(RA0(%GM-CR>tmxD*<5kA`WB_P=_~k7Py0^oIC6)IHO{bOtJqbI;8<
z9=|-#WEvT#ASiN(Lpa+nDXfjqS2@4lFFt#i_YpGL?jEXXPEAKNf)n<wP`WGTf?D;+
zwtqPm*~?B&!tWJ<aKl~ei8T<FYmjlc=$*v}AoDXgh!myzHXlVqPsx9ux_P>lb^>!M
zXq((l^V}5-k}3JeApL$lLl9Av%COt+UdwQl<WlO5QP_39AaLxnLy6S!-u_V6AvV(A
zY3KGECL$~sh*JwJuCuUyR28p-aFP2|rW;_P@0VIfc)7nE@?|FHS{{apQBY$hqn9EC
zbjMhvP}g$w_OM3$vxvP)TyShBm5vzJ0Ht6sRkN9h72L-*sB#py2f`w5VcVrQ#y~^s
zlqjr6Yw%{fFE<tkh+RI*{=UaGkE^3cGVPO1?r-3Xq(vl;%A4sJ727=wZ!i%@xUce}
zHtcW)VaBkhxnutYOh$z9cbFk8^4bw5BBg+aDD_wo>zV9tDWqELA-uvZj(~-DhbQ`6
zR(yN1pMuRBK~PBAxRDhl{tPRE8W)+b0N#KNPpSE^BY{Dnp|MSJzz;ntpNpeHjE82n
zQ<wL<r=*_#O&*vp6c9*6fgNYTbQ96%N(6JtuR=LDX(rLq5(^wCWR!)2_n;9gFr6Kf
zOR{vFsO(@+w%U~aik~CDbQdivW}hxag>gSqqV(9;kT`^8J4VT{vB!CpSigX$PJlWM
z>U4Q)l4hdnFD~fXw|`qoHy9<C!NPYtn+Fd@iG&5I_nr*LW$R1o1NK2C6$8U6+dcNL
z8U!5P%qoCreF1eNHHP-z*<L<OoTk7YR90j~`V5PF&RGCtW`hvY$)AQ>NR-<)%3Uxn
z)(SKi5~BJ$-=m&%-H*Lcpb!%hCCUZMc8FBn%;Ytp3=r{OT~H;|u~u&vJNL`;Q2_X}
zlNfXiCA_i4L?7s3L|&2<#poQt0N5m$={;cUeJ~bkm{*@(DX32RKQjjASnvk;bsiGX
zWqa_3sE1chnU_l$MZo>5dvIXC1DT``ZT&l}z}1-l<ElJMX-;OsRf%gGVi;H|I686t
zwRvImo;`}Tw;Cq~Y^;!}S2KCf<r#)0axzzE^XtT2NEdA%t59oNtYZ~%;AcF-WvG1T
z;)Y~KUX#+YtA%IXN~AaHttMA6`$NPr;lT$PFOKJlOM{E+d(4G?8wD}SDN8TT`g6ao
zcmIE}Z$bDwRbSa|tp;E8a{70kB!v7rDLI3<c0ICihIT8R;1gZ@I_mscMsn~j&}I5G
zT=vUA#=$l?G@h^<?U4OnSlaoMwZg?U>?`^+niu_&`f@FSb<Xo|&@Mt1eWkKb+J#?m
z?mFS~#SoiLuhw6%mZ`C(R%rl=K@W_>E`M(x$7!v(bO#Dw{xa43c#|90p~I02Px;71
zT-9ptS`%}u_>3ZPi|g`*xVq{Ra^QtYe&n-UIu*0e(Sus!BljfVoLB0S^5nO|2+LTo
zZ*{d#KMq`E{#3ek5DgxT)M)on1ZNrsyqT~;Oi({ZlXqWIg=)4Yw0hifKQ=4UFNI`J
zUrwY%Y3vD}8d()GzZ}C#<T&P}dUp@q|AkVv!Mx70m&V0)C|4#GiTKUGEq<w1FaNd8
z6@obSn_UJ!T&0v!y7+mS=<wHRm4gjsl$5PiwdZGytyHO0v^|gFFzM}*DgC(T`T!|)
z4MF4OfH}?uh^MOXu*<5DsO(^A{$XslSEv%pMa@k&Mi0^!u2Ut-3&b>ozFQ<cJgVeo
zGs<s?9u3T>(@B3W&$u6q^1Ms0#T$?qqG<iZW*2@3Kpo2hWBKgQifrfle}(qj<E2Bc
z0yqi#zxLaZ;(m(3DrOXwBuDF8t}H)ldGv0xE|Zwz7}V!6#mlnNz>~40gXmFs_YTN{
zDF}H%z{VP+k|b4<CBt+u{xn51;wxi)tv|Ea%fMN8M;9y~b+3#kR-Z#-YJ-h7m8h12
zp42^o7JzIwXY209O56ie;N3f7abz;Z7HP&l^aK}<mT*v`r?fv~`P#P-M)uo-+BAK>
z4}BVeV@v@{FMwEDtFqQXwvTs;+<Zy;?MvFhgHeViAK-1KLckZ`&tTwz=#1{K|B(??
z{WII+@rX6jJm0YN+oXDVYMpQ+WZ_17-)x(@!F_*p6jskMaf$BafV$speNZP9mg*8^
zU7Uj!iO87AEnfs^+&m#aWBEB$)23Nt>QUxjExs5LMH&`EG)?N2aSzb@agYHKVA{nW
zm2y~`m+so9Tr`<u4q+%tAFR+Y%&q^Uo5UC)A>%9tV`UVKLm|0wJ@&!W1!?#kc%|tK
z99!4RG(VwMx$W83)HheqxxSnPz>>p<dQiTZM6GPsTA|G_T<8tih(kis(vtaS8^9*K
zP}NRdyLYeo-##{`(dx~*e2ZnD#erfhE5gvNq00bElv_((uF~sjm@qcLSVnAkPZyu=
z*3AWOf}&X&(>&5l@i2E}$68u9!pIEd1Aqb7;<v1`ThktdSZFw{8dxlqwDki>`E9NN
zrW8tx<Jp^3LuzL`GiP8ENs>Z{-cMg0xc5SAY@(c=L7kV+vHgw&YR%*l+p(FDblGT}
zROF;5hz3ncXn&PGy^$HZ!2VCspY~Gl`}CVRX$a6E_N9T4E)oOA?Yg-a@F}=1NpcME
zn>y@Vt40(m`u$f2|Lac7u?tkIpkRX0XVOL(4*qt>=erTmw=ir;dgo3Xn_yCp44rkM
zmUx+VzAvebE3hYP`*kY}7wn34<$ODmKK|xQzx`ED7<-i#{rtK0l!x7kG%S}N$+_qV
zpy!qqC$kpIL&6NE+*FsBqRd1AfhzT!EJS}Y6SAd?);`rR=T(}VsFNM5XPIV>4cmPd
zWveacy^QU-h=7MO6lao6dRPA4crBj6XEJbw&BxpI0XZV}-r+!Wk3JB(1;y?re6~!G
zwO(POA1&D9m`znmV?mvCF}k2kdCT>PBY^W#1TlOMM0ZxL97-l_>_Px6CP|IzUHqty
z3pZhN5dcEGf6dIa$%Fr0cgu#cVK8`@s`Z{c{@quj7tzzC+kZ(Edf6dizz({wml!Li
zYt711?3YTANq$ye`vhqMNMmE35fR852i}I}zOJXV9aN>A0gzvOnQ<!PfV$YjT=TES
zxNYzxQ3A-zt2nhUkh%GgO@L?2u`Z(LreBG|ZVgp(uoo_-1T=m2I`?_?pb?1>BBHQ?
zkQxLLALkkEYz=)sH*XN9@Nc+A_14Oo0w#93$&pkd*@jdSu=Rkw@yqtK{zrU{wn`}{
zz*5OF!<_VzwQKJ2*Bjj{o=?S{0TnpJ8`I+wxnB$X>~lP=azutCyxg;wE8$NH9C|>V
z23*R$w`qy#JZpyl|4iYpR7$l#rME{v;(x#0Bf(RzQE|i%eORjPRhh_mO{r%gts()}
z`t`~unT-r2|GSwh$L7gAn>0AuDl!#*zS&duoE@T>ocpIbXoR#wZ^z~WOpkSO6zI-e
zD=d;&kKm-DF00oiCafYdpB;?|3t1tHj&-A_qa#0wN`#7T?2!>K@{c#egVy04`>cp~
zUNo8NWkgzLzjUpiPadSgXyCVyG;9*g9#*bu>gPY(D>IEga3BjC$;ovF_55A$r1(-|
z_%$20$+s#s#ekcK=qwBo3-Xe*LdGb~Nk4=mgqkKYKhn)XCft8>jAR%=h<*wl{ySNU
z_EU#=jF>#LJfD6X`QNf+go{J1o=1OWe{o8MQ}Zu3Tg98rKHBo%VY2m;`1zejI0tw>
z8Ofla7@R0$D`;{C4{_QdyG@DNr`2Kib&}n5KWnMA%o~~)(Y1jf>3!%W^|+*W$*H{x
z+X@?VA7b%AQ`mhS9FAMeYTEXqdGY^~TM_Ns=s7o2DwlG-W&BIuLIDq{vtNh7yX+?A
zMuk^Ctr`lMi-B?N7cr_EuH8a5U0dTkZbSCa#Qj|m3Y&Rt0|U$Fz}O0(M4(B*S`}Hc
z6t`n1&Ytp@h%L3G=$jM|!z1Ec|C$WiN@EbgLH!a|F?<h)63Ek&g5A_1;(kuLxs4s^
z6*W397N@Wc@}Y<=SXvp*o;mE%cBEr};hYl31fats5#6lYTYa9rNqH<xv(U*v72VGZ
zOt_U%4gnYGFn(k9ZC~Xy2(7cVajRa>lWM$^N%L02r|~{l#eMiNUkQLhjV;^F$Ls75
zo_jelxgo}S01^v#!`?ePdqLYI<j1gkX}vRUzjP5@&VOrEy#(S5C{??!By=KsXEkxI
zwweb-QBuU@jmvedjbB>#kOe#$vYzjhzmko#i44c6O!p2XUg@67JG!MZW<zKpbba+r
ze$KZBg`7*rSl?iwLX{_sLkB(&t34NTzT}k=Bep(R+~?UUE~KN=tuF}sl>6XKpGuf^
z<-$+385GR_hIY7-6xv)%81$rH0mcvS7)yxkU{G<I0H6h}ndPC|=JYhPneN?`#eGnM
zNHf03xLJP?tt<Dk|2_Q|*o=5f!?3_fJ0*P<I`!K8>LG~hd<*t_moR-(WI6{2Vc1pl
z1`A7O(U+3J9{U9@?y#kMiz}z$N4WQ#4Gc0O5uBxmdx5FB<l=OdGMrPZ*zqcnI@LTz
zbp(s9u(vqU7X>IOzy<$hr*09RV_qO(119A-I8!GERb&;}1S$w$2yHARx|Hn|>i8HB
zM&!kqoZXwN<B1lH5AS>Nur6i<K}Q*>4UUNN?Z%onOx$xqNURSX`}_(CO_Hh*5gIC5
zX5_dnO-@5dA<UKPWC<}IZOel6FNsTS#86P=3lNgJVJu)>@IFvAUR%57e&!kYJirPf
z_gIBhxy$6ffFCjX_j3Mr3*bui?>P1q3p{e7yvbA$UEpB~xD&KxzsUb%fTfEp@Q&4a
ztoJ~Z|5;Ye=egx_#RXVqc%iQptf5(5KP*6aE7;O~4gaWiUm6M5EygvR?=Z-!jCE0p
zXbkH=2#qqzGlukeEI<>mkqQ$_VU0gnrn+U_X8?sO-#pV()noAg5_590h(mS3uShQM
zt<s)(UcNym1c|;}pB3vV;{-X=OV)Pb3c)q3dszT<4*wdghd5=MaK7$gZlK9nN)Q!@
zM!lb;dF)=JO2!Yixkjfn(&5V+>wtK&S9=HiZ4A+RsW|v-IDQ#A`B1hG5>$pON$gA@
z^TAC)J8|oRJ&Yp(^|QSX8vXIvE^~^)h6o(Uk?Fm>C6mN+K`*^+9MI-N-5_~b%kVMi
zd052r<#u@jNa7b&0YrIQF-m;EY`NX!GVNQ>V^$4|;Ek5u=|y!J@HVXReXbW`jN|93
z!VW`h8?9Lpa-2Y%{^QT}>rCJ5o^sfeO!b!9E<k50G-tjx=>h~RlXd>we~YpNKH|9i
zPPI9jZ{<+9hP4wpi^MJgLeU@T$MJxa&Lj^1ic+bM{tR3rHeNCqoT!KV!doxf1#n&i
zRT}z$m%stdr0=h0y|MF>ae8z+CfT<6%_9|b{YQrWRog=PXo4p-UXDtqPA=1ud7&L>
zzDY+A)}{F-Vd93k%If`QpoG=lpqPkJN-f+wVz49!ZxMRW8>d|@!7dncMpQ3UiM^K+
zcn_3lJh@3@%+PsOZEbMrOwz|T^Q-OYQJ0#*<FCq*0b6Gw{uw3OvsuQDPbs<%<Uh+V
z=V|~~v;&A$-#$%cuwfBEl4y}ph-+4mJnm-xtH1<TLu*g4VmVvcXnw7Vh1hQ`xt1)Q
z8qsq8EFtY6!_fF|LqCl#*ZwALXXi<PTc9P3p2Jj3<ZC!UK1;;;CpvKH3#STx&wyK4
z4RTszfLJgfLxm+N{eSQe%)ITk&HnqN?)S7tji@hjvn%*#38me5bX<7A3@xKUI1-5p
z?b|wU9Ns}e;8Q#mnTXV6;jMg7T1YV|44&wu|Gzq-z)__{Sxn;d%`P+cRBEvEq~P6`
z%>CcWrxu(wd=jPqui+D_XaJ1>`hfNMvkN}yshe0|ZEot}1SQWulmYfmVfiiUh^TxZ
zSW@33P}tw%7@4w`l%l~68-sC==OjhgoFQKEgmwJ<`T*1J4kLvr5Bs7ZYOV~SLo)`7
z!YN$(F(8Cs^uNHPV?d&>6FlXAiGiBCKscvQGf_A`2@sc3Al(El^6uePV14%M3CVB>
zsC53Bi4<Y`BCt!Yi!e1x0u#ryUO|#=wxf2e9i9B_eJZ~0U<p@y>=2INWEG__e)*8W
z*7JHAU7yiAu)<A?F#dGZc_{b;nWZRcz|JUQF4fZx2gp7i5?-J$0+jF=m_N26^`YCS
zb-2a|DH|G;d3wIu8(TjAfWN8tR?`EEf9|=@{Zpk9{Q;x<Z6HJ<T#S2CNYlbIl*$R&
zV^4+2%?T{(AJBA`Pd6!5280N7jy8q{DmrWYZpWctUSjbaW;<cH$M)=9Z|0<X%%=;J
zh$)^=k9I--WP&|C-=e|VL*uu8j0P}Uxm)W21&0#>lH_2?^d=tQ8rU4<2#Qug6eIp1
zoa^z7SQn19<r<G25(xl+3C+jRo53bsTY#SYoCX#FeAf5cKS=sNypag6{|V+2RBK+d
z<k8G0t9!hU5yo3=Hbi((23YLgA&p#3r)2hwQzy*}q7LKX!B%d1IuB>W`D0?yi^YLS
zhWOx^y}#!+cJm5e$l=uIb(^upEm@INLfg7WJnwihvasT2ASrvY^I~tOKn~Xiu^xiD
z(i)F09}$P1&&_(_Kb&O#bhqnAa&x9VZ)Oo%iq8ao?~8wR#Q1lu(xD!y%0mNCe;K_<
zmP?etHkl1(#S%f;e|gOZp*HXW=uJ7}$O_&Y+$-E~Y@tvlk5nc=-pN<hu_D48g@8{o
zS5wV=r^Uvj?69=B)MVk_!=d-osG6diR7Zd_;D1;r+Jed(z|uhPb72wrGJ<jRF}1W6
z{kOHz@if<K-LS2S|GL?}&n6ObFf7bpzN!6wQ(GkVe!4njgnXd}U@>$pUsl4l9<5t%
zbJF(*R)oGh29a8Z_{wN9v|`-ANGN8Y(WpQ9=M+lsK`c!t`-=-mt8Dmp23U^_Wo9}}
zB(oDP-Y)%D-G(|m`qGb%`E24p7pB1{_j1e|hHKVaa=VWTPR?i9_8sNP?GCB+nV=7m
zO|xRSj*~KM*v%8DKH&B}S3ta16$(q&=u$ikPaE-yn!;C?*NMUiLWi1d7q<TFuQBv%
z);LbwjhD|TM%@pwMrE@XLT&O)1r{O`M8XM-h3K>DTWY;j-1#6g5a*Ou-yn@BFUGNd
zBVP9`QZc>q6xAYo<%?LxOusT)!@HEX0q^yn{+Qrllx&yvNIEifkQS6BCBeOR*=XY?
zHy~rZ{sw85;j(w9sq~6rL#lB7MwPq2o$%F_-_)yvhwJ!|`LCA}-vo=031HgLYTRjn
z{OjOdoWzQ#R2_kOd}1g5-Dado;wS^Q6%p@>#FRc#<Rqh2%=gb~7jt4`ZxR+cs9(?B
zT11rI0R6cE?J2}bEFnHJw?MS~vd*kHJz3iwDW|Q3KO2w&OZpfKQ%+x*qC!xI#|Ik7
zo_JaOZ~jW^ed`9h8e}*FUk(tRSx6G@g1)0pLEC!LuHXUS{FoP{3|FPMqI8rxTc)9f
z=uG$$4M9)H==g3;H0Z&9iNI@=2vwE-3l@3mxMqWF9hHz-25WaM3!2lsOy=#CvJbmY
zrhsA{k$!~9zs+`NTJ2vSFIX2gFTU2im{p+9rk!tIpinGlxwdz=EAB1>1M3k{eFOx5
zIsOkjzN;`wioZ@4F#n`W#PnM6|J1HUw+obhqR(u;{h<NRs$Z0<X*R|Ya+W>OZw4;G
zLvkK=I*g}T5yewUaB=4cbc+$KafwB1LHT3W@x@$BRdgxn{IlRkS6)_hhY-7DJ16mM
zjjCnv0u(9<#TgM4DgLqQi}4eyON~kxfx@EuX>Ew74Hf)>^GD0Nk*u;Y2?%5c(|=yA
zz+_rb!Zb3p$5;T8O$mwwX3~!FMHRt$gSs1gso6~;qIxv`;(*wLV;!v+@&FH`{;B-q
zZL}%bwI*WRVN4G1#hmK-BUCICrhlz+C?aEK11b&S>n&Px=;VAa4CG)q+s8iT$xtkT
zUDA+-8CkF?w=RD;XBHx2Bn9wwon_hLI=mQz&Ne+xQ8`LK*Pb_Yydrrx0+$)-|4nX+
z<5#Gl+H=xaY2}7s0EzSr)gtql8?vd^(#7%S9?|A&-J)fGZ`W`hLb63x^xG?I|5n9x
zoYhU7Hhg{QDrVO&#;f*7V+_9EF0T>3-cjvSS$ZxMQ{6;|SMw?1e+a33Jv0fwkInWD
zc(i7!vlX1mCj|)<SYBoGLv(|g!Qkc6l+wx|wzanU4kDE|69-k^z8@aB(t>p{tv4cB
zjgJq~<V3WvXeJ%48dQ2?HGmV4=TYK<ikd|)=kb-HK2;gE1&;JYZDXXmO3-W_jAXcC
z$;I{e=2V88x`58jnESEIOLbklf=OubZaZ@u{BO+d20kOVmqAjbB3u}Tp~CL8a#NH@
zAuhpi&x37NC@ShrH8Kf8NV;XPha0<EP9ZA?3v)$ba|P)LUWf9-K2k07BGlCiz&13$
zHMj#;_+K(MhbqC#k?yJYLYGO78<~?<g6};WB<LKI-dPgp>{jR)oIk&kQs&Kn|1dZ1
zn~nC5JgcX<&RT)K$-KrHlkw<es0ZPT>U6mB9t6Uic(~QAppL7Z@Do6G)P*$ljEa>u
z&^Ce8iG9H!HeAGR%1EG^!wavUh&iC0V@0WJ>6OP>u)czkXlBl5W=a;?2oyo`oCpND
z^v7Fz0ls(CW9ZIAZRr$tM2K&IDmYR5vD#*j2wE7l(<4fS7`6zki|OemaVR==v>rM=
zh>2{UNqf62ydAFXP9T8sLXB8?_A$p~Xch)&WeB~+eBB&4@>D{tZuSVIKjS-JIl<&p
z7zqcJsB~$c_&2LDkfv1OqKg|&_%!Y6KkS#pBut>!IZ`IWz#%)A4xaWSC!uyt%ho5W
zH1Y=H(!e-RVP#{6hCjK_yv;g~gm*o&Y(!3u$%r0}I8UV<TaGvNo`@{@&{j_opR@b@
zWhv)SEo(W;fqtl^aRfB3?(B>lb_V~Qet*ysD!T3-ru4*D5;-W^UObfD1}*?c5p(+p
zVHAD~Wl#hhoOun0Gz`>)85GeMgVN4i<qIO%6!X`oW8(*IBRMXFFWj8-NDqDp!?@}|
zNXI~z99U{a4bY#e1&0r>Ur{&IVSS;LB_O>_3br!ZWu2KZnG5SZL<%(=%p7@gmn9-D
z{)O&nqhl*3cYQ_@5SHi=cq{;550+a(%&0nTAiYbEdd*>$^=WL6(>9k)GXdi5b`yvD
zX$d_Qdg_sIoDw5=1dGej(w1@V7NHh>l&*KTInm(g{RhM$X%+jqLjag}R$OkL{-I>^
zEJ3})Xa;$6VpHDhr@~+dpUV#d=|joZ)fZIZYVTOW*q>!+%*Bl3Jn!N~oYo{uocf7L
z?B9S0h`LTtK5*~|U;kJ>+lVe2qbuKm&5*a&igejPs4CfRQ|w)fKk&|KR?Q8*dSi`p
z^nVLf*Hj00bzzjk1`TWLBBF-Fxj=DO1M^+j@!l19)S?&Y6q}b&b2RlT{q1lS$8OBi
z=il8lE68Rb70oIG7o>Kb^qXx1<Km{C{7!!3aAvhD($6M}`VtXyR`T6AjyD-#mnT|U
z@VNixfoHTqT*iP}EF%=BGHII}C4ItVxw2~J2Ry%D+qW4aI?1~f@s#U(Q%FgypMZB{
zXKUd!y~2Ud=d>FO+KHO5_UX<lVoaXw;c(a~tVn&BTRQ_yk>CqjI9xa&-Xc^*S-x!3
z<4-JUr3k~PckP$~Hgl2qf!;@AoDN9A+XzF67D;N~2X%@R%HRf~g9>VDVkaHI$<t4l
z7}DX!I(avnYBu$Ti(5+d_5`u+)xU#@OJX;)jeDv4<xNBmBzvCc3Ra*&DKSFm%fv<x
z+-)5iH&+BsQlsCW!C6**TN5|x$CzYg+z-*OabI>xq8|^?!bG`*k;3IYC_M`iz2z*T
zV0|hKGptzZURS;3jRc1(AdP@`Xmam*%vR>MzgZ~o*j#FdqbuG{Q9U`dhN!c{v0zYj
z$LG!g{b!Au2;ptFV+MG?4UV7mv|@tF*MnK)_gomJn`p~iZRmpoNcmxGB<7uTBo-tr
zhle1L-EP2vTWC^=G`QnjcR*@X6LN7Y5e?<cnJMtJ2b=*sxFm9Q`new&q4QtLx~^ON
zv^#eWZTjKvMMmD0B`>5=w&)3F-01M__@F)UtD6RBwJ72ba^Ld&{>pEeR5j1*sdD;U
zJmIVXoceVtfb%8Srh8b#$14>2I*KFeD6@UO&*shQ7xAe9gWl^4!JC?xE!69jWp-MV
z$UOrykZ^}E=Fc1W8+aebsb}odYzIcK$N#;)qpdFvczbP^&o;4Hvy(0;Jgp6il5U>5
z_LWO}@CIZf43G5;Lg+`v>C7z!MCCIT%>iUe>tb#=VQRiVjh9@nO+;@%)cPNvLB_BA
zDqOtZ>1a*YzVF!;j)<7V$;oG3VblkqL^}N0)5a&~v1wRoUAe<%m0p8vYfcMO#)i7-
zV6oD0p4npS*(C%4XC6<u0CtplnS7vm5cQNzp~i|=-483$#AHU|#ExXDN{00fEhI_r
zd6t>9L7FdfKQ;!&8^k+rjM7u@yp-3|TjY#J21g>Vdq3980QiUitMaGy=;*;T;TzcS
z+EQqr%9DKVa&v10T@LvcglwM0G0|h#z@EV(%C+gF-=Xr!6K8YJec_A%TzQ2@BiDc9
zhrblBdfNBSI6nKmyuyEz|8fmeu<6CHF7W!TvuC{MrwRs*83iWsyr)FlZvwray>Esv
z$Da!-q?;b*J9OP8oV*NxYSqiZ3Mm=|`7xR6R7zEGl}o3eWc+o*UK*H+U!za0nBZO;
zUdW`zph@o_%;wus>FASG)u}0^J_q8z^93JCdunDkF;McxD4;6$7RUv_^KQ4`n%&JH
zfX102KW8rsU~rCr^UjhGx0~~YpFmUs6lQ!Cgx_IYV|B^>b&u=oWzqkwDF)RXuQHVQ
z2O8S4^m3S%gr;)*H~KdPOy6be0O9L01L0Tb>&2+5^Q}sUe%lZjb;h*9q9L;03z2{s
zZp8T|2ZzNNcTeO^V=3&*<e~1j8D}%CGF6wQP^08=r7>!Tl`*k1C|y4)B-}9SSO;$1
z%uTUA$2{5ru#XvkGyMrvkf#S0jI#?|IV)t~KyYr_!4B9f;DYhB&ggW6o*kR{hIo{x
z)5oQ4+FjVfFqV(In?O@;%Zjd~SJaTyCYvht7wgRW7Qrl+#x;#X3-rtsJ49Kql6K+}
z(p2}VaI!}RP=siux<~BGhFapt&?>67?VEv1lVn=AlK0#L2g>7(ZN7DtTVqZK5sXuW
zgP)?+%i*=4o7pimwl_3x{vHwG1^>VRd_?b!Se0X42f}Ocv$FBUk7O_b(o;p(Ts5mU
z7V*~5A>``Boh3%Dy_no+XpSvaSRahB>AK^!P&E1}j)~AS6V+qe{(+MD^#Y7greb9?
z542Py=KaZ3^ae-pDj{gIjPttThM&;=YLVb3iW$r~2|+%8+F`#*e)sd1ae`PP82Q7X
zZeo0n`=Fp?{nC#J>sWE#JPYFT0!QI7p5H;of9n`_co>0v24M5-X^+woK7Er7fOm)E
zshE>}OVpsQtUcnd@j;aRrs5%(^L1z+PD1XaoX$x3xk6<I?b<^u#NLd+cEJ&90sACL
zTe8WV>522h#iYmad8Hh9b{-(DsAp{J{5z)u^ilVXf?&#!f@Yf)vl^8Oy@Ky&1A8vq
zzW`?c^nrzP+n<-f5dOud%*!bfL->S^cQg2&;Wtnt7zEZL<r&`eZ70bMlC+kcm&is4
z0ub<-HW+BY2LZ?)HJlEqE0Ek^o)|UsXwDzt7+FmeE!g5%BJ_oNR9IxQaP4jukoa#&
zc?NqAKZ-%|rKh<dyT<t(zAP)Y`{+JC_c*gV93OqU)`G@!pdRy%{R-s}Z@Epx>3?nX
zc4{}q4*s~uXTjI=i7)zc!Z}qMrvah1Wyf&zNdCyhk(|)Bnfjh-(G%FXm^)(6{Y+Vz
z6ThD4PY6!wgge^tFy@y{{EAN%#thrLUUVE~rg#c}LlvOGw_8vN?pQxU?I7rs-Jcmn
zUt8QEFKQ<~55BPJXAWo@zhA&!HZAJXHSI|X9e`)1{6n?4-UF=*=NzNTnRw<L#_|-f
z1;;zRnTBZ*?Grxfc~=IIc4A{12S!C3n_SZMG97{9I3JkRkq#Tvw~dp&ZGA1DC3uXE
zuhpSCVnDMabTm13i+ixl07pM{U%unIh^t!X46utiFMIbb&m@O2gXUi$&aSom)pAWY
z9{kSU=8KLY((b$Bu-d6}_%afW{W;$E-a5|rmHs5O3roZ@F<n`NXP93Ql2mCuk8Hr(
z3D93D@K;_ZZodAUbzM7BGN0sv4J!WNg%d42-5E>6`or`K-5W}os)vCU*C#(gDom_R
z5zC3Yjwd1>K9rI&Po|BtnvSO*60JM1<L)&uT!<r5|LpH%ZM&gZ3vAtljK4iLY7{PE
zUf?Pg^)f!o&26TTX%mgM50-$-WPqkJ5KE8lq5-Wrz$F|=-4FC)T+@#q>4nFB%%BjK
zUL8(~##c$yjjT7XW*>rGN|~Qv8@wtf%t}H=xDw;_(NI>CPjx^9P1!@_c1|>3|HYKY
z(i)R|IL`^D2uP@?FpJ3V89^_ynVH07Ge2+OxkbBOLy*H$0MUWB4LS)jEKYK3uvbnE
zFG-J8*Xnx?o>1C|WDOAr2UPrDx=#i2&t&2hx3)$C(+TFUwx!CMy~F^Rm0#^`msQxi
zS9<T4c=O{COH*w6(Z3HRv-(_`+iWT2b;nJGP-?&@;0Li5xO!$bvHd0i#1A5aaxBC7
zN5?;*H1k{F%}~Wbm@T@Lo80+t1TaD@e`g{ZbIS9>CDEq&P>^E2?Rd_mkxvtwQMq$o
zypOOUP1|0>`(TtYM!-QyWeY|O^6@=F%NpsZVZJ2NuJ<SUm2HwdMRzLZm`}H%`kp)d
z3;0d#d^5k;5JuY-L^&S1HD!q&_?>*qST3Mcn7}tiWpz&4eto&VTtYNNq&czA@zBrq
ztq?G#(Dd>rJ}C<db|7!AbL3BQ)FV+eq7rS-4KLn4<V!>>cE@st9mS8F%>l&9j4UDj
zm*Gj2F}y_RWs0VpJPE<*H;5b3?xY4J^-<9FlkEv+#1Rnh9l5VqV)3uq-z>yJ@lszj
z(8K3-qLu^}Ed0GLDz5HLQ$#Z3C9)cwCY+z7lMC01rGR4QG#z&8s}+?pTc73`<I_u$
z85(f@HsrDq=^A8_%D^<qy}A>xcg|oeg5w0VoQSZ)*+uXF#TEmdF&sY$H+VCZLk<O$
z^iqrT-mU7d+`Ic<niIjjbiGw}O<y{*3MwML)E_U%ySETmUo_R*e#wc}=B~^w`3LPY
zcDPeKCi)orcV;4Ug<%OJUx@$qa@_-eacBU=E;dXoMS}UfBH1lHhEZ+9y$k#WRRoAw
zW$6pht%bF0w|46$(cX(Bb}UUt?RXTAE}qGqq|~a&9VUon>>exT&GTZJy9GeYu59_i
z{=65PR&b(eFrz+>%Z?bvi~A_1?1csp<7~q1UN2L|Odsl97ytdcBB*m|Ht?a+e$~R@
z{#l)oms?$!Tc91pw)8KOY0Z4!ijUKJunx1uw4~2%nY*fmU<1mv_B}TZPWckH=QZ{E
zJei4W8<?zt*E<QV)jVzUf#$8KC+x4MxYgQk!NT9wv?F9dv8+Huz<BtXxmVisuV32y
z(tYc1%8Ys#lf-8F5HKHJZ@@_P=o&E_#9zzxM{H1jWbNJ7j<U5j{J=~_p_Blyl9#}q
zM$>u&ru({FK>-l+fY!5jw?)u2fXw$6l?;DrvKeI@WJ0Je<;z@Vw@pOH$Uf!Wmx(mQ
z&vh32lx5{_^b=OZ`L*Wgn|v#gDca)jxuW*!N}da=xE|xzLEy&r;_VU;=iHZql~7hc
z=B8oy<D`WTnTVt+Vxx<mhl=kNj0rkz*-X{=ya4CCiaW|ufv#?MPNYid|GdYG07*c$
zzcnSlTMady_EG;o9A-LgCBI&VH~ff1@4^=K3@PcB7a8@hEGX2bn$1ES2<QyCjGO~y
zb1Sz3hdCh;gq0)`M={WkB>eB%H9jXDh!cFcB#LNm%<yFm6>ZzIR}4T8zr<wWG4?YM
zG;O0bdPX14B7m(|#Bmg$*v;IKLOvl1Fn+D$SMh&B1^gWNUVMn__lwvyNGv`G)93RE
z`|O<bCyYo&8^QwGFbmvK$-vji$wONSi^5tyt6T>C?*jDS)Uu6Pjmu05Az0H`hksyD
zX5I{wLF{TT?kgG>V%#sk11At6K`4Q;`vSueSwpp1TKs?6#M7s%%DNfnbj2AzjGK7r
zmp$L0FK`E3if7xYbGn}q5pI<a0PK7~cITq=1{+0=W)y0uXuO2G0I;Zk%+Y#l@Dkl_
z@1fQ_oI^z;-$mU)qNk&cNqGWyL$bQVap|)a-#sXq9GMP*?XV=lWX~Z^EWUn0Hp0v0
zQ{o@sLtqWSGwYtU@iPe^JNKw0Ph)1i8yV|BFE7u2LgJiy<w8z87Uz;GFA+PJX#rcx
zpt3P&%k2NKk8*6>G)e+0C*<oEKJm|x3^O{r4lpZktUV{Yf)PuKw`iHWh~pX&qG8Lr
zP5&*3AL!RHYSg27<Y~Kgh*^gX*caJ$#@^}422no&4o^I%qI`@tn^<g}R|59b0EGR7
z(&vLr=7PF7t;siQWzLN6wEM(v<ikopG`g}kZ@YO#fYb7qFAK_}2*9tTjG;0D@gyxx
zEJwLRFEbTbA#={`<+iJ>k1KEE=RQm=M&_UUiX+pys%hEDD>{;(hV9TL?cBM`gnf+N
z<A3qp)`3BJe{CZco)U-&Lbm5gA*o?|t4*2jA#-=0Xr$JXyY|l2s{3?zt?flWvPoK;
zan2~9ujD51@F|PtgG?m)c@MDS(4l5<W-fm?-qP1Qpj-hb*Ys5eHp?y|0F9-(fIh*(
z(utARr{hz3&~SPm{RfLnG7dlxGNvwlBAh{*?u8Fw{73)Ct|veVjE&&v73>a?HKgEu
za{1|OTIJT)g1+Q<l4rh?HvD?`xkbBkeB@d33R)UdEM*mQz@LKGFN8KC>u|rmU~r0Q
zkA-L#{r~ct?yTK7BvL-iD^~s?MKT5ez**%aFV9ql6pDupQW+14fu$46O~(Yz093Pb
zq{ig8_8->})g`Z!R^yotK~VV0sI#bEtFk*cwwWvYzwOKYXfY1YFy{YQ64SVvWKg)L
zs^hlD70fnfFB4=EZ>W#f6@!~`wG)rJhTy066ir^uMm+awllfvnrk?%Px2HZ%cdURI
zz@v3v;+0IqDd{%u3=P5LL)lo8_xd2K6GRit47a5<x_k=yIL_Rs=d>~sE&_1HSQe1_
z8^GyvrQ;-?%EK}!rP41<b-QF!oZ#>jRrN-}tfQ(&Nb{8N3PVT9>DT%1r&>XGY`VV;
zPpt6M18|eK0Vgt1w)NQ+c<D?~a9DL9u=DUf7d6=$eBR0HhxMtN_+R#XHdV6A=mM{@
zB#U=_EURC9@#Ok;e<5anbB1#pm;@}gAUyOJbmDCw!ZmmIO?Jz4VvxR>sPyijhMG2G
zPTDX~f$om{9^;S$LjmcCXOCyO`h#=~ftsss5h$5vviJpKY;FVM&b-<ZfJPgl9)Rxd
z6S_qF+cd@stoV0EO4Bx3FxsG>s0KdxQi^yk<~~Q#yHf-#iEL&AFA6y<+C`xf<|{N1
zHH7yQn`Nr8<zm?!``6X!?KJO@J{Y~D4D=2oIG_Ex;*0p}S(?N7{K8=I7IzpLwPJFi
z{miSGc%#7BuUVTl4sS6(H6A-B%C&=AcuIM>NAK_fu+@d9HRuFcFcMA)P{zO!OjpO^
z=<2xt%;wP9(P(^O^_BY1%$&J;Ij7qPp(USNpVtT9OKKnouk4Lb%*7njry=t4yua6N
z&6vb+2=mmzzG_C3Es=)KIMH}2kZ9D!xg&%(dBw@H*lActD)^`Vz6QKRH=L=W6-!y`
z7E?3w;fwxG30zgi^h8Y7QD54Nf37L_G5G-4PlItcnnyD4J=M>1BwG6W?WydgtpQp!
z;bH`Z(H*iZi<6oFh16?BmSld>kp<QZeBH~k)q{0!z5Gsz(@-70<ao6VnfwV~Uui!)
z8PJzmJLU3jR;<0VDJER(VAbO5Tj8@KwFEN~%9f0q`b3%Ro|73-oOmjCgg_=74Y@Cx
zmTL{TbWvR8T#KsgL!Zu(-`AmHn*W^LEJNX;et$-Ho>6Qoh%G84zQ-A+f!Kr^WZj|6
zU3x<6nISwBgGY*OJ~84(p-ge~ZSHNq(vMUk^9<Uwo5o@pL!}(p$F}(sr}>Vv1<|;C
znF>1RmXcTSnh#jWaIIOXaUixqdb>}D(E@Gb_q~S;&V0(z_Xt<OnYcb6X<a*r_@M0>
z5ek=AZG-#~DtU}m1@+8dmsuk2lOk<bNTm5Q6k1&c8{pRPq}3%I|4pYbY}?cpQG*w3
zVF_o6&JF_OedWG;8<M_JW$eh{0&Owq>8xeJsd8;9Q@>dQn0j3q@x6^_iRg*x-JiT!
zz$q)F0hqWTQ1z?%3|m%ATRXle{C({`9{##19=*!J7K_I~$Tf-vZnN`SJ+u=SRfH{&
z_6mGuILh!@aQFwQkD_v5qj!^d9cU<n(%9MP+Z2SSc8tA^$vJx9Pu;5hve4jtP=WKT
zYe@Jt9OJz@KB|$3H$-O(Seu5&1h`kr61(<zkjW+=O}e!%c{70|Jup3vEUb|3#{S59
ztJCm!00nc-Bodyx{FHeYw`TWlc=f7=bKk6oK+&cj_Bh<@%AWqoUi?QaYr>x&tK!C%
zJ@YRBkBm&eKBx-@$b=RpY$8ex5B~p=A?&(jfDrqgSe#4L=a9^g0d3mD>>p=G+_#qX
zYD+B`q#5V&Gf*b(haB2k`6glez5U5`BhRA}T11h*LmMW<r$U?r#Y`^DjwHB9bSB$p
zL0i`-+Tg!|@u2ns89ZAiUvoM`ELI3R%ccv(@rfGNHm7zFe3XO&8PizoeN4J2fk%$p
z>dcz}lF)@#YGym@ZX?pbGNv`4|0YSqeNxwefnq=gY{m&;*4EH4V+Dq75=l#PajQNT
zuLhMcD%md~Z^E|v$M??C4Iu{J6fQy;G$LdtcwO=I80L4zntqMd=oKaKnxeb!WK1%D
zbR%YUsJSDWk%QvE2CB<9aukoyU{ZW4D721U7~AF;AdcC>ZgJk?unh&tTzzY@U~dyb
zTSi2$PDyf~D!|~;))Qp8Bib<tTAu6FAoQvoDE^+W+u6gqiVrHD&t~hy<0x>-a42|D
z2&k36s;Xo&?xHj>t|-#T32Z~)RET4r5sWU!hi_#T-PnY~b#<l!@HEB1tSc;GV63v(
zmi|#s+ki4Yq^TKm^}Qe<SoUl8izBN8cN9JU&41hMMc0mAqfrGlki}9!%TIeg7Tj6}
z^Xl99tSXZS8yaJTI$-2GULtRY;H0uTZG~+k>%~Rxs8ioT{e&m~+SrIZ?ctP>!)gnM
zYgV|#CSr8c#K65=Mcl^W_zy4pO~|DgfMdgrkHW$iss)wFB@m%uJzoYh@JuhKv_5Dl
z`0Z45(5=8u-kuF9TWl#eo^J2OpFvfh^181!xJjZdG-UGyUdd;-oG%Tt=8d(y&XHdG
zKa*V@1*O?aa@%s=e2N|FVl7%iYge%^&6Qw14E*RWz1b;jEdJ+*Ax2xOxIC>r92yrb
zlwYIv;NDUkoeR@zgDu5+o^TU$SuS~iD>s3M43KB8pFg<f=yi0P`31I<_fnU7jH1c=
z$1jR#{lW2w#fq=yhH3-v4HmqI2L|1<1sZF^ko$}=iYjOv^k_RM<ct+c-Ef0w#A<Sc
zD-dlV`1@4`=_iQY&ptbhMiI%6O|s50kqga45n0crd&b@h?IfT~1Ljw1c)kE8YX#uI
zl*|N{ow`>5Z@+5Q+f0J_+He^!x`;G?ML#h~-Dw#W%EA@KhjgL{<_88T!hidTM(C(%
zMKe?@o%)E+jsyv@Ik3KwV^QUP<!u210hG`tW&vh-xgVQ?o>VCP%tb{_E>95Kt3oz|
zS+ZsA^q2DS`ID5=hS2gX4nY@*HU$jL0_4Y2<f1k!Ro=`*`Kl6oup+`HdcX0FYRAOk
zf&TO42GMGDG5iY7u!t6mG<40ZCNpuo?g<c}QZX+NS{M$HxaN7Lur#}rP$iocegyHQ
z8Wf!US?4d_X|bUlK-Q~(haAP`HP+XR7RI&s6Y!eXF{0Qkyzal$N54vYWzGHs?8AVg
zRzwBJEW<|HY>wiM??zCWT62_15xjGcTA%fsg<!hGrj}tpB_4V3aQ^yNw}nM=X5n52
z5HM7LMeR|2Tm=xSV9`8^B4!!Mk5Swkh_<pLwfJmp4ohR46|83solQbxW<ixe*6h*H
z7&XvAjly2pR88{Xn4{O!W=E_AcLoB&$MW-P+=J6CDfz{MJ|#ZwxwrWMSy?#ujI?gb
zZmThtI3YZG?xQ=TbxnM^*uO<T_J3LYb|e?@H2umwD#8-;dBX|Ur>v-!!oj4P@II7>
zvqR>SkMPvY23Je^mmbXEBNI^w_KM4Ib0YL0o!g#_gAqXN>UALW;V8nR(rbpa#WryX
zdXU97PU7O~vU6)UhDVEnV_rf9JphbZ|EZi<C>z}grH7>M5t~QTgp%ZABS8=Y`SGUB
zv9ZlyEv0&TgZlhre6I0_XGgABFT1q$VPWG56V8iUqKWi0s!?A=lxR}m{i~zF-p@bW
zzgoz7UOC~XxokhrfdR)gY@UjzZO8v8^U9Li6zOR-PcIK5NzH6`Yu+H)^q_|R?esh6
zS%MWY%m>h|Q3~A>AKj}muU5q_)6trtB^xXD1hWRN=k80sm(?7xyzIVyDkOb$^3+{k
zU2P=ni$^+Xw)~=Fh1M>;_Pirm(vhfE+jH43z5!3rt|C;N_FL{Cuy#%rQ6f;esmh{{
zIRvkAs2_>KC3nRF#kh43(K=f{gy|tlL^O?l@`o^leTdn8;`F?y#$^SNzNdYCCa4&*
zT3USpV)vXuUvSd*#eCjU^!LK-=bRXh(cuL?Azb&Yy$-cr6GIuN_|ce%i^UvNiFHx)
z>Oy)6T8e_#hWXjn=a{Jj+vq(8Z@O=Jh<zZHWL;^%*A;wBE~P{2gbqPxW}oVR!pC8B
za7i>VcWbRT?tkI?;D}vFc!w_|-Zi}Lxz7l6w?y82CeF*klZe)C6^;55)JlR)I|o=4
ziN)i0X(oKk$XC*2%*B0fOGY=oz`}|nr5pp-gUBg#W1q2Jw-I}Arg*I+_Y4Hj3C>-F
z@iQ1g_e3h&g9|?6l!+LRPfWu%5l_B?C!@DXO$PUXd{TvH=SeQF%>K4uAXrvL54pUH
z49pdc3A!Xy=s$H$^J^`{&5d0q4_QECS~WV}QGALmND0pwhv?=l#Q4faPuA#ZUivCU
z_$RtSmipW?iCdHsd(~F%<B`ETs(h_tO9cN_g=w5rzQ2ynksi-AHj3tM9=7l9xkp4C
z1-_be#tOJgoh(Ihu<XR@A6m9lR3s<}<s>x+U^otp=BGzU{XLtasmol)jX7tzk~;AY
zJje+R(>PDH9x2zTpD<xaq+p?PQ~kZZ`%q|)(9<XTYSQJ?GHG65@ea@dgTODMOjM;_
z2D5ta*?#A6OGR`IZiD-G<*c#rAsHT~ZCVxN4pvtG1~_<Crd?vjbvuNa{NJhd`nK#|
z@5?2aGQR42++k@{U1telMB$)5Mmpnzl5!db$n=y#BbJiE?c??P9n&mm^ZK6PA(;22
z!}U-P)f9Lth^HekVqIa=-n$@NYn|v;8gx4~)sGVn^fVb0`!C2<pDtBqD=nYtw%pEO
z&dkj7zfv*gGwjKB&HHx?R>r&3#fhcHfdlE_Rz4x$1F-W*IJTfl=8IdfL)IhZBO7jf
zuSq7zPJGNE%ci5%soH!4h0xwxauS-B$f`cBGdm`5vD>45Q?j(rQ;pd-HJe<0Jxy59
z0`WAp5!*d}B+8hcZlMGEyM_>;-Z^35q%)ihq1M^U5NjH3bDc(ah;P5~a?|H53F)_>
zuQ<|Kll;v;lw1}CkinvI*gc*AXQecfd@C<gqpE-+#k!Uh!$fvcE>TRzqCMW9OY)>c
z@`;I^T3(gK(#MCj=K{+jyzQmZMiM}73jvy6=Mz!OXRj!Uf*byIv$}u4Mv#vHTxx{A
z<Pd+(q5xsZ8UCx^qf)~BIk9MivolLQbtvBcyPq|2vaO}8!D6FjN+{{G!p%VFRJMdN
zg=)rS93I2B)wRnr(XR=R<mRH}<!CP$e%q~|Ms&mnq7385%_tK9R&ODCNrHSZ=JNWJ
z#Z`@6!xex|k2jP2(VI>Ca?1`|CvWBhVW_X_{vu%-Ze&6xdOCFLy2xEWJr7_2P@T|z
zG537`%aH<VmjJ^!077`XvHMn<jCRYVUx?ih3eZLu&)@l1jOZv+N)?o=zKkO^bJq3Z
zib9oKw_bJW8z+PO)IDL+n4cEGh%_bKb6|*Ki4KEOtyqht!NUpc!Wl6>1MR5#POo-2
zL!`Qo<-;1SC{nNR>@{t2k^^@FpkBJDVrymnKfIK^#54qvyO|dPAPp@iC#pImm9mH2
zDGuxG9&h(PLu5+gQXIK}A%#|{JJ`&`0~3*Ie>zO?cpRiXX5HYlI;i`fDZ@Ar(mTG9
zEbS$(v)q@bVNQ{8^dS`H*I70pLA_>-NkHe2@gq`LrBQ?E&vXdmiC<v&;&^tvk>TLJ
zXE~kmJ@9P>PuGcxlYau2)C_}UymB*$fU9(*vo-T&g~iu3=H0A0KcrteoqaA^EX|H3
z0u$~<$edDL;AT790_6jX+MiwI6?4wY6B0lDP3PW|IpU~S(;B~#W&8nmzQzl?1m{(+
zNTG#Qy!gu?xx|`n(%l)Q%WIigm8%#4scX++=6r>@{m*uE2%?EL?(co+U7?9*-n*~$
znH&GQ$sZ$3l6H6@zfJ_rM3e>B0uUloe)@<&>eod=5I-hzm*OyVIc4_c3FOq>5p4|P
z7k{Hug!oD{5arSWA4H_)xf`P-Ds(Kp``D|bOe?3ncUttc&u^YM)Bxhchg5Ts^`np?
z33u5{wtJTTEnpkk3H<5Ma<F{STIuUJopoJYM|y}Mi=wWJ6o+d$lY<w#`W1IHPL`^c
z&^^YH$4fTvT^MQzx{5BE=dZ8jLqEH>ti7t611Ugy0_ozvC1Qe;J_@1k!^K=!+qziK
z^d9!hy7d!L`F!TSzS5<guwFHP*z4i!QfiIQ{|1F~JFjvQ?hcc?5%Z3(xQ12MzpIf3
zOpk<T$AS)S@k64i8}$g6#Qg?195pxlykwr|Y|OExQMPC!1NMps*$6f<Brdg6=XFzv
zF~MesrN`GcEFj(5KvI)0{*zVznh5W@E3BA4iY24jAulKU(}&z`Kl^+6$^uZUzdtwj
z-Rlm5^yjhSxoqP|-9`n<An9G_(W}P2roWpyTl-^?Zi5qr(^9U#ACNMORRz}-OQ51a
zwSGGgazuP62?-!R3#`=RXia;@RKM>KVtsKk#JM`A@XeMUh;Z@ETY#P!Dl&lN_28yv
z-cz})S>Q@o+oq8B-47Wppjr2K<MuTAWONQE-wRug54D!14(jN1MsxayQmtQ<_YS%&
zH#%b5$vWxnCJNST>fAo&F!0FGZkBacAPvxbjr|~{$QVNp=7WFzEc^(6tb3t0*+OJ|
zVZzmC<5SK459U2dD3;k@;9Ex(qa&Spk^MGQ4FwZtv~UZKTV*W9g;xUqA4&@+TLYHE
z%|!$HjO%G_Cmd&-96m4i$@nfCr9>({ToiP$@9yZD5+Tq{q^(KqBu&hU+-uI|6PW7z
z0msTzR{p@BP4a4^pTX*+OTx^CYf5`}NGLxy6X`$7EY@wWvu_O;d1m#M&H=z4ElSY@
z5xEIA^c28&FFA$nZ0b{9C`8}1&NqOw=9<k6Je6U~9bJ`fZ)Y@c02K8J{hCb_y|L-6
zF5^tN7^|EbchVKT$YX{X>{U(-ANKmlXYn$nzDM#t-da9)?Whou>{$L%7!>o^&kBHM
z`-_M%65Y?fiXaE2<dH2%<u*j4zC!4qe8IoYD}Xvum$dav9Gfn@n!yi2>1PSJ2;iX@
z5k+wD0Yw32mY5K2C1rkcXyjn%t{B3$$Llg54*{1Lnoh+T0ETp8@m|+k2a>+yA)FNw
zFNVwpl(2bc?2P&oipGBTAd8xB?QL5rn+&y7Sw(~uKpzLG^_;EnpD)TL`8C6d%|N=M
zg%7(vCkn(4dF4Ok`F!+&x^^MWLi#p@^>Uo$lKL!Sf6VaLfVa@E8Mo^Hf-~2&d}T_m
zoVvg>L~Maw>bl%OUE<HA6k4{^Yj<^NV#+($<k@C+u!ri$gXqyM3G(=YO1wH|1o2%N
zsMHI@HsH18k#yb~%K)B8FeXo%?ewG)TUpQ%Fcqp>veih4EM92wYZ2ILrc4)sjOu)F
z!D`W5?yJ7Ev4FuG6KejR&f9wrl?U73w0R#knX|mMz+U8%n=QwoE)xZ<3Y~E^WSrG>
zz~vRuzl!=jR}I8@nwl9moIggh>n{P}2Upq@KxN_Q*V2o=SQvyC72tO$;boUqyH;6k
z7qD$WhF39CO)CUv6RDfyJ=TV>@CEW%<wXH4g~91GA&{M&Z_p3F2jx`e+koa506W@J
zk%ZK9$=!t+x~X2{q8<n_EpGi_qI{4<A}h-@@ac1Rh+^S@9cVmT_qcpd<yDudt{q^A
z>%bo0E+|?%Nq4ZaA06bw<1%nY@fqz+WWAC^;%>bAa2<M-k$gHNf2G&E53-a<>+FAJ
zVbZhX8_1a1MG)1wvZyZ$HM07`G*;+k1cAFfTE<cHAgrO5n)G4$t_hJ)U#{v9G1fvo
z+z_>;-oWOBgwLaq^BKr{jaQL|=|S-}-Rvq(B_lk!HCAp1yePFD!8jg^MdlB?!Y*X&
z8DzR1?M#JvSb8T@HrMF^nw7C>4_~=gM7m*mZW5yb>Tz(Kg*>LPVXy+oMvLd26=hpW
zzJCK5ip7Zq7{6@!!~#<93*z8KSeD=^Fl6g5!vDC}<Mq-oR40bzIe6aL`oKrV1lHim
zuHw%5U3U!In1lm&+0<8Z&RD}k7NYi?(lv-RJWwDRFTKk^`qPzUaa*ep_UX>wOi3^>
z$!Sc>ZY71XQeRuujK`gj=leXNFHG*!hUijMO_i&E*9L{URmy9~WvuP(_M4^Hg(LNL
zpEPg<WqwLPx#|7B+C3~?;rj`1S(@7uY~A)P)xZc6%;b<x)0LNmZxO{@(qh4w2y98O
z(9jVW+qFd*8V6uGXpMbfwjE8kR8R_osHmu=cO@>3cPLe&+j5-cP)c2d@Gze;7Z-|K
z7w%~jV_;I{^5m!l%^*KqHl8BkOXLRMUwbzlF6{<I&onZ&R|8E=fVIT!Fisr6f@HkV
z+H+TIfCBE)nqwOU(+?@W#94)zxdR;5h;Pthndn!|Dv6ridE=$X`}Nzm-vD#tNk(GW
zK)>V{Dr%0J6GYT?(E_uxl!4I>>n^P#Sp>8j#h0Q`6r@(PzuV6WHUpEtQ&~HZEd2*D
z1mcKQ5?|1r4&amhhbB~qwzS7jd6(3DR#K}+UCA#B8!DWjDMM{~#u6<gcUs|aY5B%0
zF;>;ttGQNlCJS0ix)~OP!r3F+$UtX%+WpKITmPrAIIX8-?TdzxG81<7hVLwEJv;y0
z@9DeehWbn=RjFwr<t>PMsSh|>iC%dK?YFAVUNeqAj155{@@oN7*BIr$2G^xX5I*U^
zC=nQ?m&C1_`FU`!Cp2_bHFU~yNyr#L`G+d+fL%;#SRX6crCNH-161<rm(oH-ZMF?d
zKj=;#El)3-5teW)(oO8b=cqwpWjVwK4Vluc026k1dM6L=Otj}DF)-4Px#JQ7xSYt&
z{zFyXVQQvS-{c$ECgZ;??WZM;?u@gz@cG*B@wvdfXgC=09;pinu<<8(UnX3a)o!BO
zep!w+*2R`BYt^zAxZGk4w>-A7h5j<}lonDV_o<X9B00AlRsWS%5lzS)tJ)9Zfb->?
zeYx_vh%1rWY9(k=ZoEdS6Sd}oDn3*1ysmw&R4*rDb4qZA;TFdkjMg|V0^}y?llhpg
z@>qZoP3UD|ftNuitjHN(nQ_F|MQ-pokXq}b0~*v**nODNA4n4J0$JO9S6!fx+)(Jb
z!S&vZ<fJg2!qXO3nr2Qog>a7I$vaVDr0<U-5d6`!2?#tdCP~L%!pHXeCR_~1p292?
zIT1GeF#Y2|AoPo3ND10&P_#M1qjM}g4Jj-V@W{tXK~gUl!2m)ky>G5nK>5G$5ekll
zAqpPqZdFnE*zDN$GKFh>fZF9&5(BW7@r}y=5g6LPJsKW%_zV;CUx=I76*ZXpFq_mt
z7FqAEaj9%q5;KZ5)T1Js`QC^&TS^YQA$FKIPr$0O*#TR9g)v3=_SZY;*Ws8iR}3rF
zed8a3vUoABe08c9822zeX8}I$zF8M@RW;|Q*Zg_usfg`$Z~hW~bZ+;~lAwZipS=X0
z{jYt<%!$-rb_S#DdSK8X8pA>x{W1~E=r}_YCE;P?p_`#Lf(MhDv<#l24Fva<IaaS8
zpXra@%H`ZCB;)<BtxIk+2NtGztvqwm2l)6In4mjDXdO}djUELVr3*T-R7D_1E!nM9
zD12|)<fW=Gpv|V_x4!+R;Y6&z+9@PQS~CIeQ#<fnRy9I8YRwH3Bf+)-gHm2kE}9;U
z{co$Q{4lPlqsn1Oi;hwY?Pw`E96zafq0amlt>J%3A^a;y==Ct!N*P%K=o2#q&We3~
zCM@q3=J$H=x2bW7{P$XLa|IrG3XS}`KbxHJ@y5rW#s}jk1jZqIwq>obw0@kbeD{Bb
z2;NYvZXjR0EAYR+o-YvSWLl?v)l$>|-aFb74zcIh3Pza7dbcbE`a>4QW%w82o9RSG
z`v%p?U#ptwd-76`i0=vlXt6+LsoUpizu5Atx>&;|A*Fr9i_cnr-1sg)P;{{L5qzc>
zR;krRZ>;p6&xpM@f|_K1MYSbiyD(;^$E7#^h&)WWxMy3xd3!tIG6^fBzh3>C&TeBh
z78{b5&G+r+32aL0=0&&ftX;AmbJ{|~UBqrbw<ph6(#jMEesCsjE={Rns`=%fx}-$X
zDNXd!Ws^tD3vH&U*X?J~W9VDhBW&lBEUTVEfN8y>6BOu)A4yboWG?%1YN0YDbbLdb
zHhT3-_&1rls7+&bj;FpWHY)G5hjA+ijs|!8Bq=G}mDAHAQ+=#)@8yWul#(DU^dKI=
z3aJ-LT==QOKQ_Pe-nllmh~26u@WV5it$12`@bbRhx)o!^px;F>Ax4^g{1THxfrGBZ
z&F7VsWjp4Yn|5VQ>;l~l7euj=<jv8+LXMpX)^R`U-g+|>#|;-SHPS<RRE2>%%=lsu
z>YDg$Ao0!+e5UUcwfmvWo<?RFSGV+4Hn|T>=p)G<r3axXt<_2Wz~J3cmcyXRZ{1GX
zz@DHV%qfte&ECmuN^ahzUC8M@P45nv4u>ZzfZv*iiWhS@A9{p`={yS3g#}s;WU2Y{
zpuNpfZkar+@d4gO6j>4oCNCY>_2mmDW=qE(1=IEaM0&{6@Bqcz??y>+4-%%HTY;yX
zM1!C`oCp_<N_r7$gy!1ibsv#vAX2I_U=U%s7fyC=<Rezk#^XHD<Z0dXB#+Jzw!UY+
zEBv?yJC=#>9y$#gW+gzF5`4ec6NOld|A*EWWv~?ntA<5Br)e*O%{~Lk1ImYU+u~3d
zCY1TiEF|4g^Anq0r-V0g*Q4d^{Ny_<Yi1f{RT3OsqHGYjk=n=MxVe8<_Xd;g9ZM>_
zV1iABy8#}AX}(XVTk~@Zlc1K5hk=_hQ17Yu480|iZJ6sp3B{cO<00ioG~+{UvL{Bt
zdW3?(!4`tLxU(s<#cKCSEJpbS(=}pM?;zCUji|z|uNWwEsw<(53_QvDTj>^H%+ol8
zuT)T>|A5U+Hc#v2CH+>3ERQ1xHrTd&7K2!`DH6`6xOI>m`uq!f(n;2Vtl8E!>$hGJ
zms*#8eMyL(yq<A<m83)9cSKtXr2xr00s%ncfr-OU8^N1sHVW}2&MM4-`PCeQ@4pWz
zTmywQP3~!^Q#mOed8Wzb8I+BAz+ahJt<lq5xkNh|IOs$Q%0l}62V&si6{n?cs8(bd
z7eXBUC3=^wVKwR~3bA$}^x0&2W5nUG;fH0$;g8Lcj_)cQ80-1wANEwX$N`Lnyg$Fb
z?LZQjMW+oCoL;N2bAN0&Cpu;Kyfn}dh<D9F_D4aIJ9EXhFf_V>%V-~N41rdfy-&Js
zqT2^IE0mTBWA%r!18Szq+e6|zXaQ^P=6f|Q@4DUCRDzuR&L+>LUF-$mj1AV;hegS-
zB}mgz#|R6qq7O?K^z5@&!909Af%0N&#|g?QH60h8xY^NE3vbtYdwsgc!)K0j#(gm>
zA?0U4`%AUw5;JV(EE%!Pwsb#&9XwSHYo`U0F4YV=xxxB*3N4LBzLOyg9h1JZ$%7nm
zvRa4%P(qVkx-AJu63J+hSNACX$kB<GcakB!#~AJ90!2QvPtEd*t!k88L6=yP-!UH{
z3@d#@rhGJgrd6BSK=<SmyGk=~ne&GyNzuYGH`+nSsPe#NeqJ`2-SeSR{?DjawrTg(
ztlXX$PNA+YolgIIJp;Ti&ufSti(nk%f`+Ri!Z?o}V!8O{D%#MI$z0ny1TTCcdDwYu
z<#zEq&nv$4=*uLFHcqXp$>|G<%*yyf;@6pd(}KKeX#KtFjA|VYA0pER`pNJq&eF-|
z&LLSNiX@s2*v<#Vf!qj11F#X;v#yIVaCTM?$Mp+;YjKKrAUVGBu{iOCPF17wLAL(R
zt6CTOjK~WivXgQDe3?xkMsK1;<M)$ehNdKG{5NGVfN$fh46lwvpZ=|>YHr8n`Dm2n
z@sP>+0lHi|QPIl|VxR|nA%2oQ4$>hH`MRu;x54v1#n*O3DIS;4aK080?~!dA3gQ>9
znKYrTZ5hZR;{%noV`#(=ZFh66#Q?(XzSK%l6Ls7($G3on78s=NQ486a#dLMdWiW5}
z!J(Y&5%QxhRZ*0GPQUP)1fZ!zwi7SDPo!;&@`-f<^~`T^`*~>_WMf-5_yj7;=^W{w
zgFK(Y$lF&t(krD*(M#d=QCKy4_NHj2*_Q<k%ZL&>4}|Py8a)$>%_vS?(!S*Xf<oyz
zGE4}`PwY?nyg^osn^r=V&nnPl0aU2j<9?jZGWf?zdFdM#1i?A&@$7aB)kVfN2IpY>
z!KeHi@fjN<^>+rBp+4~iM@#DDKl_VdDe@-GXvj*0-hd<vAn$T9cKF`CC8_*6SZ>Z9
zc3hgz9>dHf+W=)oladyoEmJH1`@tJbSJO=JN%lIMmX~F`DSxHfA(NHhUMw6w5ZYzS
zPfBi$Jz)asV&Em_uN5%vgB(#$k&NQQ+Xy;$+c>h|4Ydc-ys*;zYiK(^hps-vJztqT
zbSm22#2}F)D!G@zRRE%49t3Y<?kb>jL4uARzXM8j78y6kbXH>0A4q!o!gpvfLWqoN
zJU6^PS+%d$MX_4I`7Ne3u`L=G190qno@$44{IxD@pl|lWl5xkb7-g+PD`bs0f}}wk
zlKwl2!xAeS`}I2%R;U-1cI#I9dV!y{_K;7UNxSvz0S~g6fhKhk0tH0{sl~mm!t(^y
zkHp>jp}b)SaaNP!7VXj;DLQQKAY@OHoUg*bj5%1OCf#%Q6=^_JXwh<Ad9{w~l^Uay
zdfgIms*L}6JG3azbP<6&uk%N=A}vZ<&nz$;gQVt~+**2y{Y(_kFjr<vQY82bl9E!K
zL}@8E(XqSE`KS~Eq`E4C&W%BcQp&6R%DNwh4R(|t0d4MBaj2@u)hdrvYA(V@OZ3OT
zdlS4m?T*(+Z-u3my!E4(4PK*p?WUbiXM7}%T*f77?7||DOM;@iAr1k{UquN|1h}8q
z#-=d=3<^+OVXt0)W|bd{T@?GY7>3A#*AtguHC4?_qzy;KLLy0cB9u}EQFNe76zI;A
zC}X|>tsN|O{>doGGXOAExpiZ)Id~xPTPC?WN9EHiZe>lm_}koh)L;K^XF8hUM5TV<
zUheQ}u7P$WRzl(UJ=|r6N$4_5Vf20D#yZh@%uecmr*<rdMtjbNi>m&T@t6pkW8%Tl
znEc>RXw4UYt=KxO*!fPip5)gpGl4q?RF^=>5nMxmvanLS$Las<t@1EqPimo{ey&wH
zn0KV1X`BKLO|E#bhsixc9)of(yO?N#Qd)_TnTyoahEfP8pn}vtK5!?X!HSRiA2HCp
zqEUo=x0uSNiXn&sW<aJ=rhZo4^F6N;reca~<v|+ei9zI*Vz|)T-hcrOnN@V@*e0g;
zZM|d?w|Fg5Lpe58<op);;Tk586s!{ij?sqpUWilCJZ$Ce5xUo6Aw|+tc+P0AncdDn
znV5wNsklL{s4_mU5g9{cBmx8AG1V_H2=jj-PeZ1NFpiVrA}B+(YdY-b%(T+TL~BQW
zm_#gZGa_GS0Wnco-~8mM&01q=NoC^}j=Q}0Z7@luoPh}J1WxEF-;-ArG^~^9AnFOY
z151(ZggV0dw3F4yAi&}Z1m_jk!<dVs{d4Ws(Z?;@B1h!mrC7}?Q^qjSgj<vnCzI1e
zg_56(xrTKGh%th{97%?f9nf`Lc7&CAR5_qBa0_)q1ni;?<aYcJ=I6*h8YQ2PJFZL$
zY)Yq0SQx*Xld{=)&l4cQXQ$;RdhZmQzKeK`;l0;0Zr)S32>3|6cuWc|4tl{KE~i9Y
zt6Hlb9D=c-iT!4qp3K*ueLg3f%>ILk_b65FBoiHoWE;-%{8OuM>Un!Tn<x3baov#!
zAYnW4;IuX9^J{;@8gi|YMNZ<$e98|Gz+RXEaQ#?HVd1LWCaRnbBPQqYQ=D}VRWD|0
z&<*R91aKpM#Q)hkoPdX9@_b=`zoK<L@=T;Go7ZS$<(#J;-0Y&#`Q&w9ARvE+y4BSq
zP5~WVA7Q#5Kz_V>13$$*lBeW|@q(*4w08aejif#XrU_^&K4u@UaXmPm5lLN*({zuJ
zG=d5zC1$AmSN*NiUTkR@;V`oSY?q=7Gp)9~CyQA6Y!7bDQSr*ANXE3%0wbLA$dcGE
zUSF-wH!mE5VRo=y`sfH6$7>Lgdsx5BTT#e%fNTp8O27Jelr?yiOKZ<aMYVuBH|D)E
z3N$bZBvr*Z^d7~M$(`$VDS6d=3c-p~dVj0XBjLgIZ~v9Qb$L~KQ%{XD`X_Y^K1W`Q
zD%SpI0Q=2s4$}EA%=?g*364T=HhWlyex_6`;?y5g0RrQ%q<?#|E}9#9nV^kOXU9+!
z1Qb(E1h#51Ua#Jyy%a=(m40|#fDOuEFYX4w>l;u1!?0r4o@P$x`v`E)OEyFjb_ZM;
z4*D>`0jwn))XZCWZzAPegVjxuyZ|HWIaRa|Y?mi!qmlGfpu3qL`<2ZQ<uCl*$&}`T
zSMS=Z-$7B;O3tpfA>g&KMOv%u=uO5?#!rNhq99C=aGM2%RJkJ{VG(ZAH-ras0o)Di
z;i(J=+{|v4i2vcml7IgHh&qC-zm_ScCm2EC#0_L2E$}tOxN+@zE~+dP4xlm(pRtIb
zDnX>AEf3jjY*RFM9obW1AO8RYf+`!{jB=1moIZ)PKPt&OSNU*BAKXUAXaue~blTw*
zT<c9ZxAijRS>C$rCF6LbGE|p`JOfHy*T{-VXA+3AZhATBC(WZ@JHb!@gd|@hyk!ip
z@{%>38OF4+MCZ8F%x;T)?>AbA4jy{tKx7%T4o-T4Bwn6yNjrxrlbcxJAS{*Muafi^
z68KEB)jTU(m3P2zgzZ2i03_#m;0nt~4gd^?C21{jNN&U?3`+Rnw`#I@OTn04=8io@
zRNRr9$evGmpY2~GY5F6ozUOEZd1k{qGcCn@8(q9vz}h(RXynf&slZ(HCXW_9gV&?H
z5`s|jJ|xp7X0#w=*x;YRIfdIiSJ$ztqwJ(=JjMx&iR$<?URg2h`}{76HgfL~!QmiP
zI)A`!+r>yD_R!<5Fki|vcI%%!H|Jh55)AAN{@x}Gu2QYTu{rzT04o--Fwzd;E2-#s
z9;<6ZY?sQ!=x~a}csji=fqU3cH*`mYV^Q_6_{6_?Q7iulxYXdq2G5+1EfS#=;f42~
zH%vRLp9OwLG4YuRB9yOja=PgTh5LzcE^tOF>P_Ja=@Ytf&>r~eZl*lrGuF@dgRz+d
z!3zkp&}n1;Lz#GZeSPZt2b1O(oJ2@nO8heDYUsmM1t<>%JzpE?G~3Z0L<OFw+%z=&
zRdZZ{-&hv{a-Xx+-HbrYS>yrd_RyoN&xu-xqv7}T?m1vN@o)m_9D5kkzmQC6tHxLC
zFF}bxHrSYB^RViPTVk^xDuc6Hj<50JHw&4*uFhYyX-4O1vF$TD1I&_=i%@&o0_U}P
zz+tA9Pbt<IH<b*g@(lT9Vkyi31Qq@s!NE_>j0}hl;>iL-&rq;!)7CXiL=1^Ysh~7o
zXR$g<Kns58&Cx?G@t%D19}4LO2AmC+eL(Qk2F3E<sR)))>izDsuJXU4-m4zkO5H=Q
zHhjxW_VH-Ar69VV`AcGZ8s23=!lME2F8^Ks9{qG|>L2}*qgpJA%r2&g>&ndt9RIFB
z(Iy%iVeQO#r-R287`^#IU00*@4Bpr4ssZqT#0+PE%Z;oZw72Fo)mm*U)<;ZSYy~3P
zik`Dx&8{LL6YoZ*+rMo4NT&s{7}hY-FQdCKTX_AN)S3oR>7*w`+Vm5}L6vBQyx{YV
zbqt~dwz-t`=ayFaqAXZbX%huXI;-j{7YTlPZccWv4&+$#rBMm^y-1uJb|2jQdH@ED
zY28a~U2G<XVC|H1XX&!8UC|Rf+4c>oHQyLKj4R>p5;^0LCPiZ1o7rkM-l<40R$C>y
zAObF2kn~~CPU_PDpQVW3^%>DBps%9+gb2xz9iJVfi@zyIr+VqNboS_sITQ)Ka#+T;
zYqZi-2Ox-=x0e(cN!taf5#nOOd~98<*A)pzy-2|77|sB99X6MB=JX?(wlbN|Lw!f(
z1ui>C*1cB#TIl1gNDcNg3l}?Z@-;U_T<B6B%kc)Z6R0{PM<;0VOOKSzvk$yhCq+q9
zQMdKC&b(qm43XX*sTL}3cpGUO6`#|WH#^FAMGv58obj_=3s}v*_5v(ITD+Csou|fl
zuAb-!n5;#f<oo%O*|#pTIQN%kT)Xk9W6nh{G1d{XfkY7UXh>_dZ%<Eq_q-aa(tQ`<
zB41?U1gb4=Pbga*?`{y4hmvG5INSL>W<uLsp-Dyxgq7P_d4xj#RUxmo(jcviUjp7?
zdP*Nc=t4b~ixDtp69?C@w>q13OPAlGTYx>f%)Bs&lR9O1+JXB@wj_E$H>`_$P9;t!
z6+L+{-Hy#jP9u;+az0-dL7tlbU8H8v!&nbJrl($FCLhauIucbQlj#Np*V_N@wqJ3^
zd8DEU3N81fu<KZoZq5L1(RGm}ww`%<Z7QVO4N!%ZbTHWmO)D+tIlGM?!feea0W8Ar
zdLc3&x%<!gdPL9!{zMl&lA~+>Bz@R6JeqzrL*@XZ*ATQ~>wLAk6VR*xG*&TPk-c{t
zhcezZaz!a;LH>OI$fun-^sg*rK6?_AtsJ03#u(ohWSvb_Nto>S^7C$Xdy<#Iq|Cn!
zpl?o>N#M-m$7G^9WB?jQwb-qYC2xEo!bc_}9+bKukco9F6Eu`$Q3i{+qdDNllDzY(
z2~b2yQd2t&oEbIxbGIN}(6@PWgf>{4(0AHN+PJDZh#bs;>WnMp*M=?uQZ1QGDImk1
zML}SIqYQ1~pP{)_lV2FRZxg7deG|>#0to7GF$rovCa26>s4OKoh9c!$1MhCr{*Hl0
zR=ZkQoMSa@m4R99Z1Re<2w!g4CR9uH9--Qa=Urni?FI;eR#SRB0zyLfP}8u)Ecqd^
zUn7e%N0!SSPo?t=?zRP-yd{rb#Md!f7D0e4DpSzdr*`=zni~cAUOFMjd&%hBaOpGZ
z=d-V?(D^|IkA1*J0_Vl~UKZv#Bx(+VB27RrT)7+`22Ub13=EH8eVSXI<^L+PG(v=v
zG`7PY_?VYgGg(!=5tV5RU<`Y6Z=GK;*)m>QA4#C7X!nuB@3gDLL(ynBfPNv#Qmdk}
z9zptQfJ$7po_7GLGB&vH<*xW8X`e!$fDWf#tqnsc!GH}{wO0-4Ho7;yE;mQ(Ptu7+
zF!dK-CJ!Fhd0IECp{xO@nNzQ3vzSQsUz>R+NmrW%dckN#8x`9cCB5wV{)DB(x2zGi
zBr3F#W(K#4qGaOtw9ermY5Bl@cHwS4mA4sktC3TT#Yhknp8FZ=n*Rf1D)jjPN*(v7
za(g2mf!Q$rR@~T(k1#fBqR&HKj;n7m*D9}e8euKg#dma<SHGHTQji(_2)(OyR7K$*
zb40WUioHxbNc$?)0K=soWdV=?TSQ~}L8fNH)^|f~?qIUZfT~wn>oFbKQ94AQembU0
zaehznb8FQ-G~q6*`3o{11vOEO0-Ku(uBOIDOW|B#>temgA`z>Xk+*4ytr^_%9c`Lx
z3<1wg>{hKc6>9m9iqvs1{8ZFVV|I{s1ZDU1I3cpjrF4K)d&XMC=3+(^uEF`d;B9Sh
zwPv*9G8(3I!LFLUcxoIY^Hu$)QURqQ%#xV7T?%?vT;v595<DlW+wS?HCeons<-#d2
z3_Bhz0r6Ow6RQYRGe;kLa{|(La|4Ah@;+g63D3TWLl*CYe8jzc#JJy?&#I&r%qmYR
z?qTM^At7joKof&r;USKOL>eSuV3WpqjXkltqrsJXBxGv+hA0CEJZjI!PdQ!9-62L1
zfTB?q2^u+j8H_du4whm_k-ZQF3Yvt5p<$S2OxJeEf0uXp%s!VmX-cgxK&jT6)&0;%
z7mOfVRks{Fhdj@h5)T)NcpRI#VC~d0ggV*@vubx4TzTX*3p6>N1a6#&;EoF~+QVvS
z*hf>?tC}zmzR|thINtm#lPh~_CA~qVHZx0|8O!jKlE<KTwilX>f75Y*n<9}cj_K)q
zUj4U|g3XCY(^SP<MMazMf!%;9sBOeOttJDc&}o7&1d}ICo{2fZy_aDcVK5jlO7y$X
zqN#OuaC|xlA~z6VbmAixV;l=F!q$Y9h(0OyS9tE1pbT%ZwTo9P5TWz_AGi0BnyCed
zt4%ApuHy%0=eE&i3CJ;vjgz5Jp?Ri(3153Y*V9U_OjLHE+L*rXp5F#Z`qlIwI@nM-
zI{;V!pUmDj-JrHF+6;_h#aXLkA0H?=w4Bm~xbP86yAAqAnUYm}yNSl2S+>>L_#05q
znH@aa{Rn01ZVDB-JJUhYs&~NvRH*9k+8O~|a32hhvBOA}13NXJ{hg)(-)9jB;2dBP
zRtqaDto0a+-0BD@?x=&u^nwAjheLm3{>AQsd?eG7#AtvkEYGQSCk}2@ETX=<36pBo
zy8qn=+73ptUNL)PBX0%q`umrhw&!vvb&tyjs`=z)a{x>cUZXTuvj>M&{c}~W%Dilt
zN@AJ{mdVOi&GptlZ8H<+1xfv*4EH_t&1whjdgdh^Bk`)*Wx0U^orbQjz02_8Sk(ji
zBvl-YysJG-c@s{+4c|434~xmjZ(j?+I&(JTmRl9ESd@8oB(Vn2YZgI1IN#>pPUTUm
zSM7(5(akPE#5VBmNFer*avZRQh*@<Jj6|QfR3+O~$bISQ*p!%^rjG)gzKuYpTDZ!=
zpP@x4P3mJK5&=Fgm7aVFQnIlJZ0mug$!skp%NM<4=j}&82qAkPI3%<7`}EOJ5KQ@%
zyp|@3&u$yCcdUQ4-l8icUvU<{pvE=9rIuueI}i!R9ohZYQcVt6=#VE!myc_Z0V>jt
zeKF_C1<J^|Bjft`>B;mW*%-()%iDTMQ^ha#7~`_5=&n6say;6Z0(Ml4Jtbhgi4jNx
z39j2{c^?Pw98a!>na@_kP`i`b*R3|8Wn;lWXE70nRS3x0#;S>u!TlE0@LPoL^u6cT
z(KgNmG=w)@H(@k8n`LlGtoqMbdB~F4UkJi}sK*A59Rc1}RA&{T1HGsBq^OHYm-!c)
zTte)3l%5(R>Lw5?baEL^17L{cV*MNfXdqi9<2l2`;bWc7g>3H3!wpwXmC~sjI1P};
z7Dfm_5c)rZyj**cZ|_F`XtieX;0q;Q#xdJ6f$rgEg~#BN?Ov((_-arHkEkui`_|i}
zU~(IrpKMg^T_of2Fih++)c4HI_3>Q(YC9`q4aN95S3F#PEOy*=jiTU~78rkuDdv9E
zCn+hqNu})5G0uJ{ErLXJr845gH42ncM7`$M_f-XUS5aoSOa1@>bcX&Z;y~995Vs%a
zf?jKEs8G|%b}owJAywl$Io^Ii1}_KsUFr_Uy55f6yyTa#DD!&t2Xg~sn1AgBhg#e<
z+G<f?IOixy^g(d}-tZ~inMmM6+f_7j2I;6zEi~cv3G`_q3!DPAsu{f8{!&G5RbLY#
zAWBf#nIs;!8*X>3PZ4IoW?bi9nbo)4L!LrVof)V%$2Ii@wEDQ^0R3GaJi+=`Ip*@H
zq>-OL5sg83Ca(R)1X#!)eYcK!_WZh;LEb}ta)u3aUtLTs1f`FHzcWB|^JVSQ0Jm2*
z=J@bQAjt@@`b0ff%6f7HqL6%<(8N~p_o`_?*W>93IPc@ElK!{UE(}_iocl4Ph+MqE
zH6y2^h*c*{G<#x_)l!`iH?V-=t8nCHC>0(BPOtP!yOKjSyJevnW^5j#lIa;rAgY=H
z8hgm1T$X)^^`>+dRc_6momZ04JCL8$1_WZd>T>HTpj-7SBn<lfrcBjTN`BgJD&P~E
zhdQ9SkUgj9NK~NMq_by0bvYGdY<ivWhYMI-SD}R@=>qDt0Gpc0B$r<O6d)(_7lKb%
z<omnsWM>jX`R&B>R+wyTsD(?iGnDxK;ZGvF1~Rti5Sh|x4EFa-F_EFG8USrS2c~rm
zs`3|)LH9~WW*+=ABsZC8g+@B6U1C1*9=m_ziz{FJxy#p{4>sltK${JTrflUR6Q0!3
zPCpJnK=WD91|H@8D^D90R-ZN`LS+bpjXk@b2j)i-YttIu!4r9PaQEGhXQe=YO(Tsh
z{}U4qX)LI48_l944-vLN8S%9G9Dzxc^%9218adOXQa~?gJ{DR;G5BJmfWf1g(~PVW
z9lz1fsqZ|p=|>U9UPH8=*($0a029K^Ep3Uc%@m+5P}a>Wme<5A{;Nu2cZQkHUZ~nx
z<jrcv0ZOt0UGEdMK|IJ(Kb%KW^K&%UB3o03x-QBB@V})(zj{q0o=)JO!Yvd2Z%=uE
zS~W)s7(UG|o!eQdveHc_loKj(wj5~Y^EXdLCK#BwB2_~nbh5W07I#!si#)!|nvM|b
zp}-AKyFf5pRf`dGP;ydz^aIlW-UFsv&k6H1s?<~ltxh<NrX%;lqv4ZDY~sU~(E4H?
z#Hp7Do^I9oRY4_6E7Y(fs)*P~2RFLjl7*fT(7zvUP&#A|qH-;!f$Ea18uz^KOqnFv
zhPeWYzL8@<O7sLvVX~;52Pn&LO3~ucOm;m`^lxQ33m+WYl4}!-#vCQPa)SZYgbAbx
z1fD<xF43OI<;J9@F&TJkZi(TYbVVh5Jg`XvV8jAC#Q+eCD59+sfGDBv98p50XYAE@
z^}UH3(hXVq`ZeZ#^g|XMZx4L@$L9w4-%ZK6m*Ljwt1S&QQVqSVB`R_eaXAo-7LM*B
zH`HIeb1-PN6X5bGEhSqH&ovDI6VMi)QBD9iK*+y`sL7bz{=evt%+zWL%F>iok{bvF
z>JmY6bs+uduG`eJkCAYXr}K+DVysGt$FV|?&@;eJ<V4oN0CpncbXRkLLIjmy63)}~
zkcl0R{!)G-D!XPkAg{FO5JL!p>m<R~)PXCXVgtX}_z2Ftp;&<8EwMgxDecjXtB@Nm
zG!#BsGC3;a`342v_jnf#4O)+i{zMSiTFtF<@9f{?^_xfU^Mf!TYti3+c@t;%s3;o5
zZeY*OqVCwAZTlcM2+G%-kcj7Y*R95sNj&HCk3U>Ls-?{1$QCiGI{SCufYG=ENm#Gw
zHLSY3G|`=FOB*ZFN*Zw}nskqbH;~u)dua&(M@%4(2RJ8`nH+uX)l=9pbzAUagxQ1y
zXZt-pm|~8J8uE(WyU0{9LtZ)ajq(Dx``;ZWQ^ZO0p=8ky%IZ7fIj~tP-i0xhZ%L!2
z2WOC9AWK4I1;hfpl05##W0(9P9r;5y-Kaxv-@a>?)i#^Zy~>HT|3a!`&iBi1QwZ5d
zBz@X)Aj3RX9EMcmHmSFT6Rqp-`xgjX-g$}0+CDBCfAD2&4GWc1k9>X2ruP#kDmPaG
zA%*b`Ljy;pV`pb@bx!_1qMOwTh>cnj^LtFDDbWo=N_#>9Y~&5IlnXdnQ%+@0p3qz>
z`6ZP%TT}L5!JM@}@gEM>v-Tl)+_-lU+RsIYdeB$*3Bt!b(&E}l&W<vtFqRygwc$;!
zR}*x{FpOKOktBUZ3RW;XEjUF)$p7?(tJ_SKJ3Pc4yW3j-Ft|*Nc!}Aa(1}Ol`sJ9-
zyt1<|i#s^cY58KD>}GXlteMzjx=G_5zQc;~4vTS%t%0qFyHi;f$~dR=3>jKZg$v$8
z?cC;282m#9cGN6Z^}_40l)sUzrfl;)mIYg_$?K`F;`qxezj)IO^4SjUW$4`!szRlP
zGZ9%YNr~4C-?g-uiDX?dp<mF;uulyqiJc>>-c7$%W7YuVOoP(ejO=>7iGzVDI2%|^
zW<g!+-QRh}><0p2?&z#NP!E8z+{pN{Mw+<#@7f?w!JfqSz;%4=aaFAm9-WX<>BNCb
zML9i}S7d13eni)2WrVG9&_iwn4n}+i*nO?4Q;KBPh@5kY@Pkch8EVnNOo)b+s*w-1
z&zD>!Qb+pkejI|78<OGs`qjh_^mXH(TqS=A@>Vjb&85UY4!PwjGK+a68$+QXR=S1H
zgnPwVs^5FUwmKF)Rk3Wf_9I;m%TAZ13x>kPF+G4$Qg`_#MI3Fpal+%F`9g~&mj`{T
z-`0_Ba7IAQ6fEMkv9tbmqQ0+jrFwlXj{=9_nO?)ixndB{p4sd~0yLQDS9;Bls&=Xb
z?4`Lh#@g-Hf-i3BT%O&L{m1kyw4re0(r2EBI?Kv+sptWYg5B!4X6E{gIvnxh#r#5M
z8#7jXfDA=(2>+&#B;PS*540S*Gz)J34tRoIRU3+d@FiADKk2kE`8Ox%zm@~QDJno$
z;P4U%Pa0DjAK6C0i%o~3ag;D$w(}iPh#w~If<&M$ez?kc^N^QM{|S&nh90Hrg4<~D
z06+6keJ0`|gGz9b#W8!ko_f|GEiVAw-6-N8tW6>@EkI4kPvYFu?aKPs5FCg^7Jfuj
z#F_nEs{RylDom9*2Q-|Bot7qq<t=@Prj-;|iM^uwl^VE~9zd@o9QhIqcU>kgszF7%
zU37%-Abbc!_HYma)ejTd-k?~<lKX*(zjj#+2!UaS)+p`3oQI=*$@w9f@mViTGh!Cv
z`W2pxIxS16IvP50nw79f&8ad`&WNyVXT$eOy=nCZzw+H<VSPKrq}T&xVskR|#H+mQ
zLaw|^-Jf4+Uz6_bu?BVBBqF^fH$$UxZ)pKi7gZbi%y)5J(yyUvkKI5z>aLwx;JI{o
zl;eRSyUIP2ozP$^m)7n|N1w6}q)Ctl7RF&Ek)v$w9>n8E1t~M<DVK3(hguj59{61!
z@x6Y%R4unOs@&I65waCl(P_aOxG07rc8D&ORPh5w5#Qh4jlS;GAI|Ee(j;*?{W>nP
z>9~>)m<6k5(fWo~5{?DAqaeE87V=BaJO@k|)Ua{eKcoRyrdl-$Fr{TIMJSMW2&MKq
z%Vq1Z{`X*qXm9}8kCeiG)G|{cy+5GoiFiL3xKoV!-4;&HJ4rZahiNYy=<}EyD4;z3
z9hIXqlRtj^72b0?2VfPV7UBmWG{d#q$8aGksBkZ}wHd*px!|yGDd3EruJ#Mh3NNda
z-kv+6?Z8sjsngku(2N}ZS|&^5iI)u=(ko{_?TIkE-7(4&Mbeo>bo2;wvNmq@1Sk-)
zL%bBIU_k0(2hIt95Nx6NfJJa>WZ8bZn(lED<Xa)LB&fm|)CWfKwiny)APDiGX;vIy
z_M{0wM%QqIRPh5~{B2g~Z6rPJGCdG){j<)+p51TyO(!*NPLQx4<R7xqLQF({U_H-U
zL#MpBTyeD|<m*X#lq?KVzH9cy{*@47%oqz4Vi@=S9M(Dqz=Z1bZ$n3stLSV|bCwfg
zsNs!3ibUhrv89foqJ<tpgX(L^Akb$`FQgqF)2=8wnXW#(!RXi!Inmzy`rGZywgLmj
za%8#S4dvE*FMHX*oPPQm677;|u!&YV5Xi3wkSqqgcNqL46~T$j_VzIrF`DmC;d>?_
z+G{>+%ouyBk|K$%YrO-c)E{m8EHfj?gGcWId@ii(XOL!H?!m1G4LrbaT%912Sm&D2
z9W$-VdXIkfrV1awSRMm-#3&R<HTQf`p<^{&ccoJirk=&npfCaHz5&nIBix1T+o>KW
z9=^6a{-k9p0a+KsvcXA~<$g<N-8*335#-`msDGT}<RG*V9RWY?3J9IDtJAN1eYQtj
z(i6hZ*Ts{&Tv$P>3ktXvq_RlQmZ0G!3*rG)xGVK)u;-C)5bV*7n$)R9an5$dW+D|l
z=hE?UfY*z%I<5%rjoAiD(zk*shH#iddMybRNr>cO2YD1-`Lenx-aItAZSjLI<M)|j
z?E|pzrpMdac{a0T<*FLQ)dH4^i2*qc+kb8d-=Kyk?Wb^&^2xbN$O-}W)}HYa>xy7`
z4UnXWI#(7W7wxl~nUX^oC^nduM!p52938Fj8)yc0gA3$J+wv?t6mhNe!JtN?W8?{#
z7`1I4u`J8TcUXXJ=TXo}<SRCn{;mTL+Ccpt-?DT$evyRG4tkW$?-q-I&zEa*lR(GF
z+@EUt2SOTliE*A^n#98f+`}!QGAYNiff<3QHs1^C61<<fa<@4WvxF8Sw!a8OA{b;O
z$6i<@a57DQT$<^X95nA*)_z0CkGwS6#<E0y#sR(WSGS=Kc?#f#)^I44baN1BukAJE
zr|!DEZg#Y;LZRyb*7sz|tQP*0G+uYpcgzzO@eSYo<z!S>;xIr{oxOHt5T}k{h;CsW
z#JFqE_d_%AEh9R|g&t-A_RL;A-1A^{uN?tj7q+pfe_xcjCjYtRSJnkhYSI({5OvJ}
z*5<up0z)wkPr^T!X1=aO@>g>*BvP_amyNjz35G^I%{o9>mbhNmWvHJ<IXF$p?T)Ch
z0@6|C&0gPt4+gXOFsiP$#7^D)E*Sj>NAM$rXTx~JzvX3KPe532C`eTNE6xe~OY-7Y
z&WNEvzip7iAe|kk$Zn!%rk=ei^8}AvR`AF@+5Z}0rW^dm#>L-yd#$rA7IXe=gz^$=
zjy;*lOU(b(`}-bmz$`R6(_H4kcHgj9)n`>aXG#)3L9DmoB2+?T0N{nA6xAxilM5Z;
zSO^kat7yd<!r!4DAf3+3T2jrKTG+&xy?6?iqM+2<F9St!oaHX<>f+u-N%MDS*N6=R
z`Ms1_P!#RIP?XS)%z%?55?`C0gjV8AUFvnPbpH4GS6ZDUFVCrXcen)gEn;&wr~)^@
zh51%RheG|Z02%TZCIYA1p6Lb~d`@6P&XgF3C-5*U64bSgA#H<oy6+XpfoD;~vd#aD
zo%y$Ri<7fSHO~V!a`RzC+0Zqtse5nFB)z6!H)|>1K4lBNF#D!6*{M{{Wn*79#1y<g
zHr)!&scyw${_|tZM%Jks-k}4#-8}O2Z(%#uSTP8?=&dX)ymYvDM$(miAMR_%rjt4a
zd5h8Z;v0T5PM!ZeHj0{j<xPF<OD6@BDXs4(dlq0Wt4bv{7gC2Dtdyh*Se-&UK|}s9
zHSNhwJkFFrURseum}BP^x799Q)v~A7JFzXPuWW`0-J1kWHIzd*)Hq^!rQAvOJ!OU^
zi1c~~9){$6efaDIhJz3lDwKIV*_qoyXRgsO85Rqg*f=xDi823#`X<j2%;WS!N48z2
z4SiQRr^T1;p~g52U`6H~ibjct1RyS?TpDX{4`=L5LsXK#Y*?CrR2X*F-EZ&^@L{6Q
zKjnX<!6vk}3t7m=3Qo8NcvqCg*)l%tA&U4pP^ijqK@|7D_1?WrZIN^Vdot$JxWv8X
z2V_}V*RKvz_+Ud0OQ3ehcb5d@OPo+jVM$DNH8ChERuC4~e4>COz(CdSqaj(!(wR31
z8K+*(U^Kr#erocHs84>W*pQP{oKq;C2n;FyB8hH*@<5-!zODofTYCf&)aQtPX^q3Q
zr8(8txP@~~?;tX7(sY*EF(;B9P7bW!MGCtO7<`_^fC*_PV11-h-ZM5(JC+73iLO0y
z7O0DT%(k^DV~TAT)TOnC5P5oK%~4=kl{282u*4an-Igj7yUEGKG-x>%Bs)P}*sF87
z6Ju7<aFH>6Kr(R@)fBRQqRr6fuOIWjozE(AQ?sHRA<y(|92+Od2iFhTX0j-C%se1?
zCpasVUR1qe=)h2+`tjKle_`+v2{gB5f?zqoLj+RPFlcagt%=eO=LGR`Q7nBtfoM2w
z8KKsiYtO*l*k|dEUVaq%TqSsi9njh>mmj$ibZ#Z26fi$jXp)Y|m-9?Y32&TIL&ESl
zioO1pa+nh=7VaPh#23KgCNu?Ze|BnEhE(KE9QV@nV!&9md9A;j_U|1>9%*1*&2|QD
z?2n|}j|i0fpR8VtyxAfX&3!x<M#9!)Kl7GGVID8I=~)@KdI5*>%BuYrKOlHv(4Z<e
z^}dY3J_JIJJEZwr+2C+bl0-_itBKBs1<L)zMgwL)Ax?b{L?7P)i5Co3Zd;{G&@;&E
zkw3tP?*$~A{Xe>z$@!AfAHw3lwZ4JDY)Po*?N;!+*99$D5hWqg%y*HY5##x>&WLiQ
z3>~dsG|j?Te#I^mJkW(eg(BTfMJ`TS34+y2y6pg8ow={9p_v~`Jyl|M8y@DJqkp52
znd?xE`R5s$1E3u<X9Wz_^grtLE_L~fMUJsQrU0v={~rS`t)i<_^2$QA-9+-PBMP)m
zXjvup$mT8q72IzR`}&dPEfHwm*vN4cK*ed2Y1@-NrRvUC97uy@WgJp&?QjG``7ICf
zF)-B>>&)tz5uG65J$r*68u)DF08E5TYd8*I{E#OSiI_d09>g^y(O__uQ2R}<KAM!Q
zytv~x5c@w*2CCOsPB!!!IX<Cp`z5=P?E~jMRy1<R^`hz_>AefsJPOV8O0%YUSC?jt
zd{!;ph1VcRan=&#^}$QJ(PacQ^VoJ_zS_y3XT518@g=j{Y2A%^{G9WES2zHnf)o44
z9o;2ot&WSxNiREsij2z0xP{QtaQk^|CcQ-u(hy0S1g35W$8DlLWrJ+7lJv|-Fi>&;
zmN=TFG9QAd03W^fsYa$oRzKG-kE&!G^t4fAHGWp+WviqByy}THvpLkTmPaoeWZbio
za#5i6QjV+@AR<7cM3pAZ#(G>Bw9rX55ia7bt(sDsJ|A0;0p(kH7?M{pk1DtzhaQ{j
z3`u)pHnMRk5230t()VZ)M-f^Yy{>;zs~1t&Rxv74`dXf-5_*hX8NG2{#wUA8^{9wL
z0j;4#rWSX7g|~7C5e^YDJaJMNw5fzfbS<j>?KdY7n1C=)GldH@SEt)3qD{R$(kH}b
zHo4-=scTO^17a+Gy~X~HUYd9wBcS$VYdZF_m^=nimtm2{Ld3jgb`cLUf918g!N&U-
zqF@=19TbR{e5D;!JwDzSfJ;n6`Ic@a7bu^d^AW3gDN0xX4R6JQ1FO)j(!oT;#?Io5
zT~~3v$4N28p(Sk%HK<;mUWOjR?dnx$oIuR?-i%B3@S^a}VUVQrD-m;lWwKK5(8BkC
z?H?v3ePoP-g<1$WSluI;7!}HoI7~`0x*R~HKz!YHm5EvFuPKu*sBi?G#%2)yJ<{M$
z)Ac!_M2o!-&*sQig8W!N2t!-*Uk?U$hyh_O2|#C8{PN&CgJW_Qs3_m0wY+6!;GnZq
zhO+$?+}FlmSnt_EYEJ>!M{Nq?;wj|Dsgza1Zv8pU!w2#Bw<#_)CuhSCw+cqUgpKf<
zZG<u(t}ounn&2qopp#7OBS5{pjHnRoT^+o1Q!&@5{_%mygO?5x#`)%gVzPMD=s0Rj
zXa#SU@SM2;`l%)n)r8GW?#Zd1FRID*$86DC=7)y(gBObQcyQ^@lsed*k*#7|*%9VR
z?g->$+&XPm9|DN)Sb&3uIe2V!ziG@hP+?Ml5=jS8LWs!{tgd=M$y`TTjnF0$xFC7r
zO6s@`Ol!VG-QH(9mAS(Udf1_4jFg#3ZY%jVfauot{l;wWys%&78t2Q2dq9t;XahH7
z>QzBNobSv7M|oe)<$%#p<@k!vzGkNyFDVo<7^)kS90!o}8BRr+i#)fsgf)D-1m+wt
zWJzNGQ8^CDjSmMyBzgD;P#pnC`aFyMZpFOqCAA#tt}p$g95TmsuMxzi+aCq=2Q(HN
z3%`CxQ~`_d5C!V@Jttu@=z&^Wo5&61X*4JIXEoYJ#O|35c2~`bV(Sx^j35$Ehp82O
zydb$Se3VQ=wRYzmTPz2~(W|zqw|+E)?`gs`^1pW%zGi|_G4XVHX1}C(^)TK6L|6V<
zUoV8R2PrM@68yyXr;6QZhrI>-(^R%uuO|pWNP~^R;$<t%bb{9wGyUuO-wg$|_t}Y$
zK<xUkG#{ncY^Jtj7QN++c4RW!h7#-fU&P*6Vp0b~XzGcAMwwvlp}93>_8tq@KZI>0
z^tXyzAZXyMw}^y{kO2RF=`(JrW-Yks@_atJu9j(QKODj8Pj09qgw^A0A9M<WIhg4u
zFTou!-(#0jybiFTdUO7qR&0RS#@^=z4+|l(-S`?n&E81b;tQtpG#35-K&f5$6$qZ1
z{IG%XGI-r3_uFck#<scgT1pTN$}8?e$LmMNTuzkIIs)+j*>IU#bL|=qAuV|+<mu)E
zC~a7Qj~wC2G**bs$hvY3rP1P2K?_=U9R>!Vh+`})nf3u<!DVuVfh&Z1Hco865k(@a
zm|C{dCdYTc8Zw#xC7f1sao5uuIHDIf$~=h#5%1o?-L`gTls&QyNFvLKsi3#65g=K~
z5ebuu&l9@C(gSBx0{AY<V}TOzi>_3BmtxqygigtH!@$wrDs$sKLDx-Gwj+o+5<F0>
z8G%5=+i^Zmn@BKGNQUfn8a#wv+%;?vAi&D}ip7%FB1qOYQ5km@G3aMjghtZW^~I;5
zYGJn8w5wowTS{mU!qTlx$(cTGD0C?eJfz1_xUD*U;>-N--`Vne-qAy3x)6BYGf!6W
zZf0`R7~Pm4jiU>=3*rmI0|b>czLLh3f5uHRk@pz5F2W3rKw?tR3*4b^^zgTui%{q>
zCW3V)mNv33+Z71eP|pk}RWn8sz^2Wh>RW3(mKlY+<X4>@7Y%6qvHtYBf-mOX$pS}z
z@ZCrO)ADL%1U2h%2_A5)eO{*;9W<2SUiEm2*|_Q_yj%@G1AqS)SgsF%DV+n!>L(I5
z8*Ua%yfo-iuL<zuhggO_9~+a8o_Ov^f1+dY<f~0CbZc0R@i@gqjfohd_x(eWwo<=P
z-jQ9QCi+UiZ0+mCeXxZthKYo|3fbPWv#a<nhrezqjWM@-iMZ&fIlVYI-`tzvM08`8
z)&Q>uDcHCOI+wy-AB}uFR8i$?2#mN6L~qM%zCxZBOI%9JpQVn`kKdb&lal+{ugpZ!
zsk^~1k61wc!=9%oi0D$){}K0bMy#BX!|(e-d{r8`VMMTU$5m)40bD|grj<oTb>ykI
z(SxcQ4^Xm9$6To4xE+U_zbcz$J_E^ZaGE5-|9{q%jnrY;2AH8+&9a?v|0&S8S@+&c
zO8w!UWi*V2B1;rGGn=7phg2;`Qg9-Jk%{%lfNQBtLY4hK4W{A2+P%l+iq^od8^4N?
z1J7XxMkLCehkP_z9&f~joRSvC5M8Y|<}4$NJ8~(tT154&`TZlr;K?f=eC@m|00``<
z)I~n`X0@<lVKdchMvn@=DZghgXzeoLSItoG|FQK|E=BH`N>DxUu>hY*pC~m3-Hx(Z
zdEthr+svH;pEok5tm`qk$9V8~DO1z*$9)>dTozN-(kr<bRpKpk3~yKgv&>&*rWk#R
zq&~wLI(j&7R(g5%p+m+k0G-8~nX1MhcNdFuLBQv4#ZIqO?qbG5FSRl*#kM8u(>^;o
znoE+>8EY4M@kgalp*ZLZ(<hQaak&WdGz2$XAt@U8mai!2^h2$N<0H_lB_D7EqRbe3
z*wys7k8VM)jRKV6_ni{w>wQ~)#a5QRyM6==7E+7)|BQ!PIK2R+3#(fp(vozz6e)OI
zvXgv<)g$A}k_PXI#8wAA=Oui+?TPa4M-S;J{HN}xnyp!?kPb`M_fse#ZyMwDsCXEQ
zDE!`8qzz&)Qbgi=&Y$oGA9Q(x_s=bc>$S9qN!WJ!uS1H%EI!#%pqZvOO`VSTY9No0
za;51)v+Hb#rnFAfn%_s$KQ~dSE!lxy4=9rvM0xY%w*!`Y#ih>4qkSr2%wgHHr}x^{
z$@VsMI@E}OAh+`LN^Tl~K2s7<sSXEA%_t^iJwZ`0J9%w4H-^lXc*~oBgLxz-oiPN8
zwqLBx6SVE_=y%$DsLUy0C`6an!G_>|xORL*-&WmZ`{ZkqLI4v3@<ASg1r2n!TWXQg
zc5~i~PSBw<W@Rpo@NsV_S;SZnExrq>HcL?+CE^)7W1%}@t>H5bdG|vfhsw`WjG1w?
z-e^!(RD}MN2?4mFAFQRJEeW}lQDG45Pf76>qtpZR%K-n<MV@5I_z&+pdfNQGG{3Of
zk9=Lhxpa74;2>KE)=#H=^^k@0TME(@r}?uhj60Rv5T2=7yfrbOIw|bm1o>>Bw*OdB
zo86T#&P>)gz|h+ee)h^LUzt!xr;^81M?>y3vtw}~S@$cfRqX&8A4t4mfG+RQ3MqU=
znk^B=6@~~>;I-l}hnBCSIK;KLqvPo^;|!gxDoZ&knBJt&$moV}<sb-X1qvuk{ns3E
z{vyHh+3cX!h+kFn=8dtCyOu^S{Fuq12nJ3X_soxbOevA12+F54jN=n&S8;p&VNDl%
z438nu;r)dvNhXw&sHdEv?*3gU7=J|<6oWrMk9;8z35+&YQj_I5E;`N1FCZnpTHoJg
zIc>s8ndEEY4Ar!<rL-5Y!)E4E0<ZV*4;DBq*rt!cMICw4QPUz40glKV@}n+CIn6fO
zV_A~<F~?K%*-TeL!bg(M=(>iz>PCUb8;9o>l2sW^<FYY52@?WHbz;}yvT2S;isBEP
z#<L@yqItIu=>#OyNts18)zR?Dy=d#PnlHh;7Dh4whl-X)a9H<ORSjE7oDcR^rmzq(
zVm*|2%~7oZzv2rrZ<CMKP>iB(cej?2^0u4J*;BJpS9n_Gtu><BHaAd~HrKDiBQ(+Y
zLr8E2_tIdEyE>rWH}14Y#eM4Tu)}q@pe5}kmpmI`i4kTA_r`v8V@qVPE;o;oFVWj!
z998fkV5}8>e2odzmrDjop*sEm=kFqgBIcsY9zwL8B=hUJGiZ5S9-H<-7S4ya7q+`9
z;0mhq#n6+Ya<lwXdqWw{$|z-}^Qm?1L|XigBtP}j7=H|8!p&`x@`)UwIrJY_Shq2O
zo$ne;56FFGKJ!<Q<N2XbO56N^9eU#Di740Kz^oNGC|j$(d?c{smYLWfYI%jRW)lcU
z><nwCa>GBrKProHM1%*btrP(eHhh#!0^kQCu@F;`x|mRR+-O10y9nBl;-Wajm=olK
z*P%8&cmX(uqGlOEHB(GNHgV{eW><Q;?ANe^4IwKS=oyf|?k;kvkqE{C%9{x%WY_)G
zyRM1_1UH$?g?}ww_z5CbS2BJzAYcKKfU^(QL5`u(R3Y4uT3>FLq%`y`MD`#&OF(+c
zkAX>+BPOA&3i|@Jdg~cXKng_+S=VYcK<kHG8ybfYULs)Vm>}d<068I4M9TVxhb<<T
zlq$j}lGyZtoE8Xue)SO0lF}<bv(C~#id;E~DBc|@xZx>5?Jt5yI+dEZ6EN9CAneVy
z-?g27%B*ZdHD$DHVTNZgMw|_=gzmeq$T6xPueu|1S{DkMD2h}w5yA>5;4kk-j23lW
z=(*8V`J%;*CI6ygqDM^=VTdgP#pf64u>s}bl!2Cua6W<SJ|^LcvJ$_E!^|Kf3LjN~
z=oD*tqs(xkH+H`!F5vEOi0|uJxBd%Ey(DeE)gs?4inMUDtlf@Ke@{!PWOo`xXv!0u
z6y2Tc_+93i<}_&qSd_D!fc4|CDv$5jmW%T|vhDxN__977i-BThNyt!Uq5{7CE%Mn`
zf_hE-Z!*WQ0EK>lRNcXrm`IBEHo`@0>_rxvxU+z(9d6S%DY743Gc`CGib+<D?FwmS
z)u1H7uzy5eIgycHkY_|)q1%tkfx?n>r!d_<;Vjte^lKe}>58jYLf+xyO5}aHHVN{V
z{yvEP!OqqvYHtsbNFr5GTYt+E)lmn?qJ2h1^p`N8Qyz-8(Sw|bC9Y#pK8u7is~Z2B
z9r7sQ-@T3R_I3Mn2ykozZwQU=CiSj=1b!m3Utko@AnN>Cim#YJAUiWM#_40drm(JQ
zCXv^h{C&18^YJUragi0jijhzX$YeEZVYO*_!F8I0MglML_1M2)NsZRkT|qi?Vbz2k
zMw7F`LEBuJxD|q`WecuA>LCWwH<YYLC~yMC3}##yv}W<}Q&swBb$yCU(5rsZ2>`S5
z+1JQrjAw5ik@lf;_drX<;KUgw%V^;JiRD=W!VpSjfLO{X_nGqevfw70*gi6lEL*wr
z`*(HEM~5sJa4x=FCqr_)hV1amOJFC6U2NZFDM9Q%rV+6s_gX*IE-me(NFrPNHsW%M
z0n{fJ4$1XVo-1~;Pp{PW&*=QeO)oG1^S{if3RZ2ZUdq|kx|F`8AqrC4BOSP8k^an|
ziEt9v9oM=QuavUxUMK;0;(P`l-EhbS)BJM?tOV%O`}F>$kd)Yry{1nx(nj=td2-6H
z!npr(X7`EO3c{LCFG_B-De(VZm#LiX^XG?A=?bcZ!t>c0JlJ|tmvcxfu3)OUUr@->
zSp`T&T*FKN^y(E@%?U~ksM~3s7ESyIHT4Pd!ct7$$}nDoupy+Egiijqj8Ibe<A(GL
zoLk~u=(Zqo2b_B*m`J5^2AS}8aTC8Xacey_p;akM8Tv>~niD_be~NF{fuc%Kyioom
zY^Xi4ir%GfUXr_olm)M;#D^DiSPrO>V_8K}Ns>27GMK<tqX^cbfF0sN#(o8%$xY*S
z-6$|`L9WVZ!I)I7``r}OPfC*JP<nO-G8K<WScEpxdkvc(_1ci>5@S>7b-RrVo=r83
z>ZN15e&7E(sW#<;X&iv&c?tg90Q%%IsT06bswBHZ$`W|rI#Zj4M(7%aSpqThekT~T
zn{Cc6&=7B<e-q=G{|$8jykiY--Q@y~IJu5ODtqpE##G$9bEL6wHVf0~q|wELh{KgO
z6M!~${SqW02J|UZmn<ylxN?VIbh@#%cxny3>(9wgj9EYg0U(aTW@OAe_UcX2Lo7UU
zk;`;sx{p;yV?7l#g4$1lVtAD|<Zsf06uS$KP&u8SRAzWu=XYY!J@}orr5T)@_#|&n
zIJ;nUXa4S=<*eN>2j^<MJ1?~X$-RrJhPqlfmyRt%<oyyU>4uD%d)k1eOi$K7=dyWw
z#(&~3@CGPXAoNMlBCWu$@~y!#w6m2ZnASDiMutiopkydrq*QbCSaE$IYTjt_df@9W
z?Rv!VMl99-qMa8;-N0OA_GP$Gm{Ug$gA7rezzWM?0ZR2~0(B`cW7K`HvtnI$Q}N<e
zF+Xi$NHWL>7Ao1<Wyr<-UH-37WfcP;2ZAe((`%|j#xpWzk6T)f+LrlA1VbgXi31OM
z1@Q#^_LS63%sjyp(ylKVqt<u)to&{IHBQqdP9!{k4vQ!4o{xc%MH_s`%9K`UyNAY9
zn(?i!aZ|Ihqg3FC+%?5WZm%C!%JFlQh+7HNfEq3g&OpWzUQ#Nbwv={*k%jsZGGhy&
zN|dw+=K{Fq5um+@I%?3RZsh1DhB7Vi$-`Z{PtLi4`TJocQ|&wCr}iOT)&`Cr9(ux@
z?UheD78$N=XHKvpu*O%_Pe0H^cEiWbQ0`mmYiRdfmxtZSyB#|n?4-mN?&Zg_-m%So
zjJWFHFF^;SJUDv+_Rm5&u>;GW=3G!hLrp^c={==eN)m^nq5QkkIk%sPO%Enr{`of5
z(CX!w*`d<7dur@ySd%}HF1BEJ8EkDxe#)`N=Y)kj>$lM__fub1V3!S{hEfCO%fmu9
z`iw<to*j|puOBKznhrBbd_<dHm9|D-)w$W*cA6XunRB4FxH{q4J0i~lQh3Cd6y&WK
zJ1w=3;joExp_IP4UVk4(ud61l9GF(>Dw~z;O{*-_@%^87?I!89mwNH-q;pOByeqsS
zg0-Wf(vQB!B<3o~M-&LdXiTC~%=aWq)Ss0IKlLdPO%JUG1Ms%b2ri7ZbL^H)Ucin7
z3FmKZs3$Vcu?Hr4X2KjR;j7({b-zQj*A!iWKEj3-L;jEgr7l5{jsW1xAk8S~Gxj1U
zO)HQFk7v{LixT~v8Jmxv>_o*m-9xB7QZ4HBn_QVeWMaGE&zxX}v%`#MRMWp=E>oOF
zh*$NPaArd9m3<C*P_0f_qKV)dAiT8w=aUwzL5w1rXB}$iR?2a@>Ic>gwuC!n&vSb^
zVi>8&Q8(rH6)>MJCY|2t-Q@7>M`~=oMQQBk<qp9sKXr_L{wW()f^a@Y3jSwA-7~Sj
zkMsXGt#s!-JtzR`w^Rv@6Xg*$K~#hVJhh%Cc{zy4h+{2MxJ^1K1%DaC72>BbFXfVs
ziw7kI4_cz9^#DN*fDZX_!o}u=KHHm0;a7xR<OQ55-ak#=r9;skdk>iCKQL7!q8C3=
zRz2aRPIAXLF7`{9>{!x*ZvdO0Xsx#A;`fP-ah0axHDy8Ez*F^h%E*QH+z5%4Sdiai
z?~q6r6x-bOWE$1-;Rf+u@f;kb{X$Xj-8w)0wa{?vDv^UhU+}9oTh;BOn}tvW%u%`h
z&Yurxh1Bg8aqS$l?8g>z5*EaQ2biAPj-rHDfk!z~aHVhbRv2k)$u+nGV|Vr?d`_qb
zLhbK9cGz11NxDyx$(cTNoD0{5!b3Hc+!8z?Meb_Om?mV`lmx0?#GIB>2rE3Tmja#v
zy-RIo+pLD-S9$u2L~^103s_|0;>bZPX6WvClcXYZ-Hx*Fv*zGl4T24pMQ2W*13aAf
z&zjTLLXm(KF8|tpPM4|^DJv|8iSv`0m6U>A1}k!1Y-XeckDYR3ObY*VeriVR(3A36
zA>WOW>|ivW9lxn7qNA^ulEsUFe=0Dg91R8nT!rUk`giy^Vhhe<3OwWxBu$Kj>s?#2
zRGHC$sS6v-4|$%tiaFxEDZNYmU&99>JytPlDe9(H0$%pZJ+pFmEbg^=Il|$6l`7T?
zdod7y_M}o89KD}rk@{>`-kWBR1F%XYq-#e`<qhQ+1Rvy}TZ2Aw_L$$mO=&~*V$T2!
zLKnJl`yt6Q^3Kn1{UKi!pcRWqD~1oGF8H=Jkts>R&2K(Ltp{fB@pUs1BB#yP&>ld~
zRSr-X^=bZcRl9Ly!&_n-;RxHLkU5BT3Y|d_IZaU2wg-D4>nb%bb$yASin48w<nrM_
zGN-$dQ2C-0#D@T-7Rcpcm`#-SU#%GUG<U^BMy+}AZ`)LAmcZd9&`x9t8MeUJga^5;
zRm!7zJI^x3>jD$Pjz6@pTPLm-`0LJ-4&C3bx!+0rP;oD18`PazJpU+CIjxhW>{X{x
z{yvnt%E^fT7%20kVxj00H{qfplw8XofmDF(uux<4e;p~W7>-&^W&AQ_6sF{p!Yy~!
zYKhhogdjN@$maR)=9p<d47MBuC4thHfumH$A*kECi1{LNRgmqpp|2YJxW>M0E=Iqv
zB%t}u4ph#vQ?oVkSt;<3-o|l6ZyIfrO~8VeLqAWYr{sqROC*!o(2}!;9lAI#E-rR}
zCvX3R1nS-c8Nzxsn}aCesj_-NtRvl<s!sW)Db2IfhuP+8><B=KK1F(?teriorHz#m
zy@Se&m|Z_ey3$>%svuXP;qiqxUlj;v0Kp4eFu}~XXk;xV(;Qmy>iD*n9*?tQ4{J^6
zo^XlE8#e`PH*I_HE=E$2XThe&l}fB>v}%HmY(HG<w(U&>gO4L7<7K8vegURfLJMyg
z2B{cAe(!|{p+)I=5z(7^bRH(Ur7cw!y1L}F)2~n1yUh3BeuvIEHCIxx9U<WnORPgf
z0KpO{_h+CB87WK}w9?;`ZC@u)y6r45@|!XGwlhogXlc1L{iXJyIh#)Oe&#LrJtT=D
zh#7MQewfOaJZlq!(o`IrgH8biO9Jg*vJlhTE*JE9=dcsiRAR;0@%ei+zana#F>Y*a
zhg<|;vwmOb&amlV9wMRbc!{@@Ap@)VYRx(*gL3}n15m&C(|&h#nv%D?zN#?E`s&<}
zT!KNQvu!vh*^oL&Y(bVJb@R_x#UreZ*^geY*{o_jlO1Wk+6CREGp{+H4<9w4n^(`i
zC{Y>`icK_)5ZsO6SS$!G9XNIO)oBXtET>+_AiNFkDendLeC19E#4QAu&G@N$lugom
zGgv=ZtgVmG`8T)rP5Hm%U4-M?!!k-cYw<Gk;*+DD*DQD|MWLqZWRzGtR*qbVbu8M$
zLyugnoO_=;WzehX?r~}-H2PTCKIxtF^H7DQ@wIHFSGBU@?IwdF_!MJ_?Ge%;pxEz-
z{=^LBCDXUuqbe=q&1b%+5L^uvkV^e}^yR;rL5-KjrLVWiRWNlQYc-ho)4i{URGu6V
z^3qE;=r#ZROdxpu7QsnQ4U()9BWC1XQH(x97-SHekJ;GhnlD9!NDz<2Ce$V8$Zulx
z0gL$o5_DYO1|5_fk>4scp5xJP;r>J4lcl9s@Bd;fiAj9qT4d$%h|9c|AdzXxgDW`9
zU?X6^=*NT5N7>u0kp6B<(lecyalvFa*7cJzN1VPF{j+%yx?_N48J|dD6vNP-*GnZL
zA_1Z`oudw1$%5F%kP~*yc<~$<L<j=jW&%=G&6w$ozE&b5u$6iQdU#}kEwcM(t1U&#
z3|q=euX$&>1N8M{MA8QhVsXAJ=4*#f^!F-7;h*ROyNu#_$Q=s9DQ=fXC*X};IDApg
z`Xj{%1+up>j5{A4A-n5CqFHJy`8mi%VSC9D7ugN3gTc)Q8l@}|YH?;_G73ko46@f`
z|EgJC6(&WrX+Ik*#}f05A5y{`z4?PoSUJ^}4g0r>>15%Rg?UL&4=R9D4|BU&u$nfz
zx)jMm+(tJ|Jq}K7cH+(|0-$9kCDR2;a+k3^N0gP^eV-<FnAGy@Juj_G!*p)Cp|-Qs
z64n!n<U9bbz~KjS3i2asazfKYFnl&tc6aQ3QbGKL7=KgV*^LgmOIzEPwNbLw8W_28
zDM=|UE*2Gx>H&VadErDHgS3?!eJf8?K?0s(=g)%G>*W|vmi^A?q9v1_E8EBkk4H(s
z8yM7lm#LV%J8Z!9vHL=*(IA%Kk2c~W!-QyOl`xI6?!K0gH`L0D)A;ecQ)|6<w*4wj
zvc|}dwRBvT<5&-W9o4Syj>wr81jimVf{n6VIdnRwdbW&>Qc)_|8W@wl!`f}N+gvXF
z`cs??b{f&ck=0U`Qf}qA5(2_$axlt%RXe<s534MGD#6HM?oOLDJ~ug*gR_cIAJHgO
zS2ph4<!(KSN9*=s=l~ANBDxr0B&M#EiNPr}<j;}e@Ba^h<hCXiGoq}HBS4^41IfM)
z0=;8v3IeB~p0M_vg#%*VlJ!2{#!8p+dcd>;i3UTlrA=85{e_$zg$xK`8@xEN<Q#zx
zBOp8hoY({gO*4|CBzy`W7hDM>SM#hbr)`wT+YmukCHwb3HQp6<21bM=pvR}p$1)(l
z`J;iL6EVHS3MqTzqZ;Y66Me9M)<_4~rOgKBX><r(b{>rPFun}*S@AOby^J<b_3NtZ
zQsP7ee1ZyBLdgC9Rv$LGsfdZ(3Q(VmGW6%&Aj}c=0K<G?>8D}uA@EYxTtpV1G^^U1
z^f73NR&FYq{UpZq@)(k@-r2aSH}rVf&4sNgFRY76EfU2H&rX~MaJlLcOZNP`dbf^n
z-O$|?g&kZK6}^R}QGosYO(UF%No@Ef%6Hj3X(0lT1Ev5vO0rrUVikM}B%$E?OcLJX
z_yGA1su!RWQn;DbU8)^~8y_)_*&_Uou(6giO!i%k<9ozllzC)94JzS=Ix>we%;W66
z-gW%AYkJa!SwOc%&7_9^B>|QsZ<&aRr6nqHaUy?U27+*;kR9s~v0gB=NY)6{CXw{a
z7F*p-5$7&jH3`OjNyYs_+6QVO%01<e^L<;LuOt+<j-D%D*YU2ggG~fuGt@uW5=XAL
zLyt91|D{+zfAnFVafz>}&`JmPxvvP|KYXeB1YHKTCaAwJczfHqi096OK%yEwTJsBs
z2#hn2m9X0oL@G=CpMQc-yIJqj#z=KgiSnPTkXm`AIn&~2ui~-#wNl@(b!sMzw+QFw
z#sd%x{zXs#)+aX0YfqRE0`Pyev9SAGrLKgdFH67u|EDt~R!+Bc{_Jyv?a<q2cC={k
zUH`I!q2(BbObCT~y%y8FoBqj3*rXxH1IC%6U!+<Y0wBOwN1O$^qlIeuTJVf1mqcxU
zct8!2Pm2n)??6KZjcluff@uFlELPl_cEW7qsZ4jbHkRq_n8N*-E6lg%#Gm_%h`TJn
zsjNFQUtzNukf6v3?Sn+xw6yT>+sX2tfWI!w$bCf?+uRTyXhA#Myxs_FjOYbB;hB0&
zC}wO<8N={b1AXEqk+}#OHS`Rt3@)5Sgu@lu#>>lcPL!0KWKgu?@PmVhpfMi#&bx0T
zsVkM_mt&?EBg*9!{J_8R5!B1KLZXhP&3^tp9r~?<W(3HtA%OH;)T^<=yF@gm2MCPr
zJa%xt+!9vU^jOUyP``u`M&+A!teEVv+1*^oZYnWt7ohB>tm8`fEj7>`+JcjN%SAR^
z1tlKcL-Tng?$N?Go?)0EgfRoibi2|S^L6Wpaj3U$?@Q&f4%^c)o9=RKEcR&ZTkOZ7
zQgR$iYK3|}`oHo$-S5OfqH<c4p$AEd(Zm+Ae-}TlQZ34Ej9JR)^x$~wTrgv=m>Y3v
z_%VXN8Ww#t8;}L<BZ9e9P1U*bg?obu0+7xutylsu9V@>e3j<gPBd4`<aGc(cSit|1
zEfke~<PG2ytNZ|aY=!DR5x6;8*0{fn^R5QX;qdd<H#y8^x0jX*1ljC$J4eO7yRz9l
zX6iQbf2JtEUyN){zsoRJ2uwIO_6r^RDxTT}F{=~O%6U8(PKI83)u0J~GJ&8uyr&Go
zR%&bPhj7cMQh@l7P;xDB!pm@{{X9WL%8^)7NM4_bCQeCs<ZoOL{5Fc3ME%(HLPCK}
zu&aiZsCYV_+m@_y$sq>Fq%hJHWC2pMLm-G?m5DY`g*9HfYpgblcwj!@cIdq7VBWT9
zME$gUerm~-hb0ca>pS4y?w)%DO}aIT6vy+qI}Tt~l!vMFO!d5Mg+^mA@w|c?)DTFZ
z18O7Wwm`3q8lKuj;VPB$Uyd2<RShgclL-w|&%urjBsXyxmruUPan7a&h099EL0xMx
z0wiEi6fl}`n+$X!l5C=RX{hr0W}42}GORlt-{aNg7v*aGVXIBniN0x+Kie3sYLY@P
z_@^z!hgEE1_n)ehUx0K-1p#1<1Hp&9%&En^#}8RAvaSmkD*N6JYqS?>&I^Tjp3HGq
z$E&Bo*!A)<RZ9z7lz5E%EyN6u<>6X`Fcg|4*@Y6T3#5^GWOdQ)$4VB6d|DMu)D15<
z%jPLNL_$#A+VTr_)YunL--vd{xFz6Wg3G73kSr+1IbJW|IPh#j&nqlY_d9}6u5$%%
zqnf>{U*3IcLKX;pWt^}ts6{jW1zJ%3n&Qnmq<`6dev+DAe8WC#`9NK`d}epT9topu
zFCMLZlVL}Hltc~Sn?FSjaCZ3nco7lm$J9_qfm<&_g;ZRVZu8$C^b1||5?Jz6bYVN{
zdC`G{JDuua;9{stx&lW_iMKd%_Xk<EZL~Sguc#%oH}fr@3w5M@=yok;YKG^tL9ZSL
z<T2tggU8UKH_Hz`X@_E=rZXhc?BB59Vo&Rm7Y!3S3kC%eyMt2b|Lq}MM-gRgL_Ibb
zCnn?dQE5U82qG`D8qKTRfpXK+i@-Ke0e0(#>-iPRhuK&Y|EwRy{kBUig?So+cXRem
zj4T<fwsJp-FW3{OCmz@>2A{DESD;%k(&#^(q4S?1$u1rBOO_=V;yqCR@G5Fg$Crl`
zs-ps0(W7~mm<-<vOb$Y`s<8kjf^x#~NKTi2-r8EqS_fZealYQQV(6tNG0if}iw{C6
zjkp{l#c`&(#a!<=UYshN@3G#}^|*^!*a#fzAQYM7hlMXgIDe}qT^?w<ha#0Gi01gO
zvMuY4DxHrMZHw%8%rLkyx3{S_+R#DpF%aDAZ0D2Y1Bn~7Qq;*2#TGi?ud1u%Sxocu
zvg8jhNufqpR^n^HeoN)q4qUbA)clT9+mKl*$e@)<AWm0~bucJWh_^_f+D6|d$~1I2
zrD|Qb9p5!{tn5Y+U+{xb;<5STrAgu@Nk5h?g;|NPZh2|{5l_4lIpskhYy(c^KrXwj
z+&hw87NMN(E!fzbmgPm4p3ggejyFJ({SL8)`b<w&6E$DPL0pRuF|>gG_<0i~%cddK
z(#Y_7e+zk&kp}p9PjhS9=W;Oem2rEjX&(V{H2<}`s>Yp3tN=DrjuRNL97rWYNOOQ1
zLZyZ%?x=10>yJCW!t;7#>}Y0CMrQwjv8P(>%ZKnC2yd4mf@rUZb(L~(he#bjXP=rN
ziJa=spzf`VV6%7wsGIYmEB2$b{*tNX7!7}m5k1;*?YtZViBY@O3I?*Jz9f+IpRkP>
zU_gXmy>2w7t-%qSt$Ns{CFna2n>>k3-l^SZ8c1^ry?Pol968G7>8r9zp#@JIfC{fg
zjkUQJr?x(i*C$@&y1T<&`_lO)&Tspc_+^ViSkM{D%jo}Vhg6vGId<H+TxAjC$+d)P
zh4+gRs3$kXJ?ftcr*ZsXHX=ZL<7KEf5cr5r`J}Kw%l;cYt@ORtDY9xpb^*7K8<}x3
zF`z*2xa|fkQAgaEdT7F7Clgu&`wz93TZ4LCMu$b1Q#vtZ(xy!DEO+|&1N14BEtU9p
zVpErK@o0XF3h*M3gAI-JMk+LYT*96lv7q+)VL4M6BR0AIJ3;)in1-FA9zr$wo)Z1+
zMI>+kigD{6&MiN&*lyE6HB~bgIGOPn!yS6{j5)~0R4KL(rDI)ZEoi+Lf{7|7gipOd
z=^x)Rm@bX80b3=Lc1NNmxsxazjnU#N^k*=hpcxrwYmhs$23n+4y}*NMtX*CuLNp(3
zIK&x*jpX_4SXio;>PSZN{po_a04Txj<Yytcz6wW}D0n`Svwj90Y$|zu4aHeWJL2FW
zw!VQ!YopHm37hyCe!NuZbC7dEb-qhjLdsTYef+e*v#cSI34d3SN5E&UO9$z0NecrM
z3EA((p^&n;b4%0OlVfVd5LABj7M|KrF>*a3x_naymPwu-=t|vZ7-VfjmFlq%_3iDD
z+f24SLX0v)u$`M33b$4NiSFPF7;Ei>LQ&Sk@k3y-A&1tDef*p`Zy%`-S1$)mMLGGE
z_z9|u)=(IAA?*er@6>+xdDX8x#mc0=%2AUmBES`A-W$44PvCg2+7c+y*s}}c-}LAS
z2hI;acH0UFa26VJBI%{<_MtrPa4p7IZ)wp&2t8Bkzj*pzkGOo55V!tjN|DwUh~43Y
z1hfzHFPy`18yU+-n;`->pX=2g6}QO}I7mI9{=ikB5ZYmUoF=<`|B|LXl_{z4ibysO
zmRnquCAMc$vUut(S}ORkXm`6hrIIKLue=wnRqNz_$P0}^;Y*|)mA$7@{c}+NEurZZ
zM$7%h7G6}6ZZ<y5bP*)t&FC6<_WB99H@9uGfvN$C+H_}|UlzP|(Qmi)q@I_E#F7xD
zymSct3+Iq@EigRI8|7ME!CuQ$C5u0`W>O-*`Q4+*z}q3ntL|DH=%=ZdS=PE=NHcI;
zPLLZ&tP6=U1^fKW9WVM(Ihm2=|3Kry4{F#xJYENIuK8N<UTP0lIrWf7=q!o8t69R(
zaM}GK*o%<FS|mw`I{pV$a-1;e$&_+Cv$A}Iv>Gkyqtk5{CSBJ3Ag;ZnN4-l=l($en
z6N~eJfSIaaCGHmK>5<x;UA;d=Y8I9F4fvDzlPrAz+pqbG>!}1pG|yCIGrCqK_x%f%
zxGbDyM*X=ab$InJ)SJ&LepJ1|R8Hso=+h0O+C8TS%6r|h!18z8TRn_e5ZSEc$9w>K
zPV_ALHLMv18D~n>ui3&SQ^3*6NA4)UK!E--Dx?)ZEHy+8vy)@G#*D~@lKV~KB205M
zi}Zh7;hxyJ&@P<zaKE&sUL^k?9>Hsr$b6UHEbZz@>GV=A4{h5UyJ{51)PGGT*FnWp
zU)o(QRY15CoOY>0W#h0de;KmUdnpmMUA`Q5Zihe&)jfg>c4)o-vJFD+ozBrRH+{UX
zFfL725?>gx<&CptixcC)Q%%tR0bWW0s`O@1@ic9{U7fX$fdA*1go%X*QF{$dYUw$I
z+M-uL-3WGt<9=PQ3V74Y8iM5<W)-g{Xg^}C%uHBTqLj({T6)w-blspdpeVa+<^pkB
zD()zVS<W)uDGNWBAPYiqNlT8W`jjP=v#;)BI3dYmA)Djv7M@iFGe2ae%;jSY&pjZs
z4zppR8?p350d@JTuAMri;rN6Ng-0Fysn19Az_P-Z-&5jn{RoTJ^JO~ibyyaAKp@2w
z4Gbl7ui#Jb3mZBgc83UCQ7o##rMee%pp5p`lWFhHt~Z^aarI$+V;%_;sP<jLuTzXW
z2Do&n38@^@NIK#RmreK)i+}K{W%FjF9XjWi0exUja|gO9?4t|K+P*+)Dz#F)2~l|`
zvg5|z)pS?TeEis)By*Ep>ceU^$Q(^%En3GoxryzVbThlX(}26~3(draGx%P9WsY*>
z1chhh#zwu9RMeT)xh4TJlQA4&uwId{W?#Vu-Y%h~(LYBU2kEg3-N!7y(blvkn=9T`
zYnj=;Shw(QmYsVGXh3N9043*0d-0R^m7|IeI{JCmPC|iBN(c$Q%$Y$cB?R?DQu}qF
zr-Qk5xgACBnp5KDb1(G9IZhQ@mQNHM`4QaJ2%p~`J8SJ4)<+*8?4xiTC~5zN_xbFQ
z@EZAz?3vj|We(VTxG1LZVwmME9Gox7oMjo&SJjU6c-+Hx)Zao_zCQT*r)vM#7t@CV
zllhdosh@Dp5M<T2#5BX~7z!vm{=DpJD@q=g)7(&<^NFJ>Wt;#(K)%1Ge8Hw=;2Amq
z09trqYyAgv$;5r(sq3d>{KN>ikYuB2rzHgJ20kX0GkZzqmhT>DH-7c6z3#+ndAC#o
zN~xVwGswR-sNpgw0-VIo$?67D{2gx~`@~z2b4r{gV@>x@qNlzznaLV9$wa_krW{8L
zk7)GerO^<3MLB8|Prda)$G)|GwA$56dD{rl`6-eo_N%FVdaw09hAg7r<?U{V8CI&~
z!izVxU9eq8XtERH3?-V<Y~b*`!OD}a0K7;JcB~>j)~}6P<Y0BKOCZNCk!S%^bxOR9
zJb-#Zo8WXGsjE>zgU|>}vPjw(VAtFG9dR8eP<OtH^^!bAeMw<^EpY*)LL6C|;wZ8#
zV*^SE<S`IFn3zn~DRuI^IuC2t=7f>Oad^#}amhP{S`6222X<vNOMo}4`)rrq)~c?2
zOvj<v`EmB$Dgv8@mXrrb6fXvSY|I$4m+U=WZd*jCExa{)Nj|?KzEd{7w$eu%&6}yj
zi-IKr3>Yzo%4%CExRz9!0wp$=E<0IU`^A5H?p#vcI2%%ulzc)>u`vffCiV+ys1~#y
z>{4_wp>6NOx${A$qx~EM<VpLYTTNBUP*z1MsH)chc{3W=^ok)fB@~5UNm0+wUp13v
z*|$N(AijRMRpTBeH^rh|QQ!xUfj!f`>vp=aXTw{~-xe$i!?nU++1jc+n{O12K1UEq
zU+R1%6<~Ym`i6Q{jYo^4d9D)TW$+bu<})CzkKtzihOX2PYQfP%avjDtpY=2=AHwOU
zx>iv0uZAhA8$%zzjuI23KtVo?JaoT&&fcao(9F4Bp^euK__$iL1J0Zv27$=iD99nV
zEnY8yu7{H(PxrT`bkH^?Fq>?kBO&??DTjLsYm~ruw#^eetlgD`n!#9Uq>yRseK{V$
zs1@S&2c!}mQ3hzV%QBz6Yi{kwA=Gc8v`u|JNs$8%MbVMNyjIC{%QeOxBO`Yt`^f#X
z3=eip$LYvDF=mtJU+0GcX=Jq-nc(=LUvM3+cUHy{k-PJJDJEhAgpmFuS+t+(S!>V~
zPEmeFRodD&h*3hHQ*DexMpY+F9Ra3=ORNjad(0|~kXdMB3KFp2?vu3LA>hLdYiJhh
z3w_IniB6i=picg`np1jJlIaajf`|kFO^IL38X2DS3(2{NV&Chw6WiZ^lLnQ^FZ;c+
z!8;KUWTz`4jOO|X=q@xgBT_<Xr&-)L1lAyWTGNZjd1w3U8wVTnHwue<gI?k~pCbVh
zgR?lc6XvJhnJQu?J9{RDL-x&*Lq`t=-o0+l(t%TeRL?v1@N*elcO8#3`iwduxf}*k
zdpG*pETG*uhQjiPAAL~D@coP}dYG!t)0XRj9neRU;TG|Uvs%G#+zbez$4T%Qm#v}l
z+VHh@3@c|$c;Xpxu!vJQaF5F?<6=8aT+Dr#rqcO<L3Z9@r#beqOJ8$8p_zDXne~#M
z-SPo;n?yX|LaFw|6FMU0b5B(ocwu>kUSk>`S<}8N1I%k;sM9_D?x{2C_E9@qq~(=z
zW0uXw{b0Ut9=wD_3@tBbdbkyOd41=P1>%*AIoJ%ZZy%;ydbmYdE0i;5hvv!D%$FD7
zdq5P#Mgacj27JC9XrA!bo6?KeW9Vj~j295sUma>|f^8dU^T}y@2MIs1dcol8ZX1hn
z#_{KAF`n2rpq*s_|GpyR4mg(AMA+6osmt{9YoH@gL^=Dd|C*4`qWZuvJdmAYJwq1c
z)yQQPbIc6-*5g0?K(O#qugOneL8C0dH}et<T%Ga@`YomCuHF@0L_-pR*~y2bNN!A4
z7$w~dmzERu!=BSnRG(2<4)cZkd0<~)qNbq)bP;1+o+3UUi{8;`DtGbECf`Z_B#NZ5
z)k+$oP3old_C_BcR7C<AKT<R&3Z}?Hcs{pcOM!3dAbbI`ZSL-4RZm!V2oBM+(gM=Q
z?%tb7Z|D12>Z``dD&{;j)#6E?DsX39M|c(d@H-pLqgZ(gPJvspEIV0xKvhh5OEKio
zJ`FcLk>7nCCNytzH~xQvt)ZdILULi2M+yW1I96o38XoHbf*|Dz%9gqRDNx-sFtov(
zk1MNyng{j<RUYgF>1#`8^FjW`*_<Dmh%HkEHcnRWO8rOp1aV3OAByqTvNo3|ureRF
zhd>cr#LW@c*RNua9Brw5ic<Ok1SDS>8_X+3xqg&v*!I2-MhOiOm(_YGaj_Iy@8<!X
zY}aNj1e!f<ahoE;Vkx*IaZa}AB@BDngZo1ZuB{hd9P0^Sm2Y&yI4GKQ9*2k9YkRY4
z1}UXNk(k84Nbi04w3a#=<>V)*MK<Mzn2L3-8dGaqKKHC;@Qw}{{X0fHq2;UtzLl=o
ziARYaUv7-ZPs2zLjqS3b=F|BsqAo4p2)8lM3_@oAi*XM=HHa!~h=%~Z_zCXTw}YHy
zlUGbADeXe_Y)6x^404}msikE{0_Ctx#u%5p9f_|L1Q|E+Kq-w-=N*y<-u|cGEe6rZ
z`|6USh83J<+bb=I%v~#Pfn(pEblPY~ZFu7@E_KoO>lAf`g3M%|S@5p8BHz?2W%ZF1
zni>5OAEq*j(yx`EjVlMa+`zTpd1^$3f&Z$&XLf14J_wY2nh%omDnGI5z+=;*jaz;C
zRrUCS;5_&f4hhc2tvr$XF)k+5v0$c4z9CqkAf83!5BeeB5vN201mbLOli6i;CE&Y?
zxF=j7EOrt^?Hj*+$k`d^SeE+G&#6mwRFtLIGV@kq<jQ8N<0M;r$1&8oWfh^7XX-@z
z#|bsY*n&9rif1PMvl8t-J#Eg~=H9g%Eu)__DaEULe7@dME{bN+tv+nqdi<{7ym;Cq
zu+v$RO~HR2XmU<%GpPeFsFs9?IiJU13XFrmHvo&*k+7M3?k~pSCRV;On@GIj3e9om
zUg2_Isi|k|zNBn4i`T-o>E1-s2avmKM+4Bgj}y87$vYOZWM<Tb&1H32(Nw4{r&fc)
z{g|LeLnL#nk5ic;tZi2W16K5(F9B+IGTpPFQK;L#q&&ORWSH>3o)*ja`Kz}do@FK;
zOipCt15ZSbt|XJn0`F-gTIbJD@!;J#U`|diIcK0nv$G)_a<~9p0kS4zELYrcpuY7C
zZS(?Bz5lT9Q#YrzPJ5xzMSs+?BovmoV%$G11yEE;vV$lA2-vIYn?O73Xw539!Er-m
z(@`-pj<<Xv`ABU-m#bB{qcM?!*E(&Wn2{-ID<FjC1zHwFfA{*Vv-Wi|y%fq6uLeWc
z=vMvdr|vJYC!D3@TZJMD8D*)9Zk=kIY?V$>0sF475Qdse6BY;HfJCWu;4R*feA)>i
z$y?wTZ`H0+S#lN0JM9woel!*rmKE1YGShFJLN^PN^0eqIDc=0;?l~f5PqN6$tum6)
z3h-}RND<7O7S;T$QYbZYHL$=vJ3M-Vdz^M$A1B4-m1L9=-r*JCAOgZNi!MEt(cuZ_
zpI3tCg*H*WPpfPF)B5lDWL4+fmsn$uT;qjO2ZBp)gDC}rwD7W8uCGj>V4T$q>!BiN
zAkVZ-dE}+xnW)O2sx-jN-8L_?`5S*0e_|y=wUiv>*H!4r=gCPgzkV~tpaHWMnVuJW
z&EPgo2t#_lEu`v?mgJPa)VL4+8}+a1&0Roil0vR_2;#SO9}|6h!X{=D!HH0oNT7-~
zGR`K{&QUjK5xwz#@S1#98)KR&6oAmb*GpY1F*^k4zD|<mqt9`l1v4HHdEX(_hf=k_
zs7lb<^gH-pxN`f}&b5v~wlRsG0lU^hW5zv5PpQecp{1{Nklg0%4?A_{PQp&<*|=3S
z^<{*@gM(vw-;3B<mk8w|iMYH&2*hjJTN5x%1&zn#c3r;rY@E?n@+DE$XA1)O3U0tr
zCoZ@TFi3>kD;xk>JTn_jKG=fk%V#j@US~-G_oOtdFT!aN$mAAWUz{7JL5wh$NpB1c
zp5}BRRz2)9rEILJNBR`UZ!pL@BK-PWqiNdF4V-N*=O7Izk(i$RElTNP4KI~#)-r~F
z&%nH-Blw%<7GmL~B>uhQ)Y07#fIi25wL3sHFR5xnNOPO#NWIh?I+3d@O_*~=*<|_L
zpn3P3nCzVTM5Ks%J77)z<tas0WU#V4Wc)?y&!q`l8M9R@29aiJ3NCTFI&Chr4^kFn
z(O!WSbgH>0<WOKie`*v|Wt$rp-+%tZKL-5xjBMiNoSAd_xp$+UGs%|Lc&3~r;lOB0
zUZTYnZns|#trLKh4{V8YQR=->B4CVIL;vwb6<SYez|x>FVIQJbpXUy4yWWeN=X*X5
zSfF|s$>`N>XYEy>cU4?+G${<D6Pb0tgImy?PchkIciak7m3&B%SgmzX6X8HgFi5=}
zn*SJlA{8UfA${Kz4}lI0b0H3p1zeMHO>-^-g-@yea()7~UJw)mqM>+v<xn5SG@k<D
zU7yu2o64PVm{Qx3#R8LRj=ouVW2vC|QFk;?;uLT^-DacXm7cWIgXAqDq1tY&Z<ecR
zdQbRpiz9UpS}3c*hNh5&3+u{22L^1xz^cl?x!$peA@bljaM2&DYZdn_QIsWqe@z%?
zloRgHi|*hCGcTQVTrO&v<WUFtE|E-EJ_UL#?vFu>Q{E_L`24H;CnIUzWcpeP;c#{3
zd;UN8z7p6F6Xo1FBlA6P$;=p!z8X_*Be@bx2QRH&CeFE=J<6Zc-x}RZ8bkynNWQg{
z^}4ujtGVjNJ`%BJLsF|83b%Z3PUs$dRy|^oFpy$Fmp+|=AI`yJ{S+8ehs7_NO<}2h
zY-GA+)jS^K%>y~Agi^0?;tKARL!KC`hN{S1)jV{ADlR$w@#6}eubNJ`l?e4bVjqtM
zN(V56JM28=_(;4y&M|8L8`P;{DDrmo=Rmb4^I)K#p4;vOB;z|Km7Yh$(Cwi%U^Tbw
zCJUotn3~a+1Iwry<Yg_t4f{MONVcqnthJr)C`@o~Hky@{89`!Yh)r!QsBn<I{$<Ii
zd%_Z7t+<sy!f#RDUL(1fN!y~8@6*OZh-APqixk4dec1n89DPY-N3AwlePBnu8{TG*
zCp)!BxPP`JxigoCj*Li7&o(`#Fc~Y=u>-G*fWXkxLQDdhojE`bHgE7|_02^1dFF9s
z3n86j?5az1CA;BuDmB+;U^0X_l|><v-H-roB_B?5V4HZTW0eeKj(s10<1jJ3i;=;V
zQ7!iTG?+O;r#?@wW8eU$hKjju39D~+0`zRGWq|5%pF-F07!<8!Y<b(@kEaXB#YiSe
zXt$|GKsa(dQZV})8RU?!dpa*sXeDC!dB(Tw^<Q@@mr^A_SK}OW<ki_)r^!-5fb*Hx
znZyndmrvU528l?)nAR5KL%LPz*KZXi>Eb@8@BAtK3Fm43mEa?Xoy!kslCPC#B7}fE
zHs{vN(H~Xbc)Bk7&Oo;oU0amS*G~4`>ik=fCuc>Wl1O4Pnvt>92@m#FH8o;!7&*J_
zkm}0ieO&Xc&%w@xF+7Be5K<*@ppi_aEzsI#5GoBV3f<DV5zEmrN&DqgZ=li9G@<Af
zkso!+vnqd%57w3kFL`#n+$(J8#P+Q46r&s-csrA3Fj7hILXC)E(V${Kh|4-X%vS7v
zlL58H>?IFQI1RR}cNcjJbV^u*Y-eUs;y8JcZ$1Q!Lxz4IbaeMnOVFwiN87mtV(D~K
z<ClN0*`7Pf!tEjiwY7<m_MBafFEv_foYzN|t&x*3EdbwYy)Cv0DA@Wq^-C3{l&ku*
zHMK$*={$uM(QaR)Pt1ymwYwJoL@m`-dDT15<*v}RU@Rn&54MaI96Na)5zd2vXmmaz
zKpPgDbJRPOI3&^oS|R!7ERGgWZ3ciFRzAn@z-JOqT0~4~!e8~`SL&a8x=43qtS@o^
zESnF50bgPz#Yca<B)?>v1E-3FzqmRgpr4A#v}42k^|ht}K8RO)^?tjKO*Gr)CTo;3
zN+>@sg6j?z!eas&UcaR>AvJd6n<_bKb#<bG1dkS=R$2YD)}Y0WnQVU+Nbc@)Yfn!E
zStMUXn6cuEm7OsO8g$ko)=f}SVxLE^SWb)r>}FX^)A5j57k)j)<RYQT?`J&58_Z}%
zxM-j@gsH)Z;w8K!1((Izz}sn7;S}QY2*N%SDA85w{VI~Vx&lanCmWj3O_q-*CZV|t
z&d{#N)l)b7t*m5Rtr_t%RvXUz0TJskE>ctw;{kkD8LrVx>*h$|F}S=m^{L5Kv+l^n
zk&?P?24hE%(IqJP8{Gq4muI@J_sXR+CSpr0_6>DneXI6Co-()hZZM`=PzBI|eSr+=
zh%$mQqAH^OTOJpqQY5YdtcEV68(&&~qCg1ISu8BVVcwx-P5O00nr%*O`#V>G5d7Bp
zHd3Bg=J%VSpjz`>UO263#BaP(j>#M=p4(cIi5o~HL&C!14E2+JqM9q9wqfs-bqlHl
zE2jdzMX~>z<%>)J_?Q@BjU?n5?s1yydDn&xP!+P1n_hmQu{c0F-+g8T^qw_0oKsE=
z9Ni2eg~ik7dJ_DCp8gRG<FmN2CafJ?VUz`sr=F8kL5})i6ZtR}D)Pyn-LiBDgaZm$
zZ?fLz&hY+OfCRjE`y!oX{5v>Iab9<u;w==&V@2*NyGRRodTsAH*fH6n4FR`Fga8dH
zAyE|6Ige%XPiP<ysjs4vzS}%yekbBwRg~sgVn#o-S9FbjGJgl4G7zPQPk6gay4`LR
zBE{Q;<k|L-H!E0+M)qurmLeb03WE!Q-Lkqh(X?`5K~#GEYyQ%~N+E$nGyff32V%E6
zGlmTob!3j}Zs53V(Y18TxO4^COJ)h>Hkh*XK>pDm@fUp|i{ur`xUQF6z=t!E>W>65
z%SpEhJ|TC0?v>SwU}j+mzge^@Rn2`^zktwk!0wKKZaUKz#y$t$tWZ}Nbkqag_cHxJ
z3v!iWF1xENq-Q2E4%{1%zI%j)C%7u}zYR9%e=>^);7V!qISz{fs02y_-d0p|R<}B%
zY3VL{6gL8}aN}V!)j%xu$x<P)%tTsQM`S}j>)M1)4vM91akz&bB?3~zz}sL-?!?AN
zL}3)f+j|OVRU8fi+}f63GoZqev|o_X9hWq~6At@H(&Cl8!BZQXbTj@L%CNfq=c@Pr
zq%iKUDX{X0RZ^p;0#jW!Es~k60oWqP3vr7f+yD@ODll6WFZehL2hI6R0yWeogY>d{
z!;SZ|_o&^k>q;$yfTag9U`x`eS+WvN1%lu`_Mr&fACIIKiM$0LlS+{UO>&~lU@S!z
zC|1u#zw*Qy-Ia!}B(akdoaK~(l_C4A`sui62jdS*Y)Z7VJOkBRa4`ESZ+tv96GU=O
zEX%Xg>{-@?x9lEL;t$c(c6P*I@~sQwoH3)*qW9=ZXZud^#CDMOTI)u`ijeah%D`L+
zW#k_(655wshEFFW0dg2_W<3U50-zG7D-Jb`b@}~$xuQS4*J>XzVP+DC#nmXIV~EaV
zl@gm)ZTy{F5GAVfvmeFfmZ)w;yTiEHO*aSN{AZ;@Nd#Q@>?P2Z`(6iu?gW8b#dlU@
z;k_canUmE|%~xh2^c{)Dq_4Bu0ullDF{{>pud(v-=CSUxu;LnR-7N2UsUw2b#4(M`
zL?`TTfROTl_^(^LS7rE;81ft&Ge6QFFC1?)!nZ7%`4ZNu-=Onrvi4bl*}_n&!<0$-
zbtD3R<FV+lP<f~H;XUTw%gp~k>mA=lE5*#4@9^>3p#;bQ^cx;ZK3wUL{8f8F=pFp5
z2)$4{=oWaodCiJ_JyPG7nQ2ok8#cbP30{D`UGmGeyX7@27|cjWf&a8=N)HeGntN0|
z+Ql^TQPDNODo~O=DmZt2TD46C)y0Z&ie>Bbke9b8s+?#ACfixBB9064t;^~P7*z&B
zuexjb|D&<XPVzDPy#aJ+4@mu2pR{o_e4qj8ByU!m-XWg9Sayj^wLbZK`HBd8lK8VF
zfk@prbe6YEX-A^e4sZLcv>61xvzhPx7*^yt9{7qlV74)CkuoM>*BQq(fm%fLvtpv)
zmZm`(y!+l^!fIcRG?#m(@fZWa_ek+ktRW{(r#*<8D1n9kKP=ZuH67^G*T8UdeU7;~
zCL13RZ;wpg;5rzkZhF2)yw86tnuag>VHZ$<Bh;<!?~ky+S^6Rkf8h8PV)p8`Xfrsp
z33hAP>lZj9*-i7(!mL61v?P>TDcE5q08ijz_0m2Pj_ln(PCd#Yy)msF-cZg?5)~U7
zVtDda2NpSH99o)6>^0V7b*Ej}g8aaM<csPLJX#Z<h4lKHQ3RGj@?wP+bQhANk%^sn
zMYFWu{3ciGb&9>Q*ujt-TNLo#aZ^nmHW$Gk5PPiF9}W%f;4hh@!;urhyx||Di9S#Y
zqT3)_p0&)=<J`%YdFY!yDVjeqTq1(T(XJ&{V#v$Zl%-|fLEzx-Z8c{)QbO6UO$Kdc
zagsJv3?3?7R%d*$9cO}|2`Y}R0P52i#d^|=B=7<0D)}~RnJspcr&({qi4^BXKJ*Zu
z8PBx%>WNs*YXM%@+_H2;hIcBPnxzEQ=_2>PJy5Ps0_61ZUu-$Iw_=dRl%Cg4JHG{c
zr%WmJOjToR0_GdjzV<WwiHc#p&MBnQn$jFwCzBQjG%s*e+oy>On$Y>)ky%SQ*#<du
zh~c*=7HE4!o}v`7ezi2>Xf`>c@w(w0rFzPk(W%bO<O-L#GZzfkQgW(gQ5~Bel%1#b
z%=Ps9b%_*TXBXbLVh$!QedjHK=!Z8U%&yXibP%5M$mdIo3O9e&&_cBc270P>=qE+*
zf#jt!H9aZt8GGs}9=(?O{u>m$%KmBjIt}4)Y-C1oN+L79lvqI=;ArhBw304u@ZPun
z)QxKp+XH(auaLRZ-%MqFMg0injWV(?yq~=?3~itMt3r&jMx19P+jn3R_)#57Vs65f
zgIV_J{D26ev}=m;SJ#gc->4OQ{I?`~U6KwTPak2XkjaZ@C6_THdt4oSpLb^Y34`|G
zZ+;gO)Z-w)xH?Da)2h@g@VAKd+srpC-tN(wq35yuPM>;&!v}UZ7o}uj*hyC9z9y*3
z356R&dz3CrS{I^pcV<V8$*n~eUx*9W^oA(c!=aLRg)g?#vY52PCX;eI+J|W{<Bw2I
zy%M@JnuVW=OA_3<`BrSzi)<Szm&X8oTquNGyDuDQw`pJjkIa3PG>OHBh9?YWYOQyw
zDy{rwdnes*Q*kl69{;bWN4o@1g4CW+4SDE}M}q!0|Fd|Q3y`$`>@?jhH=Rh%t)y6i
z+e3C!rzxbgv|6h-{QM-8)y4|8T<w_UnYZ@sXrjA&<(E9F7?%JZvJbn**bH_N)?eyy
zF~3z)B)e!&Hb%n_8n#o~{f;q2^5m};8T92PlqUm4R2q5RP{@EBPGw^y*~mR^_aR%9
zw3FvM2u0xjE*!J+{|ayt7J<`UPZ=P#X&5DlKU$zUgPgQ)0CRS|<at$BtUIdjk6-a)
zSn*Bvjhub|d(d>=W;6o(z8PGA_IZ>9L!m7Oc@sCvU+~T4C6=;)*zS_v#UZOH%1>x2
zl>I~6^GF3?@UJc!K&D4}LBx8vgu}LlVvV-p5dGc-3Xa1`_2o4+ifsvuRv5dS<W?_J
zS+b^C)fZ!u8zF7Z!%s{A!j*ub=tT_5k66f8!iimXA9~fa;BPV7C+Jd>dzAR2<}t@o
z&9t}3{TLTB#X-Z|sM^DNW%r?!gws?&UAj>b#wMv|36qAW9VROQZ=^3~SV<BASNZVG
zzo2h2a#dG|&h<4s^z2@b(iYG7<IRO0%T-z{aXCPN?LvcosOd7VXv7gxxXA37jecw?
zwpxZo`YLQ+q}fB$dD?AlL&nk(;XtXWTUbGrmG2BLJ`qw^m~?TI3(e&ETeQ43J5$LJ
zvy-alTy_fp1>+%TeGpow+WE25*3R{M7`r1-r?ilmvTY3}iSiF9CX@)WD;G)5xCGOT
zjNG;E<J{yKYqB@RxgHD|pq%VqkrC&D#3d8YYd8Zrnd3`-GvUlb6wn5Ys7Wi)tZUtI
zD{Fz}Ik^iL6B4PDbl|Q{pE^ZAOYTKCynjL|geY4~hXXjEN|qP&@sNk!k7B|*(?^K6
z|1z<=kG<Mu6%{BHc)iVUr^Ed(JJ_sAC@QBga>kyCc}VM4Zyd*zyGnS=%g|5Q609rQ
z8;drdx3SO;QNr>CA;s-1ET1ZZZ8X-%2+wt1U8`X8<sO$@QUWm=dvJbQ3TOiI)B6iY
z>-74F!YDJNf9ww@oZk%SVrV};g`cZ!)-E<y?u;H!^TS+$#HY)uUuurfaP4b%u(d6!
z9p^s0Iu?DEaF>g$GW_Q5ZiN0jrezD0s*_wepCGx<EttrSvC(sA&_^lAbfps^{+=9s
zW9a>i5yLhy0a#;WaAoLv_ac!0KfGWS*@;Rk|6G!{-_DZN^=^Z+VgauKz)z73Fg<Nr
zrJv;-B}C?U(H={i#dz;^DKKy$XYSoRE1tW|uLaZ6peIlqjqBiqBErQPnBEtMl-Qn%
zy6Bc@l(sY2g#$J2@iWXdL2EIZ%vx5`+{U-&mg0N$AOy^-&`63&Y&ShYKIsHTN@mO5
zye|PZHTB>wj;5rR4&vb|qZM$8jgm2FqEUs0BL5eun9C!MEtN*YPDQqklKV;j_%LHy
zJ+|y*)OqN0f>`%o*U>)^G4>(MQ>jwds0|0z^_zg;ZeII*qJt4a@ze)JHO0yhwx&ON
zX$V^qGZrc}xz%nM5Xz=_X-kd6b*+1TODZp)sPIh`BEFlO!gFt+uzW`WgP_GMbfk}8
zV(J5RJ_>;9q^KQWvAHUASwuidpfietfcF~et4+1M^E`4wu`S>{02{#I%g@L3-|V1O
zJATJXv+=6uRhzW~p$Qin7lY2CD{uV-53N0unNXpf)Qi|Sze5MYIt$4MaUcu|YcGek
zRj-TrHsLxNk6_2}Cc3TGMXAG$&@@|2duA9p4TbvUTT-j5SWRtm?V+>XR}xL^ZGjOG
zN-kn(Qy7jA`kR2U;S4#*RyRV0v={p*#?GOCwo`kH9$|OFG@M1lJv!~C<$W)<y2!;y
z3$T&zpo43pjX*Gj4<P_)78XU}1#>Oc(d`TX4QGcZHfAp6me~l1Z;UQq$QEVtnvf#d
z(Vl2jx}Opqiw0H@THLfPA<}mWYEu6CPTt-OWWvmspLp7_-+rv>=*$caN>Xk<$Au<d
z3Z7iD2Wq+xKa~XKVNPupemlB`ap^38dtOIeC<@K}^JcAa&n{vDw$c#NMw`5I77mOB
z&46Q^gnPq9o#td0&Pj$L?e9f{Vd?V`;yT{JvE?0PM%yCGuT<w!i4^)0U)400J{H~;
za`X6V67~H&)?$FD4W*x_nqX3XR`M(*%g~}$JL%~+oz$*CP%QW0WjII-%$Vu~7UNRx
za}5p!Z8mm?drm3BXY+5Ul8r@rPQtKg=Uj_uGh&GD1V!@=8m>5)H+e!>o+Ul|Sv}Wm
zJBwXNG$=7KXi{PH{@CIqyzPynz;iCVGVI!`W5W()bn+8vJ-e04gGscQ@11O9V>6P>
zzc?QG(E>>Yo=GGj2A=M}VObt?*cHuQ_E=8$W^l)6BnImVIi>hSNp?c08*|pByyfX;
z1mB#}Phg*N_p2|@-9ZLl=+XeAqF<S17o!LHPx)=-HIDF>Cj+Uts$_B`!J$i5L^@JC
z2iv=mv)Jz07Q*;_62K2^_Aer=Z^V1bY;Panw0`?r_Rboe3R*VWr9-EmjB6=Zk`xkV
zfI5h8m;vPYS&EDBHZ0*$S7*}x-P9q)HQo9s8FC-F`R`mmA#b-L>@GXiwmShdx1d>p
z$eJLn8L5H2`<5(slkUW22nQ43?(GQgoH0z43xCwnkUkFh7fY>@koyhpBFCq$wh~q7
z6JHkVjL$L7{QFx-vwwhdac~hNv$m;Iwe|HORM~v3_91g%8EX!!L%J#(uu2{VIg%8Z
zd8B&^b!m05*9Pr$>SlUo><4$LH2bOXEJEWi{95d<j=c_Q0khO$l(f2_Z7MD_9l@#$
zpgsiwGBtLl6Ber#z{^`obVfJwe`<gbaZh`6TnP1%;ML(f#)*+UhkPX;LRZYae^+ee
z{PnBHIcv2SG|I<ht@AVtYyg8aq)f`9KU^H_XbKexZV#j<v<CxqgFFP)XV=`Bo=&y&
zfO&}vbV=K<Z;5ab+yvUr&UHK45*@kVR5{!$n=z|_hO&~=9G41e{J2KS<H+Fl0fkoI
zRKyJF6GLi<Trfp9UdbBy`p54O;_*@%adFOoEKUO5BrwRBda~ORa%6l{py>ukVM56U
z?Sk_6;gjWn!J@CnrU`P-9>~U&rT?%!lZNJ(lu}+k?28xZ!gSGyCp6W!-iU1EZL$pq
zGx`iBC55Uw27Np+>C91-5nY_IjgM~T8zH2kQ)xjGGgZl95+j5|^q4}1QSVc0Oy@@=
zt^A-8o{roSz0pc(l6;k&t)4)IbtBg|=SN#!37X^J<q)tQN;ur7j7!}D6o7IHxY?b=
ztS0^>n!*KnKXgT_dHx;G&t`dV-<`Ih&ri3^5S)ASr#M<cD~)%&Vc3QZGarV$#;fMT
z63;;DCC~2P>cnLoOg4cTCJ2r<Ws}Hph2j2J063LYThMp-jl2(cWC6$(qUa2aWPW|0
zL5^CC)PmaxL9r)xR7--nG<`m-_)r6q6vgPPq8~8_3|;T3f)7zy0Z;j_2Gkejchlma
z0Pd^5AD7v7$Iy(k*c1f<%k&S9C@8dtOVXI?GGLCSt8qa=3kzn-n}E}5;=B5?4U;-{
z6=;x+;VQ}Qdh;jrtNuHg*?aOGqWOfEG~Zo`K=Q+X(z|DWjl>etL9<hqLg#z8oXJRS
zqII@Fxpg$#Qd)~QGrEJ~J3?oJuY~#8G?XV_XT2C{M;MS4CZ}2$Y6o4rZ0IC<rY>C|
zY9QCVqBLjwI<ONfXDYfe6@ZItWZ(oH{S+osTP{fzBD^a@y_J70E^MNbYzqHsvk6I+
zFRLzH`HQoNniw^0^l@8WW2ZFfR99PuXH<7I1S!l~?B!##EF$TT$8`feEw7Y~n7yBX
zzZO9tka7J=&J@UeQbF=)3+sWzfrtdi>X$I+-PMttD&RcSiNu=AhJK`Qshjb^<UaUC
zJAK+L7m5V}d?(YBdh^It+AAuSarG|F5ENZ_%;FbE$PKq<1tL5urVer8Ql0uc*N;Is
zpkZN2TuP`6_9>BbgxBtUw-v4XB3^?DhT4~mhhB{ez!5Q2v%wCbncs8u<U$&=2}KZ_
zAbi<V>1yO176jzHVcX8G;*JYX3K>cEgT1ObY96At6?xW)8&u5&+|rVH46DuWS+;{*
zEQ?@0sF3yT_A42UTDk{WtH?RmVuMpEnxJ_<yQzB;*@fyV&voOK5uk319aQRQeqLbP
zRClT&Ii8@xLoB1}_;ZTyQBWjpVbEtTW!>5o*%1#o*+FI7AJkXC9<i63aQVLk(cFpX
z2-E_Lv`wz=<xt@5b$Xiouy)J%E^YOB_MU~s*xT;CD)c?4<)v@@O@JJ0gtEHrFf2|8
zDNW;@v7KpG=1_}NP^gHsVL4+-@0akx4RLR2$*|sDy&Uixw=SOw;y?WYhLuomOFB}d
zzvA!^tMW|ue39H69?5@=qJ7ZhR}Xja-i>e`enh|ei^W9zIzv!wpz5nuTSt1WN)s%D
zJT#u<!Pk6<6DbK3Pjf}O$c8z|4&e?NXxZN+&k3yP>USKfJ$4}iq(cK1YHkU=pG4?F
zm^7%SvnpAB)HrFc3v4=ZR9rhtYA*5iU~~g8jMzTo&ha|oJt@;oCTqI77(!gX)!S>J
zj!4)uf>OIC?Ty+zFBP~8?HS@YPgBs-6Kmg>bAiak{pDsEqAG8HNL9VgtpW9P?p3p9
zR{Q1zJi(rIjKY7-Z%2Jypziv;x!?-Y_pQm(`xB<Ual!5ARs2=m(jqDOH8CD1=b^%?
zi-?^=tQ#4&l&~%iR(?S*Rh&n_t$5#}i{lHVd>6FD!UFyuDnS?0<XoTEy&{wwG_4LM
zCa0R_Hl>DQg=xq+0S0X3%{uCYM8dFW+IkBbMaA$;(N-5z;?8M`*#&9D9#)NRVB6R8
zm^k=i@U)z2o=}`jRpw*@Ahz!5)30DyNZallGl~UdEAwusNjAqD18wti)+ucSwBTgT
zpCs)<OofsZ;XA_6{|N36*~B;3wn3Z?2QrMoqp!sHmh<LOZPV6gG@gf=Szmx8#R!9+
z`i;aC22UCL2B^H??}UV>QaQl>(J-d^VVjS()Knf}i_N5XeO%xk#kN$v$*CK($jf|W
z;5@<7XIS-1i!XZ)H5s9}eyLVGKmM8oDP@jvXj$cwE*`jhfJHE4e?JxbaEiXd4z>oN
z;%GOONF^C#gz!WTS($`2rQ(xmmb*`_F5&JRq~*=#__xpE1G^gDpf#&oQy?p<LFiZ>
z5lCsl*N>~W!H*}L?F%3JSzt(8fh$LBz&ZdUe)XCU;zlM-fom}>x80^jJ@=ID5y;C#
zKBKwCwLfY3_GYPky{_mLKXTZ6?d$bkbu%+5>{N+h5VLFN;M2xl!5mjC<f?)s5|P(T
zn9bF}uM`pbLOp-tUqV4Is-8?hI3J3I-o+L7Znqi(%lp6IF+lDz+U^|y7ECIpO7il2
zJ`d)wNWNb%Er`g-?iVT1Jn<+lX7i9Y_AY&t8>-thL`H09<VY2&xqKWze92FjHWkW4
ze8vW14ej#-(vjn4Z#X!R3n5C&?<b=-tRL1S(dyVVO$s6sJd782_pU*+^q;(twA$>v
zo+yI0aBh0}=F4@2Yz$ZpCMbW8<<pe0CI3Ggxq|btlj_Rn*aZ=NuP?wnxYFI_LBCSS
z(ssHg6)j4mETpD;q;HdG4#J<GK8edYSHY=UGH{yLoB(S|8Pz(qRf>g>y*^d!O?yxf
z=U$NL%V)UKKhR??le2b%uv*fgO-r@;v$VU?Zr1JL8U2*MQ6zS|9zWEGa*JBKOOhca
zh;ZYnRXdY!Zv+a%)^Hn#EaRhmlj(zGnP14i5EAkB#w`nEfe7lJSZPaFk#hNBOiike
z4qT@PocQ$z%f#|XuB=tn`I8H&Y-QKiErK<i@caTi0EX#;%+qz4CVCrF`iufP6`JyL
zZ`%641O=E+x)9VrA~pfs0l^a<fe2Ow6MUJhhAjqsc`ys~HQ%~4A`n6O-pLESHg@+f
zT%Z{a^`bMT7Ix#=8xcs{Nd#!NpR^Sk`VKDXBVDgz`c>Fktse=MpT=y(PS;LUCG@`l
z$U%0(&xcOqXV2->$jDW{)(3M|27Y_qet<V@_JSsgBkqm{=7DA(pwbf;P`aO<0Xs%L
z%U`CByn`)45LVz}1YxknkCZb_n%miP`0xW3)k$!b*Rwbv{oX4g9`8{gKnrZ12|FQn
zNM1le3o*|Q(npRWq<jmg0IKLLLlxY!4sOh|n){SDQ7pUkp8d6WVN$dKA^(S1xhy4W
z2mqNZue6wC;fG#n?3Bf4!1dj>WsaO$Lq4JdnLsd^ym1WAXF4zHio=XIic+-@K@s&3
z_v}koU{g}@8|3@_F2Uqg(<_dwuIXC}{`O6Pz2tVnHH({*iAfv1$!b<FTcJ=x0)cYP
zcIYCvNeo+>^Jy|0@~bE=GXRvJExPPKz-f-Qy`X9w@&XZU88i<^M9|WvRKj?e3W{SW
zk6QI0+wsBX{Y>-N^<&*dWa^*LNHiD2s9bsBWk1y?t-Cv2+Zt(QpNih2hllGhN{~m(
z2`(NGf}Pe{H)AXwynu`6iMkcAi9e<mgxaS=AipT19&YFxN59eHk;p$~V$&&rGljUy
zEfyPWKoRc?23kG8a|-A?_i*`5PU%o(8)dx`b3l8-Gkm?hDNU}V#^H#Wl;w?4Ja5=x
zXC7lp=OtWDKe<aR%fNyS*$pw1kB7(zqc0Lteixi_p#zKf!tuTF>yM);R(tELD`f{h
z&zCm9fW_#myuwCoiBZ|29|Y$I@fWNmscdSXZ1J1=&(jBAM%M>p+gAe9YZwh@e+J_4
zBoNu%9Cpq(Ud}&$h^DeB<-|5NRTe3tLi4v~dqjI-tbMdy7EkTDd2|i`ep2{Q4P`XK
z`Jam&7#T_&j@Jo>Pom-Aqwz9|s}Z8pB4+Pt*c1hv3eBF_1r;S4vNfO)lukCAis%;4
zp=vA0mnj2XU_zw{<S^gV?>DHc3G*OaHd_`Lxq6s<ns>36K!{}^_W3%d*kub>sdWd~
z?}H!0c+!yvu8qkQ=a9@mE(YftL7_oeil@4M3f&zV6)zX+slP234;PH#1E?wBT&d^u
zp;kw{(vUjHg_~Q&d!p@Pvi%~2J-CEHEPs_RNC;VC_%p*A5v1DWA=Q9iLkq+9*`d*p
z<?lvx#xJmNkD5EOagIGS9$pk9z*pJc^N3*!MjmL?i_u!X;~UMMbWxmvT~K+#f|mlw
zprRc(**-9H>RNZeqiCwd+>i{gwx7VlhO`K7@@OS&7o^lZIMxc82ovr0B)%GAqIJ!+
zX&NDzDE9Lgv3ANN0?~uQ)LkRKob8^Y)1+eLFBoz7TDAq6i+4Uk>Bd{9#;M)|d*Ns$
z8!Qo9TX#($%(fyN?AHeFo-0KI`FUKZ>qrI*^JAaoi2t&E7zy_Z44pe5N4jNGgINH!
zx2CK&bRX%{k`EBg&3>(HK%Pql5xY}|9Fm~6Rq?lb5L(fVKtCTK;)F>{xZ$g<<Jp3j
zkPPl<PY*Jdt)l#FZFGFBy2~xZbgoS|EzOy;v=X2@Q<4VjtVs08fwUJ>xbyf-g8cUS
zewdR#rB7PbWyzk6vVG-7waD~!Oq`wn>Z8Jb616-srfMjakrX@i@e<UBVgeIvOf_aG
zsd0(@ugW+4%+X3u44{l84{jEQnw>dB=R=)*9jHY$tdjZ8!XUV$@Z1X(HN^}~ww<wO
z;^8QS*K$dA=%JhoYsFD#zWi6CSlKzAmEfs39+F23I?`h;<Oq%l#KtAT8&is5-~7vn
z(6QC-(j;oQ#bORpmcuxava*U<7ix7vT7nE3i*H4W$q$$JghtOw6c44AO@4<s<3axr
z;+36ct;EK>P!j8lA6;%$2}US)uU63^h36une@gy?W4#4Onq4MZ#d8hSaVO)&IpsQ%
zg*bqj6~=095rB#Rwu(|}EvgueW1~00P40}Y^sH2puF~*J3yNzTOu-A$YfMTliL3`U
zpJBWG<LKx>6H6N_)?X)_seMGx*Ch*4v2b6u;jecgB0R$APa%c>8TJow@ZCF#d16Nj
z5a8mnNd7rP@<c;x9itiDgsHj0DvC?%+z@|SkLFCmr<PrAvHZj~5}1uwm3(oVGk%Hn
z7|)@A#<EE2<0H{Qb`);a#9=)@EX$D5roU*&YQeZ>OpqVe!g>V5sPSG_7zf`zG75vR
zT;-!u_>+EZhH=x-MI2Fm7-erzD-|%sd8ij^&cN+HwtpiceSEit#ZVoX*)?>$5g_(6
zL`B;8RG(}_O|I9IdAc`r<7{7inOOIRfUZ9nu5UP%1JsY%G39z}S^v|pV6YyGm?h*-
z&NA3c=GH$~uU6V7W9#-pt&&6pW0qtlFxu@(zN7M>aF=Qh2&O<NQm$SgVz_Wh*9?97
zpva<OynCJxf!Wm&!R95b!Zoxwhjf}s_m^F}k%lg*l;7o^L9KZD<T$__#hmWjVp!19
zcy@RnQch@<mpphrBybGT&RYN{S6yuupdTSm+of#?3I!Y)9pT}DhMFr@$K<@J?dm!#
z?OSbfsf)A1rn~U@CICXn2DLeL4?5MU%t6*{*Bc>rH%lkxIGOkM5DhB!4u9oXOz7SQ
z9x7>`+}|0y@Jx8|NUJ<(=-O^kZ|H|p^BolFh}0M{@|(`5@La9_FVS&O{+RGP3vc!}
z5P9rR^kz8Cos;9|>5S8ncLs<oo}9l}*M2R@083RbB&F9UJ-77SRB|-flm>ZUJqI}q
zP|VB@s#Ihnii$G`wzn}G-gy~5R4S4Rw*~2YJbGry5drDMCS0YURZ^!b*|&bY;Af5M
zYj08sn!(N)VXX;QS?RHrIkMiDEGS}sgUNk7g7jep$7EFImq@c+v&Nh|8b`+F0>JQd
zVU&Te;sPiG_4?mM9sb(VqgAlHY+TJs1lvW&d2OJyPX}1JO&da4-9R%dhd#EIKg~`U
z)}%{nAToet?bAqjIzwlm1@5h1Qj%<PU|q-bFQV>gvcf&8B-fw2ZO<|DBQk2sG}+rh
zHFXO{e6LF!v%l%!*2;8oF~1a6?vAEEswpO0!q7eqNxwV$Z>Rl!Ne4Z;CUNdCTK!}n
z9iF?(L9`!*fLHhS9YhCyjb~=bL%Wj0VIkdxF$C83;p12QZ09%6L3EZYCVJrQ@I&rT
zuj-uIAeg##2mHH``xC7=VHGiv3)lpc%CO3ccop4<;?45X>Cduk#``Jt9t9ko_<ER{
zm8D|Q1k=9*7ROhKE`gxMyDoGa>!1~^0nmDvEaKa!l1{yL8VpS1>7J2YWUKgvuROLa
zl<dTh4V!tl34F1p^gEQb&L1t}GKu#_7VZ4Z&hmxjV2R_VVqwmv;!sp--^9YTQ|X*2
zubUltI&c+Thjg@&r7geHTP9hBuU3<cv2mzv8d@bhF9Z((7N>*E@aS<Y`6u-Ss5A51
znAfaifm2jkrbNXDm{+3-akHX?KkjEE@Dngm4JHbOaW&LVX+!5`Sp1O~B->U*R`Zmq
zOaBuegc*{&W!u!MW;ZJ1p_JE;Y8(G8`7shstS%#^Z(u|RRz9FtkD*-fbqaLF8mN~C
zfSZ+<Bw%@A`?dTbfWFV(1M64&vb`Xu(`qa1BgInr&|<x3^eo1Q3nfN&+^sf?i1pUw
zADbp<4=+;1bmL6(F5H&W)GY)h)V@j;vBo4gdPuGenwejGMyVy#2}TQnO|;@Sd?l#?
z=VSrPu3b{%tJl>G)rO?mKcBpzy4lxEm(s4WDCqbfoYxJcK68{TMt5;sBkl`o70Yj{
zBLivcDf?$f@)hQ?YAMnZVJh)adA;-Lg39bM9ZTdpc@%99G`x!Nwz>z-9bVy46)MRH
zfK{&195ATJ=m#UMg_zwkGyDNfHh*wS!%ZxSeVjcsFQHmPI}y>G0u02|NYD^=J;n69
ze?v7@9$i=E3+Ll;bpMceFIa7?QOEPxZ6c-B5*bsf+4Ck)c7(i{g|hjFeXO1T0z$Vn
zuKM6pZZr&P^<2?SIE=x_s?rswqV^;uNvlvDC4mMDAS0Z72U9_S-gTaL@N9EoMYJIA
zh72^F^Whg{ayEQUnIf%d6(@wDUS&#=QKXQZoHO*^T6KNC+O|$%5b8N!Ah%m!rcMqS
zYpsuqE8#_SHTBQR)R?0C;RNzH^W~p{NZ}n-s4^7<WUM+f)!nGcaAnXSp{Xj7N1lI}
zK5U+8d}`I{CHTOW$?ydoLI5l2UuJEZjRNa^f?<tPt;52y7yJWvRVzAg)6Y`?V5a2w
zdcw~QC&=vz6f<zr!mjsr-as5_2g6hDRj_Tcpkc++P_k<93v=vpxpNW#zOT~(|CDQp
zurB1%WYV}$Q-Ov1c-t5XGswqlUIM0%-2>{4UTeYig$`#9E*kCJOZ#nQl-HI;?{de%
zk&gd4G7le>25N~-|AB(`pWWE|aFkrufuSZb*Z}AA0N;~p>3*o$8nq@PVplu@Ifb?e
zC_WL{vPgDb9R*&Am<#~WD4~>R@1plc>(0D~i%wDMD}r!8&#47L!E=i73&<H_NJ!D!
z^@$+AX1;Z*5vPx>xM|0S;x`LfD?6Y7U0^<U_juW8OF;yA2uZVqrjP__frXDuFxO%y
z6xng7ZOuL9X)2FBkNu&gNMi9|xfSV?B8`k#Fb>d8$=D&-IMzd}fheeU=+RrMZt38O
z{$R{C1)@6iWC*9Uf&0wi!rK4a5<6^YpQMz-EcD3T!^kH3M4|cG&_tR@bFWbcRoVbo
ze?H#UcBX)9ZV)JWsn~fD|B7Ttf_hvLBT0B5$^vM@p<etE>nqhs@(blELF!ZMVl1Km
zfLiV4L?zXeKqA%6zy|?ZsZpXQ(zTNPBL0UMkqYn$)xNcX+SuXBUlyKf8`2?k)#Zx9
zWLeCaqQRQunO|(b(=)LR8F)7+$Ina2QN$Zom?y+983eX|3<L8p4hSkD!=*XxY?aGo
z`~0_C(F2Q2-B$GlkYmDjS;U6CK<bQ$1?YvlU!^E5RV6t%z|i49+W6kh4WlDLZyiuq
z>qBLCh$CPR+26z!n|Mc6i=LKq4V`JC`=Um2K$n0jGaa0evDU`bxtOChgRg)Tg#%Nj
zNv^4Mj?XYR!8I6(8a$4%Su7S7&um~D5SrD2?(whybDlmK<*HP>&BB$r2AL8v$l{#x
zp(ls9^wqSPJS4)-x(&>NYl7cmiYi}P?gHjbc743DNKqU}@{rg*OkgEiuZ{FwbDX}(
zGPSjz$yPO-8Q#Oem9TtYtt&n&NvXt*;ztOiz1nCwR?As|!eI)!u4`-2M$hrIW^d^u
zkFLq4Cu>6cH4QE6x`z#?WnHW%zZlcJL1a2dj=_S(0Cpw)>e2&{6e7O1tg(-64~KSk
z+ys_`a<_C5KMx*b!OXu751zdl6GC_yA86suV81w$NUag{F%ZHaVwt1#okOKV4v9xG
zuq$99Jd>R+kL&EQ*X>0&BMkA)k%Fi^x9TVwNAcZnA;@K;7XB*WUya(%i9*|Z&i6&V
z&8+Eox8#&D$<-*=ZE2I0^#$u6{2fQ?G)p=l^>wnxq2c@Oq4<We{3S>yk%-DX4lYj-
z@{kW|D~XWhD-rIVLQ%E`vyamen-aKpFtYMPjl#EE-$HHK+eJ!-Fo}dlXem-LKW?Z3
zr&wFVe5^+{0+#N{thzD?Qw{x68g7~^M}KE6Lb=J!iOwRyf6`Ex>r!E@Ww6l%1F_KH
z7{-|+v9wYJs{B&H{&)7faaF2ml<$Sy-$#5uShdu}=~T7Cy?Ozo_I5Xgw?P_SxuH!G
z@dbTtqZ=Vi_!kWt)k6Ces4%8psvHV5TZya~*S(L;j&qaeO8o}=l*JLdreyD<l?Dj>
zL1sRcy0l1cimWn1m!pz)uzHX#fUwl7{nD!BPyn_ENGd!3<!_R1cuf6-guqtz(;Gex
zqB-#$BF(hkQx{dc<fX9aO*vnXPup?7>vxf=ZuR2`kWC{D1*SwqgBa$;Q{I7g&({WH
zr*o|V6prh#%KRd)HK*7Fkx@q80G{VC{B8pm;eS<QKRvXq&gv_1Z`RM}h?@CnISF#x
zn%7aY-%nq>dIT5por=4JMy<(P{$ccEv~77Xgiet_%5j;v`;WEuw+xHhZ(_&BsiiW3
zifdo-kI=Qz8i)!jTHo_L#H!PMstuyVBMl>wQz6D#2-ip#WQ$mi9PuQWVU+XQ*O7HF
zEOICkAz)KInquvS(5@S&onSYkB<wBpz2?3~IN-qn4af}?v^G9~Xl8iCNoZI--lT67
zqgjCV))jXKX9@y+*HnD|UzMzw5m<1A4;=CC8nuF$7?T6wgNtnEvHNJGxa2m;>lcSW
zzt36A$!uldj^A5ygFx4vr&s1a)F^DCi=e76Xy2;>l7@hc01NsE=9xGP4iaT^9vFAs
z>pOklrL@EZVf7wegZg0s%!aWCW81blfqMO2#~@PmNoN;pU8GwV3eg48ph|q^5<2g!
z9;)39NycL8z+`tc-fXpiv*(+VIK0Q%G_C*pa{Ka!p!`N!;N60&psUz}prxwU$9>4G
z$bjfKd_AHAqIo#kvr$_L=X3TLct6)E3Xh(m?{Phbp*FM6zDQn5Ms7L`MF)6ZyME<p
zc07k<4HtT404qS$zqpAP8V3LZC3=lrl&I`)W74brO-NtqD`+=HRafHI#;sa(4UXFF
z7>91=Rll=Kls8RKn@1BK0~c1L9Hq#gbX`WL&gNt|Voj80pPcb6xpd%GL}TlH?YT%y
z59lT#NRMPR8zyn821>~?i7GEY@qdehRd7}5BARW2tl>kD2fQX1Vl;45o2D{qGPQ)1
zcCjSHF}|MTq#{m0%TwcJlI}|1#!ZYbj|;vJk@<S#Sr;{I9{nAL(-1JwUdyuQs!!2Z
zG!|EJG{KO(agjHE!=PsJo;WgHZc}yjTA&yZRqv;hXWcHh(Fh?v<xcJ5h8Ec8ft>d~
zK7fZY>hCEp?eq7L`S{8M8VZ5yYxYA766?+8vygw#4znM4UR9^S=nDv{LX)WS!EpTY
zrHw-w<$G0jsBS{MQc*ky3s6R=e@r4C)j0sRWFZ7@5*dZj7Nk*dHS+nIeCL9B&HID9
zn|Sc-sYt#|hdiO{h1z`=*REJz*-i$XacKm*F-c3|>sbj&Wmv&8bSXAMHf7_eJt}R{
zU#rLravmK@;Ny#BWS?Yt>GrS4OHLo4b($T0DvF(4@nCB|K49{WrLvSkWOcH|cTac9
zv?n%sBp;;sYEdRK-t7meE2@%x>#96M%`V!`m=61qo1S4mssD`gggD7{OS`C5I$EV;
zMUlb_oji{B4gj0YvxdJ`VU+#Ij@QJqFZ+@dM)|h%0L79-TY(66h(RCW%AR?5*$K}g
z>K(tZ6~4Vd&YBRIE5;^^b==t84cK*Afe3Wyf&)s}j)1-Smuc;p9W{8+2Hn5JVX`Co
zI!c_OPyEi^EX6_U1#t3r=jqMWnRTI4&x_QgWYnyT<%9sDB?-@!lQQeIjn*#Amv7Nj
zYp+JLk#I<{axn{3$*=kAPVDRRF~E63y**u&@_Z!#Y$yg(7i{8rGZJ>u%i3bCPM}4#
zS~r9Rsk3js=bc)K`E<aLji&;a>{M^#a}?22wwLSm!{9Iw9rypd`0h>R!x{#oaNza{
ztuHTi9q!KhcU&!`x=+u598rl|tZW9Z?qo>Y7Pgnxj%^kG?bbNHwIv8gOhkhAJu1sw
z?_BV+Pi_oEcO3U<gKhjcJ;oawDg2lDe>+T{=AB>dp8>_)uaWR*eDypuh{_!I#3fy_
znJo3rOZ!qx%L6=BC1q;6ANJ@)00BxeYV0>=#hOa<4;01jPy2<ER}_6(=O&E1Mgf1l
zzOA$G@R-4vL?+7&lBFb<x1^HaoHyxHCaqi=;|t+!BC72H7q=Ci1K?&M6)0&7hLDKZ
z+88S;p**z*4^JH%m4~OaGW~xM;_9j0tS&J7-G-P`j*+afp4I>)=g7`J0WHdIG2aY5
zxlVx>2R`_#&r&AQ|3N7ANuBBu&B+rn>1^AdvbWdrC3<RmeNo1<;Ph`HUzaiz6}hB#
zCu-L+9p0K`%9#E3uX*5c<i)CzjO$Cec3ES&pPeQ?FY=m{pAUy)y(ym4f#I)_Fd3aj
z_bQU-gPIr{@XFh=-pJXdqpOIReqAZZ{%PXMF-~9XzGl7jeU!g@1-U<;$irqevI8H+
ziVE?fpFV~2y8`Z+VhOFvrtu+qCO5x=DE<B?>}2;g2Wbd@#}J)#R#0}@kS^<Uo5$s3
zH@8boAs{|5Z39S)iO3J7E6$Xw_<ubK$+sT*I|)|4<?gwBmkgsrbGDakRH4}7JIbsQ
zeJCU|PM}G9`pj^X8YIG$j;ouHGea%UZ?}@MgA+53vK@>|7VoV<Eu5}t#fT2D*|9xv
zgQ9%=7G=IX<N(GpQTLt(Xt-jG;T9>~lAFC7Br()^V~uu5nb~wuFL4MIvTO>`6sE$1
zv@GHOZj$u=kZ}L$9wXdn*Q<z0>3sTTXLC2ZYM|mwyX#q&B2o0!7h58Dm8Du*w0VIz
zF4WNddPd*EFBjRPzBzjJKp=WaH<HE?ml=Oa!JRW)pAU(623+;o{`84yydV=pZTKY_
z5$KU;#TZ)?{!TMFpj&Q968iG0!uRm7rj6Mo#B9;t^`oFCx1xd4G-_WOU>9ioUIIpf
z^?#$Fss4AWv@VyneeDG9$i~WCFT_AJ4lU_F4p>&Cd70Cs@ZwHJmozU{2?vd@dd!;O
zeWn>V2jKw_E29Ms9L@~DfckhwOu!2z$c$gZuhl#{`WFY=-O0DMU=UmKzPrf8!Bbl%
z@KBCHH_WZw0b;J&fc48tR!vq{^zd<Fd|}VqgL@pn?v6~c@@wUqn1W9DmGGZ;%}(d;
z6jq))%m}#KATMXWUAcIaM8f3$gvkT7zUE9U(g7j$WM1q3cl{(r(Id8|W6r^0UT@J0
z$MPl6IPquqj0m?86tgJWjbEkp8>cHP<v`4nrd>1R9}ib;9%J<+N&X|I#u-`D&BBX*
z3_2dXM*+_<%6J^?G{X8o4TT5+waqBwDfY)IYD<)JEmFDMvc%C%m7e)@YE;jW<C>er
ziN)8|*7E@G^=jQ7NHhb5S~hTQEn8DUj31TY%D(1SMrC@qmP!&2nN7y&^?i&zblalZ
zb*>KwK~#k%N*12T4*U}P3?bS`YFamL9*_nK9(T~J()wRGrMNItVUh_#TxS|$7}9^P
z?IzMTKwU7v8J5ypAS=RuhIUd%by=hVADgM4BZlDPu#K550*U|Vxuu}q+zn3$50yl}
z{@*Z}$dLm(?{?<JDh2v?uAMT9{~shP3KxHgvSr;KEBY!eZfm2xOKl`hE?tEo-*fkO
zA+A_R5?(Cdj$(jqFsWk8!vnE~1eMe1Rzbk7#e??`bv)Ed8~WTuUq*qh{krLH2KT4B
zuJs4njuXpiq6dkv<t{gxK06~lSs3FE7{+u3IC6N>1<P@iCH*WmjSN0dp*Yq|MgvJ-
z5~Wwh9dA`!afve&H|c*VC!a0O#C8-Sv{}7905&jO+aq%{8>Lb}-=JcPj4L`{rXVSp
zm|L4~TIf$is0S@^>>W|1yFzZs$2u&5w7)+<shkM=x0Mm=Uj(?+D6biXw6y;DF$bao
z`=>B&<~uc(PH0s2UB&|GGaq`WFjnPrfMt!|Dt||kI+su>*|i-<J#A;V!+Px8MXenN
znXZCi+7Pb>e<|>zciVo2ooV=^;#J%F9CYn|8#+>UJGVqj7s(F&u$G!IY$OHXKEkIM
z^hizs*E-MBzf>AlrXYN<m&W;*Z3hfz?iBt}0!>J^E(LuKgVC|yB7sx12*Vc}88%DH
zYsi5T%qzV_!Z4@E53Xi8P7+Q6!4L119rruxlDsvzjT`aKmTQ4}Th<ypT@A#eH8`ij
z#BSmyK7@(e%|B~m@cQNZZRKu1SW#VO-Po%s6fv-Ew@cKNVISRg*cCWh<R%)f%WOqe
zfxToPjYxU>6XOeHIndWI2h*|?-Aj(&S%Y4(8DFw<pdHj^2I=kyTeeE_f1n>H02kFV
znuJz^`v*826%Ck3nwKtM*Q>6j(~ESiSV+M*q(G2S2uY8@$*S`#p_xJz(cnYScW3{e
z$qZi5nbYr{s);3`_suwj8=w?m;X=Vd9U06UK8}Dn)0UY>^S-V8ziT<s_IFlPd|*+R
zw)F&irMZ5baoExW+ivxWp<97itth{kt=Rc+^F6RMP%yQIZhCrB$?$3h>Xd?W_4%R*
zavc#v_y%i7r$Ak>Hi%fYJbu}>^)aRL1Qhg$L+IzXGUcP@#$k9q3(;d8^Z*R?zX|xf
z6}0gMF1w}VM>0bp=aR$zK9Bgo<7w*IS)HY{ghKP@k{D%)G}k3N;90n<J`ik<VH14x
zBefbnM#~f10Y;XWNWq<Wvf|C4Qc*1l1aB{0#2QOul5c%RwphFXsT(k(D&~ywc=HG5
zFpjXjG%1qr5-0?G0-=Nlp~+e4W0sYKRvI(HWaB4uinoJA41MDup<;>S<G5&vvAQ52
zMdVqL;2hTw<3Hf)6@{}>1HITfLxS-JQN%1NhFs8d#BM81P3V9^tlm`eDe;24_*sP|
zY=yN%1NRKVpAju3u}c=Z-UsG&)1iOTyoFxoeK+&WYE7Y21ogV=vI~OIFhjnYPN8|f
z?!Gn;xP0n&fuJH;H&zuf2cr8vA+Uo7X(}Z>=^aimB@rNOci~*f5zeQHLf^)#d<{jb
z?)+VV!hTSsfQ}xSNDatY;u&}^OcA#OZ>zZDro>TRc+d8Gfw+It1*TXEUuoS{i`x%F
z7#J~V$okWGVQ)YDgy={U9ma}=(=iX}3R-*K!@q6ltDj7CuXGlkx~d#WJ*t7^+Dkyx
z!&TYSWd^THGvn_xmM<?G{WxY#UNyR|CpkZfR?ng*bVz+wdl1>sR+xbh#$$_R{3^SI
zy7I|$7|a|2TGS2RBMrFSa@P8V?2HfEbi=<fFx!naR{GuOHmuHXAV4tDZ$?@|Uq7b6
z*<!W6G`<sj&$(g-09T4cp7J)?5IyJ^fX0v`lZTte|7x-RMJ|;9n^GMFx;{$|3%0|Z
z0@<V~FD?Ez&{E(+WS-SqJ^TZG0{OeQR1|2B_xsPO*J&lXY{D8Kl(=ws+FFyX<x2oR
zDZCG%L5JS<Qe@^6@8dpicSyC+Az)_08N)GQJiFaIIOIqk=eU{I2-4!gdE`zhzu@H|
zWJABa+@P{mtqeyo<b_cKqO|`OEsg4Tl*FUAPoyr;989goCI}R@5E_zOZccX?l())6
zmBtAQ@Zwy&^KON7f1T1YzR2fR2%MZ&7`iOaSaWqmqDpU#6BQZKBsn9v>Xar^IMt9N
za}WwS&}!n0Pd)J^fHQ%W09qWfX|Lna<)lu>;F;<s7qC{HlC9qN3w%J&^9`msn`rP7
znPT`@3!Grjp!}H1tAguk7>JTHbn~GE?V3)L;w!RaD&fJLS9!Y(s@&v;{c(uR1c~4*
z8CvIK3{p-lTLF>ngkJ%f^3U)hq4-5lWsFl`BXp>QH9Ws{^ThtY%GuaXp+L<IY~w&b
z+rdA8`)n!)TQXf53HA`FUr7;$KcR|vlx<%rwWOg)=}P%DcRx?Ho+<QGU0=$@_lLXR
zoFS)shRy8-yR9q^WNpE0Z4W6(piEKfgp?K`zzsf<f=ps9!?a%yn-I6pCfiB0o$J9T
z;le`pewo)di19kywKK9|Kjq`uvB+k&38y@Wy{RLgJRT`2nFsdZN@i%5_0~ScJ?Q83
zVPlqf^2G+5NIH*Zy#t3&I_J`QLC4yl!8_wli1^W~2+&fMEKgy?OrS}!;THV@O%boZ
zHkCL)dj`%k0u4*gTtfcpgqEZu-K)E|6`t5&LUO$Ji__j{qlTM3W_@#1c-W?*U%%Ze
z<o4`nWZl-?Xx==E2bJGlx<&jZ&?bM}DkDP`c$yL2#_-KU_K<GZ^QDEh2kJyaB36@@
zERQKpt1b3sM8w<dWC1bCCQFwv*d|XmKUA8CJ(djQrl17lT;k`rw#!*^1Ssu0@9Mru
zQ*9MzQA&cVktXgNdCqlrFQdMk088o9knScN?K$W$$@N+%Fpp4j!?-CK3K*#x=j!br
z14pu<ojrJ~B={+0A$}1h`7J@`5`6M4wx@wZG;CFZUPE}ndrwr%E%Oh_7geM?-I1Gk
z;_B`sRM+I<2x5l~`bga4Z7j5eVu2wFVaBnTmg6dGm`;@3ueP4%E}a|0e5;9Pc8ok4
z-iL&e@R%`qp~YUmOZcb$+&A|W-HNKo6|PhMmOC)(IJ-GOrQO3(&JcB_J&&k&0U48v
z8ZJ9TOx}&PRwc!*+2Ml2UwG}bDNuadU$7I3PSd_dyKblm?PWl3c=`s4vdmuzh_PP4
zy)#G<>_r2SK;=nZVU_=d2k74qS<o<4+KMANwK|^U$8Q;L!NZ9Ec3*rEfL`5?zQY}+
zxtNVt-aOdomeinRH?g?lilR~v&dndqbBclkf;ORiGksq50VMiQ1*{ioY(E6;>Cri{
ztkYm7v!^z6e>v2?&BKmd0-wi_4^z$wwd+ZygN9*P=HS*}RoJ2Mj>sQAr8V}$RP#9q
zSpK)_ao-6zH7=$&<4<+Ff%HIIhyD*u2uVFy-H^4_uld(%4`w4_gS_!@VX?M`-N5|I
zpm4^7%T#oek~klKi288G8@;1QappsSBr{4}7(On^eT<j(E3}R^2}>I-n;P&E!VWmW
zy}n(jW?DcBFH_T74aLLC6IriIo2LL<JdwX7eTBvq@$}i0K<5LoXx5Ard~}3TjFefl
zx9<ix2#kBOr8L<07#fV5|01+Hghonl-Aq_D{U&L>LbX3+eY}v?C6Bg$o<7OR0k#?Z
z(atE4B(BM|U|ZAVa;+Jt5bqV3b)dbndEWNS*hw3<VQ<9rQ~E&|!)(##+0m%NaYa06
znuf-x9%Txlw2kTZ<8Cv|2wr*2l$6-sDD{o;7RC-*(F|y24?GXqIvP9bX&;|%gY&x{
zrVUk}GY@6P(|XnnU)wd%E|uNJ3@5NbJyj9-64a|vBuMT0K``~oIzz8@Rfawzmnida
zbqp3;iZvALVWH|D6;;%tJKzi<#0`FseE+@rki53W&r|1z`r~}oPVxa&Ic<pG=-B_~
zph=1tOmlJZdz^+ki-@duN{b>HjsAMNV$P(oxs_=^L-xdyG;q^ftM^*|h>pk&suEJI
zjfOw}8(UY<M>bx~f*?YdjwI4IgqkqIL{o+s9Gl0+<@!<*qlU;uXPNqpGh3&QsFA8I
zs}gmHiP8jQce+k*0eHQ;CBnbmeg<r9b-<$Z>FRSAca0uD!<S^qe=df~jp)5~swl?|
z2U8abU(T%}-(-NCyt&Xd{0#w|uq9Qm%2Wj5&X?U!%LREdMs?Y4>A)`n(N1>Xa<!`P
zDfmk~i`C1Xr&gM9UD^|ex#83{(>eP&Nmr0oA_A77gc=Gs`fB+fNq*LsP&sBVQmPhe
z(g=Zx3jf-!QK#b9#ilDO+v+#^wyf*~P4m2!1os8}8ZXnUj;gT%jB-*!)vmNEJW(x#
z;L?Cp=$G2)@U>9f)oJ_TZK>GZEi~i{oo~?eJgTtMcva_E<8mP4cdFs!U;reimS-Ey
zE=xE44voXo@SlhHSqo4VyhpHj*oP=kt(+G+M%RSZZRepmWoY-4YXo81eW+H^&hkbc
zR3*pHnb%n3ds~^UU|g2``%lvOG1HEok^<o!L5|Nc$tvdm;rO0#YUJ#&p@dLpxj$AM
zDD~!y4PdA`0gqPhsx|jtcEGO7T&~1;$*EXTq7)vKgf;P(T3s$+K_kpqb{?wUR3Xg#
zWUZNZ(x0I1kM*WaPnAPz#I7^R;isQ=aD|lE8n}}tL_6<|PiiLdr417!ET}BZQ>g`Z
zk@fU|7Y=KAaoQRTNU;R<E52&u1KvXJ)yKSoLKfJVB&)PYd!6o`N{C5gK}&wadQqs>
z%dbPN5ledJE_n<dNqr*E6HMw@?BOYs7rd842k%tbTg0+TQWMQT`#oz_GQ;U9t7Bx-
zmJM3-hWGYcXZc8O4w3A2b+TIOOys=1^j_AexmWU8XKOIdLbH|Jp$#|&I;NUruqvZl
zcbuT-k8fL2)A%>c@-cnMzn92CQRvJr{8!a`(5Nu=aax{Br36~PtZ3XbajxZSK(2sb
zGJ(u##o>$+VVgcGZh*>J7DMC*>pOTS3Vv_5wU<0Fg?Pke4V+c-yRa`H9!5~56XV&P
zV5F=5t_d8TxHiKG>b2Q6Bu7^eI9D;4VWXOI`HkTorB3W{VP#vN_<3@;sj7khnH!kd
z?FN;bCw_}jb`FC#oQ%PrW-3D)gtTf<0LsJ(qa>OOIx+4`_8}Eetg8!PZz^c_+^oFQ
z{ickU&OKFj*N|W{29+hV^DcTUX_t~i-k&nd#hES=tf9e`(Yw1JRw}h&ocHNx-|I??
zW{>}<S<Z1HQ<22xx^V3-Z1Ef~TPj0fny<Jw<=b%1gZ~PxJS=kd3`3i+lMMRJ0Y;1}
z+^VXSl>OV=xF9*)MU&S#^w*as{cwpmVr3{nYx-t)vnohf>aBu$2UC@~36hX~NT-+k
z{Jw|qiHh?^2=>BW|DflBgtnD?*sg(2r#Ez(B7{@bXJwmns7z=`VIpFE$ONn%L<-Vt
zkpGD2jAx&aB{yuIm1a|3FAK&f#z;Igl+FHG$vgK2%iR@cpS%w@b4B_q@t(x$9)*S|
zii($eBsMmfcPx6TQ>Yi@jRuRMPWx+M|7w{J&|?JSufxWx2Pd6<;t$9o!KB-Yj-I09
z2{bSO=?y!tG;)X}VLGHfe~bZ)q{>laP^^$m!tQHQLPMGcgidRsEPpU8s~QjOBgdcX
zrt_{KW9LQ*uo#y&a(rt8B~6W}$+xr!iuj0xFi~lV(w)k#gk0B%dM*k#4;Kg;Ge^#|
z1^Nr+RL`Jz<k9inkGN3zO&n&MYfaDN4n}@)2ep?pP)a=ZI%u`6%hHBsAa$3$04}k2
z+Cqgitqg;>!d{#n>vU2BWsa+n6ptdm382!XxZ1LPcTM{91(W29WM!ga$RdZ+rDg>w
z0(Eyj7Ra%fJ^M_#7f(#goiL!(;C4p9;2suobW~Bhvw`LtTXTsjruuafrh;9d3qd+X
zJHLlYz`(uT9rop?qAiC0lu5oBoo)h}G(*&N+*3fv>SBXBIU~%LsZKUHIiGpN+{!Kr
z*21WtHRJvMD$0<DNFWs>iU%VoQX=$N-*0wmsGErVGK8KXlIq?9_DiJAXKE1g+rnFa
zIAdC8gqKiI2W0(xD`%QTR#$eeM;!qwu1DwC0Bz!D%FnM=+cJ$>=ulDd)v5_z?0Ejl
zNeStx#md*O{@wATZH4eKb1;eJf|*9u<$%1uv>0zDOn)iH<ctu4zFK_?c_<ulhq~I2
z!^1+XEC@~PMzSN{MM&7D{Z{ee!-rPeK2$Bw%sKJiNw*f*iZm_SHJr6&TzifAD>xW3
zV=w#^@D!A273dmrh>SFQc9rn^$-ZI2nWYW2s3#$*f*mH---z1$%TrGAr%Ja>y~Dq6
zWk^EBhR_m{k*+0E!$h{Zy4@$RbQKId)?GiOVqsPpHD@NTk>E393(P|dbSM*|J;hX2
z4jkh|8A_k&%exhY(htWT;EtOS1JMGDv0B=r!ez2P+uV(}jS2Sjl)pcXsfO5?jUyds
zoVX-@CnHYMr~jpF^w6p?Z>m=m96Z#^SV;UWQFt9KP(?pEnz!&lY;xIYF~qA42q4?_
zPTSP`E|*}K0}#AUj)V~dte_MRM^rxf_)}~zgQz}LKPRN5@-Gi*S~}1(?7b?-myvL%
zvCx4uG4wg&6vNdXWuzHHQuk66asuhcz9%Z7Q1MvV4YW^YsrBu_^9gEV@o)Tv8#Fk>
zKwR#sDlbUNxSvFUgO8HR#!gSDT_}rwoQKAmwfD|F!joz<cB}QQUlUezi7Ojo5;&Cy
zr~MyZ>}LAv*HI}Z4GbvTS(2m}pdPUA^qg@?dlM{-s4gk2X2-vd!#)Z?m+A-miePMJ
zGiZ6jMkNaNm}1jPU8X}lJ}wjZo4nLeZ(d?PQ1&TTr{;U$u>T`7=J+{rCI_nD$ib<9
z^}^Hgwu{77Fe_@Mg;#_z6m3z|eofWd<mG-#mvNcJ$$zur3Ol@1__eo{o$pcp$E$1-
zP9pcoc=RbwU-F*b6P#vZ@(6xFx9%u?^Hx!1Sa)bqL*KUu6D3|?jQ?hJ7<8-N!jjUP
zwqK#HOp`5*wl(rLf`;5nH#?K_VYVbDbdm5_=Q=$tDTlirlWn2JtqsYBGW_F_u+1Z<
z*=-qV!WHtSqKvG*(??;s8MA5T+dYxEobH$LWmlv4Q)fYrebJYW;|b4TsHD0k86Ku(
zd=xTf{|w0uim6@9Y)Usc<i+LHx!<_hel3M)sE|t|L$Y7ozrYzkEw-?ZQ4++5MjOJ@
z!n-wb<Kyino&^I><`u4Np39ThdC94*6I5@zRV4_UWcU*d2b+TtIU83n$MLK_UJj3K
zX~?8wZGs)0^W*57#y{E&h%jTYIPmYjtKgdW#Gne8u5FiqGfV?=e?FVywRPorlvd(!
zwGd=7*5|AVf$CrXnGhxXf!Iz#K*zemr~xm|@qJUSF121N$~imV$od%e8Ww$Fs@wws
zZ`K|#+FX+mhH}~y1pRSxf<SGr^#nn%ZLwe`l)vH6j5kBaG0ec3#CLypf}oP~*2PTp
z$np#MsV`?bY#;}I4O})BO~#T;$`Bm{_#U8v8z;!$g26PhWxa&qC4o5Pz@q72XgWo$
zg8UTYI<+)|Cz|L8JWP^PuB~mzBgo|5r%^yGi`VG|D)~k4fOLW3-*bIO{<*FJDov|m
z!;taiAdL&T!RA-<=St&sL_4%3qw=HylkmlsZ|B1X3qFVv^;s3BjmneO+~6#plmTLV
zE+WHIH}`^RFj_@tsgJze-#kT^E`gf1u?q;uKxnh$sD#95&d{_9{zO#M1MqogTjo)^
zJ>7KI3c*vc%4r)@duG%Q5nAhj)gjz5?w}E5yRRuGOR3E8ak`j-EB|GO(oNz}k!`N~
zKd4Cf6Fg8B&r9<zwdO(f<mh8*v^vVYH9O`6G$g;{3w3351}77qDJTUF9|L8FQwbzP
z8%OORm!7kihhqIv(w8EFvRE`QDcQp-JfE={387_n^#RtWo(ILP#2zVNv_lvkBLung
z&J3WCW8!}ubqi=o%~&N;*1%FQF~qJ5Dz#6T24tA+CoqH;mhouma+&Z4Q)=@Y|D*Yu
z_}JfYgK>Kdh0@NJd_$AZpfsriW0k(PHjB6*QB9Jl_#++?rzL2$pF`6vQ&~^E+cSNM
zcIk{L*1yl`IXhLjtY151CVB(P6@s$~aBgEn8aZqbu$nn`!q>YCC&pAdI!gA;|Kyh!
zbOu}rw)sL%oAd}9v)%u#QWaPftv%x6=dXl%*k$QKh|bxUdzd|gn(;0H2!Ad&LwjSB
zvrxBI_5ueQ>%ADo4|0;Rbm{=1_N<+O_NqqTf&IHvE@(DTrE{FNPhyCy;&Uny-WIne
zQbNmC{w30{-eId!u8mJbpWDYVfN;X5Raut)@k?!%T2VJb9yDA+BaOajBK;a$RT7kj
z5sTZdNu}M4;aa0rf+;hB9GU3W#8Z#?%%?UF{H$fT%#Z>lSGq7x;58T{33ofydAk%Q
zHO!!(?CyN^)&j<ZhS#91yFr|&^n?g)x(5=-<J;VQYuZV#dn|Xck9s*0(8OrENf-3A
z-qEA)gCl)w#01oGeSvYHffwhViy%Qh=7HDujtZlkx9p<F$JaIy>o{0yoVf8lv=Ig!
z0pP2bZ0f|@w%_x~;fGFlY`0hkKF9j}Wx9K+ox0DD8xf}!3WOQ6G3}2GzZo5;grAu%
zbA3=R=L?rn{$C<Bi#yfoSWSrU1;~4z3!ue{0c3xrz*V}W=V+=#i&a7a%cl&EoROhS
zv~p49w8xn#1ijwGMq|rCRhf|S2Lxmg3~{J8t8LVSyQ`k_V9{sq%5cB573r_Wf*$?;
zpCjt82jYo;jMkwoxoFG<N-DNn4eM2di)J}NWuHkB-oFu4IEkl@F%F)gE#;fpp`LIN
zG)y6`-GmKhO0{UdpQM<@ZCO0Ay4^$wq*%7XWrapV@682AZn_+n70ojv6quUf9WMX`
zM0GHSU`Mv|B#JrNHtnK)MhW~PyoXT|1YbqtydF0Ldq6Iz2e>j3OPC=;EiRf?Nm^^|
zwm1wo=<Be_TaiQpat0c?%w4e!yXq1nAT$2jqA+0cDonZb5s>V*a}~Cg?>LOPiRra7
zrVsdvfpjCH&(n-=g6+5o6~!9#US#vKmCg2V?QMj>k}ge;`%t9n5N8ZcxRXqcP)S10
z8K#fy(~J=fVgfVFWoLEA5y{+I2h~M7bR##GzfA%3OoyQprU3r!V>bg0UU!LeWeVCG
zjau*g+&7i(o3m^2`?h1RlqPn|IiL$^C~WfmEr3GJW7qVGR!>?yj{9kr40;~yYq<xd
zHS?fcQVG+g+CN^-_rR9piS>8D2Xv8xk%T5i2K^sUNu8*q8F`-<aik97gAl!Q!Ham+
zSJ&f=uyLE0@}Q}@hi1%APw|nau~rKriC`tz+)Ut^$I0}jD2}|R>#Br;a=1@)!vm@d
zE)I2uy`Nk2$5~~16^fbs4WA!>i93(-AykB)TPAsoO}bWhw0~rXj`*jTtI{L?um7L)
zY;qgG9whWWVNTqGeoQ0=rO+-E$t;VWdL)2gP;&9>Pko5#r|=uEG4|g`zzplN-np2>
zcR|&>O7vU?F>NEY@W0%XBC^Zv=8BFXA2yMjdbFZBmz?9aq1=h@o0n4Wz?I>CA=Hcf
zy~LcJ@DpYj?vjX2znEpbri>9j2HZ)R84(f7c#D#zcovhBv7@jRxFHx}n0PF@NE9VO
z%-RXJ$y(~=)8K4BRhX}@3d2zX{f@9QtE(jOC8(A+X@nO;&IS425&jcq17V3&y6_cn
zi(asiqFM~*O3U?V5E6J4TtDRK<5hbkYee8Qr#TJZy@G+Kl*44d;8wY8Ea!3<I;z8Q
z!XwPwNL(7fGd{px%uwT34l6hYwfjq##c*CJ@dBsL+wG0x!F0GCHd2iK^qOjL&F;g-
zcF}Vw<1Dw!3e|<}UmuXMJ&+&A4|rPXG>We1EXMNZHmAX7NWU8M3|;RSK5orr9QyW=
zaZbSzHxFd%urm+V9*!_$(Kx`0?dwXKcG~}4ev@5CT#GOB_Q#UeS`WH<Tqfm<p1k6L
zrQ{QSkH(k!D5Lp<T#`hspG#>4Dq_zr+mbAw+G4tRe65N`yRR;`V~A~`uG?Q#qX<{1
zSbbrRQ~KGT%(Y5!SOW0r_oA&KQ8m|?;IekzI<l-C+hW-|K*AG<Ou9gz51q|H#6)aW
zlC6DikI*aimHeACGv}0rdZMgIXxHQj6=f*~IslK6%#S>dlp&g;lM9E;8o0itFWT4*
zf<cG;tP0l>)R`K!%NMd(&P^^V+g--mWWL2jWhwIbi~Jk>i!4_NZifOSu;4EgW=735
zI#ZyfG-;qg-`ElOvG*kOHYdw>7fq8s$26eHmIk^j>e}B2Svv>pijWoWy?-P_7cewZ
zTvyd#BC4eIN?Qw_+L`5Bp-S7&WTwguP836-CeTJ?nZ?-GM2@QRhlM{t^p164nWuum
zTYRF+g<cycJsUzr(dc3-9PiaO=@_d);W`pUY7`c+K5sMRWyz}NKFhma+~*1Q00ET`
za*+Z+V{>yeF{>@jTjuXjPYp{`BJawTCO2Y3;!De(sr{yM&Fp=6QtlbH3Phv@vk6qI
zaNht8DG<&<Yw^Sq&^r;9BF2yfKcZR%_*$KQU4mZ?uZP>p+E6osf|Ulm`G<G@t^>V(
zXmvth9Q61zMoWH#&jCCS5E16g_IRNF9y*E7ki$xlS@m?Wo(<05qr)3yk#y6q9d)xV
zun^HebwO#qxhY8|T0naX0L~D+hSpw3i<P)Ess;@<e!Lr7`;gSgagii#*jHFLkB&-N
z@jN5_eL0D^^-7a6hkmSvfSf)A;7F{(%t{oe@zZ0dMH%#qoz343DyybBaL|;kqzR@?
zGF9^k-7f;D*sP#AkLx;pt!>CBv!8%n@P^IFu#JtmL{t;z=Vw|^``g<lgnqOi^(omE
zpORY61`w5sVo+6DWhW;u$aq_KSlzy~LkG4F9icx6fdZenvd)`)%boG|j9C?je+_v3
z2NC*lGdd@7MQlL{b_=?&-R^5H*{Ap>x#W&3;bfRKJJLw45?x9*;1eOK+*j2gCx7Gq
zykHh#HQq2b&HUozj)mkv5(6}R`P#aDHYZ!FE&v0W2<ZODfJ^kYP!Th^ny_2@^eHm9
zSf&9oB0x`DS$!@-D?RT1A`${gP?Urj>UIF~&->?+WWO4i+0D>q7e8Fxmw{uu1yuJ0
zdt>*%9L8mvO;6>l?~uNKtpT9h20oXX@bFCeF;10_!bO^vPBb}Dt5!v*=clvb|3*@@
zfj}CUa1H)hx54nx&&{cOFgs4Al=|X*BTHP$Y@F+U(Dn9yOMrnjNsg+ogkjTsZz^ou
z-DJ4#w7Y{e9s`4sr?i0C&&qlXG()4v;GCJ6MzLLo{WVg9-re}QIARm<`PvruR(CN&
zxiA!ew>_Sd`)36?JPbPh`rhB%gtWy9zC&{!hj$_?N*1&@pIqiSm-;!p@9#<y^Negl
zJ-Szc%R)8dvCQ(I<>cT!jZC^g>R}~=WjQWGQ*}!LScf1Cu&X0Ru&&lpfd^h|YyVzn
z9yEzxgf#9T^@;E$a2%gT!oY3Z_?HvGLZkM7pE4%==l>cR7n}fuO=&jCYUc}FEGOLr
zA<w(Mo^Nb7*re;7=HbU0Wp6^IQJtK=F|!wr&JBM;RKEupc{n7g@}Oy+4N_#WA%9I-
z`sTVo*VAL)?bLpN&@0V=acLjOxm!Js_Qs^lk-HVX;a3SK`krslH=FvAt{Qd#rd{n)
z7upMa4z&84o8n?SXKt|r+|hTdDHz}FKTwo*xiWH;r>;ytmI`Y21PRMr**uYPdpM)j
zr7zt&V6I%3b}?}61!t^vyuf{FpNU9Zh?&XO;aZC_#P{!aVB*jmPaY5mXpqIak9+X@
z($pF!e)j!VL!eEMN~-J<oSG;l`N}z-c$iR2!Uiyh_KQ4zGZfwh5X!PMvl<`(*s#CD
zl>658SrZoh`|U_t6J<5AA!9I*%^&C9eUm<NDX!i32<{t^;vQwtcQtul)r8+=v7$?(
zl-0>tbqY^=fqRz?Kb%!ScY6VJ$Vus*<$Pyyz=$HArHoThHQOD__(N)mV>i=I_WdQ8
zSAx_+1Wr_SxE~;P8Vv4$-{T;1fPJ~hzMJCZ91WhF<fq{KLH5P<!6|Ko)-~uOP!@7^
zd^stMPhykVdrHBNCela-boY?t$?%<ggJ1AMFPJyUnU<P>nlCSd7u+Fr`ua>?kTp@1
zbtPdRYgB=ptC*Q71uD+__C?<Y!M}obgKr8pizC*B^g?mh=xuql7?urQX8wPu+q=75
zKOI?_Wok!ts}mNVMOhuRmo}QBGi}!UH1jG>dgw4P&M=I!irShfs{JP(+Br><fvMt7
z*)rTkEW}rj?8J^jhqqabPrj$S@a|L+)-_^|Nl<jUlQ!Jq!lDjB+xs7AztEz=5dI&<
zg*RP(1n|zIxj@yNcR2*4SxQ%G%=sGvFe*cCW4W|+jk$wzgOhWq<V9@XLR4@neApD$
z<nW-ktycfenc38D&|IJ<%&<(>6a;Ejpd25OmdP{bCm@B32lFj9X=wP0;&d?E21xxY
zKo8*dq0<1T$7RHI=5fu(qDXcAX2pyL-BRIT7!3eDz#T&FEYX-Jp_eUm5WV(HM!veF
z#xeh&cLt72Vyt0_ay%)Gb$u*Ej{42ztf%v`@)h~S&-jNDS_~%qgl(<Jo4?7}c;0y4
zNmraI2M9e%ye>SI-ZfagrGAi`OO-{D9a93UU5IGlI(}|%f2v@T^`12ci#6A~gmNX;
zr-w&M{Wfi3G1pP5htOW=JB5!afbZyG4lmJk7&~(4uzFT(A6p2+swet3A1w94_&)D3
zD@2A;EpW0s$P$Wa>4eA@dP8qYBDS_`=3qs;#;VrATLtD}Q)-oi<K4fqgPxhd=~jku
z91_``Ct?^=zt<>G%@|k)z$^}Psrf=ZM#u&OlLOIsTZ*2VNC>`g!;C&wbOa1}yPr4&
z3eP6ulaOORxLw0;d$FF0+cL*XPa|eJETnaJV$^2#L0ZEhE`A~WBn0l4rO&5T9%voC
z7H2$9IP95qgeRuijDX8cn5@I=Nj{Pj`;>b&fhD|3B|O=gpsw0FJJ>5^!W5}CJqKyW
zSu(G3tdoT^Cs}DP+Qu_2$SZgH$IxR$2Fh^-1r(+XHU9GT>8^Rw;Vjy?cMrPUD|G(k
zE#4zDHdc~W@OVC%hay@K65TB>*fkop%}n+SgEk(rQ)7|iUDdAoP&-`@9m(}PFWQ*K
zLea=2sF80eo@`|lAfI{h*jhGt8>eR|Lr=L-QD3Minw9}ltB$<>A!1r&#tD5a{F%lZ
zgaj=0IJE=~TK1IoD)|en;A3G8v!Syw4`=im3^HH!w_GQI{fmfHy%r(vJ}Kh96ft&U
zr%Yrh4<OOA)CPT%_Ff0=P3D8*&D}24D+sPh6Oha;a^6{x?Rx}9Nir`Y6e3*7e)XKQ
zOc?7nxTtKW3^vICyO2sVg*}8@_-2NL%5hxBby8s7y_(%f7#}o<_#GpkxV~a%7J0PT
zRj||Z*zqhlXt@{`5UT~Ob!jal?8Q;uX)P|u>`SBrcHX+QB>_5hyW5>FXhha7uMcxN
zMtx*nQotPSiBU`RZacgR#8`YbgWKt^*O>4k*YZ|qT0HY!9E93LHe!;+08|I0%s2do
z=0w0h-InqQdVtGTB;&qUw!T;NaMZZe^-rp39exm{MeM-7LG|OkgKt3*(53?<gd3{6
zW(u6V*92;loWhqvBFDiIg1Zu*eVP2%C7S4YYEBAnL~@gt?zaLF_|iVW4{|E}(&IjC
z@z;#3omkmLWz#UMcPsYH#0xRKX(!JsY7M<`E@ZKxY@9yO#f8MVi*0|aiahfssA!ka
zBYNJj0n-K#@0w~33zu;J6NIpN^{+3x3oGH*sfU}nyF5l(1Ig`>G8dujkBY=7dGcR~
zpu1E0xu+*g)6*P$m>kJ(>2WGWooaxa6~(o0bb3oNff-WT?9@QWZd!Y1QguHW?>g^c
zaB-UOTpVNci5J%lnlh4#+~6~38wlk^Jm_CrbmrD%?RYSj=$Ah&%PJ{7^5_N-S3qbi
z>YREI&H6Or)*z^&1WZrGY(%+Gn&BM;ohr8_?NLy#m_<`V5E^iCz5%(+<Ko5uF<N3u
zo-3iWYeMJZgngw~_?!^*;<{1v&MBT__aTgG%MRKHWOb+9i3VS>$CIecKKlpg*-D2x
z{>$3Ec;}d`NZY$O-@OwVmaWf_Pv&i@W;$h<X!<yt2Em-UU5rV2Jk)?EVv{#yC@AUo
zf3EIvuYvqTol04qWQ_L{NV%%X|1VGGkzVLtuI%aMYHD|{zC{4%I4!?swW>T%y~hTt
zXo#>JcP#(zNQ<aShq5Mc#p#?f>_2KFb2-jeqwzd5Y`s05sL-a*BITlGUpWvE9@bbX
z>VjzI=9VMtL$yigpmm;zm3rIMsV$H}|Ehqg=n%k54Jz3*#lbnux5T}kt|Twmt|)i?
zxHV9G8}X)xD{|%iZeh!Lw(tTzXa9^;!3OfuCVuy#f$xX;kxju4se;|DqsRMs`i}~0
zkYR`yCTVi|tyj<in2|BRkd(xG<CH!(F1z?U?z}XWtQ#r9oa9Jhw4py0O2EhAix~mJ
z)Yk3InKWqn&OSW)cqb<~r)pheOhGr210oOYgz~T?T`uQu`1%lBNYd4yADbpdU!umf
z@+7Ss=6h0pm+1rj_Aa>KgTix5Yxa8$K<#o71c@i4Dm+zFf(2T7mSDH(vO+nGqn?JJ
zezM2kuux%YsPood-|%#5<vJGivJ5-<ddl7q8IGwM>S5nT#xaOwQ&{3=l^+_0x5jl{
zTVXt~{99hv*2~8y*3_8FP2(?QJ?*HUO`T6qqRkw8-HK0J>zL!>wM96vh2MEW?xrTc
ze{l0U$hjm}%$xlSO5nm8+N=-s0TakDIV@M8?jM8Iazm&5rm<khf8LS=(6^q2j*if(
zgAzWj)rn$eaHP!;8!0j=+v;_er%XX$0bHk<bC+9Tt5>FckG(s)^fCp4g~R%^?-Z$1
z<jimgtM?~RE1l8<z0W*p?a(&B*kLy`L$4Rl)mfuq4q5&6+4aUm<bKF#HtJ5i!{oc{
zG?R~WzY<<4xMf@z8gfcoX~jc9h&Kz4j4soH8r>PaAGo<m4aoZquU#g?kLt#IFK{3$
z*E}^e+I(#UuptwAx;8<$U3{D`W_JLu585?hE$`7_?hlE(xBUkTEXY0)A{yo!BDh-Z
z8Mj^&y|&;D?WG0Wq0EV;{2(>%cmI-m>U-Nncg^^>%??5Mw@wEt7lya=%YxL?6A`3H
zhI?pET?G8R<aWLWDRW6(wg11{&wfznrpWS)TV;$Jo>$ins_X(Jp+6lZbt$RSn0+W5
zqFL&08Tc?w!;36_lW&P;$7!bTW3{`tr{vHzkzB+0mn>(lXCkuF5$z0**R1E5Iua*9
zx+@3vB<}wx6WKL-59p}9eQ71ht?KYtE)<67vRqzXU_m`B$Jfwk-RTm)@0g^5+pPsE
z>~v8!$F|v@t4xjjHy)o2z!;*cJX;ElMC_uI0g*l8OBY}woaG|bOa)Bc6B^{)xOq6W
z@+gNH)v^kHKE1`7a^UxO6XM0uC9atjKVk+{#Gp#z(BX=00~-^;Em5z<!#4nE8OTzM
zVs6EEi4Z2PYIfiuufB$k5TX)&t?2~Q4gm7@9UwpWB1d7Gh;8THR4yRYr6Sesr2h9S
z*5Nk|iem5{uYqDd=lj$4z*Kt?gBuQdE5l2nu9yOZr4Dq<WmF&wQiRy`D$o+jehLa4
zxg&K$EP0N$bs}IW*VY?x4&gZU<e71vn&Yr1PQHdHrvGtQvP3Q!S?bf!_<j_@(AE#h
zSord#2ADXg^>892*2Me0tk_nR8w##q^J|-7(_fL~K$+*nGQtDrW3BxDLhQrpyvlz2
z75!-P`$?X>P8!Y}qH=y>zncykWgWr74Th+P$sMLdL0;HD6JY>Euz%V|i$PED!Tlbs
zc}tecZNN%`=Z0JQaWg=h7M1v8Dvg~%M#u<kl)L@=zeTpn;I?}HD9{q97+R*<JTuH^
zdCEAQ0h>EOKpj)UN#YV=YFCnz;wsx-6;B(hKF@!e&7E;@P%vTLf|!)KV69b`LsO<%
z>@C}D%8?SCT(33pj(2(}j!Ul}GS}EA49`?mB6E(xrd6|@>mn8`hITcMrSBBLlQ)Lc
zmuVkz3LA&rqX=>UDAxWtDryOQ$(dFKd|MRN5n(=b#id6hc1J$P1R@tmY8~ySn_s#V
z=G5q5fh-gYwJCS$LZMI^mwU)wt)Cz?vu)8Z<p8$ew*`6z&bC2-6EOtzM5V`;9X4;6
zhEG*?jyk!C&}xfA)A9P%E}#X-ZNA5|2coi4!3@^V`1EK0W0KBovW*{MXFOOcx_rIq
zIL044LaINFwLj&{EKP9Q(ldFezEC&BDRMv!U~yqu!qHwmCf{?r(W`~V%V@tmdnisZ
z!?iZcr6C*cTk4bSr%%%Yxd`sRHFlRle|0VerM;Dvz$uX1>xo~e=Bp%&svEQFcI2?L
z<pE`^V(H!a$cFX7TojXg-v3^8H`WC4=aOokzx|hDnlDp!-EhTth-Up=FJ1j!&KRq>
zA~%}6+{ukN5@30VgMR%qJiMv69zK^pi^(ICU7WltwaYx7)Or}XXtG{n5VR1$%`sri
zP|&T^Dq!SUfcRT)xY-NbN!Nc$)wbqG5ZyA|y_dpk{+bcuy~Yk7IpS7V_PDD2mlnh$
zd~kPPJ<r)w2*x7DBP+P9@L-7jE9vvyWd*~;d`uo6X|n&IqN`8=Mh9AgxZKdGRt!~)
zvvl#(@pM(UZ?vlKhpStE+@I0F0g}5mIxM@|*gfuQ*vRfKn{csKexmjO%}S9vmO{xB
zo>%~$=z;08f#c_AJ*N<0o;}bj?}=T1^S*@RgJSDha%Ohp*0g-jd?0v3u~|l&!gn&R
zEs~(K=(S%CP?V&ew^L@3M*R|EfK^@H(~j~fCom?@Y`Y*UPiVasO*-ii@rFN;fc_q4
zfwVSs!Ds94NeE|d3kg;Glbo`7(!GIn%Ul!<%>D+9Wif^m{0$X2>nX<(%%M#V+%<tP
zcEz5RgpKYDJx<Ev`X3&k0JDvsD@ca@2X98!P(LQi_L5maQmQc47Q7y9X7G9^mg8Lv
zU{YowbUuEUIPa=~u_qV<GvG;QbENgNzgbk8B{3*E=AnuF&6+<4!oLlu=52|(sm5Pm
z#|z#R+>v*)<bdc|-e{Ib*4-%`b0-0`<RLgYRuCnV=Lhp50Xk9nafGa75f1IDE^#NJ
zS3{<XYIF`fFst;#!@zi)AN|V~v_t{%bhzuE44FbAeA0UA&|05VXtM>P=y_t;Gr2m3
z`PD0r%L$yJbSCt}FQF`lXgzCr?Nm=w4O^bXMtyB=C!Rclf`{t}`|z__4<iMbpe~WV
zohh}QA3gFkr+_K*Gp78O<shf|p~Q`tM|nHv$Sq0)3qv$%Bp$zS`yr?+JTCzebW)1m
zh^OJ>31nX;uxoV-x6jY|BMb55bn$6gq+%^bTOd%h9B0ph1;)078HaNw7pG&C#Ce<?
z66Ws_4v5=~=-FNeRf&v*nf`uKFum$B>;%q|mBPVY<3f4K)H-pZCSvUjF3m+0o_{<L
zl-SXjc>PJ(S=2e7;i_MTp#rKCnajEBuvIm^femExDnsawwkzZ)xQHA03@&sCuLngE
z`WyF7<~t!J?aj*=QUZ>YKxTFT?64QqQ`0|$oeY|b$kA%`*a0I$g$1*xgfX`>f^Kz1
z8Hx!IPiQE(8wV}>L-r4MO=DqGYL3^$Mh53PNZTTWk%<l=wmLj}90d)37$;ECEtp5H
zsW9b>>?lj;0eH(iCcUL1Z0C-nCh$?^#yf_{#wctqbP#udT&XE^r?i1ha^f!y+?DT*
zD~k;OSC*TafmIG#;ZgFv{;-P4N}69GGLbrMZ*wJWlh%=h<`Q+0rwH3TI5`g$F;Qql
z&PaM15G|=Pol@3pj;_z0nW*`c%rHAB)3(EY=foJO)(2SY!kUFSRjuSWmZak=?a04B
zx7FAxH9(T4`|IWY{9)KZtro(X>iL(jUNIsd_(+~ut0bh08*3}V{vDZMNQGQ(HvO`8
zk3{+PzX~R3mf9;DK31SZWX4;OYQo2OW+Xq%ipJeT5DI+9JlN#JScrlhEtShtR71$G
zSJ}yA3ouxw$El04ycp7wTLpplC}CVw!DOodxtp%)oqh1D^PRkYP(r@Yc)STI_-wNa
zRv33vZTN*6GUc>daHzeG&6q+GkntMsmr&ASrt1wcdvZ+RTafx#@Yo;zV143+tM*-a
zI#JC4XcF)YG6PY<*K}RPF?zw6Q9}&C``n#G!Vnx<sY~|%m9T&a?6i3_T1i4CV)Qmu
zD87c2u^&M1+;mg0ghH!ihoWTXXzWOb!Byq=1<wFHWKCwS^GEnfVUzY(;<l5LbwzX}
z3810(??b5&^*6#N=?1a`YF@Ls4q{&(QBwoG%V$|9{1vflW3~kBcfjF*pfbO;NJBuR
zyXk&h6X7T*Wj~u<n{_<XDvJ5YFOxPxZC!+fffe#82XA3qW^g)rSzd)_DVW6GwlVub
zRJ5Dd<_R4k%l)Xs(!COmz=Z@=N==BR4~19Q1%y1mT_QqDSA_Z9!yZ<fxJ;L2PP^go
z_S!jiC#ov?Z%L&K(i7<MfYk1|=~F&OexQ>cC7)4XGkTumy76si(n8t#3P`z{auYm&
zLJiF?d@VjOU2a3@Rqc$cw@VSm;4DxsuR+r191p@D2Al}G<%fXA#I&b5+azso<*Axw
z5O?<;Y00#b0^OAqVR<k9=~_Ot#RC&Ne)?IFII|1BTiD%4lWVx)RRR#%y6pWIxDEPW
z2B{(xHtD6XX8yYfh;m?_rXq&{Kygq>YWqQSKT<g|QrzGn_W_MW-;#GEeMumA?~C85
z!XLF(m(yYfA+3o<m-l%5v4)JT=gDm%gk}x#@Ar+Lc-T3AE^T7B4xn2(Es0+zfhmGB
zbHzK8G_<ES8hzopteRDYQv?$O>L(;|Dr(cPtiIr|$j*do6tL$KnGWlS+1f>DE7%bm
zdOYbk39ky<07XE$zh@Ju^a}4joX>lT%|sm-U5(E!S(Z>QuSZ>1&dum=ER5Y$361g&
zU@Gvn$o#*a${NJ2&3E=OwnnZ)x1k#k^SmZIc4z$Pa!b}p)K?{r;DVBiGf#3<%0=nE
zLFe5J)+!dq*{vX0#^*#=a=>>m4YKaj{jc#a#ehcr1h_kp;e+JUht$<lomYX0ew=tz
zH({2`ZO25nofMzqClIJsJ?l`T?>#CjWFK!e$6@aUD1|(y#{HX?+!Jq^N2rjfZDi)4
zVa<SKjU}60&z-n$T%7x#;#;6kLvNb1^CXBR!x3S#X#BW(A_f;^v_hWuL+|iaB!d(}
z$Pn?SiK&-IeBl!JTM_g-T(iDL+I1`{4L(5If36~T*f30pqB{j*m!RJeu;t1vFLi`w
z(<>37Fh37j+0*19yjC7tnS%CK#}i<{4&J)P0ciqI59YU)4Qdb*On1OHcTs+7*T|!7
zhRfIs9=4&XB@-hF&-AFP3-~;U9sl11l&5W5ltFs4e${<OwqvE%bjlt4+_q{fy_{Sh
zhZ4Y(V!7b!bHa<zJfI4H5rESkN9)&tq{!|IdF}$OXJ7bal#T7mLO~NCZAz(NQ8?qu
zkZ6*otKTQQPpR1g{rx@DaEhceeomdclEiqV@R;RGhPx(HtjX2>2PoY6I**Gyfm|S2
z))|@>Q_NMfjHCKoO@(1|0Y<Z??1ysHGzqm10BBZ(jOgKnZJe6@`JVELsm}p+jkEN`
zo;c76K6Sc`1tnC`tVK=skp56fp=6Z!e>P}+^f?@>*`X2LVJ1w>3-AQtfk|xsLgMY{
zlrn8|s@%Wxm*)@UbpsGjrngTcu8Ce8KIm!hd3`K8o>8sjZOyZ{Sf2j1q=j-u77IEF
zJoL<q`&?&vo?;iwbwiJ#T|wK0e5Lq!n`5Q!uB}GV{&AiIR=04WdXTDllD^L~Y}O*6
zlRvIYKyB(8g9}dKb#bjRH3U9g1Y*24<G5FZD+j@u4T6J$HOl0L>M!4Y($$Q<vXXhB
znQ0s)B}1GjJ+I{7`j}RP9e}l6FlNi1bzAqbAd~P`j*Run$#_3sWu`kJBnac;8n|k@
z(F@hGe>yC5K%1*Y0cS`6>BH|6qXbU>e{4pFaWO?~mIrGVXuRL*oya6mm_{T-`gdXT
zdj)ySi!wBYyKa{{>c(=`K57M<S*epo@M|u#UD>LhMd-?%I@yIzH?4<HgaEAd?4*d^
zFvT*pKXF$b9X2|o6tKJ=*6G4AXx1a_V)`DdQ%Q?NPL(J~QqoBEN7-{ti-B<j3@TGB
zxis?G=r)asjdGBtbM3|yyP4g^zNJ<~8rrF*5#Ukq@5h9ghhl*;`R13HVSCO-=5Itk
zq}zR~A3cDC5;Z8?g{V~ZbS@_0;)Er7rQjai8P9tWHbGS#MsI+CNd?Bzc()NTZPEWu
zyX=9|T8l_yAX^d4>>zph6Lp!CFHLs?+LF^OOnqH!ZZ$tzuimmM{Ph50Fqe}JLNrBY
zx&5*Fr7&^*q0~1EqY}BcyRb6OWS54#ufiN9d^N3Vb0*x{dD0o;%YBD@TBQ7<APV1q
zA&*8sciFgmh33>X++QP(>K6$Qz!G-kEu!IfN7)_s;7|TCrg8tPn+mmZS5;uBd*>*|
zur|hpsXDIgcr*A}h#q<twU^z?|HQL)-78D^rss&q+4rj@BV5h5dN4J{(yn7BdLKp8
z!gz~=jN>zV-5Ug?_99}dZg>&mNMffHW+%|@i`VljPl5ps@YgLFW@>d0>iWq<@7|jE
zK~|uPfZ~fY<(0Y!!45dJ^rJw>%8{^wv0E0`!<&Uvu`_CjIiA6!>@ErpG6`2<mX@}X
zQTC|E%b(6zQQ#v{^lD?D6ST@E@KF1X5{7Bt#5}eZl(<raX4`U?q~eOrvH-PCJx=5a
zWV+{h#fJe%LTWkDcluJ<fpBjXXp+Q5g(aG~<O1paIr{lF0z*PQT6QZUU(<k?>~h{-
zO9gv%L=$As!jQouL|Zo8CiiI+v6>0LA**L$zhS3SEcI99+3zunc}4+Y<#6~uFKZwv
zXukRVv2HaIiQz20m?}BJ$BwiZP^y(}r9mRTgBgV^nZ&AJqOs14jiqUJk_`vWysGLB
zP>e{BF~W5W76(pKnBzeCilM6~#6RjL1vawVyLkQGK9=`CaO9%vkYZwA3C*z<-<g`{
zuAJnsJ;;w&PrA*z$^rFCkal$6Uer<I&`_0?AL=5k(9T0HnkRQCLQ|G3h<Kq7^teEL
zjpS~TTC^-XC58RKG()GaUi9*~?AYX$7azs@ooY;MrBR!<z|P0*Y_8)FLcS_SA^?+j
zmmeIXAATEcg9`;|#=lu6nrcP`u!}gVht1QA)GF5rV5RM6+6Z^|6?H#_9s@@zg8|y*
z<_xb=I7v^koCZW>h8<v4Cwy~<1O;o%_nsTu6V4oH0j?9Ke-ZMepCg{gZ8~v!^u-ij
z=r&X+@W1;(dVXDFK#7ZRRHo49{&3XG0d4UGy~!>Qa&G?&TLk4N(k@07nD^{5={_)S
z0h6*=Qww<?@pCCsV0q&`9h-cP(;F_qIp5>vdQYa$7sFahlXLOrI4hc6oAq^Vd!%yk
z8UHb>5rNbRgnkEy@B+8UT_;v<f4Hi&4K-T<yj4)WDoS5T2_%NQZ7sgK!@M^T0nYMA
zM-hRQdZvjgXNbO3n@EjQ+H5ML1TO%C&ddT>xD^4vZGR``cRd1he_Vq-V27`n2_Sia
z{D>R=-tJBe^5rou(gC(UxNx29<F<IVTdgJs7SI}@c{gRY@X}20R(-jEJomyd^>X=X
zhT#oAU!U*ni`}T16(urXs#Cd{e}e2Z@F&53yjr5194kPqU6Kth)K7lW$pZJ4I%#pq
zw6C%8z6pZsVJehLlXr25hBRGXQbxau<w?`+4m#1esh_-xk{2E9MzJg$8NhCTMQ*;B
z^H}P<qA^N%-x*13Ni_InGrJG?1kC$A&0K~v=dU;zE}Lf_s142aj3gON8b#I7jbYI_
zIqu7cz*(a3=f(5))ussWRmPie#LDF6U<V)$mkmotMDt*CyMlA^#ESjRrOWWdt$qR#
zco<qksrk|zfRm{wDOn6F3+VE;luF+y5A90$7^h$BBX<*^Bi3N~->$XW!<z^h#8$*y
z)Bp5l_3311m`!*lQ#I}`<Cbl_0+e0Zr67hTf>k$NL71Vc@-5P@HS;lI3}HI7MFR~L
z2uE(u#nZ4Ibpyo!L}L0|=k%lULzS!GUA98zT}e=){T{jnUe%kkCEjoqk2i;_>rTLK
zv*k%T_4NY^>rK~Kw84sc@PA&%e%Q^kj2*mw{3|+B1;2#|hX&0~kn=rw1I+$55l9O+
zD*pz$07n_c1?Jbc3i)1`k-{rpIo-EmR~2R!kv$a7_}&Ff$3Di;C8PJFO{{>pd0#q(
z=A?JNIqUTR0d$Q^Ur}Wk0EMR!zioV2Q#xDrB}?>SKqb#_gp~y<V&FK&iFkbQ#GlBS
zr-D?>9fy-v7IP|MU$cn7x!06S<?H)wLZBpdr0G{NsueA@<wK?pYSj3n?rT(Oc17M&
zP_N)U%BJ8*f2sHq`hszpW{GufK_ecYxOL8{&<BC!sxg=N%O>Fac?VTJ;O4CL1i7((
zVMCgjx>;;a45K<r`j<0*5Q(73gys7p>~jR_+PHcd^C6~$Ti0FhIoRQXowH{IE}vU9
z_*UBEwyV`V<-J#DxRzBHTv$jNmcY3C4xokHJOFv8w2)pc6=C(!CR-0*!GpTi7<|Za
zFqo2%TU6+xB{5(82ern5ab9!`6buVj&&R{DIuilsMmjLd2hA7l^P9>8g8YXjR=~DB
zQn4mH*0Wr9d%e^{Mm4c=oZ|Pl!-JNgF!X~qAk@`CTpN{0#@&IHtX8yQhIhR`Q;}GJ
zc_~2*JBp`-cv&)+cp)zA)D7Y5TFLolWk6>$&uC9@d2DXjcW6FU01Jj{zfGsE`jElP
zqWn9KAu<j6)#pt+PiP|0n2$c~|JyeT+)9V0CCCNdPPAY>6tN#?W&W?Jf@0L{brrwO
zSS7y^$%rZl$YldCD%ET+v2NK;^cg1u$vFMa*t$F524jyzp$8D_lGcWYZlDofx=!AQ
z2fz<`y&>qlr{Swoikk-wO&en`9Nc}&0fUH$f5~ZXv;$ofapM`}AdM=T$UC&4pZ4W#
z2awwQG(2p-=~m#%`wp$OYirhfF^9+a-CN1Us$I<!2B(?-s3yV%h1jQ)<K4AF|B10$
z=2e3N1)6m-jC%I<tw$94p!brOHBLnsWMm@D373j=BY0hPL@?0|%rFHz{EeB)l2dSG
ztoe`0J#i)ED%CIrQ><}*cm3+rby9z+k65*#B<noNE=56rOW-EI>K?@x)PjJ*0(NCu
zpDt|Y*%5_z*f8`@@}`^K|35c-dD<i|A!uM4Xv(V1tUd7|2FC29QpTPzTWQ(yzD~oc
z3`Fx4LgIW@|Hm8HX<mXeuQ#)zj!Q-q{aryR_PlsSI@WE`z^tOT!ejfVe=RKKyyjAu
z>1El6`aKcoKQ<K3L{_jmNwk37&ocDmfzR(b)dxB;%9%-bZ;}1gnsMV`vT?*#xwun&
zPv6>Sz(~qCu87u*Jcg}gRxBg$GU{$Ui;+XL<(z78D3?xD3eZspB&OkvXn#_YB^41V
z-qZxA$$18t)eoJqBw@tpA;*_CsX3%JRdmB4^x_q*Q9J8sumYj=L=l7pS!ee-j6%)J
z%7rWnwJ7BdEECs<TAC2c#*2_b7XuX1vK*2R=F3Iy&lbGan_2vBKm|ODe@%yqW12cl
z4Cd6wHH-H6j!)#6V9tc520%cj=S$*@Q^%%_N1Q#ABky6Ms`<^_Ua*eYr)&TFO{tRQ
zBRdm;q?^C))Yqo6TR7FF5F{&?_mUF`_$~1q_ivUpfo}|;o(T-IStBU=Vof=%szfK^
zQYmSR(mog$Gcy5;`YSJX>m-p@0R(+%?&3`XzubS$_?Jt{QNm9|_mLztA9g}H^!>#!
zVH5wMyE?Y&8nI`Kb^92oaCE72O|mw!SjA%)^hr6olmmlABZ0fALStqw5#i<9WSeKN
zj?0=d1QY$K@n`wLDy0DgSG#<0qypF=`tL5TpL=kK0i&l>wUlSDStY`HF)K}rlK~z<
zAG_QkUgvL81^55C&3TEjcx`(?!eU6gmVxP<YuPbzUp*%;n}6Mbop`#XwtKEnTmD~Q
zHg-BI9`EQ7oB^ZL@>~_Hs{TJ}lI;=5jTt+)nkDh)za`oZLMsk_W_;Ed|0eM?unBT9
z>jXt7P&naN37V;2PC+^m+>@E*<T)Zqc?05hyWrQ+tYKAMZwxN&+|X`yg1@+WP<}^Q
zA9_LQ!opB$QbX!+c&DF{ojgO#8E&9C>T#7T`v!)!Rfvr^xRosjjbZ)b+1sa!HQ|Mj
zp_e_`wPp{~IFhb&@GIL*x87F)_{79ly(c%SGV<jMuP&#JAS0A=7F;viX|qPv<L9-d
zH`bunSx8R==(H@p4QAp#Ulj69yt`o8WSrPZb^A9iXHamNDOpohn#&%gJMP8Ygu)I0
zv|Z&UnVp|$C)RxK>@ze5r`(FQ!I~?xmpQZ#D3m|&>j2a`6indxEVY|8MR}{4wmwg5
zM1&=mBID`bvfF8yTv|c<jG>*v^Eaj2&9xt#X(Yh`4FNNYA0r4vF<&QENd#zi^tt~q
z8CA;ls7+mInP1cAIu0~GPH~AdNLU{+mz10R;XrE8QZFK7c$--h!|}t@*Xa9rhX##}
zIGAShVb7cF4AdcX5ek)U3Cc%_;r!2Uuoo3s7XWkj6@B3jes#_xnLfh&>C?AjmaJ*v
zPQiPr+|9<^aUu8eeGB0|M0$uMahdIEd|~rgSSIX@7BS_G#z6qB0VZ@t<#a@x7z<Oc
zIf7ky++;SjmrX;eIm$MVq}hY*$v%jni)h%))}9e_G@IX9PyAgs2}%ftQKTWPrzywN
zzgLQ@zSTg2X4#SEvZm^KDxk;>tm=Sj(&MfO;aYPtsI^OaJ0|C;>?ruihs+or-JrXB
zn<@}57aQAn)gC2F82~o;P3Pp)aoYfI^}`2PVvpfA|B_Qp!$4C>1<I;xy`d$FH1uOQ
z8=2+c`?LNZ@bzvS|A-T@{{sez>QYxZJC5#~fm62w#lNiU0p~OVFtcs&83So*2SNdR
zLE-w}Bh*U*?9+C;ZPOrcdS`CpSRytH9<-Y^B;>@;pNIX<(MKItULIQ7nQ)FAH+b}6
z`58J)ZJ$GyIZS~9zQN<6z;0|cdSzMB8@o4Z<vkJ=A0pvQf(U@Ww!tP0yP6Iat>3^l
z#7ZchDAh{TS>Ow%|L0T6c6^yE|9UJ;n{|U?m+a~{_Bar0*8xRu?JPKGG~25X@jp41
z0gKo2`1u@$suda^hq|#t7tdpAKOlpPQ0=lcMuzWW7lL=uQW%s7z8Frmj$tL<VuFZX
z?t(%)F*uuZv1mmHD1xBUewGIJ;%XQF<<I_8MRaPRjnF}@{CjH+631Oa^#5RIU9o7C
zox$c(Ff(ugWTd#6f4#$HjIu*<S>NT8jF+&$_lima+pfFn6!EGEG*3xkhHyAYIG-5Y
zx&5V0LFfY3Y4L*+Tk}FIdhvwcrj9#MUD=varuPk{a{{`@Kt-?fzeIw;A$T^Y`wd18
z94>2^4jD=-1NUrJwWGXg1TCh!teoEB33+<vVb%#JRh)ZUg{x<Eu<ok%;vX+@|KS{&
zU6QzEw%zjJU+``)RaE7H$XO%%K^QliT~3176Ad<UW)p58&Rl8lT1jBVM^w<SfObxP
zxAmNW;(o<OuT>_|0QNx798GL*p2ciUIDL>+0v|i01n37(0_w9N7;G^ky=(}xS=O3p
zcRpBJmQW{4QGJ5v9b}2<|0C#!n<z8wX2I0QbsH&!FMa$=3eu~CHOcX0)+EnY{U<Ln
zit#zG=F!^d-Knf3)i%TV;p;NYtr6s6(lq&uG>04gdIq~^=10}RPQ2J@wa<#mLV_<B
zJLNt-DsZ!mFbBEx`hN*3MldeYPTw3?#b{Lyqwux4UG5#2^}?%s&z*CPhq!zA?qOZ8
zx~cx&%58k~kw?JFht616kwu!9rS!QI4`t%3w1VgWE^ASipqE2@c#vHmj6O^xHnmik
z9N74Eo9V&pD9unfR=apMa>R!f{hClo=BL<`QyyRG7(~rA@<9#g!}(tvL_8ujISw&d
zzO;9+kWEVJ;U$oZ13h=cT;!Sqnl5u<0l2sG@W~lYpltd&=rTQs7ed=|Deub7eHT*@
zN!p=tQZ>u7nW%hlP<t-lx5}HD_q0~m+T$Q@Sz}H1CVj{rWp!7Qr_aqONVY8h7!`%n
z_i=J}NAf<reTJCud}EG4LyyGA{z6>{5`#FvTi^bLgmr|5lYgdGe^6O2RRvF^=~Eg#
zuDgQO?`_oDC6KV_%z4j7q1+L!e5(c^x}Vgsl|@o+3gcI5_hQGa4XUW@tB;tGJX`08
zW<6Y9?Wjn#Hi~MJVBz6<Y9?;7#tn~X^7Lv`7Jm;^c#F#hW1e13&wU$0Zc-Sd;<2DF
za}ELeaz75Px3W0qDA9V1M(|2O0kUu{GE&)82an4q+nuJ^oipmr<blRb0mQ1ZJYZbr
zkqFoHbWd26PBBOkKkYyby+-fJR~tNvnzgD^#cWf2FeH?iTML=hDA>tGhc&#-|J7Ft
z^qojF1!aohlU9n7oU?u(9}$95Ym`^41QI<*u8RHg?5-_LaXMFW&td$}h~rXNoDXfK
zx8&yHBih68FvB8>B|qff1^#aPWbSJ}V;K(7x=#7r&y!Gw0`{arcZeMK)YrL|J9_3c
zc?6(XHAGl<ujB3c5nUJJF4g~_(VqLZX$bTezZ5dkMSxE{?5m=|++m;%r6+P&klkT@
zr@uKtn!2m7uDCVWw-$u4*PuBO0-iEOYm$l0n+VdX#}{@Ru4CSS_Q;-uEk#Zhzg6^1
z)DK~MqF$4ZK}@gI(($c*W|q=~7^RK~lL*A+HS_bJ3hwuc6P}%5lil>7F*R;=2x`l0
zel!gMVG`1BLz^`7Bs%T2F5O8FJc|h?!>aD>ljvMjj=-tx@rl_T-74V0(+$}8bKC6#
ztAj$67W3Um$(~2X$zR%L3Q;JpAsTn#gGOLLdqA=-7-NaFNK2HLvaJ{J5<8;OM9YhC
zh6zmhTpy9y%PEQwJbzlpQ=LbCE*7kP2!Me_PuHF~7k_xh?zQg0B_zH#oU=_32(q&%
z%x^Ind#4%Ndzj3By{-RS__Zv97H%6+M`uG`n$9LLyy1%CA<()POB@FOWuX%2pOpzm
z<`2|Wx?|%%jRpViXCW>Zt@0i$gPojlh8APGO)>QgS%ViH+sB$0(89NMZ_tFebTP!-
zy+CuBwW8dxu(YP;vkd~Gh;?tl?jnav{9O!8xoZi-_NKaj9rBNgW&E`|%y{!Ro$&Q-
zH;|KusYAJPar7%PJ;F?L?Z4c!+ySI^u(?H5pYf-j6_cEtmv^8O&CFQva{1EF&NpEV
zB(QEHOGd>PYsXI<av|{_62M|||1W%qAw<}B`=%gJO809ZcBZWoLD``1<mpNyfZe`Q
z5~!!)np!-(i>N)nVB|`c!H*sN_HA*5QIfA;zqVplu+sQBRzumjvOJmr;0(MMN=aQ?
z-S+2EO;{9cwK@P;V=J}0DQmMt37N<E-<!(4swqxVbRusn8q^#B&5c7i26@U4S!v;9
z>3|r)s%Gv7BcsqiRab||q)^r-mm;2BvRe~&{{UDI$vG*V^ePBO!In_Ix1@EV@}NC-
z=CgujWab_C=q{$f&j)RCO>)rCIp|3iBxD_`atERsPx1)VG&cWmRiM$bw2JoAMtI%}
z=FiWU88=$u?J*Es#tSrxa`s{XG2rU}?{_gfh@Iw<rE|b@(4<_088=i$uGB8}@zWzx
z;Xpb(2=QzY0r9cz_Qlau-ZXHSUw!05TR_J#H{R4D?DHepPrBbUdR;pTVE2haMSeg{
z6r>E1lb7Y(ZMu6<@?KI^!y4gX50Y?*xO9E6oty<{a9^(msHt}CH67{dL{BeAKb+V=
z1eN<NwWH;>Vc4ZI?#Lp)9w4D`yc6UxTchX*lBcv5Np|;m$_#<o3eaeUbFO=qwGUC8
zo=Sf1(aR)1e#m9k$1&t^uXfT_MzT7hfS@j4$l(45QUh0g5d$3oW5)>-gI{$bR_Wkt
z2Q%@ocf9Kuz1O0!x}H^c;LL2@(}2Nca}gzmO?+{st}+I+dzTOW9ALn+KN!Re%vOO@
z(jm)C{Zv^kmF|O8!cSdDaUz8VR{Qo5OH-zxabqR-khAUNNDRMt+5+UpIt!ckCP5UJ
zdk%=pe;hP90-}5Uk+GEPMah!S016aR#o9zS-`MVgH)a}WEvW|}qTM)bwQbTX>fX*o
z1H!cE=paTrmKy8zota~v?bI_9uHxwVtLWiVBn<`bh;iw#n`vw?{X4MmCk+($0ykHc
z4}OQ&LnAg0v@BBI_nn^WIJk5FHt^Gc2E2ow(aW!j_71{<4Vg>|k0~sFKI68+!PKOM
z|AOt^M2{=oZUQ<a-x^|tP0o<9OJ=#z%fH9`<IKxo#6K-P)9cpMdnZ-N9{s`g)eik~
zhYNmwRbH?#*|W-9mtpy2>PjDs7gFXY*m!F|67@5=$!{pjt`2UexS1gAm9Q-`vC7@p
z?f=YF1`2JT@6vl$Ch;)7V`X|xs{b$WJoy}yBNy^ri-4U#me1MV@|<?oWIPb%xm+8>
zxHkbCC4pYLTsJuxQ6pA&gI!nY#MyBEP2+nVdxCkeRf!M!ArX?MCHDTQF-otA;WTHx
z&mnvV;8HRdZ|i8X(@%CLi8so=T9j>J^h77O^Ekix<~nt2NP*F3PlG^pWlc;oJFiA1
z+`-l)H?vY%R9FxfIJjMC24gu&XO{YX8yRNE$-|q_PGjfofDQ$lo5)<cp6Bg*<rUd>
zi!<##z3g8v7Z;HE9!b8V0=#i&xTdn_;FOsaP{csB3H2JOJtn*T$&iRRLB=a-he(%u
zR<(w#JG8$lZmA@&UKDm$40M*O3pwVV{q#0wlg+ZRS#8yuQz6MR^sEWWI~XUwzyMfM
zmKgX2M?sm{Lue1P8T7YD`+`Wk_~YL{Nw-8Io2S|F@<31Hl|CMfHJl+)+A|eud1kF#
zb}gnx8;iw)-dIyuhD!ZideLyWy=pUQt$ZlsaC+RszW{0xN;K=oQyH7<`xT1%FXJE%
zXF|p<X7TUD9&tSs2HZ&||Az>K^y+2B&U17sq{jK@(tz2%5hR>_=){5UvDei)HAAkK
zI3VFc2B2H%;&)i9x+Tz49fRI|M-$V?g@tky10$B$yX4zujyTMJ5h8yM5eSe1_Mn9Z
zr*fBh*E-xUB!mqosykWGlqFoy^zYOOF;&V)!aw%A3U@J+H8@=|i=s+KV_(%vdwQjg
zZ6&q6=-KK8*SVe9Vr^4pp21XRvq@0&kA8XOxV15hx>71+97>K5H*&q;r*M(p7gw$t
z#B)0WG;!2(J~>dFWqBBAsb(K(J22i0p&ye)GS2(tw)OnYHhHth3QF6&TJ$~Ju^`Rj
zPM0OLRuy~q@G}$G%0B*kkEmtCfMwqkzMzmTR#6-5V*|xeHJ#c@#Apqxdsr><@2YZa
zb|$;XegRKTbJLsmxpcuBq@wUayd0|OM1t#<A-qA|22NH~xK##zSB>XVZKqy2q#97m
zK<s%{#8ls)1@>Ba@TAzbzkSZ*WsWqqbDc}53AV?Jbe}YAein44S34ssmpa7yoN)v4
zn%A8z;!O^>`rdx<suYLvI2?L`Wag~vFtsY5X%1XLqzjLzqG$MOI5H>%O-hZ!trS`|
z4A5fz|6e;swfh>opoFI#hk~ZZ&OA4(-;@6}KT?>4Lt<<;C9s`TD#xB7RTzK{F=B5P
zG~RTeoa&x*5b>S8f;o@fV-BxB!TFg!0PB2L6FA!4`)q=UWB*wl5uk2oi1Gzo5gLn)
zVBJ!;)D$<Qwi;*-Or2@L*>=#PV=|CP>fR>%wR&zF!LZF^hxVwZ$CZrIGIbr&x#(97
ztw-+K*vx1}rkCJ#wAE+aP(DfI4hh9n*D8c<ddmcO_(szymvcN@O)ETodg$8zIw>#&
zUd|7F&F`B<OhM7$v;-cvhE%97OPlc>DS?}uIJVFMEd*(f`j~S<OKWcT-w@Dm)@Kxl
z{6b;{VC;DWG?=zIVTmf&PG-In#WsE&<G#^EAb@!oEg-<Q1(__ndgS3%&9l>%;+es1
z9{0Q0Y6YMEY>Q`<Yy9$B$peUr5N=ad>kYF0pr^A`wRCNwxv2sXm9}0FB+XmdWJ!Rb
zt`_R?8#wEN0=&#WS9Jb)4CxL@PYE3t)nUZOr);CPF5LWxl}RlrU?3^qfp60>y6IGe
z@VpE4u!7K&I2Z=xgZEFhKMQzV=-Lm~V;O_ofC(SL2Abg)#9@5R8I4-;2Hx@H1UO?L
zm3cpzd;G-hI0cMGrDsI`2?4^#68m9-eQ09<$BnqASu%y;tU7W6tk)wlYRC+38cEUG
zEeCEu-h|w$9D~JbwhX)Z(O3j}y}>w%T(XH!@w@X|jF46fh&~ESTu*mFSPM41i=G0g
z1;*3#J6-N`uu%opsW5g37N8|E1?86uv{3Yekb5lNa^Ct8aDu}pzf)l%bWLo28RKXM
z8f6x=r2wjA#+$0gs+(xJ6Q-NrPduY7k7rtl2g0+;6m^Mot<F?Q9Khj}E<l`ln->|T
z*u|;n<g`E9-?}xQtMb5C0V(hcdXr};<5^de_HB3@DKWuo3|P8#p3L*=rZLmR{{1f+
zMc)ttJ&N4ez#ZrnQO(xMy59>A+kD2D+1a0HXw91=GJa+$_N))S4FYTMfA95vOUo9H
z=%Z~NCm`f{q#T$p7_sR1k9Tg<6yKISew$m$$XJt5B_irb4)n!7Bj?NO?@{h9LlC;o
z1Vs=4CovXo;&x0QA{)$Rp9*JMACQ5q-;?u=(GL6fX@bw`90+}}ESQrd^0!VR8)=f3
zBR{5fT-n*i6s|y{KYQ{2hby!^v9YfgjadJ=e@l*c9QJjF63&=bUc90+I3&oiqj&=u
zoCEM<^gH?mK|yf|chvqP=HYOAL(BI$qgM$Xp@0Mw+%B}x{UEDcm!DJP%J)nj1QP`~
zAXENXah0hRx+xwdqEc}S{iZgO(4F2_dr*go6HX4FHnCZ06WBlP;1~3GlHobo8&cNr
zn+QzneHmqy=ET!~u&gmrTEqv`NY>E8sA$G@j2yIZ3hyXGfA_~HclPJg^N=Cx{c`Ub
zE~2u028YujRSNV9N>3>+wB8U@fPjV!OL>pP+l$YzXl)vgmq(Ux(1)e~aB~EOuas|X
z(5nalF0!s1ou$p#8_aSmbrx|^Eq$1Wt&;engA)sh%#*snv{)+-h3B!C*}{G-ztkjW
zpt?|bk`gY)R;XlFR!Q)tH-ia2uqt*8-+iU*1(q`p93oMV!x>Y<rp<?^aaf2=In9vJ
z@>coYu~{`&A|UaHi(#EOABT;)Feb}T{{!zdRoZcU<@&@q@W2mnNAD;`UUWUi`EGze
zKz+$qqWte-<wFg(=EVr1=w@xMZWQ9B$Xq3+dV|h3{k*~)dz*dz(V>ict%PTQiHTKG
zPRfY%YU9>_hB~R8U2H_Z;$W|Wl-7@V*gR&L?92`%H8!E0bcU+@SF*Hc;#Kr(#Q8G*
zq>91El8cTUnI2#hZ=;P$0*|>(98EdhOxTSk!{DrKvg7ytm*lv>2br1fa?hdoPXO<2
z^^YGEqC4?Rpw;Y7FXGX9$O`*bRM*prqHrOpTU+sxkOtn;{$%%N(719OjyD84f$yAu
zJ)DuS<L`}B)OpT5v<{4)ug6sJH?~P?HSbeYql%K-=tUH05Q<&g#z55{kF@ZZ$))b&
zijgh`Bt5?Q-|RgbbejTk?G=+f08gw2=w0&}-@md*VaFP}Un>;2<Ce)_L)T<~9*}Iw
zmUTGA{?nfKN`QrHiw+62B~oGOB@IJPX`GgaD07mnmS>F{vow{)noHgVZr8|s<i~!e
z^IFC`g6HI4k-yH>zuP2k$|M|BP7O*QAPpg*MZAA%v2bnYX618O1;i|T$5{}Fr(@Fg
zhU+<jQ<VP#_Kt*u&NTN;@B*YoDaCKFu202uD6UJFKEH_unTen!4lCEKex3Qb69(g$
zr=#|4)!{mN9dK0x5rZ6A5aCRM5~w}`*Y$1x*DkgW8Q{fum*ocNp+uP<`%rmA;ojE~
z4EvxapqdVz_;;9vP%Ysmb^|!$eC`>5=1T1`y}}FwDU9J~nl{yB|L=lH1G+LNIjTfP
zau$se?dy_xXkGj}1=J7DKe`nILl3`w3n$L=-H50cz_N!$!N3^JDYhGKQ4tu2W@Qh^
zaCoC{ksTF&Ek{o*9{TA@khEy!g|zl3n)A7}u)#tFDD_wWJUmgRk*j<32V4kfsr3nZ
z)Jp=Br0!n8pqhnN*f8iVVp5B%ySB>L<+x~UVL4xlT==|+wk4mFz#t4;8m#P0!J$i9
z{ZgX<r3kVR|ILJx1XV0B+O7(v#n7K$j4g$;Qt^$fKjy93$#mRX@7liPMXj*68Mr;N
zE8}H}wYx?xyDlD1{-+vfgn)lBEfua)6So6lv=x(wrybo(d923GG?5Vif<BB=p9JKb
zVFrlR+DGApq8j%rJpz<Gs}@7*XREb<tbcUsL0i*HNx1nJub{F9%e-B|L4y#HaIeiL
z?=UN)OD6r)O=$IRDygVxi&<=P>s5bMe@U0)z=ZJChz4m@fS*)Yh}Q1K-q3-fn@7?Q
zcX}n2$xQ{DE)G)FRk6I5;~X)*`<519Xw&F94yPF~!0zHqpUgCY3^XS#(OM!^W~Y2f
zUG4050KUX=Ti@LnT{m3SUMUnSRhtE~Dh)t^YS}$icG%SCpOD8A|B|W}64eRE(bS0M
z!<h3=sw9NL>=IbSz=`pl8SW}0^??%XvMossC3?0CyG&PL2bL7~qfw!ZUf7sq|JY3X
z`}f2ZuGg`$9D63<GRE0Dyi*TO_c%k>3|`KcGHfZU>q_g`OExs%&ul<!>aUkRU!}jV
zSKuShVY%>s5(5CaxsDxm;P85j+7G?L5#~H=v%RR?jl%eFs&(IP+_l7VK96gBUygl%
zFEfh0x_x;eszyxU3wydTen_NpovGduLyZR$2n7{U+FGM%?CN+{4_)F}yBj<E4hPSP
z>)vVH^}20w-Eujmr+SS4zb}ZSP%V#zBoH4Y9moJL5lJTwvTns4(Al>e*9$<b^U9bB
znRWu#^FT9wGuV67P@v(t5UBTxo?Ly<Y>n1qzIf1DO^3KB3N_xkD0kgs>bHQ6x!i>-
z5Cr1h?TV3MF$Nnq!C@GTeTs`7r3`qCr9A#PuD{;KxPs)W*ka1y20$(Y-Fzgi2#ncY
zk5c&c20iX3I%+Nxf1apEFbG1!<v$Dn=~cEfl;yrM%DBnoRZv)wXmMA?v?8Gm`deH6
z#sXR0V5ZkV@+4ttvyE=bI)iROFx$0_R&nFA&8G(%gPU{#=--4uW<mYiZ$6Qy*p~CA
z>BTqOB{v_3<$=8#Yjy^d)aZ6%PauTL_8j2<n`tvrA>y1`;%N%8$s|K?`V<&Jevs>L
zc(0NUe=?|=#h>n$!e+0HQ>d8ND%)x5d~QV1p@(lcEh+v8f=9wn<2dbIR&E{?9DmFf
zF3S0HJm*;37$h;-4K)f)#MW3aW(*D4F88JeZ(VRYLfgcZMds($=Gua*p<8C>C>ca!
z)cK}XLN_gc^j0ReS0+%yI&)&lOG;%5AMUuhfMG`{yHYqb%k3!)1o2y1{11a8PqYP{
zHY)ZCAyMX0#_;1IEuas5Fxk$gjXt#SRXM{Rs;}H6XKRmOOqx@mxJrBq`$C0wWg=gA
z{I1a{2&4_QuTe(?lI9NyZwV;s-0TwPBbi?KmymQl!2{G<-#uS@OlabZ-5($BN$y+H
zj~P{8OJQsR74#gzdq!e0gm?IqLBygv-@neMMsC+$SSy=fxA|s^Ls`7*28oltG$_n%
z9&G}qYCV=)pd%3%IyH||<g{;N=52pP<(O&Bp|@>wXor@?ls*_#<7&{Ro~5B#6}Z}A
zzGG_XLliL`44Ub>UE;Kc<Sp=O<J1%L@EPu_h^H`M!c)U@z&5kgR;2Q<&*%@a$G`hb
zZa=BNiYld=GyB~Vnl+mL<p{uij230AINkD<hjQlodKYe~4~az3B;?UOl3m}&4@2>D
zqc~Qs<DBh_m<Y3IJ|h&+e!1g&&ha9`_-2%##!aa-!61z<yhPmDI#4c>Z%vFCp;_@_
zY7+$?=}bsc@QY2~6~=g=ahabpZjXvi&NP<Glr%2A(lgmkZuIp?s$i_kbBPvJ7T@&9
zE*ZLPLs4%oBiwRIiOY>RI`&l|2+`6|!h{yPQ=i%@>d`lmaIdQck&&ULEzCl$^kU4V
zM*3>`HVAw{r%N5&r#cyRdup4e9Uu@Z=8kJi_f58!5bqW&N1Ozb))N6pnJ3ExjJHgJ
zP?SCT1wjcZfbITzCG&LwFbQyB{46wRc_#Xd7{iBhzdj@R&nsI(v2V7tyX1A^$&zcn
zFbU^TY_{&l*CTIYDqpM%KfO@I5W9;IFv31?uQDwGki6n5D)c?m)fn-Mmemh?L3HP)
z<2Sz_UC{>l1R>(eJwG>}04+VSR%4*DmMk+N7*8jw?|(t<Pnf^1xzR}|{ciFc4b%m4
z^wlfSo1}c{2oU<yKq#o$SRVt;Y#a!NvCTtFa+FKjc<!(h1e39sQqEYSC$*Z>KM&lK
z2$R^Xnzd}@Ac<_Ai49Uoi7px}TaY}r2g+?mx=IZ`x&A4Sfvmvr8vxtWphwdKWt3?k
zFIl?XdsfN%Q6j?oYX(V8sa||WE3DFpe$cU~ug78^`T>7n*J%ql<;dvdyqARQk_kxZ
z^xn<xJRbe?X^+;B>S=TLRMUdLn_^RToB?J>9Aspn7EUnsg!R53S3UqBjq|MmR}hlR
z_(=GL1ejS^4_nldcIjpa*rhiBUHCr6<ENNyeKov#KYap7U1~384~L+fbkyJob?!AR
zY5u{w-x?O}2bAu{2(`UcmwXfC(H0x~rFjqz3Gb({G6E4Be$*GgwPhc>%5H^tSR8&9
zVvm$~>59DZH7-8Gqy*Dnn)N^Gw63dK)zv7dCj2z7<o5@h+yU<J3c#cA16i3Xyrv%{
zAT(UO+#JG?RCopT?K$A`&&<gVCM!QFLf4wRxFhjwH9Ou0&H)RFRA!5=vCh3WW#;5f
z7yAx0^-&mjEN*w+eYnpHYZUo)ID(|F>2pbXqL;DmaiXPez78nmvs$;lqOMv}@67BH
zNluwakb+qt)IHeJVi*v0WMI4s89z5f{LXF;OF(o}Vs;7WOAvwx(_wYVpzf2$m1zky
zdkgLPojoB}-i>nrVP2T`e%M};Y+SSS78cNXuyA|Pb4LO!xm3sHQMFv@779mgHYsm1
z_c9dhRtk9`uu*r&?YXEkZh+g8a2I1Om<GvxdpdFgqM6pjAH`&f+AEgkHcC)CQfae$
zx^tfM8ojRw=x_1Yc8mR&afWbf>UeC;?QWCfu1j|V6kWikij$`sc`dvdC3P@EFk+Pu
z_;H(J?ggniuXX5eC!=<QndZ8>1x#KI@gH?qG}%joOn(lSi9XAZ$=i=f?INebS1O(Y
z)g*7^<<O3)7G2<QP%nLmqgkUARbp>Nexwos%n?j#U1rOZG{wn7F3t}3xR9W`j9}q>
zP4CWfJ)mEp@TGaeP(&g@4Zx({X21tblTdw*u7I7sKQYoxq#VFp3qM@oCKl0wda(xW
ztu}5mMW^t>A=ts3SobAkL&^2Z)6Q+wesUoNyU=VbolG>up{~V*voCp|>BvR1TEbFx
zEXlIvlJzX;H&_tQjn%IplM0meGJgovMIzY(i~io#e`5DrdY|e*dsn8{qD^d#Mhr#9
zC1`{VU{9-=54Ze52WSiW${N&k(sS{qz|l&syFDscy=gt`Th+iVp9m;9gSK+gIGTpf
zLyg~9&j~4xPQzEQuz4Rb7zbT2I0vKqp_SnTa{RHK>3;?{TX1F+(rOeA^{}uaIddfh
zMTT?_xp6?0X9t3QLO2S^4NaswWjY|pOCszRo^&^*#}Fzir$Ry3O++t4zlr-g{(A6&
zaWz9yqLLx0$JNZjFmGgFq>Hy3os=JAmzewFVg)DYZ&r^#z&v_eDY>|AIhjPerbJH{
ziz3G8!r7x2M4$)FNZUTQY-Jj&iun%&kDL80FQ6fF;7Z@4kZ2W?joeQ55ShzpoqQ<}
z@I+Jl>m(#`XAgc8F`j0nMLFd>tm`<LQiA|)+Lb)cbdNZ{x-VOSLj?Vb?w@gnV%xM6
zm(LFk?i#Ev=d705IXSbKvZJ+pA=;$%q{bow_ByimE3LO<mhu4x<-gvZ)mDWYc4E8h
zV%B(b7Mqi0Y)5s`r~e0c(wuR&j~*l!5HKyl?gMtPx+;l%`6(+i-Pz|wVWg-Sd{Ws!
z(F7+aanIzq);`g($I31jQE~C>v4GB83ch*6QtK~|p(iAKb{9-WL3TV-^WYlGdXg=N
z<lmxPqd&##;#7|ipN_1tLIy)5`UYSIFg@5wZN^dsq@I$nnsAHA<NS2!S=*2e@t-$T
zoG=Ljw<Pl>{|?HPmuZ6cPm#p`G&Jjo%#8Hpypahxw8tce?k^#<74k&*f37@r9;P>g
zcr(LE1cw)dpXMKMt@F2s-66gyaow3sJ@Y==3);4K51ii}(}U{b($=fV%^CRVU1UdW
zO+<WJ5t#Pe@4@vpr<17Wb4W~^;LK@bO3nsg3a)@P{v~``>e*6X34vR6u~@JpSE%3k
zP6!I`wGFo-`T%`dySSg{BB?Q!KyQ?1x&MUz_|Q=}R=Bd}kuO<z3yIV<P;VfYGzANk
z>+Ng6bYG)+?L+7zv#`bphXxuMAJs@-<XR0mR|g~D0MqSUbM&W}?o@?+Lp&nAy2f!J
z)bU;wwig)33c=(BRMa$)r2G>K`D!S??5nfDNv}%`Upfe-3pNn)*mDuaB-M3h4w|JL
zu@ZX;e;<zJHD$+d$7G<MfS)=&0n;{IB{r<0qk8DcPp5`S_GegOyAI3r&W|rKqxo!5
zCiK_t3%gS4hF5^`w8<wKS<U8&=uqbv>wQdNytsM8XzRVux|h#xA2-ZC(}S3fkwrHF
z*?^p}<_XfvJ`%9=C@>jW%P%Uec>}eNk2qghgH=;F|J;jO)h@I1oV=y}>%b!%8kehf
zG53Ui@R#5&Q}tpooI_KFJ}in8Yi8uOSf(2#41YVPCm`FUPU475L)fI^N@M}{B)Unv
z(HdtbuT6Yj!j7)vg>rg?n>RBn<2KprPGvq``WMquG!J;X$=<QdJOgG%Y*!1HaY8Iw
zMH;~I={JOXXI#Z@jj~#rkS%X|w#EzNEfE`{I?c%GMD!#meAvpw&v@#H35ytXbNt+o
zLy}cB%I6fO_~I{#WO6H^JD-^d>`hTQ@Ag&5U<AC6H`M#FEmwB;+GoqX*p_RMqM4nU
z0@9;m!44}?3k?y}4QhGnIt1A$UHen$!<XW+%o|F|s6S?Gk}KM=tRo(b+*_Tq5dqSp
z!CA4Yd2dQiMm<f^OG)nqiSECL)0zdzEXj@)4`uMixF*_yUtOdZo?FJiQnzBRS)xk=
zb@Y`VAc97I)|Pi?gMunolFKAZ>~E4hKF^AX8TC)KkZUD9P|JZ>iYMOk>iEN1!*`@`
znDO)w{)fnG=m4GC$ViLs${cF0TxnOL+H4`S*H;2B9PkO%;1-9bSwkom<_4|awO2p=
zva|d;ru6**A$?&bqzmFKY2Y&h&J}{vcOaypAB4vWAb$zESFfwij%AG`0e0-;HRcON
z`jZ?-JcpK23QdeoB{Hpw@k`O%+wkiN6Jka1@%3g($DCSKdH2u%;rg=_kpFXc3gw!G
zRC6|BGL~|<8jQRn8#ptC2^@>2MC2Xdz7<7B3ORwXZ2sJX!KByzfKBa3??Foi=95vb
z_eoRyPW)u{@~U!fK5dMJnrJ#Mx~cVkZ`muf3LFR2+XT6Bk|^U<{jA#u8kZ{`mIQqW
zf8CsRlp*PGk#bF8^UQv)u6JPVLYs%pD!@F~l_uX94b`yE*LfiP@^JJ}u37Q(l|wYF
z+~;P7gKaAq0@Kke^N*(>sbfhb6k;Cv#HAZO$aDo5hx!a`vD3^&(mAU}#1^N+mla9A
zx1MigJ-hVF$W#1miXpC68U;m3S$^YG3(n_mDj@BiDqnHkPeDdftN8}D+QDVu8?x3c
z2I0$uP)^<!i=bl3vA%HH#pc|FkbvmmbzxLzw+rjKO%8@+RqA3~jI?P$H@xY}y>vS<
zHZ$Q151_I+o801!MxZi8g&|sIXKsfgVz=deNbysVRiL-Cy!56G!xU#;#zIi~)0yn`
z`~^4=;THs~?W<7b-RTVn9WaAaiL+c4)v($LHJsy^`1QVAqd2M!pCVQ060l!yYk`_#
z{7!?+t<nD#8GORJ2;93qTzq5e<KQW)jtB*+r0=utr*#@$@lfH%!W>QKfS0x`<+!A#
zql5lJ-(imt&<hx6wJnu|q4i*4i4)nP`!>$sH|Zn!u~f29S~Mk%B1!cDsrCp_CFtvk
zT3Q9FGDip34Cw^`G)^eXQO($r_Fq>@OG@U>)Vj$}_z`sPuLMNWz5ysx;E&HY3PL3_
zTevqvszNxW(oXqM9R~fVKqRmf2!i-G9=G|?-ffr{iDi|9k`!H{NVA&u;u?J>1rEaL
z8&HDgcWi)Q@*x?%!WH;Bznp|UPNk>8#3T)|LrhGtu+Hr)rMUs%&@<g8NPTPKC|3_e
z{Ch4|fblqXFq_AIWO<}{Zq>y!>aqhz%KcM#d#jDfkY`>FM_^~3N@rr~eRx|5m_d&5
z4SJ|_b;3Soqnl=Yf#rBo(HCr-R;jU^x4B;yj)wpY=r9<aURs8432BlA+BKybU-j{4
z(O|hTl-a4y{OeT}$Bxwofo)DAcmfZWg0*25W8d)Q4Y5r=i}kAle)$0bo$CBH!AdW|
zR4Zml6}>p$3+P#n12Fi}Zm-fcqQHp28O2K6;TDuYvVui|&GIG+sjlU41&*d^dkYfC
zdd$Ai2xh`K=rZrw{xhB({%gFU;wvqVx!^K?^Q7}kot=Ampg6JfzW*ie^P!=;rjv2l
zcM4lYcy^IZPy#=2Fo<NR-P)R%bx^kO1gQ1@(Ij^aZAp-X6h4A6NV+be)zH&npP%jW
z-|;tY-bH51&&a-KKVoAGs7Ryr+U>khV7%+_B*i*@^N)TSa45EVG*0K*UFY#x?JA-4
z!fw<1?H*6SV#%x_3pJ2cH+q9@G514eN8{DERMUjp66s4*z;McHjO1<_V=JB9OmknM
zdyq(0uF+&qpoiNCK^jkOFKq|90kbE9k18sIEp+790IU!CF;x)@;<nd+onOzEr)BHl
zfBa615Mc6;)&B?zcGAiY@%{~ZOy1CSPdI#QawE*9=w5jKP|QNecHwK?h0v-SjSphm
zvmuy+-5N<0A-xwOsIc25W>iVm!*&d6HoJM;gN$5#_HRWK=+fyo9KAOvgt>ocx;Gr1
zjS%Tn&M$-v+{u}QH{$GA!0ge|iQrIVB*muqb8l&HsVa1-!y@1!7#)(Z1k7aHX2Y@E
zC%Q*l$KTL@P%Rwba-VQtyI3>4Nz_%fP&~9Fod<vQe{=iIBYkk1$C2?1QK<=V=~h$%
zaJQggJiZ0P_Lz-)4l8j4#S+nxH%BE1!A=w3#T^*PL#xOM*K#VaXi4P|wqM>F^-9c9
zzKGMi8?Dt0b$4q_52v!2q0J($|BI8m*j}7WJ1E#xnYQ~ff$OAJzM93GUS?+>2WlS~
zGP2DrAwao_)r4dzVLj}=e+Pp&7hn-<dMeWfQ_DsUrUEYOjR{_%0ImeTF?-+$*CAf=
zjKTH;Bt(*#E7@;Qi4TM5PrDRg<53i<sPOJG7?G_J1AEN=Pb(rjZ$|4J))gk0IuhUx
z63567(xjd)g9R?I!avfR2<|bM)B(s83`iI-1(Kk6EU+nRWz7_vU$ed3+KFm`B|eN4
zT7ORD1_Hf#|J+vkpC7t6h>l#0TcRn2#}F=HDqc*nM*UHb&Tii5AdF-+faf7M96XQ7
zd^I021!XP@D)7G@M>X6P*uHTUJr5uOVaJTN17hxi=exrXidCj$$uGO;;5}CGpq3J*
zS0!2YxY<j=w<V%<1R%G2C~64@J2~I?{I2CJk719N#2n~ZAiM^*8rEVqPgq`7`FGQL
zhH_UW&jsC)qQR}SrU<BR{<AC~pdcza<!HDt;~y(alfzoROb3gx2aJmRq%se6GZvA5
z$59AOHxx+ow09$zeYWnFMr&3WiV(VRCU@Ansxiz4wq7_Bd|y4PqWct;8&@x~XJeKM
zO@8(|3j|+h-xrj`e{fajxD)bK&jB5fff>_-zSJLJ5ddsL{`}79r5&3mc{M~1&e4T!
zYm*&Rdk1Mf@ANsrakB8pAo|o$jc$C1Dd5&=y;;UBa>)JlC}XlXv{Q=co8gjtnbhCt
z4NO0lyF-4qN;S8PyeO>Vm#k@T{{6(zI3|h|gWn9aa*N{k$0-RTjvx(B{+dEByEw#L
z+gcd%7P?=Uh}X`dV$z?|DQg?khYgOmv825v{;|&xR(f+H=@JA$KT&kUBlK!1Fo<f<
zI5}$=y=#v}YTs))NxS64DM^3DU3=9He%pEdlA15=?MeVqK(4<`TgmSDyl=8NGq}*V
zSqaDrriZ+qPt$@+VS<-d-QWsG((0(2QRy0zcc#}q&o=WAv<l^ScX_gS$M2Fgj#Dsc
zg6T1=s85v`Z2-ZjsUeqb@r{C1L;i*V)+p!}2KxKgdiB2HYeAouQ$4ZV6XfvC{cy+I
zvpDU6pU9?ZDtewfdydiV?Z!wW_7~bxM5XYuTGt&aoMt^xm;+F(!UYy@LJ&*Yx$hi;
zsXUYnA4(iW8XLPQK+IsT@3Dbr8=4db?|OJa{QWn6q@c-l!E0IRfDsIm?BqH34)BHW
zYV_*or9r}r!-Qgojb*Y0Kfb>PswKaJML$Ajv|iUjCN3?br0rGO90>})O5difWoi#=
zM%p>S)t9%b4SCpJ-e;#md@Jvd7!Pq{<`Cz8z&1j4k#e*7#ih|MNCMSdrLH1`cW<@_
zR~`usz!;|QSxKUZYFxv2!r=k4AI@xT#9qjgtlAk^5KEL{C#H2nWDrpIDOPYt$%6?w
zf#+9jW=7NCV0I-foy`F><!Q-QZTY7~Gt6|r;4QFZt0nj>4z1e%$h+CIdCCzv#4SJ@
zGr&Kz)>VD>$eI5PnBE&{d|s9SCAAabrDDQ(#JXpu-0f<IfLCIiHu!{q7V^S=zsf2b
z`m=iM+l?Kal21UX;BJF*`T~B^Zf=uJg&rUIKx=tJPvOfzM@;f=1A*;2VLUB7u)zMw
zTGo_t^cxi!;QzV-XJ22dT2qEtz1%Zuf$A){Tx}}Cackb{7eO--V^m*utj(TJ<!fC!
zx`@D|!bN#9Qt=-L&<eqoz3t+!iZOKRR!aBs`!n=OsRzC4Y55%zyGm{xR7ou3!u)_Z
z@!9Dlw_BMY<OJ2r&&}48fS+092UE|YXs*%D!<YRWZC*J7H>~G2vmT^;X;C$W)p@6)
z^M<PG=)I_r>fB~HR03*N3`RSk=EczX`;Kn848eU}i9i+aJ@lL(*(6>Xa>ib%*;a3q
zna6c~4BDf|I7S<Xc=t|)9R7z*GXs9}aUs^pRvX&366zzhf{lls|2|VhKi2EY8YkPx
zN7Fj+Jkn6Y^b6(ET{MP9fp-!CPUkN9*p3SZq(rO+#~}~KRnycNlPp?AJnd@o+Rky;
zU1^K&hJcU<xz2wPMQzhMs2kC#KxF{nHSsXo0OLXJBn${`JiGkFuobxF<xMnBa?WHl
z-xl8N=gh(m+|l`F!7K36Z{`J;U99may&YcvV+RQqCeF0RRCqR40Kls;Pv1KJpsRFM
zLIHT6QU1F)3?mLk5(X99Fe@R5um;*^OPtO4U|HtI^gXm2RGa0!fEE+JquWiA2b_y2
zS52Q%4wy^0a~vq1zPAlaSb~bP*Mu!SG+d9ifPKs+!F)QAeilU>T6Hv2oO%ytHPu!g
z2#A{tW8197o`ehI?*M%B9+h&)(fSfMZ&T{C*nPszI<!ZF6=+l1N?oHaKX5G}1z&<{
zp0!t$D@-Fu2$xj~3;T!*e-2oSx|F0}){`7eQoT3XIcjxCtCw5BVU>i#$JHF+e%4o4
zgy#;JGGOPwzSbGCxM32N7#REeKJtUvQ;l+7A4&+Xdsl$Ngvbi`UEw4aHgixeJBg(|
z(MDF>DfWyn6O+?{umY>=YtiPrT*l;FO)%2xZEUfK<?x$*QE0C%s`X?mGJMYewP>a{
zYQKj2LOp19SKZ56(t7*|zFD~(K1DOglrnNqvX72>$J}Woss(wPLfCJfkUEfOL*3yw
z-{4@Q2HTnv;43?no}#H=MJm3(gwX@esdk!mS*Um<b%_^eU=36j7MK>W<x@PPyA79H
zaBe23;^L5}knMCP{RZ;_-o{^#fY6rs^~*^2>BRRWu2Hmg4H;&}z+3_QRtTJcQyx6H
z^T#?>)eu2;0oSh=U^qpuX(k_JB%bJy)?!VTGWRCR=w64I`%+lfgnXMskk3(MVO96}
zy>dy_-HY~iG=VvU%{h-Ieg2%xp^nzLRf!OE^IU%yk?%$xOp3r#L`DqE)XU%`S7a%`
z4Np<5{$p2=4WO{Z`r)Em!pk?cduv)*Lej+D<L$N5%&TD#oJldnFn=bRmDJBG6=g*(
z0MFj921aXiAr|iGVtOe+!t<k=R`MdYCY#^+Vd<sCk9&BI!3|RW^R)JgF1jU=P*e!v
zic<;`vG|O3R?!YVRDe=Te%3A*G#-65xYS03fC0G|0}Y<GRSMRW7Hn>*En4CTH9)=f
zg`v^<^C1G^GEUB`zmc(TIL}5f^iW5^#^tG-Y287;qNSljpI}{rk^QelIw<`{j)b~q
zGgIIX1}S?@GOy`BFqk7kNCJ#v^5H|rWg*6guM|CoIha^dH@#B)T9FW-FZ!9$bW3hy
z@BD+7mOkg(T!mk~XRb!Tg)i-_*9SLIn;n&oHNyM$5SvC{kX0~0u>OircQW-sPK@2P
zz2>^m-3g8|y(6XV`UxB3nKKB@EvQwH$e=#9NjybD>rY=wZ9JOy^~uy=jDnY9UF>wE
z-;U=!CHSG_)dZ%z+eoh=yWC*fL3oA{`;e!)>cumVt|NRh{_B;zjbmFxl7|3q&U6do
zLziFPo)#>LNRy1|TQoM@-Rjc09^;yA{Rg%D<dYE2Z;Jk*;9p*OavgIkVuKF$wv_xt
zLtZ{%UJ7!_gGc4wiTIcg!(^NKqQJQwY%y9y<NiS--e+HKi&pLz?MB~v>%qGC>z64)
zwCM6#S;yQ_?ju?=dpz+ddFQ`UREylcFh-BGZ=yaCq_KFV)Dy;=%$+f9w!GcW08nJ`
zzsaB-t-@^u!+Tk_ru)-Cs0Z&67Q<Syq6P!g0BtYPVLK9#xy&nu+!ulnz@D27i+mb(
z*b^=pkrEaJpKKA&>n9lX)dIkn56`xC&n;ee<wva39qZ)u<u-d$9=sK88g?EX9xFhy
zG}Pi|z)MkB-gFVnBk~p@?UqyCX_Ah)Ehrejm#szi0P(!aW}e^z;-QTN#S}xCnG%>{
z7F>wdF8X2@hrH2?;NNRqzud9gQ~rJ#ZqKo*+YgqewZv6ukB7T-;*p`$X4$6=+wnBW
zQv5`fH2nAX4s3|p$0(qHmRa}cNjY*tUhWw}l9fWc0}EfRpSIbs2+k}3KY$M-tPYJ2
zV5$K`v@im6^PE)oy%}Xtzb}>{#%v=%8vPAlU9gJviYa@!)CQHp>)LE2f;&8Z87)-^
zT4*VBYGU6cmM##C#IAXY*}2um**%lw)kRyZe+{&JY$*v|-%T!bf@yLTWy52vEcfor
z%G}eDZqk>Zuxe9YxdKpF{I@QDjH2zv!Bk*g8R~phv&!*6V%qB*;CPuX`3tuO#Km$I
zJ`Frh>?QWM$j}Z%Gf&?$=Km5naeo?4UK#m$pj~2>^ko*}3xkz(Y#(7SX*mjPD{opr
zp?U66Im{pF29rUhgfzGC!W4(a=1j<egwgU>SU6gDPc;F*@>-mZM8CcK4h_T68%>_Y
zn71*m-F;1CZKed*$e0^u`nCI)jV~!%f)LIYs=U;|&kEf~+l8fNeCbLqW5-Q%VB#*f
zSDKe@m&$g=zfeIg7R1*jZtDxqUr1VhLl&cdvd`#f%01hSJY$H(CU4?uGTe$req6{1
zERmBDoDRJ0HOb(HjWHI7gWXtH2fI$xpt3zrb4zgQ)WW0>Wo&N~-uJ{)L%|bo*JIx0
z#;+PWW@OnQhnE&4NoU)e2Ssod9E>B>4wz=E%9fG+q;>*5op{VZ*qa)gt_>U;0V_1_
zicz_K8V^E3M97>$5Ys7~v@GMblER<C?9IU-yxf^skn8C)^8CT_(w!h}$ZtVzoqsS1
zJP{9(Hk<&|47<MoJ*^|IQL*3D7|H@!q=(DlQvHRjdvbmB9R{|t(jqou@;`z+M+lng
zM66wklyxPIFqQ6tz0pwuwRLs=3Bh!e>RN%0@4ABJ>Gks27ov)F7mE-VpxMXOz5_1m
zMe)6ByR#%S_ba<zHXp243;U4Cm>tV8e5p~IqryCg^tzYdKm<3gn3YR{^ig=}r}yaK
zex=637{@B;zW@^j1Vc<b;;>uRl!c?!T;ylSu0=+j#~{!S@^TZ;0a?jlz-wC~q`r}<
z;k~lKdY{$Q3XHB;;b3L0*VGmH;LFRU3$wHGc|*8|S@)M-wPkef|Hy}Q3p!yGNoX6G
ziZbJ%eGNHa>^}jUi+)`ux_JSGStt1o1c%qakEFilaf^bqg3HDTFq930ntL2SfyOKk
zXD`36j~KMi5tDB5-OHR$Bj=xBRF1-nONihaK>e#!eH=fa*Tc}%8LO$YWOD0ZSX{sS
z3;hjbU3Jyk9w54m$lN0!?B{lJC$^theqfkEHS?ZaMbj&ZxT3)Gdeg8AIeuCeTqMOp
zUr8V{s{mSuR*cGd-aBEN6~{4?y(*ukWgMPz|4ZOTtMo}$snC`8xPj$hzbjgwJ(i(z
z7Z9$xGbd1$vEp_6UjI3M^RuW6))5R2IKmOAG!&MyCC@eG>jAX@A6btDN7EYWw8Xva
zCXF*spwz4qALQ|?fxzdl%6;-n{^Ps5S7sX4j<8-Ms7U)WcbOK!`oBt{z$|7t%i3U&
z$C;5}Ce@Y31W-}A_LZu^@oJ1<p2%r@jVRy9`OSDXMKsQgT7nsx%}VvEZNgCikrVYv
z$65&=>MFBIk2g0Al;<*>FbSg&6|t&;gwY;T?IB%`mbJy#?3Y>0>Mg$v=LN0BPPy+|
zk7Hfa`6}PV_utwdTbqOxxqVe=*lrEn<(d0kf<}W`jJ3LbM`P^N%01-BNGf}$hZ;l?
z3|4^lhVnDpyg&5QHZIKF`lS^31X|`a*V01M@%&CDD%H(%Simvnn_JHsdN~K!!NTPe
ztI8cw(AawOs0eL!Fagsr#YFm>+1MJN?1wf3^k;&+DeSDpe3Vp3)2SdeKR6errOx|D
zkzE^0tVgHoJb>@Kb}EtV`$e#v25f;7JORcvyI<-M^ebvFtyFTL2g8G_hE^Knu)AgM
z7@KfFvS2+NvdQMEwKbNG6bN6Jev9euxcUwu7DP%6>e4!?)R)l*Cd2sq<WRU;q8ptC
z`)%Q+{Z)k!SJ&I$?)uehjtHl3NG#0Yu%nz6RTxg1Eb|+}jizZqo_lD+Gx4CUyoxvL
z|7>zMht%laGQRvmiZbQxMHOT}@(pYhj`a&UGq1N*b|uVjsLJ+zFR4=FM9#qw^@#W^
zOPYxC(il=;V^q2Z4rt&G@q?W1dA&oX;Z$Mw!7?8>%0P)d{}O>mfE^wq=fYN6yB<}O
z(}m#JZHEJ$N=OaCBz*@*YY(i&z-J8vyeZxP<jv823@>yN+96Z=Dd0f}N}_U%0GXYz
zkH~|(i__Q^ogEXah-GKQYgx3PQe=`LB@NG3Dh@COGLI_M(~Ut#>n(PdPL;b>FCVOE
z`g&SVdS_(v6Nkna9%l@J$e0EbD}45YSUS7XH9ftILPF>}GoPJ69ZLSes*7(HV+6Kr
z<?zJneAWV!Mc>|{O`%b}*&}2LR4fi5RYk9~Fu`W$_iIXdl!jMB`Hzjn+o%g&t#xic
zbC!QsBYl9nH3ueQL_Z|Vz<4^$c>}7&=|_+ElL9?|wze*eN_$Hl$TFJ%9m+^G2Qd~f
z{1_!x3%2wHPAS`)>hg~pKntde_1I<)&XtQw53Tt^1lD2{D+a3&r?kP23P(m;qO>gv
z`7D={ZZoiXe38Ol+ulZM7(krHIAfFbaql<lT+QWy_!WN)g#dOC8D}+OxsV12|FXNB
z9_TibBV4W`!3p(R{AA5|727KEnewx+VJ2rCZQHCCVljlC#X?I{gfR!1Y07-Dmiz;Y
zs(D;Z@19z_ix#CW%h2<USIr=X%w;$9sXV|-<AqVPJ_}_9%cA<*kviBC7fr`DY2N$6
z_%l?7R;rFs<T3R`Qs@&;dgP~v+7uZ4`TMPlRrKvo82uVsC!{WvXwq?)%Ud!JRxqvp
z)y_*7PAC{1+c_&(&3W6VMtpk)m8KTj-j87<Gk6G)1D1}LB{)Knzs$Q(V<Th5o0ix6
zfC1SnXn4Asp|@D-jL3MOqm+g+5Q=B31XE>0s%?%l+cd;YPb72|N7jTvOgNkm3z*pA
z)_{28z*@29z~jYA1`KJ{qbbCLX7lMbKBvIGms+LSP_2RMRUcugf7HMjA=olQ_Ooa`
zWItqHNM~NzB){+y{K&Nua!1NF_uv?S=6oAe<D+blc*4LDQ-4AG`rJ`}yKcz3^^dsi
z)Oeuq+4;^cpcBii7iRjv*c}RL6+yvqO5i|UE+ucHrMC)^6IEZb$o_i~pBsI!k|}}~
zsJeHSnM%Pqz$^P)Luue$Mu0@1<>;k6?IaDZX-%F}hV%kJqWb<Uu3fLFPO%~S^pZF}
zFd*mKKZq<d&zbuBqpz|FdjMCz)wY(B9di9ZDg~3aNRX)NCluEy-TCK0QI`&Bhk^_2
zdzPX6h2c6IRkWIUwo!anWU)H9;Wfs^E+rbhz*^gPk^$U}Bo*|L&wyJ~)pq4bEiEDf
zWx~xjeNCv0wvpmh`wNTa3!9e0G%DXm)yA$Bcb-Pz>j`=}zVn?szz@|Q-YRcH9FxZq
zEQ5w>3GCiNxb1?O25%XUDmj~W4GQBwTJ}|K&b}|OZs+U@K!NEk4RCzq$vIYTEqTC;
zcQTyh<_7THNQ@yC8~U|+AnNr7^p+osQ=D|-@yHl_ZDOJ!ik9$9_ti^aY_9?LaQ27;
z-A+h@7O`2x!xDhgxXFPdDFZR9{;uv5riY)DRrd144hBcEoA;X2@Ge3?s)wD3^emCr
zK>#3g(Ax|Dz)*+JY_#$TxHJ>fZpSz#I~k=6UoCS#r4E{8;QZpTVK~wrmx~O72&q-K
z_>|GJY=@U3W?{$f<U|G19Uu{&gS-YZj9)nD4$5?rjgI5uoctLfjz0tIi{CV)E34wC
z`Nx%K(FYDifl*b*+LfZaQvYjZO4cd0;yv(n;eH7;$JRmaR0W9#I??{Dwe4Ae#*fvd
zs-#%Zy$OAl_FuRHQBxTdQOX1r-BFORl{yF<<L8{5zT*&{D5Qz*is-PA?Iu~oUTmrr
zE#kD=DnUUu(mNeS@(hzRa9x@lW8j6Jcf0~6GYjM}te<$tMj_)e5aCP`iJ4xz;*c4r
z?z&h6L1oavS8E!0JEAT*vGlUIHbAh)&E_44{zO!)uK=^i(&exP2`P${;Fk4l+ByDw
zMcvSzuBE*Zxs<)2o#V*9&Jqw##mIPvJEWL-G|!i{<c%!I)gf!fbE;55u)>BZO{l>k
z>yfCP{Y)4xaMOpuJg#;ot#txIUI>s018EwRx%V_GTiwVHS0=R#Tne`A65>hRDWSxI
zF-xjkL_aAFPaG**U%{+(<&U|saJsKV392C~mzszKo8wT$!XruRm!oX%*J)=vED>m1
zdW@8~UeN3B0oba$;NGu<H-g*Z=CY*<9BV=EZzx3{=cL+jrjqA4!(zr7`4u1WH!7@E
zVqxAXf1hL48+w{uSFMrF-~{Z-M%%u~cdfCj0?|tOr9HDiSp7UYAT}#b&6L3~>B6`f
zA@NYsrDKCT3yq|NLcZOLqU^frp8GMN847D94~(sK1q2^JI`{zXttzY0x;v>zn<;z;
zRAS)R>R;rdB#sR-H93xeZ%N1`NSf~AOyXt?NkN44)1PcjygP~;IRdKj_!2`O<h%jU
z=D#ahB%DBzQHtqHScq<hB0k+kFo(S_&CHh9@Cj-2rbko1X~CW0^D?aGAsXOgs8AAY
zY*tEM&50Gg{S&Z=<kMTEY#$g8aCKNTZsPOw|H>dFJ^+PfpyN1jo8rWP!CUlFuFdIm
zElYb)dJ3THPeD_L4JG@jAK#ezPO@el(s2x2sBKtyDb7FR_)fLPzjE;ra1!MfxFoeJ
z6zCQylKn|%;pv2^=5KRm5)|$lQrkchEKoN;3A|Yyth`C%dta77KgwXELcaNqH16EZ
z*RsNj&R`n7m5M8(Vtg9V^b4AKT`L5y4A()6>+uvW@VJeX8fY_JboFfP?ouRJE_IfQ
zJ&3=g_WkdP0@7p!DIFWpX!RgT!f*rfU29iS+teWW|F79<c|e%$@M-~IWJ}yaLQYJ3
z|8`cny3a>aP2rB+5D=OTuB;rwWA1%R`Ygs)s{F|omS)7sCK!m~+->(MZBuIwjo9x%
zIk%6XrjO%T*g>ehT04R)lNIo0&Z6g!a!`u9JCtZjT)NRJqm`<vog#fho)D#?IK6`l
zpXh*qz;#DWS^VA4aqN-FA@%ZAj7M^#gc58_rX?8h8!buWVl5ceGzV2cs<95{%y7t^
z5IknDk6b+h;o@e-rs_h)s=9myPD&|-L|V)ih%^yA<UHy_MI<lm9Hz8D^ula<(e`Nu
zk#MB)z_$IpN!i{n9)0fcVpA{2ct1Kc1)AG(wqKP)hL&Tp7QsOw9C;R<9g`&stPqn#
z1JV;68evfGwJWhRDS@w}-`LVi2a8H9(|D*As8utlJTdE%yr9lNUxJo41%3?u>h_hr
zwVThzem#61dhbabjf3-Oc850(e6}&bYA{>x08rvpG|LNxD-P%>-HTO%ycG-6@QYB+
z#)fLDGbov(DOx1&58NJVSNw$)EO9$fP#^J?P*5-x>pS#EfO&Ge68?+R0Vy_hHYa<q
z*1YFU_G;H?l71M)kzu!W%0QT?{iv!F_dlq^bjt*J8VxSOa@Q{~q%5D&WqW95?b9f9
zHs`+u7jq?Q8N*hycGYc5v)-eW=#t0oST!)@h|~Ju-9l+{*t<r6SF+gH(~i8*Gx;M)
z(0SX8=bF*3-%RdcGm{E>ja&3-TWq+i!ept8?_$H{0L48S81U|8xQkQE9k4N{DYX$!
zmhk3%!O=c`C8>X>&1J{{I**I~l`~hS=tAZK9F6OA66=Fh7xx6dql@bvN3zD^POFJf
z`?6LNw~Sj+3JwgE@mGxQxr)=rnH_J=svCHb;Ga^!ZzWL{_I&3Hu$%h~5>iSw$6=ob
z%EXPmr7xS2(8so27b}<;M8UQOJ+nUz(oWWi?jdITsj{%inx5$}>XKiVD~QNw$j9bS
zyb0o`2W(4(oNnZw{!CFyoj!z{jdn*MoI=!8F6LVySc;6{TS#WHO`}N@>H6PlYu4bV
z-wHdWu>%2Q4H^!Dc@|(!dMi2-XnEv?-MXDxjW%-Pf1Pn&PGTFGAG7t&YM28qI^3qJ
zo@3qihKLk<19&54ZHhGSg$(e$DQbV#UEk~=nbiaDEBrZ_CW>G$wmN1diEw+j_Td`u
zEQYI^$h8<N2<UQIrba2Zk}VBFnYQiS=Zx<!>=ODI7Vj`y(p(}GZCjEGlcnJQ^3hcF
zt~2fQj2$1%t;xFX&hTPldVhy8rcsB0&79!|&t|rsEzbkFzU#a7Fcf9+6A!m6hzniw
zZA-63qO=RRW#mdVkTQdYHX3-lX&j~!vahhu^ZN$PXmRY#VPNvaCH$n>$e+33m>~pB
z?NdTc1Wc9178W;llLc7Wj?=l4PgzbPHAXJYSPP}c<r5h%Dzfkx6Lw=lP8(X@yjXqD
zqIhue7tImH`^78lTdLf?rV0H%OiAhpfk3hvWPDHqj;~Z=(QhW!QiGL7mU1&jXsd;B
zN!@SEciW7AV4UN+V8zzgrENJmq|O%&GkEgV;|XV~R`hZ<4fu4o3<X>N@s@6PAHg|!
zhy@Stl5kTsn9^^#*-kns0g<;IeYP&tr$PBX+Ooz#0@~t@&OiZqCcN?`N<G2TCcA|q
zZIyWy4D(Ih%g8!0pkOKl?K%j`ea7sk!}mKj>R56y`^80bj<MDoHn(v0JRYLtO{H@2
zXsWZ0M#?i`S@8IXV%w#|$oOj1lj^f%=kRj#v#nRAu}1-SOjGB2Vo&ULysVEBFvqYD
zx*bdZ>%ko_Q^F+fPY3NrEy_bTk16E5Q@XOLI<1yb5+*m-v}yQ1=<Y=Krnx!q2J1JX
zSyp4Z#-NsB#uCmWbId|b;WKL2iaO0O;Nj=k14QKaFdtKN9jYf~fBA65=>h4!<F3;K
zm&-0v>wFCZ%?_!Mhk`65>NPwgYF9BDdYJ$%YBT^i%_^{&$gVB+g0et5iu21>x#(+F
zv!qz#3Oexf6Jb1jh8r!yVaonsDT6wX<+f2u-cJ{IPzqmnzObC&S9duF2OzJaeJe9_
z%6A)t_08KM-BqnA_PqDC@rKk<0yTg$=T`@r;81i231!JWc6&dPGTH4?mo7fj+lj_>
z?;F6<wbY?XV3jk%q)uz87Q@boH*+ObM6lNb5sZ)qTKX*?o8?u#qJi1^h@AEN7-Rz!
z0=k3@&E<Vin!3$JW5N_iA(^&9$fS8S3z^qSDWr*47vmh@#xTH#<CQ)PpE56nM!8N_
zlLYYp<!N0Mw>F(2Ec=%-K^SNuRP1@|C*Pg>zizF3X|GKrxIjV-F|}A!cGzL5HN&_?
z^ieqyY8;b<eN#Atby&%@`8lGtfR$~E?8A{!f0LJ^Irw*Y7ER$jjqv=xqb<$Gyg2U{
zTBknXQRZq^iS1LR-C3>GctG$M=-;Q37jl73Ob0Ii$Ji~o^Xr{%{D#2Gj&yTx!?BRZ
z*9Q8{x-_%wlA15LgPL(ehD3sEt;_8(XaO%*#^YV&!CGW|AG`AGL7wm>CJ&Au<?DzL
zh>KS@+vjtPDy9%LLFPf6O)mzTZKAaC7rkgUo<l*?2oX4dnd1Bv#^PY$Q<Pu18KTfC
zd^@{VI#rjHY=7tn^dIihlY~)>fjLTy=Tqpue1pQ=eb{TL*SkWI)Vjd^9=XWj1T4<|
z#~?L^0d_mgUnj=Kl4E2iCMhCFo=|s*MRKFA>%S$STc%xSu<F*|@gbkGcEx;|Q9)2~
zXs%fGrcCk0r7uB@kgW$XULkG1|1%WO1A2*e0=3M4=H2%>!X?f46gTwjrx}8=cxXBa
zr^}z0a4qy2zd_H9*Cw=!{WvSN@CfSa<sG5FpTonsdnK;bQ68wE4D{b>**c*qltS6+
zTfJEs=8tZXz+YE|lcjlF=?+2zvh)kE9Dn^BN^Fauu0QD&PIs<B*tK=mq8sdGvH^Ls
zu6tBQj55uE!<lreB;|L;CNHB&@EzE6MfrHD6@otowbH{!B14w7{ddc-k>S$3GnAd&
z64Vc8ixG5bP-*HVA*xm9W0{AnD7g}u!!*Jc0B=VGZBR=&k|JSoDCiADbCA#9m4u+j
z*3bJP>|`HiTvr|n9`($`xI@YT=0o}n&XPYwEr3I=;F5DZn8+cq5%g4tJ`Yk@$7Ejc
z*IDG<#}KfHfwl~z<<T<|Zh_kJNbayytF|ux42PJOs-!j(w8qFBB+6z|7&~D}S7wji
zNNHAv5wuI{eE6u;kyZI>lOngKc|fv!ko!I#brka<(bop(2whD1Rl>qIItlKDBSLt&
za7<D^k5v`XqY<YxyENR4)u@&ek8b8*rYFCb`K=EGUDg}Z>cZS$(6Hc{8K-eBY5e7a
z%zG#*_ywr$IcoTLbxl{xuSz#rbNr(4h^7GK!y;byTzrVna6D7{D}v}VsY;+E#Q-WH
zKb46xmTA<SXNBUr6PQkR7N;b?s)6iXLJCtS{(i9(p_bieiq$!B7MQH*m9xGciIb^B
zdOxkbDEMxNI9FiK2e&i9xFc*gfFY5U=^5KG>1@h^xN8zeR6v6W#?=)ULfKBvGqZ?C
zzOe7;ATLSOlQorm#)ttPAbJT+nc$NZ^e2xnpZ-21-w}<S%WV3cy|QED8|(#-0}+$3
z{#C50Vq_@wqN&Zu&3otC8O_|>BHoDa$h|6}M)=2P%_$|BCi`W{!H+g_frslDk_`wx
z{*H4nuFd&?*zFGVS8u-!dUt_SWWv0I;z${R8=4W|c9|b)!=aymAb(3F-{&HWv)IAQ
zLwi^s^kwekBQHv>pI2U^TJ8{{+T($SEY4?^eE6UA$%fD+NY&$c1FwHax-K*O<J|4M
zgpsNYxrX>J;ysODdXV$tBeY&ZfC0L&Rft1L`hUU&{|a6@lQ7{OPa?UU3+6LZC{@9-
zca|G1f`vR=!^XQ86(=>%yGYH*7tXwLTU#=N@E+5+Ou&>6Tv1Z5rv|c4)%X{A)N1|N
z5w6h+sl}*cJtvf?gEoy^8v(`c&EV50c$C__p|nV^lzl4X3S}qi<4rrd(u>))QE*$G
z#IsB9;w|l>B9sCZjDuV!U@FfpUyt6UAt+7GF}(2)i7~zcpOq9n5J>evhD$njJ=4q-
zJ5Y}ny*N#ZaX?=9o|NMQ=zqU>q3rP!ePlNl+Ub1Do#9p}4N{;G&872I(KtsmvN;C%
zhJGbiPD3|qm<#yPjFq^0_U?U_f=ZT?g{%bmQvrBz2vYVcipj-wU`vz$WjiDG(5)c@
z<>N0fA1ePZqzrK<qAlZld>NaCQ%njN$ON*l+ht`a+r*8Rxcwtp8TJQw^;(-N3-R)d
z!B7&}gzLBdc4g${nNikj6``IBAo56tPx;(A7ot(c`+KoK$d>TN`haui>6E5SpaEAU
z1FRVlkSztXP*X)SCha~ln(i~$jjesuzo9~mdBiJ-$v4Aq54FFU$G8D2H0@>frXb2+
zWMo&`#Vc+Al<qUtT1b;*4B$Mp*xg5oR?rYM3p1aOaw1j-6`?|Ytlu<!F8D5Kxp}AL
zFKhu}zZ}Al+?ycZ{+a@db^J2U+J|^ai^ZS!0*g3YF`g-eCCHpyL6|=^E%3=u`;tfp
z%Ny0@QK%OI2?|2ez-kYuoG!iARKaU{A1qK5#>FV6dWgB(J53FGee1|aez|s7>Fu>(
z>FmoH?d%mGEk(?L*I`=_-U12(<sfA&X<g`5OdRu4g(4H!g%gn*#S&dj+^<@%LGWfS
zJolU^L*(<qPwej;TP&)O?l6W+ds`wo<Fmmf29Jj-q5Ah7Fsz-dOvepAlyFdSr1wHQ
zb{R?%j<#0d6xEo~oj!ZYFbO*!M$&Uac(G=><*E+MgWKtOOYCpP2|V8sbW#SCT*Vv5
z%_3pKF(?7K0cGDbvWEcOe#QIx>bhVbe^u@<BhgNwgJ@1U1f4dg1ojd(ar@;e4BEGx
z)_Jq$o4{bPGrU;s)`(_Nm)6fCu@d9$!xGJ@xx7gWv~1jLbf6j3MBox%js&0S&t7Bu
z;=MP5Y*;=`TrjY!hR$|B%G(2fz~PQj@BQA~)musHTXgjC=9br^7d2wFSdqnkyr&TB
zL=!2_1gnYjs=_*wuoH%6A29DSHL+EaqZG|ef=1u3Pr{@J5t@27*KufllSjMAX91L9
zM(XV^D{^1MiS9r?AP6~Uhw0u&eXSXw3a}OW?{)+RwKY(WZv(Y#f&&74%B4?_Wo2&r
zGI$}?a?*b~SXobR66QCehVbfbQo1!nby-H}u+$LQm!1?ga<~_LPC-bm>=4Z+ZNpf$
z!a)%x8yxp4Gy<c&Va7pMX1=M-9v)5|I4K{6T-sJ{Qx(3@VUR3NB!UyS=oZpB$m1tq
z%1wRyzTy#m+2CB_vXO*D3Xid9s)W>>4UCk}M_aZ5j8~shsH4N%4SGW&@5JLD2{jnm
zqG7Zbw86YRj_U2r7YQ>2RT=>V|Hn_eq&F>Nce4KT+ucBj-(XR5vhNaQ7o=9P9X>;^
zH(*q)<n6d%Zj?{jmsRe4Z^&S_#&=5ZoA(hXZqhD;je&d{8ZWFYHbzw1GG-)0nEs-$
zu!5H=&)uv}9Ey8op?Zg<VXtM<m=m<|AHhc~Tlcj_UXqy4dJs#o?nmohe06wGl0IE-
z_x3d-jHqy6^*IEZAgleu-bY2%yU4?QU)>#tGEqv%&+Hn{<es3TT}~txOH$Ai;EU^{
z)@JMbT!~Nx&M{xOKYvf#0eRcBpJw!VKB2IGv#zbQ-273XL3MYRJ9UF}O$V%ywiaW@
zsJSpLHeSl(h@=j-MFRUbadL*tg@x8C6HrPHe+<;)@fp(CSSy4wj@4Qst}DdF)JcK}
z+*YYiIVezS%dZa0V{K!;vt+FZ*HioTl+Irc9)e<jaiR~ke&L-m>d8!kx2YX`0%~89
zJ~3~S80J@WmB`+Q7aj7>;W6WiL~xkp(aJa)Nfoi*auCK*ATHq`NA!flVu})-C`-#6
z#k5vTSx2^=p)DP{`i=mB{#a17@|I%eDd5fI7u%cRih$FJ@Bf2mh!_Af0F}@9nT`pX
z<a@0+NV`?+tZ8_{XT8;b&2Ld+eQm8llD~}WF`C{LJk}Jh`J#fprl5mKE_QyJ_pYd`
zUV>5!eJhdh8$tIPkQarS(6M|3ErTu91hmNZdkeT?g$@*HQwpr6v`iGI2B)dJ%P59N
zGDffiqXobi9YY8SkzC?#STs$%RuY7pDdn_uE=s(3l5duRo}QtB#j>cce^pT&9D@Xb
zP)v)oT#nwWQCQh2RCYryT?5k|YSa8CH}4pgMd!TLMy5crxr!AH@03)-LHjCSO3cB3
z9m5?c(iyPBcMA3Q`ALbW-d{~ZFUNSd89Ln{8_J(u79G&VBWq6%u08*)MDg?w_VciU
z<3_lY(<kaM7u^Id<ZJ#Dm_%l7G6?+&>5O{{jsx2W`^2LNi=|5*q!jI`D#wi$Zstxr
z#kq!;;oq^w?0j8fI5!_+lw5)I9y@Uy<}IFU@Xi{^VfllL0!o0Y;t1Wed3VlTzT0?_
zIPWF1!+vRP^|nIG{_n7^SLxoF#Z4WwJ181P9&>&*ltC%vb{M;`av}4!nU+8(Du#VQ
zHVUPMd}D30>EHu<{m6HY&8g9z$;;ky*3vWW);hgUHqJAa^`G8QQ=6yA8rEjvTB&e$
z6Z-KK%b_88cip%B{7H%Yta}`qxw9vQlzJx@FWkNeKZwIH3cj85sMMcsTYum0jHWk%
zw*P2vClH1aaU`eyMS8Tf7thvT5^S2o=jTv5lgT2z)+pT<K8?I3s{1#ZkA?C1)SewD
zfZFDNm7W*ESP@LwPDW~qo#2{(6W*fT^2*X@){t$0CGus`hX^zNrq}GTtHqe)a?>rs
z<&=%(O?+EMG#yiPgXl5vzU=yZGaF5g{MlX2bY2jxE!)Ri5ZrHMHc3XL=xe|k;EVms
z{pdnFI1IJ+3hXcdh)CB3@?IO=nEwFwbvGg=C`w%JaivCz^N`=iVnh&-)0(6LY{IW|
z%(mA;^&849icT;jVw3%AEf9s~LzxPVS+oB!HskYSAt4^8j9_KSs~4`V05XD6fhs{@
zB6@G|Bh}uED9e!Nw1%2naXZ+5__@<M>fa^i%wX@tc`8(M-Cp<cIDzR4?6;19alCk>
zf%odOCl)Oe{{AB3^eTBjpM-ve%I|vu;USz&DtQf59(F(NC%$ZA2Q&^Z4`=M|VH}2J
z5p(?qYRF~9A5%P4p=SX<4^|_^E4Sp31SJjqA{WxPXqx9WV2xepCx7X!*r8nU=-oqS
z4VCd&JTplcdZmJl<OGNiuzT0h(vd2VY8O_?v-GzRO@UkdCfGXA*q}Q%m=GK*5dVLH
zJa;dIJ{+D&;RkVPZd~5Wp+0r1k%||9*4+oc<9*sg&dY+H1!dOv;Z|&TxwyHUj~JG%
zdn+(UL*<XR@#<kV@Qxr{uteJV_S$TdkLx>Ce}}L00}x5cq3%5ky_zURQqViAY&m=)
zC0O+MfQEsd2}I}z=l#6~DHc3THHw;vPW2ILoa>kE#dm!}IsIem3Q6N6*;^gj%?2-7
zdgJO0_*v|Zw)R*0^kI}3L^>R~^CWz1wC(Gw)0t3v9?8ALwJ;;kh337uwX%{PZw<O0
zsH?)&3qov~(*f|x7asNYlRDbg(dZZJ{&KwjAZ=9K8TvZ3(D|;MmS(OdWz&FKql->w
zSd5KFkZ!hol-xywS}TJL9$*Hjn6Os1u#)L98+(w6(M^VNY^F7ul~VwUxUGRwL*FBV
z5o&)tJ88}ZH{n48A+_`puOjh&y7QiE(k*w!UUqO_o*QTyN+A$<!Ri#+b6>BNIEV%u
zQo|)QT(M3SC1s!Ic$g~CS#887@s{KIonh_$JnH>L!$fbJh_$+STE(3aL3W9U5VyMS
zn@IQ~8whr&XIebyi7!qBSKRZ!k8khd&%Hr}+k$vuxI~8siu`j&Nh+8j>%51i;$yNm
z3t(PFV00NYB8T-em~(D;ZKlBZKAoO{iq`TVui_I@Zu(p6sX@v=sm16RxdI%jcI}S6
zu9Hwr5<3Et-T`+GMP`kBxX_KCLYLvSKdea(vz5c#UOesZTdld9%IXIgl(Aa%Zi^5(
zmR|Haqj2cO^V7@}siN;Ztf>eV3HHiG+WLaK@Hmju;|i0vs!fGpsO|@X&JDk`3q26y
zs<I7k#N_MA9gM0rVI+}5!|Jjb<Nt$-yEh4O*buw6dG9OPYbTs&f-TD(L9)9sh$2{o
zYS@4kQ#L%u-iewv(Zc^h?8G@;7JMt?!EyFJ^jIjZ`l{K?$@mIiGjN*gIiOzgwMC_l
z*<>=ZrwI(r;$VYU54WkTte0Pf@f_p;!pz@^`+K~q<mP|)wUHw(`$iaQmE4artnv=v
z2!xHL`j$Seg3Je9+7QQlKf;E-8Cl(x21_)^NxcCvEyVgERvQ=oB-ba#2o9$KT#@^P
z5`+5wmVOf5<Ta}v?g>7qrG_BhiWBa-kU=^v`ydSI!;{}A0)DWV`A_OJ9fg-XeRE^|
z!(YlMkiemLqqep9T2@YC=%I;ZRZS{N{Ig%at{QicEaEj8fVn3$#&6^H@Y>DDfubaC
zLdb>GmQO@+g@E&P=OxiHOeB0tho3AGCeC1=#3HBEC@N5Ax)DQ1U2*$?Plv+9a7wFY
z_c37}rn55++(|PgvB{ZnpoG`ikvDdA-u199a*zFV$^rNW!`*3tzpT=EM_7qnl&2+w
zidFud(3e0fNfK(?_5PRg>}Op;*=!2(>Hx>?jEv!`pYe&+^Cfyxq#Vx^H?g<q8lD`n
z+zkIm;gBU^34?Ej%N*Dh1JMg}A0$&EO8lC*Z4Rh^F|{#;H%IN3X2Sy<FyU$?e@C*l
zBr?u{)xQNJ5(D<~=AHnzvC9J=l6iPB^dZ>2zG%sK%DI9z?OhbG@O|z}PX?^GpPmi&
zdLTz?TO)*GtwSjVqt@~@W|Bq5Ext!s9X`0>nCYslUH8LzGRIey_d3eUQ8dW5O>4W#
ze3Ikcp!Xkpf**;w9{4OJ;CY{UWZtNesH0Fs2ksSzRT^LDJ$v3Wn(*`L_wjPQ0=i)G
zm?<Mo7b1c<kSC~;gFOq+Z!rmU?dmmuP|{#k2gV6bT1-1#@G-N~#;tbRVDMWZfb_x-
z#6q`2dK`;#{rlZBcMTY{?JNk*)s>tbX274ybs1=wZKL*4VDRE26?b~JFYa11??CM#
zY44qYlV^5|w@nEY3!e9EG%1JCU9qePh6U>=22vvvCLwCJ6GAoPvZwuupAMO%;B|f6
z<u=S^Bb=$_cRUZuy<}1R-ATn|mum>79j!W|yctcGB$F2*D2m{X({pv3++<D=-p>jZ
z*+yWwA!I!(cInkW1K(+^jJbXl!qbN7=WNR0nY@R2&PpZpLt!MpFb;x5M<NI^AFF{6
z;r7tT8;n4g*LlmG;3-NZP}X~@gs{0XEl>jv;ov@{=?<4#6Ftpx?FR=H{IB-Yn$3R8
zIA#9WD{nmfr2U*b7dt||h89u_i(ra!33I86K(2ZCRe&oAoUBgv)6}fKP=$R<aNgLJ
zZaa__Dkmp-uiL}I;$=0|n6&HU6Y}d*9W&%RxEE_x#i#rRx59Bpqq?~~5N_kLaz-C`
z^vBB|<sh`pko@ByuYQl|TRla{)aQyxM-q+GUq7s52ds^e_>m;y0u+o#x80s3<9#Ab
z{QEkH-}>BHX*8c|lSW%mzFudg_o5Ty3AY$mM}`i)Ylli}Xtz*H;eD`lt0OOT9a;6I
z82PRDlZuEbyH<NTK0VwI$~Mu+mzH?V-%hrQt{A5)=7}?9tTn4${D#n!>i-#m+kIXn
zPl5he#z5`K;ZoGV;=mIe<Bw;-fu?dW4l{PNFclSB5}lArx5-mz$V_dMdS2g9Qo`DM
zPzGxOJSnH^eUewbU^3wM$-xTBJ#Ics<_Q;pxB?>kQZxvr2!a1n;Gi=2Kk87t3D9j|
zF5<gU+iCY~B3?3=C6PU@BPr#C6$<W=RSe~Ahm#b)_JZ45VZi)0Pmo?!ZT)t%NP>~n
z(61znygg=9USZb1oj!+kp740ZtjNGv<LRs;=tTpJ3H0jJfAVqFu|N^QX!nnW?3s$#
zI9A2R^UsOdA;rfM5+^G8f*j)HQ@0F$#QBdJ+{krtG8kbf?rZGRwy58t#V7QH6+MV&
zl?OM>Q>@GW3eiwZ7NPfNewKR9H1!BO$k2DWz&ge61{T#2%<g&zoW~4%t|P{F2H#P0
z+3JJr%GJCSUf6MmQ?9Jv*>SkZ1z~Y?bVGjZm@ke(?RUz*_-rV(Mo$+`QK;!2=BMJy
zLVa#8wqaH7RZ#1ad%s00O@3^`m}51Tv>ph{+ARDQk`CI?RjBi`Yg<Au?U$h0C}<uf
ze%6Fk@XB@qAbMmU{}UlGl`(d_qisZ;jT4i#kzy>P699n=61n9uL@;k99abFmS(Jt;
znH+axzx(rlRviG0UH!8`rC%3|;up=9Dt|!ggPfDS-|#Z8hCoE}T>wf8Ci#E3I-LJB
z2DWO$h$>~~L~&`gQt3L832I9^>arQAZx=WdFaVOVTn(jPl)KQ>$|o-D#zDszr75u@
z>k|F`XJY<a2?}lvsGfN#flW-(;Z|DOmFSBB0HOPRz1pP_`K!6suvhz3?ik0*^_ICV
z_q>Tt@ix)Viu`l1K)T!TN^gOne*>+1h7FJ9%$<rt-q811n$A%rE4|EGS|)6%rp``9
zzZ@82^KwyaK18Ck(ex=8O_7ns+EED#5wtl@KZn#aWI^zR1-QB%dru?s;QjfncaiuN
zYGymY7cdQR5lua*0n<a<p9K`<wsI@s@JYvUUQnZQ4Y6)BZoFP0wI;^T;7qT_MEdI(
z53>4c+Ixa?RMhciNPl=<f}w9Vf%S<vuj~rVH!`fivHR^0SV!{LSl;ZPPy3^@bXS+y
zEi(_ePgK)g=sXj6&GtU!_K|=+&sRorWsir#x+>mtmA8Lp-BnN>XVC?OI~Zsg>dOxP
zKcT#2Ytw%a-#efY6i8#zHhW3e!AIJ1kC2E@Jp#wmi0-%P$zE_#Qgg42Fn6aeMuU4g
z^JR1N!co#`YJwFoZ-eK8>-nnJj@5{|Ci3?#0#($_%Hr(W_eUe5K!TKtTr*8Rz!aRE
z_7D22oeKOIi(DA5E-&Z2i8WmS#yQV&2W#Xoiqw;fTkAhDHPm6NbG>wP9tul2Zh_AX
zwf!GB$A#x4RDCoKZo}*!Nw528bE)v)%|75-umMyXc1ROJ*+ziN31a;s3?utcG?D+O
zAmPyG;3`QL-ZD*zT}tt=GD{b-tNUwmy@gMdsKImBC5mXtpw*`>2He;E1V^FBDQR(E
zCpWkZ-O+z5_zk?coRn-6?JO1~H667Y!M;btS`oZthf$oP6s1<<8F3q37i9n#sDPzr
z2Zl}XD%<hqC0lEAjhDCzS(s6lKUdVoW0cuE`kSr}N<@@hL@%$hU`^93{U1!UY6u{{
zr0K~EouF7+=v~O?_ptuqf|)Q=#527oP0azNXf#~}lMQ`DDyl1@<6I%Hs@CdaP8yi)
z4mT@*PP^IL{Q87hz5SZ~Jg$k>h&fC$)i<ulo}?3gCU-RMvkv{P-&rRx*9R*~0DsIK
zp2};5ZDJsC{C=0=uLYyolnyJT6_uap2fa|W%!A&x-}QI*mT!wB?^WuV!5QF-@-)v1
zFv_l`Wo2SHAYlKOp6R~;+7*1K#I3`52(4V0ljWP66l&&&Wfb(fhqO568l8l<%Z-{M
zt1R?{xTTvCIP_OPx?u+}T|G^2&ttP{h^#$$hLWzdl$5g>I9$icgbju3OBi=V<LC;#
zyP#+qMyCl`BgW0Sf8mY_=jz9oYDbG^&v-j1EsnTLzOQBia5mJtW|cfae?`5SA8+%f
z6}KGSxRzz?`HCD}UOxea)5_*Y`7`0@NPP3f`6A_YfEKq;>cb0~`3wXT=C*3G3I5R3
zkxIEgY!7^ZWVx0^vSzSoGDF9$Tt*@zs5ki#><;<D1AkxX$i%JE6u^v+SEs&~Kx7w4
z(`IEnp8_z+UGm97NT3`}`km`8`DUakPOvrlP*J!c-Ji7u2<T>Hb`X+PW_%1KZ7JBw
z4msIV$=6=qEQVv|qD=extQp7SPdM<DuQWY!?eg4ct$%ZX!?w~<+8+}I){Nst&U4!a
z{nuu4GEOfaVka}yx;rnbH)|WyTX;lqq&zB>gUp^nn8lBkk#t|nPV95HS`_)j6UaB&
z3WIp38(czOCAuwJ6l_po(MVa=*<uCb{C{QKyrvAS{V_MKX=oPQsg#fG7@;pxYM*k;
z<ouBzEs~en+&$s{7Kh^+-DyMXqLXIX2|h7`5$HjCujEnGgZhu?Md0}(o$f514nv1z
zty2MmA$>o<3Hu`-L#E23l55$8nt1YZ%k>Thu-M`C2<u1mXhVKS;uB&)0p~JePx=4>
zB(&xsFB!4eAVwUb!PhYAm#QJF)a>Q+|Kb00yGh;9ZhP`9(iH0nEiQ+a;?=U1%b^Qk
zb(eSXdEqCjkKY`{vAt&1)#GEqn`}}6CJ^WgJ-&5Qg8b1>H74=!rEK_fM9!C&jO@zm
z+{b{(Ljg8eByfMr+KzkItIt@0JDBjP$pzE=z8j(=OSluschGs^UIJ!4Ntq>cfS6mp
zOQ6T!3?(mU&;%>t^Z@L%mn7sj<WFR|$47-e@E!JnSb0$qePh?{Kn1+g?vs+C*l<@?
z)8ypW!(5x93WkyE?n=eD2Y>5emS4uNykdxOHfycmemf_#G5d;+Iip}ULA&IYEh@8<
zT8PoaVTjdcBs4mp{*9QGXlqXCsO<NX`<~<@L}mzBpfUK>;|Q4$*m)I^ZzPd8Bi*#+
z{E8`D8{r9v^p0%zIJb}BL(Ks_asGA9#tEyah$KGWJ9qk=Ed~v}S=)6eOOZ%inHQfS
z+|iAKsi43zey|kAz!m@~)9g9P#&VxUtg7Ec<rTRRjE8Dj3(^cmm=*ll2nfxO33Nom
zs*@ewFVEMZlVd4|!eA0tU~)YC_F)N?`VJ_!<%W2ww;*5_jcw&@O>%e%=aHO0^|B(x
zl^OZ$y>8tRGoJ9zEk}L;khoSQPYMfvssbZ;e1#aYp9HrYw}pu2?!qEFD@5aQWCR7(
zqK=x=2)%hD!`s-J>wyyq(O;6)Z~<>ooP3_z8Nd(7wSkmIEZTA;@>0ak@>KKKuV3&;
z?~0kXyjQxUffT9pn~Sq6`ATKH{A<C|1ndm_6c*8*E9{ldd+}gcC&c#@Z<$p?NHTv%
z_l-V#dOJuQ&G9_Pu(wIG&mT>DwlZ!j;?X}sT8$GR`PIIt+kY~BVj;{9ySq+O^@mHh
zf9I;l=g2(0g;WyIXdsd1f$O5#p*7QYG!sIh#4#jBbzY=44hOmnepuBz$C&OU7K{7d
z;y=GK>r~Q_-?HSM+I*T(IAJ?-YrunIEix~5TgTs6pCL5PSWWq>o@zsP@Vfwr95lb6
zi;GTAwvB(|q?$W+)JnJoc9+C`_HHewcCA;HIaSTAnXH|9DY~h*V+^cBJky?iZlA~V
z1OMV5ngF|;AtU6jf!Rn{=7$$n63}!gu|)7ziYab|E<cdiHiZTQr7@%dU))&(9<q6Z
zI~MG+mTs)2&9Ti4DFSm&!INstoJec<R7!KL0hI+VFcd#ZNOwRf-4azBbD>Y;0TV1K
z(85L4Ag6xWGKe^IuYRs+R^>-p06sv$zt}@jOXbEw)V0f)x3>ZjlO{HL=DG|M7bFgV
zvI>G8EW!+=(q{g>$naC253{AK!=z`>ehksmj4(z*T;<l#S1%4w&v^i|vnLh~D2NFa
zmm043;#?UK*BM!!D0D<sr|wt<brA*cd(RaE_PZN}ZDp--70l3yBVm>2-yA|EQ&vLH
zS+-T^Ij9%}A@2||q(sT{X)#MpOj2^KGk`tnD>sS_Dz$;)NA?CoQ6OccZ6l3!+@191
z<n#DT3t!Cd58zI$()NeI%ox?6$1=+rYYz5c+v1~ob_s8%1R$Wijq@jw?t4H%k@sRt
z3$gUsAcW*pn>lTc_ZQ0%-pUd07EbMr04=Zl#lw@590eG`8zf4h!R81claaRdQGsP~
zi(vHWLE!B2$rtD*dm;+rZB<-d1(VQ$1`@yh{DoQVO~AoZe1{+H#Kw^@o_5WPGm>zs
zc-9FPIDhSVAsZ{Z3tCY?!%N-&agmqPR9pn$7g?L2hF^vImy{CMwL0sRf}x#>pqVE3
zGwtHy=MNfhEB8ma<du~VA<09u_j=Cs@#uQ_Vzkyn<zM|lU&NY?M>(xj^XNFBBC65Z
zaV7nJtq*{PCCw0{DHLh>-eaa+`u>j|mjaBBE}<PcT>n965~Ma2kW`mNA@KZ?^(*FQ
z3^+OA^a{^y6&P&RZsKcGQ@0lxl%X+HgM-I*g;-h>ffwR5I?{K@v=G=`vYbAu)RO*j
z?aj^L#gk?^&~f5ZI=r8znOysZHROJ-Q|2-{dC%G0LgC{=kg^ZDH;i0hch9I$RY)NM
zx0U2hw2KqcdhEK?O2mF_m@o|yQKclF&qVJM?L%6DovJxkXdCXX;^iYbBz^iFSen{C
z*M$@oIt&2zvbcV3#7mFCh-jb(gmtufE%~+xtNdi@&&6yk9?}6;o=*R|L12zl_NHL@
z`!B$I?WykRS!F+P6jj<xR-G*N7O_?JoW#_3gr7AEa()Qh)tlo*vP4UD$f@KiB3~TG
zrxOEE8oo&A^^f`-LlCuGC0NvpgVca}8<i7&i_n64|88aXr0NraLpmfgFolYOF?`qg
zpIeJmC3+B6i77uM_unR@NU??>X>f^E)woTBt`8e~j3tazX{;2(^!<g<-v9^5+Xsf$
z(&GtGMrJ`Q5}9jPIpOS{PTb0__7zL2A%3Wn45P{*fDF5sz7QTHUQN}*G%zhsrA*>j
zwJqigK!`>#=?1XQ0<Yr{7!K4&&)X2eiM2Wxi0(C*=b%FFpfIn%x6hx8=l$+3{)69_
z)?x|{<)1LCl^3|x3@VGrXG)?LaZL^TJR-?KG|HdI4i5S$xi}7qE1tqWxCbP&Cvu7i
zMWi`?191{j6-1T9Kar2eRj!Z}z{eN;>HU9XuNIXo?#0sUq4J|i;X8>C&j+`_O4_nh
z?)bPOVB1*6B^fM|0iwQR<2OVFvRSoE757ng7}LTbGl&*==(1^(AKjUBRb`+!U>Y~1
zalIg~__V8Xu|wm<CYM*#xf+?CrbzTJaq!Lk{$d#mm%?uU{SZoD?DI~0UA3To6-I^;
zlj70C9jggxo~iWUy^EDPQ(ef6s$hcw>*V?=cI~1Ib&cgLXv`TUNP(lcVe;YGwxzXD
zMMw{ST(g3Bp*q;Akar@DpXJ$0^JbM)dAPF++`*uaO}$xQ)Ym`kf~H4K_z8X+nqgF7
z{yzR($Z+8%)4;%-gC~(A1nHx1RuYK|?QQK_Awj*|%XOL#7Ox7juO5XBwo}tbNCU0&
zlYXG)A7Z0hRE7bM_I|Rz{^7n_qPz}qW3Pf_l1zsXzUZl>siRSQr7U~oL(hJSQHyfL
zXA@{3C}RT(1Un(<*WN7HPMR+d(x;t?=K_P#xoEBM8<(WcbZKE4W>Uyt!i3@2Y!9c>
zDwg<IZMtP6SW1l6n|<j51&$^TMr>p$-qX?coSXv-tjVjn@B?n!anLBDXzzd1cSAH<
zsg<$)a_AfEu$LoP3lcE5g2vTZc~2THIazBC*dhT<=9iQ-PWVof+DRxC-$ulv`w(%Y
z$SW|>#(S*sI36*vsO1()1oeSJu;Cps#83ckza+yq^d)_E9{Dd?74!-<`nneVmsK9b
z#iAiM!Y>pZGPOF;Fz{YAuCE~yN`c-G1<D_E=3E0f3-^={=B!7S;>7@`qc;9!@C;{m
zoX)QxC~B!>X$1Wt1d|z*p1hN}R95(${%Ld-L5E)4cwuyRf_dn4uL^ZpPBknDFBp*=
z$EbjfGhM7+?b$NF#})h5ZEPnc0vIBf9*N`!0T}nJn!$rYJ=a%wCtI$oe~8=_JFgBm
z7k5Yie}B^z#lTU?NprYyk51M3YjWE2$?hU=I{~h$9oGju?7~pxS|iAmI@HWc5a_c@
z-_7*fE9f$CaP|$2Mq!DyN0muE59Dj3x4bL?E&=AGWAX$%w!|nQv0Sm6(Z7WTXqBcI
z?p<E}9kKNhZ!$y%C03fNv<~7bJaaJE_S*{7E)`BT3HQX#N1$~z4deD#pWu2IE3lDN
zR4w?Tm~1WzS$NtaWyIwor{m`1c<nujs%?M9#Zui8E1BgFJMD_)GIf`$Ic5{;0Atn-
z^R=5m*)WQy2cT+Q;%@<`wRzh6N)wXe*8-*?jf+iP5G)CeJd~lJu<<-oPz(5-x0swF
ze(Ie5)ZWvEeFg9%aeiD^Z9E?I$494kv=}ZZySYLh@vJG@6)Kh#dt>FL@=Gih`Y)^0
zviTL#P6g`2yGt5ys){N<{k=H#tq@<RzrL)GR&^O39RK~B+_$(Q(gmhB4PWuU=x*cB
zPH@jbT75~*|F$|0h7nYZ6Wx3tzgUGW61-eY@BzLnoPVo)Ly?6-N?4-6JN0fJiH-&%
z@P}b#aqvRF$HD9^Fhay9O2R=R8LPsYbviO3myWWI<d0%{L5p*2@*i}!tmJ~Ng!XR>
z`rP{5dCgSAwDB=aDCw29S8Ar8W28#R$4sVbtWOK6hLCQRDLfuA1-Kn5{4$grf6|8`
z+JITs#cJtRCl3u_Eqw|3gd<6?Vyx>_$2O&)EMr;k<V!<&woSszvFK#VHD4%{=Kd!<
z(Xf%<SH?gWN?eDiGL7(|ZR2x7W$dc-uNfz3{2g7Tj=6ghQcHtYRRvc~y;qoGob@^!
z^6AX=y1z@a%Z^#fIlAVyvZ4tpT-Ql#y@X49eI~_OyO;zQ#fccPb<O^gu8$Dk;P#PG
zv%Bbgv!t6tls>NFl~GxDB4`YE$=75lKdSeL!!<T!by>ZdR*6(yk$c_E1=C%K#aD<w
ztRSUhtG1Eq#<j~05boG;Y<^gG{HW3jb8N&@=ue<e+o`XkWwqzKmHRD8j!<!5K-{<U
zaLJ%h$dG|!cMH>b>qZN@6d<WSrdIf9sUM0ITPtI30LQpW!NhDC7R|qJyEB5K6<KlQ
zMNBOq@PNaOF0Ad8_%CN5*^QV_u5Aoa;CgixpRm<w1ZT0z$d0J#tr-@P=V+wB&5BWJ
zOaKa(6nWLg%Ddvr>)2&<f$<W&kU!Xidd`yl13xV&W%1?CtrCe+8})_h5ZsKrqj5d&
z$5%~8UMgM|xc{#w%~SFT8m@`p4mCTv{xtB%9XhM!F~-TJotnhbjrd7~$pnrllI}dm
z6G?ggP?K?d?UOM->w-&qB1!q=#i>gcl3OL}lSpBl63(K(F_N>_!vAzfya0*SB+%tU
zRmnUwKOG}!7I4om@tpsm(X1zAP|o85m|firC-FDozC;7MFX`%n65h`7fSCLLeM9^X
zdo_Rjc4gH@ER$>Pww@b@0IOzcXRUXwc!baJzYL$m?j!2pByf0apB}G@@vYyfMENvq
z*pTn{dtFrj%0@+6xmraJdF#h$?ZZr0YL0iy)Dcb!Yl%B}jLkVfXD`9zFmiXz$>Luo
z_r2>b>l+P-^g-#$Hc^NoKZZQ4)F9ofx3K6tIS<llVHRCIopgfSogdy@17)a{F1>5u
z&fi)O2lgL8R6EM9J9S#0Y?~>dQa*>*9Dd;evSq~U4VLA>4jgKV8;GgoomqP8+l4qA
z2+x^9!-4`&CbQ1KoP=#>4FewqT27EchH)l<ft;yb7!cMlJXIasTC<GF!>m+VrQ`Rs
zuqSm(q9^7Bf=EfdbjsYLi22}9(+-`{sL!EIfCRYggfV=5r6alsg~`I#<o4;AXsHF*
zQsQxvB)`w+*d(_@-Tt8-QvQg8EzPu?zc~%|c@dyGEz2(P!^&H=_CYcilxq*@lU*H-
zE@XthZ1R5zj-SiNKK+^@Sbufe!Hg%ZC;oA>v%>n5euZC^4W+waq4@Yj-nDjF9;ZNl
zk|9fDN<F_qR>iRAGDCA!8DBJcKXl;-;~C%dd<U4;+5&NB-)7*B?Jm`N2EYTg)!EK0
zdxSon@ap)V(d0>Q@em=}L)uW@7OWZ#KRnzT$7kEbOu;$zpBOoz{isO%xo>&MCd?40
zs+3nPGQ?{dV}{M)A_|2k?qw!W<!UmI{M((s@Z5}+QH;9O{OzEa%d88BYX_Y{6J6|c
z+H%2x5I&2D1iq&-9Wl>tE?-@(l{HTh(H9fALh)W(LbDY3R@GxUj4(j{(08+5pesTL
zDL((`rV|)0q4(@G7#0~c(d*iBWmbHgrsr(Hc`0c!g9ZQjNk%4C|3u>I{JUK>_iM=%
z`OgN%)7e(n=AF~VZyb$%``xu6@Jj|O0F0{IXjQsl3BM~Zt=!PgAk+Q-*c;j04&Tls
z!<OTonDZk5)+K2e+c(ue)()0q(EmVe1N0W)Ao%Or-uii3hr_73<_qKM2>k37tMT&g
zTNhXTu(1y)xV+re1Yr}6?+OosjE%QNDG9+$M3$Cs-M{<Ox6L~3cpNb(Bp0~{@J_!%
z-mMsDzd_&b%DYdHa})Kx?LwWR6|2$ztGc5fKJB4zx1H15K=@}~p|a5eb@)@@LH7Du
z4EtN<#vER@QVBrgnH+&;0CO9V#{I+*ByZCHY2tb~b-HWvIj~xOrbyX46mIek1#f>~
za%&M*p&M7CD4sULMq8O32Qlw0kYkHL9C80mxpcl`#|{VJmCV<cOedrfZA^U;HlJUO
z^1?kek&|L&V+rlBM@Ycn#tCt)($c=%?0*MQlbX>fT2WCm3GKIW3!Tx~eYO@P!A(pY
zn3Ywr_EPmWNXIqmzMxFxwV)z-yWi20IqbB6dGVHUag%I@Dh<p=b8W&lD^HhTj5d+L
zsaQNt3a?{$xs@_JEPPu?oUvYS;4A2MsVSw~0SpvUy~G#rXz>nC^I#u2`A`B30}(V(
zTYDvFYTz2{j8SeLZ${sm>z?BxnMd=!MQhcFan509rI?u>D8E`1*oB1sfJUVr)$7ql
zd*yCsH^{n)2NBoj*9}4lJbc(a|L*i@T{2pfs*P+bN#n9H^;b7*SM-mE+bM+A99Q#f
z{<@!&{3F2C6|dgui7%}?pI4KR!7ZGO|JM8CAMlqJe1pE<BN=9o{V($fHg*qN0LiEY
zdpN3%1P@F*SBsmbTCj}6gC+*LcsEtiUr%wm93THDDs7kS=a^qNlpN>A_i6mjNS(V_
zDHN76GO)Kv3#WcRezcrMjT@1tQBxRS7Ra<Z_GcMP*SPLg=b(c1Rlm)6KAjJz&pt@Z
zih$l{G=?I;2GOo#F4uJUYmBW~HoX$l>WWaapeITq4fsPEI_v)T+A-n^tzpgOM8fh)
zztr7=P@!A+F;XAt<Z0Nn_o(kPw^+ZEc@+Jc6?Zl3kI*CR($t3dw3Hw|d&76?D+8h8
z;ALOb&<npzdFp8CP#(GTno93|nK%)CpCD&X%cJ$>`~R-$qG1qOF3s2FB@}7Prfn4d
zt6yNggGAE73Th7x_B1>9enRd5HUivwF2IH#R_vZ_knl_WD{>eBLju$fLv1aRwlt!N
zCYOHMO8}z1CKVIiTFG8>(%8s@m{L>RnzYu&L5+z@XRUDMx!e>rsKh`aSWc%@OMfbQ
zKJMcpL&O5BTjKQnRB8|<OkP(w_gJBzEfTG@QGbF&&}rw13Q~%33965a7&1afOuqID
zfiMHcwzSij%v&>wiQ3WTtEK_7S1udIka7B6MRv`%@G9gF+26s)%^pM9l!U0vX5!EF
zi)vg5&H!6c2k8WF0L`M9$HsJW#-)`itq_&@&qF06HVaYJNK2zzgu~ZkeegC|>EInJ
z>G8=mQ!gRr3nelS>+s0y7-aAo(!MZAf-@AZr{1q*LPW#J@f(cjoc043?!=|YX|GR|
zNSu&g3^i!Xh-7p7`#OB?iuUq3bthY?>4LFD=rGkUP^s${E_XOx)RcXEij(+Ij045<
zwieFwK|=Po@X{+&Dgqw>nYlJRw*pGh4Tc(hclq;!OdB6b8O%sLoF;uo;Nu!L@e&T_
zXo>ZPwwRld7lKuB!>FCgZfjRPKt;t@m(03Iwt0nyIcL0ha!DkNDA%6DDXMOtVrHQI
zLU+5CL)Kx<{}q$ssKU#xJ&P1&t~9GD>J?q+i$Asjc0D(E!W_v@z9=ZjdY{wS->IVb
z{3}Y2GebK`;vhUnkgGatP2%cMd97CHD!o?3ZzTT_DoagHiQAA0>-xCwl*jk?|8m_1
z2*X~;*_SY5I>}tqw?n|D+G01|Si7NjJZur7)xm~PeVSqp5ABpE3U!LYy;$9%?Q`A`
zFvlzM>a$@6;MH4XA^jZ7pbDS5okX2AwbC>;1imBdy{+G9hkp$`Hl}>MVWSrCI$O%}
z>+XMS04OlDZx<GBT?_uT@^%;~0$D4evLFZ-)k_q8<NI?{^<B$2W~E%t5+nXV8c#&W
zQ(cU`y-+%q6YP=#I4n>X!<2IBMf^4_NOCWtj&GJn?#BZZ*Je)41lV*2><)!R`<8vr
z!jZ&PRUADu%773_D}QjBa&O76-hqtzBeh8AG92|485|61gf<5>dUg!XE<mhi`B=;Q
z7J%TVr|ydO1REwQusVqYi|eOh1th7T49kJ?%vbN|BM-`vM>*^|uCXg^Ef-dEAKBBl
zXjy^Z&d?J27$~M)T)Z+hsb<Z|p*Txdr){I|(G(x#m1{Bo{0bU!SY><%64{4BM&;2?
zG@yd5F`<iIZg3h*R3>#~*DIXu)cbV4${9jjVqvKt9E2+-!!RS7vo6ynO|#+HPPs(-
zXZJxN#PqOS4>SKH$MD5Mtx?yEoIWA(dkW<YJR+8DC&v=SezCQ3ci#_YU3mT3-MGZy
zh#jn@WF-c*6e`2=Xkdt$$o9GdGsbw#r$yUns;qD@S(RrIl<WDzgif!Kly3BETV~-K
zw7_Rpusy?J55xwbuh%y?wgyd8xsNseI+X_n$eol_Y3`ylvGJh4@fAa-0H40_icTie
z)=lg1FS&Y`WMvyY!q-?VE})V*>kor-?6o!4A2M+x#gvUv^O6YBd<`f)*FTTTAD;N$
zW`q!3W>>CS;Xuorl;r6S`ORE9l6Zb_@~c^6lR@yE1LCDC*=c?mJXBzh|HmP|+@fE@
zfJ>yeR>koOj_!;K+0=TD;^Na=5qsBGYOld6`0GUe+?ort#=Zl#ax;O8P?yFzj!pO^
z*v(PVB_nK6nHm7PY!a{Ei>BNcQE&QdH-<MecmQy?l}>9LkFtaiMZmFoxif&So!vi_
z!JeW)HhhR+;a`!?YnjnrhLRkJ_Nm^ntsi-LbIqi0Cc+k!56WA+GU|Xa3arRaf4OCB
z6^UigxJ!!bD$~|n3q-m99@%+sZTXT>{)Nt3KYoD*ryh3OW3o^(mPWrH`sc!F!z3#V
zN-MN-?E{rn+&<VU3S*1Mf%KymQ9zF=&l5TIdP?8<b}1SWd%%wLBfq+ecwPpJm|LE!
zobgQcB)%hjCC3a+qXgEadaY;|IME`+;_Y`C0T52`&UlM9KvS+|;DqF6Vv}J=1RG)9
zu=Zm^N}Csyq*;o_$KtDw8qW0Oz7}~1Z=JIsSdJz9Am9Dj&;bfZ{^r!~OT^(dy<_{L
z95fg~ACYai0j|x=D(v+pwf{LE2^-gr^mgVb<CoXhEp#)PhzSZjT^IkpD^yS-Jw|%6
z<_=P~-lZ|BpE=$yNb&ZpR}Qp4=s*=e!y757!eNL3e)u!25CPq$idz$#WiXPvf^cG?
zH9&!<6(wR{%NQIb(QN47<8<M6#_;wR!M`3JR<z56QXuOj*2X;9)FvbS@=nGQU@5up
zY{uCqh}vep>EDk`@$PaZ!A<>V-WdU7Np|s=%F*fJuE|G9Kz&x>ZVpvdPh}tSw8PVP
zXx!GOy4l!70k-MLfuV$!No2N#8z=rWGY`!5VzUvrOq8;x9UHvn_PfgR7Nr1#+w@CW
z{A-eue13~VJ&i(>wvo!Kqw!RVhqmF7S^L)B>Ov=|lj*yV{&>N4PXVL11<H2|bTEtk
zD?d<vReXr<;kUDzI}Jg4(ZZzmeqOn&6pYIK@+jUl_w=cCKj=(_!f}Cy39F>bqR~zg
zHK%})K%!yjgu8N&sAPfxQXFG(!_!x5-Dj8LG@8D98{e}L*q{^XF&)@<?Gt%A8fwZw
zyClDfJ4Y|2&N%BK=pNq1eW6PLbLV0u73~twH+R<2kmeGZHkqn=H*MO{XvD{oOMD`L
zlg~wx33Os5)2m{R+7}>oXI_La%$vM(bW0xebQ;rm8Rm?W>pp(k8R#cbHHeo@+(7yw
z=Z^WTR_&jCa(^1%Hb&DdZ#FUk2Gx0yaJ$0|tyZ%=-TIcUu~BMf%$_k!;v&^&>&7oO
zMwq7ROj(GQyWS*z$^&<ab>(Tw-=7x$O~XQFY7OR!DJ~)OSGMElP@IEiAnkF9rl!d(
z?o#;c$kl+f=L6K^+0uR?Yd10udbX-Vv;hqXM|3ou#;!+8-0IJCR`qlmhFXjzJP%YZ
zeF5;Z_a;{YAjf0Fg~1{ZlN-{GweEDu9>?N)*Q{!Pcb^}^qk|waC;q~VDhoDky%@1z
zOX2xR$JMh|RWmf#6BGeV$fx4$SZ+x3#ksl}Z<2@Va$nZs>aHDgb+7PPqgYy%#=VXf
z`Z`Gqa=E`Ao!h<Q<^*j(4GEk&SNoGy0v5sxIPyvT_=z<7QHCkJ7R$HIjlGk%{Ag~l
zK|pV-IU}tP<MBz}+P-Hxgn%szc55~TL$xA4IGVa3sxXZ~Rp^^KfNFc1YX#@BxU*Ay
zRuU;<%qwA=-8-9UNLp6hyvzW@^2_Cq3hju|_PSyj9!f2vgA&60U19`S_K?M?gebhJ
z&)U;>91c~xVRS{A4AH8;+#Q)z?=SuP@?tpwHda62IFHMa?6+Qw5&vPq(<Zyt2Kxp0
zArGEapSqL%3}W$8$=`|Z$syB~V7*yZ?Chp~RyQNYq+C?lAT_zj>v-f1{{tmUnyW$V
za2JeoNlor?slDk~8cZ@-34#y%6VdA%8s?mH3EqbaUlXgljo4!EtjGex2{~NZurNX;
zIIpyT7D9x^Fy#IM5ng)M0ko#aLf8n{FnBdCqwbK?JS@>;cTj|q@cB@xqZl;L=35xZ
z_ru(|UCNFXe^US#E=uT!1T<g>Hs)&PvETO9Tx5m#Pb9)uaU(ADEQ<+9a7qs9*(V5Z
zF0Gsz16!mO!ZkFvaSb}tMWd%<Od~x^NDE&TN9LN^ECBzNRG9G1y_Gndqort1>oL+>
z@1J#erFU^&<Sk~GnKaXZVEDEGM6}m4w}0a(3vpm>mUml&AI2)_w?=G22?>Z((fb&F
zCosLm6&`CxM3~1c+THp_YwCG&4#sp>e*F{8)tX50tt1z!P>%4S%k~{Uq$x0@N}+I%
z`B=KK%NzfWgAPC?kULyO4_I&Asf@^o`5>j3dubd489gbZD7<2-&;6}5Mk$_m(1;tz
zP#zHoa$Tl#A|mc%pu(`19OL6uJnIO;d0VvB-Q~E=7I%_b=x6<WV9Jc~XDSM$oP-G;
zY||u~-?)Q0Wt8cJP3dR}Kce5g+c2c<!#CUr)@Q@mev??<)}s5nMaKx~&{k5|BGc>m
z>@or*aLl%^M!@;)X-aN2;A%oYGr*n&=2hZkYR%95x;w2!T=sZ(1<KC`FecCAg3wv=
z-R!c;@M9M25sA#mjE^X%@@Bol7W0UO?wz>H=Dw<pWH{~v?J@$YJrW)~4jL&aa%Jm8
zspu<tinGb_*=4<nl(q(`6hb8(?G<z0mZ>tt$HeEAg%kgW;@kKqUqOPcCV|W<wD3Mw
z!-(&@(B`f<QIoo?BWx_KqD}k#nj@BRo9)hy+z<jsvLQ^eC-%z){R=l!dD73|6=~r{
z&Fz0df$7fw7YY*yc8$G4IsG0#I8}=xSw=UtQR%mYL*FsB9OWX?W@6JiI`mZ_`~@sV
z*ZoLUxPf2$L|#)48W``P=h7WjV_6aMnR>QXqt<RhtW(qMZu>3Sj6(ca#(k7O)UiYo
z1JY=Ai(`s&D4j&aCYmHXwiC?=PxZu4mbZ!*1A=;ffah@L**D~F@N`ZBgs10&Y6jd%
zO{ezSv$tTPx0Nh|Vd7dyCx#tzQTMoz#FPI}46Tu2M9rW_To|c@c;HTp)h4&aTDWxT
zyoZ4NndDfOiQ7Ykkv=t1cHHS$5T`>qjj#Ju_-w`o0QoegGQT#1fJ-2FHgF25Z34-M
zmxX2sLZ?ecnFVWT(%dvAm8~0zcS9x(8~N!GRWKZS2FQRlZc`W3@I?CzPTR?f{%V&y
zm85^>w!dI}$X#%w-3qpNwREY0tP?131oU+NX$^tgZT{<!fwDEZ&UKZKw({o08S=N0
z=eH*+w4%@|Z|JOG*b*+Z9Ad};k+?iR@sY@&vO+)ix-ZO41L@quBW6qVzzX+8;|d}R
zMI1QigK&cmz@oZNwy-~#z$by1(uAMv%(@V&<h|e=8G;GS0Q-2eIJdgI&GI4K$+sXm
z+O7HSBEZ43#;|!{zbT-lM?~fjDP(k2Y^@!=mBH?`F!&TD!p8C+kQAHhJ=^+NllWAq
z+gnMxkb1T<Cn!kYDB~7Y;VpQoK3Xx>zaubBsUb|Bs`Bq(&fbY5WI#QZaRm~PZt0;#
zNgRtHi<!UPB}yQ}Hg2OHeIZ$<$Yi`agR4`0IPkN@;TE2<3WTP+>e=PCtQV6ZWduq9
zILAo}D7p#{Ll}Q5g|4&5h7RfEfK+i3*7N)Tdo&C3X~0p_4J~XLVazWYHQzXcY7jin
zg8?!XRbtl02eNR=ACeQQIF$G=d$2uH*8=f&!_WWhS_59_Oci=)G3CqH=~mxEwbU1^
zk>>_N2sO_#@QmMDsazD(MTk)iMt5#ZEOL5N{bl#por`b5Eu=-xf*za0v2oep*)F>W
zkt2}-hHfDy!<9oL_ehiikJ=cERiA?Qj7#~)9SZWay#wLUqa7BD;VNm}@n|XUS-5aT
z0!|6O(ctWs?7;@9O03Oc4na)c6q*Wl!cvq&v%hPVIR8ADEgBJ=;*yksr{O)17_Ejb
z)WLb{s3$F`-}ejC9b;+A^J&6iqs2c+QD;}#YL;-+cRox7HIZ<}lS3Lmz#f|9$~tI4
z)r#{g7(5WhZh-ZX@BdkET748M0dFwl!9UU;#kEQ{SUjQH3#s<NUTs9ljx5#<PsMY7
z>31+S%}-z79(?!hA)6v9Z3szuwOg6JnZ9eBl+$j5`>Y7*Kl(LV<A5heYR#D&E<A0n
zlT5+OPkxnSz!GqvMOHv_D1ud{EQuheeo5S7kNhLx=2$wop$OzWQM3TkX!3n;_0=gt
zVD7M9acQ|DH3T2*iPSSi!B~V%?`j%t_ZH+N3(@}DvOb<-hQXX~{@kFM(hqsTmv?pr
z4>X*7gaR<~mIqY##2ZRpdhd?M<k{49M$@J!5k~@pXg<YlkZ!>R2TIlEx_PdVrUcYU
z+|ma!6wlNWr+T@6SLEoof9E1iHdq7uqp0R%l(pAFUT9l|CA&MiIjiADr&|@MpCG>h
zxi5f@9`5{#HqVqRw^eg!d>gLrTqA~=WF?N4EN<%%KY)d4zS<02BsN6#bKdX`gpT|y
z5K%~@!u!)fj}a<gYc<7Ql<SYw;=zsII}4%|Q<Bsj=)02-C;F)J6~RBs->)HEWp#7c
zv>fl%CP@YVd6p^OSo);t91XSb9!Glx)xT?lb9~Deg)QSxtfMpbe@lYgzgdM^yQ(8W
z*U%e+%WsEYPNk2;#Ze7hZG(&dCf^n3+4xS6Mx*peEoxqR9!a$*#zCN-vY^Z3#4=+V
z>d|i(u`f!>$jY7ZGBf6ELXLS|W!+fg7-yqQ(8ZffSB+>f)~~K!igPW2n%U{gZUh(N
zbO6<R3S^>AGs|R>ywSd3ou39S&{n4l?|Z6T&=AQ2y)gHxg$Kf8$y99#Vq2`7j1o;x
zHl=~i<Rxv2FG7b*tlZVS`75_jO@vFjvejNC%0?|%&q69NWrA+*IH3&1>!NU61rm@N
z0*{`#{V-6x7BmRpfLS-}H0}74XPD{O&R98l*Y#lU<eS7iDN*^p?o|TYU33Pyhcwq~
z*U%kZ`T{N<Q45ev2JA`Q$jk7*UDLw%*PX(RQIDUW<+y`nSINGB6S^?WLivBKx5wSx
z6a9*ee%Syz3-U2PPO=)1*uyZS(Zy$++`L1DTOVhT1TF;_^NLy9WOm*XoUjzu>m0E{
zV*dvDOJn6TM^98PyFBIFURw`dPDYgD<vFN(T?7*M$%#-AdFL#MKzwiBpYq4;9{jri
z3viLwR!Jy=9;_E>M=2`fD85}3!b0ze;a0#TM^Ys1!v$RuoKMO}OIbE32kEfz8yBt@
zFR(n43|p5|B?I7a{r>oNKXBv=SucFfi~3lZX$b&4uEyTjMUI+8hN;9f`~w8aSfJKc
zR#)2WCHF3piF=)PY~9ukXA$?cqp!`rId@z2DGgv$vV`TDaRI4>m82f$XfI8&FrUo&
z+Rr<rUF~ZU!%au;s1`tJy02P3w_yL165k4&A6BS;I<&$tykdk8*=Hv_WE#khRbv40
zees6y-mhLIE-wCJ>`J)YMm9o_sjH;EoQt*9Ek`Q9Isobr9ByJmkp#*ta!)cm-lX|{
zBPK<ghiL_INp@HI*{K-A|H|y^uC6EWjbzt3zp(r_mKG(k6ygq&OD#6$gN2GiD{%Qi
z+i25#h2QC5@*gKjpKYOA;~g4~w7Q~@!=T=UA+%05qGJerp4L1v<^|uI4@Bx}@3(&o
zEua2^&jN$#R1s=V&48W#HPaq)&-Q!}Y5A*Z5rkQP*%DCledRbDUwtNFdtAl_p|A#a
z@oa1pq5vF`Qgh^5uB@b`5&=27=Vi^h=>@5&29}L3orq(wwG31hnj;Q#b;E1)Kvu_&
z$9a$gk|dQDQn1h)0Nvl@$oxWVcDtW!9-#22%4z0mAQ0SYCmt66($SwF>-HjR66p9`
zyV~rLclAn4)5^*h&bFcVc4{8wMoM_6$A?1AKU%xiuqVd3iZBk`PMFa<8g-OkVuj1K
z&>0>s-S+>&?V8ZB9<Hi~W2D;MLZ7C<!?T7TQug-fE6@w03S(=8`2hP3bv;FwD~Onz
zJAVwWSo!m||I4kCTe-~Q6zCO?boEHQ;x8r<#qUG{Q`6g7aM)B@lEO_JYWu98#y6D$
zorTO_wyewZt2R3p+{u&l))@szqp5y@5T0+ce`Ey^=TR}^63tmpwPG^#U)UYZ;jOmU
zocO?L=@Z38ZCC!SXBp>UV#G!ax8hAXFEKNWi}@|l68N$qo6_aZ&#bckOoTVQVK%c~
z?OoGnsHyL<Jf~SjG-Kd~q$qDQ-In!j03h5*LgCMh((2*~cM-fPS1=S)S6Tx)?}7O3
zk)35cbOF9e;3`uAJX+@9ofm<9q9g`_&=o>uQ0g>4&Z1>E&34iQ&>dwXNftA=$rm80
z;9nhTI64%cOswE}vX;n#q)GQjyK4LXy^-wok?r3|xw|0W@2&=us(5qH2Fqx=zXMIF
zOrxmwpP8Mr&BXYDi(8|TB4?D^&??T_AotZn%&-wgmfXosw@hpcbEd)H?oF4w%MwD8
z;Ohu0e%%z-`H?1kzgC(~EHcO5gu}t^1I+v*QCW;1cG&yzTEe#u=$WDbp+CS-up-^g
zVJi|weFB?u4?U-L`e=gUn=liQ>|0eYw)4s@()@`{{4Vh?P+z$&QqBp{UjZ&=u0VrX
z%W#*N!Tkt7J12d^67yyGQvg>wOhZf$KC9lWxJQ~uNETmW)B3|lU<svpWkyQq_r{{m
zapp^4%Hpy8U9I75ktBZI6BqeA<uc5fY$PqKCY_NurkpOY`@UdF5AaqgJ+>JTc^=BX
zYgekt%yvEge@P>$KwUUry0F7;GewKHfgbETaR;7^gcn~DVc2~MJKjrCRE(ixhPy<=
zY?TCkCo%PAzkYE_u~Dl9tZd+~vrDRYy{VDQ-<MYjyHzGatBQQr)Nsz&nu(t>O;wIa
zNZNoX{M0raNgPouN2_ti)Wgt=Q0wNK{>D=A`x934f0N9?8Seg7TU#?3dED7ua3rzS
z2)y#Ze9H~8P(UrPjjNli^v9R(T}^tg!PsO4SQJ|a_mp|R+grx$P1qDXku?o^=F?5(
z+_8e@efa5uc+)SXFk-Xz6os7d`FR!h0xnXK>rhb<;Iv0_Db7b(+a#zT0SSyG2xC5%
zJI%o#FIU_c=9|pTyzFjNUgzZ!*uicX{0p4L=Mi)hQXr+=B3s`Eq6(Qgc(NNrOc{&o
z+GJVmj>`>6n|55b(Kkep;0yhgvoqzsQA->ib@&;dso-jV(ip>SVJNF{HnA;aarJwJ
zIV{Z(>(!oEa0Wu>_6hP`K*3Vohs@8?38B8ck5dDc_=u~vwUVl;JE1h7<%BLlqS8v}
zmX2c>%I&jKxEchi`9pFjeY_XT8Kj*uT51xL4R(>pM1@Kp3xnxXvCE+C@Ce3GisXzW
zIsG`Q6}iTnQdmtR4K*~j6d^G1itC`ts$y*B&Biv_Z*m8?oA_SEIys@s#V#|F2JUw5
zuEcx9p+y<M=7U(!iDA;KJ?t=*E!mmlh#_fC+8G=8zZPRlx+wc!#&t7UD@9ru`FBx%
zYF7AVOaJ^7jQw@c(#elt*v@ZQO_y+$F*#ia2vT<CHI=^*2heY&BMZUs#-WN_mlusg
z9m%80`ORolYF;*K8q^q~ty9CKOmu8RSzP53w3Py3oPuS_h63__owSZxI0#EssDe|=
zl1v62wn-KFU~CI;Z>^n(^6mjS4qa99d+=7I?|us~2w&!@vp4NU)Y9Fr6{8K3@|sUv
z;1H0cWw1r}fyqla`gXT9#|el#DTpCGV(sLh!@~tcJCF7??l280UgaJ;U-YziJ2|`O
zvKoTzg(Hwh+f9@h6C!Hvun;tv6(YaXaWTqyp$H~T!g?>lQ%(fuFx6woW`_mY|B;WN
z#d$&C>hG*!nsI6j!=Y$FSz}Gu3U;h<x0ftDg}G(DJr8y5Vp>@l=xED%x$79#Kf=O~
z4E#_}OxKV7g<$Bk1;V<A59m+jKD|5o6zO2;AHmc3prdN=o#=jvS(YHd*7mh<-?>yG
zSDgBz-7>AX>B?FaxjkQ->Jn9LS{mL6LoSQH-{CS6<sSw#QJlqj{0ZvCV#B`TwZ$KH
z>wWR)N{#J0S!9fDXqaXbtk~Cq=vziODShcBq)0pJxdn|Uco7UY^2JmorKOQSR7ygU
z<9OcS&%<#I6~6KJ)v$5-Som@vVt%e01As|EZa8|MJIEK~!Ry}5AKOW^5HlL>B)_jv
zfJqt&kTM%`67>?I9JtBxi<1DM2&R>{2C&gT1Y~j-6x0T_oh)3CMY=QeN!U2oq5xgf
z3r3B6^m=moe?wl-bAT8MU-}7Bjg;<xbE3Uz)eQjIM_dzKGp3kfRhQRPiejESB|eH}
zTu(hQ@WN6B>jhJOxIEH)pP!tFOcg$S4bH@i&ZG7SCp{!N-z`xlZ9+=cJZ_+AVUoUn
zdK7vc@i68^R+9FdP3wc_!%_a58AePr*e5Lhw6t=TO#iy<C4YX>%7)cugKE$3Un)O~
zycjJ#+5F}{Axm>&Jb}wXj;d#28jg09CW5k(PI+X6dgq#n?FiV(KzfH)rtJ#YN{il%
zt5%o^6xzsz)&0~i5r&7{hA=V2<N{O-q7&}7a$kEKh`oRi{1s6*htqN^lT2WSYFpDk
z4lG}`9Ohcx7;I{UQ6C)AH~0X<^h@D04|`GXaf|#W#05-eEX?-#{<m-@o!n;53n8WL
znpy)lF|O6D4M*F`x9h3CYj_Nl0%tvzhIzv4;KJr4usiElA~b}xE&1x;Y3|q|SdMCV
zmHvR8!oz*5JDWX%vV`iCpFRUiU8Sk}ZhIyL3{RAktmM(wbhOEG`wbzKC_vgj=?|Q>
zp=lF$>Pr><?*tFM@u||{@G7WXM3eSbSjBDz?k1jhRX%IVt8Q69MG7<;mTbhS97|+W
zq+^YR4mbTxaq4qg6ZPenzEC$TZR+!)O@z5ADwPqV^*on4l3t?iZ^6W?@4@{*J3x2i
z&{H39(+?S3LC}U#ufG&3!uE&O4ESxiIWHQ>EVRkE&=M`Ilce^ebXSn}S;$(YC?g+S
zCJGyfOkj&k;d5$VfheYQc1fWrm4JxLd#{iC*ncOs<Qq0=6gUOWRBO4u__Q)G!WF$b
zqwV6ceAxx9j&%F%;5m?v((RWly-k&@UKx*FZ6*{wiks9n=l!6n(Ku6#WZ2y4PWRlY
zmXR<u&oX;uugFo4ENlQI!wS<P?U*JD688!}2?uxYNN;)%oW*aGo(`!`=;l^A)EAN?
zkS0>1D>dZ~BIO#d?&Z&fFsxj$@!I;<@|_)jPRFDe&zHMlDLFOR87piO7soSJ-*??k
z9yJvQY?blQU$2#ZLgF)4HtN?lTlE^`^wJ@!B-JUHkC=KWFwy6{(QoqMwYwpo5D^k!
z3xwS0Q3=1I4yB#{&w-YQD{X5rN>1#3daAJZ*eitR)HWv0?u8%ZQZWyp_BKY;R^FYw
zWfoz=vu%)jfpY!B?DQ9G$@d_nYg^!F)e4s^n;BujsS&SA@Y*<JHe_I9jV0C$<-9^@
zSgwEIgIO<kR7~dLG{ZIaavMd__D|b?p!sJTL0k{#GuHAQVE|~zmz@vtd1%*{8qA(Y
zZMpS+q7)~ZS8w-eJ=BpC6CCs`7t=QeMD1hN2P4Ove-9FJmx>W1A?oX9i+}-L72W@D
zP$HJZ1IJT+w~6n$0;4RffVI?6GyDbTd01u$4?C0id4j^_&rrHCg@hx}rnhIQf#rRg
zd7^gKiTu>9K(vCQHRNYL8hb&xAh4^L7Dk*QS%6UU3+A*Pimvy5Yzj3OIRs|XY?+L7
zyt*fNX*U1qmlGtQubLDqc*H(1cfoUe0kM<e-JQ1AlczbkT{=0e3iu*9-ntPZn>3?(
zpYO)MNmv4V5z%YevM&4DgwEZ;*N|rBsts;V3^Ew|qdIs$29dk%u}aYCho{35d8H;0
z=i|=~DwCMHF$RH{<hm^#pV$y6G=T5bIi#E*wyWeXg?9{@_p%X7XyTCmd&;B@`Wb&<
zaf(skxqS&00{}Q7@RoF()+w37tO$G?1$Ww7nsWpDspb_QF<4y%aD%QO0ITs?Fq$GB
zW$7b4L@hGmod=h`Fvjt$kJ!$+_WCU(Tgs}{{~=cu%QldPQsv3PJz3h)G;F~}r1ax|
z9Gr6=H90Kldzpb3Iz9=B9gGY7TSKVNf6$?QQYjjA-_9+D^NbWc-`lZye*de26vit_
z&1n=C>s|Y)z<8ZuJhg*1-X68Xen!(`m7+_ym8BuFmKx1#o3r{GzIqCWQy5>`ucmV#
zN?#_}htXMVuPxV*zJ?uTnbgpSEA&My?^5@l1-W!XgI48(xsoPy|23U~BX{*1iCC;I
zY64cV+b6SJSw;J{=r;6%v^LGfQ`6wSJJF^_7c0r2moH<uoYZae90?X*vnJ(=Xi~$}
z`+`<Li$J-uEWrhL?~eU15$@<cdq_|NfSkfNJJyV+{T6L3z_Z+!|D!<4S%~N0{2w4@
z9o!L?+W_Ig8ZAK|dwFH1nh53Qysa>Y#wnexkLCYoio@p5cNU15#2j{M64Ej5Ae(@^
z%)&Gy60gM39RZ#Uwepr5tSuqur=a+!?$ef5F8u>ql9!Ws1hnFjdG0U#Q1_&(B#(oX
zXG<gl42^?822ZnkYx^uC(u`Zb15F3!K~ncCB|SHdZDM)EvWE~X3Jn^=!3L@}vvv!7
z<9pm#dJNu4Rw;*?o(Yg5qsyLKh)E&FU47f7o74{%VGLp!40!;T6zRiUF}B)WGAw<x
z2`tr1Cx2IOoO@DTZ+bG*rf%&?7cX!7*k6?m0~6`*O{C7*LtA1Jx24dDCaaO<r$d3d
zaR420s*L~S0-O_jRp5B`mU^uR-y8bXau2@TO=%_<I$Z!HaZeNl?Ys%*6sU?L22F-C
zm7BL|&4BR6?%2y|zQ8eEh~AQ}Xa*q^!Na^^YHeJ)3g6qHu`mMJHCs^jJdZqZk-4<J
ze}Dv()lUL~e3F2Ebxax$t-jtf#wrZ?X_SI8v`ui#6cB?FLvnbEppXn~G}qSX)e$L<
zm}<lD3SIXk!yp{oDFd(s11zcR<>l=@J;T)tkI?mk3u~9Sum^|oMNVNDhKIRqoR<34
zlZi0krK8e95UJW#eHA98Jo5PbdRnE9zFWgv2YvzFu>=@t6KAR09~4C*yK)IF$YA3_
zOz<ga?Y4}sO;%VYuU+;{5ok~=AX2sd0At62_?u5JeJD59j!v+_-}-uGo!n#h8{^pZ
zaTdbePt6{#3e45?6`YmL2LI!A-~&n~n5Uql(bLR`o%KHh{(`P=A1QTsjF68XXe>=$
zn;Gla%)u$DrN4He*1qIOS;xv|YN$EfnOJ-rZI!2GdEc{^%Vju+tk$Zg-F3~lLnU3v
zWTYVt^nV8LzaxfF7C*1=TU>EfByKXMx2!k@n{rg2NmJ#Z{T$SCtqi&8gY~!DC}C)i
zPjB0qdRL$_W=L4yt1s{#A{yH4sE$R7aHSO)=8so7=Mmu`Pp$cZY*-ik6NuLqJX1)&
zL4?rr>%wgY5x8|}){$BEy_DAB;ZiLd-!(KHfnDa@z(VevAf@Vp8U(QHl|k7V76z*$
zoWFF#+QjhdftSl?FAfv&^5&yCfFbwV-m`Hy>`NymN~49K*c58;N2E0ZxnXr#h6Vew
z>a>W0Q;Qwwe8OgGoLXLT89!EYwXXd@){Q^~selR2PWRZ_w1hQ(=CpJLs{A|bP}<*&
zS@@^EJ*e8LWs;@)%E}@$VYRKnrcR%FdSz8dwbA;9MF9rK8p21wvgQ}WO6%Xge<G&q
zoJkED$qC84`{0ZvoB^06=hmf+(PD-WSns3>Nu8eQk&|c6m089E2d!y|@WhST=C$Pk
zTM1OFrZC8ut}M#mNeLV^i6Cl!g*KcNVB~?zrsCXK6X*QH!W31B==B~;RrL2`)W;N@
z2?kXw*iUMFdNV2x&zB0ZHGFjR^>NP0WkOvr$Ew6Pf|AP(rd3t-yKq)<1MHnqr~Rjk
zPXrq6I_C9Jb;>yi*i1UCD5Vi>q{wleA9u+)Q!=~qrf=9}YKg2B$_qi8re{2JlTHHF
z1Qv={A2>TJJ*30F>2|CR&Qi|(=3nD7QCAEtSl`nbpG*-?bFsyl2JcFX(T`4!usGE*
z7r7(32eJfB5=I@;D`95Qm(aFg!19>836-9J%ZlNAm^kk;GPl<^_^JJ<3ztWmJsAIw
z+{>|2si5E=q__k{O6p{MlA9t#slBHJ;71X)qrWIQ>-<L)hM+F}i4Z53u?M>mlv(-r
z@{J!QS5Nok)X?^lk_!w%yXtPr+x`6Z4++=)<qUh$_znsB%#gVNZZf@2K$lo(e4m*e
z_kNIIo80Xc?w^;<!8T~$CdiVIBzlLDJ+4<Y*_|n8J!3KaZfwMVB{%VDxPpIFY=`Oe
z?QPF>UZ*ux_K_VpEVa{tAQK8ynKz8<G|YXaRV+r$9R+4mGJ(nw8fRW!^<kw}P-?L(
zyKCPb2)g=3tJ}T+e|t*YmrjsF!MY`vvTmzTcFZO)8Qp!ea+M658CyTlWQr(gQ9|xA
z=Bc{~k4`kYxN{OA1*NO-@bfa+WVyY_oSz<e_Est@Cm;Q5<J2mM^IOd=)#JT&Gxfqu
z?`%50*H%ynAx$)?uDqhY5Ncb(;;kW?xwb$Ygb)K;SS}-d3o5wA$_zfmjC7*uno?~n
zze~6tNiuRkaCmfO6h;%e#DUHypc11`^ro)xUT)PgapJ7?s`)=<GRLy&)G^PS3|O#4
z9Jp=^nmM<lAozqdl+?oUUmP#w4&o}<I^qL<k4Tz<BT*g@l}JYiDr4v&T629T+iH~T
z(}<c)CotzSz!g`}T&y}Jy##9Bl4L`%Ps(tjMFs+Ldioob#0^a-o`F7klr31>!4RAH
zsO3tYy|NIRD}Eta9i@w|={hmAf`TOLxw1w9hmwd*lR4mko;r6zxmVKS8a$_Cg7I2S
zGr^#4{#?{X?=fc`#g}dtLtbke1Xhj%JVZ;y$nGL6`=Q{hp~HV@O94vljIdLkAOO@h
zi%d#*gmTkn6g)>+-(`XnYDDM6V4dfECGlGg+xmkw*5KY+QJ-)Z--%RdYfjc;FD>g6
zn_jKcf!=_-i5R2ZO6-a3{!gD-h7mOqejBUBS}rAvQ;$>2&SZ(hv+JqNjxvr_5&}Oo
z3s#GOK0iOX=#vK@x$hHw4_KElrF^#k#u$!GY|!~|p9{{eQ1K45xAu%)@{sebvVYDY
z5LOFQ6~rqvxdMZcb|#{Fx_1#WlXE`OX`#`dBlMgI1cPopE%%Xf9}IB4y`ljYCx4?O
zPr5d}IVPH3!$U#T;TMvrB$k`#t)EBerOlOKvP+DiY#VmQ!v1vWjxk(fZE3-E-I5mC
zC)QXk-6w<hbKbG+2FSden7!ogAI0}?J0VBr*h(<JsMJuCc6q=TP%+S3e)S!v^GU+Q
zRd23eb(7sA4Q0q(Jjz85RJ?_a=q(*t86+%k(=aIm=JhGv$;|Rf3e)QRCi`n?M{`LI
z4i@S|_m_>hHg{un7S}9|%;el8Y)3`o#}khpR0@Hi{5tYt#V5Uk?0dh^Q<sin8+VdJ
z6lm<_2-%=`2g&D1?QMSkR6eOgq0HJOVHX?gwT%DrEdg>(sx;#^(hH;OANE+HX3vR5
zKv7a#Zj`vs7fBVcID?XBsf7+;0>Mo6LT}U6hpS1RbwbWg5c?m7dR<h3g!678j6*pm
z{WX!#z(RbVJ;*SD00oeRd2H)BVg2i>)_YswJjjqX#)_#g-};UH9kIiM%c~gs0eNpf
z5~J9eK0k$~4<}nxq>K*y1u5Qcmd-fg$+bnX+kIbmzCn472s5Utjf^fXn4W_e(j11N
zz!+oTVwVxrn0?-PVGJnfinKC6$ME4~rat;Ci|jp7gOCTiMb4{98MXt^GicNEe&h-=
zGHz5!rAe!A<$7qqE+r#HRQ#)hgVCV1!F75f4U~wWGqt?D7KPAXxcoVcT!6=^00*!T
zUDY&EZfB(X983BB0*US*hj&MCDwTXtC-F6utIdWdL;?`Ak@T1&L&y2iHA2_u+ei~Y
z0wo(6=lT7=9FEfGn;avS+=x#)TXtHBs(Cm~=*RR+#gtV@U<2!U3;y;EAvGUIrWYF$
zweinL<5;zk!R&)vhTTnpbvb!hBJ>KA64~HGo<v{pu%D<ShkU;LYNmV=S6L*MNc$x9
z7QZg?N!1YYdgqq!c6!Ja5teST*(&$e2ef?kK8OYT`+d@zPALO?H|*qH+;s^{_Uj7M
zOL#jOWUA+L<xJ=?M}%$IoKhNItcUQGn(HJ5=lVToBxA;*xl-}~Q9!Q0(>@eGm$u?i
ze7eV7&B`FQfL5J*d^R@ma6*!Iq(ZXo>8#8o8==OdD^AC-#g@zlAa;$6v?LuhG`8GC
z6d(#a)-{yr_Ws75Fhjq_8=lBDfgRjW43(h34pwZH?@eSLZiyP-M%*+qrT@un^Ktn5
zE`;`aj-%RT@#R877Io^4u2ux16;yxtNDKz8PMBc+@wU9hk-sKbrDe6+ihi$iQ!(+d
zakAe9!<2hxk;nX|agk$Gi@B6p59B%(Fk|~0OQ#yc_?^###G6@S7^=-_yRbW#%(m;T
zs2m?u_3-8x%_cJ7-v320y#asU^Y3?OVQ8gk*5=p9&dQ#D?wx0<5qDWh?uTd>6Wh(0
zGAjL~DT=tJHte)wEcfumHT}86*m->VMT;wG=T0(Z{Oc<(`(mwZ$nI4QF(9i6K~EG@
z19Q(}`gE7)UohjwtqJ2zD*g0coOw2wqMQYlh(*agUmeU}&2!~j4&GiZfLK$6(OC`6
zX;0p+z<w=TVQwX{6B7KNYP~&>NGOJ%igSeHlp5+oyw5!2*VVd0t9_bfSMf<If6&}u
z+rh6J!Se}dGaN$z-zAx5g)yl)iwWUF#gm2)<Mp?x<`uxrGTFP+Wfl)G)*pN)I|fUc
zlW_X<%-Olco}bxYu5s1AS7~c7>6}+5E&~=Bl2PXOKoRu@TU7r<^{x6!G9C(X(Ug$e
zUpa{g!ZhHcTB5Py-F^;dhL0+-xp6k6=Ra{adc|h`mSb<c+%BGmB$G$8PW8J8jQ^69
zLX1+7tz1wIdfvtZB7265$BQnz59~b00Xqj7^O*^N$$=778Xri=?+~VjJe8k=CX#YI
zk51jeLcF=HOPKu_X!QL)IT}9M$w%WYEu#HZ0D35|1r!W_h(~drm3aY#`5*CQZXnXq
z;9x{6+>5?~qP5QYe3K|Y0rrFH>?f>jKI=IkVn4c~d$ZhW2c_pK#DQ;{cghl!^>x3M
za#2i5oi^+EY>L+P1V7fc?Y2wR?pQfj3`7>pm76s7==G8|s6XFn_YfvRo|W>N)iLVG
zOh&Uw3VE866%b3Mu$t7da_WX6>K8k+Lxdad>pr0_=t<sroOCE5eONg+ln*&w<uE$E
z6NemiquV$XCXtV5w(99H{tv*rv_DLNSG#m|E#`zW>Q)b~s4y2CzhIA(yU*~yMIwq-
zpwO$Okl7=&kooztvr?@1h8!Px39>i2Q#EDch=@HA^)`2h9td6{*9deWnobKsne#HN
zaNc+p1c(7l$(PKIwEAN4cx=4RvS!G(EjsFZ0Y|3)50nT;<Wjh3qSI7X^+>P$4&P;(
zu70x>uBpFA-Cj(O9~BoUTBbU<Hb;5nmsJCPDT7Xpq1V#DSk~pm(UW%{xqC>;;%G}v
zS?)r7r3UYg>58@TA#Ykv`dwXV$T0}ekSESDnLK^VyTL{&=47Ag{^_04QB33#fiYNy
zk~dMEtdEu8h5arx(XW_E@Y~7Zn6L?_V7mr1x85}NFEp};`o2qLe~_pyVUaw4tY@*Q
z+5Pc6<wgH2|Gl3PFOQwB6bC)dAc(qrA)(~oWZ~pUA0ggTVA1U%#+4^J6zO2caOc9-
z^w`cn+a`4FM}vRFLwX_AvS1DjP^pQMmwNLHX3NbRv*Qq~KEj5Jo5!xI{F6GLuA1|l
z=2evLL3i`M3E%4?;f24%weRQg+(r4g#IxP}!;Eos(|CvHBU_3e=Y!6hoVE^JC%?*I
zv<FJe_DV$l;xeG33vffN5R#B!FGQS$3nC<EAD$<!A-kvJI5?M#?>Yz;awy6eG}Ip-
zta}>D+oSET-}jx=R-y~gaT_-j?4=_>r`45yZZxPL<)u9w1=pI{6Ev!*PGn|kh7V+x
zE{6TM{It<IqZ!ilVLEY4wdGgF$iK$`&0&c(_iioDaWe>IiSI>%W%MY~d81o@`uvl~
z9A-8wVNrH$GilmiA-#uHq?od-%elFhnv~H?5e9rl(XycNnn3vF)9Rk1oz36BQi2-d
z#3l;v4VzExOFn^FSldF&P-zR27c8)U1c5vEf<=3Ndpe+WtiChxB!2Td6kP9=DX+7W
ziH`V?JZ2jSCO?8_q3F;{<zEU)t0q>}(@$Kkjt*3EglT^cf7Vts&T{ZJbWcZy{Gg10
zOCh3q)|uMgD!Fm?P;Sdw&D+nn0S7eUjC4h6+k4;3!M+)yU!ap$Em%1=uUoYYh#fP!
zB;&QqELVH5H8CXJ0)8M4QVQCQsZ-%%j6P<^w$LKNMCU7qTMWp)8|6q$5#=hcXtGG<
zjo|uGcwV=Rq)ga4@a}<Vd~zx-u=c`$2TJ|B0&wwGZhgYf^-0hOhE|*#clZY_RMl;Q
z(|U5OM3wFHHixMiF=1sKIL${-uJNz~*AK_x%#ej?aKcJH%Jl!jHG;&mDcZZP%TaPj
zOMS0*q3MwHuWs4v2s_G4ElbhwuvGwF^1gklU023JdIo)DPN<FI0d3LbebMtf93-ut
zQhV`q*U$>`7jK}3oeBkDnP8N1DvS$t0k2=n!_cVv_mzUxN>J<R?cI7&k-~xd!(7Gs
z@Nzofz?aov?C@6P1C^VEgac4Nl-W^ng0qs1MpcHh<o(iQoelUk)3zfT;dn@jOWo7y
z7Tq3u*}wo%q|!TKTv7<I{VWw`5X;U_(2hIh%Zy&rQHuPXOWdwWYRE3%#Qf82qoXR?
z8UUwa;gfJt1y6HjQDN^JOq*cMFPY1WELIq!xX6SPZqk_{J$K}01v0^}Kk?J$Sl57c
z##sWhpyhkR(Z$MBMkYFi!W9}Pn2R~O_LM7D?!V|>y9|m9E4iKj?bM#KxYHYNwaqdE
z(m0OqXaYysDs2};zZh36%F4=naESWnTn_l0xK3`NrfB4N9>`$COm(j`J@0?7$kbk<
z;7;j`<G!j!t1t!iQbdl+O$N)j*COdvZCdU<x`3x_igt`(;;4Qt2p(p><J_V=;GX~j
z6jA1wGBV<n!Wpl_PrWB21t@HMVdR*sUlDiyFGfgQF2upGDvS@;D`>!J-F@@y{@$<s
z?n(w7Jr@m#qHuI62%@#SAJtD_YAIMLQC=$hSl^cTca+@-nr_I%gwm$3g5^O9YuFx;
zYE*hQIWSg<b`aqOqe08{1e$~$L4Y>v%OT=0&dxBDuul5dqHX^Av>m4VZtpEOUOg2o
z)HyA82pJU@Kkdiyj!C`#u4}0i?TlFuPv{GrcgJGGpp?r=M=}eeUh~rT=U-X?_`!}I
z7_drp=HU(=3@Mh`iscD^-CRhFv3dWPtMF~eC>w)?a5|ZL>6>u)62x&q@j(A6o~GwF
z9XA;*CgL~+MQ8vl1=w!+xv1Aiq^oTx!cPyz9YH})x}CivY97>$rcwYD=f}c-R@C=T
zH~<idHw-OWTVWP0M=^?Ngm?>jKR4HhDgj|J@XCwZ8ZU7O9CJLlUA?@LojwfeAJV8R
zl1w@QxtHpcZRd7)Eu3g=0yb;~B$ShbZ5+GHv)D%)OnXhG?UfbrUknqgIO|~pufk03
zDZkTTJ%!^L1ufIk#9*9@W{cl@!k=Fhl$}~xAbhgp9VU=RB{<DjH~L9dyqJLs`_@t5
zq(~QnGG<@uLf*B2%<%7x=l$0u#i$U&qSPJ-LXER~2NJvZevj~$ttR5?#t<wl(U>T^
zCMCL|P~)Ph;o}(H&Qz6PGu{QwOf4}?=4@Xl^<n2L>MtD^t3Wg(`e_k^(^#)iedq4x
zfVZzDTb<DG9lKyWb4Io@&~?g;LM+>jE%@VHn2mUm3>caT(@DY%C+&)n!+6_U;%(`F
z(?_+j8bnq#5!YKFDb5u!)la>`jNI!v@43Yb!Pvb38Q3e;($73FUY3FJNCx-o5E<~T
zhFrgY@$fncYo>e&(J|F#E$umX`l+(Qm(mEIZ;J2#C=l3-b!^%97ERL9^&w8I$(mBp
zDu2QqF{#}}1F6-i-YAd_$p`t$leN}5>Q@VU@FihZC)y2I8iGqu{-?^p^71yy|6Q3$
zJlGC6)<-Ams`--xYm?VfXpGI;<+tJ*Y~^)fu6Ud73nBsZBm6%NiqJ}il^~%y;<5vo
zl~spF+>J-Jra{5)WtaSSUHX;4b+3n)-l(ws%_?*0V|X<9b1sSJ2IYksz{Lzbs4u+g
zk0bnKX$UE(ZCofWPh)2?XQB74@0;f00Hs5g#WY>b%87^U4TumFNblo}ipn^fTdQEK
z_oTZhbxxrX63h8MH2x=WlFH;PKAfUL8biK<fF+fOOETd+rivYS!cy#kbRjV)h!e#L
ze(1D|ArSjYq%tE=JtfQw677;sp}Y$mu}KH#3I@T=J9V`GQUm4%FK6(jh~0l&8zx<$
zt8i5$Yp>O+eeapN>sMSZ!G$DgZLosQ*^xXgxe!g&s&yVVp=A7I42_MZ9hkgRk7FTY
z_2<tC@49{iSaOa|Jar%~Jb7*?_()1nw)1SK&$w=hb}I%}!(Zi_KU7bt`rVD4^I8pD
z%8=q_Y#j6$*o7u@FvCxOhcKg<DC8S|a=hco@(@^^L=l(<#y1$mp3q=9yAkXDC2Lkk
zYtVUsqEmTB9OX3QK3+5N1|G*_xe7WBGrOjk6B8wPNPA{)KO=OL%r<FRWUUzK@xRx{
zlP~eR9tp0KCIZn3WpWWbdQ>(V+=g|ogYsv$fgHdrUJ}N0KdEWD6vz3KG#v=ohJ^1d
zgOblACnSD{1EFgM<k7gT6GsigaeK`4-5Hx<Qn~8uvlzS^Xt|`6f%LakAsB;_M(h)W
zw+NJSx9wx1f#!+TM;-EokaP#u6uU@GHv>CG`nKBm1B|}KD~YZRzE*phajQ>G&-I8C
z8==1uMhMk`-5{<OH$Ah>g+n}gKT}1W<qMsyyeGbZ;iN5_skJ)Fr6%^8_G!rU!wYR-
zka0sq77&g*Q}P+8pl_@Ij<H3B=A6)UE+@IJv9#D=w|&JGvmd#QA^6LNcwt+{d<G7c
z!jAfZP$NG=K{|hzvfqvykz6>7_`k^NGZ_kz7mjgVu#P&(L)nuhgBeMKWY(KZnS^vg
zYnklv%Kjy?S(LlX_(R}YNa4Ydw^38wuQ+Bkb>CLo>lc7XrBh`#(2Dl0i3!7AxC<X|
zp3$a`R7p)dsM84JZ6~@$KrL8+N?@Oj%SCzaX-$b9Pwp}!pnk~#QiJ&{23?WqpryC*
z%WPqHP&Hh+!*S!H3)1eB4LBmE`Elp5nT2P!94wP>NeteyM7~OHhmlSllJ@LJeH-B9
z&}aH@Y-b!?`Kdh6^@rKl?CyL?zDF)`{}7~bt~`bp12gEt&}<wZZKI+pbP0Fml<oIu
zax_}d6%iX21C!p4rsnXG`k0U!E*+AtUhplnUzyr(l*9B=#|e&unwT(*<KY#jdE~-e
z=#%drD6?XLFI<cU$&{Be?zOO{R0E<U8oJosw2KvVcfIKF(+d*Md_|QllB@L?Z+QJz
zc(k5GwW8O7Oq*>FAyH3^A&_?btJm|!yG6iabM2@Dy)BcEUhT?46C0IPW0N?w?(=yb
z)E2b9qduUG>&jsTT*U#;q8)h<T<lAzYxnd2o-9bytQFqodG|b+nla!=oGW2J#C;&*
zpf|pnoCkqoncTXLwupmdP0ld#m{G78DiiQ;G~|cqHgdz#4m*a)NjfYEcns>z*UfL{
z(0LPv$fCfOUEh9%R*9_NI@xh%8-(8(X`=Kf(^z4IAaz#~+O|ygf0*u;;tTSb0Sna7
zgSj04<EvUU-Rs<jFBBz;6UQ4a_B8oJ6V-ND=9qLTQGVGBOJ7Kvshcxn?py+qzP&o<
zaALE^f?mT;5<BM4A__&XY*;hA$C%p*PT*T({il7NNFik~v_d8xYdeH?Y-yQ+bW>QM
z629o{;ix6#3))$jjBcjcm-$MOB6;84&Xx~ThQM|jg>7P-pZPmwzd@|6E9E6RG=8jd
zO}#sa&13}TSce#a&bD=@`E^|g{Myy0rY5s`V^cYT|I@t1{N@cGgxvpQNMH}>_PS)A
zA0*kK9)U8K)Fj5?gKKJ^bfNWqp^K)=a?dW9vsG@zt6hsv`{Y@sV?qUm`egGN7o%!n
z74UBZwa!=b(0ywcJWJ!c(sHmEc5K<K%%()aIlFgqv$M?P`GSP5zBx2m=r@feU%v%r
z_>LCS78B+CZoe|#AXtyIx5c-!)YY5k>8>VM0kw*iGz#bE?>BB{{0<f7tZz8FPc+!y
zsOnv0cbokL#o|=&lp&d^oMfxkS&eF!j8V?6;>?ONU@37Yy%hgoq&4V&No(&GZ{hB+
zx!$k!-rt?WJCZ1<Dy_^c5PKNJ^?dtXL=%xlswx+3eSTg66*a?=2LigJF!a3+l78<g
zQvvJ_Za#tbcf!vZTNV#~Y!LaN)TX7X3o%N*O*K@vZ4^QL<~yT1i5tRhnfXB%kC0c3
z;!#?A$dsQQpg>D19J7@O7fc*0P;+F@F=~w3>a>nP5e10Ve}NzijkAz&a_<;`d+)6Y
z-XC@4>yNvwg{ksd{a?BrnUb$ha}nzG34=83gB?rGl=Be-$ruH<g0QFHz=7-C^L~Z0
z+d#rPLbA;S2}Py8{_ZsfVp00NM&7~q9l+#(rc(oW%A;k3;e>jmBgSB2BW6}6SAB#v
zRj$=+o$ZrsYxt$>!((4urIejaIAQ#Xw%?>7lR!)m$l-2f%BObQ%43}f8%^zO27X~s
zm^{S!35zUQEzRax4#tBpu}Xhflf$P?$ph1&uyyqwrg;329=6p`%KZOj*}J%ELTW(i
z_pITEOG3z~R1`XtJ;U9W;3p3tI2>D;DqpB6$?=&7c~Uym&v=6#sqTdfM!v09%0Z@Y
zfva6quVpM<wl>rAu=_XZ_$na+&gB^m&F%(-DOCyOQIbTLX_Y6)2^3-T(<yp^NDY=2
zv>fa>)aStt#A2i<XH1@E*}<^Oo4C0u>;-|R;_4mKZ$oh5p)f#{_%9UurWBZ3sQi@Q
zc?uQip6o+3rd&U?TSG&B#4k$R%7<5pD}(NS>-@}`j47l7h1DMQ#6Pq=>bnk<`Fye*
zfRts|J!ItGs8D;3_#s+iLCtt!e1z?e2wyi<y19rb_ecY4XEghh_$U{wML{4p2z`gD
zVd=@gZ<*H@j{+pR&pA`vi?pm$m0V$#A`mev4RDRJ9K0Lzg4C<pVY|%eezg1JsfZd!
z=u?GJQbN47TYC=4#L)(9g1LDY>sZFi0z+my^X29yA=ZU#5&Z4g_E^OXLp}fRNf)zg
zK;JD?YmezSvlr4^61XMdN}|xB5v|9`-QL|l%${EAg#-N+AXx$F$zFj`h?E*g-M^4n
za1Cz>c+A#c(1ZI3$m&2I<_QqdVmeBv)p=L)+dLd|%ufV>e(e1poUs+&$U05`oY6x~
zEBpsBt^XC00u9-ZXaJYXGQySx#Z0TsqKbV_XvCV>;lEn3F?gpC4$0mT_{5NNw`~zA
zsk{7x7BM|ZHkOj_f+e|te$$zCLQs=N7b5e3U!>T3>zPD~$gQk|B+=3vPfl3V-hjA(
z6?{=r-2WVRqni4K>Fs-UzAkv`2EfTJ*GIMYW$l_yKoLl{3iih8gl{NGbHR1RK|Sh`
z2U2c=jhi!!_k%zFdb3BB70SVa;9~Sn<IiN9c(iQaH_9uZq&Q8-!SmaqWx9CyEP2+x
zY8dE>#bTh|dlg;-!=Fmj$G}G4JgZRAR(QcgjH{s~DeNac=IlobIiqd{jelaLmq~G^
z+e=rL@kzJxwg}`eO9Gz!!>t`pkTv-q#g?_w9-5i?tbm?H?XUWNG81QJX)x<4jhe16
z708&Z_lth<dg7!%g(ppt-KGh0%3rBXR_XfL&*dd2M=u%R?)#+h0AZ0(2sHr>zkx|3
z&}h-s<cLsqIJ5}7<9NnsY#o!xDM$$;_?ia42bu;~E+gk2+W8}o2(DmDFwW$H{1Az5
zS>O9|N=XH8AIE3A+=4>|1bH`rm{HMX8{Gq|QYDY+KU!vH&+$j1zQ=zx#omhTC}M#Y
z5kbE4<jy_g0ogdN=FP2G_+3iezft=|M);wIQDuPDPeoKqOTJC8GprDY3+?!;V1Ahk
ziz#Q3a@cV>bR;&a-m?JOHQv%>-<3Av1sWzWha#=`P(cpStj<~!_1h{9YH$!ip7EXp
zXfY-t`=+W{RT=E0g%TEnAsNFrA%=9~MujTRpvE}Q$iz(3iY_wF!DKTej0fBbcm?U-
zimZ9&X|slacF^3hjq*~CCSBB{|F1^7q1TW7Nl0dYSR&~o)L0>i)sJ-76X;~Q(g%im
zrQ9mX=7Fp{__`Q$35t(UqL`E_MlD>1%Cv0!;WO4iwCWRv0p5-?D;l)_3w6I6G*iIp
zRN1~&OP^Ky)JPK9x6!ZhURG4;L%{tvSlDtc?w!IH0PMu`6{bl#@kuCJ?4Y7?cuJSu
zZ960To=TG8bFpgm6bsKlX-a3IB^5CXTa?-IcqFx$X>YHts^&zXI-!5pcH-6eYnOUs
zAl>E+jXmy^1cMGX>MfxNSDjwB5hSCXf$2Zdt`N41!yokK*qa!U%x7+ZtrIBC6el9o
z{{#Z9^>1?EIDN&SOgtit_UzZ^p@KqFoG0l7dzQmOcA|@gNLyz{2sAwf4qq=@Bd;Dl
z)$SN*2qYHgR%nM<XDF+j#1r%mipNtk17P40PkfoS=l+F(VGspVr~tY*%EpDRJdk1Q
z3IwzoEWX+KcNT8HTa7)>)`(aqx+ynb=*H)FRi&^k9b(=`eu61lmo;Y{o2l2#V^$<0
zwrwYd?6L^}qgZ5Ls0Zi@+IcMa{-g`Cx%G<<!Ss7=w2CJxjk-~c?c&A_VoAffDlWVI
z)jeFamn+Y41wD&rkiv@NFBaohuu&wOwg@;(1a=rQC5;oKA@OH+NORLoD*s4{GEv@(
z&#9gSr8q@|yoe!|dWraWv(cS;^^$*VDQ#9a+arrgO+0#_Igd4=GZpUlj&Lq`oL9ZA
z#V~ep=kg0IeS4??0LCyZ!G~$#kiFl8JP9;*Ox3fA`FInDyT~NC@SSQ8?+ZGi2s0>l
zvePwlChi;*jdgTIN3a=LGcK7r^*M;CLh@Hp0`Q8^|Kt_=RN7^fsHD%H#;r$GVW*~X
zuqrJRYzcI4zJ$f9nG2?avuh#MqnBN^tpw<%3Hghb|42REXq@2$bWQdMAgUoHJq}z`
zlGaEQ(J&aNU+i(jo<VavzNL*@K)OwF;BlU9R@#94BNI5RQ%dp!4bX?>1{miKcc`JU
zo<W?`w=6QlHs!GB$o-`T>Yian{Y~d@6rqpPL)=i_f2oJ=gqBF;e&?LDd1Duv;9}e%
z|DVb2Fr`X|afZnu|Db(2yeTi0>V<l}=`SfLxl@Q|3qmz2r6`bN0dSp5LL5Hfz2Q}y
zjvwTk$)`{&DR$UdmX=2r%JJ>*zK}OnEdmlG^DSFJ#yr4*s{%loB~Q`f5?1-td0tt6
zS#zt?_K@OW&*z(<hgvAe*tM{$e5h$GB5J+f%M2*#5a>S8wx`hb$9k!(4@Z^xBIPNp
z#pCkJ-|J3=VIRh0{ul&n1dXi|7ndgh%73B33IKMD)Niy%JSBY9`Yn5fW^bW*ND-f%
z@^vOQNSYfpeY+X<4_m@bh3lDg(SfRH$n1s)M2Vt~>F+~wGtuIf?nG`j%!h^&(alEs
z;n#nuxBQ+uV!<&T5qPt{Kai`J#|afjGK_0}V^Z;Z=TLSPW1f^T=z79r1QwL@fBL~i
zfCHkE7#5nZ&|`Aw^A-xDb}TqX;qfU8bHuFUTIECJ;iomBQ*6(VS{vz7sXG?Y1K#FS
zNhQ|2w6>nX!zcvOix8U^a5van>%3Q>@^`~nNM|?wWl8*omTA+$@e#*jb?#(qvF%Ue
zy;oh(fs#%okub!QleGg>w>{)`SzJLua9ca7(F@5I-<I*My0HEgWC=OWoe(jeu(S=-
z1>0*a^`*Mm3M?YDI=v&kMlj+h8gDGVMt$NK^ETzez@rk@&|s-J{x==@Xr7?s*+@(c
zc!D}4+!Tj%;@OiejTGlD-6h6y0X?eSqXGgeUHvN55TpY-N{Bw{NvFd?k`bI%{p7NI
z(f=Sy^hWk)EpB>?3Tm6Mts{r3Oo`chLrU-)I#)P5NzZKM{qrWK`}33cgxcv|kDohT
zE7ojXL6tM7BOmA^&@Kewa4%aO)D|#C3hXA3#L=u2DT;lXexYe2&GXM*ZR_%fQH`tm
z4^o<}+)(w=Rod83$Z!jJPm~s!txa5(M$}&q*WTpa$nSq(4IsN=-F0WSybvYFIbhNj
zvl&UdP?$Xrh(ffGjoWpHD8S5m3SWEh@gX~@M^HyZ&WcU9dK+!KST^`bLOKP+-5o=f
z%~(ttY#=UWH3O85b5eR#YN!e|gqj<Y@y`Fw-rYB$?gwyIIlrU3Oh58f`c`g_lZJM5
z4_=0x+lM@wWbDMMfYzQm2TFOu=Mt_p3a5lqE;NghQp$wr(*W?4RN5g4u8s_#yC16)
z;K5V3${Sz<QiOX-3R$0y{34$HfVRe(z~)MLHxF-)HR<vQ_$wtTm#i2(<C0e*@92i(
zzZc)PN{0a#Jf!(S9J~mur*Y@bG$ur9`T1Of?@s9Syhh>yRY<dubyeIb=y!!UWJ881
zGrca3Ik%fD1J+0#!!yOYOV-0-Yx%`<8u`FOJIrS_XScgR99SmU=#i@(!gG{E6dI|p
zRuU%Osn32a8i5VUuTodH(~_s;<(VDJs3f8Lfmtqh2#nYnYVbB?uMvJ=a-<yJ<sdf8
z8*)Z6YE!0}VlP>Fth7PeP&i#7`FMeiskiGWg9;wYWcLhPFR4P~OEB}FScpz^jElel
ze39<86LY`3*MT@%f`++nm!L%CWroaqkAI;k$-H)@rndUOiqhT;L68raOz|JCM&L%o
z9hd8&VwIqF<N1uZ$6-@!82}W<+c5N2Waw}xa$pUWQN7iHsK}Ubi+5D(32F2z4fT>n
zl80gsEfSQ5Fu$nGv*AaB;3?jGR=q)v&CgNSJBVOHs?&b+f`rsj|K5A*k4gxb(`;Uu
zzfCBapK|^7vXn4r<!Y7aDMUtR+%P#BUOgeG>P?b>sG<c;<n+vO(L>)J5rl|+7}(Vp
z15sob;2yI_d~zrcGSsPDCHfQipF?SA2*#_vdmc65F6u~>e;pDl7UxL4$%p1eDbM)~
zWRXK<Wh4o(67k3WLS~82k-#_?_j3oq_zxz$o420!;<X}ZDXRa(QpHSdCn#>E&>N6P
z8(Mgct}d52Hbk4Rd?vRG2y4xkrMyrJ6D6{>>@rd8yD{r>9A>FiYNIT3KZ+5M6`+fI
z4M&vfSY_tx1dp-*8%>>kIH)Wq4i<mS<hk!sDLmDt^WShHGzT=1O)`vFUdCQTvh9;K
zib7?G&{fh!+H*Z3Py4@^8nqFIpqJTWz#O~3f9{Vh{=vv>?QdVFkw}n>DzZ(`&_1U#
z4t3mvwn0M78;GSMLI7gVBQAp!1SW&Gy6TclDQ1#WLUC^crcD5#E|4j1ze=d(L=>)G
z)zPZg&7G(X7vVFE18RjshiO?61LI?JN~*|~p{8c6aU1g>vA2T;oMs5rpVLaw9=avp
zOvci#b08kvh*Oi+Yk!XX_D#{W%{cpDa<;^jbEW$Nd1v>`<=}g<;I9z&Q>JPZbrz2v
zFm<A?6G}kWQ4#iJFZ6?P82|OgQfgD`iwl1^!Z4x`oRzO|u=3o5RQp}scvfs!($Ptn
zurmeS0W*5F_am}8jbJV_hPS+ZB$9m0D4}cEwH(hl0fzG>#~nzhCz@#e0dj+nq7kUu
z-O+J|djTgE0!QeDROHI|d63mY8{IuO6Jfc}Ft}oMst&B!qlOxrDA6XWjH5B+V$y(y
z(Pyr<rH{!frWz~Jpy$qd8wUn##BW<|+->qFY9S7=fxr6jyDPnmMAG`1sNY(!*0F~H
z7$tD1@}8~P0j6^=>>nAf+<v9@69FO$s?-N~0R}}#{j>TT_XOdUr4l!K2%y;E5R?(x
z@?Vp%oqsY!o_dD+_pzF0TT<vh`*Vm<0a_oZ!U6jPa+mJfa@M3bK-#h;p)`n@-&FMD
z7x(F>K6)w=Y3|zGjDnlzq(AQ1>F62FH<SoB_%n-QD!=j`&G<#pTgM4`X#3Px4g=Lp
zJCH{0A2dpOVV8za9G9vcsurBjJhTF+M+SQ73$6L7kSYeFDGOL+^;vo`Gcf#<ogB$b
zhJN-%=a&256E%gYkQA1`xpTHI9Qm*1<+7%pF1&N`Rwaa87p>qHNoFNJkr_dZ<rBE7
zV=|?65`;kO9khVPSja@EzCG@%rCy1wart2eRxeItEGUuIr)qat!zf{teAzq`i?cwa
zBEGqWjUGrX(bE$pj=iFM#2^K>jZ!^6Zl|>pl}&qVVR?zE5umZ1V5vgX&Eh%KKHZh3
z5ORUXw`S|mNXfz#`I<yk-S^k_1(t~SvzB?HfQDPn+(~6^Fa8J^uadouU<w?1ht@y1
z8c{Y6T#<~dSS!Ce2!@2`acT{h+86$I_jY1eWc17Xm-1Y7gy*40xcaHyWxui955Ae#
z{7g?d{~&_M&BQY#d~;vH&W)}LD_-4&`N8oYURU&Dke!`Ts({rwy892|x9LIXp;XK1
zlM2V|$g;fTL5u_RBA80^BeeEjHYW=&22YQ}Ubdd(zd%J<&oQEt-!a$QYR)kQt}bu1
zLx+l3;6y{0xqIz!QGB0wLP2i5OkH@wAUB4A(9uxo*t(qLcEjuIoey=ts=U5%fxI9u
z-x3k4xNATpsnd0nyN}wqlFM)!Dw5VCuJX2_{<K)9OpOj_(91V6H2~Jjj;>^QBz~H2
ziMH#8y<@=ib42nexc1d=>KCR7H^(jH)H?hfI}Wz^BBHIr<AlvfmkW_8TQ}?)wKJlG
zLL6jFdb{^^2+#WiE&v{#D&vHaI&rJM1dSvf+g(*9L~x;ngiCcI8LP#KcEkGB&_<il
z%@GZ_wMLO(&lv{w;Lat=<v7J}VIv4gz|zS<9hA;bPx=o$vAIQ?dUocTlDxG6ey(i&
zNhsuM0dVMtGqTQL^=|g!jbUp|)KH^-3Y}L5c=~WrLKd`u5%S?xXGB9|-K$ygHmAp|
z%D2ar=go+rrWrZ|6<>U)SB1<W^->&sB7HxPk|3GWfvwYvfBIB`*E@SypNWklOxL#B
zxhF|!=`5eC3K@pH>LC@4L4H&2W;JH#0H*H?L@Ie2dNgC)0B_MYBJi;>SM$<6l&2=n
z!s|{DHMO6rDVX9>r->JA_M(%o`-sgf{~?$Z+BUnd-Mpu4u06?0>VQN`FC)zMV>nFc
z>rd{6xzpDXjJNJ~O>^|~zst;r7Ne(rk^xhri1v!YH^CilUuEgKeUQ*#XhDH>@&bx%
zihdG#Ei+6YzwI0e_8rHvk<L_FGe~=-uOALTc)Z8k87biRYsk7xdnsOhX1`w?y5Oo`
zd;p|-36z&Sye(5Z;0{kUEWeo;qz~cyx?1E6oa|&HG!jH=A$*RP$1!KLLRl~NIi9n-
z!}9Jis>4mmz=5QpUC<FhzK<6B2rFudY3AO5G5oc)+twT3(O1iPBUkE*X(1IT=`i*R
zChco)IS|!Rk_>f8&Mz~9*g(rfU*B2b2<n<jt2q$b()d`ol-Y~@DW$lGbDyyIx-0|<
z37oHaZZ#qIbskUrjZ>`JrX(vk)}8L@r9So7_qmT{yPAPg89%@{3m8-f{^1NzM457{
z*8H7ef?w)bMY-MQ19?oOm>ekH6)EliSFPbXe28JBU*9qkWZ9r7Fi7OYAG@=;#en>m
zV&nh-#zE9Ll`Uofs}LO$kkr<6TC+y&-c6rG;A#^V4BUsDn_Vp{ZG@bQ4!e3ce=E*s
zyJ|F_;asDmQ5`r($P~Uu0SA{*qG|SJyI8cZ=}MHjQPs_(qxAWir`F2VLd(U)`CHXS
zkoVjV{G<CV%0d0rnspYt3+5R3Pk$Km`R5O0aqYd~ZGQ7YbrLbgT7(df6$5t4Dr?{;
zCTg03Xl0Tq5&QBc+$SV|S`A-XU`}M}5I3Pw7stlqe=???f%zkr9CG-tp9{!qE1!?V
zrxYDvRqhyn!7%O5lk^Ml(BZ&ev_~NyHpw&KOFT;}$}9@MRS8Zui?%+-$HXB_u_Cf*
zg7?G@Ohf;Y5zH;vlAA8<URh*r#t5RgEF%ryUg?tuNm$=|r6D0V!EF9P`v!5P527?)
zZk`%PY0=H!i9_0_bX-){)ItxaD}mqfGxQstwIU8VQt>B8mQ9?Hu%qFJLva%{$tdXQ
ziiGZN0z%*xf3m(}yYYX;Ha**5D5U3U51})$Hm|YCXUM)%#n373Wb*?p+W-usrh;SD
zfqn0*+MK;aWUNIiOR!rImBwWgUr|aVKEt`rHJX@&BujUXerhC~t#T+Do3`rL^O4bS
z<uhoekE@H-CpDwl#~j&@u?i<TOZp+fw_B%-*fG#}8cZa^KUzVGp%1s>5rPCIMQzng
zNuFNHz>S*Q5oi@5poj?JbQ@OB+OlAQ=#8wJ5hP+&5p`FsiZ`o0>c}|ZN<+{?(2@DT
zy4i|oknWCZR-56p0BC0Y7fNh99f}Vcju>qme6%aBJwtMYKOZN(8Nxej@m=azwY`;+
z932(*s%*4Wchmuje}=iXDV2CorEPfPpqQkohtpzz8^vQaP9`W>8txHIl6}H6H_rDc
z*dusp-5PxBN_}?r-o)ZZdV|`l!eR_kUNb8Y<s@xJVwx5dk`gG}Q_u0`Lo3ukwqt&d
zUKH(OMh)QJq<mvcF)@_}IYJgo1r3C}v0vFZi~zl*KTNC#cWKTp)K(zkWBdExw<xvW
zyv@SR<#8<L)I?srZ8am)*F(Gf=OZF1>s<jKlA&o9sDD~6;%Rly!T~QZ%4qp>Jn_Ff
zSe<eMhny+`Z)ztPmtZT8_t1_q2>1FRdghzgw+|Y~D=v}ku>?RBODq}|!UJmBC2Yd0
z@2dTl6Pjub>93M1*#zgd0a$UIX1N}e-cv<?L;C|bqrvgrR6O0FO#{?c$QCmOjk8~(
zOKIAu3Jh7Mq;$0UA;Mhl6+_vh(RbT-2pgpEMW^R`7O&zevzH*DVY#2?Ro~Owis4R+
zbwiE5V=Qo)osYwT%d8V?$&ei^P;EIMt|n0B0Zp80{x#1zM50Lk&C_-yz-fFn80EE3
z{Sq+ePGQ{EW!$`~r4Lgln{miBD;y%xH!S_Q<;>oQTbs|N-jGV1PVX6)bQf%X3od@1
zp5Rmo3<Bw&QwB`pM|zVcH0#&#Cvp2$;cmaA?94$AN?pq;td9Q(@KhS+*VdNt%*mw(
z84A{yals|F=&+V>$(o&4oY=~2P6lb(PKD?S0jfwqP=Ym(Br!I$p{in!Hlj-@#)Hoq
zIaIYbxFSoRfCuZGS}u{<u;)?F$UhE~kDA<ZrIRW_=k!Ly3NG~zy$(wd91~dhe-u~W
zCi|*>n>a5$uH>cb>LJ8R(ptPMHoBz`?~_4tb~|u%Ob2K$#32$XWlS43-ei*q{Gt07
z3+K)ZYd4+^1MV2#wpqYsAjrBI@+6`*IgP(eFVnRDULfp@&<IR~bR>KM3&e(YI@-MD
z5y_FL-ChBIQ~$9n1q_Tv6XI(%^c;82+kps^Zzt3Rl%1#*UvR}y@UZb3WN1CO;*Y-X
z?AT&w4pvJ*@iz#MXWl8&kFNwLeOGG*U{GkA=bkKCQd$q^pFk;WBtvojnJjZhlM4#V
zn8<#W$l#NZo0!t;ZMdG%H0t7RzRrc*oXCTiB@E5GfE9>FA%ela2;Fa<l4{ino&&6$
zidV6n5uyUWlk1fW$I=~$0WTLUZ`WQ#_af*$x$SbE;hkp7E`gAGRwx1=T=<I*=ZEz1
zlDE+jGvEev(Qr4OF_0gJ_O81EHf8=0DtsAPkoFgYap3N^O;U+C=K2aGW$h!5b~lMl
zQQMe?3#1Pc22ON&P~>2YLU|6e6P6YiXn~>p66tqG#a6bE=TdmvX7n9><W&*RWYDgD
zGSu`M(QyDWF%6%1j*uJLG}B8&dSa&v2gWRr3Lgx#<rhdMwKrEa;N{rylogK4^?aFb
zWnF|Bh6mD23KbSMqUu!W6ihGpFY+<Ngl8V&OQDf3BZkgx0^d*UbJioT_?G6POl;M}
zJ{oO2H1C&~tR5k+d+Rp07>M+!>w`V{`@w-9Is{xk;%40;fv%vIfVcO#yTM6-E&KxX
zV*DezO$#OGavTqCBc0>?;CA^UW1kF0Eh<xpu;*^&3)0<d{|@lmD9q0vIgBf4y!JhN
zu{oU!Yct^$%XPy-4S&Q2YK%JLvfz@nhz{werM0u5kJ`xTBfbsYjn3k3OT51K=x-*D
z|J)FV-3%o0=l{$ZPnHj|S+|GrG}%9~u8}l8?R09uUA#^V16aYfUm<h~FFBQhEuHpq
zovm&LPL=}|)5uowK*?_o4fx1G!1agO&&fzi{?+pt)BeW0RI`4l$}3c$BxRKkYcmJ4
z6LiqUBijkFsG*`eoX@&6O38lI-NNW9ePwG2?718;Ng|^ZklBRs*6Ela{g$oe#5h)2
zN)3AL(id6ro}NRyouF(8iWa~aX77fF&c&nHDEXReZZpuY=WSE9<mEl}M!#!i&vaHS
zub@X++*)Y|o5wIZNW?6yGU1Hq!dEKW@TPUKw4<Ua(|P^FTfL=?vY-cvH@<uRD5`EK
zij%i5>$0VzS2p`2=l85z3dqiCY-K@ui_M>2Iy}KMe1^dNr-bJ+Nt1WnwuDnoEH$XJ
zC%>{Ctx_RywW%%+ud`>Oi$`x#xvV}H;CBUvpiK>uf7~CkRYFr}8I{UiL{<lMFPg~Z
zZ#*Kmx>otC-<UsfvB-vmgjs8rmr}K)&Y5aCrl{POTaoj*_x<waPRJ1Ph7{<k8qhC;
zGrv#a2GmzRG>4@++R2EKK{zsac;1+C;NhUs;y6}O8{&oX*5O)Hx8|#CJ1EUf7`iNI
zYehVf1EcCLKpcC+(BR9T*&7c0ShM|}ke1qb*(-oJ8TW=(R>UCscK0lvxvh$|xqXI(
zKJ9kN;3$X9{f~Ul6yj|a^B53i-2G&kEb*a>{!>`aywHjK7#pKUL;7!(vvp~<tG_BG
zEdNQg@Nm3a;y;>7nK`$4TeT)gExc<3hN}sVc#~v?RUy65+y$7MhyUAhxO;EF+WnK0
z0$LetXO98IL$w)%p|P?P$3Ji<I%|e2NabO{qsJzKzeR&SkQ-caWs7~#4ol(+^Gfsn
zjb=z3`Q_vEGz}V!Y@NN{TZ5T61TM%rRqY{*hir595>e6GSK~hq$;`^k$2@$ZpRKbD
z&L{1cR|}K&LGsaK1T9@92tXUdaIl(BeR*u>t~g5NK+=yn(OH>#*_i!U2DSW-Atx5(
z-GeBQtvXy9lz>96*+Uh#19_8zz&1pn=G%uI!txOhX>LKA3v}<p_liR3eA2k!!1l(|
zID!irdK)L-c<tV~7-mN{jpiLN3Pt~dj{iHOLyLIsfG0BOIqKYEYUCd9K{MMRs_?5Z
za*$S*-M1$;c6NP5{inFiKO?;Mt-jmN*y+fWLLh@=PjW9sB+YoR1t&Z4OwTD(Fnq^G
zRt|eBYstdT2V3SUTt(-MQkB}r!_Pfi>!$4j^E3pb`lV^unCB0|4L<!-ve9Azn5s;w
zc`#|nU?Zp1Ld6(=b77ClGg_Kt-r<Mpa{+afP9r#(gIGvw?&K&&T^!!JQY@IZNQ0c>
z)=#%42+%$2BVBFA4lg=i+UA64_7#o{=5|$5aqhl0cBr=Lg!8B7+(jwoNW!}gp<9uh
z-jZD&q3wY55+;28xXHyD)C6f}TRnsh4OAG8tSq*={MFiMs-MD5(6j_JZmA$`s2(N;
zqIwF3jF?#qY--aPcM_CpA4Ws~pK6g*anGgyq07Vy=2N90nLDrX?K*p9qN9y-HJ{~*
zC@*}yIr_Da*m8Xxg-Eyk0h>&8eXEvWX5(<4R>3gnz`%&8Sw-ybYEY+;x2aK2;TX51
z5{L~+w=~foIpkL0X<I6*<LSHV%e+>}RbuKJ$I^%0`$cj-Jb%bVElMLc_`aE7v`{kP
zFqG`r!+wa~J^4G}t6Afp^}+JM_hyILa?+UouVg%#a1W`}5$_u_`t7u1?)GEm4fQ(Z
zFS-FR!~ZQ0p+~VduQ!@&vhQOAbb}pFXkI#BBm?k<ow78oRN*oBswECI|3VWAZ;Xn5
zJg%_F(p6TcZF?5FOAU?TM48(+&WyG)W7$hMra9D8xZI?Lec|5|q?S!Ib@ZI2-8WF#
zaMl!AB|>(rRf=bs`j?uz5da79aT29I99H!PRt)>%FU_OaQ?l{FGCd?x>iG3zsHdX6
zbdqL_=I7YoN0|tv6$gf28fBxC!NXo-8)CT*!6%rrr+aIbL}aB*#<r`zH;E#Wp_jv^
zE+SmoU?~*eq`v>H!9T72>QTM!UPhD~!GQyE%(Y*e>^rw43Z*ospXaXQGHLlB^q$68
z?FKz;3<!%k-%|ij1`N@)eLEp^1tB5I>x{rDldY;mDZbxu%u2z;jU9J_q=|mfc#=X{
z!BRO6ir4!ccuzWT)Fe20rsr`Rw<gh(mKS;~^00KG5K5%Me9EuS{!%!*FbHc6Pk6hz
z(7&^&T6b=iDKRqO2b5M{(sfmXvN<|LHF37>;}e8ZVgHqs1=GlS%}~ZkvPAg$(-Hv;
zsNytazJY@6iU67~$l{<kFj7IB2fCeEbj-n29{j5ISWF-h>@ZU=?Tp3_d7oicL8l8y
zJB-n9yrm$+Su5a?r&Q$Rd~h=3*UqXpu6;258Kg(gxA4I3o&zt63M|Gii$TyriUPy)
zJQw@y49p9TVhUBV5`NwEWy=N)m<(O&B^ImQ|I2ayR;z*@Sl~p>eo0X`$~RHQ>^1*f
zT^sWbE;~ax5I8vZg=OL<wHmDZCb(BZp<X4l|JuZMM^xQwF8k>3dgo_X<y!0DA9N-Z
z4g>$gmYdu=25j$Xw`77bgxp0h7`=r6Kif%S(jd$F{Q)AF(^vj)DmL#!+{k-xtmV5F
zyb17y<KKt*(cZ51RnZV=u&s0brDn<(@-n!b`9e@sGN%6H^JD6_PXyd5cgMk2VWTO2
z8Fy&Ak!WQBrk{Lv5V5R@wo?+04p6QjS8rr{{fFRDH`SifDMW)lG&sAP_*B`?w5hVi
zoLrpT*)TkeE+VKP;u$FP1*ueb?Ygye+Nmq18M}OX_*CC4|CE;hga)7v&6)rDojwhT
zQS=Gy1b5k$BdE&Y;+A0>x$g@1*6M1bx}d3X9zL47b5>$;`u&u1<qTNmX!+-i5*tbZ
zr!T1#I&ztL>mcw{;CzZRKsLSUJ8L7jZIJnK0-1|H%3s2~gr*m-fefT-`~`>eWIV1z
z#x|+OdQ#QOViKOM+sx6=ptOD3ZZ7E-2FC<5EA?=6@|&4`FM!?IR(xx76x@?IP~`_~
znp71&+7=GN6Wgr>9QQLU0Nl~BI^oV`e@Ovv#*mAcrloc3V@40PX<t@xoosCG6OV>d
zmPJu=BG}ixWxSciu%Owg9&yU{*M1(M?^9VibzDb&5hN}U&D!I;PmUfWk;*i)QeYAs
zB{SD{eHLY3B(TOE>7go%k=Js40F$gIFEW`lbLp+J;s8O{E8dSSDC62-JErOWf3iJt
z|9mM&<EpD_ecnX=<ul3?%of$M+%2}?rY0FrFzsbW*JrL15GpNUrqTj^O_%)w0E60s
z6)RhJgwoY2pYv`a^Z`43PStGAr3)!_n+U;W$vQ(4KSk>Mtfwg`UP!<3G50cZUrTow
zoa1|!i>rUwIE1QP-w5h3vdmd~JxfLttY<Uf5Z>)74><F1!y*?Gs%Y`B)SI=_;>Wo)
zr={*IvPpWVT7NgA38FA_$c)7X$KP|H9W%YGo2@J5(IO7A!?(Ix@>QDI(et{qLJE1l
z0K3y@eF#*wM+I4|Sx<71fy!$*6sz$A5POhBogb7d^<9dL=Pkarg9agm52Q-^F1O|o
zcL$Q2I(1OX9SD5&jlki4+=W5+ScB$r(sjKsedXyrl%<4^9(VM5mw4@pV&5KfxjM$M
z^VVXtLYSJp)OX||;T^`XPV_;tC891Snb0AsZ=Df6gEzh;GH0FY0YrTRKwEtbFCDJm
z0`%t?z5OX#pZWI`qL=f=cqQnCwuz2w3D`tDbnw0~wdr1mhK5V}@1`r65fE=zD1>P6
z+g146Qk>z!L6(>XR0EG0J-E^EKZ%MQ1$Oeq1zc}C1~Of52Ayt&E)+R6p~+N=focbB
zEr(8RF1zPxlU+Ss|6qQkp2=~mHO(VKIyq|bYfzq$c>8bK7i3P2M~=LEDp|aAT$2Al
z-eO@TV&6tiRX}cWt~!lG5vaVSeAj?Bnd6{Ce{*k-fmFAMc4jlsHyu8e&sksolv8sT
zIXspvwbzrMknNET&l@b1Vn}Qr&jc=8_f>bF@IPXc+;>f{%t|~9(xs-55!xdC+40E?
z9}eNQsjM)0AIcI3Kx*Vr{8G6Wc1BczPHb05oR*50@6vC3)8%C?8j=!&^@jakV&~H>
z1?VZAZxEe5I0xgSW!Y^o`WsZJhZ2&c%@6=K(L5ckk^_J_Z3-dNaxeqt5JERQ?#W2Y
z0v~{f=zxp?9W`HAq&ZABH4dzFIsw+0y1cJyuiSxhe6v<T<oDMGeHeeFgXMd-fr*|R
z%Rnta5RMk@9t)d^(okkPlQr;ethO3nH0c&BT4tLEEP3hcuD*wR<?@Cc`62OG8Ij05
zh%8b9n1qn}FS43}6SuOkDZG1<c#0Q0(>$uW)yxNSmclab`l`q*qb}9M>X$^pPi+ns
z=_$o`St7^md_h%bN{1YbbjTc*bO!*Z*Hc#r({!Og<R-FGbQ@K%tuHBn$v}<Gv|z>x
z9(}%_{d-L{c+202{~8GmcL_to6QCLbOuo&C<#G5nGP*H%#@wr60<m#}>&+dRQa$<N
zqE82BjL}<X`;7fVNCz{Wk>CcYcCI2s%I?EM5<?gV#JJsda+Y&2ub{OBdKuM@kGm3-
zHz8@HGxgj`kxKf0HtaFk<3m;{<WN^b*=UEz1UR3!*s#bcP@Tu{AfNInfDPE)eAYzP
z;~@&NqwU6td$r^N>T`TtWzeVA!i=>9NAo}N4)wcHOby-0msMM`H7L>83Uw8`EZnO_
zk7zJ4uAfrOAw6fw)2)LbGHlgmNGJ2o>HPGBNF4@_6hioRPKvw4jXLF(tQ3)|!+-q%
zbx9cyc4h07tD4J2%#KA*M&LcPzr1HBPal6uCLz|p(-wG)-M9R)M>ca8w$!zo=Zu5G
z3hqK{A)Y!ONE`_qV?2O}UW^-SQ94?W?iuNE@nTfsbjfubA9Bk|IThMVT1a29%waT_
z$2uJUM-E8CQ^8M+oE)zgB?A_W8cwYkst6fMu^+4s`&i^1^}@!G4|du<wK}pjV!^b#
z`ZyIcfrc=|h*s!9FkqCS1jtgyRH#b=M|qlCG8jxi_vTH3uB~YBp=cla{7W)bnc`7+
z(=vo?SOSuGVc_MW=RIOZ#EDLXB+K20lc?^JV|p#1*U99>R~96itbgGQ{^N!{CAyi=
zWql?Iak8cy^6*zmZH31+&{_}Z2LVCRPq_8oy73n)mERt$@tj|EA*PfZA*Hy`6~e@Y
z3ZFmi;nMyZ%uP8V155%rk-HvjcZw<7zK83sUjf7GRlR6jkvPhAZbNzBOvLP=@f*vf
zKW+>W!;^We?bcmT=mk9zaaJs|@T$UHzm!j<WYK%Av-QM{MBFAS7Z;X*uY5J7>jz9o
z(|84docL$Y^EM2QX*e~lq`v&Va}l1{bO1&`xxapm4|$eJCiU-F8a$zSnm^{}n}J-u
zyk0AUOWfy?x3_JJXIyqygVooaYW=^)_Gf><>+9kpdknUrp{_<nX*Sji4nid^-`N*R
z3BC|wZ*BaP3O3qr>Omo0dLWY}2r(%)W9bTcIY3HW8R7^k5zRhKrkuV^8-+;2Zv8#1
zuLWJb0Qh+dc=m<T5+mMt(EKM+&2K9fLXdZVakYf#2_BU^yc%tU|KH;mx282s^fG!f
zev}Tm2D!c2Qh#3JXgUtj2LD?R3H+vMCI)hkkVTa4{8zsWfv9NE<|zK-LQ$hzEw56R
z?7kdg&!S2{zTfW#aVj=e6dt7(fBAasI~OgSk=n)YuUxCU_ND)RwQ+w2<3!C)9ba$-
z8QK;p0n%|@f-G>8S+c6@-2|eA8!`L1S|PxSw|#UJzo@R+jM)%X9)B9VVrhf0)Zlqm
ztO%sDZ=#~p)=T}9YeS|_2ObBtDzY6vzvk^v+9s+I^lpo^eHe$W*Gu~c0#sRs*(G$3
z`4;9|-h<OAsf>ltPNn(@M9gj{#t)KY6+Ibn*Hz#3iDr~3!uqq7X4=o3*5HSJYz2Qo
zsXIhadkw7R5;o;#ZPCv&a_CN}7{gJ+iUwVuh6Z|pO$(rT$Ngc0ewotaHZKE8#DzWL
z$@M}g<vmmYlb$uq3?iZWve85Pn1E1=9&Td<+=uk`%Mie?z2!w0tLmG<7W-XEaC@kc
zKdMz%ZaBJe0&@|Cz>!MLO<o!rvD9%rI*Db;zt5_qqvy~CQ%SM4u_@&dw^znNQ74%O
zzWxc|6`g*M@#fmb^tkr*b|V(UDCmo14JyTc@Gv`oN9YZ_R2<rlPiNrY>Lqn<34NS9
zPB=MFif-+I;a})9t>ke_Olw?HgBK_!CB%9*5{Vd&x=K+`yo31?Hw)y5IDs&teSFXY
zw(PTe<LwaF&>dbLNppVG>d(gEoO-^zkIPMo+DvVSMyE<qR-t!jwyL6ZXddr*xY0WX
zA>%eW^&lW2wz2BI4dt(@Y6ufIU|lHFLb8!Q+uI-2WhwxK2!Q5$X+?&UaFVDu;kuKw
z7&M#av{9VQ1odC#r-Lmldh_wy+Iru6SZ<K$dAa~&z|@8ym>M3^c$1IO*p?j+?X^~E
z`2};79HkvQ^oV#@Lr{rEFQq=`f@>e{jK_e9Gd=dUC&@<g*P&gt6AXaD;z8s6-S+Jm
zGhr4S;x4b`*^V@<W$kmW^PT;0UkaX4>&)3y9U;+E7oD+ty)+&28TuDd{K6$|LHj_n
zZzHQ7@EvUg$GXEhe<$q5zrggsuQ{DoaF0?;D4tA5>T!1uV0a+Z2C^RGWEfkq2JAZ5
zs#eussu9^i@)am!u{D~H#IsQ%dP^YG7#wCKNmJsUzEZWDFbWF_I&uYBx^~#Gp-x0m
zjwT`aHSCnO)Ouft?xGeXz0PzTe-Jig%f-Xc8uw3}q)L7jRuJ9AU$5qw)72E|_Mxq^
zSqduW7pES`0EB>4*PdU#meJ!wlb8`V?GuKA_%rIq88@6#ja*AO1|1M&KN1c#6bJr4
z$1#4rU*CYoCq(%kjF~r~Oe-N(yqJXmUH2}O(h=RbR8`j+;jF*qO{@nZATz`p2oihf
ziv1-*pHkOJJ0t=VElS&!UD(O6ylaeMJO3u8&@m}0?7CVl|15ex<oNMM%pRQ=Z;F_W
za>Oixo`+R!p(7CV@>_@-?^%_q0uLm#a-~oT7ooFvA4rbggA{lWMX4@VR`z))<IlgP
z;}g+l!qE<fVL?w6I}MiM9EA^60|b=ShcJoTOnoYG&vQv^Fx{;<U`Y8RH<Qp*Wa&n0
z*u7Re4T?kfw#Zg*RJUd;sBGol;^D!#Y=#ya31))?kI6QCKMczOid8uj28d1*@LY{H
z%4Q3a);bI45t5iD6t;~qRg8-54&CbXB37^JcC|C@le}OP2hcveg11-E*f_!G>l3X~
z)hvwx{}7tL?Sk;+Ji^*d!BWA)V)*J~<ZoE0V*(PIY$R+-*wjN|j@g+i3<g~EuAl9x
zsL4|+y!p}brq2zC?D87rOk8%iJ^ob$FMlQgB%5OiuJdHlc-KlhAvvC3t?Y;+UDQ}*
z=DbP>XY5#e^QSBZ%`QlY36wR*UQYK6Y~mq#^FX#9e`gzeYV`l4res%S)kP=dBGGFb
zoI2pLcAIS7fNMv+9?CowgPyKy<thTxqP#==Fb3VDm1rHmO24d56?+`9r2>ML)SO}U
z38VhDs<Mb>b^H4%YAGdlRJH6SiIZge6LA`7y3r-=f(@;1H#(R_$Q%_RC+|i!+licQ
z{jJpqfwtB5$~Lsf9iWfm8h*ZxCR~gzJW2AlZ{TV5Jpt-{`mO;r40KQ#ybhFBQa1&n
z{QU5~gSVdS-z03V^2V7Y!VhA(?y;8JO|=UY%RBay3le<0ZH}T%7G)Pz;L>C<*+F%?
z*1SiQBP#Y2W=6lJAE>YCZ;Y?MRfnHaN21wUr7F@V@+hw|gK}>L+hRvdgr5JOu;Cl$
zEl6p~B#=1QAgQdB#I?~Beb1hd!~IZB{Em#1v?!Rc>@j$p(<C|SpuD=5|1PNA(Y@y@
zn}di39)4e&_nqjub~;e!22Wp+yW#~&pTcbO);>CpZ}V1?vVX368)+i26!p;(qGEC)
zUNNA^bc{NZA2pzY!uz}X47@?NA!rmiMmeDuHvfnxujotFp5(l3f|6+EYjHl!*UPz*
z#}n0O%T$F7M@k52Lo{^lK@fudp-Z+cjWt0IO1BP7qtxHQqo!3DTsf9iGkl(o?+zHj
z-QbYyaZ(Y78u|`a>ITnM&qZ~`L*Gx<HHXR6Gu}bDUmYVTmn}Wg{Vubi3DfVT9R)_5
zVgk+*2w5amt;C3B!%SJo<v#py$Rk-i?qE&qR3@)R*J+3U8s%756A6;<yUQDNRpq{Y
z&Lr#a^wnm2f5(fko-IEHE*fDh(@dnAm^vEg&Vm?b*!!koANq|G8>buTNo&J_HQnqR
zSf8K>6n9Ed)ov#{%%RAWXj-WPn|XfoQsK*il1aPLcO|#;GJE+13YUqVWb(8@r5C;D
z<9y+h_dLU|68l>HQ3xk?qEZtacm)8FV4{i@NZSYplu9MLHznE?X!g`0PgE*8i?Jnq
zWqBH^3YA!E4k|Wy{wA`JN<}jiF`}yPBdQD5RvGqy#eK9bZ%`G9AaJ_W6fR|vE{g$l
zma#&HJ@O#+k<_JblB3y?X&8|C5bg@pubSb0;1Ro*u~szyZY|n6u(Y#x)!|+M_Fc8T
z-E%lJ$Hy55Bd}AFnfnyFS**bl!GyE_EayqV=CFnbMv+_IuKHveZSoK9;|d2HF#w#p
zAdqnej?mHR+(yFR^#wJ))mG9%@9)@`6Hl}T$~B@2Uq_4|6tF{qwR|ep=ih3}AN*rr
zweqHKo+o*(pulw_SAe19o9{|Qv?N)S=RFnnCAX6zq;zaj_WYLp!agjI^Mz|97ANBX
zoX7Ab;*Ov^jOo*A^%bE(YUracefC7s;EF9`B`|%C;^pPMa=GG_0UujHuVouhu+jQ;
zRDPd<b&(33p2m3WM7t+(k$);4A(MhkTKB5+;^v7u9k<e1G7UVgnU-PRq>l|Bb_V;D
zIP%$3j9#}M&Ckxc=Jbw)^v)y4xknu*8KvVlW!96$a~9P~^Xgai{}PQ%nW$ZvT8c(K
zU}Pr)+?%;|DXO3gPK{&EXF@s{)UXJ@V8uS8FrZCi_o}K4h)O&o9q4jghBc!ol{oLa
zf{=KiOtQDS(_)y&z!)0{SLpH+B_27rFy4rnu-`77_)%B|`P8k0;b>LUIC%EjG9)^`
z!=fto@wg0!pN{>^5NT}8PiaHtk?KKJ2CqTAsdV*HUmzKaHXUdLZFV_IkBUrqpn`(s
z0oMNw`zpr5{Vl&F!ySin5?5>8O%9B79eTD*F>DGEu==v>z@#&t<U=%N(%(lyg7y3-
zNHZ!eYh|NnUneSk2!cnA(|Xw>lPnh(MPoL0ajH<}16pnA>jSoCP@bv@s|uPenU<3n
zUw=P1W&AUv7LQ6ah|uEpqJ#ipa<r#39hDi*!{mZyMM<iS9|T<s&J!|!mt>-oFbRWs
zRs`@H@ixOFHIW6<9yD<e78q;>TDD>jcxdJ+8A%e3tn5>#O#{0!K(OSH8<D=y<64+J
zKnB44c-dcW6E$+@?)eYBMQh4JCo>B3&>J>sB*J-Z98SJP7O&lr_=rg=wB7$(w&;=E
zpUcB{H&2h7x^H%`wI8sHn2xh7ykt027WUGpVH}9LD{lP-y`DrgwNOzegnyCo5b6=F
zy%JFPH6%W@`#DW}E3gv>stZ;)S<h88u?XBvz2KFa{nucxtO%E7VI;c~1~GR&Uu72)
ztVr|kPo&w?p89i_5^vF6wxQ|$L;K@9Y<obm>me7zwv=upt&V@ZpB)*LTu!+|{@sxj
zwr1R*dY7SIexIZxL45?nb7K6OUEso`T|^xU-*Zv*@(8k;z-&W?bhy*n6I}40WmPYr
z_0~t5f~%&!ZdR$jZ|%nx&px1zAL`iX#UUx$3MIhv?MTL~!Z-PN9%9HPToz>56!Tt&
z$!RcP1M6(Br-VZ=0%WA0GVVU+_Jv;hfbe{8*@Rn?&Dm=K75&}N^=>wIqEoVLpa=S>
zV6~KlpDfBtK&t(RPx_Y=s?ZFXN>ZRsR79y_nyB7}1t2oljU^?&TTNa*nI)v_8FkTB
z%Tw+R*x|CTDr1?RX`TAEp7RU@$dZCG{H?y5Yv9KDbi^E<vXVRk5(-C`+-0fN-L9=l
zUeSvE6ZD<DDGkhvrhM~L6PL5J6@3x%jCc@#N@F=j0YV)Vk|n5yy)_cJkTxvILHwd<
zZ@47CUvF`m0&T}J9&eHr@IAV41ijx$j^b={ykK>AZ_?f9A)Fm!v7KRRTph+zb&A|}
zKdMB$f6i}lFH=U%#5xY7c^rq2zq4biJ&PH6_kZ#EjGHgtt@~z9E@3>XiBj-`BtyA4
z=M4<4UH=cg@Njy0z-<PCb(_Ln`_hmg$!n002{^^AGZb$T!q>y2EOXR+({*?AAr?NT
zGooQB%=?}6FtU!2^|TtSRS%!x3h(H!m4fd_$CqD0(bvMnoCeWxO6oZ9wqz|D_~6iO
zTddF?<UIw;)+<_IDNx>>t*yH1gu=AnQE~fSK_Mf<kBnh@*K7?@X<am+QoKNHkjI*2
zpgFjs{39KauY-eLAoSub3f})zD=`mqm}&MM03W)(ka$|W27v+>W45n$g6-?n5bdR1
z8awDae#4uI-Ml1pSOuNS3RHL6fl44fN2KM*Q<7Jwvikv6zOcwWlMg+v_z*%*{rO&c
zaa=6kcP^%9<-}vD!LtYAv&bTFd1elm>z)>uqZ0S?c;e2Dh4~zKdNas<3jbrXtP!+~
z6#i;w7esqe2oC#}=DRXB#&ck&YLaCC>@p!=8DWbOAoK0xdB2j<hL%DJ$8+1~LuEMK
zWrt7C1JxPk0aB1z;?#kCPkW=W<whyzf{#l)8>9{b?p(dX1gle-kEnV395~=rt;oPN
zSW~_ltIeB1rML5SA5Gza(W;AenkxLQ%n`;h{SDkaDvhsk1o0*9d(VGF`Ujic_Q)#<
zI3n(n@!e8aw`M+Aft<D0xT+H3z*kblbZYTtzOKvZOVtyOJElq|HDw@1$^fg?Q|J3E
ztrIerj`BYpLNEAP>x(?V9o2B%9JMx9!g0OZ6G%2%hYXQ~VtnAVmSfry$@yle#h61i
z+sIodky7)4-X>6L@@3;p@>mALMDmbTlwh;8&fjN6jy+oS=$pAL9bigFA4>r4OJ6#a
z<aSg8R595Q8<@Kl?My%Ff4f{t7JE5Jm(lrH*P3E!z#yomX<^F6)k<N(o`n@hTg0Ho
zC>J!ZeN#OkUmy5K{eZQTTV)OPeP#=&?lBk4(>h!zI=ZV>0eICtEjH6ltl3C@7rJ_i
zM$ixMG`K&Y0F2F84cO3zOeN#O-DiDG%&2SEaP^w{MTLIHe@BwpSkjp?AcC%<_-SvW
z?yq?oi=}HJQ4_R209F~-JGb7%gPaQ?8mge+_@GK(cuMw!FjWb4+(1TMB|>&s-dmr;
zcguBGnCHH&QL(_R;)b*N`O!F8ki}K_>9wFl$2)v$TU!jt0Q`G!rB#|KqZQ}n8*2n-
z88ul>-WiQf7J3bnAkRMG`KyCgksnO!{RLV=O`!L3tdUCs(M8TRbKH=nGE<hQEAv~g
z@;MDd(X>6WGTuqcC_ckk_M$2+?wDG31(9Gm=^9}|7??2bD@!7J1XJ`9ZJqNOzgH|W
z#0vj|#ZIj?y8xLpKnTIAvjFNv?HOTp0-1d$-4GduT%C_G!5<i?h}w?W^f{PBUPl63
zdRZ$V?9z_0@J-6{X4F!a5i5spU|^QO6b?mw`cBH?R~@BlluojrSiicbbgx<hdlfI9
z&3_vH`?D#T{)0t>fDAqWGLPKb9|iH&W9NIVz5c$)5S~GF-Z;X=pHCSI{J2U><GGs|
z0yXtpM}o9>I*E*g<6f7rKGX>G<+iI4&;b659o{f^wSl3LY|KdDO_ed!#LbWZM>B^?
z*B~@FiMMVcSD^I3{MhjKJaa_5Gia6zatHn9*p8d8@+aPd|5p_rhq^xNnM{27O=~oC
z$aoYD^IG?FZK-K}y1M4IX<l#Z;43#Q7B2QaB|v>N$znw$9@~FtK+>RNgX322S3IXP
zxngIWi#|gDJdCfWoa-D^8<hucGk?$+P~~)KqZ_bdJZ@xP6#ez7Zg4z{UlJ5l2C&ae
z6aV&vj(7d_pH-nXYe5^|OIfT}zF6V=cLWI?<vC$2y1(Add<kqR>nZNl+4x+XL<Ou^
zo2#*qP61`Id0R+pAO;n??N%|$LIOw6jcXo!*J9?Kddbvr&a+)jRc$(Zs8+{rGKjeJ
zk#OH@f0d*niPZHODPze_W3FC{r}fgAocv4z8SpEf(L_gg4xsa=oz%SAD+W!{+O9oX
zV%&K?3?@Ysl_PHi$sB+>&@?(Y`(Bs5U}kp?x%QZP1Ro;~=Uo;Y#WBHkkWMcVMr8%9
zvU;4JdObgHui5EqQRt6YOjJt=wb|PJhYf%kdy^4`@ia5{M#?N*#}Da@+w$<GAI(<U
zLHL46X-O07JKtwj#Y(>9?|9+!4$KVVD!+gx(f;JOv;S@_YVeEuxpIoYb0$JZz(lX;
z#1gZ7V|ptkhk3vl6-8Sh20BCyNb*>}0HtHizQjmVt(1c%5rMG1M8mh82Mo*xp#A0O
z8^{s_Z|O7BY~#LUZ7zDyN>O)j)>l#Rt00M&b@$S&dk=Rj<@=TE(?t3(Z^OSgzTQFK
zB<bicBl~n9&P#)ua)L^o0293N5dG3`oU7C@97ss%0_~^^b@+Qst70_D!wi})(nl9F
zT{7js(hBPb?8^dd)+E2UMPlQOY}$P@h|(C_$B)ZnWQ(kb-eL^SQ$7Cge%+ilokY#L
z1#n=N6Hq2&4|QPLVI{?;z9%U9;Jt4EG|>JrwAwirU4%nbR&Ml^vWFJzN^4;oHSWZ?
z*X$~#dy#%~E4XQ!{@DPy87|$x2r#S}C?>Ej7XvLP3U|>@7&4Um-KRf`B&Xn@%|eu$
z#+3@D{Llcs@`xpw36uojeWr#z)*lx1k^hYJuv`M!gQ5|7@#ev_xAgfKAvfPhrobp>
zIb$wH&6V!!`9czTIi*YTRs&RvJg#6RTtk{UJqsJZcy!-*hZCiosap8$LqvFqXf0x2
zdf51$4P6MmZ=|C<sXKX(PeSrqby2B$bQp_HV<RQ5b^ZD!lv~~rhF<J#hkSG4l}6CM
za=13UWF7AM|JRLd<82`c_Zgs^*(qbMAV9g7a1O*fHkNqIi88{n24{M|QwY-6iV!C5
z75@;zJ*4!qq|YS3VqDo4ZGPBE-5y(ybSMomC7_T;YQ4@EU#@=D?RGIJ0&w1tywI+F
zG5r@~iXT-_+5$sSlixU#c`w3Eq5;xFE2mB>1N42nyKL&75taxT8JUYX|N7>t^PXqZ
zp$Fz>?PZKC$&~z+RM7-$!E9Muce=GP_j`qq4+_VNCK;!n{-ETF7AVCFc`ME$upskr
z`4{x%u`K=INHG|aZ#5lML-*41l0}lUs~~t5@)=3-RJG)o{oQY~?4lDAC%xrdLeO}{
zAW?<I<dxX1x+C!4ED^c_DSlgjH@)KXlG@P5<gUeyH)uOt8=8aBB4;BHWYG6CvvFKI
z4%G1Qy3I|Ld24+-spS>E%2G8kt`8Y1_u4W{uf_Ui#0Z<44PcL|CRo!d`GF~xF9HFN
zQo+}+zerM9h-u5D>26{<=NpdrKSYBIPukvW12~SSf}k+*aYB{3S`j*0SmD!i=UJMo
z!TEcGYZUCYEmoE&jD)h#kEG|QNM|)R{Kx%5e>R9d?48&?1~2pY1986G1Jm&KAk(v<
zxri3Jj)g<J5{z(F#&atV01;-RMXQnSwr7kh`2!ipK{mZ#?5v}3=?T)y%{~6KZH-V}
zzyuD8qp*hy(QAkxjl3I(wjx;nMg0}6{e55RNf>+hq4OB~q>HSu3u*OwW3I&1<)QfY
zkm)&K24dCNM8Ppa7A+^Z1S@YbBxL!keF&*=6z4FOWnljZ$@|I4{&@I_d_x1Ty{KJ>
zS{x((=Sm<Fm?H8F(Hk;^!DS7|_)MX)Y6funiX5^95nZK=Vz{Yb>XIcVmSqJxuzexv
zQz_C|`a5I)4q<$EyNv@z>(#<CX&Xo!szc`0BvWC}`dVqtm)CZBG56k7a^dP8VKP<v
z3(lE`_LN~u{?@+I6g*uX@rgL+Msy~&JE=Yk;!`kL+p?dRV3t%2fGlHd@`v06+<{=!
z|0(NU5;55gLokhN5#LTk5e8zNXtM92Z6=B7)wr{bBx|-*e<WvM-@u{You-4UKWe%d
zYh$;|MyGhrTrHAQ5Wr0xx}bG4dj!lv3-OgTGa^8`b8oqG$Q;=aZ@n`JEBS$K1b3Tu
zyB1szUk}^wIiagyz5|m+zMlPr4lkg6w_|#6UvDiad2VN=)t2mJJ*gn?b_I2tIAm^i
zn;%_4U}tY|qq|$pMN4ZIPmBa$Rqt~z9F_Bh>TZ~__H>ok%;`O}#$@P%uDm?KM1|J#
z?V{7MEpjQ3hh#(U+1zxDoS{3~wz+pYQ5Nv&S+Q}~y;fB5qucc(#8QVZYs$2?kBdf!
zq6nc$zozmA;ItKGvQfrOF9gu8q?3I-Vz#{Yi|K3rT)czNTH}IqXn%%U!=xB=ss{<F
z3xIrdV!XBg4`$u+t>K1Bfy;1bUCi<?*yid6nv({FoQt$Y%ni&M$5Mcho3lj2C?l#o
zm%vVb9H4P5Kg7*a%WuZ=fZ@vlF=k1=9o-t6^hSGhN9WoCAYpl}YX)K_9F(B*Ib58D
zeHQ9p>$Mrirqrkhs`vpCq^nKiE0t-hGDQHl$ow+w{{gJa?q==%n%Kq`w`5TyVvp!C
z_&6bfC?zEA6shZOtJE4c{jpK&9@n9xQz#O?DeF8cB?CN}hQjhA9FO`T+IzEs{nQ40
zNlt^st$Hp(i+W*eP*23t-LCPRM&9(R-N~a(uA&ATeIy-nS2u_P|K^7F2h%JG%%g6e
zC>)lzwnA`8$~8F$>Q{Tu3I|SAI0}y;=?D>3>;Uv1?4}}gp!iKzTj}vjexie(6iauc
zs5~yp(lIeHcafW4DaE#1$+(Q*0tD1>oYI(aPgmP&${0$IhK;;`MH!-7B}i{C6Tb7X
z_9~$86bDndIh4~+%r4-~5a-*$)0gXRI7?qGJko=AUHQLQa)p@UMq#QWN#=6wcxhcs
zT{p4K;kJderc)C(XbF*dZ!)c#W38kx@L8@AXm*1Tb1rGtDh@v0&bU$Fo%M37>2iK_
zz)1_z6Y6iQYQDy8%;5>e$&L{@eXxVa1w8BE`UO5}ag;L!dT+5W+w^`D8<3v-WopZ4
z3HQ?p2Ed1%$#O{5sI*N9S@@NoAY_2hM9Gs=IOpS{{xY!z5v~i@&3Pn=$hJR2Xw|J<
zVJ8|6S=h;#!7~Q%`oz)CN^qVy^`=2d(GlJeYD#;cZLDCpLZ)W((mBuYp;^&)<l)#+
zo=3eCl*9QIiQc{d1ABK7&ix$s=*qCfIqB6_?HxiC@2x$-eOWO|*SM9&U{m)a_fUfC
z=^Klu-oReS_}`)VeraSA7OuhYk@a<3D}6DJ)tq8EZ`z)mf5tqwvT66mK1AD8^yQ@?
zjULTm=_UfQt~@SSd@uSk`+IHE2rv&mwWcC$k_uy$XvFLd#L;%`SfunC*m@*vHPnDB
z@5h8Npn|CE&4z_*P`7buh4gPQes%hZN@I+0)T*^>YkS<G1fyD)1(5&cOa*j4TSA;j
zTNlsZ(jOin>9zHXGo;rc0BUDk2f_QVL#dC^U`aQ<V*HJx!id0Csd>8)!V&T!Ez@*i
zrfLU%SaZWU0}r@*O{j5C6r-lI@Nk`<J&Z4=cEy+i;;dz^>a}~YA}$y!8zh`X(=8c}
zaNS3};`T;Ym3E0}`kIX^fir}IY{9l`3yEu7=}*k427k(VDLPU4bo<y%5^|@=-AiYz
zL_Jry-o!^!5K2z-Q!#C}2y5t1YKW8RuQHTr&|g_CASYpzht@$r|1psMSTyOjf4s;<
zh7GNp<g_-q@y^c`{KY==WxnZW`tp72xd4Y`leX+2OdALcZNvsvreBYuvM}b?Bho+@
z3_`F;p%GVU@66p!x3(Xc2vOE{-sCo0h=c?B>2IFpSayZ!N9K{Sw#n(d4&j#tnbjd=
z;b6*^S@APCWtPHtFFv0P8$A-T;Grz2kg*8la3k%ezcJs+fXDfLD=&T<68f=Mc`*q5
zEGWLt<r%Fps0a$|dPVybtK-!7f8Z=!^M&Y(&g|V6rcf>Asgjhfp#`<n4lX|aKJh&O
zx~i~n#30P(_u))b4Q9zpVdkGpoV%pF`D=3F*1>u5L?YR%1-w?i1beL+DBwYglM&!=
z%$E_Jl5o_?uJzv5nC|u<zGZe*u%UX5=zOs51ln($%prOWi_4)hlZEUaUI<JgKrXz%
z(&Kp)9V5uTspuS*^nromXw*;@KeV~wwoAx0pF+LmafHw|IKFJrG6h>fERm_&mifL-
z_MSH9M7K2|i%Rj#BI_tz>HH5Ple}VGkznK&i~!LLk@al1nPfsJGmyZC41FPDr@HAY
z{?a<d{%6YfWz}lt5!QQyBP{E=VKUqPP3K?<E?6a(uYl;KR1~-{uXGm>q4UbFxSxm$
zk0QZ8Yk7uaybK^phb#}*x?#tst{qh^!ecIg>tA)9613p0FteNOd&z1vXf-(5wMe|B
zks;@?1}@XxbNoYIsj+F_oMe}=jV)D38F)a6B6=j~PnJW&zM3-zoEMwmX9U2HLo>3N
zUzD0UoqyKVQQrzN^^jbMqXno8vC5cjymYc5V1o1<?mllY4hQHd+Teg8S$wdQh&!J;
zF2iZ#(r>>~p5rQ6p^iO`9q)Bmbw{oNQ@3RqS*#<vWGEgm(uD^lE+OpSl&M2?ks#rK
z1GBlS9<Q)hF&eDVI3oQ;>>>AY?MRI-ub0!f?&b_b1C23@+V``M)F@mlpJYXNz`a<F
zK4CF`umRYtTvS%V)~+|0x|nawP*>uJZIl6%>S&e6GZjDHd=^hJ0e@q4KkvAAR#mQg
z?7-O{l1ajKE?ODfP)qiZHJxKx5fU3p!ILH#x?s^BeE%t?(A+s5!`U;d-Y|Xk>553<
zvMTaLEOl82kl2k1peJp&v2oKh@7p%z<y+e_yFP{VY@D`6l+pbAQ^V4$21shj*JOgR
z#CJAv8PYa&=^H|oHoky5Y$i7%i4rOC0ItLOe+1@U%{@MDBr0XpNcY5<LjTQdUr07q
ze+|MO%%hbc?{2*eX}}2r7p1@B{pT!)=n_PZn##;%&%O$RctqA5nta$Tq@>{%k-*8*
zh3>wCX34#7N5uLBL_Uw6h@VBONv0BnwNnN%P6{aIx6_;hb0dg){BfQUQSIRkKqm4o
zEb4eg?+-)i&HR7~AYf;(z?FxEV?-^jw;I#ldpX#;bKRt_!fMQOdD6ola(uID8_Bi%
zjn=K9{ZzSbz%)DXqz11@KMSqT9k+--boQU&HU8iQgOozoN?pvFb6FNby;!eK^mDU!
z%jLBuXJ|ULN6v~Av%d4qD>~c9J^aGBc5+#AjAovX8woEj!<VCvc)~IWc$u|4WIEU#
zx@p?WNGU7r{CV>4Pv4D371;OP8oj|aeAe1zeg3-yn;&oH-fTtw$?9@83&;X&<*Go9
zvL&i~8?jtUWXHp#FAjFIq}B(}RRN#F8)7h;2{nn*2tjj4=Bs<a7DzBjQ%ZTfzb26f
z!9_>Y53lW0+CbT0EHupuUQW7%d9g|l@GR%a)9uz23G5pGJH=S+vQE`l4|ru9C$o)w
z5culAS=}O`XZ*p<r$2R7Y}iz8{D<&fcIKAGX=SOIi;xQhh0$H8|2_5L1$z<z7|3E`
z7fULn*Q<n-mp_9?EZCm`yiUkx?(lZ@8QKwLTu`O4{|!9xvPObtx}n*B`<7N1Lo|(J
z>%1;TFkR~LY3vhFy}l{D__v8Q4xQvU;mS7;D60ZsKGG(Mk>M#}w|nCWT;!mVS|@%H
zzP%}!kk3;&Ea5XNwq7p?W16niLjIXu$4u1~DQiDK-q67L#XRGJM>pxxui@`=<VW_&
z=Gh&OI!6X!%wzk3jKx+F?Wxt9Hle0JHSZ~K$k>;P=L~GnyXCLaF-odlk_$!{#J{Rg
z)EeWYn(mTLeq6m?nZ!QOZGNp%Rc|;q+>v?e_I`c6A0lRcMGdP1MpWMj#Y3fqdBpn~
z=QQDd+I>HkJ?ksIM1IEf2cWdxRZ!NV9n3Abg|F<74h4ez%&bPG#g86!7ll?m3;v{Y
z<jbLjLQ-M@t3N_NU|w~~L<sO-PW~9aCd9-NSwnb3Tih#A=TSk?m|=p_trhf_wy)lI
zS37^z`ZN^{H<5~8hiw8;+8N$0Rms^gg_KTOl|dDQ?w-l}>pUg6q|fM*kdRYAu(d1@
ze5)>04s=-`A86n2^8)>}*MdPJrz7StAdk~_W8UsF+>qzeWvF@WNWnr8e&U)icdC*|
z3WEZD0{SRI4^BLTLhjHiz17sUJwMppmK*dS2GA#v1q<cGQSLfn9@i@D*G;M%&unuc
z12mNF5rL{0d<&RrQg4z-PmRNjh-`rl;JpJdiS269vjP&kWb4*EnF);L<AB%R6&Gow
z3JX0pEa%f*S<N348vps_2Fgx(<uloiJYR27<mkG9&fV^36SaQi=ZQQ?0~&QL3z)5q
ziY|-Ha>X!+5-8JNU3qB#W8ggn<~h5zE!Em(!|$J@;!`UrLr4b;f3h9f)k=~mWg=IW
zP!2(fH!g)Od#6NQa224w6~&{R@DW(y^f^FLw`B#8Nzy-zzn;pnbL)RQZ?j;Opw+}d
z(FO`@i@b}xTpn<`TlRV(5kZ!7RYHQ%k=p&#x$6iSyewfbe^`2h4*t$M1#v&9zjU*v
zU3oS_)c}@@D+t=JEIPGr3n(Kd-4m@WmN8jek!-f`8(Mcoz+Q0mvVx1y{cYYVVt=TN
zJ$eGlV!r5G;H(P2aW6)IPPToR8Xc;6#jXqzxU@0lHcjgY?+YrW?{VkvrhdIHBkHg!
zJ7NqYcDYY8BwnsNSeqg)CYu2N!$JNoUwo)1ByGG@)|RYIi7n_yVS3&H=zB%yl88pv
z&;n8!J2{$??+Xg%k7e`<g>?~+Eap5jxU@vK39Sr#L#VO;inTfiLt^6o9~I{^t;jV&
zGk2v15ZK!Sv*jE=M$@Y`7jbVo--mR?W7o}{92tG>->oSp30{B<3-g29QLnUR;$6_<
zmhY@Q5f7B-?T3J)5Deqehm~wC!3+a2Y=+zWGIx0P)B#<~NbMByMX*{1HEM0a|3zKo
zzAiO;s>WZH>LGx$O-<$^wx#9kb4IwnBok5?%fHPyT3iY1Dc|_v3Gp=fOmMjvo`H*X
z9EiE01P0|zZNwEL7v^jK)G)on5?fIv*}-2*M@fSzqnr(%NS+xAdCX=SS84Di)dj{L
z)_yEk_5<7te^&ovg`0W5(oydq^yR^)G!5VfZ&6AN5>1DTpzZWrj(M`wQIg;covx=J
zqv`V)nptenj;zOxc9b}>^Pil0;DFM~_3rT_V~|)AO?qgB;u_Nc0>5}M#RfYeMH5IQ
z$7+XE%m0!YaM^ATm-=}2#N;<lCYVBvb;j$%R7eJLrSAlb4o*OIM^42~Gq;#IXeu}8
zUHL30x3Q@X6+Y%+eYZPgy-E~|71ExXHuQj;(1s^U(ubS!S8*`0tgzCRTegIN*0pv!
zJOzecKd>v6{gZaJNB!g#_b<4XMu&*;^>%we47uy<^bS!75v}PwG~nruCgY|r&!|va
z?&=q7ak00I*ls3?6<t8;PR3Lu9rr-zmsb5|7YrQXCBgK=C5!%4u9s-Ln)>lp_##*r
zpXGpPbd;C~L+v%B1UeHEN)L!`BMu9a{u=s9iqbber!*oZ<biz|z$l(??e8EfnM#jT
zQ|L}Ro)kMqjdS6E@`T=(NsWjBiZSj8kJ{kzV5n!d-*`vWd7-P6rJLsu-V<teT;O#3
z_B2U^3lmX>qK4Z6J_SM5JP82}_qWkry&6URtQB{YIX28mmu6Ay>+>(6Ldy$#d$SlU
zPT)I^a{51*JH0@%4-X2m1H<Wcjg-e49GEl<nw+E+NA(U%I;Oo!rHRGLACv?sRWL}D
zlb_%!so->J`yvtp($EJ*sgR*u`!BQh;iK|6zqB&6$vl+Fk|=-Bm3#IHi`8@mHUhzw
zKq_IacA>jhi~e-7^FezSW_|U^5W*N!F@7Ri{M_{tnq(7F;r&v8&Ijp6&A%g7-(UZ|
z0`l&o>@;?AZ~}FTpN_Zjve~`9$T4@+16XqlLtd2_y%tMAlL{h^;-C~N^`rm7<tJ;f
zf+4<SLV@waSVkU-TTt_y9&yd7*ZJyg@pXd`cDfj-TnyyNGI4rM4MS|PI8s8F6btW2
z^xr1?_W7`Vzc^hBq<hCD=~5b;MmteZ(?%pc3pZZ2WgE1wrgH$BT3SEo)H#eMGh3g+
z$<EIO`I#?ZUuDjY9Oq`qfGrWa9H<!;Ml^Os2u?JNZn1*Isf&MQXF!A0x&T|c6JLa&
z5Q)jo#zQX3DT8QCd1k~5>@-#^KYzo#l%*<Mycqx~@@fNQ-&0}r>jd?C4L*AzEo7nL
zeUGIcxvuem=TuLz#HSiuU<3t?;?1Lzy`%O!?T4X#!u!JJ^Q83o|FfK&Z2K#pB5rS?
z4@dw5Ln6KYRr05g_GUe?*+*e-IN#vt9C&+h;8x6%(g;~1&%9WI$r6<4l8o;bld-Ko
z$(dmTxk{UV*OA9?XlC9{0*I|~xFPMQp-QO%AWedpLYCu%;*ux$o5sts7T3E{-agE5
z7b8=A9p4Tib+_W+CUNEhIQEqdO|pB0O%do;rxX>U%4>=+IS2YWP-u1^PNC_wL-OD&
z=|tV;6{J;am{*FllAyNb3nc?{{n>|<i@A+fgkL!H%@ts8Bq(dpiiBDb9Mmv}eL;2|
zLu#}DaqqtQz9I<3CYuZ${tizHXkc=xpOQ(pLi~Q>4>;tQpdV5dr7;FV0$)eUC<nu;
zg!n=-@DJgh&^YJgc<<}XIBddQs^x`gFi5=Y{ThU|LfqL$|F@ip4HQN_ge3bLlt<mY
z9(UCLOqJCJ9m3c*C2zX!C(vBvENwoG`Y@lA2X#e-F<R)TdGFU3xH0H5{0AJs*G`SL
zLDrHc_giW_2`gN1%=bv!tgNJyt*koY*(e26Eh;r85Vh9V8gDF?6dtH>O3$v6KMN@%
z+{EHb*CLDF^>ncs-v?hH9t1OiQt<feze}LqpCNJbAsSo|MAGvOqC7t(=3l8S39G8n
zbM1~Q(u!^tzwJ+BB=n+shydSl_cA>+HSw511nu=x_>GK#+3?VqRuboyR*uYwe;TAg
z>#^$W0g6`XZOf<%y1#H(M<GD9)|~f;EH1n>HoDl+f|w>7ry|INoPG@k)jyaoZR2+G
z`)aVb{NgpD;M~(&lQzLt5ZRmG^7Og5J`<mCy@YMF8tNv%{9Hha?Kqv^LGba{VN&`w
zGBLPQ=9F&qYRE*@I$Hm(7yTyx5gaNZR>>?<wI}rMf{cagPeDiwSHm$<Ky_Am7Jjw{
zJ9e6H2oi!Ic1hGn^QA6F@U=a0!y@KxD3v_ACI?doU8u$nqM=y$XgFB%9N^33?H#Wk
zas%b2(Ve6g*8*+npi*M?qXOPSB3BNu0{oenxKl5*60s^P(;NJho8^KuPs<^QZ@DCg
zAzx&v;{ZQm=wfn9TCk*$W<1O3!eUW!X|^kX=rH`#Y<*oj(zBRaB4e{Z*=%VcsvQ}p
zVNo%M&?J3?2a<}T|K3wYtj4-N{6={@TOa(Oieh8u-WE@v5G>nG@l&*!hZfC*MI>uA
zgR)t+^Hquhvkxj8hoLmj05JQn6UQ|LRm`<U`#2?u6K*rer+CUX%rz;eXEFQ^EREms
zkXPpW#G%D!E@a<eh!!-zn8EcyFw!T2bk8R&(`J{otCy8wCw1rsHWcDmpXR$6+*etK
zQIl5-UDdO_PIpj%!2PC3&x*^~<exn6<fC$VazctPbT;mf_)Fs)pJLP%kuv|AZyJ&I
zrwfjI!!J+cu(dk>*cRB`A@T*(p8<ee#-&y~9T&Aw9!dUsUn^;@Dydt%csX8ajI9RL
z+EtW?6~hCgN{i6G62r`{5Uye!_QzZlH4j{fiDpoVhZ(t2uC$SV%{qx9$Dd^&f*|gK
zt_6A%b=2?3QFQi4C#7N>x^<zu9qWGFI$9FtuD8DTRcu(02|r4l`YGcPKV_6!^K<Hc
zk|Y>BlW9)vXN+o@OQ!i%%QN)-Dq7h33}Zkv`L8A0LTm#eqY@jBf#~Yzp<#Id3B9B7
zJHr+l5fW;-J{2MeNSuZ%I7LsBL2ziVEY|fXI4u6K|Jxui28UVs<lCN*KzFMDbMpZL
zqBR2k?b5`TDU_Qo+(4FyDN<ZeG0wR^DgfWdYfMe2=(-NZk3ilYLl%}ECrh_bi|JF$
z=0(xok3SmIDX0O5Y-5f>-l5^lgioYW9Niv)e4BfH0E4fO_60B^>z`nc4V~!P`4W~F
zUl?C=z(5pQQZ82ahsli?dyYpe;Xw$9vK)J@m4DSkoRVr|B3^b#OB%&thYc?$P6pU#
zsEPfwJ0Cp}r1ssSwraW`^I>>cP7wyJ;g_5i-0B}`H<3MIY*(P_3`bWy_e=8r7x=Lv
zFUFD&4MuDV&=Zooz*k*dsu4Of**xfXplJZNHK7Jsctgl|4ZanOsE_lYuNW~SWQ@Qd
z!39<VYB#>4Y6d5}Q79+S{o$iF>-85uft32Lf2vZ0e56+#Y-KewW+7jq@@FwKAsnhn
z4n?0JX3~<l>u14--Hb^+w=@uLeMsvNp(cK`-^nPBJXyN!o=cnCPdjNR+|)4zuA<fI
zy6CAuytxX2*esuXJtbbg;dGi+EU6=A&DI+)?<79iuwb9=qeamqJrE(kz_3)XcWt6j
z)>HqNW>3e}Ua{}nWx8zAv^9j`rAPA&#^lL%tYHjvI|mj;`h1^jNK^WGwPQ+j@C!%k
z^Tq`^qTDN+4D#1xYq^qO4;El+xL6snbwxAQYKs-YEYys~Y~_$+tZ*t0L}DkBBvFs}
z|M0$TCZEr^fD`e)i13ijFf>l@=En<Z^eGBu#%@v!4p*+`fPD;XK;gondI~sD*8gw;
zM6nj`;qiC4M7WJT?8HK#Ic8z<C!8dG)Yf8q#GT0ZtW7A0MjjEY<Z=VO>&Z(~6(nKY
z$)@haV7V@l+&SHkC-m%)oyV$A<lF<|+}XcuK)Z|^S9EOtJDx%9XgcqlpP1b*x=;+%
z`lhM8r>hm*M0y)@5s|U5t)=scKquTbhj8K(UO@wmgFk}y<B`w73{TXNMw}Q7^-To%
zg*t8DbXRbA*xh49itxwHkC#OC30NO-zLpX!?EF(;2NF@3p@$J3x8@JVBi^L@rnFVj
z6(^UHC4z?)xa|N*XLBocN2`~2J399lk_pvejg$-3M8Z8&Up1~?vn}aIePlTglw70Q
z%0|ZF*TKG}qay1f&sT~?^Y*<H)hOGP3~~EBe1m4SNYgFK(0S|XGX(bLCo|{;Y^Upj
zcwog()jid+>|fH5y~!iA#*^zkpf4&5?$d+(d(mBM{o*FSuVB*d$Olw{kZ^b!=WE{@
zmlky3U8rkW^9$f1hK&_cz@p(2x@VM<=Yy)^PcD*ybSJaRhBRZ1e9#Y@Z!heQI)k<X
zh8tw6f$%u;%0v$c60Gvc#w*x>G_<5TalprwNHny)=uc7nG@Q%15~+D&bJ3csskWoR
zGXJT+DkVe%Sup=qshWf+a}JQ>uKG!?CcA)1UDUhGE~s4KO+vENA>xV{t&%I69+Zq@
zXCsG3t57gL#ky>o=ifqA0;%igRT+|$6xx~^U)!O%S%rmaxMxdtf60_XadE0Gx>lIJ
ztgG{@=Y^dNg`)8t@T&ugAe)LUvdki_n;<r$8|l}@?4^@ZEM5?qH*pit@bwhvWTuVd
zN1H=A-tQwzLac@&_U_UYazx-_WSr5G;jP2t!SUwem$a8<72ZBN8QMT6658ZRKab;o
z{8c6*CHNRypUe<&|4aeN<in}dsWAfs%Nes7?DNQHejhsqkh?<B6W+DClHq@m_xm)>
zUZ24#fSbbh;58Cj)0ze9D3t_ZXqt!xnp&fv)smC*P&4bUAD}gmEzBo>w}=Q9s`a8_
zOxoBgx)ncW;6gD~w=;b!hlq}1IdRG(xh?>zDCR1#6zPT)AWOW_b8ZBIfCXS1>+{LK
z5TGS-4HIysigOESyGmS@p<5TXp+t9pl9!{m;-rnwkJm$QRkF^39;wC_2&jfNqFRd}
z%NQLXu5GhU9Uv-Mc#Eg%?JUx(q0>x7*Y!;UBHS73R_{~MD_{L2=3F&_xFYGI(=M@h
zGh<K$Mn{HN`b{%LbEctW7qxYlrhsa&C}!|z^SnjeT+sUGqW&9Mc%pN9(8+ZU0HOA`
zy$b*8L<`7aZB23>P%llp?5qQ;9OO$kkyy?G<YN3*Bec)s7+VVJ3vlck3m>4EO^!Xs
z{E|}^h(Hbfm|ZTRQ#$Co@V4_45xz(EbI<^L4<KtW6n(EzQKGZEH4t0$=W;><#{=?N
zwSp`!V}LQBju9-i!3MlSJ}DyrkldS4Zg$1ONT`m}a)i_;!BF<7*V*d^nB-p#2Ds*n
zKB}T5#kJS^ytB7Bt(>k*{&0geET<zAq?*ii$G*O~lbLkVAQsxnQrHL+bDQYbN$PZ~
zz8YqvI267U4$X~A7=wiGzraD`i-Wo;vM8S`%$EsAF&Vl8{3QGlV?Rwx21wrOF{E8b
z1^osLl(F3`UCZ#XM3v6^Em^ZFE9`T#OBTCxI?sa%tOQgzlc&0M*cNcicrIF>77&vE
z)&Ha~kN=OXvQPRrJC>Jyk*)b4a{h__hM?MIxWIYkE{f(ck$D^GtOP6V4bG(Q1KQo%
zP@AIS*Z*%*cz>sMgNc=>9<{;Jk=XdJ?R~f6Y7>oU#!-tuvHl*2c4ocFpZvu?CTISo
z1e~grVh-^PkR0@WXJVhaLiFOobGnbDNQw-|L#2+xdj0009Ctb`5b`oyqgnf>9{EJ5
zCnCprg1H1cHCV)4<ro5jLE$#hdP54Zw@xae5Ei|%c%`hE1>S42seiL_-ZB;>xjOb3
zg;D4BW8M4qYmfKiA8A|y%~Pm<0&_G_an}F2EkMtTfdt0oNtN~rmiQq8x^Lmhdhum@
z`&2CZC0!JPAcnd2%|p_3L7EjK9xQ{W;{8wB(>$es@>Z$-v@!caFLMp8v<!*{8y4|=
z&UeHP&!5DrMd<uGe4ayTMFLOu<qHPSz1_qVf@6uG<Qw+0W4J8Y@pc_F=tlJ%(_nZ?
zO9`AFEU!}8r0il+rB1GQ^dLrQ4`OMeB=!U-b~OY|+7j)_AH5VG7gfXt-2IAzXM5I)
zr+~&;v)2Ci?sr2v-D%Lz$1wXkr+Fl9@~s<p9THwk%mfS{FPRb0BiQv0cvYXo&MUQN
z4oBw<?!Sts832vajc77$q%}Q_t7eb~uqvPamZon?!iZ}h%Gr^%HzOQAfyA-xAJjo)
z=vduo>|D3`;@iB5kO!~e_0~ks&^y}`)$D9A14u+hB`X-9_e=W$VR^XmS8pU(Y8aeP
zYt4Y0Lk_aaohr54tnnIplN+%OjF&Vy7%j_CX6eOIblx_e^t6`&+~MhUyC<QK1Wo2o
z9$YaIn3?#Ro8v-7mhkL^<p+fK_0?x9%G}ucswk~a*mC>eRCM~2u(GJ0jH!<hCXd;4
zwVUaL`@+txByAr1)~QDAw0;imX%<ZFtLBPO<w)j@cQa~}RyatjY1Vq_70398TI{Dl
zY>Z|nBfrD9(Z`1df7T{;+?ve~n?QKl7kFJ#t-HU0u6W<!Mpxr`h@r`eH<(PzE+?ko
z^5Az)df-SXa#D?5>)J=iO}?9BGj*~cPH*i1fpi$8drRVPjeg%4!o*4BUH*e1ckq3w
z+G|gmkJY^0M0iCEk%flGXvl%(G>UX~v8(;j!19xUKOYhT07Op}{P#>>GF&$Z(rO_=
zD&&*K><TEY`qbq>VMrzrYb2`~zrH<@$X@RakZv%N;0D}CUfq-xO+<CLrf}|BQ^RCb
zpC*HoNV?vj+_EoY&Db-EvyjYEY`If?0^HSDTPJu63xb{9&IK?Y4`3LU(kgG;l0g}4
ztT0sxbwB8u;NFrJk2DRQb268J8tBQNhr3#Uk~fTrwe&-qplipT7`gPeUqqsHlU#Zq
z(pes!_WCj#V3oF}ZLx-ok&U`MX0hjs+7<^^N^yIkpXRl%2ND)@mdHsiCy6)CAG2{p
zgy*8@A|sB-juQD66GRNOBF9lagEO7=)M>4n$!IR5a~6N_HQ2ORa!jPZ-D=F4CUiZI
zA8+v^c%57Y;Sbhdiiwyn@dO!OQO^qMy1EBzf##5dQA@pMyE}O%Qqh@pbTk@+-S9(e
z!%?w`x2jzaLNV-jZ_xxt!PGc0toK9^leye<T`lu=ms4qHoT+1rrrg4YHB@ISk_6!3
z?P^G&X^pY|vr%{teE+{a&h<p}bQk)uY?|0)2q_LG5)TiJ#Qey=v+vkK)_-E(CUz+I
zWz%G?KpQogUyR=rZcQ1ttg>KY<ZBXsGv~w(QoBw%H}SQ7L|Bh!=<_ttRMyW%8KnBx
zNhF-6(0$oSI1B$Jiml_jR^3X}#sl&HV}}5o8O6Nh;DG|Q<p9O#!C=JZ&~)b06!J~3
zZp10|Zo}A!qVGk!&`Xp$s$f_lvZlXEMVf=sXCm10=k6WFIvfv%cmu&-#$&@HG>TX1
zKn{3E-`0YB+*?EdB%CM>??<00tBRv_;hciw@HxMRRK*W)OZ^CHaN}dV7a8hIN4<QV
za@NI#{_HZ4?9Dc*@tWEjWUHsAgmBvcGteCtXpkVpnSeEP_TL6HurPw^l=XK?$fzKF
z&QSl4z~wVL4YR@Ud0X9eMWWO+$3hdLy{R-!@9ri0T@Y!^nK=(%ea^U^9vA@;XyJKj
zL%C3ZDR%2LV51CBHfj+Qd<H}aVL%{9?=TDtfUI}I5myafGYaTN*t<J@KGR5;)Ttvz
zux4U)Ke?c`qZ!7+C4*n4CnXTCt{%$Qt$CA;Gq#lk6R4ng_2bsWde^^eAI<mt)ysNb
z07*c$zZUD2v3=PR?dJ#aDN}DkHY34%ttK|(x*XVUQ?_4SbW%|GOqMuk7oFGKH9iKZ
zZDPI2f}A>t=FcB_BFDGjR84`nYADl$4DATLIv$xV-ggWls<mQ6FxeAmF%QEh`?o41
zgPf*n+U(^nKa;zP6jN~xAdJro_0pBYRl1m;UQ!K4uY~9CPBt$UF;IK4yF9@Sux6ng
zS1YTC4_xBP!(DMsY%?(^Z$Sf%%1?MCp@F-GT*lgXK|8+oDuqm;d~J=A+hp&*VH85Q
z9+l(PpxM4mHl(A?y6ir{h51Esp4k?$hQ>2M87WlVwkbn2=o5pDp5Uavcra?Mi6re7
z)4_9c!ZhpREmB<?KoDDRSG8(YH@QC|H1mleN0LIaV?Y*P3+T3|oq|lr3Eoo4%DY+d
zmHi1~;*$f4BUOM;RFqb&Tm%r@fTNCa>tl$4i;b`--cOy?`I5eA?0>Yf+N+A9sj#<V
zy8~wrG#0K*6?ktx8}aGbuFs`Z%fn8pXEnb&3wG&0e*ISPM{j;B(ovB0U51OXRJjt&
z<{kU*^KXYCili+izZt*I>`iJx^-VL^$`({wTMd)L@DK=aYemyXEn1iR<x^g5E^Zt3
zet?$bGmTO_ecT$R;*tg%WB<RedgY;29QF-h8tekutvm1$Ea|AuZb?!MDm<6YAL{DO
z*`NX@yHdiW_sMQ`77+=i9~Ha&pMfOEbEyb#3zXGg&i=7Gew(b5vZJ*hBLc6lW1BXj
zAd|n$`n#(?vw6f4kVNLN0#YyKw6OkSf^g`i=eua`R18$iw9FfEq?-vg21BZww%2=s
zb=mh|NAej=^rpBK%5C~LaGIOKbyahVt-5Z)Dr)_nwDXL^wEDUW`tLFqpq3Z*Ed*U1
z?>{<Sz~`S4mlkp>W)M<Bg^^43;Hw9q>vHiFqaLjgC1*}Q94N66HEUc6di+VFo&4Ah
zcv>O&<dP8zbxYff43|pM_DCu-ouc))f)x>TvfQ3Ke)a5T#uo`5$p5_br#dg6*F8Vy
zY5Ntkom0vj!t0@A;4lHzoiRx|z$pLF1Yanu2%Dghy(Eor9a*+DBz`=Bh0Oj3ue(#_
z>~iJ_&lksbx9!7xG&W#5cW_C1QCiP5H*c+0l6IK}&sh~)Je8fvC=cjpbJilRkd>X@
z1kmo8^<JaP!*{$1<V*r#gA?5jnXF8zFa2F57FRY(D^a~qJol4^?bX?{uRzbQ#1li;
zDF;Z?J)jNZy+(Ajp8TCouAqm#e}g)Hl5_U9<i9gA<`${@P44zff@1rw1+xTWkptl3
zn^eMe(;OOBLL^sY6Pe{bD9TM`;pPYrr?J-<4B8k%)I)U4v=5yFjP0UcQcxY|Oxhtq
zEFh)!_vKg_5xtI5npfhteBzfnHE3u5+0F5k1px9VM!u5yxC7x`7QDdakX@f&pmx4z
z6BVx;e5g9qzvsQAdr~R#RaX|U1bZR93I$?rtnHt>ALj<Vy)r8vxe7xAuEgO{dpyEX
z;Mp!L#jfs#I#usPC5==j;D;XCavWeHvC{>^4>(ss8y?R4)0#R7{bKGRXVMIuoh89^
zHuIlx!8WeC<lGjUPfU5c8n7RI)LvkO?3rfT5jY#H6c1p}*6%d3JM=jx!Xa7?GHESX
zFBN=Le}_B%&H$0S+O+Alqd89$)B2~6`afbeIZO1Ka5w=+S|#FqNMtg0t3wQ4)bZ_7
zG?{>dxp_#~@=Ju$a#0oBd48)dXKz`2*^kFwc<=8#?)~%#^{i%BbHEpYm;g?IrAWCy
znE^Nj3I3c&zJN=5?Wa6-9UL444|~Q^{;NUk06yCAE1tVlndxH)=rbhAgXKk0nODSt
zd@zu+aQgtXrr`IOP7KFB4x(yZU|$JGXZzj}*aO>Ky^_BUYXnZdQ42}TdEUiMv%%HY
z<6x>hYV#@a`x;WrUic-%h4D+7LniPVwD8S!PAZ9@(5|@ZhkuF^X#!a;kEWwrpQ$h}
zwe0knp_L4(>cWA;z_=`w#=sY4^QF8YkQfR4$s*~gSXNng&L#sLV28{jC`aaZ@E<7A
zEBnC&5t~;JH}gkei&Sqc@GP&Slxdp2sHA{|WtsZe`REo~#{;#M!^sT&#ci={=X0eg
zkoC858MXf-6#lIGNQ!8kzmNNIIiw~j!>pq%FkLjZDguO4L<)!%vbM%fhe_U#_fHj9
zlPFr^lcoFKJ4W`eu|5a8fUi8OlQtd67Y=Y9VR{w0G)PjLQ5(maRtl6?UV}<;*Ec`#
zxSMg#xN{SMv6~)h{FjM7j#Xe_(DilVGlMk-Rge|c(G0%eqml7ilY$HZ!OlMg%4Tfb
z@S;th|Bn4uga<^})jCYVGTxjPcA0vwBIk>a)jqg7U@4bJOAz>7qZ=bC_WE_nlId=<
z_KZC;qz_!_L(yC~wT7GIFOZo76Dx!N4okkC`vG_hjdiC6ngkX!%pKqkaQbd$n&TGt
z>%{nzG+C}ayrWZysICqKdLzVD5lN0evZv%>e@u9FBjDhtM}YsKvw%{SLeWR7C%rdd
zK;FR+x!RVSEP6Vbcj`S^8$;AlviKZRj0t`4!k&KM83Tu1Q@m2zP^9h~r#+;>i>P0L
zI=E9gs^mdrhGFawQA0$yYS;^U)9}&K*}qa13@tj#ELw3D%KwALUw?cUr_QDke%6ej
zv`Yo8{!vVd5ecL<epYfLerBiF|Cid;HtwsL35(`m?MO`sz>tHfOa>250c@Z_cLc4Q
zKqbieOq163Rlw*O|EiLSP2Drh>p6)3*6=u&u^*-_1yMMuak0w{c}%#i96rl^(~TN0
zqq0m5DRIbRTY`;I&yfQlWT<poROe`(bH)@5Bs-~$KVj0CPDVc)A6mJCDGg_&@FF}l
ziXan()Ffa|y?KVR>qbM(Nmdc)t~CAt^vaz_Z*By<O+ij0psya0EUj?rQefSV<2?dh
zNoYg?vk0mQ1wr4%aV^_q6JtVW!c_l!Js&tAwNxNUcE9*z^z^@iEAZ6XwGrVRV^chR
zx+II+;Cc`WH|$r@1kwdA**Sm{;~3+b`>iyhqARiahuz2)Ipi6B;!2f;*=13fW#z%}
zNQcE`M3+H2R>yOhr`ag2esSj^6pV)@ybg6RMi>wm=Xyq;B7V9#EJd)=O0$pYi5enu
za;&7P!EjsrMWy8|EgXYzpD8W5gQWtUozWat>iiDk>~*Qm&~@kr&c{))oMB`+q_YZ3
zsGOlhGKRE93R8d2B*G~+qq}K9FnIoZdna7(0z%tX^lB_lf~y1L-R;p}axh0nHJvA7
z^*w5B&s>ht?bG_;&LnH3kqh@gNk-|6HA(EI^glz1DTaLtPDZSm_}*o&OitgUVt>Gf
zD8;1CZj1S;Ye&Nk8SKw&MD!{gwhGX#wx!eZ#fQm30wYlh4izKomfhmo`FHJKYvqjo
z*4FaGS(C+>RIB-dh89xU!GM=2?y%?_?}LLmo?<?_@+v;J;%-|ByhCkm0lEJIIZhAq
zS*t}a_Jb7rYl_!Wp&&EC<7zvbmSJ+Hzak+!+`@G~)94`Xo8Dl(s6u>~&dXp0)~q~h
z<W|L~d@Y%%lL+(A?l?K+sPC$Ar~_zRmdIed5?BMUg?{<{|9mG5?8Fha7zN7J-K1-)
z^_hxFMA+a9Qi<@jyr}|VUkPIuB!_b$zMwUGn4jwtz)Z6zmhQ?!p)Y|F^DT*Z>rUH5
z6zCQeNa{ql4Z)r_2IFA_eU8gHP2Wa9ZOFr7$+rw{&eiKTC>T8%@)9}EQh?+rt?h<)
z+6hKqivwIpr--EJ`p7kRLcwa(k4@dXNd}z8vk@0UyOb1YFn#>IlFwM@2)j{fgeo*-
zn-kqZ{%@#e1>7NLQ-2<cXcdLXCc9}pNt;S{bdZ>k(|72@$wAy%<&6-a;$pPMH40fK
z=_e`6aKJlMnIKePu0|iaqA&skZB)7r6+FhZwOV2cNU|)nsz{?TFWh@Fo6T{C%C?;N
zGFxLEY!u|Am>Q$H^O#iWlu)8Q9}D6cv(AEHovCD61*eapG<!(s;Y)+u#jtOxfJ#J&
zoQ>%$%}m^>G+ad_%WticE|B#Ufl6kH=!^x1Cv@FFaNqEGk%!kq-9p}*fU%BCE@T6Y
z_}`cbpYHR3@MpQOeu~hLrE%6iljTCU^tkfst&qbv_JYqcm-P}|X{}uZ^niyp2^OXH
zsjlBo`9<?lUmvd_3(CcOT<1!CCuOL8s#l`eT@4!eJHvMzbtRoM50IfWV%RD|CY<PB
zaZEEwYS?J;*Y4&zW-7GYmj>9JGYA$vV`l#X5FR+;kNKEoqDDO_{E9pzleP!V=Eo@^
z_fbB<N#D=c>1@cOULYjRZ_zaHt!!K+G%FOCF*KeMm%V&8K`ekKS`+PN5L`$_{R%8R
zpfW`k^{H^CK3ZTpUP8Lrmfy3=?1y2P@O@|)xRZ6S??l^jWtx1n_6A-e)$Qan2*0XX
zULCWq>{VS=q@yrtKiqKk3ex&$KK5!wfY=x2HL5apBvW2q*S+PO<Sa*qL2>ic1ZeQ5
z+T5hZemhYjFTo-=bE->~pgY};n0bxs5bK)73D9wk$hdSS_dn(v%KANCdW9}Tn@;n3
z$5X-qS5XIpi3(Pl5Mz8G)^VA7@K~>SN|E+hLXhi66(I_{TQ%Z)u%zcCYcVef$F~*3
zTRWCkiqQXQD%??>w|duthjZ19Svix4z_AV8pVCdHv(Y}+{Ny91UzkxaHU|?>tP%ar
zu@>tUv~)4xB{Id^Ta$o5M-SG3O|k9vY0(S&?`MvR>q`D{xX7i~<mEu`5J&SS_4RoM
zajw?+h;>i-HD<!_@F=-Eq>1BzC*DMKuH@|V9A!vQfz@?bmVY-RLxU1WIbTo!t=fKp
zJ*3n3lVRTislnP&ILTLvbjMjUJVHs-_<TQwgsM4R(<>h%tpGiAS~86bymvgHBABx2
zdR@^=2b0Vrlg!1R%$?R(TM=^YGr9sJmJBoGJ?XQDt;iYC>XbIk@QwO7t;L5{VRZKE
zoj!(DV$iyLCEyc1g|ad={=NbGaC$0%l&uXzTe<JCFaTw@Ax&BAv0pbE#EwQjxrMky
z-5I?Y3-!rcuN<)88^rJitfmZV=w)zO6gl58TzH^ZuUZEK%_R0Ft01dZC)>?)jI;+L
z4E=i&girhU4d*YrMFo6`uax!fH~*u90hsunXo`rD|GqTft9!J5_8(*>>kz{asdO-P
zGO_8am9R<UIpt->4UzAY_LThmC8h9LMa0)YBTNz{A7X2`;j;#o`4E^x2&W=(wV@-O
z9Fk$64;q^0o{w+xt(dxn=^Hf4aFM*de}mA5!;yKA{BhqIWz}aMqGHd1CW-G@?L+6C
zYwBz+c9*#3n;5_2C=AFj_h1_<OPr}OS1RT?YgksKo`qICj-PpYk*-c|oP=4}aU9WT
zcw3FlZjxz#!vd@?vn9p}QveE;jeh^7TVkah71}TOiuxBgDT@1yqm!t8anj<9dEtOy
z<Ax5@QE!;|+Cz|Ln#^pG`vS${RY=&VE;fL1cZ+k})E2-y?OPz0`)pY8DXHmP6&at`
z^3^LfNPqrFS~vGhXNrWR3dkxBy#CU>g2Bz$I%{mpWy}=_ADIw(tNnr<U5}Uz)P;<s
zc*V5p!qL~3at~g|i7XB>ukQn?x{~!@)_Kz-P!|^P_*6Ds(O1_M%w7jCsZ&})chIRX
z1C&%CoCSYfkDp_#-*fv8B75zy<Gk)P+Lz`XxMGJ!5$qY}P;C_Y_(tXyB7SZ`17zSb
z>)MUnCwnv#Nmf8RLFS;;;tAH+%N(BNJ)|VZeSWjeZiS+EnjN@xYol7O^6zVdjQ_@+
zSk~|G63BsKb;ZDFcBNbTJCcO=LG{XLOrXhBXiyV#et#$t#}R3~dB<wwH<(N+(j^*f
zsy`M@OHfSsE+;etW&1TnOYAf9KppYcXRNZ{w-+WqA{mkxJCc~mL`!mORWuCXpon^D
zni|6gz#+ezDK(7&wnrvD-7$HDL1$qhhW*(~+@T`ojsZM9iWj{!9x81kK>2nfBz8He
z3XO4{MP^Q^BC?RIw~M0f5p?o}mp%dYIv^jUb82!`tQ&t{4TaQ0_9;iniAQ!y!DEjU
zLySQwC;PUA6{O%F>~w@2{>D>yxXtMbpWqAN#62Qr)1L?|-f+PB{aux4H95|AAxH)E
zf10G~YFrl&*EM2*DVFR=10#g^&L0AROS#BTQaj|~@Ku`v=Ey^?XE3GJE6{_6{*VR!
zZeh*CLtVtI5D7V-tf0g4YxXJuq}QGfLodhsV7vg7>r3RH*6OV_0}rp)qMT^56U(!5
zeavcS6Dl)QerdFEmIWZWLRVjpq-p3~N`;6Tvv;|1n|o?k5`S8<vV}#2A|KCq)y}F5
zk^}iae(aF}U#Qte+hcCwN*+i=JFbTNHa$}_^)i{xZ(=Ia*iqq1z^npvpgQ`(r>&+R
zoyc)UF$TJVPht8NP_`<?epvEUT6S0FeA;cm`0Y(D+br3WjDlP=Elx!WyCY}-ViLcV
zd%&w&J;NbOaCJo=NGiMr2zwQ%Z*`{$K{%c?{uBR3`zaxo4%mnww(G;0J?o;7Pl)%&
z=r{->-d^O5SipR7W8ZST9X?l6B4ULXUC~ojJS;cZR(ZkQgEOpdN}cHyhtar!y*e_?
zA~<NL#k8ImNX>F&_uOr<LAE<=wv5UV`M%}k*ye9IcEm$cq&;a(L?gS^SD-!x@NYe*
zJdA3o<XiD$%Z!dUz+_hzF|<oz!2bwRmX;At!L$V)qBIjoj%cuI8>WeW&>F(U%)U_J
z+(XWEDrFrvMF+<5^Tz;K-KYYnl_zlI$!s9E*I69jiI;0niIRPu7bV*&Ir3l#5PVSK
z7k=uSWVD3d3X0po#`2*#a2$EU2h~f$hq(da3Ew3h&9-?A<30|ovK|WTlx5~mLPf*+
z;NnQkrgp65pCrINKH)m<yV1;*#m-1mla5{$>-N#DVl0p!yFZQxg3V_3>~t@)1#s_W
z!KY_}b|~yac~P0aOdj9qt^{ZP!&`?Xw`2;q$?r1i@xDbRIpGprE=^Q`$VYxZ9$P(0
zNtO*r3xfg_0zWRsevDHlOM5|7^1{65jr1`<Vo=Jy5wA>djJ(m)fI2vrMCD8Rd=%Jg
z;>@)VZ3&sP`tJAG;XFA)gvwNt{Zmb8m-aSVMrn}i9|tY-O67hV+)~r{;bv2JJ*gZt
z8VnSIKueMCkVacJYtrj;e4sr{NG}OQgS_egkq_M`3gP!333aJficlyAR-k+Jx+D8P
zY)!x-Yhnf+*=F%8vm;gUg9^EJ8ibbM&ZEpLGqGki=WMw66!DY0&y$fsyN|bMI`acl
zW^XUp{tPwlbrU_o<+u7)i-%LYuJI=iQJ*{D7!yb_6_wA?F7x2rmq~>|KD@XlS%ueH
zgv#*2Ub`}>pI99q;h1<0A@zu3NEgXex}@?)e!U<TX-w@GeLceTB+K)%=AOtnC0o#)
z6&KiLhR~o^PWsMCPJ1kL8JQWd(u+U9^ppX{?;RZ=YK3Zfu3${kqoWB^B75hdyj3K%
z_RJf#bs6F1a>^;Em6dU5NYA{!6AAo>+L{V)0v71UvklIITFFUTBnDw+5851q)X@Hw
zXA3_aIsr7=m5`-`RPiD_t*PdGk|1y2gmX1*yDBTmzwy6wveXv~sniQ3H4j=uB_Qb=
zO2_$&eU?O>Vd=FpXlB`s6wSjUhM$SZA~sjGbQ-W!5MG~>XBRsE4GSk1s<RrR$imm8
z?OW2}%;w{U3UueAB{aJ15!ewcWY6+fiokxhb<nsLFJHW?&4;QFzHv^M5VN~jV8e$9
z-<b!aG~q7vVP&C;gU1gY?DUV4Kj6i^i#Bn8zIdXk>Of{zEdWte%Lc8?=qQX)lb81N
zqCcm-xRYp@k_IePiv`Bv?cJ?XVutQ{`9b%$=|(dIln~Ye?4yR)IEeOSmo2ii-^%d)
zzaXtYWH{u(`gRSWE5nPnnstyN{fDa{1&n|uAjq5+C}xx5m*#B1WV6IRz`|aa6}0$o
z4!%{FX-W=7b+OMn099Z<N!OJ<8s0GWxsL$dY;KOCAh?0@P9BgVd_jZ3V6bn7sFT7C
zA-;~D&={mi#n5=%=o8jwFdlGF6Eqy(;b3)0xnSRK-$Xwrp$lv~5R1zouV-%Ub;3Zw
z3EMNlhR=I=-tU8BVr^aipgp9CsfeR}2m8n6zEz>bhd0=od5`^@;4})}9qH@fm^sM}
zQfnTm#I!)fz&78&r?U>pQG96zj!!tWC>$%{!j{Z~u9ITww{jo1?qBl%(D&E;#vja}
zGQ--tDfN8xy*UDC$l>-EaUFUM`k5p_#a2=k#qZ6sEm!J(zQF$Cg<_(SaE=e!nmXFy
zWh71>fZi_X7jlV~qeQq9J2M|YdrGbEHO*B!G;qwf!LB-U2sSLg?@OSj?+yz0%lCO<
zP~GVhYJ_OQfWw*3t5+T&`7wRnW{P#umq%OGah8jDMs;ct<?4hanco(8U`zAg=$5%6
z{MU_A1^Mm}jk?bVC6n%mDlSJy@{^&5A1cZ4o<hF8ScwX@ePF2U^n`_JNUfL@2|>Te
zhC1O<?kw)nra5JTurq%M2<=46rv!l67xD<ZzoTmh-yIX&=0zlDfa2AmPWMy7>zmFq
zbEJhrYJvY|ZiFP;H4O?FSq}No%Y8D2TmLiJh&22HoUvatoX}q`%hp5(lNbT^j*o3c
zdQe54>UVxA5v}2=cQHLS9^_S(*Ke8-5Nc8UamJMec@fl_gyaBg_0$SN*K`?2%$kO4
zyGA2Pe*QW*xqY0=BNFU)yvXTuR54l*(T&yStQSbf7Bl0mC|GG&Jvf4rATrOW(*gZj
zv!l4JMtKW_AGIZFd7aGcVwdAO(A<>Suoe@(Dklm-2nN+cxLj-%Pj4b1VPwJUREpsc
z)TF!aJE-pOm5+x63#oUU#_BN6`}*}v0cj{2g8#KP;V*N^fuV>(SuYo9`}BFxNh5`F
z1Y6E~07DZmz9a|CF!b}^-tRl0jvfBV%WzU(7scVjDh6OIvQr_paA2{sy1Oj91=qwF
z4p?bSv=N3NhpwKM?o*~4W#_OTGuTBF<SW?y)Niqp^?jj&jl|&cO;C=G6;1M~+gFcY
ze8PN>Cm^*WEPoPUkYkrbG*@*KLSN&Ee3`jK%-PBssL>8o*KE`2ueRc6KbA#b<|<E&
zpN&FD2f3dqA{Y<pe>^_k^5|bV7pRtA+~qioOHhawRu7~ZLpLJgp&US)!&NI|qwadp
z5-Kx`6-I}80u&TGT}3#mw$e1NBWcp`Eh$>b=VH@3u!WDk;)u9(x?RFdrK4flqgvTV
z5LkVWyzAUttxL^0=~oSfSxUFdz@U6?DIp9REV6w(=i1Pb78Gk1fh7p7d9Qs?po02^
zc2oBg&1eXto+~OTyM9|2;Xfc5M#;6f0hd<`*^7IQ2?d@LYqf7necZ}86_80uz@S$f
z`Dl<c;m3on?L3X)q)lGH42ZCr6KbjeJ>7Meo~qG_oscnKs*3eUldq#3m)mDZ!<uHX
zex>k??@@{n{^j&Z5~$@u5^Ru-TZUKckne>3JBr6~I{rf#P!_WWV5}!<aaTsg=D`47
z+7S0PWOSMuRJVfWCtVr*jNKn5k-L)~o!^K-w*|GnhZm-Mhnxj>gy6=&Y1f}024ayb
z=d~9~>2(|pN^D@|RRcYq{E(|-3vge}MrT;Df&Ppf;XZC^Oq^llsS9c%Yy8}nn%FoQ
zjvGycg<II?kCfwC7iY%>nYqBWP2={B3Y>Eod#V+x)T#3pnNGdsk3gOYzLcd&ECoql
zE&Ks648f*(2p{H6EfM0zoQa+I`^gmix`7*PT}G1oW%9Pb)B~{MZ!?l!3L*|#@oz^m
z3CP=*d1gEevqQ<%n{F7X5DV6hR)-dWAxD0u6Tt8n)#(XwtD}J`51o@?Sn-2*URC>#
zVLS}c=Uf>(OYDR^jlpr(y%DCgiiY#6PH$mAD)#H~i6dPbj>^?#nK0l-5J)C*W2ZG=
z&hxL+NO|rJFH47ja0L&<l*SU%jGpxUl2B-!#Uz-J4NE`N2rz>@@y_#5fd7Z=lJ25T
z6BTkkigiaI`<w3QPM?rCe6K;h_gr>>js&R8_FB38DR-&a>F!H%YWTUIR#`b4;&i|a
zcn__uNnU;7#V<U({=s71>>0=XDbjGPXRQqlX<0<$`R8Bv(v4~~?LMH)v(Zx(xbe36
zdG2ue0rUPqPESWVko@HNZV--i`pmuuQlEkFWI{mmD+AHL-KTgpIGYbsrLtt98<^RB
zh%y+oeVX!A5^Z~?_<nBM(iWL!$QG8mjDdFcs)vzz;^o<msT`FiBRIB+)QH}g6C-~e
z9@cN}866}=*h6KPKaJV;x&eist#zts4<n3Xj5e2HCU@`RAkNeCc`UFPblD~L+>t--
zn2-VBp=}99sfb%pg@%~e|0*O<qVN%no1YY$#%z<k1b7L>T6#S^0e$ALn#BW^zW!#d
zF4_TRR97XrIT^A8&GAeJs2k;~4Lb^gNL&h<6Nx7VHM{ls8&p~F*?|zB<=73K>~n_U
zeX8plUWao|22lB$l>PxjaG0SXZs?lc)0{sh3V~nXnC;Yc|M>aB4B9mPRXR>DYBy+p
zS$C+IlwG#FUN6+NN8VIhC-2x;3zMQL{dv|b^`gK!llN@{pWE*-B@(J;cX6D!(ON(K
zflmCuDp$(A;)UiVjx#hE4XKbR4W9*5@qO{OEq0|XFM_|FCoqDF5!iSJUKNz0v<Nz#
zM$Y<^A5GpCHn)Qc0rbqQ0bC?Xge2bJy(li!n~<G?^E{ZOQON$2b`r}&9WWYNX9T&-
z>}!_0Xv12`3?yN#ioj2D8oKL-b6ZF8UWd*m)oNkw5pM|+(Gt#Mr?1V~e|R{6+4WCa
zNMgAz(dNhNON&|VWO)+JkAy*alX;5eGzaoH*RrrbfRInh2+b15yl2tE^B!50^EJIQ
zQt$l}B9a6C5`xFGN*pS0#r1+rYdY!o|8`njrF8UqR4_9Z2tsX<{}TJAJm_DpAVXYo
zEEO`J12Tw?+P65`5tQx;#5YGzjD?ZD4W%Y8K$Z6p#q7_-b1S)A9cWxi)s;dV+#To9
zmBo=ADFoY}0qW>=B6N+KWRfr$v~<QzE?!1(nm<jk++NDIm(+V(kVv67=pgfj1xM`3
zURjr#HlYroDu@_G#6>O;eu^ZPN@!0vRfz5MmmTjuCIX(_Z->xw;7<mqzuuAMLe4j~
z&8AfRPG$wfRx{_7&47e!u1XikMq-?0>v{11;XX1(<&dIq*^}L{ftXaPab-eVugSMy
z`%cPG*pDp%;O?|nxW7_6!LucYS=K{>O9y&!6R{`Tbu^aA{VGy!HHDpp+9)?to$#bO
zxz32FLq&4`Te9rD!~5UgnGb6~@Wg=6Nzg@2_X}#7#Hd0R4MyZn&LFr(|A>+~IO0X7
z?%BlzeEqoPbj`7qyY8bb#>=inA>wlSR=h8iww;CJvon00LdrLQnNS>G+|l@Yu;Kda
zIm_w41rq7kNmw)FuX%cHLrc|ZOXV(Kz=r<5zBgf?4XE5FwHBJ8@^~aNghw_3+$$YJ
zk5OZ4dyjVLyXC2eZQ@m|dRv&b2iN(r8ouX2IrP~L{~V`#+4?`@Zsf3&91>fzw3j<l
zp}{xC;2*^b9x!x~NPFLmWqRRB;&vmnE=oOYmTgad9cb-ZS?M-grSb>R8*i3HtD$%~
z+_cuqdh<+Z&<F_RnDZRKr*CW0!S_s(_W)j<E5H~qR6o#76DSVc2jhG;ZUDeQqEv!s
z!f#tfgH-b@>qtlL6T>5DG<7#Q)M*&Pn;<?uOtLD6)x}5RvSFC6f?KtaYSPxLRC!4H
zFq3<+tASM4{Nh&GjT;j=TIBKT%C9>YPclrA)|BPh7rIsaZK9U5#th;t@X;uj-FP|{
zEfQAG<>N6_8U&Rep%}xRSfskzw8i7`jrH6=41zMJH$56>I4KG~XlS+G?iP7!Pu*H9
zg=r8;r##cLAMES^dA4@%__F+0&^qLdaV45F2;o<6QEJxuwp1NpoTyBkC*LWy{I!dX
zQTPQ8pn}^oaI^`upzVXBcd4_W7Uh`kux!>nC9uDJC=?)i;-?j*ekY?TmE^9|E=z`R
z>MkEKAae5q`nM>%j957Y2B)lH!BOBIJ|&gV&J6ELHxeB@ZmSDBP_j!xN4|Qfo00x>
zK`z^)+qipc=cw6G!+C9ErMBheKjAu2LsfzF>Y<bIiCK*$nZ-SdP{&qJ9FZ?_2_{(H
zAvod4^pB-}+%AUCj2>`xCqn%Ygl9_Mgi%RH!MOh0@-9K|n`UHhi-k82I+U1d)FiqF
zx~vq#D}dM<H|;lDdQJZHb4$)YQebN}A>K|u1kp@jbAgHQxNU@^NGJApIPj@2{-3{2
zE|&#lU@5$!OxCAsTKzAD8Ide5qChN%=VGZ!nf(k*C%tffoAgjOu!Ha2iqMNF$y<zR
zdI@#kR<P-Ka>ghMfIq}WXEe~|b{ybZZBb`eBZR&a^~^McOazTa)g_1);kYMbJUQpo
z@5gs5cSdkBjx00(R`+@u|JS3n>L)^M&>Vx>*0>pN^(FEpS`XorDoz++H?8;ke|fnp
zVioPCEI{Vv7Kwa8A$ag6TQuT|2fegC_2EJW(~PzPLxc1tmLzTID6Bj2IJfrniqa4U
zi4{}TtK^tAP!%8eud~VHC4KVrRC0+K>2io`nq|uq3t-qIb{Win8|dNlFrMC#_!F~Y
zWx3Xz>s+A>ol8c7)cuV6!7g%r{<ND_0|3`Wym3i4gle4f021QnVu=0CW~t^XU9fuP
zX1_qH`=d~|8FmceGP-fy6&e(p%<9m{9yQ#w@Mf+-MP!_!IV!)nveNw{{fvBA*o<%K
zzm|RC=O&B5s_Hz)kwggQ*^OOA8FnF_qvKpAUlf$nDLh-k<6AObJ0!8Nyf=#?`*iYI
z^I@>Ak2q7HCTQ=}vg{kTMXKSm9zuke)>E#U=G{buhrXcDZhc}Re;*b~xQ6`Zx_GzH
zr$Ir#A_h)W=<iDCYf|%*Z)i5n;$~>;Yx<wriIgop7m?`FYoWy0jVL?MI5(I9W@fst
zHlXz?JQ|fT)~By(uZg>VFoSb49Y!9wi^o`BxVJ3BaFg)Fm~Fzzf<?lIUjR|M|DCqE
z`kkJ#a(`lPDFX7_97}HF3N@G)S!Cvkvj!u>-V!y|+H}vx5Rdo)Mem-@TR^Ep>^}iU
ziWtRJjVj{*#de_qBr%}nu%r>rJp+g1vx(#Gg<Y#@`D}ZK!#GC)h5o=cy^sB=ykebB
z%~}#~XdBohnrA>7o@vI-^k?c1OmhITXK2P08G#MS;iA?RO1PqId3C>2R(TVLs-K~i
z_1jv93a>8s_3;WJ@0i(#ia{TM@7j8bL{olC)@?^Fr@A-VCx$>)O6tR;_V}h!K;Yka
z9KrzlqLi2Mb1_u3H)_1F-q=>ncE>V17k+|ulw2kPZKD$8q--v4M$!O{j4ge@pid8#
zz~+ZUj+UX!R+%Z(wA%~=(=TM+TxX~+3p#0m^K%fj3Ziu8BGsLIjc-qJ3VZB$0rbsP
zVL--Mn09`!O=1gEqrFKBxeVVasTSlb8=6K?Z3rnqkX=CQs$Tb!;l+Vi1c<0w??8Ks
znI(iVvuZ@g#32veI`(eVyJR`dI`1KCSkha^A3w76Sg2vn$fC;bhCJGytq;mddrSDk
zF+rOyRoW%YJwXmOc))-SK&V;6*O9D_EyEyck08`&!jKXhk9?x7;#uvl8v7e}H!Mgk
z_JN_DydShiqX!2uQGL{03H&AChWTg&Xe6P9dgsd^a65rS$?-!SV(O~LTPB6r?1$so
z*>+x3`<I0Gkw+)a6TR6W>qgWKs^?BKXTyL5fp2Pno9VFYd9|+5e4j}XWMBDnt+P_f
zrc>akH($V8Mh=<Yx_PzacV6pAp8^bO=<b7=azgs1^PFnvJ3KwRn+%EextQK9U~^$2
zzaW3mdI9SE&ejVmqV~3DVY}Xaae$T$<W}6luN&WgexaEjDW!QSfj;WI!~S~`D}f{m
zPYp<3Kmnv5Y>0poQ3A$au!5tfN>9H?NgsbfrmRs<`LUW7WMalMYJHK^1Y5aRFEF0a
zT_dNaX5UqlunoqIX5<-l<L7%$CvTT;H(bi%4DJ7M!n6)Oe+WA$dhZlO%DPX6CRk*r
z8aoCxdAx1-OV=Xk@X^_!6=aOZtF@6k?|+(Rlsb1NcDK(4n0qmNj#Dwo;_W12rPa%p
z1Gor#VbNQ#6L*h6H`5F96OG_Ne24YXMYG}f^wb$;swArd&B`eKfT#3S3##Xp@_)p|
z9o;Nnln*?jRU@7`vi?(78jlGY70xYJX-xzk)kc($1@mUpX3WJKc>rP6VYOVWAO-uw
zxF%G#35w-1d>Rs}1-pwO&fvjbJy@4O;nFDtQ#;qwm+Z5j@T(zG*GNKfq6LY8S=<Hs
zfEZfT;%BqmYJPx99Dzz2I27~@u7_ikdvbu10`^^0-;v!C)k3F9;(7g0&(M0j6^w%u
zUmZD=Eg+YyWy}lx=igkwMg&(o{OS%Li?`>Vc+&xbe81Eu)&fk=3O(MdgTx`vN0!Ud
zEl1ob!4UHvw5yfSEOB$oVXZU3tevIb^L`%%p3n3GqF3g?hWX=sx|0bh>A97>2DES$
z+gIi^atsnt6s6Y+$p&vK`Tc6^Nc|4zg^gCX!t<~D8{_e(u^GOy%f@Je0IvOJ5-8G^
zky+NE&yB1vLv}84LGOCkgf=+jsk6xeK<&GQh_?3Vl_B&I6cphcg`ld5f9KR9ye=Ce
zayoq=&ADVf_{gXYPHNXm;0s<IvwZBwdgaXct3`!N1`o;Alq0??3=Vg^WeuON5U8+r
zmiZT$^rgH-8V)5bTKzEjr6b1dG;Ob$TK8&V9mnyty-$m-ux<2TWYy17-BkyyegzVX
z$T^`-#Ym$MpdT%8F|y#@>s`FW$8)#XP`E{lq|a=k6wpF+<}Z8i&#`C`8H!cf!ovWD
z?3;K|4o3FBw-$JS>UnrlT+t#n!UD+}11cQ0KX~!D7;n^PzU+qd6hE;P1*@(3d#`kn
zBt~3yQO;~e!pbVzFsh<yXB7yzD*<`?!(uF}`NaFmIY0X9g`D-8<Fdm+9Yb-YMS5b)
z=6ihYG2S;)Ll(pPWuB6@<_NNUUAU8f1tScrJeCLdLX!+}y9xf@mYuQ`gdz-&({qeZ
ztkh+l)cn6?{C{8kTiAZ}5eHJJq9E^DglZgU+^1Fi%lQdzMOfL{hNDhngjYYl$79$H
z=X(D>w@a0@6$)8b5Z%H+F2VJ*7+~M}(eu<2R74Jq>$c}w2lBhJ*<{*b5qFa&0=|7+
zxw-7cN%KY_Pv*rq9epy>nfVK?F?FC?lK&<^7JMu_8}5g+`>jP1u{SaMwyf47Op!G4
zAmV9@NgjrpH+m1?Fe`{I9Cat=H7cxE^_VxDnS+oDh<u%ZQ3$8C#tuI9E3I3iP-~Zn
z1T`m<vt|spT{Q-E<M5&~o@ssGr!(87Kt35+Q#6in|C7qUKM5gAaXq2#(Fd#C26P+d
zcN(50)Z}|+g=4#R%N~DLWycfoZEI_U3BTb#AJDPZHm@K@AIKoVBE~|uEeDHh<gCgQ
zmQ#KXp7Lj;Xvjvq*#~CH8IV0KOZx*n2QGbAtG#}UVMyl&G|hPS)f~Y~OON0^HDULM
z1as&8v2P))xLCZb-ljs&N>453KQ38Dnj$j1fUfb-91iX4S*sVi1`6<?3mR1!m9jK2
z1}y49Sy*6oV2`+&9+QLfQVeVEE#Pre1M@T@TA+hc?i=h}f;0G@q0c{y@!25zH5J|8
zorpzfN*h49jfaTw86|Sk8gZCqXaLQtAy7$p;S^~@1e!0b)rn>@M2aBF|HJy$u;F__
zk^Eg0(GnwtnDl%tl}pi04<@Zic{8v2J-gmMXhAdK2+9=}vW%Vfh2SHBDm2<DQVgpR
zhY^$?VzG!5yaaCBtNkTW?!UYw<zQVCs+Vr6V8LYqQuH6|;R$79goz}4b2#4CN%#R7
zf+lHPqZS7)k(K=k{tfwSL9=WIyM<x9bx8!;^OEIu4`GnczuV40pi~gpiK`gy#)Ba<
zWPG7u;^xNIHslosEkAQ^ceiz9NP)C+3i=dv7z9eRxqX5h0U+d3oxrsi<7)mXex@7`
zlDgjYcWVUE${67X@0G;-1@^Apd*3w@N}irZu;yr?BG@U6AzHK^(yJ7HCGL=loCm0!
zGyajqG8tjrZRR+b(K|VNKzA`}=u1O2P2*oir09KY1(suv7>6{@+MoI_C+!lHt;d^=
zT$)m5*zfW95Gqad$(6@CS3ulhh~O(oi*^GKTcWpA4u)d+C1bS2BuOLixLa`QvSp?i
zs+i4$X;B0xF|3-iv_VM5EtM+(3&3KaHRsJ#@xUHqpMx{&`}p~pPu2n-@lgV~s@6h?
ztS0>F!I?rD@GX4mo||(kus@qWNpmSVG&JTCLl@Z3#z4S%QAA1LsWa3V%!AqPO&~xJ
z=A^>&@}uT{!O7F4t4?;a=5&^^*il<J@N4l(ibfH;o1ZJp-xS)L`k~%tD&E;-NSK7(
z?a-pgMPB?gXu}{*Hx{U>f8z-itAoSDVE0;6(dVY<=PG*n+AY2>E}_>jFPeDRXQ<e%
zg1f0`Yv@6)1{%#_VEE*=2CDsSpItq$0xJkr<&gPHo~YK1J3w;_ArlW>Hd=z(wGlCH
zV4YSFj5<9Bko==|D}m6{X~-E$1f+Gy6uI{xX(OhDkeK?3Nra?z;(8D6xrfM?q;5y7
zYViuNo>WWQt8i>F!!1ZP76aCSQyHc}*OL;%hiZD(<zTLD#vce$wq6Iz9{4?-yBS>g
z5i0%urh6x>>p3pV*%P;iB%pjhuMG9nkBvQ(<hxCB%fT<WB<0!Fv}4Z`ne|PGx}6`w
zy7B~wN@Bm+PmhS}s#oZbl@iv0AtM+BOwy)j-rHXMulCVQe{Uv|<Wnyx8z;Ke#-EG3
z;ci~nb-&h6b(h7?Y$iT~@GOHNmNxWu29H1#?2>UwOmR1?<cF>SJ{Zk?`7~QEf~uHn
zVRMO~U^@7C?YlaU#=`{A{GSr&H$#ekD!&4Rt=h16V>}WV{IqTil4xj>;U5jjw0T)!
z&oH@V9?L{M{5L+&)pWLT*=Qnp5Kz-+Eq@SeqFX_bdOUEgS@C%*yVl{AzdycAbbW);
z&~(w?RNh9rFDd^<7aFeTYE;gwOUX9}wlN#-+3bk!M3}S2A`}C^8zm~VhFuP@{-=<B
z>;K+7kb{l0{T&s;oSBJ%I$b@GI*LU-3~B3O07l3A&m^|3nSg}&H}Mb+HHp}xQEv<t
zm5+<di!$lP*m|tVc3a(|P>9mO4I76(XtW8E13&aH?(s4~llA`uXVZj=R*dWhR9rJ8
zQfO-HXM{_*s_7HH3eBD=MW5Gu+1f{R#Y_!8zTV=_pJ*7wMDoijbVrvd2d{yBa0hP4
zX+ZN38>RU`!{|3n&4-_;?^Q{aE9@+mru&lZt66XKz6-)%eRSriPMF3ZuHW~pbtb%x
zCbN#WB_DU-u~tL|N&bbFm($~7`DlI2JUnTjrvN8Lwsw*%Y<1vOyP`_E;_q=8I3$co
z2SKR%d6Hy#g5XvIRAtf3uR0|*^<AQ&GQb!3(Nwr9=s@HrPdScWdj88&{S-6%@?uV5
zHu)G~5aj%_4O-oCIyI>_vQ>s};yZ&(Woe1e4oQ%XN7@CAnEhaKl>;elSF0H*yC%3A
zbaUW2qMW~E`kPAI_imL&;FyV}or-<F9H|vn?wyq)flS$K^E4M!;Y&SS+G9OM0<`d)
zs*Jk6IVSBSmp(T^N}Wjp&W-oBiPo?qlElQ9W!4*KtPaI@^ZZgPs!RwukTk@Z6F#9X
zA7f{7Q~Vmt4o^2a&R23l&78z&x`5BV{U?z$ym@Q|6ELgFVgsCcs!VfvFRE+x<8D^P
zzM>ZN*`~OTe3%{{L$8s<<)ZG0=6ED<kVUC2rgX1sJ6EF}{o=40$_`YP^>+X{kiZ%1
zTbuM^oR=eDSgR=z|AN2g1(OA_^Wk)OnH5z)fG-#sL(}*9OC2(7A!+#NBwe!BT_gW&
zy22`o(LVezX-aZtsr6E*W>EOQfP5ere^!eX|K!j_H;)-oQZOyGr&Ig^n*#Hz%EA9m
ziG%L^1TxZL-dId>EsSVpefQ6^A@3n$e<DF`n$(rigYAN!DaSyy(+1QDKju`xK3LN%
zQeUwg46QueA*~XtqBb;}-X;O&-xP<9d%J(fECxn|&w*Yu0@Z%PHMU@}*MzCi?8OD|
zbG(sx`p^kcs8gFjEu|9g5_yd!&CYOUn+!5EC$PJybAn#`aTLzRFYRa@SZLW{!kl!3
z<g#CPz9hne?z89qPt)`l@{4`ym$R-}Vl-Wuu|XRXQ24+W%}o%L8Z!$e$2_odXj9<P
zopbKG-wnW=*GlFdwUnvq58wGR2c)F)J!JKe)ly^3+Jo6asK9;+B$V_it1Y#6L^`+6
zIVqUoup}}WmTOH^ib8M!VZ(t1q2NKkiMqV%8%Ml1exP#r7Rtj8(i&@Lpg%R*Is?Tq
zZ}O2AT7T>vqSMPDiu*I6dakP~4A`7WV{woOC7hru&u&%2W5pJJ+(R7pPhRlmdRa!(
zBwew^tsG(-V;1XFMM)kG1l)w^*P(CA>P;px%=Sd#;+0|WAExA<-r3#+d44NX-_DPq
zUj((}Q_|hhVm^kV)*$f=#Qh{lVUNy(0m!K&eJNPpkR`QOH8iMH!}%kTO_<J-<$531
z+OQ((*|dAu1V+;~?4tXhrH%+r2%)`|b5>*_2;PF*37c}JKB<m$Q*7Hb7D359$nEpP
z3g4DR&%_P5Qf`fMBnsC9@w!lE1^axzu90Gx5JAb+6Z~-2l!Z$zRoxlFzYWZ@&rlam
z^@zDER6)5d!KWXFl*IJPcax^<XC(buvb)}i*pq^i(@S9OneOZ?BHa(#yD0j|L7epo
zSc)SkT3$ZgjtKT*h6b_K3Ur(9OB!|cIY+fZx^qWqgj<~3<*0TV&r&d0j3o`w?ynOa
zJjt$|a`s?&;wUo@eps+~=b}M!=%LUNwZ@$hI!6G*+t#AJkj=$IxK)#-@I0TZqojPK
z&2V@whosejWNjR^UVmkSu$1KcP)jYM+bEh+eg3Z*+bMs@A|A<rerJI10wpDV{yjr0
z)i<BX$+OyPq4dCY9#)Pn@CE{EKlzw(nc#=wLYyhKgu$}z^BdJpN`G+o5)dA1Hdyn8
zV&JVZBq_Mb8trf&vz|7u#C$xG4eqMOu+H!C+6FCjsQJ%WXk5RPh#oO|pEy@{UCd(!
z#z(m&Z`&929LRL23#=()2ekL8PJ*TGi{8%KEBpmDLf<+HT(Mx#Q%IS*<oL+QA$m=M
ze10-sCa;!AGRD@eDZI!{tk`YN>rnMjGpk`o=h}j2Huphx3UpDN;mahzCSavvLJ!bF
zpCB%8FOXk&MlB7DCskDDVKIr-@gw`yp>EGdIb#eD&hoFlQd;-q^XFg%vgt;&v_+$I
z)@K)q*#`ZoG~>}kBY(8^#_vQ~VtL=UBq!m4H^w;yM|nhWVJ1_>aaZ<c8o#x3C~71f
zii*Wi>PrF%Q2RV0?M&C`Yu?10MsvrV8>ap;sCtS!jgr0}fAwOU{44tpTmR1!shwm|
z{TA&y(#~JHe|Qmr)dDbW;D+`)RCy-i?Dszb9`=AvfrcpJqVk(--MGCP=+*`Gd`<zr
z)Nyby@^wEQtF5iX?DgqkK_n#={l`^RfO}yE6+$)uPcXlGW-jq`y5^ed-1@e@=rj6H
z96_}cTe9k8Xp-4?EVKu#=F|*iGm*}*e*|c?Hri2#8Q_{2Ll1Oa;>^P^F>1QAzkSWF
z8I0xE?BgTw*ypnVtrNqj=t6Jh$8e}~LJo)kDUTz<vtqGhLY@<f!{d~I{=T9hP^B%<
zCr;4c924q!yeJHP!H7G9(CG{DPQ3P!KLtOwdlieujvU=YMt(?pI>|$;#9;$4AHMQF
z$qY*?i*u|I%H)C5IKX<HlWx#j1<pM=LhwRT>4!Q1%_P(DfaMiowDf5nW~ZjbXGMY>
znP`^{6*sM2#{P23%#1+dU%qN8O+czKw#Iz+;ZVGdNb49&h&6T4+2$`j{kYnYx>0PE
z|Mzsz$${pu#+r})8y_E0L0)V^>4<2dBN*1-M+2Z<t)P|l{E?1fWI6iy{i-GmwBtEr
zv_SVJusjaP4+#0FrGJ}kHk_uT$Yfk*jp8^siMaK@lR_3e3SM<8y^j7LJVt)vdimH6
z)b^_hGNa>xk6=u=Z2~rqjuk)+=)ZQj&tzI`2+k`cIiLk@-E~_6SZSR}*6beP@xB~V
zZXRMdE0HH7jY@(@DtpHw*w`2?N;&ymEKlE2T`}Cs_?HvkzuB9w83NWD%8<dsb&HZ+
z*%Bli{&$$0F!Z@Gcw2W&d}5&cfnaWc@xkB|)^IH!=akYdDOwM;=Cs?odd$3y3fGO#
z3V$~$+!vB4I&I;wWx1Eir1|IpA3V&vDV|n!ZjeMXbod+5YB*$E*1!4<#nE%%@qb)7
zT)1?Ot!HdS4sjgMk}1<+ugd^!lDzg1V2ANzd93Qeh=@ny2}@hJYw2kf&d-W#(~#H&
z_-Xnk9fELx?(e%E&$Fbf7!sbxk<&W-d`(zHK8h&I-m77U2M}=Z@@|x~zypJFBBhu%
z3hZv*gd2TN(3~q~d+ECX)mZWvYEHBiwh!>CFjwgwm&hl*9rOc)>xu*HrtUp3#*J3D
z*s;UHh54D#&;u^v9<!L3bh_+!VEW=tgfYSg``Z<_b5^P=>fh3jOdRr5zp@19s||@%
zm)3&SO5tMlPu!G--j9mvIZzgPes~lr60k|_!G%MvyG%Uf3Are2k!q#cYW^RwiH9nR
zs(AX$0~n;SM1d`>`ITfJc&%5*HnrB7jK^xCc#DpzQ)Q9lw7MMX$FbM^V<A+;jNs@v
z2QJd?d>Tk`aOoJCZ@ptrHOQhu%ZFx@Vyqjx1N9oPQ|!bhL5BW|62E^D1U+EmV92u)
zYFJU`YT>IOgq3CHCz->R-g(k%g=C+KVNd%v*&IYZ7D;*B>9F2^23XVbsjQ8MX?EQ{
z$sz{lYkyS1kCqP5qzOPQrwmp})W=$YC5IM>>6Zy*ATO<*mBlaZYGq)hohk&e9VKUG
zqri3%GFW1>NT11Ld!XD1c+`>6`CCf@G|D8Fcduc;qCn@L*$bNt!*@GPMFmhhnTL3-
z!!T-4Lw(L((Q%f~OIQnNh))oyIp8Qndsm=_=qVK{J8{F;7E%DgS(!RR{W^JyJpmnk
z(XSHl0t6i=JTC(SYEDw1aN=P23^64QoSQFo*0ij~v!2nNK5+>a@Pqn%`<0+r_CCj5
zNWIrqtpxCZ4Tj3G-2rOxO5n`hSS!U5b6BT=0BHX_oj!QlOMjfGDHHU)6|%cpLvp2?
zy^N5U@iqHQTAQFt;FKd_AJ!bV7?>^mm@VqFa7nlPD-LjBq!^l2eY167cM6zS&$yP)
za}Ul}0S^Xa5E9J}2156-ZRD6AWS`V+4s}}>!_tL6F%28rt5#G>#+*&FiuTtVEq+~>
z1@-NRHg3<U<KW3${?fGt)!&*-L^HR7#1v>r4T7pSc_dz)C=$$b=0gx^o{)ZqRX8p(
zhuUS}PL|Tl8gbkXKzlC<;eV>d9=EMmwKQcoHzEKxK*+z_qtNs#Y-Dbx{``6v&3M!l
zJ9>1<C!fCyeowp>e69B+qz#&CA3=|t>fQ-;5#TTMutU4!e9!ze9Y?+|?P7lg?~6<;
zA^z0kK-t413}6T4zk5xUR4mRgnwYf<RD{7-g)T)T!`h5ykGaO)oY@=YNI|pv4iq*V
z(t#GlaW?8As&c4P>p`iBr}&1#2^csfW!p-t@$wA6cQiNY)jCn*!Gn<8Vx!1rMf-;>
z9oAU@!jE-)@${bWv1?I~pHe@>Wtg6p6W`=-(dY_X!yB6U-X{~P_U6&9;+F_hHqZGz
zbDPi;hhaFp^DJ{6V3vt*os{0jFDhis{HMevFij~^IT!M_@PLc$(<f+?b0PbO76NdA
zKJ~x$ykQ#{l=jMX#kl_gaiX_69Q!O#!9eka0qLmM2&CnkRd^xsyE)dF429)fnf<+K
z1E<Jk()kN@7ZDjQ6a@N2NV3c59dSJd7e@ZJm%b%<naD>&9WLDieiz%+%4IN^G3&6{
zMwFhrpl`aHwbBy?$BFQEA3M%~V&#Rk(TD-266w=vd8A^p)CLFG@mryiJF<CG5M`H+
zz%k0+D-nnsG`>bQ?f&W};@_9gjVMt+V4>%zA1Bh72soH|y|ZMta+3C7DhHJ=-{qu>
zh<n}PoquBrbjS7Sl8|6}W*Z0E=DXJ_7uh~KK0&3R`E<E67^wF>*RwI!m_Q+?3x=$s
z`Kh4~nyN?i)b2#P0v_`YROElIa_UpANt<<$*c>cKcm)!sOfX69@Z&;_RI2O|WTFiR
zqI();`9{ON97MUm+}uyUR>QDWCk^RR8~yk~9aCYaE6@B;#vq1psg={{?|5V{lIb~~
zihu8<Bc95@(|g8dOuPB(+?PY;*oBLv#-T{+obxr4WK$T=^ej<9AVzHkM{R;Qo|EK#
z!aAq>62scagXQ=Tal3kr>CBEbO}b0cn#e^kPff1ib#4=fds2s=5~o`{Sa$qFwJNtk
zV(wXcn%4z_F)J9`;*`YPwoRG715el2IpkjLLN43MlEmG+StaGQm;{JetLxKQIU6i=
zTp{PJKFd*KJAfedjRF0fb%{I5$8;nZWgcRPyQsWkc1+48WV0Hsf%@HB>)fo_(q>NQ
z6VqE>W;J9abCx7ApFK-Lz!~}*4Ko&7_cx9oZ!dID?<oE<RKlR^<N;xP{9RH75n(o{
zvdtEA^kO(4zB!HP$emKxiMQGAkwVg^kt}eK_X?ZZ_!~Nm^_RDQOlVoO+7=IQk33k4
z(x^)P-3=@nAWTm>yE3uPO4zyr^<r!pfrj;(;pKXiZsI)}vfo&vd!bg8G^j(lA_X!t
z8Sr3+843%lyWQ^NSlr`3Q;Vhre=vmn$WY260}_#2e_qenv+!zn^ROI9pSdcsg>y@x
znh87$Tw7fu;}iZKU@QvMR6^4F15g@D>bFXNm%q#aPjAU2Ct=~;Ljd5<-F!pBHiZRb
zn8U=e?5TE%GNF*NdRlPFPZ$*S2rG)_uu$cQWkoSQZfssz!CxGFmWcFk<MGTKQX#cl
za8bTR$dTlw8IEl})#q;?#SmzXLnJITKA;y2dP&)nE_rlxSIXWJOMn)${<FPD_)kNV
zw)OGT&J<MS6mYQ+EOm<{Xx3#jk!NuHH*t!3oHFm4-RNbJStl+Cg}%x4k$~smrxnkH
z3&<pnxid7sXaD*$dnVb4MdD7M^UAYPXz?!k^C9fj!ddRuX$d==kP>S=v5|7&ro@w_
zYpvJ)%9o*;?u6T&C_BK~8YAuv8IOIf5H!|cx;DD0+m;%S>ex3JtY_dbmL)EvaMms&
z44gZfU-nY%2zsoJQncyJIdpo<$t`>0ml?O|rAQk9ZqEo_Yb<lv%`tCI45m^qn<glp
z?qq)kN8RO71QS>qg-2hOaACF0nMJwIGEZ6jpp7<lbKzCsbWk@QZX*XP&7Ck)hKGTn
z$m<Zb(0eg^nb=UgG0gFC+JX4KU|2c?&h4nZ<&w;738p=|KSpy6WPN=)kNg3qbFMcV
z8C*;iKXXT_T<<S5)5?r>1xtC~!0G4BOWmG3MN*A>l4>`_*JtmX29fG*9B)JZ|8jQ<
zodPV;Rwo<JNzM#b@0>o(_Ck3N_4prX^t3fuxp`_l?0wF;Nuj*LOL~I*$ln|}u-v&4
z=6Sf%N{{D~6S!Zj{>OBFR%EZ@>)8*J(MT&duX_A`CA}0Btq&-KB&KE<SCT`%DHay0
zbfv;M6-x5WZH8QTMCNypTOs+sz|OUr@EdM9s1#g>WXYLUt%MfiN&egEA(~*-kcFU}
z96oF^e4lYRQt(@Rnf#0ZrQ|kQMh0ZA;d{rOWsZGl2f3h{_XyUiFM`H1n?UN~LypV!
z?)n*PS)AF*=eZxZ2$_;-E&-|%HkgD5Nqio5OpkQ8E8!dAgn_PlvrDg(GT|{?2nmd?
zGRbdsIOZj_C2AWkT0(N`tW&_wG`1ZrQcyl;KjR#=1GP<^z80MuG?wX=L4xgw8+es`
z)97T0di@tptKkacOGB!Ed1Cs$Q~We~Fg)jv!w3^F1d4$}oWG~s_D4*IPrWIws#OSd
zFtF&TbU%`r<5P!xEYCWy*y7(atfY9ko$9|z3BgOE#$wj5+*FlvheG)6TaqDLFjj~w
zbWl+1R^S>Zhr_zpp-Q81?M}xX_<t|P*?O@*7`ismmYWe(&m`$NgmCrVc{~B=7<nSj
z1g?*+i#qfVXePP|V}QfG*)W8V=hCPq?#31O$`lMC#1V%UC=9k5cb5iuAWA`m#4rwI
z@w!2cWhdZOPk#p*RtOZAKV~u(&tkFWDVg#ccM4+_w|8C%EI{)0ut?^uO9l{hYjSI-
zI~lHld<LsldSy7$9ROo%nDSDv8AYUaSmiVr*9}BvrbmbOwq4`2dv#<AT=^e^^cJM&
zVAP8(OiI@<3fkUR-S!=urD^{`ED8<J|89|jsZzIO>;839$W?@P+)qCA07mP{$s=An
z%?8Pl85C+65<gYWa(y@@v>cDlspJ5mP6&l4{|8>AX<3AG@B_0k%p`<`odO;rN98T#
zn%`F{{(%r>^ZlCaJP1tlF?b@^m=oG}Q4|l}VbwzpA?H3AOp!zr%|-V{iigf3ZjQL>
za{fn{)AfseB?-JdgpJIq`g+KLl|bN4+Ae2&+xN<-sEX%W8ur{b>Z-30$0@s-=X&7Z
zsi@b9(>wSz4|HY3R|q8&HRze?X1b1ty1O(0Zj8<1038r8D$}R8g<NZ+H@-Qf@!biV
z{LW2Vi(8-u9%I;Ov+ACIQYk#6w}8NmO)3Bs@1cWw(MT%-uG(~f3{l7OYie(mM-DHU
zL1XJP=U<p1p`(-}oRM@;*<gVvP}xrc!h&}W?6Q(2)$_~-hB)RRaTOsdxLJdX(MW0%
zr_qmtY&&^Bj{g-+e6a}w+wrpt!Y{0PKI&K`l;$epKKDaQF7DVVf6K{YQE}N>)qxUH
z)s`(tMnW&>@-LE96EFXtPLXmm@fJ(7+*Q~2U~Q%!wI)k(?{QZs0{}M}wPXde$QaJk
zx6J88e{Qn2%yDXW0!duoaV{8d&*@`kMtgA@31}xVX!kv>p{F<1(@fT?)Jj)Nmye`6
zYO*G64q}f4mIBOXm4u_P>Z!J4Z!8q;verD<p91@QVH{wr<!T^1c&<OKWYM4~wnqC&
zs?*~QN|B2L8KJPyTT-e#HOamQZ*Vs1E)qafSy-&Q-JJfsz$86hyj_3FG#HlPmhBuQ
zPO2t81=u)vPDUcfXI}bCc1b5IYUxEd2vTZ)QVgt5OAv?zA`>MHBpA*649t)XL-dSO
za2rOvrsVLDSgZF@F?I<t&|^;0mVkd?44b=*(eh2A>Z=}&Z*281=PXGH)}hii6n^L$
zB{NviVMW#WNp}Y>iB|h>&#&wxz#D^TWagf)3e#tFR4^oaJr(iEBfk0|u2@Ns@S7Cj
zt|Y-|R$(T)>0XJ7aw8vAUv0lFhV#E!Q~(NtD1T=cV<_DARm3P5Hf8lI*nqHd;neWN
zr1_z0Qa(Lobqm&l<N77wRtdD?Sd^3;nM-ZnHWD20Ase>k=i}%n;^-G4*44ZTMWKrU
zctku@bNy&{;wn6vB2`je$uS_UNCZ8NCD`+Hn0=R`r!4tnf$P|#`?j4DPXd_aJ}O0s
zHEmjIm5Ae%z>7HpVR^{ucemLne>Rj;h`J4cd30^DE1Aqml(^H>Ff#R|8G_F`!WoLu
zLW}6^GsswS&w`Y~c<iR6raW_tAri}k;<ZAH?teif(_O`Y4!jQ-@ml-uMOAFbFEDLV
zDf1T&wu@eDk9y6U`FHuK<F8n{&;bDRhNP~<gOV|mM5$-q7KK~7mU+#sG0{ZbD|^jW
zJz>Tr5)JiD{9bGP`k6Z!9|AF*8a@wGfnw8nsgzhf>8{{$e2X053*k6O=l*pK3UY4w
zTqoML8@uij&R&cd#<?Z7vrJ9AFFO}TrlY0h$yrxz7P%2qJbrY;=v=WI?qdVNL%<&j
z1{}ul`qaU70IoQ)KTh5U{61B5nuP@~ysvxhPcb&;RJ`b|dc5MoHLUBws>9U<9Q4Oe
z^gqB3C*FX2Ni9-!Ed+kLic5u(9bLSXS_WKEIfR7LY`{~_X6V9Z1doasaZu2tk~_Pf
z&1?#d0J0n*f)|5i8C_XJg?2U8!{I)TlMoU#T!+_-+F;1<V}J{@xNTN|F~5EI|Ct)C
zbLj9LCv7cS&qFA82~)POEr_4<-Wb{cIx@7U*#5zC*g(%x;gLxT-SqD$q@TGUbS{Yq
zb!XA%N)!Xe3VNsrpwMD+H91==9~|tPVZ$AHOkVWIPKk8omBBgi&^qG){21t`#BgZW
zgyygY!E)#+qy$Cx5IOjy!&#~&i6A257L@c)Eyr2-r%-H3XYUrnhc}JA2t>%zeQFgR
zZL-U0<9VAM$`b|~y!usNvt@XLB6{}A%T^x<<klHve1<^a97(*M0JM8_UgoAj+sDNG
zAGb1JUkHYwH?%;<F#>`lOI}+u1})lax&tGMOEhnblm_tsgE}@;-Fe%|x`6?|6L49r
zdis<^%{8V1$B!{<OSu@E%U+8E_6Qj!C#rW)QU04_v2cFM+UZ{rWdve-eOF>jA7*ct
z&ykqgil4~-Lp*<;j)C*OOLIvrOvxX}14T7c0)FsJ{8yth=R3XRNFuBENw?cg-7(Ql
zj4~n@+6=?aHuH$@q|4eN37uY}K<Su3)?~SS7|y^wHjrRR^FVs5huWlydX8l#&)~qQ
zIAylP3*LQNSh6r7vSXOcJD#T$(zqrT#L`w=GQUPhwZe}(sHBPYw0@kXqS=0tV<YL*
zyFiNvx+i*~=mT4ymq+_fuB%8)z9sK6^;0cJ@v1hYj}Y7$tRH%UNlkF7EAxq7u75mF
z67);MU)u^Y^WqHF`3F1dq&Xz6S@&>}6Cc3K5I&gmf#1)m{*bPP<@^C1xOkmbQvPr2
z+D$#JoWovZD5h;hA$H#uds4g4=>Q2|lRO8LOn&{$Kc4dy=$!Rv^petfvRz+bIyGGg
zXQd((E*F)j264gH``rISqp&&8P6GL6KdwTspXP?+(0K(DGIM(-SF#*7D1TGdxb%^j
zO-i(G^*vR`X5L9t8-k!6zkmg>2fT{<d-iwdtWWj97O(u7MUIkm$K9B82TlGVVa%QD
z7eFiw@p7V_Uu(>0u$|PAOdd;ezq+enjZQjH4y1|eK?y)h1T4qJ_W!~lorb!efq|$F
zAb1_yCW1U~_E?~mv_H;Xig*Kx{mE{ePk!YX42Q-&R$EdI=rZ*6<z~y%p!@nfW?|`d
zBlI*DB6tg2QWB^xze^0zaB8hKG`c($-l|eOXqvH%61`@9P`=ntELK}hY6^YuDIt|Q
zgg!oy#CoBVedSiJ*Q?JdwmUxJH>3y%O?XCYrQKa`j#ndPf5AJNOI6z-Tyo?Zn%luP
zpKU$oSWT&H=f4MdjB>-i4>Ft4UeWb=%u;wBKqpWe^-L;KTH?M{V3}rQ=XdHoH02lb
zl)J}OI|FTlhy6Fb*TtM=6Z5FT?d~}*2rc<R6)3=f(;|?~lt_x?F?Ln8Bui_XIbGx6
zh<a1=j>`KhRXt`o=+U#LdFQ_BQf3<aDcI*&Q2QBk6r3N{+-`}*3ZA%_nFfW_<`MEW
z&EMR}F=^X9>w?HWYjnJ$NM4P&`o%0}V5e8<Bq4+fT4H?CKY?O<X4`oOt}TK0P+#!4
zSs$`*QBv7vJYtpDb+`~cv7KX?^ydM-xZSJ7VI73jd$PCFnQ4mj>+KW|yib|G1?&4d
zMAo+IQ>W?xuDvJZ5sS`ViKRm4S)FFZZ*L+KU_%xs%k@|%O(_f0iX7d&QQGKg;)zN0
z;0~ZB6misig4I*pCe)TgXqcN$s~ow~qC!Rpm482Sd7IZ3zd!;9B@Q(bHfM({9abEX
zVuFOym6!OJ{z1MuvF^GZ6yWju(Z_poAr;+u)(V!*TjwFXkfk11Uo4u{SFM^g#!ztL
zJb%ju@o6UM3LBL}o-pPAt0IGWjam{k1_*uS>O6r66tDD+&RO8f6=R9Hlraf73i<5Z
zrx4R9o8?pyuZDTmK4STFmF-jSQX+3dzsyj(O&CDwSdVGn;CWEd61q(z2|2|{OB0cB
zCX~}oSHYQ3&WM#uH!kHK;s}@sqo^(=6Scx%^BYvDs~&W7?Pf++fv`IpZT}Weh5gE+
z^*?MK+^@YExypK+!2^&A)o!VJ8+r&^4|>X65Vh83nlc8^q8EuZU7KM?Z@OQKhj6;w
zx=b{camt!CB}T2a8DdQb+vETxrG4TUDgA!VvcV!HY6m9X{blw%5D~rrw+5UL?sR@I
zfz!z!vxz_}aM47W1%E)Ks8*GhTn=e(YZ6s||5a#ADk#bIk7ir;qK!V|t}p9kPk*H!
zQPt#W@ql0+Jc)PzwPFQ06&p2P`@LR}+4geQqb%{F%PSK|_-v^1VZJoJR>YC(f-lY?
zrD2ee0_S=(T<m(C=;Do*;kVhYgSP@pX(rRj(!)dAx}1wbH!pd_ho=6`{T)T;i~vF5
z3<4z0CkJu-r}7@S3b?gv5#O^Fwy<#4O!$_n5rAx!G+GiPF-|xM{`oCJdn)EX%#!zJ
z1x?DbDLO7I6xgX|AY(4&6L(%(rvhd>5uweG<J}EoXZuQ1#NNg)gkoaYS8f;7p*a<u
zUFYxQ=?Z)k0HGx0brv_ii)McsW-n0(t{3^qLZ{i4#jr?fNUD^}l$+M9s-_``VYRe^
zgmjq`<yiiETeR$|DgQtu72ULlH(tVEZN$W!PI46=LY>1byCRD3d=0hDFco#Qr0=r5
z=9BM~TQ}Xo3f%)p2|hd95B+oYY4!V8J`Cfa`3D5liM~kQq?J<;ogFJi|J@q8)+ST!
zRn{}vF3wkK*AnZjtZZS?M%|$b=0rVmGw-C)Y^rcVr}9vBAFn7MDI@0^sHd{6(%1Z7
z8>q<4`LRuSTaJpR05AgmUb0XYhIf0UTUQ=0d9+FxI%k?Xb!nHF{FabQ;38KXc)!Z9
zuoKvI-8W_#K@0xc>%e)mrn|fr@sxAGvXiaDo_qbc@i{${0~(c9b~q<LTrVj%!HP`6
zbwN~p1My6WT}U>4yl1^XOsS_1X8a@?UHKz;(j(t*S#)8aGf)(P(`_K{+-`YWNF%5R
zBJ=fLH!lmQ#o3{tX7~;y(SsTA3$qAfnq;WVKD1P8Yomj7B}JWkgsvB~Z49AN;JuwE
zD{WVMx&Iogqw2XNmDY`?8RrR<%<`B{;Y<vY)!e?(@J8Wm{H=_YGWQOoEhO%~DVmsH
zl8fg*7PoAM^&*G#7DJ;e(&_S*_0~UsBkb=NzJegT+PT<CtqQ&$cvOMi1P7ikzF3cl
z>oWn4KW(qiDJQA9$}Xw~z{_-!-`sqI+9(<wj#Nnn{2Z6n%v2xTcmj$pC>4HIs)d)2
z5554X0>uI5+d;)f3^Bw)9K}5)zeZy>M892RI+%g4%$|jqBs^J$UC^|79P7UjF2mjA
zeiE6q;*KVK?&4*nE+O#Uh$<Ij(}Ex568bt$wx$^Rv?bv2qcpt1up%~}AF=MlkM;*<
zFn>>pLYa*A*^)`b%_OwlQw#(hxvJ#h6)s@ow~%TJGF@i&U$psyV8yOL6*HFWEZJ#w
zcu7kTrQ=^MtiztCwwm@xUISDzi=NkBZLKk^IeNId+Lt)C{TdEr?8!MVEy{+*3Cl%3
zmpWcnZhcyClTZ}D-4Terf19N&;XyW5ctEKQ3x@cy*h+qmYxL;|@qR2gt}f7ed3s<=
ze%U(sBs)L{fjbEc>h*%XnOKDo+8rsKl)BGi0$VbCV9^@~sh<ab_S-pGtuSf9rkcgj
zjp`&1w#{kO%;=4Zm7ZR70DJB&_C~)6JE484>vbgH5q2cjXYqC9EBha)colqX^Lv&(
zg}#{Ipzj$sji5NMqar3D?=UWU+W>S}6U*a<6Pjos{<B=<rLM*l(L4kUh79^nB@5M<
zUFH-Yx!_W6(M%N>!A2la+v4x%B}=3-1q7roYU7*oBvxjr8hHL*BnxGGFrYDBCvP17
z!0wnJ5uEWz23o7>entRmd(n0mrWlSrIKF4yv7@4AhkhOQIjc``6)j*|Y*)ZaP%Ap*
zL)d<dKUa(IQ$QD8YJf#p&)aa-Wd)<`Ros)ok#(Gn5ij$2{UMPLmivBT9zRN?j)CqK
z&B;O?^@<3T%OH--HJxTSMp$jJgAq+gZ@>71KN7aB!V<FXp=;6IALifnX*FUBY>*V|
zwP<>Bdb9^`wwKZ2O&~~mXb!{BCxo+LqaI&rLL3EjVgCJmw-Kp0c>?X6%cy}^IP)A1
zEOpfxG&xraDj4%cN_Z*8GX;4H27`*_*jS(@6Pe_;$@`<(;txMG!_Qf)pr`@*vd2W;
z?*g}j(Rkvf4Lb(FA~bed|5b+NUjmymJr($ASu|>?EZ?%v(W@byxc~F;$rR|UoCE}k
zrHSdhzh1WM)LW3rVXPa?I}~zplq@HE25Q-jBq5pWMp{g3><4`*upy`D7N`)VeYB&f
zbv5|elyM1<tY-Di(ssz6&t6C^!+HJ8te&gUpR#ih0jnS~v2G7}eiS-J+zR{2Ojo+$
zpOUSxKIk^M-DXuZsaV7&BOy7MOqzR5hu%~xuKQ_GIs-eyf$rwXJ_FWA!!a7kldA6N
zsMhkqv%VTIr%L}h#(0C%3xF~7MuxEst5D)W`M?&{WxJTHe{2NcVpiz7-^nOab&Shu
zM>b~?I%cF2XjJ*u+7j3)WalPB`b!?yObXXx1TRR?^+^1GsRquqS3Hvp%5~SNeY1kt
z{r>H#8WXR7vEh6ePv)pqBR?j8<7LH(bt53;3G|5f;Kz3@rb4h|r#mK<Q+uGcr4dE~
zJt9!{x1u+hf02J+oI1wbb6yW?vz7lWCxSAV87vouA4Y<6eI*4HfMr(*gmeIq4srB|
z4;$HnukEuuON;8ODsmOTI17H|W|D7i88I4bues6NY#53qb4ik#cy6VS(DIx<N@fc`
zBVf;Sg*KZ8F+QH9u@%yDiHgQAQ+A!^)hms}&FhEK8RC%FZW4z?n(qyfR|ZdL;Y5(e
z94@aF_ap05*n#rZKi`RKek;m3)YZ4^vhDW=B5G+RAyq>v+`aJ9(*+3SrtXfeZ86ax
z5*e|N)&LPM{l1Sjf9|u1rcyCvHvKvUIJOero5db~y12fH{|cYhm6W#Y$~GN_oeIkk
zc%9PRz0^cOqF6KD?n#K%V`GAvoSlEz0eI!02J{T=2Xh6XX|TP!?rCGA%A*+Cd`b#0
zw-%X{00i~iIaQ*9p&TrMG$zHgG9#1VPj2uysG2sP>z@S)1=Dj}g)`zO_V=p4kf}x)
zCEk@qBb{BL>|M{1W9W#$F8l275!*|#C!N=`X|_w>GDhcAXMc^n*IXihBl)6Bq&~x@
z30hyF(10~${PrltBcw-@g_+RoI`TKpmAv>GcO-|~9;ft4J)<L=O`0L72xC*WbL3$~
z7+%b2Crr>ol7Jfp>bCN2dn7=B#QeCj011gEjF=}oB=mc{qu|$T0Rm}X=DOn9hBe>d
zqhmO&L>OA*X>JH*!-@hIc4612{nx>cc145+#BsOX{gOqA(cxtCww2kPnvSAK(*YS%
zlz`iW+e0@oE#40iCIp8E;EB{c1ROj!r16f7vZkz9)SO`RUcyBQ&hr(Z*#}M+)Uq{6
z<l}3*EF7dWsZ{n|a%-VMZ$;M%e#r>Eb^G4tp3z8JEM2JLn$YiQn;RvbJ*iqY5BGdE
zKoRf+CNc^EVAWJ0DIA8}u{20QIutJZwdkVOfHF*5^2})rU?+@8+JUE|Aqy~Weruh9
zzFaFLJ<Iz_<0EpU`-=(F=P(>FgDp|rVw&Ayn*6R&stVd!0PGfY^;L$MmE1(sq^pQh
z(uLDFP$wCWmo)lz1g>A<<C@-|e3W+(aH&Y7i@6F)VK%w1<ha_^y-RuBYls=Aj%+m?
zg7Jg4SPduQscTCb2J*_?)Kc4mBqAv1vRUA>flL@K?Ye*Tn)_sY@P4ecOi@@hG$%_P
zVga<!#rA_Z^D?GeMUOk*HzMcpnS@R}RcDInIp{=?tMRr2nD6uXf4e>r#e}YrZ9GOH
znxK|TpZZbtrh1KWOF@$X38qt<4n(zv5Hh^`^X>C<iOO*for4!W1yBI0zuPBpGYV~f
z)fWVF&8<xvv^w9nC7i2&Aj^y2Z74~edYLx{59d#jR4aOp#oURXnv|!H5QK#5L8~w1
z%fy20`ir3$oA(Kd+kh&~SB9$@hW*sw7XRnpCk?uNCZYOP9Gie^$B!g8;w{stDOCA>
zM_DL=IFQ9P>~_dRTCehvbFa6PXXyK3ZT_fm9u44VwU*{U#W?xKauZcXaLsjaDfAo|
z)q%XIZzUB&l@zDz_8gdf5X$v5e6=3v(B^3MH}&FV?aW88_)E(c+}7PfLQU45f)Qoa
zDI2)E%|f_m=iuS9c7I0WZK~rE(_K!|o#p2EzX`MHa_gLseCh%j(YaQXiX~7X{X8I=
zN-2<nHLt1+9z@V>-1z9AZPX#{+)oL9PjEqg9NI^+8tqwr+{OhY9tn)eh_Yg^Yu_6b
z)YIy{5ua*$q|o21R4-cEgHaFGHII-JP~+d0>y;xVliKjjAJxv73*}cy<xK3zjDv&L
zxYFO5LwBn}MP!pXv_e``nQg40arI!TYgN^lL{k?2Q5&72S-0i6_)WU5>+wrFZ*sxx
z&?rum|K?9b*XPF4GV3e6nAPkIG_h#-Uqy!QHd9@3j8r8H5J$x$mzQoC8X}>W7j_(Q
zXdact3Gz_|Wh6xQdrK=M*Ri}ZYizRz=EHMIeOP024)xg}P)kBN`ME1>zh!f-xwB)L
z4`0uc+@ck))+(@p%@)L&_+olRWYg;j3uFmAq@I?)Wb63}H&FIN&|yH(4dQCri_h9&
z1I=wsTpv$TBa$~I(Sjozmp$=9r?c&I=ZFHm^C7SeCdL?;6g>0ybfepiKf7{6j37*C
zPkL~L5G0gpkDc&xjkx}t+~$BSuW^kE!x-X(EZ<;P(K?Wlu?;)kk%)nDY|G-a<~GlM
zLg~!It;XKh=d1fX8A}1>u~s2Y6^|5C!R#<m`mdt5#8MH4=WYiVZelECFnJt316ss{
z&kN7&;+&@;TDE!Xx4Bc2juu;JfZFwnra3;1;RAn1#6KdsD7Q7XqIY#Q?(+Wk@NV_L
zWRt4U7i3jvV37+L!soHFCv*Wr!Vd3_x;dvWXm{eVs#h3gE$%v;Br_aqqs+xe>Ydpe
z1~?sU^D9jTK4pm&%ByxhHzCKMPQ(f{6H)$g!H;UV7#|QR0&UP~^zqGi-s(z{U8E$7
zl=ja8R{C6txImURn2Un7jGaI{|JWW!K0s9e(?-L?joVY`>*4p(9-k2#r!UuxbKQC2
zb<b7tFkrpo9nEbD0W((x1UjZ=u0Qfka^<R#u->~<AZGSPjE&E#7Y264<0}=4n9Hm9
zTBONEP_ekM`7em|=BUJH*dE!C5SoE-1x)}lGEnQMNLyy5FZsORL$@rbsgL~igXk&6
zP4+xa|2<V4zTfT*YFvI*mePQ)yx0}%T9s6te88fXNMw8CG@RM--pB)K2akM&q|{uN
zd;pv5_(}B<tANc?S9A3_w+eGGqq=R5ezR@OBSLx8(Ims!mTLO*Q*R#dF^g=VQnOBb
z+Az5lq%Ndh9$gLi0^^uMEQlLw!!w}C%ngypPA7xk>f{5WvA-?i6m_-sMY=qou#EMH
zO_HJu|FSN?3ef$6Evo;8_ArmDD<%Y?)wdZjwrKBz$|J=SYVVJgN>XF~*=C=4d+V-0
z%N%3L7<q`_xqgPJ-jtAVIdYw=M7rm4niq0C-MS&FylB_US$iVE@YLrO`8edA*1UQf
zB+gfqUPINqAA3%xGv>-+{4Xd!*OG9y_c^QvY%<5(|3^_7+lUd-Lt$|qmK+lCgU%83
zijv*B+R)kkb)?k05~D5@TF^|K1*n=+E~7Yn*;#7LBUaZ)Wgj^5hXLeLDo!8f&Ls+}
z<1K&~oyH;BMGc)M*jde}%6afW*fgme0n#kS)=;)Q4_`;Is70NVEFy^Ethn)%3lslM
zG}sZ_r)>xR>sdsmgv2Z!|9-}=CQOTIDZO|)Apriwd2hmpLOYf$L1|<8pq+p*rT1QR
z@AkTv^ew7&o(Qy+OutjlbkhzZO`&#}=!M~^&@St3th`J4mMXtKm493~7!=Q|ZXJ2s
z+sA#SWsxM7JxlR2x!>VzNXv<Ydx&O-h>I&^yPt#IT&UKTl)46wZNKIVO$$d~yo|9g
zwO@!fB4l&l`00d2f_bpuAz=Bn#4jC=Lo<fSPe{Z?%3ZJUG$faUxsiO+?2N3q?HC}G
z&qm-5<7#1r5^r&9?1;_%N@_)%e5B`TZqoNui02*rUMq`+q)J{pbfG3VmcP|6^l$AF
za-3L!2}8366BiV!TJF_Je@oU&aLfg89t`&LFa0()bFn9GL;Jp+pPw%!RZYKQ`(^R4
zxuylE>ma8@AhvdqdH$%1xl}AL9LQzx1$F?ZXRCW0VKZTB{G;6J(?6LC17!0Uf|W1<
zuaYP^3St#wxNAP1T#ZbUaq#ip1nKi883%$Sn#kCbosT?hz>y&<xQZ<IN5Fw>;}WV;
zm<-=!WpsP3P#p%;c6}T84AZKZ7l)M+eAr)E(s?M-()`~*JBBNlNLdF8oJU2-C_dPw
zI<}a&AB&RFcqipMr@BGI^vG_1F1>ph$>xp=JH#17YD#K;gH@U&&NKKm(3nINtiDp-
zudOG#LO<^*tV?qvu<XdI;7+nMot%#tH1sKSo{ouKYkOoP(L0kJ-b|;Et}365TW&RA
zY&8guV3S3$75Ro~FAjGQ`H8FtP{L^~sjh`AJ_aSR>YVDnRaa`Ztr=+{vCO?hu4Mm`
zbd!67AVjA|>>ChDOf$76W1<jW&i}B!RfJ)kH?UcpkaZ~SQ02XhQ3eT*oFS|cX}|JC
zMJ=jZoANd1@r1_$R2y-946qVMt4iMb0dHFz03J-QL$;bu%4p)fJ>ObNj_NHjT+BT@
zIYEq<BERs_slVTge_VCyp|2w)RnFvvmNET<64Y5QdLzPJ!VKS0;7cD-DC3c)-trF~
zZyLY)ojx7(x-<?k$R9(W4-6>!IPS{#o{$~Q1!HZBULdzK`sM1qbxVIQYGvllNzg1c
zZVE$U*HEfO=tvg!m_Dj#AHpzEE&MbNIQ;bu;<{G5@xN#eX=1{i4Z9elap5Dd*w#hc
zT^+y~`Myo}6d`DJ%^Mi_5mXg9ct<z%{=OL^F&myi<p7}EVQjU~VC;o~$g{e!-%O6;
zs^}c4ycnY+kw=|pnot6(&vv31Z6N~%<6)3JLU4(z&;vm&yaq-X5BW&yj+H*Dd>}2i
zoh1U_x>wWrmemlnD%bQ0h&N)xY?C@{(Wz~;x(vSmK;-Fjzd~%v$47?2G^C0nPuU!`
zM*NzTA@0HWCQpun1`C16{r^;oS~Q9)u!-}veEO^=wu>~vK4=QS)WJRm4G{ycJMuzB
z8i@i!y{<R?(po%R&!iVdC1^JBKI894+5^rQ&6(2=04QH-n25=}uFp4r)ish)(?zVa
zwTsQhx5;^S+CP$5%QgjG0dDN4Bli!V;heP*W(*g9;209ci%>HvH9))|0S1=i0xbFF
zk92Vr31GM|b(6zz)0@j+SQxrkea4*zFqH~4#Mz(*s%bs`ur7U%Lbwy~VgTC0k`}?!
zMo?0Y-VrVQt6g<Zn7Q2^`gvQ_oG%#`?Pcj=Ftl~(irat0YaV-R;vW~D)AWh|U`Yh;
z)`t<DO+R+q*%>Yfy@pGHDUG)XuCY+Fk<pxQ#&<Pof}%9kf@LU#wS+LfdOim}M+F`o
zA~p@uA57g?trcwZ)NV|~Hf@Q`pRAq&+b}tWEip3Uq)Qv9*Ysx6<<Zp19^cM%Y#Hs8
zTBBB->5kYk0E)(=zzhF)ChK1F!6iaT6G)c-pCy#geIr!;kOSe*qga;1rbpdQ$r@kG
zD4Nk&#h%LB)#}ikZq!JJd1-4uGc-6RnW$d=IGqDZZ*#JGW7XrTPJ&tMv7HyVBpYdL
zRG3WAD)Q-IQGpyp>&}D2(Z}E;@auA$!2yRbnYLJ-_&s_;aWUlO^<gpRy332j8mhs1
z#Vx?LE0WKr4uaT6X!@Y#g_8K=;D1MZ#WC%x#>Z53RR(5HZ_3Ox0QGnwno4#+1}_=m
zevCqgD9@sPX>-DvR4X7<&dB4L+C+Q*4<KTlmQj;h83<z(SLKts*q-3lO<VXwHT7ko
z0jp++Vk$)aG>Aja2!~(gP_Ujwp0R`d2_05Rs-U&fZ7JdZ#ut9n-sf%b&EUx#*qx~D
zTSAmRpn6_ROU4hX2^yQoeR*umBp_nlyrvGKC9ayL0o{9w5`1KurLxOBd$0z74|U9T
z7`LMP7!hLAMLb?nsnG5SHCQQ<L{kjf6m0D0ECi+2628qHP~a$Rc^~-|Ae=gXgw0v=
z-(kDTDD_NF0S*YKd+clO^Ot9Mmcw`Z44xIuET4%bx?bv-YDwdY)s#X-uZg#H@%{mi
zYNn2)2cFuK)<(JV_ch7r=pvrB`AgKhbi12X*R$>WHdm+~Sd;^bEWeli!-{`Orim#*
z;Mlm#Ta0lnsL^-kc(TlRX__}o#|+Gi6ND)-q3CDxffJED;^B#JSMpXfIt!C2%mLu|
z5WaJ!`gc!h@O$K1<0B0(HlulB3V6Tf5aT2jHE!#Fx)_J8%|rjdpqj{=M21ki`^l>E
z7&JTca(SkCgfiqnr#`mtZAJ*O^PD@D?!6sI=q7aLq=V<^OBVkI{8e8bTClf}Hp1_g
zY5|<O)4ziHn~!yD{^)CPX-A<AQC|R>`f(W)KFDA?dmK5$m<%RQ(3j5SzOmJR)gP8x
zF?aPEAJ4c0Jxn=fl+GM{Nii{oL)iZ+?)Okh+(8w6@uIZ{sy1Vq%o|*<{vt7x2=p@)
z%q~1p@IPqOPXmEf8k*S7qhU)=x(yJZd04>ljmdN2R;m9gNU1-F`kxdahI);4Cu;24
zaB(Zlj+P1CZLK;;CR)(+|Ls2QNO9>Gfb3wm)i782^B!>%UEINCeDT_p7CUl$A3W#4
zc&h0-C?T}mXt5UYL^p4}Vu^IH(Rjc30XlHvHXU+~V(clrlZSM^t{y}$q5;#z@kROF
zA}P4~p|FGf#qoq$>Z!+9cx4q|;=THIioe@I5CWm8eV&NCr0c~~DQ>yc;gPMY2aL6(
z#!V?wHFp5*%n7D7W&kYaU8WY{6D@f>u1-`Q(3@j;<$TNP*f)TH$rG;%?0-+FDLRzl
zO->6&<EK(mM{CV@IAi}gfUyA<ONordT|;U;oU=z>p~Xjmaho17Xba1^TvKk(yO_;H
z&jCNFPYY>4lBbNC;zZ(l$ma_;Q@Y^X2OA8uwULc|&}lk|os;D&4@u~FVBwZ>&uV95
zhFQgCREXZt>VI9K`k~?By8GZuIUtyXgWKK<9c5K6J&!h;9s)0tywV`?bdGg(yX@DP
ztWtxU5NF7sTM)`h(Y*TCJ?Dbaee<NLJh+{nAG1(H+Hko|obVwHB>ewVdM|1Zugzib
zwwxVRpg8P4Vvr%cTb{1ZM%9=Gp&Ya}+10+59FG+AI``|B>P{&)MxxV381j36+c1~W
zk8X4P_19uM$rnngnk<%SQIqfg!1~T%w+M;<0EQSu5Neg>ie=(nybAxg=FAM;eyaGS
zr8`0Q#e;*$q9X=jy1^X&>{v}w!j#f$cIdur5Ywx=4gvZZ^HkBH_$4Avuc8;{mNxLA
z$6bU33N!rf+)R(svj%Apf~-Jba%`4b{dg9SwcC>YE5(5X_xpgRGHL8k(FCT;vL3s>
znPCAto`CZNQv)>`Odg(YVZ^#wz-6^(*9FWP_3b6+lkl_=SLV;53b%PcC=6EpS~z%f
zS#;JM3$Lf*ZUpgKWh4pSUN&9xoW7zQVtp<lQHdUx18!a;AyA<coQ`?M%(}Dq`U*18
z3e+0(<wk{eMu!RcbMJ`1cWNB%YTbM!5QOdD83Vh=C=Vz3DH^2cwl?zfIFS^hVIEo5
z@p<{oXCxWXm|6L~x})c4H;y$?4MsrsmZ)pB*YpYe%*f&$F8&6&mZ5ZK-5Nh<ovV(R
z0k)o#V&!zbGK~8QH(p70%n_{;n?mSbtyjMW;o^cPkZ$OepW+Prk&(0H651Mn&9P^D
z>t&dIb&x*&e&53<gwN95TlA!S?;apl-IqPHHuJ6YsO8oK!f8&~x)|e>T{&pkw>Ovp
zmGIZGzto=56dY|tBRoJuPST`oR0Dlzaf{A+WZyMw5zIDWrQXeH8U0ncLE;q^Xk!_i
zOuR{?X<WKrAJu_X4=_T7f3m%bsl8L=$z6&|rqwO|c*GocsuY@<sBMbg$$3AaDtN*Z
zs{rpjpwl9wM9@!YlUQ2rbVUa)AeZ!jTqKS^)PH8Egm+a7Sz*bMDEuOujd8&b><)A7
zAY3W{<Z3h^x_wMRw7d|Yu+wnI&xddUzi~OqF(;do%Jye6P1dIYS5xXdU0>N+SL720
zdk4m&4HBY(%7>!BO_A`Zs(){BOvpEh?`BnXP{C6{Y4gj)xLLFSNQiTE2}3Hkr-B7}
zFZ<Ko)j7B)O#*@Or2OT3RQCjEl1LUviID^#TjKhJ|G_~wpzxgrE+j_{cf_{fO8K1$
zpv~G1vIDfUTJPcp+I4qili|H!I1M7K1<!F%^24@SAM^KCnpm|q$J&Ia8z~=G?Hctz
zwXBaUQpWWcTCYMJ^1@WNiy%I&RG22+;SG%cA*vQYQC2pX9J{|tD!xT!i8(q}0^SH(
zGKR@FhjH5%1e+|IKH!0!jt+>U48TF|N^NQFSP<8_7c;jbH_WJ0H#wV-hirqBc^)mC
zhC0k#WuRyxxeb+!Vh}yxG)PYO-#MJE$)pSsA$C7Dl~KxYXP)Q2q<U5CNmt=aI=n9Q
zMJd%+Sz=~#DYB$zlj<3f?G%oZ!(*Xa5n+=b@|=o-?llvgeYh(%90S>#Bqn)QaTGJl
zNu*gJoQ4Hll%3KV{+>oXf>j?ZDv*x+W%RjPlApi~Wt?aQj_$D=8uQSj`Gg{;gWafk
z5+_9_kct{!_&vK(umahX>pIsX_nyGf7-^0H(NN=|ud7Lf=v4j>#%}aGZFrxa=a9od
z-$GY?vX?XLE6${6xpAg21Rgd7Yolk$tDGhZ$ngSCiapk=L=i50WZEj&E<ojvf04HF
zYV}`jdkBQ<GJx(^Uo$o&mZj=)>c|tdR;=H|Wj8lctO1@8(arflOrpaC+)dxl!2w|T
zz&eEV#jri!_kyM}HysP@7O`$)>8u-M?de)1{5I>1p6BB)%e71i-M|)vT>!@E!6?+M
ziMLzY))sdqq+$6vQ3&73lOs;PH8WD?QqSWu^xSr#a3_*;=d=A+u5)jk%ynCcCV`*b
zKX!1iAUt{aGpWr~0i+%xDnF3LtO5qK6oFf6UEw-M`;e9mby!p*)Y=tmY1{K{%(S_*
zd@RnRPI34NUU*_I?COB2R`h*bah0Ipacsc<f_D+Fmx6R8)tS2BVW8Ap9;;W(f%!h9
zXtBz2xcl*d!NB6}rkdb$cja7uwXWhZ1-YnT#{yNY%nI6oM8cFQf5q`<DM|QqxfSrr
zpJ}vkC0FE=NoAa}PyLZ4XwFy8J3+|__54tMv?r3d1%?KyAv1d5!|R!cxWD#j3Jq5h
zO~bOSY{onrsBC#$4Sovps#_23r)+O#Y`tyhw*HxUOa{GluOf)DS9%B37|fI;P@ai7
z*FW5#W}a+|Vqg&wJi=!3))VI?wAvLJ&xBMhVMv!xZM#(Yb;WEXHeRH2;hwXRP~+H}
zdO}UOt!&2)f#_~fpaZ!o&aYdgS#uieHF->j81>mc);|-#XCE-P4lx~)3t5&Rt?0f~
zsP*hC1okA`!`XgTKX=%o6*h+3G3$dIM0G5#@9D1$mG0B#CF8*;eefSGG7UY;&x`9S
z<LcC|ZEv;Yi7Q0Nmy-z)eXTkFeAJay9k4*gLs|8Hz2Yt86y`Kx4zJ-K$YUCp2nHb1
z0lP+lXYHmaYfIE;Lu4%WurUK^TFXW7N7(ZfSQp*6Myf8Nvg%1NHg1jZNbA7Qe8iGN
zoEW(ww%vD-zpSl1jCD{ih&J?qZ9cSM^~u62X}bJ!X2eMey*K(9X*PYl@3@4mFYM!O
zB~x;6@S0o<;^n^@I<Kv5)~QK59O6bnSa>ODIdsOrw8}BtQ%RgTqRS$;4M0+ALvQW{
zT*awFfv?Q;*|4*_=XzXKa8~~zL~IBHd{La72!&0=Q~*K@NDYXf6!6Et?GhsE<MEAx
z*f%Xt{eC3wN!J@R*{j&5bN;mJ+?i%!ZY?LqBAW{2!wMGe0;+WWnRZ-oErn#9Xj@8H
z5u8UcHc$L<L`xjuCK5Rwk~AXSEV2`QT<NY=49vp8IK(LMJ*H6w^$=C`M~nj-@v3~8
zMF#0_#hi$xwwPDz5OHN0x+Pt*v)*9d%w|A@atH$OR5T%rj6Zm@BazItU9s`5_qrDc
z-7YC$W#6w9lblCi0puY>I-?+dwh->u-tgQr;gGx%Iw>Q}zu5m%*I+{gU=_C7To4^`
zIG>>aA6_71z*VbDu92xH*wNS=erzm3a#ggOseEWxSl^>A41T3&I6Z=8vMWA}|GS-E
zq=qF$Q(u8r8aOm0Z_qzYV!xVkp11)3l9O#PPvh)xdgr8sF2A9M(Kkw5Q<lsuHh8x<
zr@!17V39a-mLK?hRst!iorV{hnsg+9rnooh@Pq#`cTmqx=0AM&petpSLIcJl{;hz9
z%W2A<XZqOeDcn^+(57*o<x|TYE-FCsSO+FbtNd&JmeO=Lyyah{()*f@snK$cf5Mzm
zn<0eML?s67x)6xY!L0A&i~(r7r})6wpdO_T>OfUdA_Bn<(^k2RuF=dhk`HsBZHaZ(
zbwD@(iIHt|P8kDN)rZ8nS0dGI>dvKXr+%p^SM=JNL+iPl|7jZmq_*M)5W>4E3)hF#
z+VKn3=v^$3eW1N-Jh}-HBQR=nWU5*M03}Xs77Z&bEKJ;7-sq7(4a`l2GhL%k?)g#~
zgm%*ud9$T?3^E5dA`BAcPhUBD&Q)osjorE?rSA7HM3U;VyQ4Fyn1Dcu9N>Qap@L-Z
znisk>$In3xU~|o2t$dCwdiL7%wQNX?Nq`BtlK4TyUrSft2i&Zt?;T!pV4J*fj)8fn
z_O21Q08MaRY`t11Jy;?ra{V>wSjM_G2(-4Qq1I@8;U~S3b4G)9=6Bf&cVrPcQRPZ{
ze1E8{B6meI-N`Eqgu--dRYYtf)b~Rv@*HdvTWKLO)Ly|KHd@LQ=9F`JQ((PfP)DU>
zJykohT*j*K=tHmv<rD}th*K>;cwZ%*PZIi^I14gMuEH8>5JA3%9wH!NUSAQ4@J<HC
z&h0_#M16X3EKHOZR?y(rpS}A}s~;wJWgR2Zg%kXtN3SRHXZF0X)-s8Z&1)K^e<BfY
zgwQYlYD>OF|DSni%vj2EUrpUE+ZriU3R+Ljt_H}U#*kT_KW)^)2e;v%lD6gJL83Hx
z-^u}_<V8;pa6!R9TvDsGF&^6JHUyizR=zf%e+)F~j;X#Lze?atzV;t$Km8b?%_kL~
z632Koxd9zZ-hKai?&83{`FOH*`HNdy7R!ood~)}2%rm?OB{bYJ<WwQU0Yr!>gxEQ@
z+%}>Sxl{J^f=A(4O|7ra9`Ltq*LI)Na`>|S(S<cs##F_xHtE=XiMpdKpTyw7O{?h8
zAEdu!`PGi`H8!ouF52Lcg44rfLswRjJ_-CpRH(`krm^0G`6fu)u?%*dLKjRj!`R8T
zp$Vx9f89pZ^GF~>QNs)DBMTyUH6;L|lx*T3hdoXx9XnC)^(MWfVaJi30?BGLm*(FF
z54T!uqS0z>HEi>#DbOVnYAp*z^^0W71z)dvNGP1Kuh)J|lv0RH|IL1?Fxh`OR**8Q
zSO^T=+=^=Sl4?%dpUA}p#049~`%UYm%+QR_M1VNWrG+>lj4N%Xc<l~|ff&}-oC!k(
zX6(eRk5<?e;|7}{jUb*6Vn3n(0xhm2>4j&lW@-*4xDC<$aGh@h7kuQ*W`aL0Xs<$o
zHM`%3d`BsR2muSHC3%xuqU#!3o`@7+GOVsv5Tg;0^JJbEn(@YgFw`)rKgmlNe}nX`
zn+5N6gu(bT9wul~=Qv7PE%CO%wVlZ-V5+RV?;R4_xXn;F6e!6Eb6zq#xA1w|YC2{%
z(-R6b%O2uPk-Sxx!LauFp?i+kXUKT|xYY>s#(p}gywgX{H!hYcI3?2@B$)7{7W1ls
z8%zq@ZUx`(D#giRrJTx-C10W;`VL7kV69QQ2i#l^$B8x$l`|PIn#DIcUD<!RKp~Hg
z(eAffOW+0nx*wlGn5ARK&jZFLT)p8K%u%X)l!jr|w>UKEuD+<@p(@M<$f<M?!Gd>K
zT&8G_&}A)Bd4LHTM!hdI>jc5S^yaL!)U8zUA|gbfg>s^*BR>mo><ikrB$5L3gO0ff
zGI+W?f7u06l4%z9&^sEdaPP*CyX^H@IrbQ<j$`x8#tIIP_19D};vCcRB_UU{jYFl|
z{;i<w$vvmA)a^&?XYU4zIjU-rDSp6a2x`usdK@Kwjh3y8HS&?!7;3=R2#N0N8$>U=
zOA9%JH7+;FCu~mX<#qZCef?#TL-G|py1Ve47!9<jBU9NCHMY;)?#5Rqtg;oY!qA)8
zo!T4q8?(aF)!ki@|2*G%WJ3e*v{fowS0fIxTk5kd_pv&x0?kHRH#D@as&H-~T^bA9
z1#g}Kp4cbbCR8a2;f+j-^^M!YlpF5io`$?JUi1oVbLyIUPEz9RgLxXv71}u14oWd1
zV3i5Y1B2-n$^Z(!J4@(ECkk1QmjTWhfxDFeJCOqC7pd!f=+d3zT=Q8O4Ae1Kvyv$a
zZ)kedmQ~a8Fo(ar63lt1JxZGtk*W4wkMdsnCk?sGJRSOwIV%V>iJ&OIQ@De9M4=7+
z-j>jWbk8C~0`zh@QI!Gl1UeZWiH%*{FUyb|al$_Id4rvXxWmAPu28%Q^*T}l5iLo)
z7f89&0HnFtpri_9scEYg^A%>6y9_lxC%AR!OqP!K)8$7bCFi=vrZ8C^Eiowt@RyJ?
z*gKVE`#eYxJ^yRuw9ZP0l(gbhivF$5!g~OZ!s|P!*V-QuM)u2kyPE(xK*ql>&$6!$
z8u({NEi}LkCjkWGW#4VYvF{p_b&t>gT(;#4#rVsuc(19K^MbYdj3ynj-7WUq9Ov~1
zotfBos)v_p*<nWq_J}GXo9hd!QkDS>NxYWxpI(eF=M}OQ3DTfY4aLzaV+CgP0K9ro
zZA+oJ#Jj$0rCqwqc9E7|M?aWdbb9l0&5<|4*QgWXH}t{{KSGnfjDmZfw*{sbv6{Ib
zvySKl@q3tnJJEEg_WRqx`n4F^Ex8+1%&1NR2Rg?CSs6XSJF_Jf#P0{)B&t0_RM;F8
zKU9q;ZXTP16#F75!OD*sI*d3=A*y9k*aF*HrejIQgH24+bbT<k91Z}%D)eyzSqy$d
z$z#fbe#{wE)qXC;5z5~{6<!>QcQ`Df-kl@OyEXI&%v}s`);}9H&5py^is2D=;|)8L
zWmD^A*}=Abh5y|i^g+B_zxUQBW3<8aMetM)g!X$4?3FBZ$fsZ;LC`UJEWhl$BX!6I
zua{L?V`kTQDYulwAH2BFwuUXwAon>+87q<BgE%7LspWO9p6mBiF|*k42v8v^lH~Rq
z!4e1JgdU~v*&Zb8b*F&;EY9Z_QjL(&WVW)*fsv?$hiS=F>&l={h-T8d`=O)?{hG&}
zd6a3`&s)4wW<niM<UUjQ<P=>|ZKlVU*sK>h%(~tCn6tExX&IMslm*k}zmvCgxv(rl
z8WQC@`)OM5&E*@*jC-L~JVAuVK(d@Hiq~pS=YgK4^v7)ukteezR3<&!-$jMlC*C}p
ziLq+i-XSJ-@UWqt;?aW7qV)q$6MGXZQlE#?8y5S{1!tYOe*we6wc+w9uO0wEp=V#B
z_832cfpK?Ki<o9G{MS3W{C{8Jy+9A;H6LvgwS_oyu*&A<>;=#s>?#L`&5gn7EE5~F
z^EXdf3oZYRBDI9tx)h&Pzmt0=xOZPL@<f{Y@WXlB7E#FP08oN=Kd;;#z_K$woRH|5
z8_`&zlV?s`*kO_g(XMR`V2WUj<6(e}2DKoKKMdyMXjG-!IdYy{y15w}7L{2-#TmEA
z_g{vwx68`oR%}Zl<QT$a0*N@?T~eQ6`!b!yavh=N)9=#N$S;|<*sTTXw6~5UjA7W@
zZvEI=6~8JvOA{e7;kJ55=0$*NZ4WLwaKDZo<BD;bQD2q_41K<j{v-SlVr7^-n63Y5
zNVfPlz(gadoQ>8aXZsp80COT8kQgqe9g(0i#(4s!cXtO%?kl)3Jn@+<^pH2~Bp<MF
zL!MR9vPnKUAR<NeAO)cNfOgR%DK(=9j<N!2lV)O_FZAGhdUdi@#sPe6Z+uEL7vclT
zeqW!t<lcC)mBrt>2=Z9>$vxF1p9*O9Mj;CW3}MBtp+Q_~U4W10so~Bxf;XqH50OnW
zQU1d2ql-8chXn1>6?L^n2Ad)rKG>a-h&Zoi^%;e12Rs7GiajBL<2g|E9_8nXcf1+?
z4!sh^J3`Mf(^^c<u<4i;T<2V6qK;J5Wra8HT66vuuP9YINiY516&uj<?V5}+Hkr&r
z(dEko-|hbn(sUZ4c76*qKk#iBh53&C(<bVxUQXUMM-AkSQgzr_0DKP<$wtFyp)Yev
zmBd@9vRL~W$~#oV{`m0!TdBECAb{a!9=@%#b;|lcIm1!Sq1@wrAR3&9_nYhDf}56x
z<pI=CwM!2%z}}s#o~Ad<HP=o8@Tu+tP&VG%M9sBdzF&p<=uMS}&%aoT<&^|>+VUio
zs|MrLpcE&U+E%`&%ujRvovJVs%LQ{&wne)SRc=3urxtuwL9KRkdkb<f7mn4F7)gSJ
z%M*VZyk1o&Uo_M|aI^g7I!cs;svL;>_dd{(`j}@>hpN?pW0Zyoy?YqXl^^2Vh13AA
zg5#Q?DR;p_yamYlv;qCr?Gu$xVw*@NCYDHu)vF!gzRM;iLXfDxy`~d;8giDuP!t?p
zGJtw8^4elI(Nr0KIPo~xK3|sBvD$e5S}*Ju8OG<}m)d>SCPh=hU_Es|UY(iXz336X
zA;qr%fxt87@)*JWG|Eh)kjU8NrxXYLeQ7m$O9p>mC}jI|ttP{gzM@Hm7)n7-9oqWK
zzBFp2W-xbnMHm6qHE%x4+1Yg+D0ZDeW>k*3G`>uPWYT^Za!FRI`PJV}_`C{w7ujPu
z5QtfqZT;taG3<sJ>@`4}8BtT=MWTA|dihxysB&Y%fd~K$^Y}S-+#u42`aqq8`56t)
zWbyTnG~*kKU`=$&`Nm7f{a5<lNmQwtI27qlkagSuy4<FmMGg|h%Jya?V|w;1L72lw
z4fKLOgFMGb+Po+VE$zsXqqfl#MPQp4l*2@B^)JPsTLK5MG2}1*`GsKTp?3D@uu0^1
z>dxV1+=a<I_Y^vy&;7xWlV+T|mDcX35s+;U0S=0*+-&~YL;(K2+1WV1ji^k1Y=ZUv
zJOYK)paB4bhuv9+S+HW&)K#DSI!OK6=bv6TpJz3j_1$l@1+(cWVvC7Zs;=*m?%=0v
z0Zx%G`43D~g{Roaeo-#MCnR#BWcE#-!I<up%F=f<o~I|ij(8ed{qWQ%l?wRCR72_@
zc6q6Ct1cF1^1l(?I*s`bca$+Br-RBSD&r3%$Ecak#^QI))T5HwV95$&!**4sr@his
z&e_Yj{j=7N4oFWPx0pDm<K5nOcFr(lnRhrKJ3s;|8<F&1s(!Gp9+HTISR;R*OpwYE
zE#0uc!h;G4_GOOPViwI|#@TCC$>4Z8JPXFNt3lRhPdP9wX}2XPgp%nP`UxOrMm9+`
zH*e8iKjoZgL0Q&LL}OXKr01O8mxwY6Kwe3*P3iLwP4l~I2Uc;9(F?=|2xw*LLCRn{
z)8!L4q(S^1GMYf@^zHY&OJU&y$j7yeC0VYuZo}Z<JTCg;VMR%t%54b27Kyf7+?+_-
zl|i*T>1_nuS^!gW_cQ+VNwRkKMO&{<^q`C}8@UC0)@)1}#(__d@A(_hrVK|VTw>c1
z9YMWA@L}sRMB@VxgI=_N2f9~7B&QCp-Ym52wXV6(t|S4PQOtFt%$n!5bqNu`(`<z<
zA1(IAx&STp!C&S#n{b3%S&zf+0HIm%p!rx~!=}VIfrq^Sv?&pQ?kAPTQCx|=vZZeH
zz}H~1Jvrx!D-ct(SaWV})gujPE?_wMOQ=YgBCq8zQldn1cg>N7@cw7m&eLBK_fdtH
z7V;-*z=yBYAUs-rMxC;bhYk#?*zNRVbLA<=<#0d;@3}!7p}jX16FYrGFP`!D`H_|W
z&`Ki)D)1>Leavjm?!ylg@y)~HBb83v|B#=`0jAYz3q#vWiXNUs5d`W6F|L^1_Q{p5
zE^4mCT*PK_h^oiD{#Ms1ZMecmya$T6kSp#u!vax6=m3LHX_RzSCUqkJDNKdz_yaH~
z&6dZ+$Mn8QPv$9GePJ3ujE`O@ZLu)#!0rh&?ja;2x^EY&tA&)HHLn#q7`u+?JVm~B
zANaBW1@!fr?jTPUhKs4Vrxzimac3zHac6Cmg`6%ckX&UXPq>wh*cm`+rhtjWM+90v
z5UwU!)myC;?~pg_=cZls<?Friw!HUH(|wQAyU4y2-4?T#LT#~yVZ=J(<j3+BW8mJN
z=#`j3)m|0X8e`f5h(E)?u#%~68$SZPDGZFOiH5uX5>c)GW;SMV4<%^%cP9<RX(ivp
zrE1*48`z1TxwE2bkXx=MB3f(N*tPNp+YUo0nzYgOF*oCSL>E?Lw%O#c|51G8Ya)h~
z0o6-Cl$blk%f~;IVQOvf{;FVqw%8!N4+NA*H)1c08nO4$2Lx-SWCr$psYI4SByLW*
zI~t`1`D47px#;$JOf&PnKv3ISCg+tO-w)}$qS^2HE-cSX1wOy?XM(Acb}4JqZtw%B
z^zi8HEC{;a=S8a!X{o=0SL<NUp}HTqifnE%oX9ljIZck(hyEj6{#O59-(D))ezlPI
zfRHO|=b{S2`F915Jt7JL$gd*}u6u7VZU5ub0u2{2C-01m5s*U9dDmQ!#ocDS(4wQr
zaO9Z%SbX}t|51vQs)5g&EonQ3vlO<a_soGK6=|hp4FQfF)RK`w(py~J9LUQZAd~7-
zAe{S3y@&CFfUX+jPUSyLJawh1)3fG~!CXlmM+d`L7J-lrl#H<eicwO5k)JfT)Z=PA
zSt|en=007&fdvVBS(c0yK}oH1NY`=+$Zq3#=n(BhPQ5$LQTC#D#Kx?QT3nxl;9DCZ
zk`9+ti|38GY0}8Vb>N?@{Sy<@wrou~m%|%alH!$A>Br1nV$y<TX8TE^3EBWwjy|)f
z_ap=~koFK$s9rMgS4q(&(v{DW*sy!UZ17b{svuB~ky_%5ycyJqBya$+pD35_jLYW*
zQERf#2m12`lNjaf#dIi+!xTB|6Q+FKBwGgSgKeUO=(AAEyW2Y$Z-qTVDuMGy81Dv*
zDBErC&xD-P;o~ja18eqiDoP~!xcZxaEExcq3W>PQoFrcP%-Is9n-+>vva%6nUdAd3
z`v?vs=#)-5QGSYqmhiqqa)m8akKyUu`5{qyFNJMYl_n>iG=k+(XHvoq`KTPlOthyZ
z8c*^@JyTGhk|)C*u^KGpXvremmZ*2>hKUf0$InyU6|V$nMS1RaB~$Y?*XHLL<E^BL
z2C;4Qan$nt!hL@t#PvegI!;^$v2PyGd$v*&S9z7PGo)$N4Y?kVyHUVm*pL^EuFbdt
zTycc64F%X{4gPHw{7XTyb&yna64}il*w2Lb!;~jqkwqY9v)9;1{6~BiinnUk!|Mr-
z-fcdzxORqlqo7M=8|^lP0S8UNN00fPr$?D#&{Y8I%ej;rCAL;kA!0NB;s2fOl^+tU
zGQ{d6li_wtQS$`aWV}@3Qo*280A06DF{S<Nn%axs3Dv75cUEn%z=n+#lY<{du(OSe
zH>%Z!1H828a%z!m$wd5Mc^Mp8YT;=fTnk85&I%y5x}#Z<9$jHai;isXU2?4qg+~|e
zbiS_Sepl`@D6DNkcSTz+#Fy9g8NkWjfbPHbA213>5Zes#qMmaM>=mWAHu(aK9!c)W
zCY3|)muvWF*LZArktwUX1r3zQ(%I;B)7@ajVK&;R)%&BsDSKbK@tagfC;}(IAQjp@
z#B;8YInP4k*e@9zUP2prLl0V)!8Ta-L=wbLNo$)1@#>{%{3r~B?6Q3?kt01N`!~U`
zBK`SJh8#xo2;1n=KP((fZH0F8MT#-j+;jVnu-0Jp);}W=vY=<sy%aLoc*x}>Rk=Lj
z2n7-!^-1&@dytnz4FE{hZi%Fes#i(Sdyb6IL0YOG*_yvDIo`82cec(iN33Jw@ezGa
zwCB>|=1OWv@pYe;?-&q14@0y$qE8!@-E}}u{BKb5mXwj|eU%lgE^0`(p_=_&t+-~{
zFjn9l=RgmYhCC}CrTxx$ARoQ0zOH~wLsd!Pb+Gro?nB>q$5wg0c$$=M9D+#Fc8Wzz
z|IC@~lLkq5&wzd*WDsZOh+|ME27Er=*$uU$Vt?@T0*{I#-`h%EL8oETk8%g8Ry!LO
zq}TJhB&Mui!X5aX`yH4jjQ?R;C-ywHLH*7e199Lpb48(KEOQ`%6Q1q|0kF;Y0$eDB
zlt$;1O5WmdS|HtP&;3`dWpZFX{AJ}JQY0?PuUpLFC&1!5I{}hGkYS{-#ImBr(7mFb
zd6dFif$+&d7C}u?PavsO;_6n+k<a7MQA<}UVq8}$ER_L5*H*daqP*_K%(@sICH^>}
zU5%l8E-3D{zHlm@GeT3L&b@>k*vFn*%%TCVuulI<B~9SX5ze(+f+nNbGGh7266_fA
zKhlZiymjZG2Ty2GiRl+aN~O(2o&h?68(pJ<kA+kola`QtlT6LeeWtC0D(Lm3_51&O
zDg|a+!5{mzGEeNlfu7qv63)`BiBEGS&#v$dMUWflumlH+EgXA#mB%zEgn@C<X-|In
zSA+qGLpaC`R+d`PxITccD9802?2MJAqR5LLg0|n;EpU{Y0wWq%tYY$503RvdYS7ns
z;K51uIj9b<Aw3)%!3j~A9!7X~9w{z^tA5#NS^HVyMKEV%G3M<Xpz-57h$mUd?wPQc
zH>s|ev;zRis1$`fh{BwMF{P`B6^dr|HsvQgIX!ls*UMj1@l=rm#8c8w{xKnc4uubN
zstUw?2NGL%T`*V1kCLE%jV{Jn9FI2zoDsq^zLezh1<IQZa8{6no?d8``^uqnpdCFy
zw&4*nWXu;GV2A@#k^0T%ejdDmf*8moe?v4%!WjM;7EsWIL7{xtSNamcE-<Dw!@I&g
zNEN06-}k~GQWM$kXT1Q-J6HBnZogpVG8V8|ES!dsOtiO&<fRTXUSL*k)*b-vew<J8
z-_wvd%g%Z8+EQZpZwr@r4?3^832}1;kSP*h0Nr8$kMNtxRk~J>p37((OQ(Bwd^cZ;
zIiCtF1M5-h$uGQi`v`P?;lSaXH5i(RT$Q()cvGJSvi8Hu2)2oj-e-kB@nyCu0MGnJ
z-(69f`~LVkSz?!JR&6UI8C{tp@4B2Obfh*tUTf9pG@l<X5bFMzE;~ae1=*pjA%fA_
z!o)A=MGE>sg7*h>TNY(&fDV9~xMwo-qHXYMFS0VEg4LSdfBl7AX8~h8FOPSf7(>!~
z^`ZW7Ys{2x!psBeqL~(0{EcXgf7XX*c(!+hP~M5aU|+hJ{hV~@+O$oJ<kcx26G?UY
zFFq$erLARs?Gq<w$u#ALqo~=^RM_LbStTdS9C7Ht4N@0Kb0;#_5@jI6@Ay23<lkbM
z-_iJJ5Yx!rHer||EA-zAb*(lg@EY;Y;duKxupX4y!(Ki(yF|=HtL5_B^Rtt<KJ8%-
zj5)U=uyEg&-kVe^VE1-@^-!eR=fKAzG1`!`aW-+&Ybmdv{1PjgGU?<%rSG03zN)=U
z>*l5HO3^IrjD}b7Et*TB*C5a`9d%nGZc3mn`bSx-RI&rY*KtTU_1f<*nvjW2+fu^F
z%t93jnnkC_vUiPM`H!0`{j>^Pe%>^&zZiyof#NflwsO97LkZz%f_d2_tUamKTmyG@
zAc#?^NN^<?)5|TPaPd1OQhR$t6Tjt$neu2vsE7P>MeX5WbbuXwc1%-tg@I1)PyKXY
z1g-*Evj$#%)v9Tf%L+O<<g<X#uBsVa5>>cWY59l<=n@$^^RdSYw9hfUgag@!^W{7o
z4ftu!Pz~yW)ee(g;aS%=$=XCYOGpfC{YlPrR{XiUYu@V2ez0#pml~&U@>&)&;domc
z5ViOfJG8S}e97u~1l)4n<?0us`h>0PWzrh5P9=ev^Lr%-;pApiq#(WcOT7RUxf=GN
zp+4EVQvq+oO=Hgt%w)ViyW=Ddj?O?mfC@R_wE@iT91&#Z9}|2N2Mfq#ZUY(&>`mLL
z>?xOs)tB4}S2F+GV$2ehAYzCUm<80)5@0&huGzvk7Pb9E@_F~R%)+4fRxYYQB!y8~
zNBp~n`ZvuZFZ-rc3`Ct)RPFlmcg|zb5lw_If#!85pa_tfXQpEp8d+_L0m5?4D*JQR
z(0cgjr2!k=9!DZzH+Z%0mR^7gpB>@tl8)rDKSNd-S0n8r7A(}q#?V@N-{&^`)uG^k
zd&0pmBC0(LUS;-$->zjJy(tnaLY%Lk1hRV|QSpQFnd-6O-wEFtMPDH+?dSpPC`rIY
z6R?ou8O17NWQPNOx_Kya8Hohj1R(t=hEi}d)(~~&4UB?kV><(!5`DNXJ7QaC+BVx4
z<>&`S9wMDGR>BDti2L)o==t;PZ0ewIBl6~f<Lihs6ztw-L_DVd!%tiDA7Kt8-d?eG
z;3AE|tgh9V>k(<^O}k|}1IqSXmGWStF$|V_iQ-2uIlA6kG^CsS0|Y~++!xUYg+WQX
ze|lEG&=x~a8FwYy9b8l(E=9riQLb@m5FLF!Ya(`(hAgMP$vtR#iNG`BTJI(-SILa&
zv!#=@^?LU@QxH24Uzf*cL`5)77R71^k==X;b6g*#vZsM4Ib|ndL>^~}r0%u*S32Rz
zOt4mnxzG8k@2>p<c|YAJ?+ZIG5IDEI0}8SguLGA`(s8GE^B+RgQDiBJ?SdV1Gt5AX
z%yW1RB2Z8FCded*qrIM#&t&;Cl7i`k`)MQ_qwPWxg6CD$a5OpvXy8|974i00UQJM%
z9SwKVG(z$02Y4cu{E3WCW<D%?Xfd;fs-K6#8HoDLypPy6FwOVvM=O3MXMWs&PX5}o
zSTrV!DgPepIU`XUhVh$+ugg00hDfjsuYZ%RL@af*UAL;WtMY|r7~(DQJd%&3G|9Vr
z4vhJWTXabV=T8a(hD%Kp#cTNRdiDN93tH)@;in=OwnpX1=E%GhwXIUyq7!++x?5ic
zxVfA-p9k~*F>h|Wu$(xHS!U0-6?>8R#3B|=n*&_N7o;+d1NdxNt%9DlwtX3A;U^N^
zn>pPZvZ(2xq2mDOj7V$`1f3K1h*@6ft~2K7a%_T3@Ceqh@7{;29B3)*s3S)K)c4ep
zXVG4$h{8pJDDL}Bbq69>=nrRXd$GU%9{ggly{Jif6ARo5BRkl+pBl;g0qU~i^h(~G
z@a*%3-1eiHTh|u>&1eZ<95#n=c0kT0#yw>FnzcG)s%ac%E2cCvf=Ho^0%ZI&hGVi$
z(}HcI%AH)tC)_glprVhO9aU?(O~(N@f=D40H#%amMkkpaTV<~@ismW8m1N$Q9;r>C
zLJ4-5jV)Kv!xfFhar!<a{X)y(BWc<A?4Qr|mwiUHQo8j8ENi*m9y_feXX|z<9!TBd
zU2fJ0JQ0)4c~?gkCeWSp_}36%-JAdoNL@5Wq6zf#0l)S&1vqr+CjMY{;+ZY}1V+nv
zN6(kIvub(pT(#4ef@>SCZuXq2=-0Z15#AbFJwn`0N9&+L?OdNWjrZ`3!k093QXg)m
zK7;q{<ZCzc*O)Icgtg5o9KgMJ`-8PlF56}*AS@DdKH%22z#{(jv?C=vna6?pt|sja
zM>78A4}#eNA|KtZZ$x0>`pxHM3rjS^n#>WHUl1n2KO=WSmsOx#3@%&sLf_7=!fD7b
zi=OgXllJHV@rCj`52SuH`jm_6)ci#52}0Nn5j7SA7Yc{#+&_!O=Ha5ll842XoLiOe
zFuKup?R2WM)|nvHV#yLEU2u7MkfLAGOgvN8ku_ntg(VZKqJW1^z$1GuE}E?Z)@!d2
zf<pW2`wJdDtHaZF<)P&B3YCyzk4F6FJ|260BK%p=lQC|Cy@`Z=&Ej8aw(!&^csyAn
zzRe};%*@j2z;$Vpb<%yf(&%f$+M~1Kx3YjhEd^Rm{+IAe6~z)csC>?hHkpxn>(jIn
zkStC%$|FW>%RtP1uNRR>LEE;RX17&pi)%Y!1|`52Bd%#)D_xv&%lhZwSSSr5{n+)Y
zny>Z`kp8r-THO54jOgNLd&y_(CO>P0BrjKIalL8>x@M5H-19m~x~g(kJTu(TR;X`u
zjcPHW%sbp}Hc8dwKi!HVIR}T7kW-~|MsX{<pcZaUy&7AHW0Y9&>t96rZSTTx+hGse
zo&I6V_Ebuzgt6?Mo#SS}mQ>+0mf+qrFRMHuD=j;}N~y%xIN13KhXBH@dnVG?Jkl8r
zW@48Jg-wHwo4>t;^nG+(Ku0jPdK^M^s94K64$mEwXrDGc=qZn!T@dZ%$)YNe6vmWT
zMD4QaXS74$1U|a1Ae&pbfpXABdfk{9fy40br^fnqFH`&-X9>K6+nKf5jbi*xHRlg$
zQdY10<=SoG0N|KU?h-V&T_<&htthK$BGibFsH!5=*|w}5)8qitcI)dtHUm4wVELkt
zW$5UkPX|_HTX8Nsp;o>BsgIa|rVpc?7#Z8NGXdLNjNb~$j40Vm<?Yqiq$rulh>gF<
z@1=jyfqkyj$5pyf5ebNtA!VkS5>GCAVAM^rdXA+Xhep%*aRgOQDTWr>#Q=wGTrCnd
zrh?Ef<|RUT3xPnd2Tia=XR?62JUI4|_}pXz#@IY=+_|5i+HUn4>g%DJt<8%0G^>I2
z5eEG|jCID=S2{#8!1Dt5=_?w!Dil|D&psO49kK7~x36^MK`^{0=YUC}VN@_2xR-Vu
zSmM@-gBS6mX~=6Z165T}4R{(iK&#B8C7X)5)A(9mO~Z%*y4)3J-3}zW4>I#r6s}-=
zth8Vq1F?8`U2r#cV8qxYBBh)XpPd|7Zt82l*jbM6OHMUe8=A&bSIja#b%Y!9JI7;A
zcjE>W?@)(YncwiQzErR>&gP|x?-M<!r{bW*N!5KfK6joGs9GPB9H0{y5Ug0Se7j-j
z5Ri+>fZ2=6#(i84mkD2w*9*(xW5eMr@7yHYdUg*s6l9;^UsWwRx*=%!$Ua5Utxm@5
zlsW;%MvqZJ2TXsnKEsn|xhAu^V&>p<|FM*E8PLeTKq1pjiu{d)h0TqU6+RE_iDvcs
zK(RExoi*$46aqfYO=fGdDo5rva=i+sAmn58e#YWkpbeM@Oz>iu$?v8}+;)nR8tJaQ
zm(%%hk2AMP4LtW>DumlmQ<8f=&V1d%v$<PcMDVsFa4K`5qm_V`>@8iKrH^(J3p4{-
zWtFx4sG@khi|c5dtgW`}K$D{9)ua1Ny#|xUs^Rp=MyZo`QLy7knZ}o>^_5vH5>BPJ
zNgqa(0l;wD^qbECQ`}t0uw@E2za>0)gYPmr8CRRtg<}KYv<{L=Vx$<V5a#<-HGh44
zZD*E~$HCzx7q*ZL4MgLgE6V3|H97a#a#E;IwcbnlK5$agVoRB*b&N<4FhNH=0y%d@
zT~<cFWOc)xEZdr;{=10ub{X<kskvw4AUda+5j{CaIPq_gCK`z#!Fa_rRis~*J9z{#
zI=3Pr5K7&!`kRtoqD7<Bq_$YoHcWbb{`yBBeYfY_i?f0|VT;>Y<A>0;BrtL3RMTRm
z@=%a^FstgC&S(3Nj^e{3T>=mGjeuceL27%3rry7m$%la!jn{!?P4G}hNtoU3MdY62
z2I?xB7(i1z!q&G%*Km=X**W>0iF>6?Hp8#L)<j3?idmpq<25l!xd(d~@P)oC#n-t=
zljX+9X?Azz-Y^K8<FDzvxQ_Y^Bjq|!9!JdWZol+ZanB2v%Qs%ChT}wJ&pWA6ZFN{9
zW&HNr#w?rOq3WZ*IW5ocz%kUo$WMdwT{A97TV4h8C~x$ve_+M+j#GC0?seo&0Cg)H
z(tS4M&Mdst1F$re3%8$~G@XaWvW{yXprkOx-ugNuePzd%1uhnrk<D^T4KGXo&<~Q6
z*{SKTtNjDzR`oR=4KfBABRLI<oO})1);;`-+hNJ?S*XeM{lNpPtXcxU@Anhy6{ktn
zW$K80Wjd&lE&0?*8mIO0b2C}phAc6l!TjvX+1}{5@{01ZLy>afJ4$I(%$}5o0X1tH
zc?VEi^+!dDgV`B%_mtU%fgazYv+J%wiGid6HDcS`xxyG$(7psFok-0Huof)MwJ$?b
z07s+RQ;^YU{f_iFk0kld{?(swQt5m&%tb+jc1-@Gm5E)*c<dAoMS|HUV;KsxbB6L}
zbtHcy?XZ<6O;BzVvPp98o<0LPjstsrPbGI3;wg`HLtrc`MA_rvQmKmRw)QWQ7c!vX
zmVENSUU7}RLehp=z4Au@#n4}9dSk26<WIu+OffR!xBl!;Oh;)jM|LBu1|Os#I#~aM
zHozhptLS&85i{ZXM$<Nj6F79h^e4e4IhuIV++C{r;a0IwKF?Ex*tuUi1pBzH&T(Jn
zv67KaaE0a^)WuL`*NQr;5y%mgh7g0LgN2-V--`bU?Jr_y5S1yRg;C+zOr_Ct4s9q*
zr^A^~pI2Zi`W(Lkf=#i1?sk?s|FVw0_ommSKSvVnxAGNCZCQsoB25@P*qfp<*u&T)
z?u%XUW0ZMq=`;zsuoNuQE!nBqQO~+Fu@rG~MxW@9AwEj<vs*w-^m3Nq(!ee3uA>qx
zk32)fkHFQB<>lCwG3Ib}a?VnT_hJsO8}5_cK+Ulz@lIN-vh}rvlq6B`IcMQBtU*TX
zCtFkisb`<3{<u-rrhT%3@qy@~czJUctoqQTQKuZ#PBJmsDTK)P2KFg#!<t5guGjkw
zVDqWUj}_gH`H|8w*sqRAbQ#YLx9{V*wt{QR6T}=bSr9&B9&BA1i_==w`H44cPT!Of
z`>QP?H7LHx!C}mwLuQw+y|SdmDV0%K%q=-_LAj7*QY7?jZ_AZVKU;~cK-DG936up!
z9+n!9=-Lc`1btF-UWL#6Aq4AQb<h<wC_dD(N3I$$jBkD3eD6<6Bnhl0t^mnWgUa6H
zGipMM34~*5)x0wc?|<i#+%OqPj*J_&A=fxIsXXuN!bAUEE)T0Tl{ipa4ZzFqZ)<zJ
zVqd2<7lE7_c+O70Y^JCJ;Sg<(?(ZXueUan^R~zUmGw+Qo$v{VyILqxnGq^+?KxDb=
zo=^p6Fuy&*CxfJ|y+?e)^tekj)N#GDlxgpq*Pj-f(Ru9Ekedc^xP5+(ATE!3K6xCF
z%fvMI5r{bMO&r$fG^#@_ff`1%HF|N^6`Y22q}uxCnf{NPE89lRF8i}MwO-&$PDUxx
zP1zpl<M^Kd>#pgPw8+lwdkR@cz;J~?Th`hQByYuFA?uHx!6qdkg6Wz%y5106P4&jl
zx%&cXrQaj`<1e0$JN2#vFs07F0jdEi6{c>@J4CRO!(?Xm$FeirH_1kcL!v7Bm|#Bk
z6uH6GxV`sWM)QP|xO>*w<<Dabb3#r*Y=;t6$oKmW5SP?zd?w*`Ta!4tQmk6*thBXF
zFgaeIgX>psC#I>aG2v6`+8{?`d1djv<O(p<wBFH1j?)gso%-Y8oQ~-{EKYQcp)T-;
z@mlXRfD;~x#dAHE@4KJV2ip_h5_~X`g{H-<H}5;T!-~MRdDw$;8K2nS@ds?qhN$>>
z@?=c|lcpMZC6hORyOjZfAR^OhYp9$H%_r}wb(48I{>dgp947>2f-nLdlXeH&hTkTs
zGsrD}@bzRERdRyF(m5zFe5!mfr6nu7c`j`3WI6at0~X|56fMtugr5D%v6O%Noo}FY
zjsBaRnd<XWEY%;7*BsNa!b`{)we?K}=Tor-xb%8{(W>CUF4dY|zO?H5Vs{slwr9uG
z|7Dhyi1hx_lNbV|(dVcw&8QoUc&#uDVfr{S^c#?Ug#1W2%5fN%N_Zy!DHC!~*5$)N
zBM`F>qNMDC?;_KBExe~_c7ZLz-DN5J6b&v2o*LfwRQzGOv&=S8g!^xpNcB315eKZh
zuYE7f=QNOubAQh#hT*!qa5p1Jp$vR@MmxejT}4D0@xO|yP@}US=a`(M*PArB>0z1U
z(lbG6HvBa##9Tu`iiX1d6Z#u*gBJIgTLU|EN5pLpL-nvIrDEtmVK)Fd_Kb*s;Z5g1
z!u6*FTBq`tP%7i>JTzswBWr>ZzIwp4maxtA-BjR0Jm0*N2-<-CZyCjR^Zi9Boo1GP
zsYAfna1K0TqTg%hl^@TW-!eX&{!5gd`cLn(YGw9-Ckl8frl~%=_Tsiarks3qZp1bw
zoz^{&Q~(9I_%m4b%cxC@HwF#~KmC87GdfRweVNWVbt+__?~lKenWf9!#>bq%hcQpu
zLnW$fuQAddrB|Aa&RE#RXHPkwd*peav21~mxF`}5G8!l>e#(;fnUsUbwJ3_7ll0V(
ztnNqsW-(NwofF_ce``d<O793Xf0=*i%IN^vG$uI<Yo8Sa{xT^tRMOU1!sBtB6=d4W
z#a?24G1~qlXEu!b5jUj&`*GB%Y+-5-$*OkMvISGxMk80)$%Y(8t<q1fQIocG*CH4O
zG2|FpJWJ8g=%S`7Y4OD2Op#!dDo9>AOrx&Qio4MOw-2oa7bq!xr*t$f-`Xg#RX_h5
zIA~bnb+{TdpqG$pf~qqX_9t8%4roR`^{7;>7ym|h2%<u!w(iW0)wrc?zkX_1JO0;Y
z*WWu+Nv9@-J<(S@?=^VdkkZ(TSfJ$KfgWn4Stj0W{Mm@@Jfk>W#ZKTsv$6i3aYxfL
zPTzFnZ(?ilH}(7DOgtt!NLvf-k&lLFux4z)I!O<8mF^q=VW|yITJ=DHO|boBe7ytP
zYcUN2+2VB04C15703zA1>+eeJ6v#SfF4!~ASZWQEiRYeLdQHg9@zPryK`EAlYrQ&9
zHfJ-)QJVVjeA$^Iv7xNEx1r0e-Ey%}4j&9=nq-)u9m;6+7*}fWF)2@WD;KJ%13dA(
ze^tk@P9a%ZGe$a!u8M>`-|tq|oEvV6BeZwkb5?WJ9&&vO$D_s2gf`gqW<=Q)3ETU1
z_$B-U!}j(1O5?vb-x7ARbz@5entKp7(W7BV!aic0-W9jffT=Xdq3GmvDdZIX75XQ-
zd#1DW6^Y(i(4<ynFwB<0T<${Eb4!8b8<{i04W&_H&`|!yL~!f?dy-t3Kbjjhp8PX-
z=_y(p@6&=+p$yfTv{hdbzFTR9K4b5%>uh72Z5lotoufWYh_fgTB>4HxwB_g5j8srH
zP~PGnm{^eDKSZ0JXyaW((j~JdBC)1#=|ujM>3Ui}r&ij|vm?3q`M`seisy7*$YBLn
zjPBDZNy$7x4(%4R_r7&j431BJ)hu~1NTg|j_HVQ?q{@Dm@(6+3S4NZacmEDi95mk?
zg`-#5YlTvS;9AE;Ea(Sx7-fmXcCRc!c)^GmS$c{$aEt!~T`cvJQFy#Wf~I~LWWvo?
z`<DCRctZU3FtX|&bZ`e1N~t1b{Xg4-tUGAVRP!;-NzsapOTslMLk|Guq8=r7#@gQz
zCc)0JS0<jJY-UKnxv#AySzi3>2*xi7UMBu!W|(cWZV?RX_@zUqWxsSIkSy&)U`F#-
zg*AwOH8N8Yp_U&zxWR4>P<pPDRU7-gLMM8A>@pKl9>0Nk+u+BiqTA11S^4H91E9wG
z5FmFc^^dz)5a?0_6G)p$3zI=4w}0!zF7!3@2P?=>H$=C1cqsD*N+l`(nBHYiks8<S
z7kyv94+rdGkPzaAXJtUUF-9eQ<CUQ8@|{onXD^nUA?0-{2`-`14-8^ZjMqtLy>`^Q
zwJEHI;iL5BXs?pS{m8el^i(PeC*~}Ch9a|t*)XXZO3{E*x<ds*7VThQzO*~62os~A
zg=uni6T8vGbKa?yswDyr>9~!6m>pR}-KvaXpV#5DC6pepV^14+>=reDvQ^%}9s*34
zO@7GuKO0Abwd00EuV}|GEIy`gu{hZ;tHRL=Auiqe)q-DW8st{O4Iqhs+t(fn!9jhA
zJ1U5;g*RX{@j)j1Mxbv}fRf%lQaFD5(A0-W+aFCo`hH&Iq3HBpTTEsy(8_4U?MLaU
zE)+cQ7(^OC8UX79GH5HurB^t8pMXYZf4EvBE>a~*eAS+*iBeWE84%8ZZDwf#)Qo>7
zdZ-|xO{Mj&5ME+IqxwYlV{Dtidn-3=IZ}d#;pN2w`Y(-nq$&;lj)r?*6hIFyQK~8U
zCnG*PwcZTJU)MhkCpO)BiPy&a<0Q~<lHILHkkr*3EeYU21VZ@s@yzt+((2MwXU?ax
zKCjAxC0-$)xBcXNqfeH?>i_L2_m8vp?j?V<>cKC9*hW(3z02aT<sABL6BkL=*1{Sy
znfY|Rk8R>Aa->k?!-<r?jTmLxQ~=(c@6>OVMR@fr<CbKdtHWUeU2uay5CWN&@|*aM
z*Dj6r%oqcDX-s7F8Y>{w*tro4+1>UNom`rSu77cKlGJ7<&d}LA#L;PUnzLJaoixu2
zrBF1D+-(M;60DX3)O&!tag4uwK9sEWzC<X`ENJm*ew20`kq|2g{fj=`KUH$q&vuIB
zgi?)Oe{a>_C2LRz6$DVez9_}S0180$3F|fmYkHD<n06DZR_!Did~zz9N!cp;)t9O3
zbne=-nRH4Q7VIQnEiHk5o}LW<O$t*LSX5Ws9wZtl)Q-~zXURa1J!9e>W<bOR#Lp43
zycdwIboog;MA%=^<P}UVqd+!);P?MaU!@0F$U$#dd+CJ+Bd+qN%Fy9u(iCE(lLu3P
z?XjcL;`nxMW#5mYsvR7J&vVE|Ue(Q(b@ZA7m|RKXM~*>cmh%Ac6MWxgR8j981P2t>
zles>ijuk*UG?T}G8K=Rypp2vb<CPNJB%1dL$NRQ2@$ErEXArYQLAlOGeBPs=Y;oeI
z#VoE^1SCk{N@0z4jnvT?TR;PPnGM9L-)Ia_P)3B={4$Jce=N`MBaCL9_hvl~H(!zI
zHGDfTqE@XSZ)^0Yva`+T?5uy>ctInj)7{-5YwuV?)ORrBif`lW#3dm~253v$b^Y2L
z@5*x*)nC=|NZIQHu}7Z+i*W8T&S!#>!g!&J7^pW;O|z%!NVz3j!71a0Jz941ez!XJ
z7;WMVWJmxX=yn``L7KsaPZhv;4wO4(C+E-3!ZvaCuYT-i!n?g021h?*+oo*fwCUs9
z#GIWJx^&w~YBi&jR^31x9fLO|!T<y9=GcyUeQA#&*weX&q!qw8Bkq0^=C3g|(&5lZ
zsyN4MQk?)Qqy7M2chcA7)2igUqw}!DIvJFD15ORNDp%y~Yn66z^SLCKr>R~3-@JGq
zPCNy0{@M0C_O<(f+;!l@;$07q_#98wVaXaxqRp>=dNp+qH_eWcL+!5_Na^uPp2dYP
zF5;7yMyu+~kIwbELkLLR1SJ;~3xfHNr0t(71}g6-3RFynKc_UR&Km;mX9T$<6&B_b
zoDe*US0_9?K{XN}VR{UX@|v7?0fUId_kK9qfkDOxC?YJj1#?AVhoCQ{4amKIhjjge
z8hf+zNUy~j_xn{Sj+x&l-tNozc@bqi^Zg)fgGFf{M}D7xO}58gx6-|;pMtxW5nuOv
z6gv;@zhQZfHYlPz=iHzycd~qu28W`RS^hxWXtbD}@7YuDkgo_h?f26>HBNe_v?(7$
zW>eibzXl@Zk$UvwGo4KJ7s;>NC%^p^94b%bF(0-REkPz;wL+vs$gcp;_O$8}yRj<#
zMbqMXHgsrf8$49pZ@N3Ox<7tDskR)Ul|&%#6u(B!hq-~yUugzFopwdsZk}=1M06v+
zZ(aTwXh54yX4^PJwBKEcdIi`LE{-Vv<R#6Pgl^G02v8Idr*Uv=V8GG9?5MY<AsCcB
zF>8Oq4pTeX!OBnAcbJeJ5+?EAs6kseumWI$K;b5lIb{kP9IO=LJ;3U+y*%a{$#A1)
zU6G5w+s`W5NscRMF|S=)Wi*o4){;+8igr|z&rOR9({O?!$PbOy{Y5Xih?#CsGs*Uj
z8vAT#Mcq*kC)L8CoLpMogOe!~GZdT;rgfVlzL&0K4h9YXE;{R9k|5p~E;i~IqEEZp
z`ZDrE3<15Cxhny?2X~te)fNv)4gFK^1STof+^rg41s0iFaCJ@A0{_VKE?<YGo4D>Z
z>I#(sD&wr%$O_`OK;F@wIePHYLvkvWGN1JTtB?bdQJ-MG{+_>p8PNly<&SzVzDD!n
zl|2MI+Km3WSi9{TXyej~3*-~~t0Rk;pD&lY6|0{T`j%Pry=FD$n&T&s4YM7Ez0wI%
z@t@)&ft%b|v?~uwgq4v-$@&KYe=zE|w(Iq3?wOFA%{p+Rhd1$&>WxNx&)1vp*8wN?
zMf+?9bz(@AKv0qe%vsbd2=YL5zOkfxao0C#-5?%TjgKjn&C^3bCrnIe>2<n?XSwq|
zP?;41nhXjPcC_}<1ysI(Ky}~ejMtNCjDL<d;>^Mh1(k~}$jYBSXP*cd@GU!1;LC|!
zuG}ZT%R*U-O86x<PH9M?&_zKhTU}vIxAs7)RA2;1cmVV?X8}`Ea%zdr6X5ocU4<1W
z*LWQM{!ilIv@$Kmz5n0uV>M@q+e??L`#nt4no*Y<{)s|R=6oR<mh=nf`J=4|w`?Qc
zvWkWs2>*j{jC0B@cCPSbK^W{_KmWXA#fyuJIs9<6B@c*itpfSR(#x!37))H(VLI)p
zD5^+XI&(V@eSfs`|B`quJ6SM6lCIV#o+DBQUzQk9giou3`<Qga6aSA7YN4jE$wZN^
zH<gX5z$N&vPp9<ab&`|&2V{H!4NOA4ufAl0_wyay?zFt^^!3B^6;Ug%*gE)J_spW=
z;bg$ZNq=ulI|Etwg39aaLIWKJLUUl(EESs<d+w5fu;dkSYx<f-7-khGM+rSymNA!6
zd#3YTti%(jL^`DU@hUMLtxD<ip;}pZkya>~>rxzXV8w=@xEd-c4w>98(}8WSAjFo)
zAJQ^XvU^wFmvt%r;i}Rzv22a-@$&tais}Hw0#6&5qUZo>%5%kXO=$YFmYf=<nv_i-
z(KTZN!VB3c$j@-i(OYOL6{$_i0C|Vomq1v6bF&yIrh&jNz%JKrbUQ>{tke*DRNA%c
zlu?XsWR(W1<JNrwb;Q$JfNVyEOOl>aPXD+J`ih)CkJlr`v?+kvs#txuaamgev3;yK
z3x1+r7kti}?%Vj#K8+C9!KZI!{!bz=W;fg}u}8{$xtaEoPA~rkqjLhKc4ak^8#o;Q
z`D{@x^ttjEs%8b0&<QNqzh=iq`C!iYiJS{=AZp|frZ9PX%>@3CskZo_rBzRL=8UMk
z{D)pcZhwbP87G9y<DE|aMZCz(gDx*eFf{4Ybtno35ijKo>+<XiIuQGyJ^QyS8E7*w
zLrs_yI{iPyf8;<|gT2_J+6oiyONpHZG_sPlm2!ai2B*ILMML}8vx#~D75G&E>!I2O
z;7I1_oH?#OD}-^Qe_Q3#tgV%K4;U5=u!JQRV-eIH(uM=$AD~{FcSr~Z)ya9wb5^FD
zfxB3>{YX0(S-mbU2~2bfLfFWl(nl|+^mb1;+;lLr?uN1b`X!r3aWhYuwj0Ib#BH_v
zCXj9|#Yucwhb6d{aGRo8e`SbhW0RuTO?SzyhO}FAnzKabMQRS`vpLorL47*S{fK}G
zcu1FWpN&v02HK{+Mm~jk%$^fX-1>J~U)zyM(z<oxWM!KfFNh0R%UTCTaT(26Ad$KD
z9e&zWfqpFBWrF97xl>4pYQ{y_rF$skX?WV5qJB=Ze~LZNN=1umWy6t40u<y(WXL5-
z*D{sc&y6{Hff$YO08C@tRlDAriuO_x|MO!ZZFGank8|R^lSAGbg2e^}Q+~W5k|uaN
z{bELvJW_JilTCSp#M7t~=g>0<4CIU=zr;~tE@WV!fUut8@rUYc4w#|cE7O8}OkeNb
z_YyV+e<<f&e6+Qmsv(|!iKBDEH}qL%whIWz<Cqxcs|<ujU4r_=#%Asv=*`hH4uS>m
z^kyxfntWc!!3lj*Yn=}1q*Vux%#vnMn#c*30R~*M(f3zyL|xdj6_ZI|0TU!2WiJbQ
zk)#V$hqVfrhrDN!V4<0y!XkE+wiBG;xx9-Vbi3}D4sw_)TS?xa!TsaaI&lICH#M%<
z{l7*4m-c?%RHJW#vXnZ(s%01mR8=&ou||ZD)-jj}mV*$CIC|c3Z>%(&jRl}fhe-a5
zYh2{P9$Gw;ag)a*wB7}(GIu8Rs0X~AsLbDPzDnp?a=#em9|^6^%Uzv*jC1+p7frY?
zWe(NUX;z}*j42*swQ6mYG`@nh1!r&rC8Z8$wo=0@oQaFs6HIIEkys?vkxX-e^t&e!
zC`KojbKq%qE(#2K&l;^6qwT4AC5rfGnfJabz$0`{JJHcq)E@ob{O#yi{#Ohe>E9Ly
zwYRQYyPv%6&<zP?{B=4KGD0IGzl9q^0H`vCbx(EeM+y*II3m0AwMNe%R%iv=oQwqS
zByGG=WaQMu+><R@!><WyYG<`6-KdLAbtkMIva8<cM=BEeTa}*BCqPg`X>tVZJ+TIg
zO+^E#H3YbTeG4fUTbww@bGA~Sg?END#>cTWieypF%QF<829yXbT^Ipu0{&^4gI#Rr
z7iqJR!%I&KmJr#7VqiHeG48rPfasxp%wS_rHq_zUndIRIBPxR9d(84*i&_`L)L~%3
z2y9H&ms@(;88X-gv<}?ts%7f=K>xsqnlYgpvX#w70cjjDEzKp6R2@B;S_Q1vpq2@a
z1p@?xJCgD0fgsIP`VF-dFwa7K6WiEcD<TKFsKqS(!mPI^sUaWntX4xj0eLa6NeL6t
z0Fe`gN9ol=t6P9c|CgT%Q31AznTbk7DP>DVw2^c0H)(4@`U%)R_iaMFl>5Cfm2SHt
zpMLc8V&=}qYDuHO0G(rfr@=ey2C&RtuM~v7pM=mfvb$mxT6#*s*_vY$|3e>jOmD^h
zv@`{<j+~}KS(j*0oi(h4qF&+$0*}l>ry<zxPdhy%%@JJ8iC+XpwI79_LRE}DQflg^
zoP;Y)c@e$`4pZ4MdYEk~^-bb7$G^W4i$U2mkt3M21&RNud2Q|)Z$YV}dc5Qx{J)dQ
zkNX=|fP+#)ASi~p?wai0O1B0|0Q)C}1>?pzc|kZkq?lS{83gO8Th!y^dlq>^8ryY_
zn)=!iG6+=Z9@hIBv=XH`caf;<L2Lc24(pA;)Q9xyW`#`Y6W&2mc7Y#_E{f#y%gnj(
zT=iGzO#*pTV>qNGQJ5$o^;w~`u}8!UfIJF77doqbXi|#bHD>22UnTy|Ye*Sk$+m={
zuFox99i_&zj03gFc8LfhrNKyU@akE{PTCs36(W#bF-kE(a+H^G&hZ#3B?5XzLs4Sx
zyU3)(EQJTzAi;^^=JQI{JWF^F?yXIZ>D0)GOjE)b{Qf;PfKNhySd@$TbzI6L_L)$=
zK^8p*&Z>bh3E!4y4XnMiB41Z2QXKi5F6Q@bk>k_Ir0a<l9wLzlh^*NJhHu**y9B$+
zW4tID?+d4MbVwV(&6WHTpB+;f4K+7~^EL?ye`B}2C|T~UOJVlG+Ya7jC6V6VQ%vx9
zsp0_6`srCRo-4M1!ajlndw6!>GQ3HZT=4ta1Ny9EHbY)RXa!%j6f@GV&T?lqV3Q30
zkZ7+%t4XF&V!!;{rIEY|gt4u?@dhwB9K`As0?-kUGAzn;7i8QViZ%wyqpR3ySN0=1
zJs3lp=JD#-85MEugaKq+;d4oS)1|VFrAgR91Xo(9`t9*hv{siZ+t+m2X$3Z8Ri+*e
zD$8|P=CbKnBUO-_2xaPW1`lX7``XmQ2kQPuQxk~nfOo;7%-m<TuKCp=%OUd>9o?d~
zD}_p|d8d2Hi7)C*Pz9~k|JesQ;^F)S1vu?GyTsRnQ@X!gbLm+wxCmv=3JMCuhg?_B
zjanqfdd9|<PEgp7ZyuO)e#no=xJY)0tzJd<hsNN4J-Ah+vbKJ$OB)uY!z4K6(xVtR
zo5elzUa}-gHwM2>u#SS<9+8)vC&W!r@z&kd7CR~>Fa}tB?oS8J1)-CoW8~v}vfQXA
zf}~3J0G-T+?GGVRoc={&#u8+1d!T52vR*tRS61$A*00VGN1FvDmB(vyhxyr_Dj_vc
zCO|mHCU)xRq>FBT-Wxcc`Ba?h?{=4C*U-~(K~KN@NHwk<Q>DRFl?EiqX3dH*G))yv
zBM!ZvCl$*<g7(3m;~A{sXoHjF`jRH8%pY0iUE&Td-!kF>CTVVZY$tTXU~jBarFv^Z
zM`BH<0EO4Z<xX3wB-ByTQMmH1r%Gj7TyebUUMg=5@<QNJX(N%!o}%RRfvQWi@?b!Y
z?4JAt<V%R>URuB3`ftC~+Ztvd1IkuZ6-xK3yjaS3wIFcoz&t*rf%v*byPo3sqse3~
z?hW2hOK9)A=sA4apR^QyD#YjF3`EfqrZPb%CBZ5WZT&}lTe2mnQ8H4|pH#6PN17<5
z?w=;_sFBljoA6hw8wVaP{c9e>y^crr6QmNuAU5{afw-eQ*ul|DTO!+~D5ITlQOJSQ
z5#VB^05?F$zgaDTS>5WYWct=I&10-M@QHAWRN!At2n6#3SiYZHw7Vy}jpb#ghUCnF
z9tAW6waL}HR%CsT$cEA%+T-@1goiSxCBRSD$Rh=3Bct?%Ho)W*QOWqH?Brd0C==pe
zOEsRAeIl-V>HU(&xspB4QtEIBzroYmK#$ewjdi^uU;+Hb9U;yjt4&Ye=3ly*DInvU
z*OT;Q>pn8#T%=~T3ALPl-&iZTVxTuus+1WKLvl1_noY~8|84|<o8TqM`a^I&m|NSr
z-`H=u2zSq#U=*<|`8-<afy51~^w4xrZA<G#tmZ11KS8!fll!INb%0Bf<KO!6;E$bv
zQ3+f8m9?vd74r+uAm4Uk8GIS0>}~=DhUXaaV52TCr3_v~fCbz90zY3|cpRDDndScD
z3dF5PTK>i77Kq(^^MdvR5uD0Oc_xrv``aqUIm7tm-~cpD2HeIOq0Nze>Gs44to&+f
z{EKP@BbzViC&n;3ocd1*Zs&WCd=fe6nEmbjHO#sz3Xy1AheIr#>3o|@=RJ#}aS4sI
z*JA;!xvZa~Tv>z9z;9(7&<Xfze9xS<1`)HzkoJe4@d;OWu@{H?wO*6ft_dD6Rlh5V
zSMxK1+BxNVP=k0e2a<gDtboz_ZpoZJwnt){$g2;g{DF5rKlGAGLSJf`U|H+V%~8ah
zR;^E49XGus3$6FjpG)Z8Li>%9yM!>UeB+2e-d!#DJDo-=B2~SIFbob4{c2smSG^#a
z&lLf-V`43!HC)ZvbhVQJQIuNVx5POvq90OC&)4TR6^Rxi{k``CIhVh{Va`RMKYpgC
zXo*lH{8WEqe+unAc`7M1>A`9D5e!%M^j$YZ^Dy5?%|9!1fh9;vB@bsvxN~HznZ0tZ
z4m=0EzrA|N`!Ac|m9CgOgPmgiVW0v2O{S#8Slm8GkD~xHMb390K7E@FvGABE6b_Yx
z=joM78tHb`K6fci4%8N_%H*Hd96z8!F@yWhv{1t4b;l=plW{JFEUEwV3=yyE%Ax$9
ztRSMu7n}|Nv{i90+EV_BW0gFHmi{m?fgtOmF=OjTxd{up!CMzEtyEL^Q82p{;enk#
z_;_^Fak1nh{1um9rHo(B6o=)pWAqp-WYS>Z(JL?@rs&)tRTzcVXxYB1+b9z*P7~!z
z&+%YT8D@nMY(h#xj9t@575g1BW6+WLhZwEggW;h>h;cDI-9nDL%$ew{Sl$Q7U*MT%
zj}vCt<eqHAH?W`_l5W}6A9KvXhR-nfgy0tjgG%=KQgPxfVAH-lhRE8r=&@`!H-Guu
zboF${cc%G{j632u?p5g)j{eaDp{vDWJ%$_gKO+@!EuvnH89B{@BQFw$R=n0Dc#wuX
zBh}#Kch@w}SnA~cMlr$`^&U1I(&@kx5aNMQr?7R}0^s04J$z-`o4;NC<^5Z&QpM<#
zO268nX^H1NuSTwj6*xxLPF8%*(0bE-vSc}C1s|i|rDNVJ5Gr!Jf--*!e_(BjAZ6cU
zOJ;OW+xRPkS~4+g2p{Y)-s)WyuG-Llvg>&114yuDd!(n_IYxab?36f?lU+`tyyQ<f
zQ3ZK**3|RGM*YdeBG=il))eq)XX!*se{Io*;!DOzF#P`J0h|VDd1t}Ur_*seO-d^y
z*xd9G1=1Ri1lR#_+02hYZ6&e%D5a#T2EyFD_{TfKJ^0(iTe<G`Va$U0H;S$@a1*<b
z$WJBboE`<G_-h4QvKbP-k2>2u@HWilPwv$DR0~0FOKwq842aie&NL5ZE%)+0mOa86
zh&X`bLW>r6hSaf-jG)g2=-H=DNjfI^@g<_)6iiNA+Eu<}Fsw1&fRD2T8QdO%QBbjK
zus1ET?(S`1Fh(w<y}hXulvC`bAx4sV=D&X1^etRL7Z0=NU%DleG4V?5<W^ogY*x8F
zwOBQ>C`Ry#K4^W5UmO8(!(l2`L$0)>_5T~<PeNpWBmFG@FoV;Ybdv<qv>4XU#1D&7
zWKd~~^r5#Tsr+9{{=Q)kK{%rox`lA%R~JEz#xrt%!n{`z|1sLxA(^{j91h5|O6a!A
z&)yPcP!Do?A>a8|xmU$1!NTInji?ZaS@&?>5-kF@m*&B>`XAbzM6a;`^{hgw5yO-4
zSO*Kkw-f8Ch-Wt+VxHTrd2N#72X_pl2XmRLMM}<5oJ2TJ>-k@r{Ls)cfhzD{f~1%2
zR9y37^Gdw|jhVU)Z8QS|YX%|viBKL~Xd3hTxl1kVU?adt3dVs{ixFu*#xx>pfVR>@
z@TDaY-gaL|HL$Wf=Qh+HqpnEE&0p=$;@ud36KXV!FmRA-$L}RuRo}h~Qi7zhwuNP-
zjd%A8nA~cin#y-40Cqw!>6_sCP112Dw{N&}vSAma4JUi)`il!u+@Mim?r)fju11Y2
zwYo@h)x+sCCvFXic_*+!;o$gZggj_fK8hY!uN1$EQ2DDgAHwGbtHGz4^ax{WLw>8^
zi71?|Aq4t}`;)C`^aMS5ycve5TMlx+)(ORXS~dz=Y?eG@9&@}?)|&a&@*wkPwUjN)
zWXU&hLlj0l|D&9k2kfM-QiUqC=(P&KaH%%!<VU)2zQY)$IQZLNVm)&jbmX3M<FCfv
z-DRJg0SY9FR0|8ntpvDGAFnwLZmyvngd5-V4B}O-e5L3^@v2?a6L`8)st_bhHHuq&
zxll8~`9x53EDDP>E{x~7i!hzn*WkfTwM;ldDdo-i#fXQ365d5wer8I~Y#j7F#@UoV
zoE7+v`TTmNtK}hl2{APn5Spo)V6B=O{iozVFkinxgL}}6P}t!p=@d|I>aMjpU)Wj`
z9ghnEbd{OJidu^ir^&z%i8*7W)*fJ+yttrtMI3$AsQ#>C8^~X(pw|>1#tU}4ARDdx
z$|}+$H-*wQ)QNq)LOku}^$>6!Q}fA`vXSL0-$39TSeQ$NwrN{f;LoafX{3$jfnvE*
zX0LDsb(=xZLpq?b|CPk%?>_otIzfS9UlsgAea=Bg0Rc5a{Lh8=f+oj%@Uunx7o#Kc
zSj5KL5}R{9%?!s=a=<g`u)e0)Dh_g6j@0U7t38mE0B?2QD)X?!vG|VoB<6*^OURYj
zkMJgSrp~(dU|>jj)`USlShUJ{CZm+9&kOW)dhBr0=s5J&sNNHZgve7Yv7t>$+UM`#
z^CQ%56A4!63=~rraC&*f^IL5xYnLnUs1ek(+>fo`l%OpX)^@ElKZq^%?)mlXy>BFO
z=HGqLpvXtV<XR~}MEi|g{eVJU9Vu?6a^^RDhG1@6GDEe9fH(?ky+5H>hlAoP*}T=3
zaeb-d(ob1}6ydXc3)3RIS)&@Z#^%%(OzE+TDHo^RpiK+6F{VDJ2I?0)n`HN@Y^RBh
z*+)y#35B*R4i=eX8ESgs6Vys^O<5<|@<|cKx#2|}SH!gG?cV<d{|JdnABM3hLZy)}
z9}19N=y)B*HJ{jJcVRH#b{a(gYOHVWvjBYvXB&Yw(ZV-p<;Jr$=wlxN%`!bAixheh
zul}1U5uGZ{gu2>t<Zcqp*|Df)Sfqy8wZ@AHTn9#h6sJ?bE0YpOAVBws45rqwU`T%P
zIAm4XMVostGF4B-<ifva1o_bc$u<Znt;L`UyeP++Z|$OxNC(y?iHd}91^|2BW3F$@
zkFpu4MyDG9^}dI#H$5Uz31n_aM@w8J<~RU#VGr)q*!T;N+tMKy=Nu4}P`}4pFS<0h
z_DZ(nxzl6lfQYSj#aQ!>WFh=roxXXJc7twAJD<`cot8`)%y6Z7hgA0F(wHs?)|tq=
zpu#butaNTf_#w#G2}-qddIWr78=Yhofow^k_~0qCs0EC+dv#^#)S=X%am^c`mazO?
zcfR3*Z*KacuoGd+QKSk>-9(=WW9|-?!Yha+q4!Wy)|I`_)GQ2r+ong3pLLoDM8YG*
z@H&RN#m{+v1dFkr_5-}tew-!gxsJf>gTmh}nPUFu3)0OtuxzK#vvZ(;sPeWDR+AP6
zdM&^@7_0s<zQ80$rc;p;f*s4g1}%UIt`y<RZAixISf2K}f~$3WNmP;bMDWr3KT|k_
z!S2<c57BM^U)h93@J{M228ZHOBo}T_GTd4j@!~sKt~28f9vHQiU0d0ht3O4qAF}=U
zXxP*2$aY5uF1*=H!GwA&W&$rL3TOZ{DH0^Vr)I2-aM?PCh)Rd7SvE$|dE!kALu;;l
zE6mC0He^mD_LhBh?7d#B72-5pDi`aSl1LUB`C&h%M?4Ydk*KPo4g;UL#qf|EDMfjn
zMXgfg6AU%@vK19;=JcflVkKT9efPjQ!VPVtaK}9D$yt!9<_JyCT(BhFZRMlY4>L%%
z|0*Bvi;-la0U8dv5NX9W{p}jH2)q<}1T|K3=fRwDes$(pkj~#1bNe2Mg?;kS)~uV6
z$Xl{XMU=@S5zlH%38WGFO_I)-p~7rTAMu|Gk5cU>28n8{3L<<(Hc%7IWd=Yd&(cB(
zmu*7NOX;cvMWL?zB(9G@%ezAy3ik__dfhdS?N;Wb&Mw?=j51J<o?-+OP0aiv{PATL
zl=uU7M*+HY5H#-zzW_LnkdK!dVOk-slv8`~y52z}k5bi?K75*QACxZFPm=Fq#6al!
z<DqWk)eW?Kye!?T&e7Rj($@TOC$-QMtZMIIastK|Jfr%hm?k}!Lr;l{D!w`vkDP$g
zM3-v)X7T>|+2Pwe!-?NRz5I$ImvFA>>TKTWU?<`_A$)x`Sq1C00$0S%)||!^-y5H$
z{T@+-fD?XtRE=Qi^FOg214Yy2(jiVW?c%OwdMmy#w5VFzb8N$KK**<VzrB7d+m`NM
z6eoUeOc8~TEQ4YERHh><eU~As-5a51{I+_}$70a|In2AhbMeEy84XpfcH3>gbTc^b
z{1KXtm>#XhsD2n0Pa8m}#q(KphPiZv|HmiK!y@FS#PFgr+PXI6dlW^x+Le0|>xMRq
z-TIMQNOY|&@jb5Sa4T70Y}a_o0voC9wtWc=4pti0L9y~k)pcfqXqT4WglLr9sZbLM
zh$}D7wX41A6MSFI>AIapmk=_Pv$%{)3)hA7NBfDdaO-=K?L?zp;^DV+Ec0gFcMH%U
zO9uRk#X@PKQGh(<Lds+jn_DR52n|0Z0IF={b?!<FKxZEXK}iZx6drWi8Bu{My0>7O
zlx)^Ynxv``%<?2L#zJlw59kOom8{-*A%R6gqZ*$lNwaNrYBo=r^7^(mo3`1SJZ%;%
z7z7wB!gs1Nvt1MpH`S$-9n-lWAU30gk1<G<M@&7S!Wl<R%|jnvDl!bu2ZTJHc5w?@
zQXm09Npq!uHkpMjeo~r#+JuxH$D_{xgV4~dMq>*Bh4FG%P-1ssd2fp<1Z?{^5U6GF
zY=fG;^}QW?o@Eq)-g2Lw7`0ao+R`1v&^d1X&K;W%AgiEzMbn~69ySeIi==aC80QK}
zQ4qd27k+fT_QwwSBEFm68?U888vlqxb!sh>Z1hV<BjmMc3^7RhA|Mp3<M?B3<uLe`
z*1l%5*{ZIKp6IUL-ySfEnpVhQm$YinG~G?q%M%X#`&QSn?xecd+xx!HG=vMB+iXxJ
zdzAT&#Jt&}^a_s~V+mb{A_{CQ<g{APVsF)199yea^0Lx_V4qL;MM)d+u}IAN?xWw3
zyKiLfzEjPWR(;rKz@dOB5cUCMk84Bq)OP-B^|~7nR<Oy&IL3KU+wsJ-B*TfYZDwQ3
zCnWVhd~W#GU_h<pB)^AO9ZooMkh%Mqs1L^GY5ZC*fVWOA12FuJ`Umsp4_!7mFZB8Z
zS$KG&ve_-B*Fuc>G&wNNcB>qNSaA%UP7et34;=2Fcl(2q40^xDCwMVlVBqb|T?XH~
z5Lda@LU~^5Z}T}kT%nha3C9(6wDgxeJZJI%EwI?*c@)LV`loS<O!#2vu!~fAvm%0)
zIGQc9z<s5}4M}cX6<R9icq){o0SjEqEl#{~pI9jrH1by|D}TV(FNJuW^oikf-8_sc
z<ZI@2!i6dnhx@#~wL&not~qiBgMV+vA>^jb1=?S3b=@2mmRI?@F{Vrjq7+_&M%quJ
zm8K&HiO6I~A0I(%N*U8O-0kbbC?NTGy{?dHFc}p*J5?m&5HNXv8_40Bf|Qx`SC@S6
zacag_XWAsr$)x7zCrSuhKX_b=vz~oAc~)z@Pf2tqRZ<cdQ7Zpf%;ab>e9i+16a^Wl
zcr`cLY@VjKf-<hg$9F!GU~7I`boLEFaREq|hQS8HJ>kC2ft-Zt!p|dvAAuDRFPTwR
zlmPX2S5XC%?p&<eM!5;s#iYEhj}cKtJQ+bc@eJQv;aWs8yuNXPcq~Fx4WErOy`r*z
zQ|SJFh~e$LNMrFHC1uuE6=^Et%jwUQ?R83;(~4msCl=<drIy6T&W&TW)kbsio7MmL
z`cb6eHO5^A&}oOa1xU}{^hqG0P+5>vZk>Ogz2d=tdmoTIKy@s-t6e9P=TIE@Or2$A
z8bDzpV6)W;z->MFt458xa7upTY>~D->7MfaMhg2sLW*x636%*U4S#^qbIOR84`n$(
zogr8Jh9TafUUlwMH~mS%*UjBAD_4fhn1mEWX-x$Y&v29%Wz3+gX(}+Eb{kq_YnL!*
zfyp7+6pF^2A)(I*W-bq!p4nM`6NR1Ck;_6qHdj%+;OTjX<N93T&dO-2?@3GibnLFn
zjuW*&8(y<b;rnEQL|Hduta6ps&`@fu_tk-#za;+7QoEDdafqmJ3DG33LY8<_b>Xot
z$I?^fls?`q>#!iWFK|b63SS8nbTq};x7(P76=MC12y8ru;#82htvS{SwGblh;B1+d
zdwWn2R6lJb8l&M1Nk=u}u3|*|mOK(zMXi+n)^AlhfkAfkrpawZB073kWN`2ODwJzz
zz>H3uOO2Tqj4w8vk~38+<u2^jzWP6kf5YwaR4;>&!->en|5D9)&Y}${u>?>sqSUl_
zu|0I0ZU)j9E!37XGQPj%k(~$^Y6UWq8kBxMq4JI^4Rc2%yD5a(L!SP*)1ZP!M$vS?
zT(B~<57r+kQh}?y4cv0Nw(=#dhTzcy^AyNbd^^~Qik0_%y#`b;;~|;n=s5BcE8spw
z$R(uyl?OW3xmWtG&Y!-BZ6DodhJ|qvHC8cm7(2QTHD*nJh2t_EnF{~zd6Bok_uiC`
z<^#H^M}Y$rG&U3&OO@j0G7Am1!Y8ZL$RsCi>#%WUb<_hyoPTL2cxc6T5yXn67H6@<
z#I=youbBHg(bi}kG;~2g_b$DBJ0#VdZX5G}j~NfPu(8D)Lhq-k@*i54YmA%Crt0XJ
z+M++r9lks8AS#=mdusNB20^;cFu8q#yU@OLMB=sxswVR1exd1QZ#~VeLIyScd*e;|
zW|g{l0{4x>BvQ8YR*|<Qs<f%pMA_lRdq8c-aHC4X_5NOSwje~ul8%~w17#JuBO;o_
zB4K*X;1P)Ua~;-7F>xpORM{tq-TTAqZl%1KO{#;hB=3zQhqW*lFc71y+ha2i072T%
z{J#2GnyXzUj7X!Qh$1~#t<dccS2f`^IL4!S<;`VUBHMkC-RSZ^+ARw6%;p6>Kl|4#
zJllgjq{Z-TmP(QKYtcQaTz7=a(*?zyxNG6Lb(G{g3@^$nTMfgyr+J0q(6Uz$0XZ)a
z*h`hJm+K^iTctXoFp_kvS!|rNa-7ahP)Z`RdngyYmAqq=T?)FJHZmWr@M%w$c0IY^
zRQ||Ki51^f)NhDc^l>6gIg|4c2<u7JidKrW+FGh?YI&;c>XN*Df<hwE!kDRpAd<3n
zZWJVuI9t(lqz?+p8677{1_~l%%qIa$NK`oiERjrlx$#=e02?IMi^#B5RD%645L=T0
zd1Tso($omq3req(s}Qudx6#EbCSjEkR(NlZ(Dn?{KXLB%Y`ytKwyJ&pebWU5u&$cI
zbEKixPv+0%xiF_rUE!o-RV@;YLld=zMX*P;OBiIRft?@%_l5nnt7re#F%w+67p0*e
z(uOA5(=X@p9xWrEC0u{*!m)2-K$BWB6g*%|z<Up?rX>j*M}d8A2n~I2HDnuWXl~qB
zJmSQBG^#0|)>7+-n3##Q)-D}7Xte_H#KWUa-2M#IrdJ#lk|syf+`1-O4lvY~!sTxX
z0F6hknoVVJE=Y?P(}L1Xtks4}Lg-n$Z;y>!McL$yf8cyC?Vz>N7pW$@L{|)0&G=k+
zs}GL}qm|}B>7Ag1t)77^&YP&qzM~`2K*h<2|62eq2bU_}jbA1+H-s~JoZdtM;J2UD
z!Xjkoan`Vq9K8Al(>!Umw<2^&l9k}2w|uzQ2JKx}H;o&1+QSmwcy0Mp^N<>D6eAQt
z_8lrDUi-9bde@{)t{%W^g~8uIvR1<O(50z3AFw$EAJaRcU>3yAvEw~cg>@S*tJuir
zC-fR|+k_%`d&g%S9o6|hL(Zr!F+Dy0%}0M+5dCU3{5y`U3@NuFx)P27hH<ke9~DmZ
zZN~X2;#|ZkLy!f&-xQfMC8uwf9KPZV!(bC1C7uuCd8Ankz2}4O5`WR*y-5eMm$!ze
zrxT7^&<Bp=AQ*LQQbv7ARGOMQAk|o=PnP9U0ntjVT$;@nR_=ogIw#lXAd_7!M_riV
z;Y3ITIAE47lG=j!F|o8E<uE~St=`@#z%{mmAR94z4B}$R@a0Z$A5&yC-BUf)^4$((
zw<T`CsVDE8DKXNrC&96E@#C2je784CM7US6zthZW3Y`^{u|k!yJoX@#MM$$`@)S!%
zqkhFu>n#6Ijn-pz4GcF^B>Kh{XIfS^6g^6JL`EGe=8&Z19y=wUc3p(Xfxi}DIPueN
z0+d@GzIvoGr{PNZc$Fw6_A+%8Z=J`k_LA*2^YN~M8Zu1iS0zrr(k1KaoCKYbyN^w!
z(Td1up+42INOfXKz7My7+-cU$Vl@SKOZ$Nj`@JXMD|mLgtE(4NhX<q9%3Xw@2A;K`
zGRpL`(a%GcF|FKn9P#KkQ~K;6JPtTG8KRig#@<;kI!a&V?@v|>Htb-=-d7WQA!RF|
zDRx0ZrO<;oE<0h;<K<%K&T^-m9VMEO{WoG~Q)#hq#!asSg(8Sj@77S&Qe7+|DYb|)
z^sR)W(5AsBjhYp%oI;39E|yk{;3%w$r5_yloM1{EJ2?|U>+7yy*34Nhwzw~Abofy{
zMtGuXI*LKhO0FM>Y-3MGNd5ql1aKNOHSl!sujD!+!Ok-tYSz^OWG`9v8u04_9+Aqs
zy^|eIqh^%{ms<iA1aDbaguYYiii-WTJf!BD-M>Rv7O4+BDP>iw8OA4YpUC#=VCa<<
z7}Rqt?zIEbAPzLM@StAO%KKU`UkL-?&NL8Fa>PKZMJ{m$^n=fju;+>;){>leGyv0{
zjmJM~^!Fr!ieOBY4H}_~jOnFJs^<0J+2QtNH@MR+3ZFo=->wCGh0olfWsm;rn!tdC
zHjxo1B}R0;fcI@y>8K?ugUeOLQlHN1^kZ>Bqi5wPDUBwK_k~SOIRHj-d@P{4g76;J
z6IrpvwU$OIa_lxG`NmPafH$9yP(7m5_yltF>Y(@H(-!#WndmD7(i3U`FrPw3^&y6n
zm>h2Ilk@y(ABBw(k$~WdwfeoFB#TO9Tcaz!fS1On%ZcH`Lkm=1?(?W$`?}Ong7<iV
z>46W9!~*hoj84h}G)%u8=>Y0`-@+!dqUUZwZQnW8!;%np0mN#i_0m+yBLpMNz^eVX
zJKB?uahDz?g^QUWwx}bVXDDlfA%<0iJ9Vh$di^z8SrnMXNPqA;vV5?jDp!_oH}76D
zZedNavz4&jHehdLo@UJf<TUr{FpsrPTtB7Ho3#4b4LWBYLox65!xNlsBgNMiuywi2
zY;pmUdV6G@I-P$h{^nA5nFLLk{RIZUeUX?|nB6~fEKkDf^Ibvr38=O<NN&$iToS!~
z*!z4;V>>VH3^Z5D<gd`|G|Jik!-!OD#NUJ&HYSzWv)V&K$B`I<WoJ2vbD@L4XP8<)
z%Py&4PX?$dNm}V|F9&p0b{LNc*S}rGNs{k^DW^NK6Y#<#3;a+v;Xy1Lr>R>0%!tj>
zMwqO-0biYyNX-VQ{hy|aY6Q5=d2d6dgExfnP;Rj*m*M<yGsWNp?!>~(f?+}4*iT;v
zQrq?xh$5iXz1VlU>Coyr*;5bB5zvBh(Sg0HrM28f+dNd0+JicVZJrwacW6yLI&ZF6
zR!oCr?=0LyIGP9y^!le;A#o_44W50VW~XNUopcr$(xn>=1Y5?$-4Dd8Im;Az04<55
zD$_pp!}+(GU0;eYpG(1?;rJQ4$!U5W!Wn+LI9k*{JVZ+};ZEyuL5P?rJlVrG0&ttx
zZXI)pXa$*lSBYRq8#QFGUuCi_KLWfS5A1O=%?r<FD-yPKfQ<qMo>P|g<VLK2sb%&1
zDKq1ea@FOMY`ap@Cg*XrE%-9HG$Ys&eL0i5l?NIK1dKVoAuu;2?fj>C$DkkjqN|i0
z^QM=P&7@G{<3b8@JDEU{!k&_(TOr-|ecT2QtX`;i_B0!#6V!hH0G=IF>Fj_U*9ZFa
z(N(sActEzXkV7PhFq&2oS2xf=F6<HJ4d&6w)@a|w<GyZl-9HGIKZV>gZ~=4W<YC$6
z>|p8_fZC`4DN*s5s3hR@i&YC9_|*4}L7={W&nZK-qZ~vKM<=zV_F7%J!9qhBH5<Uc
z{@p5^Phk8W{BaC)PU#4#5E9;btq7soI@>tUW9;jJ9Qy~l&|3%LtSApzHcQS}3T^^U
z19ulpYn=Vln+NStIvnOb9@%k+z*bv{x&+bj>&2j;85C`~gBba+`02%urqnnd<n&Pa
zr#Wc2ceP_{!HOf0>yV=WV=|)<2U3w|n@64ta%oI@?TJw_pRMlkBMu2OSb0cqmEWW1
zP*2fuV56aJgSgi(3{VWQ!1}7`VL=3vIksq2CvDrVxP1Kz%$zKGf18@=pAP)^Qlbj8
zFnHD3DxgczmCQhvuVX5)6(hB#xU$0g+-`Y$<P$JP<gK~FYtI~hhn(>KR#$Quj#qxb
zJS@?VY7j;752cs-6tJU?uNiO;^VZW-QH82Y7`5CqWUnyp@tM)>zNof)J;s`d!jj1Q
zo0~cGNm=Zju6;CLyu_g3p;0?pWMk3&(?$}8S)GjCDk{@08dFou8-7>gA28)R7a!(q
zF5M-Yb-$MEn@RG+t?X&F*jaBb%gWf(M!2&w5J~gVqPnlzQ>*2g$wv=0@<_@@AIKkQ
zBJT%M*TGt8La>@popwf(#Q}CrlIXw#QW&Z6X@T#}09$a2XTObeCkitlgSr^noLWsZ
zy%dF&s>L>GYxtv3`o;v&@ruCmla^`fI9J}nV|UW07BouRxYNG=Bn!^AAow-P9PzHa
z2DLvN;>7UBKsKa#2m7Jk@oYn*J%DQzcpOA(%Y^-P>1PgK`sr;s*ldPwi#@j4^>8?v
zT4Skhf+u)$3i1LUQP8k1zSD;CP)wJCxW6%32NJ%$&kVI$32w#8ljap<#=0(Fj6#YD
z;*Y|1f!BRlW#h~1U5E*Nyf=Pr|1wn4h0g@V>fLwM&_KsRz*@IAE!PX_Ub<(VUmIq?
z(W}8{i^bdeyMRM=ffg6~qu~U<f^w>*XpGZd+C9%;YCji09Agwph%^ZO&&tqwT5RxT
z;Tdi65!SLaCht)o!ebS~G$O{}`Q!k+$WP!LI9MMS$J1+ty|a%J_X_vyKPW;2Nd;Ua
zm<o2RSH9(v5L=<3F6vN9`){~UT+ZF#+nCQdV#`)@O7r;0^7|W({ObS$i5PSh^E3*A
z7syz4E>i_ec#p|dWJDir_4cD^(ch}%CF<h7v0U%BfFSPMQf=mcN!NmXswLKi6>3I^
zAxue4M1vnJ!A1950CuiR*v=TI<3OMAZLeSVH^j!-XjWI(fbDQtxkq%$8VctXOwFsZ
zv+U>n(9rF4zw&H9KF5u+O34qX#tXS)k}*#Acb??$7fO*$KR(C&tsO1x+e~EZwaKu4
zQ!~*@2ec`$X)02EKzu}stZ|t48ympo4`l@dA_H}NQ&541r{JGdPbbk`#EYzaW>Ney
zmt^erWng`bz(5ZwSR3Kfvs@oMZCqDsx?F@|C&5{7aQ}DUEq74(r9NZXihYPYC~a&R
z-KO65S=I7#TaH$qR&V$w3o8G63-rJ5O5n9_z$NOIR+&yuWt}N`klNWV9b7}V57xWk
zrXc~ws)<*%MdMrkB<lr+1wbWI#rY^9zG4Ae{`ERh#>dOJXWhN=^zZG~99U`|ph>h(
zw8vi45{E3G{cl`B28j#YU19t1;q4p;%B#}EqxyB;o*L7L*HQY2lq0zqr9>+^F0m&p
zPI7se36m_v@XC()1Y)n5Xy%6t#?%L9EqMKzfBiB};I@qT%}c}W4~e~?uppQM6n7s6
z2^*cXWBIU{@G^=%R_u=RYt}R)Bx5ReP>#zMtT#zYnS{Oc1x$wC&+&n~cl1o|f5`T+
z%W@Xw5t(UOB1^g88YM8Oa(*BGkj;1jsx8!RgaUp^aEWhn`wIoGUyG_#b}B?UjDY3(
z<t;tKWPF1LRt;A0HHR(t7oR5#c{rUv#6@91ry4qJc^B}|tuX$$qU{cQ_HTm)dhkQO
z7dI$EMq;dliHSqwH@JSGYaGQK`TxoFpy<<q8;#5`bqs?O5m%xe`}Kmuy$eWfZD1)~
zgrCzj1ex@l#nPkzk;9m?z2{1r${{`j!HCA?Tp5}tDhE&ArFl)>77oP=1A_$)vm_^W
z(*)^{f)zAsNY@$?Gc(Nk`EM}f^`<g`Pd3e@*_8KMA5y2JEZA$LvP?#+y~eyz6eX@W
zOVrSjqAD*fmK-*~s)W9*&QgoLLSFMaKGjNEJUjdFq#xb*6>x=iu^*8x$ReYcD_vN!
zQQv<a-LXb1d|9Q?$b@SVXH;a%mSz6jh_ABG8p<+@lIz}^g;M!QpQH`*mxNzWf;J;l
z2@(7i|A?=J4S?=OW!1BlOW?yz8cP8H?`?g7xm4egjRCIoTy_EJ6Ak;rYrZ{;7s0$#
z`%7oR|7r3+@Ai7f^U)^ZxI7TGUI*5c!7n7~mUSpd{t%sTz8%Fy?I|vMOXOqm9m6+J
z1O%l)-cNa^=`tbTS~Rh6hdd@s4>q4lN$cgxPX-=d)=FR0P2%lg61n}T;RTnb4{jqF
z&Zut^r>E)?)D2#kQw-;U#U|EN7cxCdTUc`Wvog&tSH;A`(t5m!%nrzLB6;Oovate7
zn$(wU45(=wi*BwxNYUf96X+SwOEtJ>SMlQXv%P%Ud*+sHUk!4FTGLg;#i(lNKtW3`
zIYu(W#>@rJsH3}CFCg;yFgo#cq5|n%XlAuXqz-t0JAGA@IJCbtrSWlZ=t>EK>p$$X
zJIX4>6JQ49h=p>pmXKSm-s8!>`#&e+5d}g>s+!ATLh51L3?Mq46ak}~;g>vOaCoT$
zB_r5N{4+DVN>8;M>V1|fA5#P$o6!}<XB^_;vA7ZpZrtHLuLHaO6_zDAt(9>}|45@9
z#nlvROwE$U|B6JKpWK0<G)8j03_FdWuZf$2t<snI)REQN)Or9%&twG=I?Y<jyM$Z;
zR&FKjn84n#*c2nt)VG<Ug<uv~_$SfUbGB$3gzba-;u%R%Qkzr|cr=E!c}(&0nx0bW
z*^9A#DHz3q?KweUPRwpU)7B>BEPV5yiGkt-UyCfBwPqK1su6eHvwJ_ZB%akJIHB9~
zeNB8dBg9w9LB`lr=t+7NviQDxKE|@ZU#o*bw0q@}9(IXRhe0^bTePe@P<&Mb*8fRO
zzv|w^*oG0-)WiMcq9tK<Y5K}|cL@(hY}|F=5LJUo+KdL3@D!ruAhEeCPQjkAu`m$G
zDgou%eUFfeaT2cVT%;h3KV>a?b_(tP8u;<kYX<)1DQ^gUuX^R?u31?*Z!2<67KNRu
zgD;xnC#NFm3TH(NQL?6fmU@|!6OMwYf((50RY|&cL5uBlcoO~dbjTW}xi+P8jG0hE
zRK^Ea1|Z5Jl$K5t+P$t+D)M5H01lCMKL=#FM~_+A(*h9|R6^<nlsS(Jn{Yme_w~XG
zVy=g%z5iDZ+oLkR)Unv^p;6fkKsT(J$s1tBkWx(@)b%$$%O8V$vpij*;j^5>9a!*x
z8%1dghK&@t(BMtF>F7IHRogjMGv$(gRv6fRf-*+j8eRDY>kn^AlQ}a#+7JrMGcuZ|
zkL^+ft*lWHjXM14Ge}N*ViA1_b4hB~-6+)Z*^3vn`hA0IN0I3UWxH%V=E#9T1$Sl?
zec%74kF_R8RlWr3LMb(XY!LIVnidvf?i}b~K~(#w+4P<YXHAu6Z``U6kebO7il~1d
z+0NaVu>)>n3b(z6vtNo(TzneO4R-pk&-TD4&y$ZL-$E;%muU@$PfkaR%#5l#&JdfR
z%}IJ3!XJakj~<GHDDkEQzmsj!f7>T{Nw`X#?`e33x@abZ<zP4pIAWWesk)))`Vw_-
z5{bA8z*`W8Wq1n8N-EbN;k%LHa;O%UIh2NnraS!v|39LZPr~!St${s^=r=1buIUCX
z4iPnzkXx4LDhdlY4tTHDXBs)a0FxS6WGwhlm%XEVl-Gi)SFGoa%T`x>8baom8aE)Z
zDF~83`xk+iVL$(ke30e#uT|@u!9)l}d-dnNckGXry3R@&J0rwEUTg7+tA4yEHEz4c
zBwryHM(^nn-^n3(oz8lBk=4=1;UTI~F3MOCxc6Mun#r=S680=Lyp^=e9)a&>Xt|S?
z{agF`IN_a258ylr1gs>vysj*;N47LQjG)Lu#(il0oRDmExrOdpqKN3<7zBJ!IEm$S
zdJ}d=X$D2@RvLDsLQLXM)^J4&K$h|PFNs!W`$eMP<Iz@4xs~1&kYsq>v|sLGOu*2`
zr@h~`o3&i3>g1YnPk|;$yYaT9HW2;*@0xaziw66vM^4oBqkm~eHTA?WfX<lT=BJy0
z@7!{6QG?!V#}3$ga2=Zb^Da?qtm|9j%e~&#Jl~57BTRV0`7Tw&=DrX2;B&;CzkDz-
z@`5^SVu*OZ3Y{|E!D4?Y$ggKr2{E;WMZD|hWu#4ss7j##5$E6)`iOp0UbYp3>IBYH
zbLKjX+tztqVYse;kgmpLcY54UKFG#zpTA2lQ4}0$Y7+$#K;j0uu8pOdCJ0WK3Wy>=
z%x(*b^nu|p5^pd+QSXjtBy(ZA`Ss+aP2dG0a#;MC<d}_e_Aj4<I?*<vTYiW0&YTu&
zE{_{j=IDvriV~t#;n#!nSPVc(PwI7?*-HBXhL;DXcr=rzSbs!yd13W`jxhPjCaO-d
zVm=8}Tu*_yPx-ZxfzSmi-B(5lfFmZMM`NxkOueG#Mwm13U1G~{RbUXchcfpGJwl!t
zG}0#Ez2*xN@)T*Qx8~nL=#_K`58N6T@TQBRW#t7W+=zLvXp7p~aa?Sk;}6&emo%FW
zFn~%W)NYkq?a7ZgcUsW4qCe}-{=eQmxx`0jb?1J9n@>bC5WdJ~D1_C&1YpfgS@FK0
z+Z1^;iz551k^3|}dgy8QT?KR)P4?Ic!1ch{<5QZzVZ7{0{mP`7j_?_40cMtP2Q~N|
zBehxjuPZ*_T9fX}?(s$CFnS3;hvXki&J_@;>;9}oKMiLBm`!F}`_2LShSJy|tY?V*
zNp))f<tG9t9aZ!x71)u3-;>m3CO*ngdXvO=5k93$1#l4h>f+&>hbgf2FN5ndPbZ=q
zwuaI&Yn<Fh)fGgy%4jw#!$QyQ2h$>DL~GK;??4;OkD2;3LymHHmBjcxK3P}YC@g7P
z`V{v_5zA$kB-$7)C1R})AEbeeEE-V|=Cysru-4w<JV8A@!}Co=p<AZIt_+5|{dH{$
zP1S|BY5xT-PBk)2$Od%+1)$h6PYEG$lKqpY%{~mws{-|HA+e|tuc+bOWvK-fYMEo=
z307_ubUwPKohE8$xvONndC1CSgGqTVV-xT!6Gk2XzYjE|c~4l=^;gvN!cBE8W~vt&
zBblX}rX9vGbk+2k1YFHOU^u8ev18U#?WJYACr81g&N$58w3x_%2Ta8=CAjnm5l1r?
z<@fcqJ0%gy;G^9y%&lvUpoj!4d{eA-(`@*-Eu26viWGR}Rk7m)tE9_YWUp%-qt;Dp
zJtduE`G0!XLeCp{auYNO+%LXDWbUeh??{OTg=C#ra}gemfri0U*Z3aBQTKWfyqDJ4
zabh-`@;EeYMj67E?WEHwL8vdk;jEt6tLnMBjl0=20|H~$;?El00(?)YM1r^9i9p$3
z?+4(4qQuf}g%G6lp^DHIi|dae4NgDca>&e-3-E(y7Dd8)I4>d5GIC`J3JHE)4pox!
zua+9dA(7kCAq}_kerd5eV0BNuXI@ZwDj7VI$JA_;bA(K+Aj1sLBvI!7kAh9c?fsA#
z<5=}yj{?tK+$O3%w5r_9>$1c`6*1TOy}d9J(?s%BHBlt3EwzE7-2PhWHBN7oj=o6y
zEk*S1fu&pW2e>e>h9h(M!jZLkBQicIa2+^OOf+u58Tn`u)NapJ6mPHvs?rGEpYdPx
z45XTCeWJM3w}15YFVSHknlnT_Wrq(Co=>d_M@Qn2Equ4?L^Crb#a^i1_Q1#b12cP)
z(0wPG{bIB<^L)HwD1WYZHR&4~7Bo=!ip=ycnE}+0rBynnc88&~{MQ*DYZn_uvi1Sx
zIP-K5yKmx93IBc96mm8Y5+H_f%74HArpV--$<fm}iOn{T(k-Cb-6_l1roJT`kS3+#
zEF-LN1Oh03MVvI#75jLOKLKt8cG#Yp-OS=aEYMKy{7hn{nUB^C!iJ(6q)Jp3SYnS6
z^oxfWnIclPmr$Ti()8jMkzj3E&j5kHncHEtW&YfO-K4CcoLtC3-e<!<aV!#^eufar
zoJF6($aut3cKuV%%N^&1n|@c)r`q2t^<FfTAq4QuEbzbGdQ~aGg+>TXpE@!dJ?ppR
zhHvJt@Z^@_tSW+uLshFgc&&8B4FKLUIO0HznZo!&ge+rQCtp6GChkX7(wZ)T-p|n}
zYqC%|eTYe7i-)jgBR7ZpNNcjz>uHzJRJfuVwGn?;`saomh+dU@Eq#Af15x%=<?eNS
zu@fF|hcvtRL8dDq&FiB+1-$ZSkc%UUTn9FI)jaEJ4VXv!U9gw<_eSgp6Yx-t0jDY{
z1aQoyx*Fw&MJ63T%fW4#&XPW44H$>Whee}iyAb|{106QzW!th?58ye>V-?Eg);VK$
z3k{>j(l>5UQTlpA3^aSJi6FHEJTFItez42_$oKk;MG4d>1qa2=>ke*UzxZ_8ipcKJ
ztvRFW)fSx^uf*X6f}T;6+WP1kj^swwhp>SB!q-NAke|>mY91D{LMCKjfRjp+$G6oy
zA>A#~IbS`4%rx<`HGM|xHq=5!+yLEDUiU?8odvfmt^X#9>nB2BF<=wO7|+q{`WdEa
zqcv+D<7q02B5SPtXLOQ3w*R&#5y9#1-s4)PLWiVZdHZShbI>0F5g3j=`G1HuB-HF6
zZL${f6PQ4t8zvdS(8Y4>xQDmC1+9)>7tqRE*$#4C|4eeiHt^$~qhX{Zy9w&-{EC-X
zblx2!Qb#~Ln=7SS775~aK02t$nwnUH?U9m#nEO={%k0VtKnybm2c3T(+yEl<d(!>0
z?T5CHt1p5G$35Y0JKz4Wqav`3ex?F~hu`ZK7nF{u%>5;>gELVtgn4n9B(klXb<I?L
z{V=wrri+Zxe-z_y8SrQ4{$C%nBOotH{Am)clbbg!e;y6_)1XqrF0=OMJ-ME(OLITi
zW*}TF&l%T!=rj(r&i}jI!B<g1f(vBI7IP$TU85B74a5&8oS|24%7|yXb%n-#`EA<!
z;KJsZogtlrYQlVCHtt0U$GHm!Ao!wjjX!Oiq0$fVJIzj%?98oVz)>7h$GeG9f&C#m
zBH1h;W<L7-JQnB@e>0fMGlkUsO>?8z{*xi@+t_|qbC*tnYy-%o#2lB=bW?KKm!Tb^
zsLmYG9(f+eX;8#}9b=ffTq>F*x`l;OGCfJOp;i3R5uki0h=iHo#8J2MvHB|sQHueT
zT!@A{4dWR5I&=aT`uQ`df{lLE9~f@Dz5^?1)=jL5{%2x@n;XgZ7}%SWhI>JJ4O&)r
z2AsIx8moNQ!+6Oq$Gav2XPv4+Y&?0F*9@$7ztOTs-8Bg^2WBYbT=)@LQ=sBhlIu}U
z()=#a@))95tCMq_`4@x!JLbsbXS2_vY?J2cJvt;MrH+=bnVW6=TEP*b`t(J$<tSF$
zu%+$wbBR_QGs&f^{g_mWjL~Yr+Jp>X$Cx}hPBP;=tT$H>jXhW1R_!d$WeD6VoU`Mi
z=-09jWISlc5X?GBM#Jw!B+XYTCo0xgML3K6(foOq8$@Tp;B3mW2-979JFU$hXB7Sy
zMLChIbgx<Ro@O&2mYQd44Jy$dlY%|rcyyg4eIE*|Ew*Ixuz0ali4^FH@A&<ro|NT0
zYxqLVV(D&E<OF67#H#EndTsL^=QLxxe9G-8?tD$syx%kE6h~PGeDvBr$0YEXaX}8V
zcXQN{S(7})V|v8`N}1*0-T<Uha|Uo;GC!stvW@U2fyK?Iji2&BOh>ix%^N4dZYA8)
zZ^CUmg2#L<=*uJQQ0J*(-S#;%=fYPrP4#_pdIlGWB^Vi7!Cz*uFIjeOnLSiZGE16e
zN@(b0{f%hb<31LpP>R{7MofaJd4d4fvk#kZ*8YBf;U_}&;HfSL3f1(2%S@W^+mmL4
zD|qWz1nYPMlFXY987UB2Loj^m_A)3~YMNJg=h0*+V0y&*sEdVCK4kw9mCS5e7(Pff
zVb0?&T&xy6S%dtoa%{B;*EORyzct=KOS(OW%3kfDpWfwa-AofrrY0@X-bIV}K05`1
zBLA6T-qxLo4NQH6h=&YXieue`V8ssGhdB8)9{cGQsuE0a#B;CmQ_b@mYE;X|f|tss
zm%bWdZ)w?yxZi*mR+#v^WnW4aO?f5Fnh7Ij#j<J4G2Sf|-Z_RCUt_YhbO~FhCJi>A
zxp|805XQ^&6BC5Gae8vCz&slIjX{KC_upATv5F=)ys9Q^&ab#2U58Q{sM;iZ)`{JZ
z7GbFCP|=k*i?l-_dhbkA+IEOO+p;HX#+GAX#kncHj(X@r(usowJ=oJKhZcgor*V{4
zuq)?sRT*dP^V{yupA&B*1``u)YR>!5QB0S(P%HqG_<ri=g4)epEv)-U>#N-l`g7b9
z$cfr|3U`w1SL&U31fmw-`RO{6#b24OGNwf-B*u4VRcy}v|KwV%UV<3<=boM<x4`0j
z1amZcUtx!@_vruPk4AA$g-vsFvIQixfzVE|o-XEe*A%!iM`bMqq`BoTNX8~a9WKYt
z+wsxXHN!!TF&9OeGN_$r&9kR?I>n5f+99Y=tLMYN3n*U@OGMKMv@CTNYwBbNT#91K
zvq&#M!v#on)TzNJ;#n^7l$X9A>enh#o>M2Xt|V?-`7inBzIjK$fmywq&Pd&_X=|sN
zu9JIZ;ax6eVnleR4{}$u0LLQ1^b!#<Q~g+gq~!6<8bwdjZ(BR7Syqe=FsUK#lVzV!
z5(e9AQ|Ok!I5C+NFq;E~R33`-^F@=?dO#I{0JoT|r>Tu70@W&vXuy-NH^c=EwgAxv
z1opzRxN71@O2_g4)DRPPOl?o3effj;#I90lr$;TP5E_~nsc9jkw~@O$>YF{6FO#;I
z#*!AdA7~TN;M)Su)tVt*+Nq-Ng1w;d>L$6^=*4%OvPep{(g{<|a&Ua#=w@OdF}jKS
z{0#maC!n7rlL4(Ktp>~L8~AzK+Fy)Wdm^fVsO6^Hk~kZm=qU#LW`Ps!M8r{;Wk*(p
zyhj6E2QF149h5z|!P+I#6ddd?z<7OH5D&)S)A6C-Jo4cH)#`^9V0G>V#Z6+gTN_}S
z=t~xpVdHhGK=f$}BQe%8uG6$&G;{ob$JheXC#2yWMbi6{+4XcFtuKonU2L**L?(-!
z$%LuG=qKP(`3=&BsqW^Ec)6n>P!w|Y&7Vh{ZOIB*z6RgoLI%gyU5-=~4Io9WRV_(X
z5AHVs%<#9y{^)M<@MK6|&y3$p{J2!hmi*KGkTC<-D>O7VWSx(y_4BG9N?<gfFav91
zJEa8ijnH9F32k$(&Iqqa?@jL*P$K-zq<sb@xD_N$i&zuV`USQ)IviDqs>nus!&QHR
zA-zV%^<)Q0L1K9M11uufex?_KDzAgSbKEvM6j`jTSc}D++v0|{$45)~^W>NR^XRFj
z=lNH@;@%$}yr-jkFfwE+K6$2di38h_!6eD|hm6fXgUv3LsdWdmj1+x<c`Tcr>@6eX
zMz8(}d(yJ551R~|eOI#;61gxgX)=IKQ|OvNTz=#>11rie85}+vYeT!!;T8+LTIWz(
zS8UXd+GP+N5{<4Gcux#IZOow&yjwT36hip*^oi`VCz-K^Jt|J}clZutkKm*hk>AT=
z9s+ilxsoI4CWpAE>I-)D7twh%;t#~kUm!dnE;mxQ&<M-{Tc`Qc?oGMQ$cE6qLS`tw
zVT0+x!8WH1NmKKtFveY2Nvvx)LK#*3X#&i0%10=_0qnnu>{N}MdjH%XA%k@pfp)I*
z87pl@`{3MuokO}a4N%o;1WF8-yax~i!y5OyAFL_l!*>=agP-v+eHKf5s<I4m$C$sL
za7j;Ts^O=#!+Ne8GIRXT&7jmL8ni{slzOFvDLRywH1X?_q^AB#3+)Nl05Ei`=q7o_
zPg;;W4}|g|wP^D=((<1q+Wy0}j}yj#06%XG#fepLFhujb%FtpblVw*9%r?Jt=)Qg2
z&GLl?sE4|<bFZi}VdI&sbxKat<^@S;+$)Me|7gO6&g=TU2fPI|vjLjbX9w^O^!y4x
zY3xSOG`9-*S7Sv2oy&phFP;Y`#iM%Z(I{7c1Xp3D2d%x~Re~~u`;U}%kJ*mOIA=VI
zKvDP`g^-d?53)dRC(A0r16S>hq77wzT-L4SF<pd(Z*yS2s5k!9!bge&85CdFV*$Zl
z5;~{av=u1gT%*b`?eIXng1xcV3L(uc%GTnyh48v@v96C5(e|%`c0Zy6zlmb3Zc9eS
zPv3#q^p!lr|6n4(LBB0`iMTJ$Xr2aVwLv+Y2-k00o6OD|VLSd!IEW2sfwVO<A};i6
z=nt@-_z0sK7aGt)LC3Ad!k&rZd@XrTNX`^|z@mW6gX&Gd;|{MrX9?@&?LwwQc+}+E
zzh;UjE(iP`E9zb=U)+C`fj2kQqsL(`OUYK>@46QBjd5i%qA@TkbH5*PH#!$(d*<?A
zcSUMJD5fh(QVP=^a*|42asjm%0Afb=m2gZ4z(E`$+N6M13<eGUmU{hxM#Ew|SfjS3
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%0D|4NF_53=<cekONa@?kg0<+Kc6P
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%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 0984/1478] 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 83e2196a171b21840a03dad6154d9d350d7dd00a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 12:26:53 +0000
Subject: [PATCH 0985/1478] Make is_shared const

---
 src/Interpreters/Cache/QueryCache.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/QueryCache.h b/src/Interpreters/Cache/QueryCache.h
index bafa78f13d5..4bc33e36441 100644
--- a/src/Interpreters/Cache/QueryCache.h
+++ b/src/Interpreters/Cache/QueryCache.h
@@ -49,7 +49,7 @@ public:
         /// If the associated entry can be read by other users. In general, sharing is a bad idea: First, it is unlikely that different
         /// users pose the same queries. Second, sharing potentially breaches security. E.g. User A should not be able to bypass row
         /// policies on some table by running the same queries as user B for whom no row policies exist.
-        bool is_shared;
+        const bool is_shared;
 
         /// When does the entry expire?
         const std::chrono::time_point<std::chrono::system_clock> expires_at;

From 840e73eb7444400514463885de75b6d551935481 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 12:27:44 +0000
Subject: [PATCH 0986/1478] Update #includes

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

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index de2e2b9ad92..fa01b1da67c 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -6,6 +6,7 @@
 #include <Common/SensitiveDataMasker.h>
 
 #include <Interpreters/AsynchronousInsertQueue.h>
+#include <Interpreters/Cache/QueryCache.h>
 #include <IO/WriteBufferFromFile.h>
 #include <IO/WriteBufferFromVector.h>
 #include <IO/LimitReadBuffer.h>
@@ -14,7 +15,6 @@
 #include <QueryPipeline/BlockIO.h>
 #include <Processors/Transforms/CountingTransform.h>
 #include <Processors/Transforms/getSourceFromASTInsertQuery.h>
-#include <Processors/Transforms/StreamInQueryCacheTransform.h>
 
 #include <Parsers/ASTIdentifier.h>
 #include <Parsers/ASTInsertQuery.h>

From 0adc98865d28fbffc5d6aff7def6d8cfb16fb91f Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 12:43:14 +0000
Subject: [PATCH 0987/1478] Add variable for access to found key components

---
 src/Interpreters/Cache/QueryCache.cpp | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/Interpreters/Cache/QueryCache.cpp b/src/Interpreters/Cache/QueryCache.cpp
index 3118f386111..1afb538c01d 100644
--- a/src/Interpreters/Cache/QueryCache.cpp
+++ b/src/Interpreters/Cache/QueryCache.cpp
@@ -385,19 +385,22 @@ QueryCache::Reader::Reader(Cache & cache_, const Key & key, const std::lock_guar
         return;
     }
 
-    if (!entry->key.is_shared && entry->key.user_name != key.user_name)
+    const auto & entry_key = entry->key;
+    const auto & entry_mapped = entry->mapped;
+
+    if (!entry_key.is_shared && entry_key.user_name != key.user_name)
     {
         LOG_TRACE(&Poco::Logger::get("QueryCache"), "Inaccessible entry found for query {}", key.queryStringFromAst());
         return;
     }
 
-    if (IsStale()(entry->key))
+    if (IsStale()(entry_key))
     {
         LOG_TRACE(&Poco::Logger::get("QueryCache"), "Stale entry found for query {}", key.queryStringFromAst());
         return;
     }
 
-    if (!entry->key.is_compressed)
+    if (!entry_key.is_compressed)
     {
         // Cloning chunks isn't exactly great. It could be avoided by another indirection, i.e. wrapping Entry's members chunks, totals and
         // extremes into shared_ptrs and assuming that the lifecycle of these shared_ptrs coincides with the lifecycle of the Entry
@@ -406,15 +409,15 @@ QueryCache::Reader::Reader(Cache & cache_, const Key & key, const std::lock_guar
         // optimization.
 
         Chunks cloned_chunks;
-        for (const auto & chunk : entry->mapped->chunks)
+        for (const auto & chunk : entry_mapped->chunks)
             cloned_chunks.push_back(chunk.clone());
 
-        buildSourceFromChunks(entry->key.header, std::move(cloned_chunks), entry->mapped->totals, entry->mapped->extremes);
+        buildSourceFromChunks(entry_key.header, std::move(cloned_chunks), entry_mapped->totals, entry_mapped->extremes);
     }
     else
     {
         Chunks decompressed_chunks;
-        const Chunks & chunks = entry->mapped->chunks;
+        const Chunks & chunks = entry_mapped->chunks;
         for (const auto & chunk : chunks)
         {
             const Columns & columns = chunk.getColumns();
@@ -428,7 +431,7 @@ QueryCache::Reader::Reader(Cache & cache_, const Key & key, const std::lock_guar
             decompressed_chunks.push_back(std::move(decompressed_chunk));
         }
 
-        buildSourceFromChunks(entry->key.header, std::move(decompressed_chunks), entry->mapped->totals, entry->mapped->extremes);
+        buildSourceFromChunks(entry_key.header, std::move(decompressed_chunks), entry_mapped->totals, entry_mapped->extremes);
     }
 
     LOG_TRACE(&Poco::Logger::get("QueryCache"), "Entry found for query {}", key.queryStringFromAst());

From 6e8af092897162035c0add81ef2d8d0028cff810 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 12:48:29 +0000
Subject: [PATCH 0988/1478] Provide query cache reader with dummy block

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

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index fa01b1da67c..5cf86412c3e 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -734,7 +734,7 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                     && res.pipeline.pulling())
                 {
                     QueryCache::Key key(
-                        ast, res.pipeline.getHeader(),
+                        ast, /*dummy for header*/ {},
                         context->getUserName(), /*dummy for is_shared*/ false,
                         /*dummy value for expires_at*/ std::chrono::system_clock::from_time_t(1),
                         /*dummy value for is_compressed*/ false);

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 0989/1478] 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 0990/1478] 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 0991/1478] 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 0992/1478] 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 0993/1478] 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 0994/1478] 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 0995/1478] 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 69e7c1cc82944305e5019630674bacab5170b319 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 18:22:15 +0000
Subject: [PATCH 0996/1478] Introduce convenience ctor for Key construction
 during read

---
 src/Interpreters/Cache/QueryCache.cpp | 5 +++++
 src/Interpreters/Cache/QueryCache.h   | 4 ++++
 src/Interpreters/executeQuery.cpp     | 6 +-----
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/QueryCache.cpp b/src/Interpreters/Cache/QueryCache.cpp
index 1afb538c01d..e2cf5a7d6dd 100644
--- a/src/Interpreters/Cache/QueryCache.cpp
+++ b/src/Interpreters/Cache/QueryCache.cpp
@@ -132,6 +132,11 @@ QueryCache::Key::Key(
 {
 }
 
+QueryCache::Key::Key(ASTPtr ast_, const String & user_name_)
+    : QueryCache::Key(ast_, {}, user_name_, false, std::chrono::system_clock::from_time_t(1), false) /// dummy values for everything != AST or user name
+{
+}
+
 bool QueryCache::Key::operator==(const Key & other) const
 {
     return ast->getTreeHash() == other.ast->getTreeHash();
diff --git a/src/Interpreters/Cache/QueryCache.h b/src/Interpreters/Cache/QueryCache.h
index 4bc33e36441..6ef7cc60918 100644
--- a/src/Interpreters/Cache/QueryCache.h
+++ b/src/Interpreters/Cache/QueryCache.h
@@ -58,12 +58,16 @@ public:
         /// (we could theoretically apply compression also to the totals and extremes but it's an obscure use case)
         const bool is_compressed;
 
+        /// Ctor to construct a Key for writing into query cache.
         Key(ASTPtr ast_,
             Block header_,
             const String & user_name_, bool is_shared_,
             std::chrono::time_point<std::chrono::system_clock> expires_at_,
             bool is_compressed);
 
+        /// Ctor to construct a Key for reading from query cache (this operation only needs the AST + user name).
+        Key(ASTPtr ast_, const String & user_name_);
+
         bool operator==(const Key & other) const;
         String queryStringFromAst() const;
     };
diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index 5cf86412c3e..b45ccf63be6 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -733,11 +733,7 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                     && (can_use_query_cache && settings.enable_reads_from_query_cache)
                     && res.pipeline.pulling())
                 {
-                    QueryCache::Key key(
-                        ast, /*dummy for header*/ {},
-                        context->getUserName(), /*dummy for is_shared*/ false,
-                        /*dummy value for expires_at*/ std::chrono::system_clock::from_time_t(1),
-                        /*dummy value for is_compressed*/ false);
+                    QueryCache::Key key(ast, context->getUserName());
                     QueryCache::Reader reader = query_cache->createReader(key);
                     if (reader.hasCacheEntryForKey())
                     {

From 24717ed908688402d023b933f8b635f3439870fb Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 18:24:20 +0000
Subject: [PATCH 0997/1478] Factorize check if query cache exists

---
 src/Interpreters/executeQuery.cpp | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index b45ccf63be6..cb68cacebda 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -645,7 +645,8 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
             }
         }
 
-        bool can_use_query_cache = settings.use_query_cache && !internal && !ast->as<ASTExplainQuery>();
+        QueryCachePtr query_cache = context->getQueryCache();
+        const bool can_use_query_cache = query_cache != nullptr && settings.use_query_cache && !internal && !ast->as<ASTExplainQuery>();
 
         if (!async_insert)
         {
@@ -727,10 +728,8 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                 /// - passive (read) use of the query cache is enabled, and
                 /// - the query cache knows the query result
                 /// then replace the pipeline by a new pipeline with a single source that is populated from the query cache
-                auto query_cache = context->getQueryCache();
                 bool read_result_from_query_cache = false; /// a query must not read from *and* write to the query cache at the same time
-                if (query_cache != nullptr
-                    && (can_use_query_cache && settings.enable_reads_from_query_cache)
+                if (can_use_query_cache && settings.enable_reads_from_query_cache
                     && res.pipeline.pulling())
                 {
                     QueryCache::Key key(ast, context->getUserName());
@@ -749,7 +748,6 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                 /// - active (write) use of the query cache is enabled
                 /// then add a processor on top of the pipeline which stores the result in the query cache.
                 if (!read_result_from_query_cache
-                    && query_cache != nullptr
                     && can_use_query_cache && settings.enable_writes_to_query_cache
                     && res.pipeline.pulling()
                     && (!astContainsNonDeterministicFunctions(ast, context) || settings.query_cache_store_results_of_queries_with_nondeterministic_functions))
@@ -927,6 +925,7 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                                     context,
                                     ast,
                                     my_can_use_query_cache = can_use_query_cache,
+                                    query_cache = query_cache,
                                     enable_writes_to_query_cache = settings.enable_writes_to_query_cache,
                                     query_cache_store_results_of_queries_with_nondeterministic_functions = settings.query_cache_store_results_of_queries_with_nondeterministic_functions,
                                     log_queries,
@@ -941,9 +940,7 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
             {
                 /// If active (write) use of the query cache is enabled and the query is eligible for result caching, then store the query
                 /// result buffered in the special-purpose cache processor (added on top of the pipeline) into the cache.
-                auto query_cache = context->getQueryCache();
-                if (query_cache != nullptr
-                    && pulling_pipeline
+                if (pulling_pipeline
                     && my_can_use_query_cache && enable_writes_to_query_cache
                     && (!astContainsNonDeterministicFunctions(ast, context) || query_cache_store_results_of_queries_with_nondeterministic_functions))
                 {

From 5311ebe1d295939bfd576e39cb31734e0f4f42d1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 20:12:51 +0000
Subject: [PATCH 0998/1478] Make query cache work effective with nested
 queries.

---
 src/Interpreters/executeQuery.cpp             | 227 +++++++++---------
 .../System/StorageSystemQueryCache.cpp        |   2 +-
 ...494_query_cache_nested_query_bug.reference |   2 +
 .../02494_query_cache_nested_query_bug.sh     |  22 ++
 4 files changed, 135 insertions(+), 118 deletions(-)
 create mode 100644 tests/queries/0_stateless/02494_query_cache_nested_query_bug.reference
 create mode 100755 tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index cb68cacebda..c52dab722c9 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -646,91 +646,16 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
         }
 
         QueryCachePtr query_cache = context->getQueryCache();
-        const bool can_use_query_cache = query_cache != nullptr && settings.use_query_cache && !internal && !ast->as<ASTExplainQuery>();
+        const bool can_use_query_cache = query_cache != nullptr && settings.use_query_cache && !internal && (ast->as<ASTSelectQuery>() || ast->as<ASTSelectWithUnionQuery>());
+        bool write_into_query_cache = false;
 
         if (!async_insert)
         {
-            /// We need to start the (implicit) transaction before getting the interpreter as this will get links to the latest snapshots
-            if (!context->getCurrentTransaction() && settings.implicit_transaction && !ast->as<ASTTransactionControl>())
+            /// If it is a non-internal SELECT, and passive/read use of the query cache is enabled, and the cache knows the query, then set
+            /// a pipeline with a source populated by the query cache.
+            auto get_result_from_query_cache = [&]()
             {
-                try
-                {
-                    if (context->isGlobalContext())
-                        throw Exception(ErrorCodes::LOGICAL_ERROR, "Global context cannot create transactions");
-
-                    execute_implicit_tcl_query(context, ASTTransactionControl::BEGIN);
-                }
-                catch (Exception & e)
-                {
-                    e.addMessage("while starting a transaction with 'implicit_transaction'");
-                    throw;
-                }
-            }
-
-            interpreter = InterpreterFactory::get(ast, context, SelectQueryOptions(stage).setInternal(internal));
-
-            const auto & query_settings = context->getSettingsRef();
-            if (context->getCurrentTransaction() && query_settings.throw_on_unsupported_query_inside_transaction)
-            {
-                if (!interpreter->supportsTransactions())
-                    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Transactions are not supported for this type of query ({})", ast->getID());
-
-            }
-
-            if (!interpreter->ignoreQuota() && !quota_checked)
-            {
-                quota = context->getQuota();
-                if (quota)
-                {
-                    if (ast->as<ASTSelectQuery>() || ast->as<ASTSelectWithUnionQuery>())
-                    {
-                        quota->used(QuotaType::QUERY_SELECTS, 1);
-                    }
-                    else if (ast->as<ASTInsertQuery>())
-                    {
-                        quota->used(QuotaType::QUERY_INSERTS, 1);
-                    }
-                    quota->used(QuotaType::QUERIES, 1);
-                    quota->checkExceeded(QuotaType::ERRORS);
-                }
-            }
-
-            if (!interpreter->ignoreLimits())
-            {
-                limits.mode = LimitsMode::LIMITS_CURRENT;
-                limits.size_limits = SizeLimits(settings.max_result_rows, settings.max_result_bytes, settings.result_overflow_mode);
-            }
-
-            if (auto * insert_interpreter = typeid_cast<InterpreterInsertQuery *>(&*interpreter))
-            {
-                /// Save insertion table (not table function). TODO: support remote() table function.
-                auto table_id = insert_interpreter->getDatabaseTable();
-                if (!table_id.empty())
-                    context->setInsertionTable(std::move(table_id));
-
-                if (insert_data_buffer_holder)
-                    insert_interpreter->addBuffer(std::move(insert_data_buffer_holder));
-            }
-
-            {
-                std::unique_ptr<OpenTelemetry::SpanHolder> span;
-                if (OpenTelemetry::CurrentContext().isTraceEnabled())
-                {
-                    auto * raw_interpreter_ptr = interpreter.get();
-                    String class_name(demangle(typeid(*raw_interpreter_ptr).name()));
-                    span = std::make_unique<OpenTelemetry::SpanHolder>(class_name + "::execute()");
-                }
-
-                res = interpreter->execute();
-
-                /// If
-                /// - it is a SELECT query,
-                /// - passive (read) use of the query cache is enabled, and
-                /// - the query cache knows the query result
-                /// then replace the pipeline by a new pipeline with a single source that is populated from the query cache
-                bool read_result_from_query_cache = false; /// a query must not read from *and* write to the query cache at the same time
-                if (can_use_query_cache && settings.enable_reads_from_query_cache
-                    && res.pipeline.pulling())
+                if (can_use_query_cache && settings.enable_reads_from_query_cache)
                 {
                     QueryCache::Key key(ast, context->getUserName());
                     QueryCache::Reader reader = query_cache->createReader(key);
@@ -739,39 +664,114 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                         QueryPipeline pipeline;
                         pipeline.readFromQueryCache(reader.getSource(), reader.getSourceTotals(), reader.getSourceExtremes());
                         res.pipeline = std::move(pipeline);
-                        read_result_from_query_cache = true;
+                        return true;
                     }
                 }
+                return false;
+            };
 
-                /// If
-                /// - it is a SELECT query, and
-                /// - active (write) use of the query cache is enabled
-                /// then add a processor on top of the pipeline which stores the result in the query cache.
-                if (!read_result_from_query_cache
-                    && can_use_query_cache && settings.enable_writes_to_query_cache
-                    && res.pipeline.pulling()
-                    && (!astContainsNonDeterministicFunctions(ast, context) || settings.query_cache_store_results_of_queries_with_nondeterministic_functions))
+            if (!get_result_from_query_cache())
+            {
+                /// We need to start the (implicit) transaction before getting the interpreter as this will get links to the latest snapshots
+                if (!context->getCurrentTransaction() && settings.implicit_transaction && !ast->as<ASTTransactionControl>())
                 {
-                    QueryCache::Key key(
-                        ast, res.pipeline.getHeader(),
-                        context->getUserName(), settings.query_cache_share_between_users,
-                        std::chrono::system_clock::now() + std::chrono::seconds(settings.query_cache_ttl),
-                        settings.query_cache_compress_entries);
-
-                    const size_t num_query_runs = query_cache->recordQueryRun(key);
-                    if (num_query_runs > settings.query_cache_min_query_runs)
+                    try
                     {
-                        auto query_cache_writer = std::make_shared<QueryCache::Writer>(query_cache->createWriter(
-                                         key,
-                                         std::chrono::milliseconds(settings.query_cache_min_query_duration.totalMilliseconds()),
-                                         settings.query_cache_squash_partial_results,
-                                         settings.max_block_size,
-                                         settings.query_cache_max_size_in_bytes,
-                                         settings.query_cache_max_entries));
-                        res.pipeline.writeResultIntoQueryCache(query_cache_writer);
+                        if (context->isGlobalContext())
+                            throw Exception(ErrorCodes::LOGICAL_ERROR, "Global context cannot create transactions");
+
+                        execute_implicit_tcl_query(context, ASTTransactionControl::BEGIN);
+                    }
+                    catch (Exception & e)
+                    {
+                        e.addMessage("while starting a transaction with 'implicit_transaction'");
+                        throw;
                     }
                 }
 
+                interpreter = InterpreterFactory::get(ast, context, SelectQueryOptions(stage).setInternal(internal));
+
+                const auto & query_settings = context->getSettingsRef();
+                if (context->getCurrentTransaction() && query_settings.throw_on_unsupported_query_inside_transaction)
+                {
+                    if (!interpreter->supportsTransactions())
+                        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Transactions are not supported for this type of query ({})", ast->getID());
+
+                }
+
+                if (!interpreter->ignoreQuota() && !quota_checked)
+                {
+                    quota = context->getQuota();
+                    if (quota)
+                    {
+                        if (ast->as<ASTSelectQuery>() || ast->as<ASTSelectWithUnionQuery>())
+                        {
+                            quota->used(QuotaType::QUERY_SELECTS, 1);
+                        }
+                        else if (ast->as<ASTInsertQuery>())
+                        {
+                            quota->used(QuotaType::QUERY_INSERTS, 1);
+                        }
+                        quota->used(QuotaType::QUERIES, 1);
+                        quota->checkExceeded(QuotaType::ERRORS);
+                    }
+                }
+
+                if (!interpreter->ignoreLimits())
+                {
+                    limits.mode = LimitsMode::LIMITS_CURRENT;
+                    limits.size_limits = SizeLimits(settings.max_result_rows, settings.max_result_bytes, settings.result_overflow_mode);
+                }
+
+                if (auto * insert_interpreter = typeid_cast<InterpreterInsertQuery *>(&*interpreter))
+                {
+                    /// Save insertion table (not table function). TODO: support remote() table function.
+                    auto table_id = insert_interpreter->getDatabaseTable();
+                    if (!table_id.empty())
+                        context->setInsertionTable(std::move(table_id));
+
+                    if (insert_data_buffer_holder)
+                        insert_interpreter->addBuffer(std::move(insert_data_buffer_holder));
+                }
+
+                {
+                    std::unique_ptr<OpenTelemetry::SpanHolder> span;
+                    if (OpenTelemetry::CurrentContext().isTraceEnabled())
+                    {
+                        auto * raw_interpreter_ptr = interpreter.get();
+                        String class_name(demangle(typeid(*raw_interpreter_ptr).name()));
+                        span = std::make_unique<OpenTelemetry::SpanHolder>(class_name + "::execute()");
+                    }
+
+                    res = interpreter->execute();
+
+                    /// If it is a non-internal SELECT query, and active/write use of the query cache is enabled, then add a processor on
+                    /// top of the pipeline which stores the result in the query cache.
+                    if (can_use_query_cache && settings.enable_writes_to_query_cache
+                        && (!astContainsNonDeterministicFunctions(ast, context) || settings.query_cache_store_results_of_queries_with_nondeterministic_functions))
+                    {
+                        QueryCache::Key key(
+                            ast, res.pipeline.getHeader(),
+                            context->getUserName(), settings.query_cache_share_between_users,
+                            std::chrono::system_clock::now() + std::chrono::seconds(settings.query_cache_ttl),
+                            settings.query_cache_compress_entries);
+
+                        const size_t num_query_runs = query_cache->recordQueryRun(key);
+                        if (num_query_runs > settings.query_cache_min_query_runs)
+                        {
+                            auto query_cache_writer = std::make_shared<QueryCache::Writer>(query_cache->createWriter(
+                                             key,
+                                             std::chrono::milliseconds(settings.query_cache_min_query_duration.totalMilliseconds()),
+                                             settings.query_cache_squash_partial_results,
+                                             settings.max_block_size,
+                                             settings.query_cache_max_size_in_bytes,
+                                             settings.query_cache_max_entries));
+                            res.pipeline.writeResultIntoQueryCache(query_cache_writer);
+                            write_into_query_cache = true;
+                        }
+                    }
+
+                }
             }
         }
 
@@ -924,10 +924,7 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
             auto finish_callback = [elem,
                                     context,
                                     ast,
-                                    my_can_use_query_cache = can_use_query_cache,
-                                    query_cache = query_cache,
-                                    enable_writes_to_query_cache = settings.enable_writes_to_query_cache,
-                                    query_cache_store_results_of_queries_with_nondeterministic_functions = settings.query_cache_store_results_of_queries_with_nondeterministic_functions,
+                                    write_into_query_cache,
                                     log_queries,
                                     log_queries_min_type = settings.log_queries_min_type,
                                     log_queries_min_query_duration_ms = settings.log_queries_min_query_duration_ms.totalMilliseconds(),
@@ -938,14 +935,10 @@ static std::tuple<ASTPtr, BlockIO> executeQueryImpl(
                                     pulling_pipeline = pipeline.pulling(),
                                     query_span](QueryPipeline & query_pipeline) mutable
             {
-                /// If active (write) use of the query cache is enabled and the query is eligible for result caching, then store the query
-                /// result buffered in the special-purpose cache processor (added on top of the pipeline) into the cache.
-                if (pulling_pipeline
-                    && my_can_use_query_cache && enable_writes_to_query_cache
-                    && (!astContainsNonDeterministicFunctions(ast, context) || query_cache_store_results_of_queries_with_nondeterministic_functions))
-                {
+                if (write_into_query_cache)
+                    /// Trigger the actual write of the buffered query result into the query cache. This is done explicitly to prevent
+                    /// partial/garbage results in case of exceptions during query execution.
                     query_pipeline.finalizeWriteInQueryCache();
-                }
 
                 QueryStatusPtr process_list_elem = context->getProcessListElement();
 
diff --git a/src/Storages/System/StorageSystemQueryCache.cpp b/src/Storages/System/StorageSystemQueryCache.cpp
index 3dfc5cf298a..117fb4e8a5c 100644
--- a/src/Storages/System/StorageSystemQueryCache.cpp
+++ b/src/Storages/System/StorageSystemQueryCache.cpp
@@ -29,7 +29,7 @@ StorageSystemQueryCache::StorageSystemQueryCache(const StorageID & table_id_)
 
 void StorageSystemQueryCache::fillData(MutableColumns & res_columns, ContextPtr context, const SelectQueryInfo &) const
 {
-    auto query_cache = context->getQueryCache();
+    QueryCachePtr query_cache = context->getQueryCache();
 
     if (!query_cache)
         return;
diff --git a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.reference b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.reference
new file mode 100644
index 00000000000..389e2621455
--- /dev/null
+++ b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.reference
@@ -0,0 +1,2 @@
+2
+0
diff --git a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
new file mode 100755
index 00000000000..f6fb15f76eb
--- /dev/null
+++ b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Tags: no-parallel
+# Tag no-parallel: Messes with internal cache
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+# Start with empty query cache (QC).
+${CLICKHOUSE_CLIENT} --query "SYSTEM DROP QUERY CACHE"
+
+${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS tab"
+${CLICKHOUSE_CLIENT} --query "CREATE TABLE tab (a UInt64) ENGINE=MergeTree() ORDER BY a"
+${CLICKHOUSE_CLIENT} --query "INSERT INTO tab VALUES (1) (2) (3)"
+${CLICKHOUSE_CLIENT} --query "INSERT INTO tab VALUES (3) (4) (5)"
+
+# Verify that the first query does two aggregations and the second query zero aggregations. Since query cache is currently not integrated
+# with EXPLAIN PLAN, we need need to check the logs.
+${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1" 2>&1 | grep "Aggregated. " | wc -l
+${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1" 2>&1 | grep "Aggregated. " | wc -l
+
+${CLICKHOUSE_CLIENT} --query "SYSTEM DROP QUERY CACHE"

From b5b67f809495d4dc71f7bfbffccc41dd828c2f7a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 17 Jun 2023 21:11:09 +0000
Subject: [PATCH 0999/1478] Exclude fasttest

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

diff --git a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
index f6fb15f76eb..f451e9b0709 100755
--- a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
+++ b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-parallel
+# Tags: no-parallel, no-fasttest
 # Tag no-parallel: Messes with internal cache
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)

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 1000/1478] 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 1001/1478] 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 1002/1478] 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 1003/1478] 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 1004/1478] 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 1005/1478] 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 1006/1478] 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 1007/1478] 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 1008/1478] 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 1009/1478] 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 1010/1478] 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 1011/1478] 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 1012/1478] 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 1013/1478] 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 1014/1478] 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 1015/1478] 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 1016/1478] 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 1017/1478] 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 1018/1478] 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 880c9aea09d737489e274c6ff05f12c5ab072c63 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Mon, 19 Jun 2023 10:47:43 +0000
Subject: [PATCH 1019/1478] Fixing style.

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

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index c79b667789b..3c5e930a6cf 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -2,19 +2,17 @@
 #include <variant>
 #include <Interpreters/PreparedSets.h>
 #include <Interpreters/Set.h>
-#include <Processors/QueryPlan/QueryPlan.h>
 #include <Interpreters/InterpreterSelectWithUnionQuery.h>
-#include <Interpreters/Set.h>
 #include <IO/Operators.h>
-#include "Common/logger_useful.h"
-#include "Processors/QueryPlan/CreatingSetsStep.h"
-#include "Processors/Executors/CompletedPipelineExecutor.h"
-#include "Processors/QueryPlan/BuildQueryPipelineSettings.h"
-#include "Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h"
-#include "Processors/Sinks/EmptySink.h"
-#include "Processors/Sinks/NullSink.h"
+#include <Common/logger_useful.h>
+#include <Processors/QueryPlan/CreatingSetsStep.h>
+#include <Processors/Executors/CompletedPipelineExecutor.h>
+#include <Processors/QueryPlan/BuildQueryPipelineSettings.h>
+#include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
+#include <Processors/Sinks/EmptySink.h>
+#include <Processors/Sinks/NullSink.h>
 #include <Processors/QueryPlan/QueryPlan.h>
-#include "Core/Block.h"
+#include <Core/Block.h>
 #include <QueryPipeline/QueryPipelineBuilder.h>
 #include <DataTypes/DataTypeLowCardinality.h>
 #include <QueryPipeline/SizeLimits.h>

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 1020/1478] 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 1021/1478] 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 1022/1478] 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 1023/1478] 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 f3398f9908214f8d5ab06c5c625f2cf9f006364b Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Mon, 19 Jun 2023 12:17:52 +0000
Subject: [PATCH 1024/1478] Try to make more consisten type check for sets.

---
 src/Storages/MergeTree/RPNBuilder.cpp | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index 1acc3ec6ce9..d7dd7ff3654 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -384,8 +384,11 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
         if (node_without_alias->column)
         {
             auto future_set = tryGetSetFromDAGNode(node_without_alias);
+            if (const auto * from_subquery = typeid_cast<const FutureSetFromSubquery *>(future_set.get()))
+                return future_set;
+
             auto set_types = future_set->getTypes();
-            if (types_match(future_set->getTypes()))
+            if (types_match(set_types))
                 return future_set;
         }
     }

From 8e7d06e0a4211de261a3aa9ef48561df30802403 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Mon, 19 Jun 2023 12:56:24 +0000
Subject: [PATCH 1025/1478] Remove isReady from FutureSet iface.

---
 src/Functions/in.cpp                          |  8 ++------
 src/Interpreters/ExpressionActions.cpp        | 11 ++++-------
 src/Interpreters/PreparedSets.cpp             | 11 +++++++----
 src/Interpreters/PreparedSets.h               |  6 +-----
 src/Planner/PlannerActionsVisitor.cpp         |  2 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  4 ++--
 src/Storages/MergeTree/RPNBuilder.cpp         |  6 +-----
 src/Storages/VirtualColumnUtils.cpp           |  2 +-
 8 files changed, 19 insertions(+), 31 deletions(-)

diff --git a/src/Functions/in.cpp b/src/Functions/in.cpp
index 0e576b92aad..c19d1e72003 100644
--- a/src/Functions/in.cpp
+++ b/src/Functions/in.cpp
@@ -123,14 +123,10 @@ public:
         }
 
         auto future_set = column_set->getData();
-        if (!future_set || !future_set->isReady())
+        auto set = future_set ? future_set->get() : nullptr;
+        if (!future_set || !set)
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Not-ready Set passed as the second argument for function '{}'", getName());
 
-        // if (auto * for_tuple = typeid_cast<FutureSetFromTuple *>(future_set.get()))
-        //     if (!for_tuple->isReady())
-        //         for_tuple->buildForTuple(size_limits, transform_null_in);
-
-        auto set = future_set->get();
         auto set_types = set->getDataTypes();
 
         if (tuple && set_types.size() != 1 && set_types.size() == tuple->tupleSize())
diff --git a/src/Interpreters/ExpressionActions.cpp b/src/Interpreters/ExpressionActions.cpp
index 989fa12cba0..f1c577948eb 100644
--- a/src/Interpreters/ExpressionActions.cpp
+++ b/src/Interpreters/ExpressionActions.cpp
@@ -936,15 +936,12 @@ bool ExpressionActions::checkColumnIsAlwaysFalse(const String & column_name) con
         for (const auto & action : actions)
         {
             if (action.node->type == ActionsDAG::ActionType::COLUMN && action.node->result_name == set_to_check)
-            {
                 // Constant ColumnSet cannot be empty, so we only need to check non-constant ones.
                 if (const auto * column_set = checkAndGetColumn<const ColumnSet>(action.node->column.get()))
-                {
-                    auto set = column_set->getData();
-                    if (set && set->isReady() && set->get()->getTotalRowCount() == 0)
-                        return true;
-                }
-            }
+                    if (auto future_set = column_set->getData())
+                        if (auto set = future_set->get())
+                            if (set->getTotalRowCount() == 0)
+                                return true;
         }
     }
 
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 3c5e930a6cf..95cfa57857b 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -30,9 +30,7 @@ class FutureSetFromTuple final : public FutureSet
 public:
     FutureSetFromTuple(Block block, const Settings & settings);
 
-    bool isReady() const override { return true; }
     SetPtr get() const override { return set; }
-
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
     DataTypes getTypes() const override { return set->getElementsTypes(); }
@@ -44,7 +42,6 @@ private:
 
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
-bool FutureSetFromStorage::isReady() const { return set != nullptr; }
 SetPtr FutureSetFromStorage::get() const { return set; }
 DataTypes FutureSetFromStorage::getTypes() const { return set->getElementsTypes(); }
 
@@ -297,7 +294,13 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     return subquery.set;
 }
 
-bool FutureSetFromSubquery::isReady() const { return subquery.set != nullptr && subquery.set->isCreated(); }
+SetPtr FutureSetFromSubquery::get() const
+{
+    if (subquery.set != nullptr && subquery.set->isCreated())
+        return subquery.set;
+
+    return nullptr;
+}
 
 std::unique_ptr<QueryPlan> FutureSetFromSubquery::build(const ContextPtr & context)
 {
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index f034aca747f..1e04bbbe3e8 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -34,9 +34,7 @@ class FutureSet
 public:
     virtual ~FutureSet() = default;
 
-    virtual bool isReady() const = 0;
     virtual SetPtr get() const = 0;
-
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
 
     virtual DataTypes getTypes() const = 0;
@@ -50,7 +48,6 @@ class FutureSetFromStorage : public FutureSet
 public:
     FutureSetFromStorage(SetPtr set_);
 
-    bool isReady() const override;
     SetPtr get() const override;
     SetPtr buildOrderedSetInplace(const ContextPtr &) override;
     DataTypes getTypes() const override;
@@ -91,8 +88,7 @@ class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_t
 public:
     FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_);
 
-    bool isReady() const override;
-    SetPtr get() const override { return subquery.set; }
+    SetPtr get() const override;
 
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index 087cd3000b9..49312e5c4ad 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -664,7 +664,7 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
     column.name = planner_context->createSetKey(in_second_argument);
     column.type = std::make_shared<DataTypeSet>();
 
-    bool set_is_created = set->isReady();
+    bool set_is_created = set->get() != nullptr;
     auto column_set = ColumnSet::create(1, std::move(set));
 
     if (set_is_created)
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index da27e7b1293..751a1f95b7b 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -137,7 +137,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets
 
     for (auto & [description, future_set] : subqueries_for_sets)
     {
-        if (future_set->isReady())
+        if (future_set->get())
             continue;
 
         auto plan = future_set->build(context);
@@ -172,7 +172,7 @@ std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSet
 
     for (auto & [description, future_set] : step.subqueries_for_sets)
     {
-        if (future_set->isReady())
+        if (future_set->get())
             continue;
 
         auto plan = future_set->build(step.context);
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index d7dd7ff3654..ad3fb984ce7 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -384,11 +384,7 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
         if (node_without_alias->column)
         {
             auto future_set = tryGetSetFromDAGNode(node_without_alias);
-            if (const auto * from_subquery = typeid_cast<const FutureSetFromSubquery *>(future_set.get()))
-                return future_set;
-
-            auto set_types = future_set->getTypes();
-            if (types_match(set_types))
+            if (types_match(future_set->getTypes()))
                 return future_set;
         }
     }
diff --git a/src/Storages/VirtualColumnUtils.cpp b/src/Storages/VirtualColumnUtils.cpp
index 58d00216dc7..b83afe766aa 100644
--- a/src/Storages/VirtualColumnUtils.cpp
+++ b/src/Storages/VirtualColumnUtils.cpp
@@ -222,7 +222,7 @@ void filterBlockWithQuery(const ASTPtr & query, Block & block, ContextPtr contex
             if (column_set)
             {
                 auto future_set = column_set->getData();
-                if (!future_set->isReady())
+                if (!future_set->get())
                 {
                     if (auto * set_from_subquery = typeid_cast<FutureSetFromSubquery *>(future_set.get()))
                     {

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 1026/1478] 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 1027/1478] 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 1028/1478] 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 1029/1478] 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 1030/1478] 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 1031/1478] 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 1032/1478] 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 1033/1478] 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 1034/1478] 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 1035/1478] 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 1036/1478] 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 1037/1478] 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 1038/1478] 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 1039/1478] 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 1040/1478] 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 1041/1478] 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 1042/1478] 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 1043/1478] 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 1044/1478] 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 1045/1478] 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 1046/1478] 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 1047/1478] 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 7280078bc6198647e8e695b8658beadc0e864ce2 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Mon, 19 Jun 2023 19:01:56 +0000
Subject: [PATCH 1048/1478] Refactoring a bit more.

---
 src/Interpreters/ActionsVisitor.cpp           |  15 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |   4 +-
 src/Interpreters/PreparedSets.cpp             | 208 ++++++++++++------
 src/Interpreters/PreparedSets.h               |  91 ++++----
 src/Interpreters/Set.h                        |   2 +
 src/Planner/CollectSets.cpp                   |  11 +-
 src/Planner/Planner.cpp                       |   8 +-
 src/Planner/PlannerActionsVisitor.cpp         |   7 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  10 +-
 src/Processors/QueryPlan/CreatingSetsStep.h   |   8 +-
 .../Optimizations/filterPushDown.cpp          |   2 +-
 .../Transforms/CreatingSetsTransform.cpp      |  10 +-
 src/Storages/KVStorageUtils.cpp               |  13 +-
 src/Storages/MergeTree/RPNBuilder.cpp         |  30 +--
 14 files changed, 248 insertions(+), 171 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 4b38f8c9434..91c490f8a4c 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -449,8 +449,8 @@ FutureSetPtr makeExplicitSet(
         if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
             element_type = low_cardinality_type->getDictionaryType();
 
-    auto set_key = PreparedSetKey::forLiteral(right_arg->getTreeHash(), set_element_types);
-    if (auto set = prepared_sets.getFuture(set_key))
+    auto set_key = right_arg->getTreeHash();
+    if (auto set = prepared_sets.find(set_key, set_element_types))
         return set; /// Already prepared.
 
     Block block;
@@ -1397,18 +1397,17 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             return {};
         //std::cerr << queryToString(right_in_operand) << std::endl;
 
-        PreparedSetKey set_key;
+        PreparedSets::Hash set_key;
         if (data.getContext()->getSettingsRef().allow_experimental_analyzer && !identifier)
         {
             InterpreterSelectQueryAnalyzer interpreter(right_in_operand, data.getContext(), SelectQueryOptions().analyze(true).subquery());
             auto query_tree = interpreter.getQueryTree();
             if (auto * query_node = query_tree->as<QueryNode>())
                 query_node->setIsSubquery(true);
-            // std::cerr << "============== " << interpreter.getQueryTree()->dumpTree() << std::endl;
-            set_key = PreparedSetKey::forSubquery(query_tree->getTreeHash());
+            set_key = query_tree->getTreeHash();
         }
         else
-            set_key = PreparedSetKey::forSubquery(right_in_operand->getTreeHash());
+            set_key = right_in_operand->getTreeHash();
 
         // std::cerr << set_key.toString() << std::endl;
         // std::cerr << data.prepared_sets->getSets().size() << std::endl;
@@ -1416,7 +1415,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         // for (const auto & [k, v] : data.prepared_sets->getSets())
         //     std::cerr << "... " << k.toString();
 
-        if (auto set = data.prepared_sets->getFuture(set_key))
+        if (auto set = data.prepared_sets->findSubquery(set_key))
             return set;
 
         FutureSetPtr external_table_set;
@@ -1449,7 +1448,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         // String set_id = right_in_operand->getColumnName();
         //bool transform_null_in =  data.getContext()->getSettingsRef().transform_null_in;
         SubqueryForSet subquery_for_set; // = data.prepared_sets->createOrGetSubquery(set_id, set_key, data.set_size_limit, transform_null_in);
-        subquery_for_set.key = set_key.toString(); //right_in_operand->getColumnName();
+        subquery_for_set.key = PreparedSets::toString(set_key, {}); //right_in_operand->getColumnName();
 
         /** The following happens for GLOBAL INs or INs:
           * - in the addExternalStorage function, the IN (SELECT ...) subquery is replaced with IN _data1,
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 678258489f4..5b8f0c60d35 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -189,11 +189,11 @@ public:
                 // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
                 // subquery_for_set.createSource(*interpreter, external_storage);
                 auto key = subquery_or_table_name->getColumnName();
-                auto set_key = PreparedSetKey::forSubquery(database_and_table_name->getTreeHash());
+                auto set_key = database_and_table_name->getTreeHash();
 
                 // std::cerr << "====== Adding key " << set_key.toString() << std::endl;
 
-                if (!prepared_sets->getFuture(set_key))
+                if (!prepared_sets->findSubquery(set_key))
                 {
                     SubqueryForSet subquery_for_set;
                     subquery_for_set.key = std::move(key);
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 95cfa57857b..f74fe86acce 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -33,7 +33,7 @@ public:
     SetPtr get() const override { return set; }
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
-    DataTypes getTypes() const override { return set->getElementsTypes(); }
+    const DataTypes & getTypes() const override { return set->getElementsTypes(); }
 
 private:
     SetPtr set;
@@ -43,7 +43,7 @@ private:
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
 SetPtr FutureSetFromStorage::get() const { return set; }
-DataTypes FutureSetFromStorage::getTypes() const { return set->getElementsTypes(); }
+const DataTypes & FutureSetFromStorage::getTypes() const { return set->getElementsTypes(); }
 
 SetPtr FutureSetFromStorage::buildOrderedSetInplace(const ContextPtr &)
 {
@@ -51,47 +51,47 @@ SetPtr FutureSetFromStorage::buildOrderedSetInplace(const ContextPtr &)
 }
 
 
-PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
-{
-    /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
-    ///   just converts LowCardinality to ordinary types.
-    for (auto & type : types_)
-        type = recursiveRemoveLowCardinality(type);
+// PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
+// {
+//     /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
+//     ///   just converts LowCardinality to ordinary types.
+//     for (auto & type : types_)
+//         type = recursiveRemoveLowCardinality(type);
 
-    PreparedSetKey key;
-    key.ast_hash = hash;
-    key.types = std::move(types_);
-    return key;
-}
+//     PreparedSetKey key;
+//     key.ast_hash = hash;
+//     key.types = std::move(types_);
+//     return key;
+// }
 
-PreparedSetKey PreparedSetKey::forSubquery(Hash hash)
-{
-    PreparedSetKey key;
-    key.ast_hash = hash;
-    return key;
-}
+// PreparedSetKey PreparedSetKey::forSubquery(Hash hash)
+// {
+//     PreparedSetKey key;
+//     key.ast_hash = hash;
+//     return key;
+// }
 
-bool PreparedSetKey::operator==(const PreparedSetKey & other) const
-{
-    if (ast_hash != other.ast_hash)
-        return false;
+// bool PreparedSetKey::operator==(const PreparedSetKey & other) const
+// {
+//     if (ast_hash != other.ast_hash)
+//         return false;
 
-    if (types.size() != other.types.size())
-        return false;
+//     if (types.size() != other.types.size())
+//         return false;
 
-    for (size_t i = 0; i < types.size(); ++i)
-    {
-        if (!types[i]->equals(*other.types[i]))
-            return false;
-    }
+//     for (size_t i = 0; i < types.size(); ++i)
+//     {
+//         if (!types[i]->equals(*other.types[i]))
+//             return false;
+//     }
 
-    return true;
-}
+//     return true;
+// }
 
-String PreparedSetKey::toString() const
+String PreparedSets::toString(const PreparedSets::Hash & hash, const DataTypes & types)
 {
     WriteBufferFromOwnString buf;
-    buf << "__set_" << ast_hash.first << "_" << ast_hash.second;
+    buf << "__set_" << hash.first << "_" << hash.second;
     if (!types.empty())
     {
         buf << "(";
@@ -143,54 +143,104 @@ String PreparedSetKey::toString() const
 
 //     it->second->addStorage(std::move(storage));
 // }
+static bool equals(const DataTypes & lhs, const DataTypes & rhs)
+{
+    size_t size = lhs.size();
+    if (size != rhs.size())
+        return false;
 
-FutureSetPtr PreparedSets::addFromStorage(const PreparedSetKey & key, SetPtr set_)
+    for (size_t i = 0; i < size; ++i)
+    {
+        if (!lhs[i]->equals(*rhs[i]))
+            return false;
+    }
+
+    return true;
+}
+
+static bool tryInsertSet(std::vector<std::shared_ptr<FutureSet>> & sets, FutureSetPtr new_set)
+{
+    auto types = new_set->getTypes();
+    for (const auto & set : sets)
+        if (equals(set->getTypes(), new_set->getTypes()))
+            return false;
+
+    sets.push_back(std::move(new_set));
+    return true;
+}
+
+static FutureSetPtr findSet(const std::vector<std::shared_ptr<FutureSet>> & sets, const DataTypes & types)
+{
+    for (const auto & set : sets)
+        if (equals(set->getTypes(), types))
+            return set;
+
+    return nullptr;
+}
+
+FutureSetPtr PreparedSets::addFromStorage(const Hash & key, SetPtr set_)
 {
     auto from_storage = std::make_shared<FutureSetFromStorage>(std::move(set_));
-    auto [it, inserted] = sets.emplace(key, std::move(from_storage));
+    auto & sets_by_hash = sets[key];
 
-    if (!inserted)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+    if (!tryInsertSet(sets_by_hash, from_storage))
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_storage->getTypes()));
 
-    return it->second;
+    return from_storage;
 }
 
-FutureSetPtr PreparedSets::addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings)
+FutureSetPtr PreparedSets::addFromTuple(const Hash & key, Block block, const Settings & settings)
 {
     auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block), settings);
-    auto [it, inserted] = sets.emplace(key, std::move(from_tuple));
+    auto & sets_by_hash = sets[key];
 
-    if (!inserted)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+    if (!tryInsertSet(sets_by_hash, from_tuple))
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_tuple->getTypes()));
 
-    return it->second;
+    return from_tuple;
 }
 
-FutureSetPtr PreparedSets::addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set)
+FutureSetPtr PreparedSets::addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set)
 {
-    auto id = subquery.key;
-    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set), settings.transform_null_in);
-    auto [it, inserted] = sets.emplace(key, from_subquery);
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set), settings);
+    auto [it, inserted] = sets_from_subqueries.emplace(key, from_subquery);
 
     if (!inserted)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", key.toString());
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, {}));
 
     // std::cerr << key.toString() << std::endl;
     // std::cerr << "========= PreparedSets::addFromSubquery\n";
     // std::cerr << StackTrace().toString() << std::endl;
 
-    subqueries.emplace_back(SetAndName{.name = id, .set = std::move(from_subquery)});
-    return it->second;
+    return from_subquery;
 }
 
-FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
+FutureSetPtr PreparedSets::find(const Hash & key, const DataTypes & types) const
 {
     auto it = sets.find(key);
     if (it == sets.end())
-        return {};
+        return nullptr;
+
+    return findSet(it->second, types);
+}
+
+std::shared_ptr<FutureSetFromSubquery> PreparedSets::findSubquery(const Hash & key) const
+{
+    auto it = sets_from_subqueries.find(key);
+    if (it == sets_from_subqueries.end())
+        return nullptr;
+
     return it->second;
 }
 
+// FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
+// {
+//     auto it = sets.find(key);
+//     if (it == sets.end())
+//         return {};
+//     return it->second;
+// }
+
 // SetPtr PreparedSets::get(const PreparedSetKey & key) const
 // {
 //     auto it = sets.find(key);
@@ -210,10 +260,14 @@ FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 //     return res;
 // }
 
-PreparedSets::SubqueriesForSets PreparedSets::detachSubqueries()
+std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::detachSubqueries()
 {
-    auto res = std::move(subqueries);
-    subqueries = SubqueriesForSets();
+    std::vector<std::shared_ptr<FutureSetFromSubquery>> res;
+    res.reserve(sets_from_subqueries.size());
+    for (auto & [_, set] : sets_from_subqueries)
+        res.push_back(std::move(set));
+
+    sets_from_subqueries.clear();
     return res;
 }
 
@@ -267,10 +321,10 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     if (!context->getSettingsRef().use_index_for_in_with_subqueries)
         return nullptr;
 
-    if (subquery.set)
+    if (auto set = get())
     {
-        if (subquery.set->hasExplicitSetElements())
-            return subquery.set;
+        if (set->hasExplicitSetElements())
+            return set;
 
         return nullptr;
     }
@@ -278,10 +332,11 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     if (external_table_set)
         return subquery.set = external_table_set->buildOrderedSetInplace(context);
 
-    auto plan = buildPlan(context, true);
+    auto plan = buildPlan(context);
     if (!plan)
         return nullptr;
 
+    subquery.set->fillSetElements();
     auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
     auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
     pipeline.complete(std::make_shared<EmptySink>(Block()));
@@ -304,7 +359,7 @@ SetPtr FutureSetFromSubquery::get() const
 
 std::unique_ptr<QueryPlan> FutureSetFromSubquery::build(const ContextPtr & context)
 {
-    return buildPlan(context, false);
+    return buildPlan(context);
 }
 
 static SizeLimits getSizeLimitsForSet(const Settings & settings)
@@ -312,15 +367,12 @@ static SizeLimits getSizeLimitsForSet(const Settings & settings)
     return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
 }
 
-std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context, bool create_ordered_set)
+std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context)
 {
-    if (subquery.set)
+    if (subquery.set->isCreated())
         return nullptr;
 
     const auto & settings = context->getSettingsRef();
-    auto size_limits = getSizeLimitsForSet(settings);
-
-    subquery.set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
 
     auto plan = subquery.detachSource();
     auto description = subquery.key;
@@ -355,15 +407,25 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
     set->finishInsert();
 }
 
-FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_)
-    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_)), transform_null_in(transform_null_in_) {}
-
-DataTypes FutureSetFromSubquery::getTypes() const
+FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, const Settings & settings)
+    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_))
 {
-    if (subquery.set)
-        return subquery.set->getElementsTypes();
+    bool create_ordered_set = false;
+    auto size_limits = getSizeLimitsForSet(settings);
+    subquery.set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+    if (subquery.source)
+        subquery.set->setHeader(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+}
 
-    return Set::getElementTypes(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName(), transform_null_in);
+void FutureSetFromSubquery::setQueryPlan(std::unique_ptr<QueryPlan> source)
+{
+    subquery.source = std::move(source);
+    subquery.set->setHeader(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+}
+
+const DataTypes & FutureSetFromSubquery::getTypes() const
+{
+    return subquery.set->getElementsTypes();
 }
 
 SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 1e04bbbe3e8..67f8a65ca17 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -37,7 +37,7 @@ public:
     virtual SetPtr get() const = 0;
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
 
-    virtual DataTypes getTypes() const = 0;
+    virtual const DataTypes & getTypes() const = 0;
 };
 
 using FutureSetPtr = std::shared_ptr<FutureSet>;
@@ -50,7 +50,7 @@ public:
 
     SetPtr get() const override;
     SetPtr buildOrderedSetInplace(const ContextPtr &) override;
-    DataTypes getTypes() const override;
+    const DataTypes & getTypes() const override;
 
 private:
     SetPtr set;
@@ -86,7 +86,7 @@ public:
 class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_this<FutureSetFromSubquery>
 {
 public:
-    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, bool transform_null_in_);
+    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, const Settings & settings);
 
     SetPtr get() const override;
 
@@ -94,74 +94,87 @@ public:
 
     std::unique_ptr<QueryPlan> build(const ContextPtr & context);
 
-    DataTypes getTypes() const override;
+    const DataTypes & getTypes() const override;
 
     SubqueryForSet & getSubquery() { return subquery; }
+    void setQueryPlan(std::unique_ptr<QueryPlan> source);
 
 private:
     SubqueryForSet subquery;
     FutureSetPtr external_table_set;
-    bool transform_null_in;
 
-    std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context, bool create_ordered_set);
+    std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context);
 };
 
-struct PreparedSetKey
-{
-    using Hash = std::pair<UInt64, UInt64>;
+// struct PreparedSetKey
+// {
+//     using Hash = std::pair<UInt64, UInt64>;
 
-    /// Prepared sets for tuple literals are indexed by the hash of the tree contents and by the desired
-    /// data types of set elements (two different Sets can be required for two tuples with the same contents
-    /// if left hand sides of the IN operators have different types).
-    static PreparedSetKey forLiteral(Hash hash, DataTypes types_);
+//     /// Prepared sets for tuple literals are indexed by the hash of the tree contents and by the desired
+//     /// data types of set elements (two different Sets can be required for two tuples with the same contents
+//     /// if left hand sides of the IN operators have different types).
+//     static PreparedSetKey forLiteral(Hash hash, DataTypes types_);
 
-    /// Prepared sets for subqueries are indexed only by the AST contents because the type of the resulting
-    /// set is fully determined by the subquery.
-    static PreparedSetKey forSubquery(Hash hash);
+//     /// Prepared sets for subqueries are indexed only by the AST contents because the type of the resulting
+//     /// set is fully determined by the subquery.
+//     static PreparedSetKey forSubquery(Hash hash);
 
-    Hash ast_hash;
-    DataTypes types; /// Empty for subqueries.
+//     Hash ast_hash;
+//     DataTypes types; /// Empty for subqueries.
 
-    bool operator==(const PreparedSetKey & other) const;
+//     bool operator==(const PreparedSetKey & other) const;
 
-    String toString() const;
+//     String toString() const;
 
-    struct Hashing
-    {
-        UInt64 operator()(const PreparedSetKey & key) const { return key.ast_hash.first; }
-    };
-};
+//     struct Hashing
+//     {
+//         UInt64 operator()(const PreparedSetKey & key) const { return key.ast_hash.first; }
+//     };
+// };
 
 class PreparedSets
 {
 public:
-    struct SetAndName
+
+    using Hash = std::pair<UInt64, UInt64>;
+    struct Hashing
     {
-        String name;
-        std::shared_ptr<FutureSetFromSubquery> set;
+        UInt64 operator()(const Hash & key) const { return key.first ^ key.second; }
     };
-    using SubqueriesForSets = std::vector<SetAndName>;
 
-    FutureSetPtr addFromStorage(const PreparedSetKey & key, SetPtr set_);
-    FutureSetPtr addFromTuple(const PreparedSetKey & key, Block block, const Settings & settings);
-    FutureSetPtr addFromSubquery(const PreparedSetKey & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
+    // struct SetAndName
+    // {
+    //     String name;
+    //     std::shared_ptr<FutureSetFromSubquery> set;
+    // };
 
-    FutureSetPtr getFuture(const PreparedSetKey & key) const;
+    using Sets = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSet>>, Hashing>;
+    using SetsFromSubqueries = std::unordered_map<Hash, std::shared_ptr<FutureSetFromSubquery>, Hashing>;
+
+    FutureSetPtr addFromStorage(const Hash & key, SetPtr set_);
+    FutureSetPtr addFromTuple(const Hash & key, Block block, const Settings & settings);
+    FutureSetPtr addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
+
+    FutureSetPtr find(const Hash & key, const DataTypes & types) const;
+    std::shared_ptr<FutureSetFromSubquery> findSubquery(const Hash & key) const;
+
+    //FutureSetPtr getFuture(const PreparedSetKey & key) const;
 
     /// Get subqueries and clear them.
     /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
     /// SetPtr would still be available for consumers of PreparedSets.
-    SubqueriesForSets detachSubqueries();
+    std::vector<std::shared_ptr<FutureSetFromSubquery>> detachSubqueries();
 
-    const std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hashing> & getSets() const { return sets; }
+    const Sets & getNormalSets() const { return sets; }
+    const SetsFromSubqueries & getSetsFromSubquery() const { return sets_from_subqueries; }
 
     bool empty() const;
 
-private:
-    std::unordered_map<PreparedSetKey, FutureSetPtr, PreparedSetKey::Hashing> sets;
+    static String toString(const Hash & key, const DataTypes & types);
 
-    /// This is the information required for building sets
-    SubqueriesForSets subqueries;
+private:
+    Sets sets;
+    SetsFromSubqueries sets_from_subqueries;
 };
 
 using PreparedSetsPtr = std::shared_ptr<PreparedSets>;
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index a6908d2bdd3..df30992dd35 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -47,6 +47,8 @@ public:
     {
     }
 
+    void fillSetElements() { fill_set_elements = true; }
+
     /** Set can be created either from AST or from a stream of data (subquery result).
       */
 
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 84ab453c065..3b9512436ad 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -61,9 +61,8 @@ public:
         if (storage_set)
         {
             /// Handle storage_set as ready set.
-            auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
+            auto set_key = in_second_argument->getTreeHash();
             sets.addFromStorage(set_key, storage_set->getSet());
-            //planner_context.registerSet(set_key, PlannerSet(FutureSet(storage_set->getSet())));
         }
         else if (const auto * constant_node = in_second_argument->as<ConstantNode>())
         {
@@ -82,8 +81,8 @@ public:
                 if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
                     element_type = low_cardinality_type->getDictionaryType();
 
-            auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
-            if (sets.getFuture(set_key))
+            auto set_key = in_second_argument->getTreeHash();
+            if (sets.find(set_key, set_element_types))
                 return;
 
             sets.addFromTuple(set_key, std::move(set), settings);
@@ -94,8 +93,8 @@ public:
             in_second_argument_node_type == QueryTreeNodeType::UNION ||
             in_second_argument_node_type == QueryTreeNodeType::TABLE)
         {
-            auto set_key = PreparedSetKey::forSubquery(in_second_argument->getTreeHash());
-            if (sets.getFuture(set_key))
+            auto set_key = in_second_argument->getTreeHash();
+            if (sets.findSubquery(set_key))
                 return;
 
             auto subquery_to_execute = in_second_argument;
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index 4ac81e28f92..e7c10f6ef7a 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -933,18 +933,18 @@ void addBuildSubqueriesForSetsStepIfNeeded(
     auto subqueries = planner_context->getPreparedSets().detachSubqueries();
     std::unordered_set<const FutureSet *> useful_sets;
 
-    PreparedSets::SubqueriesForSets subqueries_for_sets;
+    //PreparedSets::SubqueriesForSets subqueries_for_sets;
 
     for (const auto & actions_to_execute : result_actions_to_execute)
         collectSetsFromActionsDAG(actions_to_execute, useful_sets);
 
-    auto predicate = [&useful_sets](const auto & set) { return !useful_sets.contains(set.set.get()); };
+    auto predicate = [&useful_sets](const auto & set) { return !useful_sets.contains(set.get()); };
     auto it = std::remove_if(subqueries.begin(), subqueries.end(), std::move(predicate));
     subqueries.erase(it, subqueries.end());
 
     for (auto & subquery : subqueries)
     {
-        auto & subquery_for_set = subquery.set->getSubquery();
+        auto & subquery_for_set = subquery->getSubquery();
         auto subquery_options = select_query_options.subquery();
         Planner subquery_planner(
             subquery_for_set.query_tree,
@@ -952,7 +952,7 @@ void addBuildSubqueriesForSetsStepIfNeeded(
             planner_context->getGlobalPlannerContext());
         subquery_planner.buildQueryPlanIfNeeded();
 
-        subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
+        subquery->setQueryPlan(std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan()));
     }
 
     //addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index 49312e5c4ad..0c84052578c 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -651,14 +651,13 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
                 element_type = low_cardinality_type->getDictionaryType();
     }
 
-    auto set_key = PreparedSetKey::forLiteral(in_second_argument->getTreeHash(), set_element_types);
+    auto set_key = in_second_argument->getTreeHash();
+    auto set = planner_context->getPreparedSets().find(set_key, set_element_types);
 
-
-    auto set = planner_context->getPreparedSets().getFuture(set_key);
     if (!set)
         throw Exception(ErrorCodes::LOGICAL_ERROR,
             "No set is registered for key {}",
-            set_key.toString());
+            PreparedSets::toString(set_key, set_element_types));
 
     ColumnWithTypeAndName column;
     column.name = planner_context->createSetKey(in_second_argument);
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 751a1f95b7b..ab028d967d8 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -126,7 +126,7 @@ void CreatingSetsStep::describePipeline(FormatSettings & settings) const
     IQueryPlanStep::describePipeline(processors, settings);
 }
 
-void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets subqueries_for_sets, ContextPtr context)
+void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subqueries, ContextPtr context)
 {
     DataStreams input_streams;
     input_streams.emplace_back(query_plan.getCurrentDataStream());
@@ -135,7 +135,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets
     plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
     query_plan = QueryPlan();
 
-    for (auto & [description, future_set] : subqueries_for_sets)
+    for (auto & future_set : sets_from_subqueries)
     {
         if (future_set->get())
             continue;
@@ -170,7 +170,7 @@ std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSet
     // plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
     // query_plan = QueryPlan();
 
-    for (auto & [description, future_set] : step.subqueries_for_sets)
+    for (auto & future_set : step.sets_from_subquery)
     {
         if (future_set->get())
             continue;
@@ -197,8 +197,8 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets,
 }
 
 DelayedCreatingSetsStep::DelayedCreatingSetsStep(
-    DataStream input_stream, PreparedSets::SubqueriesForSets subqueries_for_sets_, ContextPtr context_)
-    : subqueries_for_sets(std::move(subqueries_for_sets_)), context(std::move(context_))
+    DataStream input_stream, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery_, ContextPtr context_)
+    : sets_from_subquery(std::move(sets_from_subquery_)), context(std::move(context_))
 {
     input_streams = {input_stream};
     output_stream = std::move(input_stream);
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index 2a6cb43c45a..c41bb782e0b 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -52,7 +52,7 @@ public:
 class DelayedCreatingSetsStep final : public IQueryPlanStep
 {
 public:
-    DelayedCreatingSetsStep(DataStream input_stream, PreparedSets::SubqueriesForSets subqueries_for_sets_, ContextPtr context_);
+    DelayedCreatingSetsStep(DataStream input_stream, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery_, ContextPtr context_);
 
     String getName() const override { return "DelayedCreatingSets"; }
 
@@ -61,14 +61,14 @@ public:
     static std::vector<std::unique_ptr<QueryPlan>> makePlansForSets(DelayedCreatingSetsStep && step);
 
     ContextPtr getContext() const { return context; }
-    PreparedSets::SubqueriesForSets detachSubqueries() { return std::move(subqueries_for_sets); }
+    std::vector<std::shared_ptr<FutureSetFromSubquery>> detachSets() { return std::move(sets_from_subquery); }
 
 private:
-    PreparedSets::SubqueriesForSets subqueries_for_sets;
+    std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery;
     ContextPtr context;
 };
 
-void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets subqueries_for_sets, ContextPtr context);
+void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery, ContextPtr context);
 
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets, ContextPtr context);
 
diff --git a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
index 63ba3d5b56c..5f04bf9ec18 100644
--- a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
+++ b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
@@ -273,7 +273,7 @@ size_t tryPushDownFilter(QueryPlan::Node * parent_node, QueryPlan::Nodes & nodes
         /// CreatingSets does not change header.
         /// We can push down filter and update header.
         /// Filter - DelayedCreatingSets - Something
-        child = std::make_unique<DelayedCreatingSetsStep>(filter->getOutputStream(), delayed->detachSubqueries(), delayed->getContext());
+        child = std::make_unique<DelayedCreatingSetsStep>(filter->getOutputStream(), delayed->detachSets(), delayed->getContext());
         std::swap(parent, child);
         std::swap(parent_node->children, child_node->children);
         std::swap(parent_node->children.front(), child_node->children.front());
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index 3139fa5ed98..aa374446f3e 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -135,11 +135,11 @@ void CreatingSetsTransform::init()
 {
     is_initialized = true;
 
-    if (subquery.set)
-    {
-        //std::cerr << "=========== " << getInputPort().getHeader().dumpStructure() << std::endl;
-        subquery.set->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
-    }
+    // if (subquery.set)
+    // {
+    //     //std::cerr << "=========== " << getInputPort().getHeader().dumpStructure() << std::endl;
+    //     subquery.set->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
+    // }
 
     watch.restart();
     startSubquery();
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index f4a4b6e9af1..d205086639d 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -66,13 +66,14 @@ bool traverseASTFilter(
                 return false;
             value = args.children.at(1);
 
-            PreparedSetKey set_key;
-            if ((value->as<ASTSubquery>() || value->as<ASTIdentifier>()))
-                set_key = PreparedSetKey::forSubquery(value->getTreeHash());
-            else
-                set_key = PreparedSetKey::forLiteral(value->getTreeHash(), {primary_key_type});
+            PreparedSets::Hash set_key = value->getTreeHash();
+            FutureSetPtr future_set;
+
+            if ((value->as<ASTSubquery>() || value->as<ASTIdentifier>()))
+                future_set = prepared_sets->findSubquery(set_key);
+            else
+                future_set = prepared_sets->find(set_key, {primary_key_type});
 
-            FutureSetPtr future_set = prepared_sets->getFuture(set_key);
             if (!future_set)
                 return false;
 
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index ad3fb984ce7..1bdbbfb3d40 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -299,14 +299,13 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
 
     if (ast_node && prepared_sets)
     {
-        auto hash = ast_node->getTreeHash();
-        auto key = PreparedSetKey::forSubquery(hash);
+        auto key = ast_node->getTreeHash();
+        const auto & sets = prepared_sets->getNormalSets();
+        auto it = sets.find(key);
+        if (it != sets.end() && !it->second.empty())
+            return it->second.at(0);
 
-        for (const auto & [k, v] : prepared_sets->getSets())
-        {
-            if (k.ast_hash == hash)
-                return v;
-        }
+        return prepared_sets->findSubquery(key);
     }
     else if (dag_node)
     {
@@ -324,9 +323,9 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(const DataTypes & data_types)
     if (prepared_sets && ast_node)
     {
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
-            return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
+            return prepared_sets->findSubquery(ast_node->getTreeHash());
 
-        return prepared_sets->getFuture(PreparedSetKey::forLiteral(ast_node->getTreeHash(), data_types));
+        return prepared_sets->find(ast_node->getTreeHash(), data_types);
     }
     else if (dag_node)
     {
@@ -369,14 +368,17 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
     if (prepared_sets && ast_node)
     {
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
-            return prepared_sets->getFuture(PreparedSetKey::forSubquery(ast_node->getTreeHash()));
+            return prepared_sets->findSubquery(ast_node->getTreeHash());
 
         auto tree_hash = ast_node->getTreeHash();
-        for (const auto & [key, future_set] : prepared_sets->getSets())
-        {
-            if (key.ast_hash == tree_hash && types_match(key.types))
+        const auto & sets = prepared_sets->getNormalSets();
+        auto it = sets.find(tree_hash);
+        if (it == sets.end())
+            return nullptr;
+
+        for (const auto & future_set : it->second)
+            if (types_match(future_set->getTypes()))
                 return future_set;
-        }
     }
     else
     {

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 1049/1478] 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 1050/1478] 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 1051/1478] 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 1052/1478] 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 1053/1478] 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 1054/1478] 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 1055/1478] 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 1056/1478] 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 1057/1478] 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 7df815d2806a9154a4f7010590952a647be97edd Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 20 Jun 2023 13:33:16 +0200
Subject: [PATCH 1058/1478] Fix

---
 src/Interpreters/Cache/Metadata.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index d659a58fdaf..ed2174213e1 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -400,6 +400,10 @@ void CacheMetadata::downloadThreadFunc()
                 if (!lock)
                     continue;
 
+                auto file_segment_metadata = lock->tryGetByOffset(file_segment->offset());
+                if (!file_segment_metadata || file_segment_metadata->evicting())
+                    continue;
+
                 holder = std::make_unique<FileSegmentsHolder>(FileSegments{file_segment});
             }
 

From 44377b01809dd4e85ca66d03c0b83a6f9da14ef9 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 20 Jun 2023 13:36:11 +0200
Subject: [PATCH 1059/1478] Rename

---
 src/Interpreters/Cache/Metadata.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index ed2174213e1..76dd5172929 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -396,11 +396,11 @@ void CacheMetadata::downloadThreadFunc()
                     || file_segment->state() != FileSegment::State::PARTIALLY_DOWNLOADED)
                     continue;
 
-                auto lock = lockKeyMetadata(file_segment->key(), KeyNotFoundPolicy::RETURN_NULL);
-                if (!lock)
+                auto locked_key = lockKeyMetadata(file_segment->key(), KeyNotFoundPolicy::RETURN_NULL);
+                if (!locked_key)
                     continue;
 
-                auto file_segment_metadata = lock->tryGetByOffset(file_segment->offset());
+                auto file_segment_metadata = locked_key->tryGetByOffset(file_segment->offset());
                 if (!file_segment_metadata || file_segment_metadata->evicting())
                     continue;
 

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 1060/1478] 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 1061/1478] 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 1062/1478] 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 1063/1478] 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 1064/1478] 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 b4273a1963dd5f66858d4a7c0feb7bc85dedc184 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 14:53:13 +0000
Subject: [PATCH 1065/1478] Fixing some tests.

---
 src/Interpreters/ActionsVisitor.cpp           | 11 ++++++++---
 src/Interpreters/PreparedSets.cpp             | 12 +++++++++---
 src/Interpreters/PreparedSets.h               |  2 --
 src/Interpreters/Set.cpp                      | 16 ++++++----------
 src/Interpreters/Set.h                        |  2 +-
 src/Planner/CollectSets.cpp                   |  8 +++++---
 src/Planner/PlannerActionsVisitor.cpp         | 17 +++++++++++------
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  8 ++++++--
 8 files changed, 46 insertions(+), 30 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 91c490f8a4c..8ddc035417b 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -445,9 +445,14 @@ FutureSetPtr makeExplicitSet(
     if (left_tuple_type && left_tuple_type->getElements().size() != 1)
         set_element_types = left_tuple_type->getElements();
 
-    for (auto & element_type : set_element_types)
-        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-            element_type = low_cardinality_type->getDictionaryType();
+    set_element_types = Set::getElementTypes(std::move(set_element_types), context->getSettingsRef().transform_null_in);
+
+    // for (auto & element_type : set_element_types)
+    //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+    //         element_type = low_cardinality_type->getDictionaryType();
+
+    // if (!set_element_types.empty())
+    //     std::cerr << "========== " << set_element_types[0]->getName() << std::endl;
 
     auto set_key = right_arg->getTreeHash();
     if (auto set = prepared_sets.find(set_key, set_element_types))
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index f74fe86acce..3281e7e9bb8 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -271,8 +271,6 @@ std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::detachSubqueri
     return res;
 }
 
-bool PreparedSets::empty() const { return sets.empty(); }
-
 void SubqueryForSet::createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_)
 {
     source = std::make_unique<QueryPlan>();
@@ -330,13 +328,18 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     }
 
     if (external_table_set)
-        return subquery.set = external_table_set->buildOrderedSetInplace(context);
+    {
+        auto set = external_table_set->buildOrderedSetInplace(context);
+        if (set)
+            return subquery.set = set;
+    }
 
     auto plan = buildPlan(context);
     if (!plan)
         return nullptr;
 
     subquery.set->fillSetElements();
+    subquery.set->initSetElements();
     auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
     auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
     pipeline.complete(std::make_shared<EmptySink>(Block()));
@@ -377,6 +380,9 @@ std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & c
     auto plan = subquery.detachSource();
     auto description = subquery.key;
 
+    if (!plan)
+        return nullptr;
+
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
             description,
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 67f8a65ca17..967cef615c5 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -168,8 +168,6 @@ public:
     const Sets & getNormalSets() const { return sets; }
     const SetsFromSubqueries & getSetsFromSubquery() const { return sets_from_subqueries; }
 
-    bool empty() const;
-
     static String toString(const Hash & key, const DataTypes & types);
 
 private:
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index 83005f3d3a7..17df5064642 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -103,22 +103,18 @@ void NO_INLINE Set::insertFromBlockImplCase(
 }
 
 
-DataTypes Set::getElementTypes(const ColumnsWithTypeAndName & header, bool transform_null_in)
+DataTypes Set::getElementTypes(DataTypes types, bool transform_null_in)
 {
-    DataTypes data_types;
-    data_types.reserve(header.size());
-
-    for (const auto & column : header)
+    for (auto & type : types)
     {
-        data_types.push_back(column.type);
-        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(data_types.back().get()))
-            data_types.back() = low_cardinality_type->getDictionaryType();
+        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(type.get()))
+            type = low_cardinality_type->getDictionaryType();
 
         if (!transform_null_in)
-            data_types.back() = removeNullable(data_types.back());
+            type = removeNullable(type);
     }
 
-    return data_types;
+    return types;
 }
 
 
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index df30992dd35..d1218830969 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -92,7 +92,7 @@ public:
     bool areTypesEqual(size_t set_type_idx, const DataTypePtr & other_type) const;
     void checkTypesEqual(size_t set_type_idx, const DataTypePtr & other_type) const;
 
-    static DataTypes getElementTypes(const ColumnsWithTypeAndName & header, bool transform_null_in);
+    static DataTypes getElementTypes(DataTypes types, bool transform_null_in);
 
 private:
     size_t keys_size = 0;
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 3b9512436ad..43431bd46ae 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -77,9 +77,11 @@ public:
             if (left_tuple_type && left_tuple_type->getElements().size() != 1)
                 set_element_types = left_tuple_type->getElements();
 
-            for (auto & element_type : set_element_types)
-                if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-                    element_type = low_cardinality_type->getDictionaryType();
+            set_element_types = Set::getElementTypes(std::move(set_element_types), settings.transform_null_in);
+
+            // for (auto & element_type : set_element_types)
+            //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+            //         element_type = low_cardinality_type->getDictionaryType();
 
             auto set_key = in_second_argument->getTreeHash();
             if (sets.find(set_key, set_element_types))
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index 0c84052578c..a7a2c6edc6c 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -639,6 +639,9 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
         in_second_argument_node_type == QueryTreeNodeType::UNION ||
         in_second_argument_node_type == QueryTreeNodeType::TABLE;
 
+    FutureSetPtr set;
+    auto set_key = in_second_argument->getTreeHash();
+
     if (!subquery_or_table)
     {
         set_element_types = {in_first_argument->getResultType()};
@@ -646,13 +649,15 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
         if (left_tuple_type && left_tuple_type->getElements().size() != 1)
             set_element_types = left_tuple_type->getElements();
 
-        for (auto & element_type : set_element_types)
-            if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-                element_type = low_cardinality_type->getDictionaryType();
-    }
+        // for (auto & element_type : set_element_types)
+        //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+        //         element_type = low_cardinality_type->getDictionaryType();
 
-    auto set_key = in_second_argument->getTreeHash();
-    auto set = planner_context->getPreparedSets().find(set_key, set_element_types);
+        set_element_types = Set::getElementTypes(std::move(set_element_types), planner_context->getQueryContext()->getSettingsRef().transform_null_in);
+        set = planner_context->getPreparedSets().find(set_key, set_element_types);
+    }
+    else
+        set = planner_context->getPreparedSets().findSubquery(set_key);
 
     if (!set)
         throw Exception(ErrorCodes::LOGICAL_ERROR,
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index ab028d967d8..54d81dd7650 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -190,10 +190,14 @@ std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSet
 
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets, ContextPtr context)
 {
-    if (!prepared_sets || prepared_sets->empty())
+    if (!prepared_sets)
         return;
 
-    addCreatingSetsStep(query_plan, prepared_sets->detachSubqueries(), context);
+    auto subqueries = prepared_sets->detachSubqueries();
+    if (subqueries.empty())
+        return;
+
+    addCreatingSetsStep(query_plan, std::move(subqueries), context);
 }
 
 DelayedCreatingSetsStep::DelayedCreatingSetsStep(

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 1066/1478] 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 1067/1478] 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 1068/1478] 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 1069/1478] 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 1070/1478] 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 1071/1478] 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 1072/1478] 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 1073/1478] 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 518ba6cbf6ee96deec772eebfaf8417347215460 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 16:43:22 +0000
Subject: [PATCH 1074/1478] Fix more tests.

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

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 3281e7e9bb8..17918a46954 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -265,9 +265,8 @@ std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::detachSubqueri
     std::vector<std::shared_ptr<FutureSetFromSubquery>> res;
     res.reserve(sets_from_subqueries.size());
     for (auto & [_, set] : sets_from_subqueries)
-        res.push_back(std::move(set));
+        res.push_back(set);
 
-    sets_from_subqueries.clear();
     return res;
 }
 

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 1075/1478] 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 1076/1478] 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 1077/1478] 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 1078/1478] 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 1079/1478] 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 1080/1478] 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 1081/1478] 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 1082/1478] 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 5a1f819e7b068f9416e0aa9db6aec8697baa2fb8 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 17:33:09 +0000
Subject: [PATCH 1083/1478] Fix more tests.

---
 src/Interpreters/ActionsVisitor.cpp   |  2 +-
 src/Interpreters/PreparedSets.cpp     | 39 ++++++++++++++++-----------
 src/Interpreters/PreparedSets.h       | 12 ++++++---
 src/Planner/CollectSets.cpp           |  2 +-
 src/Planner/PlannerActionsVisitor.cpp |  6 ++++-
 src/Storages/KVStorageUtils.cpp       |  2 +-
 src/Storages/MergeTree/RPNBuilder.cpp |  6 ++---
 7 files changed, 43 insertions(+), 26 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 8ddc035417b..a9c0bbbbbc0 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -455,7 +455,7 @@ FutureSetPtr makeExplicitSet(
     //     std::cerr << "========== " << set_element_types[0]->getName() << std::endl;
 
     auto set_key = right_arg->getTreeHash();
-    if (auto set = prepared_sets.find(set_key, set_element_types))
+    if (auto set = prepared_sets.findTuple(set_key, set_element_types))
         return set; /// Already prepared.
 
     Block block;
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 17918a46954..144436589a0 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -178,21 +178,10 @@ static FutureSetPtr findSet(const std::vector<std::shared_ptr<FutureSet>> & sets
     return nullptr;
 }
 
-FutureSetPtr PreparedSets::addFromStorage(const Hash & key, SetPtr set_)
-{
-    auto from_storage = std::make_shared<FutureSetFromStorage>(std::move(set_));
-    auto & sets_by_hash = sets[key];
-
-    if (!tryInsertSet(sets_by_hash, from_storage))
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_storage->getTypes()));
-
-    return from_storage;
-}
-
 FutureSetPtr PreparedSets::addFromTuple(const Hash & key, Block block, const Settings & settings)
 {
     auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block), settings);
-    auto & sets_by_hash = sets[key];
+    auto & sets_by_hash = sets_from_tuple[key];
 
     if (!tryInsertSet(sets_by_hash, from_tuple))
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_tuple->getTypes()));
@@ -200,6 +189,17 @@ FutureSetPtr PreparedSets::addFromTuple(const Hash & key, Block block, const Set
     return from_tuple;
 }
 
+FutureSetPtr PreparedSets::addFromStorage(const Hash & key, SetPtr set_)
+{
+    auto from_storage = std::make_shared<FutureSetFromStorage>(std::move(set_));
+    auto [it, inserted] = sets_from_storage.emplace(key, from_storage);
+
+    if (!inserted)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, {}));
+
+    return from_storage;
+}
+
 FutureSetPtr PreparedSets::addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set)
 {
     auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set), settings);
@@ -215,10 +215,10 @@ FutureSetPtr PreparedSets::addFromSubquery(const Hash & key, SubqueryForSet subq
     return from_subquery;
 }
 
-FutureSetPtr PreparedSets::find(const Hash & key, const DataTypes & types) const
+FutureSetPtr PreparedSets::findTuple(const Hash & key, const DataTypes & types) const
 {
-    auto it = sets.find(key);
-    if (it == sets.end())
+    auto it = sets_from_tuple.find(key);
+    if (it == sets_from_tuple.end())
         return nullptr;
 
     return findSet(it->second, types);
@@ -233,6 +233,15 @@ std::shared_ptr<FutureSetFromSubquery> PreparedSets::findSubquery(const Hash & k
     return it->second;
 }
 
+std::shared_ptr<FutureSetFromStorage> PreparedSets::findStorage(const Hash & key) const
+{
+    auto it = sets_from_storage.find(key);
+    if (it == sets_from_storage.end())
+        return nullptr;
+
+    return it->second;
+}
+
 // FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
 // {
 //     auto it = sets.find(key);
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 967cef615c5..49545ad1e2a 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -148,14 +148,16 @@ public:
     //     std::shared_ptr<FutureSetFromSubquery> set;
     // };
 
-    using Sets = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSet>>, Hashing>;
+    using SetsFromTuple = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSet>>, Hashing>;
+    using SetsFromStorage = std::unordered_map<Hash, std::shared_ptr<FutureSetFromStorage>, Hashing>;
     using SetsFromSubqueries = std::unordered_map<Hash, std::shared_ptr<FutureSetFromSubquery>, Hashing>;
 
     FutureSetPtr addFromStorage(const Hash & key, SetPtr set_);
     FutureSetPtr addFromTuple(const Hash & key, Block block, const Settings & settings);
     FutureSetPtr addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
 
-    FutureSetPtr find(const Hash & key, const DataTypes & types) const;
+    FutureSetPtr findTuple(const Hash & key, const DataTypes & types) const;
+    std::shared_ptr<FutureSetFromStorage> findStorage(const Hash & key) const;
     std::shared_ptr<FutureSetFromSubquery> findSubquery(const Hash & key) const;
 
     //FutureSetPtr getFuture(const PreparedSetKey & key) const;
@@ -165,13 +167,15 @@ public:
     /// SetPtr would still be available for consumers of PreparedSets.
     std::vector<std::shared_ptr<FutureSetFromSubquery>> detachSubqueries();
 
-    const Sets & getNormalSets() const { return sets; }
+    const SetsFromTuple & getSetsFromTuple() const { return sets_from_tuple; }
+    const SetsFromStorage & getSetsFromStorage() const { return sets_from_storage; }
     const SetsFromSubqueries & getSetsFromSubquery() const { return sets_from_subqueries; }
 
     static String toString(const Hash & key, const DataTypes & types);
 
 private:
-    Sets sets;
+    SetsFromTuple sets_from_tuple;
+    SetsFromStorage sets_from_storage;
     SetsFromSubqueries sets_from_subqueries;
 };
 
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index 43431bd46ae..b0e6b272c9f 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -84,7 +84,7 @@ public:
             //         element_type = low_cardinality_type->getDictionaryType();
 
             auto set_key = in_second_argument->getTreeHash();
-            if (sets.find(set_key, set_element_types))
+            if (sets.findTuple(set_key, set_element_types))
                 return;
 
             sets.addFromTuple(set_key, std::move(set), settings);
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index a7a2c6edc6c..40b6ec109dc 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -654,10 +654,14 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
         //         element_type = low_cardinality_type->getDictionaryType();
 
         set_element_types = Set::getElementTypes(std::move(set_element_types), planner_context->getQueryContext()->getSettingsRef().transform_null_in);
-        set = planner_context->getPreparedSets().find(set_key, set_element_types);
+        set = planner_context->getPreparedSets().findTuple(set_key, set_element_types);
     }
     else
+    {
         set = planner_context->getPreparedSets().findSubquery(set_key);
+        if (!set)
+            set = planner_context->getPreparedSets().findStorage(set_key);
+    }
 
     if (!set)
         throw Exception(ErrorCodes::LOGICAL_ERROR,
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index d205086639d..b3b60fc064c 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -72,7 +72,7 @@ bool traverseASTFilter(
             if ((value->as<ASTSubquery>() || value->as<ASTIdentifier>()))
                 future_set = prepared_sets->findSubquery(set_key);
             else
-                future_set = prepared_sets->find(set_key, {primary_key_type});
+                future_set = prepared_sets->findTuple(set_key, {primary_key_type});
 
             if (!future_set)
                 return false;
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index 1bdbbfb3d40..0b42111be45 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -300,7 +300,7 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet() const
     if (ast_node && prepared_sets)
     {
         auto key = ast_node->getTreeHash();
-        const auto & sets = prepared_sets->getNormalSets();
+        const auto & sets = prepared_sets->getSetsFromTuple();
         auto it = sets.find(key);
         if (it != sets.end() && !it->second.empty())
             return it->second.at(0);
@@ -325,7 +325,7 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(const DataTypes & data_types)
         if (ast_node->as<ASTSubquery>() || ast_node->as<ASTTableIdentifier>())
             return prepared_sets->findSubquery(ast_node->getTreeHash());
 
-        return prepared_sets->find(ast_node->getTreeHash(), data_types);
+        return prepared_sets->findTuple(ast_node->getTreeHash(), data_types);
     }
     else if (dag_node)
     {
@@ -371,7 +371,7 @@ FutureSetPtr RPNBuilderTreeNode::tryGetPreparedSet(
             return prepared_sets->findSubquery(ast_node->getTreeHash());
 
         auto tree_hash = ast_node->getTreeHash();
-        const auto & sets = prepared_sets->getNormalSets();
+        const auto & sets = prepared_sets->getSetsFromTuple();
         auto it = sets.find(tree_hash);
         if (it == sets.end())
             return nullptr;

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 1084/1478] 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 1085/1478] 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 1086/1478] 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 c0b1d7f4f2bc9dc92c35b751c37a5f747f0a297a Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 19:12:22 +0000
Subject: [PATCH 1087/1478] Fixing 01774_tuple_null_in

---
 src/Interpreters/ActionsVisitor.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index a9c0bbbbbc0..9125b38b48c 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -445,17 +445,17 @@ FutureSetPtr makeExplicitSet(
     if (left_tuple_type && left_tuple_type->getElements().size() != 1)
         set_element_types = left_tuple_type->getElements();
 
-    set_element_types = Set::getElementTypes(std::move(set_element_types), context->getSettingsRef().transform_null_in);
-
-    // for (auto & element_type : set_element_types)
-    //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-    //         element_type = low_cardinality_type->getDictionaryType();
+    for (auto & element_type : set_element_types)
+        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+            element_type = low_cardinality_type->getDictionaryType();
 
     // if (!set_element_types.empty())
     //     std::cerr << "========== " << set_element_types[0]->getName() << std::endl;
 
+    auto set_element_keys = Set::getElementTypes(set_element_types, context->getSettingsRef().transform_null_in);
+
     auto set_key = right_arg->getTreeHash();
-    if (auto set = prepared_sets.findTuple(set_key, set_element_types))
+    if (auto set = prepared_sets.findTuple(set_key, set_element_keys))
         return set; /// Already prepared.
 
     Block block;

From e4f057e3040d6088d5fffec568fc167fefba56b8 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 19:40:37 +0000
Subject: [PATCH 1088/1478] Fix Set index with constant nullable comparison.

---
 src/Storages/MergeTree/MergeTreeIndexSet.cpp       |  2 +-
 ...2789_set_index_nullable_condition_bug.reference |  1 +
 .../02789_set_index_nullable_condition_bug.sql     | 14 ++++++++++++++
 3 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02789_set_index_nullable_condition_bug.reference
 create mode 100644 tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql

diff --git a/src/Storages/MergeTree/MergeTreeIndexSet.cpp b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
index 120b3e43472..78e8b460433 100644
--- a/src/Storages/MergeTree/MergeTreeIndexSet.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
@@ -554,7 +554,7 @@ void MergeTreeIndexConditionSet::traverseAST(ASTPtr & node) const
     if (atomFromAST(node))
     {
         if (node->as<ASTIdentifier>() || node->as<ASTFunction>())
-            node = makeASTFunction("__bitWrapperFunc", node);
+    else
     }
     else
         node = std::make_shared<ASTLiteral>(UNKNOWN_FIELD);
diff --git a/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.reference b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.reference
new file mode 100644
index 00000000000..e6ce356cd45
--- /dev/null
+++ b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.reference
@@ -0,0 +1 @@
+v1	v2
diff --git a/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql
new file mode 100644
index 00000000000..84c53d35d71
--- /dev/null
+++ b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql
@@ -0,0 +1,14 @@
+CREATE OR REPLACE TABLE test_table
+(
+    col1 String,
+    col2 String,
+    INDEX test_table_col2_idx col2 TYPE set(0) GRANULARITY 1
+) ENGINE = MergeTree()
+      ORDER BY col1
+AS SELECT 'v1', 'v2';
+
+SELECT * FROM test_table
+WHERE 1 == 1 AND col1 == col1 OR
+       0 AND col2 == NULL;
+
+drop table if exists test_table;

From 5bda0b535d9b161acf17980ebddd252e1dd4f587 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 19:45:03 +0000
Subject: [PATCH 1089/1478] Fixing build.

---
 src/Storages/MergeTree/MergeTreeIndexSet.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexSet.cpp b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
index 78e8b460433..6f4c5e48ea8 100644
--- a/src/Storages/MergeTree/MergeTreeIndexSet.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
@@ -1,3 +1,4 @@
+#include "Parsers/queryToString.h"
 #include <Storages/MergeTree/MergeTreeIndexSet.h>
 
 #include <Interpreters/ExpressionActions.h>
@@ -554,7 +555,7 @@ void MergeTreeIndexConditionSet::traverseAST(ASTPtr & node) const
     if (atomFromAST(node))
     {
         if (node->as<ASTIdentifier>() || node->as<ASTFunction>())
-    else
+            node = makeASTFunction("__bitWrapperFunc", makeASTFunction("toUInt8OrDefault", node));
     }
     else
         node = std::make_shared<ASTLiteral>(UNKNOWN_FIELD);

From 266e81702a3c7cf68ac3f78995ce7b1fea8686e3 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Tue, 20 Jun 2023 19:48:39 +0000
Subject: [PATCH 1090/1478] Fixing clang-tidy

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

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 144436589a0..03c18730cc5 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -88,10 +88,10 @@ SetPtr FutureSetFromStorage::buildOrderedSetInplace(const ContextPtr &)
 //     return true;
 // }
 
-String PreparedSets::toString(const PreparedSets::Hash & hash, const DataTypes & types)
+String PreparedSets::toString(const PreparedSets::Hash & key, const DataTypes & types)
 {
     WriteBufferFromOwnString buf;
-    buf << "__set_" << hash.first << "_" << hash.second;
+    buf << "__set_" << key.first << "_" << key.second;
     if (!types.empty())
     {
         buf << "(";

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 1091/1478] 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 b8085dfa0e63b88132abcaecee5084936515a6d6 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 00:20:40 +0200
Subject: [PATCH 1092/1478] Fix bad merge

---
 src/Interpreters/Cache/FileSegment.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index de8ede69848..daae9b447a4 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -305,8 +305,9 @@ void FileSegment::resetRemoteFileReader()
 
 FileSegment::RemoteFileReaderPtr FileSegment::extractRemoteFileReader()
 {
-    if (isCompleted(false)
-        || download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION)
+    auto lock = lockFileSegment();
+    if (remote_file_reader && (download_state == State::DOWNLOADED
+        || download_state == State::PARTIALLY_DOWNLOADED_NO_CONTINUATION))
     {
         return std::move(remote_file_reader);
     }

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 1093/1478] 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 1094/1478] 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 1095/1478] 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 1096/1478] 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 1097/1478] 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 44798971f9bd4f17e1c856b5345532cd6c96f2a7 Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Tue, 20 Jun 2023 18:25:38 -0700
Subject: [PATCH 1098/1478] Fix a test, add APPEND to suggest.

---
 src/Client/Suggest.cpp                                     | 2 +-
 tests/queries/0_stateless/02346_into_outfile_and_stdout.sh | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index 4e38add0ef5..c9cc27b4337 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -43,7 +43,7 @@ Suggest::Suggest()
         "IN",           "KILL",     "QUERY",  "SYNC",      "ASYNC",    "TEST",        "BETWEEN",  "TRUNCATE",    "USER",    "ROLE",
         "PROFILE",      "QUOTA",    "POLICY", "ROW",       "GRANT",    "REVOKE",      "OPTION",   "ADMIN",       "EXCEPT",  "REPLACE",
         "IDENTIFIED",   "HOST",     "NAME",   "READONLY",  "WRITABLE", "PERMISSIVE",  "FOR",      "RESTRICTIVE", "RANDOMIZED",
-        "INTERVAL",     "LIMITS",   "ONLY",   "TRACKING",  "IP",       "REGEXP",      "ILIKE",    "CLEANUP"
+        "INTERVAL",     "LIMITS",   "ONLY",   "TRACKING",  "IP",       "REGEXP",      "ILIKE",    "CLEANUP",     "APPEND"
     });
 }
 
diff --git a/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh b/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
index 8ec086c97ef..38145ab3e51 100755
--- a/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
+++ b/tests/queries/0_stateless/02346_into_outfile_and_stdout.sh
@@ -66,7 +66,7 @@ performBadQuery "bad_query_incorrect_usage" "SELECT 1, 2, 3 INTO OUTFILE AND STD
 
 performBadQuery "bad_query_no_into_outfile" "SELECT 1, 2, 3 AND STDOUT'" "SYNTAX_ERROR"
 
-performFileExists "bad_query_file_exists" "SELECT 1, 2, 3 INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists.out' AND STDOUT" "File ${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists exists, consider using APPEND or TRUNCATE if appropriate. (CANNOT_OPEN_FILE)"
+performFileExists "bad_query_file_exists" "SELECT 1, 2, 3 INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists.out' AND STDOUT" "File ${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_bad_query_file_exists.out exists, consider using APPEND or TRUNCATE."
 
 performCompression "compression" "SELECT * FROM (SELECT 'Hello, World! From clickhouse.') INTO OUTFILE '${CLICKHOUSE_TMP}/test_into_outfile_and_stdout_compression.gz' AND STDOUT COMPRESSION 'GZ' FORMAT TabSeparated"
 

From dab42af754735f6d3e002af224a8f2e708124e14 Mon Sep 17 00:00:00 2001
From: Manas Alekar <manas@clickhouse.com>
Date: Tue, 20 Jun 2023 22:43:25 -0700
Subject: [PATCH 1099/1478] Fix another test.

---
 .../0_stateless/02050_clickhouse_client_local_exception.sh      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02050_clickhouse_client_local_exception.sh b/tests/queries/0_stateless/02050_clickhouse_client_local_exception.sh
index eac085a914e..a2bb29377ac 100755
--- a/tests/queries/0_stateless/02050_clickhouse_client_local_exception.sh
+++ b/tests/queries/0_stateless/02050_clickhouse_client_local_exception.sh
@@ -10,4 +10,4 @@ function cleanup()
     rm "${CLICKHOUSE_TMP}/test_exception"
 }
 trap cleanup EXIT
-$CLICKHOUSE_LOCAL --query="SELECT 1 INTO OUTFILE '${CLICKHOUSE_TMP}/test_exception' FORMAT Native" 2>&1 | grep -q "Code: 76. DB::ErrnoException:" && echo 'OK' || echo 'FAIL' ||:
+$CLICKHOUSE_LOCAL --query="SELECT 1 INTO OUTFILE '${CLICKHOUSE_TMP}/test_exception' FORMAT Native" 2>&1 | grep -q "Code: 504. DB::Exception:" && echo 'OK' || echo 'FAIL' ||:

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 1100/1478] 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 5e4805665974ded066713ccdaacc76cfff618b5d Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 21 Jun 2023 09:21:01 +0000
Subject: [PATCH 1101/1478] Disable analyzer

---
 .../0_stateless/02494_query_cache_nested_query_bug.sh       | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
index f451e9b0709..c5ca1d88b4d 100755
--- a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
+++ b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-parallel, no-fasttest
+# Tags: no-parallel
 # Tag no-parallel: Messes with internal cache
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
@@ -16,7 +16,7 @@ ${CLICKHOUSE_CLIENT} --query "INSERT INTO tab VALUES (3) (4) (5)"
 
 # Verify that the first query does two aggregations and the second query zero aggregations. Since query cache is currently not integrated
 # with EXPLAIN PLAN, we need need to check the logs.
-${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1" 2>&1 | grep "Aggregated. " | wc -l
-${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1" 2>&1 | grep "Aggregated. " | wc -l
+${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1, allow_experimental_analyzer=0" 2>&1 | grep "Aggregated. " | wc -l
+${CLICKHOUSE_CLIENT} --send_logs_level=trace --query "SELECT count(a) / (SELECT sum(a) FROM tab) FROM tab SETTINGS use_query_cache=1, max_threads=1, allow_experimental_analyzer=0" 2>&1 | grep "Aggregated. " | wc -l
 
 ${CLICKHOUSE_CLIENT} --query "SYSTEM DROP QUERY CACHE"

From 0149f905decbb5de715245463c82f470bd8af7c1 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <KochetovNicolai@users.noreply.github.com>
Date: Wed, 21 Jun 2023 11:26:54 +0200
Subject: [PATCH 1102/1478] Update MergeTreeIndexSet.cpp

---
 src/Storages/MergeTree/MergeTreeIndexSet.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexSet.cpp b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
index 6f4c5e48ea8..7f6edfc7ec4 100644
--- a/src/Storages/MergeTree/MergeTreeIndexSet.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
@@ -1,4 +1,3 @@
-#include "Parsers/queryToString.h"
 #include <Storages/MergeTree/MergeTreeIndexSet.h>
 
 #include <Interpreters/ExpressionActions.h>

From 446320b182e7ceba9df32307e7c18be9cbbcfe34 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <KochetovNicolai@users.noreply.github.com>
Date: Wed, 21 Jun 2023 11:28:15 +0200
Subject: [PATCH 1103/1478] Update 02789_set_index_nullable_condition_bug.sql

---
 .../0_stateless/02789_set_index_nullable_condition_bug.sql     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql
index 84c53d35d71..fed030f170d 100644
--- a/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql
+++ b/tests/queries/0_stateless/02789_set_index_nullable_condition_bug.sql
@@ -1,4 +1,5 @@
-CREATE OR REPLACE TABLE test_table
+drop table if exists test_table;
+CREATE TABLE test_table
 (
     col1 String,
     col2 String,

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 1104/1478] 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 1105/1478] 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 1106/1478] 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 1107/1478] 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 1108/1478] 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 1109/1478] 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 1110/1478] 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 1111/1478] 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 1112/1478] 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 75b7121759ac4bb1fc12078042d52a445ae319a5 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 21 Jun 2023 12:37:06 +0000
Subject: [PATCH 1113/1478] Exclude fasttest again :-(

---
 .../queries/0_stateless/02494_query_cache_nested_query_bug.sh  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
index c5ca1d88b4d..394367919e9 100755
--- a/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
+++ b/tests/queries/0_stateless/02494_query_cache_nested_query_bug.sh
@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
-# Tags: no-parallel
+# Tags: no-parallel, no-fasttest
 # Tag no-parallel: Messes with internal cache
+#     no-fasttest: Produces wrong results in fasttest, unclear why, didn't reproduce locally.
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

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 1114/1478] 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 1115/1478] 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 1116/1478] 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 1117/1478] 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 1118/1478] 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 1119/1478] 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 1120/1478] 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 1121/1478] 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 1122/1478] 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 1123/1478] 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 1124/1478] 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 1125/1478] 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 1126/1478] 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 1127/1478] 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 1128/1478] 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 1129/1478] 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 1130/1478] 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 1131/1478] 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 1132/1478] 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 1133/1478] 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 1134/1478] 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 1135/1478] 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 5229544b559366a9a10df0ecb17485a54eee51fb Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Wed, 21 Jun 2023 22:17:39 +0200
Subject: [PATCH 1136/1478] Added function getCurrrentBatchAndScheduleNext to
 IObjectStorageIteratorAsync

---
 src/Disks/ObjectStorages/ObjectStorageIterator.h |  6 ++++++
 .../ObjectStorageIteratorAsync.cpp               | 16 ++++++++++++++++
 .../ObjectStorages/ObjectStorageIteratorAsync.h  |  3 ++-
 src/Storages/StorageAzureBlob.cpp                | 11 +++++++----
 4 files changed, 31 insertions(+), 5 deletions(-)

diff --git a/src/Disks/ObjectStorages/ObjectStorageIterator.h b/src/Disks/ObjectStorages/ObjectStorageIterator.h
index 2ff5ce60acc..841b0ea6664 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIterator.h
+++ b/src/Disks/ObjectStorages/ObjectStorageIterator.h
@@ -14,6 +14,7 @@ public:
     virtual bool isValid() = 0;
     virtual RelativePathWithMetadata current() = 0;
     virtual RelativePathsWithMetadata currentBatch() = 0;
+    virtual std::optional<RelativePathsWithMetadata> getCurrrentBatchAndScheduleNext() = 0;
     virtual size_t getAccumulatedSize() const = 0;
 
     virtual ~IObjectStorageIterator() = default;
@@ -53,6 +54,11 @@ public:
         return batch;
     }
 
+    virtual std::optional<RelativePathsWithMetadata> getCurrrentBatchAndScheduleNext() override
+    {
+        return std::nullopt;
+    }
+
     size_t getAccumulatedSize() const override
     {
         return batch.size();
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
index f91c19f2fb9..7425f629a5a 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.cpp
@@ -100,6 +100,22 @@ RelativePathsWithMetadata IObjectStorageIteratorAsync::currentBatch()
     return current_batch;
 }
 
+std::optional<RelativePathsWithMetadata> IObjectStorageIteratorAsync::getCurrrentBatchAndScheduleNext()
+{
+    std::lock_guard lock(mutex);
+    if (!is_initialized)
+        nextBatch();
+
+    if (current_batch_iterator != current_batch.end())
+    {
+        auto temp_current_batch = current_batch;
+        nextBatch();
+        return temp_current_batch;
+    }
+
+    return std::nullopt;
+}
+
 size_t IObjectStorageIteratorAsync::getAccumulatedSize() const
 {
     return accumulated_size.load(std::memory_order_relaxed);
diff --git a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
index a2b06da9a91..b0dd3cef39c 100644
--- a/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
+++ b/src/Disks/ObjectStorages/ObjectStorageIteratorAsync.h
@@ -27,6 +27,7 @@ public:
     RelativePathWithMetadata current() override;
     RelativePathsWithMetadata currentBatch() override;
     size_t getAccumulatedSize() const override;
+    std::optional<RelativePathsWithMetadata> getCurrrentBatchAndScheduleNext() override;
 
     ~IObjectStorageIteratorAsync() override
     {
@@ -48,7 +49,7 @@ protected:
     bool is_initialized{false};
     bool is_finished{false};
 
-    mutable std::mutex mutex;
+    mutable std::recursive_mutex mutex;
     ThreadPool list_objects_pool;
     ThreadPoolCallbackRunner<BatchAndHasNext> list_objects_scheduler;
     std::future<BatchAndHasNext> outcome_future;
diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index b9d59f04001..91dc92f09e8 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -882,7 +882,6 @@ StorageAzureBlobSource::Iterator::Iterator(
 
 RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
 {
-    std::lock_guard lock(next_mutex);
     if (is_finished)
         return {};
 
@@ -901,6 +900,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
     {
         bool need_new_batch = false;
         {
+            std::lock_guard lock(next_mutex);
             need_new_batch = !blobs_with_metadata || index >= blobs_with_metadata->size();
         }
 
@@ -909,10 +909,10 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
             RelativePathsWithMetadata new_batch;
             while (new_batch.empty())
             {
-                if (object_storage_iterator->isValid())
+                auto result = object_storage_iterator->getCurrrentBatchAndScheduleNext();
+                if (result.has_value())
                 {
-                    new_batch = object_storage_iterator->currentBatch();
-                    object_storage_iterator->nextBatch();
+                    new_batch = result.value();
                 }
                 else
                 {
@@ -945,6 +945,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
                 const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
 
+                std::lock_guard lock(next_mutex);
                 blob_path_with_globs.reset();
                 blob_path_with_globs.emplace();
                 for (UInt64 idx : idxs.getData())
@@ -960,6 +961,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
                 if (outer_blobs)
                     outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
 
+                std::lock_guard lock(next_mutex);
                 blobs_with_metadata = std::move(new_batch);
                 for (const auto & [_, info] : *blobs_with_metadata)
                     total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
@@ -967,6 +969,7 @@ RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
         }
 
         size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
+        std::lock_guard lock(next_mutex);
         return (*blobs_with_metadata)[current_index];
     }
 }

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 1137/1478] 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 0af028ab3f19dc1dc3501d5e5b2dd0e9aa540fdc Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Wed, 21 Jun 2023 20:55:27 +0000
Subject: [PATCH 1138/1478] Refactor a bit more.

---
 src/Interpreters/ActionsVisitor.cpp           |  12 +-
 src/Interpreters/GlobalSubqueriesVisitor.h    |   9 +-
 src/Interpreters/InterpreterSelectQuery.cpp   |   2 +-
 src/Interpreters/PreparedSets.cpp             | 137 +++++++++++------
 src/Interpreters/PreparedSets.h               | 145 +++++++++---------
 src/Planner/CollectSets.cpp                   |  28 +---
 src/Planner/Planner.cpp                       |   8 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  26 ++--
 src/Processors/QueryPlan/CreatingSetsStep.h   |  16 +-
 .../Transforms/CreatingSetsTransform.cpp      |  60 +++-----
 .../Transforms/CreatingSetsTransform.h        |   8 +-
 src/QueryPipeline/QueryPipelineBuilder.cpp    |   8 +-
 src/QueryPipeline/QueryPipelineBuilder.h      |   8 +-
 .../MergeTree/MergeTreeDataSelectExecutor.cpp |   4 +-
 14 files changed, 232 insertions(+), 239 deletions(-)

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 9125b38b48c..7c3af4ce691 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1406,7 +1406,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         if (data.getContext()->getSettingsRef().allow_experimental_analyzer && !identifier)
         {
             InterpreterSelectQueryAnalyzer interpreter(right_in_operand, data.getContext(), SelectQueryOptions().analyze(true).subquery());
-            auto query_tree = interpreter.getQueryTree();
+            const auto & query_tree = interpreter.getQueryTree();
             if (auto * query_node = query_tree->as<QueryNode>())
                 query_node->setIsSubquery(true);
             set_key = query_tree->getTreeHash();
@@ -1449,11 +1449,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             }
         }
 
-        /// We get the stream of blocks for the subquery. Create Set and put it in place of the subquery.
-        // String set_id = right_in_operand->getColumnName();
-        //bool transform_null_in =  data.getContext()->getSettingsRef().transform_null_in;
-        SubqueryForSet subquery_for_set; // = data.prepared_sets->createOrGetSubquery(set_id, set_key, data.set_size_limit, transform_null_in);
-        subquery_for_set.key = PreparedSets::toString(set_key, {}); //right_in_operand->getColumnName();
+        std::unique_ptr<QueryPlan> source = std::make_unique<QueryPlan>();
 
         /** The following happens for GLOBAL INs or INs:
           * - in the addExternalStorage function, the IN (SELECT ...) subquery is replaced with IN _data1,
@@ -1465,10 +1461,10 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
           */
         {
             auto interpreter = interpretSubquery(right_in_operand, data.getContext(), data.subquery_depth, {});
-            subquery_for_set.createSource(*interpreter);
+            interpreter->buildQueryPlan(*source);
         }
 
-        return data.prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), data.getContext()->getSettingsRef(), std::move(external_table_set));
+        return data.prepared_sets->addFromSubquery(set_key, std::move(source), nullptr, std::move(external_table_set), data.getContext()->getSettingsRef());
     }
     else
     {
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 5b8f0c60d35..8c784d3c2ff 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -188,20 +188,17 @@ public:
             {
                 // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
                 // subquery_for_set.createSource(*interpreter, external_storage);
-                auto key = subquery_or_table_name->getColumnName();
                 auto set_key = database_and_table_name->getTreeHash();
 
                 // std::cerr << "====== Adding key " << set_key.toString() << std::endl;
 
                 if (!prepared_sets->findSubquery(set_key))
                 {
-                    SubqueryForSet subquery_for_set;
-                    subquery_for_set.key = std::move(key);
-                    subquery_for_set.table = std::move(external_storage);
-                    subquery_for_set.createSource(*interpreter);
+                    std::unique_ptr<QueryPlan> source = std::make_unique<QueryPlan>();
+                    interpreter->buildQueryPlan(*source);
 
                     //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
-                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(subquery_for_set), getContext()->getSettingsRef(), nullptr);
+                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(source), std::move(external_storage), nullptr, getContext()->getSettingsRef());
                     // std::cerr << "... Future set " << reinterpret_cast<const void *>(external_storage_holder.get()) << " " << reinterpret_cast<const void *>(future_set.get()) << std::endl;
                     external_storage_holder->future_set = std::move(future_set);
                 }
diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index 52238ad5932..01736731f2e 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -3151,7 +3151,7 @@ void InterpreterSelectQuery::executeExtremes(QueryPlan & query_plan)
 
 void InterpreterSelectQuery::executeSubqueriesInSetsAndJoins(QueryPlan & query_plan)
 {
-    auto subqueries = prepared_sets->detachSubqueries();
+    auto subqueries = prepared_sets->getSubqueries();
 
     if (!subqueries.empty())
     {
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 03c18730cc5..2aa3e02c713 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -200,17 +200,42 @@ FutureSetPtr PreparedSets::addFromStorage(const Hash & key, SetPtr set_)
     return from_storage;
 }
 
-FutureSetPtr PreparedSets::addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set)
+FutureSetPtr PreparedSets::addFromSubquery(
+    const Hash & key,
+    std::unique_ptr<QueryPlan> source,
+    StoragePtr external_table,
+    FutureSetPtr external_table_set,
+    const Settings & settings)
 {
-    auto from_subquery = std::make_shared<FutureSetFromSubquery>(std::move(subquery), std::move(external_table_set), settings);
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(
+        toString(key, {}),
+        std::move(source),
+        std::move(external_table),
+        std::move(external_table_set),
+        settings);
+
     auto [it, inserted] = sets_from_subqueries.emplace(key, from_subquery);
 
     if (!inserted)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, {}));
 
-    // std::cerr << key.toString() << std::endl;
-    // std::cerr << "========= PreparedSets::addFromSubquery\n";
-    // std::cerr << StackTrace().toString() << std::endl;
+    return from_subquery;
+}
+
+FutureSetPtr PreparedSets::addFromSubquery(
+    const Hash & key,
+    QueryTreeNodePtr query_tree,
+    const Settings & settings)
+{
+    auto from_subquery = std::make_shared<FutureSetFromSubquery>(
+        toString(key, {}),
+        std::move(query_tree),
+        settings);
+
+    auto [it, inserted] = sets_from_subqueries.emplace(key, from_subquery);
+
+    if (!inserted)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, {}));
 
     return from_subquery;
 }
@@ -269,7 +294,7 @@ std::shared_ptr<FutureSetFromStorage> PreparedSets::findStorage(const Hash & key
 //     return res;
 // }
 
-std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::detachSubqueries()
+std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::getSubqueries()
 {
     std::vector<std::shared_ptr<FutureSetFromSubquery>> res;
     res.reserve(sets_from_subqueries.size());
@@ -279,25 +304,25 @@ std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::detachSubqueri
     return res;
 }
 
-void SubqueryForSet::createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_)
-{
-    source = std::make_unique<QueryPlan>();
-    interpreter.buildQueryPlan(*source);
-    if (table_)
-        table = table_;
-}
+// void SubqueryForSet::createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_)
+// {
+//     source = std::make_unique<QueryPlan>();
+//     interpreter.buildQueryPlan(*source);
+//     if (table_)
+//         table = table_;
+// }
 
-bool SubqueryForSet::hasSource() const
-{
-    return source != nullptr;
-}
+// bool SubqueryForSet::hasSource() const
+// {
+//     return source != nullptr;
+// }
 
-QueryPlanPtr SubqueryForSet::detachSource()
-{
-    auto res = std::move(source);
-    source = nullptr;
-    return res;
-}
+// QueryPlanPtr SubqueryForSet::detachSource()
+// {
+//     auto res = std::move(source);
+//     source = nullptr;
+//     return res;
+// }
 
 
 std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseToBuild(const String & key)
@@ -339,15 +364,15 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     {
         auto set = external_table_set->buildOrderedSetInplace(context);
         if (set)
-            return subquery.set = set;
+            return set_and_key->set = set;
     }
 
     auto plan = buildPlan(context);
     if (!plan)
         return nullptr;
 
-    subquery.set->fillSetElements();
-    subquery.set->initSetElements();
+    set_and_key->set->fillSetElements();
+    set_and_key->set->initSetElements();
     auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
     auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
     pipeline.complete(std::make_shared<EmptySink>(Block()));
@@ -355,15 +380,15 @@ SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
     CompletedPipelineExecutor executor(pipeline);
     executor.execute();
 
-    subquery.set->checkIsCreated();
+    set_and_key->set->checkIsCreated();
 
-    return subquery.set;
+    return set_and_key->set;
 }
 
 SetPtr FutureSetFromSubquery::get() const
 {
-    if (subquery.set != nullptr && subquery.set->isCreated())
-        return subquery.set;
+    if (set_and_key->set != nullptr && set_and_key->set->isCreated())
+        return set_and_key->set;
 
     return nullptr;
 }
@@ -380,22 +405,20 @@ static SizeLimits getSizeLimitsForSet(const Settings & settings)
 
 std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context)
 {
-    if (subquery.set->isCreated())
+    if (set_and_key->set->isCreated())
         return nullptr;
 
     const auto & settings = context->getSettingsRef();
 
-    auto plan = subquery.detachSource();
-    auto description = subquery.key;
+    auto plan = std::move(source);
 
     if (!plan)
         return nullptr;
 
     auto creating_set = std::make_unique<CreatingSetStep>(
             plan->getCurrentDataStream(),
-            description,
-            subquery,
-            shared_from_this(),
+            set_and_key,
+            external_table,
             SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
             context);
     creating_set->setStepDescription("Create set for subquery");
@@ -421,25 +444,49 @@ FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
     set->finishInsert();
 }
 
-FutureSetFromSubquery::FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, const Settings & settings)
-    : subquery(std::move(subquery_)), external_table_set(std::move(external_table_set_))
+FutureSetFromSubquery::FutureSetFromSubquery(
+    String key,
+    std::unique_ptr<QueryPlan> source_,
+    StoragePtr external_table_,
+    FutureSetPtr external_table_set_,
+    const Settings & settings)
+    : external_table(std::move(external_table_))
+    , external_table_set(std::move(external_table_set_))
+    , source(std::move(source_))
 {
+    set_and_key = std::make_shared<SetAndKey>();
+    set_and_key->key = std::move(key);
+
     bool create_ordered_set = false;
     auto size_limits = getSizeLimitsForSet(settings);
-    subquery.set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
-    if (subquery.source)
-        subquery.set->setHeader(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+    set_and_key->set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
 }
 
-void FutureSetFromSubquery::setQueryPlan(std::unique_ptr<QueryPlan> source)
+FutureSetFromSubquery::FutureSetFromSubquery(
+    String key,
+    QueryTreeNodePtr query_tree_,
+    //FutureSetPtr external_table_set_,
+    const Settings & settings)
+    : query_tree(std::move(query_tree_))
 {
-    subquery.source = std::move(source);
-    subquery.set->setHeader(subquery.source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+    set_and_key = std::make_shared<SetAndKey>();
+    set_and_key->key = std::move(key);
+
+    bool create_ordered_set = false;
+    auto size_limits = getSizeLimitsForSet(settings);
+    set_and_key->set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+}
+
+void FutureSetFromSubquery::setQueryPlan(std::unique_ptr<QueryPlan> source_)
+{
+    source = std::move(source_);
+    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
 }
 
 const DataTypes & FutureSetFromSubquery::getTypes() const
 {
-    return subquery.set->getElementsTypes();
+    return set_and_key->set->getElementsTypes();
 }
 
 SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 49545ad1e2a..339f4a6b435 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -24,6 +24,16 @@ using QueryTreeNodePtr = std::shared_ptr<IQueryTreeNode>;
 
 struct Settings;
 
+/// This is a structure for prepared sets cache.
+/// SetPtr can be taken from cache, so we should pass holder for it.
+struct SetAndKey
+{
+    String key;
+    SetPtr set;
+};
+
+using SetAndKeyPtr = std::shared_ptr<SetAndKey>;
+
 /// Represents a set in a query that might be referenced at analysis time and built later during execution.
 /// Also it can represent a constant set that is ready to use.
 /// At analysis stage the FutureSets are created but not necessarily filled. Then for non-constant sets there
@@ -35,22 +45,20 @@ public:
     virtual ~FutureSet() = default;
 
     virtual SetPtr get() const = 0;
-    virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
-
     virtual const DataTypes & getTypes() const = 0;
+    virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
 };
 
 using FutureSetPtr = std::shared_ptr<FutureSet>;
 
-
 class FutureSetFromStorage : public FutureSet
 {
 public:
     FutureSetFromStorage(SetPtr set_);
 
     SetPtr get() const override;
-    SetPtr buildOrderedSetInplace(const ContextPtr &) override;
     const DataTypes & getTypes() const override;
+    SetPtr buildOrderedSetInplace(const ContextPtr &) override;
 
 private:
     SetPtr set;
@@ -58,80 +66,67 @@ private:
 
 
 /// Information on how to build set for the [GLOBAL] IN section.
-class SubqueryForSet
+// class SubqueryForSet
+// {
+// public:
+
+//     void createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_ = nullptr);
+
+//     bool hasSource() const;
+
+//     /// Returns query plan for the set's source
+//     /// and removes it from SubqueryForSet because we need to build it only once.
+//     std::unique_ptr<QueryPlan> detachSource();
+
+//     /// Build this set from the result of the subquery.
+//     String key;
+//     SetPtr set;
+
+//     /// If set, put the result into the table.
+//     /// This is a temporary table for transferring to remote servers for distributed query processing.
+//     StoragePtr table;
+
+//     /// The source is obtained using the InterpreterSelectQuery subquery.
+//     std::unique_ptr<QueryPlan> source;
+//     QueryTreeNodePtr query_tree;
+// };
+
+class FutureSetFromSubquery : public FutureSet
 {
 public:
+    FutureSetFromSubquery(
+        String key,
+        std::unique_ptr<QueryPlan> source_,
+        StoragePtr external_table_,
+        FutureSetPtr external_table_set_,
+        const Settings & settings);
 
-    void createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_ = nullptr);
-
-    bool hasSource() const;
-
-    /// Returns query plan for the set's source
-    /// and removes it from SubqueryForSet because we need to build it only once.
-    std::unique_ptr<QueryPlan> detachSource();
-
-    /// Build this set from the result of the subquery.
-    String key;
-    SetPtr set;
-
-    /// If set, put the result into the table.
-    /// This is a temporary table for transferring to remote servers for distributed query processing.
-    StoragePtr table;
-
-    /// The source is obtained using the InterpreterSelectQuery subquery.
-    std::unique_ptr<QueryPlan> source;
-    QueryTreeNodePtr query_tree;
-};
-
-class FutureSetFromSubquery : public FutureSet, public std::enable_shared_from_this<FutureSetFromSubquery>
-{
-public:
-    FutureSetFromSubquery(SubqueryForSet subquery_, FutureSetPtr external_table_set_, const Settings & settings);
+    FutureSetFromSubquery(
+        String key,
+        QueryTreeNodePtr query_tree_,
+        //FutureSetPtr external_table_set_,
+        const Settings & settings);
 
     SetPtr get() const override;
-
+    const DataTypes & getTypes() const override;
     SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
     std::unique_ptr<QueryPlan> build(const ContextPtr & context);
 
-    const DataTypes & getTypes() const override;
-
-    SubqueryForSet & getSubquery() { return subquery; }
-    void setQueryPlan(std::unique_ptr<QueryPlan> source);
+    QueryTreeNodePtr detachQueryTree() { return std::move(query_tree); }
+    void setQueryPlan(std::unique_ptr<QueryPlan> source_);
 
 private:
-    SubqueryForSet subquery;
+    SetAndKeyPtr set_and_key;
+    StoragePtr external_table;
     FutureSetPtr external_table_set;
 
+    std::unique_ptr<QueryPlan> source;
+    QueryTreeNodePtr query_tree;
+
     std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context);
 };
 
-// struct PreparedSetKey
-// {
-//     using Hash = std::pair<UInt64, UInt64>;
-
-//     /// Prepared sets for tuple literals are indexed by the hash of the tree contents and by the desired
-//     /// data types of set elements (two different Sets can be required for two tuples with the same contents
-//     /// if left hand sides of the IN operators have different types).
-//     static PreparedSetKey forLiteral(Hash hash, DataTypes types_);
-
-//     /// Prepared sets for subqueries are indexed only by the AST contents because the type of the resulting
-//     /// set is fully determined by the subquery.
-//     static PreparedSetKey forSubquery(Hash hash);
-
-//     Hash ast_hash;
-//     DataTypes types; /// Empty for subqueries.
-
-//     bool operator==(const PreparedSetKey & other) const;
-
-//     String toString() const;
-
-//     struct Hashing
-//     {
-//         UInt64 operator()(const PreparedSetKey & key) const { return key.ast_hash.first; }
-//     };
-// };
-
 class PreparedSets
 {
 public:
@@ -142,30 +137,30 @@ public:
         UInt64 operator()(const Hash & key) const { return key.first ^ key.second; }
     };
 
-    // struct SetAndName
-    // {
-    //     String name;
-    //     std::shared_ptr<FutureSetFromSubquery> set;
-    // };
-
     using SetsFromTuple = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSet>>, Hashing>;
     using SetsFromStorage = std::unordered_map<Hash, std::shared_ptr<FutureSetFromStorage>, Hashing>;
     using SetsFromSubqueries = std::unordered_map<Hash, std::shared_ptr<FutureSetFromSubquery>, Hashing>;
 
     FutureSetPtr addFromStorage(const Hash & key, SetPtr set_);
     FutureSetPtr addFromTuple(const Hash & key, Block block, const Settings & settings);
-    FutureSetPtr addFromSubquery(const Hash & key, SubqueryForSet subquery, const Settings & settings, FutureSetPtr external_table_set);
+
+    FutureSetPtr addFromSubquery(
+        const Hash & key,
+        std::unique_ptr<QueryPlan> source,
+        StoragePtr external_table,
+        FutureSetPtr external_table_set,
+        const Settings & settings);
+
+    FutureSetPtr addFromSubquery(
+        const Hash & key,
+        QueryTreeNodePtr query_tree,
+        const Settings & settings);
 
     FutureSetPtr findTuple(const Hash & key, const DataTypes & types) const;
     std::shared_ptr<FutureSetFromStorage> findStorage(const Hash & key) const;
     std::shared_ptr<FutureSetFromSubquery> findSubquery(const Hash & key) const;
 
-    //FutureSetPtr getFuture(const PreparedSetKey & key) const;
-
-    /// Get subqueries and clear them.
-    /// We need to build a plan for subqueries just once. That's why we can clear them after accessing them.
-    /// SetPtr would still be available for consumers of PreparedSets.
-    std::vector<std::shared_ptr<FutureSetFromSubquery>> detachSubqueries();
+    std::vector<std::shared_ptr<FutureSetFromSubquery>> getSubqueries();
 
     const SetsFromTuple & getSetsFromTuple() const { return sets_from_tuple; }
     const SetsFromStorage & getSetsFromStorage() const { return sets_from_storage; }
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index b0e6b272c9f..df3558745fb 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -46,12 +46,6 @@ public:
         auto in_second_argument_node_type = in_second_argument->getNodeType();
 
         const auto & settings = planner_context.getQueryContext()->getSettingsRef();
-
-        // String set_key = planner_context.createSetKey(in_second_argument);
-
-        // if (planner_context.hasSet(set_key))
-        //     return;
-
         auto & sets = planner_context.getPreparedSets();
 
         /// Tables and table functions are replaced with subquery at Analysis stage, except special Set table.
@@ -129,27 +123,7 @@ public:
                 subquery_to_execute = std::move(subquery_for_table);
             }
 
-            // auto subquery_options = select_query_options.subquery();
-            // Planner subquery_planner(
-            //     in_second_argument,
-            //     subquery_options,
-            //     planner_context.getGlobalPlannerContext());
-            // subquery_planner.buildQueryPlanIfNeeded();
-
-            // const auto & settings = planner_context.getQueryContext()->getSettingsRef();
-            // SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
-            // bool tranform_null_in = settings.transform_null_in;
-            // auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, tranform_null_in);
-
-            SubqueryForSet subquery_for_set;
-            subquery_for_set.key = planner_context.createSetKey(in_second_argument);
-            subquery_for_set.query_tree = std::move(subquery_to_execute);
-            //subquery_for_set.source = std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan());
-
-            /// TODO
-            sets.addFromSubquery(set_key, std::move(subquery_for_set), settings, nullptr);
-
-            //planner_context.registerSet(set_key, PlannerSet(in_second_argument));
+            sets.addFromSubquery(set_key, std::move(subquery_to_execute), settings);
         }
         else
         {
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index e7c10f6ef7a..d524f2bed98 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -930,7 +930,7 @@ void addBuildSubqueriesForSetsStepIfNeeded(
     const PlannerContextPtr & planner_context,
     const std::vector<ActionsDAGPtr> & result_actions_to_execute)
 {
-    auto subqueries = planner_context->getPreparedSets().detachSubqueries();
+    auto subqueries = planner_context->getPreparedSets().getSubqueries();
     std::unordered_set<const FutureSet *> useful_sets;
 
     //PreparedSets::SubqueriesForSets subqueries_for_sets;
@@ -944,10 +944,10 @@ void addBuildSubqueriesForSetsStepIfNeeded(
 
     for (auto & subquery : subqueries)
     {
-        auto & subquery_for_set = subquery->getSubquery();
+        auto query_tree = subquery->detachQueryTree();
         auto subquery_options = select_query_options.subquery();
         Planner subquery_planner(
-            subquery_for_set.query_tree,
+            query_tree,
             subquery_options,
             planner_context->getGlobalPlannerContext());
         subquery_planner.buildQueryPlanIfNeeded();
@@ -955,8 +955,6 @@ void addBuildSubqueriesForSetsStepIfNeeded(
         subquery->setQueryPlan(std::make_unique<QueryPlan>(std::move(subquery_planner).extractQueryPlan()));
     }
 
-    //addCreatingSetsStep(query_plan, std::move(subqueries_for_sets), planner_context->getQueryContext());
-
     if (!subqueries.empty())
     {
         auto step = std::make_unique<DelayedCreatingSetsStep>(
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index 54d81dd7650..06099eef872 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -36,15 +36,13 @@ static ITransformingStep::Traits getTraits()
 
 CreatingSetStep::CreatingSetStep(
     const DataStream & input_stream_,
-    String description_,
-    SubqueryForSet & subquery_for_set_,
-    FutureSetPtr set_,
+    SetAndKeyPtr set_and_key_,
+    StoragePtr external_table_,
     SizeLimits network_transfer_limits_,
     ContextPtr context_)
     : ITransformingStep(input_stream_, Block{}, getTraits())
-    , description(std::move(description_))
-    , subquery_for_set(subquery_for_set_)
-    , set(std::move(set_))
+    , set_and_key(std::move(set_and_key_))
+    , external_table(std::move(external_table_))
     , network_transfer_limits(std::move(network_transfer_limits_))
     , context(std::move(context_))
 {
@@ -52,7 +50,7 @@ CreatingSetStep::CreatingSetStep(
 
 void CreatingSetStep::transformPipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings &)
 {
-    pipeline.addCreatingSetsTransform(getOutputStream().header, subquery_for_set, std::move(set), network_transfer_limits, context->getPreparedSetsCache());
+    pipeline.addCreatingSetsTransform(getOutputStream().header, std::move(set_and_key), std::move(external_table), network_transfer_limits, context->getPreparedSetsCache());
 }
 
 void CreatingSetStep::updateOutputStream()
@@ -65,16 +63,16 @@ void CreatingSetStep::describeActions(FormatSettings & settings) const
     String prefix(settings.offset, ' ');
 
     settings.out << prefix;
-    if (subquery_for_set.set)
+    if (set_and_key->set)
         settings.out << "Set: ";
 
-    settings.out << description << '\n';
+    settings.out << set_and_key->key << '\n';
 }
 
 void CreatingSetStep::describeActions(JSONBuilder::JSONMap & map) const
 {
-    if (subquery_for_set.set)
-        map.add("Set", description);
+    if (set_and_key->set)
+        map.add("Set", set_and_key->key);
 }
 
 
@@ -126,7 +124,7 @@ void CreatingSetsStep::describePipeline(FormatSettings & settings) const
     IQueryPlanStep::describePipeline(processors, settings);
 }
 
-void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subqueries, ContextPtr context)
+void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery, ContextPtr context)
 {
     DataStreams input_streams;
     input_streams.emplace_back(query_plan.getCurrentDataStream());
@@ -135,7 +133,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<Fut
     plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
     query_plan = QueryPlan();
 
-    for (auto & future_set : sets_from_subqueries)
+    for (auto & future_set : sets_from_subquery)
     {
         if (future_set->get())
             continue;
@@ -193,7 +191,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets,
     if (!prepared_sets)
         return;
 
-    auto subqueries = prepared_sets->detachSubqueries();
+    auto subqueries = prepared_sets->getSubqueries();
     if (subqueries.empty())
         return;
 
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index c41bb782e0b..7110775da79 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -13,12 +13,11 @@ class CreatingSetStep : public ITransformingStep
 {
 public:
     CreatingSetStep(
-            const DataStream & input_stream_,
-            String description_,
-            SubqueryForSet & subquery_for_set_,
-            FutureSetPtr set_,
-            SizeLimits network_transfer_limits_,
-            ContextPtr context_);
+        const DataStream & input_stream_,
+        SetAndKeyPtr set_and_key_,
+        StoragePtr external_table_,
+        SizeLimits network_transfer_limits_,
+        ContextPtr context_);
 
     String getName() const override { return "CreatingSet"; }
 
@@ -30,9 +29,8 @@ public:
 private:
     void updateOutputStream() override;
 
-    String description;
-    SubqueryForSet & subquery_for_set;
-    FutureSetPtr set;
+    SetAndKeyPtr set_and_key;
+    StoragePtr external_table;
     SizeLimits network_transfer_limits;
     ContextPtr context;
 };
diff --git a/src/Processors/Transforms/CreatingSetsTransform.cpp b/src/Processors/Transforms/CreatingSetsTransform.cpp
index aa374446f3e..afce1355f7a 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.cpp
+++ b/src/Processors/Transforms/CreatingSetsTransform.cpp
@@ -25,13 +25,13 @@ CreatingSetsTransform::~CreatingSetsTransform() = default;
 CreatingSetsTransform::CreatingSetsTransform(
     Block in_header_,
     Block out_header_,
-    SubqueryForSet & subquery_for_set_,
-    FutureSetPtr set_,
+    SetAndKeyPtr set_and_key_,
+    StoragePtr external_table_,
     SizeLimits network_transfer_limits_,
     PreparedSetsCachePtr prepared_sets_cache_)
     : IAccumulatingTransform(std::move(in_header_), std::move(out_header_))
-    , subquery(subquery_for_set_)
-    , set(std::move(set_))
+    , set_and_key(std::move(set_and_key_))
+    , external_table(std::move(external_table_))
     , network_transfer_limits(std::move(network_transfer_limits_))
     , prepared_sets_cache(std::move(prepared_sets_cache_))
 {
@@ -54,31 +54,30 @@ void CreatingSetsTransform::work()
 void CreatingSetsTransform::startSubquery()
 {
     /// Lookup the set in the cache if we don't need to build table.
-    if (prepared_sets_cache && !subquery.table)
+    if (prepared_sets_cache && !external_table)
     {
         /// Try to find the set in the cache and wait for it to be built.
         /// Retry if the set from cache fails to be built.
         while (true)
         {
-            auto from_cache = prepared_sets_cache->findOrPromiseToBuild(subquery.key);
+            auto from_cache = prepared_sets_cache->findOrPromiseToBuild(set_and_key->key);
             if (from_cache.index() == 0)
             {
-                LOG_TRACE(log, "Building set, key: {}", subquery.key);
+                LOG_TRACE(log, "Building set, key: {}", set_and_key->key);
                 promise_to_build = std::move(std::get<0>(from_cache));
             }
             else
             {
-                LOG_TRACE(log, "Waiting for set to be build by another thread, key: {}", subquery.key);
+                LOG_TRACE(log, "Waiting for set to be build by another thread, key: {}", set_and_key->key);
                 SharedSet set_built_by_another_thread = std::move(std::get<1>(from_cache));
                 const SetPtr & ready_set = set_built_by_another_thread.get();
                 if (!ready_set)
                 {
-                    LOG_TRACE(log, "Failed to use set from cache, key: {}", subquery.key);
+                    LOG_TRACE(log, "Failed to use set from cache, key: {}", set_and_key->key);
                     continue;
                 }
 
-                //subquery.promise_to_fill_set.set_value(ready_set);
-                subquery.set = ready_set; //.reset();
+                set_and_key->set = ready_set;
                 done_with_set = true;
                 set_from_cache = true;
             }
@@ -86,21 +85,19 @@ void CreatingSetsTransform::startSubquery()
         }
     }
 
-    if (subquery.set && !set_from_cache)
-        LOG_TRACE(log, "Creating set, key: {}", subquery.key);
-    if (subquery.table)
+    if (set_and_key->set && !set_from_cache)
+        LOG_TRACE(log, "Creating set, key: {}", set_and_key->key);
+    if (external_table)
         LOG_TRACE(log, "Filling temporary table.");
 
-    // std::cerr << StackTrace().toString() << std::endl;
-
-    if (subquery.table)
+    if (external_table)
         /// TODO: make via port
-        table_out = QueryPipeline(subquery.table->write({}, subquery.table->getInMemoryMetadataPtr(), nullptr, /*async_insert=*/false));
+        table_out = QueryPipeline(external_table->write({}, external_table->getInMemoryMetadataPtr(), nullptr, /*async_insert=*/false));
 
-    done_with_set = !subquery.set || set_from_cache;
-    done_with_table = !subquery.table;
+    done_with_set = !set_and_key->set || set_from_cache;
+    done_with_table = !external_table;
 
-    if ((done_with_set && !set_from_cache) /*&& done_with_join*/ && done_with_table)
+    if ((done_with_set && !set_from_cache) && done_with_table)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Logical error: nothing to do with subquery");
 
     if (table_out.initialized())
@@ -120,9 +117,9 @@ void CreatingSetsTransform::finishSubquery()
     }
     else if (read_rows != 0)
     {
-        if (subquery.set)
-            LOG_DEBUG(log, "Created Set with {} entries from {} rows in {} sec.", subquery.set->getTotalRowCount(), read_rows, seconds);
-        if (subquery.table)
+        if (set_and_key->set)
+            LOG_DEBUG(log, "Created Set with {} entries from {} rows in {} sec.", set_and_key->set->getTotalRowCount(), read_rows, seconds);
+        if (external_table)
             LOG_DEBUG(log, "Created Table with {} rows in {} sec.", read_rows, seconds);
     }
     else
@@ -135,12 +132,6 @@ void CreatingSetsTransform::init()
 {
     is_initialized = true;
 
-    // if (subquery.set)
-    // {
-    //     //std::cerr << "=========== " << getInputPort().getHeader().dumpStructure() << std::endl;
-    //     subquery.set->setHeader(getInputPort().getHeader().getColumnsWithTypeAndName());
-    // }
-
     watch.restart();
     startSubquery();
 }
@@ -152,7 +143,7 @@ void CreatingSetsTransform::consume(Chunk chunk)
 
     if (!done_with_set)
     {
-        if (!subquery.set->insertFromBlock(block.getColumnsWithTypeAndName()))
+        if (!set_and_key->set->insertFromBlock(block.getColumnsWithTypeAndName()))
             done_with_set = true;
     }
 
@@ -175,12 +166,11 @@ void CreatingSetsTransform::consume(Chunk chunk)
 
 Chunk CreatingSetsTransform::generate()
 {
-    if (subquery.set && !set_from_cache)
+    if (set_and_key->set && !set_from_cache)
     {
-        subquery.set->finishInsert();
-        //subquery.promise_to_fill_set.set_value(subquery.set);
+        set_and_key->set->finishInsert();
         if (promise_to_build)
-            promise_to_build->set_value(subquery.set);
+            promise_to_build->set_value(set_and_key->set);
     }
 
     if (table_out.initialized())
diff --git a/src/Processors/Transforms/CreatingSetsTransform.h b/src/Processors/Transforms/CreatingSetsTransform.h
index 27c330bdbc3..d1ec7dcbca7 100644
--- a/src/Processors/Transforms/CreatingSetsTransform.h
+++ b/src/Processors/Transforms/CreatingSetsTransform.h
@@ -29,8 +29,8 @@ public:
     CreatingSetsTransform(
         Block in_header_,
         Block out_header_,
-        SubqueryForSet & subquery_for_set_,
-        FutureSetPtr set_,
+        SetAndKeyPtr set_and_key_,
+        StoragePtr external_table_,
         SizeLimits network_transfer_limits_,
         PreparedSetsCachePtr prepared_sets_cache_);
 
@@ -43,8 +43,8 @@ public:
     Chunk generate() override;
 
 private:
-    SubqueryForSet & subquery;
-    FutureSetPtr set;
+    SetAndKeyPtr set_and_key;
+    StoragePtr external_table;
     std::optional<std::promise<SetPtr>> promise_to_build;
 
     QueryPipeline table_out;
diff --git a/src/QueryPipeline/QueryPipelineBuilder.cpp b/src/QueryPipeline/QueryPipelineBuilder.cpp
index dca185cec8b..dedf85e409c 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.cpp
+++ b/src/QueryPipeline/QueryPipelineBuilder.cpp
@@ -571,8 +571,8 @@ std::unique_ptr<QueryPipelineBuilder> QueryPipelineBuilder::joinPipelinesRightLe
 
 void QueryPipelineBuilder::addCreatingSetsTransform(
     const Block & res_header,
-    SubqueryForSet & subquery_for_set,
-    FutureSetPtr set,
+    SetAndKeyPtr set_and_key,
+    StoragePtr external_table,
     const SizeLimits & limits,
     PreparedSetsCachePtr prepared_sets_cache)
 {
@@ -581,8 +581,8 @@ void QueryPipelineBuilder::addCreatingSetsTransform(
     auto transform = std::make_shared<CreatingSetsTransform>(
             getHeader(),
             res_header,
-            subquery_for_set,
-            std::move(set),
+            std::move(set_and_key),
+            std::move(external_table),
             limits,
             std::move(prepared_sets_cache));
 
diff --git a/src/QueryPipeline/QueryPipelineBuilder.h b/src/QueryPipeline/QueryPipelineBuilder.h
index 134de59520d..e744e3612ce 100644
--- a/src/QueryPipeline/QueryPipelineBuilder.h
+++ b/src/QueryPipeline/QueryPipelineBuilder.h
@@ -33,8 +33,8 @@ class TableJoin;
 class QueryPipelineBuilder;
 using QueryPipelineBuilderPtr = std::unique_ptr<QueryPipelineBuilder>;
 
-class FutureSet;
-using FutureSetPtr = std::shared_ptr<FutureSet>;
+struct SetAndKey;
+using SetAndKeyPtr = std::shared_ptr<SetAndKey>;
 
 class PreparedSetsCache;
 using PreparedSetsCachePtr = std::shared_ptr<PreparedSetsCache>;
@@ -146,8 +146,8 @@ public:
 
     void addCreatingSetsTransform(
         const Block & res_header,
-        SubqueryForSet & subquery_for_set,
-        FutureSetPtr set,
+        SetAndKeyPtr set_and_key,
+        StoragePtr external_table,
         const SizeLimits & limits,
         PreparedSetsCachePtr prepared_sets_cache);
 
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index c3cf146e88e..125fe98203f 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -978,7 +978,7 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
                 if (ranges.ranges.empty())
                     break;
 
-                auto & index_and_condition = skip_indexes.useful_indices[idx];
+                const auto & index_and_condition = skip_indexes.useful_indices[idx];
                 auto & stat = useful_indices_stat[idx];
                 stat.total_parts.fetch_add(1, std::memory_order_relaxed);
                 stat.total_granules.fetch_add(ranges.ranges.getNumberOfMarks(), std::memory_order_relaxed);
@@ -1006,7 +1006,7 @@ RangesInDataParts MergeTreeDataSelectExecutor::filterPartsByPrimaryKeyAndSkipInd
                 if (ranges.ranges.empty())
                     break;
 
-                auto & indices_and_condition = skip_indexes.merged_indices[idx];
+                const auto & indices_and_condition = skip_indexes.merged_indices[idx];
                 auto & stat = merged_indices_stat[idx];
                 stat.total_parts.fetch_add(1, std::memory_order_relaxed);
 

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 1139/1478] 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 1140/1478] 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 1141/1478] 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 1142/1478] 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 1143/1478] 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 1144/1478] 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 1145/1478] 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 1146/1478] 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 1147/1478] 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 1148/1478] 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 1149/1478] 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 1150/1478] 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 1151/1478] 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 1152/1478] 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 1153/1478] 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 1154/1478] 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 1155/1478] 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 1156/1478] 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 1157/1478] 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 26ba3d8f13a078d7b41be00ca9c687e59f04774a Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Thu, 22 Jun 2023 10:01:22 -0300
Subject: [PATCH 1158/1478] test for #36894

---
 ...02302_lc_nullable_string_insert_as_number.reference |  1 +
 .../02302_lc_nullable_string_insert_as_number.sql      | 10 ++++++++++
 2 files changed, 11 insertions(+)
 create mode 100644 tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
 create mode 100644 tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql

diff --git a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
new file mode 100644
index 00000000000..573541ac970
--- /dev/null
+++ b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
@@ -0,0 +1 @@
+0
diff --git a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql
new file mode 100644
index 00000000000..89b31e2b2b0
--- /dev/null
+++ b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql
@@ -0,0 +1,10 @@
+DROP TABLE IF EXISTS lc_nullable_string;
+
+CREATE TABLE lc_nullable_string(`c1` LowCardinality(Nullable(String)) DEFAULT CAST(NULL, 'LowCardinality(Nullable(String))')) 
+ENGINE = Memory;
+
+INSERT INTO lc_nullable_string (c1) FORMAT Values (0);
+
+SELECT * FROM lc_nullable_string;
+
+DROP TABLE lc_nullable_string;

From b1d37fbc6bbeac4613c4e58555a56b1092f4018b Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Thu, 22 Jun 2023 10:23:32 -0300
Subject: [PATCH 1159/1478] test for #36894

---
 .../02302_lc_nullable_string_insert_as_number.reference        | 1 +
 .../0_stateless/02302_lc_nullable_string_insert_as_number.sql  | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
index 573541ac970..0d66ea1aee9 100644
--- a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
+++ b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.reference
@@ -1 +1,2 @@
 0
+1
diff --git a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql
index 89b31e2b2b0..9859c1559d5 100644
--- a/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql
+++ b/tests/queries/0_stateless/02302_lc_nullable_string_insert_as_number.sql
@@ -4,7 +4,8 @@ CREATE TABLE lc_nullable_string(`c1` LowCardinality(Nullable(String)) DEFAULT CA
 ENGINE = Memory;
 
 INSERT INTO lc_nullable_string (c1) FORMAT Values (0);
+INSERT INTO lc_nullable_string (c1) Values (1);
 
-SELECT * FROM lc_nullable_string;
+SELECT * FROM lc_nullable_string ORDER BY c1;
 
 DROP TABLE lc_nullable_string;

From 22e49748b5ff129422fca4ff2da92b26e38d3906 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Thu, 22 Jun 2023 14:23:04 +0000
Subject: [PATCH 1160/1478] Cleanup.

---
 src/Analyzer/Passes/QueryAnalysisPass.cpp     |   4 +-
 src/Analyzer/SetUtils.cpp                     |  13 +-
 src/Analyzer/SetUtils.h                       |  10 +-
 src/Functions/in.cpp                          |   9 +-
 src/Interpreters/ActionsVisitor.cpp           |  37 +-
 .../ClusterProxy/SelectStreamFactory.cpp      |   8 +-
 .../ClusterProxy/SelectStreamFactory.h        |   4 +-
 .../ClusterProxy/executeQuery.cpp             |   1 -
 src/Interpreters/ExpressionAnalyzer.cpp       | 119 -----
 src/Interpreters/ExpressionAnalyzer.h         |   8 -
 src/Interpreters/GlobalSubqueriesVisitor.h    |  48 +-
 src/Interpreters/InterpreterSelectQuery.cpp   |   3 -
 src/Interpreters/PreparedSets.cpp             | 493 ++++++------------
 src/Interpreters/PreparedSets.h               |  65 ++-
 src/Interpreters/Set.cpp                      |  13 +-
 src/Interpreters/Set.h                        |  22 +-
 src/Interpreters/SetKeys.h                    |  18 +
 src/Planner/CollectSets.cpp                   |  18 +-
 src/Planner/CollectSets.h                     |   2 +-
 src/Planner/Planner.cpp                       |   9 +-
 src/Planner/PlannerActionsVisitor.cpp         |   6 +-
 src/Planner/PlannerContext.cpp                |  46 --
 src/Planner/PlannerContext.h                  |  72 +--
 src/Planner/PlannerJoinTree.cpp               |  21 +-
 src/Planner/Utils.cpp                         |   3 +-
 src/Planner/Utils.h                           |   1 -
 .../CreateSetAndFilterOnTheFlyStep.cpp        |   2 +-
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  18 +-
 src/Processors/QueryPlan/CreatingSetsStep.h   |  10 +-
 .../QueryPlan/DistributedCreateLocalPlan.cpp  |   3 +-
 .../QueryPlan/DistributedCreateLocalPlan.h    |   1 -
 .../QueryPlan/ReadFromMergeTree.cpp           |  27 -
 src/Processors/QueryPlan/ReadFromRemote.cpp   |   6 +-
 src/Processors/QueryPlan/ReadFromRemote.h     |   2 -
 src/Storages/KVStorageUtils.cpp               |   1 -
 src/Storages/MergeTree/KeyCondition.cpp       |  33 +-
 .../MergeTree/MergeTreeDataSelectExecutor.cpp |   4 +-
 .../MergeTreeIndexConditionBloomFilter.cpp    |  44 +-
 .../MergeTree/MergeTreeIndexFullText.cpp      |   9 +-
 .../MergeTree/MergeTreeIndexInverted.cpp      |  14 +-
 src/Storages/MergeTree/PartitionPruner.cpp    |   9 -
 src/Storages/StorageDistributed.cpp           |   5 +-
 src/Storages/StorageMergeTree.cpp             |   3 +-
 src/Storages/StorageReplicatedMergeTree.cpp   |   3 +-
 src/Storages/StorageSet.cpp                   |   4 +-
 .../System/StorageSystemZooKeeper.cpp         |  10 +-
 src/Storages/VirtualColumnUtils.cpp           |  20 -
 src/Storages/buildQueryTreeForShard.cpp       |  17 +-
 48 files changed, 343 insertions(+), 955 deletions(-)
 create mode 100644 src/Interpreters/SetKeys.h

diff --git a/src/Analyzer/Passes/QueryAnalysisPass.cpp b/src/Analyzer/Passes/QueryAnalysisPass.cpp
index 98f40dc4c15..163092f1b7f 100644
--- a/src/Analyzer/Passes/QueryAnalysisPass.cpp
+++ b/src/Analyzer/Passes/QueryAnalysisPass.cpp
@@ -5211,14 +5211,14 @@ ProjectionNames QueryAnalyzer::resolveFunction(QueryTreeNodePtr & node, Identifi
 
             const auto & settings = scope.context->getSettingsRef();
 
-            auto result_block = makeSetForConstantValue(first_argument_constant_type,
+            auto result_block = getSetElementsForConstantValue(first_argument_constant_type,
                 second_argument_constant_literal,
                 second_argument_constant_type,
                 settings.transform_null_in);
 
             SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
 
-            auto set = std::make_shared<Set>(size_limits_for_set, false /*fill_set_elements*/, 0, settings.transform_null_in);
+            auto set = std::make_shared<Set>(size_limits_for_set, 0, settings.transform_null_in);
 
             set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
             set->insertFromBlock(result_block.getColumnsWithTypeAndName());
diff --git a/src/Analyzer/SetUtils.cpp b/src/Analyzer/SetUtils.cpp
index 2fb05449714..15eec16e899 100644
--- a/src/Analyzer/SetUtils.cpp
+++ b/src/Analyzer/SetUtils.cpp
@@ -118,7 +118,7 @@ Block createBlockFromCollection(const Collection & collection, const DataTypes &
 
 }
 
-Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in)
+Block getSetElementsForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in)
 {
     DataTypes set_element_types = {expression_type};
     const auto * lhs_tuple_type = typeid_cast<const DataTypeTuple *>(expression_type.get());
@@ -135,9 +135,6 @@ Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field &
     size_t lhs_type_depth = getCompoundTypeDepth(*expression_type);
     size_t rhs_type_depth = getCompoundTypeDepth(*value_type);
 
-    // SizeLimits size_limits_for_set = {settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode};
-    // bool transform_null_in = settings.transform_null_in;
-
     Block result_block;
 
     if (lhs_type_depth == rhs_type_depth)
@@ -171,14 +168,6 @@ Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field &
     }
 
     return result_block;
-
-    // auto set = std::make_shared<Set>(size_limits_for_set, true /*fill_set_elements*/, tranform_null_in);
-
-    // set->setHeader(result_block.cloneEmpty().getColumnsWithTypeAndName());
-    // set->insertFromBlock(result_block.getColumnsWithTypeAndName());
-    // set->finishInsert();
-
-    // return set;
 }
 
 }
diff --git a/src/Analyzer/SetUtils.h b/src/Analyzer/SetUtils.h
index fdeaa4a3c48..c35b45dce59 100644
--- a/src/Analyzer/SetUtils.h
+++ b/src/Analyzer/SetUtils.h
@@ -12,18 +12,12 @@ namespace DB
 class Set;
 using SetPtr = std::shared_ptr<Set>;
 
-/** Make set for constant part of IN subquery.
+/** Get set elements for constant part of IN subquery.
   * Throws exception if parameters are not valid for IN function.
   *
   * Example: SELECT id FROM test_table WHERE id IN (1, 2, 3, 4);
   * Example: SELECT id FROM test_table WHERE id IN ((1, 2), (3, 4));
-  *
-  * @param expression_type - type of first argument of function IN.
-  * @param value - constant value of second argument of function IN.
-  * @param value_type - type of second argument of function IN.
-  *
-  * @return SetPtr for constant value.
   */
-Block makeSetForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in);
+Block getSetElementsForConstantValue(const DataTypePtr & expression_type, const Field & value, const DataTypePtr & value_type, bool transform_null_in);
 
 }
diff --git a/src/Functions/in.cpp b/src/Functions/in.cpp
index c19d1e72003..9045ba677f2 100644
--- a/src/Functions/in.cpp
+++ b/src/Functions/in.cpp
@@ -123,9 +123,12 @@ public:
         }
 
         auto future_set = column_set->getData();
-        auto set = future_set ? future_set->get() : nullptr;
-        if (!future_set || !set)
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Not-ready Set passed as the second argument for function '{}'", getName());
+        if (!future_set)
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "No Set is passed as the second argument for function '{}'", getName());
+
+        auto set = future_set->get();
+        if (!set)
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Not-ready Set is passed as the second argument for function '{}'", getName());
 
         auto set_types = set->getDataTypes();
 
diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index 7c3af4ce691..bf78868463a 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -445,19 +445,16 @@ FutureSetPtr makeExplicitSet(
     if (left_tuple_type && left_tuple_type->getElements().size() != 1)
         set_element_types = left_tuple_type->getElements();
 
-    for (auto & element_type : set_element_types)
-        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-            element_type = low_cardinality_type->getDictionaryType();
-
-    // if (!set_element_types.empty())
-    //     std::cerr << "========== " << set_element_types[0]->getName() << std::endl;
-
     auto set_element_keys = Set::getElementTypes(set_element_types, context->getSettingsRef().transform_null_in);
 
     auto set_key = right_arg->getTreeHash();
     if (auto set = prepared_sets.findTuple(set_key, set_element_keys))
         return set; /// Already prepared.
 
+    for (auto & element_type : set_element_types)
+        if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
+            element_type = low_cardinality_type->getDictionaryType();
+
     Block block;
     const auto & right_arg_func = std::dynamic_pointer_cast<ASTFunction>(right_arg);
     if (right_arg_func && (right_arg_func->name == "tuple" || right_arg_func->name == "array"))
@@ -1400,11 +1397,21 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
     {
         if (no_subqueries)
             return {};
-        //std::cerr << queryToString(right_in_operand) << std::endl;
 
         PreparedSets::Hash set_key;
         if (data.getContext()->getSettingsRef().allow_experimental_analyzer && !identifier)
         {
+            /// Here we can be only from mutation interpreter. Normal selects with analyzed use other interpreter.
+            /// This is a hacky way to allow reusing cache for prepared sets.
+            ///
+            /// Mutation is executed in two stages:
+            /// * first, query 'SELECT count() FROM table WHERE ...' is executed to get the set of affected parts (using analyzer)
+            /// * second, every part is mutated separately, where plan is build "manually", usign this code as well
+            /// To share the Set in between first and second stage, we should use the same hash.
+            /// New analyzer is uses a hash from query tree, so here we also build a query tree.
+            ///
+            /// Note : this code can be safely removed, but the test 02581_share_big_sets will be too slow (and fail by timeout).
+            /// Note : we should use new analyzer for mutations and remove this hack.
             InterpreterSelectQueryAnalyzer interpreter(right_in_operand, data.getContext(), SelectQueryOptions().analyze(true).subquery());
             const auto & query_tree = interpreter.getQueryTree();
             if (auto * query_node = query_tree->as<QueryNode>())
@@ -1414,12 +1421,6 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
         else
             set_key = right_in_operand->getTreeHash();
 
-        // std::cerr << set_key.toString() << std::endl;
-        // std::cerr << data.prepared_sets->getSets().size() << std::endl;
-        // std::cerr << reinterpret_cast<const void *>(data.prepared_sets.get()) << std::endl;
-        // for (const auto & [k, v] : data.prepared_sets->getSets())
-        //     std::cerr << "... " << k.toString();
-
         if (auto set = data.prepared_sets->findSubquery(set_key))
             return set;
 
@@ -1440,12 +1441,12 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
 
             if (!data.getContext()->isGlobalContext())
             {
-                // std::cerr << ".... checking for " << identifier->getColumnName() << std::endl;
+                /// If we are reading from storage, it can be an external table which is used for GLOBAL IN.
+                /// Here, we take FutureSet which is used to build external table.
+                /// It will be used if set is useful for primary key. During PK analysis
+                /// temporary table is not filled yet, so we need to fill it first.
                 if (auto tmp_table = data.getContext()->findExternalTable(identifier->getColumnName()))
-                {
                     external_table_set = tmp_table->future_set;
-                    // std::cerr << "Found " << reinterpret_cast<const void *>(tmp_table.get()) << " " << reinterpret_cast<const void *>(external_table_set.get()) << std::endl;
-                }
             }
         }
 
diff --git a/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp b/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
index 0f8a725e144..0cf3f360994 100644
--- a/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
+++ b/src/Interpreters/ClusterProxy/SelectStreamFactory.cpp
@@ -92,13 +92,11 @@ SelectStreamFactory::SelectStreamFactory(
     const Block & header_,
     const ColumnsDescriptionByShardNum & objects_by_shard_,
     const StorageSnapshotPtr & storage_snapshot_,
-    QueryProcessingStage::Enum processed_stage_,
-    PreparedSetsPtr prepared_sets_)
+    QueryProcessingStage::Enum processed_stage_)
     : header(header_),
     objects_by_shard(objects_by_shard_),
     storage_snapshot(storage_snapshot_),
-    processed_stage(processed_stage_),
-    prepared_sets(std::move(prepared_sets_))
+    processed_stage(processed_stage_)
 {
 }
 
@@ -119,7 +117,7 @@ void SelectStreamFactory::createForShard(
     auto emplace_local_stream = [&]()
     {
         local_plans.emplace_back(createLocalPlan(
-            query_ast, header, context, processed_stage, prepared_sets, shard_info.shard_num, shard_count, /*replica_num=*/0, /*replica_count=*/0, /*coordinator=*/nullptr));
+            query_ast, header, context, processed_stage, shard_info.shard_num, shard_count, /*replica_num=*/0, /*replica_count=*/0, /*coordinator=*/nullptr));
     };
 
     auto emplace_remote_stream = [&](bool lazy = false, time_t local_delay = 0)
diff --git a/src/Interpreters/ClusterProxy/SelectStreamFactory.h b/src/Interpreters/ClusterProxy/SelectStreamFactory.h
index b19012ddba6..030c0b77dd5 100644
--- a/src/Interpreters/ClusterProxy/SelectStreamFactory.h
+++ b/src/Interpreters/ClusterProxy/SelectStreamFactory.h
@@ -69,8 +69,7 @@ public:
         const Block & header_,
         const ColumnsDescriptionByShardNum & objects_by_shard_,
         const StorageSnapshotPtr & storage_snapshot_,
-        QueryProcessingStage::Enum processed_stage_,
-        PreparedSetsPtr prepared_sets_);
+        QueryProcessingStage::Enum processed_stage_);
 
     void createForShard(
         const Cluster::ShardInfo & shard_info,
@@ -95,7 +94,6 @@ public:
     const ColumnsDescriptionByShardNum objects_by_shard;
     const StorageSnapshotPtr storage_snapshot;
     QueryProcessingStage::Enum processed_stage;
-    PreparedSetsPtr prepared_sets;
 };
 
 }
diff --git a/src/Interpreters/ClusterProxy/executeQuery.cpp b/src/Interpreters/ClusterProxy/executeQuery.cpp
index a9cf3d55392..e2f1dfe8ba7 100644
--- a/src/Interpreters/ClusterProxy/executeQuery.cpp
+++ b/src/Interpreters/ClusterProxy/executeQuery.cpp
@@ -226,7 +226,6 @@ void executeQuery(
             std::move(remote_shards),
             header,
             processed_stage,
-            stream_factory.prepared_sets,
             main_table,
             table_func_ptr,
             new_context,
diff --git a/src/Interpreters/ExpressionAnalyzer.cpp b/src/Interpreters/ExpressionAnalyzer.cpp
index b05563cf29f..f27d23e8e94 100644
--- a/src/Interpreters/ExpressionAnalyzer.cpp
+++ b/src/Interpreters/ExpressionAnalyzer.cpp
@@ -450,77 +450,6 @@ void ExpressionAnalyzer::initGlobalSubqueriesAndExternalTables(bool do_global, b
 }
 
 
-// void ExpressionAnalyzer::tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options)
-// {
-//     if (!prepared_sets)
-//         return;
-
-//     auto set_key = PreparedSetKey::forSubquery(*subquery_or_table_name);
-
-//     if (prepared_sets->getFuture(set_key).isValid())
-//         return; /// Already prepared.
-
-//     if (auto set_ptr_from_storage_set = isPlainStorageSetInSubquery(subquery_or_table_name))
-//     {
-//         prepared_sets->set(set_key, set_ptr_from_storage_set);
-//         return;
-//     }
-
-//     auto build_set = [&] () -> SetPtr
-//     {
-//         LOG_TRACE(getLogger(), "Building set, key: {}", set_key.toString());
-
-//         auto interpreter_subquery = interpretSubquery(subquery_or_table_name, getContext(), {}, query_options);
-//         auto io = interpreter_subquery->execute();
-//         PullingAsyncPipelineExecutor executor(io.pipeline);
-
-//         SetPtr set = std::make_shared<Set>(settings.size_limits_for_set_used_with_index, true, getContext()->getSettingsRef().transform_null_in);
-//         set->setHeader(executor.getHeader().getColumnsWithTypeAndName());
-
-//         Block block;
-//         while (executor.pull(block))
-//         {
-//             if (block.rows() == 0)
-//                 continue;
-
-//             /// If the limits have been exceeded, give up and let the default subquery processing actions take place.
-//             if (!set->insertFromBlock(block.getColumnsWithTypeAndName()))
-//                 return nullptr;
-//         }
-
-//         set->finishInsert();
-
-//         return set;
-//     };
-
-//     SetPtr set;
-
-//     auto set_cache = getContext()->getPreparedSetsCache();
-//     if (set_cache)
-//     {
-//         auto from_cache = set_cache->findOrPromiseToBuild(set_key.toString());
-//         if (from_cache.index() == 0)
-//         {
-//             set = build_set();
-//             std::get<0>(from_cache).set_value(set);
-//         }
-//         else
-//         {
-//             LOG_TRACE(getLogger(), "Waiting for set, key: {}", set_key.toString());
-//             set = std::get<1>(from_cache).get();
-//         }
-//     }
-//     else
-//     {
-//         set = build_set();
-//     }
-
-//     if (!set)
-//         return;
-
-//     prepared_sets->set(set_key, std::move(set));
-// }
-
 SetPtr ExpressionAnalyzer::isPlainStorageSetInSubquery(const ASTPtr & subquery_or_table_name)
 {
     const auto * table = subquery_or_table_name->as<ASTTableIdentifier>();
@@ -534,54 +463,6 @@ SetPtr ExpressionAnalyzer::isPlainStorageSetInSubquery(const ASTPtr & subquery_o
     return storage_set->getSet();
 }
 
-
-/// Performance optimization for IN() if storage supports it.
-// void SelectQueryExpressionAnalyzer::makeSetsForIndex(const ASTPtr & node)
-// {
-//     if (!node || !storage() || !storage()->supportsIndexForIn())
-//         return;
-
-//     for (auto & child : node->children)
-//     {
-//         /// Don't descend into subqueries.
-//         if (child->as<ASTSubquery>())
-//             continue;
-
-//         /// Don't descend into lambda functions
-//         const auto * func = child->as<ASTFunction>();
-//         if (func && func->name == "lambda")
-//             continue;
-
-//         makeSetsForIndex(child);
-//     }
-
-//     const auto * func = node->as<ASTFunction>();
-//     if (func && functionIsInOrGlobalInOperator(func->name))
-//     {
-//         const IAST & args = *func->arguments;
-//         const ASTPtr & left_in_operand = args.children.at(0);
-
-//         if (storage()->mayBenefitFromIndexForIn(left_in_operand, getContext(), metadata_snapshot))
-//         {
-//             const ASTPtr & arg = args.children.at(1);
-//             if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
-//             {
-//                 if (settings.use_index_for_in_with_subqueries)
-//                     tryMakeSetForIndexFromSubquery(arg, query_options);
-//             }
-//             else
-//             {
-//                 auto temp_actions = std::make_shared<ActionsDAG>(columns_after_join);
-//                 getRootActions(left_in_operand, true, temp_actions);
-
-//                 if (prepared_sets && temp_actions->tryFindInOutputs(left_in_operand->getColumnName()))
-//                     makeExplicitSet(func, *temp_actions, true, getContext(), settings.size_limits_for_set, *prepared_sets);
-//             }
-//         }
-//     }
-// }
-
-
 void ExpressionAnalyzer::getRootActions(const ASTPtr & ast, bool no_makeset_for_subqueries, ActionsDAGPtr & actions, bool only_consts)
 {
     LogAST log;
diff --git a/src/Interpreters/ExpressionAnalyzer.h b/src/Interpreters/ExpressionAnalyzer.h
index e4a9e96c517..271c3943afc 100644
--- a/src/Interpreters/ExpressionAnalyzer.h
+++ b/src/Interpreters/ExpressionAnalyzer.h
@@ -141,11 +141,6 @@ public:
     void makeWindowDescriptionFromAST(const Context & context, const WindowDescriptions & existing_descriptions, WindowDescription & desc, const IAST * ast);
     void makeWindowDescriptions(ActionsDAGPtr actions);
 
-    /** Create Set from a subquery or a table expression in the query. The created set is suitable for using the index.
-      * The set will not be created if its size hits the limit.
-      */
-    // void tryMakeSetForIndexFromSubquery(const ASTPtr & subquery_or_table_name, const SelectQueryOptions & query_options = {});
-
     /** Checks if subquery is not a plain StorageSet.
       * Because while making set we will read data from StorageSet which is not allowed.
       * Returns valid SetPtr from StorageSet if the latter is used after IN or nullptr otherwise.
@@ -363,9 +358,6 @@ public:
     /// Deletes all columns except mentioned by SELECT, arranges the remaining columns and renames them to aliases.
     ActionsDAGPtr appendProjectResult(ExpressionActionsChain & chain) const;
 
-    /// Create Set-s that we make from IN section to use index on them.
-    // void makeSetsForIndex(const ASTPtr & node);
-
 private:
     StorageMetadataPtr metadata_snapshot;
     /// If non-empty, ignore all expressions not from this list.
diff --git a/src/Interpreters/GlobalSubqueriesVisitor.h b/src/Interpreters/GlobalSubqueriesVisitor.h
index 8c784d3c2ff..5b633fee9b6 100644
--- a/src/Interpreters/GlobalSubqueriesVisitor.h
+++ b/src/Interpreters/GlobalSubqueriesVisitor.h
@@ -69,7 +69,6 @@ public:
 
         void addExternalStorage(ASTPtr & ast, const Names & required_columns, bool set_alias = false)
         {
-            // std::cerr << "=============== addExternalStorage is remote " << is_remote << std::endl;
             /// With nondistributed queries, creating temporary tables does not make sense.
             if (!is_remote)
                 return;
@@ -163,49 +162,20 @@ public:
                 nullptr,
                 /*create_for_global_subquery*/ true);
             StoragePtr external_storage = external_storage_holder->getTable();
-
-            // std::cerr << "......... adding external table " << external_table_name << std::endl;
-
             external_tables.emplace(external_table_name, external_storage_holder);
 
-            /// We need to materialize external tables immediately because reading from distributed
-            /// tables might generate local plans which can refer to external tables during index
-            /// analysis. It's too late to populate the external table via CreatingSetsTransform.
-            // if (is_explain)
-            // {
-            //     /// Do not materialize external tables if it's explain statement.
-            // }
-            // else if (getContext()->getSettingsRef().use_index_for_in_with_subqueries)
-            // {
-            //     auto external_table = external_storage_holder->getTable();
-            //     auto table_out = external_table->write({}, external_table->getInMemoryMetadataPtr(), getContext());
-            //     auto io = interpreter->execute();
-            //     io.pipeline.complete(std::move(table_out));
-            //     CompletedPipelineExecutor executor(io.pipeline);
-            //     executor.execute();
-            // }
-            // else
+            auto set_key = database_and_table_name->getTreeHash();
+
+            if (!prepared_sets->findSubquery(set_key))
             {
-                // auto & subquery_for_set = prepared_sets->getSubquery(external_table_name);
-                // subquery_for_set.createSource(*interpreter, external_storage);
-                auto set_key = database_and_table_name->getTreeHash();
+                std::unique_ptr<QueryPlan> source = std::make_unique<QueryPlan>();
+                interpreter->buildQueryPlan(*source);
 
-                // std::cerr << "====== Adding key " << set_key.toString() << std::endl;
-
-                if (!prepared_sets->findSubquery(set_key))
-                {
-                    std::unique_ptr<QueryPlan> source = std::make_unique<QueryPlan>();
-                    interpreter->buildQueryPlan(*source);
-
-                    //std::cerr << reinterpret_cast<const void *>(prepared_sets.get()) << std::endl;
-                    auto future_set = prepared_sets->addFromSubquery(set_key, std::move(source), std::move(external_storage), nullptr, getContext()->getSettingsRef());
-                    // std::cerr << "... Future set " << reinterpret_cast<const void *>(external_storage_holder.get()) << " " << reinterpret_cast<const void *>(future_set.get()) << std::endl;
-                    external_storage_holder->future_set = std::move(future_set);
-                }
-                else
-                    throw Exception(ErrorCodes::LOGICAL_ERROR, "Set is already created for GLOBAL IN");
-                    //prepared_sets->addStorageToSubquery(key, std::move(external_storage));
+                auto future_set = prepared_sets->addFromSubquery(set_key, std::move(source), std::move(external_storage), nullptr, getContext()->getSettingsRef());
+                external_storage_holder->future_set = std::move(future_set);
             }
+            else
+                throw Exception(ErrorCodes::LOGICAL_ERROR, "Set is already created for GLOBAL IN");
 
             /** NOTE If it was written IN tmp_table - the existing temporary (but not external) table,
             *  then a new temporary table will be created (for example, _data1),
diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index 85c3457c6b9..6ea15312ec4 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -953,10 +953,7 @@ Block InterpreterSelectQuery::getSampleBlockImpl()
 
     if (storage && !options.only_analyze)
     {
-        // query_analyzer->makeSetsForIndex(select_query.where());
-        // query_analyzer->makeSetsForIndex(select_query.prewhere());
         query_info.prepared_sets = query_analyzer->getPreparedSets();
-
         from_stage = storage->getQueryProcessingStage(context, options.to_stage, storage_snapshot, query_info);
     }
 
diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 2aa3e02c713..428ef873bc5 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -25,20 +25,25 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-class FutureSetFromTuple final : public FutureSet
+static SizeLimits getSizeLimitsForSet(const Settings & settings)
 {
-public:
-    FutureSetFromTuple(Block block, const Settings & settings);
+    return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
+}
 
-    SetPtr get() const override { return set; }
-    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
+static bool equals(const DataTypes & lhs, const DataTypes & rhs)
+{
+    size_t size = lhs.size();
+    if (size != rhs.size())
+        return false;
 
-    const DataTypes & getTypes() const override { return set->getElementsTypes(); }
+    for (size_t i = 0; i < size; ++i)
+    {
+        if (!lhs[i]->equals(*rhs[i]))
+            return false;
+    }
 
-private:
-    SetPtr set;
-    SetKeyColumns set_key_columns;
-};
+    return true;
+}
 
 
 FutureSetFromStorage::FutureSetFromStorage(SetPtr set_) : set(std::move(set_)) {}
@@ -51,42 +56,153 @@ SetPtr FutureSetFromStorage::buildOrderedSetInplace(const ContextPtr &)
 }
 
 
-// PreparedSetKey PreparedSetKey::forLiteral(Hash hash, DataTypes types_)
-// {
-//     /// Remove LowCardinality types from type list because Set doesn't support LowCardinality keys now,
-//     ///   just converts LowCardinality to ordinary types.
-//     for (auto & type : types_)
-//         type = recursiveRemoveLowCardinality(type);
+FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
+{
+    auto size_limits = getSizeLimitsForSet(settings);
+    set = std::make_shared<Set>(size_limits, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
 
-//     PreparedSetKey key;
-//     key.ast_hash = hash;
-//     key.types = std::move(types_);
-//     return key;
-// }
+    Columns columns;
+    columns.reserve(block.columns());
+    for (const auto & column : block)
+        columns.emplace_back(column.column);
 
-// PreparedSetKey PreparedSetKey::forSubquery(Hash hash)
-// {
-//     PreparedSetKey key;
-//     key.ast_hash = hash;
-//     return key;
-// }
+    set_key_columns.filter = ColumnUInt8::create(block.rows());
 
-// bool PreparedSetKey::operator==(const PreparedSetKey & other) const
-// {
-//     if (ast_hash != other.ast_hash)
-//         return false;
+    set->insertFromColumns(columns, set_key_columns);
+    set->finishInsert();
+}
 
-//     if (types.size() != other.types.size())
-//         return false;
+const DataTypes & FutureSetFromTuple::getTypes() const { return set->getElementsTypes(); }
 
-//     for (size_t i = 0; i < types.size(); ++i)
-//     {
-//         if (!types[i]->equals(*other.types[i]))
-//             return false;
-//     }
+SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
+{
+    if (set->hasExplicitSetElements())
+        return set;
+
+    const auto & settings = context->getSettingsRef();
+    size_t max_values = settings.use_index_for_in_with_subqueries_max_values;
+    bool too_many_values = max_values && max_values < set->getTotalRowCount();
+    if (!too_many_values)
+    {
+        set->fillSetElements();
+        set->appendSetElements(set_key_columns);
+    }
+
+    return set;
+}
+
+
+FutureSetFromSubquery::FutureSetFromSubquery(
+    String key,
+    std::unique_ptr<QueryPlan> source_,
+    StoragePtr external_table_,
+    FutureSetPtr external_table_set_,
+    const Settings & settings)
+    : external_table(std::move(external_table_))
+    , external_table_set(std::move(external_table_set_))
+    , source(std::move(source_))
+{
+    set_and_key = std::make_shared<SetAndKey>();
+    set_and_key->key = std::move(key);
+
+    auto size_limits = getSizeLimitsForSet(settings);
+    set_and_key->set = std::make_shared<Set>(size_limits, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+}
+
+FutureSetFromSubquery::FutureSetFromSubquery(
+    String key,
+    QueryTreeNodePtr query_tree_,
+    const Settings & settings)
+    : query_tree(std::move(query_tree_))
+{
+    set_and_key = std::make_shared<SetAndKey>();
+    set_and_key->key = std::move(key);
+
+    auto size_limits = getSizeLimitsForSet(settings);
+    set_and_key->set = std::make_shared<Set>(size_limits, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
+}
+
+SetPtr FutureSetFromSubquery::get() const
+{
+    if (set_and_key->set != nullptr && set_and_key->set->isCreated())
+        return set_and_key->set;
+
+    return nullptr;
+}
+
+void FutureSetFromSubquery::setQueryPlan(std::unique_ptr<QueryPlan> source_)
+{
+    source = std::move(source_);
+    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
+}
+
+const DataTypes & FutureSetFromSubquery::getTypes() const
+{
+    return set_and_key->set->getElementsTypes();
+}
+
+std::unique_ptr<QueryPlan> FutureSetFromSubquery::build(const ContextPtr & context)
+{
+    if (set_and_key->set->isCreated())
+        return nullptr;
+
+    const auto & settings = context->getSettingsRef();
+
+    auto plan = std::move(source);
+
+    if (!plan)
+        return nullptr;
+
+    auto creating_set = std::make_unique<CreatingSetStep>(
+            plan->getCurrentDataStream(),
+            set_and_key,
+            external_table,
+            SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
+            context);
+    creating_set->setStepDescription("Create set for subquery");
+    plan->addStep(std::move(creating_set));
+    return plan;
+}
+
+SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
+{
+    if (!context->getSettingsRef().use_index_for_in_with_subqueries)
+        return nullptr;
+
+    if (auto set = get())
+    {
+        if (set->hasExplicitSetElements())
+            return set;
+
+        return nullptr;
+    }
+
+    if (external_table_set)
+    {
+        auto set = external_table_set->buildOrderedSetInplace(context);
+        if (set)
+            return set_and_key->set = set;
+    }
+
+    auto plan = build(context);
+    if (!plan)
+        return nullptr;
+
+    set_and_key->set->fillSetElements();
+    auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
+    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
+    pipeline.complete(std::make_shared<EmptySink>(Block()));
+
+    CompletedPipelineExecutor executor(pipeline);
+    executor.execute();
+
+    set_and_key->set->checkIsCreated();
+
+    return set_and_key->set;
+}
 
-//     return true;
-// }
 
 String PreparedSets::toString(const PreparedSets::Hash & key, const DataTypes & types)
 {
@@ -108,84 +224,18 @@ String PreparedSets::toString(const PreparedSets::Hash & key, const DataTypes &
     return buf.str();
 }
 
-// SubqueryForSet & PreparedSets::createOrGetSubquery(const String & subquery_id, const PreparedSetKey & key,
-//                                                    SizeLimits set_size_limit, bool transform_null_in)
-// {
-//     SubqueryForSet & subquery = subqueries[subquery_id];
-
-//     /// If you already created a Set with the same subquery / table for another ast
-//     /// In that case several PreparedSetKey would share same subquery and set
-//     /// Not sure if it's really possible case (maybe for distributed query when set was filled by external table?)
-//     if (subquery.set.isValid())
-//         sets[key] = subquery.set;
-//     else
-//     {
-//         subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
-//         sets[key] = FutureSet(subquery.promise_to_fill_set.get_future());
-//     }
-
-//     if (!subquery.set_in_progress)
-//     {
-//         subquery.key = key.toString();
-//         subquery.set_in_progress = std::make_shared<Set>(set_size_limit, false, transform_null_in);
-//     }
-
-//     return subquery;
-// }
-
-/// If the subquery is not associated with any set, create default-constructed SubqueryForSet.
-/// It's aimed to fill external table passed to SubqueryForSet::createSource.
-// void PreparedSets::addStorageToSubquery(const String & subquery_id, StoragePtr storage)
-// {
-//     auto it = subqueries.find(subquery_id);
-//     if (it == subqueries.end())
-//         throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot find subquery {}", subquery_id);
-
-//     it->second->addStorage(std::move(storage));
-// }
-static bool equals(const DataTypes & lhs, const DataTypes & rhs)
-{
-    size_t size = lhs.size();
-    if (size != rhs.size())
-        return false;
-
-    for (size_t i = 0; i < size; ++i)
-    {
-        if (!lhs[i]->equals(*rhs[i]))
-            return false;
-    }
-
-    return true;
-}
-
-static bool tryInsertSet(std::vector<std::shared_ptr<FutureSet>> & sets, FutureSetPtr new_set)
-{
-    auto types = new_set->getTypes();
-    for (const auto & set : sets)
-        if (equals(set->getTypes(), new_set->getTypes()))
-            return false;
-
-    sets.push_back(std::move(new_set));
-    return true;
-}
-
-static FutureSetPtr findSet(const std::vector<std::shared_ptr<FutureSet>> & sets, const DataTypes & types)
-{
-    for (const auto & set : sets)
-        if (equals(set->getTypes(), types))
-            return set;
-
-    return nullptr;
-}
-
 FutureSetPtr PreparedSets::addFromTuple(const Hash & key, Block block, const Settings & settings)
 {
     auto from_tuple = std::make_shared<FutureSetFromTuple>(std::move(block), settings);
+    const auto & set_types = from_tuple->getTypes();
     auto & sets_by_hash = sets_from_tuple[key];
 
-    if (!tryInsertSet(sets_by_hash, from_tuple))
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_tuple->getTypes()));
+    auto types = from_tuple->getTypes();
+    for (const auto & set : sets_by_hash)
+        if (equals(set->getTypes(), set_types))
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_tuple->getTypes()));
 
+    sets_by_hash.push_back(std::move(from_tuple));
     return from_tuple;
 }
 
@@ -246,7 +296,11 @@ FutureSetPtr PreparedSets::findTuple(const Hash & key, const DataTypes & types)
     if (it == sets_from_tuple.end())
         return nullptr;
 
-    return findSet(it->second, types);
+    for (const auto & set : it->second)
+        if (equals(set->getTypes(), types))
+            return set;
+
+    return nullptr;
 }
 
 std::shared_ptr<FutureSetFromSubquery> PreparedSets::findSubquery(const Hash & key) const
@@ -267,36 +321,9 @@ std::shared_ptr<FutureSetFromStorage> PreparedSets::findStorage(const Hash & key
     return it->second;
 }
 
-// FutureSetPtr PreparedSets::getFuture(const PreparedSetKey & key) const
-// {
-//     auto it = sets.find(key);
-//     if (it == sets.end())
-//         return {};
-//     return it->second;
-// }
-
-// SetPtr PreparedSets::get(const PreparedSetKey & key) const
-// {
-//     auto it = sets.find(key);
-//     if (it == sets.end() || !it->second.isReady())
-//         return nullptr;
-//     return it->second.get();
-// }
-
-// std::vector<FutureSetPtr> PreparedSets::getByTreeHash(IAST::Hash ast_hash) const
-// {
-//     std::vector<FutureSetPtr> res;
-//     for (const auto & it : this->sets)
-//     {
-//         if (it.first.ast_hash == ast_hash)
-//             res.push_back(it.second);
-//     }
-//     return res;
-// }
-
-std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::getSubqueries()
+PreparedSets::Subqueries PreparedSets::getSubqueries()
 {
-    std::vector<std::shared_ptr<FutureSetFromSubquery>> res;
+    PreparedSets::Subqueries res;
     res.reserve(sets_from_subqueries.size());
     for (auto & [_, set] : sets_from_subqueries)
         res.push_back(set);
@@ -304,33 +331,10 @@ std::vector<std::shared_ptr<FutureSetFromSubquery>> PreparedSets::getSubqueries(
     return res;
 }
 
-// void SubqueryForSet::createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_)
-// {
-//     source = std::make_unique<QueryPlan>();
-//     interpreter.buildQueryPlan(*source);
-//     if (table_)
-//         table = table_;
-// }
-
-// bool SubqueryForSet::hasSource() const
-// {
-//     return source != nullptr;
-// }
-
-// QueryPlanPtr SubqueryForSet::detachSource()
-// {
-//     auto res = std::move(source);
-//     source = nullptr;
-//     return res;
-// }
-
-
 std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseToBuild(const String & key)
 {
     std::lock_guard lock(cache_mutex);
 
-    // std::cerr << "PreparedSetsCache::findOrPromiseToBuild " <<  key << "\n" << StackTrace().toString() << std::endl;
-
     auto it = cache.find(key);
     if (it != cache.end())
     {
@@ -347,163 +351,4 @@ std::variant<std::promise<SetPtr>, SharedSet> PreparedSetsCache::findOrPromiseTo
     return promise_to_fill_set;
 }
 
-SetPtr FutureSetFromSubquery::buildOrderedSetInplace(const ContextPtr & context)
-{
-    if (!context->getSettingsRef().use_index_for_in_with_subqueries)
-        return nullptr;
-
-    if (auto set = get())
-    {
-        if (set->hasExplicitSetElements())
-            return set;
-
-        return nullptr;
-    }
-
-    if (external_table_set)
-    {
-        auto set = external_table_set->buildOrderedSetInplace(context);
-        if (set)
-            return set_and_key->set = set;
-    }
-
-    auto plan = buildPlan(context);
-    if (!plan)
-        return nullptr;
-
-    set_and_key->set->fillSetElements();
-    set_and_key->set->initSetElements();
-    auto builder = plan->buildQueryPipeline(QueryPlanOptimizationSettings::fromContext(context), BuildQueryPipelineSettings::fromContext(context));
-    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*builder));
-    pipeline.complete(std::make_shared<EmptySink>(Block()));
-
-    CompletedPipelineExecutor executor(pipeline);
-    executor.execute();
-
-    set_and_key->set->checkIsCreated();
-
-    return set_and_key->set;
-}
-
-SetPtr FutureSetFromSubquery::get() const
-{
-    if (set_and_key->set != nullptr && set_and_key->set->isCreated())
-        return set_and_key->set;
-
-    return nullptr;
-}
-
-std::unique_ptr<QueryPlan> FutureSetFromSubquery::build(const ContextPtr & context)
-{
-    return buildPlan(context);
-}
-
-static SizeLimits getSizeLimitsForSet(const Settings & settings)
-{
-    return SizeLimits(settings.max_rows_in_set, settings.max_bytes_in_set, settings.set_overflow_mode);
-}
-
-std::unique_ptr<QueryPlan> FutureSetFromSubquery::buildPlan(const ContextPtr & context)
-{
-    if (set_and_key->set->isCreated())
-        return nullptr;
-
-    const auto & settings = context->getSettingsRef();
-
-    auto plan = std::move(source);
-
-    if (!plan)
-        return nullptr;
-
-    auto creating_set = std::make_unique<CreatingSetStep>(
-            plan->getCurrentDataStream(),
-            set_and_key,
-            external_table,
-            SizeLimits(settings.max_rows_to_transfer, settings.max_bytes_to_transfer, settings.transfer_overflow_mode),
-            context);
-    creating_set->setStepDescription("Create set for subquery");
-    plan->addStep(std::move(creating_set));
-    return plan;
-}
-
-FutureSetFromTuple::FutureSetFromTuple(Block block, const Settings & settings)
-{
-    bool create_ordered_set = false;
-    auto size_limits = getSizeLimitsForSet(settings);
-    set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
-    set->setHeader(block.cloneEmpty().getColumnsWithTypeAndName());
-
-    Columns columns;
-    columns.reserve(block.columns());
-    for (const auto & column : block)
-        columns.emplace_back(column.column);
-
-    set_key_columns.filter = ColumnUInt8::create(block.rows());
-
-    set->insertFromColumns(columns, set_key_columns);
-    set->finishInsert();
-}
-
-FutureSetFromSubquery::FutureSetFromSubquery(
-    String key,
-    std::unique_ptr<QueryPlan> source_,
-    StoragePtr external_table_,
-    FutureSetPtr external_table_set_,
-    const Settings & settings)
-    : external_table(std::move(external_table_))
-    , external_table_set(std::move(external_table_set_))
-    , source(std::move(source_))
-{
-    set_and_key = std::make_shared<SetAndKey>();
-    set_and_key->key = std::move(key);
-
-    bool create_ordered_set = false;
-    auto size_limits = getSizeLimitsForSet(settings);
-    set_and_key->set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
-    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
-}
-
-FutureSetFromSubquery::FutureSetFromSubquery(
-    String key,
-    QueryTreeNodePtr query_tree_,
-    //FutureSetPtr external_table_set_,
-    const Settings & settings)
-    : query_tree(std::move(query_tree_))
-{
-    set_and_key = std::make_shared<SetAndKey>();
-    set_and_key->key = std::move(key);
-
-    bool create_ordered_set = false;
-    auto size_limits = getSizeLimitsForSet(settings);
-    set_and_key->set = std::make_shared<Set>(size_limits, create_ordered_set, settings.use_index_for_in_with_subqueries_max_values, settings.transform_null_in);
-}
-
-void FutureSetFromSubquery::setQueryPlan(std::unique_ptr<QueryPlan> source_)
-{
-    source = std::move(source_);
-    set_and_key->set->setHeader(source->getCurrentDataStream().header.getColumnsWithTypeAndName());
-}
-
-const DataTypes & FutureSetFromSubquery::getTypes() const
-{
-    return set_and_key->set->getElementsTypes();
-}
-
-SetPtr FutureSetFromTuple::buildOrderedSetInplace(const ContextPtr & context)
-{
-    if (set->hasExplicitSetElements())
-        return set;
-
-    const auto & settings = context->getSettingsRef();
-    size_t max_values = settings.use_index_for_in_with_subqueries_max_values;
-    bool too_many_values = max_values && max_values < set->getTotalRowCount();
-    if (!too_many_values)
-    {
-        set->initSetElements();
-        set->appendSetElements(set_key_columns);
-    }
-
-    return set;
-}
-
 };
diff --git a/src/Interpreters/PreparedSets.h b/src/Interpreters/PreparedSets.h
index 339f4a6b435..cb240f5260a 100644
--- a/src/Interpreters/PreparedSets.h
+++ b/src/Interpreters/PreparedSets.h
@@ -8,7 +8,7 @@
 #include <future>
 #include <Storages/IStorage_fwd.h>
 #include <Interpreters/Context_fwd.h>
-#include <Core/Settings.h>
+#include <Interpreters/SetKeys.h>
 
 namespace DB
 {
@@ -17,7 +17,7 @@ class QueryPlan;
 
 class Set;
 using SetPtr = std::shared_ptr<Set>;
-class InterpreterSelectWithUnionQuery;
+struct SetKeyColumns;
 
 class IQueryTreeNode;
 using QueryTreeNodePtr = std::shared_ptr<IQueryTreeNode>;
@@ -44,14 +44,19 @@ class FutureSet
 public:
     virtual ~FutureSet() = default;
 
+    /// Returns set if set is ready (created and filled) or nullptr if not.
     virtual SetPtr get() const = 0;
+    /// Returns set->getElementsTypes(), even if set is not created yet.
     virtual const DataTypes & getTypes() const = 0;
+    /// If possible, return set with stored elements useful for PK analysis.
     virtual SetPtr buildOrderedSetInplace(const ContextPtr & context) = 0;
 };
 
 using FutureSetPtr = std::shared_ptr<FutureSet>;
 
-class FutureSetFromStorage : public FutureSet
+/// Future set from already filled set.
+/// Usually it is from StorageSet.
+class FutureSetFromStorage final : public FutureSet
 {
 public:
     FutureSetFromStorage(SetPtr set_);
@@ -64,34 +69,27 @@ private:
     SetPtr set;
 };
 
+/// Set from tuple is filled as well as set from storage.
+/// Additionally, it can be converted to set useful for PK.
+class FutureSetFromTuple final : public FutureSet
+{
+public:
+    FutureSetFromTuple(Block block, const Settings & settings);
 
-/// Information on how to build set for the [GLOBAL] IN section.
-// class SubqueryForSet
-// {
-// public:
+    SetPtr get() const override { return set; }
+    SetPtr buildOrderedSetInplace(const ContextPtr & context) override;
 
-//     void createSource(InterpreterSelectWithUnionQuery & interpreter, StoragePtr table_ = nullptr);
+    const DataTypes & getTypes() const override;
 
-//     bool hasSource() const;
+private:
+    SetPtr set;
+    SetKeyColumns set_key_columns;
+};
 
-//     /// Returns query plan for the set's source
-//     /// and removes it from SubqueryForSet because we need to build it only once.
-//     std::unique_ptr<QueryPlan> detachSource();
-
-//     /// Build this set from the result of the subquery.
-//     String key;
-//     SetPtr set;
-
-//     /// If set, put the result into the table.
-//     /// This is a temporary table for transferring to remote servers for distributed query processing.
-//     StoragePtr table;
-
-//     /// The source is obtained using the InterpreterSelectQuery subquery.
-//     std::unique_ptr<QueryPlan> source;
-//     QueryTreeNodePtr query_tree;
-// };
-
-class FutureSetFromSubquery : public FutureSet
+/// Set from subquery can be built inplace for PK or in CreatingSet step.
+/// If use_index_for_in_with_subqueries_max_values is reached, set for PK won't be created,
+/// but ordinary set would be created instead.
+class FutureSetFromSubquery final : public FutureSet
 {
 public:
     FutureSetFromSubquery(
@@ -104,7 +102,6 @@ public:
     FutureSetFromSubquery(
         String key,
         QueryTreeNodePtr query_tree_,
-        //FutureSetPtr external_table_set_,
         const Settings & settings);
 
     SetPtr get() const override;
@@ -123,10 +120,9 @@ private:
 
     std::unique_ptr<QueryPlan> source;
     QueryTreeNodePtr query_tree;
-
-    std::unique_ptr<QueryPlan> buildPlan(const ContextPtr & context);
 };
 
+/// Container for all the sets used in query.
 class PreparedSets
 {
 public:
@@ -137,7 +133,7 @@ public:
         UInt64 operator()(const Hash & key) const { return key.first ^ key.second; }
     };
 
-    using SetsFromTuple = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSet>>, Hashing>;
+    using SetsFromTuple = std::unordered_map<Hash, std::vector<std::shared_ptr<FutureSetFromTuple>>, Hashing>;
     using SetsFromStorage = std::unordered_map<Hash, std::shared_ptr<FutureSetFromStorage>, Hashing>;
     using SetsFromSubqueries = std::unordered_map<Hash, std::shared_ptr<FutureSetFromSubquery>, Hashing>;
 
@@ -160,11 +156,12 @@ public:
     std::shared_ptr<FutureSetFromStorage> findStorage(const Hash & key) const;
     std::shared_ptr<FutureSetFromSubquery> findSubquery(const Hash & key) const;
 
-    std::vector<std::shared_ptr<FutureSetFromSubquery>> getSubqueries();
+    using Subqueries = std::vector<std::shared_ptr<FutureSetFromSubquery>>;
+    Subqueries getSubqueries();
 
     const SetsFromTuple & getSetsFromTuple() const { return sets_from_tuple; }
-    const SetsFromStorage & getSetsFromStorage() const { return sets_from_storage; }
-    const SetsFromSubqueries & getSetsFromSubquery() const { return sets_from_subqueries; }
+    // const SetsFromStorage & getSetsFromStorage() const { return sets_from_storage; }
+    // const SetsFromSubqueries & getSetsFromSubquery() const { return sets_from_subqueries; }
 
     static String toString(const Hash & key, const DataTypes & types);
 
diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index 17df5064642..b42ff102f72 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -167,19 +167,16 @@ void Set::setHeader(const ColumnsWithTypeAndName & header)
         extractNestedColumnsAndNullMap(key_columns, null_map);
     }
 
-    if (fill_set_elements)
-    {
-        /// Create empty columns with set values in advance.
-        /// It is needed because set may be empty, so method 'insertFromBlock' will be never called.
-        initSetElements();
-    }
-
     /// Choose data structure to use for the set.
     data.init(data.chooseMethod(key_columns, key_sizes));
 }
 
-void Set::initSetElements()
+void Set::fillSetElements()
 {
+    if (data.getTotalRowCount())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert set to ordered because it is not empty");
+
+    fill_set_elements = true;
     set_elements.reserve(keys_size);
     for (const auto & type : set_elements_types)
         set_elements.emplace_back(type->createColumn());
diff --git a/src/Interpreters/Set.h b/src/Interpreters/Set.h
index d1218830969..9ea46e117ef 100644
--- a/src/Interpreters/Set.h
+++ b/src/Interpreters/Set.h
@@ -4,6 +4,7 @@
 #include <QueryPipeline/SizeLimits.h>
 #include <DataTypes/IDataType.h>
 #include <Interpreters/SetVariants.h>
+#include <Interpreters/SetKeys.h>
 #include <Parsers/IAST.h>
 #include <Storages/MergeTree/BoolMask.h>
 
@@ -21,17 +22,6 @@ using FunctionBasePtr = std::shared_ptr<const IFunctionBase>;
 
 class Chunk;
 
-/// Prepared key columns for set which can be added to fill set elements.
-/// Used only to upgrade set from tuple.
-struct SetKeyColumns
-{
-    /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
-    ColumnRawPtrs key_columns;
-    Columns materialized_columns;
-    ColumnPtr null_map_holder;
-    ColumnUInt8::MutablePtr filter;
-};
-
 /** Data structure for implementation of IN expression.
   */
 class Set
@@ -41,14 +31,12 @@ public:
     /// (that is useful only for checking that some value is in the set and may not store the original values),
     /// store all set elements in explicit form.
     /// This is needed for subsequent use for index.
-    Set(const SizeLimits & limits_, bool fill_set_elements_, size_t max_elements_to_fill_, bool transform_null_in_)
+    Set(const SizeLimits & limits_, size_t max_elements_to_fill_, bool transform_null_in_)
         : log(&Poco::Logger::get("Set")),
-        limits(limits_), fill_set_elements(fill_set_elements_), max_elements_to_fill(max_elements_to_fill_), transform_null_in(transform_null_in_)
+        limits(limits_), max_elements_to_fill(max_elements_to_fill_), transform_null_in(transform_null_in_)
     {
     }
 
-    void fillSetElements() { fill_set_elements = true; }
-
     /** Set can be created either from AST or from a stream of data (subquery result).
       */
 
@@ -61,7 +49,7 @@ public:
     bool insertFromColumns(const Columns & columns);
     bool insertFromBlock(const ColumnsWithTypeAndName & columns);
 
-    void initSetElements();
+    void fillSetElements();
     bool insertFromColumns(const Columns & columns, SetKeyColumns & holder);
     void appendSetElements(SetKeyColumns & holder);
 
@@ -129,7 +117,7 @@ private:
     SizeLimits limits;
 
     /// Do we need to additionally store all elements of the set in explicit form for subsequent use for index.
-    bool fill_set_elements;
+    bool fill_set_elements = false;
     size_t max_elements_to_fill;
 
     /// If true, insert NULL values to set.
diff --git a/src/Interpreters/SetKeys.h b/src/Interpreters/SetKeys.h
new file mode 100644
index 00000000000..2cab9849c9b
--- /dev/null
+++ b/src/Interpreters/SetKeys.h
@@ -0,0 +1,18 @@
+#pragma once
+#include <Columns/ColumnsNumber.h>
+
+namespace DB
+{
+
+/// Prepared key columns for set which can be added to fill set elements.
+/// Used only to upgrade set from tuple.
+struct SetKeyColumns
+{
+    /// The constant columns to the right of IN are not supported directly. For this, they first materialize.
+    ColumnRawPtrs key_columns;
+    Columns materialized_columns;
+    ColumnPtr null_map_holder;
+    ColumnUInt8::MutablePtr filter;
+};
+
+}
diff --git a/src/Planner/CollectSets.cpp b/src/Planner/CollectSets.cpp
index df3558745fb..8dd7c6637bf 100644
--- a/src/Planner/CollectSets.cpp
+++ b/src/Planner/CollectSets.cpp
@@ -30,9 +30,8 @@ namespace
 class CollectSetsVisitor : public ConstInDepthQueryTreeVisitor<CollectSetsVisitor>
 {
 public:
-    explicit CollectSetsVisitor(PlannerContext & planner_context_) //, const SelectQueryOptions & select_query_options_)
+    explicit CollectSetsVisitor(PlannerContext & planner_context_)
         : planner_context(planner_context_)
-        //, select_query_options(select_query_options_)
     {}
 
     void visitImpl(const QueryTreeNodePtr & node)
@@ -60,7 +59,7 @@ public:
         }
         else if (const auto * constant_node = in_second_argument->as<ConstantNode>())
         {
-            auto set = makeSetForConstantValue(
+            auto set = getSetElementsForConstantValue(
                 in_first_argument->getResultType(),
                 constant_node->getValue(),
                 constant_node->getResultType(),
@@ -72,18 +71,12 @@ public:
                 set_element_types = left_tuple_type->getElements();
 
             set_element_types = Set::getElementTypes(std::move(set_element_types), settings.transform_null_in);
-
-            // for (auto & element_type : set_element_types)
-            //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-            //         element_type = low_cardinality_type->getDictionaryType();
-
             auto set_key = in_second_argument->getTreeHash();
+
             if (sets.findTuple(set_key, set_element_types))
                 return;
 
             sets.addFromTuple(set_key, std::move(set), settings);
-
-            //planner_context.registerSet(set_key, PlannerSet(FutureSet(std::move(set))));
         }
         else if (in_second_argument_node_type == QueryTreeNodeType::QUERY ||
             in_second_argument_node_type == QueryTreeNodeType::UNION ||
@@ -141,14 +134,13 @@ public:
 
 private:
     PlannerContext & planner_context;
-    //const SelectQueryOptions & select_query_options;
 };
 
 }
 
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context) //, const SelectQueryOptions & select_query_options)
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context)
 {
-    CollectSetsVisitor visitor(planner_context); //, select_query_options);
+    CollectSetsVisitor visitor(planner_context);
     visitor.visit(node);
 }
 
diff --git a/src/Planner/CollectSets.h b/src/Planner/CollectSets.h
index e0db802d3b4..5f9f7a5a466 100644
--- a/src/Planner/CollectSets.h
+++ b/src/Planner/CollectSets.h
@@ -12,6 +12,6 @@ struct SelectQueryOptions;
 /** Collect prepared sets and sets for subqueries that are necessary to execute IN function and its variations.
   * Collected sets are registered in planner context.
   */
-void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context); //, const SelectQueryOptions & select_query_options);
+void collectSets(const QueryTreeNodePtr & node, PlannerContext & planner_context);
 
 }
diff --git a/src/Planner/Planner.cpp b/src/Planner/Planner.cpp
index d524f2bed98..9f6c22f90f3 100644
--- a/src/Planner/Planner.cpp
+++ b/src/Planner/Planner.cpp
@@ -933,8 +933,6 @@ void addBuildSubqueriesForSetsStepIfNeeded(
     auto subqueries = planner_context->getPreparedSets().getSubqueries();
     std::unordered_set<const FutureSet *> useful_sets;
 
-    //PreparedSets::SubqueriesForSets subqueries_for_sets;
-
     for (const auto & actions_to_execute : result_actions_to_execute)
         collectSetsFromActionsDAG(actions_to_execute, useful_sets);
 
@@ -994,7 +992,7 @@ void addAdditionalFilterStepIfNeeded(QueryPlan & query_plan,
     auto storage = std::make_shared<StorageDummy>(StorageID{"dummy", "dummy"}, fake_column_descriptions);
     auto fake_table_expression = std::make_shared<TableNode>(std::move(storage), query_context);
 
-    auto filter_info = buildFilterInfo(additional_result_filter_ast, fake_table_expression, planner_context, select_query_options, std::move(fake_name_set));
+    auto filter_info = buildFilterInfo(additional_result_filter_ast, fake_table_expression, planner_context, std::move(fake_name_set));
     if (!filter_info.actions || !query_plan.isInitialized())
         return;
 
@@ -1225,7 +1223,7 @@ void Planner::buildPlanForQueryNode()
     }
 
     checkStoragesSupportTransactions(planner_context);
-    collectSets(query_tree, *planner_context); //, select_query_options);
+    collectSets(query_tree, *planner_context);
     collectTableExpressionData(query_tree, planner_context);
 
     const auto & settings = query_context->getSettingsRef();
@@ -1524,10 +1522,7 @@ void Planner::buildPlanForQueryNode()
     }
 
     if (!select_query_options.only_analyze)
-    {
-        //addCreatingSetsStep(query_plan, planner_context->getPreparedSets().detachSubqueries(planner_context->getQueryContext()), planner_context->getQueryContext());
         addBuildSubqueriesForSetsStepIfNeeded(query_plan, select_query_options, planner_context, result_actions_to_execute);
-    }
 }
 
 SelectQueryInfo Planner::buildSelectQueryInfo() const
diff --git a/src/Planner/PlannerActionsVisitor.cpp b/src/Planner/PlannerActionsVisitor.cpp
index 40b6ec109dc..7575828e64d 100644
--- a/src/Planner/PlannerActionsVisitor.cpp
+++ b/src/Planner/PlannerActionsVisitor.cpp
@@ -633,7 +633,7 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
     DataTypes set_element_types;
 
     auto in_second_argument_node_type = in_second_argument->getNodeType();
-    // std::cerr << "=========== " << in_second_argument->getNodeTypeName() << std::endl;
+
     bool subquery_or_table =
         in_second_argument_node_type == QueryTreeNodeType::QUERY ||
         in_second_argument_node_type == QueryTreeNodeType::UNION ||
@@ -649,10 +649,6 @@ PlannerActionsVisitorImpl::NodeNameAndNodeMinLevel PlannerActionsVisitorImpl::ma
         if (left_tuple_type && left_tuple_type->getElements().size() != 1)
             set_element_types = left_tuple_type->getElements();
 
-        // for (auto & element_type : set_element_types)
-        //     if (const auto * low_cardinality_type = typeid_cast<const DataTypeLowCardinality *>(element_type.get()))
-        //         element_type = low_cardinality_type->getDictionaryType();
-
         set_element_types = Set::getElementTypes(std::move(set_element_types), planner_context->getQueryContext()->getSettingsRef().transform_null_in);
         set = planner_context->getPreparedSets().findTuple(set_key, set_element_types);
     }
diff --git a/src/Planner/PlannerContext.cpp b/src/Planner/PlannerContext.cpp
index c8aeebc17c1..3c75d4fbea8 100644
--- a/src/Planner/PlannerContext.cpp
+++ b/src/Planner/PlannerContext.cpp
@@ -118,50 +118,4 @@ PlannerContext::SetKey PlannerContext::createSetKey(const QueryTreeNodePtr & set
     return "__set_" + toString(set_source_hash.first) + '_' + toString(set_source_hash.second);
 }
 
-// void PlannerContext::registerSet(const SetKey & key, PlannerSet planner_set)
-// {
-//     if (!planner_set.getSet().isValid())
-//         throw Exception(ErrorCodes::LOGICAL_ERROR, "Set must be initialized");
-
-//     const auto & subquery_node = planner_set.getSubqueryNode();
-//     if (subquery_node)
-//     {
-//         auto node_type = subquery_node->getNodeType();
-
-//        if (node_type != QueryTreeNodeType::QUERY &&
-//            node_type != QueryTreeNodeType::UNION &&
-//            node_type != QueryTreeNodeType::TABLE)
-//            throw Exception(ErrorCodes::LOGICAL_ERROR,
-//                "Invalid node for set table expression. Expected query or union. Actual {}",
-//                subquery_node->formatASTForErrorMessage());
-//    }
-
-//     set_key_to_set.emplace(key, std::move(planner_set));
-// }
-
-// bool PlannerContext::hasSet(const SetKey & key) const
-// {
-//     return set_key_to_set.contains(key);
-// }
-
-// const PlannerSet & PlannerContext::getSetOrThrow(const SetKey & key) const
-// {
-//     auto it = set_key_to_set.find(key);
-//     if (it == set_key_to_set.end())
-//         throw Exception(ErrorCodes::LOGICAL_ERROR,
-//             "No set is registered for key {}",
-//             key);
-
-//     return it->second;
-// }
-
-// PlannerSet * PlannerContext::getSetOrNull(const SetKey & key)
-// {
-//     auto it = set_key_to_set.find(key);
-//     if (it == set_key_to_set.end())
-//         return nullptr;
-
-//     return &it->second;
-// }
-
 }
diff --git a/src/Planner/PlannerContext.h b/src/Planner/PlannerContext.h
index 78c7f8feab5..aceb313d4b5 100644
--- a/src/Planner/PlannerContext.h
+++ b/src/Planner/PlannerContext.h
@@ -44,56 +44,6 @@ private:
 
 using GlobalPlannerContextPtr = std::shared_ptr<GlobalPlannerContext>;
 
-/** PlannerSet is wrapper around Set that is used during query planning.
-  *
-  * If subquery node is null, such set is already prepared for execution.
-  *
-  * If subquery node is not null, then set must be build from the result of the subquery.
-  * If subquery node is not null, it must have QUERY or UNION type.
-  */
-class PlannerSet
-{
-
-};
-
-// {
-// public:
-//     /// Construct planner set that is ready for execution
-//     explicit PlannerSet(FutureSetPtr set_)
-//         : set(std::move(set_))
-//     {}
-
-//     /// Construct planner set with set and subquery node
-//     explicit PlannerSet(QueryTreeNodePtr subquery_node_)
-//         //: set(promise_to_build_set.get_future())
-//         : subquery_node(std::move(subquery_node_))
-//     {}
-
-//     /// Get a reference to a set that might be not built yet
-//     const FutureSetPtr & getSet() const
-//     {
-//         return set;
-//     }
-
-//     /// Get subquery node
-//     const QueryTreeNodePtr & getSubqueryNode() const
-//     {
-//         return subquery_node;
-//     }
-
-//     /// This promise will be fulfilled when set is built and all FutureSet objects will become ready
-//     // std::promise<SetPtr> extractPromiseToBuildSet()
-//     // {
-//     //     return std::move(promise_to_build_set);
-//     // }
-
-// private:
-//     //std::promise<SetPtr> promise_to_build_set;
-//     FutureSetPtr set;
-
-//     QueryTreeNodePtr subquery_node;
-// };
-
 class PlannerContext
 {
 public:
@@ -181,29 +131,9 @@ public:
 
     using SetKey = std::string;
 
-    // using SetKeyToSet = std::unordered_map<String, PlannerSet>;
-
-    // /// Create set key for set source node
+    /// Create set key for set source node
     static SetKey createSetKey(const QueryTreeNodePtr & set_source_node);
 
-    // /// Register set for set key
-    // void registerSet(const SetKey & key, PlannerSet planner_set);
-
-    // /// Returns true if set is registered for key, false otherwise
-    // bool hasSet(const SetKey & key) const;
-
-    // /// Get set for key, if no set is registered logical exception is thrown
-    // const PlannerSet & getSetOrThrow(const SetKey & key) const;
-
-    // /// Get set for key, if no set is registered null is returned
-    // PlannerSet * getSetOrNull(const SetKey & key);
-
-    // /// Get registered sets
-    // const SetKeyToSet & getRegisteredSets() const
-    // {
-    //     return set_key_to_set;
-    // }
-
     PreparedSets & getPreparedSets() { return prepared_sets; }
 
 private:
diff --git a/src/Planner/PlannerJoinTree.cpp b/src/Planner/PlannerJoinTree.cpp
index c27ee72437c..5d8f8ca8741 100644
--- a/src/Planner/PlannerJoinTree.cpp
+++ b/src/Planner/PlannerJoinTree.cpp
@@ -403,8 +403,7 @@ void updatePrewhereOutputsIfNeeded(SelectQueryInfo & table_expression_query_info
 
 FilterDAGInfo buildRowPolicyFilterIfNeeded(const StoragePtr & storage,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context,
-    const SelectQueryOptions & select_query_options)
+    PlannerContextPtr & planner_context)
 {
     auto storage_id = storage->getStorageID();
     const auto & query_context = planner_context->getQueryContext();
@@ -413,13 +412,12 @@ FilterDAGInfo buildRowPolicyFilterIfNeeded(const StoragePtr & storage,
     if (!row_policy_filter)
         return {};
 
-    return buildFilterInfo(row_policy_filter->expression, table_expression_query_info.table_expression, planner_context, select_query_options);
+    return buildFilterInfo(row_policy_filter->expression, table_expression_query_info.table_expression, planner_context);
 }
 
 FilterDAGInfo buildCustomKeyFilterIfNeeded(const StoragePtr & storage,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context,
-    const SelectQueryOptions & select_query_options)
+    PlannerContextPtr & planner_context)
 {
     const auto & query_context = planner_context->getQueryContext();
     const auto & settings = query_context->getSettingsRef();
@@ -445,15 +443,14 @@ FilterDAGInfo buildCustomKeyFilterIfNeeded(const StoragePtr & storage,
             *storage,
             query_context);
 
-    return buildFilterInfo(parallel_replicas_custom_filter_ast, table_expression_query_info.table_expression, planner_context, select_query_options);
+    return buildFilterInfo(parallel_replicas_custom_filter_ast, table_expression_query_info.table_expression, planner_context);
 }
 
 /// Apply filters from additional_table_filters setting
 FilterDAGInfo buildAdditionalFiltersIfNeeded(const StoragePtr & storage,
     const String & table_expression_alias,
     SelectQueryInfo & table_expression_query_info,
-    PlannerContextPtr & planner_context,
-    const SelectQueryOptions & select_query_options)
+    PlannerContextPtr & planner_context)
 {
     const auto & query_context = planner_context->getQueryContext();
     const auto & settings = query_context->getSettingsRef();
@@ -487,7 +484,7 @@ FilterDAGInfo buildAdditionalFiltersIfNeeded(const StoragePtr & storage,
         return {};
 
     table_expression_query_info.additional_filter_ast = additional_filter_ast;
-    return buildFilterInfo(additional_filter_ast, table_expression_query_info.table_expression, planner_context, select_query_options);
+    return buildFilterInfo(additional_filter_ast, table_expression_query_info.table_expression, planner_context);
 }
 
 JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expression,
@@ -697,14 +694,14 @@ JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expres
                     }
                 };
 
-                auto row_policy_filter_info = buildRowPolicyFilterIfNeeded(storage, table_expression_query_info, planner_context, select_query_options);
+                auto row_policy_filter_info = buildRowPolicyFilterIfNeeded(storage, table_expression_query_info, planner_context);
                 add_filter(row_policy_filter_info, "Row-level security filter");
 
                 if (query_context->getParallelReplicasMode() == Context::ParallelReplicasMode::CUSTOM_KEY)
                 {
                     if (settings.parallel_replicas_count > 1)
                     {
-                        auto parallel_replicas_custom_key_filter_info = buildCustomKeyFilterIfNeeded(storage, table_expression_query_info, planner_context, select_query_options);
+                        auto parallel_replicas_custom_key_filter_info = buildCustomKeyFilterIfNeeded(storage, table_expression_query_info, planner_context);
                         add_filter(parallel_replicas_custom_key_filter_info, "Parallel replicas custom key filter");
                     }
                     else
@@ -719,7 +716,7 @@ JoinTreeQueryPlan buildQueryPlanForTableExpression(QueryTreeNodePtr table_expres
                 }
 
                 const auto & table_expression_alias = table_expression->getAlias();
-                auto additional_filters_info = buildAdditionalFiltersIfNeeded(storage, table_expression_alias, table_expression_query_info, planner_context, select_query_options);
+                auto additional_filters_info = buildAdditionalFiltersIfNeeded(storage, table_expression_alias, table_expression_query_info, planner_context);
                 add_filter(additional_filters_info, "additional filter");
 
                 from_stage = storage->getQueryProcessingStage(query_context, select_query_options.to_stage, storage_snapshot, table_expression_query_info);
diff --git a/src/Planner/Utils.cpp b/src/Planner/Utils.cpp
index 403e3f03997..733db0f00bc 100644
--- a/src/Planner/Utils.cpp
+++ b/src/Planner/Utils.cpp
@@ -429,7 +429,6 @@ SelectQueryInfo buildSelectQueryInfo(const QueryTreeNodePtr & query_tree, const
 FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
         const QueryTreeNodePtr & table_expression,
         PlannerContextPtr & planner_context,
-        [[maybe_unused]] const SelectQueryOptions & select_query_options,
         NameSet table_expression_required_names_without_filter)
 {
     const auto & query_context = planner_context->getQueryContext();
@@ -447,7 +446,7 @@ FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
     }
 
     collectSourceColumns(filter_query_tree, planner_context);
-    collectSets(filter_query_tree, *planner_context); //, select_query_options);
+    collectSets(filter_query_tree, *planner_context);
 
     auto filter_actions_dag = std::make_shared<ActionsDAG>();
 
diff --git a/src/Planner/Utils.h b/src/Planner/Utils.h
index 8071e201f88..d9412800e61 100644
--- a/src/Planner/Utils.h
+++ b/src/Planner/Utils.h
@@ -82,7 +82,6 @@ SelectQueryInfo buildSelectQueryInfo(const QueryTreeNodePtr & query_tree, const
 FilterDAGInfo buildFilterInfo(ASTPtr filter_expression,
         const QueryTreeNodePtr & table_expression,
         PlannerContextPtr & planner_context,
-        const SelectQueryOptions & select_query_options,
         NameSet table_expression_required_names_without_filter = {});
 
 ASTPtr parseAdditionalResultFilter(const Settings & settings);
diff --git a/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp b/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
index ebd58c3dc95..c54d32c1385 100644
--- a/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
+++ b/src/Processors/QueryPlan/CreateSetAndFilterOnTheFlyStep.cpp
@@ -105,7 +105,7 @@ CreateSetAndFilterOnTheFlyStep::CreateSetAndFilterOnTheFlyStep(
     : ITransformingStep(input_stream_, input_stream_.header, getTraits())
     , column_names(column_names_)
     , max_rows_in_set(max_rows_in_set_)
-    , own_set(std::make_shared<SetWithState>(SizeLimits(max_rows_in_set, 0, OverflowMode::BREAK), false, 0, true))
+    , own_set(std::make_shared<SetWithState>(SizeLimits(max_rows_in_set, 0, OverflowMode::BREAK), 0, true))
     , filtering_set(nullptr)
     , crosswise_connection(crosswise_connection_)
     , position(position_)
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index aae632787b9..3e4dfb0c7d1 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -124,7 +124,7 @@ void CreatingSetsStep::describePipeline(FormatSettings & settings) const
     IQueryPlanStep::describePipeline(processors, settings);
 }
 
-void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery, ContextPtr context)
+void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::Subqueries subqueries, ContextPtr context)
 {
     DataStreams input_streams;
     input_streams.emplace_back(query_plan.getCurrentDataStream());
@@ -133,7 +133,7 @@ void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<Fut
     plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
     query_plan = QueryPlan();
 
-    for (auto & future_set : sets_from_subquery)
+    for (auto & future_set : subqueries)
     {
         if (future_set->get())
             continue;
@@ -157,18 +157,11 @@ void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<Fut
     query_plan.unitePlans(std::move(creating_sets), std::move(plans));
 }
 
-//void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::SubqueriesForSets subqueries_for_sets, ContextPtr context)
-
 std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSets(DelayedCreatingSetsStep && step)
 {
-    // DataStreams input_streams;
-    // input_streams.emplace_back(query_plan.getCurrentDataStream());
-
     std::vector<std::unique_ptr<QueryPlan>> plans;
-    // plans.emplace_back(std::make_unique<QueryPlan>(std::move(query_plan)));
-    // query_plan = QueryPlan();
 
-    for (auto & future_set : step.sets_from_subquery)
+    for (auto & future_set : step.subqueries)
     {
         if (future_set->get())
             continue;
@@ -179,7 +172,6 @@ std::vector<std::unique_ptr<QueryPlan>> DelayedCreatingSetsStep::makePlansForSet
 
         plan->optimize(QueryPlanOptimizationSettings::fromContext(step.context));
 
-        //input_streams.emplace_back(plan->getCurrentDataStream());
         plans.emplace_back(std::move(plan));
     }
 
@@ -199,8 +191,8 @@ void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets,
 }
 
 DelayedCreatingSetsStep::DelayedCreatingSetsStep(
-    DataStream input_stream, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery_, ContextPtr context_)
-    : sets_from_subquery(std::move(sets_from_subquery_)), context(std::move(context_))
+    DataStream input_stream, PreparedSets::Subqueries subqueries_, ContextPtr context_)
+    : subqueries(std::move(subqueries_)), context(std::move(context_))
 {
     input_streams = {input_stream};
     output_stream = std::move(input_stream);
diff --git a/src/Processors/QueryPlan/CreatingSetsStep.h b/src/Processors/QueryPlan/CreatingSetsStep.h
index 7110775da79..a90b70a2fa4 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.h
+++ b/src/Processors/QueryPlan/CreatingSetsStep.h
@@ -47,10 +47,12 @@ public:
     void describePipeline(FormatSettings & settings) const override;
 };
 
+/// This is a temporary step which is converted to CreatingSetStep after plan optimization.
+/// Can't be used by itself.
 class DelayedCreatingSetsStep final : public IQueryPlanStep
 {
 public:
-    DelayedCreatingSetsStep(DataStream input_stream, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery_, ContextPtr context_);
+    DelayedCreatingSetsStep(DataStream input_stream, PreparedSets::Subqueries subqueries_, ContextPtr context_);
 
     String getName() const override { return "DelayedCreatingSets"; }
 
@@ -59,14 +61,14 @@ public:
     static std::vector<std::unique_ptr<QueryPlan>> makePlansForSets(DelayedCreatingSetsStep && step);
 
     ContextPtr getContext() const { return context; }
-    std::vector<std::shared_ptr<FutureSetFromSubquery>> detachSets() { return std::move(sets_from_subquery); }
+    PreparedSets::Subqueries detachSets() { return std::move(subqueries); }
 
 private:
-    std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery;
+    PreparedSets::Subqueries subqueries;
     ContextPtr context;
 };
 
-void addCreatingSetsStep(QueryPlan & query_plan, std::vector<std::shared_ptr<FutureSetFromSubquery>> sets_from_subquery, ContextPtr context);
+void addCreatingSetsStep(QueryPlan & query_plan, PreparedSets::Subqueries subqueries, ContextPtr context);
 
 void addCreatingSetsStep(QueryPlan & query_plan, PreparedSetsPtr prepared_sets, ContextPtr context);
 
diff --git a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
index 8e2221d564d..9b9cc221ca8 100644
--- a/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
+++ b/src/Processors/QueryPlan/DistributedCreateLocalPlan.cpp
@@ -43,7 +43,6 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     const Block & header,
     ContextPtr context,
     QueryProcessingStage::Enum processed_stage,
-    [[maybe_unused]] PreparedSetsPtr prepared_sets,
     size_t shard_num,
     size_t shard_count,
     size_t replica_num,
@@ -99,7 +98,7 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     }
     else
     {
-        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options); //, prepared_sets);
+        auto interpreter = InterpreterSelectQuery(query_ast, new_context, select_query_options);
         interpreter.buildQueryPlan(*query_plan);
     }
 
diff --git a/src/Processors/QueryPlan/DistributedCreateLocalPlan.h b/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
index cf59027a33f..c08b9bdf67e 100644
--- a/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
+++ b/src/Processors/QueryPlan/DistributedCreateLocalPlan.h
@@ -18,7 +18,6 @@ std::unique_ptr<QueryPlan> createLocalPlan(
     const Block & header,
     ContextPtr context,
     QueryProcessingStage::Enum processed_stage,
-    PreparedSetsPtr prepared_sets,
     size_t shard_num,
     size_t shard_count,
     size_t replica_num,
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index e549a06877e..1e21d13e2b1 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1220,13 +1220,8 @@ static void buildIndexes(
         const auto & partition_key = metadata_snapshot->getPartitionKey();
         auto minmax_columns_names = data.getMinMaxColumnsNames(partition_key);
         auto minmax_expression_actions = data.getMinMaxExpr(partition_key, ExpressionActionsSettings::fromContext(context));
-        // minmax_columns_types = data.getMinMaxColumnsTypes(partition_key);
 
-        // if (context->getSettingsRef().allow_experimental_analyzer)
         indexes->minmax_idx_condition.emplace(filter_actions_dag, context, minmax_columns_names, minmax_expression_actions, NameSet());
-        // else
-        //     indexes->minmax_idx_condition.emplace(query_info, context, minmax_columns_names, minmax_expression_actions);
-
         indexes->partition_pruner.emplace(metadata_snapshot, filter_actions_dag, context, false /* strict */);
     }
 
@@ -1402,32 +1397,10 @@ MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToReadImpl(
         result.column_names_to_read.push_back(ExpressionActions::getSmallestColumn(available_real_columns).name);
     }
 
-    // storage_snapshot->check(result.column_names_to_read);
-
     // Build and check if primary key is used when necessary
     const auto & primary_key = metadata_snapshot->getPrimaryKey();
     const Names & primary_key_column_names = primary_key.column_names;
 
-    // if (!key_condition)
-    // {
-    //     if (settings.query_plan_optimize_primary_key)
-    //     {
-    //         NameSet array_join_name_set;
-    //         if (query_info.syntax_analyzer_result)
-    //             array_join_name_set = query_info.syntax_analyzer_result->getArrayJoinSourceNameSet();
-
-    //         key_condition.emplace(query_info.filter_actions_dag,
-    //             context,
-    //             primary_key_column_names,
-    //             primary_key.expression,
-    //             array_join_name_set);
-    //     }
-    //     else
-    //     {
-    //         key_condition.emplace(query_info, context, primary_key_column_names, primary_key.expression);
-    //     }
-    // }
-
     if (!indexes)
         buildIndexes(indexes, query_info.filter_actions_dag, data, context, query_info, metadata_snapshot);
 
diff --git a/src/Processors/QueryPlan/ReadFromRemote.cpp b/src/Processors/QueryPlan/ReadFromRemote.cpp
index 16cb06a94d6..ed740e3e242 100644
--- a/src/Processors/QueryPlan/ReadFromRemote.cpp
+++ b/src/Processors/QueryPlan/ReadFromRemote.cpp
@@ -97,7 +97,6 @@ ReadFromRemote::ReadFromRemote(
     ClusterProxy::SelectStreamFactory::Shards shards_,
     Block header_,
     QueryProcessingStage::Enum stage_,
-    PreparedSetsPtr prepared_sets_,
     StorageID main_table_,
     ASTPtr table_func_ptr_,
     ContextMutablePtr context_,
@@ -110,7 +109,6 @@ ReadFromRemote::ReadFromRemote(
     : ISourceStep(DataStream{.header = std::move(header_)})
     , shards(std::move(shards_))
     , stage(stage_)
-    , prepared_sets(std::move(prepared_sets_))
     , main_table(std::move(main_table_))
     , table_func_ptr(std::move(table_func_ptr_))
     , context(std::move(context_))
@@ -152,7 +150,7 @@ void ReadFromRemote::addLazyPipe(Pipes & pipes, const ClusterProxy::SelectStream
             my_context = context, my_throttler = throttler,
             my_main_table = main_table, my_table_func_ptr = table_func_ptr,
             my_scalars = scalars, my_external_tables = external_tables,
-            my_stage = stage, my_prepared_sets = prepared_sets, local_delay = shard.local_delay,
+            my_stage = stage, local_delay = shard.local_delay,
             add_agg_info, add_totals, add_extremes, async_read, async_query_sending]() mutable
         -> QueryPipelineBuilder
     {
@@ -187,7 +185,7 @@ void ReadFromRemote::addLazyPipe(Pipes & pipes, const ClusterProxy::SelectStream
         if (try_results.empty() || local_delay < max_remote_delay)
         {
             auto plan = createLocalPlan(
-                query, header, my_context, my_stage, my_prepared_sets, my_shard.shard_info.shard_num, my_shard_count, 0, 0, /*coordinator=*/nullptr);
+                query, header, my_context, my_stage, my_shard.shard_info.shard_num, my_shard_count, 0, 0, /*coordinator=*/nullptr);
 
             return std::move(*plan->buildQueryPipeline(
                 QueryPlanOptimizationSettings::fromContext(my_context),
diff --git a/src/Processors/QueryPlan/ReadFromRemote.h b/src/Processors/QueryPlan/ReadFromRemote.h
index 405b5727ff2..d4005d81f1b 100644
--- a/src/Processors/QueryPlan/ReadFromRemote.h
+++ b/src/Processors/QueryPlan/ReadFromRemote.h
@@ -26,7 +26,6 @@ public:
         ClusterProxy::SelectStreamFactory::Shards shards_,
         Block header_,
         QueryProcessingStage::Enum stage_,
-        PreparedSetsPtr prepared_sets_,
         StorageID main_table_,
         ASTPtr table_func_ptr_,
         ContextMutablePtr context_,
@@ -47,7 +46,6 @@ public:
 private:
     ClusterProxy::SelectStreamFactory::Shards shards;
     QueryProcessingStage::Enum stage;
-    PreparedSetsPtr prepared_sets;
     StorageID main_table;
     ASTPtr table_func_ptr;
     ContextMutablePtr context;
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index 4c1fe4fc559..16ab99d03b4 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -77,7 +77,6 @@ bool traverseASTFilter(
             if (!future_set)
                 return false;
 
-            //if (!future_set->isReady())
             future_set->buildOrderedSetInplace(context);
 
             auto set = future_set->get();
diff --git a/src/Storages/MergeTree/KeyCondition.cpp b/src/Storages/MergeTree/KeyCondition.cpp
index d41dd30098b..f909d854cf6 100644
--- a/src/Storages/MergeTree/KeyCondition.cpp
+++ b/src/Storages/MergeTree/KeyCondition.cpp
@@ -1194,8 +1194,6 @@ bool KeyCondition::tryPrepareSetIndex(
     RPNElement & out,
     size_t & out_key_column_num)
 {
-    // std::cerr << "::: tryPrepareSetIndex for " << func.getColumnName() << std::endl;
-    // std::cerr << StackTrace().toString() << std::endl;
     const auto & left_arg = func.getArgumentAt(0);
 
     out_key_column_num = 0;
@@ -1239,56 +1237,27 @@ bool KeyCondition::tryPrepareSetIndex(
     }
 
     if (indexes_mapping.empty())
-    {
-        // std::cerr << ".. index mapping is empty\n";
         return false;
-    }
 
     const auto right_arg = func.getArgumentAt(1);
 
-    // LOG_TRACE(&Poco::Logger::get("KK"), "Trying to get set for {}", right_arg.getColumnName());
-
     auto future_set = right_arg.tryGetPreparedSet(indexes_mapping, data_types);
     if (!future_set)
-    {
-        // std::cerr << ".. no future set\n";
         return false;
-    }
 
-    // LOG_TRACE(&Poco::Logger::get("KK"), "Found set for {}", right_arg.getColumnName());
-
-    //if (!future_set->isReady())
-    //{
-        // LOG_TRACE(&Poco::Logger::get("KK"), "Building set inplace for {}", right_arg.getColumnName());
-    future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
-    //}
-
-    auto prepared_set = future_set->get();
+    auto prepared_set = future_set->buildOrderedSetInplace(right_arg.getTreeContext().getQueryContext());
     if (!prepared_set)
-    {
-
-        // std::cerr << ".. no prepared set\n";
         return false;
-    }
-
-    // LOG_TRACE(&Poco::Logger::get("KK"), "Set if ready for {}", right_arg.getColumnName());
 
     /// The index can be prepared if the elements of the set were saved in advance.
     if (!prepared_set->hasExplicitSetElements())
-    {
-
-        // std::cerr << ".. no explicit elements\n";
         return false;
-    }
-
-    // LOG_TRACE(&Poco::Logger::get("KK"), "Has explicit elements for {}", right_arg.getColumnName());
 
     prepared_set->checkColumnsNumber(left_args_count);
     for (size_t i = 0; i < indexes_mapping.size(); ++i)
         prepared_set->checkTypesEqual(indexes_mapping[i].tuple_index, data_types[i]);
 
     out.set_index = std::make_shared<MergeTreeSetIndex>(prepared_set->getSetElements(), std::move(indexes_mapping));
-    // std::cerr << ".. can use\n";
     return true;
 }
 
diff --git a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
index 125fe98203f..ee515106591 100644
--- a/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataSelectExecutor.cpp
@@ -1839,9 +1839,7 @@ void MergeTreeDataSelectExecutor::selectPartsToRead(
 
         if (partition_pruner)
         {
-            auto val = partition_pruner->canBePruned(*part);
-            // std::cerr << "... part " << part->getNameWithState() << "  cbp ? " << val << std::endl;
-            if (val)
+            if (partition_pruner->canBePruned(*part))
                 continue;
         }
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
index e2bf9bde674..398a85e92ac 100644
--- a/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexConditionBloomFilter.cpp
@@ -31,21 +31,13 @@ namespace
 
 ColumnWithTypeAndName getPreparedSetInfo(const ConstSetPtr & prepared_set)
 {
-    // std::cerr << "====== " << prepared_set->getDataTypes().size() << std::endl;
     if (prepared_set->getDataTypes().size() == 1)
         return {prepared_set->getSetElements()[0], prepared_set->getElementsTypes()[0], "dummy"};
 
     Columns set_elements;
     for (auto & set_element : prepared_set->getSetElements())
-    {
-        // std::cerr << set_element->dumpStructure() << std::endl;
-        set_elements.emplace_back(set_element->convertToFullColumnIfConst());
-    }
 
-    // for (auto & set_element : prepared_set->getElementsTypes())
-    // {
-    //     // std::cerr << set_element->getName() << std::endl;
-    // }
+        set_elements.emplace_back(set_element->convertToFullColumnIfConst());
 
     return {ColumnTuple::create(set_elements), std::make_shared<DataTypeTuple>(prepared_set->getElementsTypes()), "dummy"};
 }
@@ -319,30 +311,17 @@ bool MergeTreeIndexConditionBloomFilter::traverseFunction(const RPNBuilderTreeNo
 
         if (functionIsInOrGlobalInOperator(function_name))
         {
-            //std::cerr << StackTrace().toString() << std::endl;
-
-            auto future_set = rhs_argument.tryGetPreparedSet();
-
-            //std::cerr << "==== Finding set for MergeTreeBF " << bool(future_set) << std::endl;
-
-            if (future_set) // && !future_set->isReady())
+            if (auto future_set = rhs_argument.tryGetPreparedSet(); future_set)
             {
-                //std::cerr << "==== not ready, building " << std::endl;
-                future_set->buildOrderedSetInplace(rhs_argument.getTreeContext().getQueryContext());
-            }
-
-            ConstSetPtr prepared_set;
-            if (future_set)
-                prepared_set = future_set->get();
-
-            //std::cerr << "==== Prep set for MergeTreeBF " << bool(prepared_set) << ' ' << (prepared_set ? prepared_set->hasExplicitSetElements() : false) << std::endl;
-
-            if (prepared_set && prepared_set->hasExplicitSetElements())
-            {
-                const auto prepared_info = getPreparedSetInfo(prepared_set);
-                // std::cerr << "...... " << prepared_info.dumpStructure() << std::endl;
-                if (traverseTreeIn(function_name, lhs_argument, prepared_set, prepared_info.type, prepared_info.column, out))
-                    maybe_useful = true;
+                if (auto prepared_set = future_set->buildOrderedSetInplace(rhs_argument.getTreeContext().getQueryContext()); prepared_set)
+                {
+                    if (prepared_set->hasExplicitSetElements())
+                    {
+                        const auto prepared_info = getPreparedSetInfo(prepared_set);
+                        if (traverseTreeIn(function_name, lhs_argument, prepared_set, prepared_info.type, prepared_info.column, out))
+                            maybe_useful = true;
+                    }
+                }
             }
         }
         else if (function_name == "equals" ||
@@ -387,7 +366,6 @@ bool MergeTreeIndexConditionBloomFilter::traverseTreeIn(
         size_t row_size = column->size();
         size_t position = header.getPositionByName(key_node_column_name);
         const DataTypePtr & index_type = header.getByPosition(position).type;
-        // std::cerr << "::::: " << ColumnWithTypeAndName{column, type, ""}.dumpStructure() << " -> " << index_type->getName() << std::endl;
         const auto & converted_column = castColumn(ColumnWithTypeAndName{column, type, ""}, index_type);
         out.predicate.emplace_back(std::make_pair(position, BloomFilterHash::hashWithColumn(index_type, converted_column, 0, row_size)));
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
index 422f504d046..b6a2cafe245 100644
--- a/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexFullText.cpp
@@ -625,13 +625,10 @@ bool MergeTreeConditionFullText::tryPrepareSetBloomFilter(
         return false;
 
     auto future_set = right_argument.tryGetPreparedSet(data_types);
-    if (future_set) // && !future_set->isReady())
-        future_set->buildOrderedSetInplace(right_argument.getTreeContext().getQueryContext());
-
-    ConstSetPtr prepared_set;
-    if (future_set)
-        prepared_set = future_set->get();
+    if (!future_set)
+        return false;
 
+    auto prepared_set = future_set->buildOrderedSetInplace(right_argument.getTreeContext().getQueryContext());
     if (!prepared_set || !prepared_set->hasExplicitSetElements())
         return false;
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
index 2814b8521f6..6b4919c545d 100644
--- a/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexInverted.cpp
@@ -655,19 +655,11 @@ bool MergeTreeConditionInverted::tryPrepareSetGinFilter(
     if (key_tuple_mapping.empty())
         return false;
 
-    //std::cerr << "==== Finding set for MergeTreeConditionInverted\n";
-
     auto future_set = rhs.tryGetPreparedSet();
+    if (!future_set)
+        return false;
 
-    //std::cerr << "==== Set for MergeTreeConditionInverted" << bool(future_set) << std::endl;
-
-    if (future_set) // && !future_set->isReady())
-        future_set->buildOrderedSetInplace(rhs.getTreeContext().getQueryContext());
-
-    ConstSetPtr prepared_set;
-    if (future_set)
-        prepared_set = future_set->get();
-
+    auto prepared_set = future_set->buildOrderedSetInplace(rhs.getTreeContext().getQueryContext());
     if (!prepared_set || !prepared_set->hasExplicitSetElements())
         return false;
 
diff --git a/src/Storages/MergeTree/PartitionPruner.cpp b/src/Storages/MergeTree/PartitionPruner.cpp
index a397a1475d1..97bb9f3b4d4 100644
--- a/src/Storages/MergeTree/PartitionPruner.cpp
+++ b/src/Storages/MergeTree/PartitionPruner.cpp
@@ -29,12 +29,6 @@ PartitionPruner::PartitionPruner(const StorageMetadataPtr & metadata, ActionsDAG
     , partition_condition(filter_actions_dag, context, partition_key.column_names, partition_key.expression, {}, true /* single_point */, strict)
     , useless(strict ? partition_condition.anyUnknownOrAlwaysTrue() : partition_condition.alwaysUnknownOrTrue())
 {
-    // auto description = getKeyCondition().getDescription();
-    // std::cerr << ".... " << description.condition << std::endl;
-    // std::cerr << filter_actions_dag->dumpDAG() << std::endl;
-    // for (const auto & name : partition_key.column_names)
-    //     std::cerr << ". " << name << std::endl;
-    // std::cerr << partition_key.expression->dumpActions() << std::endl;
 }
 
 bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
@@ -52,8 +46,6 @@ bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
     else
     {
         const auto & partition_value = part.partition.value;
-        // for (const auto & val : partition_value)
-        //     std::cerr << val.dump() << std::endl;
         std::vector<FieldRef> index_value(partition_value.begin(), partition_value.end());
         for (auto & field : index_value)
         {
@@ -64,7 +56,6 @@ bool PartitionPruner::canBePruned(const IMergeTreeDataPart & part)
 
         is_valid = partition_condition.mayBeTrueInRange(
             partition_value.size(), index_value.data(), index_value.data(), partition_key.data_types);
-        // std::cerr << "may be true " << is_valid << std::endl;
         partition_filter_map.emplace(partition_id, is_valid);
 
         if (!is_valid)
diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index a69db7d80c0..c46192ab43b 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -88,10 +88,8 @@
 #include <Processors/Executors/CompletedPipelineExecutor.h>
 #include <Processors/QueryPlan/QueryPlan.h>
 #include <Processors/QueryPlan/BuildQueryPipelineSettings.h>
-#include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
 #include <Processors/QueryPlan/ReadFromPreparedSource.h>
 #include <Processors/QueryPlan/ExpressionStep.h>
-#include <QueryPipeline/QueryPipelineBuilder.h>
 #include <Processors/Sources/NullSource.h>
 #include <Processors/Sources/RemoteSource.h>
 #include <Processors/Sinks/EmptySink.h>
@@ -769,8 +767,7 @@ void StorageDistributed::read(
             header,
             snapshot_data.objects_by_shard,
             storage_snapshot,
-            processed_stage,
-            query_info.prepared_sets);
+            processed_stage);
 
     auto settings = local_context->getSettingsRef();
 
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index 655b3d5a8f4..c02c96f62be 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -231,8 +231,7 @@ void StorageMergeTree::read(
                 header,
                 {},
                 storage_snapshot,
-                processed_stage,
-                query_info.prepared_sets);
+                processed_stage);
 
         ClusterProxy::executeQueryWithParallelReplicas(
             query_plan, getStorageID(), /*remove_table_function_ptr*/ nullptr,
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 01f663aeee4..bb99e21e4ab 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -4866,8 +4866,7 @@ void StorageReplicatedMergeTree::read(
                 header,
                 {},
                 storage_snapshot,
-                processed_stage,
-                query_info.prepared_sets);
+                processed_stage);
 
         ClusterProxy::executeQueryWithParallelReplicas(
             query_plan, getStorageID(), /*remove_table_function_ptr*/ nullptr,
diff --git a/src/Storages/StorageSet.cpp b/src/Storages/StorageSet.cpp
index f9fdcdf02a6..79369ab4bcb 100644
--- a/src/Storages/StorageSet.cpp
+++ b/src/Storages/StorageSet.cpp
@@ -147,7 +147,7 @@ StorageSet::StorageSet(
     const String & comment,
     bool persistent_)
     : StorageSetOrJoinBase{disk_, relative_path_, table_id_, columns_, constraints_, comment, persistent_}
-    , set(std::make_shared<Set>(SizeLimits(), false, 0, true))
+    , set(std::make_shared<Set>(SizeLimits(), 0, true))
 {
     Block header = getInMemoryMetadataPtr()->getSampleBlock();
     set->setHeader(header.getColumnsWithTypeAndName());
@@ -176,7 +176,7 @@ void StorageSet::truncate(const ASTPtr &, const StorageMetadataPtr & metadata_sn
     Block header = metadata_snapshot->getSampleBlock();
 
     increment = 0;
-    set = std::make_shared<Set>(SizeLimits(), false, 0, true);
+    set = std::make_shared<Set>(SizeLimits(), 0, true);
     set->setHeader(header.getColumnsWithTypeAndName());
 }
 
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 4cb08b90c2a..d361a4173c1 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -323,14 +323,8 @@ static void extractPathImpl(const ActionsDAG::Node & node, Paths & res, ContextP
         if (!future_set)
             return;
 
-        //if (!future_set->isReady())
-        future_set->buildOrderedSetInplace(context);
-
-        auto set = future_set->get();
-        if (!set)
-            return;
-
-        if (!set->hasExplicitSetElements())
+        auto set = future_set->buildOrderedSetInplace(context);
+        if (!set || !set->hasExplicitSetElements())
             return;
 
         set->checkColumnsNumber(1);
diff --git a/src/Storages/VirtualColumnUtils.cpp b/src/Storages/VirtualColumnUtils.cpp
index b83afe766aa..907fc0cd22c 100644
--- a/src/Storages/VirtualColumnUtils.cpp
+++ b/src/Storages/VirtualColumnUtils.cpp
@@ -89,25 +89,6 @@ ASTPtr buildWhereExpression(const ASTs & functions)
     return makeASTFunction("and", functions);
 }
 
-// void buildSets(const ASTPtr & expression, ExpressionAnalyzer & analyzer)
-// {
-//     const auto * func = expression->as<ASTFunction>();
-//     if (func && functionIsInOrGlobalInOperator(func->name))
-//     {
-//         const IAST & args = *func->arguments;
-//         const ASTPtr & arg = args.children.at(1);
-//         if (arg->as<ASTSubquery>() || arg->as<ASTTableIdentifier>())
-//         {
-//             analyzer.tryMakeSetForIndexFromSubquery(arg);
-//         }
-//     }
-//     else
-//     {
-//         for (const auto & child : expression->children)
-//             buildSets(child, analyzer);
-//     }
-// }
-
 }
 
 namespace VirtualColumnUtils
@@ -208,7 +189,6 @@ void filterBlockWithQuery(const ASTPtr & query, Block & block, ContextPtr contex
     /// Let's analyze and calculate the prepared expression.
     auto syntax_result = TreeRewriter(context).analyze(expression_ast, block.getNamesAndTypesList());
     ExpressionAnalyzer analyzer(expression_ast, syntax_result, context);
-    //buildSets(expression_ast, analyzer);
     ExpressionActionsPtr actions = analyzer.getActions(false /* add alises */, true /* project result */, CompileExpressions::yes);
 
     for (const auto & node : actions->getNodes())
diff --git a/src/Storages/buildQueryTreeForShard.cpp b/src/Storages/buildQueryTreeForShard.cpp
index fa4730cbe84..1ee7d747fcc 100644
--- a/src/Storages/buildQueryTreeForShard.cpp
+++ b/src/Storages/buildQueryTreeForShard.cpp
@@ -1,3 +1,4 @@
+
 #include <Storages/buildQueryTreeForShard.h>
 
 #include <Analyzer/ColumnNode.h>
@@ -15,6 +16,8 @@
 #include <Planner/Utils.h>
 #include <Processors/Executors/CompletedPipelineExecutor.h>
 #include <Processors/QueryPlan/ExpressionStep.h>
+#include <Processors/QueryPlan/Optimizations/QueryPlanOptimizationSettings.h>
+#include <QueryPipeline/QueryPipelineBuilder.h>
 
 namespace DB
 {
@@ -276,11 +279,14 @@ TableNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
     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();
 
+    auto optimization_settings = QueryPlanOptimizationSettings::fromContext(mutable_context);
+    auto build_pipeline_settings = BuildQueryPipelineSettings::fromContext(mutable_context);
+    auto pipeline = QueryPipelineBuilder::getPipeline(std::move(*query_plan.buildQueryPipeline(optimization_settings, build_pipeline_settings)));
+
+    pipeline.complete(std::move(table_out));
+    CompletedPipelineExecutor executor(pipeline);
+    executor.execute();
     mutable_context->addExternalTable(temporary_table_name, std::move(external_storage_holder));
 
     return temporary_table_expression_node;
@@ -291,14 +297,13 @@ TableNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_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());
+    DistributedProductModeRewriteInJoinVisitor visitor(planner_context->getQueryContext());
     visitor.visit(query_tree_to_modify);
 
     auto replacement_map = visitor.getReplacementMap();

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 1161/1478] 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 1162/1478] 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 1163/1478] 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 1164/1478] 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 1165/1478] 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 1166/1478] 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 1167/1478] 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 376b65ee1efeeec438d52750e57182aef7379cad Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 22 Jun 2023 19:06:49 +0200
Subject: [PATCH 1168/1478] Define Thrift version for parquet

---
 contrib/arrow-cmake/CMakeLists.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/contrib/arrow-cmake/CMakeLists.txt b/contrib/arrow-cmake/CMakeLists.txt
index 5fe942d1cd0..836452c53ed 100644
--- a/contrib/arrow-cmake/CMakeLists.txt
+++ b/contrib/arrow-cmake/CMakeLists.txt
@@ -514,6 +514,10 @@ if (SANITIZE STREQUAL "undefined")
     target_compile_options(_arrow PRIVATE -fno-sanitize=undefined)
 endif ()
 
+# Define Thrift version for parquet (we use 0.16.0)
+add_definitions(-DPARQUET_THRIFT_VERSION_MAJOR=0)
+add_definitions(-DPARQUET_THRIFT_VERSION_MINOR=16)
+
 # === tools
 
 set(TOOLS_DIR "${ClickHouse_SOURCE_DIR}/contrib/arrow/cpp/tools/parquet")

From 1d379108a314abc9744069c4e697b9e87818fa7b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 22 Jun 2023 19:23:14 +0200
Subject: [PATCH 1169/1478] Update arrow version in cmake

---
 contrib/arrow-cmake/CMakeLists.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contrib/arrow-cmake/CMakeLists.txt b/contrib/arrow-cmake/CMakeLists.txt
index 836452c53ed..46b86cb4ddb 100644
--- a/contrib/arrow-cmake/CMakeLists.txt
+++ b/contrib/arrow-cmake/CMakeLists.txt
@@ -31,12 +31,12 @@ endif()
 
 set (CMAKE_CXX_STANDARD 17)
 
-set(ARROW_VERSION "6.0.1")
+set(ARROW_VERSION "11.0.0")
 string(REGEX MATCH "^[0-9]+\\.[0-9]+\\.[0-9]+" ARROW_BASE_VERSION "${ARROW_VERSION}")
 
-set(ARROW_VERSION_MAJOR "6")
+set(ARROW_VERSION_MAJOR "11")
 set(ARROW_VERSION_MINOR "0")
-set(ARROW_VERSION_PATCH "1")
+set(ARROW_VERSION_PATCH "0")
 
 if(ARROW_VERSION_MAJOR STREQUAL "0")
     # Arrow 0.x.y => SO version is "x", full SO version is "x.y.0"

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 1170/1478] 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 1171/1478] 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 ba4b5c335047f72bbed063434b5f4b7a38459fe6 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Thu, 22 Jun 2023 18:15:16 +0000
Subject: [PATCH 1172/1478] Fix stupid bug.

---
 src/Interpreters/PreparedSets.cpp | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/Interpreters/PreparedSets.cpp b/src/Interpreters/PreparedSets.cpp
index 428ef873bc5..67822ecf440 100644
--- a/src/Interpreters/PreparedSets.cpp
+++ b/src/Interpreters/PreparedSets.cpp
@@ -230,12 +230,11 @@ FutureSetPtr PreparedSets::addFromTuple(const Hash & key, Block block, const Set
     const auto & set_types = from_tuple->getTypes();
     auto & sets_by_hash = sets_from_tuple[key];
 
-    auto types = from_tuple->getTypes();
     for (const auto & set : sets_by_hash)
         if (equals(set->getTypes(), set_types))
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, from_tuple->getTypes()));
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Duplicate set: {}", toString(key, set_types));
 
-    sets_by_hash.push_back(std::move(from_tuple));
+    sets_by_hash.push_back(from_tuple);
     return from_tuple;
 }
 

From 75391afbd82b3c2aa5caae8fed82324334a49bbb Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Thu, 22 Jun 2023 18:16:48 +0000
Subject: [PATCH 1173/1478] Fix typo.

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

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index bf78868463a..cfbe53b5e4d 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1406,7 +1406,7 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
             ///
             /// Mutation is executed in two stages:
             /// * first, query 'SELECT count() FROM table WHERE ...' is executed to get the set of affected parts (using analyzer)
-            /// * second, every part is mutated separately, where plan is build "manually", usign this code as well
+            /// * second, every part is mutated separately, where plan is build "manually", using this code as well
             /// To share the Set in between first and second stage, we should use the same hash.
             /// New analyzer is uses a hash from query tree, so here we also build a query tree.
             ///

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 1174/1478] 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 1175/1478] 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 f226397fa35bc7637a1a2a078018e760ecb09d6b Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Thu, 22 Jun 2023 19:21:08 +0000
Subject: [PATCH 1176/1478] Fix check.

---
 src/Interpreters/Set.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Interpreters/Set.cpp b/src/Interpreters/Set.cpp
index b42ff102f72..b8b61c7c11f 100644
--- a/src/Interpreters/Set.cpp
+++ b/src/Interpreters/Set.cpp
@@ -173,9 +173,6 @@ void Set::setHeader(const ColumnsWithTypeAndName & header)
 
 void Set::fillSetElements()
 {
-    if (data.getTotalRowCount())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert set to ordered because it is not empty");
-
     fill_set_elements = true;
     set_elements.reserve(keys_size);
     for (const auto & type : set_elements_types)

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 1177/1478] 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 1178/1478] 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 1179/1478] 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 2b8238786e4e8f649e3bdffcf4f373dcbe54617e Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Thu, 22 Jun 2023 21:36:45 +0000
Subject: [PATCH 1180/1478] Added test

---
 .../0_stateless/02789_object_type_invalid_num_of_rows.reference | 0
 .../0_stateless/02789_object_type_invalid_num_of_rows.sql       | 2 ++
 2 files changed, 2 insertions(+)
 create mode 100644 tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
 create mode 100644 tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql

diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
new file mode 100644
index 00000000000..53d391d69ac
--- /dev/null
+++ b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
@@ -0,0 +1,2 @@
+set allow_experimental_object_type=1;
+SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST(CAST('{"x" : 1}', 'Object(Nullable(\'json\'))'), 'Object(\'json\')'))) -- { serverError NOT_IMPLEMENTED }

From 003acb4fbe1f4a1704688cf4edf44183c09c65db Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Thu, 22 Jun 2023 18:31:01 +0200
Subject: [PATCH 1181/1478] add absl as include dir

---
 contrib/abseil-cpp-cmake/CMakeLists.txt | 14 ++++++++++++++
 contrib/re2-cmake/CMakeLists.txt        | 15 ++++-----------
 2 files changed, 18 insertions(+), 11 deletions(-)

diff --git a/contrib/abseil-cpp-cmake/CMakeLists.txt b/contrib/abseil-cpp-cmake/CMakeLists.txt
index 4c31ecfc599..d64b6036611 100644
--- a/contrib/abseil-cpp-cmake/CMakeLists.txt
+++ b/contrib/abseil-cpp-cmake/CMakeLists.txt
@@ -17,3 +17,17 @@ get_target_property(FLAT_HASH_SET_INCLUDE_DIR absl::flat_hash_set INTERFACE_INCL
 target_include_directories (_abseil_swiss_tables SYSTEM BEFORE INTERFACE ${FLAT_HASH_SET_INCLUDE_DIR})
 
 add_library(ch_contrib::abseil_swiss_tables ALIAS _abseil_swiss_tables)
+
+set(ABSL_FORMAT_SRC
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/arg.cc
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/bind.cc
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/extension.cc
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/float_conversion.cc
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/output.cc
+    ${ABSL_ROOT_DIR}/absl/strings/internal/str_format/parser.cc
+)
+
+add_library(_abseil_str_format ${ABSL_FORMAT_SRC})
+target_include_directories(_abseil_str_format PUBLIC ${ABSL_ROOT_DIR})
+
+add_library(ch_contrib::abseil_str_format ALIAS _abseil_str_format)
diff --git a/contrib/re2-cmake/CMakeLists.txt b/contrib/re2-cmake/CMakeLists.txt
index a081f92bc94..305c2400c77 100644
--- a/contrib/re2-cmake/CMakeLists.txt
+++ b/contrib/re2-cmake/CMakeLists.txt
@@ -12,6 +12,7 @@ endif()
 set(SRC_DIR "${ClickHouse_SOURCE_DIR}/contrib/re2")
 
 set(RE2_SOURCES
+    ${SRC_DIR}/re2/bitmap256.cc
     ${SRC_DIR}/re2/bitstate.cc
     ${SRC_DIR}/re2/compile.cc
     ${SRC_DIR}/re2/dfa.cc
@@ -31,11 +32,13 @@ set(RE2_SOURCES
     ${SRC_DIR}/re2/tostring.cc
     ${SRC_DIR}/re2/unicode_casefold.cc
     ${SRC_DIR}/re2/unicode_groups.cc
+    ${SRC_DIR}/util/pcre.cc
     ${SRC_DIR}/util/rune.cc
     ${SRC_DIR}/util/strutil.cc
 )
 add_library(re2 ${RE2_SOURCES})
 target_include_directories(re2 PUBLIC "${SRC_DIR}")
+target_link_libraries(re2 ch_contrib::abseil_str_format)
 
 # Building re2 which is thread-safe and re2_st which is not.
 # re2 changes its state during matching of regular expression, e.g. creates temporary DFA.
@@ -47,6 +50,7 @@ target_compile_definitions (re2_st PRIVATE NDEBUG NO_THREADS re2=re2_st)
 target_include_directories (re2_st PRIVATE .)
 target_include_directories (re2_st SYSTEM PUBLIC ${CMAKE_CURRENT_BINARY_DIR})
 target_include_directories (re2_st SYSTEM BEFORE PUBLIC ${SRC_DIR})
+target_link_libraries (re2_st ch_contrib::abseil_str_format)
 
 file (MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/re2_st)
 foreach (FILENAME filtered_re2.h re2.h set.h stringpiece.h)
@@ -59,17 +63,6 @@ foreach (FILENAME filtered_re2.h re2.h set.h stringpiece.h)
     add_dependencies (re2_st transform_${FILENAME})
 endforeach ()
 
-file (MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/util)
-foreach (FILENAME mutex.h)
-    add_custom_command (OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/util/${FILENAME}"
-        COMMAND ${CMAKE_COMMAND} -DSOURCE_FILENAME="${SRC_DIR}/util/${FILENAME}"
-            -DTARGET_FILENAME="${CMAKE_CURRENT_BINARY_DIR}/util/${FILENAME}"
-            -P "${CMAKE_CURRENT_SOURCE_DIR}/re2_transform.cmake"
-        COMMENT "Creating ${FILENAME} for re2_st library.")
-    add_custom_target (transform_${FILENAME} DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/util/${FILENAME}")
-    add_dependencies (re2_st transform_${FILENAME})
-endforeach ()
-
 # NOTE: you should not change name of library here, since it is used to generate required header (see above)
 add_library(ch_contrib::re2 ALIAS re2)
 add_library(ch_contrib::re2_st ALIAS re2_st)

From fb7d23f245c3cd44f4f096f362fcb4ef948b1580 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Thu, 22 Jun 2023 18:31:12 +0200
Subject: [PATCH 1182/1478] fix build

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

diff --git a/src/Dictionaries/RegExpTreeDictionary.cpp b/src/Dictionaries/RegExpTreeDictionary.cpp
index 3852cca6928..074b179c48e 100644
--- a/src/Dictionaries/RegExpTreeDictionary.cpp
+++ b/src/Dictionaries/RegExpTreeDictionary.cpp
@@ -479,7 +479,7 @@ std::pair<String, bool> processBackRefs(const String & data, const re2_st::RE2 &
     for (const auto & item : pieces)
     {
         if (item.ref_num >= 0 && item.ref_num < 10)
-            result += matches[item.ref_num].ToString();
+            result += String{matches[item.ref_num]};
         else
             result += item.literal;
     }

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 1183/1478] 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 1184/1478] 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 1185/1478] 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 1186/1478] 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 1187/1478] 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 7d00b26a884aaf09b5170e56311caba17a6ba7ce Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Thu, 22 Jun 2023 22:39:38 +0000
Subject: [PATCH 1188/1478] always reprodusible with max_threads=1

---
 .../0_stateless/02789_object_type_invalid_num_of_rows.sql       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
index 53d391d69ac..8ced133c8eb 100644
--- a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
+++ b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
@@ -1,2 +1,2 @@
 set allow_experimental_object_type=1;
-SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST(CAST('{"x" : 1}', 'Object(Nullable(\'json\'))'), 'Object(\'json\')'))) -- { serverError NOT_IMPLEMENTED }
+SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST(CAST('{"x" : 1}', 'Object(Nullable(\'json\'))'), 'Object(\'json\')'))) settings max_threads=1; -- { serverError NOT_IMPLEMENTED }

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 1189/1478] 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 1190/1478] 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 1191/1478] 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 db8120722f5281996e29972ba2b9f3eab965e6d1 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Fri, 23 Jun 2023 12:00:20 +0200
Subject: [PATCH 1192/1478] Separated functionality of Iterator into
 GlobIterator and KeysIterator, added test for filter by file

---
 src/Storages/StorageAzureBlob.cpp             | 332 +++++++++---------
 src/Storages/StorageAzureBlob.h               |  64 +++-
 .../test_storage_azure_blob_storage/test.py   |  16 +
 3 files changed, 233 insertions(+), 179 deletions(-)

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 91dc92f09e8..8a1c81e808e 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -611,19 +611,19 @@ Pipe StorageAzureBlob::read(
             requested_virtual_columns.push_back(virtual_column);
     }
 
-    std::shared_ptr<StorageAzureBlobSource::Iterator> iterator_wrapper;
+    std::shared_ptr<StorageAzureBlobSource::IIterator> iterator_wrapper;
     if (configuration.withGlobs())
     {
         /// Iterate through disclosed globs and make a source for each file
-        iterator_wrapper = std::make_shared<StorageAzureBlobSource::Iterator>(
-            object_storage.get(), configuration.container, std::nullopt,
-            configuration.blob_path, query_info.query, virtual_block, local_context, nullptr);
+        iterator_wrapper = std::make_shared<StorageAzureBlobSource::GlobIterator>(
+            object_storage.get(), configuration.container, configuration.blob_path,
+            query_info.query, virtual_block, local_context, nullptr);
     }
     else
     {
-        iterator_wrapper = std::make_shared<StorageAzureBlobSource::Iterator>(
+        iterator_wrapper = std::make_shared<StorageAzureBlobSource::KeysIterator>(
             object_storage.get(), configuration.container, configuration.blobs_paths,
-            std::nullopt, query_info.query, virtual_block, local_context, nullptr);
+            query_info.query, virtual_block, local_context, nullptr);
     }
 
     ColumnsDescription columns_description;
@@ -786,201 +786,129 @@ static void addPathToVirtualColumns(Block & block, const String & path, size_t i
     block.getByName("_idx").column->assumeMutableRef().insert(idx);
 }
 
-StorageAzureBlobSource::Iterator::Iterator(
+StorageAzureBlobSource::GlobIterator::GlobIterator(
     AzureObjectStorage * object_storage_,
     const std::string & container_,
-    std::optional<Strings> keys_,
-    std::optional<String> blob_path_with_globs_,
+    String blob_path_with_globs_,
     ASTPtr query_,
     const Block & virtual_header_,
     ContextPtr context_,
     RelativePathsWithMetadata * outer_blobs_)
-    : WithContext(context_)
+    : IIterator(context_)
     , object_storage(object_storage_)
     , container(container_)
-    , keys(keys_)
     , blob_path_with_globs(blob_path_with_globs_)
     , query(query_)
     , virtual_header(virtual_header_)
     , outer_blobs(outer_blobs_)
 {
-    if (keys.has_value() && blob_path_with_globs.has_value())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot specify keys and glob simultaneously it's a bug");
 
-    if (!keys.has_value() && !blob_path_with_globs.has_value())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Both keys and glob mask are not specified");
+    const String key_prefix = blob_path_with_globs.substr(0, blob_path_with_globs.find_first_of("*?{"));
 
-    if (keys)
+    /// We don't have to list bucket, because there is no asterisks.
+    if (key_prefix.size() == blob_path_with_globs.size())
     {
-        Strings all_keys = *keys;
-
-        blobs_with_metadata.emplace();
-        /// Create a virtual block with one row to construct filter
-        if (query && virtual_header && !all_keys.empty())
-        {
-            /// Append "idx" column as the filter result
-            virtual_header.insert({ColumnUInt64::create(), std::make_shared<DataTypeUInt64>(), "_idx"});
-
-            auto block = virtual_header.cloneEmpty();
-            addPathToVirtualColumns(block, fs::path(container) / all_keys.front(), 0);
-
-            VirtualColumnUtils::prepareFilterBlockWithQuery(query, getContext(), block, filter_ast);
-
-            if (filter_ast)
-            {
-                block = virtual_header.cloneEmpty();
-                for (size_t i = 0; i < all_keys.size(); ++i)
-                    addPathToVirtualColumns(block, fs::path(container) / all_keys[i], i);
-
-                VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
-                const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
-
-                Strings filtered_keys;
-                filtered_keys.reserve(block.rows());
-                for (UInt64 idx : idxs.getData())
-                    filtered_keys.emplace_back(std::move(all_keys[idx]));
-
-                all_keys = std::move(filtered_keys);
-            }
-        }
-
-        for (auto && key : all_keys)
-        {
-            ObjectMetadata object_metadata = object_storage->getObjectMetadata(key);
-            total_size += object_metadata.size_bytes;
-            blobs_with_metadata->emplace_back(RelativePathWithMetadata{key, object_metadata});
-            if (outer_blobs)
-                outer_blobs->emplace_back(blobs_with_metadata->back());
-        }
-    }
-    else
-    {
-        const String key_prefix = blob_path_with_globs->substr(0, blob_path_with_globs->find_first_of("*?{"));
-
-        /// We don't have to list bucket, because there is no asterisks.
-        if (key_prefix.size() == blob_path_with_globs->size())
-        {
-            ObjectMetadata object_metadata = object_storage->getObjectMetadata(*blob_path_with_globs);
-            blobs_with_metadata->emplace_back(*blob_path_with_globs, object_metadata);
-            if (outer_blobs)
-                outer_blobs->emplace_back(blobs_with_metadata->back());
-            return;
-        }
-
-        object_storage_iterator = object_storage->iterate(key_prefix);
-
-        matcher = std::make_unique<re2::RE2>(makeRegexpPatternFromGlobs(*blob_path_with_globs));
-
-        if (!matcher->ok())
-            throw Exception(ErrorCodes::CANNOT_COMPILE_REGEXP,
-                "Cannot compile regex from glob ({}): {}", *blob_path_with_globs, matcher->error());
-
-        recursive = *blob_path_with_globs == "/**" ? true : false;
+        ObjectMetadata object_metadata = object_storage->getObjectMetadata(blob_path_with_globs);
+        blobs_with_metadata.emplace_back(blob_path_with_globs, object_metadata);
+        if (outer_blobs)
+            outer_blobs->emplace_back(blobs_with_metadata.back());
+        return;
     }
 
+    object_storage_iterator = object_storage->iterate(key_prefix);
+
+    matcher = std::make_unique<re2::RE2>(makeRegexpPatternFromGlobs(blob_path_with_globs));
+
+    if (!matcher->ok())
+        throw Exception(
+            ErrorCodes::CANNOT_COMPILE_REGEXP, "Cannot compile regex from glob ({}): {}", blob_path_with_globs, matcher->error());
+
+    recursive = blob_path_with_globs == "/**" ? true : false;
 }
 
-RelativePathWithMetadata StorageAzureBlobSource::Iterator::next()
+RelativePathWithMetadata StorageAzureBlobSource::GlobIterator::next()
 {
+    std::lock_guard lock(next_mutex);
+
     if (is_finished)
         return {};
 
-    if (keys)
+    bool need_new_batch = blobs_with_metadata.empty() || index >= blobs_with_metadata.size();
+
+    if (need_new_batch)
     {
-        size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
-        if (current_index >= blobs_with_metadata->size())
+        RelativePathsWithMetadata new_batch;
+        while (new_batch.empty())
         {
-            is_finished = true;
-            return {};
-        }
-
-        return (*blobs_with_metadata)[current_index];
-    }
-    else
-    {
-        bool need_new_batch = false;
-        {
-            std::lock_guard lock(next_mutex);
-            need_new_batch = !blobs_with_metadata || index >= blobs_with_metadata->size();
-        }
-
-        if (need_new_batch)
-        {
-            RelativePathsWithMetadata new_batch;
-            while (new_batch.empty())
+            auto result = object_storage_iterator->getCurrrentBatchAndScheduleNext();
+            if (result.has_value())
             {
-                auto result = object_storage_iterator->getCurrrentBatchAndScheduleNext();
-                if (result.has_value())
-                {
-                    new_batch = result.value();
-                }
-                else
-                {
-                    is_finished = true;
-                    return {};
-                }
-
-                for (auto it = new_batch.begin(); it != new_batch.end();)
-                {
-                    if (!recursive && !re2::RE2::FullMatch(it->relative_path, *matcher))
-                        it = new_batch.erase(it);
-                    else
-                        ++it;
-                }
-            }
-
-            index.store(0, std::memory_order_relaxed);
-            if (!is_initialized)
-            {
-                createFilterAST(new_batch.front().relative_path);
-                is_initialized = true;
-            }
-
-            if (filter_ast)
-            {
-                auto block = virtual_header.cloneEmpty();
-                for (size_t i = 0; i < new_batch.size(); ++i)
-                    addPathToVirtualColumns(block, fs::path(container) / new_batch[i].relative_path, i);
-
-                VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
-                const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
-
-                std::lock_guard lock(next_mutex);
-                blob_path_with_globs.reset();
-                blob_path_with_globs.emplace();
-                for (UInt64 idx : idxs.getData())
-                {
-                    total_size.fetch_add(new_batch[idx].metadata.size_bytes, std::memory_order_relaxed);
-                    blobs_with_metadata->emplace_back(std::move(new_batch[idx]));
-                    if (outer_blobs)
-                        outer_blobs->emplace_back(blobs_with_metadata->back());
-                }
+                new_batch = result.value();
             }
             else
             {
-                if (outer_blobs)
-                    outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
+                is_finished = true;
+                return {};
+            }
 
-                std::lock_guard lock(next_mutex);
-                blobs_with_metadata = std::move(new_batch);
-                for (const auto & [_, info] : *blobs_with_metadata)
-                    total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
+            for (auto it = new_batch.begin(); it != new_batch.end();)
+            {
+                if (!recursive && !re2::RE2::FullMatch(it->relative_path, *matcher))
+                    it = new_batch.erase(it);
+                else
+                    ++it;
             }
         }
 
-        size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
-        std::lock_guard lock(next_mutex);
-        return (*blobs_with_metadata)[current_index];
+        index.store(0, std::memory_order_relaxed);
+        if (!is_initialized)
+        {
+            createFilterAST(new_batch.front().relative_path);
+            is_initialized = true;
+        }
+
+        if (filter_ast)
+        {
+            auto block = virtual_header.cloneEmpty();
+            for (size_t i = 0; i < new_batch.size(); ++i)
+                addPathToVirtualColumns(block, fs::path(container) / new_batch[i].relative_path, i);
+
+            VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
+            const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
+
+            blobs_with_metadata.clear();
+            for (UInt64 idx : idxs.getData())
+            {
+                total_size.fetch_add(new_batch[idx].metadata.size_bytes, std::memory_order_relaxed);
+                blobs_with_metadata.emplace_back(std::move(new_batch[idx]));
+                if (outer_blobs)
+                    outer_blobs->emplace_back(blobs_with_metadata.back());
+            }
+        }
+        else
+        {
+            if (outer_blobs)
+                outer_blobs->insert(outer_blobs->end(), new_batch.begin(), new_batch.end());
+
+            blobs_with_metadata = std::move(new_batch);
+            for (const auto & [_, info] : blobs_with_metadata)
+                total_size.fetch_add(info.size_bytes, std::memory_order_relaxed);
+        }
     }
+
+    size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
+    if (current_index >= blobs_with_metadata.size())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Index out of bound for blob metadata");
+    return blobs_with_metadata[current_index];
 }
 
-size_t StorageAzureBlobSource::Iterator::getTotalSize() const
+size_t StorageAzureBlobSource::GlobIterator::getTotalSize() const
 {
     return total_size.load(std::memory_order_relaxed);
 }
 
 
-void StorageAzureBlobSource::Iterator::createFilterAST(const String & any_key)
+void StorageAzureBlobSource::GlobIterator::createFilterAST(const String & any_key)
 {
     if (!query || !virtual_header)
         return;
@@ -995,6 +923,78 @@ void StorageAzureBlobSource::Iterator::createFilterAST(const String & any_key)
 }
 
 
+StorageAzureBlobSource::KeysIterator::KeysIterator(
+    AzureObjectStorage * object_storage_,
+    const std::string & container_,
+    Strings keys_,
+    ASTPtr query_,
+    const Block & virtual_header_,
+    ContextPtr context_,
+    RelativePathsWithMetadata * outer_blobs_)
+    : IIterator(context_)
+    , object_storage(object_storage_)
+    , container(container_)
+    , query(query_)
+    , virtual_header(virtual_header_)
+    , outer_blobs(outer_blobs_)
+{
+    Strings all_keys = keys_;
+
+    /// Create a virtual block with one row to construct filter
+    if (query && virtual_header && !all_keys.empty())
+    {
+        /// Append "idx" column as the filter result
+        virtual_header.insert({ColumnUInt64::create(), std::make_shared<DataTypeUInt64>(), "_idx"});
+
+        auto block = virtual_header.cloneEmpty();
+        addPathToVirtualColumns(block, fs::path(container) / all_keys.front(), 0);
+
+        VirtualColumnUtils::prepareFilterBlockWithQuery(query, getContext(), block, filter_ast);
+
+        if (filter_ast)
+        {
+            block = virtual_header.cloneEmpty();
+            for (size_t i = 0; i < all_keys.size(); ++i)
+                addPathToVirtualColumns(block, fs::path(container) / all_keys[i], i);
+
+            VirtualColumnUtils::filterBlockWithQuery(query, block, getContext(), filter_ast);
+            const auto & idxs = typeid_cast<const ColumnUInt64 &>(*block.getByName("_idx").column);
+
+            Strings filtered_keys;
+            filtered_keys.reserve(block.rows());
+            for (UInt64 idx : idxs.getData())
+                filtered_keys.emplace_back(std::move(all_keys[idx]));
+
+            all_keys = std::move(filtered_keys);
+        }
+    }
+
+    for (auto && key : all_keys)
+    {
+        ObjectMetadata object_metadata = object_storage->getObjectMetadata(key);
+        total_size += object_metadata.size_bytes;
+        keys.emplace_back(RelativePathWithMetadata{key, object_metadata});
+    }
+
+    if (outer_blobs)
+        *outer_blobs = keys;
+}
+
+RelativePathWithMetadata StorageAzureBlobSource::KeysIterator::next()
+{
+    size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
+    if (current_index >= keys.size())
+        return {};
+
+    return keys[current_index];
+}
+
+size_t StorageAzureBlobSource::KeysIterator::getTotalSize() const
+{
+    return total_size.load(std::memory_order_relaxed);
+}
+
+
 Chunk StorageAzureBlobSource::generate()
 {
     while (true)
@@ -1072,7 +1072,7 @@ StorageAzureBlobSource::StorageAzureBlobSource(
     String compression_hint_,
     AzureObjectStorage * object_storage_,
     const String & container_,
-    std::shared_ptr<Iterator> file_iterator_)
+    std::shared_ptr<IIterator> file_iterator_)
     :ISource(getHeader(sample_block_, requested_virtual_columns_))
     , WithContext(context_)
     , requested_virtual_columns(requested_virtual_columns_)
@@ -1167,18 +1167,16 @@ ColumnsDescription StorageAzureBlob::getTableStructureFromData(
     ContextPtr ctx)
 {
     RelativePathsWithMetadata read_keys;
-    std::shared_ptr<StorageAzureBlobSource::Iterator> file_iterator;
+    std::shared_ptr<StorageAzureBlobSource::IIterator> file_iterator;
     if (configuration.withGlobs())
     {
-        file_iterator = std::make_shared<StorageAzureBlobSource::Iterator>(
-            object_storage, configuration.container, std::nullopt,
-            configuration.blob_path, nullptr, Block{}, ctx, &read_keys);
+        file_iterator = std::make_shared<StorageAzureBlobSource::GlobIterator>(
+            object_storage, configuration.container, configuration.blob_path, nullptr, Block{}, ctx, &read_keys);
     }
     else
     {
-        file_iterator = std::make_shared<StorageAzureBlobSource::Iterator>(
-            object_storage, configuration.container, configuration.blobs_paths,
-            std::nullopt, nullptr, Block{}, ctx, &read_keys);
+        file_iterator = std::make_shared<StorageAzureBlobSource::KeysIterator>(
+            object_storage, configuration.container, configuration.blobs_paths, nullptr, Block{}, ctx, &read_keys);
     }
 
     std::optional<ColumnsDescription> columns_from_cache;
diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index e2001fa24ae..31b2beb05aa 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -142,28 +142,37 @@ private:
 class StorageAzureBlobSource : public ISource, WithContext
 {
 public:
-    class Iterator : WithContext
+    class IIterator : public WithContext
     {
     public:
-        Iterator(
+        IIterator(ContextPtr context_):WithContext(context_) {}
+        virtual ~IIterator() = default;
+        virtual RelativePathWithMetadata next() = 0;
+        virtual size_t getTotalSize() const = 0;
+
+        RelativePathWithMetadata operator ()() { return next(); }
+    };
+
+    class GlobIterator : public IIterator
+    {
+    public:
+        GlobIterator(
             AzureObjectStorage * object_storage_,
             const std::string & container_,
-            std::optional<Strings> keys_,
-            std::optional<String> blob_path_with_globs_,
+            String blob_path_with_globs_,
             ASTPtr query_,
             const Block & virtual_header_,
             ContextPtr context_,
             RelativePathsWithMetadata * outer_blobs_);
 
-        RelativePathWithMetadata next();
-        size_t getTotalSize() const;
-        ~Iterator() = default;
+        RelativePathWithMetadata next() override;
+        size_t getTotalSize() const override;
+        ~GlobIterator() override = default;
 
      private:
         AzureObjectStorage * object_storage;
         std::string container;
-        std::optional<Strings> keys;
-        std::optional<String> blob_path_with_globs;
+        String blob_path_with_globs;
         ASTPtr query;
         ASTPtr filter_ast;
         Block virtual_header;
@@ -171,7 +180,7 @@ public:
         std::atomic<size_t> index = 0;
         std::atomic<size_t> total_size = 0;
 
-        std::optional<RelativePathsWithMetadata> blobs_with_metadata;
+        RelativePathsWithMetadata blobs_with_metadata;
         RelativePathsWithMetadata * outer_blobs;
         ObjectStorageIteratorPtr object_storage_iterator;
         bool recursive{false};
@@ -184,6 +193,37 @@ public:
         std::mutex next_mutex;
     };
 
+    class KeysIterator : public IIterator
+    {
+    public:
+        KeysIterator(
+            AzureObjectStorage * object_storage_,
+            const std::string & container_,
+            Strings keys_,
+            ASTPtr query_,
+            const Block & virtual_header_,
+            ContextPtr context_,
+            RelativePathsWithMetadata * outer_blobs_);
+
+        RelativePathWithMetadata next() override;
+        size_t getTotalSize() const override;
+        ~KeysIterator() override = default;
+
+    private:
+        AzureObjectStorage * object_storage;
+        std::string container;
+        RelativePathsWithMetadata keys;
+
+        ASTPtr query;
+        ASTPtr filter_ast;
+        Block virtual_header;
+
+        std::atomic<size_t> index = 0;
+        std::atomic<size_t> total_size = 0;
+
+        RelativePathsWithMetadata * outer_blobs;
+    };
+
     StorageAzureBlobSource(
         const std::vector<NameAndTypePair> & requested_virtual_columns_,
         const String & format_,
@@ -196,7 +236,7 @@ public:
         String compression_hint_,
         AzureObjectStorage * object_storage_,
         const String & container_,
-        std::shared_ptr<Iterator> file_iterator_);
+        std::shared_ptr<IIterator> file_iterator_);
 
     ~StorageAzureBlobSource() override;
 
@@ -217,7 +257,7 @@ private:
     String compression_hint;
     AzureObjectStorage * object_storage;
     String container;
-    std::shared_ptr<Iterator> file_iterator;
+    std::shared_ptr<IIterator> file_iterator;
 
     struct ReaderHolder
     {
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 0de325ccd14..5f812cbe4fc 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -595,3 +595,19 @@ def test_partition_by_tf(cluster):
     assert "1,2,3\n" == get_azure_file_content("test_partition_tf_3.csv")
     assert "3,2,1\n" == get_azure_file_content("test_partition_tf_1.csv")
     assert "78,43,45\n" == get_azure_file_content("test_partition_tf_45.csv")
+
+def test_filter_using_file(cluster):
+    node = cluster.instances["node"]
+    table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
+    partition_by = "column3"
+    values = "(1, 2, 3), (3, 2, 1), (78, 43, 45)"
+    filename = "test_partition_tf_{_partition_id}.csv"
+
+    azure_query(
+        node,
+        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}",
+    )
+
+    query = f"select count(*) from azureBlobStorage('http://azurite1:10000/devstoreaccount1',  'cont', 'test_partition_tf_*.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', '{table_format}') WHERE _file='test_partition_tf_3.csv'"
+    assert azure_query(node, query) == "1\n"
+

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 1193/1478] 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 1194/1478] 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 b6517217d8fe5c56bf5086a8965d626674cbfd7a Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Fri, 23 Jun 2023 10:17:20 +0000
Subject: [PATCH 1195/1478] Automatic style fix

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

diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index 5f812cbe4fc..6089466ff5d 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -596,6 +596,7 @@ def test_partition_by_tf(cluster):
     assert "3,2,1\n" == get_azure_file_content("test_partition_tf_1.csv")
     assert "78,43,45\n" == get_azure_file_content("test_partition_tf_45.csv")
 
+
 def test_filter_using_file(cluster):
     node = cluster.instances["node"]
     table_format = "column1 UInt32, column2 UInt32, column3 UInt32"
@@ -610,4 +611,3 @@ def test_filter_using_file(cluster):
 
     query = f"select count(*) from azureBlobStorage('http://azurite1:10000/devstoreaccount1',  'cont', 'test_partition_tf_*.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', '{table_format}') WHERE _file='test_partition_tf_3.csv'"
     assert azure_query(node, query) == "1\n"
-

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 1196/1478] 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 1197/1478] 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 1198/1478] 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 1199/1478] 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 1200/1478] 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 1201/1478] 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 b5ad349c4f4a877b1cc2386a17a77ff65724394c Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Fri, 23 Jun 2023 14:34:24 +0200
Subject: [PATCH 1202/1478] Removed unwanted atomic variables to non atomic

---
 src/Storages/StorageAzureBlob.cpp | 4 ++--
 src/Storages/StorageAzureBlob.h   | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 8a1c81e808e..d582cfe6f4c 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -860,7 +860,7 @@ RelativePathWithMetadata StorageAzureBlobSource::GlobIterator::next()
             }
         }
 
-        index.store(0, std::memory_order_relaxed);
+        index = 0;
         if (!is_initialized)
         {
             createFilterAST(new_batch.front().relative_path);
@@ -896,7 +896,7 @@ RelativePathWithMetadata StorageAzureBlobSource::GlobIterator::next()
         }
     }
 
-    size_t current_index = index.fetch_add(1, std::memory_order_relaxed);
+    size_t current_index = index++;
     if (current_index >= blobs_with_metadata.size())
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Index out of bound for blob metadata");
     return blobs_with_metadata[current_index];
diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index 31b2beb05aa..746c84841ca 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -177,7 +177,7 @@ public:
         ASTPtr filter_ast;
         Block virtual_header;
 
-        std::atomic<size_t> index = 0;
+        size_t index = 0;
         std::atomic<size_t> total_size = 0;
 
         RelativePathsWithMetadata blobs_with_metadata;
@@ -188,8 +188,8 @@ public:
         std::unique_ptr<re2::RE2> matcher;
 
         void createFilterAST(const String & any_key);
-        std::atomic<bool> is_finished = false;
-        std::atomic<bool> is_initialized = false;
+        bool is_finished = false;
+        bool is_initialized = false;
         std::mutex next_mutex;
     };
 

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 1203/1478] 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 1204/1478] 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 1205/1478] 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 1206/1478] 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 1207/1478] 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 598da6207e355142278ddc061e6a191974697438 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Fri, 23 Jun 2023 15:49:37 +0000
Subject: [PATCH 1208/1478] Use inNull and add a comment.

---
 src/Storages/MergeTree/MergeTreeIndexSet.cpp | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeIndexSet.cpp b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
index 7f6edfc7ec4..9c34a149128 100644
--- a/src/Storages/MergeTree/MergeTreeIndexSet.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexSet.cpp
@@ -554,7 +554,10 @@ void MergeTreeIndexConditionSet::traverseAST(ASTPtr & node) const
     if (atomFromAST(node))
     {
         if (node->as<ASTIdentifier>() || node->as<ASTFunction>())
-            node = makeASTFunction("__bitWrapperFunc", makeASTFunction("toUInt8OrDefault", node));
+            /// __bitWrapperFunc* uses default implementation for Nullable types
+            /// Here we additionally convert Null to 0,
+            /// otherwise condition 'something OR NULL' will always return Null and filter everything.
+            node = makeASTFunction("__bitWrapperFunc", makeASTFunction("ifNull", node, std::make_shared<ASTLiteral>(Field(0))));
     }
     else
         node = std::make_shared<ASTLiteral>(UNKNOWN_FIELD);

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 1209/1478] 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 1210/1478] 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 1211/1478] 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 1212/1478] 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 1213/1478] 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 1214/1478] 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 1215/1478] 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 1216/1478] 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 fad07bf4b83cd6676fc37032041d772c987f1fe5 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Fri, 23 Jun 2023 23:42:31 +0200
Subject: [PATCH 1217/1478] Fix using locks in ProcessList.

---
 src/Interpreters/ProcessList.cpp | 26 ++++++++++++++++++--------
 src/Interpreters/ProcessList.h   |  1 +
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/src/Interpreters/ProcessList.cpp b/src/Interpreters/ProcessList.cpp
index aca474bf152..c8e33b477a1 100644
--- a/src/Interpreters/ProcessList.cpp
+++ b/src/Interpreters/ProcessList.cpp
@@ -246,6 +246,7 @@ ProcessList::insert(const String & query_, const IAST * ast, ContextMutablePtr q
                 priorities.insert(static_cast<int>(settings.priority)),
                 std::move(thread_group),
                 query_kind,
+                settings,
                 watch_start_nanoseconds));
 
         increaseQueryKindAmount(query_kind);
@@ -342,6 +343,7 @@ QueryStatus::QueryStatus(
     QueryPriorities::Handle && priority_handle_,
     ThreadGroupPtr && thread_group_,
     IAST::QueryKind query_kind_,
+    const Settings & query_settings_,
     UInt64 watch_start_nanoseconds)
     : WithContext(context_)
     , query(query_)
@@ -353,9 +355,11 @@ QueryStatus::QueryStatus(
     , query_kind(query_kind_)
     , num_queries_increment(CurrentMetrics::Query)
 {
-    auto settings = getContext()->getSettings();
-    limits.max_execution_time = settings.max_execution_time;
-    overflow_mode = settings.timeout_overflow_mode;
+    /// We have to pass `query_settings_` to this constructor because we can't use `context_->getSettings().max_execution_time` here:
+    /// a QueryStatus is created with `ProcessList::mutex` locked (see ProcessList::insert) and calling `context_->getSettings()`
+    /// would lock the context's lock too, whereas holding two those locks simultaneously is not good.
+    limits.max_execution_time = query_settings_.max_execution_time;
+    overflow_mode = query_settings_.timeout_overflow_mode;
 }
 
 QueryStatus::~QueryStatus()
@@ -601,12 +605,18 @@ QueryStatusInfo QueryStatus::getInfo(bool get_thread_list, bool get_profile_even
 
 ProcessList::Info ProcessList::getInfo(bool get_thread_list, bool get_profile_events, bool get_settings) const
 {
+    /// We have to copy `processes` first because `process->getInfo()` below can access the context to get the query settings,
+    /// and it's better not to keep the process list's lock while doing that.
+    std::vector<QueryStatusPtr> processes_copy;
+
+    {
+        auto lock = safeLock();
+        processes_copy.assign(processes.begin(), processes.end());
+    }
+
     Info per_query_infos;
-
-    auto lock = safeLock();
-
-    per_query_infos.reserve(processes.size());
-    for (const auto & process : processes)
+    per_query_infos.reserve(processes_copy.size());
+    for (const auto & process : processes_copy)
         per_query_infos.emplace_back(process->getInfo(get_thread_list, get_profile_events, get_settings));
 
     return per_query_infos;
diff --git a/src/Interpreters/ProcessList.h b/src/Interpreters/ProcessList.h
index b593bcef395..e5a61497ff2 100644
--- a/src/Interpreters/ProcessList.h
+++ b/src/Interpreters/ProcessList.h
@@ -164,6 +164,7 @@ public:
         QueryPriorities::Handle && priority_handle_,
         ThreadGroupPtr && thread_group_,
         IAST::QueryKind query_kind_,
+        const Settings & query_settings_,
         UInt64 watch_start_nanoseconds);
 
     ~QueryStatus();

From be17a817929ea7fef4a68ac108f89a65f0e21827 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sat, 24 Jun 2023 00:12:31 +0000
Subject: [PATCH 1218/1478] recursively collect call stacks on job scheduling
 and add all stack traces to exceptions printout

---
 src/Common/Exception.cpp  | 19 ++++++++++++++++++-
 src/Common/Exception.h    | 12 +++++++++++-
 src/Common/ThreadPool.cpp |  9 ++++++++-
 src/Common/ThreadPool.h   | 14 ++++++++++++--
 4 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/src/Common/Exception.cpp b/src/Common/Exception.cpp
index 20206b76225..a43335ed8de 100644
--- a/src/Common/Exception.cpp
+++ b/src/Common/Exception.cpp
@@ -1,5 +1,6 @@
 #include "Exception.h"
 
+#include <algorithm>
 #include <cstring>
 #include <cxxabi.h>
 #include <cstdlib>
@@ -83,6 +84,7 @@ Exception::Exception(const MessageMasked & msg_masked, int code, bool remote_)
     : Poco::Exception(msg_masked.msg, code)
     , remote(remote_)
 {
+    capture_thread_frame_pointers = thread_frame_pointers;
     handle_error_code(msg_masked.msg, code, remote, getStackFramePointers());
 }
 
@@ -90,12 +92,14 @@ Exception::Exception(MessageMasked && msg_masked, int code, bool remote_)
     : Poco::Exception(msg_masked.msg, code)
     , remote(remote_)
 {
+    capture_thread_frame_pointers = thread_frame_pointers;
     handle_error_code(message(), code, remote, getStackFramePointers());
 }
 
 Exception::Exception(CreateFromPocoTag, const Poco::Exception & exc)
     : Poco::Exception(exc.displayText(), ErrorCodes::POCO_EXCEPTION)
 {
+    capture_thread_frame_pointers = thread_frame_pointers;
 #ifdef STD_EXCEPTION_HAS_STACK_TRACE
     auto * stack_trace_frames = exc.get_stack_trace_frames();
     auto stack_trace_size = exc.get_stack_trace_size();
@@ -107,6 +111,7 @@ Exception::Exception(CreateFromPocoTag, const Poco::Exception & exc)
 Exception::Exception(CreateFromSTDTag, const std::exception & exc)
     : Poco::Exception(demangle(typeid(exc).name()) + ": " + String(exc.what()), ErrorCodes::STD_EXCEPTION)
 {
+    capture_thread_frame_pointers = thread_frame_pointers;
 #ifdef STD_EXCEPTION_HAS_STACK_TRACE
     auto * stack_trace_frames = exc.get_stack_trace_frames();
     auto stack_trace_size = exc.get_stack_trace_size();
@@ -153,7 +158,17 @@ std::string Exception::getStackTraceString() const
     auto * stack_trace_frames = get_stack_trace_frames();
     auto stack_trace_size = get_stack_trace_size();
     __msan_unpoison(stack_trace_frames, stack_trace_size * sizeof(stack_trace_frames[0]));
-    return StackTrace::toString(stack_trace_frames, 0, stack_trace_size);
+    String thread_stack_trace;
+    std::for_each(capture_thread_frame_pointers.rbegin(), capture_thread_frame_pointers.rend(),
+        [&thread_stack_trace](StackTrace::FramePointers & frame_pointers)
+        {
+            thread_stack_trace +=
+                "\nJob's origin stack trace:\n" +
+                StackTrace::toString(&frame_pointers[0], 0, std::ranges::find(frame_pointers, nullptr) - frame_pointers.begin());
+        }
+    );
+
+    return StackTrace::toString(stack_trace_frames, 0, stack_trace_size) + thread_stack_trace;
 #else
     return trace.toString();
 #endif
@@ -185,6 +200,8 @@ Exception::FramePointers Exception::getStackFramePointers() const
     return frame_pointers;
 }
 
+thread_local std::vector<StackTrace::FramePointers> Exception::thread_frame_pointers = {};
+
 
 void throwFromErrno(const std::string & s, int code, int the_errno)
 {
diff --git a/src/Common/Exception.h b/src/Common/Exception.h
index 170e0d32b3c..c1bbeada506 100644
--- a/src/Common/Exception.h
+++ b/src/Common/Exception.h
@@ -25,18 +25,25 @@ class Exception : public Poco::Exception
 public:
     using FramePointers = std::vector<void *>;
 
-    Exception() = default;
+    Exception()
+    {
+        capture_thread_frame_pointers = thread_frame_pointers;
+    }
 
     Exception(const PreformattedMessage & msg, int code): Exception(msg.text, code)
     {
+        capture_thread_frame_pointers = thread_frame_pointers;
         message_format_string = msg.format_string;
     }
 
     Exception(PreformattedMessage && msg, int code): Exception(std::move(msg.text), code)
     {
+        capture_thread_frame_pointers = thread_frame_pointers;
         message_format_string = msg.format_string;
     }
 
+    static thread_local std::vector<StackTrace::FramePointers> thread_frame_pointers;
+
 protected:
     // used to remove the sensitive information from exceptions if query_masking_rules is configured
     struct MessageMasked
@@ -66,6 +73,7 @@ public:
     Exception(int code, T && message)
         : Exception(message, code)
     {
+        capture_thread_frame_pointers = thread_frame_pointers;
         message_format_string = tryGetStaticFormatString(message);
     }
 
@@ -80,6 +88,7 @@ public:
     Exception(int code, FormatStringHelper<Args...> fmt, Args &&... args)
         : Exception(fmt::format(fmt.fmt_str, std::forward<Args>(args)...), code)
     {
+        capture_thread_frame_pointers = thread_frame_pointers;
         message_format_string = fmt.message_format_string;
     }
 
@@ -131,6 +140,7 @@ private:
 
 protected:
     std::string_view message_format_string;
+    mutable std::vector<StackTrace::FramePointers> capture_thread_frame_pointers;
 };
 
 
diff --git a/src/Common/ThreadPool.cpp b/src/Common/ThreadPool.cpp
index f91849ead66..0bd4fcb0455 100644
--- a/src/Common/ThreadPool.cpp
+++ b/src/Common/ThreadPool.cpp
@@ -189,7 +189,9 @@ ReturnType ThreadPoolImpl<Thread>::scheduleImpl(Job job, Priority priority, std:
         jobs.emplace(std::move(job),
                      priority,
                      /// Tracing context on this thread is used as parent context for the sub-thread that runs the job
-                     propagate_opentelemetry_tracing_context ? DB::OpenTelemetry::CurrentContext() : DB::OpenTelemetry::TracingContextOnThread());
+                     propagate_opentelemetry_tracing_context ? DB::OpenTelemetry::CurrentContext() : DB::OpenTelemetry::TracingContextOnThread(),
+                     /// capture_frame_pointers
+                     true);
 
         ++scheduled_jobs;
     }
@@ -348,6 +350,8 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
         /// A copy of parent trace context
         DB::OpenTelemetry::TracingContextOnThread parent_thread_trace_context;
 
+        std::vector<StackTrace::FramePointers> thread_frame_pointers;
+
         /// Get a job from the queue.
         Job job;
 
@@ -393,6 +397,7 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
             /// to prevent us from modifying its priority. We have to use const_cast to force move semantics on JobWithPriority::job.
             job = std::move(const_cast<Job &>(jobs.top().job));
             parent_thread_trace_context = std::move(const_cast<DB::OpenTelemetry::TracingContextOnThread &>(jobs.top().thread_trace_context));
+            thread_frame_pointers = std::move(const_cast<std::vector<StackTrace::FramePointers> &>(jobs.top().frame_pointers));
             jobs.pop();
 
             /// We don't run jobs after `shutdown` is set, but we have to properly dequeue all jobs and finish them.
@@ -411,6 +416,8 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
         /// Run the job.
         try
         {
+            DB::Exception::thread_frame_pointers = std::move(thread_frame_pointers);
+
             CurrentMetrics::Increment metric_active_pool_threads(metric_active_threads);
 
             job();
diff --git a/src/Common/ThreadPool.h b/src/Common/ThreadPool.h
index 70053ff7558..17731de9540 100644
--- a/src/Common/ThreadPool.h
+++ b/src/Common/ThreadPool.h
@@ -19,6 +19,8 @@
 #include <Common/CurrentMetrics.h>
 #include <Common/ThreadPool_fwd.h>
 #include <Common/Priority.h>
+#include <Common/StackTrace.h>
+#include <Common/Exception.h>
 #include <base/scope_guard.h>
 
 /** Very simple thread pool similar to boost::threadpool.
@@ -127,8 +129,16 @@ private:
         Priority priority;
         DB::OpenTelemetry::TracingContextOnThread thread_trace_context;
 
-        JobWithPriority(Job job_, Priority priority_, const DB::OpenTelemetry::TracingContextOnThread & thread_trace_context_)
-            : job(job_), priority(priority_), thread_trace_context(thread_trace_context_) {}
+        std::vector<StackTrace::FramePointers> frame_pointers;
+
+        JobWithPriority(Job job_, Priority priority_, const DB::OpenTelemetry::TracingContextOnThread & thread_trace_context_, bool capture_frame_pointers = false)
+            : job(job_), priority(priority_), thread_trace_context(thread_trace_context_)
+        {
+            if (!capture_frame_pointers)
+                return;
+            frame_pointers = DB::Exception::thread_frame_pointers;
+            frame_pointers.push_back(StackTrace().getFramePointers());
+        }
 
         bool operator<(const JobWithPriority & rhs) const
         {

From 786987a29a67bb8e26685b1856bf52a20c142ef1 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 05:17:43 +0200
Subject: [PATCH 1219/1478] Remove garbage from function `transform`

---
 base/base/bit_cast.h        |   6 ++
 src/Functions/transform.cpp | 161 +++++++++++++++++-------------------
 2 files changed, 81 insertions(+), 86 deletions(-)

diff --git a/base/base/bit_cast.h b/base/base/bit_cast.h
index 5373ead36e8..4783a84586b 100644
--- a/base/base/bit_cast.h
+++ b/base/base/bit_cast.h
@@ -7,7 +7,13 @@
 
 /** Returns value `from` converted to type `To` while retaining bit representation.
   * `To` and `From` must satisfy `CopyConstructible`.
+  *
   * In contrast to std::bit_cast can cast types of different width.
+  *
+  * Note: for signed types of narrower size, the casted result is zero-extended
+  * instead of sign-extended as with regular static_cast.
+  * For example, -1 Int8 (represented as 0xFF) bit_casted to UInt64
+  * gives 255 (represented as 0x00000000000000FF) instead of 0xFFFFFFFFFFFFFFFF
   */
 template <typename To, typename From>
 std::decay_t<To> bit_cast(const From & from)
diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index 9970012ef4a..d8b6416e429 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -5,6 +5,7 @@
 #include <Columns/ColumnConst.h>
 #include <Columns/ColumnDecimal.h>
 #include <Columns/ColumnString.h>
+#include <Columns/ColumnNullable.h>
 #include <Core/DecimalFunctions.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/getLeastSupertype.h>
@@ -16,6 +17,8 @@
 #include <Common/Arena.h>
 #include <Common/HashTable/HashMap.h>
 #include <Common/typeid_cast.h>
+#include <Common/FieldVisitorToString.h>
+
 
 namespace DB
 {
@@ -29,28 +32,26 @@ namespace ErrorCodes
 
 namespace
 {
-    /** transform(x, from_array, to_array[, default]) - convert x according to an explicitly passed match.
-  */
     /** transform(x, [from...], [to...], default)
-  * - converts the values according to the explicitly specified mapping.
-  *
-  * x - what to transform.
-  * from - a constant array of values for the transformation.
-  * to - a constant array of values into which values from `from` must be transformed.
-  * default - what value to use if x is not equal to any of the values in `from`.
-  * `from` and `to` - arrays of the same size.
-  *
-  * Types:
-  * transform(T, Array(T), Array(U), U) -> U
-  *
-  * transform(x, [from...], [to...])
-  * - if `default` is not specified, then for values of `x` for which there is no corresponding element in `from`, the unchanged value of `x` is returned.
-  *
-  * Types:
-  * transform(T, Array(T), Array(T)) -> T
-  *
-  * Note: the implementation is rather cumbersome.
-  */
+      * - converts the values according to the explicitly specified mapping.
+      *
+      * x - what to transform.
+      * from - a constant array of values for the transformation.
+      * to - a constant array of values into which values from `from` must be transformed.
+      * default - what value to use if x is not equal to any of the values in `from`.
+      * `from` and `to` - arrays of the same size.
+      *
+      * Types:
+      * transform(T, Array(T), Array(U), U) -> U
+      *
+      * transform(x, [from...], [to...])
+      * - if `default` is not specified, then for values of `x` for which there is no corresponding element in `from`, the unchanged value of `x` is returned.
+      *
+      * Types:
+      * transform(T, Array(T), Array(T)) -> T
+      *
+      * Note: the implementation is rather cumbersome.
+      */
     class FunctionTransform : public IFunction
     {
     public:
@@ -236,7 +237,7 @@ namespace
                 {
                     const auto * it = table.find(bit_cast<UInt64>(pod[i]));
                     if (it)
-                        column_result.insertFrom(*cache.to_columns, it->getMapped());
+                        column_result.insertFrom(*cache.to_column, it->getMapped());
                     else if (cache.default_column)
                         column_result.insertFrom(*cache.default_column, 0);
                     else if (default_non_const)
@@ -259,7 +260,7 @@ namespace
             out_offs.resize(size);
             auto & out_chars = out->getChars();
 
-            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_columns.get());
+            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_column.get());
             const auto & to_chars = to_col->getChars();
             const auto & to_offs = to_col->getOffsets();
             const auto & table = *cache.table_num_to_idx;
@@ -340,7 +341,7 @@ namespace
             if constexpr (std::is_same_v<ColumnDecimal<Decimal32>, T> || std::is_same_v<ColumnDecimal<Decimal64>, T>)
                 out_scale = out->getScale();
 
-            const auto & to_pod = reinterpret_cast<const T *>(cache.to_columns.get())->getData();
+            const auto & to_pod = reinterpret_cast<const T *>(cache.to_column.get())->getData();
             const auto & table = *cache.table_num_to_idx;
             if (cache.default_column)
             {
@@ -427,7 +428,7 @@ namespace
                     current_offset = offsets[i];
                     const auto * it = table.find(ref);
                     if (it)
-                        column_result.insertFrom(*cache.to_columns, it->getMapped());
+                        column_result.insertFrom(*cache.to_column, it->getMapped());
                     else if (cache.default_column)
                         column_result.insertFrom(*cache.default_column, 0);
                     else if (default_non_const)
@@ -453,7 +454,7 @@ namespace
             out_offs.resize(size);
             auto & out_chars = out->getChars();
 
-            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_columns.get());
+            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_column.get());
             const auto & to_chars = to_col->getChars();
             const auto & to_offs = to_col->getOffsets();
 
@@ -542,7 +543,7 @@ namespace
             const size_t size = offsets.size();
             out_pod.resize(size);
 
-            const auto & to_pod = reinterpret_cast<const T *>(cache.to_columns.get())->getData();
+            const auto & to_pod = reinterpret_cast<const T *>(cache.to_column.get())->getData();
             const auto & table = *cache.table_string_to_idx;
             if (cache.default_column)
             {
@@ -597,11 +598,10 @@ namespace
             std::unique_ptr<NumToIdx> table_num_to_idx;
             std::unique_ptr<StringToIdx> table_string_to_idx;
 
-            ColumnPtr to_columns;
+            ColumnPtr from_column;
+            ColumnPtr to_column;
             ColumnPtr default_column;
 
-            Arena string_pool;
-
             std::atomic<bool> initialized{false};
             std::mutex mutex;
         };
@@ -609,27 +609,6 @@ namespace
         mutable Cache cache;
 
 
-        static UInt64 bitCastToUInt64(const Field & x)
-        {
-            switch (x.getType())
-            {
-                case Field::Types::UInt64:
-                    return x.get<UInt64>();
-                case Field::Types::Int64:
-                    return x.get<Int64>();
-                case Field::Types::Float64:
-                    return std::bit_cast<UInt64>(x.get<Float64>());
-                case Field::Types::Bool:
-                    return x.get<bool>();
-                case Field::Types::Decimal32:
-                    return x.get<DecimalField<Decimal32>>().getValue();
-                case Field::Types::Decimal64:
-                    return x.get<DecimalField<Decimal64>>().getValue();
-                default:
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unexpected type in function 'transform'");
-            }
-        }
-
         static void checkAllowedType(const DataTypePtr & type)
         {
             if (type->isNullable())
@@ -656,33 +635,49 @@ namespace
         /// Can be called from different threads. It works only on the first call.
         void initialize(const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type) const
         {
-            const ColumnConst * array_from = checkAndGetColumnConst<ColumnArray>(arguments[1].column.get());
-            const ColumnConst * array_to = checkAndGetColumnConst<ColumnArray>(arguments[2].column.get());
+            if (cache.initialized)
+                return;
+
+            const DataTypePtr & from_type = arguments[0].type;
+
+            const ColumnArray * array_from = checkAndGetColumnConstData<ColumnArray>(arguments[1].column.get());
+            const ColumnArray * array_to = checkAndGetColumnConstData<ColumnArray>(arguments[2].column.get());
 
             if (!array_from || !array_to)
                 throw Exception(
                     ErrorCodes::ILLEGAL_COLUMN, "Second and third arguments of function {} must be constant arrays.", getName());
 
-            if (cache.initialized)
-                return;
+            std::lock_guard lock(cache.mutex);
 
-            const auto & from = array_from->getValue<Array>();
-            const size_t size = from.size();
+            ColumnPtr from_column_or_null_ptr = castColumnAccurateOrNull(
+                {
+                    array_from->getDataPtr(),
+                    typeid_cast<const DataTypeArray &>(*arguments[1].type).getNestedType(),
+                    arguments[1].name
+                },
+                from_type);
+
+            const ColumnNullable & from_column_or_null = assert_cast<const ColumnNullable &>(*from_column_or_null_ptr);
+
+            cache.from_column = from_column_or_null.getNestedColumnPtr();
+
+            cache.to_column = castColumn(
+                {
+                    array_to->getDataPtr(),
+                    typeid_cast<const DataTypeArray &>(*arguments[2].type).getNestedType(),
+                    arguments[2].name
+                },
+                result_type);
+
+            const size_t size = cache.from_column->size();
             if (0 == size)
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Empty arrays are illegal in function {}", getName());
 
-            std::lock_guard lock(cache.mutex);
-
-            if (cache.initialized)
-                return;
-
-            const auto & to = array_to->getValue<Array>();
-            if (size != to.size())
+            if (cache.to_column->size() != size)
                 throw Exception(
                     ErrorCodes::BAD_ARGUMENTS, "Second and third arguments of function {} must be arrays of same size", getName());
 
             /// Whether the default value is set.
-
             if (arguments.size() == 4)
             {
                 const IColumn * default_col = arguments[3].column.get();
@@ -702,20 +697,20 @@ namespace
 
             /// Note: Doesn't check the duplicates in the `from` array.
 
-            const IDataType & from_type = *arguments[0].type;
-
-            if (from[0].getType() != Field::Types::String)
+            if (isNativeInteger(from_type))
             {
                 cache.table_num_to_idx = std::make_unique<Cache::NumToIdx>();
                 auto & table = *cache.table_num_to_idx;
                 for (size_t i = 0; i < size; ++i)
                 {
-                    Field key = convertFieldToType(from[i], from_type);
-                    if (key.isNull())
-                        continue;
-
-                    /// Field may be of Float type, but for the purpose of bitwise equality we can treat them as UInt64
-                    table[bitCastToUInt64(key)] = i;
+                    if (!from_column_or_null.isNullAt(i))
+                    {
+                        /// Field may be of Float type, but for the purpose of bitwise equality we can treat them as UInt64
+                        StringRef ref = cache.from_column->getDataAt(i);
+                        UInt64 key = 0;
+                        memcpy(&key, ref.data, ref.size);
+                        table[key] = i;
+                    }
                 }
             }
             else
@@ -724,23 +719,17 @@ namespace
                 auto & table = *cache.table_string_to_idx;
                 for (size_t i = 0; i < size; ++i)
                 {
-                    const String & str_from = from[i].get<const String &>();
-                    StringRef ref{cache.string_pool.insert(str_from.data(), str_from.size() + 1), str_from.size() + 1};
-                    table[ref] = i;
+                    if (!from_column_or_null.isNullAt(i))
+                    {
+                        StringRef ref = cache.from_column->getDataAt(i);
+                        table[ref] = i;
+                    }
                 }
             }
 
-            auto to_columns = result_type->createColumn();
-            for (size_t i = 0; i < size; ++i)
-            {
-                Field to_value = convertFieldToType(to[i], *result_type);
-                to_columns->insert(to_value);
-            }
-            cache.to_columns = std::move(to_columns);
-
             cache.initialized = true;
         }
-};
+    };
 
 }
 

From 396eb704269b7d67cfbf654d8b111d826292ddc2 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 05:48:08 +0200
Subject: [PATCH 1220/1478] Remove garbage from function `transform`

---
 src/Functions/transform.cpp                   | 39 ++++++++++---------
 .../02797_transform_narrow_types.reference    |  6 +++
 .../02797_transform_narrow_types.sql          |  6 +++
 3 files changed, 32 insertions(+), 19 deletions(-)
 create mode 100644 tests/queries/0_stateless/02797_transform_narrow_types.reference
 create mode 100644 tests/queries/0_stateless/02797_transform_narrow_types.sql

diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index d8b6416e429..3e4ca412491 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -14,10 +14,8 @@
 #include <Functions/IFunction.h>
 #include <Interpreters/castColumn.h>
 #include <Interpreters/convertFieldToType.h>
-#include <Common/Arena.h>
 #include <Common/HashTable/HashMap.h>
 #include <Common/typeid_cast.h>
-#include <Common/FieldVisitorToString.h>
 
 
 namespace DB
@@ -28,6 +26,7 @@ namespace ErrorCodes
     extern const int BAD_ARGUMENTS;
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
     extern const int ILLEGAL_COLUMN;
+    extern const int LOGICAL_ERROR;
 }
 
 namespace
@@ -260,14 +259,14 @@ namespace
             out_offs.resize(size);
             auto & out_chars = out->getChars();
 
-            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_column.get());
+            const auto * to_col = assert_cast<const ColumnString *>(cache.to_column.get());
             const auto & to_chars = to_col->getChars();
             const auto & to_offs = to_col->getOffsets();
             const auto & table = *cache.table_num_to_idx;
 
             if (cache.default_column)
             {
-                const auto * def = reinterpret_cast<const ColumnString *>(cache.default_column.get());
+                const auto * def = assert_cast<const ColumnString *>(cache.default_column.get());
                 const auto & def_chars = def->getChars();
                 const auto & def_offs = def->getOffsets();
                 const auto * def_data = def_chars.data();
@@ -276,7 +275,7 @@ namespace
             }
             else
             {
-                const auto * def = reinterpret_cast<const ColumnString *>(default_non_const.get());
+                const auto * def = assert_cast<const ColumnString *>(default_non_const.get());
                 const auto & def_chars = def->getChars();
                 const auto & def_offs = def->getOffsets();
                 executeNumToStringHelper(table, pod, out_chars, out_offs, to_chars, to_offs, def_chars, def_offs, size);
@@ -341,16 +340,16 @@ namespace
             if constexpr (std::is_same_v<ColumnDecimal<Decimal32>, T> || std::is_same_v<ColumnDecimal<Decimal64>, T>)
                 out_scale = out->getScale();
 
-            const auto & to_pod = reinterpret_cast<const T *>(cache.to_column.get())->getData();
+            const auto & to_pod = assert_cast<const T *>(cache.to_column.get())->getData();
             const auto & table = *cache.table_num_to_idx;
             if (cache.default_column)
             {
-                const auto const_def = reinterpret_cast<const T *>(cache.default_column.get())->getData()[0];
+                const auto const_def = assert_cast<const T *>(cache.default_column.get())->getData()[0];
                 executeNumToNumHelper(table, pod, out_pod, to_pod, const_def, size, out_scale, out_scale);
             }
             else if (default_non_const)
             {
-                const auto & nconst_def = reinterpret_cast<const T *>(default_non_const.get())->getData();
+                const auto & nconst_def = assert_cast<const T *>(default_non_const.get())->getData();
                 executeNumToNumHelper(table, pod, out_pod, to_pod, nconst_def, size, out_scale, out_scale);
             }
             else
@@ -424,7 +423,7 @@ namespace
                 ColumnString::Offset current_offset = 0;
                 for (size_t i = 0; i < size; ++i)
                 {
-                    const StringRef ref{&data[current_offset], offsets[i] - current_offset};
+                    const StringRef ref{&data[current_offset], offsets[i] - current_offset - 1};
                     current_offset = offsets[i];
                     const auto * it = table.find(ref);
                     if (it)
@@ -454,14 +453,14 @@ namespace
             out_offs.resize(size);
             auto & out_chars = out->getChars();
 
-            const auto * to_col = reinterpret_cast<const ColumnString *>(cache.to_column.get());
+            const auto * to_col = assert_cast<const ColumnString *>(cache.to_column.get());
             const auto & to_chars = to_col->getChars();
             const auto & to_offs = to_col->getOffsets();
 
             const auto & table = *cache.table_string_to_idx;
             if (cache.default_column)
             {
-                const auto * def = reinterpret_cast<const ColumnString *>(cache.default_column.get());
+                const auto * def = assert_cast<const ColumnString *>(cache.default_column.get());
                 const auto & def_chars = def->getChars();
                 const auto & def_offs = def->getOffsets();
                 const auto * def_data = def_chars.data();
@@ -470,7 +469,7 @@ namespace
             }
             else if (default_non_const)
             {
-                const auto * def = reinterpret_cast<const ColumnString *>(default_non_const.get());
+                const auto * def = assert_cast<const ColumnString *>(default_non_const.get());
                 const auto & def_chars = def->getChars();
                 const auto & def_offs = def->getOffsets();
                 executeStringToStringHelper(table, data, offsets, out_chars, out_offs, to_chars, to_offs, def_chars, def_offs, size);
@@ -501,7 +500,7 @@ namespace
             {
                 const char8_t * to = nullptr;
                 size_t to_size = 0;
-                const StringRef ref{&data[current_offset], offsets[i] - current_offset};
+                const StringRef ref{&data[current_offset], offsets[i] - current_offset - 1};
                 current_offset = offsets[i];
                 const auto * it = table.find(ref);
                 if (it)
@@ -543,16 +542,16 @@ namespace
             const size_t size = offsets.size();
             out_pod.resize(size);
 
-            const auto & to_pod = reinterpret_cast<const T *>(cache.to_column.get())->getData();
+            const auto & to_pod = assert_cast<const T *>(cache.to_column.get())->getData();
             const auto & table = *cache.table_string_to_idx;
             if (cache.default_column)
             {
-                const auto const_def = reinterpret_cast<const T *>(cache.default_column.get())->getData()[0];
+                const auto const_def = assert_cast<const T *>(cache.default_column.get())->getData()[0];
                 executeStringToNumHelper(table, data, offsets, out_pod, to_pod, const_def, size);
             }
             else
             {
-                const auto & nconst_def = reinterpret_cast<const T *>(default_non_const.get())->getData();
+                const auto & nconst_def = assert_cast<const T *>(default_non_const.get())->getData();
                 executeStringToNumHelper(table, data, offsets, out_pod, to_pod, nconst_def, size);
             }
             return true;
@@ -571,7 +570,7 @@ namespace
             ColumnString::Offset current_offset = 0;
             for (size_t i = 0; i < size; ++i)
             {
-                const StringRef ref{&data[current_offset], offsets[i] - current_offset};
+                const StringRef ref{&data[current_offset], offsets[i] - current_offset - 1};
                 current_offset = offsets[i];
                 const auto * it = table.find(ref);
                 if (it)
@@ -697,7 +696,7 @@ namespace
 
             /// Note: Doesn't check the duplicates in the `from` array.
 
-            if (isNativeInteger(from_type))
+            if (from_type->isValueRepresentedByNumber())
             {
                 cache.table_num_to_idx = std::make_unique<Cache::NumToIdx>();
                 auto & table = *cache.table_num_to_idx;
@@ -713,7 +712,7 @@ namespace
                     }
                 }
             }
-            else
+            else if (from_type->isValueUnambiguouslyRepresentedInContiguousMemoryRegion())
             {
                 cache.table_string_to_idx = std::make_unique<Cache::StringToIdx>();
                 auto & table = *cache.table_string_to_idx;
@@ -726,6 +725,8 @@ namespace
                     }
                 }
             }
+            else
+                throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected data type {} as the first argument in function `transform`", from_type->getName());
 
             cache.initialized = true;
         }
diff --git a/tests/queries/0_stateless/02797_transform_narrow_types.reference b/tests/queries/0_stateless/02797_transform_narrow_types.reference
new file mode 100644
index 00000000000..5a2bd60ca83
--- /dev/null
+++ b/tests/queries/0_stateless/02797_transform_narrow_types.reference
@@ -0,0 +1,6 @@
+f
+s
+11
+11
+33
+3
diff --git a/tests/queries/0_stateless/02797_transform_narrow_types.sql b/tests/queries/0_stateless/02797_transform_narrow_types.sql
new file mode 100644
index 00000000000..56a02fb8af7
--- /dev/null
+++ b/tests/queries/0_stateless/02797_transform_narrow_types.sql
@@ -0,0 +1,6 @@
+SELECT transform(-1, [-1, 2], ['f', 's'], 'g');
+SELECT transform(2, [-1, 2], ['f', 's'], 'g');
+SELECT transform(-1, [-1, 2], [11, 22], 33);
+SELECT transform(-1, [-1, 2], [11, 22]);
+SELECT transform(3, [-1, 2], [11, 22], 33);
+SELECT transform(3, [-1, 2], [11, 22]);

From cb2d3954103fbc2d1230a3122488602de56a4313 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 06:52:28 +0200
Subject: [PATCH 1221/1478] Add generic implementation of function `transform`

---
 src/Functions/transform.cpp                   | 137 +++++++++++++-----
 .../02798_generic_transform.reference         |  38 +++++
 .../0_stateless/02798_generic_transform.sql   |  12 ++
 3 files changed, 148 insertions(+), 39 deletions(-)
 create mode 100644 tests/queries/0_stateless/02798_generic_transform.reference
 create mode 100644 tests/queries/0_stateless/02798_generic_transform.sql

diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index 3e4ca412491..e2eab1d02fc 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -16,6 +16,7 @@
 #include <Interpreters/convertFieldToType.h>
 #include <Common/HashTable/HashMap.h>
 #include <Common/typeid_cast.h>
+#include <Common/FieldVisitorsAccurateComparison.h>
 
 
 namespace DB
@@ -79,15 +80,6 @@ namespace
                     args_size);
 
             const DataTypePtr & type_x = arguments[0];
-            const auto & type_x_nn = removeNullable(type_x);
-
-            if (!type_x_nn->isValueRepresentedByNumber() && !isString(type_x_nn) && !isNothing(type_x_nn))
-                throw Exception(
-                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
-                    "Unsupported type {} of first argument "
-                    "of function {}, must be numeric type or Date/DateTime or String",
-                    type_x->getName(),
-                    getName());
 
             const DataTypeArray * type_arr_from = checkAndGetDataType<DataTypeArray>(arguments[1].get());
 
@@ -99,14 +91,13 @@ namespace
 
             const auto type_arr_from_nested = type_arr_from->getNestedType();
 
-            if ((type_x->isValueRepresentedByNumber() != type_arr_from_nested->isValueRepresentedByNumber())
-                || (isString(type_x) != isString(type_arr_from_nested)))
+            auto src = tryGetLeastSupertype(DataTypes{type_x, type_arr_from_nested});
+            if (!src)
             {
                 throw Exception(
                     ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
                     "First argument and elements of array "
-                    "of second argument of function {} must have compatible types: "
-                    "both numeric or both strings.",
+                    "of the second argument of function {} must have compatible types",
                     getName());
             }
 
@@ -157,8 +148,8 @@ namespace
             }
         }
 
-        ColumnPtr
-        executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type, size_t input_rows_count) const override
+        ColumnPtr executeImpl(
+            const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type, size_t input_rows_count) const override
         {
             initialize(arguments, result_type);
 
@@ -172,22 +163,36 @@ namespace
                 default_non_const = castColumn(arguments[3], result_type);
 
             auto column_result = result_type->createColumn();
-            if (!executeNum<ColumnVector<UInt8>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<UInt16>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<UInt32>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<UInt64>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Int8>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Int16>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Int32>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Int64>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Float32>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnVector<Float64>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnDecimal<Decimal32>>(in, *column_result, default_non_const)
-                && !executeNum<ColumnDecimal<Decimal64>>(in, *column_result, default_non_const)
-                && !executeString(in, *column_result, default_non_const))
+            if (cache.table_num_to_idx)
             {
-                throw Exception(ErrorCodes::ILLEGAL_COLUMN, "Illegal column {} of first argument of function {}", in->getName(), getName());
+                if (!executeNum<ColumnVector<UInt8>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<UInt16>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<UInt32>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<UInt64>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Int8>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Int16>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Int32>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Int64>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Float32>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnVector<Float64>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnDecimal<Decimal32>>(in, *column_result, default_non_const)
+                    && !executeNum<ColumnDecimal<Decimal64>>(in, *column_result, default_non_const))
+                {
+                    throw Exception(ErrorCodes::ILLEGAL_COLUMN, "Illegal column {} of first argument of function {}", in->getName(), getName());
+                }
             }
+            else if (cache.table_string_to_idx)
+            {
+                if (!executeString(in, *column_result, default_non_const))
+                    executeContiguous(in, *column_result, default_non_const);
+            }
+            else if (cache.table_anything_to_idx)
+            {
+                executeAnything(in, *column_result, default_non_const);
+            }
+            else
+                throw Exception(ErrorCodes::LOGICAL_ERROR, "State of the function `transform` is not initialized");
+
             return column_result;
         }
 
@@ -204,6 +209,47 @@ namespace
             return impl->execute(args, result_type, input_rows_count);
         }
 
+        void executeAnything(const IColumn * in, IColumn & column_result, const ColumnPtr default_non_const) const
+        {
+            const size_t size = in->size();
+            const auto & table = *cache.table_anything_to_idx;
+            column_result.reserve(size);
+            for (size_t i = 0; i < size; ++i)
+            {
+                SipHash hash;
+                in->updateHashWithValue(i, hash);
+
+                const auto * it = table.find(hash.get128());
+                if (it)
+                    column_result.insertFrom(*cache.to_column, it->getMapped());
+                else if (cache.default_column)
+                    column_result.insertFrom(*cache.default_column, 0);
+                else if (default_non_const)
+                    column_result.insertFrom(*default_non_const, i);
+                else
+                    column_result.insertFrom(*in, i);
+            }
+        }
+
+        void executeContiguous(const IColumn * in, IColumn & column_result, const ColumnPtr default_non_const) const
+        {
+            const size_t size = in->size();
+            const auto & table = *cache.table_string_to_idx;
+            column_result.reserve(size);
+            for (size_t i = 0; i < size; ++i)
+            {
+                const auto * it = table.find(in->getDataAt(i));
+                if (it)
+                    column_result.insertFrom(*cache.to_column, it->getMapped());
+                else if (cache.default_column)
+                    column_result.insertFrom(*cache.default_column, 0);
+                else if (default_non_const)
+                    column_result.insertFrom(*default_non_const, i);
+                else
+                    column_result.insertFrom(*in, i);
+            }
+        }
+
         template <typename T>
         bool executeNum(const IColumn * in_untyped, IColumn & column_result, const ColumnPtr default_non_const) const
         {
@@ -593,9 +639,11 @@ namespace
         {
             using NumToIdx = HashMap<UInt64, size_t, HashCRC32<UInt64>>;
             using StringToIdx = HashMap<StringRef, size_t, StringRefHash>;
+            using AnythingToIdx = HashMap<UInt128, size_t>;
 
             std::unique_ptr<NumToIdx> table_num_to_idx;
             std::unique_ptr<StringToIdx> table_string_to_idx;
+            std::unique_ptr<AnythingToIdx> table_anything_to_idx;
 
             ColumnPtr from_column;
             ColumnPtr to_column;
@@ -648,18 +696,16 @@ namespace
 
             std::lock_guard lock(cache.mutex);
 
-            ColumnPtr from_column_or_null_ptr = castColumnAccurateOrNull(
+            const ColumnPtr & from_column_uncasted = array_from->getDataPtr();
+
+            cache.from_column = castColumn(
                 {
-                    array_from->getDataPtr(),
+                    from_column_uncasted,
                     typeid_cast<const DataTypeArray &>(*arguments[1].type).getNestedType(),
                     arguments[1].name
                 },
                 from_type);
 
-            const ColumnNullable & from_column_or_null = assert_cast<const ColumnNullable &>(*from_column_or_null_ptr);
-
-            cache.from_column = from_column_or_null.getNestedColumnPtr();
-
             cache.to_column = castColumn(
                 {
                     array_to->getDataPtr(),
@@ -696,13 +742,14 @@ namespace
 
             /// Note: Doesn't check the duplicates in the `from` array.
 
-            if (from_type->isValueRepresentedByNumber())
+            WhichDataType which(from_type);
+            if (isNativeNumber(which) || which.isDecimal32() || which.isDecimal64())
             {
                 cache.table_num_to_idx = std::make_unique<Cache::NumToIdx>();
                 auto & table = *cache.table_num_to_idx;
                 for (size_t i = 0; i < size; ++i)
                 {
-                    if (!from_column_or_null.isNullAt(i))
+                    if (applyVisitor(FieldVisitorAccurateEquals(), (*cache.from_column)[i], (*from_column_uncasted)[i]))
                     {
                         /// Field may be of Float type, but for the purpose of bitwise equality we can treat them as UInt64
                         StringRef ref = cache.from_column->getDataAt(i);
@@ -718,7 +765,7 @@ namespace
                 auto & table = *cache.table_string_to_idx;
                 for (size_t i = 0; i < size; ++i)
                 {
-                    if (!from_column_or_null.isNullAt(i))
+                    if (applyVisitor(FieldVisitorAccurateEquals(), (*cache.from_column)[i], (*from_column_uncasted)[i]))
                     {
                         StringRef ref = cache.from_column->getDataAt(i);
                         table[ref] = i;
@@ -726,7 +773,19 @@ namespace
                 }
             }
             else
-                throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected data type {} as the first argument in function `transform`", from_type->getName());
+            {
+                cache.table_anything_to_idx = std::make_unique<Cache::AnythingToIdx>();
+                auto & table = *cache.table_anything_to_idx;
+                for (size_t i = 0; i < size; ++i)
+                {
+                    if (applyVisitor(FieldVisitorAccurateEquals(), (*cache.from_column)[i], (*from_column_uncasted)[i]))
+                    {
+                        SipHash hash;
+                        cache.from_column->updateHashWithValue(i, hash);
+                        table[hash.get128()] = i;
+                    }
+                }
+            }
 
             cache.initialized = true;
         }
diff --git a/tests/queries/0_stateless/02798_generic_transform.reference b/tests/queries/0_stateless/02798_generic_transform.reference
new file mode 100644
index 00000000000..2140c3218b3
--- /dev/null
+++ b/tests/queries/0_stateless/02798_generic_transform.reference
@@ -0,0 +1,38 @@
+def
+def
+def
+hello
+def
+world
+def
+abc!
+def
+def
+
+
+
+hello
+
+world
+
+abc
+
+
+
+
+
+hello
+
+world
+
+abc
+
+
+123
+2023-03-03 00:00:00.000
+2023-02-02 00:00:00.000
+2023-01-01 00:00:00.000
+1	1
+42	42
+42
+42
diff --git a/tests/queries/0_stateless/02798_generic_transform.sql b/tests/queries/0_stateless/02798_generic_transform.sql
new file mode 100644
index 00000000000..6317d83fb29
--- /dev/null
+++ b/tests/queries/0_stateless/02798_generic_transform.sql
@@ -0,0 +1,12 @@
+SELECT transform((number, toString(number)), [(3, '3'), (5, '5'), (7, '7')], ['hello', 'world', 'abc!'], 'def') FROM system.numbers LIMIT 10;
+SELECT transform(toNullable(toInt256(number)), [3, 5, 7], ['hello', 'world', 'abc'], '') FROM system.numbers LIMIT 10;
+SELECT transform(toUInt256(number), [3, 5, 7], ['hello', 'world', 'abc'], '') FROM system.numbers LIMIT 10;
+
+select case 1::Nullable(Int32) when 1 then 123 else 0 end;
+
+SELECT transform(arrayJoin(['c', 'b', 'a']), ['a', 'b'], [toDateTime64('2023-01-01', 3), toDateTime64('2023-02-02', 3)], toDateTime64('2023-03-03', 3));
+
+SELECT transform(1, [1], [toDecimal32(1, 2)]), toDecimal32(1, 2);
+select transform(1, [1], [toDecimal32(42, 2)]), toDecimal32(42, 2);
+SELECT transform(1, [1], [toDecimal32(42, 2)], 0);
+SELECT transform(1, [1], [toDecimal32(42, 2)], toDecimal32(0, 2));

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 1222/1478] 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;
     }

From 3746e274b8fab462621adaf9d1d0b4902a3c7252 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 07:05:31 +0200
Subject: [PATCH 1223/1478] Support empty arrays

---
 src/Functions/transform.cpp                   | 15 ++++++++--
 .../02799_transform_empty_arrays.reference    | 30 +++++++++++++++++++
 .../02799_transform_empty_arrays.sql          |  3 ++
 3 files changed, 46 insertions(+), 2 deletions(-)
 create mode 100644 tests/queries/0_stateless/02799_transform_empty_arrays.reference
 create mode 100644 tests/queries/0_stateless/02799_transform_empty_arrays.sql

diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index e2eab1d02fc..a4667b1cea0 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -163,7 +163,13 @@ namespace
                 default_non_const = castColumn(arguments[3], result_type);
 
             auto column_result = result_type->createColumn();
-            if (cache.table_num_to_idx)
+            if (cache.is_empty)
+            {
+                return default_non_const
+                    ? default_non_const
+                    : castColumn(arguments[0], result_type);
+            }
+            else if (cache.table_num_to_idx)
             {
                 if (!executeNum<ColumnVector<UInt8>>(in, *column_result, default_non_const)
                     && !executeNum<ColumnVector<UInt16>>(in, *column_result, default_non_const)
@@ -645,6 +651,8 @@ namespace
             std::unique_ptr<StringToIdx> table_string_to_idx;
             std::unique_ptr<AnythingToIdx> table_anything_to_idx;
 
+            bool is_empty = false;
+
             ColumnPtr from_column;
             ColumnPtr to_column;
             ColumnPtr default_column;
@@ -716,7 +724,10 @@ namespace
 
             const size_t size = cache.from_column->size();
             if (0 == size)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Empty arrays are illegal in function {}", getName());
+            {
+                cache.is_empty = true;
+                return;
+            }
 
             if (cache.to_column->size() != size)
                 throw Exception(
diff --git a/tests/queries/0_stateless/02799_transform_empty_arrays.reference b/tests/queries/0_stateless/02799_transform_empty_arrays.reference
new file mode 100644
index 00000000000..fd44083947e
--- /dev/null
+++ b/tests/queries/0_stateless/02799_transform_empty_arrays.reference
@@ -0,0 +1,30 @@
+0
+1
+2
+3
+4
+5
+6
+7
+8
+9
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello
+Hello 0
+Hello 1
+Hello 2
+Hello 3
+Hello 4
+Hello 5
+Hello 6
+Hello 7
+Hello 8
+Hello 9
diff --git a/tests/queries/0_stateless/02799_transform_empty_arrays.sql b/tests/queries/0_stateless/02799_transform_empty_arrays.sql
new file mode 100644
index 00000000000..84e3e9d2930
--- /dev/null
+++ b/tests/queries/0_stateless/02799_transform_empty_arrays.sql
@@ -0,0 +1,3 @@
+SELECT transform(number, [], [1]) FROM numbers(10);
+SELECT transform(number, [], [], 'Hello') FROM numbers(10);
+SELECT transform(number, [], [], 'Hello ' || number::String) FROM numbers(10);

From f48c1605da9a3e06a6cca2bfa5cf63b6b518659e Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 07:08:44 +0200
Subject: [PATCH 1224/1478] Add a test

---
 .../02800_transform_alter.reference           |  6 +++
 .../0_stateless/02800_transform_alter.sql     | 43 +++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 tests/queries/0_stateless/02800_transform_alter.reference
 create mode 100644 tests/queries/0_stateless/02800_transform_alter.sql

diff --git a/tests/queries/0_stateless/02800_transform_alter.reference b/tests/queries/0_stateless/02800_transform_alter.reference
new file mode 100644
index 00000000000..cae8aeba20f
--- /dev/null
+++ b/tests/queries/0_stateless/02800_transform_alter.reference
@@ -0,0 +1,6 @@
+1	a1	a1
+2	a2	b2
+3	a3	b3
+1	a1
+2	b2
+3	b3
diff --git a/tests/queries/0_stateless/02800_transform_alter.sql b/tests/queries/0_stateless/02800_transform_alter.sql
new file mode 100644
index 00000000000..7458f51c5a4
--- /dev/null
+++ b/tests/queries/0_stateless/02800_transform_alter.sql
@@ -0,0 +1,43 @@
+DROP TABLE IF EXISTS test_xy;
+DROP TABLE IF EXISTS updates;
+
+CREATE TABLE test_xy
+(
+    `x` Int32,
+    `y` String
+)
+ENGINE = MergeTree
+ORDER BY x;
+
+CREATE TABLE updates
+(
+    `x` Int32,
+    `y` String
+)
+ENGINE = MergeTree
+ORDER BY x;
+
+INSERT INTO test_xy(x, y) VALUES (1, 'a1'), (2, 'a2'), (3, 'a3');
+INSERT INTO updates(x, y) VALUES  (2, 'b2'), (3, 'b3');
+
+SELECT x, y,
+    transform(x,
+        (select groupArray(x) from (select x, y from updates order by x) t1),
+        (select groupArray(y) from (select x, y from updates order by x) t2),
+        y)
+FROM test_xy
+WHERE 1 ORDER BY x, y;
+
+SET mutations_sync = 1;
+ALTER table test_xy
+    UPDATE
+    y =  transform(x,
+        (select groupArray(x) from (select x, y from updates order by x) t1),
+        (select groupArray(y) from (select x, y from updates order by x) t2),
+        y)
+    WHERE 1;
+
+SELECT * FROM test_xy ORDER BY x, y;
+
+DROP TABLE test_xy;
+DROP TABLE updates;

From ed3ead3493b936346cda744dbbb0a18f19964918 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 07:17:50 +0200
Subject: [PATCH 1225/1478] Add support for Nullable

---
 src/Functions/transform.cpp                   |  6 ++
 .../02801_transform_nullable.reference        | 65 +++++++++++++++++++
 .../0_stateless/02801_transform_nullable.sql  | 12 ++++
 3 files changed, 83 insertions(+)
 create mode 100644 tests/queries/0_stateless/02801_transform_nullable.reference
 create mode 100644 tests/queries/0_stateless/02801_transform_nullable.sql

diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index a4667b1cea0..db41c6fa081 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -695,6 +695,12 @@ namespace
 
             const DataTypePtr & from_type = arguments[0].type;
 
+            if (from_type->onlyNull())
+            {
+                cache.is_empty = true;
+                return;
+            }
+
             const ColumnArray * array_from = checkAndGetColumnConstData<ColumnArray>(arguments[1].column.get());
             const ColumnArray * array_to = checkAndGetColumnConstData<ColumnArray>(arguments[2].column.get());
 
diff --git a/tests/queries/0_stateless/02801_transform_nullable.reference b/tests/queries/0_stateless/02801_transform_nullable.reference
new file mode 100644
index 00000000000..b51587c094c
--- /dev/null
+++ b/tests/queries/0_stateless/02801_transform_nullable.reference
@@ -0,0 +1,65 @@
+1970-01-01 00:00:01.000
+1970-01-01 00:00:02.000
+1970-01-01 00:00:00.000
+\N
+\N
+\N
+hello
+\N
+world
+\N
+abc
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+\N
+-1
+-1
+-1
+111
+-1
+222
+-1
+\N
+-1
+-1
+-1.1
+-1.1
+-1.1
+\N
+-1.1
+222
+-1.1
+333
+-1.1
+-1.1
+1
+1
+1
+\N
+1
+\N
+1
+\N
+1
+1
+Остальные
+\N
diff --git a/tests/queries/0_stateless/02801_transform_nullable.sql b/tests/queries/0_stateless/02801_transform_nullable.sql
new file mode 100644
index 00000000000..bcf4adba2f8
--- /dev/null
+++ b/tests/queries/0_stateless/02801_transform_nullable.sql
@@ -0,0 +1,12 @@
+select transform('a', ['a', 'b'], [toDateTime64(1, 3, 'UTC'), toDateTime64(2, 3, 'UTC')], toDateTime64(0, 3, 'UTC'));
+select transform(2, [1, 2], [toDateTime64(1, 3, 'UTC'), toDateTime64(2, 3, 'UTC')], toDateTime64(0, 3, 'UTC'));
+select transform(null, [1, 2], [toDateTime64(1, 3, 'UTC'), toDateTime64(2, 3, 'UTC')], toDateTime64(0, 3, 'UTC'));
+
+SELECT transform(number, [3, 5, 7], ['hello', 'world', 'abc'], null) FROM system.numbers LIMIT 10;
+SELECT transform(null, ['3', '5', '7'], ['hello', 'world', 'abc'], null) FROM system.numbers LIMIT 10;
+SELECT transform(null, [null, null, null], [null, null, null], null) FROM system.numbers LIMIT 10;
+SELECT transform(toString(number), ['3', '5', '7'], [111, 222, null], -1) FROM system.numbers LIMIT 10;
+SELECT transform(toString(number), ['3', '5', '7'], [null, 222, 333], materialize(-1.1)) FROM system.numbers LIMIT 10;
+SELECT transform(toString(number), ['3', '5', '7'], [null, null, null], materialize(1)) FROM system.numbers LIMIT 10;
+SELECT transform(1, [2, 3], ['Meta.ua', null], materialize('Остальные')) AS title;
+SELECT transform(2, [2, 3], [null, 'Google'], materialize('Остальные')) AS title;

From 64a42c7d3a7738a6055de215daf5a113495e45f7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 07:19:45 +0200
Subject: [PATCH 1226/1478] More tests

---
 .../0_stateless/02801_transform_nullable.reference     | 10 ++++++++++
 tests/queries/0_stateless/02801_transform_nullable.sql |  2 ++
 2 files changed, 12 insertions(+)

diff --git a/tests/queries/0_stateless/02801_transform_nullable.reference b/tests/queries/0_stateless/02801_transform_nullable.reference
index b51587c094c..48d529e7d90 100644
--- a/tests/queries/0_stateless/02801_transform_nullable.reference
+++ b/tests/queries/0_stateless/02801_transform_nullable.reference
@@ -63,3 +63,13 @@ abc
 1
 Остальные
 \N
+-
+xyz
+Hello
+-
+xyz
+World
+-
+xyz
+-
+-
diff --git a/tests/queries/0_stateless/02801_transform_nullable.sql b/tests/queries/0_stateless/02801_transform_nullable.sql
index bcf4adba2f8..95f3c16600a 100644
--- a/tests/queries/0_stateless/02801_transform_nullable.sql
+++ b/tests/queries/0_stateless/02801_transform_nullable.sql
@@ -10,3 +10,5 @@ SELECT transform(toString(number), ['3', '5', '7'], [null, 222, 333], materializ
 SELECT transform(toString(number), ['3', '5', '7'], [null, null, null], materialize(1)) FROM system.numbers LIMIT 10;
 SELECT transform(1, [2, 3], ['Meta.ua', null], materialize('Остальные')) AS title;
 SELECT transform(2, [2, 3], [null, 'Google'], materialize('Остальные')) AS title;
+
+SELECT transform(number % 3 = 1 ? NULL : number, [2, 5, NULL], ['Hello', 'World', 'xyz'], '-') FROM numbers(10);

From 7aa089902081922cb08e3e149f359a85add7785d Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 07:55:38 +0200
Subject: [PATCH 1227/1478] Add a test for #42631

---
 .../02803_remote_cannot_clone_block.reference |  1 +
 .../02803_remote_cannot_clone_block.sql       | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 tests/queries/0_stateless/02803_remote_cannot_clone_block.reference
 create mode 100644 tests/queries/0_stateless/02803_remote_cannot_clone_block.sql

diff --git a/tests/queries/0_stateless/02803_remote_cannot_clone_block.reference b/tests/queries/0_stateless/02803_remote_cannot_clone_block.reference
new file mode 100644
index 00000000000..d00491fd7e5
--- /dev/null
+++ b/tests/queries/0_stateless/02803_remote_cannot_clone_block.reference
@@ -0,0 +1 @@
+1
diff --git a/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql b/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql
new file mode 100644
index 00000000000..3e14aa6be96
--- /dev/null
+++ b/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql
@@ -0,0 +1,19 @@
+DROP TABLE IF EXISTS numbers_10_00223;
+
+CREATE TABLE numbers_10_00223
+ENGINE = Log AS
+SELECT *
+FROM system.numbers
+LIMIT 10000;
+
+SELECT *
+FROM
+(
+    SELECT 1
+    FROM remote('127.0.0.{2,3}', currentDatabase(), numbers_10_00223)
+        WITH TOTALS
+)
+WHERE 1
+GROUP BY 1;
+
+DROP TABLE numbers_10_00223;

From f41183d2098f778381fa1d50ef30411d54c4d73a Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 08:22:42 +0200
Subject: [PATCH 1228/1478] Update test

---
 .../02497_if_transform_strings_to_enum.reference       | 10 ++++++++++
 .../0_stateless/02497_if_transform_strings_to_enum.sql |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02497_if_transform_strings_to_enum.reference b/tests/queries/0_stateless/02497_if_transform_strings_to_enum.reference
index a1a653361ee..88f23334d31 100644
--- a/tests/queries/0_stateless/02497_if_transform_strings_to_enum.reference
+++ b/tests/queries/0_stateless/02497_if_transform_strings_to_enum.reference
@@ -405,6 +405,16 @@ QUERY id: 0
     TABLE id: 7, table_name: system.numbers
   LIMIT
     CONSTANT id: 17, constant_value: UInt64_10, constant_value_type: UInt64
+other
+other
+other
+other
+other
+other
+other
+other
+other
+other
 SELECT transform(number, [NULL], _CAST([\'google\', \'censor.net\', \'yahoo\'], \'Array(Enum8(\\\'censor.net\\\' = 1, \\\'google\\\' = 2, \\\'other\\\' = 3, \\\'yahoo\\\' = 4))\'), _CAST(\'other\', \'Enum8(\\\'censor.net\\\' = 1, \\\'google\\\' = 2, \\\'other\\\' = 3, \\\'yahoo\\\' = 4)\'))
 FROM
 (
diff --git a/tests/queries/0_stateless/02497_if_transform_strings_to_enum.sql b/tests/queries/0_stateless/02497_if_transform_strings_to_enum.sql
index 492d42cb6bc..c3db61d1fb2 100644
--- a/tests/queries/0_stateless/02497_if_transform_strings_to_enum.sql
+++ b/tests/queries/0_stateless/02497_if_transform_strings_to_enum.sql
@@ -33,7 +33,7 @@ SELECT transform(number, [2, 4, 6], ['google', 'censor.net', 'yahoo'], 'other')
 EXPLAIN SYNTAX SELECT transform(number, [2, 4, 6], ['google', 'censor.net', 'yahoo'], 'other') as value, value FROM system.numbers LIMIT 10;
 EXPLAIN QUERY TREE run_passes = 1 SELECT transform(number, [2, 4, 6], ['google', 'censor.net', 'yahoo'], 'other') as value, value FROM system.numbers LIMIT 10;
 
-SELECT transform(number, [NULL], ['google', 'censor.net', 'yahoo'], 'other') FROM (SELECT NULL as number FROM system.numbers LIMIT 10); -- { serverError 36 }
+SELECT transform(number, [NULL], ['google', 'censor.net', 'yahoo'], 'other') FROM (SELECT NULL as number FROM system.numbers LIMIT 10);
 EXPLAIN SYNTAX SELECT transform(number, [NULL], ['google', 'censor.net', 'yahoo'], 'other') FROM (SELECT NULL as number FROM system.numbers LIMIT 10);
 EXPLAIN QUERY TREE run_passes = 1 SELECT transform(number, [NULL], ['google', 'censor.net', 'yahoo'], 'other') FROM (SELECT NULL as number FROM system.numbers LIMIT 10);
 

From 7d55461f8b6aa6b7c59db312e247688d2c31c70f Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 08:23:36 +0200
Subject: [PATCH 1229/1478] Update test

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

diff --git a/tests/queries/0_stateless/01733_transform_ubsan.sql b/tests/queries/0_stateless/01733_transform_ubsan.sql
index 7c3d8ef653a..f2e89e104d7 100644
--- a/tests/queries/0_stateless/01733_transform_ubsan.sql
+++ b/tests/queries/0_stateless/01733_transform_ubsan.sql
@@ -1,4 +1,4 @@
 SELECT arrayStringConcat(arrayMap(x -> transform(x, [1025, -9223372036854775808, 65537, 257, 1048576, 10, 7, 1048575, 65536], ['censor.net', 'googlegooglegooglegoogle', 'test', '', '', 'hello', 'world', '', 'xyz'], ''), arrayMap(x -> (x % -inf), range(number))), '')
 FROM system.numbers
 LIMIT 1025
-FORMAT Null;
+FORMAT Null; -- { serverError 43 }

From a7febd1c13e7b2d3cd932dcb316660db4cb08a4c Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 08:28:23 +0200
Subject: [PATCH 1230/1478] Backward compatibility

---
 src/Functions/transform.cpp                         | 5 ++++-
 tests/queries/0_stateless/01733_transform_ubsan.sql | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/Functions/transform.cpp b/src/Functions/transform.cpp
index db41c6fa081..8d6e53c491e 100644
--- a/src/Functions/transform.cpp
+++ b/src/Functions/transform.cpp
@@ -92,7 +92,10 @@ namespace
             const auto type_arr_from_nested = type_arr_from->getNestedType();
 
             auto src = tryGetLeastSupertype(DataTypes{type_x, type_arr_from_nested});
-            if (!src)
+            if (!src
+                /// Compatibility with previous versions, that allowed even UInt64 with Int64,
+                /// regardless of ambiguous conversions.
+                && !isNativeNumber(type_x) && !isNativeNumber(type_arr_from_nested))
             {
                 throw Exception(
                     ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
diff --git a/tests/queries/0_stateless/01733_transform_ubsan.sql b/tests/queries/0_stateless/01733_transform_ubsan.sql
index f2e89e104d7..7c3d8ef653a 100644
--- a/tests/queries/0_stateless/01733_transform_ubsan.sql
+++ b/tests/queries/0_stateless/01733_transform_ubsan.sql
@@ -1,4 +1,4 @@
 SELECT arrayStringConcat(arrayMap(x -> transform(x, [1025, -9223372036854775808, 65537, 257, 1048576, 10, 7, 1048575, 65536], ['censor.net', 'googlegooglegooglegoogle', 'test', '', '', 'hello', 'world', '', 'xyz'], ''), arrayMap(x -> (x % -inf), range(number))), '')
 FROM system.numbers
 LIMIT 1025
-FORMAT Null; -- { serverError 43 }
+FORMAT Null;

From 3711430d9f97401d80dff14eaab68008bb03132c Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Thu, 15 Jun 2023 16:14:56 +0200
Subject: [PATCH 1231/1478] Rename member fields of CityHash_v1_0_2::uint128:
 "first" -> "low64", "second" -> "high64".

---
 base/base/wide_integer_impl.h                 | 16 ++++++++++++++++
 contrib/cityhash102/include/city.h            | 19 ++++++++++++++++---
 src/Compression/CompressedReadBufferBase.cpp  | 16 ++++++++--------
 src/Compression/CompressedWriteBuffer.cpp     |  8 ++++----
 .../DistributedAsyncInsertHeader.cpp          |  4 ++--
 .../MergeTree/DataPartStorageOnDiskBase.cpp   |  2 +-
 .../MergeTree/MergeTreeDataPartChecksum.cpp   |  8 ++++----
 .../PartMetadataManagerWithCache.cpp          |  8 ++++----
 src/Storages/System/StorageSystemParts.cpp    |  6 +++---
 .../System/StorageSystemProjectionParts.cpp   |  6 +++---
 10 files changed, 61 insertions(+), 32 deletions(-)

diff --git a/base/base/wide_integer_impl.h b/base/base/wide_integer_impl.h
index 4a80c176829..dc6a49694ae 100644
--- a/base/base/wide_integer_impl.h
+++ b/base/base/wide_integer_impl.h
@@ -15,6 +15,8 @@
 #include <boost/multiprecision/cpp_bin_float.hpp>
 #include <boost/math/special_functions/fpclassify.hpp>
 
+#include <city.h>
+
 // NOLINTBEGIN(*)
 
 /// Use same extended double for all platforms
@@ -281,6 +283,14 @@ struct integer<Bits, Signed>::_impl
         }
     }
 
+    constexpr static void wide_integer_from_cityhash_uint128(integer<Bits, Signed> & self, const CityHash_v1_0_2::uint128 & value) noexcept
+    {
+        if constexpr (std::endian::native == std::endian::little)
+            wide_integer_from_tuple_like(self, std::make_pair(value.low64, value.high64));
+        else
+            wide_integer_from_tuple_like(self, std::make_pair(value.high64, value.low64));
+    }
+
     /**
      * N.B. t is constructed from double, so max(t) = max(double) ~ 2^310
      * the recursive call happens when t / 2^64 > 2^64, so there won't be more than 5 of them.
@@ -1036,6 +1046,8 @@ constexpr integer<Bits, Signed>::integer(T rhs) noexcept
         _impl::wide_integer_from_wide_integer(*this, rhs);
     else if  constexpr (IsTupleLike<T>::value)
         _impl::wide_integer_from_tuple_like(*this, rhs);
+    else if constexpr (std::is_same_v<std::remove_cvref_t<T>, CityHash_v1_0_2::uint128>)
+        _impl::wide_integer_from_cityhash_uint128(*this, rhs);
     else
         _impl::wide_integer_from_builtin(*this, rhs);
 }
@@ -1051,6 +1063,8 @@ constexpr integer<Bits, Signed>::integer(std::initializer_list<T> il) noexcept
             _impl::wide_integer_from_wide_integer(*this, *il.begin());
         else if  constexpr (IsTupleLike<T>::value)
             _impl::wide_integer_from_tuple_like(*this, *il.begin());
+        else if constexpr (std::is_same_v<std::remove_cvref_t<T>, CityHash_v1_0_2::uint128>)
+            _impl::wide_integer_from_cityhash_uint128(*this, *il.begin());
         else
             _impl::wide_integer_from_builtin(*this, *il.begin());
     }
@@ -1088,6 +1102,8 @@ constexpr integer<Bits, Signed> & integer<Bits, Signed>::operator=(T rhs) noexce
 {
     if  constexpr (IsTupleLike<T>::value)
         _impl::wide_integer_from_tuple_like(*this, rhs);
+    else if constexpr (std::is_same_v<std::remove_cvref_t<T>, CityHash_v1_0_2::uint128>)
+        _impl::wide_integer_from_cityhash_uint128(*this, rhs);
     else
         _impl::wide_integer_from_builtin(*this, rhs);
     return *this;
diff --git a/contrib/cityhash102/include/city.h b/contrib/cityhash102/include/city.h
index 77d4c988cdd..87363d16444 100644
--- a/contrib/cityhash102/include/city.h
+++ b/contrib/cityhash102/include/city.h
@@ -61,11 +61,24 @@ namespace CityHash_v1_0_2
 typedef uint8_t uint8;
 typedef uint32_t uint32;
 typedef uint64_t uint64;
-typedef std::pair<uint64, uint64> uint128;
 
+/// Represent an unsigned integer of 128 bits as it's used in CityHash.
+/// Originally CityHash used `std::pair<uint64, uint64>` instead of this struct,
+/// however the members `first` and `second` could be easily confused so they were renamed to `low64` and `high64`:
+/// `first` -> `low64`, `second` -> `high64`.
+struct uint128
+{
+    uint64 low64 = 0;
+    uint64 high64 = 0;
 
-inline uint64 Uint128Low64(const uint128& x) { return x.first; }
-inline uint64 Uint128High64(const uint128& x) { return x.second; }
+    uint128() = default;
+    uint128(uint64 low64_, uint64 high64_) : low64(low64_), high64(high64_) {}
+    friend bool operator ==(const uint128 & x, const uint128 & y) { return (x.low64 == y.low64) && (x.high64 == y.high64); }
+    friend bool operator !=(const uint128 & x, const uint128 & y) { return !(x == y); }
+};
+
+inline uint64 Uint128Low64(const uint128 & x) { return x.low64; }
+inline uint64 Uint128High64(const uint128 & x) { return x.high64; }
 
 // Hash function for a byte array.
 uint64 CityHash64(const char *buf, size_t len);
diff --git a/src/Compression/CompressedReadBufferBase.cpp b/src/Compression/CompressedReadBufferBase.cpp
index 278210d770a..662cd6bf337 100644
--- a/src/Compression/CompressedReadBufferBase.cpp
+++ b/src/Compression/CompressedReadBufferBase.cpp
@@ -49,8 +49,8 @@ static void validateChecksum(char * data, size_t size, const Checksum expected_c
 
     /// TODO mess up of endianness in error message.
     message << "Checksum doesn't match: corrupted data."
-        " Reference: " + getHexUIntLowercase(expected_checksum.first) + getHexUIntLowercase(expected_checksum.second)
-        + ". Actual: " + getHexUIntLowercase(calculated_checksum.first) + getHexUIntLowercase(calculated_checksum.second)
+        " Reference: " + getHexUIntLowercase(expected_checksum.low64) + getHexUIntLowercase(expected_checksum.high64)
+        + ". Actual: " + getHexUIntLowercase(calculated_checksum.low64) + getHexUIntLowercase(calculated_checksum.high64)
         + ". Size of compressed block: " + toString(size);
 
     const char * message_hardware_failure = "This is most likely due to hardware failure. "
@@ -95,8 +95,8 @@ static void validateChecksum(char * data, size_t size, const Checksum expected_c
     }
 
     /// Check if the difference caused by single bit flip in stored checksum.
-    size_t difference = std::popcount(expected_checksum.first ^ calculated_checksum.first)
-        + std::popcount(expected_checksum.second ^ calculated_checksum.second);
+    size_t difference = std::popcount(expected_checksum.low64 ^ calculated_checksum.low64)
+        + std::popcount(expected_checksum.high64 ^ calculated_checksum.high64);
 
     if (difference == 1)
     {
@@ -194,8 +194,8 @@ size_t CompressedReadBufferBase::readCompressedData(size_t & size_decompressed,
     {
         Checksum checksum;
         ReadBufferFromMemory checksum_in(own_compressed_buffer.data(), sizeof(checksum));
-        readBinaryLittleEndian(checksum.first, checksum_in);
-        readBinaryLittleEndian(checksum.second, checksum_in);
+        readBinaryLittleEndian(checksum.low64, checksum_in);
+        readBinaryLittleEndian(checksum.high64, checksum_in);
 
         validateChecksum(compressed_buffer, size_compressed_without_checksum, checksum);
     }
@@ -238,8 +238,8 @@ size_t CompressedReadBufferBase::readCompressedDataBlockForAsynchronous(size_t &
         {
             Checksum checksum;
             ReadBufferFromMemory checksum_in(own_compressed_buffer.data(), sizeof(checksum));
-            readBinaryLittleEndian(checksum.first, checksum_in);
-            readBinaryLittleEndian(checksum.second, checksum_in);
+            readBinaryLittleEndian(checksum.low64, checksum_in);
+            readBinaryLittleEndian(checksum.high64, checksum_in);
 
             validateChecksum(compressed_buffer, size_compressed_without_checksum, checksum);
         }
diff --git a/src/Compression/CompressedWriteBuffer.cpp b/src/Compression/CompressedWriteBuffer.cpp
index cb2ee1140d0..f16330332ab 100644
--- a/src/Compression/CompressedWriteBuffer.cpp
+++ b/src/Compression/CompressedWriteBuffer.cpp
@@ -38,8 +38,8 @@ void CompressedWriteBuffer::nextImpl()
 
         CityHash_v1_0_2::uint128 checksum = CityHash_v1_0_2::CityHash128(out_compressed_ptr, compressed_size);
 
-        writeBinaryLittleEndian(checksum.first, out);
-        writeBinaryLittleEndian(checksum.second, out);
+        writeBinaryLittleEndian(checksum.low64, out);
+        writeBinaryLittleEndian(checksum.high64, out);
 
         out.position() += compressed_size;
     }
@@ -50,8 +50,8 @@ void CompressedWriteBuffer::nextImpl()
 
         CityHash_v1_0_2::uint128 checksum = CityHash_v1_0_2::CityHash128(compressed_buffer.data(), compressed_size);
 
-        writeBinaryLittleEndian(checksum.first, out);
-        writeBinaryLittleEndian(checksum.second, out);
+        writeBinaryLittleEndian(checksum.low64, out);
+        writeBinaryLittleEndian(checksum.high64, out);
 
         out.write(compressed_buffer.data(), compressed_size);
     }
diff --git a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
index 018c1d863bb..d815f671652 100644
--- a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
+++ b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
@@ -40,8 +40,8 @@ DistributedAsyncInsertHeader DistributedAsyncInsertHeader::read(ReadBufferFromFi
         {
             throw Exception(ErrorCodes::CHECKSUM_DOESNT_MATCH,
                             "Checksum of extra info doesn't match: corrupted data. Reference: {}{}. Actual: {}{}.",
-                            getHexUIntLowercase(expected_checksum.first), getHexUIntLowercase(expected_checksum.second),
-                            getHexUIntLowercase(calculated_checksum.first), getHexUIntLowercase(calculated_checksum.second));
+                            getHexUIntLowercase(expected_checksum.low64), getHexUIntLowercase(expected_checksum.high64),
+                            getHexUIntLowercase(calculated_checksum.low64), getHexUIntLowercase(calculated_checksum.high64));
         }
 
         /// Read the parts of the header.
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
index 30776a8bc50..92e9005751e 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
@@ -400,7 +400,7 @@ void DataPartStorageOnDiskBase::backup(
         if (it != checksums.files.end())
         {
             file_size = it->second.file_size;
-            file_hash = {it->second.file_hash.first, it->second.file_hash.second};
+            file_hash = it->second.file_hash;
         }
 
         BackupEntryPtr backup_entry = std::make_unique<BackupEntryFromImmutableFile>(disk, filepath_on_disk, copy_encrypted, file_size, file_hash);
diff --git a/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp b/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
index 78f68ea72fe..58ba7acb9ba 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
@@ -154,9 +154,9 @@ bool MergeTreeDataPartChecksums::readV2(ReadBuffer & in)
         assertString("\n\tsize: ", in);
         readText(sum.file_size, in);
         assertString("\n\thash: ", in);
-        readText(sum.file_hash.first, in);
+        readText(sum.file_hash.low64, in);
         assertString(" ", in);
-        readText(sum.file_hash.second, in);
+        readText(sum.file_hash.high64, in);
         assertString("\n\tcompressed: ", in);
         readText(sum.is_compressed, in);
         if (sum.is_compressed)
@@ -164,9 +164,9 @@ bool MergeTreeDataPartChecksums::readV2(ReadBuffer & in)
             assertString("\n\tuncompressed size: ", in);
             readText(sum.uncompressed_size, in);
             assertString("\n\tuncompressed hash: ", in);
-            readText(sum.uncompressed_hash.first, in);
+            readText(sum.uncompressed_hash.low64, in);
             assertString(" ", in);
-            readText(sum.uncompressed_hash.second, in);
+            readText(sum.uncompressed_hash.high64, in);
         }
         assertChar('\n', in);
 
diff --git a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
index 7c0aedf699b..7deae69750f 100644
--- a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
+++ b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
@@ -250,8 +250,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                     ErrorCodes::CORRUPTED_DATA,
                     "Checksums doesn't match in part {} for {}. Expected: {}. Found {}.",
                     part->name, file_path,
-                    getHexUIntUppercase(disk_checksum.first) + getHexUIntUppercase(disk_checksum.second),
-                    getHexUIntUppercase(cache_checksums[i].first) + getHexUIntUppercase(cache_checksums[i].second));
+                    getHexUIntUppercase(disk_checksum.low64) + getHexUIntUppercase(disk_checksum.high64),
+                    getHexUIntUppercase(cache_checksums[i].low64) + getHexUIntUppercase(cache_checksums[i].high64));
 
             disk_checksums.push_back(disk_checksum);
             continue;
@@ -287,8 +287,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                 ErrorCodes::CORRUPTED_DATA,
                 "Checksums doesn't match in projection part {} {}. Expected: {}. Found {}.",
                 part->name, proj_name,
-                getHexUIntUppercase(disk_checksum.first) + getHexUIntUppercase(disk_checksum.second),
-                getHexUIntUppercase(cache_checksums[i].first) + getHexUIntUppercase(cache_checksums[i].second));
+                getHexUIntUppercase(disk_checksum.low64) + getHexUIntUppercase(disk_checksum.high64),
+                getHexUIntUppercase(cache_checksums[i].low64) + getHexUIntUppercase(cache_checksums[i].high64));
         disk_checksums.push_back(disk_checksum);
     }
     return results;
diff --git a/src/Storages/System/StorageSystemParts.cpp b/src/Storages/System/StorageSystemParts.cpp
index 86ecb336b51..95bad0a20fe 100644
--- a/src/Storages/System/StorageSystemParts.cpp
+++ b/src/Storages/System/StorageSystemParts.cpp
@@ -252,17 +252,17 @@ void StorageSystemParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
         }
 
diff --git a/src/Storages/System/StorageSystemProjectionParts.cpp b/src/Storages/System/StorageSystemProjectionParts.cpp
index d2c6c3ef287..6508d062d37 100644
--- a/src/Storages/System/StorageSystemProjectionParts.cpp
+++ b/src/Storages/System/StorageSystemProjectionParts.cpp
@@ -221,17 +221,17 @@ void StorageSystemProjectionParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.first) + getHexUIntLowercase(checksum.second));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
             }
         }
 

From f11e1c25ee2864bd06fbd1dd5bf6009ec0a391f9 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sat, 24 Jun 2023 17:24:54 +0000
Subject: [PATCH 1232/1478] added to fatal errors handler, added comments

---
 src/Common/Exception.h    |  2 ++
 src/Common/StackTrace.cpp | 15 +++++++++++++++
 src/Common/StackTrace.h   |  2 ++
 src/Common/ThreadPool.h   |  2 ++
 src/Daemon/BaseDaemon.cpp | 32 +++++++++++++++++++++++++++++++-
 src/IO/ReadHelpers.h      |  3 +++
 src/IO/WriteHelpers.h     |  3 +++
 7 files changed, 58 insertions(+), 1 deletion(-)

diff --git a/src/Common/Exception.h b/src/Common/Exception.h
index c1bbeada506..4514df2159b 100644
--- a/src/Common/Exception.h
+++ b/src/Common/Exception.h
@@ -42,6 +42,7 @@ public:
         message_format_string = msg.format_string;
     }
 
+    /// Collect call stacks of all previous jobs' schedulings leading to this thread job's execution
     static thread_local std::vector<StackTrace::FramePointers> thread_frame_pointers;
 
 protected:
@@ -140,6 +141,7 @@ private:
 
 protected:
     std::string_view message_format_string;
+    /// Local copy of static per-thread thread_frame_pointers, should be mutable to be unpoisoned on printout
     mutable std::vector<StackTrace::FramePointers> capture_thread_frame_pointers;
 };
 
diff --git a/src/Common/StackTrace.cpp b/src/Common/StackTrace.cpp
index e6b7839c4e2..aea0f854fe1 100644
--- a/src/Common/StackTrace.cpp
+++ b/src/Common/StackTrace.cpp
@@ -412,6 +412,21 @@ void StackTrace::toStringEveryLine(std::function<void(std::string_view)> callbac
     toStringEveryLineImpl(true, {frame_pointers, offset, size}, std::move(callback));
 }
 
+void StackTrace::toStringEveryLine(const FramePointers & frame_pointers, std::function<void(std::string_view)> callback)
+{
+    toStringEveryLineImpl(true, {frame_pointers, 0, static_cast<size_t>(std::ranges::find(frame_pointers, nullptr) - frame_pointers.begin())}, std::move(callback));
+}
+
+void StackTrace::toStringEveryLine(void ** frame_pointers_raw, size_t offset, size_t size, std::function<void(std::string_view)> callback)
+{
+    __msan_unpoison(frame_pointers_raw, size * sizeof(*frame_pointers_raw));
+
+    StackTrace::FramePointers frame_pointers{};
+    std::copy_n(frame_pointers_raw, size, frame_pointers.begin());
+
+    toStringEveryLineImpl(true, {frame_pointers, offset, size}, std::move(callback));
+}
+
 using StackTraceCache = std::map<StackTraceTriple, String, std::less<>>;
 
 static StackTraceCache & cacheInstance()
diff --git a/src/Common/StackTrace.h b/src/Common/StackTrace.h
index 3940c880c5b..656f543d837 100644
--- a/src/Common/StackTrace.h
+++ b/src/Common/StackTrace.h
@@ -65,6 +65,8 @@ public:
     static void symbolize(const FramePointers & frame_pointers, size_t offset, size_t size, StackTrace::Frames & frames);
 
     void toStringEveryLine(std::function<void(std::string_view)> callback) const;
+    static void toStringEveryLine(const FramePointers & frame_pointers, std::function<void(std::string_view)> callback);
+    static void toStringEveryLine(void ** frame_pointers_raw, size_t offset, size_t size, std::function<void(std::string_view)> callback);
 
     /// Displaying the addresses can be disabled for security reasons.
     /// If you turn off addresses, it will be more secure, but we will be unable to help you with debugging.
diff --git a/src/Common/ThreadPool.h b/src/Common/ThreadPool.h
index 17731de9540..57188572a9d 100644
--- a/src/Common/ThreadPool.h
+++ b/src/Common/ThreadPool.h
@@ -129,6 +129,7 @@ private:
         Priority priority;
         DB::OpenTelemetry::TracingContextOnThread thread_trace_context;
 
+        /// Call stacks of all jobs' schedulings leading to this one
         std::vector<StackTrace::FramePointers> frame_pointers;
 
         JobWithPriority(Job job_, Priority priority_, const DB::OpenTelemetry::TracingContextOnThread & thread_trace_context_, bool capture_frame_pointers = false)
@@ -136,6 +137,7 @@ private:
         {
             if (!capture_frame_pointers)
                 return;
+            /// Save all previous jobs call stacks and append with current
             frame_pointers = DB::Exception::thread_frame_pointers;
             frame_pointers.push_back(StackTrace().getFramePointers());
         }
diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index bfd5568b71d..fb5b53201a2 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -19,6 +19,7 @@
 #include <csignal>
 #include <unistd.h>
 
+#include <algorithm>
 #include <typeinfo>
 #include <iostream>
 #include <fstream>
@@ -153,6 +154,7 @@ static void signalHandler(int sig, siginfo_t * info, void * context)
     writePODBinary(*info, out);
     writePODBinary(signal_context, out);
     writePODBinary(stack_trace, out);
+    writeVectorBinary(Exception::thread_frame_pointers, out);
     writeBinary(static_cast<UInt32>(getThreadId()), out);
     writePODBinary(current_thread, out);
 
@@ -250,6 +252,7 @@ public:
                 siginfo_t info{};
                 ucontext_t * context{};
                 StackTrace stack_trace(NoCapture{});
+                std::vector<StackTrace::FramePointers> thread_frame_pointers;
                 UInt32 thread_num{};
                 ThreadStatus * thread_ptr{};
 
@@ -260,12 +263,13 @@ public:
                 }
 
                 readPODBinary(stack_trace, in);
+                readVectorBinary(thread_frame_pointers, 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.
-                std::thread([=, this] { onFault(sig, info, context, stack_trace, thread_num, thread_ptr); }).detach();
+                std::thread([=, this] { onFault(sig, info, context, stack_trace, thread_frame_pointers, thread_num, thread_ptr); }).detach();
             }
         }
     }
@@ -300,6 +304,7 @@ private:
         const siginfo_t & info,
         ucontext_t * context,
         const StackTrace & stack_trace,
+        const std::vector<StackTrace::FramePointers> & thread_frame_pointers,
         UInt32 thread_num,
         ThreadStatus * thread_ptr) const
     {
@@ -375,6 +380,31 @@ private:
         /// Write symbolized stack trace line by line for better grep-ability.
         stack_trace.toStringEveryLine([&](std::string_view s) { LOG_FATAL(log, fmt::runtime(s)); });
 
+        /// In case it's a scheduled job write all previous jobs origins call stacks
+        std::for_each(thread_frame_pointers.rbegin(), thread_frame_pointers.rend(),
+            [this](const StackTrace::FramePointers & frame_pointers)
+            {
+                if (size_t size = std::ranges::find(frame_pointers, nullptr) - frame_pointers.begin())
+                {
+                    LOG_FATAL(log, "========================================");
+                    WriteBufferFromOwnString bare_stacktrace;
+                    writeString("Job's origin stack trace:", bare_stacktrace);
+                    std::for_each_n(frame_pointers.begin(), size,
+                        [&bare_stacktrace](const void * ptr)
+                        {
+                            writeChar(' ', bare_stacktrace);
+                            writePointerHex(ptr, bare_stacktrace);
+                        }
+                    );
+
+                    LOG_FATAL(log, fmt::runtime(bare_stacktrace.str()));
+
+                    StackTrace::toStringEveryLine(const_cast<void **>(&frame_pointers[0]), 0, size, [this](std::string_view s) { LOG_FATAL(log, fmt::runtime(s)); });
+                }
+            }
+        );
+        
+
 #if defined(OS_LINUX)
         /// Write information about binary checksum. It can be difficult to calculate, so do it only after printing stack trace.
         /// Please keep the below log messages in-sync with the ones in programs/server/Server.cpp
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index dabb21c046c..4a05a106de0 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -12,6 +12,7 @@
 
 #include <type_traits>
 
+#include <Common/StackTrace.h>
 #include <Common/formatIPv6.h>
 #include <Common/DateLUT.h>
 #include <Common/LocalDate.h>
@@ -1093,6 +1094,8 @@ 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); }
 
+inline void readBinary(StackTrace::FramePointers & x, ReadBuffer & buf) { readPODBinary(x, buf); }
+
 template <std::endian endian, typename T>
 inline void readBinaryEndian(T & x, ReadBuffer & buf)
 {
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 3d1a5aa49ef..ade7956a67d 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -10,6 +10,7 @@
 
 #include <pcg-random/pcg_random.hpp>
 
+#include <Common/StackTrace.h>
 #include <Common/DateLUT.h>
 #include <Common/LocalDate.h>
 #include <Common/LocalDateTime.h>
@@ -868,6 +869,8 @@ inline void writeBinary(const UUID & x, WriteBuffer & buf) { writePODBinary(x, b
 inline void writeBinary(const IPv4 & x, WriteBuffer & buf) { writePODBinary(x, buf); }
 inline void writeBinary(const IPv6 & x, WriteBuffer & buf) { writePODBinary(x, buf); }
 
+inline void writeBinary(const StackTrace::FramePointers & x, WriteBuffer & buf) { writePODBinary(x, buf); }
+
 /// Methods for outputting the value in text form for a tab-separated format.
 
 inline void writeText(is_integer auto x, WriteBuffer & buf)

From e0485778f54e02d2f4b6ead1b1b3142023b569b1 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sat, 24 Jun 2023 19:37:00 +0000
Subject: [PATCH 1233/1478] style fix

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

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index fb5b53201a2..f92dc82476d 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -403,7 +403,7 @@ private:
                 }
             }
         );
-        
+
 
 #if defined(OS_LINUX)
         /// Write information about binary checksum. It can be difficult to calculate, so do it only after printing stack trace.

From 3ed86867f8b2c055fab7903619f0a74650742722 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 24 Jun 2023 23:06:13 +0200
Subject: [PATCH 1234/1478] Remove `sipHash128ReferenceKeyed`

---
 src/Functions/FunctionsHashing.h              |  29 ---
 src/Functions/FunctionsHashingMisc.cpp        |   5 -
 .../02552_siphash128_reference.sql            | 206 ------------------
 3 files changed, 240 deletions(-)

diff --git a/src/Functions/FunctionsHashing.h b/src/Functions/FunctionsHashing.h
index a4d4fbd085d..db0ff976d63 100644
--- a/src/Functions/FunctionsHashing.h
+++ b/src/Functions/FunctionsHashing.h
@@ -402,34 +402,6 @@ struct SipHash128ReferenceImpl
     static constexpr bool use_int_hash_for_pods = false;
 };
 
-struct SipHash128ReferenceKeyedImpl
-{
-    static constexpr auto name = "sipHash128ReferenceKeyed";
-    using ReturnType = UInt128;
-    using Key = impl::SipHashKey;
-
-    static Key parseKey(const ColumnWithTypeAndName & key) { return impl::parseSipHashKey(key); }
-
-    static UInt128 applyKeyed(const Key & key, const char * begin, size_t size)
-    {
-        return sipHash128ReferenceKeyed(key.key0, key.key1, begin, size);
-    }
-
-    static UInt128 combineHashesKeyed(const Key & key, UInt128 h1, UInt128 h2)
-    {
-#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
-        UInt128 tmp;
-        reverseMemcpy(&tmp, &h1, sizeof(UInt128));
-        h1 = tmp;
-        reverseMemcpy(&tmp, &h2, sizeof(UInt128));
-        h2 = tmp;
-#endif
-        UInt128 hashes[] = {h1, h2};
-        return applyKeyed(key, reinterpret_cast<const char *>(hashes), 2 * sizeof(UInt128));
-    }
-
-    static constexpr bool use_int_hash_for_pods = false;
-};
 
 /** Why we need MurmurHash2?
   * MurmurHash2 is an outdated hash function, superseded by MurmurHash3 and subsequently by CityHash, xxHash, HighwayHash.
@@ -1737,7 +1709,6 @@ using FunctionSHA512 = FunctionStringHashFixedString<SHA512Impl>;
 using FunctionSipHash128 = FunctionAnyHash<SipHash128Impl>;
 using FunctionSipHash128Keyed = FunctionAnyHash<SipHash128KeyedImpl, true, SipHash128KeyedImpl::Key>;
 using FunctionSipHash128Reference = FunctionAnyHash<SipHash128ReferenceImpl>;
-using FunctionSipHash128ReferenceKeyed = FunctionAnyHash<SipHash128ReferenceKeyedImpl, true, SipHash128ReferenceKeyedImpl::Key>;
 using FunctionCityHash64 = FunctionAnyHash<ImplCityHash64>;
 using FunctionFarmFingerprint64 = FunctionAnyHash<ImplFarmFingerprint64>;
 using FunctionFarmHash64 = FunctionAnyHash<ImplFarmHash64>;
diff --git a/src/Functions/FunctionsHashingMisc.cpp b/src/Functions/FunctionsHashingMisc.cpp
index 127c87ba940..56c3c1ed00c 100644
--- a/src/Functions/FunctionsHashingMisc.cpp
+++ b/src/Functions/FunctionsHashingMisc.cpp
@@ -20,11 +20,6 @@ REGISTER_FUNCTION(Hashing)
         .examples{{"hash", "SELECT hex(sipHash128Reference('foo', '\\x01', 3))", ""}},
         .categories{"Hash"}
     });
-    factory.registerFunction<FunctionSipHash128ReferenceKeyed>(FunctionDocumentation{
-        .description="Same as [sipHash128Reference](#hash_functions-siphash128reference) but additionally takes an explicit key argument instead of using a fixed key.",
-        .examples{{"hash", "SELECT hex(sipHash128ReferenceKeyed((506097522914230528, 1084818905618843912),'foo', '\\x01', 3));", ""}},
-        .categories{"Hash"}
-    });
     factory.registerFunction<FunctionCityHash64>();
     factory.registerFunction<FunctionFarmFingerprint64>();
     factory.registerFunction<FunctionFarmHash64>();
diff --git a/tests/queries/0_stateless/02552_siphash128_reference.sql b/tests/queries/0_stateless/02552_siphash128_reference.sql
index c238e51b690..200954c3b57 100644
--- a/tests/queries/0_stateless/02552_siphash128_reference.sql
+++ b/tests/queries/0_stateless/02552_siphash128_reference.sql
@@ -1,207 +1 @@
--- Test Vectors from the SipHash reference C implementation:
--- Written by
--- Jean-Philippe Aumasson <jeanphilippe.aumasson@gmail.com>
--- Daniel J. Bernstein <djb@cr.yp.to>
--- Released under CC0
--- https://github.com/veorq/SipHash/blob/eee7d0d84dc7731df2359b243aa5e75d85f6eaef/vectors.h#L645
-
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           ''));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-select hex(sipHash128ReferenceKeyed((toUInt64(506097522914230528), toUInt64(1084818905618843912)),
-                           char(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)));
-
--- CH tests
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0)) == sipHash128Reference(char(0));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1)) == sipHash128Reference(char(0, 1));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2)) == sipHash128Reference(char(0, 1, 2));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3)) == sipHash128Reference(char(0, 1, 2, 3));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4)) == sipHash128Reference(char(0, 1, 2, 3, 4));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23)) == sipHash128Reference(char(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-select sipHash128ReferenceKeyed((toUInt64(0),toUInt64(0)),char(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)) == sipHash128Reference(char(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));
-
-select sipHash128ReferenceKeyed((0, 0), '1'); -- { serverError 48 }
-select sipHash128ReferenceKeyed(toUInt64(0), '1'); -- { serverError 48 }
-
 SELECT hex(sipHash128Reference()) = hex(reverse(unhex('1CE422FEE7BD8DE20000000000000000'))) or hex(sipHash128()) = '1CE422FEE7BD8DE20000000000000000';
-SELECT hex(sipHash128ReferenceKeyed()) = hex(reverse(unhex('1CE422FEE7BD8DE20000000000000000'))) or hex(sipHash128Keyed()) = '1CE422FEE7BD8DE20000000000000000';

From 84c592aecdb9cbdba17dc7e3431b14c785da11f3 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 01:34:15 +0200
Subject: [PATCH 1235/1478] Update test

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

diff --git a/tests/queries/0_stateless/00809_add_days_segfault.sql b/tests/queries/0_stateless/00809_add_days_segfault.sql
index 6791439708a..d2d91dd2711 100644
--- a/tests/queries/0_stateless/00809_add_days_segfault.sql
+++ b/tests/queries/0_stateless/00809_add_days_segfault.sql
@@ -9,4 +9,4 @@ SET send_logs_level = 'fatal';
 SELECT ignore(addDays((CAST((96.338) AS DateTime)), -3));
 SELECT ignore(subtractDays((CAST((-5263074.47) AS DateTime)), -737895));
 SELECT quantileDeterministic([], identity(( SELECT subtractDays((CAST((566450.398706) AS DateTime)), 54) ) )), '\0', []; -- { serverError 43 }
-SELECT sequenceCount((CAST((( SELECT NULL ) AS rg, ( SELECT ( SELECT [], '<e', caseWithExpr([NULL], -588755.149, []), retention(addWeeks((CAST((-7644612.39732) AS DateTime)), -23578040.02833), (CAST(([]) AS DateTime)), (CAST(([010977.08]) AS String))), emptyArrayToSingle('') ) , '\0', toUInt64([], 't3hw@'), '\0', toStartOfQuarter(-4230.1872, []) ) ) AS Date))); -- { serverError 43 }
+SELECT sequenceCount((CAST((( SELECT NULL ) AS rg, ( SELECT ( SELECT [], '<e', caseWithExpr([NULL], -588755.149, []), retention(addWeeks((CAST((-7644612.39732) AS DateTime)), -23578040.02833), (CAST(([]) AS DateTime)), (CAST(([010977.08]) AS String))), emptyArrayToSingle('') ) , '\0', toUInt64([], 't3hw@'), '\0', toStartOfQuarter(-4230.1872, []) ) ) AS Date))); -- { serverError 43, 36 }

From d84a4626b03ce9aa6d0a3c562ed30dc65670e5cb Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 03:22:59 +0200
Subject: [PATCH 1236/1478] Disable "compile_expressions" setting by default

---
 src/Core/Settings.h   | 2 +-
 tests/clickhouse-test | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 3d42bd582ed..658f3c8025b 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -141,7 +141,7 @@ class IColumn;
     M(Bool, allow_suspicious_low_cardinality_types, false, "In CREATE TABLE statement allows specifying LowCardinality modifier for types of small fixed size (8 or less). Enabling this may increase merge times and memory consumption.", 0) \
     M(Bool, allow_suspicious_fixed_string_types, false, "In CREATE TABLE statement allows creating columns of type FixedString(n) with n > 256. FixedString with length >= 256 is suspicious and most likely indicates misusage", 0) \
     M(Bool, allow_suspicious_indices, false, "Reject primary/secondary indexes and sorting keys with identical expressions", 0) \
-    M(Bool, compile_expressions, true, "Compile some scalar functions and operators to native code.", 0) \
+    M(Bool, compile_expressions, false, "Compile some scalar functions and operators to native code.", 0) \
     M(UInt64, min_count_to_compile_expression, 3, "The number of identical expressions before they are JIT-compiled", 0) \
     M(Bool, compile_aggregate_expressions, true, "Compile aggregate functions to native code. This feature has a bug and should not be used.", 0) \
     M(UInt64, min_count_to_compile_aggregate_expression, 3, "The number of identical aggregate expressions before they are JIT-compiled", 0) \
diff --git a/tests/clickhouse-test b/tests/clickhouse-test
index 82aa3639179..4860ce0fac9 100755
--- a/tests/clickhouse-test
+++ b/tests/clickhouse-test
@@ -589,7 +589,7 @@ class SettingsRandomizer:
         "filesystem_prefetch_step_bytes": lambda: random.choice(
             [0, "100Mi"]
         ),  # 0 means 'auto'
-        "compile_expressions": lambda: random.randint(0, 1),
+        # "compile_expressions": lambda: random.randint(0, 1), - this setting has a bug: https://github.com/ClickHouse/ClickHouse/issues/51264
         "compile_aggregate_expressions": lambda: random.randint(0, 1),
         "compile_sort_description": lambda: random.randint(0, 1),
         "merge_tree_coarse_index_granularity": lambda: random.randint(2, 32),

From 171e11f27693b76d4d131c7a00592fd58bfe884a Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 04:11:27 +0200
Subject: [PATCH 1237/1478] Fix "merge_truncate_long" test

---
 .../01443_merge_truncate_long.reference       | 100 ++++++++++++++++++
 .../0_stateless/01443_merge_truncate_long.sh  |  37 +++++--
 2 files changed, 127 insertions(+), 10 deletions(-)

diff --git a/tests/queries/0_stateless/01443_merge_truncate_long.reference b/tests/queries/0_stateless/01443_merge_truncate_long.reference
index e69de29bb2d..190423f88f8 100644
--- a/tests/queries/0_stateless/01443_merge_truncate_long.reference
+++ b/tests/queries/0_stateless/01443_merge_truncate_long.reference
@@ -0,0 +1,100 @@
+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
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84
+85
+86
+87
+88
+89
+90
+91
+92
+93
+94
+95
+96
+97
+98
+99
+100
diff --git a/tests/queries/0_stateless/01443_merge_truncate_long.sh b/tests/queries/0_stateless/01443_merge_truncate_long.sh
index 00abc48493a..ce867d32c1a 100755
--- a/tests/queries/0_stateless/01443_merge_truncate_long.sh
+++ b/tests/queries/0_stateless/01443_merge_truncate_long.sh
@@ -3,23 +3,40 @@
 
 set -e
 
+CLICKHOUSE_CLIENT_SERVER_LOGS_LEVEL=none
+
 CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CUR_DIR"/../shell_config.sh
 
-CLICKHOUSE_CLIENT=$(echo ${CLICKHOUSE_CLIENT} | sed 's/'"--send_logs_level=${CLICKHOUSE_CLIENT_SERVER_LOGS_LEVEL}"'/--send_logs_level=none/g')
-
 ${CLICKHOUSE_CLIENT} --query="DROP TABLE IF EXISTS t"
-${CLICKHOUSE_CLIENT} --query="CREATE TABLE t (x Int8) ENGINE = MergeTree ORDER BY tuple()"
+${CLICKHOUSE_CLIENT} --query="CREATE TABLE t (x Int8) ENGINE = MergeTree ORDER BY ()"
 
-for _ in {1..70}; do
-    ${CLICKHOUSE_CLIENT} --query="INSERT INTO t VALUES (0)"
-    ${CLICKHOUSE_CLIENT} --query="INSERT INTO t VALUES (0)"
-    ${CLICKHOUSE_CLIENT} --query="OPTIMIZE TABLE t FINAL" 2>/dev/null &
-    ${CLICKHOUSE_CLIENT} --query="TRUNCATE TABLE t"
-    ${CLICKHOUSE_CLIENT} --query="SELECT count() FROM t HAVING count() > 0"
-done
 
+function thread()
+{
+    trap 'BREAK=1' 2
+
+    while [[ -z "${BREAK}" ]]
+    do
+        ${CLICKHOUSE_CLIENT} --query="OPTIMIZE TABLE t FINAL;" 2>&1 | tr -d '\n' | rg -v 'Cancelled merging parts' ||:
+    done
+}
+
+thread &
+pid=$!
+
+for i in {1..100}; do
+    echo "
+        INSERT INTO t VALUES (0);
+        INSERT INTO t VALUES (0);
+        TRUNCATE TABLE t;
+        SELECT count() FROM t HAVING count() > 0;
+        SELECT ${i};
+        "
+done | ${CLICKHOUSE_CLIENT} --multiquery
+
+kill -2 "$pid"
 wait
 
 $CLICKHOUSE_CLIENT -q "DROP TABLE t"

From 1482df53cacfee5d102ff7d99b9ba520dcb2267b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 04:14:40 +0200
Subject: [PATCH 1238/1478] Update reference

---
 .../02552_siphash128_reference.reference      | 129 ------------------
 1 file changed, 129 deletions(-)

diff --git a/tests/queries/0_stateless/02552_siphash128_reference.reference b/tests/queries/0_stateless/02552_siphash128_reference.reference
index 452e9910660..d00491fd7e5 100644
--- a/tests/queries/0_stateless/02552_siphash128_reference.reference
+++ b/tests/queries/0_stateless/02552_siphash128_reference.reference
@@ -1,130 +1 @@
-A3817F04BA25A8E66DF67214C7550293
-DA87C1D86B99AF44347659119B22FC45
-8177228DA4A45DC7FCA38BDEF60AFFE4
-9C70B60C5267A94E5F33B6B02985ED51
-F88164C12D9C8FAF7D0F6E7C7BCD5579
-1368875980776F8854527A07690E9627
-14EECA338B208613485EA0308FD7A15E
-A1F1EBBED8DBC153C0B84AA61FF08239
-3B62A9BA6258F5610F83E264F31497B4
-264499060AD9BAABC47F8B02BB6D71ED
-00110DC378146956C95447D3F3D0FBBA
-0151C568386B6677A2B4DC6F81E5DC18
-D626B266905EF35882634DF68532C125
-9869E247E9C08B10D029934FC4B952F7
-31FCEFAC66D7DE9C7EC7485FE4494902
-5493E99933B0A8117E08EC0F97CFC3D9
-6EE2A4CA67B054BBFD3315BF85230577
-473D06E8738DB89854C066C47AE47740
-A426E5E423BF4885294DA481FEAEF723
-78017731CF65FAB074D5208952512EB1
-9E25FC833F2290733E9344A5E83839EB
-568E495ABE525A218A2214CD3E071D12
-4A29B54552D16B9A469C10528EFF0AAE
-C9D184DDD5A9F5E0CF8CE29A9ABF691C
-2DB479AE78BD50D8882A8A178A6132AD
-8ECE5F042D5E447B5051B9EACB8D8F6F
-9C0B53B4B3C307E87EAEE08678141F66
-ABF248AF69A6EAE4BFD3EB2F129EEB94
-0664DA1668574B88B935F3027358AEF4
-AA4B9DC4BF337DE90CD4FD3C467C6AB7
-EA5C7F471FAF6BDE2B1AD7D4686D2287
-2939B0183223FAFC1723DE4F52C43D35
-7C3956CA5EEAFC3E363E9D556546EB68
-77C6077146F01C32B6B69D5F4EA9FFCF
-37A6986CB8847EDF0925F0F1309B54DE
-A705F0E69DA9A8F907241A2E923C8CC8
-3DC47D1F29C448461E9E76ED904F6711
-0D62BF01E6FC0E1A0D3C4751C5D3692B
-8C03468BCA7C669EE4FD5E084BBEE7B5
-528A5BB93BAF2C9C4473CCE5D0D22BD9
-DF6A301E95C95DAD97AE0CC8C6913BD8
-801189902C857F39E73591285E70B6DB
-E617346AC9C231BB3650AE34CCCA0C5B
-27D93437EFB721AA401821DCEC5ADF89
-89237D9DED9C5E78D8B1C9B166CC7342
-4A6D8091BF5E7D651189FA94A250B14C
-0E33F96055E7AE893FFC0E3DCF492902
-E61C432B720B19D18EC8D84BDC63151B
-F7E5AEF549F782CF379055A608269B16
-438D030FD0B7A54FA837F2AD201A6403
-A590D3EE4FBF04E3247E0D27F286423F
-5FE2C1A172FE93C4B15CD37CAEF9F538
-2C97325CBD06B36EB2133DD08B3A017C
-92C814227A6BCA949FF0659F002AD39E
-DCE850110BD8328CFBD50841D6911D87
-67F14984C7DA791248E32BB5922583DA
-1938F2CF72D54EE97E94166FA91D2A36
-74481E9646ED49FE0F6224301604698E
-57FCA5DE98A9D6D8006438D0583D8A1D
-9FECDE1CEFDC1CBED4763674D9575359
-E3040C00EB28F15366CA73CBD872E740
-7697009A6A831DFECCA91C5993670F7A
-5853542321F567A005D547A4F04759BD
-5150D1772F50834A503E069A973FBD7C
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
-1
 1

From 650e80663c11bafdaca32580fc0f3980cd409be8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 05:59:02 +0200
Subject: [PATCH 1239/1478] Fix MSan report in lowerUTF8/upperUTF8

---
 src/Functions/LowerUpperUTF8Impl.h | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/Functions/LowerUpperUTF8Impl.h b/src/Functions/LowerUpperUTF8Impl.h
index e8d0abae322..f6b18439fd1 100644
--- a/src/Functions/LowerUpperUTF8Impl.h
+++ b/src/Functions/LowerUpperUTF8Impl.h
@@ -139,7 +139,7 @@ struct LowerUpperUTF8Impl
             /// In case partial buffer was passed (due to SSE optimization)
             /// we cannot convert it with current src_end, but we may have more
             /// bytes to convert and eventually got correct symbol.
-            if (partial && src_sequence_length > static_cast<size_t>(src_end-src))
+            if (partial && src_sequence_length > static_cast<size_t>(src_end - src))
                 return false;
 
             auto src_code_point = UTF8::convertUTF8ToCodePoint(src, src_end - src);
@@ -181,7 +181,9 @@ private:
 
 #ifdef __SSE2__
         static constexpr auto bytes_sse = sizeof(__m128i);
-        const auto * src_end_sse = src + (src_end - src) / bytes_sse * bytes_sse;
+
+        /// If we are before this position, we can still read at least bytes_sse.
+        const auto * src_end_sse = src_end - bytes_sse + 1;
 
         /// SSE2 packed comparison operate on signed types, hence compare (c < 0) instead of (c > 0x7f)
         const auto v_zero = _mm_setzero_si128();
@@ -227,9 +229,11 @@ private:
             {
                 /// UTF-8
 
+                /// Find the offset of the next string after src
                 size_t offset_from_begin = src - begin;
                 while (offset_from_begin >= *offset_it)
                     ++offset_it;
+
                 /// Do not allow one row influence another (since row may have invalid sequence, and break the next)
                 const UInt8 * row_end = begin + *offset_it;
                 chassert(row_end >= src);
@@ -247,8 +251,9 @@ private:
             }
         }
 
-        /// Find which offset src has now
-        while (offset_it != offsets.end() && static_cast<size_t>(src - begin) >= *offset_it)
+        /// Find the offset of the next string after src
+        size_t offset_from_begin = src - begin;
+        while (offset_it != offsets.end() && offset_from_begin >= *offset_it)
             ++offset_it;
 #endif
 

From f9dec21c9b7324e9184851e66129f6c2fcf7d0b2 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 06:01:37 +0200
Subject: [PATCH 1240/1478] Add a test

---
 tests/queries/0_stateless/02807_lower_utf8_msan.reference | 4 ++++
 tests/queries/0_stateless/02807_lower_utf8_msan.sql       | 2 ++
 2 files changed, 6 insertions(+)
 create mode 100644 tests/queries/0_stateless/02807_lower_utf8_msan.reference
 create mode 100644 tests/queries/0_stateless/02807_lower_utf8_msan.sql

diff --git a/tests/queries/0_stateless/02807_lower_utf8_msan.reference b/tests/queries/0_stateless/02807_lower_utf8_msan.reference
new file mode 100644
index 00000000000..7d7df6af777
--- /dev/null
+++ b/tests/queries/0_stateless/02807_lower_utf8_msan.reference
@@ -0,0 +1,4 @@
+©--------------------
+©--------------------------------------
+AAAAАБВГAAAAAAAAAAAAАБВГAAAAAAAA
+AAAAАБВГAAAAAAAAAAAAАБВГAAAAAAAA
diff --git a/tests/queries/0_stateless/02807_lower_utf8_msan.sql b/tests/queries/0_stateless/02807_lower_utf8_msan.sql
new file mode 100644
index 00000000000..e9eb18bf615
--- /dev/null
+++ b/tests/queries/0_stateless/02807_lower_utf8_msan.sql
@@ -0,0 +1,2 @@
+SELECT lowerUTF8(arrayJoin(['©--------------------------------------', '©--------------------'])) ORDER BY 1;
+SELECT upperUTF8(materialize('aaaaАБВГaaaaaaaaaaaaАБВГAAAAaaAA')) FROM numbers(2);

From 511b2cdc21f6e0350aea15cb3e786633a9e52ba3 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 06:10:57 +0200
Subject: [PATCH 1241/1478] Increase timeout of fast test

---
 tests/ci/fast_test_check.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/fast_test_check.py b/tests/ci/fast_test_check.py
index 89066ade2cb..d377826513b 100644
--- a/tests/ci/fast_test_check.py
+++ b/tests/ci/fast_test_check.py
@@ -150,7 +150,7 @@ def main():
         os.makedirs(logs_path)
 
     run_log_path = os.path.join(logs_path, "run.log")
-    with TeePopen(run_cmd, run_log_path, timeout=40 * 60) as process:
+    with TeePopen(run_cmd, run_log_path, timeout = 90 * 60) as process:
         retcode = process.wait()
         if retcode == 0:
             logging.info("Run successfully")

From 4fd1fc4507c0628333d869cc21a757e7de7b6da7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 06:14:31 +0200
Subject: [PATCH 1242/1478] Fix typo

---
 tests/ci/tee_popen.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/tee_popen.py b/tests/ci/tee_popen.py
index 4869301785e..7872b489951 100644
--- a/tests/ci/tee_popen.py
+++ b/tests/ci/tee_popen.py
@@ -11,7 +11,7 @@ import os
 import sys
 
 
-# Very simple tee logic implementation. You can specify shell command, output
+# Very simple tee logic implementation. You can specify a shell command, output
 # logfile and env variables. After TeePopen is created you can only wait until
 # it finishes. stderr and stdout will be redirected both to specified file and
 # stdout.

From 8763c601d227a527566fe7f08647e86be205bde5 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sun, 25 Jun 2023 04:22:06 +0000
Subject: [PATCH 1243/1478] Automatic style fix

---
 tests/ci/fast_test_check.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/fast_test_check.py b/tests/ci/fast_test_check.py
index d377826513b..b316705245a 100644
--- a/tests/ci/fast_test_check.py
+++ b/tests/ci/fast_test_check.py
@@ -150,7 +150,7 @@ def main():
         os.makedirs(logs_path)
 
     run_log_path = os.path.join(logs_path, "run.log")
-    with TeePopen(run_cmd, run_log_path, timeout = 90 * 60) as process:
+    with TeePopen(run_cmd, run_log_path, timeout=90 * 60) as process:
         retcode = process.wait()
         if retcode == 0:
             logging.info("Run successfully")

From 535fef97d5d36180ac55ef76af3c480daa46c90c Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sun, 25 Jun 2023 04:44:21 +0000
Subject: [PATCH 1244/1478] clang-tidy fix

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

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index f92dc82476d..634ef5e7f0a 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -399,7 +399,7 @@ private:
 
                     LOG_FATAL(log, fmt::runtime(bare_stacktrace.str()));
 
-                    StackTrace::toStringEveryLine(const_cast<void **>(&frame_pointers[0]), 0, size, [this](std::string_view s) { LOG_FATAL(log, fmt::runtime(s)); });
+                    StackTrace::toStringEveryLine(const_cast<void **>(frame_pointers.data()), 0, size, [this](std::string_view s) { LOG_FATAL(log, fmt::runtime(s)); });
                 }
             }
         );

From 8017ea79c173d2e14f76111fff97e0b1f84d934e Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 06:54:00 +0200
Subject: [PATCH 1245/1478] Fix bad tests for DNS

---
 .../test.py                                    | 18 ++++++++++++++++++
 .../test.py                                    | 17 +++++++++++++++++
 2 files changed, 35 insertions(+)

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 ba807d3b5d7..82ae0b6c527 100644
--- a/tests/integration/test_host_regexp_multiple_ptr_records/test.py
+++ b/tests/integration/test_host_regexp_multiple_ptr_records/test.py
@@ -1,5 +1,7 @@
 import pytest
+import socket
 from helpers.cluster import ClickHouseCluster, get_docker_compose_path, run_and_check
+from time import sleep
 import os
 
 DOCKER_COMPOSE_PATH = get_docker_compose_path()
@@ -32,11 +34,27 @@ def started_cluster():
         cluster.shutdown()
 
 
+def check_ptr_record(ip, hostname):
+    try:
+        host, aliaslist, ipaddrlist = socket.gethostbyaddr(ip)
+        if hostname.lower() == host.lower():
+            return True
+    except socket.herror:
+        pass
+    return False
+
+
 def setup_dns_server(ip):
     domains_string = "test3.example.com test2.example.com test1.example.com"
     example_file_path = f'{ch_server.env_variables["COREDNS_CONFIG_DIR"]}/example.com'
     run_and_check(f"echo '{ip} {domains_string}' > {example_file_path}", shell=True)
 
+    # DNS server takes time to reload the configuration.
+    for try_num in range(10):
+        if all(check_ptr_record(ip, host) for host in domains_string.split()):
+            break
+        sleep(1)
+
 
 def setup_ch_server(dns_server_ip):
     ch_server.exec_in_container(
diff --git a/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/test.py b/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/test.py
index 62f47579612..d73e8813e79 100644
--- a/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/test.py
+++ b/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/test.py
@@ -1,4 +1,5 @@
 import pytest
+import socket
 from helpers.cluster import ClickHouseCluster, get_docker_compose_path, run_and_check
 from time import sleep
 import os
@@ -31,11 +32,27 @@ def started_cluster():
         cluster.shutdown()
 
 
+def check_ptr_record(ip, hostname):
+    try:
+        host, aliaslist, ipaddrlist = socket.gethostbyaddr(ip)
+        if hostname.lower() == host.lower():
+            return True
+    except socket.herror:
+        pass
+    return False
+
+
 def setup_dns_server(ip):
     domains_string = "test3.example.com test2.example.com test1.example.com"
     example_file_path = f'{ch_server.env_variables["COREDNS_CONFIG_DIR"]}/example.com'
     run_and_check(f"echo '{ip} {domains_string}' > {example_file_path}", shell=True)
 
+    # DNS server takes time to reload the configuration.
+    for try_num in range(10):
+        if all(check_ptr_record(ip, host) for host in domains_string.split()):
+            break
+        sleep(1)
+
 
 def setup_ch_server(dns_server_ip):
     ch_server.exec_in_container(

From c1da927b895e2982f729d90b20a212bd40581ea6 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 07:01:36 +0200
Subject: [PATCH 1246/1478] Attempt to fix the `relax_too_many_parts` test

---
 tests/queries/0_stateless/02458_relax_too_many_parts.sql | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/02458_relax_too_many_parts.sql b/tests/queries/0_stateless/02458_relax_too_many_parts.sql
index a1f8e86fce5..01f9edce675 100644
--- a/tests/queries/0_stateless/02458_relax_too_many_parts.sql
+++ b/tests/queries/0_stateless/02458_relax_too_many_parts.sql
@@ -1,5 +1,5 @@
 DROP TABLE IF EXISTS test;
-CREATE TABLE test (x UInt64, s String) ENGINE = MergeTree ORDER BY tuple() SETTINGS parts_to_throw_insert = 3;
+CREATE TABLE test (x UInt64, s String) ENGINE = MergeTree ORDER BY tuple() SETTINGS parts_to_throw_insert = 3, max_parts_to_merge_at_once = 1;
 
 -- The "too many parts" threshold works:
 SET max_block_size = 1, min_insert_block_size_rows = 1, min_insert_block_size_bytes = 1;
@@ -14,7 +14,7 @@ ALTER TABLE test MODIFY SETTING max_avg_part_size_for_too_many_parts = '1M';
 
 -- It works in the same way if parts are small:
 SYSTEM START MERGES test;
-OPTIMIZE TABLE test FINAL;
+OPTIMIZE TABLE test FINAL SETTINGS optimize_throw_if_noop=1;
 SYSTEM STOP MERGES test;
 
 INSERT INTO test VALUES (5, 'a');
@@ -23,7 +23,7 @@ INSERT INTO test VALUES (7, 'a'); -- { serverError TOO_MANY_PARTS }
 
 -- But it allows having more parts if their average size is large:
 SYSTEM START MERGES test;
-OPTIMIZE TABLE test FINAL;
+OPTIMIZE TABLE test FINAL SETTINGS optimize_throw_if_noop=1;
 SYSTEM STOP MERGES test;
 
 SET max_block_size = 65000, min_insert_block_size_rows = 65000, min_insert_block_size_bytes = '1M';

From 266b08132cb4908123ee4479dfa3e93b3ca0212e Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 07:11:41 +0200
Subject: [PATCH 1247/1478] Fix MySQL test in Debug mode

---
 .../02479_mysql_connect_to_self.sql            | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/tests/queries/0_stateless/02479_mysql_connect_to_self.sql b/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
index ff46ebf1ed2..c5c5dfb8c4a 100644
--- a/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
+++ b/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
@@ -8,28 +8,28 @@ INSERT INTO foo VALUES (1, 'one', -1, 'een'), (2, 'two', -2, 'twee'), (3, 'three
 SET allow_experimental_analyzer = 1;
 
 SELECT '---';
-SELECT * FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') ORDER BY key;
+SELECT * FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) ORDER BY key;
 
 SELECT '---';
-SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '');
+SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100);
 
 SELECT '---';
-SELECT 1 FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '');
+SELECT 1 FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100);
 
 SELECT '---';
-SELECT key FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') ORDER BY key;
+SELECT key FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) ORDER BY key;
 
 SELECT '---';
-SELECT b, a FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') ORDER BY a;
+SELECT b, a FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) ORDER BY a;
 
 SELECT '---';
-SELECT b, a FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') ORDER BY c;
+SELECT b, a FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) ORDER BY c;
 
 SELECT '---';
-SELECT b FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') WHERE c != 'twee' ORDER BY b;
+SELECT b FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) WHERE c != 'twee' ORDER BY b;
 
 SELECT '---';
-SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '') WHERE c != 'twee';
+SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connect_timeout = 100, connection_wait_timeout = 100) WHERE c != 'twee';
 
 EXPLAIN QUERY TREE dump_ast = 1
 SELECT * FROM mysql(
@@ -38,5 +38,5 @@ SELECT * FROM mysql(
 );
 
 SELECT '---';
-SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connection_pool_size = 1);
+SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connection_pool_size = 1, connect_timeout = 100, connection_wait_timeout = 100);
 SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connection_pool_size = 0); -- { serverError BAD_ARGUMENTS }

From b46817cbded44f67d9d68421cfe103cb345ef622 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 07:18:29 +0200
Subject: [PATCH 1248/1478] Fix bad test `01018_Distributed__shard_num`

---
 tests/queries/0_stateless/01018_Distributed__shard_num.sql | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/queries/0_stateless/01018_Distributed__shard_num.sql b/tests/queries/0_stateless/01018_Distributed__shard_num.sql
index 7e31062348d..6f9d8a6a1bb 100644
--- a/tests/queries/0_stateless/01018_Distributed__shard_num.sql
+++ b/tests/queries/0_stateless/01018_Distributed__shard_num.sql
@@ -3,6 +3,9 @@
 -- make the order static
 SET max_threads = 1;
 
+-- data should be inserted into Distributed table synchronously
+SET insert_distributed_sync = 1;
+
 DROP TABLE IF EXISTS mem1;
 DROP TABLE IF EXISTS mem2;
 DROP TABLE IF EXISTS mem3;

From 071cd58be805f2021fbead23fb08f2853d816b12 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 08:31:02 +0200
Subject: [PATCH 1249/1478] Fix "logical error" in addressToLineWithInlines

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

diff --git a/src/Functions/addressToLineWithInlines.cpp b/src/Functions/addressToLineWithInlines.cpp
index 9a7b0858b87..43e2eeb10c7 100644
--- a/src/Functions/addressToLineWithInlines.cpp
+++ b/src/Functions/addressToLineWithInlines.cpp
@@ -59,14 +59,13 @@ protected:
 
     void setResult(StringRefs & result, const Dwarf::LocationInfo & location, const std::vector<Dwarf::SymbolizedFrame> & inline_frames) const override
     {
-
         appendLocationToResult(result, location, nullptr);
         for (const auto & inline_frame : inline_frames)
             appendLocationToResult(result, inline_frame.location, &inline_frame);
     }
-private:
 
-    inline ALWAYS_INLINE void appendLocationToResult(StringRefs & result, const Dwarf::LocationInfo & location, const Dwarf::SymbolizedFrame * frame) const
+private:
+    void appendLocationToResult(StringRefs & result, const Dwarf::LocationInfo & location, const Dwarf::SymbolizedFrame * frame) const
     {
         const char * arena_begin = nullptr;
         WriteBufferFromArena out(cache.arena, arena_begin);
@@ -83,6 +82,7 @@ private:
         }
 
         result.emplace_back(out.complete());
+        out.finalize();
     }
 
 };

From f4f2c1476cc9484bd470328c65c454e7b8874169 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 08:40:11 +0200
Subject: [PATCH 1250/1478] Fix test 01280_ttl_where_group_by

---
 .../0_stateless/01280_ttl_where_group_by.sh        | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/tests/queries/0_stateless/01280_ttl_where_group_by.sh b/tests/queries/0_stateless/01280_ttl_where_group_by.sh
index ebef8f2a797..e6f83d6edd1 100755
--- a/tests/queries/0_stateless/01280_ttl_where_group_by.sh
+++ b/tests/queries/0_stateless/01280_ttl_where_group_by.sh
@@ -15,9 +15,11 @@ function optimize()
     done
 }
 
+# "SETTINGS max_parts_to_merge_at_once = 1" prevents merges to start before our own OPTIMIZE FINAL
+
 echo "ttl_01280_1"
 $CLICKHOUSE_CLIENT -n --query "
-create table ttl_01280_1 (a Int, b Int, x Int, y Int, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second delete where x % 10 == 0 and y > 5;
+create table ttl_01280_1 (a Int, b Int, x Int, y Int, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second delete where x % 10 == 0 and y > 5 SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_1 values (1, 1, 0, 4, now() + 10);
 insert into ttl_01280_1 values (1, 1, 10, 6, now());
 insert into ttl_01280_1 values (1, 2, 3, 7, now());
@@ -34,7 +36,7 @@ $CLICKHOUSE_CLIENT --query "drop table if exists ttl_01280_2"
 
 echo "ttl_01280_2"
 $CLICKHOUSE_CLIENT -n --query "
-create table ttl_01280_2 (a Int, b Int, x Array(Int32), y Double, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second group by a, b set x = minForEach(x), y = sum(y), d = max(d);
+create table ttl_01280_2 (a Int, b Int, x Array(Int32), y Double, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second group by a, b set x = minForEach(x), y = sum(y), d = max(d) SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_2 values (1, 1, array(0, 2, 3), 4, now() + 10);
 insert into ttl_01280_2 values (1, 1, array(5, 4, 3), 6, now());
 insert into ttl_01280_2 values (1, 1, array(5, 5, 1), 7, now());
@@ -53,7 +55,7 @@ $CLICKHOUSE_CLIENT --query "drop table if exists ttl_01280_3"
 
 echo "ttl_01280_3"
 $CLICKHOUSE_CLIENT -n --query "
-create table ttl_01280_3 (a Int, b Int, x Int64, y Int, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second group by a set b = min(b), x = argMax(x, d), y = argMax(y, d), d = max(d);
+create table ttl_01280_3 (a Int, b Int, x Int64, y Int, d DateTime) engine = MergeTree order by (a, b) ttl d + interval 1 second group by a set b = min(b), x = argMax(x, d), y = argMax(y, d), d = max(d) SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_3 values (1, 1, 0, 4, now() + 10);
 insert into ttl_01280_3 values (1, 1, 10, 6, now() + 1);
 insert into ttl_01280_3 values (1, 2, 3, 7, now());
@@ -72,7 +74,7 @@ $CLICKHOUSE_CLIENT --query "drop table if exists ttl_01280_4"
 
 echo "ttl_01280_4"
 $CLICKHOUSE_CLIENT -n --query "
-create table ttl_01280_4 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), -(a + b)) ttl d + interval 1 second group by toDate(d) set x = sum(x), y = max(y);
+create table ttl_01280_4 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), -(a + b)) ttl d + interval 1 second group by toDate(d) set x = sum(x), y = max(y) SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_4 values (1, 1, 0, 4, now() + 10);
 insert into ttl_01280_4 values (10, 2, 3, 3, now());
 insert into ttl_01280_4 values (2, 10, 1, 7, now());
@@ -86,7 +88,7 @@ $CLICKHOUSE_CLIENT --query "select x, y from ttl_01280_4 ORDER BY a, b, x, y"
 $CLICKHOUSE_CLIENT --query "drop table if exists ttl_01280_5"
 
 echo "ttl_01280_5"
-$CLICKHOUSE_CLIENT -n --query "create table ttl_01280_5 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), a, -b) ttl d + interval 1 second group by toDate(d), a set x = sum(x), b = argMax(b, -b);
+$CLICKHOUSE_CLIENT -n --query "create table ttl_01280_5 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), a, -b) ttl d + interval 1 second group by toDate(d), a set x = sum(x), b = argMax(b, -b) SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_5 values (1, 2, 3, 5, now());
 insert into ttl_01280_5 values (2, 10, 1, 5, now());
 insert into ttl_01280_5 values (2, 3, 5, 5, now());
@@ -100,7 +102,7 @@ $CLICKHOUSE_CLIENT --query "drop table if exists ttl_01280_6"
 
 echo "ttl_01280_6"
 $CLICKHOUSE_CLIENT -n --query "
-create table ttl_01280_6 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), a, -b) ttl d + interval 1 second group by toDate(d), a;
+create table ttl_01280_6 (a Int, b Int, x Int64, y Int64, d DateTime) engine = MergeTree order by (toDate(d), a, -b) ttl d + interval 1 second group by toDate(d), a SETTINGS max_parts_to_merge_at_once = 1;
 insert into ttl_01280_6 values (1, 2, 3, 5, now());
 insert into ttl_01280_6 values (2, 10, 3, 5, now());
 insert into ttl_01280_6 values (2, 3, 3, 5, now());

From b3f84a2b63cc2e516473d11c3d8852416454641c Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 08:48:31 +0200
Subject: [PATCH 1251/1478] Maybe fix the "many mutations" test

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

diff --git a/tests/queries/0_stateless/02125_many_mutations.sh b/tests/queries/0_stateless/02125_many_mutations.sh
index c3108df5ae3..b42d5bb15d3 100755
--- a/tests/queries/0_stateless/02125_many_mutations.sh
+++ b/tests/queries/0_stateless/02125_many_mutations.sh
@@ -5,7 +5,9 @@ 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 settings number_of_mutations_to_delay = 0, number_of_mutations_to_throw = 0"
+# "max_parts_to_merge_at_once = 1" prevents merges to start in background before our own OPTIMIZE FINAL
+
+$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, max_parts_to_merge_at_once = 1"
 $CLICKHOUSE_CLIENT -q "insert into many_mutations values (0, 0), (1, 1)"
 $CLICKHOUSE_CLIENT -q "system stop merges many_mutations"
 
@@ -44,6 +46,6 @@ wait
 
 $CLICKHOUSE_CLIENT -q "select count() from system.mutations where database = currentDatabase() and table = 'many_mutations' and not is_done"
 $CLICKHOUSE_CLIENT -q "system start merges many_mutations"
-$CLICKHOUSE_CLIENT -q "optimize table many_mutations final"
+$CLICKHOUSE_CLIENT -q "optimize table many_mutations final" --optimize_throw_if_noop 1
 $CLICKHOUSE_CLIENT -q "select count() from system.mutations where database = currentDatabase() and table = 'many_mutations' and not is_done"
 $CLICKHOUSE_CLIENT -q "select x, y from many_mutations order by x"
diff --git a/tests/queries/0_stateless/02125_many_mutations_2.sh b/tests/queries/0_stateless/02125_many_mutations_2.sh
index 52866a54974..e5e3070a944 100755
--- a/tests/queries/0_stateless/02125_many_mutations_2.sh
+++ b/tests/queries/0_stateless/02125_many_mutations_2.sh
@@ -5,7 +5,9 @@ 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 settings number_of_mutations_to_delay = 0, number_of_mutations_to_throw = 0"
+# "max_parts_to_merge_at_once = 1" prevents merges to start in background before our own OPTIMIZE FINAL
+
+$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, max_parts_to_merge_at_once = 1"
 $CLICKHOUSE_CLIENT -q "insert into many_mutations select number, number + 1 from numbers(2000)"
 $CLICKHOUSE_CLIENT -q "system stop merges many_mutations"
 
@@ -44,7 +46,7 @@ wait
 
 $CLICKHOUSE_CLIENT -q "select count() from system.mutations where database = currentDatabase() and table = 'many_mutations' and not is_done"
 $CLICKHOUSE_CLIENT -q "system start merges many_mutations"
-$CLICKHOUSE_CLIENT -q "optimize table many_mutations final"
+$CLICKHOUSE_CLIENT -q "optimize table many_mutations final" --optimize_throw_if_noop 1
 $CLICKHOUSE_CLIENT -q "system flush logs"
 $CLICKHOUSE_CLIENT -q "select count() from system.mutations where database = currentDatabase() and table = 'many_mutations' and not is_done"
 $CLICKHOUSE_CLIENT -q "select count() from many_mutations"

From e9a9a019cf10c2cbd13a28084c4d02c6114a71ad Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 09:28:15 +0200
Subject: [PATCH 1252/1478] Attempt to fix test_ssl_cert_authentication

---
 .../test_ssl_cert_authentication/configs/ssl_config.xml    | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml b/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
index ed3b2b595db..d0b58d984bf 100644
--- a/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
+++ b/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
@@ -18,6 +18,10 @@
             <privateKeyFile>/etc/clickhouse-server/config.d/server-key.pem</privateKeyFile>
             <caConfig>/etc/clickhouse-server/config.d/ca-cert.pem</caConfig>
             <verificationMode>relaxed</verificationMode>
+            <invalidCertificateHandler>
+                <!-- Server cannot ask about the certificate in the terminal. Reject instead. -->
+                <name>RejectCertificateHandler</name>
+            </invalidCertificateHandler>
         </server>
 
         <client> <!-- Used for connecting to https dictionary source and secured Zookeeper communication -->
@@ -25,12 +29,9 @@
             <cacheSessions>true</cacheSessions>
             <disableProtocols>sslv2,sslv3</disableProtocols>
             <preferServerCiphers>true</preferServerCiphers>
-            <!-- Use for self-signed: <verificationMode>none</verificationMode> -->
             <invalidCertificateHandler>
-                <!-- Use for self-signed: <name>AcceptCertificateHandler</name> -->
                 <name>RejectCertificateHandler</name>
             </invalidCertificateHandler>
         </client>
     </openSSL>
 </clickhouse>
-  
\ No newline at end of file

From c4ea7ab5b15add3d3b69412224f9c53e30be1661 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 25 Jun 2023 09:31:09 +0200
Subject: [PATCH 1253/1478] Attempt to fix test_ssl_cert_authentication

---
 programs/server/config.xml                                 | 7 +++++++
 .../test_ssl_cert_authentication/configs/ssl_config.xml    | 4 ----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/programs/server/config.xml b/programs/server/config.xml
index 2f69f23a718..acd6d92a896 100644
--- a/programs/server/config.xml
+++ b/programs/server/config.xml
@@ -282,6 +282,13 @@
             <cacheSessions>true</cacheSessions>
             <disableProtocols>sslv2,sslv3</disableProtocols>
             <preferServerCiphers>true</preferServerCiphers>
+
+            <invalidCertificateHandler>
+                <!-- The server, in contrast to the client, cannot ask about the certificate interactively.
+                     The only reasonable option is to reject.
+                -->
+                <name>RejectCertificateHandler</name>
+            </invalidCertificateHandler>
         </server>
 
         <client> <!-- Used for connecting to https dictionary source and secured Zookeeper communication -->
diff --git a/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml b/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
index d0b58d984bf..24c9eb8891f 100644
--- a/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
+++ b/tests/integration/test_ssl_cert_authentication/configs/ssl_config.xml
@@ -18,10 +18,6 @@
             <privateKeyFile>/etc/clickhouse-server/config.d/server-key.pem</privateKeyFile>
             <caConfig>/etc/clickhouse-server/config.d/ca-cert.pem</caConfig>
             <verificationMode>relaxed</verificationMode>
-            <invalidCertificateHandler>
-                <!-- Server cannot ask about the certificate in the terminal. Reject instead. -->
-                <name>RejectCertificateHandler</name>
-            </invalidCertificateHandler>
         </server>
 
         <client> <!-- Used for connecting to https dictionary source and secured Zookeeper communication -->

From 5871ca0836e9a21790f6bf3cff2d3134523f3a08 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Sat, 24 Jun 2023 20:38:03 +0200
Subject: [PATCH 1254/1478] Fix performance tests due to warnings from jemalloc
 about Per-CPU arena disabled

jemalloc can show the following warning:

    Number of CPUs detected is not deterministic. Per-CPU arena disabled

It will be shown if one of the following returns different number of
CPUs:
- _SC_NPROCESSORS_ONLN
- _SC_NPROCESSORS_CONF
- sched_getaffinity()

And actually for my CPU linux returns different numbers, because there
are more possible CPUs then online, from dmesg:

    smpboot: Allowing 128 CPUs, 64 hotplug CPUs

And from sysfs:

    # grep . /sys/devices/system/cpu/{possible,online,offline}
    /sys/devices/system/cpu/possible:0-127
    /sys/devices/system/cpu/online:0-63
    /sys/devices/system/cpu/offline:64-127

From ACPI:

    # acpidump -o acpi
    # acpixtract -a acpi
    # iasl -d *.dat
    # grep -e 'Processor Enabled' apic.dsl | sort | uniq -c
        64                            Processor Enabled : 0
        64                            Processor Enabled : 1

So I guess this is the same as what happened in this perf run [1].

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/51360/5d43a64112711b339b82b1c0e8df7882546a1a3c/performance_comparison_[4_4]/report.html

P.S. personally I, just use cmdline=possible_cpus=64 to fix this for my
setup.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 docker/test/performance-comparison/compare.sh | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docker/test/performance-comparison/compare.sh b/docker/test/performance-comparison/compare.sh
index 293ad9ac411..798d2a40b12 100755
--- a/docker/test/performance-comparison/compare.sh
+++ b/docker/test/performance-comparison/compare.sh
@@ -14,6 +14,13 @@ LEFT_SERVER_PORT=9001
 # patched version
 RIGHT_SERVER_PORT=9002
 
+# abort_conf   -- abort if some options is not recognized
+# abort        -- abort if something is not right in the env (i.e. per-cpu arenas does not work)
+# narenas      -- set them explicitly to avoid disabling per-cpu arena in env
+#                 that returns different number of CPUs for some of the following
+#                 _SC_NPROCESSORS_ONLN/_SC_NPROCESSORS_CONF/sched_getaffinity
+export MALLOC_CONF="abort_conf:true,abort:true,narenas:$(nproc --all)"
+
 function wait_for_server # port, pid
 {
     for _ in {1..60}
@@ -109,10 +116,6 @@ function restart
     while pkill -f clickhouse-serv ; do echo . ; sleep 1 ; done
     echo all killed
 
-    # Change the jemalloc settings here.
-    # https://github.com/jemalloc/jemalloc/wiki/Getting-Started
-    export MALLOC_CONF="confirm_conf:true"
-
     set -m # Spawn servers in their own process groups
 
     local left_server_opts=(
@@ -147,8 +150,6 @@ function restart
 
     set +m
 
-    unset MALLOC_CONF
-
     wait_for_server $LEFT_SERVER_PORT $left_pid
     echo left ok
 

From cc3d27c0a30e40532541324b100f2584327b5ba3 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Sun, 25 Jun 2023 15:14:29 +0000
Subject: [PATCH 1255/1478] clang-tidy fix

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

diff --git a/src/Common/Exception.cpp b/src/Common/Exception.cpp
index a43335ed8de..af48ce8fd99 100644
--- a/src/Common/Exception.cpp
+++ b/src/Common/Exception.cpp
@@ -164,7 +164,7 @@ std::string Exception::getStackTraceString() const
         {
             thread_stack_trace +=
                 "\nJob's origin stack trace:\n" +
-                StackTrace::toString(&frame_pointers[0], 0, std::ranges::find(frame_pointers, nullptr) - frame_pointers.begin());
+                StackTrace::toString(frame_pointers.data(), 0, std::ranges::find(frame_pointers, nullptr) - frame_pointers.begin());
         }
     );
 

From f1f0daa654755b2d12ec9548262adfe4e87fe9b6 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Thu, 15 Jun 2023 17:59:37 +0200
Subject: [PATCH 1256/1478] Show halves of checksums in "system.parts",
 "system.projection_parts" and error messages in the correct order.

---
 src/Compression/CompressedReadBufferBase.cpp              | 4 ++--
 src/Storages/Distributed/DistributedAsyncInsertHeader.cpp | 4 ++--
 src/Storages/MergeTree/PartMetadataManagerWithCache.cpp   | 8 ++++----
 src/Storages/System/StorageSystemParts.cpp                | 6 +++---
 src/Storages/System/StorageSystemProjectionParts.cpp      | 6 +++---
 utils/checksum-for-compressed-block/main.cpp              | 2 +-
 6 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/src/Compression/CompressedReadBufferBase.cpp b/src/Compression/CompressedReadBufferBase.cpp
index 662cd6bf337..bae52c8bece 100644
--- a/src/Compression/CompressedReadBufferBase.cpp
+++ b/src/Compression/CompressedReadBufferBase.cpp
@@ -49,8 +49,8 @@ static void validateChecksum(char * data, size_t size, const Checksum expected_c
 
     /// TODO mess up of endianness in error message.
     message << "Checksum doesn't match: corrupted data."
-        " Reference: " + getHexUIntLowercase(expected_checksum.low64) + getHexUIntLowercase(expected_checksum.high64)
-        + ". Actual: " + getHexUIntLowercase(calculated_checksum.low64) + getHexUIntLowercase(calculated_checksum.high64)
+        " Reference: " + getHexUIntLowercase(expected_checksum.high64) + getHexUIntLowercase(expected_checksum.low64)
+        + ". Actual: " + getHexUIntLowercase(calculated_checksum.high64) + getHexUIntLowercase(calculated_checksum.low64)
         + ". Size of compressed block: " + toString(size);
 
     const char * message_hardware_failure = "This is most likely due to hardware failure. "
diff --git a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
index d815f671652..e1b54304f23 100644
--- a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
+++ b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
@@ -40,8 +40,8 @@ DistributedAsyncInsertHeader DistributedAsyncInsertHeader::read(ReadBufferFromFi
         {
             throw Exception(ErrorCodes::CHECKSUM_DOESNT_MATCH,
                             "Checksum of extra info doesn't match: corrupted data. Reference: {}{}. Actual: {}{}.",
-                            getHexUIntLowercase(expected_checksum.low64), getHexUIntLowercase(expected_checksum.high64),
-                            getHexUIntLowercase(calculated_checksum.low64), getHexUIntLowercase(calculated_checksum.high64));
+                            getHexUIntLowercase(expected_checksum.high64), getHexUIntLowercase(expected_checksum.low64),
+                            getHexUIntLowercase(calculated_checksum.high64), getHexUIntLowercase(calculated_checksum.low64));
         }
 
         /// Read the parts of the header.
diff --git a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
index 7deae69750f..324bd4bbaee 100644
--- a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
+++ b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
@@ -250,8 +250,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                     ErrorCodes::CORRUPTED_DATA,
                     "Checksums doesn't match in part {} for {}. Expected: {}. Found {}.",
                     part->name, file_path,
-                    getHexUIntUppercase(disk_checksum.low64) + getHexUIntUppercase(disk_checksum.high64),
-                    getHexUIntUppercase(cache_checksums[i].low64) + getHexUIntUppercase(cache_checksums[i].high64));
+                    getHexUIntUppercase(disk_checksum.high64) + getHexUIntUppercase(disk_checksum.low64),
+                    getHexUIntUppercase(cache_checksums[i].high64) + getHexUIntUppercase(cache_checksums[i].low64));
 
             disk_checksums.push_back(disk_checksum);
             continue;
@@ -287,8 +287,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                 ErrorCodes::CORRUPTED_DATA,
                 "Checksums doesn't match in projection part {} {}. Expected: {}. Found {}.",
                 part->name, proj_name,
-                getHexUIntUppercase(disk_checksum.low64) + getHexUIntUppercase(disk_checksum.high64),
-                getHexUIntUppercase(cache_checksums[i].low64) + getHexUIntUppercase(cache_checksums[i].high64));
+                getHexUIntUppercase(disk_checksum.high64) + getHexUIntUppercase(disk_checksum.low64),
+                getHexUIntUppercase(cache_checksums[i].high64) + getHexUIntUppercase(cache_checksums[i].low64));
         disk_checksums.push_back(disk_checksum);
     }
     return results;
diff --git a/src/Storages/System/StorageSystemParts.cpp b/src/Storages/System/StorageSystemParts.cpp
index 95bad0a20fe..b642f4b5088 100644
--- a/src/Storages/System/StorageSystemParts.cpp
+++ b/src/Storages/System/StorageSystemParts.cpp
@@ -252,17 +252,17 @@ void StorageSystemParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
         }
 
diff --git a/src/Storages/System/StorageSystemProjectionParts.cpp b/src/Storages/System/StorageSystemProjectionParts.cpp
index 6508d062d37..05c83747c4d 100644
--- a/src/Storages/System/StorageSystemProjectionParts.cpp
+++ b/src/Storages/System/StorageSystemProjectionParts.cpp
@@ -221,17 +221,17 @@ void StorageSystemProjectionParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.low64) + getHexUIntLowercase(checksum.high64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
             }
         }
 
diff --git a/utils/checksum-for-compressed-block/main.cpp b/utils/checksum-for-compressed-block/main.cpp
index 4f9923e7638..d30a3798820 100644
--- a/utils/checksum-for-compressed-block/main.cpp
+++ b/utils/checksum-for-compressed-block/main.cpp
@@ -45,7 +45,7 @@ int main(int, char **)
     {
         auto flipped = flipBit(str, pos);
         auto checksum = CityHash_v1_0_2::CityHash128(flipped.data(), flipped.size());
-        std::cout << getHexUIntLowercase(checksum.first) << getHexUIntLowercase(checksum.second) << "\t" << pos / 8 << ", " << pos % 8 << "\n";
+        std::cout << getHexUIntLowercase(checksum.high64) << getHexUIntLowercase(checksum.low64) << "\t" << pos / 8 << ", " << pos % 8 << "\n";
     }
 
     return 0;

From 5eeda0a0d24ae14a78da79273870aec9fa6bd8a0 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Sat, 24 Jun 2023 22:17:53 +0200
Subject: [PATCH 1257/1478] Fix test
 00961_checksums_in_system_parts_columns_table

---
 .../00961_checksums_in_system_parts_columns_table.reference     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/00961_checksums_in_system_parts_columns_table.reference b/tests/queries/0_stateless/00961_checksums_in_system_parts_columns_table.reference
index 186f2feab79..4bf3cfe65a2 100644
--- a/tests/queries/0_stateless/00961_checksums_in_system_parts_columns_table.reference
+++ b/tests/queries/0_stateless/00961_checksums_in_system_parts_columns_table.reference
@@ -1 +1 @@
-20000101_1_1_0	test_00961	b5fce9c4ef1ca42ce4ed027389c208d2	fc3b062b646cd23d4c23d7f5920f89ae	da96ff1e527a8a1f908ddf2b1d0af239
+20000101_1_1_0	test_00961	e4ed027389c208d2b5fce9c4ef1ca42c	4c23d7f5920f89aefc3b062b646cd23d	908ddf2b1d0af239da96ff1e527a8a1f

From 71cded08ff2813f4c4757e71a773ca8cc0a293bf Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Sun, 25 Jun 2023 14:51:29 +0200
Subject: [PATCH 1258/1478] Remove unnecessary include <city.h> from
 wide_integer_impl.h

---
 base/base/wide_integer_impl.h | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/base/base/wide_integer_impl.h b/base/base/wide_integer_impl.h
index dc6a49694ae..411841e6d9f 100644
--- a/base/base/wide_integer_impl.h
+++ b/base/base/wide_integer_impl.h
@@ -15,8 +15,6 @@
 #include <boost/multiprecision/cpp_bin_float.hpp>
 #include <boost/math/special_functions/fpclassify.hpp>
 
-#include <city.h>
-
 // NOLINTBEGIN(*)
 
 /// Use same extended double for all platforms
@@ -29,6 +27,8 @@ using FromDoubleIntermediateType = long double;
 using FromDoubleIntermediateType = boost::multiprecision::cpp_bin_float_double_extended;
 #endif
 
+namespace CityHash_v1_0_2 { struct uint128; }
+
 namespace wide
 {
 
@@ -283,8 +283,11 @@ struct integer<Bits, Signed>::_impl
         }
     }
 
-    constexpr static void wide_integer_from_cityhash_uint128(integer<Bits, Signed> & self, const CityHash_v1_0_2::uint128 & value) noexcept
+    template <typename CityHashUInt128 = CityHash_v1_0_2::uint128>
+    constexpr static void wide_integer_from_cityhash_uint128(integer<Bits, Signed> & self, const CityHashUInt128 & value) noexcept
     {
+        static_assert(sizeof(item_count) >= 2);
+
         if constexpr (std::endian::native == std::endian::little)
             wide_integer_from_tuple_like(self, std::make_pair(value.low64, value.high64));
         else

From 477b707ff1765d8a2d62ad21b869d544b212de96 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 02:02:24 +0200
Subject: [PATCH 1259/1478] Revert "Merge pull request #50951 from
 ZhiguoZh/20230607-toyear-fix"

This reverts commit 6bbd0d144df01b07a28d3d9927ce2a6c1dc2ee56, reversing
changes made to 74cb79769bbaa0c4619ca7cb382e6e37c8c7d7b5.
---
 src/Functions/DateTimeTransforms.h            |  72 -------
 .../FunctionDateOrDateTimeToSomething.h       |  13 --
 src/Functions/IFunction.h                     |  24 +--
 src/Functions/IFunctionAdaptors.h             |   7 -
 ...OrDateTimeConverterWithPreimageVisitor.cpp | 199 ------------------
 ...teOrDateTimeConverterWithPreimageVisitor.h |  37 ----
 src/Interpreters/TreeOptimizer.cpp            |  19 --
 ...783_date_predicate_optimizations.reference |  52 -----
 .../02783_date_predicate_optimizations.sql    |  76 -------
 ...dicate_optimizations_ast_rewrite.reference |  87 --------
 ...te_predicate_optimizations_ast_rewrite.sql |  47 -----
 11 files changed, 1 insertion(+), 632 deletions(-)
 delete mode 100644 src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
 delete mode 100644 src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h
 delete mode 100644 tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference
 delete 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 84c71c89b11..019e0c42cde 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -322,7 +322,6 @@ struct ToTimeImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToDateImpl;
 };
@@ -394,7 +393,6 @@ struct ToStartOfSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -442,7 +440,6 @@ struct ToStartOfMillisecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -486,7 +483,6 @@ struct ToStartOfMicrosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -524,7 +520,6 @@ struct ToStartOfNanosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -723,28 +718,6 @@ struct ToYearImpl
         return time_zone.toYear(DayNum(d));
     }
 
-    static inline constexpr 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;
 };
 
@@ -818,7 +791,6 @@ struct ToQuarterImpl
     {
         return time_zone.toQuarter(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -843,7 +815,6 @@ struct ToMonthImpl
     {
         return time_zone.toMonth(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -869,7 +840,6 @@ struct ToDayOfMonthImpl
         return time_zone.toDayOfMonth(DayNum(d));
     }
 
-    static inline constexpr bool hasPreimage() { return false; }
     using FactorTransform = ToStartOfMonthImpl;
 };
 
@@ -917,7 +887,6 @@ struct ToDayOfYearImpl
     {
         return time_zone.toDayOfYear(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -942,7 +911,6 @@ struct ToHourImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToDateImpl;
 };
@@ -971,7 +939,6 @@ struct TimezoneOffsetImpl
         throwDateTimeIsNotSupported(name);
     }
 
-    static inline constexpr bool hasPreimage() { return false; }
     using FactorTransform = ToTimeImpl;
 };
 
@@ -995,7 +962,6 @@ struct ToMinuteImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfHourImpl;
 };
@@ -1020,7 +986,6 @@ struct ToSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfMinuteImpl;
 };
@@ -1045,7 +1010,6 @@ struct ToISOYearImpl
     {
         return time_zone.toISOYear(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1102,7 +1066,6 @@ struct ToISOWeekImpl
     {
         return time_zone.toISOWeek(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToISOYearImpl;
 };
@@ -1145,7 +1108,6 @@ struct ToRelativeYearNumImpl
     {
         return time_zone.toYear(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1177,7 +1139,6 @@ struct ToRelativeQuarterNumImpl
     {
         return time_zone.toRelativeQuarterNum(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1209,7 +1170,6 @@ struct ToRelativeMonthNumImpl
     {
         return time_zone.toRelativeMonthNum(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1241,7 +1201,6 @@ struct ToRelativeWeekNumImpl
     {
         return time_zone.toRelativeWeekNum(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1273,7 +1232,6 @@ struct ToRelativeDayNumImpl
     {
         return static_cast<DayNum>(d);
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1311,7 +1269,6 @@ struct ToRelativeHourNumImpl
         else
             return static_cast<UInt32>(time_zone.toRelativeHourNum(DayNum(d)));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1343,7 +1300,6 @@ struct ToRelativeMinuteNumImpl
     {
         return static_cast<UInt32>(time_zone.toRelativeMinuteNum(DayNum(d)));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1372,7 +1328,6 @@ struct ToRelativeSecondNumImpl
     {
         return static_cast<UInt32>(time_zone.fromDayNum(DayNum(d)));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1397,31 +1352,6 @@ struct ToYYYYMMImpl
     {
         return time_zone.toNumYYYYMM(DayNum(d));
     }
-    static inline constexpr 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;
 };
@@ -1446,7 +1376,6 @@ struct ToYYYYMMDDImpl
     {
         return time_zone.toNumYYYYMMDD(DayNum(d));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1471,7 +1400,6 @@ struct ToYYYYMMDDhhmmssImpl
     {
         return time_zone.toNumYYYYMMDDhhmmss(time_zone.toDate(DayNum(d)));
     }
-    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
diff --git a/src/Functions/FunctionDateOrDateTimeToSomething.h b/src/Functions/FunctionDateOrDateTimeToSomething.h
index d98b788c7d7..82818cc3d2b 100644
--- a/src/Functions/FunctionDateOrDateTimeToSomething.h
+++ b/src/Functions/FunctionDateOrDateTimeToSomething.h
@@ -7,7 +7,6 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
-    extern const int NOT_IMPLEMENTED;
 }
 
 /// See DateTimeTransforms.h
@@ -84,18 +83,6 @@ public:
                 arguments[0].type->getName(), this->getName());
     }
 
-    bool hasInformationAboutPreimage() const override { return Transform::hasPreimage(); }
-
-    RangeOrNull getPreimage(const IDataType & type, const Field & point) const override
-    {
-        if constexpr (Transform::hasPreimage())
-            return Transform::getPreimage(type, point);
-        else
-            throw Exception(ErrorCodes::NOT_IMPLEMENTED,
-                "Function {} has no information about its preimage",
-                Transform::name);
-    }
-
 };
 
 }
diff --git a/src/Functions/IFunction.h b/src/Functions/IFunction.h
index 433cb61d04e..1e4f8bf1102 100644
--- a/src/Functions/IFunction.h
+++ b/src/Functions/IFunction.h
@@ -2,8 +2,6 @@
 
 #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>
@@ -32,8 +30,7 @@ namespace ErrorCodes
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
 }
 
-/// A left-closed and right-open interval representing the preimage of a function.
-using RangeOrNull = std::optional<std::pair<Field, Field>>;
+class Field;
 
 /// The simplest executable object.
 /// Motivation:
@@ -231,12 +228,6 @@ 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?
@@ -290,14 +281,6 @@ 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>;
@@ -487,17 +470,12 @@ 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 123fdbc2f50..23725b1a8b1 100644
--- a/src/Functions/IFunctionAdaptors.h
+++ b/src/Functions/IFunctionAdaptors.h
@@ -90,17 +90,10 @@ 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
deleted file mode 100644
index a377bb4bba6..00000000000
--- a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
+++ /dev/null
@@ -1,199 +0,0 @@
-#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
-{
-
-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:
- *
- *  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 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)
-{
-    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
deleted file mode 100644
index 778fa462364..00000000000
--- a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h
+++ /dev/null
@@ -1,37 +0,0 @@
-#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 fd4d2c9d846..c38b3c79026 100644
--- a/src/Interpreters/TreeOptimizer.cpp
+++ b/src/Interpreters/TreeOptimizer.cpp
@@ -25,7 +25,6 @@
 #include <Interpreters/GatherFunctionQuantileVisitor.h>
 #include <Interpreters/RewriteSumIfFunctionVisitor.h>
 #include <Interpreters/RewriteArrayExistsFunctionVisitor.h>
-#include <Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h>
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -678,21 +677,6 @@ 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"};
@@ -796,9 +780,6 @@ 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/02783_date_predicate_optimizations.reference b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
index 872a5dd1d7d..cd689b93034 100644
--- a/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
@@ -1,54 +1,2 @@
 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 0a2fa6cc93b..abb13f1005e 100644
--- a/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
@@ -11,79 +11,3 @@ 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;
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
deleted file mode 100644
index 9235e7e106a..00000000000
--- a/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference
+++ /dev/null
@@ -1,87 +0,0 @@
-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
deleted file mode 100644
index 266be59b0a3..00000000000
--- a/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.sql
+++ /dev/null
@@ -1,47 +0,0 @@
-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 4ee74ec213b333893ddeb89331970e0d8758adbd Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 02:19:52 +0200
Subject: [PATCH 1260/1478] Two tests are twice longer in average with Analyzer
 and sometimes failing

---
 docker/test/util/process_functional_tests_result.py | 4 ++--
 tests/{broken_tests.txt => analyzer_tech_debt.txt}  | 2 ++
 tests/ci/functional_test_check.py                   | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)
 rename tests/{broken_tests.txt => analyzer_tech_debt.txt} (97%)

diff --git a/docker/test/util/process_functional_tests_result.py b/docker/test/util/process_functional_tests_result.py
index c75a3500831..fd4cc9f4bf7 100755
--- a/docker/test/util/process_functional_tests_result.py
+++ b/docker/test/util/process_functional_tests_result.py
@@ -86,7 +86,7 @@ def process_test_log(log_path, broken_tests):
                                 test_name,
                                 "NOT_FAILED",
                                 test_time,
-                                ["This test passed. Update broken_tests.txt.\n"],
+                                ["This test passed. Update analyzer_tech_debt.txt.\n"],
                             )
                         )
                     else:
@@ -205,7 +205,7 @@ if __name__ == "__main__":
     parser.add_argument("--in-results-dir", default="/test_output/")
     parser.add_argument("--out-results-file", default="/test_output/test_results.tsv")
     parser.add_argument("--out-status-file", default="/test_output/check_status.tsv")
-    parser.add_argument("--broken-tests", default="/broken_tests.txt")
+    parser.add_argument("--broken-tests", default="/analyzer_tech_debt.txt")
     args = parser.parse_args()
 
     broken_tests = list()
diff --git a/tests/broken_tests.txt b/tests/analyzer_tech_debt.txt
similarity index 97%
rename from tests/broken_tests.txt
rename to tests/analyzer_tech_debt.txt
index b3668b06e21..0872033aed0 100644
--- a/tests/broken_tests.txt
+++ b/tests/analyzer_tech_debt.txt
@@ -124,3 +124,5 @@
 02534_s3_cluster_insert_select_schema_inference
 02765_parallel_replicas_final_modifier
 02784_parallel_replicas_automatic_disabling
+02581_share_big_sets_between_mutation_tasks_long
+02581_share_big_sets_between_multiple_mutations_tasks_long
diff --git a/tests/ci/functional_test_check.py b/tests/ci/functional_test_check.py
index f77ef330ea2..9279b19b187 100644
--- a/tests/ci/functional_test_check.py
+++ b/tests/ci/functional_test_check.py
@@ -108,7 +108,7 @@ def get_run_command(
 
     env_str = " ".join(envs)
     volume_with_broken_test = (
-        f"--volume={repo_tests_path}/broken_tests.txt:/broken_tests.txt"
+        f"--volume={repo_tests_path}/analyzer_tech_debt.txt:/analyzer_tech_debt.txt"
         if "analyzer" in check_name
         else ""
     )

From a487a1ab5acbe5fd2d5d1ee9872f895709408002 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 02:48:30 +0200
Subject: [PATCH 1261/1478] Fix bad test

---
 tests/queries/0_stateless/02479_mysql_connect_to_self.sql | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/queries/0_stateless/02479_mysql_connect_to_self.sql b/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
index c5c5dfb8c4a..cf2220073d3 100644
--- a/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
+++ b/tests/queries/0_stateless/02479_mysql_connect_to_self.sql
@@ -2,6 +2,8 @@
 
 SET send_logs_level = 'fatal'; -- failed connection tries are ok, if it succeeded after retry.
 
+DROP TABLE IF EXISTS foo;
+
 CREATE TABLE foo (key UInt32, a String, b Int64, c String) ENGINE = TinyLog;
 INSERT INTO foo VALUES (1, 'one', -1, 'een'), (2, 'two', -2, 'twee'), (3, 'three', -3, 'drie'), (4, 'four', -4, 'vier'), (5, 'five', -5, 'vijf');
 
@@ -40,3 +42,5 @@ SELECT * FROM mysql(
 SELECT '---';
 SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connection_pool_size = 1, connect_timeout = 100, connection_wait_timeout = 100);
 SELECT count() FROM mysql('127.0.0.1:9004', currentDatabase(), foo, 'default', '', SETTINGS connection_pool_size = 0); -- { serverError BAD_ARGUMENTS }
+
+DROP TABLE foo;

From 0e88aae9d7ab53d4267324e17f5a48fae00ae72c Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 04:27:50 +0200
Subject: [PATCH 1262/1478] Remove ConsoleCertificateHandler

---
 .../Poco/Net/ConsoleCertificateHandler.h      | 53 -------------------
 .../include/Poco/Net/SSLManager.h             |  6 +--
 .../src/CertificateHandlerFactoryMgr.cpp      |  2 -
 .../src/ConsoleCertificateHandler.cpp         | 53 -------------------
 base/poco/NetSSL_OpenSSL/src/SSLManager.cpp   |  2 +-
 .../settings.md                               |  2 +-
 .../settings.md                               |  2 +-
 .../settings.md                               |  2 +-
 8 files changed, 7 insertions(+), 115 deletions(-)
 delete mode 100644 base/poco/NetSSL_OpenSSL/include/Poco/Net/ConsoleCertificateHandler.h
 delete mode 100644 base/poco/NetSSL_OpenSSL/src/ConsoleCertificateHandler.cpp

diff --git a/base/poco/NetSSL_OpenSSL/include/Poco/Net/ConsoleCertificateHandler.h b/base/poco/NetSSL_OpenSSL/include/Poco/Net/ConsoleCertificateHandler.h
deleted file mode 100644
index 8e09b6f18ae..00000000000
--- a/base/poco/NetSSL_OpenSSL/include/Poco/Net/ConsoleCertificateHandler.h
+++ /dev/null
@@ -1,53 +0,0 @@
-//
-// ConsoleCertificateHandler.h
-//
-// Library: NetSSL_OpenSSL
-// Package: SSLCore
-// Module:  ConsoleCertificateHandler
-//
-// Definition of the ConsoleCertificateHandler class.
-//
-// Copyright (c) 2006-2009, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#ifndef NetSSL_ConsoleCertificateHandler_INCLUDED
-#define NetSSL_ConsoleCertificateHandler_INCLUDED
-
-
-#include "Poco/Net/InvalidCertificateHandler.h"
-#include "Poco/Net/NetSSL.h"
-
-
-namespace Poco
-{
-namespace Net
-{
-
-
-    class NetSSL_API ConsoleCertificateHandler : public InvalidCertificateHandler
-    /// A ConsoleCertificateHandler is invoked whenever an error occurs verifying the certificate.
-    ///
-    /// The certificate is printed to stdout and the user is asked via console if he wants to accept it.
-    {
-    public:
-        ConsoleCertificateHandler(bool handleErrorsOnServerSide);
-        /// Creates the ConsoleCertificateHandler.
-
-        virtual ~ConsoleCertificateHandler();
-        /// Destroys the ConsoleCertificateHandler.
-
-        void onInvalidCertificate(const void * pSender, VerificationErrorArgs & errorCert);
-        /// Prints the certificate to stdout and waits for user input on the console
-        /// to decide if a certificate should be accepted/rejected.
-    };
-
-
-}
-} // namespace Poco::Net
-
-
-#endif // NetSSL_ConsoleCertificateHandler_INCLUDED
diff --git a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h
index a4fde26286e..21a1ed685e5 100644
--- a/base/poco/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h
+++ b/base/poco/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h
@@ -85,7 +85,7 @@ namespace Net
     ///                </options>
     ///            </privateKeyPassphraseHandler>
     ///            <invalidCertificateHandler>
-    ///                 <name>ConsoleCertificateHandler</name>
+    ///                 <name>RejectCertificateHandler</name>
     ///            </invalidCertificateHandler>
     ///            <cacheSessions>true|false</cacheSessions>
     ///            <sessionIdContext>someString</sessionIdContext> <!-- server only -->
@@ -186,7 +186,7 @@ namespace Net
         ///
         /// Valid initialization code would be:
         ///     SharedPtr<PrivateKeyPassphraseHandler> pConsoleHandler = new KeyConsoleHandler;
-        ///     SharedPtr<InvalidCertificateHandler> pInvalidCertHandler = new ConsoleCertificateHandler;
+        ///     SharedPtr<InvalidCertificateHandler> pInvalidCertHandler = new RejectCertificateHandler;
         ///     Context::Ptr pContext = new Context(Context::SERVER_USE, "any.pem", "any.pem", "rootcert.pem", Context::VERIFY_RELAXED, 9, false, "ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH");
         ///     SSLManager::instance().initializeServer(pConsoleHandler, pInvalidCertHandler, pContext);
 
@@ -203,7 +203,7 @@ namespace Net
         ///
         /// Valid initialization code would be:
         ///     SharedPtr<PrivateKeyPassphraseHandler> pConsoleHandler = new KeyConsoleHandler;
-        ///     SharedPtr<InvalidCertificateHandler> pInvalidCertHandler = new ConsoleCertificateHandler;
+        ///     SharedPtr<InvalidCertificateHandler> pInvalidCertHandler = new RejectCertificateHandler;
         ///     Context::Ptr pContext = new Context(Context::CLIENT_USE, "", "", "rootcert.pem", Context::VERIFY_RELAXED, 9, false, "ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH");
         ///     SSLManager::instance().initializeClient(pConsoleHandler, pInvalidCertHandler, pContext);
 
diff --git a/base/poco/NetSSL_OpenSSL/src/CertificateHandlerFactoryMgr.cpp b/base/poco/NetSSL_OpenSSL/src/CertificateHandlerFactoryMgr.cpp
index a89bbea11f2..f570e2d3599 100644
--- a/base/poco/NetSSL_OpenSSL/src/CertificateHandlerFactoryMgr.cpp
+++ b/base/poco/NetSSL_OpenSSL/src/CertificateHandlerFactoryMgr.cpp
@@ -13,7 +13,6 @@
 
 
 #include "Poco/Net/CertificateHandlerFactoryMgr.h"
-#include "Poco/Net/ConsoleCertificateHandler.h"
 #include "Poco/Net/AcceptCertificateHandler.h"
 #include "Poco/Net/RejectCertificateHandler.h"
 
@@ -24,7 +23,6 @@ namespace Net {
 
 CertificateHandlerFactoryMgr::CertificateHandlerFactoryMgr()
 {
-	setFactory("ConsoleCertificateHandler", new CertificateHandlerFactoryImpl<ConsoleCertificateHandler>());
 	setFactory("AcceptCertificateHandler", new CertificateHandlerFactoryImpl<AcceptCertificateHandler>());
 	setFactory("RejectCertificateHandler", new CertificateHandlerFactoryImpl<RejectCertificateHandler>());
 }
diff --git a/base/poco/NetSSL_OpenSSL/src/ConsoleCertificateHandler.cpp b/base/poco/NetSSL_OpenSSL/src/ConsoleCertificateHandler.cpp
deleted file mode 100644
index db64752e70c..00000000000
--- a/base/poco/NetSSL_OpenSSL/src/ConsoleCertificateHandler.cpp
+++ /dev/null
@@ -1,53 +0,0 @@
-//
-// ConsoleCertificateHandler.cpp
-//
-// Library: NetSSL_OpenSSL
-// Package: SSLCore
-// Module:  ConsoleCertificateHandler
-//
-// Copyright (c) 2006-2009, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#include "Poco/Net/ConsoleCertificateHandler.h"
-#include <iostream>
-
-
-namespace Poco {
-namespace Net {
-
-
-ConsoleCertificateHandler::ConsoleCertificateHandler(bool server): InvalidCertificateHandler(server)
-{
-}
-
-
-ConsoleCertificateHandler::~ConsoleCertificateHandler()
-{
-}
-
-
-void ConsoleCertificateHandler::onInvalidCertificate(const void*, VerificationErrorArgs& errorCert)
-{
-	const X509Certificate& aCert = errorCert.certificate();
-	std::cout << "\n";
-	std::cout << "WARNING: Certificate verification failed\n";
-	std::cout << "----------------------------------------\n";
-	std::cout << "Issuer Name:  " << aCert.issuerName() << "\n";
-	std::cout << "Subject Name: " << aCert.subjectName() << "\n\n";
-	std::cout << "The certificate yielded the error: " << errorCert.errorMessage() << "\n\n";
-	std::cout << "The error occurred in the certificate chain at position " << errorCert.errorDepth() << "\n";
-	std::cout << "Accept the certificate (y,n)? ";
-	char c = 0;
-	std::cin >> c;
-	if (c == 'y' || c == 'Y')
-		errorCert.setIgnoreError(true);
-	else
-		errorCert.setIgnoreError(false);
-}
-
-
-} } // namespace Poco::Net
diff --git a/base/poco/NetSSL_OpenSSL/src/SSLManager.cpp b/base/poco/NetSSL_OpenSSL/src/SSLManager.cpp
index 82eed1a29eb..927602ca658 100644
--- a/base/poco/NetSSL_OpenSSL/src/SSLManager.cpp
+++ b/base/poco/NetSSL_OpenSSL/src/SSLManager.cpp
@@ -46,7 +46,7 @@ const std::string SSLManager::CFG_PREFER_SERVER_CIPHERS("preferServerCiphers");
 const std::string SSLManager::CFG_DELEGATE_HANDLER("privateKeyPassphraseHandler.name");
 const std::string SSLManager::VAL_DELEGATE_HANDLER("KeyConsoleHandler");
 const std::string SSLManager::CFG_CERTIFICATE_HANDLER("invalidCertificateHandler.name");
-const std::string SSLManager::VAL_CERTIFICATE_HANDLER("ConsoleCertificateHandler");
+const std::string SSLManager::VAL_CERTIFICATE_HANDLER("RejectCertificateHandler");
 const std::string SSLManager::CFG_SERVER_PREFIX("openSSL.server.");
 const std::string SSLManager::CFG_CLIENT_PREFIX("openSSL.client.");
 const std::string SSLManager::CFG_CACHE_SESSIONS("cacheSessions");
diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index 5643e273d39..40c1b8d64a1 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -1602,7 +1602,7 @@ Keys for server/client settings:
 - requireTLSv1_2 (default: false) – Require a TLSv1.2 connection. Acceptable values: `true`, `false`.
 - fips (default: false) – Activates OpenSSL FIPS mode. Supported if the library’s OpenSSL version supports FIPS.
 - privateKeyPassphraseHandler (default: `KeyConsoleHandler`)– Class (PrivateKeyPassphraseHandler subclass) that requests the passphrase for accessing the private key. For example: `<privateKeyPassphraseHandler>`, `<name>KeyFileHandler</name>`, `<options><password>test</password></options>`, `</privateKeyPassphraseHandler>`.
-- invalidCertificateHandler (default: `ConsoleCertificateHandler`) – Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: `<invalidCertificateHandler> <name>ConsoleCertificateHandler</name> </invalidCertificateHandler>` .
+- invalidCertificateHandler (default: `RejectCertificateHandler`) – Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: `<invalidCertificateHandler> <name>RejectCertificateHandler</name> </invalidCertificateHandler>` .
 - disableProtocols (default: "") – Protocols that are not allowed to use.
 - preferServerCiphers (default: false) – Preferred server ciphers on the client.
 
diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md
index 33db6df0fdd..5430469ea18 100644
--- a/docs/ru/operations/server-configuration-parameters/settings.md
+++ b/docs/ru/operations/server-configuration-parameters/settings.md
@@ -1067,7 +1067,7 @@ ClickHouse использует потоки из глобального пул
 -   requireTLSv1_2 - Требование соединения TLSv1.2. Допустимые значения: `true`, `false`.
 -   fips - Активация режима OpenSSL FIPS. Поддерживается, если версия OpenSSL, с которой собрана библиотека поддерживает fips.
 -   privateKeyPassphraseHandler - Класс (подкласс PrivateKeyPassphraseHandler)запрашивающий кодовую фразу доступа к секретному ключу. Например, `<privateKeyPassphraseHandler>`, `<name>KeyFileHandler</name>`, `<options><password>test</password></options>`, `</privateKeyPassphraseHandler>`.
--   invalidCertificateHandler - Класс (подкласс CertificateHandler) для подтверждения не валидных сертификатов. Например, `<invalidCertificateHandler> <name>ConsoleCertificateHandler</name> </invalidCertificateHandler>`.
+-   invalidCertificateHandler - Класс (подкласс CertificateHandler) для подтверждения не валидных сертификатов. Например, `<invalidCertificateHandler> <name>RejectCertificateHandler</name> </invalidCertificateHandler>`.
 -   disableProtocols - Запрещенные к использованию протоколы.
 -   preferServerCiphers - Предпочтение серверных шифров на клиенте.
 
diff --git a/docs/zh/operations/server-configuration-parameters/settings.md b/docs/zh/operations/server-configuration-parameters/settings.md
index 52142eda2e8..f6106d8734e 100644
--- a/docs/zh/operations/server-configuration-parameters/settings.md
+++ b/docs/zh/operations/server-configuration-parameters/settings.md
@@ -466,7 +466,7 @@ SSL客户端/服务器配置。
 -   requireTLSv1_2 – Require a TLSv1.2 connection. Acceptable values: `true`, `false`.
 -   fips – Activates OpenSSL FIPS mode. Supported if the library’s OpenSSL version supports FIPS.
 -   privateKeyPassphraseHandler – Class (PrivateKeyPassphraseHandler subclass) that requests the passphrase for accessing the private key. For example: `<privateKeyPassphraseHandler>`, `<name>KeyFileHandler</name>`, `<options><password>test</password></options>`, `</privateKeyPassphraseHandler>`.
--   invalidCertificateHandler – Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: `<invalidCertificateHandler> <name>ConsoleCertificateHandler</name> </invalidCertificateHandler>` .
+-   invalidCertificateHandler – Class (a subclass of CertificateHandler) for verifying invalid certificates. For example: `<invalidCertificateHandler> <name>RejectCertificateHandler</name> </invalidCertificateHandler>` .
 -   disableProtocols – Protocols that are not allowed to use.
 -   preferServerCiphers – Preferred server ciphers on the client.
 

From 88048153d7af70dcfc27dc1c9bd480d9cad99d53 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 04:37:14 +0200
Subject: [PATCH 1263/1478] Fix 00899_long_attach_memory_limit

---
 tests/queries/0_stateless/00899_long_attach_memory_limit.sql | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/00899_long_attach_memory_limit.sql b/tests/queries/0_stateless/00899_long_attach_memory_limit.sql
index aa507cda2ac..d4aa2a0eb7b 100644
--- a/tests/queries/0_stateless/00899_long_attach_memory_limit.sql
+++ b/tests/queries/0_stateless/00899_long_attach_memory_limit.sql
@@ -1,4 +1,5 @@
--- Tags: long, no-debug, no-parallel, no-fasttest
+-- Tags: long, no-debug, no-parallel, no-fasttest, no-msan, no-tsan
+-- This test is slow under MSan or TSan.
 
 DROP TABLE IF EXISTS index_memory;
 CREATE TABLE index_memory (x UInt64) ENGINE = MergeTree ORDER BY x SETTINGS index_granularity = 1;

From cf2e110c134c6934fd22e0c9ec5a598ac5b107cc Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 05:20:35 +0200
Subject: [PATCH 1264/1478] Fix test 01293_optimize_final_force

---
 tests/queries/0_stateless/01293_optimize_final_force.sh | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01293_optimize_final_force.sh b/tests/queries/0_stateless/01293_optimize_final_force.sh
index 994d5952dbc..eb3a2756899 100755
--- a/tests/queries/0_stateless/01293_optimize_final_force.sh
+++ b/tests/queries/0_stateless/01293_optimize_final_force.sh
@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest
+# Tags: no-fasttest, no-debug, no-s3-storage
+# This test is too slow with S3 storage and debug modes.
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 4cef0342979ced426f4823016ebc65f42067aab7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 05:27:45 +0200
Subject: [PATCH 1265/1478] Fix
 02481_parquet_list_monotonically_increasing_offsets.sh

---
 .../02481_parquet_list_monotonically_increasing_offsets.sh   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02481_parquet_list_monotonically_increasing_offsets.sh b/tests/queries/0_stateless/02481_parquet_list_monotonically_increasing_offsets.sh
index 47245eeb940..55e6ac2f758 100755
--- a/tests/queries/0_stateless/02481_parquet_list_monotonically_increasing_offsets.sh
+++ b/tests/queries/0_stateless/02481_parquet_list_monotonically_increasing_offsets.sh
@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Tags: no-ubsan, no-fasttest
+# Tags: no-ubsan, no-fasttest, no-tsan
+# It is too slow under TSan
 
 CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
@@ -13,4 +14,4 @@ ${CLICKHOUSE_CLIENT} --query="CREATE TABLE parquet_load (list Array(Int64), json
 cat "$DATA_FILE" | ${CLICKHOUSE_CLIENT} -q "INSERT INTO parquet_load FORMAT Parquet"
 ${CLICKHOUSE_CLIENT} --query="SELECT * FROM parquet_load" | md5sum
 ${CLICKHOUSE_CLIENT} --query="SELECT count() FROM parquet_load"
-${CLICKHOUSE_CLIENT} --query="drop table parquet_load"
\ No newline at end of file
+${CLICKHOUSE_CLIENT} --query="drop table parquet_load"

From e3d999b023cad921dd740354125a8cbac9c30da5 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 05:43:27 +0200
Subject: [PATCH 1266/1478] Fix test 02497_trace_events_stress_long

---
 .../02497_trace_events_stress_long.sh            | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02497_trace_events_stress_long.sh b/tests/queries/0_stateless/02497_trace_events_stress_long.sh
index 7dc72807c5a..f1dbb9c0399 100755
--- a/tests/queries/0_stateless/02497_trace_events_stress_long.sh
+++ b/tests/queries/0_stateless/02497_trace_events_stress_long.sh
@@ -44,4 +44,18 @@ timeout $TIMEOUT bash -c thread2 >/dev/null &
 wait
 
 $CLICKHOUSE_CLIENT -q "KILL QUERY WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%' SYNC" >/dev/null
-$CLICKHOUSE_CLIENT -q "SELECT count() FROM system.processes WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%'"
+
+# After this moment, the server can still run another query.
+# For example, the 'timeout' command killed all threads of thread1,
+# and the 'timeout' itself has finished, and we have successfully 'wait'-ed for it,
+# but just before that, one of the threads successfully sent a query to the server,
+# but the server didn't start to run this query yet,
+# and even when the KILL QUERY was run, the query from the thread didn't start,
+# but only started after the KILL QUERY has been already processed.
+
+# That's why we have to run the next command in a loop.
+
+for _ in {1..10}
+do
+    $CLICKHOUSE_CLIENT -q "SELECT count() FROM system.processes WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%'" | rg '^0$' && break
+done

From 21c9feeeb3af922fb621688d8bfc7459d9a50f1a Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 05:46:10 +0200
Subject: [PATCH 1267/1478] Fix test

---
 .../02497_trace_events_stress_long.sh         | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/tests/queries/0_stateless/02497_trace_events_stress_long.sh b/tests/queries/0_stateless/02497_trace_events_stress_long.sh
index f1dbb9c0399..3ec729079b8 100755
--- a/tests/queries/0_stateless/02497_trace_events_stress_long.sh
+++ b/tests/queries/0_stateless/02497_trace_events_stress_long.sh
@@ -43,19 +43,21 @@ timeout $TIMEOUT bash -c thread2 >/dev/null &
 
 wait
 
-$CLICKHOUSE_CLIENT -q "KILL QUERY WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%' SYNC" >/dev/null
-
-# After this moment, the server can still run another query.
-# For example, the 'timeout' command killed all threads of thread1,
-# and the 'timeout' itself has finished, and we have successfully 'wait'-ed for it,
-# but just before that, one of the threads successfully sent a query to the server,
-# but the server didn't start to run this query yet,
-# and even when the KILL QUERY was run, the query from the thread didn't start,
-# but only started after the KILL QUERY has been already processed.
-
-# That's why we have to run the next command in a loop.
-
 for _ in {1..10}
 do
+    $CLICKHOUSE_CLIENT -q "KILL QUERY WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%' SYNC" >/dev/null
+
+    # After this moment, the server can still run another query.
+    # For example, the 'timeout' command killed all threads of thread1,
+    # and the 'timeout' itself has finished, and we have successfully 'wait'-ed for it,
+    # but just before that, one of the threads successfully sent a query to the server,
+    # but the server didn't start to run this query yet,
+    # and even when the KILL QUERY was run, the query from the thread didn't start,
+    # but only started after the KILL QUERY has been already processed.
+
+    # That's why we have to run this in a loop.
+
     $CLICKHOUSE_CLIENT -q "SELECT count() FROM system.processes WHERE query_id LIKE '02497_$CLICKHOUSE_DATABASE%'" | rg '^0$' && break
+
+    sleep 1
 done

From 8e6f6655853cfd1106f96c75fddb4cd57f39f8a0 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 05:57:38 +0200
Subject: [PATCH 1268/1478] Fix build

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

diff --git a/src/Functions/IFunction.h b/src/Functions/IFunction.h
index 1e4f8bf1102..c5b9a78015d 100644
--- a/src/Functions/IFunction.h
+++ b/src/Functions/IFunction.h
@@ -11,6 +11,11 @@
 
 #include <memory>
 
+#if USE_EMBEDDED_COMPILER
+#    include <Core/ValuesWithType.h>
+#endif
+
+
 /// This file contains user interface for functions.
 
 namespace llvm

From ae08fb20198a953a31ea5930e5890eded39b0642 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 26 Jun 2023 12:02:09 +0200
Subject: [PATCH 1269/1478] no finalize in d-tor WriteBufferFromOStream

---
 src/IO/WriteBufferFromOStream.cpp | 14 +-------------
 src/IO/WriteBufferFromOStream.h   |  2 --
 2 files changed, 1 insertion(+), 15 deletions(-)

diff --git a/src/IO/WriteBufferFromOStream.cpp b/src/IO/WriteBufferFromOStream.cpp
index e0ec0b770e2..ffc3e62e9a6 100644
--- a/src/IO/WriteBufferFromOStream.cpp
+++ b/src/IO/WriteBufferFromOStream.cpp
@@ -19,14 +19,7 @@ void WriteBufferFromOStream::nextImpl()
     ostr->flush();
 
     if (!ostr->good())
-    {
-        /// 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());
-    }
+        throw Exception(ErrorCodes::CANNOT_WRITE_TO_OSTREAM, "Cannot write to ostream at offset {}", count());
 }
 
 WriteBufferFromOStream::WriteBufferFromOStream(
@@ -46,9 +39,4 @@ WriteBufferFromOStream::WriteBufferFromOStream(
 {
 }
 
-WriteBufferFromOStream::~WriteBufferFromOStream()
-{
-    finalize();
-}
-
 }
diff --git a/src/IO/WriteBufferFromOStream.h b/src/IO/WriteBufferFromOStream.h
index f8b45c2fa59..5a933739cb1 100644
--- a/src/IO/WriteBufferFromOStream.h
+++ b/src/IO/WriteBufferFromOStream.h
@@ -18,8 +18,6 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
-    ~WriteBufferFromOStream() override;
-
 protected:
     explicit WriteBufferFromOStream(size_t size = DBMS_DEFAULT_BUFFER_SIZE, char * existing_memory = nullptr, size_t alignment = 0);
 

From 1f60a6ed4e1040623f7482a64a2ae493996be3e7 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 26 Jun 2023 12:34:11 +0200
Subject: [PATCH 1270/1478] Fix

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 5 +----
 src/Interpreters/Cache/FileSegment.cpp          | 2 +-
 src/Interpreters/Cache/FileSegment.h            | 2 --
 3 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 76d54f9d27c..960d2a72410 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -510,9 +510,6 @@ bool CachedOnDiskReadBufferFromFile::completeFileSegmentAndGetNext()
     current_file_segment->use();
     implementation_buffer = getImplementationBuffer(*current_file_segment);
 
-    if (read_type == ReadType::CACHED)
-        current_file_segment->incrementHitsCount();
-
     LOG_TEST(
         log, "New segment range: {}, old range: {}",
         current_file_segment->range().toString(), completed_range.toString());
@@ -857,7 +854,7 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
         implementation_buffer = getImplementationBuffer(file_segments->front());
 
         if (read_type == ReadType::CACHED)
-            file_segments->front().incrementHitsCount();
+            file_segments->front().use();
     }
 
     chassert(!internal_buffer.empty());
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 95592fc7c12..a77f0726d74 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -898,7 +898,7 @@ void FileSegment::use()
     if (it)
     {
         auto cache_lock = cache->lockCache();
-        it->use(cache_lock);
+        hits_count = it->use(cache_lock);
     }
 }
 
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 681c0d719e4..2e6bbe5657e 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -180,8 +180,6 @@ public:
 
     size_t getRefCount() const { return ref_count; }
 
-    void incrementHitsCount() { ++hits_count; }
-
     size_t getCurrentWriteOffset(bool sync) const;
 
     size_t getFirstNonDownloadedOffset(bool sync) const;

From e92035072b7b3367da12089b28041893eb90e636 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 26 Jun 2023 13:44:09 +0300
Subject: [PATCH 1271/1478] Update MergeTreeTransaction.cpp

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

diff --git a/src/Interpreters/MergeTreeTransaction.cpp b/src/Interpreters/MergeTreeTransaction.cpp
index 1358e3ed3c2..6b8e09a64f5 100644
--- a/src/Interpreters/MergeTreeTransaction.cpp
+++ b/src/Interpreters/MergeTreeTransaction.cpp
@@ -326,6 +326,8 @@ void MergeTreeTransaction::afterFinalize()
     is_read_only = storages.empty();
 
     /// Release shared pointers just in case
+    creating_parts.clear();
+    removing_parts.clear();
     storages.clear();
     mutations.clear();
     finalized = true;

From eb649873b379a29fec5584205558f70641f16bba Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 26 Jun 2023 13:48:21 +0300
Subject: [PATCH 1272/1478] Unify merge predicate (#51344)

* unify merge predicate

* Update BaseDaemon.cpp
---
 .../MergeTree/ReplicatedMergeTreeQueue.cpp    | 234 +++++++++---------
 .../MergeTree/ReplicatedMergeTreeQueue.h      |  95 +++----
 2 files changed, 175 insertions(+), 154 deletions(-)

diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
index 03ded2ef260..3ba3048b812 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
@@ -1530,7 +1530,7 @@ bool ReplicatedMergeTreeQueue::shouldExecuteLogEntry(
 
 
 Int64 ReplicatedMergeTreeQueue::getCurrentMutationVersion(
-    const String & partition_id, Int64 data_version, std::lock_guard<std::mutex> & /* state_lock */) const
+    const String & partition_id, Int64 data_version) const
 {
     auto in_partition = mutations_by_partition.find(partition_id);
     if (in_partition == mutations_by_partition.end())
@@ -2108,24 +2108,19 @@ ReplicatedMergeTreeQueue::QueueLocks ReplicatedMergeTreeQueue::lockQueue()
 }
 
 LocalMergePredicate::LocalMergePredicate(ReplicatedMergeTreeQueue & queue_)
-    : queue(queue_)
 {
+    /// Use only information that can be quickly accessed locally without querying ZooKeeper
+    virtual_parts_ = &queue_.virtual_parts;
+    mutations_state_ = &queue_;
+    virtual_parts_mutex = &queue_.state_mutex;
 }
 
-ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
-    ReplicatedMergeTreeQueue & queue_, zkutil::ZooKeeperPtr & zookeeper, std::optional<PartitionIdsHint> && partition_ids_hint_)
-    : nested_pred(queue_)
-    , queue(queue_)
-    , partition_ids_hint(std::move(partition_ids_hint_))
-    , prev_virtual_parts(queue.format_version)
-{
-    {
-        std::lock_guard lock(queue.state_mutex);
-        prev_virtual_parts = queue.virtual_parts;
-    }
 
-    /// Load current quorum status.
-    auto quorum_status_future = zookeeper->asyncTryGet(fs::path(queue.zookeeper_path) / "quorum" / "status");
+template<typename VirtualPartsT, typename MutationsStateT>
+CommittingBlocks BaseMergePredicate<VirtualPartsT, MutationsStateT>::getCommittingBlocks(
+    zkutil::ZooKeeperPtr & zookeeper, const std::string & zookeeper_path, Poco::Logger * log_)
+{
+    CommittingBlocks committing_blocks;
 
     /// Load current inserts
     /// Hint avoids listing partitions that we don't really need.
@@ -2133,14 +2128,14 @@ ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
     /// so without hint it can do a few thousands requests (if not using MultiRead).
     Strings partitions;
     if (!partition_ids_hint)
-        partitions = zookeeper->getChildren(fs::path(queue.zookeeper_path) / "block_numbers");
+        partitions = zookeeper->getChildren(fs::path(zookeeper_path) / "block_numbers");
     else
         std::copy(partition_ids_hint->begin(), partition_ids_hint->end(), std::back_inserter(partitions));
 
     std::vector<std::string> paths;
     paths.reserve(partitions.size());
     for (const String & partition : partitions)
-        paths.push_back(fs::path(queue.zookeeper_path) / "block_numbers" / partition);
+        paths.push_back(fs::path(zookeeper_path) / "block_numbers" / partition);
 
     auto locks_children = zookeeper->tryGetChildren(paths);
 
@@ -2153,22 +2148,40 @@ ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
         if (response.error != Coordination::Error::ZOK)
         {
             /// Probably a wrong hint was provided (it's ok if a user passed non-existing partition to OPTIMIZE)
-            LOG_WARNING(queue.log, "Partition id '{}' was provided as a hint, but there's not such partition in ZooKeeper", partitions[i]);
+            LOG_WARNING(log_, "Partition id '{}' was provided as a hint, but there's not such partition in ZooKeeper", partitions[i]);
             partition_ids_hint->erase(partitions[i]);
             continue;
         }
 
-        Strings partition_block_numbers = response.names;
+        Strings partition_block_numbers = locks_children[i].names;
         for (const String & entry : partition_block_numbers)
         {
             if (!startsWith(entry, "block-"))
                 continue;
+
             Int64 block_number = parse<Int64>(entry.substr(strlen("block-")));
-            String zk_path = fs::path(queue.zookeeper_path) / "block_numbers" / partitions[i] / entry;
             committing_blocks[partitions[i]].insert(block_number);
         }
     }
 
+    return committing_blocks;
+}
+
+ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
+    ReplicatedMergeTreeQueue & queue_, zkutil::ZooKeeperPtr & zookeeper, std::optional<PartitionIdsHint> && partition_ids_hint_)
+    : BaseMergePredicate<ActiveDataPartSet, ReplicatedMergeTreeQueue>(std::move(partition_ids_hint_))
+    , queue(queue_)
+{
+    {
+        std::lock_guard lock(queue.state_mutex);
+        prev_virtual_parts = std::make_shared<ActiveDataPartSet>(queue.virtual_parts);
+    }
+
+    /// Load current quorum status.
+    auto quorum_status_future = zookeeper->asyncTryGet(fs::path(queue.zookeeper_path) / "quorum" / "status");
+
+    committing_blocks = std::make_shared<CommittingBlocks>(getCommittingBlocks(zookeeper, queue.zookeeper_path, queue.log));
+
     merges_version = queue_.pullLogsToQueue(zookeeper, {}, ReplicatedMergeTreeQueue::MERGE_PREDICATE);
 
     {
@@ -2179,7 +2192,8 @@ ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
         ///
         /// If pinned parts are fetched after logs are pulled then we can safely say that it contains all locks up to `merges_version`.
         String s = zookeeper->get(queue.zookeeper_path + "/pinned_part_uuids");
-        pinned_part_uuids.fromString(s);
+        pinned_part_uuids = std::make_shared<PinnedPartUUIDs>();
+        pinned_part_uuids->fromString(s);
     }
 
     Coordination::GetResponse quorum_status_response = quorum_status_future.get();
@@ -2187,13 +2201,21 @@ ReplicatedMergeTreeMergePredicate::ReplicatedMergeTreeMergePredicate(
     {
         ReplicatedMergeTreeQuorumEntry quorum_status;
         quorum_status.fromString(quorum_status_response.data);
-        inprogress_quorum_part = quorum_status.part_name;
+        inprogress_quorum_part = std::make_shared<String>(quorum_status.part_name);
     }
-    else
-        inprogress_quorum_part.clear();
+
+    /// Use all information about parts
+    prev_virtual_parts_ = prev_virtual_parts.get();
+    virtual_parts_ = &queue.virtual_parts;
+    committing_blocks_ = committing_blocks.get();
+    pinned_part_uuids_ = pinned_part_uuids.get();
+    inprogress_quorum_part_ = inprogress_quorum_part.get();
+    mutations_state_ = &queue;
+    virtual_parts_mutex = &queue.state_mutex;
 }
 
-bool LocalMergePredicate::operator()(
+template<typename VirtualPartsT, typename MutationsStateT>
+bool BaseMergePredicate<VirtualPartsT, MutationsStateT>::operator()(
     const MergeTreeData::DataPartPtr & left,
     const MergeTreeData::DataPartPtr & right,
     const MergeTreeTransaction *,
@@ -2205,20 +2227,8 @@ bool LocalMergePredicate::operator()(
         return canMergeSinglePart(right, out_reason);
 }
 
-bool ReplicatedMergeTreeMergePredicate::operator()(
-    const MergeTreeData::DataPartPtr & left,
-    const MergeTreeData::DataPartPtr & right,
-    const MergeTreeTransaction *,
-    String * out_reason) const
-{
-    if (left)
-        return canMergeTwoParts(left, right, out_reason);
-    else
-        return canMergeSinglePart(right, out_reason);
-}
-
-
-bool ReplicatedMergeTreeMergePredicate::canMergeTwoParts(
+template<typename VirtualPartsT, typename MutationsStateT>
+bool BaseMergePredicate<VirtualPartsT, MutationsStateT>::canMergeTwoParts(
     const MergeTreeData::DataPartPtr & left,
     const MergeTreeData::DataPartPtr & right,
     String * out_reason) const
@@ -2263,21 +2273,21 @@ bool ReplicatedMergeTreeMergePredicate::canMergeTwoParts(
 
     for (const MergeTreeData::DataPartPtr & part : {left, right})
     {
-        if (pinned_part_uuids.part_uuids.contains(part->uuid))
+        if (pinned_part_uuids_ && pinned_part_uuids_->part_uuids.contains(part->uuid))
         {
             if (out_reason)
                 *out_reason = "Part " + part->name + " has uuid " + toString(part->uuid) + " which is currently pinned";
             return false;
         }
 
-        if (part->name == inprogress_quorum_part)
+        if (inprogress_quorum_part_ && part->name == *inprogress_quorum_part_)
         {
             if (out_reason)
                 *out_reason = "Quorum insert for part " + part->name + " is currently in progress";
             return false;
         }
 
-        if (prev_virtual_parts.getContainingPart(part->info).empty())
+        if (prev_virtual_parts_ && prev_virtual_parts_->getContainingPart(part->info).empty())
         {
             if (out_reason)
                 *out_reason = "Entry for part " + part->name + " hasn't been read from the replication log yet";
@@ -2290,7 +2300,7 @@ bool ReplicatedMergeTreeMergePredicate::canMergeTwoParts(
     if (left_max_block > right_min_block)
         std::swap(left_max_block, right_min_block);
 
-    if (left_max_block + 1 < right_min_block)
+    if (committing_blocks_ && left_max_block + 1 < right_min_block)
     {
         if (partition_ids_hint && !partition_ids_hint->contains(left->info.partition_id))
         {
@@ -2299,8 +2309,8 @@ bool ReplicatedMergeTreeMergePredicate::canMergeTwoParts(
             return false;
         }
 
-        auto committing_blocks_in_partition = committing_blocks.find(left->info.partition_id);
-        if (committing_blocks_in_partition != committing_blocks.end())
+        auto committing_blocks_in_partition = committing_blocks_->find(left->info.partition_id);
+        if (committing_blocks_in_partition != committing_blocks_->end())
         {
             const std::set<Int64> & block_numbers = committing_blocks_in_partition->second;
 
@@ -2316,109 +2326,107 @@ bool ReplicatedMergeTreeMergePredicate::canMergeTwoParts(
         }
     }
 
-    return nested_pred.canMergeTwoParts(left, right, out_reason);
-}
+    std::unique_lock<std::mutex> lock;
+    if (virtual_parts_mutex)
+        lock = std::unique_lock(*virtual_parts_mutex);
 
-bool LocalMergePredicate::canMergeTwoParts(
-    const MergeTreeData::DataPartPtr & left,
-    const MergeTreeData::DataPartPtr & right,
-    String * out_reason) const
-{
-    Int64 left_max_block = left->info.max_block;
-    Int64 right_min_block = right->info.min_block;
-
-    std::lock_guard lock(queue.state_mutex);
-
-    for (const MergeTreeData::DataPartPtr & part : {left, right})
+    if (virtual_parts_)
     {
-        /// We look for containing parts in queue.virtual_parts (and not in prev_virtual_parts) because queue.virtual_parts is newer
-        /// and it is guaranteed that it will contain all merges assigned before this object is constructed.
-        String containing_part = queue.virtual_parts.getContainingPart(part->info);
-        if (containing_part != part->name)
+        for (const MergeTreeData::DataPartPtr & part : {left, right})
         {
-            if (out_reason)
-                *out_reason = "Part " + part->name + " has already been assigned a merge into " + containing_part;
-            return false;
+            /// We look for containing parts in queue.virtual_parts (and not in prev_virtual_parts) because queue.virtual_parts is newer
+            /// and it is guaranteed that it will contain all merges assigned before this object is constructed.
+            String containing_part = virtual_parts_->getContainingPart(part->info);
+            if (containing_part != part->name)
+            {
+                if (out_reason)
+                    *out_reason = "Part " + part->name + " has already been assigned a merge into " + containing_part;
+                return false;
+            }
+        }
+
+        if (left_max_block + 1 < right_min_block)
+        {
+            /// Fake part which will appear as merge result
+            MergeTreePartInfo gap_part_info(
+                left->info.partition_id, left_max_block + 1, right_min_block - 1,
+                MergeTreePartInfo::MAX_LEVEL, MergeTreePartInfo::MAX_BLOCK_NUMBER);
+
+            /// We don't select parts if any smaller part covered by our merge must exist after
+            /// processing replication log up to log_pointer.
+            Strings covered = virtual_parts_->getPartsCoveredBy(gap_part_info);
+            if (!covered.empty())
+            {
+                if (out_reason)
+                    *out_reason = "There are " + toString(covered.size()) + " parts (from " + covered.front()
+                        + " to " + covered.back() + ") that are still not present or being processed by "
+                        + " other background process on this replica between " + left->name + " and " + right->name;
+                return false;
+            }
         }
     }
 
-    if (left_max_block + 1 < right_min_block)
+    if (mutations_state_)
     {
-        /// Fake part which will appear as merge result
-        MergeTreePartInfo gap_part_info(
-            left->info.partition_id, left_max_block + 1, right_min_block - 1,
-            MergeTreePartInfo::MAX_LEVEL, MergeTreePartInfo::MAX_BLOCK_NUMBER);
+        Int64 left_mutation_ver = mutations_state_->getCurrentMutationVersion(
+            left->info.partition_id, left->info.getDataVersion());
 
-        /// We don't select parts if any smaller part covered by our merge must exist after
-        /// processing replication log up to log_pointer.
-        Strings covered = queue.virtual_parts.getPartsCoveredBy(gap_part_info);
-        if (!covered.empty())
+        Int64 right_mutation_ver = mutations_state_->getCurrentMutationVersion(
+            left->info.partition_id, right->info.getDataVersion());
+
+        if (left_mutation_ver != right_mutation_ver)
         {
             if (out_reason)
-                *out_reason = "There are " + toString(covered.size()) + " parts (from " + covered.front()
-                    + " to " + covered.back() + ") that are still not present or being processed by "
-                    + " other background process on this replica between " + left->name + " and " + right->name;
+                *out_reason = "Current mutation versions of parts " + left->name + " and " + right->name + " differ: "
+                    + toString(left_mutation_ver) + " and " + toString(right_mutation_ver) + " respectively";
             return false;
         }
     }
 
-    Int64 left_mutation_ver = queue.getCurrentMutationVersion(
-        left->info.partition_id, left->info.getDataVersion(), lock);
-
-    Int64 right_mutation_ver = queue.getCurrentMutationVersion(
-        left->info.partition_id, right->info.getDataVersion(), lock);
-
-    if (left_mutation_ver != right_mutation_ver)
-    {
-        if (out_reason)
-            *out_reason = "Current mutation versions of parts " + left->name + " and " + right->name + " differ: "
-                + toString(left_mutation_ver) + " and " + toString(right_mutation_ver) + " respectively";
-        return false;
-    }
-
     return MergeTreeData::partsContainSameProjections(left, right);
 }
 
-bool ReplicatedMergeTreeMergePredicate::canMergeSinglePart(
+template<typename VirtualPartsT, typename MutationsStateT>
+bool BaseMergePredicate<VirtualPartsT, MutationsStateT>::canMergeSinglePart(
     const MergeTreeData::DataPartPtr & part,
     String * out_reason) const
 {
-    if (pinned_part_uuids.part_uuids.contains(part->uuid))
+    if (pinned_part_uuids_ && pinned_part_uuids_->part_uuids.contains(part->uuid))
     {
         if (out_reason)
             *out_reason = fmt::format("Part {} has uuid {} which is currently pinned", part->name, part->uuid);
         return false;
     }
 
-    if (part->name == inprogress_quorum_part)
+    if (inprogress_quorum_part_ && part->name == *inprogress_quorum_part_)
     {
         if (out_reason)
             *out_reason = fmt::format("Quorum insert for part {} is currently in progress", part->name);
         return false;
     }
 
-    if (prev_virtual_parts.getContainingPart(part->info).empty())
+    if (prev_virtual_parts_ && prev_virtual_parts_->getContainingPart(part->info).empty())
     {
         if (out_reason)
             *out_reason = fmt::format("Entry for part {} hasn't been read from the replication log yet", part->name);
         return false;
     }
 
-    return nested_pred.canMergeSinglePart(part, out_reason);
-}
+    std::unique_lock<std::mutex> lock;
+    if (virtual_parts_mutex)
+        lock = std::unique_lock(*virtual_parts_mutex);
 
-bool LocalMergePredicate::canMergeSinglePart(const MergeTreeData::DataPartPtr & part, String * out_reason) const
-{
-    std::lock_guard lock(queue.state_mutex);
-
-    /// We look for containing parts in queue.virtual_parts (and not in prev_virtual_parts) because queue.virtual_parts is newer
-    /// and it is guaranteed that it will contain all merges assigned before this object is constructed.
-    String containing_part = queue.virtual_parts.getContainingPart(part->info);
-    if (containing_part != part->name)
+    if (virtual_parts_)
     {
-        if (out_reason)
-            *out_reason = fmt::format("Part {} has already been assigned a merge into {}", part->name, containing_part);
-        return false;
+        /// We look for containing parts in queue.virtual_parts (and not in prev_virtual_parts) because queue.virtual_parts is newer
+        /// and it is guaranteed that it will contain all merges assigned before this object is constructed.
+        String containing_part = virtual_parts_->getContainingPart(part->info);
+        if (containing_part != part->name)
+        {
+            if (out_reason)
+                *out_reason = fmt::format("Part {} has already been assigned a merge into {}", part->name, containing_part);
+            return false;
+        }
     }
 
     return true;
@@ -2459,7 +2467,7 @@ std::optional<std::pair<Int64, int>> ReplicatedMergeTreeMergePredicate::getDesir
 
     /// We cannot mutate part if it's being inserted with quorum and it's not
     /// already reached.
-    if (part->name == inprogress_quorum_part)
+    if (inprogress_quorum_part && part->name == *inprogress_quorum_part)
         return {};
 
     std::lock_guard lock(queue.state_mutex);
@@ -2474,7 +2482,7 @@ std::optional<std::pair<Int64, int>> ReplicatedMergeTreeMergePredicate::getDesir
     UInt64 mutations_limit = queue.storage.getSettings()->replicated_max_mutations_in_one_entry;
     UInt64 mutations_count = 0;
 
-    Int64 current_version = queue.getCurrentMutationVersion(part->info.partition_id, part->info.getDataVersion(), lock);
+    Int64 current_version = queue.getCurrentMutationVersion(part->info.partition_id, part->info.getDataVersion());
     Int64 max_version = in_partition->second.begin()->first;
 
     int alter_version = -1;
@@ -2548,8 +2556,8 @@ bool ReplicatedMergeTreeMergePredicate::isMutationFinished(const std::string & z
         if (partition_ids_hint && !partition_ids_hint->contains(partition_id))
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Partition id {} was not provided as hint, it's a bug", partition_id);
 
-        auto partition_it = committing_blocks.find(partition_id);
-        if (partition_it != committing_blocks.end())
+        auto partition_it = committing_blocks->find(partition_id);
+        if (partition_it != committing_blocks->end())
         {
             size_t blocks_count = std::distance(
                 partition_it->second.begin(), partition_it->second.lower_bound(block_num));
@@ -2671,4 +2679,6 @@ void ReplicatedMergeTreeQueue::removeCurrentPartsFromMutations()
         removeCoveredPartsFromMutations(part_name, /*remove_part = */ false, /*remove_covered_parts = */ true);
 }
 
+template class BaseMergePredicate<ActiveDataPartSet, ReplicatedMergeTreeQueue>;
+
 }
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.h b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.h
index 79572e13963..f205526a660 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.h
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.h
@@ -34,6 +34,7 @@ private:
     friend class CurrentlyExecuting;
     friend class LocalMergePredicate;
     friend class ReplicatedMergeTreeMergePredicate;
+    template<typename T, typename U> friend class BaseMergePredicate;
     friend class MergeFromLogEntryTask;
     friend class ReplicatedMergeMutateTaskBase;
 
@@ -212,7 +213,7 @@ private:
     /// with getDataVersion() == data_version. (Either this mutation was already applied or the part
     /// was created after the mutation).
     /// If there is no such mutation or it has already been executed and deleted, return 0.
-    Int64 getCurrentMutationVersion(const String & partition_id, Int64 data_version, std::lock_guard<std::mutex> & /* state_lock */) const;
+    Int64 getCurrentMutationVersion(const String & partition_id, Int64 data_version) const;
 
     /** Check that part isn't in currently generating parts and isn't covered by them.
       * Should be called under state_mutex.
@@ -491,33 +492,14 @@ public:
     void createLogEntriesToFetchBrokenParts();
 };
 
-/// Lightweight version of ReplicatedMergeTreeMergePredicate that do not make any ZooKeeper requests,
-/// but may return false-positive results. Checks only a subset of required conditions.
-class LocalMergePredicate
+using CommittingBlocks = std::unordered_map<String, std::set<Int64>>;
+
+template<typename VirtualPartsT, typename MutationsStateT>
+class BaseMergePredicate
 {
 public:
-    LocalMergePredicate(ReplicatedMergeTreeQueue & queue_);
-
-    bool operator()(const MergeTreeData::DataPartPtr & left,
-                    const MergeTreeData::DataPartPtr & right,
-                    const MergeTreeTransaction * txn,
-                    String * out_reason = nullptr) const;
-
-    bool canMergeTwoParts(const MergeTreeData::DataPartPtr & left,
-                          const MergeTreeData::DataPartPtr & right,
-                          String * out_reason = nullptr) const;
-
-    bool canMergeSinglePart(const MergeTreeData::DataPartPtr & part, String * out_reason) const;
-
-private:
-    const ReplicatedMergeTreeQueue & queue;
-};
-
-class ReplicatedMergeTreeMergePredicate
-{
-public:
-    ReplicatedMergeTreeMergePredicate(ReplicatedMergeTreeQueue & queue_, zkutil::ZooKeeperPtr & zookeeper,
-                                      std::optional<PartitionIdsHint> && partition_ids_hint_);
+    BaseMergePredicate() = default;
+    BaseMergePredicate(std::optional<PartitionIdsHint> && partition_ids_hint_) : partition_ids_hint(std::move(partition_ids_hint_)) {}
 
     /// Depending on the existence of left part checks a merge predicate for two parts or for single part.
     bool operator()(const MergeTreeData::DataPartPtr & left,
@@ -537,6 +519,46 @@ public:
     /// This predicate is checked for the first part of each range.
     bool canMergeSinglePart(const MergeTreeData::DataPartPtr & part, String * out_reason) const;
 
+    CommittingBlocks getCommittingBlocks(zkutil::ZooKeeperPtr & zookeeper, const std::string & zookeeper_path, Poco::Logger * log_);
+
+protected:
+    /// A list of partitions that can be used in the merge predicate
+    std::optional<PartitionIdsHint> partition_ids_hint;
+
+    /// A snapshot of active parts that would appear if the replica executes all log entries in its queue.
+    const VirtualPartsT * prev_virtual_parts_ = nullptr;
+    const VirtualPartsT * virtual_parts_ = nullptr;
+
+    /// partition ID -> block numbers of the inserts and mutations that are about to commit
+    /// (loaded at some later time than prev_virtual_parts).
+    const CommittingBlocks * committing_blocks_ = nullptr;
+
+    /// List of UUIDs for parts that have their identity "pinned".
+    const PinnedPartUUIDs * pinned_part_uuids_ = nullptr;
+
+    /// Quorum state taken at some later time than prev_virtual_parts.
+    const String * inprogress_quorum_part_ = nullptr;
+
+    /// An object that provides current mutation version for a part
+    const MutationsStateT * mutations_state_ = nullptr;
+
+    std::mutex * virtual_parts_mutex = nullptr;
+};
+
+/// Lightweight version of ReplicatedMergeTreeMergePredicate that do not make any ZooKeeper requests,
+/// but may return false-positive results. Checks only a subset of required conditions.
+class LocalMergePredicate : public BaseMergePredicate<ActiveDataPartSet, ReplicatedMergeTreeQueue>
+{
+public:
+    LocalMergePredicate(ReplicatedMergeTreeQueue & queue_);
+};
+
+class ReplicatedMergeTreeMergePredicate : public BaseMergePredicate<ActiveDataPartSet, ReplicatedMergeTreeQueue>
+{
+public:
+    ReplicatedMergeTreeMergePredicate(ReplicatedMergeTreeQueue & queue_, zkutil::ZooKeeperPtr & zookeeper,
+                                      std::optional<PartitionIdsHint> && partition_ids_hint_);
+
     /// Returns true if part is needed for some REPLACE_RANGE entry.
     /// We should not drop part in this case, because replication queue may stuck without that part.
     bool partParticipatesInReplaceRange(const MergeTreeData::DataPartPtr & part, String * out_reason) const;
@@ -561,28 +583,17 @@ public:
     String getCoveringVirtualPart(const String & part_name) const;
 
 private:
-    LocalMergePredicate nested_pred;
-
     const ReplicatedMergeTreeQueue & queue;
 
-    std::optional<PartitionIdsHint> partition_ids_hint;
-
-    /// A snapshot of active parts that would appear if the replica executes all log entries in its queue.
-    ActiveDataPartSet prev_virtual_parts;
-    /// partition ID -> block numbers of the inserts and mutations that are about to commit
-    /// (loaded at some later time than prev_virtual_parts).
-    std::unordered_map<String, std::set<Int64>> committing_blocks;
-
-    /// List of UUIDs for parts that have their identity "pinned".
-    PinnedPartUUIDs pinned_part_uuids;
-
-    /// Quorum state taken at some later time than prev_virtual_parts.
-    String inprogress_quorum_part;
+    /// We copy a merge predicate when we cast it to AllowedMergingPredicate, let's keep the pointers valid
+    std::shared_ptr<ActiveDataPartSet> prev_virtual_parts;
+    std::shared_ptr<CommittingBlocks> committing_blocks;
+    std::shared_ptr<PinnedPartUUIDs> pinned_part_uuids;
+    std::shared_ptr<String> inprogress_quorum_part;
 
     int32_t merges_version = -1;
 };
 
-
 /** Convert a number to a string in the format of the suffixes of auto-incremental nodes in ZooKeeper.
   * Negative numbers are also supported - for them the name of the node looks somewhat silly
   *  and does not match any auto-incremented node in ZK.

From c64f929b9cb57ca171dbe28e82b60a956004daf8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 26 Jun 2023 12:10:58 +0200
Subject: [PATCH 1273/1478] Fix broken labeling for `manual approve`

---
 tests/ci/workflow_approve_rerun_lambda/app.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/ci/workflow_approve_rerun_lambda/app.py b/tests/ci/workflow_approve_rerun_lambda/app.py
index 3db62430d85..1a3874ad01a 100644
--- a/tests/ci/workflow_approve_rerun_lambda/app.py
+++ b/tests/ci/workflow_approve_rerun_lambda/app.py
@@ -224,8 +224,8 @@ def approve_run(workflow_description: WorkflowDescription, token: str) -> None:
 
 
 def label_manual_approve(pull_request, token):
-    url = f"{pull_request['url']}/labels"
-    data = {"labels": "manual approve"}
+    url = f"{pull_request['issue_url']}/labels"
+    data = {"labels": ["manual approve"]}
 
     _exec_post_with_retry(url, token, data)
 

From 065b87aa30d6e6a3f7e64ef3fdfabdc79039a91d Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 26 Jun 2023 12:21:20 +0200
Subject: [PATCH 1274/1478] Improve logging a little bit, avoid double labeling

---
 tests/ci/workflow_approve_rerun_lambda/app.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/tests/ci/workflow_approve_rerun_lambda/app.py b/tests/ci/workflow_approve_rerun_lambda/app.py
index 1a3874ad01a..5e2331ece3c 100644
--- a/tests/ci/workflow_approve_rerun_lambda/app.py
+++ b/tests/ci/workflow_approve_rerun_lambda/app.py
@@ -376,11 +376,10 @@ def main(event):
     changed_files = get_changed_files_for_pull_request(pull_request, token)
     print(f"Totally have {len(changed_files)} changed files in PR:", changed_files)
     if check_suspicious_changed_files(changed_files):
-        print(
-            f"Pull Request {pull_request['number']} has suspicious changes, "
-            "label it for manuall approve"
-        )
-        label_manual_approve(pull_request, token)
+        print(f"Pull Request {pull_request['number']} has suspicious changes")
+        if "manual approve" not in labels:
+            print("Label the PR as needed for manuall approve")
+            label_manual_approve(pull_request, token)
     else:
         print(f"Pull Request {pull_request['number']} has no suspicious changes")
         approve_run(workflow_description, token)

From 9af56624f523b63a078815fc5e31bc16f49821c9 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Mon, 26 Jun 2023 13:30:51 +0200
Subject: [PATCH 1275/1478] Fix flaky test test_skip_empty_files

---
 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 a7293337a9e..6c251d2f84e 100644
--- a/tests/integration/test_storage_s3/test.py
+++ b/tests/integration/test_storage_s3/test.py
@@ -1776,7 +1776,7 @@ def test_skip_empty_files(started_cluster):
     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"
+        f"select * from url('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{11|1|22}}.parquet', auto, 'number UInt64') settings engine_url_skip_empty_files=1"
     )
 
     assert len(res.strip()) == 0

From 7d8d19d8003ebaaac910a6af802ee4874e1821f8 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 26 Jun 2023 14:27:13 +0200
Subject: [PATCH 1276/1478] Add test

---
 .../tests/gtest_lru_file_cache.cpp            | 77 +++++++++++++++++++
 1 file changed, 77 insertions(+)

diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index 3cba1e48e1e..9ff9f92afe4 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -22,6 +22,8 @@
 
 #include <Poco/ConsoleChannel.h>
 #include <Disks/IO/CachedOnDiskWriteBufferFromFile.h>
+#include <Disks/IO/CachedOnDiskReadBufferFromFile.h>
+#include <Disks/IO/createReadBufferFromFileBase.h>
 #include <Interpreters/Cache/WriteBufferToFileSegment.h>
 
 namespace fs = std::filesystem;
@@ -862,3 +864,78 @@ TEST_F(FileCacheTest, temporaryData)
     ASSERT_LE(file_cache.getUsedCacheSize(), size_used_before_temporary_data);
     ASSERT_LE(file_cache.getFileSegmentsNum(), segments_used_before_temporary_data);
 }
+
+TEST_F(FileCacheTest, CachedReadBuffer)
+{
+    DB::ThreadStatus thread_status;
+
+    /// To work with cache need query_id and query context.
+    std::string query_id = "query_id";
+
+    Poco::XML::DOMParser dom_parser;
+    std::string xml(R"CONFIG(<clickhouse>
+</clickhouse>)CONFIG");
+    Poco::AutoPtr<Poco::XML::Document> document = dom_parser.parseString(xml);
+    Poco::AutoPtr<Poco::Util::XMLConfiguration> config = new Poco::Util::XMLConfiguration(document);
+    getMutableContext().context->setConfig(config);
+
+    auto query_context = DB::Context::createCopy(getContext().context);
+    query_context->makeQueryContext();
+    query_context->setCurrentQueryId(query_id);
+    chassert(&DB::CurrentThread::get() == &thread_status);
+    DB::CurrentThread::QueryScope query_scope_holder(query_context);
+
+    DB::FileCacheSettings settings;
+    settings.base_path = cache_base_path;
+    settings.max_file_segment_size = 5;
+    settings.max_size = 30;
+    settings.max_elements = 10;
+    settings.boundary_alignment = 1;
+
+    ReadSettings read_settings;
+    read_settings.enable_filesystem_cache = 1;
+    read_settings.local_fs_method = LocalFSReadMethod::pread;
+
+    std::string file_path = fs::current_path() / "test";
+    auto read_buffer_creator = [&]()
+    {
+        return createReadBufferFromFileBase(file_path, read_settings, std::nullopt, std::nullopt);
+    };
+
+    auto wb = std::make_unique<WriteBufferFromFile>(file_path, DBMS_DEFAULT_BUFFER_SIZE);
+    std::string s(30, '*');
+    wb->write(s.data(), s.size());
+    wb->next();
+    wb->finalize();
+
+    auto cache = std::make_shared<DB::FileCache>(settings);
+    cache->initialize();
+    auto key = cache->createKeyForPath(file_path);
+
+    {
+        auto cached_buffer = std::make_shared<CachedOnDiskReadBufferFromFile>(
+            file_path, key, cache, read_buffer_creator, read_settings, "test", s.size(), false, false, std::nullopt, nullptr);
+
+        WriteBufferFromOwnString result;
+        copyData(*cached_buffer, result);
+        ASSERT_EQ(result.str(), s);
+
+        assertEqual(cache->dumpQueue(), { Range(0, 4), Range(5, 9), Range(10, 14), Range(15, 19), Range(20, 24), Range(25, 29) });
+    }
+
+    {
+        ReadSettings modified_settings{read_settings};
+        modified_settings.local_fs_buffer_size = 10;
+        modified_settings.remote_fs_buffer_size = 10;
+
+        auto cached_buffer = std::make_shared<CachedOnDiskReadBufferFromFile>(
+            file_path, key, cache, read_buffer_creator, modified_settings, "test", s.size(), false, false, std::nullopt, nullptr);
+
+        cached_buffer->next();
+        assertEqual(cache->dumpQueue(), { Range(5, 9), Range(10, 14), Range(15, 19), Range(20, 24), Range(25, 29), Range(0, 4) });
+
+        cached_buffer->position() = cached_buffer->buffer().end();
+        cached_buffer->next();
+        assertEqual(cache->dumpQueue(), {Range(10, 14), Range(15, 19), Range(20, 24), Range(25, 29), Range(0, 4), Range(5, 9) });
+    }
+}

From 179a7ce20263fd3bc50431ee234a99520595aebe Mon Sep 17 00:00:00 2001
From: lgbo-ustc <lgbo.ustc@gmail.com>
Date: Sun, 25 Jun 2023 11:07:15 +0800
Subject: [PATCH 1277/1478] debug

---
 src/Interpreters/GraceHashJoin.cpp | 30 +++++++++++++++++++++++-------
 tests/ci/stress.py                 |  3 +++
 2 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/src/Interpreters/GraceHashJoin.cpp b/src/Interpreters/GraceHashJoin.cpp
index 197b64865e1..4218a8ea4e1 100644
--- a/src/Interpreters/GraceHashJoin.cpp
+++ b/src/Interpreters/GraceHashJoin.cpp
@@ -385,11 +385,23 @@ GraceHashJoin::Buckets GraceHashJoin::rehashBuckets(size_t to_size)
 
 void GraceHashJoin::addBucket(Buckets & destination)
 {
-    auto & left_file = tmp_data->createStream(left_sample_block);
-    auto & right_file = tmp_data->createStream(prepareRightBlock(right_sample_block));
+    // There could be exceptions from createStream, In ci tests
+    // there is a certain probability of failure in allocating memory, see memory_tracker_fault_probability.
+    // It may terminate this thread and leave a broken hash_join, and another thread cores when it tries to
+    // use the broken hash_join. So we print an exception message here to help debug.
+    try
+    {
+        auto & left_file = tmp_data->createStream(left_sample_block);
+        auto & right_file = tmp_data->createStream(prepareRightBlock(right_sample_block));
 
-    BucketPtr new_bucket = std::make_shared<FileBucket>(destination.size(), left_file, right_file, log);
-    destination.emplace_back(std::move(new_bucket));
+        BucketPtr new_bucket = std::make_shared<FileBucket>(destination.size(), left_file, right_file, log);
+        destination.emplace_back(std::move(new_bucket));
+    }
+    catch (...)
+    {
+        LOG_ERROR(&Poco::Logger::get("GraceHashJoin"), "Can't create bucket. current buckets size: {}", destination.size());
+        throw;
+    }
 }
 
 void GraceHashJoin::checkTypesOfKeys(const Block & block) const
@@ -626,7 +638,11 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
     if (current_block.rows() > 0)
     {
         std::lock_guard lock(hash_join_mutex);
-
+        auto current_buckets = getCurrentBuckets();
+        if (!isPowerOf2(current_buckets.size())) [[unlikely]]
+        {
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Broken buckets. its size({}) is not power of 2", current_buckets.size());
+        }
         if (!hash_join)
             hash_join = makeInMemoryJoin();
 
@@ -637,11 +653,11 @@ void GraceHashJoin::addJoinedBlockImpl(Block block)
 
         current_block = {};
 
+        // Must use the latest buckets snapshot in case that it has been rehashed by other threads.
+        buckets_snapshot = rehashBuckets(current_buckets.size() * 2);
         auto right_blocks = hash_join->releaseJoinedBlocks(/* restructure */ false);
         hash_join = nullptr;
 
-        buckets_snapshot = rehashBuckets(buckets_snapshot.size() * 2);
-
         {
             Blocks current_blocks;
             current_blocks.reserve(right_blocks.size());
diff --git a/tests/ci/stress.py b/tests/ci/stress.py
index 1aa483854fc..6d17384c63f 100755
--- a/tests/ci/stress.py
+++ b/tests/ci/stress.py
@@ -38,6 +38,9 @@ def get_options(i, upgrade_check):
             client_options.append("join_algorithm='partial_merge'")
         if join_alg_num % 5 == 2:
             client_options.append("join_algorithm='full_sorting_merge'")
+        if join_alg_num % 5 == 3 and not upgrade_check:
+            # Some crashes are not fixed in 23.2 yet, so ignore the setting in Upgrade check
+            client_options.append("join_algorithm='grace_hash'")
         if join_alg_num % 5 == 4:
             client_options.append("join_algorithm='auto'")
             client_options.append("max_rows_in_join=1000")

From aab86da4e9bc1840d740c00fa02c599a36c3d04c Mon Sep 17 00:00:00 2001
From: lgbo-ustc <lgbo.ustc@gmail.com>
Date: Mon, 26 Jun 2023 20:42:21 +0800
Subject: [PATCH 1278/1478] increase max_bytes_in_join

---
 tests/queries/0_stateless/02275_full_sort_join_long.sql.j2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2 b/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
index 98cc46c9cb4..7276e77dc16 100644
--- a/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
+++ b/tests/queries/0_stateless/02275_full_sort_join_long.sql.j2
@@ -30,7 +30,7 @@ SELECT 'skipped';
 
 {% for join_algorithm in ['full_sorting_merge', 'grace_hash'] -%}
 
-SET max_bytes_in_join = '{% if join_algorithm == 'grace_hash' %}1M{% else %}0{% endif %}';
+SET max_bytes_in_join = '{% if join_algorithm == 'grace_hash' %}16M{% else %}0{% endif %}';
 
 SELECT '-- {{ join_algorithm }} --';
 SET join_algorithm = '{{ join_algorithm }}';

From c4d190617c72436bfeae8563c636ed8e925e1849 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 26 Jun 2023 14:46:51 +0200
Subject: [PATCH 1279/1478] fix flacky test test_profile_events_s3

---
 tests/integration/test_profile_events_s3/test.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/integration/test_profile_events_s3/test.py b/tests/integration/test_profile_events_s3/test.py
index 10c9385f865..de18142d4f6 100644
--- a/tests/integration/test_profile_events_s3/test.py
+++ b/tests/integration/test_profile_events_s3/test.py
@@ -139,7 +139,7 @@ def test_profile_events(cluster):
     )
     stat1 = get_query_stat(instance, query1)
     for metric in stat1:
-        assert stat1[metric] == metrics1[metric] - metrics0[metric]
+        assert stat1[metric] == metrics1.get(metric, 0) - metrics0.get(metric, 0)
     assert (
         metrics1["WriteBufferFromS3Bytes"] - metrics0["WriteBufferFromS3Bytes"] == size1
     )
@@ -163,7 +163,7 @@ def test_profile_events(cluster):
     stat2 = get_query_stat(instance, query2)
 
     for metric in stat2:
-        assert stat2[metric] == metrics2[metric] - metrics1[metric]
+        assert stat2[metric] == metrics2.get(metric, 0)- metrics1.get(metric, 0)
 
     assert (
         metrics2["WriteBufferFromS3Bytes"] - metrics1["WriteBufferFromS3Bytes"]
@@ -189,4 +189,4 @@ def test_profile_events(cluster):
     # With async reads profile events are not updated fully because reads are done in a separate thread.
     # for metric in stat3:
     #    print(metric)
-    #    assert stat3[metric] == metrics3[metric] - metrics2[metric]
+    #    assert stat3[metric] == metrics3.get(metric, 0) - metrics2.get(metric, 0)

From 047f656980f01cc339043c1b5ba225bb6f4ce07e Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 26 Jun 2023 15:04:50 +0200
Subject: [PATCH 1280/1478] add explicit finalize calls

---
 src/Client/QueryFuzzer.cpp                      | 2 +-
 src/Parsers/MySQL/tests/gtest_create_parser.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Client/QueryFuzzer.cpp b/src/Client/QueryFuzzer.cpp
index bfcfe659982..39ca7a5ed88 100644
--- a/src/Client/QueryFuzzer.cpp
+++ b/src/Client/QueryFuzzer.cpp
@@ -1244,7 +1244,7 @@ void QueryFuzzer::fuzzMain(ASTPtr & ast)
     std::cout << std::endl;
     WriteBufferFromOStream ast_buf(std::cout, 4096);
     formatAST(*ast, ast_buf, false /*highlight*/);
-    ast_buf.next();
+    ast_buf.finalize();
     std::cout << std::endl << std::endl;
 }
 
diff --git a/src/Parsers/MySQL/tests/gtest_create_parser.cpp b/src/Parsers/MySQL/tests/gtest_create_parser.cpp
index 554b3f0a67d..2f65eb6e592 100644
--- a/src/Parsers/MySQL/tests/gtest_create_parser.cpp
+++ b/src/Parsers/MySQL/tests/gtest_create_parser.cpp
@@ -40,5 +40,5 @@ TEST(CreateTableParser, SS)
     ASTPtr ast = parseQuery(p_create_query, input.data(), input.data() + input.size(), "", 0, 0);
     WriteBufferFromOStream buf(std::cerr, 4096);
     ast->dumpTree(buf);
-
+    buf.finalize();
 }

From 4fabce9cc85cf649af55c0bb5341dad15aa91231 Mon Sep 17 00:00:00 2001
From: Tyler Hannan <tyler@clickhouse.com>
Date: Mon, 26 Jun 2023 15:10:56 +0200
Subject: [PATCH 1281/1478] Update README.md

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 87fb4920222..eac036c2d9b 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,7 @@ curl https://clickhouse.com/ | sh
 * [**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
+* [**ClickHouse Meetup in Singapore**](https://www.meetup.com/clickhouse-singapore-meetup-group/events/294428050/) - Jul 27
 
 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.
 

From 237805705c0239d3b252b3fa3b59f0214452ccd0 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <104093494+CheSema@users.noreply.github.com>
Date: Mon, 26 Jun 2023 15:44:30 +0200
Subject: [PATCH 1282/1478] Update test.py

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

diff --git a/tests/integration/test_profile_events_s3/test.py b/tests/integration/test_profile_events_s3/test.py
index de18142d4f6..a8e037d667f 100644
--- a/tests/integration/test_profile_events_s3/test.py
+++ b/tests/integration/test_profile_events_s3/test.py
@@ -163,7 +163,7 @@ def test_profile_events(cluster):
     stat2 = get_query_stat(instance, query2)
 
     for metric in stat2:
-        assert stat2[metric] == metrics2.get(metric, 0)- metrics1.get(metric, 0)
+        assert stat2[metric] == metrics2.get(metric, 0) - metrics1.get(metric, 0)
 
     assert (
         metrics2["WriteBufferFromS3Bytes"] - metrics1["WriteBufferFromS3Bytes"]

From d4d85d9fe92430e08c1006f2d6c9d935445473e8 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 26 Jun 2023 16:03:47 +0200
Subject: [PATCH 1283/1478] add explicit finalize calls

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

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 14516bfa939..19b601b9a7b 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -790,7 +790,7 @@ bool Client::processWithFuzzing(const String & full_query)
 
                 WriteBufferFromOStream cerr_buf(std::cerr, 4096);
                 fuzz_base->dumpTree(cerr_buf);
-                cerr_buf.next();
+                cerr_buf.finalize();
 
                 fmt::print(
                     stderr,
@@ -928,7 +928,7 @@ bool Client::processWithFuzzing(const String & full_query)
         std::cout << std::endl;
         WriteBufferFromOStream ast_buf(std::cout, 4096);
         formatAST(*query, ast_buf, false /*highlight*/);
-        ast_buf.next();
+        ast_buf.finalize();
         if (const auto * insert = query->as<ASTInsertQuery>())
         {
             /// For inserts with data it's really useful to have the data itself available in the logs, as formatAST doesn't print it

From e6535b1f875931d46421166897a2a912b6b8a17d Mon Sep 17 00:00:00 2001
From: taiyang-li <654010905@qq.com>
Date: Mon, 26 Jun 2023 22:22:22 +0800
Subject: [PATCH 1284/1478] update libhdfs3 version

---
 contrib/libhdfs3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/libhdfs3 b/contrib/libhdfs3
index 164b89253fa..377220ef351 160000
--- a/contrib/libhdfs3
+++ b/contrib/libhdfs3
@@ -1 +1 @@
-Subproject commit 164b89253fad7991bce77882f01b51ab81d19f3d
+Subproject commit 377220ef351ae24994a5fcd2b5fa3930d00c4db0

From 7cadfeac29c68dc9ac749cd48d115da02ae48f62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Mon, 26 Jun 2023 14:55:03 +0000
Subject: [PATCH 1285/1478] Add retries to flaky tests

---
 tests/integration/test_tlsv1_3/test.py | 67 ++++++++++++++++++--------
 1 file changed, 47 insertions(+), 20 deletions(-)

diff --git a/tests/integration/test_tlsv1_3/test.py b/tests/integration/test_tlsv1_3/test.py
index e25216c67df..a29dcb5fc1c 100644
--- a/tests/integration/test_tlsv1_3/test.py
+++ b/tests/integration/test_tlsv1_3/test.py
@@ -4,6 +4,7 @@ from helpers.ssl_context import WrapSSLContextWithSNI
 import urllib.request, urllib.parse
 import ssl
 import os.path
+import logging
 
 
 # The test cluster is configured with certificate for that host name, see 'server-ext.cnf'.
@@ -11,6 +12,7 @@ import os.path
 SSL_HOST = "integration-tests.clickhouse.com"
 HTTPS_PORT = 8443
 SCRIPT_DIR = os.path.dirname(os.path.realpath(__file__))
+MAX_RETRY = 5
 
 cluster = ClickHouseCluster(__file__)
 instance = cluster.add_instance(
@@ -88,10 +90,18 @@ def test_https_wrong_cert():
         execute_query_https("SELECT currentUser()", user="john", cert_name="client2")
     assert "HTTP Error 403" in str(err.value)
 
+    count = 0
     # Wrong certificate: self-signed certificate.
-    with pytest.raises(Exception) as err:
-        execute_query_https("SELECT currentUser()", user="john", cert_name="wrong")
-    assert "unknown ca" in str(err.value)
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https("SELECT currentUser()", user="john", cert_name="wrong")
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(f"Failed attempt with wrong cert, err: {err_str}")
+            continue
+        assert "unknown ca" in err_str
+        break
 
     # No certificate.
     with pytest.raises(Exception) as err:
@@ -181,24 +191,41 @@ def test_https_non_ssl_auth():
         == "jane\n"
     )
 
+    count = 0
     # However if we send a certificate it must not be wrong.
-    with pytest.raises(Exception) as err:
-        execute_query_https(
-            "SELECT currentUser()",
-            user="peter",
-            enable_ssl_auth=False,
-            cert_name="wrong",
-        )
-    assert "unknown ca" in str(err.value)
-    with pytest.raises(Exception) as err:
-        execute_query_https(
-            "SELECT currentUser()",
-            user="jane",
-            enable_ssl_auth=False,
-            password="qwe123",
-            cert_name="wrong",
-        )
-    assert "unknown ca" in str(err.value)
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https(
+                "SELECT currentUser()",
+                user="peter",
+                enable_ssl_auth=False,
+                cert_name="wrong",
+            )
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(f"Failed attempt with wrong cert, user: peter, err: {err_str}")
+            continue
+        assert "unknown ca" in err_str
+        break
+
+    count = 0
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https(
+                "SELECT currentUser()",
+                user="jane",
+                enable_ssl_auth=False,
+                password="qwe123",
+                cert_name="wrong",
+            )
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(f"Failed attempt with wrong cert, user: jane, err: {err_str}")
+            continue
+        assert "unknown ca" in err_str
+        break
 
 
 def test_create_user():

From 45c263cbb551c27e303f6a050df558ec63a3b463 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 26 Jun 2023 15:00:46 +0000
Subject: [PATCH 1286/1478] Replace try/catch logic in hasTokenOrNull() by sth
 more lightweight

---
 src/Common/StringSearcher.h               | 16 ++++-
 src/Common/Volnitsky.h                    |  3 +-
 src/Functions/HasTokenImpl.h              | 74 +++++++++++------------
 src/Functions/hasToken.cpp                | 12 ++--
 src/Functions/hasTokenCaseInsensitive.cpp |  7 +--
 5 files changed, 59 insertions(+), 53 deletions(-)

diff --git a/src/Common/StringSearcher.h b/src/Common/StringSearcher.h
index ae440f9151b..120a79120bb 100644
--- a/src/Common/StringSearcher.h
+++ b/src/Common/StringSearcher.h
@@ -811,15 +811,24 @@ class TokenSearcher : public StringSearcherBase
     size_t needle_size;
 
 public:
+
+    template <typename CharT>
+    requires (sizeof(CharT) == 1)
+    static bool isValidNeedle(const CharT * needle_, size_t needle_size_)
+    {
+        if (std::any_of(needle_, needle_ + needle_size_, isTokenSeparator))
+            return false;
+        return true;
+    }
+
     template <typename CharT>
     requires (sizeof(CharT) == 1)
     TokenSearcher(const CharT * needle_, size_t needle_size_)
         : searcher(needle_, needle_size_)
         , needle_size(needle_size_)
     {
-        if (std::any_of(needle_, needle_ + needle_size_, isTokenSeparator))
-            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Needle must not contain whitespace or separator characters");
-
+        /// The caller is responsible for calling isValidNeedle()
+        chassert(isValidNeedle(needle_, needle_size_));
     }
 
     template <typename CharT>
@@ -880,6 +889,7 @@ using ASCIICaseSensitiveStringSearcher =   impl::StringSearcher<true, true>;
 using ASCIICaseInsensitiveStringSearcher = impl::StringSearcher<false, true>;
 using UTF8CaseSensitiveStringSearcher =    impl::StringSearcher<true, false>;
 using UTF8CaseInsensitiveStringSearcher =  impl::StringSearcher<false, false>;
+
 using ASCIICaseSensitiveTokenSearcher =    impl::TokenSearcher<ASCIICaseSensitiveStringSearcher>;
 using ASCIICaseInsensitiveTokenSearcher =  impl::TokenSearcher<ASCIICaseInsensitiveStringSearcher>;
 
diff --git a/src/Common/Volnitsky.h b/src/Common/Volnitsky.h
index 64c5bf4c0d3..8f9aa23a38a 100644
--- a/src/Common/Volnitsky.h
+++ b/src/Common/Volnitsky.h
@@ -406,8 +406,7 @@ public:
         /// And also adding from the end guarantees that we will find first occurrence because we will lookup bigger offsets first.
         for (auto i = static_cast<ssize_t>(needle_size - sizeof(VolnitskyTraits::Ngram)); i >= 0; --i)
         {
-            bool ok = VolnitskyTraits::putNGram<CaseSensitive, ASCII>(
-                needle + i, static_cast<int>(i + 1), needle, needle_size, callback);
+            bool ok = VolnitskyTraits::putNGram<CaseSensitive, ASCII>(needle + i, static_cast<int>(i + 1), needle, needle_size, callback);
 
             /** `putNGramUTF8CaseInsensitive` does not work if characters with lower and upper cases
               * are represented by different number of bytes or code points.
diff --git a/src/Functions/HasTokenImpl.h b/src/Functions/HasTokenImpl.h
index 18e629b58fb..8cacdfff99d 100644
--- a/src/Functions/HasTokenImpl.h
+++ b/src/Functions/HasTokenImpl.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <Columns/ColumnString.h>
+#include <Common/StringSearcher.h>
 #include <Core/ColumnNumbers.h>
 
 
@@ -9,6 +10,7 @@ namespace DB
 
 namespace ErrorCodes
 {
+    extern const int BAD_ARGUMENTS;
     extern const int ILLEGAL_COLUMN;
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
 }
@@ -44,51 +46,47 @@ struct HasTokenImpl
         const UInt8 * const end = haystack_data.data() + haystack_data.size();
         const UInt8 * pos = begin;
 
-        try
+        if (!ASCIICaseSensitiveTokenSearcher::isValidNeedle(pattern.data(), pattern.size()))
         {
-            /// Parameter `pattern` is supposed to be a literal of letters and/or numbers.
-            /// Otherwise, an exception from the constructor of `TokenSearcher` is thrown.
-            /// If no exception is thrown at that point, then no further error cases may occur.
-            TokenSearcher searcher(pattern.data(), pattern.size(), end - pos);
             if (res_null)
-                std::ranges::fill(res_null->getData(), false);
-
-            /// The current index in the array of strings.
-            size_t i = 0;
-            /// We will search for the next occurrence in all rows at once.
-            while (pos < end && end != (pos = searcher.search(pos, end - pos)))
-            {
-                /// Let's determine which index it refers to.
-                while (begin + haystack_offsets[i] <= pos)
-                {
-                    res[i] = negate;
-                    ++i;
-                }
-
-                /// We check that the entry does not pass through the boundaries of strings.
-                if (pos + pattern.size() < begin + haystack_offsets[i])
-                    res[i] = !negate;
-                else
-                    res[i] = negate;
-
-                pos = begin + haystack_offsets[i];
-                ++i;
-            }
-
-            /// Tail, in which there can be no substring.
-            if (i < res.size())
-                memset(&res[i], negate, (res.size() - i) * sizeof(res[0]));
-        }
-        catch (...)
-        {
-            if (!res_null)
-                throw;
-            else
             {
                 std::ranges::fill(res, 0);
                 std::ranges::fill(res_null->getData(), true);
+                return;
             }
+            else
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Needle must not contain whitespace or separator characters");
         }
+
+        TokenSearcher searcher(pattern.data(), pattern.size(), end - pos);
+        if (res_null)
+            std::ranges::fill(res_null->getData(), false);
+
+        /// The current index in the array of strings.
+        size_t i = 0;
+        /// We will search for the next occurrence in all rows at once.
+        while (pos < end && end != (pos = searcher.search(pos, end - pos)))
+        {
+            /// Let's determine which index it refers to.
+            while (begin + haystack_offsets[i] <= pos)
+            {
+                res[i] = negate;
+                ++i;
+            }
+
+            /// We check that the entry does not pass through the boundaries of strings.
+            if (pos + pattern.size() < begin + haystack_offsets[i])
+                res[i] = !negate;
+            else
+                res[i] = negate;
+
+            pos = begin + haystack_offsets[i];
+            ++i;
+        }
+
+        /// Tail, in which there can be no substring.
+        if (i < res.size())
+            memset(&res[i], negate, (res.size() - i) * sizeof(res[0]));
     }
 
     template <typename... Args>
diff --git a/src/Functions/hasToken.cpp b/src/Functions/hasToken.cpp
index de67e80e752..b90750ea233 100644
--- a/src/Functions/hasToken.cpp
+++ b/src/Functions/hasToken.cpp
@@ -16,18 +16,18 @@ struct NameHasTokenOrNull
     static constexpr auto name = "hasTokenOrNull";
 };
 
-using FunctionHasToken = DB::FunctionsStringSearch<DB::HasTokenImpl<NameHasToken, DB::VolnitskyCaseSensitiveToken, false>>;
-using FunctionHasTokenOrNull = DB::
-    FunctionsStringSearch<DB::HasTokenImpl<NameHasTokenOrNull, DB::VolnitskyCaseSensitiveToken, false>, DB::ExecutionErrorPolicy::Null>;
+using FunctionHasToken
+    = FunctionsStringSearch<HasTokenImpl<NameHasToken, VolnitskyCaseSensitiveToken, false>>;
+using FunctionHasTokenOrNull
+    = FunctionsStringSearch<HasTokenImpl<NameHasTokenOrNull, VolnitskyCaseSensitiveToken, false>, ExecutionErrorPolicy::Null>;
 
 REGISTER_FUNCTION(HasToken)
 {
     factory.registerFunction<FunctionHasToken>(FunctionDocumentation
-        {.description="Performs lookup of needle in haystack using tokenbf_v1 index."}, DB::FunctionFactory::CaseSensitive);
+        {.description="Performs lookup of needle in haystack using tokenbf_v1 index."}, FunctionFactory::CaseSensitive);
 
     factory.registerFunction<FunctionHasTokenOrNull>(FunctionDocumentation
-        {.description="Performs lookup of needle in haystack using tokenbf_v1 index. Returns null if needle is ill-formed."},
-        DB::FunctionFactory::CaseSensitive);
+        {.description="Performs lookup of needle in haystack using tokenbf_v1 index. Returns null if needle is ill-formed."}, FunctionFactory::CaseSensitive);
 }
 
 }
diff --git a/src/Functions/hasTokenCaseInsensitive.cpp b/src/Functions/hasTokenCaseInsensitive.cpp
index a6e8ecf3e9d..d7381e336b5 100644
--- a/src/Functions/hasTokenCaseInsensitive.cpp
+++ b/src/Functions/hasTokenCaseInsensitive.cpp
@@ -17,10 +17,9 @@ struct NameHasTokenCaseInsensitiveOrNull
 };
 
 using FunctionHasTokenCaseInsensitive
-    = DB::FunctionsStringSearch<DB::HasTokenImpl<NameHasTokenCaseInsensitive, DB::VolnitskyCaseInsensitiveToken, false>>;
-using FunctionHasTokenCaseInsensitiveOrNull = DB::FunctionsStringSearch<
-    DB::HasTokenImpl<NameHasTokenCaseInsensitiveOrNull, DB::VolnitskyCaseInsensitiveToken, false>,
-    DB::ExecutionErrorPolicy::Null>;
+    = FunctionsStringSearch<HasTokenImpl<NameHasTokenCaseInsensitive, VolnitskyCaseInsensitiveToken, false>>;
+using FunctionHasTokenCaseInsensitiveOrNull
+    = FunctionsStringSearch<HasTokenImpl<NameHasTokenCaseInsensitiveOrNull, VolnitskyCaseInsensitiveToken, false>, ExecutionErrorPolicy::Null>;
 
 REGISTER_FUNCTION(HasTokenCaseInsensitive)
 {

From 5de8c4ac679c0c79f0554681a3113be4a5c000d7 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 26 Jun 2023 15:27:05 +0000
Subject: [PATCH 1287/1478] Automatic style fix

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

diff --git a/tests/integration/test_tlsv1_3/test.py b/tests/integration/test_tlsv1_3/test.py
index a29dcb5fc1c..f5c2be51ed7 100644
--- a/tests/integration/test_tlsv1_3/test.py
+++ b/tests/integration/test_tlsv1_3/test.py
@@ -204,7 +204,9 @@ def test_https_non_ssl_auth():
         err_str = str(err.value)
         if count < MAX_RETRY and "Broken pipe" in err_str:
             count = count + 1
-            logging.warning(f"Failed attempt with wrong cert, user: peter, err: {err_str}")
+            logging.warning(
+                f"Failed attempt with wrong cert, user: peter, err: {err_str}"
+            )
             continue
         assert "unknown ca" in err_str
         break
@@ -222,7 +224,9 @@ def test_https_non_ssl_auth():
         err_str = str(err.value)
         if count < MAX_RETRY and "Broken pipe" in err_str:
             count = count + 1
-            logging.warning(f"Failed attempt with wrong cert, user: jane, err: {err_str}")
+            logging.warning(
+                f"Failed attempt with wrong cert, user: jane, err: {err_str}"
+            )
             continue
         assert "unknown ca" in err_str
         break

From 4da82d10d0a7eba0a10fc8f02889d1bd533f7b82 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Mon, 26 Jun 2023 17:57:46 +0200
Subject: [PATCH 1288/1478] Update gtest_lru_file_cache.cpp

---
 src/Interpreters/tests/gtest_lru_file_cache.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index 9ff9f92afe4..58b1302a72c 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -893,7 +893,7 @@ TEST_F(FileCacheTest, CachedReadBuffer)
     settings.boundary_alignment = 1;
 
     ReadSettings read_settings;
-    read_settings.enable_filesystem_cache = 1;
+    read_settings.enable_filesystem_cache = true;
     read_settings.local_fs_method = LocalFSReadMethod::pread;
 
     std::string file_path = fs::current_path() / "test";

From a1eb27ce3038df0921d6667e65074168776988dc Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 26 Jun 2023 18:12:41 +0200
Subject: [PATCH 1289/1478] Update log message

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

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 76d54f9d27c..b65a368b936 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -878,10 +878,11 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
 
     LOG_TEST(
         log,
-        "Current read type: {}, read offset: {}, impl offset: {}, file segment: {}",
+        "Current read type: {}, read offset: {}, impl offset: {}, impl position: {}, file segment: {}",
         toString(read_type),
         file_offset_of_buffer_end,
         implementation_buffer->getFileOffsetOfBufferEnd(),
+        implementation_buffer->getPosition(),
         file_segment.getInfoForLog());
 
     chassert(current_read_range.left <= file_offset_of_buffer_end);
@@ -940,7 +941,8 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
         // We don't support implementation_buffer implementations that use nextimpl_working_buffer_offset.
         chassert(implementation_buffer->position() == implementation_buffer->buffer().begin());
 
-        size = implementation_buffer->buffer().size();
+        if (result)
+            size = implementation_buffer->buffer().size();
 
         LOG_TEST(
             log,
@@ -954,15 +956,21 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
             ProfileEvents::increment(ProfileEvents::CachedReadBufferReadFromCacheBytes, size);
             ProfileEvents::increment(ProfileEvents::CachedReadBufferReadFromCacheMicroseconds, elapsed);
 
-            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 || new_file_offset > file_segment_write_offset)
+            if (result)
             {
-                auto file_segment_path = file_segment.getPathInLocalCache();
-                throw Exception(
-                    ErrorCodes::LOGICAL_ERROR,
-                    "Read unexpected size. File size: {}, file path: {}, file segment info: {}",
-                    fs::file_size(file_segment_path), file_segment_path, file_segment.getInfoForLog());
+                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 || new_file_offset > file_segment_write_offset)
+                {
+                    auto file_segment_path = file_segment.getPathInLocalCache();
+                    throw Exception(
+                        ErrorCodes::LOGICAL_ERROR, "Read unexpected size. "
+                        "File size: {}, file segment path: {}, impl size: {}, impl path: {}"
+                        "file segment info: {}",
+                        fs::file_size(file_segment_path), file_segment_path,
+                        implementation_buffer->getFileSize(), implementation_buffer->getFileName(),
+                        file_segment.getInfoForLog());
+                }
             }
         }
         else

From d8cee8a34c4f3376b64977e222f46bd6abf0ffd5 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 26 Jun 2023 19:00:25 +0200
Subject: [PATCH 1290/1478] Fix style

---
 src/Common/StringSearcher.h | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/src/Common/StringSearcher.h b/src/Common/StringSearcher.h
index 120a79120bb..24b707c97ae 100644
--- a/src/Common/StringSearcher.h
+++ b/src/Common/StringSearcher.h
@@ -21,12 +21,6 @@
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int BAD_ARGUMENTS;
-}
-
-
 /** Variants for searching a substring in a string.
   * In most cases, performance is less than Volnitsky (see Volnitsky.h).
   */

From 1ed33b193628dd69ccfefb7ca343066608399bbb Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 26 Jun 2023 19:22:46 +0200
Subject: [PATCH 1291/1478] Update src/Common/StringSearcher.h

Co-authored-by: ltrk2 <107155950+ltrk2@users.noreply.github.com>
---
 src/Common/StringSearcher.h | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/Common/StringSearcher.h b/src/Common/StringSearcher.h
index 24b707c97ae..ff32218b64b 100644
--- a/src/Common/StringSearcher.h
+++ b/src/Common/StringSearcher.h
@@ -810,9 +810,7 @@ public:
     requires (sizeof(CharT) == 1)
     static bool isValidNeedle(const CharT * needle_, size_t needle_size_)
     {
-        if (std::any_of(needle_, needle_ + needle_size_, isTokenSeparator))
-            return false;
-        return true;
+        return std::none_of(needle_, needle_ + needle_size_, isTokenSeparator));
     }
 
     template <typename CharT>

From 61136680e403ae88469f66157e847168996be786 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 26 Jun 2023 20:05:58 +0200
Subject: [PATCH 1292/1478] Update src/Common/StringSearcher.h

Co-authored-by: ltrk2 <107155950+ltrk2@users.noreply.github.com>
---
 src/Common/StringSearcher.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Common/StringSearcher.h b/src/Common/StringSearcher.h
index ff32218b64b..3ed192d05f3 100644
--- a/src/Common/StringSearcher.h
+++ b/src/Common/StringSearcher.h
@@ -810,7 +810,7 @@ public:
     requires (sizeof(CharT) == 1)
     static bool isValidNeedle(const CharT * needle_, size_t needle_size_)
     {
-        return std::none_of(needle_, needle_ + needle_size_, isTokenSeparator));
+        return std::none_of(needle_, needle_ + needle_size_, isTokenSeparator);
     }
 
     template <typename CharT>

From 01607f0b32291f75d86e55d17a9baa0ef82c1075 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 26 Jun 2023 20:21:25 +0200
Subject: [PATCH 1293/1478] Add check for intersecting ranges

---
 src/Interpreters/Cache/FileCache.cpp | 24 +++++++++++++++++++-----
 src/Interpreters/Cache/FileSegment.h |  2 ++
 src/Interpreters/Cache/Metadata.cpp  | 22 ++++++++++++++++++++++
 src/Interpreters/Cache/Metadata.h    |  2 ++
 4 files changed, 45 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index b601c4029f3..9bd1bc503ff 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -499,12 +499,14 @@ KeyMetadata::iterator FileCache::addFileSegment(
     chassert(size > 0); /// Empty file segments in cache are not allowed.
 
     const auto & key = locked_key.getKey();
-    if (locked_key.tryGetByOffset(offset))
+    const FileSegment::Range range(offset, offset + size - 1);
+
+    if (auto intersecting_range = locked_key.hasIntersectingRange(range))
     {
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
-            "Cache entry already exists for key: `{}`, offset: {}, size: {}.",
-            key, offset, size);
+            "Attempt to add intersecting file segment in cache ({} intersects {})",
+            range.toString(), intersecting_range->toString());
     }
 
     FileSegment::State result_state;
@@ -964,8 +966,20 @@ void FileCache::loadMetadata()
                 if ((main_priority->getSizeLimit() == 0 || main_priority->getSize(lock) + size <= main_priority->getSizeLimit())
                     && (main_priority->getElementsLimit() == 0 || main_priority->getElementsCount(lock) + 1 <= main_priority->getElementsLimit()))
                 {
-                    auto file_segment_metadata_it = addFileSegment(
-                        *locked_key, offset, size, FileSegment::State::DOWNLOADED, CreateFileSegmentSettings(segment_kind), &lock);
+                    KeyMetadata::iterator file_segment_metadata_it;
+                    try
+                    {
+                        file_segment_metadata_it = addFileSegment(
+                            *locked_key, offset, size, FileSegment::State::DOWNLOADED, CreateFileSegmentSettings(segment_kind), &lock);
+                    }
+                    catch (...)
+                    {
+                        tryLogCurrentException(__PRETTY_FUNCTION__);
+                        chassert(false);
+
+                        fs::remove(offset_it->path());
+                        continue;
+                    }
 
                     const auto & file_segment_metadata = file_segment_metadata_it->second;
                     chassert(file_segment_metadata->file_segment->assertCorrectness());
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 681c0d719e4..75053ff5dad 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -134,6 +134,8 @@ public:
 
         bool operator==(const Range & other) const { return left == other.left && right == other.right; }
 
+        bool operator<(const Range & other) const { return right < other.left; }
+
         size_t size() const { return right - left + 1; }
 
         String toString() const { return fmt::format("[{}, {}]", std::to_string(left), std::to_string(right)); }
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index f799bae1e10..5be3bb6490a 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -451,6 +451,28 @@ void LockedKey::shrinkFileSegmentToDownloadedSize(
     chassert(file_segment->assertCorrectnessUnlocked(segment_lock));
 }
 
+std::optional<FileSegment::Range> LockedKey::hasIntersectingRange(const FileSegment::Range & range) const
+{
+    if (key_metadata->empty())
+        return {};
+
+    auto it = key_metadata->lower_bound(range.left);
+    if (it == key_metadata->end())
+    {
+        auto check_range = std::prev(it)->second->file_segment->range();
+        return check_range < range ? std::nullopt : std::optional<FileSegment::Range>(check_range);
+    }
+
+    std::optional<FileSegment::Range> check_range;
+    if (range < (check_range = it->second->file_segment->range())
+        && (it == key_metadata->begin() || (check_range = std::prev(it)->second->file_segment->range()) < range))
+    {
+        return {};
+    }
+
+    return check_range;
+}
+
 std::shared_ptr<const FileSegmentMetadata> LockedKey::getByOffset(size_t offset) const
 {
     auto it = key_metadata->find(offset);
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 635594a289a..8ee40aa977f 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -164,6 +164,8 @@ struct LockedKey : private boost::noncopyable
 
     bool isLastOwnerOfFileSegment(size_t offset) const;
 
+    std::optional<FileSegment::Range> hasIntersectingRange(const FileSegment::Range & range) const;
+
     void removeFromCleanupQueue();
 
     void markAsRemoved();

From 72e407eb06e506a03f3d491e81cf9b8982b469c0 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 26 Jun 2023 20:40:18 +0200
Subject: [PATCH 1294/1478] Better

---
 src/Interpreters/Cache/Metadata.cpp | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 5be3bb6490a..cde11a071f5 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -457,20 +457,21 @@ std::optional<FileSegment::Range> LockedKey::hasIntersectingRange(const FileSegm
         return {};
 
     auto it = key_metadata->lower_bound(range.left);
-    if (it == key_metadata->end())
+    if (it != key_metadata->end()) /// has next range
     {
-        auto check_range = std::prev(it)->second->file_segment->range();
-        return check_range < range ? std::nullopt : std::optional<FileSegment::Range>(check_range);
+        auto next_range = it->second->file_segment->range();
+        if (!(range < next_range))
+            return next_range;
+
+        if (it == key_metadata->begin())
+            return {};
     }
 
-    std::optional<FileSegment::Range> check_range;
-    if (range < (check_range = it->second->file_segment->range())
-        && (it == key_metadata->begin() || (check_range = std::prev(it)->second->file_segment->range()) < range))
-    {
-        return {};
-    }
+    auto prev_range = std::prev(it)->second->file_segment->range();
+    if (!(prev_range < range))
+        return prev_range;
 
-    return check_range;
+    return {};
 }
 
 std::shared_ptr<const FileSegmentMetadata> LockedKey::getByOffset(size_t offset) const

From c01d5ed004bbc64f95a7bfbacba1bda3bf2aa273 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Tue, 27 Jun 2023 00:27:51 +0200
Subject: [PATCH 1295/1478] Fix after review.

---
 src/Interpreters/ProcessList.cpp | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/Interpreters/ProcessList.cpp b/src/Interpreters/ProcessList.cpp
index c8e33b477a1..daa8d434ab6 100644
--- a/src/Interpreters/ProcessList.cpp
+++ b/src/Interpreters/ProcessList.cpp
@@ -593,10 +593,13 @@ QueryStatusInfo QueryStatus::getInfo(bool get_thread_list, bool get_profile_even
             res.profile_counters = std::make_shared<ProfileEvents::Counters::Snapshot>(thread_group->performance_counters.getPartiallyAtomicSnapshot());
     }
 
-    if (get_settings && getContext())
+    if (get_settings)
     {
-        res.query_settings = std::make_shared<Settings>(getContext()->getSettings());
-        res.current_database = getContext()->getCurrentDatabase();
+        if (auto ctx = context.lock())
+        {
+            res.query_settings = std::make_shared<Settings>(ctx->getSettings());
+            res.current_database = ctx->getCurrentDatabase();
+        }
     }
 
     return res;

From bcb106e1385b55b046643b55bb6683a666db81e4 Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Mon, 26 Jun 2023 19:39:47 -0400
Subject: [PATCH 1296/1478] add missing aggregate functions (#51443)

* add missing aggregate functions

* add sparkBar
---
 .../aggregate-functions/reference/index.md    | 20 +++++++++++++++++++
 .../aspell-ignore/en/aspell-dict.txt          |  1 +
 2 files changed, 21 insertions(+)

diff --git a/docs/en/sql-reference/aggregate-functions/reference/index.md b/docs/en/sql-reference/aggregate-functions/reference/index.md
index 17ef494e9ad..6c56aefd51d 100644
--- a/docs/en/sql-reference/aggregate-functions/reference/index.md
+++ b/docs/en/sql-reference/aggregate-functions/reference/index.md
@@ -19,8 +19,19 @@ Standard aggregate functions:
 - [stddevSamp](/docs/en/sql-reference/aggregate-functions/reference/stddevsamp.md)
 - [varPop](/docs/en/sql-reference/aggregate-functions/reference/varpop.md)
 - [varSamp](/docs/en/sql-reference/aggregate-functions/reference/varsamp.md)
+- [corr](./corr.md)
 - [covarPop](/docs/en/sql-reference/aggregate-functions/reference/covarpop.md)
 - [covarSamp](/docs/en/sql-reference/aggregate-functions/reference/covarsamp.md)
+- [entropy](./entropy.md)
+- [exponentialMovingAverage](./exponentialmovingaverage.md)
+- [intervalLengthSum](./intervalLengthSum.md)
+- [kolmogorovSmirnovTest](./kolmogorovsmirnovtest.md)
+- [mannwhitneyutest](./mannwhitneyutest.md)
+- [median](./median.md)
+- [rankCorr](./rankCorr.md)
+- [sumKahan](./sumkahan.md)
+- [studentTTest](./studentttest.md)
+- [welchTTest](./welchttest.md)
 
 ClickHouse-specific aggregate functions:
 
@@ -34,12 +45,15 @@ ClickHouse-specific aggregate functions:
 - [avgWeighted](/docs/en/sql-reference/aggregate-functions/reference/avgweighted.md)
 - [topK](/docs/en/sql-reference/aggregate-functions/reference/topk.md)
 - [topKWeighted](/docs/en/sql-reference/aggregate-functions/reference/topkweighted.md)
+- [deltaSum](./deltasum.md)
+- [deltaSumTimestamp](./deltasumtimestamp.md)
 - [groupArray](/docs/en/sql-reference/aggregate-functions/reference/grouparray.md)
 - [groupArrayLast](/docs/en/sql-reference/aggregate-functions/reference/grouparraylast.md)
 - [groupUniqArray](/docs/en/sql-reference/aggregate-functions/reference/groupuniqarray.md)
 - [groupArrayInsertAt](/docs/en/sql-reference/aggregate-functions/reference/grouparrayinsertat.md)
 - [groupArrayMovingAvg](/docs/en/sql-reference/aggregate-functions/reference/grouparraymovingavg.md)
 - [groupArrayMovingSum](/docs/en/sql-reference/aggregate-functions/reference/grouparraymovingsum.md)
+- [groupArraySample](./grouparraysample.md)
 - [groupBitAnd](/docs/en/sql-reference/aggregate-functions/reference/groupbitand.md)
 - [groupBitOr](/docs/en/sql-reference/aggregate-functions/reference/groupbitor.md)
 - [groupBitXor](/docs/en/sql-reference/aggregate-functions/reference/groupbitxor.md)
@@ -84,3 +98,9 @@ ClickHouse-specific aggregate functions:
 - [theilsU](./theilsu.md)
 - [maxIntersections](./maxintersections.md)
 - [maxIntersectionsPosition](./maxintersectionsposition.md)
+- [meanZTest](./meanztest.md)
+- [quantileGK](./quantileGK.md)
+- [quantileInterpolatedWeighted](./quantileinterpolatedweighted.md)
+- [sparkBar](./sparkbar.md)
+- [sumCount](./sumcount.md)
+
diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index bf988295644..00d047121e6 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -2169,6 +2169,7 @@ snowflakeToDateTime
 socketcache
 soundex
 sparkbar
+sparkBar
 sparsehash
 speedscope
 splitByChar

From 45f40cf2220fd7e37195fbed8d83db7f7cfa75e4 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 27 Jun 2023 04:16:26 +0200
Subject: [PATCH 1297/1478] Update system_warnings test

---
 tests/queries/0_stateless/01945_system_warnings.sh | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/01945_system_warnings.sh b/tests/queries/0_stateless/01945_system_warnings.sh
index bf11cee2911..c9bd0fd4b8a 100755
--- a/tests/queries/0_stateless/01945_system_warnings.sh
+++ b/tests/queries/0_stateless/01945_system_warnings.sh
@@ -21,5 +21,4 @@ ${CLICKHOUSE_CLIENT} --multiple_joins_rewriter_version=42 -q "SELECT message FRO
 ${CLICKHOUSE_CLIENT} -q "SELECT count() = countDistinct(message) FROM system.warnings"
 
 # Avoid too many warnings, especially in CI
-${CLICKHOUSE_CLIENT} -q "SELECT count() < 5 FROM system.warnings"
-
+${CLICKHOUSE_CLIENT} -q "SELECT count() < 10 FROM system.warnings"

From 8c38d10bb4e838a156a2c1031cf2b60548e8cc42 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 27 Jun 2023 05:49:03 +0200
Subject: [PATCH 1298/1478] A fix for clang-17

---
 src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
index 4ad3cc7373a..188956b34fc 100644
--- a/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
+++ b/src/Processors/QueryPlan/ReadFromMemoryStorageStep.cpp
@@ -144,9 +144,9 @@ Pipe ReadFromMemoryStorageStep::makePipe()
             storage_snapshot,
             nullptr /* data */,
             nullptr /* parallel execution index */,
-            [storage = storage](std::shared_ptr<const Blocks> & data_to_initialize)
+            [my_storage = storage](std::shared_ptr<const Blocks> & data_to_initialize)
             {
-                data_to_initialize = static_cast<const StorageMemory &>(*storage).data.get();
+                data_to_initialize = assert_cast<const StorageMemory &>(*my_storage).data.get();
             }));
     }
 

From 9d8b996f684ff5f669db49a616bd3ec3bf0e4c23 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Tue, 27 Jun 2023 04:30:56 +0000
Subject: [PATCH 1299/1478] Automatic style fix

---
 tests/ci/fast_test_check.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ci/fast_test_check.py b/tests/ci/fast_test_check.py
index 7bb09d30177..2849759a3ee 100644
--- a/tests/ci/fast_test_check.py
+++ b/tests/ci/fast_test_check.py
@@ -150,7 +150,7 @@ def main():
         os.makedirs(logs_path)
 
     run_log_path = os.path.join(logs_path, "run.log")
-    with TeePopen(run_cmd, run_log_path, timeout = 90 * 60) as process:
+    with TeePopen(run_cmd, run_log_path, timeout=90 * 60) as process:
         retcode = process.wait()
         if retcode == 0:
             logging.info("Run successfully")

From 76108b955cdab459ba98dd660912f6e90aad57f4 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 27 Jun 2023 07:06:50 +0200
Subject: [PATCH 1300/1478] Fix test 01605_adaptive_granularity_block_borders

---
 .../01605_adaptive_granularity_block_borders.sql           | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/01605_adaptive_granularity_block_borders.sql b/tests/queries/0_stateless/01605_adaptive_granularity_block_borders.sql
index ca7d0f3c950..4623c456475 100644
--- a/tests/queries/0_stateless/01605_adaptive_granularity_block_borders.sql
+++ b/tests/queries/0_stateless/01605_adaptive_granularity_block_borders.sql
@@ -5,9 +5,9 @@ SET allow_prefetched_read_pool_for_remote_filesystem=0;
 
 DROP TABLE IF EXISTS adaptive_table;
 
---- If granularity of consequent blocks differs a lot, then adaptive
---- granularity will adjust amout of marks correctly. Data for test empirically
---- derived, it's quite hard to get good parameters.
+-- If granularity of consequent blocks differs a lot, then adaptive
+-- granularity will adjust the amount of marks correctly.
+-- Data for test was empirically derived, it's quite hard to get good parameters.
 
 CREATE TABLE adaptive_table(
     key UInt64,
@@ -32,6 +32,7 @@ SET enable_filesystem_cache = 0;
 
 -- If we have computed granularity incorrectly than we will exceed this limit.
 SET max_memory_usage='30M';
+SET max_threads = 1;
 
 SELECT max(length(value)) FROM adaptive_table;
 

From b4b21c0cf2e0c9c128a1558b543787297059748a Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Tue, 27 Jun 2023 10:05:14 +0200
Subject: [PATCH 1301/1478] Try fix flaky 02497_storage_file_reader_selection

---
 .../queries/0_stateless/02497_storage_file_reader_selection.sh  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02497_storage_file_reader_selection.sh b/tests/queries/0_stateless/02497_storage_file_reader_selection.sh
index 20bde68718d..66b894404cf 100755
--- a/tests/queries/0_stateless/02497_storage_file_reader_selection.sh
+++ b/tests/queries/0_stateless/02497_storage_file_reader_selection.sh
@@ -7,7 +7,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 DATA_FILE=test_02497_$CLICKHOUSE_TEST_UNIQUE_NAME.tsv
 echo -e 'key\nfoo\nbar' > $DATA_FILE
 
-$CLICKHOUSE_LOCAL --storage_file_read_method=mmap --print-profile-events -q "SELECT * FROM file($DATA_FILE) FORMAT Null" 2>&1 | grep -F -c "CreatedReadBufferMMap"
+$CLICKHOUSE_LOCAL --storage_file_read_method=mmap --print-profile-events -q "SELECT * FROM file($DATA_FILE) FORMAT Null" 2>&1 | grep -F -c "CreatedReadBufferMMap:"
 $CLICKHOUSE_LOCAL --storage_file_read_method=mmap --print-profile-events -q "SELECT * FROM file($DATA_FILE) FORMAT Null" 2>&1 | grep -F -c "CreatedReadBufferOrdinary"
 
 $CLICKHOUSE_LOCAL --storage_file_read_method=pread --print-profile-events -q "SELECT * FROM file($DATA_FILE) FORMAT Null" 2>&1 | grep -F -c "CreatedReadBufferMMap"

From dc2c1a42267ec8c0edf86b3ebbad00d7bc4fa42b Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 27 Jun 2023 13:21:34 +0200
Subject: [PATCH 1302/1478] Convert 02003_memory_limit_in_client from expect to
 sh test (to fix flakiness)

I don't see the reason for using expect here, and plus now the test is
only 2 lines instead.

Also this conversion should fix the test flakiness, since sometimes 60
seconds is not enough [1]:

    2023.06.26 17:42:29.582168 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Debug> executeQuery: Query span trace_id for opentelemetry log: 00000000-0000-0000-0000-000000000000
    2023.06.26 17:42:29.584019 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Debug> executeQuery: (from [::1]:38130) (comment: 02003_memory_limit_in_client.expect) SELECT arrayMap(x -> range(x), range(number)) FROM numbers(1000) (stage: Complete)
    2023.06.26 17:42:29.588131 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Trace> InterpreterSelectQuery: FetchColumns -> Complete
    2023.06.26 17:42:29.780980 [ 2566 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Debug> MemoryTracker: Current memory usage (for query): 1.24 GiB.
    2023.06.26 17:43:29.179098 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Information> TCPHandler: Client has dropped the connection, cancel the query.
    2023.06.26 17:44:05.523345 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Information> executeQuery: Code: 394. DB::Exception: Query was cancelled or a client has unexpectedly dropped the connection. (QUERY_WAS_CANCELLED) (version 23.6.1.1) (from [::1]:38130) (comment: 02003_memory_limit_in_client.expect) (in query: SELECT arrayMap(x -> range(x), range(number)) FROM numbers(1000))
    2023.06.26 17:44:05.680631 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Debug> MemoryTracker: Peak memory usage (for query): 1.25 GiB.
    2023.06.26 17:44:05.680747 [ 13456 ] {8a324061-a504-4843-be65-6abb5db4bc5c} <Debug> TCPHandler: Processed in 96.108615451 sec.

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/51407/e92035072b7b3367da12089b28041893eb90e636/stateless_tests__tsan__[2_5].html

And it is either expect is too slow, or server did not respond for
awhile, but this was a TSan build and trace_log is empty, so it is not
possible to check which one was the problem.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../02003_memory_limit_in_client.expect       | 64 -------------------
 .../02003_memory_limit_in_client.reference    |  1 +
 .../02003_memory_limit_in_client.sh           |  8 +++
 3 files changed, 9 insertions(+), 64 deletions(-)
 delete mode 100755 tests/queries/0_stateless/02003_memory_limit_in_client.expect
 create mode 100755 tests/queries/0_stateless/02003_memory_limit_in_client.sh

diff --git a/tests/queries/0_stateless/02003_memory_limit_in_client.expect b/tests/queries/0_stateless/02003_memory_limit_in_client.expect
deleted file mode 100755
index 377656fa641..00000000000
--- a/tests/queries/0_stateless/02003_memory_limit_in_client.expect
+++ /dev/null
@@ -1,64 +0,0 @@
-#!/usr/bin/expect -f
-
-# This is a test for system.warnings. Testing in interactive mode is necessary,
-# as we want to see certain warnings from client
-
-set basedir [file dirname $argv0]
-set basename [file tail $argv0]
-exp_internal -f $env(CLICKHOUSE_TMP)/$basename.debuglog 0
-set history_file $env(CLICKHOUSE_TMP)/$basename.history
-
-log_user 0
-set timeout 60
-match_max 100000
-
-expect_after {
-    # Do not ignore eof from expect
-    -i $any_spawn_id eof { exp_continue }
-    # A default timeout action is to do nothing, change it to fail
-    -i $any_spawn_id timeout { exit 1 }
-}
-
-#
-# Check that the query will fail in clickhouse-client
-#
-spawn bash -c "source $basedir/../shell_config.sh ; \$CLICKHOUSE_CLIENT_BINARY \$CLICKHOUSE_CLIENT_OPT --disable_suggestion --max_memory_usage_in_client=1 --history_file=$history_file"
-expect ":) "
-
-send  -- "SELECT arrayMap(x -> range(x), range(number)) FROM numbers(1000)\r"
-expect "Code: 241"
-
-expect ":) "
-
-# Exit.
-send -- "\4"
-expect eof
-
-#
-# Check that the query will fail in clickhouse-client
-#
-spawn bash -c "source $basedir/../shell_config.sh ; \$CLICKHOUSE_CLIENT_BINARY \$CLICKHOUSE_CLIENT_OPT --disable_suggestion --max_memory_usage_in_client=1 --history_file=$history_file"
-expect ":) "
-
-send  -- "SELECT arrayMap(x -> range(x), range(number)) FROM numbers(1000)\r"
-expect "Code: 241"
-
-expect ":) "
-
-# Exit.
-send -- "\4"
-expect eof
-
-#
-# Check that the query will not fail (due to max_untracked_memory)
-#
-spawn bash -c "source $basedir/../shell_config.sh ; \$CLICKHOUSE_CLIENT_BINARY \$CLICKHOUSE_CLIENT_OPT --disable_suggestion --max_memory_usage_in_client=1 --history_file=$history_file"
-expect ":) "
-
-send  -- "SELECT * FROM (SELECT * FROM system.numbers LIMIT 600000) as num WHERE num.number=60000\r"
-expect "60000"
-expect ":) "
-
-# Exit.
-send -- "\4"
-expect eof
diff --git a/tests/queries/0_stateless/02003_memory_limit_in_client.reference b/tests/queries/0_stateless/02003_memory_limit_in_client.reference
index e69de29bb2d..541b3a18e90 100644
--- a/tests/queries/0_stateless/02003_memory_limit_in_client.reference
+++ b/tests/queries/0_stateless/02003_memory_limit_in_client.reference
@@ -0,0 +1 @@
+60000
diff --git a/tests/queries/0_stateless/02003_memory_limit_in_client.sh b/tests/queries/0_stateless/02003_memory_limit_in_client.sh
new file mode 100755
index 00000000000..2d2493828c8
--- /dev/null
+++ b/tests/queries/0_stateless/02003_memory_limit_in_client.sh
@@ -0,0 +1,8 @@
+#!/usr/bin/bash -f
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT --max_memory_usage_in_client=1 -n -q "SELECT arrayMap(x -> range(x), range(number)) FROM numbers(1000) -- { clientError MEMORY_LIMIT_EXCEEDED }"
+$CLICKHOUSE_CLIENT --max_memory_usage_in_client=0 -n -q "SELECT * FROM (SELECT * FROM system.numbers LIMIT 600000) as num WHERE num.number=60000"

From acea2d66f0c4abad3c700ef2153977a5bcfba819 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 27 Jun 2023 13:40:07 +0200
Subject: [PATCH 1303/1478] Fix

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

diff --git a/tests/integration/test_disk_over_web_server/test.py b/tests/integration/test_disk_over_web_server/test.py
index 719de5e8bef..d62adfb3343 100644
--- a/tests/integration/test_disk_over_web_server/test.py
+++ b/tests/integration/test_disk_over_web_server/test.py
@@ -45,6 +45,8 @@ def cluster():
                 f"CREATE TABLE data{i} (id Int32) ENGINE = MergeTree() ORDER BY id SETTINGS storage_policy = 'def', min_bytes_for_wide_part=1;"
             )
 
+            node.query("SYSTEM STOP MERGES")
+
             for _ in range(10):
                 node.query(
                     f"INSERT INTO data{i} SELECT number FROM numbers(500000 * {i+1})"

From d4c8021f8078425ae3e7a74e32477f78307a0999 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Tue, 27 Jun 2023 12:41:21 +0000
Subject: [PATCH 1304/1478] Extend consistency check for ColumnObject

+ check that there arer subcolumns when there are rows
---
 src/Columns/ColumnObject.cpp                       | 14 ++++++++++++--
 .../02789_object_type_invalid_num_of_rows.sql      |  2 +-
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/src/Columns/ColumnObject.cpp b/src/Columns/ColumnObject.cpp
index 07872774559..4fa0c3ee41a 100644
--- a/src/Columns/ColumnObject.cpp
+++ b/src/Columns/ColumnObject.cpp
@@ -626,6 +626,9 @@ ColumnObject::ColumnObject(Subcolumns && subcolumns_, bool is_nullable_)
 
 void ColumnObject::checkConsistency() const
 {
+    if (num_rows && subcolumns.empty())
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "ColumnObject is inconsistent: it has no subcolumns, but has {} rows", num_rows);
+
     if (subcolumns.empty())
         return;
 
@@ -642,9 +645,9 @@ void ColumnObject::checkConsistency() const
 
 size_t ColumnObject::size() const
 {
-#ifndef NDEBUG
+// #ifndef NDEBUG
     checkConsistency();
-#endif
+// #endif
     return num_rows;
 }
 
@@ -711,6 +714,8 @@ void ColumnObject::insert(const Field & field)
     }
 
     ++num_rows;
+
+    checkConsistency();
 }
 
 void ColumnObject::insertDefault()
@@ -719,6 +724,8 @@ void ColumnObject::insertDefault()
         entry->data.insertDefault();
 
     ++num_rows;
+
+    checkConsistency();
 }
 
 Field ColumnObject::operator[](size_t n) const
@@ -776,6 +783,8 @@ void ColumnObject::insertRangeFrom(const IColumn & src, size_t start, size_t len
 
     num_rows += length;
     finalize();
+
+    checkConsistency();
 }
 
 void ColumnObject::popBack(size_t length)
@@ -784,6 +793,7 @@ void ColumnObject::popBack(size_t length)
         entry->data.popBack(length);
 
     num_rows -= length;
+    checkConsistency();
 }
 
 template <typename Func>
diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
index 8ced133c8eb..a9c8a844aa0 100644
--- a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
+++ b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
@@ -1,2 +1,2 @@
 set allow_experimental_object_type=1;
-SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST(CAST('{"x" : 1}', 'Object(Nullable(\'json\'))'), 'Object(\'json\')'))) settings max_threads=1; -- { serverError NOT_IMPLEMENTED }
+SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST('{"x" : 1}', 'Object(\'json\')'))) settings max_threads=1; -- { serverError NOT_IMPLEMENTED }

From 46a69829ff5a50867c21013b2ae9d28f2331876e Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 27 Jun 2023 15:04:47 +0200
Subject: [PATCH 1305/1478] Delay shutdown of system and temporary databases

---
 src/Interpreters/DatabaseCatalog.cpp | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index 8d3fa91a7fe..9a96bd09d82 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -216,8 +216,22 @@ void DatabaseCatalog::shutdownImpl()
 
     /// We still hold "databases" (instead of std::move) for Buffer tables to flush data correctly.
 
+    /// Delay shutdown of temporary and system databases. They will be shutdown last.
+    std::vector<DatabasePtr> databases_with_delayed_shutdown;
     for (auto & database : current_databases)
+    {
+        if (database.first == TEMPORARY_DATABASE || database.first == SYSTEM_DATABASE)
+        {
+            databases_with_delayed_shutdown.push_back(database.second);
+            continue;
+        }
         database.second->shutdown();
+    }
+
+    for (auto & database : databases_with_delayed_shutdown)
+    {
+        database->shutdown();
+    }
 
     {
         std::lock_guard lock(tables_marked_dropped_mutex);

From 89de7a64eb3d36c3cbfed7388338e7352d216c78 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Tue, 27 Jun 2023 15:06:31 +0200
Subject: [PATCH 1306/1478] Fix memory leakage in CompressionCodecDeflateQpl.

---
 src/Compression/CompressionCodecDeflateQpl.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Compression/CompressionCodecDeflateQpl.cpp b/src/Compression/CompressionCodecDeflateQpl.cpp
index 4a2866d152d..859a9c2463a 100644
--- a/src/Compression/CompressionCodecDeflateQpl.cpp
+++ b/src/Compression/CompressionCodecDeflateQpl.cpp
@@ -9,6 +9,7 @@
 #include <Common/logger_useful.h>
 #include "libaccel_config.h"
 #include <Common/MemorySanitizer.h>
+#include <base/scope_guard.h>
 
 namespace DB
 {
@@ -34,6 +35,7 @@ DeflateQplJobHWPool::DeflateQplJobHWPool()
     // loop all configured workqueue size to get maximum job number.
     accfg_ctx * ctx_ptr = nullptr;
     auto ctx_status = accfg_new(&ctx_ptr);
+    SCOPE_EXIT({ accfg_unref(ctx_ptr); });
     if (ctx_status == 0)
     {
         auto * dev_ptr = accfg_device_get_first(ctx_ptr);

From ddca9ece501e7e5554fbf439008f990997c7f2d1 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 27 Jun 2023 15:32:14 +0200
Subject: [PATCH 1307/1478] Increase retries

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

diff --git a/tests/integration/test_multiple_disks/test.py b/tests/integration/test_multiple_disks/test.py
index 54e7f6dd8ee..b5606ee8bc2 100644
--- a/tests/integration/test_multiple_disks/test.py
+++ b/tests/integration/test_multiple_disks/test.py
@@ -846,7 +846,7 @@ def test_start_stop_moves(start_cluster, name, engine):
         node1.query("SYSTEM START MOVES {}".format(name))
 
         # wait sometime until background backoff finishes
-        retry = 30
+        retry = 60
         i = 0
         while not sum(1 for x in used_disks if x == "jbod1") <= 2 and i < retry:
             time.sleep(1)

From 99c9830737941e133814c75cd811ce4c5576b4fa Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 27 Jun 2023 13:34:58 +0000
Subject: [PATCH 1308/1478] Docs: Add more blog posts to join docs

---
 docs/en/sql-reference/statements/select/join.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/sql-reference/statements/select/join.md b/docs/en/sql-reference/statements/select/join.md
index 08ffae838f8..7971b3ba275 100644
--- a/docs/en/sql-reference/statements/select/join.md
+++ b/docs/en/sql-reference/statements/select/join.md
@@ -21,6 +21,9 @@ Expressions from `ON` clause and columns from `USING` clause are called “join
 ## Related Content
 
 - Blog: [ClickHouse: A Blazingly Fast DBMS with Full SQL Join Support - Part 1](https://clickhouse.com/blog/clickhouse-fully-supports-joins)
+- Blog: [ClickHouse: A Blazingly Fast DBMS with Full SQL Join Support - Under the Hood - Part 2](https://clickhouse.com/blog/clickhouse-fully-supports-joins-hash-joins-part2)
+- Blog: [ClickHouse: A Blazingly Fast DBMS with Full SQL Join Support - Under the Hood - Part 3](https://clickhouse.com/blog/clickhouse-fully-supports-joins-full-sort-partial-merge-part3)
+- Blog: [ClickHouse: A Blazingly Fast DBMS with Full SQL Join Support - Under the Hood - Part 4](https://clickhouse.com/blog/clickhouse-fully-supports-joins-direct-join-part4)
 
 ## Supported Types of JOIN
 

From 648b647f5f878c4da0265cfae3dc39e50021170b Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 27 Jun 2023 15:49:26 +0200
Subject: [PATCH 1309/1478] Fix race

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

diff --git a/src/IO/BoundedReadBuffer.h b/src/IO/BoundedReadBuffer.h
index 183dbedb78b..eb65857e83a 100644
--- a/src/IO/BoundedReadBuffer.h
+++ b/src/IO/BoundedReadBuffer.h
@@ -31,7 +31,8 @@ public:
 
 private:
     std::optional<size_t> read_until_position;
-    size_t file_offset_of_buffer_end = 0;
+    /// atomic because can be used in log or exception messages while being updated.
+    std::atomic<size_t> file_offset_of_buffer_end = 0;
 };
 
 }

From b8866e01286c4e1adeb10554b823eb1a79b9119c Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 27 Jun 2023 16:11:27 +0200
Subject: [PATCH 1310/1478] Fix flaky unit test

---
 src/Interpreters/tests/gtest_lru_file_cache.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index 3cba1e48e1e..429f940a7c7 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -475,7 +475,7 @@ TEST_F(FileCacheTest, get)
                 }
                 cv.notify_one();
 
-                file_segment2.wait(file_segment2.range().left);
+                file_segment2.wait(file_segment2.range().right);
                 file_segment2.complete();
                 ASSERT_TRUE(file_segment2.state() == State::DOWNLOADED);
             });

From fe9702192961fe2073713d9b9f033c6177666d22 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Tue, 27 Jun 2023 16:54:14 +0200
Subject: [PATCH 1311/1478] add missing finalize calls in buffers

---
 src/BridgeHelper/ExternalDictionaryLibraryBridgeHelper.cpp | 1 +
 src/Dictionaries/HTTPDictionarySource.cpp                  | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/src/BridgeHelper/ExternalDictionaryLibraryBridgeHelper.cpp b/src/BridgeHelper/ExternalDictionaryLibraryBridgeHelper.cpp
index 284e7740a58..fcb8ebd1f22 100644
--- a/src/BridgeHelper/ExternalDictionaryLibraryBridgeHelper.cpp
+++ b/src/BridgeHelper/ExternalDictionaryLibraryBridgeHelper.cpp
@@ -239,6 +239,7 @@ QueryPipeline ExternalDictionaryLibraryBridgeHelper::loadKeys(const Block & requ
         WriteBufferFromOStream out_buffer(os);
         auto output_format = getContext()->getOutputFormat(ExternalDictionaryLibraryBridgeHelper::DEFAULT_FORMAT, out_buffer, requested_block.cloneEmpty());
         formatBlock(output_format, requested_block);
+        out_buffer.finalize();
     };
     return QueryPipeline(loadBase(uri, out_stream_callback));
 }
diff --git a/src/Dictionaries/HTTPDictionarySource.cpp b/src/Dictionaries/HTTPDictionarySource.cpp
index 757a3b1819b..55bff868dee 100644
--- a/src/Dictionaries/HTTPDictionarySource.cpp
+++ b/src/Dictionaries/HTTPDictionarySource.cpp
@@ -135,6 +135,7 @@ QueryPipeline HTTPDictionarySource::loadIds(const std::vector<UInt64> & ids)
         WriteBufferFromOStream out_buffer(ostr);
         auto output_format = context->getOutputFormatParallelIfPossible(configuration.format, out_buffer, block.cloneEmpty());
         formatBlock(output_format, block);
+        out_buffer.finalize();
     };
 
     Poco::URI uri(configuration.url);
@@ -164,6 +165,7 @@ QueryPipeline HTTPDictionarySource::loadKeys(const Columns & key_columns, const
         WriteBufferFromOStream out_buffer(ostr);
         auto output_format = context->getOutputFormatParallelIfPossible(configuration.format, out_buffer, block.cloneEmpty());
         formatBlock(output_format, block);
+        out_buffer.finalize();
     };
 
     Poco::URI uri(configuration.url);

From 98721ca36c87379e6899837b46cf4b9b5810a969 Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <nikitamikhaylov@clickhouse.com>
Date: Tue, 27 Jun 2023 16:44:50 +0000
Subject: [PATCH 1312/1478] New epoch


From 0b6d367bdbe73e1ea9b1f179f315cba2185ffe94 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Tue, 27 Jun 2023 17:14:49 +0000
Subject: [PATCH 1313/1478] Parts mover: lock between getActiveContainingPart
 and swapActivePart

---
 src/Storages/MergeTree/MergeTreeData.cpp       | 9 +++++++--
 src/Storages/MergeTree/MergeTreeData.h         | 3 ++-
 src/Storages/MergeTree/MergeTreePartsMover.cpp | 7 +++++--
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index e9c3a7f66ae..5e17559acc0 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -4529,9 +4529,8 @@ MergeTreeData::DataPartPtr MergeTreeData::getActiveContainingPart(
 }
 
 
-void MergeTreeData::swapActivePart(MergeTreeData::DataPartPtr part_copy)
+void MergeTreeData::swapActivePart(MergeTreeData::DataPartPtr part_copy, DataPartsLock &)
 {
-    auto lock = lockParts();
     for (auto original_active_part : getDataPartsStateRange(DataPartState::Active)) // NOLINT (copy is intended)
     {
         if (part_copy->name == original_active_part->name)
@@ -4587,6 +4586,12 @@ MergeTreeData::DataPartPtr MergeTreeData::getActiveContainingPart(const String &
     return getActiveContainingPart(part_info);
 }
 
+MergeTreeData::DataPartPtr MergeTreeData::getActiveContainingPart(const String & part_name, DataPartsLock & lock) const
+{
+    auto part_info = MergeTreePartInfo::fromPartName(part_name, format_version);
+    return getActiveContainingPart(part_info, DataPartState::Active, lock);
+}
+
 MergeTreeData::DataPartsVector MergeTreeData::getVisibleDataPartsVectorInPartition(ContextPtr local_context, const String & partition_id) const
 {
     return getVisibleDataPartsVectorInPartition(local_context->getCurrentTransaction().get(), partition_id);
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index b27392b355b..c821a436a76 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -504,12 +504,13 @@ public:
 
     /// Returns a part in Active state with the given name or a part containing it. If there is no such part, returns nullptr.
     DataPartPtr getActiveContainingPart(const String & part_name) const;
+    DataPartPtr getActiveContainingPart(const String & part_name, DataPartsLock & lock) const;
     DataPartPtr getActiveContainingPart(const MergeTreePartInfo & part_info) const;
     DataPartPtr getActiveContainingPart(const MergeTreePartInfo & part_info, DataPartState state, DataPartsLock & lock) const;
 
     /// Swap part with it's identical copy (possible with another path on another disk).
     /// If original part is not active or doesn't exist exception will be thrown.
-    void swapActivePart(MergeTreeData::DataPartPtr part_copy);
+    void swapActivePart(MergeTreeData::DataPartPtr part_copy, DataPartsLock &);
 
     /// Returns all parts in specified partition
     DataPartsVector getVisibleDataPartsVectorInPartition(MergeTreeTransaction * txn, const String & partition_id, DataPartsLock * acquired_lock = nullptr) const;
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.cpp b/src/Storages/MergeTree/MergeTreePartsMover.cpp
index 8fa4ac6c78a..a8f34ba4cec 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.cpp
+++ b/src/Storages/MergeTree/MergeTreePartsMover.cpp
@@ -263,7 +263,10 @@ void MergeTreePartsMover::swapClonedPart(TemporaryClonedPart & cloned_part) cons
     if (moves_blocker.isCancelled())
         throw Exception(ErrorCodes::ABORTED, "Cancelled moving parts.");
 
-    auto active_part = data->getActiveContainingPart(cloned_part.part->name);
+    /// `getActiveContainingPart` and `swapActivePart` are called under the same lock
+    /// to prevent part becoming inactive between calls
+    auto part_lock = data->lockParts();
+    auto active_part = data->getActiveContainingPart(cloned_part.part->name, part_lock);
 
     /// It's ok, because we don't block moving parts for merges or mutations
     if (!active_part || active_part->name != cloned_part.part->name)
@@ -284,7 +287,7 @@ void MergeTreePartsMover::swapClonedPart(TemporaryClonedPart & cloned_part) cons
     cloned_part.part->renameTo(active_part->name, false);
 
     /// TODO what happen if server goes down here?
-    data->swapActivePart(cloned_part.part);
+    data->swapActivePart(cloned_part.part, part_lock);
 
     LOG_TRACE(log, "Part {} was moved to {}", cloned_part.part->name, cloned_part.part->getDataPartStorage().getFullPath());
 

From 79b6792548c065d6795c5a167b29da44aa91dae7 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Tue, 27 Jun 2023 17:15:11 +0000
Subject: [PATCH 1314/1478] Enable allow_remove_stale_moving_parts for
 stateless tests

---
 tests/config/config.d/merge_tree_old_dirs_cleanup.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/config/config.d/merge_tree_old_dirs_cleanup.xml b/tests/config/config.d/merge_tree_old_dirs_cleanup.xml
index 2b8ea63b63d..e6b50724c97 100644
--- a/tests/config/config.d/merge_tree_old_dirs_cleanup.xml
+++ b/tests/config/config.d/merge_tree_old_dirs_cleanup.xml
@@ -5,4 +5,5 @@
         <!-- Default is 60 seconds, but let's make tests more aggressive -->
         <merge_tree_clear_old_temporary_directories_interval_seconds>5</merge_tree_clear_old_temporary_directories_interval_seconds>
     </merge_tree>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>

From d3b8b454f853c63da4b94ec97afdcb1528ffdc22 Mon Sep 17 00:00:00 2001
From: Ilya Yatsishin <2159081+qoega@users.noreply.github.com>
Date: Tue, 27 Jun 2023 19:19:58 +0200
Subject: [PATCH 1315/1478] Fix segfault in MathUnary

---
 src/Functions/FunctionMathUnary.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Functions/FunctionMathUnary.h b/src/Functions/FunctionMathUnary.h
index 6e4bff7122d..9f400932356 100644
--- a/src/Functions/FunctionMathUnary.h
+++ b/src/Functions/FunctionMathUnary.h
@@ -154,6 +154,8 @@ private:
             using ColVecType = ColumnVectorOrDecimal<Type>;
 
             const auto col_vec = checkAndGetColumn<ColVecType>(col.column.get());
+            if (col_vec == nullptr)
+                return false;
             return (res = execute<Type, ReturnType>(col_vec)) != nullptr;
         };
 

From 5a39960e0374f355b22260bea1095676b50e92c6 Mon Sep 17 00:00:00 2001
From: Nikifor Seriakov <nikandfor@gmail.com>
Date: Tue, 27 Jun 2023 21:32:39 +0400
Subject: [PATCH 1316/1478] Update docs/en/interfaces/formats.md

Fixed RawBLOB comparison lists formatting.
---
 docs/en/interfaces/formats.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 79baf04d75d..378a1c46d93 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -2454,18 +2454,22 @@ In this format, all input data is read to a single value. It is possible to pars
 The result is output in binary format without delimiters and escaping. If more than one value is output, the format is ambiguous, and it will be impossible to read the data back.
 
 Below is a comparison of the formats `RawBLOB` and [TabSeparatedRaw](#tabseparatedraw).
+
 `RawBLOB`:
 - data is output in binary format, no escaping;
 - there are no delimiters between values;
 - no newline at the end of each value.
-[TabSeparatedRaw] (#tabseparatedraw):
+
+`TabSeparatedRaw`:
 - data is output without escaping;
 - the rows contain values separated by tabs;
 - there is a line feed after the last value in every row.
 
 The following is a comparison of the `RawBLOB` and [RowBinary](#rowbinary) formats.
+
 `RawBLOB`:
 - String fields are output without being prefixed by length.
+
 `RowBinary`:
 - String fields are represented as length in varint format (unsigned [LEB128] (https://en.wikipedia.org/wiki/LEB128)), followed by the bytes of the string.
 

From f5327e79bb37c3cc061b8704ffdb85aa4f0b31c4 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 27 Jun 2023 20:18:38 +0200
Subject: [PATCH 1317/1478] fix a logical error on mutation

---
 src/Storages/MergeTree/IMergeTreeDataPart.cpp |  1 +
 src/Storages/MergeTree/IMergeTreeDataPart.h   |  3 +++
 src/Storages/MergeTree/MutateTask.cpp         | 16 +++++++++-------
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index cf2d1b19326..85edba84296 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -1362,6 +1362,7 @@ void IMergeTreeDataPart::loadColumns(bool require)
     else
     {
         loaded_metadata_version = metadata_snapshot->getMetadataVersion();
+        old_part_with_no_metadata_version_on_disk = true;
     }
 
     setColumns(loaded_columns, infos, loaded_metadata_version);
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.h b/src/Storages/MergeTree/IMergeTreeDataPart.h
index fd73d802579..6dd82493398 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.h
@@ -249,6 +249,9 @@ public:
     /// Flag for keep S3 data when zero-copy replication over S3 turned on.
     mutable bool force_keep_shared_data = false;
 
+    /// Some old parts don't have metadata version, so we set it to the current table's version when loading the part
+    bool old_part_with_no_metadata_version_on_disk = false;
+
     using TTLInfo = MergeTreeDataPartTTLInfo;
     using TTLInfos = MergeTreeDataPartTTLInfos;
 
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index b98b0844ee7..a19b9daca0e 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -153,20 +153,22 @@ static void splitAndModifyMutationCommands(
                     /// But we don't know for sure what happened.
                     auto part_metadata_version = part->getMetadataVersion();
                     auto table_metadata_version = metadata_snapshot->getMetadataVersion();
-                    /// StorageMergeTree does not have metadata version
-                    if (table_metadata_version <= part_metadata_version && part->storage.supportsReplication())
-                        throw Exception(ErrorCodes::LOGICAL_ERROR, "Part {} with metadata version {} contains column {} that is absent "
-                                        "in table {} with metadata version {}",
-                                        part->name, part_metadata_version, column.name,
-                                        part->storage.getStorageID().getNameForLogs(), table_metadata_version);
 
-                    if (part_metadata_version < table_metadata_version)
+                    bool allow_equal_versions = part_metadata_version == table_metadata_version && part->old_part_with_no_metadata_version_on_disk;
+                    if (part_metadata_version < table_metadata_version || allow_equal_versions)
                     {
                         LOG_WARNING(log, "Ignoring column {} from part {} with metadata version {} because there is no such column "
                                          "in table {} with metadata version {}. Assuming the column was dropped", column.name, part->name,
                                     part_metadata_version, part->storage.getStorageID().getNameForLogs(), table_metadata_version);
                         continue;
                     }
+
+                    /// StorageMergeTree does not have metadata version
+                    if (part->storage.supportsReplication())
+                        throw Exception(ErrorCodes::LOGICAL_ERROR, "Part {} with metadata version {} contains column {} that is absent "
+                                        "in table {} with metadata version {}",
+                                        part->name, part_metadata_version, column.name,
+                                        part->storage.getStorageID().getNameForLogs(), table_metadata_version);
                 }
 
                 for_interpreter.emplace_back(

From 575f3513977a21a8fea5ff30116636f2fc9ac2f1 Mon Sep 17 00:00:00 2001
From: Yatsishin Ilya <2159081+qoega@users.noreply.github.com>
Date: Tue, 27 Jun 2023 18:34:12 +0000
Subject: [PATCH 1318/1478] add test

---
 tests/queries/0_stateless/02807_math_unary_crash.reference | 2 ++
 tests/queries/0_stateless/02807_math_unary_crash.sql       | 4 ++++
 2 files changed, 6 insertions(+)
 create mode 100644 tests/queries/0_stateless/02807_math_unary_crash.reference
 create mode 100644 tests/queries/0_stateless/02807_math_unary_crash.sql

diff --git a/tests/queries/0_stateless/02807_math_unary_crash.reference b/tests/queries/0_stateless/02807_math_unary_crash.reference
new file mode 100644
index 00000000000..6ed281c757a
--- /dev/null
+++ b/tests/queries/0_stateless/02807_math_unary_crash.reference
@@ -0,0 +1,2 @@
+1
+1
diff --git a/tests/queries/0_stateless/02807_math_unary_crash.sql b/tests/queries/0_stateless/02807_math_unary_crash.sql
new file mode 100644
index 00000000000..16c3ba1e0ae
--- /dev/null
+++ b/tests/queries/0_stateless/02807_math_unary_crash.sql
@@ -0,0 +1,4 @@
+CREATE TABLE t10 (`c0` Int32) ENGINE = MergeTree ORDER BY tuple();
+INSERT INTO t10 (c0) FORMAT Values (-1);
+SELECT 1 FROM t10 GROUP BY erf(-sign(t10.c0));
+SELECT 1 FROM t10 GROUP BY -sign(t10.c0);

From 3e5abbbf48953288d5bcea4fab9f2431bd05873d Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 27 Jun 2023 22:47:19 +0300
Subject: [PATCH 1319/1478] Update 02807_math_unary_crash.sql

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

diff --git a/tests/queries/0_stateless/02807_math_unary_crash.sql b/tests/queries/0_stateless/02807_math_unary_crash.sql
index 16c3ba1e0ae..fb693ac70f7 100644
--- a/tests/queries/0_stateless/02807_math_unary_crash.sql
+++ b/tests/queries/0_stateless/02807_math_unary_crash.sql
@@ -1,4 +1,6 @@
+DROP TABLE IF EXISTS t10;
 CREATE TABLE t10 (`c0` Int32) ENGINE = MergeTree ORDER BY tuple();
 INSERT INTO t10 (c0) FORMAT Values (-1);
 SELECT 1 FROM t10 GROUP BY erf(-sign(t10.c0));
 SELECT 1 FROM t10 GROUP BY -sign(t10.c0);
+DROP TABLE t10;

From 1ed104417a2cb49fc3c677d9193e2b676de95d77 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 27 Jun 2023 19:41:24 +0200
Subject: [PATCH 1320/1478] fix race between executeMetadataAlter and
 initializeReplication

(cherry picked from commit 1d47783e857ed4dd7550de0728913e0144657a52)
---
 src/Databases/DatabaseReplicated.cpp                | 10 ++++++++++
 src/Databases/DatabaseReplicated.h                  |  2 ++
 src/Databases/DatabaseReplicatedWorker.cpp          |  5 ++++-
 src/Databases/IDatabase.h                           |  3 +++
 src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp |  9 +++++++++
 5 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index de40ee4d82d..661afc6bf1f 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -1293,6 +1293,16 @@ void DatabaseReplicated::commitAlterTable(const StorageID & table_id,
     assert(checkDigestValid(query_context));
 }
 
+
+bool DatabaseReplicated::canExecuteReplicatedMetadataAlter() const
+{
+    /// ReplicatedMergeTree may call commitAlterTable from its background threads when executing ALTER_METADATA entries.
+    /// It may update the metadata digest (both locally and in ZooKeeper)
+    /// before DatabaseReplicatedDDLWorker::initializeReplication() has finished.
+    /// We should not update metadata until the database is initialized.
+    return ddl_worker && ddl_worker->isCurrentlyActive();
+}
+
 void DatabaseReplicated::detachTablePermanently(ContextPtr local_context, const String & table_name)
 {
     auto txn = local_context->getZooKeeperMetadataTransaction();
diff --git a/src/Databases/DatabaseReplicated.h b/src/Databases/DatabaseReplicated.h
index 1da181de030..ff1a4aba41c 100644
--- a/src/Databases/DatabaseReplicated.h
+++ b/src/Databases/DatabaseReplicated.h
@@ -48,6 +48,8 @@ public:
     /// then it will be executed on all replicas.
     BlockIO tryEnqueueReplicatedDDL(const ASTPtr & query, ContextPtr query_context, bool internal) override;
 
+    bool canExecuteReplicatedMetadataAlter() const override;
+
     bool hasReplicationThread() const override { return true; }
 
     void stopReplication() override;
diff --git a/src/Databases/DatabaseReplicatedWorker.cpp b/src/Databases/DatabaseReplicatedWorker.cpp
index ff2675dfd6b..593d0655777 100644
--- a/src/Databases/DatabaseReplicatedWorker.cpp
+++ b/src/Databases/DatabaseReplicatedWorker.cpp
@@ -91,12 +91,12 @@ 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;
     }
     else
     {
+        LOG_WARNING(log, "Did not find digest in ZooKeeper, creating it");
         /// Database was created by old ClickHouse versions, let's create the node
         std::lock_guard lock{database->metadata_mutex};
         digest = local_digest = database->tables_metadata_digest;
@@ -104,6 +104,9 @@ void DatabaseReplicatedDDLWorker::initializeReplication()
         zookeeper->create(database->replica_path + "/digest", digest_str, zkutil::CreateMode::Persistent);
     }
 
+    LOG_TRACE(log, "Trying to initialize replication: our_log_ptr={}, max_log_ptr={}, local_digest={}, zk_digest={}",
+              our_log_ptr, max_log_ptr, local_digest, digest);
+
     bool is_new_replica = our_log_ptr == 0;
     bool lost_according_to_log_ptr = our_log_ptr + logs_to_keep < max_log_ptr;
     bool lost_according_to_digest = database->db_settings.check_consistency && local_digest != digest;
diff --git a/src/Databases/IDatabase.h b/src/Databases/IDatabase.h
index 53a2f372814..aadae3e2491 100644
--- a/src/Databases/IDatabase.h
+++ b/src/Databases/IDatabase.h
@@ -254,6 +254,9 @@ public:
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "{}: alterTable() is not supported", getEngineName());
     }
 
+    /// Special method for ReplicatedMergeTree and DatabaseReplicated
+    virtual bool canExecuteReplicatedMetadataAlter() const { return true; }
+
     /// Returns time of table's metadata change, 0 if there is no corresponding metadata file.
     virtual time_t getObjectMetadataModificationTime(const String & /*name*/) const
     {
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
index 3ba3048b812..792843cbe18 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeQueue.cpp
@@ -1448,6 +1448,15 @@ bool ReplicatedMergeTreeQueue::shouldExecuteLogEntry(
             LOG_TRACE(LogToStr(out_postpone_reason, log), fmt_string, entry.znode_name, entry.alter_version, head_alter);
             return false;
         }
+
+        auto database_name = storage.getStorageID().database_name;
+        auto database = DatabaseCatalog::instance().getDatabase(database_name);
+        if (!database->canExecuteReplicatedMetadataAlter())
+        {
+            LOG_TRACE(LogToStr(out_postpone_reason, log), "Cannot execute alter metadata {} with version {} "
+                      "because database {} cannot process metadata alters now", entry.znode_name, entry.alter_version, database_name);
+            return false;
+        }
     }
 
     /// If this MUTATE_PART is part of alter modify/drop query, than we have to execute them one by one

From b95e8704d3e0f255cb5a8830b87f4cb4ca3ebe4c Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Wed, 28 Jun 2023 02:27:31 +0200
Subject: [PATCH 1321/1478] Fix test_host_regexp_multiple_ptr_records

---
 .../coredns_config/Corefile                                     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/test_host_regexp_multiple_ptr_records/coredns_config/Corefile b/tests/integration/test_host_regexp_multiple_ptr_records/coredns_config/Corefile
index 0dd198441dc..3edf37dafa5 100644
--- a/tests/integration/test_host_regexp_multiple_ptr_records/coredns_config/Corefile
+++ b/tests/integration/test_host_regexp_multiple_ptr_records/coredns_config/Corefile
@@ -1,6 +1,6 @@
 . {
     hosts /example.com {
-        reload "200ms"
+        reload "20ms"
         fallthrough
     }
     forward . 127.0.0.11

From 42f3871833993ffb3fd135c47ee9ee81d2897116 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Wed, 28 Jun 2023 02:29:27 +0200
Subject: [PATCH 1322/1478] Fix
 test_host_regexp_multiple_ptr_records_concurrent

---
 .../coredns_config/Corefile                                     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/coredns_config/Corefile b/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/coredns_config/Corefile
index 0dd198441dc..3edf37dafa5 100644
--- a/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/coredns_config/Corefile
+++ b/tests/integration/test_host_regexp_multiple_ptr_records_concurrent/coredns_config/Corefile
@@ -1,6 +1,6 @@
 . {
     hosts /example.com {
-        reload "200ms"
+        reload "20ms"
         fallthrough
     }
     forward . 127.0.0.11

From 6e769237a736d5f7c9e795451a4dddf675fdf85c Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Wed, 28 Jun 2023 01:39:06 +0000
Subject: [PATCH 1323/1478] added setting 'enable_job_stack_trace', default is
 off

---
 src/Common/Exception.cpp             |  1 +
 src/Common/Exception.h               |  1 +
 src/Common/ThreadPool.cpp            | 10 +++++++---
 src/Common/ThreadPool.h              |  3 ++-
 src/Common/ThreadStatus.h            |  1 +
 src/Core/Settings.h                  |  1 +
 src/Interpreters/ThreadStatusExt.cpp | 14 ++++++++++++++
 7 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/src/Common/Exception.cpp b/src/Common/Exception.cpp
index af48ce8fd99..ee268be45f6 100644
--- a/src/Common/Exception.cpp
+++ b/src/Common/Exception.cpp
@@ -200,6 +200,7 @@ Exception::FramePointers Exception::getStackFramePointers() const
     return frame_pointers;
 }
 
+thread_local bool Exception::enable_job_stack_trace = false;
 thread_local std::vector<StackTrace::FramePointers> Exception::thread_frame_pointers = {};
 
 
diff --git a/src/Common/Exception.h b/src/Common/Exception.h
index 4514df2159b..f80dfe7f0a2 100644
--- a/src/Common/Exception.h
+++ b/src/Common/Exception.h
@@ -43,6 +43,7 @@ public:
     }
 
     /// Collect call stacks of all previous jobs' schedulings leading to this thread job's execution
+    static thread_local bool enable_job_stack_trace;
     static thread_local std::vector<StackTrace::FramePointers> thread_frame_pointers;
 
 protected:
diff --git a/src/Common/ThreadPool.cpp b/src/Common/ThreadPool.cpp
index 0bd4fcb0455..979e53a72c0 100644
--- a/src/Common/ThreadPool.cpp
+++ b/src/Common/ThreadPool.cpp
@@ -191,7 +191,7 @@ ReturnType ThreadPoolImpl<Thread>::scheduleImpl(Job job, Priority priority, std:
                      /// Tracing context on this thread is used as parent context for the sub-thread that runs the job
                      propagate_opentelemetry_tracing_context ? DB::OpenTelemetry::CurrentContext() : DB::OpenTelemetry::TracingContextOnThread(),
                      /// capture_frame_pointers
-                     true);
+                     DB::Exception::enable_job_stack_trace);
 
         ++scheduled_jobs;
     }
@@ -397,7 +397,9 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
             /// to prevent us from modifying its priority. We have to use const_cast to force move semantics on JobWithPriority::job.
             job = std::move(const_cast<Job &>(jobs.top().job));
             parent_thread_trace_context = std::move(const_cast<DB::OpenTelemetry::TracingContextOnThread &>(jobs.top().thread_trace_context));
-            thread_frame_pointers = std::move(const_cast<std::vector<StackTrace::FramePointers> &>(jobs.top().frame_pointers));
+            DB::Exception::enable_job_stack_trace = jobs.top().enable_job_stack_trace;
+            if (DB::Exception::enable_job_stack_trace)
+                thread_frame_pointers = std::move(const_cast<std::vector<StackTrace::FramePointers> &>(jobs.top().frame_pointers));
             jobs.pop();
 
             /// We don't run jobs after `shutdown` is set, but we have to properly dequeue all jobs and finish them.
@@ -416,7 +418,9 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
         /// Run the job.
         try
         {
-            DB::Exception::thread_frame_pointers = std::move(thread_frame_pointers);
+            if (DB::Exception::enable_job_stack_trace)
+                DB::Exception::thread_frame_pointers = std::move(thread_frame_pointers);
+            
 
             CurrentMetrics::Increment metric_active_pool_threads(metric_active_threads);
 
diff --git a/src/Common/ThreadPool.h b/src/Common/ThreadPool.h
index 57188572a9d..f5721146e09 100644
--- a/src/Common/ThreadPool.h
+++ b/src/Common/ThreadPool.h
@@ -131,9 +131,10 @@ private:
 
         /// Call stacks of all jobs' schedulings leading to this one
         std::vector<StackTrace::FramePointers> frame_pointers;
+        bool enable_job_stack_trace = false;
 
         JobWithPriority(Job job_, Priority priority_, const DB::OpenTelemetry::TracingContextOnThread & thread_trace_context_, bool capture_frame_pointers = false)
-            : job(job_), priority(priority_), thread_trace_context(thread_trace_context_)
+            : job(job_), priority(priority_), thread_trace_context(thread_trace_context_), enable_job_stack_trace(capture_frame_pointers)
         {
             if (!capture_frame_pointers)
                 return;
diff --git a/src/Common/ThreadStatus.h b/src/Common/ThreadStatus.h
index 061959d9f1f..3b6b947471e 100644
--- a/src/Common/ThreadStatus.h
+++ b/src/Common/ThreadStatus.h
@@ -290,6 +290,7 @@ public:
     void flushUntrackedMemory();
 
 private:
+    void applyGlobalSettings();
     void applyQuerySettings();
 
     void initPerformanceCounters();
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index c14bd420c5c..d4003124303 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -465,6 +465,7 @@ class IColumn;
     M(UInt64, max_fetch_partition_retries_count, 5, "Amount of retries while fetching partition from another host.", 0) \
     M(UInt64, http_max_multipart_form_data_size, 1024 * 1024 * 1024, "Limit on size of multipart/form-data content. This setting cannot be parsed from URL parameters and should be set in user profile. Note that content is parsed and external tables are created in memory before start of query execution. And this is the only limit that has effect on that stage (limits on max memory usage and max execution time have no effect while reading HTTP form data).", 0) \
     M(Bool, calculate_text_stack_trace, true, "Calculate text stack trace in case of exceptions during query execution. This is the default. It requires symbol lookups that may slow down fuzzing tests when huge amount of wrong queries are executed. In normal cases you should not disable this option.", 0) \
+    M(Bool, enable_job_stack_trace, false, "Output stack trace of a job creator when job results in exception", 0) \
     M(Bool, allow_ddl, true, "If it is set to true, then a user is allowed to executed DDL queries.", 0) \
     M(Bool, parallel_view_processing, false, "Enables pushing to attached views concurrently instead of sequentially.", 0) \
     M(Bool, enable_unaligned_array_join, false, "Allow ARRAY JOIN with multiple arrays that have different sizes. When this settings is enabled, arrays will be resized to the longest one.", 0) \
diff --git a/src/Interpreters/ThreadStatusExt.cpp b/src/Interpreters/ThreadStatusExt.cpp
index 6a4f4576eca..5acfe500b1d 100644
--- a/src/Interpreters/ThreadStatusExt.cpp
+++ b/src/Interpreters/ThreadStatusExt.cpp
@@ -158,6 +158,17 @@ void CurrentThread::attachQueryForLog(const String & query_)
     current_thread->attachQueryForLog(query_);
 }
 
+void ThreadStatus::applyGlobalSettings()
+{
+    auto global_context_ptr = global_context.lock();
+    if (!global_context_ptr)
+        return;
+
+    const Settings & settings = global_context_ptr->getSettingsRef();
+
+    DB::Exception::enable_job_stack_trace = settings.enable_job_stack_trace;
+}
+
 void ThreadStatus::applyQuerySettings()
 {
     auto query_context_ptr = query_context.lock();
@@ -166,6 +177,8 @@ void ThreadStatus::applyQuerySettings()
 
     const Settings & settings = query_context_ptr->getSettingsRef();
 
+    DB::Exception::enable_job_stack_trace = settings.enable_job_stack_trace;
+
     query_id_from_query_context = query_context_ptr->getCurrentQueryId();
     initQueryProfiler();
 
@@ -204,6 +217,7 @@ void ThreadStatus::attachToGroupImpl(const ThreadGroupPtr & thread_group_)
 
     local_data = thread_group->getSharedData();
 
+    applyGlobalSettings();
     applyQuerySettings();
     initPerformanceCounters();
 }

From be852d554bb592cb66cacd0feef75b496b2465f1 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Tue, 27 Jun 2023 13:33:39 +0000
Subject: [PATCH 1324/1478] Use magic_enum for values

---
 src/Common/ZooKeeper/IKeeper.h                |  2 +
 src/Common/ZooKeeper/ZooKeeper.h              |  2 +
 src/Common/ZooKeeper/ZooKeeperImpl.h          |  2 +
 src/Coordination/FourLetterCommand.cpp        | 11 +++--
 src/Coordination/KeeperContext.cpp            | 20 +++++++--
 src/Coordination/KeeperFeatureFlags.cpp       | 17 +++-----
 src/Coordination/KeeperFeatureFlags.h         | 14 +------
 .../StorageSystemZooKeeperConnection.cpp      | 41 ++++++++++++++++---
 .../test_keeper_feature_flags_config/test.py  |  4 +-
 ...2735_system_zookeeper_connection.reference |  4 +-
 .../02735_system_zookeeper_connection.sql     |  2 +-
 11 files changed, 80 insertions(+), 39 deletions(-)

diff --git a/src/Common/ZooKeeper/IKeeper.h b/src/Common/ZooKeeper/IKeeper.h
index 369aacf16c7..2703c1079c0 100644
--- a/src/Common/ZooKeeper/IKeeper.h
+++ b/src/Common/ZooKeeper/IKeeper.h
@@ -532,6 +532,8 @@ public:
 
     virtual bool isFeatureEnabled(DB::KeeperFeatureFlag feature_flag) const = 0;
 
+    virtual const DB::KeeperFeatureFlags * getKeeperFeatureFlags() const { return nullptr; }
+
     /// Expire session and finish all pending requests
     virtual void finalize(const String & reason) = 0;
 };
diff --git a/src/Common/ZooKeeper/ZooKeeper.h b/src/Common/ZooKeeper/ZooKeeper.h
index 03200771e4a..1fcb048add2 100644
--- a/src/Common/ZooKeeper/ZooKeeper.h
+++ b/src/Common/ZooKeeper/ZooKeeper.h
@@ -529,6 +529,8 @@ public:
     size_t getConnectedZooKeeperIndex() const { return connected_zk_index; }
     UInt64 getConnectedTime() const { return connected_time; }
 
+    const DB::KeeperFeatureFlags * getKeeperFeatureFlags() const { return impl->getKeeperFeatureFlags(); }
+
 private:
     void init(ZooKeeperArgs args_);
 
diff --git a/src/Common/ZooKeeper/ZooKeeperImpl.h b/src/Common/ZooKeeper/ZooKeeperImpl.h
index ae6bef067e3..44ea993947e 100644
--- a/src/Common/ZooKeeper/ZooKeeperImpl.h
+++ b/src/Common/ZooKeeper/ZooKeeperImpl.h
@@ -202,6 +202,8 @@ public:
 
     void setServerCompletelyStarted();
 
+    const KeeperFeatureFlags * getKeeperFeatureFlags() const override { return &keeper_feature_flags; }
+
 private:
     ACLs default_acls;
     Poco::Net::SocketAddress connected_zk_address;
diff --git a/src/Coordination/FourLetterCommand.cpp b/src/Coordination/FourLetterCommand.cpp
index 10d13657fb0..34540902d47 100644
--- a/src/Coordination/FourLetterCommand.cpp
+++ b/src/Coordination/FourLetterCommand.cpp
@@ -13,6 +13,7 @@
 #include <Coordination/Keeper4LWInfo.h>
 #include <IO/WriteHelpers.h>
 #include <IO/Operators.h>
+#include <boost/algorithm/string.hpp>
 
 #include <unistd.h>
 #include <bit>
@@ -545,7 +546,7 @@ String FeatureFlagsCommand::run()
 
     StringBuffer ret;
 
-    auto append = [&ret] (String key, uint8_t value) -> void
+    auto append = [&ret] (const String & key, uint8_t value) -> void
     {
         writeText(key, ret);
         writeText('\t', ret);
@@ -553,8 +554,12 @@ String FeatureFlagsCommand::run()
         writeText('\n', ret);
     };
 
-    for (const auto feature : all_keeper_feature_flags)
-        append(SettingFieldKeeperFeatureFlagTraits::toString(feature), feature_flags.isEnabled(feature));
+    for (const auto & [feature_flag, name] : magic_enum::enum_entries<KeeperFeatureFlag>())
+    {
+        std::string feature_flag_string(name);
+        boost::to_lower(feature_flag_string);
+        append(feature_flag_string, feature_flags.isEnabled(feature_flag));
+    }
 
     return ret.str();
 
diff --git a/src/Coordination/KeeperContext.cpp b/src/Coordination/KeeperContext.cpp
index e6f30c81310..e1c3a138646 100644
--- a/src/Coordination/KeeperContext.cpp
+++ b/src/Coordination/KeeperContext.cpp
@@ -1,10 +1,19 @@
 #include <Coordination/KeeperContext.h>
 #include <Coordination/KeeperConstants.h>
 #include <Common/logger_useful.h>
+#include <Coordination/KeeperFeatureFlags.h>
+#include <boost/algorithm/string.hpp>
 
 namespace DB
 {
 
+namespace ErrorCodes
+{
+
+extern const int BAD_ARGUMENTS;
+
+}
+
 KeeperContext::KeeperContext()
 {
     /// enable by default some feature flags
@@ -29,12 +38,17 @@ void KeeperContext::initialize(const Poco::Util::AbstractConfiguration & config)
         config.keys(feature_flags_key, keys);
         for (const auto & key : keys)
         {
-            auto feature_flag = SettingFieldKeeperFeatureFlagTraits::fromString(key);
+            auto feature_flag_string = boost::to_upper_copy(key);
+            auto feature_flag = magic_enum::enum_cast<KeeperFeatureFlag>(feature_flag_string);
+
+            if (!feature_flag.has_value())
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid feature flag defined in config for Keeper: {}", key);
+
             auto is_enabled = config.getBool(feature_flags_key + "." + key);
             if (is_enabled)
-                feature_flags.enableFeatureFlag(feature_flag);
+                feature_flags.enableFeatureFlag(feature_flag.value());
             else
-                feature_flags.disableFeatureFlag(feature_flag);
+                feature_flags.disableFeatureFlag(feature_flag.value());
         }
 
         system_nodes_with_data[keeper_api_feature_flags_path] = feature_flags.getFeatureFlags();
diff --git a/src/Coordination/KeeperFeatureFlags.cpp b/src/Coordination/KeeperFeatureFlags.cpp
index 216dca014d4..3aff87bcea9 100644
--- a/src/Coordination/KeeperFeatureFlags.cpp
+++ b/src/Coordination/KeeperFeatureFlags.cpp
@@ -23,15 +23,10 @@ std::pair<size_t, size_t> getByteAndBitIndex(size_t num)
 
 }
 
-IMPLEMENT_SETTING_ENUM(KeeperFeatureFlag, ErrorCodes::BAD_ARGUMENTS,
-     {{"filtered_list", KeeperFeatureFlag::FILTERED_LIST},
-     {"multi_read", KeeperFeatureFlag::MULTI_READ},
-     {"check_not_exists", KeeperFeatureFlag::CHECK_NOT_EXISTS}});
-
 KeeperFeatureFlags::KeeperFeatureFlags()
 {
     /// get byte idx of largest value
-    auto [byte_idx, _] = getByteAndBitIndex(all_keeper_feature_flags.size() - 1);
+    auto [byte_idx, _] = getByteAndBitIndex(magic_enum::enum_count<KeeperFeatureFlag>() - 1);
     feature_flags = std::string(byte_idx + 1, 0);
 }
 
@@ -56,7 +51,7 @@ void KeeperFeatureFlags::fromApiVersion(KeeperApiVersion keeper_api_version)
 
 bool KeeperFeatureFlags::isEnabled(KeeperFeatureFlag feature_flag) const
 {
-    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(magic_enum::enum_integer(feature_flag));
 
     if (byte_idx > feature_flags.size())
         return false;
@@ -71,7 +66,7 @@ void KeeperFeatureFlags::setFeatureFlags(std::string feature_flags_)
 
 void KeeperFeatureFlags::enableFeatureFlag(KeeperFeatureFlag feature_flag)
 {
-    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(magic_enum::enum_integer(feature_flag));
     chassert(byte_idx < feature_flags.size());
 
     feature_flags[byte_idx] |= (1 << bit_idx);
@@ -79,7 +74,7 @@ void KeeperFeatureFlags::enableFeatureFlag(KeeperFeatureFlag feature_flag)
 
 void KeeperFeatureFlags::disableFeatureFlag(KeeperFeatureFlag feature_flag)
 {
-    auto [byte_idx, bit_idx] = getByteAndBitIndex(feature_flag);
+    auto [byte_idx, bit_idx] = getByteAndBitIndex(magic_enum::enum_integer(feature_flag));
     chassert(byte_idx < feature_flags.size());
 
     feature_flags[byte_idx] &= ~(1 << bit_idx);
@@ -92,10 +87,10 @@ const std::string & KeeperFeatureFlags::getFeatureFlags() const
 
 void KeeperFeatureFlags::logFlags(Poco::Logger * log) const
 {
-    for (const auto & feature_flag : all_keeper_feature_flags)
+    for (const auto & [feature_flag, feature_flag_name] : magic_enum::enum_entries<KeeperFeatureFlag>())
     {
         auto is_enabled = isEnabled(feature_flag);
-        LOG_INFO(log, "Keeper feature flag {}: {}", SettingFieldKeeperFeatureFlagTraits::toString(feature_flag), is_enabled ? "enabled" : "disabled");
+        LOG_INFO(log, "Keeper feature flag {}: {}", feature_flag_name, is_enabled ? "enabled" : "disabled");
     }
 }
 
diff --git a/src/Coordination/KeeperFeatureFlags.h b/src/Coordination/KeeperFeatureFlags.h
index cdd4704a7ca..6c48915f60c 100644
--- a/src/Coordination/KeeperFeatureFlags.h
+++ b/src/Coordination/KeeperFeatureFlags.h
@@ -1,28 +1,18 @@
 #pragma once
 
-#include <Core/SettingsEnums.h>
-#include <Core/SettingsFields.h>
 #include <Coordination/KeeperConstants.h>
 
 namespace DB
 {
 
-enum KeeperFeatureFlag
+/// these values cannot be reordered or removed, only new values can be added
+enum class KeeperFeatureFlag : size_t
 {
     FILTERED_LIST = 0,
     MULTI_READ,
     CHECK_NOT_EXISTS,
 };
 
-static inline constexpr std::array all_keeper_feature_flags
-{
-    KeeperFeatureFlag::FILTERED_LIST,
-    KeeperFeatureFlag::MULTI_READ,
-    KeeperFeatureFlag::CHECK_NOT_EXISTS,
-};
-
-DECLARE_SETTING_ENUM(KeeperFeatureFlag);
-
 class KeeperFeatureFlags
 {
 public:
diff --git a/src/Storages/System/StorageSystemZooKeeperConnection.cpp b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
index cd78ae01457..33268d58358 100644
--- a/src/Storages/System/StorageSystemZooKeeperConnection.cpp
+++ b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
@@ -1,8 +1,11 @@
 #include <Interpreters/Context.h>
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeEnum.h>
 #include <DataTypes/DataTypeString.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <DataTypes/DataTypeDateTime.h>
 #include <Common/ZooKeeper/ZooKeeper.h>
+#include <Coordination/KeeperFeatureFlags.h>
 #include <Storages/System/StorageSystemZooKeeperConnection.h>
 
 namespace DB
@@ -10,6 +13,13 @@ namespace DB
 
 NamesAndTypesList StorageSystemZooKeeperConnection::getNamesAndTypes()
 {
+    DataTypeEnum16::Values feature_flags_enum_values;
+    feature_flags_enum_values.reserve(magic_enum::enum_count<KeeperFeatureFlag>());
+    for (const auto & [feature_flag, feature_flag_string] : magic_enum::enum_entries<KeeperFeatureFlag>())
+        feature_flags_enum_values.push_back(std::pair{std::string{feature_flag_string}, static_cast<Int16>(feature_flag)});
+
+    auto feature_flags_enum = std::make_shared<DataTypeEnum16>(std::move(feature_flags_enum_values));
+
     return {
         {"name", std::make_shared<DataTypeString>()},
         {"host", std::make_shared<DataTypeString>()},
@@ -19,7 +29,8 @@ NamesAndTypesList StorageSystemZooKeeperConnection::getNamesAndTypes()
         {"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>()}
+        {"client_id", std::make_shared<DataTypeInt64>()},
+        {"enabled_feature_flags", std::make_shared<DataTypeArray>(std::move(feature_flags_enum))}
     };
 }
 
@@ -36,17 +47,37 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
     res_columns[7]->insert(0);
     res_columns[8]->insert(context->getZooKeeper()->getClientID());
 
+    const auto add_enabled_feature_flags = [&](const auto & zookeeper)
+    {
+        Array enabled_feature_flags;
+        const auto * feature_flags = zookeeper->getKeeperFeatureFlags();
+        if (feature_flags)
+        {
+            for (const auto & feature_flag : magic_enum::enum_values<KeeperFeatureFlag>())
+            {
+                if (feature_flags->isEnabled(feature_flag))
+                {
+                    enabled_feature_flags.push_back(feature_flag);
+                }
+            }
+        }
+        res_columns[9]->insert(std::move(enabled_feature_flags));
+    };
+
+    add_enabled_feature_flags(context->getZooKeeper());
+
     for (const auto & elem : context->getAuxiliaryZooKeepers())
     {
         res_columns[0]->insert(elem.first);
         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(0);
-        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(0);
         res_columns[8]->insert(elem.second->getClientID());
+        add_enabled_feature_flags(elem.second);
     }
 
 }
diff --git a/tests/integration/test_keeper_feature_flags_config/test.py b/tests/integration/test_keeper_feature_flags_config/test.py
index bb7252e9ec8..93ac6cbd3bd 100644
--- a/tests/integration/test_keeper_feature_flags_config/test.py
+++ b/tests/integration/test_keeper_feature_flags_config/test.py
@@ -69,12 +69,12 @@ def test_keeper_feature_flags(started_cluster):
 
         for feature, is_enabled in feature_flags:
             node.wait_for_log_line(
-                f"ZooKeeperClient: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}",
+                f"ZooKeeperClient: Keeper feature flag {feature.upper()}: {'enabled' if is_enabled else 'disabled'}",
                 look_behind_lines=1000,
             )
 
             node.wait_for_log_line(
-                f"KeeperContext: Keeper feature flag {feature}: {'enabled' if is_enabled else 'disabled'}",
+                f"KeeperContext: Keeper feature flag {feature.upper()}: {'enabled' if is_enabled else 'disabled'}",
                 look_behind_lines=1000,
             )
 
diff --git a/tests/queries/0_stateless/02735_system_zookeeper_connection.reference b/tests/queries/0_stateless/02735_system_zookeeper_connection.reference
index eddd4829829..380da27cde6 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	0	1	1
-zookeeper2	::1	9181	0	0	0	1
\ No newline at end of file
+default	::1	9181	0	0	0	1	1	['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS']
+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 863d90e1654..f999da51225 100644
--- a/tests/queries/0_stateless/02735_system_zookeeper_connection.sql
+++ b/tests/queries/0_stateless/02735_system_zookeeper_connection.sql
@@ -9,7 +9,7 @@ ENGINE ReplicatedMergeTree('zookeeper2:/clickhouse/{database}/02731_zk_connectio
 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)
+       (abs(session_uptime_elapsed_seconds  - zookeeperSessionUptime()) < 10), enabled_feature_flags
 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

From eff1cc0e5df2af76b5687fce03901686e1a8360c Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Wed, 28 Jun 2023 10:20:33 +0200
Subject: [PATCH 1325/1478] Remove unused errorcode

---
 src/Coordination/KeeperFeatureFlags.cpp | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/Coordination/KeeperFeatureFlags.cpp b/src/Coordination/KeeperFeatureFlags.cpp
index 3aff87bcea9..d0cd1c86b55 100644
--- a/src/Coordination/KeeperFeatureFlags.cpp
+++ b/src/Coordination/KeeperFeatureFlags.cpp
@@ -6,11 +6,6 @@
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int BAD_ARGUMENTS;
-}
-
 namespace
 {
 

From 04a08b47f3ca5d250600775adf1c307c09af929b Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 22:25:56 +0200
Subject: [PATCH 1326/1478] Reorganize installation of clickhouse to have
 separated layers

---
 docker/server/Dockerfile.ubuntu | 46 +++++++++++++++++++++------------
 1 file changed, 30 insertions(+), 16 deletions(-)

diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index f393b98cfe6..abb3f387330 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -11,14 +11,15 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
     && apt-get update \
     && apt-get upgrade -yq \
     && apt-get install --yes --no-install-recommends \
-        apt-transport-https \
         ca-certificates \
-        dirmngr \
-        gnupg2 \
-        wget \
         locales \
         tzdata \
-    && apt-get clean
+        wget \
+    && apt-get clean \
+    && rm -rf \
+        /var/lib/apt/lists/* \
+        /var/cache/debconf \
+        /tmp/*
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
@@ -43,7 +44,8 @@ ARG single_binary_location_url=""
 
 ARG TARGETARCH
 
-RUN arch=${TARGETARCH:-amd64} \
+# install from a web location with deb packages
+RUN arch="${TARGETARCH:-amd64}" \
     && if [ -n "${deb_location_url}" ]; then \
         echo "installing from custom url with deb packages: ${deb_location_url}" \
         rm -rf /tmp/clickhouse_debs \
@@ -54,15 +56,27 @@ RUN arch=${TARGETARCH:-amd64} \
             || exit 1 \
         ; done \
         && dpkg -i /tmp/clickhouse_debs/*.deb ; \
-    elif [ -n "${single_binary_location_url}" ]; then \
+    fi
+
+# install from a single binary
+RUN if [ -n "${single_binary_location_url}" ]; then \
         echo "installing from single binary url: ${single_binary_location_url}" \
         && rm -rf /tmp/clickhouse_binary \
         && mkdir -p /tmp/clickhouse_binary \
         && wget --progress=bar:force:noscroll "${single_binary_location_url}" -O /tmp/clickhouse_binary/clickhouse \
         && chmod +x /tmp/clickhouse_binary/clickhouse \
         && /tmp/clickhouse_binary/clickhouse install --user "clickhouse" --group "clickhouse" ; \
-    else \
-        mkdir -p /etc/apt/sources.list.d \
+    fi
+
+# A fallback to installation from ClickHouse repository
+RUN if ! clickhouse local -q "SELECT ''" > /dev/null; then \
+        apt-get update \
+        && apt-get install --yes --no-install-recommends \
+            apt-transport-https \
+            ca-certificates \
+            dirmngr \
+            gnupg2 \
+        && mkdir -p /etc/apt/sources.list.d \
         && apt-key adv --keyserver keyserver.ubuntu.com --recv 8919F6BD2B48D754 \
         && echo ${REPOSITORY} > /etc/apt/sources.list.d/clickhouse.list \
         && echo "installing from repository: ${REPOSITORY}" \
@@ -72,20 +86,20 @@ RUN arch=${TARGETARCH:-amd64} \
             packages="${packages} ${package}=${VERSION}" \
         ; done \
         && apt-get install --allow-unauthenticated --yes --no-install-recommends ${packages} || exit 1 \
-    ; fi \
-    && clickhouse-local -q 'SELECT * FROM system.build_options' \
     && rm -rf \
         /var/lib/apt/lists/* \
         /var/cache/debconf \
         /tmp/* \
-    && mkdir -p /var/lib/clickhouse /var/log/clickhouse-server /etc/clickhouse-server /etc/clickhouse-client \
-    && chmod ugo+Xrw -R /var/lib/clickhouse /var/log/clickhouse-server /etc/clickhouse-server /etc/clickhouse-client
-
-RUN apt-get autoremove --purge -yq libksba8 && \
-    apt-get autoremove -yq
+    && apt-get autoremove --purge -yq libksba8 \
+    && apt-get autoremove -yq \
+    ; fi
 
+# post install
 # we need to allow "others" access to clickhouse folder, because docker container
 # can be started with arbitrary uid (openshift usecase)
+RUN clickhouse-local -q 'SELECT * FROM system.build_options' \
+    && mkdir -p /var/lib/clickhouse /var/log/clickhouse-server /etc/clickhouse-server /etc/clickhouse-client \
+    && chmod ugo+Xrw -R /var/lib/clickhouse /var/log/clickhouse-server /etc/clickhouse-server /etc/clickhouse-client
 
 RUN locale-gen en_US.UTF-8
 ENV LANG en_US.UTF-8

From 6145baade8dad30207935c81a844fadd618cb912 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 22:27:33 +0200
Subject: [PATCH 1327/1478] Upgrade OS only once

The ubuntu images are updated twice a month, it makes sense to do
upgrade
https://github.com/docker-library/official-images/commits/master/library/ubuntu
---
 docker/server/Dockerfile.ubuntu | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index abb3f387330..a563149ba8e 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -81,7 +81,6 @@ RUN if ! clickhouse local -q "SELECT ''" > /dev/null; then \
         && echo ${REPOSITORY} > /etc/apt/sources.list.d/clickhouse.list \
         && echo "installing from repository: ${REPOSITORY}" \
         && apt-get update \
-        && apt-get --yes -o "Dpkg::Options::=--force-confdef" -o "Dpkg::Options::=--force-confold" upgrade \
         && for package in ${PACKAGES}; do \
             packages="${packages} ${package}=${VERSION}" \
         ; done \

From a2c4546c00f181ddc11a59c9e1b259819432e3c8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 22:53:30 +0200
Subject: [PATCH 1328/1478] Downgrade the base image to address issues on old
 dockerd

---
 docker/server/Dockerfile.ubuntu | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index a563149ba8e..e2347945cf6 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -1,4 +1,4 @@
-FROM ubuntu:22.04
+FROM ubuntu:20.04
 
 # see https://github.com/moby/moby/issues/4032#issuecomment-192327844
 ARG DEBIAN_FRONTEND=noninteractive

From 6d2b5166b930e77e53c9bb608d56d372c0ecd0b3 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 23:10:56 +0200
Subject: [PATCH 1329/1478] Update golang version in builder

---
 docker/packager/binary/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/packager/binary/Dockerfile b/docker/packager/binary/Dockerfile
index dd21c8552d3..e824161a688 100644
--- a/docker/packager/binary/Dockerfile
+++ b/docker/packager/binary/Dockerfile
@@ -89,7 +89,7 @@ RUN arch=${TARGETARCH:-amd64} \
     && dpkg -i /tmp/nfpm.deb \
     && rm /tmp/nfpm.deb
 
-ARG GO_VERSION=1.19.5
+ARG GO_VERSION=1.19.10
 # We need go for clickhouse-diagnostics
 RUN arch=${TARGETARCH:-amd64} \
     && curl -Lo /tmp/go.tgz "https://go.dev/dl/go${GO_VERSION}.linux-${arch}.tar.gz" \

From 1cd5ae36bd89215d7c1af99d2a8b9193d0f79081 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 23:20:47 +0200
Subject: [PATCH 1330/1478] Get rid of deprecated apt-key

---
 docker/server/Dockerfile.ubuntu | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index e2347945cf6..1bb0cfdc700 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
         /tmp/*
 
 ARG REPO_CHANNEL="stable"
-ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
+ARG REPOSITORY="deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
 ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
@@ -77,8 +77,13 @@ RUN if ! clickhouse local -q "SELECT ''" > /dev/null; then \
             dirmngr \
             gnupg2 \
         && mkdir -p /etc/apt/sources.list.d \
-        && apt-key adv --keyserver keyserver.ubuntu.com --recv 8919F6BD2B48D754 \
-        && echo ${REPOSITORY} > /etc/apt/sources.list.d/clickhouse.list \
+        && GNUPGHOME=$(mktemp -d) \
+        && GNUPGHOME="$GNUPGHOME" gpg --no-default-keyring \
+            --keyring /usr/share/keyrings/clickhouse-keyring.gpg \
+            --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 8919F6BD2B48D754 \
+        && rm -r "$GNUPGHOME" \
+        && chmod +r /usr/share/keyrings/clickhouse-keyring.gpg \
+        && echo "${REPOSITORY}" > /etc/apt/sources.list.d/clickhouse.list \
         && echo "installing from repository: ${REPOSITORY}" \
         && apt-get update \
         && for package in ${PACKAGES}; do \

From 0e72c6dcc934a52184909e3c6b32b084678c185a Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 28 Jun 2023 10:33:07 +0200
Subject: [PATCH 1331/1478] fix

---
 .../0_stateless/01111_create_drop_replicated_db_stress.sh       | 2 +-
 tests/queries/0_stateless/01293_optimize_final_force.sh         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/01111_create_drop_replicated_db_stress.sh b/tests/queries/0_stateless/01111_create_drop_replicated_db_stress.sh
index 770a0780ca2..4d341e5b8a3 100755
--- a/tests/queries/0_stateless/01111_create_drop_replicated_db_stress.sh
+++ b/tests/queries/0_stateless/01111_create_drop_replicated_db_stress.sh
@@ -64,7 +64,7 @@ function alter_table()
         if [ -z "$table" ]; then continue; fi
         $CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=0 -q \
         "alter table $table update n = n + (select max(n) from merge(REGEXP('${CLICKHOUSE_DATABASE}.*'), '.*')) where 1 settings allow_nondeterministic_mutations=1" \
-        2>&1| grep -Fa "Exception: " | grep -Fv "Cannot enqueue query" | grep -Fv "ZooKeeper session expired" | grep -Fv UNKNOWN_DATABASE | grep -Fv UNKNOWN_TABLE | grep -Fv TABLE_IS_READ_ONLY | grep -Fv TABLE_IS_DROPPED
+        2>&1| grep -Fa "Exception: " | grep -Fv "Cannot enqueue query" | grep -Fv "ZooKeeper session expired" | grep -Fv UNKNOWN_DATABASE | grep -Fv UNKNOWN_TABLE | grep -Fv TABLE_IS_READ_ONLY | grep -Fv TABLE_IS_DROPPED | grep -Fv "Error while executing table function merge"
         sleep 0.$RANDOM
     done
 }
diff --git a/tests/queries/0_stateless/01293_optimize_final_force.sh b/tests/queries/0_stateless/01293_optimize_final_force.sh
index eb3a2756899..9b9ed6272a1 100755
--- a/tests/queries/0_stateless/01293_optimize_final_force.sh
+++ b/tests/queries/0_stateless/01293_optimize_final_force.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest, no-debug, no-s3-storage
+# Tags: no-fasttest, long, no-debug, no-s3-storage
 # This test is too slow with S3 storage and debug modes.
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)

From 67a7bdbb3a1c8fa2341e1627261d311cba1308a7 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 28 Jun 2023 10:45:07 +0200
Subject: [PATCH 1332/1478] Rollback note about 22.04 in #50958

---
 docker/server/README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docker/server/README.md b/docker/server/README.md
index 18dce492123..67646a262f5 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -20,7 +20,6 @@ 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 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 1596b09dc2888690acafa397936d0d7051e95fba Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 28 Jun 2023 10:51:15 +0200
Subject: [PATCH 1333/1478] add missing finalize calls

---
 programs/format/Format.cpp | 5 +++--
 src/Client/ClientBase.cpp  | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/programs/format/Format.cpp b/programs/format/Format.cpp
index 392ecefac0f..43c66a32302 100644
--- a/programs/format/Format.cpp
+++ b/programs/format/Format.cpp
@@ -151,6 +151,7 @@ int mainEntryClickHouseFormat(int argc, char ** argv)
 
             WriteBufferFromFileDescriptor out(STDOUT_FILENO);
             obfuscateQueries(query, out, obfuscated_words_map, used_nouns, hash_func, is_known_identifier);
+            out.finalize();
         }
         else
         {
@@ -175,7 +176,7 @@ int mainEntryClickHouseFormat(int argc, char ** argv)
                     {
                         WriteBufferFromOStream res_buf(std::cout, 4096);
                         formatAST(*res, res_buf, hilite, oneline);
-                        res_buf.next();
+                        res_buf.finalize();
                         if (multiple)
                             std::cout << "\n;\n";
                         std::cout << std::endl;
@@ -199,7 +200,7 @@ int mainEntryClickHouseFormat(int argc, char ** argv)
                             res_cout.write(*s_pos++);
                         }
 
-                        res_cout.next();
+                        res_cout.finalize();
                         if (multiple)
                             std::cout << " \\\n;\n";
                         std::cout << std::endl;
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 34b3b1e228a..cf1c2ed8779 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -362,7 +362,7 @@ ASTPtr ClientBase::parseQuery(const char *& pos, const char * end, bool allow_mu
         std::cout << std::endl;
         WriteBufferFromOStream res_buf(std::cout, 4096);
         formatAST(*res, res_buf);
-        res_buf.next();
+        res_buf.finalize();
         std::cout << std::endl << std::endl;
     }
 

From 0c1f24db77354c7982eaac60618da3b15589e4a4 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 28 Jun 2023 12:13:16 +0200
Subject: [PATCH 1334/1478] Add a comment (#51517)

* Add a comment

* Update DatabaseCatalog.cpp
---
 src/Interpreters/DatabaseCatalog.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index 40ef2bd4775..4cb2f6e3b3d 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -217,6 +217,8 @@ void DatabaseCatalog::shutdownImpl()
     /// We still hold "databases" (instead of std::move) for Buffer tables to flush data correctly.
 
     /// Delay shutdown of temporary and system databases. They will be shutdown last.
+    /// Because some databases might use them until their shutdown is called, but calling shutdown
+    /// on temporary database means clearing its set of tables, which will lead to unnecessary errors like "table not found".
     std::vector<DatabasePtr> databases_with_delayed_shutdown;
     for (auto & database : current_databases)
     {

From 0320ab4a7056ac099145648504505cb1c7225858 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Wed, 28 Jun 2023 12:16:16 +0200
Subject: [PATCH 1335/1478] Try making Keeper in `DatabaseReplicated` tests
 more stable (#51473)

* Try making Keeper in DatabaseReplicated less flaky

* lower log level to debug

* Revert back to information
---
 tests/config/config.d/database_replicated.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/config/config.d/database_replicated.xml b/tests/config/config.d/database_replicated.xml
index 9a405f85908..2504a7ca526 100644
--- a/tests/config/config.d/database_replicated.xml
+++ b/tests/config/config.d/database_replicated.xml
@@ -40,7 +40,7 @@
             <operation_timeout_ms>10000</operation_timeout_ms>
             <session_timeout_ms>30000</session_timeout_ms>
             <heart_beat_interval_ms>1000</heart_beat_interval_ms>
-            <election_timeout_lower_bound_ms>4000</election_timeout_lower_bound_ms>
+            <election_timeout_lower_bound_ms>2000</election_timeout_lower_bound_ms>
             <election_timeout_upper_bound_ms>5000</election_timeout_upper_bound_ms>
             <raft_logs_level>information</raft_logs_level>
             <force_sync>false</force_sync>

From 451694d8b6ed7630842020ca132a9d7548352cad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Wed, 28 Jun 2023 10:24:54 +0000
Subject: [PATCH 1336/1478] Make `test_ssl_cert_authentication` similar to
 `test_tlvs1_3`

---
 .../test_ssl_cert_authentication/test.py      | 92 +++++++++++++------
 1 file changed, 62 insertions(+), 30 deletions(-)

diff --git a/tests/integration/test_ssl_cert_authentication/test.py b/tests/integration/test_ssl_cert_authentication/test.py
index b05a6acc16b..91faf8b0ce3 100644
--- a/tests/integration/test_ssl_cert_authentication/test.py
+++ b/tests/integration/test_ssl_cert_authentication/test.py
@@ -2,10 +2,10 @@ import pytest
 from helpers.client import Client
 from helpers.cluster import ClickHouseCluster
 from helpers.ssl_context import WrapSSLContextWithSNI
+import urllib.request, urllib.parse
 import ssl
 import os.path
 from os import remove
-import urllib3
 
 
 # The test cluster is configured with certificate for that host name, see 'server-ext.cnf'.
@@ -14,6 +14,7 @@ SSL_HOST = "integration-tests.clickhouse.com"
 HTTPS_PORT = 8443
 # It's important for the node to work at this IP because 'server-cert.pem' requires that (see server-ext.cnf).
 SCRIPT_DIR = os.path.dirname(os.path.realpath(__file__))
+MAX_RETRY = 5
 
 cluster = ClickHouseCluster(__file__)
 instance = cluster.add_instance(
@@ -164,17 +165,19 @@ def get_ssl_context(cert_name):
 def execute_query_https(
     query, user, enable_ssl_auth=True, cert_name=None, password=None
 ):
-    url = f"https://{instance.ip_address}:{HTTPS_PORT}/?query={query}"
-    headers = {"X-ClickHouse-User": user}
+    url = (
+        f"https://{instance.ip_address}:{HTTPS_PORT}/?query={urllib.parse.quote(query)}"
+    )
+    request = urllib.request.Request(url)
+    request.add_header("X-ClickHouse-User", user)
     if enable_ssl_auth:
-        headers["X-ClickHouse-SSL-Certificate-Auth"] = "on"
+        request.add_header("X-ClickHouse-SSL-Certificate-Auth", "on")
     if password:
-        headers["X-ClickHouse-Key"] = password
-    http_client = urllib3.PoolManager(ssl_context=get_ssl_context(cert_name))
-    response = http_client.request("GET", url, headers=headers)
-    if response.status != 200:
-        raise Exception(response.status)
-    return response.data.decode("utf-8")
+        request.add_header("X-ClickHouse-Key", password)
+    response = urllib.request.urlopen(
+        request, context=get_ssl_context(cert_name)
+    ).read()
+    return response.decode("utf-8")
 
 
 def test_https():
@@ -198,10 +201,18 @@ def test_https_wrong_cert():
         execute_query_https("SELECT currentUser()", user="john", cert_name="client2")
     assert "403" in str(err.value)
 
+    count = 0
     # Wrong certificate: self-signed certificate.
-    with pytest.raises(Exception) as err:
-        execute_query_https("SELECT currentUser()", user="john", cert_name="wrong")
-    assert "unknown ca" in str(err.value)
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https("SELECT currentUser()", user="john", cert_name="wrong")
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(f"Failed attempt with wrong cert, err: {err_str}")
+            continue
+        assert "unknown ca" in err_str
+        break
 
     # No certificate.
     with pytest.raises(Exception) as err:
@@ -291,24 +302,45 @@ def test_https_non_ssl_auth():
         == "jane\n"
     )
 
+    count = 0
     # However if we send a certificate it must not be wrong.
-    with pytest.raises(Exception) as err:
-        execute_query_https(
-            "SELECT currentUser()",
-            user="peter",
-            enable_ssl_auth=False,
-            cert_name="wrong",
-        )
-    assert "unknown ca" in str(err.value)
-    with pytest.raises(Exception) as err:
-        execute_query_https(
-            "SELECT currentUser()",
-            user="jane",
-            enable_ssl_auth=False,
-            password="qwe123",
-            cert_name="wrong",
-        )
-    assert "unknown ca" in str(err.value)
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https(
+                "SELECT currentUser()",
+                user="peter",
+                enable_ssl_auth=False,
+                cert_name="wrong",
+            )
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(
+                f"Failed attempt with wrong cert, user: peter, err: {err_str}"
+            )
+            continue
+        assert "unknown ca" in err_str
+        break
+
+    count = 0
+    while count <= MAX_RETRY:
+        with pytest.raises(Exception) as err:
+            execute_query_https(
+                "SELECT currentUser()",
+                user="jane",
+                enable_ssl_auth=False,
+                password="qwe123",
+                cert_name="wrong",
+            )
+        err_str = str(err.value)
+        if count < MAX_RETRY and "Broken pipe" in err_str:
+            count = count + 1
+            logging.warning(
+                f"Failed attempt with wrong cert, user: jane, err: {err_str}"
+            )
+            continue
+        assert "unknown ca" in err_str
+        break
 
 
 def test_create_user():

From b8b0fd3abfee08db6b31b393fb828915940ae13d Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
Date: Wed, 28 Jun 2023 12:30:15 +0200
Subject: [PATCH 1337/1478] Slightly better code around packets for parallel
 replicas (#51451)

---
 src/Client/Connection.cpp                     |  8 +---
 src/Client/IServerConnection.h                | 10 +++--
 src/QueryPipeline/RemoteQueryExecutor.cpp     |  6 ++-
 src/Storages/MergeTree/MergeTreeReadPool.cpp  | 21 ++++++----
 src/Storages/MergeTree/MergeTreeReadPool.h    | 18 ++++----
 .../ParallelReplicasReadingCoordinator.cpp    |  2 -
 src/Storages/MergeTree/RequestResponse.cpp    | 26 +++++++++++-
 src/Storages/MergeTree/RequestResponse.h      | 42 +++++++++++++++++--
 8 files changed, 98 insertions(+), 35 deletions(-)

diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index be226bfd9dd..cd102f46ffe 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -1175,16 +1175,12 @@ ProfileInfo Connection::receiveProfileInfo() const
 
 ParallelReadRequest Connection::receiveParallelReadRequest() const
 {
-    ParallelReadRequest request;
-    request.deserialize(*in);
-    return request;
+    return ParallelReadRequest::deserialize(*in);
 }
 
 InitialAllRangesAnnouncement Connection::receiveInitialParallelReadAnnounecement() const
 {
-    InitialAllRangesAnnouncement announcement;
-    announcement.deserialize(*in);
-    return announcement;
+    return InitialAllRangesAnnouncement::deserialize(*in);
 }
 
 
diff --git a/src/Client/IServerConnection.h b/src/Client/IServerConnection.h
index 52382ff9d45..a0c029c79fb 100644
--- a/src/Client/IServerConnection.h
+++ b/src/Client/IServerConnection.h
@@ -16,6 +16,10 @@
 
 #include <boost/noncopyable.hpp>
 
+#include <optional>
+#include <vector>
+#include <memory>
+#include <string>
 
 namespace DB
 {
@@ -34,9 +38,9 @@ struct Packet
     ProfileInfo profile_info;
     std::vector<UUID> part_uuids;
 
-    InitialAllRangesAnnouncement announcement;
-    ParallelReadRequest request;
-    ParallelReadResponse response;
+    /// The part of parallel replicas protocol
+    std::optional<InitialAllRangesAnnouncement> announcement;
+    std::optional<ParallelReadRequest> request;
 
     std::string server_timezone;
 
diff --git a/src/QueryPipeline/RemoteQueryExecutor.cpp b/src/QueryPipeline/RemoteQueryExecutor.cpp
index 233dfe13339..cd6f65b7b43 100644
--- a/src/QueryPipeline/RemoteQueryExecutor.cpp
+++ b/src/QueryPipeline/RemoteQueryExecutor.cpp
@@ -434,11 +434,13 @@ RemoteQueryExecutor::ReadResult RemoteQueryExecutor::processPacket(Packet packet
     switch (packet.type)
     {
         case Protocol::Server::MergeTreeReadTaskRequest:
-            processMergeTreeReadTaskRequest(packet.request);
+            chassert(packet.request.has_value());
+            processMergeTreeReadTaskRequest(packet.request.value());
             return ReadResult(ReadResult::Type::ParallelReplicasToken);
 
         case Protocol::Server::MergeTreeAllRangesAnnounecement:
-            processMergeTreeInitialReadAnnounecement(packet.announcement);
+            chassert(packet.announcement.has_value());
+            processMergeTreeInitialReadAnnounecement(packet.announcement.value());
             return ReadResult(ReadResult::Type::ParallelReplicasToken);
 
         case Protocol::Server::ReadTaskRequest:
diff --git a/src/Storages/MergeTree/MergeTreeReadPool.cpp b/src/Storages/MergeTree/MergeTreeReadPool.cpp
index ba8c2c6385f..2ab90189f9d 100644
--- a/src/Storages/MergeTree/MergeTreeReadPool.cpp
+++ b/src/Storages/MergeTree/MergeTreeReadPool.cpp
@@ -6,6 +6,7 @@
 #include <Common/Stopwatch.h>
 #include <Common/formatReadable.h>
 #include <Common/logger_useful.h>
+#include <Storages/MergeTree/RequestResponse.h>
 
 
 namespace ProfileEvents
@@ -433,8 +434,12 @@ MergeTreeReadTaskPtr MergeTreeReadPoolParallelReplicas::getTask(size_t thread)
 
     if (buffered_ranges.empty())
     {
-        auto result = extension.callback(ParallelReadRequest{
-            .replica_num = extension.number_of_current_replica, .min_number_of_marks = min_marks_for_concurrent_read * threads});
+        auto result = extension.callback(ParallelReadRequest(
+            CoordinationMode::Default,
+            extension.number_of_current_replica,
+            min_marks_for_concurrent_read * threads,
+            /// For Default coordination mode we don't need to pass part names.
+            RangesInDataPartsDescription{}));
 
         if (!result || result->finish)
         {
@@ -529,12 +534,12 @@ MarkRanges MergeTreeInOrderReadPoolParallelReplicas::getNewTask(RangesInDataPart
     if (no_more_tasks)
         return {};
 
-    auto response = extension.callback(ParallelReadRequest{
-        .mode = mode,
-        .replica_num = extension.number_of_current_replica,
-        .min_number_of_marks = min_marks_for_concurrent_read * request.size(),
-        .description = request,
-    });
+    auto response = extension.callback(ParallelReadRequest(
+        mode,
+        extension.number_of_current_replica,
+        min_marks_for_concurrent_read * request.size(),
+        request
+    ));
 
     if (!response || response->description.empty() || response->finish)
     {
diff --git a/src/Storages/MergeTree/MergeTreeReadPool.h b/src/Storages/MergeTree/MergeTreeReadPool.h
index 21273904e00..68d5438cb3d 100644
--- a/src/Storages/MergeTree/MergeTreeReadPool.h
+++ b/src/Storages/MergeTree/MergeTreeReadPool.h
@@ -193,10 +193,11 @@ public:
             predict_block_size_bytes, column_names, virtual_column_names, prewhere_info,
             actions_settings, reader_settings, per_part_params);
 
-        extension.all_callback({
-            .description = parts_ranges.getDescriptions(),
-            .replica_num = extension.number_of_current_replica
-        });
+        extension.all_callback(InitialAllRangesAnnouncement(
+            CoordinationMode::Default,
+            parts_ranges.getDescriptions(),
+            extension.number_of_current_replica
+        ));
     }
 
     ~MergeTreeReadPoolParallelReplicas() override;
@@ -253,10 +254,11 @@ public:
         for (const auto & part : parts_ranges)
             buffered_tasks.push_back({part.data_part->info, MarkRanges{}});
 
-        extension.all_callback({
-            .description = parts_ranges.getDescriptions(),
-            .replica_num = extension.number_of_current_replica
-        });
+        extension.all_callback(InitialAllRangesAnnouncement(
+            mode,
+            parts_ranges.getDescriptions(),
+            extension.number_of_current_replica
+        ));
     }
 
     MarkRanges getNewTask(RangesInDataPartDescription description);
diff --git a/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp b/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
index 2814d13cff0..57cd91cc995 100644
--- a/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
+++ b/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
@@ -102,7 +102,6 @@ public:
 
     explicit DefaultCoordinator(size_t replicas_count_)
         : ParallelReplicasReadingCoordinator::ImplInterface(replicas_count_)
-        , announcements(replicas_count_)
         , reading_state(replicas_count_)
     {
     }
@@ -119,7 +118,6 @@ public:
     PartitionToBlockRanges partitions;
 
     size_t sent_initial_requests{0};
-    std::vector<InitialAllRangesAnnouncement> announcements;
 
     Parts all_parts_to_read;
     /// Contains only parts which we haven't started to read from
diff --git a/src/Storages/MergeTree/RequestResponse.cpp b/src/Storages/MergeTree/RequestResponse.cpp
index 05930d5a4c4..2ce0e20dcd2 100644
--- a/src/Storages/MergeTree/RequestResponse.cpp
+++ b/src/Storages/MergeTree/RequestResponse.cpp
@@ -51,7 +51,7 @@ String ParallelReadRequest::describe() const
     return result;
 }
 
-void ParallelReadRequest::deserialize(ReadBuffer & in)
+ParallelReadRequest ParallelReadRequest::deserialize(ReadBuffer & in)
 {
     UInt64 version;
     readIntBinary(version, in);
@@ -60,12 +60,24 @@ void ParallelReadRequest::deserialize(ReadBuffer & in)
             "from replicas differ. Got: {}, supported version: {}",
             version, DBMS_PARALLEL_REPLICAS_PROTOCOL_VERSION);
 
+    CoordinationMode mode;
+    size_t replica_num;
+    size_t min_number_of_marks;
+    RangesInDataPartsDescription description;
+
     uint8_t mode_candidate;
     readIntBinary(mode_candidate, in);
     mode = validateAndGet(mode_candidate);
     readIntBinary(replica_num, in);
     readIntBinary(min_number_of_marks, in);
     description.deserialize(in);
+
+    return ParallelReadRequest(
+        mode,
+        replica_num,
+        min_number_of_marks,
+        std::move(description)
+    );
 }
 
 void ParallelReadRequest::merge(ParallelReadRequest & other)
@@ -125,7 +137,7 @@ String InitialAllRangesAnnouncement::describe()
     return result;
 }
 
-void InitialAllRangesAnnouncement::deserialize(ReadBuffer & in)
+InitialAllRangesAnnouncement InitialAllRangesAnnouncement::deserialize(ReadBuffer & in)
 {
     UInt64 version;
     readIntBinary(version, in);
@@ -134,11 +146,21 @@ void InitialAllRangesAnnouncement::deserialize(ReadBuffer & in)
             "from replicas differ. Got: {}, supported version: {}",
             version, DBMS_PARALLEL_REPLICAS_PROTOCOL_VERSION);
 
+    CoordinationMode mode;
+    RangesInDataPartsDescription description;
+    size_t replica_num;
+
     uint8_t mode_candidate;
     readIntBinary(mode_candidate, in);
     mode = validateAndGet(mode_candidate);
     description.deserialize(in);
     readIntBinary(replica_num, in);
+
+    return InitialAllRangesAnnouncement {
+        mode,
+        description,
+        replica_num
+    };
 }
 
 }
diff --git a/src/Storages/MergeTree/RequestResponse.h b/src/Storages/MergeTree/RequestResponse.h
index 7e5563c0553..3a5bfde6c20 100644
--- a/src/Storages/MergeTree/RequestResponse.h
+++ b/src/Storages/MergeTree/RequestResponse.h
@@ -40,21 +40,40 @@ struct PartBlockRange
     }
 };
 
+/// ParallelReadRequest is used by remote replicas during parallel read
+/// to signal an initiator that they need more marks to read.
 struct ParallelReadRequest
 {
+    /// No default constructor, you must initialize all fields at once.
+
+    ParallelReadRequest(
+        CoordinationMode mode_,
+        size_t replica_num_,
+        size_t min_number_of_marks_,
+        RangesInDataPartsDescription description_)
+        : mode(mode_)
+        , replica_num(replica_num_)
+        , min_number_of_marks(min_number_of_marks_)
+        , description(std::move(description_))
+    {}
+
     CoordinationMode mode;
     size_t replica_num;
     size_t min_number_of_marks;
-
-    /// Extension for ordered mode
+    /// Extension for Ordered (InOrder or ReverseOrder) mode
+    /// Contains only data part names without mark ranges.
     RangesInDataPartsDescription description;
 
     void serialize(WriteBuffer & out) const;
     String describe() const;
-    void deserialize(ReadBuffer & in);
+    static ParallelReadRequest deserialize(ReadBuffer & in);
     void merge(ParallelReadRequest & other);
 };
 
+/// ParallelReadResponse is used by an initiator to tell
+/// remote replicas about what to read during parallel reading.
+/// Additionally contains information whether there are more available
+/// marks to read (whether it is the last packet or not).
 struct ParallelReadResponse
 {
     bool finish{false};
@@ -66,15 +85,30 @@ struct ParallelReadResponse
 };
 
 
+/// The set of parts (their names) along with ranges to read which is sent back
+/// to the initiator by remote replicas during parallel reading.
+/// Additionally contains an identifier (replica_num) plus
+/// the reading algorithm chosen (Default, InOrder or ReverseOrder).
 struct InitialAllRangesAnnouncement
 {
+    /// No default constructor, you must initialize all fields at once.
+
+    InitialAllRangesAnnouncement(
+        CoordinationMode mode_,
+        RangesInDataPartsDescription description_,
+        size_t replica_num_)
+        : mode(mode_)
+        , description(description_)
+        , replica_num(replica_num_)
+    {}
+
     CoordinationMode mode;
     RangesInDataPartsDescription description;
     size_t replica_num;
 
     void serialize(WriteBuffer & out) const;
     String describe();
-    void deserialize(ReadBuffer & in);
+    static InitialAllRangesAnnouncement deserialize(ReadBuffer & in);
 };
 
 

From a029105fd51044d692c0b2895dd9d5ce09b28036 Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nk@clickhouse.com>
Date: Wed, 28 Jun 2023 10:35:19 +0000
Subject: [PATCH 1338/1478] Fix duplicate storage set logical error.

---
 src/Interpreters/ActionsVisitor.cpp               |  3 +++
 .../02809_storage_set_analysis_bug.reference      |  0
 .../02809_storage_set_analysis_bug.sql            | 15 +++++++++++++++
 3 files changed, 18 insertions(+)
 create mode 100644 tests/queries/0_stateless/02809_storage_set_analysis_bug.reference
 create mode 100644 tests/queries/0_stateless/02809_storage_set_analysis_bug.sql

diff --git a/src/Interpreters/ActionsVisitor.cpp b/src/Interpreters/ActionsVisitor.cpp
index cfbe53b5e4d..10502b7e66d 100644
--- a/src/Interpreters/ActionsVisitor.cpp
+++ b/src/Interpreters/ActionsVisitor.cpp
@@ -1435,6 +1435,9 @@ FutureSetPtr ActionsMatcher::makeSet(const ASTFunction & node, Data & data, bool
 
             if (table)
             {
+                if (auto set = data.prepared_sets->findStorage(set_key))
+                    return set;
+
                 if (StorageSet * storage_set = dynamic_cast<StorageSet *>(table.get()))
                     return data.prepared_sets->addFromStorage(set_key, storage_set->getSet());
             }
diff --git a/tests/queries/0_stateless/02809_storage_set_analysis_bug.reference b/tests/queries/0_stateless/02809_storage_set_analysis_bug.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql b/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql
new file mode 100644
index 00000000000..212170571f7
--- /dev/null
+++ b/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql
@@ -0,0 +1,15 @@
+DROP TABLE IF EXISTS test_set;
+DROP TABLE IF EXISTS null_in__fuzz_6;
+
+set allow_suspicious_low_cardinality_types = 1;
+
+
+CREATE TABLE null_in__fuzz_6 (`dt` LowCardinality(UInt16), `idx` Int32, `i` Nullable(Int256), `s` Int32) ENGINE = MergeTree PARTITION BY dt ORDER BY idx;
+insert into null_in__fuzz_6 select * from generateRandom() limit 1;
+
+SET transform_null_in = 0;
+
+CREATE TABLE test_set (i Nullable(int)) ENGINE = Set();
+INSERT INTO test_set VALUES (1), (NULL);
+
+SELECT count() = 1 FROM null_in__fuzz_6 PREWHERE 71 WHERE i IN (test_set); -- { serverError CANNOT_CONVERT_TYPE }

From d3677adcdf367ec87aba49ec844c607a9d6c987d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1nos=20Benjamin=20Antal?=
 <benjamin.antal@clickhouse.com>
Date: Wed, 28 Jun 2023 10:37:38 +0000
Subject: [PATCH 1339/1478] Import missing module

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

diff --git a/tests/integration/test_ssl_cert_authentication/test.py b/tests/integration/test_ssl_cert_authentication/test.py
index 91faf8b0ce3..ff2de7491e1 100644
--- a/tests/integration/test_ssl_cert_authentication/test.py
+++ b/tests/integration/test_ssl_cert_authentication/test.py
@@ -6,6 +6,7 @@ import urllib.request, urllib.parse
 import ssl
 import os.path
 from os import remove
+import logging
 
 
 # The test cluster is configured with certificate for that host name, see 'server-ext.cnf'.

From 82fd863ad4eb1209ca66e660d7cf3b646f88fff7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Wed, 28 Jun 2023 13:39:47 +0300
Subject: [PATCH 1340/1478] Update 02809_storage_set_analysis_bug.sql

---
 tests/queries/0_stateless/02809_storage_set_analysis_bug.sql | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql b/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql
index 212170571f7..531946acda0 100644
--- a/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql
+++ b/tests/queries/0_stateless/02809_storage_set_analysis_bug.sql
@@ -3,7 +3,6 @@ DROP TABLE IF EXISTS null_in__fuzz_6;
 
 set allow_suspicious_low_cardinality_types = 1;
 
-
 CREATE TABLE null_in__fuzz_6 (`dt` LowCardinality(UInt16), `idx` Int32, `i` Nullable(Int256), `s` Int32) ENGINE = MergeTree PARTITION BY dt ORDER BY idx;
 insert into null_in__fuzz_6 select * from generateRandom() limit 1;
 
@@ -13,3 +12,6 @@ CREATE TABLE test_set (i Nullable(int)) ENGINE = Set();
 INSERT INTO test_set VALUES (1), (NULL);
 
 SELECT count() = 1 FROM null_in__fuzz_6 PREWHERE 71 WHERE i IN (test_set); -- { serverError CANNOT_CONVERT_TYPE }
+
+DROP TABLE test_set;
+DROP TABLE null_in__fuzz_6;

From 3c8c4ce449fb9bfa74de74a0756b85f9c149efbe Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 28 Jun 2023 13:16:26 +0200
Subject: [PATCH 1341/1478] Update test.py

---
 tests/integration/test_storage_postgresql/test.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/integration/test_storage_postgresql/test.py b/tests/integration/test_storage_postgresql/test.py
index d60a90ed7ce..05d4b1e12ef 100644
--- a/tests/integration/test_storage_postgresql/test.py
+++ b/tests/integration/test_storage_postgresql/test.py
@@ -335,7 +335,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 18
+    assert count <= 19
 
     busy_pool = Pool(30)
     p = busy_pool.map_async(node_insert_select, range(30))
@@ -347,7 +347,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 18
+    assert count <= 20
 
     node1.query("DROP TABLE test.test_table;")
     node1.query("DROP TABLE test.stat;")

From 06206d092d843fd3e6c005609008cd85597f9124 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 28 Jun 2023 13:18:53 +0200
Subject: [PATCH 1342/1478] Update test.py

---
 tests/integration/test_storage_postgresql/test.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/integration/test_storage_postgresql/test.py b/tests/integration/test_storage_postgresql/test.py
index 05d4b1e12ef..83eb4f6f02a 100644
--- a/tests/integration/test_storage_postgresql/test.py
+++ b/tests/integration/test_storage_postgresql/test.py
@@ -323,7 +323,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 18
+    assert count <= 18 # 16 for test.test_table + 1 for conn + 1 for test.stat
 
     busy_pool = Pool(30)
     p = busy_pool.map_async(node_insert, range(30))
@@ -335,7 +335,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 19
+    assert count <= 19 # 16 for test.test_table + 1 for conn + at most 2 for test.stat
 
     busy_pool = Pool(30)
     p = busy_pool.map_async(node_insert_select, range(30))
@@ -347,7 +347,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 20
+    assert count <= 20 # 16 for test.test_table + 1 for conn + at most 3 for test.stat
 
     node1.query("DROP TABLE test.test_table;")
     node1.query("DROP TABLE test.stat;")

From 5443987113e0417c310eaf7bbfdfdf26de64f142 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Wed, 28 Jun 2023 11:33:45 +0000
Subject: [PATCH 1343/1478] Automatic style fix

---
 tests/integration/test_storage_postgresql/test.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/integration/test_storage_postgresql/test.py b/tests/integration/test_storage_postgresql/test.py
index 83eb4f6f02a..9f7c012e66f 100644
--- a/tests/integration/test_storage_postgresql/test.py
+++ b/tests/integration/test_storage_postgresql/test.py
@@ -323,7 +323,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 18 # 16 for test.test_table + 1 for conn + 1 for test.stat
+    assert count <= 18  # 16 for test.test_table + 1 for conn + 1 for test.stat
 
     busy_pool = Pool(30)
     p = busy_pool.map_async(node_insert, range(30))
@@ -335,7 +335,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 19 # 16 for test.test_table + 1 for conn + at most 2 for test.stat
+    assert count <= 19  # 16 for test.test_table + 1 for conn + at most 2 for test.stat
 
     busy_pool = Pool(30)
     p = busy_pool.map_async(node_insert_select, range(30))
@@ -347,7 +347,7 @@ def test_concurrent_queries(started_cluster):
         )
     )
     print(count)
-    assert count <= 20 # 16 for test.test_table + 1 for conn + at most 3 for test.stat
+    assert count <= 20  # 16 for test.test_table + 1 for conn + at most 3 for test.stat
 
     node1.query("DROP TABLE test.test_table;")
     node1.query("DROP TABLE test.stat;")

From 5a1bbe5a8d2f07960161100e0a17527e4bda6de2 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 28 Jun 2023 14:05:14 +0200
Subject: [PATCH 1344/1478] Update CachedOnDiskReadBufferFromFile.cpp

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 960d2a72410..5b42f41fbf3 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -852,9 +852,7 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
     else
     {
         implementation_buffer = getImplementationBuffer(file_segments->front());
-
-        if (read_type == ReadType::CACHED)
-            file_segments->front().use();
+        file_segments->front().use();
     }
 
     chassert(!internal_buffer.empty());

From 15f64a7cb9a07d48e92fd0db6ea1f9b8227b0e5e Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 28 Jun 2023 15:26:17 +0200
Subject: [PATCH 1345/1478] Add some checks

---
 src/Interpreters/Cache/FileSegment.cpp        |  3 ++-
 src/Interpreters/Cache/IFileCachePriority.h   |  2 +-
 .../Cache/LRUFileCachePriority.cpp            | 19 +++++++++++++++----
 src/Interpreters/Cache/LRUFileCachePriority.h |  4 +++-
 src/Interpreters/Cache/Metadata.cpp           |  4 ++--
 5 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 95592fc7c12..e97d708ba74 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -872,6 +872,7 @@ void FileSegment::setDetachedState(const FileSegmentGuard::Lock & lock)
     setDownloadState(State::DETACHED, lock);
     key_metadata.reset();
     cache = nullptr;
+    queue_iterator = nullptr;
 }
 
 void FileSegment::detach(const FileSegmentGuard::Lock & lock, const LockedKey &)
@@ -890,7 +891,7 @@ void FileSegment::use()
 
     if (!cache)
     {
-        chassert(isCompleted(true));
+        chassert(isDetached());
         return;
     }
 
diff --git a/src/Interpreters/Cache/IFileCachePriority.h b/src/Interpreters/Cache/IFileCachePriority.h
index 10f63fce21d..34c49653ab8 100644
--- a/src/Interpreters/Cache/IFileCachePriority.h
+++ b/src/Interpreters/Cache/IFileCachePriority.h
@@ -44,7 +44,7 @@ public:
 
         virtual size_t use(const CacheGuard::Lock &) = 0;
 
-        virtual std::shared_ptr<IIterator> remove(const CacheGuard::Lock &) = 0;
+        virtual void remove(const CacheGuard::Lock &) = 0;
 
         virtual const Entry & getEntry() const = 0;
 
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index 6f142c0cc6d..18862e154da 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -166,15 +166,17 @@ void LRUFileCachePriority::iterate(IterateFunc && func, const CacheGuard::Lock &
     }
 }
 
-LRUFileCachePriority::Iterator
-LRUFileCachePriority::LRUFileCacheIterator::remove(const CacheGuard::Lock &)
+void LRUFileCachePriority::LRUFileCacheIterator::remove(const CacheGuard::Lock &)
 {
-    return std::make_shared<LRUFileCacheIterator>(
-        cache_priority, cache_priority->remove(queue_iter));
+    checkUsable();
+    cache_priority->remove(queue_iter);
+    queue_iter = LRUQueueIterator{};
 }
 
 void LRUFileCachePriority::LRUFileCacheIterator::invalidate()
 {
+    checkUsable();
+
     LOG_TEST(
         cache_priority->log,
         "Invalidating entry in LRU queue. Key: {}, offset: {}, previous size: {}",
@@ -187,6 +189,8 @@ void LRUFileCachePriority::LRUFileCacheIterator::invalidate()
 
 void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
 {
+    checkUsable();
+
     LOG_TEST(
         cache_priority->log,
         "Update size with {} in LRU queue for key: {}, offset: {}, previous size: {}",
@@ -198,8 +202,15 @@ void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
 
 size_t LRUFileCachePriority::LRUFileCacheIterator::use(const CacheGuard::Lock &)
 {
+    checkUsable();
     cache_priority->queue.splice(cache_priority->queue.end(), cache_priority->queue, queue_iter);
     return ++queue_iter->hits;
 }
 
+void LRUFileCachePriority::LRUFileCacheIterator::checkUsable() const
+{
+    if (queue_iter == LRUQueueIterator{})
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to use invalid iterator");
+}
+
 }
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.h b/src/Interpreters/Cache/LRUFileCachePriority.h
index 8dc4eb0a016..e0d7d45062a 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.h
+++ b/src/Interpreters/Cache/LRUFileCachePriority.h
@@ -60,13 +60,15 @@ public:
 
     size_t use(const CacheGuard::Lock &) override;
 
-    Iterator remove(const CacheGuard::Lock &) override;
+    void remove(const CacheGuard::Lock &) override;
 
     void invalidate() override;
 
     void updateSize(int64_t size) override;
 
 private:
+    void checkUsable() const;
+
     LRUFileCachePriority * cache_priority;
     mutable LRUFileCachePriority::LRUQueueIterator queue_iter;
 };
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 8c8524f7fa7..a77a9072cb6 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -147,7 +147,6 @@ String CacheMetadata::getFileNameForFileSegment(size_t offset, FileSegmentKind s
             file_suffix = "_temporary";
             break;
         case FileSegmentKind::Regular:
-            file_suffix = "";
             break;
     }
     return std::to_string(offset) + file_suffix;
@@ -398,6 +397,8 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     if (file_segment->queue_iterator)
         file_segment->queue_iterator->invalidate();
 
+    file_segment->detach(segment_lock, *this);
+
     const auto path = key_metadata->getFileSegmentPath(*file_segment);
     bool exists = fs::exists(path);
     if (exists)
@@ -408,7 +409,6 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     else if (file_segment->downloaded_size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist", path);
 
-    file_segment->detach(segment_lock, *this);
     return key_metadata->erase(it);
 }
 

From c42bf37a141decb206e405470c2af6d85145bf3f Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 28 Jun 2023 09:59:32 -0400
Subject: [PATCH 1346/1478] list the disk types

---
 .../engines/table-engines/mergetree-family/mergetree.md   | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index 42454af6feb..c67ac8fa4ef 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -756,6 +756,14 @@ If you perform the `SELECT` query between merges, you may get expired data. To a
 - [ttl_only_drop_parts](/docs/en/operations/settings/settings.md/#ttl_only_drop_parts) setting
 
 
+## Disk types
+
+In addition to local block devices, ClickHouse supports other device types through table engines. These are the types:
+- [S3](#table_engine-mergetree-s3)
+- GCS (also supported using the [S3 table engine](#table_engine-mergetree-s3))
+- [Azure Blob Storage](#table_engine-mergetree-azure-blob-storage)
+- [HDFS](/docs/en/sql-reference/table-functions/hdfs.md)
+
 ## Using Multiple Block Devices for Data Storage {#table_engine-mergetree-multiple-volumes}
 
 ### Introduction {#introduction}

From f57d91b678226094bc55074b3df1ce8ba630fb5f Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Wed, 28 Jun 2023 17:14:58 +0300
Subject: [PATCH 1347/1478] Update 02803_remote_cannot_clone_block.sql

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

diff --git a/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql b/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql
index 3e14aa6be96..6d79aa76d18 100644
--- a/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql
+++ b/tests/queries/0_stateless/02803_remote_cannot_clone_block.sql
@@ -6,6 +6,8 @@ SELECT *
 FROM system.numbers
 LIMIT 10000;
 
+SET allow_experimental_analyzer = 0;
+
 SELECT *
 FROM
 (

From 0b19c1832a7afd9015e1872a932b2d28b326117c Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 28 Jun 2023 14:15:03 +0000
Subject: [PATCH 1348/1478] Fix: detach from thread group

---
 src/Dictionaries/HashedDictionary.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/Dictionaries/HashedDictionary.cpp b/src/Dictionaries/HashedDictionary.cpp
index eb1d98a8f39..798f37cb516 100644
--- a/src/Dictionaries/HashedDictionary.cpp
+++ b/src/Dictionaries/HashedDictionary.cpp
@@ -10,6 +10,7 @@
 #include <Common/ConcurrentBoundedQueue.h>
 #include <Common/CurrentMetrics.h>
 #include <Common/MemoryTrackerBlockerInThread.h>
+#include <Common/scope_guard_safe.h>
 
 #include <Core/Defines.h>
 
@@ -69,6 +70,11 @@ public:
             shards_queues[shard].emplace(backlog);
             pool.scheduleOrThrowOnError([this, shard, thread_group = CurrentThread::getGroup()]
             {
+                SCOPE_EXIT_SAFE(
+                    if (thread_group)
+                        CurrentThread::detachFromGroupIfNotDetached();
+                );
+
                 /// Do not account memory that was occupied by the dictionaries for the query/user context.
                 MemoryTrackerBlockerInThread memory_blocker;
 

From bfcadabb927e5ea547c29df488d3fe6ea396a178 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 28 Jun 2023 10:30:49 -0400
Subject: [PATCH 1349/1478] add web disk type

---
 docs/en/engines/table-engines/mergetree-family/mergetree.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index c67ac8fa4ef..1f084fe075b 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -763,6 +763,7 @@ In addition to local block devices, ClickHouse supports other device types throu
 - GCS (also supported using the [S3 table engine](#table_engine-mergetree-s3))
 - [Azure Blob Storage](#table_engine-mergetree-azure-blob-storage)
 - [HDFS](/docs/en/sql-reference/table-functions/hdfs.md)
+- [Web (read-only)](#web-storage)
 
 ## Using Multiple Block Devices for Data Storage {#table_engine-mergetree-multiple-volumes}
 
@@ -944,6 +945,8 @@ configuration files; all the settings are in the CREATE/ATTACH query.
 The example uses `type=web`, but any disk type can be configured as dynamic, even Local disk. Local disks require a path argument to be inside the server config parameter `custom_local_disks_base_directory`, which has no default, so set that also when using local disk.
 :::
 
+#### Example dynamic web storage {#web-storage}
+
 ```sql
 ATTACH TABLE uk_price_paid UUID 'cf712b4f-2ca8-435c-ac23-c4393efe52f7'
 (

From b392127304d8c14ce34bd86d0b8ca561e1559919 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 28 Jun 2023 11:00:07 -0400
Subject: [PATCH 1350/1478] add example web config

---
 .../mergetree-family/mergetree.md             | 53 ++++++++++++++++++-
 1 file changed, 52 insertions(+), 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 1f084fe075b..b87c4d216cf 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -945,7 +945,7 @@ configuration files; all the settings are in the CREATE/ATTACH query.
 The example uses `type=web`, but any disk type can be configured as dynamic, even Local disk. Local disks require a path argument to be inside the server config parameter `custom_local_disks_base_directory`, which has no default, so set that also when using local disk.
 :::
 
-#### Example dynamic web storage {#web-storage}
+#### Example dynamic web storage
 
 ```sql
 ATTACH TABLE uk_price_paid UUID 'cf712b4f-2ca8-435c-ac23-c4393efe52f7'
@@ -1249,6 +1249,57 @@ Examples of working configurations can be found in integration tests directory (
   Zero-copy replication is disabled by default in ClickHouse version 22.8 and higher.  This feature is not recommended for production use.
   :::
 
+## Web storage (read-only) {#web-storage}
+
+Web storage can be used for read-only purposes. An example use is for hosting sample
+data, or for migrating data.
+
+:::tip
+Storage can also be configured temporarily within a query, if a web dataset is not expected
+to be used routinely, see [dynamic storage](#dynamic-storage) and skip editing the
+configuration file.
+:::
+
+In this sample configuration:
+- the disk is of type `web`
+- the data is hosted at `http://nginx:80/test1/`
+- a cache on local storage is used 
+
+```xml
+<clickhouse>
+    <storage_configuration>
+        <disks>
+            <web>
+                <type>web</type>
+                <endpoint>http://nginx:80/test1/</endpoint>
+            </web>
+            <cached_web>
+                <type>cache</type>
+                <disk>web</disk>
+                <path>cached_web_cache/</path>
+                <max_size>100000000</max_size>
+            </cached_web>
+        </disks>
+        <policies>
+            <web>
+                <volumes>
+                    <main>
+                        <disk>web</disk>
+                    </main>
+                </volumes>
+            </web>
+            <cached_web>
+                <volumes>
+                    <main>
+                        <disk>cached_web</disk>
+                    </main>
+                </volumes>
+            </cached_web>
+        </policies>
+    </storage_configuration>
+</clickhouse>
+```
+
 ## Virtual Columns {#virtual-columns}
 
 - `_part` — Name of a part.

From dd3a744cef6e736bc68782fd79853a1535bdebb8 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 28 Jun 2023 11:17:16 -0400
Subject: [PATCH 1351/1478] add HDFS example

---
 .../mergetree-family/mergetree.md             | 38 ++++++++++++++++++-
 1 file changed, 37 insertions(+), 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 b87c4d216cf..1b7f3263ab9 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -762,7 +762,7 @@ In addition to local block devices, ClickHouse supports other device types throu
 - [S3](#table_engine-mergetree-s3)
 - GCS (also supported using the [S3 table engine](#table_engine-mergetree-s3))
 - [Azure Blob Storage](#table_engine-mergetree-azure-blob-storage)
-- [HDFS](/docs/en/sql-reference/table-functions/hdfs.md)
+- [HDFS](#hdfs-storage)
 - [Web (read-only)](#web-storage)
 
 ## Using Multiple Block Devices for Data Storage {#table_engine-mergetree-multiple-volumes}
@@ -1249,6 +1249,42 @@ Examples of working configurations can be found in integration tests directory (
   Zero-copy replication is disabled by default in ClickHouse version 22.8 and higher.  This feature is not recommended for production use.
   :::
 
+## HDFS storage {#hdfs-storage}
+
+In this sample configuration:
+- the disk is of type `hdfs`
+- the data is hosted at `hdfs://hdfs1:9000/clickhouse/`
+
+```xml
+<clickhouse>
+    <storage_configuration>
+        <disks>
+            <hdfs>
+                <type>hdfs</type>
+                <endpoint>hdfs://hdfs1:9000/clickhouse/</endpoint>
+                <skip_access_check>true</skip_access_check>
+            </hdfs>
+            <hdd>
+                <type>local</type>
+                <path>/</path>
+            </hdd>
+        </disks>
+        <policies>
+            <hdfs>
+                <volumes>
+                    <main>
+                        <disk>hdfs</disk>
+                    </main>
+                    <external>
+                        <disk>hdd</disk>
+                    </external>
+                </volumes>
+            </hdfs>
+        </policies>
+    </storage_configuration>
+</clickhouse>
+```
+
 ## Web storage (read-only) {#web-storage}
 
 Web storage can be used for read-only purposes. An example use is for hosting sample

From 594ec09edf0d63b73e02c2dbbee6cc500eb52d87 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 28 Jun 2023 18:19:16 +0200
Subject: [PATCH 1352/1478] fix missing metadata_version.txt

---
 .../MergeTree/DataPartStorageOnDiskBase.cpp   | 26 ++++----
 .../MergeTree/DataPartStorageOnDiskBase.h     |  5 +-
 src/Storages/MergeTree/IDataPartStorage.h     | 31 +++++++--
 src/Storages/MergeTree/IMergeTreeDataPart.cpp | 20 +++---
 src/Storages/MergeTree/MergeTreeData.cpp      | 35 +++++------
 src/Storages/MergeTree/MergeTreeData.h        | 13 +---
 src/Storages/MergeTree/MutateTask.cpp         | 11 +++-
 src/Storages/MergeTree/MutateTask.h           |  2 +-
 src/Storages/StorageMergeTree.cpp             |  6 +-
 src/Storages/StorageReplicatedMergeTree.cpp   | 63 +++++++++++--------
 10 files changed, 120 insertions(+), 92 deletions(-)

diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
index 30776a8bc50..c850ebaa6fd 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskBase.cpp
@@ -415,41 +415,41 @@ void DataPartStorageOnDiskBase::backup(
 MutableDataPartStoragePtr DataPartStorageOnDiskBase::freeze(
     const std::string & to,
     const std::string & dir_path,
-    bool make_source_readonly,
     std::function<void(const DiskPtr &)> save_metadata_callback,
-    bool copy_instead_of_hardlink,
-    const NameSet & files_to_copy_instead_of_hardlinks,
-    DiskTransactionPtr external_transaction) const
+    const ClonePartParams & params) const
 {
     auto disk = volume->getDisk();
-    if (external_transaction)
-        external_transaction->createDirectories(to);
+    if (params.external_transaction)
+        params.external_transaction->createDirectories(to);
     else
         disk->createDirectories(to);
 
-    localBackup(disk, getRelativePath(), fs::path(to) / dir_path, make_source_readonly, {}, copy_instead_of_hardlink, files_to_copy_instead_of_hardlinks, external_transaction);
+    localBackup(disk, getRelativePath(), fs::path(to) / dir_path, params.make_source_readonly, {}, params.copy_instead_of_hardlink,
+                params.files_to_copy_instead_of_hardlinks, params.external_transaction);
 
     if (save_metadata_callback)
         save_metadata_callback(disk);
 
-    if (external_transaction)
+    if (params.external_transaction)
     {
-        external_transaction->removeFileIfExists(fs::path(to) / dir_path / "delete-on-destroy.txt");
-        external_transaction->removeFileIfExists(fs::path(to) / dir_path / "txn_version.txt");
-        external_transaction->removeFileIfExists(fs::path(to) / dir_path / IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
+        params.external_transaction->removeFileIfExists(fs::path(to) / dir_path / "delete-on-destroy.txt");
+        params.external_transaction->removeFileIfExists(fs::path(to) / dir_path / "txn_version.txt");
+        if (!params.keep_metadata_version)
+            params.external_transaction->removeFileIfExists(fs::path(to) / dir_path / IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
     }
     else
     {
         disk->removeFileIfExists(fs::path(to) / dir_path / "delete-on-destroy.txt");
         disk->removeFileIfExists(fs::path(to) / dir_path / "txn_version.txt");
-        disk->removeFileIfExists(fs::path(to) / dir_path / IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
+        if (!params.keep_metadata_version)
+            disk->removeFileIfExists(fs::path(to) / dir_path / IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
     }
 
     auto single_disk_volume = std::make_shared<SingleDiskVolume>(disk->getName(), disk, 0);
 
     /// Do not initialize storage in case of DETACH because part may be broken.
     bool to_detached = dir_path.starts_with("detached/");
-    return create(single_disk_volume, to, dir_path, /*initialize=*/ !to_detached && !external_transaction);
+    return create(single_disk_volume, to, dir_path, /*initialize=*/ !to_detached && !params.external_transaction);
 }
 
 MutableDataPartStoragePtr DataPartStorageOnDiskBase::clonePart(
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskBase.h b/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
index 043953eb20c..5f7dcc3fd32 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskBase.h
@@ -62,11 +62,8 @@ public:
     MutableDataPartStoragePtr freeze(
         const std::string & to,
         const std::string & dir_path,
-        bool make_source_readonly,
         std::function<void(const DiskPtr &)> save_metadata_callback,
-        bool copy_instead_of_hardlink,
-        const NameSet & files_to_copy_instead_of_hardlinks,
-        DiskTransactionPtr external_transaction) const override;
+        const ClonePartParams & params) const override;
 
     MutableDataPartStoragePtr clonePart(
         const std::string & to,
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index 9d6c5d0dcba..b40a9aa1b46 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -63,6 +63,9 @@ using DiskPtr = std::shared_ptr<IDisk>;
 class ISyncGuard;
 using SyncGuardPtr = std::unique_ptr<ISyncGuard>;
 
+class MergeTreeTransaction;
+using MergeTreeTransactionPtr = std::shared_ptr<MergeTreeTransaction>;
+
 class IBackupEntry;
 using BackupEntryPtr = std::shared_ptr<const IBackupEntry>;
 using BackupEntries = std::vector<std::pair<String, BackupEntryPtr>>;
@@ -72,6 +75,17 @@ struct WriteSettings;
 
 class TemporaryFileOnDisk;
 
+
+struct HardlinkedFiles
+{
+    /// Shared table uuid where hardlinks live
+    std::string source_table_shared_id;
+    /// Hardlinked from part
+    std::string source_part_name;
+    /// Hardlinked files list
+    NameSet hardlinks_from_source_part;
+};
+
 /// This is an abstraction of storage for data part files.
 /// Ideally, it is assumed to contain read-only methods from IDisk.
 /// It is not fulfilled now, but let's try our best.
@@ -220,14 +234,23 @@ public:
     /// If `external_transaction` is provided, the disk operations (creating directories, hardlinking,
     /// etc) won't be applied immediately; instead, they'll be added to external_transaction, which the
     /// caller then needs to commit.
+
+    struct ClonePartParams
+    {
+        MergeTreeTransactionPtr txn = NO_TRANSACTION_PTR;
+        HardlinkedFiles * hardlinked_files = nullptr;
+        bool copy_instead_of_hardlink = false;
+        NameSet files_to_copy_instead_of_hardlinks;
+        bool keep_metadata_version = false;
+        bool make_source_readonly = false;
+        DiskTransactionPtr external_transaction = nullptr;
+    };
+
     virtual std::shared_ptr<IDataPartStorage> freeze(
         const std::string & to,
         const std::string & dir_path,
-        bool make_source_readonly,
         std::function<void(const DiskPtr &)> save_metadata_callback,
-        bool copy_instead_of_hardlink,
-        const NameSet & files_to_copy_instead_of_hardlinks,
-        DiskTransactionPtr external_transaction = nullptr) const = 0;
+        const ClonePartParams & params) const = 0;
 
     /// Make a full copy of a data part into 'to/dir_path' (possibly to a different disk).
     virtual std::shared_ptr<IDataPartStorage> clonePart(
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index 85edba84296..1f105951757 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -1363,6 +1363,8 @@ void IMergeTreeDataPart::loadColumns(bool require)
     {
         loaded_metadata_version = metadata_snapshot->getMetadataVersion();
         old_part_with_no_metadata_version_on_disk = true;
+        LOG_WARNING(storage.log, "Part {} doesn't have metadata version on disk, setting it to {}. "
+                    "It's okay if the part was created by an old version of ClickHouse", name, loaded_metadata_version);
     }
 
     setColumns(loaded_columns, infos, loaded_metadata_version);
@@ -1765,12 +1767,6 @@ void IMergeTreeDataPart::renameToDetached(const String & prefix)
 
 DataPartStoragePtr IMergeTreeDataPart::makeCloneInDetached(const String & prefix, const StorageMetadataPtr & /*metadata_snapshot*/) const
 {
-    auto storage_settings = storage.getSettings();
-
-    /// In case of zero-copy replication we copy directory instead of hardlinks
-    /// because hardlinks tracking doesn't work for detached parts.
-    bool copy_instead_of_hardlink = isStoredOnRemoteDiskWithZeroCopySupport() && storage.supportsReplication() && storage_settings->allow_remote_fs_zero_copy_replication;
-
     /// Avoid unneeded duplicates of broken parts if we try to detach the same broken part multiple times.
     /// Otherwise it may pollute detached/ with dirs with _tryN suffix and we will fail to remove broken part after 10 attempts.
     bool broken = !prefix.empty();
@@ -1778,13 +1774,19 @@ DataPartStoragePtr IMergeTreeDataPart::makeCloneInDetached(const String & prefix
     if (!maybe_path_in_detached)
         return nullptr;
 
+    /// In case of zero-copy replication we copy directory instead of hardlinks
+    /// because hardlinks tracking doesn't work for detached parts.
+    auto storage_settings = storage.getSettings();
+    IDataPartStorage::ClonePartParams params
+    {
+        .copy_instead_of_hardlink = isStoredOnRemoteDiskWithZeroCopySupport() && storage.supportsReplication() && storage_settings->allow_remote_fs_zero_copy_replication,
+        .make_source_readonly = true
+    };
     return getDataPartStorage().freeze(
         storage.relative_data_path,
         *maybe_path_in_detached,
-        /*make_source_readonly=*/ true,
         /*save_metadata_callback=*/ {},
-        copy_instead_of_hardlink,
-        /*files_to_copy_instead_of_hardlinks=*/ {});
+        params);
 }
 
 MutableDataPartStoragePtr IMergeTreeDataPart::makeCloneOnDisk(const DiskPtr & disk, const String & directory_name) const
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index e9c3a7f66ae..f3cf4a85953 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -7289,10 +7289,7 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
     const String & tmp_part_prefix,
     const MergeTreePartInfo & dst_part_info,
     const StorageMetadataPtr & metadata_snapshot,
-    const MergeTreeTransactionPtr & txn,
-    HardlinkedFiles * hardlinked_files,
-    bool copy_instead_of_hardlink,
-    const NameSet & files_to_copy_instead_of_hardlinks)
+    const IDataPartStorage::ClonePartParams & params)
 {
     /// Check that the storage policy contains the disk where the src_part is located.
     bool does_storage_policy_allow_same_disk = false;
@@ -7343,16 +7340,14 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
     }
 
     String with_copy;
-    if (copy_instead_of_hardlink)
+    if (params.copy_instead_of_hardlink)
         with_copy = " (copying data)";
 
     auto dst_part_storage = src_part_storage->freeze(
         relative_data_path,
         tmp_dst_part_name,
-        /*make_source_readonly=*/ false,
         /*save_metadata_callback=*/ {},
-        copy_instead_of_hardlink,
-        files_to_copy_instead_of_hardlinks);
+        params);
 
     LOG_DEBUG(log, "Clone{} part {} to {}{}",
               src_flushed_tmp_part ? " flushed" : "",
@@ -7364,18 +7359,18 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
         .withPartFormatFromDisk()
         .build();
 
-    if (!copy_instead_of_hardlink && hardlinked_files)
+    if (!params.copy_instead_of_hardlink && params.hardlinked_files)
     {
-        hardlinked_files->source_part_name = src_part->name;
-        hardlinked_files->source_table_shared_id = src_part->storage.getTableSharedID();
+        params.hardlinked_files->source_part_name = src_part->name;
+        params.hardlinked_files->source_table_shared_id = src_part->storage.getTableSharedID();
 
         for (auto it = src_part->getDataPartStorage().iterate(); it->isValid(); it->next())
         {
-            if (!files_to_copy_instead_of_hardlinks.contains(it->name())
+            if (!params.files_to_copy_instead_of_hardlinks.contains(it->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());
+                params.hardlinked_files->hardlinks_from_source_part.insert(it->name());
             }
         }
 
@@ -7386,18 +7381,18 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
             for (auto it = projection_storage.iterate(); it->isValid(); it->next())
             {
                 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)
+                if (!params.files_to_copy_instead_of_hardlinks.contains(file_name_with_projection_prefix)
                     && 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);
+                    params.hardlinked_files->hardlinks_from_source_part.insert(file_name_with_projection_prefix);
                 }
             }
         }
     }
 
     /// We should write version metadata on part creation to distinguish it from parts that were created without transaction.
-    TransactionID tid = txn ? txn->tid : Tx::PrehistoricTID;
+    TransactionID tid = params.txn ? params.txn->tid : Tx::PrehistoricTID;
     dst_data_part->version.setCreationTID(tid, nullptr);
     dst_data_part->storeVersionMetadata();
 
@@ -7579,13 +7574,15 @@ PartitionCommandsResultInfo MergeTreeData::freezePartitionsByMatcher(
             createAndStoreFreezeMetadata(disk, part, fs::path(backup_part_path) / part->getDataPartStorage().getPartDirectory());
         };
 
+        IDataPartStorage::ClonePartParams params
+        {
+            .make_source_readonly = true
+        };
         auto new_storage = data_part_storage->freeze(
             backup_part_path,
             part->getDataPartStorage().getPartDirectory(),
-            /*make_source_readonly=*/ true,
             callback,
-            /*copy_instead_of_hardlink=*/ false,
-            /*files_to_copy_instead_of_hardlinks=*/ {});
+            params);
 
         part->is_frozen.store(true, std::memory_order_relaxed);
         result.push_back(PartitionCommandResultInfo{
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index b27392b355b..43e59ccc392 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -828,21 +828,10 @@ public:
     MergeTreeData & checkStructureAndGetMergeTreeData(const StoragePtr & source_table, const StorageMetadataPtr & src_snapshot, const StorageMetadataPtr & my_snapshot) const;
     MergeTreeData & checkStructureAndGetMergeTreeData(IStorage & source_table, const StorageMetadataPtr & src_snapshot, const StorageMetadataPtr & my_snapshot) const;
 
-    struct HardlinkedFiles
-    {
-        /// Shared table uuid where hardlinks live
-        std::string source_table_shared_id;
-        /// Hardlinked from part
-        std::string source_part_name;
-        /// Hardlinked files list
-        NameSet hardlinks_from_source_part;
-    };
-
     std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> cloneAndLoadDataPartOnSameDisk(
         const MergeTreeData::DataPartPtr & src_part, const String & tmp_part_prefix,
         const MergeTreePartInfo & dst_part_info, const StorageMetadataPtr & metadata_snapshot,
-        const MergeTreeTransactionPtr & txn, HardlinkedFiles * hardlinked_files,
-        bool copy_instead_of_hardlink, const NameSet & files_to_copy_instead_of_hardlinks);
+        const IDataPartStorage::ClonePartParams & params);
 
     virtual std::vector<MergeTreeMutationStatus> getMutationsStatus() const = 0;
 
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index a19b9daca0e..f4a071b8f27 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -852,7 +852,7 @@ struct MutationContext
 
     MergeTreeTransactionPtr txn;
 
-    MergeTreeData::HardlinkedFiles hardlinked_files;
+    HardlinkedFiles hardlinked_files;
 
     bool need_prefix = true;
 
@@ -1803,7 +1803,12 @@ bool MutateTask::prepare()
         if (ctx->need_prefix)
             prefix = "tmp_clone_";
 
-        auto [part, lock] = ctx->data->cloneAndLoadDataPartOnSameDisk(ctx->source_part, prefix, ctx->future_part->part_info, ctx->metadata_snapshot, ctx->txn, &ctx->hardlinked_files, false, files_to_copy_instead_of_hardlinks);
+        IDataPartStorage::ClonePartParams clone_params
+        {
+            .txn = ctx->txn, .hardlinked_files = &ctx->hardlinked_files,
+            .files_to_copy_instead_of_hardlinks = std::move(files_to_copy_instead_of_hardlinks), .keep_metadata_version = true
+        };
+        auto [part, lock] = ctx->data->cloneAndLoadDataPartOnSameDisk(ctx->source_part, prefix, ctx->future_part->part_info, ctx->metadata_snapshot, clone_params);
         part->getDataPartStorage().beginTransaction();
 
         ctx->temporary_directory_lock = std::move(lock);
@@ -1932,7 +1937,7 @@ bool MutateTask::prepare()
     return true;
 }
 
-const MergeTreeData::HardlinkedFiles & MutateTask::getHardlinkedFiles() const
+const HardlinkedFiles & MutateTask::getHardlinkedFiles() const
 {
     return ctx->hardlinked_files;
 }
diff --git a/src/Storages/MergeTree/MutateTask.h b/src/Storages/MergeTree/MutateTask.h
index 54ad996ad4c..dc21df018d7 100644
--- a/src/Storages/MergeTree/MutateTask.h
+++ b/src/Storages/MergeTree/MutateTask.h
@@ -45,7 +45,7 @@ public:
         return promise.get_future();
     }
 
-    const MergeTreeData::HardlinkedFiles & getHardlinkedFiles() const;
+    const HardlinkedFiles & getHardlinkedFiles() const;
 
 private:
 
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index c02c96f62be..4c0c0c8e3fa 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -1932,7 +1932,8 @@ void StorageMergeTree::replacePartitionFrom(const StoragePtr & source_table, con
         Int64 temp_index = insert_increment.get();
         MergeTreePartInfo dst_part_info(partition_id, temp_index, temp_index, src_part->info.level);
 
-        auto [dst_part, part_lock] = cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, my_metadata_snapshot, local_context->getCurrentTransaction(), {}, false, {});
+        IDataPartStorage::ClonePartParams clone_params{.txn = local_context->getCurrentTransaction()};
+        auto [dst_part, part_lock] = cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, my_metadata_snapshot, clone_params);
         dst_parts.emplace_back(std::move(dst_part));
         dst_parts_locks.emplace_back(std::move(part_lock));
     }
@@ -2030,7 +2031,8 @@ void StorageMergeTree::movePartitionToTable(const StoragePtr & dest_table, const
         Int64 temp_index = insert_increment.get();
         MergeTreePartInfo dst_part_info(partition_id, temp_index, temp_index, src_part->info.level);
 
-        auto [dst_part, part_lock] = dest_table_storage->cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, dest_metadata_snapshot, local_context->getCurrentTransaction(), {}, false, {});
+        IDataPartStorage::ClonePartParams clone_params{.txn = local_context->getCurrentTransaction()};
+        auto [dst_part, part_lock] = dest_table_storage->cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, dest_metadata_snapshot, clone_params);
         dst_parts.emplace_back(std::move(dst_part));
         dst_parts_locks.emplace_back(std::move(part_lock));
     }
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index b1ba06c77f9..ecc2537f6ad 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -1578,7 +1578,7 @@ void StorageReplicatedMergeTree::checkPartChecksumsAndAddCommitOps(const zkutil:
 }
 
 MergeTreeData::DataPartsVector StorageReplicatedMergeTree::checkPartChecksumsAndCommit(Transaction & transaction,
-    const MutableDataPartPtr & part, std::optional<MergeTreeData::HardlinkedFiles> hardlinked_files, bool replace_zero_copy_lock)
+    const MutableDataPartPtr & part, std::optional<HardlinkedFiles> hardlinked_files, bool replace_zero_copy_lock)
 {
     auto zookeeper = getZooKeeper();
 
@@ -2183,7 +2183,7 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
         /// A replica that will be used to fetch part
         String replica;
 
-        MergeTreeData::HardlinkedFiles hardlinked_files;
+        HardlinkedFiles hardlinked_files;
 
         scope_guard temporary_part_lock;
     };
@@ -2433,8 +2433,6 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
 
     static const String TMP_PREFIX = "tmp_replace_from_";
 
-    std::vector<MergeTreeData::HardlinkedFiles> hardlinked_files_for_parts;
-
     auto obtain_part = [&] (PartDescriptionPtr & part_desc)
     {
         if (part_desc->src_table_part)
@@ -2442,8 +2440,14 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
             if (part_desc->checksum_hex != part_desc->src_table_part->checksums.getTotalChecksumHex())
                 throw Exception(ErrorCodes::UNFINISHED, "Checksums of {} is suddenly changed", part_desc->src_table_part->name);
 
+            bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
+                || dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
+            IDataPartStorage::ClonePartParams clone_params
+            {
+                .copy_instead_of_hardlink = zero_copy_enabled && part_desc->src_table_part->isStoredOnRemoteDiskWithZeroCopySupport()
+            };
             auto [res_part, temporary_part_lock] = cloneAndLoadDataPartOnSameDisk(
-                part_desc->src_table_part, TMP_PREFIX + "clone_", part_desc->new_part_info, metadata_snapshot, NO_TRANSACTION_PTR, &part_desc->hardlinked_files, false, {});
+                part_desc->src_table_part, TMP_PREFIX + "clone_", part_desc->new_part_info, metadata_snapshot, clone_params);
             part_desc->res_part = std::move(res_part);
             part_desc->temporary_part_lock = std::move(temporary_part_lock);
         }
@@ -4270,6 +4274,11 @@ bool StorageReplicatedMergeTree::fetchPart(
             profile_events_scope.getSnapshot());
     };
 
+    auto is_zero_copy_part = [&settings_ptr](const auto & data_part)
+    {
+        return settings_ptr->allow_remote_fs_zero_copy_replication && data_part->isStoredOnRemoteDiskWithZeroCopySupport();
+    };
+
     DataPartPtr part_to_clone;
     {
         /// If the desired part is a result of a part mutation, try to find the source part and compare
@@ -4281,7 +4290,7 @@ bool StorageReplicatedMergeTree::fetchPart(
         auto source_part = getActiveContainingPart(covered_part_info);
 
         /// Fetch for zero-copy replication is cheap and straightforward, so we don't use local clone here
-        if (source_part && (!settings_ptr->allow_remote_fs_zero_copy_replication || !source_part->getDataPartStorage().supportZeroCopyReplication()))
+        if (source_part && !is_zero_copy_part(source_part))
         {
             auto source_part_header = ReplicatedMergeTreePartHeader::fromColumnsAndChecksums(
                 source_part->getColumns(), source_part->checksums);
@@ -4330,14 +4339,15 @@ bool StorageReplicatedMergeTree::fetchPart(
     InterserverCredentialsPtr credentials;
     std::optional<CurrentlySubmergingEmergingTagger> tagger_ptr;
     std::function<MutableDataPartPtr()> get_part;
-    MergeTreeData::HardlinkedFiles hardlinked_files;
     scope_guard part_directory_lock;
 
     if (part_to_clone)
     {
         get_part = [&, part_to_clone]()
         {
-            auto [cloned_part, lock] = cloneAndLoadDataPartOnSameDisk(part_to_clone, "tmp_clone_", part_info, metadata_snapshot, NO_TRANSACTION_PTR, &hardlinked_files, false, {});
+            chassert(!is_zero_copy_part(part_to_clone));
+            IDataPartStorage::ClonePartParams clone_params{ .keep_metadata_version = true };
+            auto [cloned_part, lock] = cloneAndLoadDataPartOnSameDisk(part_to_clone, "tmp_clone_", part_info, metadata_snapshot, clone_params);
             part_directory_lock = std::move(lock);
             return cloned_part;
         };
@@ -4387,7 +4397,8 @@ bool StorageReplicatedMergeTree::fetchPart(
             Transaction transaction(*this, NO_TRANSACTION_RAW);
             renameTempPartAndReplace(part, transaction);
 
-            replaced_parts = checkPartChecksumsAndCommit(transaction, part, hardlinked_files, !part_to_clone);
+            chassert(!part_to_clone || !is_zero_copy_part(part));
+            replaced_parts = checkPartChecksumsAndCommit(transaction, part, /*hardlinked_files*/ {}, /*replace_zero_copy_lock*/ true);
 
             /** If a quorum is tracked for this part, you must update it.
               * If you do not have time, in case of losing the session, when you restart the server - see the `ReplicatedMergeTreeRestartingThread::updateQuorumIfWeHavePart` method.
@@ -7255,7 +7266,6 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
         assert(replace == !LogEntry::ReplaceRangeEntry::isMovePartitionOrAttachFrom(drop_range));
 
         String drop_range_fake_part_name = getPartNamePossiblyFake(format_version, drop_range);
-        std::vector<MergeTreeData::HardlinkedFiles> hardlinked_files_for_parts;
 
         for (const auto & src_part : src_all_parts)
         {
@@ -7286,19 +7296,21 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
 
             UInt64 index = lock->getNumber();
             MergeTreePartInfo dst_part_info(partition_id, index, index, src_part->info.level);
-            MergeTreeData::HardlinkedFiles hardlinked_files;
+            HardlinkedFiles hardlinked_files;
 
-            bool copy_instead_of_hardlink = storage_settings_ptr->allow_remote_fs_zero_copy_replication
-                                            && src_part->isStoredOnRemoteDiskWithZeroCopySupport();
-
-            auto [dst_part, part_lock] = cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, metadata_snapshot, NO_TRANSACTION_PTR, &hardlinked_files, copy_instead_of_hardlink, {});
+            bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
+                || dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
+            IDataPartStorage::ClonePartParams clone_params
+            {
+                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport()
+            };
+            auto [dst_part, part_lock] = cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, metadata_snapshot, clone_params);
             src_parts.emplace_back(src_part);
             dst_parts.emplace_back(dst_part);
             dst_parts_locks.emplace_back(std::move(part_lock));
             ephemeral_locks.emplace_back(std::move(*lock));
             block_id_paths.emplace_back(block_id_path);
             part_checksums.emplace_back(hash_hex);
-            hardlinked_files_for_parts.emplace_back(hardlinked_files);
         }
 
         ReplicatedMergeTreeLogEntryData entry;
@@ -7360,7 +7372,7 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
             }
 
             for (size_t i = 0; i < dst_parts.size(); ++i)
-                lockSharedData(*dst_parts[i], false, hardlinked_files_for_parts[i]);
+                lockSharedData(*dst_parts[i], false, /*hardlinked_files*/ {});
 
             Coordination::Error code = zookeeper->tryMulti(ops, op_results);
             if (code == Coordination::Error::ZOK)
@@ -7501,7 +7513,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
         String dest_alter_partition_version_path = dest_table_storage->zookeeper_path + "/alter_partition_version";
         Coordination::Stat dest_alter_partition_version_stat;
         zookeeper->get(dest_alter_partition_version_path, &dest_alter_partition_version_stat);
-        std::vector<MergeTreeData::HardlinkedFiles> hardlinked_files_for_parts;
         std::vector<scope_guard> temporary_parts_locks;
 
         for (const auto & src_part : src_all_parts)
@@ -7524,12 +7535,15 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
             UInt64 index = lock->getNumber();
             MergeTreePartInfo dst_part_info(partition_id, index, index, src_part->info.level);
 
-            MergeTreeData::HardlinkedFiles hardlinked_files;
+            HardlinkedFiles hardlinked_files;
 
-            bool copy_instead_of_hardlink = storage_settings_ptr->allow_remote_fs_zero_copy_replication
-                                            && src_part->isStoredOnRemoteDiskWithZeroCopySupport();
-
-            auto [dst_part, dst_part_lock] = dest_table_storage->cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, dest_metadata_snapshot, NO_TRANSACTION_PTR, &hardlinked_files, copy_instead_of_hardlink, {});
+            bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
+                || dynamic_cast<const MergeTreeData *>(dest_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
+            IDataPartStorage::ClonePartParams clone_params
+            {
+                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport()
+            };
+            auto [dst_part, dst_part_lock] = dest_table_storage->cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, dest_metadata_snapshot, clone_params);
 
             src_parts.emplace_back(src_part);
             dst_parts.emplace_back(dst_part);
@@ -7537,7 +7551,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
             ephemeral_locks.emplace_back(std::move(*lock));
             block_id_paths.emplace_back(block_id_path);
             part_checksums.emplace_back(hash_hex);
-            hardlinked_files_for_parts.emplace_back(hardlinked_files);
         }
 
         ReplicatedMergeTreeLogEntryData entry_delete;
@@ -7606,7 +7619,7 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
                     dest_table_storage->renameTempPartAndReplaceUnlocked(part, transaction, dest_data_parts_lock);
 
                 for (size_t i = 0; i < dst_parts.size(); ++i)
-                    dest_table_storage->lockSharedData(*dst_parts[i], false, hardlinked_files_for_parts[i]);
+                    dest_table_storage->lockSharedData(*dst_parts[i], false, /*hardlinked_files*/ {});
 
                 Coordination::Error code = zookeeper->tryMulti(ops, op_results);
                 if (code == Coordination::Error::ZBADVERSION)

From 9c2a9a60ea9a1f474495d74c399df5ffe5dddb45 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Wed, 28 Jun 2023 16:35:41 +0000
Subject: [PATCH 1353/1478] Update version_date.tsv and changelogs after
 v23.3.6.7-lts

---
 docs/changelogs/v23.3.6.7-lts.md     | 19 +++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 2 files changed, 20 insertions(+)
 create mode 100644 docs/changelogs/v23.3.6.7-lts.md

diff --git a/docs/changelogs/v23.3.6.7-lts.md b/docs/changelogs/v23.3.6.7-lts.md
new file mode 100644
index 00000000000..387cc126aba
--- /dev/null
+++ b/docs/changelogs/v23.3.6.7-lts.md
@@ -0,0 +1,19 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.3.6.7-lts (7e3f0a271b7) FIXME as compared to v23.3.5.9-lts (f5fbc2fd2b3)
+
+#### Improvement
+* Backported in [#51240](https://github.com/ClickHouse/ClickHouse/issues/51240): Improve the progress bar for file/s3/hdfs/url table functions by using chunk size from source data and using incremental total size counting in each thread. Fix the progress bar for *Cluster functions. This closes [#47250](https://github.com/ClickHouse/ClickHouse/issues/47250). [#51088](https://github.com/ClickHouse/ClickHouse/pull/51088) ([Kruglov Pavel](https://github.com/Avogar)).
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#51529](https://github.com/ClickHouse/ClickHouse/issues/51529): Split huge `RUN` in Dockerfile into smaller conditional. Install the necessary tools on demand in the same `RUN` layer, and remove them after that. Upgrade the OS only once at the beginning. Use a modern way to check the signed repository. Downgrade the base repo to ubuntu:20.04 to address the issues on older docker versions. Upgrade golang version to address golang vulnerabilities. [#51504](https://github.com/ClickHouse/ClickHouse/pull/51504) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix type of LDAP server params hash in cache entry [#50865](https://github.com/ClickHouse/ClickHouse/pull/50865) ([Julian Maicher](https://github.com/jmaicher)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index dd21cc7e953..307ed97068f 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.6.7-lts	2023-06-28
 v23.3.5.9-lts	2023-06-22
 v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12

From 372f5786c42fd3e96bbcafb80012c04fdaa96bbc Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 28 Jun 2023 18:44:54 +0200
Subject: [PATCH 1354/1478] more optimal REPLACE_RANGE with zero-copy

---
 src/Storages/StorageReplicatedMergeTree.cpp | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index ecc2537f6ad..b9d48fc75f3 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -2435,13 +2435,17 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
 
     auto obtain_part = [&] (PartDescriptionPtr & part_desc)
     {
-        if (part_desc->src_table_part)
+        /// Fetches with zero-copy-replication are cheap, but cloneAndLoadDataPartOnSameDisk will do full copy.
+        /// It's okay to check the setting for current table and disk for the source table, because src and dst part are on the same disk.
+        bool prefer_fetch_from_other_replica = !part_desc->replica.empty() && storage_settings_ptr->allow_remote_fs_zero_copy_replication
+            && part_desc->src_table_part && part_desc->src_table_part->isStoredOnRemoteDiskWithZeroCopySupport();
+
+        if (part_desc->src_table_part && !prefer_fetch_from_other_replica)
         {
             if (part_desc->checksum_hex != part_desc->src_table_part->checksums.getTotalChecksumHex())
                 throw Exception(ErrorCodes::UNFINISHED, "Checksums of {} is suddenly changed", part_desc->src_table_part->name);
 
-            bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
-                || dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
+            bool zero_copy_enabled = dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
             IDataPartStorage::ClonePartParams clone_params
             {
                 .copy_instead_of_hardlink = zero_copy_enabled && part_desc->src_table_part->isStoredOnRemoteDiskWithZeroCopySupport()

From 56354b72514e79dfcd9a322c4cbf2aa2e81e6892 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 28 Jun 2023 16:55:22 +0000
Subject: [PATCH 1355/1478] Fix yet another place

---
 src/Dictionaries/HashedDictionary.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Dictionaries/HashedDictionary.cpp b/src/Dictionaries/HashedDictionary.cpp
index 798f37cb516..5f25600db8f 100644
--- a/src/Dictionaries/HashedDictionary.cpp
+++ b/src/Dictionaries/HashedDictionary.cpp
@@ -236,6 +236,11 @@ HashedDictionary<dictionary_key_type, sparse, sharded>::~HashedDictionary()
 
         pool.trySchedule([&container, thread_group = CurrentThread::getGroup()]
         {
+            SCOPE_EXIT_SAFE(
+                if (thread_group)
+                    CurrentThread::detachFromGroupIfNotDetached();
+            );
+
             /// Do not account memory that was occupied by the dictionaries for the query/user context.
             MemoryTrackerBlockerInThread memory_blocker;
 

From 39f8b92e24ea8e695583469dfc42d2c0238e6356 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 28 Jun 2023 19:05:35 +0200
Subject: [PATCH 1356/1478] Allow to add disk name for custom disk

---
 src/Disks/getOrCreateDiskFromAST.cpp          | 23 ++++++++++----
 src/Parsers/ParserSetQuery.cpp                |  4 +--
 src/Parsers/isDiskFunction.cpp                |  2 +-
 ...stom_disk_with_user_defined_name.reference |  3 ++
 ...2808_custom_disk_with_user_defined_name.sh | 31 +++++++++++++++++++
 5 files changed, 54 insertions(+), 9 deletions(-)
 create mode 100644 tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.reference
 create mode 100755 tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh

diff --git a/src/Disks/getOrCreateDiskFromAST.cpp b/src/Disks/getOrCreateDiskFromAST.cpp
index 637acff7b95..c5ec0f5d91b 100644
--- a/src/Disks/getOrCreateDiskFromAST.cpp
+++ b/src/Disks/getOrCreateDiskFromAST.cpp
@@ -26,12 +26,20 @@ namespace
 {
     std::string getOrCreateDiskFromDiskAST(const ASTFunction & function, ContextPtr context)
     {
-        /// We need a unique name for a created custom disk, but it needs to be the same
-        /// after table is reattached or server is restarted, so take a hash of the disk
-        /// configuration serialized ast as a disk name suffix.
-        auto disk_setting_string = serializeAST(function, true);
-        auto disk_name = DiskSelector::TMP_INTERNAL_DISK_PREFIX
-            + toString(sipHash128(disk_setting_string.data(), disk_setting_string.size()));
+        std::string disk_name;
+        if (function.name == "disk")
+        {
+            /// We need a unique name for a created custom disk, but it needs to be the same
+            /// after table is reattached or server is restarted, so take a hash of the disk
+            /// configuration serialized ast as a disk name suffix.
+            auto disk_setting_string = serializeAST(function, true);
+            disk_name = DiskSelector::TMP_INTERNAL_DISK_PREFIX
+                + toString(sipHash128(disk_setting_string.data(), disk_setting_string.size()));
+        }
+        else
+        {
+            disk_name = function.name.substr(std::strlen("disk_"));
+        }
 
         auto result_disk = context->getOrCreateDisk(disk_name, [&](const DisksMap & disks_map) -> DiskPtr {
             const auto * function_args_expr = assert_cast<const ASTExpressionList *>(function.arguments.get());
@@ -43,6 +51,9 @@ namespace
             return disk;
         });
 
+        if (!result_disk->isCustomDisk())
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Disk with name `{}` already exist", disk_name);
+
         if (!result_disk->isRemote())
         {
             static constexpr auto custom_disks_base_dir_in_config = "custom_local_disks_base_directory";
diff --git a/src/Parsers/ParserSetQuery.cpp b/src/Parsers/ParserSetQuery.cpp
index 4df74c2dd82..727d037112f 100644
--- a/src/Parsers/ParserSetQuery.cpp
+++ b/src/Parsers/ParserSetQuery.cpp
@@ -215,7 +215,7 @@ bool ParserSetQuery::parseNameValuePair(SettingChange & change, IParser::Pos & p
     else if (ParserKeyword("FALSE").ignore(pos, expected))
         value = std::make_shared<ASTLiteral>(Field(static_cast<UInt64>(0)));
     /// for SETTINGS disk=disk(type='s3', path='', ...)
-    else if (function_p.parse(pos, function_ast, expected) && function_ast->as<ASTFunction>()->name == "disk")
+    else if (function_p.parse(pos, function_ast, expected) && function_ast->as<ASTFunction>()->name.starts_with("disk"))
     {
         tryGetIdentifierNameInto(name, change.name);
         change.value = createFieldFromAST(function_ast);
@@ -280,7 +280,7 @@ bool ParserSetQuery::parseNameValuePairWithParameterOrDefault(
         node = std::make_shared<ASTLiteral>(Field(static_cast<UInt64>(1)));
     else if (ParserKeyword("FALSE").ignore(pos, expected))
         node = std::make_shared<ASTLiteral>(Field(static_cast<UInt64>(0)));
-    else if (function_p.parse(pos, function_ast, expected) && function_ast->as<ASTFunction>()->name == "disk")
+    else if (function_p.parse(pos, function_ast, expected) && function_ast->as<ASTFunction>()->name.starts_with("disk"))
     {
         change.name = name;
         change.value = createFieldFromAST(function_ast);
diff --git a/src/Parsers/isDiskFunction.cpp b/src/Parsers/isDiskFunction.cpp
index e60229cb3f7..5ba626a8b2c 100644
--- a/src/Parsers/isDiskFunction.cpp
+++ b/src/Parsers/isDiskFunction.cpp
@@ -10,7 +10,7 @@ bool isDiskFunction(ASTPtr ast)
         return false;
 
     const auto * function = ast->as<ASTFunction>();
-    return function && function->name == "disk" && function->arguments->as<ASTExpressionList>();
+    return function && function->name.starts_with("disk") && function->arguments->as<ASTExpressionList>();
 }
 
 }
diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.reference b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.reference
new file mode 100644
index 00000000000..713dde3527d
--- /dev/null
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.reference
@@ -0,0 +1,3 @@
+OK
+0
+1
diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
new file mode 100755
index 00000000000..99b9a0ed7b3
--- /dev/null
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -0,0 +1,31 @@
+# Tags: no-fasttest, no-parallel
+
+# set -x
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+
+$CLICKHOUSE_CLIENT -nm --query """
+DROP TABLE IF EXISTS test;
+CREATE TABLE test (a Int32, b String)
+ENGINE = MergeTree() ORDER BY tuple()
+SETTINGS disk = disk_s3disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3disk);
+""" 2>&1 | grep -q "Disk with name \`s3disk\` already exist" && echo 'OK' || echo 'FAIL'
+
+$CLICKHOUSE_CLIENT -nm --query """
+SELECT count() FROM system.disks WHERE name = '$disk_name'
+"""
+
+disk_name="${CLICKHOUSE_TEST_UNIQUE_NAME}"
+$CLICKHOUSE_CLIENT -nm --query """
+DROP TABLE IF EXISTS test;
+CREATE TABLE test (a Int32, b String)
+ENGINE = MergeTree() ORDER BY tuple()
+SETTINGS disk = disk_$disk_name(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3disk);
+"""
+
+$CLICKHOUSE_CLIENT -nm --query """
+SELECT count() FROM system.disks WHERE name = '$disk_name'
+"""

From eea3c39959876a78639d53d4a5f84354cc53135b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 28 Jun 2023 10:49:46 +0000
Subject: [PATCH 1357/1478] Cosmetics

---
 .../functions/tuple-functions.md              |   7 +-
 src/Common/assert_cast.h                      |   2 +-
 src/Functions/tupleElement.cpp                | 140 +++++++-----------
 .../0_stateless/02116_tuple_element.sql       |  22 +--
 .../02354_tuple_element_with_default.sql      |  10 +-
 5 files changed, 73 insertions(+), 108 deletions(-)

diff --git a/docs/en/sql-reference/functions/tuple-functions.md b/docs/en/sql-reference/functions/tuple-functions.md
index 1739920c9f0..7ed2deaeda6 100644
--- a/docs/en/sql-reference/functions/tuple-functions.md
+++ b/docs/en/sql-reference/functions/tuple-functions.md
@@ -22,14 +22,15 @@ tuple(x, y, …)
 
 A function that allows getting a column from a tuple.
 
-If the second argument is a number `n`, it is the column index, starting from 1. If the second argument is a string `s`, it represents the name of the element. Besides, we can provide the third optional argument, such that when index out of bounds or element for such name does not exist, the default value returned instead of throw exception. The second and third arguments if provided are always must be constant. There is no cost to execute the function.
+If the second argument is a number `index`, it is the column index, starting from 1. If the second argument is a string `name`, it represents the name of the element. Besides, we can provide the third optional argument, such that when index out of bounds or no element exist for the name, the default value returned instead of throwing an exception. The second and third arguments, if provided, must be constants. There is no cost to execute the function.
 
-The function implements the operator `x.n` and `x.s`.
+The function implements operators `x.index` and `x.name`.
 
 **Syntax**
 
 ``` sql
-tupleElement(tuple, n/s [, default_value])
+tupleElement(tuple, index, [, default_value])
+tupleElement(tuple, name, [, default_value])
 ```
 
 ## untuple
diff --git a/src/Common/assert_cast.h b/src/Common/assert_cast.h
index 604cfaed6e2..0b73ba1cc12 100644
--- a/src/Common/assert_cast.h
+++ b/src/Common/assert_cast.h
@@ -23,7 +23,7 @@ namespace DB
   * The exact match of the type is checked. That is, cast to the ancestor will be unsuccessful.
   */
 template <typename To, typename From>
-To assert_cast(From && from)
+inline To assert_cast(From && from)
 {
 #ifndef NDEBUG
     try
diff --git a/src/Functions/tupleElement.cpp b/src/Functions/tupleElement.cpp
index b1fd200f5cd..fb8f1d3b48d 100644
--- a/src/Functions/tupleElement.cpp
+++ b/src/Functions/tupleElement.cpp
@@ -34,32 +34,14 @@ class FunctionTupleElement : public IFunction
 {
 public:
     static constexpr auto name = "tupleElement";
-    static FunctionPtr create(ContextPtr)
-    {
-        return std::make_shared<FunctionTupleElement>();
-    }
-
-    String getName() const override
-    {
-        return name;
-    }
 
+    static FunctionPtr create(ContextPtr) { return std::make_shared<FunctionTupleElement>(); }
+    String getName() const override { return name; }
     bool isVariadic() const override { return true; }
-
-    size_t getNumberOfArguments() const override
-    {
-        return 0;
-    }
-
-    bool useDefaultImplementationForConstants() const override
-    {
-        return true;
-    }
-
+    size_t getNumberOfArguments() const override { return 0; }
+    bool useDefaultImplementationForConstants() const override { return true; }
     ColumnNumbers getArgumentsThatAreAlwaysConstant() const override { return {1}; }
-
     bool useDefaultImplementationForNulls() const override { return false; }
-
     bool isSuitableForShortCircuitArgumentsExecution(const DataTypesWithConstInfo & /*arguments*/) const override { return false; }
 
     DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override
@@ -72,107 +54,98 @@ public:
                             getName(), number_of_arguments);
 
         size_t count_arrays = 0;
-        const IDataType * tuple_col = arguments[0].type.get();
-        while (const DataTypeArray * array = checkAndGetDataType<DataTypeArray>(tuple_col))
+        const IDataType * input_type = arguments[0].type.get();
+        while (const DataTypeArray * array = checkAndGetDataType<DataTypeArray>(input_type))
         {
-            tuple_col = array->getNestedType().get();
+            input_type = array->getNestedType().get();
             ++count_arrays;
         }
 
-        const DataTypeTuple * tuple = checkAndGetDataType<DataTypeTuple>(tuple_col);
+        const DataTypeTuple * tuple = checkAndGetDataType<DataTypeTuple>(input_type);
         if (!tuple)
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
                 "First argument for function {} must be tuple or array of tuple. Actual {}",
                 getName(),
                 arguments[0].type->getName());
 
-        auto index = getElementNum(arguments[1].column, *tuple, number_of_arguments);
+        std::optional<size_t> index = getElementIndex(arguments[1].column, *tuple, number_of_arguments);
         if (index.has_value())
         {
-            DataTypePtr out_return_type = tuple->getElements()[index.value()];
+            DataTypePtr return_type = tuple->getElements()[index.value()];
 
             for (; count_arrays; --count_arrays)
-                out_return_type = std::make_shared<DataTypeArray>(out_return_type);
+                return_type = std::make_shared<DataTypeArray>(return_type);
 
-            return out_return_type;
+            return return_type;
         }
         else
         {
-            const IDataType * default_col = arguments[2].type.get();
-            size_t default_argument_count_arrays = 0;
-            if (const DataTypeArray * array = checkAndGetDataType<DataTypeArray>(default_col))
-            {
-                default_argument_count_arrays = array->getNumberOfDimensions();
-            }
+            const IDataType * default_type = arguments[2].type.get();
+            size_t default_count_arrays = 0;
 
-            if (count_arrays != default_argument_count_arrays)
-            {
+            if (const DataTypeArray * default_type_as_array = checkAndGetDataType<DataTypeArray>(default_type))
+                default_count_arrays = default_type_as_array->getNumberOfDimensions();
+
+            if (count_arrays != default_count_arrays)
                 throw Exception(ErrorCodes::NUMBER_OF_DIMENSIONS_MISMATCHED,
                                 "Dimension of types mismatched between first argument and third argument. "
                                 "Dimension of 1st argument: {}. "
-                                "Dimension of 3rd argument: {}.",count_arrays, default_argument_count_arrays);
-            }
+                                "Dimension of 3rd argument: {}", count_arrays, default_count_arrays);
+
             return arguments[2].type;
         }
     }
 
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
     {
-        Columns array_offsets;
+        const auto & input_arg = arguments[0];
+        const IDataType * input_type = input_arg.type.get();
+        const IColumn * input_col = input_arg.column.get();
 
-        const auto & first_arg = arguments[0];
-
-        const IDataType * tuple_type = first_arg.type.get();
-        const IColumn * tuple_col = first_arg.column.get();
-        bool first_arg_is_const = false;
-        if (typeid_cast<const ColumnConst *>(tuple_col))
+        bool input_arg_is_const = false;
+        if (typeid_cast<const ColumnConst *>(input_col))
         {
-            tuple_col = assert_cast<const ColumnConst *>(tuple_col)->getDataColumnPtr().get();
-            first_arg_is_const = true;
+            input_col = assert_cast<const ColumnConst *>(input_col)->getDataColumnPtr().get();
+            input_arg_is_const = true;
         }
-        while (const DataTypeArray * array_type = checkAndGetDataType<DataTypeArray>(tuple_type))
-        {
-            const ColumnArray * array_col = assert_cast<const ColumnArray *>(tuple_col);
 
-            tuple_type = array_type->getNestedType().get();
-            tuple_col = &array_col->getData();
+        Columns array_offsets;
+        while (const DataTypeArray * array_type = checkAndGetDataType<DataTypeArray>(input_type))
+        {
+            const ColumnArray * array_col = assert_cast<const ColumnArray *>(input_col);
+
+            input_type = array_type->getNestedType().get();
+            input_col = &array_col->getData();
             array_offsets.push_back(array_col->getOffsetsPtr());
         }
 
-        const DataTypeTuple * tuple_type_concrete = checkAndGetDataType<DataTypeTuple>(tuple_type);
-        const ColumnTuple * tuple_col_concrete = checkAndGetColumn<ColumnTuple>(tuple_col);
-        if (!tuple_type_concrete || !tuple_col_concrete)
+        const DataTypeTuple * input_type_as_tuple = checkAndGetDataType<DataTypeTuple>(input_type);
+        const ColumnTuple * input_col_as_tuple = checkAndGetColumn<ColumnTuple>(input_col);
+        if (!input_type_as_tuple || !input_col_as_tuple)
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
-                "First argument for function {} must be tuple or array of tuple. Actual {}",
-                getName(),
-                first_arg.type->getName());
+                "First argument for function {} must be tuple or array of tuple. Actual {}", getName(), input_arg.type->getName());
 
-        auto index = getElementNum(arguments[1].column, *tuple_type_concrete, arguments.size());
+        std::optional<size_t> index = getElementIndex(arguments[1].column, *input_type_as_tuple, arguments.size());
 
         if (!index.has_value())
         {
             if (!array_offsets.empty())
-            {
                 recursiveCheckArrayOffsets(arguments[0].column, arguments[2].column, array_offsets.size());
-            }
             return arguments[2].column;
         }
 
-        ColumnPtr res = tuple_col_concrete->getColumns()[index.value()];
+        ColumnPtr res = input_col_as_tuple->getColumns()[index.value()];
 
         /// Wrap into Arrays
         for (auto it = array_offsets.rbegin(); it != array_offsets.rend(); ++it)
             res = ColumnArray::create(res, *it);
 
-        if (first_arg_is_const)
-        {
+        if (input_arg_is_const)
             res = ColumnConst::create(res, input_rows_count);
-        }
         return res;
     }
 
 private:
-
     void recursiveCheckArrayOffsets(ColumnPtr col_x, ColumnPtr col_y, size_t depth) const
     {
         for (size_t i = 1; i < depth; ++i)
@@ -187,22 +160,16 @@ private:
     void checkArrayOffsets(ColumnPtr col_x, ColumnPtr col_y) const
     {
         if (isColumnConst(*col_x))
-        {
             checkArrayOffsetsWithFirstArgConst(col_x, col_y);
-        }
         else if (isColumnConst(*col_y))
-        {
             checkArrayOffsetsWithFirstArgConst(col_y, col_x);
-        }
         else
         {
             const auto & array_x = *assert_cast<const ColumnArray *>(col_x.get());
             const auto & array_y = *assert_cast<const ColumnArray *>(col_y.get());
             if (!array_x.hasEqualOffsets(array_y))
-            {
                 throw Exception(ErrorCodes::SIZES_OF_ARRAYS_DONT_MATCH,
                                 "The argument 1 and argument 3 of function {} have different array sizes", getName());
-            }
         }
     }
 
@@ -220,23 +187,21 @@ private:
         size_t row_size = offsets_y.size();
         for (size_t row = 0; row < row_size; ++row)
         {
-            if (unlikely(offsets_x[0] != offsets_y[row] - prev_offset))
-            {
+            if (offsets_x[0] != offsets_y[row] - prev_offset)
                 throw Exception(ErrorCodes::SIZES_OF_ARRAYS_DONT_MATCH,
                                 "The argument 1 and argument 3 of function {} have different array sizes", getName());
-            }
             prev_offset = offsets_y[row];
         }
     }
 
-    std::optional<size_t> getElementNum(const ColumnPtr & index_column, const DataTypeTuple & tuple, const size_t argument_size) const
+    std::optional<size_t> getElementIndex(const ColumnPtr & index_column, const DataTypeTuple & tuple, size_t argument_size) const
     {
         if (checkAndGetColumnConst<ColumnUInt8>(index_column.get())
             || checkAndGetColumnConst<ColumnUInt16>(index_column.get())
             || checkAndGetColumnConst<ColumnUInt32>(index_column.get())
             || checkAndGetColumnConst<ColumnUInt64>(index_column.get()))
         {
-            size_t index = index_column->getUInt(0);
+            const size_t index = index_column->getUInt(0);
 
             if (index == 0)
                 throw Exception(ErrorCodes::ILLEGAL_INDEX, "Indices in tuples are 1-based.");
@@ -244,21 +209,20 @@ private:
             if (index > tuple.getElements().size())
                 throw Exception(ErrorCodes::ILLEGAL_INDEX, "Index for tuple element is out of range.");
 
-            return std::optional<size_t>(index - 1);
+            return {index - 1};
         }
         else if (const auto * name_col = checkAndGetColumnConst<ColumnString>(index_column.get()))
         {
-            auto index = tuple.tryGetPositionByName(name_col->getValue<String>());
-            if (index.has_value())
-            {
-                return index;
-            }
+            std::optional<size_t> index = tuple.tryGetPositionByName(name_col->getValue<String>());
 
-            if (argument_size == 2)
+            if (index.has_value())
+                return index;
+            else
             {
-                throw Exception(ErrorCodes::NOT_FOUND_COLUMN_IN_BLOCK, "Tuple doesn't have element with name '{}'", name_col->getValue<String>());
+                if (argument_size == 2)
+                    throw Exception(ErrorCodes::NOT_FOUND_COLUMN_IN_BLOCK, "Tuple doesn't have element with name '{}'", name_col->getValue<String>());
+                return std::nullopt;
             }
-            return std::nullopt;
         }
         else
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
diff --git a/tests/queries/0_stateless/02116_tuple_element.sql b/tests/queries/0_stateless/02116_tuple_element.sql
index c911712684d..bedfedd7c2d 100644
--- a/tests/queries/0_stateless/02116_tuple_element.sql
+++ b/tests/queries/0_stateless/02116_tuple_element.sql
@@ -14,12 +14,12 @@ EXPLAIN SYNTAX SELECT tupleElement(t1, 2) FROM t_tuple_element;
 SELECT tupleElement(t1, 'a') FROM t_tuple_element;
 EXPLAIN SYNTAX SELECT tupleElement(t1, 'a') FROM t_tuple_element;
 
-SELECT tupleElement(number, 1) FROM numbers(1); -- { serverError 43 }
-SELECT tupleElement(t1) FROM t_tuple_element; -- { serverError 42 }
-SELECT tupleElement(t1, 'b') FROM t_tuple_element; -- { serverError 10, 47 }
-SELECT tupleElement(t1, 0) FROM t_tuple_element; -- { serverError 127 }
-SELECT tupleElement(t1, 3) FROM t_tuple_element; -- { serverError 127 }
-SELECT tupleElement(t1, materialize('a')) FROM t_tuple_element; -- { serverError 43 }
+SELECT tupleElement(number, 1) FROM numbers(1); -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
+SELECT tupleElement(t1) FROM t_tuple_element; -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
+SELECT tupleElement(t1, 'b') FROM t_tuple_element; -- { serverError NOT_FOUND_COLUMN_IN_BLOCK, UNKNOWN_IDENTIFIER }
+SELECT tupleElement(t1, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t1, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t1, materialize('a')) FROM t_tuple_element; -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
 
 SELECT t2.1 FROM t_tuple_element;
 EXPLAIN SYNTAX SELECT t2.1 FROM t_tuple_element;
@@ -27,11 +27,11 @@ EXPLAIN SYNTAX SELECT t2.1 FROM t_tuple_element;
 SELECT tupleElement(t2, 1) FROM t_tuple_element;
 EXPLAIN SYNTAX SELECT tupleElement(t2, 1) FROM t_tuple_element;
 
-SELECT tupleElement(t2) FROM t_tuple_element; -- { serverError 42 }
-SELECT tupleElement(t2, 'a') FROM t_tuple_element; -- { serverError 10, 47 }
-SELECT tupleElement(t2, 0) FROM t_tuple_element; -- { serverError 127 }
-SELECT tupleElement(t2, 3) FROM t_tuple_element; -- { serverError 127 }
-SELECT tupleElement(t2, materialize(1)) FROM t_tuple_element; -- { serverError 43 }
+SELECT tupleElement(t2) FROM t_tuple_element; -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
+SELECT tupleElement(t2, 'a') FROM t_tuple_element; -- { serverError NOT_FOUND_COLUMN_IN_BLOCK, UNKNOWN_IDENTIFIER }
+SELECT tupleElement(t2, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t2, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t2, materialize(1)) FROM t_tuple_element; -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
 
 DROP TABLE t_tuple_element;
 
diff --git a/tests/queries/0_stateless/02354_tuple_element_with_default.sql b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
index 908a869885b..ba1388cfa57 100644
--- a/tests/queries/0_stateless/02354_tuple_element_with_default.sql
+++ b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
@@ -10,16 +10,16 @@ EXPLAIN SYNTAX SELECT tupleElement(t1, 'z', 0) FROM t_tuple_element_default;
 SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
 EXPLAIN SYNTAX SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
 
-SELECT tupleElement(t1, 3, 'z') FROM t_tuple_element_default; -- { serverError 127 }
-SELECT tupleElement(t1, 0, 'z') FROM t_tuple_element_default; -- { serverError 127 }
+SELECT tupleElement(t1, 3, 'z') FROM t_tuple_element_default; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t1, 0, 'z') FROM t_tuple_element_default; -- { serverError ILLEGAL_INDEX }
 
 DROP TABLE t_tuple_element_default;
 
 SELECT '--------------------';
 
-SELECT tupleElement(array(tuple(1, 2)), 'a', 0); -- { serverError 645 }
-SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(1, 2), tuple(3, 4))); -- { serverError 190 }
-SELECT tupleElement(array(array(tuple(1))), 'a', array(array(1, 2, 3))); -- { serverError 190 }
+SELECT tupleElement(array(tuple(1, 2)), 'a', 0); -- { serverError NUMBER_OF_DIMENSIONS_MISMATCHED }
+SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(1, 2), tuple(3, 4))); -- { serverError SIZES_OF_ARRAYS_DONT_MATCH }
+SELECT tupleElement(array(array(tuple(1))), 'a', array(array(1, 2, 3))); -- { serverError SIZES_OF_ARRAYS_DONT_MATCH }
 
 SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(3, 4)));
 EXPLAIN SYNTAX SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(3, 4)));

From bf54fb4caad774bb1efe1fd39e7b7abaef1a9869 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 28 Jun 2023 11:06:41 +0000
Subject: [PATCH 1358/1478] tupleElement(): Return default value for
 out-of-bounds-index

Makes the actual and the documented behavior consistent.
---
 src/Functions/tupleElement.cpp                     | 14 ++++++++------
 .../02354_tuple_element_with_default.reference     |  2 ++
 .../02354_tuple_element_with_default.sql           |  4 ++--
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/src/Functions/tupleElement.cpp b/src/Functions/tupleElement.cpp
index fb8f1d3b48d..8689a095809 100644
--- a/src/Functions/tupleElement.cpp
+++ b/src/Functions/tupleElement.cpp
@@ -203,13 +203,15 @@ private:
         {
             const size_t index = index_column->getUInt(0);
 
-            if (index == 0)
-                throw Exception(ErrorCodes::ILLEGAL_INDEX, "Indices in tuples are 1-based.");
+            if (index > 0 && index <= tuple.getElements().size())
+                return {index - 1};
+            else
+            {
+                if (argument_size == 2)
+                    throw Exception(ErrorCodes::NOT_FOUND_COLUMN_IN_BLOCK, "Tuple doesn't have element with index '{}'", index);
+                return std::nullopt;
+            }
 
-            if (index > tuple.getElements().size())
-                throw Exception(ErrorCodes::ILLEGAL_INDEX, "Index for tuple element is out of range.");
-
-            return {index - 1};
         }
         else if (const auto * name_col = checkAndGetColumnConst<ColumnString>(index_column.get()))
         {
diff --git a/tests/queries/0_stateless/02354_tuple_element_with_default.reference b/tests/queries/0_stateless/02354_tuple_element_with_default.reference
index d5dfff17ef1..08a1f60e163 100644
--- a/tests/queries/0_stateless/02354_tuple_element_with_default.reference
+++ b/tests/queries/0_stateless/02354_tuple_element_with_default.reference
@@ -7,6 +7,8 @@ FROM t_tuple_element_default
 z
 SELECT tupleElement(t2, \'z\', \'z\')
 FROM t_tuple_element_default
+z
+z
 --------------------
 [(3,4)]
 SELECT tupleElement([(1, 2)], \'a\', [(3, 4)])
diff --git a/tests/queries/0_stateless/02354_tuple_element_with_default.sql b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
index ba1388cfa57..de281c0a868 100644
--- a/tests/queries/0_stateless/02354_tuple_element_with_default.sql
+++ b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
@@ -10,8 +10,8 @@ EXPLAIN SYNTAX SELECT tupleElement(t1, 'z', 0) FROM t_tuple_element_default;
 SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
 EXPLAIN SYNTAX SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
 
-SELECT tupleElement(t1, 3, 'z') FROM t_tuple_element_default; -- { serverError ILLEGAL_INDEX }
-SELECT tupleElement(t1, 0, 'z') FROM t_tuple_element_default; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t1, 3, 'z') FROM t_tuple_element_default;
+SELECT tupleElement(t1, 0, 'z') FROM t_tuple_element_default;
 
 DROP TABLE t_tuple_element_default;
 

From 5b78b3903b468575dc36af84bbb90f673d50a7c0 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 28 Jun 2023 12:26:34 +0000
Subject: [PATCH 1359/1478] Fix logical error in tupleElement()

---
 src/Functions/tupleElement.cpp                | 69 -------------------
 .../02286_tuple_numeric_identifier.sql        |  4 +-
 ...02354_tuple_element_with_default.reference | 43 ++++--------
 .../02354_tuple_element_with_default.sql      | 61 +++++-----------
 4 files changed, 34 insertions(+), 143 deletions(-)

diff --git a/src/Functions/tupleElement.cpp b/src/Functions/tupleElement.cpp
index 8689a095809..96b5a047419 100644
--- a/src/Functions/tupleElement.cpp
+++ b/src/Functions/tupleElement.cpp
@@ -17,11 +17,8 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
-    extern const int ILLEGAL_INDEX;
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
     extern const int NOT_FOUND_COLUMN_IN_BLOCK;
-    extern const int NUMBER_OF_DIMENSIONS_MISMATCHED;
-    extern const int SIZES_OF_ARRAYS_DONT_MATCH;
 }
 
 namespace
@@ -79,21 +76,7 @@ public:
             return return_type;
         }
         else
-        {
-            const IDataType * default_type = arguments[2].type.get();
-            size_t default_count_arrays = 0;
-
-            if (const DataTypeArray * default_type_as_array = checkAndGetDataType<DataTypeArray>(default_type))
-                default_count_arrays = default_type_as_array->getNumberOfDimensions();
-
-            if (count_arrays != default_count_arrays)
-                throw Exception(ErrorCodes::NUMBER_OF_DIMENSIONS_MISMATCHED,
-                                "Dimension of types mismatched between first argument and third argument. "
-                                "Dimension of 1st argument: {}. "
-                                "Dimension of 3rd argument: {}", count_arrays, default_count_arrays);
-
             return arguments[2].type;
-        }
     }
 
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
@@ -128,11 +111,7 @@ public:
         std::optional<size_t> index = getElementIndex(arguments[1].column, *input_type_as_tuple, arguments.size());
 
         if (!index.has_value())
-        {
-            if (!array_offsets.empty())
-                recursiveCheckArrayOffsets(arguments[0].column, arguments[2].column, array_offsets.size());
             return arguments[2].column;
-        }
 
         ColumnPtr res = input_col_as_tuple->getColumns()[index.value()];
 
@@ -146,54 +125,6 @@ public:
     }
 
 private:
-    void recursiveCheckArrayOffsets(ColumnPtr col_x, ColumnPtr col_y, size_t depth) const
-    {
-        for (size_t i = 1; i < depth; ++i)
-        {
-            checkArrayOffsets(col_x, col_y);
-            col_x = assert_cast<const ColumnArray *>(col_x.get())->getDataPtr();
-            col_y = assert_cast<const ColumnArray *>(col_y.get())->getDataPtr();
-        }
-        checkArrayOffsets(col_x, col_y);
-    }
-
-    void checkArrayOffsets(ColumnPtr col_x, ColumnPtr col_y) const
-    {
-        if (isColumnConst(*col_x))
-            checkArrayOffsetsWithFirstArgConst(col_x, col_y);
-        else if (isColumnConst(*col_y))
-            checkArrayOffsetsWithFirstArgConst(col_y, col_x);
-        else
-        {
-            const auto & array_x = *assert_cast<const ColumnArray *>(col_x.get());
-            const auto & array_y = *assert_cast<const ColumnArray *>(col_y.get());
-            if (!array_x.hasEqualOffsets(array_y))
-                throw Exception(ErrorCodes::SIZES_OF_ARRAYS_DONT_MATCH,
-                                "The argument 1 and argument 3 of function {} have different array sizes", getName());
-        }
-    }
-
-    void checkArrayOffsetsWithFirstArgConst(ColumnPtr col_x, ColumnPtr col_y) const
-    {
-        col_x = assert_cast<const ColumnConst *>(col_x.get())->getDataColumnPtr();
-        col_y = col_y->convertToFullColumnIfConst();
-        const auto & array_x = *assert_cast<const ColumnArray *>(col_x.get());
-        const auto & array_y = *assert_cast<const ColumnArray *>(col_y.get());
-
-        const auto & offsets_x = array_x.getOffsets();
-        const auto & offsets_y = array_y.getOffsets();
-
-        ColumnArray::Offset prev_offset = 0;
-        size_t row_size = offsets_y.size();
-        for (size_t row = 0; row < row_size; ++row)
-        {
-            if (offsets_x[0] != offsets_y[row] - prev_offset)
-                throw Exception(ErrorCodes::SIZES_OF_ARRAYS_DONT_MATCH,
-                                "The argument 1 and argument 3 of function {} have different array sizes", getName());
-            prev_offset = offsets_y[row];
-        }
-    }
-
     std::optional<size_t> getElementIndex(const ColumnPtr & index_column, const DataTypeTuple & tuple, size_t argument_size) const
     {
         if (checkAndGetColumnConst<ColumnUInt8>(index_column.get())
diff --git a/tests/queries/0_stateless/02286_tuple_numeric_identifier.sql b/tests/queries/0_stateless/02286_tuple_numeric_identifier.sql
index a5fd8e57ad5..f723284ad61 100644
--- a/tests/queries/0_stateless/02286_tuple_numeric_identifier.sql
+++ b/tests/queries/0_stateless/02286_tuple_numeric_identifier.sql
@@ -12,8 +12,8 @@ SELECT * FROM t_tuple_numeric FORMAT JSONEachRow;
 SELECT `t`.`1`.`2`, `t`.`1`.`3`, `t`.`4` FROM t_tuple_numeric;
 SELECT t.1.1, t.1.2, t.2 FROM t_tuple_numeric;
 
-SELECT t.1.3 FROM t_tuple_numeric; -- {serverError ILLEGAL_INDEX}
-SELECT t.4 FROM t_tuple_numeric; -- {serverError ILLEGAL_INDEX}
+SELECT t.1.3 FROM t_tuple_numeric; -- {serverError NOT_FOUND_COLUMN_IN_BLOCK}
+SELECT t.4 FROM t_tuple_numeric; -- {serverError NOT_FOUND_COLUMN_IN_BLOCK}
 SELECT `t`.`1`.`1`, `t`.`1`.`2`, `t`.`2` FROM t_tuple_numeric; -- {serverError UNKNOWN_IDENTIFIER}
 
 DROP TABLE t_tuple_numeric;
diff --git a/tests/queries/0_stateless/02354_tuple_element_with_default.reference b/tests/queries/0_stateless/02354_tuple_element_with_default.reference
index 08a1f60e163..499b4c36a10 100644
--- a/tests/queries/0_stateless/02354_tuple_element_with_default.reference
+++ b/tests/queries/0_stateless/02354_tuple_element_with_default.reference
@@ -1,28 +1,15 @@
-z
-SELECT tupleElement(t1, \'z\', \'z\')
-FROM t_tuple_element_default
-0
-SELECT tupleElement(t1, \'z\', 0)
-FROM t_tuple_element_default
-z
-SELECT tupleElement(t2, \'z\', \'z\')
-FROM t_tuple_element_default
-z
-z
---------------------
-[(3,4)]
-SELECT tupleElement([(1, 2)], \'a\', [(3, 4)])
---------------------
-SELECT tupleElement(t1, \'a\', [tuple(1)])
-FROM t_tuple_element_default
---------------------
-[(0)]
-SELECT tupleElement(t1, \'a\', [tuple(0)])
-FROM t_tuple_element_default
-[0]
-SELECT tupleElement(t1, \'a\', [0])
-FROM t_tuple_element_default
-[0]
-[0]
-SELECT tupleElement(t1, \'a\', [0])
-FROM t_tuple_element_default
+hello
+world
+default
+default
+[(['a'],1)]
+[1,3]
+[2,4]
+default
+--------
+hello
+world
+default
+default
+[(['a'],1)]
+[[1,2,3]]
diff --git a/tests/queries/0_stateless/02354_tuple_element_with_default.sql b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
index de281c0a868..89320f4d210 100644
--- a/tests/queries/0_stateless/02354_tuple_element_with_default.sql
+++ b/tests/queries/0_stateless/02354_tuple_element_with_default.sql
@@ -1,50 +1,23 @@
-DROP TABLE IF EXISTS t_tuple_element_default;
+-- const tuple argument
 
-CREATE TABLE t_tuple_element_default(t1 Tuple(a UInt32, s String), t2 Tuple(UInt32, String)) ENGINE = Memory;
-INSERT INTO t_tuple_element_default VALUES ((1, 'a'), (2, 'b'));
+SELECT tupleElement(('hello', 'world'), 1, 'default');
+SELECT tupleElement(('hello', 'world'), 2, 'default');
+SELECT tupleElement(('hello', 'world'), 3, 'default');
+SELECT tupleElement(('hello', 'world'), 'xyz', 'default');
+SELECT tupleElement(('hello', 'world'), 3, [([('a')], 1)]); -- arbitrary default value
 
-SELECT tupleElement(t1, 'z', 'z') FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'z', 'z') FROM t_tuple_element_default;
-SELECT tupleElement(t1, 'z', 0) FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'z', 0) FROM t_tuple_element_default;
-SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t2, 'z', 'z') FROM t_tuple_element_default;
+SELECT tupleElement([(1, 2), (3, 4)], 1, 'default');
+SELECT tupleElement([(1, 2), (3, 4)], 2, 'default');
+SELECT tupleElement([(1, 2), (3, 4)], 3, 'default');
 
-SELECT tupleElement(t1, 3, 'z') FROM t_tuple_element_default;
-SELECT tupleElement(t1, 0, 'z') FROM t_tuple_element_default;
+SELECT '--------';
 
-DROP TABLE t_tuple_element_default;
+-- non-const tuple argument
 
-SELECT '--------------------';
-
-SELECT tupleElement(array(tuple(1, 2)), 'a', 0); -- { serverError NUMBER_OF_DIMENSIONS_MISMATCHED }
-SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(1, 2), tuple(3, 4))); -- { serverError SIZES_OF_ARRAYS_DONT_MATCH }
-SELECT tupleElement(array(array(tuple(1))), 'a', array(array(1, 2, 3))); -- { serverError SIZES_OF_ARRAYS_DONT_MATCH }
-
-SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(3, 4)));
-EXPLAIN SYNTAX SELECT tupleElement(array(tuple(1, 2)), 'a', array(tuple(3, 4)));
-
-SELECT '--------------------';
-
-CREATE TABLE t_tuple_element_default(t1 Array(Tuple(UInt32)), t2 UInt32) ENGINE = Memory;
-
-SELECT tupleElement(t1, 'a', array(tuple(1))) FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'a', array(tuple(1))) FROM t_tuple_element_default;
-
-SELECT '--------------------';
-
-INSERT INTO t_tuple_element_default VALUES ([(1)], 100);
-
-SELECT tupleElement(t1, 'a', array(tuple(0))) FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'a', array(tuple(0))) FROM t_tuple_element_default;
-
-SELECT tupleElement(t1, 'a', array(0)) FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'a', array(0)) FROM t_tuple_element_default;
-
-INSERT INTO t_tuple_element_default VALUES ([(2)], 200);
-
-SELECT tupleElement(t1, 'a', array(0)) FROM t_tuple_element_default;
-EXPLAIN SYNTAX SELECT tupleElement(t1, 'a', array(0)) FROM t_tuple_element_default;
-
-DROP TABLE t_tuple_element_default;
+SELECT tupleElement(materialize(('hello', 'world')), 1, 'default');
+SELECT tupleElement(materialize(('hello', 'world')), 2, 'default');
+SELECT tupleElement(materialize(('hello', 'world')), 3, 'default');
+SELECT tupleElement(materialize(('hello', 'world')), 'xzy', 'default');
+SELECT tupleElement(materialize(('hello', 'world')), 'xzy', [([('a')], 1)]); -- arbitrary default value
 
+SELECT tupleElement([[(count('2147483646'), 1)]], 'aaaa', [[1, 2, 3]]) -- bug #51525

From 53a30bee8d66c06f69f53b8850a11b8fbde2e1d4 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 28 Jun 2023 19:16:10 +0000
Subject: [PATCH 1360/1478] 00900_orc_load: kill less aggressively

The test sporadically produces wrong results because the INSERT takes
longer than 3 seconds, likely due to infrastructure latency. Removing
the timeout to give it more headroom. Tests are afaik auto-killed after
10 min, so if there is a true issue in ClickHouse (e.g. deadlock), we
would notice anyways.
---
 tests/queries/0_stateless/00900_orc_load.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/00900_orc_load.sh b/tests/queries/0_stateless/00900_orc_load.sh
index 62149fa554e..5dc5dfb87a7 100755
--- a/tests/queries/0_stateless/00900_orc_load.sh
+++ b/tests/queries/0_stateless/00900_orc_load.sh
@@ -12,6 +12,6 @@ ${CLICKHOUSE_CLIENT} --query="select * from orc_load FORMAT ORC" > "${CLICKHOUSE
 ${CLICKHOUSE_CLIENT} --query="truncate table orc_load"
 
 cat "${CLICKHOUSE_TMP}"/test.orc | ${CLICKHOUSE_CLIENT} -q "insert into orc_load format ORC"
-timeout 3 ${CLICKHOUSE_CLIENT} -q "insert into orc_load format ORC" < "${CLICKHOUSE_TMP}"/test.orc
+${CLICKHOUSE_CLIENT} -q "insert into orc_load format ORC" < "${CLICKHOUSE_TMP}"/test.orc
 ${CLICKHOUSE_CLIENT} --query="select * from orc_load"
 ${CLICKHOUSE_CLIENT} --query="drop table orc_load"

From 8854f05a7534fc844b5a7b00af72ad0ae7c0ac1b Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Wed, 28 Jun 2023 19:53:49 +0000
Subject: [PATCH 1361/1478] style fix

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

diff --git a/src/Common/ThreadPool.cpp b/src/Common/ThreadPool.cpp
index 979e53a72c0..cc88594d84f 100644
--- a/src/Common/ThreadPool.cpp
+++ b/src/Common/ThreadPool.cpp
@@ -420,7 +420,7 @@ void ThreadPoolImpl<Thread>::worker(typename std::list<Thread>::iterator thread_
         {
             if (DB::Exception::enable_job_stack_trace)
                 DB::Exception::thread_frame_pointers = std::move(thread_frame_pointers);
-            
+
 
             CurrentMetrics::Increment metric_active_pool_threads(metric_active_threads);
 

From 45cd7f35cdfb3c1ed17cd2451468761aa25a6bfb Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 22 Jun 2023 02:16:56 +0200
Subject: [PATCH 1362/1478] Use clickhouse/integration-helper from changed
 images

---
 docker/test/integration/runner/dockerd-entrypoint.sh |  2 ++
 tests/integration/helpers/network.py                 | 11 +++++++----
 tests/integration/runner                             |  2 ++
 3 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/docker/test/integration/runner/dockerd-entrypoint.sh b/docker/test/integration/runner/dockerd-entrypoint.sh
index fe47fc90951..347d904d5c0 100755
--- a/docker/test/integration/runner/dockerd-entrypoint.sh
+++ b/docker/test/integration/runner/dockerd-entrypoint.sh
@@ -52,6 +52,8 @@ export CLICKHOUSE_TESTS_BASE_CONFIG_DIR=/clickhouse-config
 export CLICKHOUSE_ODBC_BRIDGE_BINARY_PATH=/clickhouse-odbc-bridge
 export CLICKHOUSE_LIBRARY_BRIDGE_BINARY_PATH=/clickhouse-library-bridge
 
+export DOCKER_BASE_TAG=${DOCKER_BASE_TAG:=latest}
+export DOCKER_HELPER_TAG=${DOCKER_HELPER_TAG:=latest}
 export DOCKER_MYSQL_GOLANG_CLIENT_TAG=${DOCKER_MYSQL_GOLANG_CLIENT_TAG:=latest}
 export DOCKER_DOTNET_CLIENT_TAG=${DOCKER_DOTNET_CLIENT_TAG:=latest}
 export DOCKER_MYSQL_JAVA_CLIENT_TAG=${DOCKER_MYSQL_JAVA_CLIENT_TAG:=latest}
diff --git a/tests/integration/helpers/network.py b/tests/integration/helpers/network.py
index 471aa2bdc2e..4859a8c5946 100644
--- a/tests/integration/helpers/network.py
+++ b/tests/integration/helpers/network.py
@@ -231,6 +231,9 @@ class _NetworkManager:
 
     def _ensure_container(self):
         if self._container is None or self._container_expire_time <= time.time():
+            image_name = "clickhouse/integration-helper:" + os.getenv(
+                "DOCKER_HELPER_TAG", "latest"
+            )
             for i in range(5):
                 if self._container is not None:
                     try:
@@ -247,7 +250,7 @@ class _NetworkManager:
                         time.sleep(i)
 
             image = subprocess.check_output(
-                "docker images -q clickhouse/integration-helper 2>/dev/null", shell=True
+                f"docker images -q {image_name} 2>/dev/null", shell=True
             )
             if not image.strip():
                 print("No network image helper, will try download")
@@ -256,16 +259,16 @@ class _NetworkManager:
                 for i in range(5):
                     try:
                         subprocess.check_call(  # STYLE_CHECK_ALLOW_SUBPROCESS_CHECK_CALL
-                            "docker pull clickhouse/integration-helper", shell=True
+                            f"docker pull {image_name}", shell=True
                         )
                         break
                     except:
                         time.sleep(i)
                 else:
-                    raise Exception("Cannot pull clickhouse/integration-helper image")
+                    raise Exception(f"Cannot pull {image_name} image")
 
             self._container = self._docker_client.containers.run(
-                "clickhouse/integration-helper",
+                image_name,
                 auto_remove=True,
                 command=("sleep %s" % self.container_exit_timeout),
                 # /run/xtables.lock passed inside for correct iptables --wait
diff --git a/tests/integration/runner b/tests/integration/runner
index f658bac412b..301a707a78d 100755
--- a/tests/integration/runner
+++ b/tests/integration/runner
@@ -336,6 +336,8 @@ if __name__ == "__main__":
                 env_tags += "-e {}={} ".format("DOCKER_MYSQL_PHP_CLIENT_TAG", tag)
             elif image == "clickhouse/postgresql-java-client":
                 env_tags += "-e {}={} ".format("DOCKER_POSTGRESQL_JAVA_CLIENT_TAG", tag)
+            elif image == "clickhouse/integration-helper":
+                env_tags += "-e {}={} ".format("DOCKER_HELPER_TAG", tag)
             elif image == "clickhouse/integration-test":
                 env_tags += "-e {}={} ".format("DOCKER_BASE_TAG", tag)
             elif image == "clickhouse/kerberized-hadoop":

From eeb8cdbc19e69aab64b0da2de0b569d6e31f438f Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 22 Jun 2023 02:36:30 +0200
Subject: [PATCH 1363/1478] Add way to define additional urls in test reports

---
 tests/ci/upload_result_helper.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/tests/ci/upload_result_helper.py b/tests/ci/upload_result_helper.py
index 150af7aff4a..fbb89ef8078 100644
--- a/tests/ci/upload_result_helper.py
+++ b/tests/ci/upload_result_helper.py
@@ -1,5 +1,5 @@
 from pathlib import Path
-from typing import Dict, List
+from typing import Dict, List, Optional
 import os
 import logging
 
@@ -58,14 +58,19 @@ def upload_results(
     test_results: TestResults,
     additional_files: List[str],
     check_name: str,
+    additional_urls: Optional[List[str]] = None,
 ) -> str:
     normalized_check_name = check_name.lower()
     for r in ((" ", "_"), ("(", "_"), (")", "_"), (",", "_"), ("/", "_")):
         normalized_check_name = normalized_check_name.replace(*r)
+
+    # Preserve additional_urls to not modify the original one
+    original_additional_urls = additional_urls or []
     s3_path_prefix = f"{pr_number}/{commit_sha}/{normalized_check_name}"
     additional_urls = process_logs(
         s3_client, additional_files, s3_path_prefix, test_results
     )
+    additional_urls.extend(original_additional_urls)
 
     branch_url = f"{GITHUB_SERVER_URL}/{GITHUB_REPOSITORY}/commits/master"
     branch_name = "master"

From 7b4e6faece3b172763f3237bf8a42282a289f059 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 19 Jun 2023 18:32:31 +0200
Subject: [PATCH 1364/1478] Speedup the submodules cloning

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

diff --git a/docker/test/fasttest/run.sh b/docker/test/fasttest/run.sh
index dab873377ce..be9d569e65c 100755
--- a/docker/test/fasttest/run.sh
+++ b/docker/test/fasttest/run.sh
@@ -151,7 +151,7 @@ function clone_submodules
         )
 
         git submodule sync
-        git submodule update --jobs=16 --depth 1 --init "${SUBMODULES_TO_UPDATE[@]}"
+        git submodule update --jobs=16 --depth 1 --single-branch --init "${SUBMODULES_TO_UPDATE[@]}"
         git submodule foreach git reset --hard
         git submodule foreach git checkout @ -f
         git submodule foreach git clean -xfd

From b68d8fa76e7be0ef1ae58ce41c6a326027c3afe6 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 19 Jun 2023 18:49:54 +0200
Subject: [PATCH 1365/1478] Update the OS version for builder and testers
 docker images

---
 docker/test/fasttest/Dockerfile         | 1 +
 docker/test/integration/base/Dockerfile | 2 +-
 docker/test/stateful/Dockerfile         | 5 +++--
 docker/test/stateless/Dockerfile        | 7 ++++---
 docker/test/util/Dockerfile             | 2 +-
 5 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/docker/test/fasttest/Dockerfile b/docker/test/fasttest/Dockerfile
index ffb13fc774d..da4baa8c687 100644
--- a/docker/test/fasttest/Dockerfile
+++ b/docker/test/fasttest/Dockerfile
@@ -9,6 +9,7 @@ RUN apt-get update \
         expect \
         file \
         lsof \
+        odbcinst \
         psmisc \
         python3 \
         python3-lxml \
diff --git a/docker/test/integration/base/Dockerfile b/docker/test/integration/base/Dockerfile
index de8efa20af4..ff50626b6aa 100644
--- a/docker/test/integration/base/Dockerfile
+++ b/docker/test/integration/base/Dockerfile
@@ -49,7 +49,7 @@ RUN arch=${TARGETARCH:-amd64} \
   && curl -o mysql-odbc.rpm "https://cdn.mysql.com/archives/mysql-connector-odbc-8.0/mysql-connector-odbc-8.0.27-1.el8.${rarch}.rpm" \
   && rpm2archive mysql-odbc.rpm \
   && tar xf mysql-odbc.rpm.tgz -C / ./usr/lib64/ \
-  && LINK_DIR=$(dpkg -L libodbc1 | rg '^/usr/lib/.*-linux-gnu/odbc$') \
+  && LINK_DIR=$(dpkg -L odbc-postgresql | rg '^/usr/lib/.*-linux-gnu/odbc$') \
   && ln -s /usr/lib64/libmyodbc8a.so "$LINK_DIR" \
   && ln -s /usr/lib64/libmyodbc8a.so "$LINK_DIR"/libmyodbc.so
 
diff --git a/docker/test/stateful/Dockerfile b/docker/test/stateful/Dockerfile
index 71a2e92e3a8..f513735a2d0 100644
--- a/docker/test/stateful/Dockerfile
+++ b/docker/test/stateful/Dockerfile
@@ -16,8 +16,9 @@ COPY s3downloader /s3downloader
 ENV S3_URL="https://clickhouse-datasets.s3.amazonaws.com"
 ENV DATASETS="hits visits"
 
-RUN npm install -g azurite
-RUN npm install tslib
+# The following is already done in clickhouse/stateless-test
+# RUN npm install -g azurite
+# RUN npm install tslib
 
 COPY run.sh /
 CMD ["/bin/bash", "/run.sh"]
diff --git a/docker/test/stateless/Dockerfile b/docker/test/stateless/Dockerfile
index 40109255a7e..32996140521 100644
--- a/docker/test/stateless/Dockerfile
+++ b/docker/test/stateless/Dockerfile
@@ -20,6 +20,7 @@ RUN apt-get update -y \
             netcat-openbsd \
             nodejs \
             npm \
+            odbcinst \
             openjdk-11-jre-headless \
             openssl \
             postgresql-client \
@@ -71,7 +72,7 @@ RUN arch=${TARGETARCH:-amd64} \
     && chmod +x ./mc ./minio
 
 
-RUN wget 'https://dlcdn.apache.org/hadoop/common/hadoop-3.3.1/hadoop-3.3.1.tar.gz' \
+RUN wget --no-verbose 'https://dlcdn.apache.org/hadoop/common/hadoop-3.3.1/hadoop-3.3.1.tar.gz' \
     && tar -xvf hadoop-3.3.1.tar.gz \
     && rm -rf hadoop-3.3.1.tar.gz
 
@@ -79,8 +80,8 @@ ENV MINIO_ROOT_USER="clickhouse"
 ENV MINIO_ROOT_PASSWORD="clickhouse"
 ENV EXPORT_S3_STORAGE_POLICIES=1
 
-RUN npm install -g azurite
-RUN npm install tslib
+RUN npm install -g azurite \
+    && npm install -g tslib
 
 COPY run.sh /
 COPY setup_minio.sh /
diff --git a/docker/test/util/Dockerfile b/docker/test/util/Dockerfile
index a49278e960b..85e888f1df7 100644
--- a/docker/test/util/Dockerfile
+++ b/docker/test/util/Dockerfile
@@ -1,5 +1,5 @@
 # docker build -t clickhouse/test-util .
-FROM ubuntu:20.04
+FROM ubuntu:22.04
 
 # ARG for quick switch to a given ubuntu mirror
 ARG apt_archive="http://archive.ubuntu.com"

From 5a8ce1f2fe5a7048066e9883ec49828e27ab7bd8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 19 Jun 2023 22:26:27 +0200
Subject: [PATCH 1366/1478] Do not upload the binaries for fast-tests to
 tests-reports

---
 docker/test/fasttest/run.sh | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docker/test/fasttest/run.sh b/docker/test/fasttest/run.sh
index be9d569e65c..989ed9d2fbb 100755
--- a/docker/test/fasttest/run.sh
+++ b/docker/test/fasttest/run.sh
@@ -80,7 +80,7 @@ function start_server
 
 function clone_root
 {
-    git config --global --add safe.directory "$FASTTEST_SOURCE"
+    [ "$UID" -eq 0 ] && git config --global --add safe.directory "$FASTTEST_SOURCE"
     git clone --depth 1 https://github.com/ClickHouse/ClickHouse.git -- "$FASTTEST_SOURCE" 2>&1 | ts '%Y-%m-%d %H:%M:%S' | tee "$FASTTEST_OUTPUT/clone_log.txt"
 
     (
@@ -202,10 +202,11 @@ function build
           | ts '%Y-%m-%d %H:%M:%S' \
           | tee "$FASTTEST_OUTPUT/test_result.txt"
         if [ "$COPY_CLICKHOUSE_BINARY_TO_OUTPUT" -eq "1" ]; then
-            cp programs/clickhouse "$FASTTEST_OUTPUT/clickhouse"
+            mkdir -p "$FASTTEST_OUTPUT/binaries/"
+            cp programs/clickhouse "$FASTTEST_OUTPUT/binaries/clickhouse"
 
-            strip programs/clickhouse -o "$FASTTEST_OUTPUT/clickhouse-stripped"
-            zstd --threads=0 "$FASTTEST_OUTPUT/clickhouse-stripped"
+            strip programs/clickhouse -o programs/clickhouse-stripped
+            zstd --threads=0 programs/clickhouse-stripped -o "$FASTTEST_OUTPUT/binaries/clickhouse-stripped.zst"
         fi
         ccache_status
         ccache --evict-older-than 1d ||:

From edcf981c4837468bf4d08dd86183b38c120913c2 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 20 Jun 2023 13:11:11 +0200
Subject: [PATCH 1367/1478] Update mysql odbc connector

---
 docker/test/integration/base/Dockerfile | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docker/test/integration/base/Dockerfile b/docker/test/integration/base/Dockerfile
index ff50626b6aa..270b40e23a6 100644
--- a/docker/test/integration/base/Dockerfile
+++ b/docker/test/integration/base/Dockerfile
@@ -46,12 +46,13 @@ RUN arch=${TARGETARCH:-amd64} \
       arm64) rarch=aarch64 ;; \
     esac \
   && cd /tmp \
-  && curl -o mysql-odbc.rpm "https://cdn.mysql.com/archives/mysql-connector-odbc-8.0/mysql-connector-odbc-8.0.27-1.el8.${rarch}.rpm" \
+  && curl -o mysql-odbc.rpm "https://cdn.mysql.com/archives/mysql-connector-odbc-8.0/mysql-connector-odbc-8.0.32-1.el9.${rarch}.rpm" \
   && rpm2archive mysql-odbc.rpm \
   && tar xf mysql-odbc.rpm.tgz -C / ./usr/lib64/ \
-  && LINK_DIR=$(dpkg -L odbc-postgresql | rg '^/usr/lib/.*-linux-gnu/odbc$') \
-  && ln -s /usr/lib64/libmyodbc8a.so "$LINK_DIR" \
-  && ln -s /usr/lib64/libmyodbc8a.so "$LINK_DIR"/libmyodbc.so
+  && rm mysql-odbc.rpm mysql-odbc.rpm.tgz \
+  && ODBC_DIR=$(dpkg -L odbc-postgresql | rg '^/usr/lib/.*-linux-gnu/odbc$') \
+  && ln -s /usr/lib64/libmyodbc8a.so "$ODBC_DIR" \
+  && ln -s /usr/lib64/libmyodbc8a.so "$ODBC_DIR"/libmyodbc.so
 
 # Unfortunately this is required for a single test for conversion data from zookeeper to clickhouse-keeper.
 # ZooKeeper is not started by default, but consumes some space in containers.

From ead81879b43d8b86f9b73f97fc0ac4277a79f047 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 21 Jun 2023 16:33:43 +0200
Subject: [PATCH 1368/1478] Update integration tests runner too

---
 .../integration/helper_container/Dockerfile   |  5 +-
 docker/test/integration/runner/Dockerfile     | 50 ++++++++++---------
 tests/integration/helpers/cluster.py          |  2 -
 tests/integration/helpers/network.py          |  4 --
 tests/integration/pytest.ini                  |  3 ++
 tests/integration/runner                      | 46 +++++++----------
 tests/integration/test_storage_hudi/test.py   |  2 +-
 7 files changed, 51 insertions(+), 61 deletions(-)

diff --git a/docker/test/integration/helper_container/Dockerfile b/docker/test/integration/helper_container/Dockerfile
index 6a093081bf2..60adaea1796 100644
--- a/docker/test/integration/helper_container/Dockerfile
+++ b/docker/test/integration/helper_container/Dockerfile
@@ -2,4 +2,7 @@
 # Helper docker container to run iptables without sudo
 
 FROM alpine
-RUN apk add -U iproute2
+RUN apk add --no-cache -U iproute2 \
+  && for bin in iptables iptables-restore iptables-save; \
+    do ln -sf xtables-nft-multi "/sbin/$bin"; \
+  done
diff --git a/docker/test/integration/runner/Dockerfile b/docker/test/integration/runner/Dockerfile
index 14c97e479f6..40627354f70 100644
--- a/docker/test/integration/runner/Dockerfile
+++ b/docker/test/integration/runner/Dockerfile
@@ -1,5 +1,5 @@
 # docker build -t clickhouse/integration-tests-runner .
-FROM ubuntu:20.04
+FROM ubuntu:22.04
 
 # ARG for quick switch to a given ubuntu mirror
 ARG apt_archive="http://archive.ubuntu.com"
@@ -56,17 +56,19 @@ RUN curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add - \
         /var/lib/apt/lists/* \
         /var/cache/debconf \
         /tmp/* \
-    && apt-get clean
+    && apt-get clean \
+    && dockerd --version; docker --version
 
-RUN dockerd --version; docker --version
 
 RUN python3 -m pip install --no-cache-dir \
     PyMySQL \
-    aerospike==4.0.0 \
-    avro==1.10.2 \
+    aerospike==11.1.0 \
     asyncio \
+    avro==1.10.2 \
+    azure-storage-blob \
     cassandra-driver \
-    confluent-kafka==1.5.0 \
+    confluent-kafka==1.9.2 \
+    delta-spark==2.3.0 \
     dict2xml \
     dicttoxml \
     docker \
@@ -76,47 +78,47 @@ RUN python3 -m pip install --no-cache-dir \
     kafka-python \
     kazoo \
     lz4 \
+    meilisearch==0.18.3 \
     minio \
     nats-py \
     protobuf \
-    psycopg2-binary==2.8.6 \
+    psycopg2-binary==2.9.6 \
+    pyhdfs \
     pymongo==3.11.0 \
+    pyspark==3.3.2 \
     pytest \
     pytest-order==1.0.0 \
-    pytest-timeout \
     pytest-random \
-    pytest-xdist \
     pytest-repeat \
+    pytest-timeout \
+    pytest-xdist \
     pytz \
     redis \
-    tzlocal==2.1 \
-    urllib3 \
     requests-kerberos \
-    pyspark==3.3.2 \
-    delta-spark==2.2.0 \
-    pyhdfs \
-    azure-storage-blob \
-    meilisearch==0.18.3
-
-COPY modprobe.sh /usr/local/bin/modprobe
-COPY dockerd-entrypoint.sh /usr/local/bin/
-COPY compose/ /compose/
-COPY misc/ /misc/
+    tzlocal==2.1 \
+    urllib3
 
+# Hudi supports only spark 3.3.*, not 3.4
 RUN curl -fsSL -O https://dlcdn.apache.org/spark/spark-3.3.2/spark-3.3.2-bin-hadoop3.tgz \
     && tar xzvf spark-3.3.2-bin-hadoop3.tgz -C / \
     && rm spark-3.3.2-bin-hadoop3.tgz
 
 # download spark and packages
 # if you change packages, don't forget to update them in tests/integration/helpers/cluster.py
-RUN echo ":quit" | /spark-3.3.2-bin-hadoop3/bin/spark-shell --packages "org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,io.delta:delta-core_2.12:2.2.0,org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0" > /dev/null
+RUN echo ":quit" | /spark-3.3.2-bin-hadoop3/bin/spark-shell --packages "org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,io.delta:delta-core_2.12:2.3.0,org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0" > /dev/null
 
 RUN set -x \
   && addgroup --system dockremap \
-    && adduser --system dockremap \
+  && adduser --system dockremap \
   && adduser dockremap dockremap \
   && echo 'dockremap:165536:65536' >> /etc/subuid \
-    && echo 'dockremap:165536:65536' >> /etc/subgid
+  && echo 'dockremap:165536:65536' >> /etc/subgid
+
+COPY modprobe.sh /usr/local/bin/modprobe
+COPY dockerd-entrypoint.sh /usr/local/bin/
+COPY compose/ /compose/
+COPY misc/ /misc/
+
 
 # Same options as in test/base/Dockerfile
 # (in case you need to override them in tests)
diff --git a/tests/integration/helpers/cluster.py b/tests/integration/helpers/cluster.py
index c77e67062a1..967eaaa78a5 100644
--- a/tests/integration/helpers/cluster.py
+++ b/tests/integration/helpers/cluster.py
@@ -3054,7 +3054,6 @@ CLICKHOUSE_STAY_ALIVE_COMMAND = "bash -c \"trap 'pkill tail' INT TERM; {} --daem
     CLICKHOUSE_START_COMMAND
 )
 
-# /run/xtables.lock passed inside for correct iptables --wait
 DOCKER_COMPOSE_TEMPLATE = """
 version: '2.3'
 services:
@@ -3066,7 +3065,6 @@ services:
             - {db_dir}:/var/lib/clickhouse/
             - {logs_dir}:/var/log/clickhouse-server/
             - /etc/passwd:/etc/passwd:ro
-            - /run/xtables.lock:/run/xtables.lock:ro
             {binary_volume}
             {odbc_bridge_volume}
             {library_bridge_volume}
diff --git a/tests/integration/helpers/network.py b/tests/integration/helpers/network.py
index 4859a8c5946..2df560708e0 100644
--- a/tests/integration/helpers/network.py
+++ b/tests/integration/helpers/network.py
@@ -271,10 +271,6 @@ class _NetworkManager:
                 image_name,
                 auto_remove=True,
                 command=("sleep %s" % self.container_exit_timeout),
-                # /run/xtables.lock passed inside for correct iptables --wait
-                volumes={
-                    "/run/xtables.lock": {"bind": "/run/xtables.lock", "mode": "ro"}
-                },
                 detach=True,
                 network_mode="host",
             )
diff --git a/tests/integration/pytest.ini b/tests/integration/pytest.ini
index 772c96f7361..e40959bd37b 100644
--- a/tests/integration/pytest.ini
+++ b/tests/integration/pytest.ini
@@ -19,3 +19,6 @@ markers =
     long_run: marks tests which run for a long time
 addopts =
     -m 'not long_run'
+; 'The asyncore module is deprecated' comes from casandra driver
+filterwarnings =
+    ignore:The asyncore module is deprecated:DeprecationWarning
diff --git a/tests/integration/runner b/tests/integration/runner
index 301a707a78d..df52f587eee 100755
--- a/tests/integration/runner
+++ b/tests/integration/runner
@@ -395,39 +395,27 @@ if __name__ == "__main__":
     if args.keyword_expression:
         args.pytest_args += ["-k", args.keyword_expression]
 
-    cmd_base = "docker run {net} {tty} --rm --name {name} --privileged \
-        --volume={odbc_bridge_bin}:/clickhouse-odbc-bridge --volume={bin}:/clickhouse \
-        --volume={library_bridge_bin}:/clickhouse-library-bridge \
-        --volume={base_cfg}:/clickhouse-config --volume={cases_dir}:/ClickHouse/tests/integration \
-        --volume={src_dir}/Server/grpc_protos:/ClickHouse/src/Server/grpc_protos \
-        --volume=/run:/run/host:ro \
-        {dockerd_internal_volume} -e DOCKER_CLIENT_TIMEOUT=300 -e COMPOSE_HTTP_TIMEOUT=600 \
-        -e XTABLES_LOCKFILE=/run/host/xtables.lock \
-        -e PYTHONUNBUFFERED=1 \
-        {env_tags} {env_cleanup} -e PYTEST_OPTS='{parallel} {opts} {tests_list} {rand} -vvv' {img}".format(
-        net=net,
-        tty=tty,
-        bin=args.binary,
-        odbc_bridge_bin=args.odbc_bridge_binary,
-        library_bridge_bin=args.library_bridge_binary,
-        base_cfg=args.base_configs_dir,
-        cases_dir=args.cases_dir,
-        src_dir=args.src_dir,
-        env_tags=env_tags,
-        env_cleanup=env_cleanup,
-        parallel=parallel_args,
-        rand=rand_args,
-        opts=" ".join(args.pytest_args).replace("'", "\\'"),
-        tests_list=" ".join(args.tests_list),
-        dockerd_internal_volume=dockerd_internal_volume,
-        img=DIND_INTEGRATION_TESTS_IMAGE_NAME + ":" + args.docker_image_version,
-        name=CONTAINER_NAME,
+    pytest_opts = " ".join(args.pytest_args).replace("'", "\\'")
+    tests_list = " ".join(args.tests_list)
+    cmd_base = (
+        f"docker run {net} {tty} --rm --name {CONTAINER_NAME} "
+        "--privileged --dns-search='.' "  # since recent dns search leaks from host
+        f"--volume={args.odbc_bridge_binary}:/clickhouse-odbc-bridge "
+        f"--volume={args.binary}:/clickhouse "
+        f"--volume={args.library_bridge_binary}:/clickhouse-library-bridge "
+        f"--volume={args.base_configs_dir}:/clickhouse-config "
+        f"--volume={args.cases_dir}:/ClickHouse/tests/integration "
+        f"--volume={args.src_dir}/Server/grpc_protos:/ClickHouse/src/Server/grpc_protos "
+        f"--volume=/run:/run/host:ro {dockerd_internal_volume} {env_tags} {env_cleanup} "
+        "-e DOCKER_CLIENT_TIMEOUT=300 -e COMPOSE_HTTP_TIMEOUT=600 -e PYTHONUNBUFFERED=1 "
+        f"-e PYTEST_OPTS='{parallel_args} {pytest_opts} {tests_list} {rand_args} -vvv'"
+        f" {DIND_INTEGRATION_TESTS_IMAGE_NAME}:{args.docker_image_version}"
     )
 
     cmd = cmd_base + " " + args.command
     cmd_pre_pull = (
-        cmd_base
-        + " find /compose -name docker_compose_*.yml -exec docker-compose -f '{}' pull \;"
+        f"{cmd_base} find /compose -name docker_compose_*.yml "
+        r"-exec docker-compose -f '{}' pull \;"
     )
 
     containers = subprocess.check_output(
diff --git a/tests/integration/test_storage_hudi/test.py b/tests/integration/test_storage_hudi/test.py
index de9cde43609..2b77f4d6d61 100644
--- a/tests/integration/test_storage_hudi/test.py
+++ b/tests/integration/test_storage_hudi/test.py
@@ -79,7 +79,7 @@ def run_query(instance, query, stdin=None, settings=None):
 
 
 def write_hudi_from_df(spark, table_name, df, result_path, mode="overwrite"):
-    if mode is "overwrite":
+    if mode == "overwrite":
         hudi_write_mode = "insert_overwrite"
     else:
         hudi_write_mode = "upsert"

From 953f1c78855500bdd2a6a603749a65082e0a4067 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 22 Jun 2023 02:36:30 +0200
Subject: [PATCH 1369/1478] Upload fast test binaries to builds bucket

---
 tests/ci/fast_test_check.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/tests/ci/fast_test_check.py b/tests/ci/fast_test_check.py
index 2849759a3ee..d5198e5c3d7 100644
--- a/tests/ci/fast_test_check.py
+++ b/tests/ci/fast_test_check.py
@@ -11,6 +11,7 @@ from typing import List, Tuple
 
 from github import Github
 
+from build_check import get_release_or_pr
 from clickhouse_helper import (
     ClickHouseHelper,
     mark_flaky_tests,
@@ -31,6 +32,7 @@ from s3_helper import S3Helper
 from stopwatch import Stopwatch
 from tee_popen import TeePopen
 from upload_result_helper import upload_results
+from version_helper import get_version_from_repo
 
 NAME = "Fast test"
 
@@ -189,6 +191,17 @@ def main():
 
     ch_helper = ClickHouseHelper()
     mark_flaky_tests(ch_helper, NAME, test_results)
+    s3_path_prefix = os.path.join(
+        get_release_or_pr(pr_info, get_version_from_repo())[0],
+        pr_info.sha,
+        "fast_tests",
+    )
+    build_urls = s3_helper.upload_build_folder_to_s3(
+        os.path.join(output_path, "binaries"),
+        s3_path_prefix,
+        keep_dirs_in_s3_path=False,
+        upload_symlinks=False,
+    )
 
     report_url = upload_results(
         s3_helper,
@@ -197,6 +210,7 @@ def main():
         test_results,
         [run_log_path] + additional_logs,
         NAME,
+        build_urls,
     )
     print(f"::notice ::Report url: {report_url}")
     post_commit_status(commit, state, report_url, description, NAME, pr_info)

From 91dc6dfe34f1239b936506324d552f578cf39fa3 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 22 Jun 2023 18:20:23 +0200
Subject: [PATCH 1370/1478] Update mysql-php-client to the recent rolling
 version

---
 docker/test/integration/mysql_php_client/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/test/integration/mysql_php_client/Dockerfile b/docker/test/integration/mysql_php_client/Dockerfile
index 55db4d15a7f..0e11ae023e6 100644
--- a/docker/test/integration/mysql_php_client/Dockerfile
+++ b/docker/test/integration/mysql_php_client/Dockerfile
@@ -1,7 +1,7 @@
 # docker build -t clickhouse/mysql-php-client .
 # MySQL PHP client docker container
 
-FROM php:8.0.18-cli
+FROM php:8-cli-alpine
 
 COPY ./client.crt client.crt
 COPY ./client.key client.key

From b2bfe2eb87e30e217839ec9b6c063a2e234c6f1f Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 22 Jun 2023 19:10:44 +0200
Subject: [PATCH 1371/1478] The error is changed in psycopg2=2.9.6

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

diff --git a/tests/integration/test_postgresql_protocol/test.py b/tests/integration/test_postgresql_protocol/test.py
index e1d8cbf9bcc..de01bba6862 100644
--- a/tests/integration/test_postgresql_protocol/test.py
+++ b/tests/integration/test_postgresql_protocol/test.py
@@ -111,7 +111,7 @@ def test_psql_client(started_cluster):
 def test_python_client(started_cluster):
     node = cluster.instances["node"]
 
-    with pytest.raises(py_psql.InternalError) as exc_info:
+    with pytest.raises(py_psql.OperationalError) as exc_info:
         ch = py_psql.connect(
             host=node.ip_address,
             port=server_port,
@@ -122,9 +122,7 @@ def test_python_client(started_cluster):
         cur = ch.cursor()
         cur.execute("select name from tables;")
 
-    assert exc_info.value.args == (
-        "Query execution failed.\nDB::Exception: Table default.tables doesn't exist\nSSL connection has been closed unexpectedly\n",
-    )
+    assert exc_info.value.args == ("SSL connection has been closed unexpectedly\n",)
 
     ch = py_psql.connect(
         host=node.ip_address,

From 22c8f1c0be46f5cc5115d6e8c55a963fa466b12e Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 01:46:29 +0200
Subject: [PATCH 1372/1478] Fix test_jemalloc_percpu_arena after upgrade

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

diff --git a/tests/integration/test_jemalloc_percpu_arena/test.py b/tests/integration/test_jemalloc_percpu_arena/test.py
index 0dccde3776e..8de3dcd7ea2 100755
--- a/tests/integration/test_jemalloc_percpu_arena/test.py
+++ b/tests/integration/test_jemalloc_percpu_arena/test.py
@@ -26,7 +26,7 @@ def run_command_in_container(cmd, *args):
             "run",
             "--rm",
             *args,
-            "ubuntu:20.04",
+            "ubuntu:22.04",
             "sh",
             "-c",
             cmd,

From 406896f9a95658a27f298c4c8b154467f8d5cbb8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 02:10:47 +0200
Subject: [PATCH 1373/1478] Create cgroupsv2 subtree for docker-in-docker

---
 docker/test/integration/runner/dockerd-entrypoint.sh | 11 +++++++++++
 tests/integration/test_cgroup_limit/test.py          |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/docker/test/integration/runner/dockerd-entrypoint.sh b/docker/test/integration/runner/dockerd-entrypoint.sh
index 347d904d5c0..3c4ff522b36 100755
--- a/docker/test/integration/runner/dockerd-entrypoint.sh
+++ b/docker/test/integration/runner/dockerd-entrypoint.sh
@@ -12,6 +12,17 @@ echo '{
     "registry-mirrors" : ["http://dockerhub-proxy.dockerhub-proxy-zone:5000"]
 }' | dd of=/etc/docker/daemon.json 2>/dev/null
 
+if [ -f /sys/fs/cgroup/cgroup.controllers ]; then
+    # move the processes from the root group to the /init group,
+    # otherwise writing subtree_control fails with EBUSY.
+    # An error during moving non-existent process (i.e., "cat") is ignored.
+    mkdir -p /sys/fs/cgroup/init
+    xargs -rn1 < /sys/fs/cgroup/cgroup.procs > /sys/fs/cgroup/init/cgroup.procs || :
+    # enable controllers
+    sed -e 's/ / +/g' -e 's/^/+/' < /sys/fs/cgroup/cgroup.controllers \
+        > /sys/fs/cgroup/cgroup.subtree_control
+fi
+
 # In case of test hung it is convenient to use pytest --pdb to debug it,
 # and on hung you can simply press Ctrl-C and it will spawn a python pdb,
 # but on SIGINT dockerd will exit, so ignore it to preserve the daemon.
diff --git a/tests/integration/test_cgroup_limit/test.py b/tests/integration/test_cgroup_limit/test.py
index f6392eca4d7..4ab12436dc9 100644
--- a/tests/integration/test_cgroup_limit/test.py
+++ b/tests/integration/test_cgroup_limit/test.py
@@ -22,7 +22,7 @@ def run_command_in_container(cmd, *args):
             "run",
             "--rm",
             *args,
-            "ubuntu:20.04",
+            "ubuntu:22.04",
             "sh",
             "-c",
             cmd,

From a18300c497a051762f1ffcb5f366d50591a812f1 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 02:28:01 +0200
Subject: [PATCH 1374/1478] Improve logging in integration/test_cgroup_limit

---
 tests/integration/test_cgroup_limit/test.py | 26 +++++++++++----------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/tests/integration/test_cgroup_limit/test.py b/tests/integration/test_cgroup_limit/test.py
index 4ab12436dc9..e77b0f70960 100644
--- a/tests/integration/test_cgroup_limit/test.py
+++ b/tests/integration/test_cgroup_limit/test.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 
+import logging
 import os
 import math
 import subprocess
@@ -16,18 +17,19 @@ def run_command_in_container(cmd, *args):
             f"{alternative_binary}:/usr/bin/clickhouse",
         )
 
-    return subprocess.check_output(
-        [
-            "docker",
-            "run",
-            "--rm",
-            *args,
-            "ubuntu:22.04",
-            "sh",
-            "-c",
-            cmd,
-        ]
-    )
+    command = [
+        "docker",
+        "run",
+        "--rm",
+        *args,
+        "ubuntu:22.04",
+        "sh",
+        "-c",
+        cmd,
+    ]
+
+    logging.debug("Command: %s", " ".join(command))
+    return subprocess.check_output(command)
 
 
 def run_with_cpu_limit(cmd, num_cpus, *args):

From 4f1982e25e9313442f312feb70bc25bd88dfae2c Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 02:51:18 +0200
Subject: [PATCH 1375/1478] API of pika for rabbitmq has changed

---
 tests/integration/test_storage_rabbitmq/test.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/tests/integration/test_storage_rabbitmq/test.py b/tests/integration/test_storage_rabbitmq/test.py
index b4dcf86e0ba..943e7742018 100644
--- a/tests/integration/test_storage_rabbitmq/test.py
+++ b/tests/integration/test_storage_rabbitmq/test.py
@@ -858,7 +858,7 @@ def test_rabbitmq_insert(rabbitmq_cluster):
         if len(insert_messages) == 50:
             channel.stop_consuming()
 
-    consumer.basic_consume(onReceived, queue_name)
+    consumer.basic_consume(queue_name, onReceived)
     consumer.start_consuming()
     consumer_connection.close()
 
@@ -921,7 +921,7 @@ def test_rabbitmq_insert_headers_exchange(rabbitmq_cluster):
         if len(insert_messages) == 50:
             channel.stop_consuming()
 
-    consumer.basic_consume(onReceived, queue_name)
+    consumer.basic_consume(queue_name, onReceived)
     consumer.start_consuming()
     consumer_connection.close()
 
@@ -2991,7 +2991,7 @@ def test_format_with_prefix_and_suffix(rabbitmq_cluster):
         if len(insert_messages) == 2:
             channel.stop_consuming()
 
-    consumer.basic_consume(onReceived, queue_name)
+    consumer.basic_consume(queue_name, onReceived)
 
     consumer.start_consuming()
     consumer_connection.close()
@@ -3050,7 +3050,7 @@ def test_max_rows_per_message(rabbitmq_cluster):
         if len(insert_messages) == 2:
             channel.stop_consuming()
 
-    consumer.basic_consume(onReceived, queue_name)
+    consumer.basic_consume(queue_name, onReceived)
     consumer.start_consuming()
     consumer_connection.close()
 
@@ -3148,7 +3148,7 @@ def test_row_based_formats(rabbitmq_cluster):
             if insert_messages == 2:
                 channel.stop_consuming()
 
-        consumer.basic_consume(onReceived, queue_name)
+        consumer.basic_consume(queue_name, onReceived)
         consumer.start_consuming()
         consumer_connection.close()
 
@@ -3211,7 +3211,7 @@ def test_block_based_formats_1(rabbitmq_cluster):
         if len(insert_messages) == 3:
             channel.stop_consuming()
 
-    consumer.basic_consume(onReceived, queue_name)
+    consumer.basic_consume(queue_name, onReceived)
     consumer.start_consuming()
     consumer_connection.close()
 
@@ -3296,7 +3296,7 @@ def test_block_based_formats_2(rabbitmq_cluster):
             if insert_messages == 9:
                 channel.stop_consuming()
 
-        consumer.basic_consume(onReceived, queue_name)
+        consumer.basic_consume(queue_name, onReceived)
         consumer.start_consuming()
         consumer_connection.close()
 

From f85460d8ef6e5996f9ec56296b3a155344772dd8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 02:56:06 +0200
Subject: [PATCH 1376/1478] Enable tests with broken channel.start_consuming

---
 tests/integration/test_storage_rabbitmq/test.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/tests/integration/test_storage_rabbitmq/test.py b/tests/integration/test_storage_rabbitmq/test.py
index 943e7742018..14764dd3835 100644
--- a/tests/integration/test_storage_rabbitmq/test.py
+++ b/tests/integration/test_storage_rabbitmq/test.py
@@ -2953,7 +2953,6 @@ def test_rabbitmq_address(rabbitmq_cluster):
     instance2.query("drop table rabbit_out sync")
 
 
-@pytest.mark.skip(reason="FIXME: flaky (something with channel.start_consuming()")
 def test_format_with_prefix_and_suffix(rabbitmq_cluster):
     instance.query(
         """
@@ -3002,7 +3001,6 @@ def test_format_with_prefix_and_suffix(rabbitmq_cluster):
     )
 
 
-@pytest.mark.skip(reason="FIXME: flaky (something with channel.start_consuming()")
 def test_max_rows_per_message(rabbitmq_cluster):
     num_rows = 5
 
@@ -3075,7 +3073,6 @@ def test_max_rows_per_message(rabbitmq_cluster):
     assert result == "0\t0\n10\t100\n20\t200\n30\t300\n40\t400\n"
 
 
-@pytest.mark.skip(reason="FIXME: flaky (something with channel.start_consuming()")
 def test_row_based_formats(rabbitmq_cluster):
     num_rows = 10
 
@@ -3172,7 +3169,6 @@ def test_row_based_formats(rabbitmq_cluster):
         assert result == expected
 
 
-@pytest.mark.skip(reason="FIXME: flaky (something with channel.start_consuming()")
 def test_block_based_formats_1(rabbitmq_cluster):
     instance.query(
         """
@@ -3234,7 +3230,6 @@ def test_block_based_formats_1(rabbitmq_cluster):
     ]
 
 
-@pytest.mark.skip(reason="FIXME: flaky (something with channel.start_consuming()")
 def test_block_based_formats_2(rabbitmq_cluster):
     num_rows = 100
 

From 0680f0988c906a01567fae54b2097f5ad60f749d Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 23 Jun 2023 03:02:03 +0200
Subject: [PATCH 1377/1478] Enable other working tests

---
 tests/integration/test_storage_rabbitmq/test.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/tests/integration/test_storage_rabbitmq/test.py b/tests/integration/test_storage_rabbitmq/test.py
index 14764dd3835..751279f5e5a 100644
--- a/tests/integration/test_storage_rabbitmq/test.py
+++ b/tests/integration/test_storage_rabbitmq/test.py
@@ -1020,7 +1020,6 @@ def test_rabbitmq_many_inserts(rabbitmq_cluster):
     ), "ClickHouse lost some messages: {}".format(result)
 
 
-@pytest.mark.skip(reason="Flaky")
 def test_rabbitmq_overloaded_insert(rabbitmq_cluster):
     instance.query(
         """
@@ -2050,7 +2049,6 @@ def test_rabbitmq_restore_failed_connection_without_losses_1(rabbitmq_cluster):
     )
 
 
-@pytest.mark.skip(reason="Timeout: FIXME")
 def test_rabbitmq_restore_failed_connection_without_losses_2(rabbitmq_cluster):
     logging.getLogger("pika").propagate = False
     instance.query(

From f728f9735048d5cea37bb422fefc72ffcab649ce Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 27 Jun 2023 13:54:01 +0200
Subject: [PATCH 1378/1478] Add cgroupsv2 for getCGroupLimitedCPUCores

---
 src/Common/getNumberOfPhysicalCPUCores.cpp | 86 +++++++++++++++++++++-
 1 file changed, 83 insertions(+), 3 deletions(-)

diff --git a/src/Common/getNumberOfPhysicalCPUCores.cpp b/src/Common/getNumberOfPhysicalCPUCores.cpp
index ed82c59140d..8fbb32e911f 100644
--- a/src/Common/getNumberOfPhysicalCPUCores.cpp
+++ b/src/Common/getNumberOfPhysicalCPUCores.cpp
@@ -1,4 +1,5 @@
 #include "getNumberOfPhysicalCPUCores.h"
+#include <filesystem>
 
 #include "config.h"
 #if defined(OS_LINUX)
@@ -7,6 +8,8 @@
 #endif
 
 #include <boost/algorithm/string/trim.hpp>
+#include <boost/algorithm/string/split.hpp>
+#include <base/range.h>
 
 #include <thread>
 #include <set>
@@ -15,7 +18,7 @@ namespace
 {
 
 #if defined(OS_LINUX)
-int32_t readFrom(const char * filename, int default_value)
+int32_t readFrom(const std::filesystem::path & filename, int default_value)
 {
     std::ifstream infile(filename);
     if (!infile.is_open())
@@ -31,10 +34,87 @@ int32_t readFrom(const char * filename, int default_value)
 uint32_t getCGroupLimitedCPUCores(unsigned default_cpu_count)
 {
     uint32_t quota_count = default_cpu_count;
+    std::filesystem::path prefix = "/sys/fs/cgroup";
+    /// cgroupsv2
+    std::ifstream contr_file(prefix / "cgroup.controllers");
+    if (contr_file.is_open())
+    {
+        /// First, we identify the cgroup the process belongs
+        std::ifstream cgroup_name_file("/proc/self/cgroup");
+        if (!cgroup_name_file.is_open())
+            return default_cpu_count;
+
+        // cgroup_name_file always starts with '0::/' for v2
+        cgroup_name_file.ignore(4);
+        std::string cgroup_name;
+        cgroup_name_file >> cgroup_name;
+
+        std::filesystem::path current_cgroup;
+        if (cgroup_name.empty())
+            current_cgroup = prefix;
+        else
+            current_cgroup = prefix / cgroup_name;
+
+        // Looking for cpu.max in directories from the current cgroup to the top level
+        // It does not stop on the first time since the child could have a greater value than parent
+        while (current_cgroup != prefix.parent_path())
+        {
+            std::ifstream cpu_max_file(current_cgroup / "cpu.max");
+            current_cgroup = current_cgroup.parent_path();
+            if (cpu_max_file.is_open())
+            {
+                std::string cpu_limit_str;
+                float cpu_period;
+                cpu_max_file >> cpu_limit_str >> cpu_period;
+                if (cpu_limit_str != "max" && cpu_period != 0)
+                {
+                    float cpu_limit = std::stof(cpu_limit_str);
+                    quota_count = std::min(static_cast<uint32_t>(ceil(cpu_limit / cpu_period)), quota_count);
+                }
+            }
+        }
+        current_cgroup = prefix / cgroup_name;
+        // Looking for cpuset.cpus.effective in directories from the current cgroup to the top level
+        while (current_cgroup != prefix.parent_path())
+        {
+            std::ifstream cpuset_cpus_file(current_cgroup / "cpuset.cpus.effective");
+            current_cgroup = current_cgroup.parent_path();
+            if (cpuset_cpus_file.is_open())
+            {
+                // The line in the file is "0,2-4,6,9-14" cpu numbers
+                // It's always grouped and ordered
+                std::vector<std::string> cpu_ranges;
+                std::string cpuset_line;
+                cpuset_cpus_file >> cpuset_line;
+                if (cpuset_line.empty())
+                    continue;
+                boost::split(cpu_ranges, cpuset_line, boost::is_any_of(","));
+                uint32_t cpus_count = 0;
+                for (const std::string& cpu_number_or_range : cpu_ranges)
+                {
+                    std::vector<std::string> cpu_range;
+                    boost::split(cpu_range, cpu_number_or_range, boost::is_any_of("-"));
+
+                    if (cpu_range.size() == 2)
+                    {
+                        int start = std::stoi(cpu_range[0]);
+                        int end = std::stoi(cpu_range[1]);
+                        cpus_count += (end - start) + 1;
+                    }
+                    else
+                        cpus_count++;
+                }
+                quota_count = std::min(cpus_count, quota_count);
+                break;
+            }
+        }
+        return quota_count;
+    }
+    /// cgroupsv1
     /// Return the number of milliseconds per period process is guaranteed to run.
     /// -1 for no quota
-    int cgroup_quota = readFrom("/sys/fs/cgroup/cpu/cpu.cfs_quota_us", -1);
-    int cgroup_period = readFrom("/sys/fs/cgroup/cpu/cpu.cfs_period_us", -1);
+    int cgroup_quota = readFrom(prefix / "cpu/cpu.cfs_quota_us", -1);
+    int cgroup_period = readFrom(prefix / "cpu/cpu.cfs_period_us", -1);
     if (cgroup_quota > -1 && cgroup_period > 0)
         quota_count = static_cast<uint32_t>(ceil(static_cast<float>(cgroup_quota) / static_cast<float>(cgroup_period)));
 

From 29a0220e63420a60d1aef9cfec0f9c6c0bba8160 Mon Sep 17 00:00:00 2001
From: Thom O'Connor <thom@clickhouse.com>
Date: Wed, 28 Jun 2023 14:42:01 -0600
Subject: [PATCH 1379/1478] Update functions-for-nulls.md

Fixing broken link to HTML anchor on page
---
 docs/en/sql-reference/functions/functions-for-nulls.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/functions/functions-for-nulls.md b/docs/en/sql-reference/functions/functions-for-nulls.md
index 6f82fedaab7..d57b799e94c 100644
--- a/docs/en/sql-reference/functions/functions-for-nulls.md
+++ b/docs/en/sql-reference/functions/functions-for-nulls.md
@@ -8,7 +8,7 @@ sidebar_label: Nullable
 
 ## isNull
 
-Returns whether the argument is [NULL](../../sql-reference/syntax.md#null-literal).
+Returns whether the argument is [NULL](../../sql-reference/syntax.md#null).
 
 ``` sql
 isNull(x)

From 296f9968c04f6ca49599e281b4092f6cffef5bfd Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 28 Jun 2023 23:20:02 +0200
Subject: [PATCH 1380/1478] fix

---
 docker/test/upgrade/run.sh                         |  1 +
 src/Storages/MergeTree/IDataPartStorage.h          |  1 +
 src/Storages/MergeTree/IMergeTreeDataPart.cpp      |  3 ++-
 src/Storages/MergeTree/MergeTreeData.cpp           | 10 ++++++++++
 src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp |  9 +++++++++
 src/Storages/StorageReplicatedMergeTree.cpp        |  9 ++++++---
 6 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index e72c28b7167..8fd514eaa93 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -189,6 +189,7 @@ rg -Fav -e "Code: 236. DB::Exception: Cancelled merging parts" \
            -e "Authentication failed" \
            -e "Cannot flush" \
            -e "Container already exists" \
+           -e "doesn't have metadata version on disk" \
     clickhouse-server.upgrade.log \
     | grep -av -e "_repl_01111_.*Mapping for table with UUID" \
     | zgrep -Fa "<Error>" > /test_output/upgrade_error_messages.txt \
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index b40a9aa1b46..a2ca30bf73a 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -244,6 +244,7 @@ public:
         bool keep_metadata_version = false;
         bool make_source_readonly = false;
         DiskTransactionPtr external_transaction = nullptr;
+        std::optional<int32_t> metadata_version_to_write = std::nullopt;
     };
 
     virtual std::shared_ptr<IDataPartStorage> freeze(
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index 1f105951757..b9591864869 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -1363,7 +1363,8 @@ void IMergeTreeDataPart::loadColumns(bool require)
     {
         loaded_metadata_version = metadata_snapshot->getMetadataVersion();
         old_part_with_no_metadata_version_on_disk = true;
-        LOG_WARNING(storage.log, "Part {} doesn't have metadata version on disk, setting it to {}. "
+        if (storage.supportsReplication())
+            LOG_WARNING(storage.log, "Part {} doesn't have metadata version on disk, setting it to {}. "
                     "It's okay if the part was created by an old version of ClickHouse", name, loaded_metadata_version);
     }
 
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index f3cf4a85953..9f2fa6c0434 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -7349,6 +7349,16 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
         /*save_metadata_callback=*/ {},
         params);
 
+    if (params.metadata_version_to_write.has_value())
+    {
+        chassert(!params.keep_metadata_version);
+        auto out_metadata = dst_part_storage->writeFile(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME, 4096, getContext()->getWriteSettings());
+        writeText(metadata_snapshot->getMetadataVersion(), *out_metadata);
+        out_metadata->finalize();
+        if (getSettings()->fsync_after_insert)
+            out_metadata->sync();
+    }
+
     LOG_DEBUG(log, "Clone{} part {} to {}{}",
               src_flushed_tmp_part ? " flushed" : "",
               src_part_storage->getFullPath(),
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index c93077fb4fb..1c896c4e2a6 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -604,6 +604,15 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::writeExistingPart(MergeTreeData:
 {
     /// NOTE: No delay in this case. That's Ok.
 
+    part->getDataPartStorage().removeFileIfExists(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
+    {
+        auto out_metadata = part->getDataPartStorage().writeFile(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME, 4096, context->getWriteSettings());
+        writeText(metadata_snapshot->getMetadataVersion(), *out_metadata);
+        out_metadata->finalize();
+        if (storage.getSettings()->fsync_after_insert)
+            out_metadata->sync();
+    }
+
     auto origin_zookeeper = storage.getZooKeeper();
     assertSessionIsNotExpired(origin_zookeeper);
     auto zookeeper = std::make_shared<ZooKeeperWithFaultInjection>(origin_zookeeper);
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index b9d48fc75f3..0361d46612b 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -2448,7 +2448,8 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
             bool zero_copy_enabled = dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
             IDataPartStorage::ClonePartParams clone_params
             {
-                .copy_instead_of_hardlink = zero_copy_enabled && part_desc->src_table_part->isStoredOnRemoteDiskWithZeroCopySupport()
+                .copy_instead_of_hardlink = zero_copy_enabled && part_desc->src_table_part->isStoredOnRemoteDiskWithZeroCopySupport(),
+                .metadata_version_to_write = metadata_snapshot->getMetadataVersion()
             };
             auto [res_part, temporary_part_lock] = cloneAndLoadDataPartOnSameDisk(
                 part_desc->src_table_part, TMP_PREFIX + "clone_", part_desc->new_part_info, metadata_snapshot, clone_params);
@@ -7306,7 +7307,8 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
                 || dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
             IDataPartStorage::ClonePartParams clone_params
             {
-                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport()
+                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport(),
+                .metadata_version_to_write = metadata_snapshot->getMetadataVersion()
             };
             auto [dst_part, part_lock] = cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, metadata_snapshot, clone_params);
             src_parts.emplace_back(src_part);
@@ -7545,7 +7547,8 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
                 || dynamic_cast<const MergeTreeData *>(dest_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
             IDataPartStorage::ClonePartParams clone_params
             {
-                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport()
+                .copy_instead_of_hardlink = zero_copy_enabled && src_part->isStoredOnRemoteDiskWithZeroCopySupport(),
+                .metadata_version_to_write = dest_metadata_snapshot->getMetadataVersion()
             };
             auto [dst_part, dst_part_lock] = dest_table_storage->cloneAndLoadDataPartOnSameDisk(src_part, TMP_PREFIX, dst_part_info, dest_metadata_snapshot, clone_params);
 

From 92d7b067b0ae9eff9b28fb41c8ffbeebc8b2c31c Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 28 Jun 2023 23:36:15 +0200
Subject: [PATCH 1381/1478] Bring back lost /tmp cleanup in clickhouse-server
 docker image

---
 docker/server/Dockerfile.ubuntu | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index 1bb0cfdc700..42ae81655d2 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -48,14 +48,15 @@ ARG TARGETARCH
 RUN arch="${TARGETARCH:-amd64}" \
     && if [ -n "${deb_location_url}" ]; then \
         echo "installing from custom url with deb packages: ${deb_location_url}" \
-        rm -rf /tmp/clickhouse_debs \
+        && rm -rf /tmp/clickhouse_debs \
         && mkdir -p /tmp/clickhouse_debs \
         && for package in ${PACKAGES}; do \
             { wget --progress=bar:force:noscroll "${deb_location_url}/${package}_${VERSION}_${arch}.deb" -P /tmp/clickhouse_debs || \
                 wget --progress=bar:force:noscroll "${deb_location_url}/${package}_${VERSION}_all.deb" -P /tmp/clickhouse_debs ; } \
             || exit 1 \
         ; done \
-        && dpkg -i /tmp/clickhouse_debs/*.deb ; \
+        && dpkg -i /tmp/clickhouse_debs/*.deb \
+        && rm -rf /tmp/* ; \
     fi
 
 # install from a single binary
@@ -65,11 +66,12 @@ RUN if [ -n "${single_binary_location_url}" ]; then \
         && mkdir -p /tmp/clickhouse_binary \
         && wget --progress=bar:force:noscroll "${single_binary_location_url}" -O /tmp/clickhouse_binary/clickhouse \
         && chmod +x /tmp/clickhouse_binary/clickhouse \
-        && /tmp/clickhouse_binary/clickhouse install --user "clickhouse" --group "clickhouse" ; \
+        && /tmp/clickhouse_binary/clickhouse install --user "clickhouse" --group "clickhouse" \
+        && rm -rf /tmp/* ; \
     fi
 
 # A fallback to installation from ClickHouse repository
-RUN if ! clickhouse local -q "SELECT ''" > /dev/null; then \
+RUN if ! clickhouse local -q "SELECT ''" > /dev/null 2>&1; then \
         apt-get update \
         && apt-get install --yes --no-install-recommends \
             apt-transport-https \
@@ -90,12 +92,12 @@ RUN if ! clickhouse local -q "SELECT ''" > /dev/null; then \
             packages="${packages} ${package}=${VERSION}" \
         ; done \
         && apt-get install --allow-unauthenticated --yes --no-install-recommends ${packages} || exit 1 \
-    && rm -rf \
-        /var/lib/apt/lists/* \
-        /var/cache/debconf \
-        /tmp/* \
-    && apt-get autoremove --purge -yq libksba8 \
-    && apt-get autoremove -yq \
+        && rm -rf \
+            /var/lib/apt/lists/* \
+            /var/cache/debconf \
+            /tmp/* \
+        && apt-get autoremove --purge -yq libksba8 \
+        && apt-get autoremove -yq \
     ; fi
 
 # post install

From 45232770e06079b2b346209ae7b412597ff5996f Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 29 Jun 2023 00:41:23 +0300
Subject: [PATCH 1382/1478] Try to fix deadlock in ZooKeeper client

---
 src/Common/ZooKeeper/ZooKeeperImpl.cpp | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/Common/ZooKeeper/ZooKeeperImpl.cpp b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
index 14b31c6a411..dd555e39529 100644
--- a/src/Common/ZooKeeper/ZooKeeperImpl.cpp
+++ b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
@@ -362,6 +362,16 @@ ZooKeeper::ZooKeeper(
     {
         tryLogCurrentException(log, "Failed to connect to ZooKeeper");
 
+        try
+        {
+            requests_queue.finish();
+            socket.shutdown();
+        }
+        catch (...)
+        {
+            tryLogCurrentException(log);
+        }
+
         send_thread.join();
         receive_thread.join();
 

From b27cf4e7ba0d9d579722202f693f820777c6bfc7 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 29 Jun 2023 00:15:45 +0200
Subject: [PATCH 1383/1478] fix

---
 src/Storages/MergeTree/MergeTreeData.cpp           | 11 +++++++++--
 src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp | 10 ----------
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 9f2fa6c0434..add48e2cf03 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -4707,12 +4707,19 @@ MergeTreeData::DataPartPtr MergeTreeData::getPartIfExistsUnlocked(const MergeTre
     return nullptr;
 }
 
-static void loadPartAndFixMetadataImpl(MergeTreeData::MutableDataPartPtr part)
+static void loadPartAndFixMetadataImpl(MergeTreeData::MutableDataPartPtr part, ContextPtr local_context, int32_t metadata_version, bool sync)
 {
     /// Remove metadata version file and take it from table.
     /// Currently we cannot attach parts with different schema, so
     /// we can assume that it's equal to table's current schema.
     part->removeMetadataVersion();
+    {
+        auto out_metadata = part->getDataPartStorage().writeFile(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME, 4096, local_context->getWriteSettings());
+        writeText(metadata_version, *out_metadata);
+        out_metadata->finalize();
+        if (sync)
+            out_metadata->sync();
+    }
 
     part->loadColumnsChecksumsIndexes(false, true);
     part->modification_time = part->getDataPartStorage().getLastModified().epochTime();
@@ -5844,7 +5851,7 @@ MergeTreeData::MutableDataPartsVector MergeTreeData::tryLoadPartsToAttach(const
             .withPartFormatFromDisk()
             .build();
 
-        loadPartAndFixMetadataImpl(part);
+        loadPartAndFixMetadataImpl(part, local_context, getInMemoryMetadataPtr()->getMetadataVersion(), getSettings()->fsync_after_insert);
         loaded_parts.push_back(part);
     }
 
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index 1c896c4e2a6..9c5890383dc 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -603,16 +603,6 @@ template<bool async_insert>
 void ReplicatedMergeTreeSinkImpl<async_insert>::writeExistingPart(MergeTreeData::MutableDataPartPtr & part)
 {
     /// NOTE: No delay in this case. That's Ok.
-
-    part->getDataPartStorage().removeFileIfExists(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME);
-    {
-        auto out_metadata = part->getDataPartStorage().writeFile(IMergeTreeDataPart::METADATA_VERSION_FILE_NAME, 4096, context->getWriteSettings());
-        writeText(metadata_snapshot->getMetadataVersion(), *out_metadata);
-        out_metadata->finalize();
-        if (storage.getSettings()->fsync_after_insert)
-            out_metadata->sync();
-    }
-
     auto origin_zookeeper = storage.getZooKeeper();
     assertSessionIsNotExpired(origin_zookeeper);
     auto zookeeper = std::make_shared<ZooKeeperWithFaultInjection>(origin_zookeeper);

From 37ad50bd637b8bfd6612e0b80b8f6dd388a19595 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Wed, 28 Jun 2023 19:40:40 -0300
Subject: [PATCH 1384/1478] Update settings.md

---
 .../server-configuration-parameters/settings.md        | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index 40c1b8d64a1..bad7e388377 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -2120,7 +2120,13 @@ This section contains the following parameters:
 - `operation_timeout_ms` — Maximum timeout for one operation in milliseconds.
 - `root` — The [znode](http://zookeeper.apache.org/doc/r3.5.5/zookeeperOver.html#Nodes+and+ephemeral+nodes) that is used as the root for znodes used by the ClickHouse server. Optional.
 - `identity` — User and password, that can be required by ZooKeeper to give access to requested znodes. Optional.
-
+- zookeeper_load_balancing - Specifies the algorithm of ZooKeeper node selection.
+  * random - randomly selects one of ZooKeeper nodes.
+  * in_order - selects the first ZooKeeper node, if it's not available then the second, and so on.
+  * nearest_hostname - selects a ZooKeeper node with a hostname that is most similar to the server’s hostname.
+  * first_or_random - selects the first ZooKeeper node, if it's not available then randomly selects one of remaining ZooKeeper nodes.
+  * round_robin - selects the first ZooKeeper node, if reconnection happens selects the next.
+    
 **Example configuration**
 
 ``` xml
@@ -2139,6 +2145,8 @@ This section contains the following parameters:
     <root>/path/to/zookeeper/node</root>
     <!-- Optional. Zookeeper digest ACL string. -->
     <identity>user:password</identity>
+    <!--<zookeeper_load_balancing>random / in_order / nearest_hostname / first_or_random / round_robin</zookeeper_load_balancing>-->
+    <zookeeper_load_balancing>random</zookeeper_load_balancing>
 </zookeeper>
 ```
 

From f23bf9c5acdd885d61ec7f68bdf8be1b1fa79dee Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 29 Jun 2023 10:04:36 +0800
Subject: [PATCH 1385/1478] Update redis.md

---
 .../engines/table-engines/integrations/redis.md  | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 568179eb690..7ef87927bfd 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -44,9 +44,10 @@ Create a table in ClickHouse which allows to read data from Redis:
 ``` sql
 CREATE TABLE redis_table
 (
-    `k` String,
-    `m` String,
-    `n` UInt32
+    `key` String,
+    `v1` UInt32,
+    `v2` String,
+    `v3` Float32
 )
 ENGINE = Redis('redis1:6379') PRIMARY KEY(k);
 ```
@@ -111,9 +112,16 @@ Flush Redis db asynchronously. Also `Truncate` support SYNC mode.
 TRUNCATE TABLE redis_table SYNC;
 ```
 
+Join:
+
+Join with other tables.
+
+```
+SELECT * FROM redis_table JOIN merge_tree_table ON redis_table.key=merge_tree_table.key;
+```
 
 ## Limitations {#limitations}
 
 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)
+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 f8f0b7d086d23f70a49be88233b19d152e99e3f4 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 29 Jun 2023 10:09:27 +0800
Subject: [PATCH 1386/1478] fix typo

---
 docs/en/engines/table-engines/integrations/redis.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 7ef87927bfd..2697abcf30e 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -49,7 +49,7 @@ CREATE TABLE redis_table
     `v2` String,
     `v3` Float32
 )
-ENGINE = Redis('redis1:6379') PRIMARY KEY(k);
+ENGINE = Redis('redis1:6379') PRIMARY KEY(key);
 ```
 
 Insert:

From 635ab9f9af3894c42b69ef093cc34e64cefce219 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 29 Jun 2023 12:53:23 +0800
Subject: [PATCH 1387/1478] move redis_table to right

---
 docs/en/engines/table-engines/integrations/redis.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 2697abcf30e..8086a6503b8 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -117,7 +117,7 @@ Join:
 Join with other tables.
 
 ```
-SELECT * FROM redis_table JOIN merge_tree_table ON redis_table.key=merge_tree_table.key;
+SELECT * FROM redis_table JOIN merge_tree_table ON merge_tree_table.key=redis_table.key;
 ```
 
 ## Limitations {#limitations}

From 2392dda4126f00ed968f1496e6b61ab8089832f9 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 29 Jun 2023 09:38:59 +0200
Subject: [PATCH 1388/1478] Changelog for 23.6

---
 CHANGELOG.md | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 72372c8fac4..a2e7b021081 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,5 @@
 ### Table of Contents
+**[ClickHouse release v23.6, 2023-06-30](#236)**<br/>
 **[ClickHouse release v23.5, 2023-06-08](#235)**<br/>
 **[ClickHouse release v23.4, 2023-04-26](#234)**<br/>
 **[ClickHouse release v23.3 LTS, 2023-03-30](#233)**<br/>
@@ -8,6 +9,107 @@
 
 # 2023 Changelog
 
+### <a id="236"></a> ClickHouse release 23.6, 2023-06-29
+
+#### Backward Incompatible Change
+* Delete feature `do_not_evict_index_and_mark_files` in the fs cache. This feature was only making things worse. [#51253](https://github.com/ClickHouse/ClickHouse/pull/51253) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Remove ALTER support for experimental LIVE VIEW. [#51287](https://github.com/ClickHouse/ClickHouse/pull/51287) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Decrease the default values for `http_max_field_value_size` and `http_max_field_name_size` to 128 KiB. [#51163](https://github.com/ClickHouse/ClickHouse/pull/51163) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* CGroups metrics related to CPU are replaced with one metric, `CGroupMaxCPU` for better usability. The `Normalized` CPU usage metrics will be normalized to CGroups limits instead of the total number of CPUs when they are set. This closes [#50836](https://github.com/ClickHouse/ClickHouse/issues/50836). [#50835](https://github.com/ClickHouse/ClickHouse/pull/50835) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### New Feature
+* Added `Overlay` database engine to combine multiple databases into one. Added `Filesystem` database engine to represent a directory in the filesystem as a set of implicitly available tables with auto-detected formats and structures. A new `S3` database engine allows to read-only interact with s3 storage by representing a prefix as a set of tables. A new `HDFS` database engine allows to interact with HDFS storage in the same way. [#48821](https://github.com/ClickHouse/ClickHouse/pull/48821) ([alekseygolub](https://github.com/alekseygolub)).
+* The function `transform` as well as `CASE` with value matching started to support all data types. This closes [#29730](https://github.com/ClickHouse/ClickHouse/issues/29730). This closes [#32387](https://github.com/ClickHouse/ClickHouse/issues/32387). This closes [#50827](https://github.com/ClickHouse/ClickHouse/issues/50827). This closes [#31336](https://github.com/ClickHouse/ClickHouse/issues/31336). This closes [#40493](https://github.com/ClickHouse/ClickHouse/issues/40493). [#51351](https://github.com/ClickHouse/ClickHouse/pull/51351) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Added option `--rename_files_after_processing <pattern>`. This closes [#34207](https://github.com/ClickHouse/ClickHouse/issues/34207). [#49626](https://github.com/ClickHouse/ClickHouse/pull/49626) ([alekseygolub](https://github.com/alekseygolub)).
+* Add support for `APPEND` modifier in `INTO OUTFILE` clause. Suggest using `APPEND` or `TRUNCATE` for `INTO OUTFILE` when file exists. [#50950](https://github.com/ClickHouse/ClickHouse/pull/50950) ([alekar](https://github.com/alekar)).
+* Add table engine `Redis` and table function `redis`. It allows querying external Redis servers. [#50150](https://github.com/ClickHouse/ClickHouse/pull/50150) ([JackyWoo](https://github.com/JackyWoo)).
+* Allow to skip empty files in file/s3/url/hdfs table functions using settings `s3_skip_empty_files`, `hdfs_skip_empty_files`, `engine_file_skip_empty_files`, `engine_url_skip_empty_files`. [#50364](https://github.com/ClickHouse/ClickHouse/pull/50364) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add a new setting named `use_mysql_types_in_show_columns` to alter the `SHOW COLUMNS` SQL statement to display MySQL equivalent types when a client is connected via the MySQL compatibility port. [#49577](https://github.com/ClickHouse/ClickHouse/pull/49577) ([Thomas Panetti](https://github.com/tpanetti)).
+* Clickhouse-client can now be called with a connection string instead of "--host", "--port", "--user" etc. [#50689](https://github.com/ClickHouse/ClickHouse/pull/50689) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Add setting `session_timezone`, it is used as default timezone for session when not explicitly specified. [#44149](https://github.com/ClickHouse/ClickHouse/pull/44149) ([Andrey Zvonov](https://github.com/zvonand)).
+* Codec DEFLATE_QPL is now controlled via server setting "enable_deflate_qpl_codec" (default: false) instead of setting "allow_experimental_codecs". This marks DEFLATE_QPL non-experimental. [#50775](https://github.com/ClickHouse/ClickHouse/pull/50775) ([Robert Schulze](https://github.com/rschu1ze)).
+
+#### Performance Improvement
+* Improved scheduling of merge selecting and cleanup tasks in `ReplicatedMergeTree`. The tasks will not be executed too frequently when there's nothing to merge or cleanup. Added settings `max_merge_selecting_sleep_ms`, `merge_selecting_sleep_slowdown_factor`, `max_cleanup_delay_period` and `cleanup_thread_preferred_points_per_iteration`. It should close [#31919](https://github.com/ClickHouse/ClickHouse/issues/31919). [#50107](https://github.com/ClickHouse/ClickHouse/pull/50107) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Make filter push down through cross join. [#50605](https://github.com/ClickHouse/ClickHouse/pull/50605) ([Han Fei](https://github.com/hanfei1991)).
+* Improve performance with enabled QueryProfiler using thread-local timer_id instead of global object. [#48778](https://github.com/ClickHouse/ClickHouse/pull/48778) ([Jiebin Sun](https://github.com/jiebinn)).
+* Rewrite CapnProto input/output format to improve its performance. Map column names and CapnProto fields case insensitive, fix reading/writing of nested structure fields. [#49752](https://github.com/ClickHouse/ClickHouse/pull/49752) ([Kruglov Pavel](https://github.com/Avogar)).
+* Optimize parquet write performance for parallel threads. [#50102](https://github.com/ClickHouse/ClickHouse/pull/50102) ([Hongbin Ma](https://github.com/binmahone)).
+* Disable `parallelize_output_from_storages` for processing MATERIALIZED VIEWs and storages with one block only. [#50214](https://github.com/ClickHouse/ClickHouse/pull/50214) ([Azat Khuzhin](https://github.com/azat)).
+* Merge PR [#46558](https://github.com/ClickHouse/ClickHouse/pull/46558). Avoid block permutation during sort if the block is already sorted. [#50697](https://github.com/ClickHouse/ClickHouse/pull/50697) ([Alexey Milovidov](https://github.com/alexey-milovidov), [Maksim Kita](https://github.com/kitaisreal)).
+* Make multiple list requests to ZooKeeper in parallel to speed up reading from system.zookeeper table. [#51042](https://github.com/ClickHouse/ClickHouse/pull/51042) ([Alexander Gololobov](https://github.com/davenger)).
+* Speedup initialization of DateTime lookup tables for time zones. This should reduce startup/connect time of clickhouse-client especially in debug build as it is rather heavy. [#51347](https://github.com/ClickHouse/ClickHouse/pull/51347) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix data lakes slowness because of synchronous head requests. (Related to Iceberg/Deltalake/Hudi being slow with a lot of files). [#50976](https://github.com/ClickHouse/ClickHouse/pull/50976) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Do not replicate `ALTER PARTITION` queries and mutations through `Replicated` database if it has only one shard and the underlying table is `ReplicatedMergeTree`. [#51049](https://github.com/ClickHouse/ClickHouse/pull/51049) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* 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)).
+
+#### Experimental Feature
+* Support parallel replicas with the analyzer. [#50441](https://github.com/ClickHouse/ClickHouse/pull/50441) ([Raúl Marín](https://github.com/Algunenano)).
+* Add random sleep before large merges/mutations execution to split load more evenly between replicas in case of zero-copy replication. [#51282](https://github.com/ClickHouse/ClickHouse/pull/51282) ([alesapin](https://github.com/alesapin)).
+
+#### Improvement
+* Relax the thresholds for "too many parts" to be more modern. Return the backpressure during long-running insert queries. [#50856](https://github.com/ClickHouse/ClickHouse/pull/50856) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Allow to cast IPv6 to IPv4 address for CIDR ::ffff:0:0/96 (IPv4-mapped addresses). [#49759](https://github.com/ClickHouse/ClickHouse/pull/49759) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Update MongoDB protocol to support MongoDB 5.1 version and newer. Support for the versions with the old protocol (<3.6) is preserved. Closes [#45621](https://github.com/ClickHouse/ClickHouse/issues/45621), [#49879](https://github.com/ClickHouse/ClickHouse/issues/49879). [#50061](https://github.com/ClickHouse/ClickHouse/pull/50061) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Add setting `input_format_max_bytes_to_read_for_schema_inference` to limit the number of bytes to read in schema inference. Closes [#50577](https://github.com/ClickHouse/ClickHouse/issues/50577). [#50592](https://github.com/ClickHouse/ClickHouse/pull/50592) ([Kruglov Pavel](https://github.com/Avogar)).
+* Respect setting `input_format_null_as_default` in schema inference. [#50602](https://github.com/ClickHouse/ClickHouse/pull/50602) ([Kruglov Pavel](https://github.com/Avogar)).
+* Allow to skip trailing empty lines in CSV/TSV/CustomSeparated formats via settings `input_format_csv_skip_trailing_empty_lines`, `input_format_tsv_skip_trailing_empty_lines` and `input_format_custom_skip_trailing_empty_lines` (disabled by default). Closes [#49315](https://github.com/ClickHouse/ClickHouse/issues/49315). [#50635](https://github.com/ClickHouse/ClickHouse/pull/50635) ([Kruglov Pavel](https://github.com/Avogar)).
+* Functions "toDateOrDefault|OrNull" and "accuateCast[OrDefault|OrNull]" now correctly parse numeric arguments. [#50709](https://github.com/ClickHouse/ClickHouse/pull/50709) ([Dmitry Kardymon](https://github.com/kardymonds)).
+* Support CSV with whitespace or `\t` field delimiters, and these delimiters are supported in Spark. [#50712](https://github.com/ClickHouse/ClickHouse/pull/50712) ([KevinyhZou](https://github.com/KevinyhZou)).
+* Settings `number_of_mutations_to_delay` and `number_of_mutations_to_throw` are enabled by default now with values 500 and 1000 respectively. [#50726](https://github.com/ClickHouse/ClickHouse/pull/50726) ([Anton Popov](https://github.com/CurtizJ)).
+* The dashboard correctly shows missing values. This closes [#50831](https://github.com/ClickHouse/ClickHouse/issues/50831). [#50832](https://github.com/ClickHouse/ClickHouse/pull/50832) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Added the possibility to use date and time arguments in the syslog timestamp format in functions `parseDateTimeBestEffort*` and `parseDateTime64BestEffort*`. [#50925](https://github.com/ClickHouse/ClickHouse/pull/50925) ([Victor Krasnov](https://github.com/sirvickr)).
+* Command line parameter "--password" in clickhouse-client can now be specified only once. [#50966](https://github.com/ClickHouse/ClickHouse/pull/50966) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Use `hash_of_all_files` from `system.parts` to check identity of parts during on-cluster backups. [#50997](https://github.com/ClickHouse/ClickHouse/pull/50997) ([Vitaly Baranov](https://github.com/vitlibar)).
+* The system table zookeeper_connection connected_time identifies the time when the connection is established (standard format), and session_uptime_elapsed_seconds is added, which labels the duration of the established connection session (in seconds). [#51026](https://github.com/ClickHouse/ClickHouse/pull/51026) ([郭小龙](https://github.com/guoxiaolongzte)).
+* Improve the progress bar for file/s3/hdfs/url table functions by using chunk size from source data and using incremental total size counting in each thread. Fix the progress bar for *Cluster functions. This closes [#47250](https://github.com/ClickHouse/ClickHouse/issues/47250). [#51088](https://github.com/ClickHouse/ClickHouse/pull/51088) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add total_bytes_to_read to the Progress packet in TCP protocol for better Progress bar. [#51158](https://github.com/ClickHouse/ClickHouse/pull/51158) ([Kruglov Pavel](https://github.com/Avogar)).
+* Better checking of data parts on disks with filesystem cache. [#51164](https://github.com/ClickHouse/ClickHouse/pull/51164) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix sometimes not correct current_elements_num in fs cache. [#51242](https://github.com/ClickHouse/ClickHouse/pull/51242) ([Kseniia Sumarokova](https://github.com/kssenii)).
+
+#### Build/Testing/Packaging Improvement
+* Add embedded keeper-client to standalone keeper binary. [#50964](https://github.com/ClickHouse/ClickHouse/pull/50964) ([pufit](https://github.com/pufit)).
+* Actual LZ4 version is used now. [#50621](https://github.com/ClickHouse/ClickHouse/pull/50621) ([Nikita Taranov](https://github.com/nickitat)).
+* ClickHouse server will print the list of changed settings on fatal errors. This closes [#51137](https://github.com/ClickHouse/ClickHouse/issues/51137). [#51138](https://github.com/ClickHouse/ClickHouse/pull/51138) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Allow building ClickHouse with clang-17. [#51300](https://github.com/ClickHouse/ClickHouse/pull/51300) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* [SQLancer](https://github.com/sqlancer/sqlancer) check is considered stable as bugs that were triggered by it are fixed. Now failures of SQLancer check will be reported as failed check status. [#51340](https://github.com/ClickHouse/ClickHouse/pull/51340) ([Ilya Yatsishin](https://github.com/qoega)).
+* Split huge `RUN` in Dockerfile into smaller conditional. Install the necessary tools on demand in the same `RUN` layer, and remove them after that. Upgrade the OS only once at the beginning. Use a modern way to check the signed repository. Downgrade the base repo to ubuntu:20.04 to address the issues on older docker versions. Upgrade golang version to address golang vulnerabilities. [#51504](https://github.com/ClickHouse/ClickHouse/pull/51504) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Report loading status for executable dictionaries correctly [#48775](https://github.com/ClickHouse/ClickHouse/pull/48775) ([Anton Kozlov](https://github.com/tonickkozlov)).
+* Proper mutation of skip indices and projections [#50104](https://github.com/ClickHouse/ClickHouse/pull/50104) ([Amos Bird](https://github.com/amosbird)).
+* Cleanup moving parts [#50489](https://github.com/ClickHouse/ClickHouse/pull/50489) ([vdimir](https://github.com/vdimir)).
+* Fix backward compatibility for IP types hashing in aggregate functions [#50551](https://github.com/ClickHouse/ClickHouse/pull/50551) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* 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)).
+* Query Cache: Try to fix bad cast from `ColumnConst` to `ColumnVector<char8_t>` [#50704](https://github.com/ClickHouse/ClickHouse/pull/50704) ([Robert Schulze](https://github.com/rschu1ze)).
+* Avoid storing logs in Keeper containing unknown operation [#50751](https://github.com/ClickHouse/ClickHouse/pull/50751) ([Antonio Andelic](https://github.com/antonio2368)).
+* SummingMergeTree support for DateTime64 [#50797](https://github.com/ClickHouse/ClickHouse/pull/50797) ([Jordi Villar](https://github.com/jrdi)).
+* Add compatibility setting for non-const timezones [#50834](https://github.com/ClickHouse/ClickHouse/pull/50834) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix hashing of LDAP params in the cache entries [#50865](https://github.com/ClickHouse/ClickHouse/pull/50865) ([Julian Maicher](https://github.com/jmaicher)).
+* Fallback to parsing big integer from String instead of exception in Parquet format [#50873](https://github.com/ClickHouse/ClickHouse/pull/50873) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix checking the lock file too often while writing a backup [#50889](https://github.com/ClickHouse/ClickHouse/pull/50889) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Do not apply projection if read-in-order was enabled. [#50923](https://github.com/ClickHouse/ClickHouse/pull/50923) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix race in the Azure blob storage iterator [#50936](https://github.com/ClickHouse/ClickHouse/pull/50936) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix erroneous `sort_description` propagation in `CreatingSets` [#50955](https://github.com/ClickHouse/ClickHouse/pull/50955) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix Iceberg v2 optional metadata parsing [#50974](https://github.com/ClickHouse/ClickHouse/pull/50974) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* MaterializedMySQL: Keep parentheses for empty table overrides [#50977](https://github.com/ClickHouse/ClickHouse/pull/50977) ([Val Doroshchuk](https://github.com/valbok)).
+* Fix crash in BackupCoordinationStageSync::setError() [#51012](https://github.com/ClickHouse/ClickHouse/pull/51012) ([Vitaly Baranov](https://github.com/vitlibar)).
+* 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)).
+* Fix ineffective query cache for SELECTs with subqueries [#51132](https://github.com/ClickHouse/ClickHouse/pull/51132) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix Set index with constant nullable comparison. [#51205](https://github.com/ClickHouse/ClickHouse/pull/51205) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix a crash in s3 and s3Cluster functions [#51209](https://github.com/ClickHouse/ClickHouse/pull/51209) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Fix a crash with compiled expressions [#51231](https://github.com/ClickHouse/ClickHouse/pull/51231) ([LiuNeng](https://github.com/liuneng1994)).
+* Fix use-after-free in StorageURL when switching URLs [#51260](https://github.com/ClickHouse/ClickHouse/pull/51260) ([Michael Kolupaev](https://github.com/al13n321)).
+* Updated check for parameterized view [#51272](https://github.com/ClickHouse/ClickHouse/pull/51272) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix multiple writing of same file to backup [#51299](https://github.com/ClickHouse/ClickHouse/pull/51299) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Fix fuzzer failure in ActionsDAG [#51301](https://github.com/ClickHouse/ClickHouse/pull/51301) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove garbage from function `transform` [#51350](https://github.com/ClickHouse/ClickHouse/pull/51350) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+
 ### <a id="235"></a> ClickHouse release 23.5, 2023-06-08
 
 #### Upgrade Notes

From 340262814a721ca7be1523ff1194c404b0f03de8 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 29 Jun 2023 12:24:19 +0200
Subject: [PATCH 1389/1478] Avoid additional maven requests for spark tests

---
 docker/test/integration/runner/Dockerfile |  6 +++++-
 tests/integration/helpers/cluster.py      | 10 ++++++----
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/docker/test/integration/runner/Dockerfile b/docker/test/integration/runner/Dockerfile
index 40627354f70..38d8ed5f223 100644
--- a/docker/test/integration/runner/Dockerfile
+++ b/docker/test/integration/runner/Dockerfile
@@ -105,7 +105,11 @@ RUN curl -fsSL -O https://dlcdn.apache.org/spark/spark-3.3.2/spark-3.3.2-bin-had
 
 # download spark and packages
 # if you change packages, don't forget to update them in tests/integration/helpers/cluster.py
-RUN echo ":quit" | /spark-3.3.2-bin-hadoop3/bin/spark-shell --packages "org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,io.delta:delta-core_2.12:2.3.0,org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0" > /dev/null
+RUN packages="org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,\
+io.delta:delta-core_2.12:2.3.0,\
+org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0" \
+    && /spark-3.3.2-bin-hadoop3/bin/spark-shell --packages "$packages" > /dev/null \
+    && find /root/.ivy2/ -name '*.jar' -exec ln -sf {} /spark-3.3.2-bin-hadoop3/jars/ \;
 
 RUN set -x \
   && addgroup --system dockremap \
diff --git a/tests/integration/helpers/cluster.py b/tests/integration/helpers/cluster.py
index 967eaaa78a5..21398790be3 100644
--- a/tests/integration/helpers/cluster.py
+++ b/tests/integration/helpers/cluster.py
@@ -624,10 +624,12 @@ class ClickHouseCluster:
             # if you change packages, don't forget to update them in docker/test/integration/runner/dockerd-entrypoint.sh
             (
                 pyspark.sql.SparkSession.builder.appName("spark_test")
-                .config(
-                    "spark.jars.packages",
-                    "org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,io.delta:delta-core_2.12:2.2.0,org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0",
-                )
+                # The jars are now linked to "$SPARK_HOME/jars" and we don't
+                # need packages to be downloaded once and once again
+                # .config(
+                #     "spark.jars.packages",
+                #     "org.apache.hudi:hudi-spark3.3-bundle_2.12:0.13.0,io.delta:delta-core_2.12:2.2.0,org.apache.iceberg:iceberg-spark-runtime-3.3_2.12:1.1.0",
+                # )
                 .master("local")
                 .getOrCreate()
                 .stop()

From 4ba334c98360bb24e7d21eb12453ac5cc765d9d8 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 29 Jun 2023 13:01:31 +0200
Subject: [PATCH 1390/1478] Review fix

---
 src/Disks/getOrCreateDiskFromAST.cpp                       | 7 ++++++-
 .../02808_custom_disk_with_user_defined_name.sh            | 4 +++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/Disks/getOrCreateDiskFromAST.cpp b/src/Disks/getOrCreateDiskFromAST.cpp
index c5ec0f5d91b..93d70738a82 100644
--- a/src/Disks/getOrCreateDiskFromAST.cpp
+++ b/src/Disks/getOrCreateDiskFromAST.cpp
@@ -38,7 +38,12 @@ namespace
         }
         else
         {
-            disk_name = function.name.substr(std::strlen("disk_"));
+            static constexpr std::string_view custom_disk_prefix = "disk_";
+
+            if (disk_name.size() <= custom_disk_prefix.size())
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid disk name: {}", disk_name);
+
+            disk_name = function.name.substr(custom_disk_prefix.size());
         }
 
         auto result_disk = context->getOrCreateDisk(disk_name, [&](const DisksMap & disks_map) -> DiskPtr {
diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
index 99b9a0ed7b3..615da606519 100755
--- a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -1,3 +1,4 @@
+#!/usr/bin/env bash
 # Tags: no-fasttest, no-parallel
 
 # set -x
@@ -14,11 +15,12 @@ ENGINE = MergeTree() ORDER BY tuple()
 SETTINGS disk = disk_s3disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3disk);
 """ 2>&1 | grep -q "Disk with name \`s3disk\` already exist" && echo 'OK' || echo 'FAIL'
 
+disk_name="${CLICKHOUSE_TEST_UNIQUE_NAME}"
+
 $CLICKHOUSE_CLIENT -nm --query """
 SELECT count() FROM system.disks WHERE name = '$disk_name'
 """
 
-disk_name="${CLICKHOUSE_TEST_UNIQUE_NAME}"
 $CLICKHOUSE_CLIENT -nm --query """
 DROP TABLE IF EXISTS test;
 CREATE TABLE test (a Int32, b String)

From 306ca66eb4d3e9ae8ee74004a09ab1d530f46658 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 29 Jun 2023 13:11:22 +0200
Subject: [PATCH 1391/1478] Fix

---
 src/Interpreters/Cache/FileCache.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index eb5b59a447d..e165c0914b6 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -757,12 +757,14 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
                 chassert(candidate->releasable());
 
                 const auto * segment = candidate->file_segment.get();
+                auto queue_it = segment->getQueueIterator();
+                chassert(queue_it);
 
                 ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedFileSegments);
                 ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->range().size());
 
                 locked_key->removeFileSegment(segment->offset(), segment->lock());
-                segment->getQueueIterator()->remove(cache_lock);
+                queue_it->remove(cache_lock);
 
                 if (query_context)
                     query_context->remove(current_key, segment->offset(), cache_lock);

From ff25b72e6da94acb2af9214150131b0c4a8aad88 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 29 Jun 2023 13:30:53 +0200
Subject: [PATCH 1392/1478] Update 02808_custom_disk_with_user_defined_name.sh

---
 .../0_stateless/02808_custom_disk_with_user_defined_name.sh     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
index 615da606519..50dee04f6a6 100755
--- a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest, no-parallel
+# Tags: no-fasttest
 
 # set -x
 

From f73d8786329237ad24f06505dcde23485a83a534 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 29 Jun 2023 13:31:41 +0200
Subject: [PATCH 1393/1478] Update src/Disks/getOrCreateDiskFromAST.cpp

Co-authored-by: Antonio Andelic <antonio2368@users.noreply.github.com>
---
 src/Disks/getOrCreateDiskFromAST.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Disks/getOrCreateDiskFromAST.cpp b/src/Disks/getOrCreateDiskFromAST.cpp
index 93d70738a82..691a51d8b48 100644
--- a/src/Disks/getOrCreateDiskFromAST.cpp
+++ b/src/Disks/getOrCreateDiskFromAST.cpp
@@ -40,7 +40,7 @@ namespace
         {
             static constexpr std::string_view custom_disk_prefix = "disk_";
 
-            if (disk_name.size() <= custom_disk_prefix.size())
+            if (disk_name.size() <= custom_disk_prefix.size() || !disk_name.starts_with(custom_disk_prefix))
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid disk name: {}", disk_name);
 
             disk_name = function.name.substr(custom_disk_prefix.size());

From 1d9d712984df7d63bbcaf232b73dde562619ba55 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Thu, 29 Jun 2023 13:32:17 +0200
Subject: [PATCH 1394/1478] use timeout instead trap in
 01443_merge_truncate_long.sh

---
 .../0_stateless/01443_merge_truncate_long.sh      | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/tests/queries/0_stateless/01443_merge_truncate_long.sh b/tests/queries/0_stateless/01443_merge_truncate_long.sh
index ce867d32c1a..65b9bcd366e 100755
--- a/tests/queries/0_stateless/01443_merge_truncate_long.sh
+++ b/tests/queries/0_stateless/01443_merge_truncate_long.sh
@@ -13,20 +13,20 @@ ${CLICKHOUSE_CLIENT} --query="DROP TABLE IF EXISTS t"
 ${CLICKHOUSE_CLIENT} --query="CREATE TABLE t (x Int8) ENGINE = MergeTree ORDER BY ()"
 
 
-function thread()
+function thread_optimize()
 {
-    trap 'BREAK=1' 2
-
-    while [[ -z "${BREAK}" ]]
+    while true;
     do
         ${CLICKHOUSE_CLIENT} --query="OPTIMIZE TABLE t FINAL;" 2>&1 | tr -d '\n' | rg -v 'Cancelled merging parts' ||:
     done
 }
 
-thread &
-pid=$!
+TIMEOUT=15
+export -f thread_optimize
+timeout $TIMEOUT bash -c thread_optimize 2> /dev/null &
 
-for i in {1..100}; do
+for i in {1..100};
+do
     echo "
         INSERT INTO t VALUES (0);
         INSERT INTO t VALUES (0);
@@ -36,7 +36,6 @@ for i in {1..100}; do
         "
 done | ${CLICKHOUSE_CLIENT} --multiquery
 
-kill -2 "$pid"
 wait
 
 $CLICKHOUSE_CLIENT -q "DROP TABLE t"

From b56d1602e841663f073c6f53a06e848b89c9214e Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 29 Jun 2023 14:25:13 +0200
Subject: [PATCH 1395/1478] Invalidate opened file cache when removing file

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 2 +-
 src/IO/OpenedFileCache.h                        | 9 +++++++--
 src/Interpreters/Cache/FileSegment.h            | 2 ++
 src/Interpreters/Cache/Metadata.cpp             | 5 +++++
 4 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 76d54f9d27c..e4dadb4eb21 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -160,7 +160,7 @@ CachedOnDiskReadBufferFromFile::getCacheReadBuffer(const FileSegment & file_segm
     if (use_external_buffer)
         local_read_settings.local_fs_buffer_size = 0;
 
-    auto buf = createReadBufferFromFileBase(path, local_read_settings);
+    auto buf = createReadBufferFromFileBase(path, local_read_settings, std::nullopt, std::nullopt, file_segment.getFlagsForLocalRead());
 
     if (getFileSizeFromReadBuffer(*buf) == 0)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to read from an empty cache file: {}", path);
diff --git a/src/IO/OpenedFileCache.h b/src/IO/OpenedFileCache.h
index 844e5b31d11..61e502a494b 100644
--- a/src/IO/OpenedFileCache.h
+++ b/src/IO/OpenedFileCache.h
@@ -72,6 +72,13 @@ public:
         return res;
     }
 
+    void remove(const std::string & path, int flags)
+    {
+        Key key(path, flags);
+        std::lock_guard lock(mutex);
+        files.erase(key);
+    }
+
     static OpenedFileCache & instance()
     {
         static OpenedFileCache res;
@@ -82,5 +89,3 @@ public:
 using OpenedFileCachePtr = std::shared_ptr<OpenedFileCache>;
 
 }
-
-
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 681c0d719e4..b8fa9486472 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -161,6 +161,8 @@ public:
 
     String getPathInLocalCache() const;
 
+    int getFlagsForLocalRead() const { return O_RDONLY | O_CLOEXEC; }
+
     /**
      * ========== Methods for _any_ file segment's owner ========================
      */
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index f799bae1e10..f201455384b 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -406,6 +406,11 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     if (exists)
     {
         fs::remove(path);
+
+        int flags = file_segment->getFlagsForLocalRead();
+        OpenedFileCache::instance().remove(path, flags);
+        OpenedFileCache::instance().remove(path, flags | O_DIRECT);
+
         LOG_TEST(key_metadata->log, "Removed file segment at path: {}", path);
     }
     else if (file_segment->downloaded_size)

From bac126fe3edbaec15834ba21ae57b3aec0f3d299 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 29 Jun 2023 15:11:02 +0200
Subject: [PATCH 1396/1478] fix

---
 src/Storages/StorageReplicatedMergeTree.cpp    | 11 ++++-------
 tests/integration/test_merge_tree_hdfs/test.py |  1 -
 tests/integration/test_merge_tree_s3/test.py   |  1 -
 3 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 0361d46612b..a967bf3c4c4 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -7301,7 +7301,6 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
 
             UInt64 index = lock->getNumber();
             MergeTreePartInfo dst_part_info(partition_id, index, index, src_part->info.level);
-            HardlinkedFiles hardlinked_files;
 
             bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
                 || dynamic_cast<const MergeTreeData *>(source_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
@@ -7377,8 +7376,8 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
                     renameTempPartAndReplaceUnlocked(part, transaction, data_parts_lock);
             }
 
-            for (size_t i = 0; i < dst_parts.size(); ++i)
-                lockSharedData(*dst_parts[i], false, /*hardlinked_files*/ {});
+            for (const auto & dst_part : dst_parts)
+                lockSharedData(*dst_part, false, /*hardlinked_files*/ {});
 
             Coordination::Error code = zookeeper->tryMulti(ops, op_results);
             if (code == Coordination::Error::ZOK)
@@ -7541,8 +7540,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
             UInt64 index = lock->getNumber();
             MergeTreePartInfo dst_part_info(partition_id, index, index, src_part->info.level);
 
-            HardlinkedFiles hardlinked_files;
-
             bool zero_copy_enabled = storage_settings_ptr->allow_remote_fs_zero_copy_replication
                 || dynamic_cast<const MergeTreeData *>(dest_table.get())->getSettings()->allow_remote_fs_zero_copy_replication;
             IDataPartStorage::ClonePartParams clone_params
@@ -7625,8 +7622,8 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
                 for (auto & part : dst_parts)
                     dest_table_storage->renameTempPartAndReplaceUnlocked(part, transaction, dest_data_parts_lock);
 
-                for (size_t i = 0; i < dst_parts.size(); ++i)
-                    dest_table_storage->lockSharedData(*dst_parts[i], false, /*hardlinked_files*/ {});
+                for (const auto & dst_part : dst_parts)
+                    dest_table_storage->lockSharedData(*dst_part, false, /*hardlinked_files*/ {});
 
                 Coordination::Error code = zookeeper->tryMulti(ops, op_results);
                 if (code == Coordination::Error::ZBADVERSION)
diff --git a/tests/integration/test_merge_tree_hdfs/test.py b/tests/integration/test_merge_tree_hdfs/test.py
index d1a145c00c1..ae3e2bde836 100644
--- a/tests/integration/test_merge_tree_hdfs/test.py
+++ b/tests/integration/test_merge_tree_hdfs/test.py
@@ -239,7 +239,6 @@ def test_attach_detach_partition(cluster):
         len(hdfs_objects)
         == FILES_OVERHEAD
         + FILES_OVERHEAD_PER_PART_WIDE * 2
-        - FILES_OVERHEAD_METADATA_VERSION
     )
 
     node.query("ALTER TABLE hdfs_test DROP PARTITION '2020-01-03'")
diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index 303fff66166..d0be8a11a06 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -338,7 +338,6 @@ def test_attach_detach_partition(cluster, node_name):
         len(list_objects(cluster, "data/"))
         == FILES_OVERHEAD
         + FILES_OVERHEAD_PER_PART_WIDE * 2
-        - FILES_OVERHEAD_METADATA_VERSION
     )
 
     node.query("ALTER TABLE s3_test DROP PARTITION '2020-01-03'")

From bbd4159beeca878616546b77a3dd36b3a9a391d6 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 29 Jun 2023 13:26:21 +0000
Subject: [PATCH 1397/1478] Automatic style fix

---
 tests/integration/test_merge_tree_hdfs/test.py | 6 +-----
 tests/integration/test_merge_tree_s3/test.py   | 3 +--
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/tests/integration/test_merge_tree_hdfs/test.py b/tests/integration/test_merge_tree_hdfs/test.py
index ae3e2bde836..95b63a5c8a3 100644
--- a/tests/integration/test_merge_tree_hdfs/test.py
+++ b/tests/integration/test_merge_tree_hdfs/test.py
@@ -235,11 +235,7 @@ def test_attach_detach_partition(cluster):
     assert node.query("SELECT count(*) FROM hdfs_test FORMAT Values") == "(8192)"
 
     hdfs_objects = fs.listdir("/clickhouse")
-    assert (
-        len(hdfs_objects)
-        == FILES_OVERHEAD
-        + FILES_OVERHEAD_PER_PART_WIDE * 2
-    )
+    assert len(hdfs_objects) == FILES_OVERHEAD + FILES_OVERHEAD_PER_PART_WIDE * 2
 
     node.query("ALTER TABLE hdfs_test DROP PARTITION '2020-01-03'")
     assert node.query("SELECT count(*) FROM hdfs_test FORMAT Values") == "(4096)"
diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index d0be8a11a06..f754bc905bf 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -336,8 +336,7 @@ def test_attach_detach_partition(cluster, node_name):
     assert node.query("SELECT count(*) FROM s3_test FORMAT Values") == "(8192)"
     assert (
         len(list_objects(cluster, "data/"))
-        == FILES_OVERHEAD
-        + FILES_OVERHEAD_PER_PART_WIDE * 2
+        == FILES_OVERHEAD + FILES_OVERHEAD_PER_PART_WIDE * 2
     )
 
     node.query("ALTER TABLE s3_test DROP PARTITION '2020-01-03'")

From 2a4cfeb01bcff1112d6615ddff529286ff024186 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 29 Jun 2023 15:27:40 +0200
Subject: [PATCH 1398/1478] Add comment

---
 src/Interpreters/Cache/Metadata.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index f201455384b..d4389e0d0b8 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -407,7 +407,10 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     {
         fs::remove(path);
 
+        /// Clear OpenedFileCache to avoid reading from incorrect file descriptor.
         int flags = file_segment->getFlagsForLocalRead();
+        /// Files are created with flags from file_segment->getFlagsForLocalRead()
+        /// plus optionally O_DIRECT is added, depends on query setting, so remove both.
         OpenedFileCache::instance().remove(path, flags);
         OpenedFileCache::instance().remove(path, flags | O_DIRECT);
 

From 0cccba62cfdb6ee9c04a6ec0199d46f91df89160 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Sun, 25 Jun 2023 16:28:18 +0200
Subject: [PATCH 1399/1478] Support getHexUIntLowercase() with
 CityHash_v1_0_2::uint128 parameter.

---
 base/base/hex.h                               | 424 ++++++++++--------
 src/Common/getHashOfLoadedBinary.cpp          |   2 +-
 src/Compression/CompressedReadBufferBase.cpp  |   4 +-
 .../DistributedAsyncInsertHeader.cpp          |   5 +-
 .../MergeTree/MergeTreeDataPartChecksum.cpp   |  14 +-
 .../PartMetadataManagerWithCache.cpp          |   8 +-
 src/Storages/StorageReplicatedMergeTree.cpp   |   3 +-
 src/Storages/System/StorageSystemParts.cpp    |   6 +-
 .../System/StorageSystemProjectionParts.cpp   |   6 +-
 utils/checksum-for-compressed-block/main.cpp  |   2 +-
 10 files changed, 267 insertions(+), 207 deletions(-)

diff --git a/base/base/hex.h b/base/base/hex.h
index b8cf95db893..0780e6159a1 100644
--- a/base/base/hex.h
+++ b/base/base/hex.h
@@ -4,212 +4,286 @@
 #include <cstring>
 #include "types.h"
 
-/// Maps 0..15 to 0..9A..F or 0..9a..f correspondingly.
+namespace CityHash_v1_0_2 { struct uint128; }
 
-constexpr inline std::string_view hex_digit_to_char_uppercase_table = "0123456789ABCDEF";
-constexpr inline std::string_view hex_digit_to_char_lowercase_table = "0123456789abcdef";
+namespace wide
+{
+    template <size_t Bits, typename Signed>
+    class integer;
+}
+
+namespace impl
+{
+    /// Maps 0..15 to 0..9A..F or 0..9a..f correspondingly.
+    constexpr inline std::string_view hex_digit_to_char_uppercase_table = "0123456789ABCDEF";
+    constexpr inline std::string_view hex_digit_to_char_lowercase_table = "0123456789abcdef";
+
+    /// Maps 0..255 to 00..FF or 00..ff correspondingly.
+    constexpr inline std::string_view hex_byte_to_char_uppercase_table = //
+        "000102030405060708090A0B0C0D0E0F"
+        "101112131415161718191A1B1C1D1E1F"
+        "202122232425262728292A2B2C2D2E2F"
+        "303132333435363738393A3B3C3D3E3F"
+        "404142434445464748494A4B4C4D4E4F"
+        "505152535455565758595A5B5C5D5E5F"
+        "606162636465666768696A6B6C6D6E6F"
+        "707172737475767778797A7B7C7D7E7F"
+        "808182838485868788898A8B8C8D8E8F"
+        "909192939495969798999A9B9C9D9E9F"
+        "A0A1A2A3A4A5A6A7A8A9AAABACADAEAF"
+        "B0B1B2B3B4B5B6B7B8B9BABBBCBDBEBF"
+        "C0C1C2C3C4C5C6C7C8C9CACBCCCDCECF"
+        "D0D1D2D3D4D5D6D7D8D9DADBDCDDDEDF"
+        "E0E1E2E3E4E5E6E7E8E9EAEBECEDEEEF"
+        "F0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF";
+
+    constexpr inline std::string_view hex_byte_to_char_lowercase_table = //
+        "000102030405060708090a0b0c0d0e0f"
+        "101112131415161718191a1b1c1d1e1f"
+        "202122232425262728292a2b2c2d2e2f"
+        "303132333435363738393a3b3c3d3e3f"
+        "404142434445464748494a4b4c4d4e4f"
+        "505152535455565758595a5b5c5d5e5f"
+        "606162636465666768696a6b6c6d6e6f"
+        "707172737475767778797a7b7c7d7e7f"
+        "808182838485868788898a8b8c8d8e8f"
+        "909192939495969798999a9b9c9d9e9f"
+        "a0a1a2a3a4a5a6a7a8a9aaabacadaeaf"
+        "b0b1b2b3b4b5b6b7b8b9babbbcbdbebf"
+        "c0c1c2c3c4c5c6c7c8c9cacbcccdcecf"
+        "d0d1d2d3d4d5d6d7d8d9dadbdcdddedf"
+        "e0e1e2e3e4e5e6e7e8e9eaebecedeeef"
+        "f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff";
+
+    /// Maps 0..255 to 00000000..11111111 correspondingly.
+    constexpr inline std::string_view bin_byte_to_char_table = //
+        "0000000000000001000000100000001100000100000001010000011000000111"
+        "0000100000001001000010100000101100001100000011010000111000001111"
+        "0001000000010001000100100001001100010100000101010001011000010111"
+        "0001100000011001000110100001101100011100000111010001111000011111"
+        "0010000000100001001000100010001100100100001001010010011000100111"
+        "0010100000101001001010100010101100101100001011010010111000101111"
+        "0011000000110001001100100011001100110100001101010011011000110111"
+        "0011100000111001001110100011101100111100001111010011111000111111"
+        "0100000001000001010000100100001101000100010001010100011001000111"
+        "0100100001001001010010100100101101001100010011010100111001001111"
+        "0101000001010001010100100101001101010100010101010101011001010111"
+        "0101100001011001010110100101101101011100010111010101111001011111"
+        "0110000001100001011000100110001101100100011001010110011001100111"
+        "0110100001101001011010100110101101101100011011010110111001101111"
+        "0111000001110001011100100111001101110100011101010111011001110111"
+        "0111100001111001011110100111101101111100011111010111111001111111"
+        "1000000010000001100000101000001110000100100001011000011010000111"
+        "1000100010001001100010101000101110001100100011011000111010001111"
+        "1001000010010001100100101001001110010100100101011001011010010111"
+        "1001100010011001100110101001101110011100100111011001111010011111"
+        "1010000010100001101000101010001110100100101001011010011010100111"
+        "1010100010101001101010101010101110101100101011011010111010101111"
+        "1011000010110001101100101011001110110100101101011011011010110111"
+        "1011100010111001101110101011101110111100101111011011111010111111"
+        "1100000011000001110000101100001111000100110001011100011011000111"
+        "1100100011001001110010101100101111001100110011011100111011001111"
+        "1101000011010001110100101101001111010100110101011101011011010111"
+        "1101100011011001110110101101101111011100110111011101111011011111"
+        "1110000011100001111000101110001111100100111001011110011011100111"
+        "1110100011101001111010101110101111101100111011011110111011101111"
+        "1111000011110001111100101111001111110100111101011111011011110111"
+        "1111100011111001111110101111101111111100111111011111111011111111";
+
+    /// Maps 0..9, A..F, a..f to 0..15. Other chars are mapped to implementation specific value.
+    constexpr inline std::string_view hex_char_to_digit_table
+        = {"\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\xff\xff\xff\xff\xff\xff" //0-9
+        "\xff\x0a\x0b\x0c\x0d\x0e\x0f\xff\xff\xff\xff\xff\xff\xff\xff\xff" //A-Z
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\x0a\x0b\x0c\x0d\x0e\x0f\xff\xff\xff\xff\xff\xff\xff\xff\xff" //a-z
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
+        "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff",
+        256};
+
+    /// Converts a hex digit '0'..'f' or '0'..'F' to its value 0..15.
+    constexpr UInt8 unhexDigit(char c)
+    {
+        return hex_char_to_digit_table[static_cast<UInt8>(c)];
+    }
+
+    /// Converts an unsigned integer in the native endian to hexadecimal representation and back. Used as a base class for HexConversion<T>.
+    template <typename TUInt, typename = void>
+    struct HexConversionUInt
+    {
+        static const constexpr size_t num_hex_digits = sizeof(TUInt) * 2;
+
+        static void hex(TUInt uint_, char * out, std::string_view table)
+        {
+            union
+            {
+                TUInt value;
+                UInt8 uint8[sizeof(TUInt)];
+            };
+
+            value = uint_;
+
+            for (size_t i = 0; i < sizeof(TUInt); ++i)
+            {
+                if constexpr (std::endian::native == std::endian::little)
+                    memcpy(out + i * 2, &table[static_cast<size_t>(uint8[sizeof(TUInt) - 1 - i]) * 2], 2);
+                else
+                    memcpy(out + i * 2, &table[static_cast<size_t>(uint8[i]) * 2], 2);
+            }
+        }
+
+        static TUInt unhex(const char * data)
+        {
+            TUInt res;
+            if constexpr (sizeof(TUInt) == 1)
+            {
+                res = static_cast<UInt8>(unhexDigit(data[0])) * 0x10 + static_cast<UInt8>(unhexDigit(data[1]));
+            }
+            else if constexpr (sizeof(TUInt) == 2)
+            {
+                res = static_cast<UInt16>(unhexDigit(data[0])) * 0x1000 + static_cast<UInt16>(unhexDigit(data[1])) * 0x100
+                    + static_cast<UInt16>(unhexDigit(data[2])) * 0x10 + static_cast<UInt16>(unhexDigit(data[3]));
+            }
+            else if constexpr ((sizeof(TUInt) <= 8) || ((sizeof(TUInt) % 8) != 0))
+            {
+                res = 0;
+                for (size_t i = 0; i < sizeof(TUInt) * 2; ++i, ++data)
+                {
+                    res <<= 4;
+                    res += unhexDigit(*data);
+                }
+            }
+            else
+            {
+                res = 0;
+                for (size_t i = 0; i < sizeof(TUInt) / 8; ++i, data += 16)
+                {
+                    res <<= 64;
+                    res += HexConversionUInt<UInt64>::unhex(data);
+                }
+            }
+            return res;
+        }
+    };
+
+    /// Helper template class to convert a value of any supported type to hexadecimal representation and back.
+    template <typename T, typename = void>
+    struct HexConversion;
+
+    template <typename TUInt>
+    struct HexConversion<TUInt, std::enable_if_t<std::is_integral_v<TUInt>>> : public HexConversionUInt<TUInt> {};
+
+    template <size_t Bits, typename Signed>
+    struct HexConversion<wide::integer<Bits, Signed>> : public HexConversionUInt<wide::integer<Bits, Signed>> {};
+
+    template <typename CityHashUInt128>
+    struct HexConversion<CityHashUInt128, std::enable_if_t<std::is_same_v<CityHashUInt128, typename CityHash_v1_0_2::uint128>>>
+    {
+        static const constexpr size_t num_hex_digits = 32;
+
+        static void hex(const CityHashUInt128 & uint_, char * out, std::string_view table)
+        {
+            HexConversion<UInt64>::hex(uint_.high64, out, table);
+            HexConversion<UInt64>::hex(uint_.low64, out + 16, table);
+        }
+
+        static CityHashUInt128 unhex(const char * data)
+        {
+            CityHashUInt128 res;
+            res.high64 = HexConversion<UInt64>::unhex(data);
+            res.low64 = HexConversion<UInt64>::unhex(data + 16);
+            return res;
+        }
+    };
+}
+
+/// Produces a hexadecimal representation of an integer value with leading zeros (for checksums).
+/// The function supports native integer types, wide::integer, CityHash_v1_0_2::uint128.
+template <typename T>
+void writeHexUIntUppercase(const T & value, char * out)
+{
+    impl::HexConversion<T>::hex(value, out, impl::hex_byte_to_char_uppercase_table);
+}
+
+template <typename T>
+void writeHexUIntLowercase(const T & value, char * out)
+{
+    impl::HexConversion<T>::hex(value, out, impl::hex_byte_to_char_lowercase_table);
+}
+
+template <typename T>
+std::string getHexUIntUppercase(const T & value)
+{
+    std::string res(impl::HexConversion<T>::num_hex_digits, '\0');
+    writeHexUIntUppercase(value, res.data());
+    return res;
+}
+
+template <typename T>
+std::string getHexUIntLowercase(const T & value)
+{
+    std::string res(impl::HexConversion<T>::num_hex_digits, '\0');
+    writeHexUIntLowercase(value, res.data());
+    return res;
+}
 
 constexpr char hexDigitUppercase(unsigned char c)
 {
-    return hex_digit_to_char_uppercase_table[c];
+    return impl::hex_digit_to_char_uppercase_table[c];
 }
+
 constexpr char hexDigitLowercase(unsigned char c)
 {
-    return hex_digit_to_char_lowercase_table[c];
+    return impl::hex_digit_to_char_lowercase_table[c];
 }
 
-/// Maps 0..255 to 00..FF or 00..ff correspondingly
-
-constexpr inline std::string_view hex_byte_to_char_uppercase_table = //
-    "000102030405060708090A0B0C0D0E0F"
-    "101112131415161718191A1B1C1D1E1F"
-    "202122232425262728292A2B2C2D2E2F"
-    "303132333435363738393A3B3C3D3E3F"
-    "404142434445464748494A4B4C4D4E4F"
-    "505152535455565758595A5B5C5D5E5F"
-    "606162636465666768696A6B6C6D6E6F"
-    "707172737475767778797A7B7C7D7E7F"
-    "808182838485868788898A8B8C8D8E8F"
-    "909192939495969798999A9B9C9D9E9F"
-    "A0A1A2A3A4A5A6A7A8A9AAABACADAEAF"
-    "B0B1B2B3B4B5B6B7B8B9BABBBCBDBEBF"
-    "C0C1C2C3C4C5C6C7C8C9CACBCCCDCECF"
-    "D0D1D2D3D4D5D6D7D8D9DADBDCDDDEDF"
-    "E0E1E2E3E4E5E6E7E8E9EAEBECEDEEEF"
-    "F0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF";
-
-constexpr inline std::string_view hex_byte_to_char_lowercase_table = //
-    "000102030405060708090a0b0c0d0e0f"
-    "101112131415161718191a1b1c1d1e1f"
-    "202122232425262728292a2b2c2d2e2f"
-    "303132333435363738393a3b3c3d3e3f"
-    "404142434445464748494a4b4c4d4e4f"
-    "505152535455565758595a5b5c5d5e5f"
-    "606162636465666768696a6b6c6d6e6f"
-    "707172737475767778797a7b7c7d7e7f"
-    "808182838485868788898a8b8c8d8e8f"
-    "909192939495969798999a9b9c9d9e9f"
-    "a0a1a2a3a4a5a6a7a8a9aaabacadaeaf"
-    "b0b1b2b3b4b5b6b7b8b9babbbcbdbebf"
-    "c0c1c2c3c4c5c6c7c8c9cacbcccdcecf"
-    "d0d1d2d3d4d5d6d7d8d9dadbdcdddedf"
-    "e0e1e2e3e4e5e6e7e8e9eaebecedeeef"
-    "f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff";
-
 inline void writeHexByteUppercase(UInt8 byte, void * out)
 {
-    memcpy(out, &hex_byte_to_char_uppercase_table[static_cast<size_t>(byte) * 2], 2);
+    memcpy(out, &impl::hex_byte_to_char_uppercase_table[static_cast<size_t>(byte) * 2], 2);
 }
 
 inline void writeHexByteLowercase(UInt8 byte, void * out)
 {
-    memcpy(out, &hex_byte_to_char_lowercase_table[static_cast<size_t>(byte) * 2], 2);
+    memcpy(out, &impl::hex_byte_to_char_lowercase_table[static_cast<size_t>(byte) * 2], 2);
 }
 
-constexpr inline std::string_view bin_byte_to_char_table = //
-    "0000000000000001000000100000001100000100000001010000011000000111"
-    "0000100000001001000010100000101100001100000011010000111000001111"
-    "0001000000010001000100100001001100010100000101010001011000010111"
-    "0001100000011001000110100001101100011100000111010001111000011111"
-    "0010000000100001001000100010001100100100001001010010011000100111"
-    "0010100000101001001010100010101100101100001011010010111000101111"
-    "0011000000110001001100100011001100110100001101010011011000110111"
-    "0011100000111001001110100011101100111100001111010011111000111111"
-    "0100000001000001010000100100001101000100010001010100011001000111"
-    "0100100001001001010010100100101101001100010011010100111001001111"
-    "0101000001010001010100100101001101010100010101010101011001010111"
-    "0101100001011001010110100101101101011100010111010101111001011111"
-    "0110000001100001011000100110001101100100011001010110011001100111"
-    "0110100001101001011010100110101101101100011011010110111001101111"
-    "0111000001110001011100100111001101110100011101010111011001110111"
-    "0111100001111001011110100111101101111100011111010111111001111111"
-    "1000000010000001100000101000001110000100100001011000011010000111"
-    "1000100010001001100010101000101110001100100011011000111010001111"
-    "1001000010010001100100101001001110010100100101011001011010010111"
-    "1001100010011001100110101001101110011100100111011001111010011111"
-    "1010000010100001101000101010001110100100101001011010011010100111"
-    "1010100010101001101010101010101110101100101011011010111010101111"
-    "1011000010110001101100101011001110110100101101011011011010110111"
-    "1011100010111001101110101011101110111100101111011011111010111111"
-    "1100000011000001110000101100001111000100110001011100011011000111"
-    "1100100011001001110010101100101111001100110011011100111011001111"
-    "1101000011010001110100101101001111010100110101011101011011010111"
-    "1101100011011001110110101101101111011100110111011101111011011111"
-    "1110000011100001111000101110001111100100111001011110011011100111"
-    "1110100011101001111010101110101111101100111011011110111011101111"
-    "1111000011110001111100101111001111110100111101011111011011110111"
-    "1111100011111001111110101111101111111100111111011111111011111111";
-
-inline void writeBinByte(UInt8 byte, void * out)
+/// Converts a hex representation with leading zeros back to an integer value.
+/// The function supports native integer types, wide::integer, CityHash_v1_0_2::uint128.
+template <typename T>
+constexpr T unhexUInt(const char * data)
 {
-    memcpy(out, &bin_byte_to_char_table[static_cast<size_t>(byte) * 8], 8);
+    return impl::HexConversion<T>::unhex(data);
 }
 
-/// Produces hex representation of an unsigned int with leading zeros (for checksums)
-template <typename TUInt>
-inline void writeHexUIntImpl(TUInt uint_, char * out, std::string_view table)
-{
-    union
-    {
-        TUInt value;
-        UInt8 uint8[sizeof(TUInt)];
-    };
-
-    value = uint_;
-
-    for (size_t i = 0; i < sizeof(TUInt); ++i)
-    {
-        if constexpr (std::endian::native == std::endian::little)
-            memcpy(out + i * 2, &table[static_cast<size_t>(uint8[sizeof(TUInt) - 1 - i]) * 2], 2);
-        else
-            memcpy(out + i * 2, &table[static_cast<size_t>(uint8[i]) * 2], 2);
-    }
-}
-
-template <typename TUInt>
-inline void writeHexUIntUppercase(TUInt uint_, char * out)
-{
-    writeHexUIntImpl(uint_, out, hex_byte_to_char_uppercase_table);
-}
-
-template <typename TUInt>
-inline void writeHexUIntLowercase(TUInt uint_, char * out)
-{
-    writeHexUIntImpl(uint_, out, hex_byte_to_char_lowercase_table);
-}
-
-template <typename TUInt>
-std::string getHexUIntUppercase(TUInt uint_)
-{
-    std::string res(sizeof(TUInt) * 2, '\0');
-    writeHexUIntUppercase(uint_, res.data());
-    return res;
-}
-
-template <typename TUInt>
-std::string getHexUIntLowercase(TUInt uint_)
-{
-    std::string res(sizeof(TUInt) * 2, '\0');
-    writeHexUIntLowercase(uint_, res.data());
-    return res;
-}
-
-/// Maps 0..9, A..F, a..f to 0..15. Other chars are mapped to implementation specific value.
-
-constexpr inline std::string_view hex_char_to_digit_table
-    = {"\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\xff\xff\xff\xff\xff\xff" //0-9
-       "\xff\x0a\x0b\x0c\x0d\x0e\x0f\xff\xff\xff\xff\xff\xff\xff\xff\xff" //A-Z
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\x0a\x0b\x0c\x0d\x0e\x0f\xff\xff\xff\xff\xff\xff\xff\xff\xff" //a-z
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"
-       "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff",
-       256};
-
+/// Converts a hexadecimal digit '0'..'f' or '0'..'F' to UInt8.
 constexpr UInt8 unhex(char c)
 {
-    return hex_char_to_digit_table[static_cast<UInt8>(c)];
+    return impl::unhexDigit(c);
 }
 
+/// Converts two hexadecimal digits to UInt8.
 constexpr UInt8 unhex2(const char * data)
 {
-    return static_cast<UInt8>(unhex(data[0])) * 0x10 + static_cast<UInt8>(unhex(data[1]));
+    return unhexUInt<UInt8>(data);
 }
 
+/// Converts four hexadecimal digits to UInt16.
 constexpr UInt16 unhex4(const char * data)
 {
-    return static_cast<UInt16>(unhex(data[0])) * 0x1000 + static_cast<UInt16>(unhex(data[1])) * 0x100
-        + static_cast<UInt16>(unhex(data[2])) * 0x10 + static_cast<UInt16>(unhex(data[3]));
+    return unhexUInt<UInt16>(data);
 }
 
-template <typename TUInt>
-constexpr TUInt unhexUInt(const char * data)
+/// Produces a binary representation of a single byte.
+inline void writeBinByte(UInt8 byte, void * out)
 {
-    TUInt res = 0;
-    if constexpr ((sizeof(TUInt) <= 8) || ((sizeof(TUInt) % 8) != 0))
-    {
-        for (size_t i = 0; i < sizeof(TUInt) * 2; ++i, ++data)
-        {
-            res <<= 4;
-            res += unhex(*data);
-        }
-    }
-    else
-    {
-        for (size_t i = 0; i < sizeof(TUInt) / 8; ++i, data += 16)
-        {
-            res <<= 64;
-            res += unhexUInt<UInt64>(data);
-        }
-    }
-    return res;
+    memcpy(out, &impl::bin_byte_to_char_table[static_cast<size_t>(byte) * 8], 8);
 }
diff --git a/src/Common/getHashOfLoadedBinary.cpp b/src/Common/getHashOfLoadedBinary.cpp
index cc0ad0d2143..b81300b8536 100644
--- a/src/Common/getHashOfLoadedBinary.cpp
+++ b/src/Common/getHashOfLoadedBinary.cpp
@@ -37,7 +37,7 @@ SipHash getHashOfLoadedBinary()
 std::string getHashOfLoadedBinaryHex()
 {
     SipHash hash = getHashOfLoadedBinary();
-    std::array<UInt64, 2> checksum;
+    UInt128 checksum;
     hash.get128(checksum);
     return getHexUIntUppercase(checksum);
 }
diff --git a/src/Compression/CompressedReadBufferBase.cpp b/src/Compression/CompressedReadBufferBase.cpp
index bae52c8bece..dd19955d010 100644
--- a/src/Compression/CompressedReadBufferBase.cpp
+++ b/src/Compression/CompressedReadBufferBase.cpp
@@ -49,8 +49,8 @@ static void validateChecksum(char * data, size_t size, const Checksum expected_c
 
     /// TODO mess up of endianness in error message.
     message << "Checksum doesn't match: corrupted data."
-        " Reference: " + getHexUIntLowercase(expected_checksum.high64) + getHexUIntLowercase(expected_checksum.low64)
-        + ". Actual: " + getHexUIntLowercase(calculated_checksum.high64) + getHexUIntLowercase(calculated_checksum.low64)
+        " Reference: " + getHexUIntLowercase(expected_checksum)
+        + ". Actual: " + getHexUIntLowercase(calculated_checksum)
         + ". Size of compressed block: " + toString(size);
 
     const char * message_hardware_failure = "This is most likely due to hardware failure. "
diff --git a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
index e1b54304f23..a8ed89e66f1 100644
--- a/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
+++ b/src/Storages/Distributed/DistributedAsyncInsertHeader.cpp
@@ -39,9 +39,8 @@ DistributedAsyncInsertHeader DistributedAsyncInsertHeader::read(ReadBufferFromFi
         if (expected_checksum != calculated_checksum)
         {
             throw Exception(ErrorCodes::CHECKSUM_DOESNT_MATCH,
-                            "Checksum of extra info doesn't match: corrupted data. Reference: {}{}. Actual: {}{}.",
-                            getHexUIntLowercase(expected_checksum.high64), getHexUIntLowercase(expected_checksum.low64),
-                            getHexUIntLowercase(calculated_checksum.high64), getHexUIntLowercase(calculated_checksum.low64));
+                            "Checksum of extra info doesn't match: corrupted data. Reference: {}. Actual: {}.",
+                            getHexUIntLowercase(expected_checksum), getHexUIntLowercase(calculated_checksum));
         }
 
         /// Read the parts of the header.
diff --git a/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp b/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
index 58ba7acb9ba..6628cd68eaf 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartChecksum.cpp
@@ -307,19 +307,7 @@ static void updateHash(SipHash & hash, const std::string & data)
 /// Hash is the same as MinimalisticDataPartChecksums::hash_of_all_files
 String MergeTreeDataPartChecksums::getTotalChecksumHex() const
 {
-    SipHash hash_of_all_files;
-
-    for (const auto & [name, checksum] : files)
-    {
-        updateHash(hash_of_all_files, name);
-        hash_of_all_files.update(checksum.file_hash);
-    }
-
-    UInt64 lo;
-    UInt64 hi;
-    hash_of_all_files.get128(lo, hi);
-
-    return getHexUIntUppercase(hi) + getHexUIntUppercase(lo);
+    return getHexUIntUppercase(getTotalChecksumUInt128());
 }
 
 MergeTreeDataPartChecksums::Checksum::uint128 MergeTreeDataPartChecksums::getTotalChecksumUInt128() const
diff --git a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
index 324bd4bbaee..bb6462b3058 100644
--- a/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
+++ b/src/Storages/MergeTree/PartMetadataManagerWithCache.cpp
@@ -250,8 +250,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                     ErrorCodes::CORRUPTED_DATA,
                     "Checksums doesn't match in part {} for {}. Expected: {}. Found {}.",
                     part->name, file_path,
-                    getHexUIntUppercase(disk_checksum.high64) + getHexUIntUppercase(disk_checksum.low64),
-                    getHexUIntUppercase(cache_checksums[i].high64) + getHexUIntUppercase(cache_checksums[i].low64));
+                    getHexUIntUppercase(disk_checksum),
+                    getHexUIntUppercase(cache_checksums[i]));
 
             disk_checksums.push_back(disk_checksum);
             continue;
@@ -287,8 +287,8 @@ std::unordered_map<String, IPartMetadataManager::uint128> PartMetadataManagerWit
                 ErrorCodes::CORRUPTED_DATA,
                 "Checksums doesn't match in projection part {} {}. Expected: {}. Found {}.",
                 part->name, proj_name,
-                getHexUIntUppercase(disk_checksum.high64) + getHexUIntUppercase(disk_checksum.low64),
-                getHexUIntUppercase(cache_checksums[i].high64) + getHexUIntUppercase(cache_checksums[i].low64));
+                getHexUIntUppercase(disk_checksum),
+                getHexUIntUppercase(cache_checksums[i]));
         disk_checksums.push_back(disk_checksum);
     }
     return results;
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index b1ba06c77f9..a2138efdf56 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -2891,8 +2891,7 @@ void StorageReplicatedMergeTree::cloneReplica(const String & source_replica, Coo
                 desired_checksums = MinimalisticDataPartChecksums::deserializeFrom(desired_checksums_str);
             }
 
-            const auto [lo, hi] = desired_checksums.hash_of_all_files;
-            log_entry.part_checksum = getHexUIntUppercase(hi) + getHexUIntUppercase(lo);
+            log_entry.part_checksum = getHexUIntUppercase(desired_checksums.hash_of_all_files);
         }
         else
         {
diff --git a/src/Storages/System/StorageSystemParts.cpp b/src/Storages/System/StorageSystemParts.cpp
index b642f4b5088..7399bd789a7 100644
--- a/src/Storages/System/StorageSystemParts.cpp
+++ b/src/Storages/System/StorageSystemParts.cpp
@@ -252,17 +252,17 @@ void StorageSystemParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
         }
 
diff --git a/src/Storages/System/StorageSystemProjectionParts.cpp b/src/Storages/System/StorageSystemProjectionParts.cpp
index 05c83747c4d..213865a8d61 100644
--- a/src/Storages/System/StorageSystemProjectionParts.cpp
+++ b/src/Storages/System/StorageSystemProjectionParts.cpp
@@ -221,17 +221,17 @@ void StorageSystemProjectionParts::processNextStorage(
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_all_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.hash_of_uncompressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
             if (columns_mask[src_index++])
             {
                 auto checksum = helper.uncompressed_hash_of_compressed_files;
-                columns[res_index++]->insert(getHexUIntLowercase(checksum.high64) + getHexUIntLowercase(checksum.low64));
+                columns[res_index++]->insert(getHexUIntLowercase(checksum));
             }
         }
 
diff --git a/utils/checksum-for-compressed-block/main.cpp b/utils/checksum-for-compressed-block/main.cpp
index d30a3798820..4ae06a78ab4 100644
--- a/utils/checksum-for-compressed-block/main.cpp
+++ b/utils/checksum-for-compressed-block/main.cpp
@@ -45,7 +45,7 @@ int main(int, char **)
     {
         auto flipped = flipBit(str, pos);
         auto checksum = CityHash_v1_0_2::CityHash128(flipped.data(), flipped.size());
-        std::cout << getHexUIntLowercase(checksum.high64) << getHexUIntLowercase(checksum.low64) << "\t" << pos / 8 << ", " << pos % 8 << "\n";
+        std::cout << getHexUIntLowercase(checksum) << "\t" << pos / 8 << ", " << pos % 8 << "\n";
     }
 
     return 0;

From 5656d18690bd00b0db48c1e12e48e0446e263465 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 29 Jun 2023 13:36:55 +0000
Subject: [PATCH 1400/1478] Update version_date.tsv and changelogs after
 v23.5.4.25-stable

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v23.5.4.25-stable.md | 31 ++++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 5 files changed, 35 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.5.4.25-stable.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 367f6043b90..6d53a6f4c51 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.3.24"
+ARG VERSION="23.5.4.25"
 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 e7e879fa95f..91b22346f13 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.3.24"
+ARG VERSION="23.5.4.25"
 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 42ae81655d2..0ed0e4e1168 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -23,7 +23,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.3.24"
+ARG VERSION="23.5.4.25"
 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.4.25-stable.md b/docs/changelogs/v23.5.4.25-stable.md
new file mode 100644
index 00000000000..53d3a7c9c0a
--- /dev/null
+++ b/docs/changelogs/v23.5.4.25-stable.md
@@ -0,0 +1,31 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.5.4.25-stable (190f962abcf) FIXME as compared to v23.5.3.24-stable (76f54616d3b)
+
+#### Improvement
+* Backported in [#51235](https://github.com/ClickHouse/ClickHouse/issues/51235): Improve the progress bar for file/s3/hdfs/url table functions by using chunk size from source data and using incremental total size counting in each thread. Fix the progress bar for *Cluster functions. This closes [#47250](https://github.com/ClickHouse/ClickHouse/issues/47250). [#51088](https://github.com/ClickHouse/ClickHouse/pull/51088) ([Kruglov Pavel](https://github.com/Avogar)).
+* Backported in [#51255](https://github.com/ClickHouse/ClickHouse/issues/51255): Disable cache setting `do_not_evict_index_and_mark_files` (Was enabled in `23.5`). [#51222](https://github.com/ClickHouse/ClickHouse/pull/51222) ([Kseniia Sumarokova](https://github.com/kssenii)).
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#51531](https://github.com/ClickHouse/ClickHouse/issues/51531): Split huge `RUN` in Dockerfile into smaller conditional. Install the necessary tools on demand in the same `RUN` layer, and remove them after that. Upgrade the OS only once at the beginning. Use a modern way to check the signed repository. Downgrade the base repo to ubuntu:20.04 to address the issues on older docker versions. Upgrade golang version to address golang vulnerabilities. [#51504](https://github.com/ClickHouse/ClickHouse/pull/51504) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Backported in [#51572](https://github.com/ClickHouse/ClickHouse/issues/51572): This a follow-up for [#51504](https://github.com/ClickHouse/ClickHouse/issues/51504), the cleanup was lost during refactoring. [#51564](https://github.com/ClickHouse/ClickHouse/pull/51564) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Query Cache: Try to fix bad cast from ColumnConst to ColumnVector<char8_t> [#50704](https://github.com/ClickHouse/ClickHouse/pull/50704) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix type of LDAP server params hash in cache entry [#50865](https://github.com/ClickHouse/ClickHouse/pull/50865) ([Julian Maicher](https://github.com/jmaicher)).
+* Fallback to parsing big integer from String instead of exception in Parquet format [#50873](https://github.com/ClickHouse/ClickHouse/pull/50873) ([Kruglov Pavel](https://github.com/Avogar)).
+* Do not apply projection if read-in-order was enabled. [#50923](https://github.com/ClickHouse/ClickHouse/pull/50923) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix race azure blob storage iterator [#50936](https://github.com/ClickHouse/ClickHouse/pull/50936) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix ineffective query cache for SELECTs with subqueries [#51132](https://github.com/ClickHouse/ClickHouse/pull/51132) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix fuzzer failure in ActionsDAG [#51301](https://github.com/ClickHouse/ClickHouse/pull/51301) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Fix ParallelReadBuffer seek [#50820](https://github.com/ClickHouse/ClickHouse/pull/50820) ([Michael Kolupaev](https://github.com/al13n321)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 307ed97068f..5c8dd0d2481 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,3 +1,4 @@
+v23.5.4.25-stable	2023-06-29
 v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09

From 6ec85f9faa548e50ec1a6b4a2d7868c9f7e0079a Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Thu, 29 Jun 2023 11:06:28 -0300
Subject: [PATCH 1401/1478] 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 cff65e049f3..cff13302cdc 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -1322,7 +1322,7 @@ Connection pool size for PostgreSQL table engine and database engine.
 
 Default value: 16
 
-## postgresql_connection_pool_size {#postgresql-connection-pool-size}
+## postgresql_connection_pool_wait_timeout {#postgresql-connection-pool-wait-timeout}
 
 Connection pool push/pop timeout on empty pool for PostgreSQL table engine and database engine. By default it will block on empty pool.
 

From d1bb8f24c0f99ad4af37747306e06691b34c8955 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Thu, 29 Jun 2023 08:55:06 +0000
Subject: [PATCH 1402/1478] Retry chroot creation in ZK

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

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index 21cb3168083..914e51a9f66 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -90,6 +90,30 @@ sleep 5
 
 attach_gdb_to_clickhouse || true  # FIXME: to not break old builds, clean on 2023-09-01
 
+function run_with_retry()
+{
+    set +e
+
+    local total_retries="$1"
+    shift
+
+    local retry=0
+
+    until [ "$retry" -ge "$total_retries" ]
+    do
+        if "$@"; then
+            set -e
+            return
+        else
+            retry=$((retry + 1))
+            sleep 3
+        fi
+    done
+
+    echo "Command '$*' failed after $total_retries retries, exiting"
+    exit 1
+}
+
 function run_tests()
 {
     set -x
@@ -138,7 +162,8 @@ function run_tests()
     ADDITIONAL_OPTIONS+=('--report-logs-stats')
 
     clickhouse-test "00001_select_1" > /dev/null ||:
-    clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')" ||:
+
+    run_with_retry 5 clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')"
 
     set +e
     clickhouse-test --testname --shard --zookeeper --check-zookeeper-session --hung-check --print-time \

From 65ecf79a0ffedf142902f5ece9db6f9d9954496c Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 29 Jun 2023 17:52:59 +0200
Subject: [PATCH 1403/1478] Update getOrCreateDiskFromAST.cpp

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

diff --git a/src/Disks/getOrCreateDiskFromAST.cpp b/src/Disks/getOrCreateDiskFromAST.cpp
index 691a51d8b48..81d5b7372f3 100644
--- a/src/Disks/getOrCreateDiskFromAST.cpp
+++ b/src/Disks/getOrCreateDiskFromAST.cpp
@@ -40,8 +40,8 @@ namespace
         {
             static constexpr std::string_view custom_disk_prefix = "disk_";
 
-            if (disk_name.size() <= custom_disk_prefix.size() || !disk_name.starts_with(custom_disk_prefix))
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid disk name: {}", disk_name);
+            if (function.name.size() <= custom_disk_prefix.size() || !function.name.starts_with(custom_disk_prefix))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid disk name: {}", function.name);
 
             disk_name = function.name.substr(custom_disk_prefix.size());
         }

From 4ee094cab1a4aed4091679e54e6ac146b2423693 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Thu, 29 Jun 2023 12:13:26 -0400
Subject: [PATCH 1404/1478] review comments

---
 .../table-engines/mergetree-family/mergetree.md    | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index 1b7f3263ab9..a1c2fbdbe50 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -758,12 +758,14 @@ If you perform the `SELECT` query between merges, you may get expired data. To a
 
 ## Disk types
 
-In addition to local block devices, ClickHouse supports other device types through table engines. These are the types:
-- [S3](#table_engine-mergetree-s3)
-- GCS (also supported using the [S3 table engine](#table_engine-mergetree-s3))
-- [Azure Blob Storage](#table_engine-mergetree-azure-blob-storage)
-- [HDFS](#hdfs-storage)
-- [Web (read-only)](#web-storage)
+In addition to local block devices, ClickHouse supports these storage types:
+- [`s3` for S3 and MinIO](#table_engine-mergetree-s3)
+- [`gcs` for GCS](/docs/en/integrations/data-ingestion/gcs/index.md/#creating-a-disk)
+- [`blob_storage_disk` for Azure Blob Storage](#table_engine-mergetree-azure-blob-storage)
+- [`hdfs` for HDFS](#hdfs-storage)
+- [`web` for read-only from web](#web-storage)
+- [`cache` for local caching](/docs/en/operations/storing-data.md/#using-local-cache)
+- [`s3_plain` for backups to S3](/docs/en/operations/backup#backuprestore-using-an-s3-disk)
 
 ## Using Multiple Block Devices for Data Storage {#table_engine-mergetree-multiple-volumes}
 

From a28728b7e537f26faf0c4785fc9fb96218178594 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 29 Jun 2023 17:40:10 +0300
Subject: [PATCH 1405/1478] Update DatabaseReplicatedWorker.cpp

(cherry picked from commit 43fc1af1b3855652536037cc2b5111f5ae1ac983)
---
 src/Databases/DatabaseReplicatedWorker.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Databases/DatabaseReplicatedWorker.cpp b/src/Databases/DatabaseReplicatedWorker.cpp
index 593d0655777..4976f54e417 100644
--- a/src/Databases/DatabaseReplicatedWorker.cpp
+++ b/src/Databases/DatabaseReplicatedWorker.cpp
@@ -161,7 +161,7 @@ bool DatabaseReplicatedDDLWorker::waitForReplicaToProcessAllEntries(UInt64 timeo
         LOG_TRACE(log, "Waiting for worker thread to process all entries before {}, current task is {}", max_log, current_task);
         bool processed = wait_current_task_change.wait_for(lock, std::chrono::milliseconds(timeout_ms), [&]()
         {
-            return zookeeper->expired() || current_task == max_log || stop_flag;
+            return zookeeper->expired() || current_task >= max_log || stop_flag;
         });
 
         if (!processed)

From f12c257dc95de8188e2be8a70344b0bd0b1f6204 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 29 Jun 2023 19:25:46 +0200
Subject: [PATCH 1406/1478] Fix

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

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index dc1f012f5c6..463d0d6605c 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -1017,7 +1017,8 @@ void FileCache::deactivateBackgroundOperations()
 
     metadata.cancelDownload();
     for (auto & thread : download_threads)
-        thread.join();
+        if (thread.joinable())
+            thread.join();
 }
 
 void FileCache::cleanup()

From 7d416cbc60c89ce34e03e7e9de5045e0120af119 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Thu, 29 Jun 2023 13:39:39 -0400
Subject: [PATCH 1407/1478] add exception docs for hasAll

---
 .../sql-reference/functions/array-functions.md  | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/docs/en/sql-reference/functions/array-functions.md b/docs/en/sql-reference/functions/array-functions.md
index bdd1445c990..7f2b8f3c605 100644
--- a/docs/en/sql-reference/functions/array-functions.md
+++ b/docs/en/sql-reference/functions/array-functions.md
@@ -230,13 +230,15 @@ hasAll(set, subset)
 **Arguments**
 
 - `set` – Array of any type with a set of elements.
-- `subset` – Array of any type with elements that should be tested to be a subset of `set`.
+- `subset` – Array of any type that shares a common supertype with `set` containing elements that should be tested to be a subset of `set`.
 
 **Return values**
 
 - `1`, if `set` contains all of the elements from `subset`.
 - `0`, otherwise.
 
+Raises an exception `NO_COMMON_TYPE` if the set and subset elements do not share a common supertype.
+
 **Peculiar properties**
 
 - An empty array is a subset of any array.
@@ -253,7 +255,7 @@ hasAll(set, subset)
 
 `SELECT hasAll(['a', 'b'], ['a'])` returns 1.
 
-`SELECT hasAll([1], ['a'])` returns 0.
+`SELECT hasAll([1], ['a'])` raises a `NO_COMMON_TYPE` exception.
 
 `SELECT hasAll([[1, 2], [3, 4]], [[1, 2], [3, 5]])` returns 0.
 
@@ -268,13 +270,15 @@ hasAny(array1, array2)
 **Arguments**
 
 - `array1` – Array of any type with a set of elements.
-- `array2` – Array of any type with a set of elements.
+- `array2` – Array of any type that shares a common supertype with `array1`.
 
 **Return values**
 
 - `1`, if `array1` and `array2` have one similar element at least.
 - `0`, otherwise.
 
+Raises an exception `NO_COMMON_TYPE` if the array1 and array2 elements do not share a common supertype.
+
 **Peculiar properties**
 
 - `Null` processed as a value.
@@ -288,7 +292,7 @@ hasAny(array1, array2)
 
 `SELECT hasAny([-128, 1., 512], [1])` returns `1`.
 
-`SELECT hasAny([[1, 2], [3, 4]], ['a', 'c'])` returns `0`.
+`SELECT hasAny([[1, 2], [3, 4]], ['a', 'c'])` raises a `NO_COMMON_TYPE` exception.
 
 `SELECT hasAll([[1, 2], [3, 4]], [[1, 2], [1, 2]])` returns `1`.
 
@@ -318,6 +322,8 @@ For Example:
 - `1`, if `array1` contains `array2`.
 - `0`, otherwise.
 
+Raises an exception `NO_COMMON_TYPE` if the array1 and array2 elements do not share a common supertype.
+
 **Peculiar properties**
 
 - The function will return `1` if `array2` is empty.
@@ -339,6 +345,9 @@ For Example:
 `SELECT hasSubstr(['a', 'b' , 'c'], ['a', 'c'])` returns 0.
 
 `SELECT hasSubstr([[1, 2], [3, 4], [5, 6]], [[1, 2], [3, 4]])` returns 1.
+i
+`SELECT hasSubstr([1, 2, NULL, 3, 4], ['a'])` raises a `NO_COMMON_TYPE` exception.
+
 
 ## indexOf(arr, x)
 

From a8172ca5d2557673d370de4f4551f756ff0722a7 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Thu, 29 Jun 2023 14:47:23 -0400
Subject: [PATCH 1408/1478] update spelling list

---
 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 526e674a154..f25d082e5a6 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -2264,6 +2264,7 @@ summap
 summingmergetree
 sumwithoverflow
 superaggregates
+supertype
 supremum
 symlink
 symlinks

From 90129b92c1dd47c0aa86cd5ed7c8107758a74b51 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 29 Jun 2023 21:19:41 +0200
Subject: [PATCH 1409/1478] Update 23.6 changelog

---
 CHANGELOG.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a2e7b021081..c1e0dba4465 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,7 +21,7 @@
 * Added `Overlay` database engine to combine multiple databases into one. Added `Filesystem` database engine to represent a directory in the filesystem as a set of implicitly available tables with auto-detected formats and structures. A new `S3` database engine allows to read-only interact with s3 storage by representing a prefix as a set of tables. A new `HDFS` database engine allows to interact with HDFS storage in the same way. [#48821](https://github.com/ClickHouse/ClickHouse/pull/48821) ([alekseygolub](https://github.com/alekseygolub)).
 * The function `transform` as well as `CASE` with value matching started to support all data types. This closes [#29730](https://github.com/ClickHouse/ClickHouse/issues/29730). This closes [#32387](https://github.com/ClickHouse/ClickHouse/issues/32387). This closes [#50827](https://github.com/ClickHouse/ClickHouse/issues/50827). This closes [#31336](https://github.com/ClickHouse/ClickHouse/issues/31336). This closes [#40493](https://github.com/ClickHouse/ClickHouse/issues/40493). [#51351](https://github.com/ClickHouse/ClickHouse/pull/51351) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Added option `--rename_files_after_processing <pattern>`. This closes [#34207](https://github.com/ClickHouse/ClickHouse/issues/34207). [#49626](https://github.com/ClickHouse/ClickHouse/pull/49626) ([alekseygolub](https://github.com/alekseygolub)).
-* Add support for `APPEND` modifier in `INTO OUTFILE` clause. Suggest using `APPEND` or `TRUNCATE` for `INTO OUTFILE` when file exists. [#50950](https://github.com/ClickHouse/ClickHouse/pull/50950) ([alekar](https://github.com/alekar)).
+* Add support for `TRUNCATE` modifier in `INTO OUTFILE` clause. Suggest using `APPEND` or `TRUNCATE` for `INTO OUTFILE` when file exists. [#50950](https://github.com/ClickHouse/ClickHouse/pull/50950) ([alekar](https://github.com/alekar)).
 * Add table engine `Redis` and table function `redis`. It allows querying external Redis servers. [#50150](https://github.com/ClickHouse/ClickHouse/pull/50150) ([JackyWoo](https://github.com/JackyWoo)).
 * Allow to skip empty files in file/s3/url/hdfs table functions using settings `s3_skip_empty_files`, `hdfs_skip_empty_files`, `engine_file_skip_empty_files`, `engine_url_skip_empty_files`. [#50364](https://github.com/ClickHouse/ClickHouse/pull/50364) ([Kruglov Pavel](https://github.com/Avogar)).
 * Add a new setting named `use_mysql_types_in_show_columns` to alter the `SHOW COLUMNS` SQL statement to display MySQL equivalent types when a client is connected via the MySQL compatibility port. [#49577](https://github.com/ClickHouse/ClickHouse/pull/49577) ([Thomas Panetti](https://github.com/tpanetti)).
@@ -40,12 +40,12 @@
 * Make multiple list requests to ZooKeeper in parallel to speed up reading from system.zookeeper table. [#51042](https://github.com/ClickHouse/ClickHouse/pull/51042) ([Alexander Gololobov](https://github.com/davenger)).
 * Speedup initialization of DateTime lookup tables for time zones. This should reduce startup/connect time of clickhouse-client especially in debug build as it is rather heavy. [#51347](https://github.com/ClickHouse/ClickHouse/pull/51347) ([Alexander Gololobov](https://github.com/davenger)).
 * Fix data lakes slowness because of synchronous head requests. (Related to Iceberg/Deltalake/Hudi being slow with a lot of files). [#50976](https://github.com/ClickHouse/ClickHouse/pull/50976) ([Kseniia Sumarokova](https://github.com/kssenii)).
-* Do not replicate `ALTER PARTITION` queries and mutations through `Replicated` database if it has only one shard and the underlying table is `ReplicatedMergeTree`. [#51049](https://github.com/ClickHouse/ClickHouse/pull/51049) ([Alexander Tokmakov](https://github.com/tavplubix)).
 * 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)).
 
 #### Experimental Feature
 * Support parallel replicas with the analyzer. [#50441](https://github.com/ClickHouse/ClickHouse/pull/50441) ([Raúl Marín](https://github.com/Algunenano)).
 * Add random sleep before large merges/mutations execution to split load more evenly between replicas in case of zero-copy replication. [#51282](https://github.com/ClickHouse/ClickHouse/pull/51282) ([alesapin](https://github.com/alesapin)).
+* Do not replicate `ALTER PARTITION` queries and mutations through `Replicated` database if it has only one shard and the underlying table is `ReplicatedMergeTree`. [#51049](https://github.com/ClickHouse/ClickHouse/pull/51049) ([Alexander Tokmakov](https://github.com/tavplubix)).
 
 #### Improvement
 * Relax the thresholds for "too many parts" to be more modern. Return the backpressure during long-running insert queries. [#50856](https://github.com/ClickHouse/ClickHouse/pull/50856) ([Alexey Milovidov](https://github.com/alexey-milovidov)).

From f48de18640467e6302c1bd48799e386d4aa39437 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 29 Jun 2023 20:59:01 +0000
Subject: [PATCH 1410/1478] Update version_date.tsv and changelogs after
 v23.4.5.22-stable

---
 docs/changelogs/v23.4.5.22-stable.md | 27 +++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  2 ++
 2 files changed, 29 insertions(+)
 create mode 100644 docs/changelogs/v23.4.5.22-stable.md

diff --git a/docs/changelogs/v23.4.5.22-stable.md b/docs/changelogs/v23.4.5.22-stable.md
new file mode 100644
index 00000000000..2d61f5b11cf
--- /dev/null
+++ b/docs/changelogs/v23.4.5.22-stable.md
@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.4.5.22-stable (0ced5d6a8da) FIXME as compared to v23.4.4.16-stable (747ba4fc6a0)
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#51530](https://github.com/ClickHouse/ClickHouse/issues/51530): Split huge `RUN` in Dockerfile into smaller conditional. Install the necessary tools on demand in the same `RUN` layer, and remove them after that. Upgrade the OS only once at the beginning. Use a modern way to check the signed repository. Downgrade the base repo to ubuntu:20.04 to address the issues on older docker versions. Upgrade golang version to address golang vulnerabilities. [#51504](https://github.com/ClickHouse/ClickHouse/pull/51504) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Backported in [#51570](https://github.com/ClickHouse/ClickHouse/issues/51570): This a follow-up for [#51504](https://github.com/ClickHouse/ClickHouse/issues/51504), the cleanup was lost during refactoring. [#51564](https://github.com/ClickHouse/ClickHouse/pull/51564) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### 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)).
+* 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)).
+* Fix incorrect constant folding [#50536](https://github.com/ClickHouse/ClickHouse/pull/50536) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix type of LDAP server params hash in cache entry [#50865](https://github.com/ClickHouse/ClickHouse/pull/50865) ([Julian Maicher](https://github.com/jmaicher)).
+* Fallback to parsing big integer from String instead of exception in Parquet format [#50873](https://github.com/ClickHouse/ClickHouse/pull/50873) ([Kruglov Pavel](https://github.com/Avogar)).
+* Do not apply projection if read-in-order was enabled. [#50923](https://github.com/ClickHouse/ClickHouse/pull/50923) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix fuzzer failure in ActionsDAG [#51301](https://github.com/ClickHouse/ClickHouse/pull/51301) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### 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 5c8dd0d2481..4ca5d1d7497 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -2,10 +2,12 @@ v23.5.4.25-stable	2023-06-29
 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.5.22-stable	2023-06-29
 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.7.5-lts	2023-06-29
 v23.3.6.7-lts	2023-06-28
 v23.3.5.9-lts	2023-06-22
 v23.3.4.17-lts	2023-06-17

From a0bf1708837667c1f3d00dded295ec5ade7a4ac9 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 29 Jun 2023 21:01:19 +0000
Subject: [PATCH 1411/1478] Update version_date.tsv and changelogs after
 v23.3.7.5-lts

---
 docs/changelogs/v23.3.7.5-lts.md     | 16 ++++++++++++++++
 utils/list-versions/version_date.tsv |  2 ++
 2 files changed, 18 insertions(+)
 create mode 100644 docs/changelogs/v23.3.7.5-lts.md

diff --git a/docs/changelogs/v23.3.7.5-lts.md b/docs/changelogs/v23.3.7.5-lts.md
new file mode 100644
index 00000000000..7a5fd5a19b6
--- /dev/null
+++ b/docs/changelogs/v23.3.7.5-lts.md
@@ -0,0 +1,16 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.3.7.5-lts (bc683c11c92) FIXME as compared to v23.3.6.7-lts (7e3f0a271b7)
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#51568](https://github.com/ClickHouse/ClickHouse/issues/51568): This a follow-up for [#51504](https://github.com/ClickHouse/ClickHouse/issues/51504), the cleanup was lost during refactoring. [#51564](https://github.com/ClickHouse/ClickHouse/pull/51564) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix fuzzer failure in ActionsDAG [#51301](https://github.com/ClickHouse/ClickHouse/pull/51301) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 5c8dd0d2481..4ca5d1d7497 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -2,10 +2,12 @@ v23.5.4.25-stable	2023-06-29
 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.5.22-stable	2023-06-29
 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.7.5-lts	2023-06-29
 v23.3.6.7-lts	2023-06-28
 v23.3.5.9-lts	2023-06-22
 v23.3.4.17-lts	2023-06-17

From fd5f6ee2f99989f9ab5c80ecbce1a0b6ab7ae109 Mon Sep 17 00:00:00 2001
From: Ramazan Polat <ramazanpolat@gmail.com>
Date: Fri, 30 Jun 2023 04:32:41 +0300
Subject: [PATCH 1412/1478] Update parts.md

Fix misalignment of `active`
---
 docs/en/operations/system-tables/parts.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/system-tables/parts.md b/docs/en/operations/system-tables/parts.md
index 9159d1e9284..5829e5ad313 100644
--- a/docs/en/operations/system-tables/parts.md
+++ b/docs/en/operations/system-tables/parts.md
@@ -27,7 +27,7 @@ Columns:
 
     Data storing format is controlled by the `min_bytes_for_wide_part` and `min_rows_for_wide_part` settings of the [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) table.
 
-   - `active` ([UInt8](../../sql-reference/data-types/int-uint.md)) – Flag that indicates whether the data part is active. If a data part is active, it’s used in a table. Otherwise, it’s deleted. Inactive data parts remain after merging.
+- `active` ([UInt8](../../sql-reference/data-types/int-uint.md)) – Flag that indicates whether the data part is active. If a data part is active, it’s used in a table. Otherwise, it’s deleted. Inactive data parts remain after merging.
 
 - `marks` ([UInt64](../../sql-reference/data-types/int-uint.md)) – The number of marks. To get the approximate number of rows in a data part, multiply `marks` by the index granularity (usually 8192) (this hint does not work for adaptive granularity).
 

From 710911f7dc18ecaa5a400d4efe6587a9b656d937 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 30 Jun 2023 11:39:08 +0300
Subject: [PATCH 1413/1478] Update CHANGELOG.md

---
 CHANGELOG.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c1e0dba4465..bf6b309ef2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -18,7 +18,6 @@
 * CGroups metrics related to CPU are replaced with one metric, `CGroupMaxCPU` for better usability. The `Normalized` CPU usage metrics will be normalized to CGroups limits instead of the total number of CPUs when they are set. This closes [#50836](https://github.com/ClickHouse/ClickHouse/issues/50836). [#50835](https://github.com/ClickHouse/ClickHouse/pull/50835) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 
 #### New Feature
-* Added `Overlay` database engine to combine multiple databases into one. Added `Filesystem` database engine to represent a directory in the filesystem as a set of implicitly available tables with auto-detected formats and structures. A new `S3` database engine allows to read-only interact with s3 storage by representing a prefix as a set of tables. A new `HDFS` database engine allows to interact with HDFS storage in the same way. [#48821](https://github.com/ClickHouse/ClickHouse/pull/48821) ([alekseygolub](https://github.com/alekseygolub)).
 * The function `transform` as well as `CASE` with value matching started to support all data types. This closes [#29730](https://github.com/ClickHouse/ClickHouse/issues/29730). This closes [#32387](https://github.com/ClickHouse/ClickHouse/issues/32387). This closes [#50827](https://github.com/ClickHouse/ClickHouse/issues/50827). This closes [#31336](https://github.com/ClickHouse/ClickHouse/issues/31336). This closes [#40493](https://github.com/ClickHouse/ClickHouse/issues/40493). [#51351](https://github.com/ClickHouse/ClickHouse/pull/51351) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
 * Added option `--rename_files_after_processing <pattern>`. This closes [#34207](https://github.com/ClickHouse/ClickHouse/issues/34207). [#49626](https://github.com/ClickHouse/ClickHouse/pull/49626) ([alekseygolub](https://github.com/alekseygolub)).
 * Add support for `TRUNCATE` modifier in `INTO OUTFILE` clause. Suggest using `APPEND` or `TRUNCATE` for `INTO OUTFILE` when file exists. [#50950](https://github.com/ClickHouse/ClickHouse/pull/50950) ([alekar](https://github.com/alekar)).
@@ -26,7 +25,7 @@
 * Allow to skip empty files in file/s3/url/hdfs table functions using settings `s3_skip_empty_files`, `hdfs_skip_empty_files`, `engine_file_skip_empty_files`, `engine_url_skip_empty_files`. [#50364](https://github.com/ClickHouse/ClickHouse/pull/50364) ([Kruglov Pavel](https://github.com/Avogar)).
 * Add a new setting named `use_mysql_types_in_show_columns` to alter the `SHOW COLUMNS` SQL statement to display MySQL equivalent types when a client is connected via the MySQL compatibility port. [#49577](https://github.com/ClickHouse/ClickHouse/pull/49577) ([Thomas Panetti](https://github.com/tpanetti)).
 * Clickhouse-client can now be called with a connection string instead of "--host", "--port", "--user" etc. [#50689](https://github.com/ClickHouse/ClickHouse/pull/50689) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
-* Add setting `session_timezone`, it is used as default timezone for session when not explicitly specified. [#44149](https://github.com/ClickHouse/ClickHouse/pull/44149) ([Andrey Zvonov](https://github.com/zvonand)).
+* Add setting `session_timezone`; it is used as the default timezone for a session when not explicitly specified. [#44149](https://github.com/ClickHouse/ClickHouse/pull/44149) ([Andrey Zvonov](https://github.com/zvonand)).
 * Codec DEFLATE_QPL is now controlled via server setting "enable_deflate_qpl_codec" (default: false) instead of setting "allow_experimental_codecs". This marks DEFLATE_QPL non-experimental. [#50775](https://github.com/ClickHouse/ClickHouse/pull/50775) ([Robert Schulze](https://github.com/rschu1ze)).
 
 #### Performance Improvement

From fe93e687de7f2be7796e1034a553fa9f01040e5d Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Fri, 30 Jun 2023 10:02:24 +0200
Subject: [PATCH 1414/1478] Add comments.

---
 base/base/hex.h | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/base/base/hex.h b/base/base/hex.h
index 0780e6159a1..937218fec5a 100644
--- a/base/base/hex.h
+++ b/base/base/hex.h
@@ -176,7 +176,7 @@ namespace impl
     };
 
     /// Helper template class to convert a value of any supported type to hexadecimal representation and back.
-    template <typename T, typename = void>
+    template <typename T, typename SFINAE = void>
     struct HexConversion;
 
     template <typename TUInt>
@@ -185,7 +185,7 @@ namespace impl
     template <size_t Bits, typename Signed>
     struct HexConversion<wide::integer<Bits, Signed>> : public HexConversionUInt<wide::integer<Bits, Signed>> {};
 
-    template <typename CityHashUInt128>
+    template <typename CityHashUInt128> /// Partial specialization here allows not to include <city.h> in this header.
     struct HexConversion<CityHashUInt128, std::enable_if_t<std::is_same_v<CityHashUInt128, typename CityHash_v1_0_2::uint128>>>
     {
         static const constexpr size_t num_hex_digits = 32;
@@ -208,6 +208,8 @@ namespace impl
 
 /// Produces a hexadecimal representation of an integer value with leading zeros (for checksums).
 /// The function supports native integer types, wide::integer, CityHash_v1_0_2::uint128.
+/// It can be used with signed types as well, however they are written as corresponding unsigned numbers
+/// using two's complement (i.e. for example "-1" is written as "0xFF", not as "-0x01").
 template <typename T>
 void writeHexUIntUppercase(const T & value, char * out)
 {

From 2b55734ccf533a4fd9180b57672bc35823ed66d0 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 30 Jun 2023 02:52:03 -0700
Subject: [PATCH 1415/1478] Fix MergeTreeMarksLoader segfaulting if marks file
 is longer than expected (#51636)

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 .../MergeTree/MergeTreeMarksLoader.cpp        | 21 +++++++++++--------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeMarksLoader.cpp b/src/Storages/MergeTree/MergeTreeMarksLoader.cpp
index 9a5576f0ad2..5c722eec380 100644
--- a/src/Storages/MergeTree/MergeTreeMarksLoader.cpp
+++ b/src/Storages/MergeTree/MergeTreeMarksLoader.cpp
@@ -135,6 +135,7 @@ MarkCache::MappedPtr MergeTreeMarksLoader::loadMarksImpl()
     if (!index_granularity_info.mark_type.adaptive)
     {
         /// Read directly to marks.
+        chassert(expected_uncompressed_size == plain_marks.size() * sizeof(MarkInCompressedFile));
         reader->readStrict(reinterpret_cast<char *>(plain_marks.data()), expected_uncompressed_size);
 
         if (!reader->eof())
@@ -148,23 +149,25 @@ MarkCache::MappedPtr MergeTreeMarksLoader::loadMarksImpl()
     }
     else
     {
-        size_t i = 0;
-        size_t granularity;
-        while (!reader->eof())
+        for (size_t i = 0; i < marks_count; ++i)
         {
+            if (reader->eof())
+                throw Exception(
+                    ErrorCodes::CANNOT_READ_ALL_DATA,
+                    "Cannot read all marks from file {}, marks expected {} (bytes size {}), marks read {} (bytes size {})",
+                    mrk_path, marks_count, expected_uncompressed_size, i, reader->count());
+
+            size_t granularity;
             reader->readStrict(
                 reinterpret_cast<char *>(plain_marks.data() + i * columns_in_mark), columns_in_mark * sizeof(MarkInCompressedFile));
             readIntBinary(granularity, *reader);
-            ++i;
         }
 
-        if (i * mark_size != expected_uncompressed_size)
-        {
+        if (!reader->eof())
             throw Exception(
                 ErrorCodes::CANNOT_READ_ALL_DATA,
-                "Cannot read all marks from file {}, marks expected {} (bytes size {}), marks read {} (bytes size {})",
-                mrk_path, marks_count, expected_uncompressed_size, i, reader->count());
-        }
+                "Too many marks in file {}, marks expected {} (bytes size {})",
+                mrk_path, marks_count, expected_uncompressed_size);
     }
 
     auto res = std::make_shared<MarksInCompressedFile>(plain_marks);

From b0d4c9c83b210f9d266cc448df4641a07fdfb08c Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 26 Jun 2023 03:04:48 +0200
Subject: [PATCH 1416/1478] Disable hedged requests under TSan

---
 src/Core/SettingsQuirks.cpp                   |  9 ++-
 .../integration/test_hedged_requests/test.py  | 75 +++++++++++++++++++
 .../test_hedged_requests_parallel/test.py     | 25 +++++++
 tests/integration/test_secure_socket/test.py  |  5 ++
 ...851_hedged_connections_external_tables.sql |  1 +
 5 files changed, 114 insertions(+), 1 deletion(-)

diff --git a/src/Core/SettingsQuirks.cpp b/src/Core/SettingsQuirks.cpp
index 3326f42adf5..5b981c71403 100644
--- a/src/Core/SettingsQuirks.cpp
+++ b/src/Core/SettingsQuirks.cpp
@@ -1,10 +1,11 @@
+#include <base/defines.h>
 #include <Core/SettingsQuirks.h>
 #include <Core/Settings.h>
 #include <Poco/Environment.h>
 #include <Poco/Platform.h>
 #include <Common/VersionNumber.h>
 #include <Common/logger_useful.h>
-#include <cstdlib>
+
 
 namespace
 {
@@ -71,6 +72,12 @@ void applySettingsQuirks(Settings & settings, Poco::Logger * log)
         }
     }
 
+#if defined(THREAD_SANITIZER)
+    settings.use_hedged_requests = false;
+    if (log)
+        LOG_WARNING(log, "use_hedged_requests has been disabled for the build with Thread Sanitizer, because they are using fibers, leading to a failed assertion inside TSan");
+#endif
+
     if (!queryProfilerWorks())
     {
         if (settings.query_profiler_real_time_period_ns)
diff --git a/tests/integration/test_hedged_requests/test.py b/tests/integration/test_hedged_requests/test.py
index be6cea80f87..5de92f437c5 100644
--- a/tests/integration/test_hedged_requests/test.py
+++ b/tests/integration/test_hedged_requests/test.py
@@ -203,6 +203,11 @@ def update_configs(
 
 
 def test_stuck_replica(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs()
 
     cluster.pause_container("node_1")
@@ -233,6 +238,11 @@ def test_stuck_replica(started_cluster):
 
 
 def test_long_query(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs()
 
     # Restart to reset pool states.
@@ -249,12 +259,22 @@ def test_long_query(started_cluster):
 
 
 def test_send_table_status_sleep(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(node_1_sleep_in_send_tables_status=sleep_time)
     check_query(expected_replica="node_2")
     check_changing_replica_events(1)
 
 
 def test_send_table_status_sleep2(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
         node_2_sleep_in_send_tables_status=sleep_time,
@@ -264,12 +284,22 @@ def test_send_table_status_sleep2(started_cluster):
 
 
 def test_send_data(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(node_1_sleep_in_send_data=sleep_time)
     check_query(expected_replica="node_2")
     check_changing_replica_events(1)
 
 
 def test_send_data2(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
     )
@@ -278,6 +308,11 @@ def test_send_data2(started_cluster):
 
 
 def test_combination1(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
         node_2_sleep_in_send_data=sleep_time,
@@ -287,6 +322,11 @@ def test_combination1(started_cluster):
 
 
 def test_combination2(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
         node_2_sleep_in_send_tables_status=sleep_time,
@@ -296,6 +336,11 @@ def test_combination2(started_cluster):
 
 
 def test_combination3(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
         node_2_sleep_in_send_tables_status=1000,
@@ -306,6 +351,11 @@ def test_combination3(started_cluster):
 
 
 def test_combination4(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_tables_status=1000,
         node_1_sleep_in_send_data=sleep_time,
@@ -317,6 +367,11 @@ def test_combination4(started_cluster):
 
 
 def test_receive_timeout1(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     # Check the situation when first two replicas get receive timeout
     # in establishing connection, but the third replica is ok.
     update_configs(
@@ -329,6 +384,11 @@ def test_receive_timeout1(started_cluster):
 
 
 def test_receive_timeout2(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     # Check the situation when first replica get receive timeout
     # in packet receiving but there are replicas in process of
     # connection establishing.
@@ -342,6 +402,11 @@ def test_receive_timeout2(started_cluster):
 
 
 def test_initial_receive_timeout(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     # Check the situation when replicas don't respond after
     # receiving query (so, no packets were send to initiator)
     update_configs(
@@ -360,6 +425,11 @@ def test_initial_receive_timeout(started_cluster):
 
 
 def test_async_connect(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs()
 
     NODES["node"].restart_clickhouse()
@@ -390,6 +460,11 @@ def test_async_connect(started_cluster):
 
 
 def test_async_query_sending(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+        
     update_configs(
         node_1_sleep_after_receiving_query=5000,
         node_2_sleep_after_receiving_query=5000,
diff --git a/tests/integration/test_hedged_requests_parallel/test.py b/tests/integration/test_hedged_requests_parallel/test.py
index 492b869614f..34cad7bb754 100644
--- a/tests/integration/test_hedged_requests_parallel/test.py
+++ b/tests/integration/test_hedged_requests_parallel/test.py
@@ -172,6 +172,11 @@ def update_configs(
 
 
 def test_send_table_status_sleep(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
         node_2_sleep_in_send_tables_status=sleep_time,
@@ -181,6 +186,11 @@ def test_send_table_status_sleep(started_cluster):
 
 
 def test_send_data(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
     )
@@ -189,6 +199,11 @@ def test_send_data(started_cluster):
 
 
 def test_combination1(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_tables_status=1000,
         node_2_sleep_in_send_tables_status=1000,
@@ -199,6 +214,11 @@ def test_combination1(started_cluster):
 
 
 def test_combination2(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
         node_2_sleep_in_send_tables_status=1000,
@@ -210,6 +230,11 @@ def test_combination2(started_cluster):
 
 
 def test_query_with_no_data_to_sample(started_cluster):
+    if NODES["node"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
     )
diff --git a/tests/integration/test_secure_socket/test.py b/tests/integration/test_secure_socket/test.py
index 2dffbed03d6..827e4b81cfc 100644
--- a/tests/integration/test_secure_socket/test.py
+++ b/tests/integration/test_secure_socket/test.py
@@ -58,6 +58,11 @@ def test(started_cluster):
         config.format(sleep_in_send_data_ms=1000000),
     )
 
+    if NODES["node1"].is_built_with_thread_sanitizer():
+        pytest.skip(
+            "Hedged requests don't work under Thread Sanitizer"
+        )
+
     attempts = 0
     while attempts < 1000:
         setting = NODES["node2"].http_query(
diff --git a/tests/queries/0_stateless/01851_hedged_connections_external_tables.sql b/tests/queries/0_stateless/01851_hedged_connections_external_tables.sql
index c4625720e59..22888d5e68c 100644
--- a/tests/queries/0_stateless/01851_hedged_connections_external_tables.sql
+++ b/tests/queries/0_stateless/01851_hedged_connections_external_tables.sql
@@ -1 +1,2 @@
+-- Tags: no-tsan
 select number from remote('127.0.0.{3|2}', numbers(2)) where number global in (select number from numbers(1))　settings async_socket_for_remote=1, use_hedged_requests = 1, sleep_in_send_data_ms=10, receive_data_timeout_ms=1;

From 6b7c17fb4c863b5145dca71daaf8c14cf4fa8a42 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 26 Jun 2023 01:24:09 +0000
Subject: [PATCH 1417/1478] Automatic style fix

---
 .../integration/test_hedged_requests/test.py  | 62 +++++--------------
 .../test_hedged_requests_parallel/test.py     | 20 ++----
 tests/integration/test_secure_socket/test.py  |  4 +-
 3 files changed, 22 insertions(+), 64 deletions(-)

diff --git a/tests/integration/test_hedged_requests/test.py b/tests/integration/test_hedged_requests/test.py
index 5de92f437c5..18ea3e50619 100644
--- a/tests/integration/test_hedged_requests/test.py
+++ b/tests/integration/test_hedged_requests/test.py
@@ -204,9 +204,7 @@ def update_configs(
 
 def test_stuck_replica(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs()
 
@@ -239,9 +237,7 @@ def test_stuck_replica(started_cluster):
 
 def test_long_query(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs()
 
@@ -260,9 +256,7 @@ def test_long_query(started_cluster):
 
 def test_send_table_status_sleep(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(node_1_sleep_in_send_tables_status=sleep_time)
     check_query(expected_replica="node_2")
@@ -271,9 +265,7 @@ def test_send_table_status_sleep(started_cluster):
 
 def test_send_table_status_sleep2(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
@@ -285,9 +277,7 @@ def test_send_table_status_sleep2(started_cluster):
 
 def test_send_data(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(node_1_sleep_in_send_data=sleep_time)
     check_query(expected_replica="node_2")
@@ -296,9 +286,7 @@ def test_send_data(started_cluster):
 
 def test_send_data2(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
@@ -309,9 +297,7 @@ def test_send_data2(started_cluster):
 
 def test_combination1(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
@@ -323,9 +309,7 @@ def test_combination1(started_cluster):
 
 def test_combination2(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
@@ -337,9 +321,7 @@ def test_combination2(started_cluster):
 
 def test_combination3(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
@@ -352,9 +334,7 @@ def test_combination3(started_cluster):
 
 def test_combination4(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_tables_status=1000,
@@ -368,9 +348,7 @@ def test_combination4(started_cluster):
 
 def test_receive_timeout1(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     # Check the situation when first two replicas get receive timeout
     # in establishing connection, but the third replica is ok.
@@ -385,9 +363,7 @@ def test_receive_timeout1(started_cluster):
 
 def test_receive_timeout2(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     # Check the situation when first replica get receive timeout
     # in packet receiving but there are replicas in process of
@@ -403,9 +379,7 @@ def test_receive_timeout2(started_cluster):
 
 def test_initial_receive_timeout(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     # Check the situation when replicas don't respond after
     # receiving query (so, no packets were send to initiator)
@@ -426,9 +400,7 @@ def test_initial_receive_timeout(started_cluster):
 
 def test_async_connect(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs()
 
@@ -461,10 +433,8 @@ def test_async_connect(started_cluster):
 
 def test_async_query_sending(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
-        
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
+
     update_configs(
         node_1_sleep_after_receiving_query=5000,
         node_2_sleep_after_receiving_query=5000,
diff --git a/tests/integration/test_hedged_requests_parallel/test.py b/tests/integration/test_hedged_requests_parallel/test.py
index 34cad7bb754..728697c690d 100644
--- a/tests/integration/test_hedged_requests_parallel/test.py
+++ b/tests/integration/test_hedged_requests_parallel/test.py
@@ -173,9 +173,7 @@ def update_configs(
 
 def test_send_table_status_sleep(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_tables_status=sleep_time,
@@ -187,9 +185,7 @@ def test_send_table_status_sleep(started_cluster):
 
 def test_send_data(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
@@ -200,9 +196,7 @@ def test_send_data(started_cluster):
 
 def test_combination1(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_tables_status=1000,
@@ -215,9 +209,7 @@ def test_combination1(started_cluster):
 
 def test_combination2(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time,
@@ -231,9 +223,7 @@ def test_combination2(started_cluster):
 
 def test_query_with_no_data_to_sample(started_cluster):
     if NODES["node"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     update_configs(
         node_1_sleep_in_send_data=sleep_time, node_2_sleep_in_send_data=sleep_time
diff --git a/tests/integration/test_secure_socket/test.py b/tests/integration/test_secure_socket/test.py
index 827e4b81cfc..123715e5f05 100644
--- a/tests/integration/test_secure_socket/test.py
+++ b/tests/integration/test_secure_socket/test.py
@@ -59,9 +59,7 @@ def test(started_cluster):
     )
 
     if NODES["node1"].is_built_with_thread_sanitizer():
-        pytest.skip(
-            "Hedged requests don't work under Thread Sanitizer"
-        )
+        pytest.skip("Hedged requests don't work under Thread Sanitizer")
 
     attempts = 0
     while attempts < 1000:

From a628bbb1f55bea23662ff65512b2e892310c13af Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 28 Jun 2023 13:58:32 +0200
Subject: [PATCH 1418/1478] Fix tests

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

diff --git a/src/Core/SettingsQuirks.cpp b/src/Core/SettingsQuirks.cpp
index 5b981c71403..37a0f2db3e2 100644
--- a/src/Core/SettingsQuirks.cpp
+++ b/src/Core/SettingsQuirks.cpp
@@ -73,7 +73,7 @@ void applySettingsQuirks(Settings & settings, Poco::Logger * log)
     }
 
 #if defined(THREAD_SANITIZER)
-    settings.use_hedged_requests = false;
+    settings.use_hedged_requests.value = false;
     if (log)
         LOG_WARNING(log, "use_hedged_requests has been disabled for the build with Thread Sanitizer, because they are using fibers, leading to a failed assertion inside TSan");
 #endif

From 24ae56b5dd383ab4577747a873d9bc4aae9f7f16 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 30 Jun 2023 11:02:16 +0000
Subject: [PATCH 1419/1478] Correctly apply async deduplication for nonordinary
 ReplicatedMergeTree tables

---
 src/Storages/MergeTree/MergeTreeDataWriter.h  |  5 ++
 .../MergeTree/ReplicatedMergeTreeSink.cpp     | 85 ++++++++++++-------
 2 files changed, 61 insertions(+), 29 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeDataWriter.h b/src/Storages/MergeTree/MergeTreeDataWriter.h
index ed7151886f5..795453b2afa 100644
--- a/src/Storages/MergeTree/MergeTreeDataWriter.h
+++ b/src/Storages/MergeTree/MergeTreeDataWriter.h
@@ -80,6 +80,11 @@ public:
       */
     TemporaryPart writeTempPart(BlockWithPartition & block, const StorageMetadataPtr & metadata_snapshot, ContextPtr context);
 
+    MergeTreeData::MergingParams::Mode getMergingMode() const
+    {
+        return data.merging_params.mode;
+    }
+
     TemporaryPart writeTempPartWithoutPrefix(BlockWithPartition & block, const StorageMetadataPtr & metadata_snapshot, int64_t block_number, ContextPtr context);
 
     /// For insertion.
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index c93077fb4fb..718e3fc95ce 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -7,6 +7,8 @@
 #include <Common/SipHash.h>
 #include <Common/ZooKeeper/KeeperException.h>
 #include <Common/ThreadFuzzer.h>
+#include "Storages/MergeTree/MergeAlgorithm.h"
+#include "Storages/MergeTree/MergeTreeDataWriter.h"
 #include <Storages/MergeTree/AsyncBlockIDsCache.h>
 #include <DataTypes/ObjectUtils.h>
 #include <Core/Block.h>
@@ -54,6 +56,9 @@ struct ReplicatedMergeTreeSinkImpl<async_insert>::DelayedChunk
         UInt64 elapsed_ns;
         BlockIDsType block_id;
         BlockWithPartition block_with_partition;
+        /// Some merging algorithms can mofidy the block which loses the information about the async insert offsets
+        /// when preprocessing or filtering data for asnyc inserts deduplication we want to use the initial, unmerged block
+        std::optional<BlockWithPartition> unmerged_block_with_partition;
         std::unordered_map<String, std::vector<size_t>> block_id_to_offset_idx;
         ProfileEvents::Counters part_counters;
 
@@ -63,12 +68,14 @@ struct ReplicatedMergeTreeSinkImpl<async_insert>::DelayedChunk
                   UInt64 elapsed_ns_,
                   BlockIDsType && block_id_,
                   BlockWithPartition && block_,
+                  std::optional<BlockWithPartition> && unmerged_block_with_partition_,
                   ProfileEvents::Counters && part_counters_)
             : log(log_),
               temp_part(std::move(temp_part_)),
               elapsed_ns(elapsed_ns_),
               block_id(std::move(block_id_)),
               block_with_partition(std::move(block_)),
+              unmerged_block_with_partition(std::move(unmerged_block_with_partition_)),
               part_counters(std::move(part_counters_))
         {
                 initBlockIDMap();
@@ -113,6 +120,7 @@ struct ReplicatedMergeTreeSinkImpl<async_insert>::DelayedChunk
         {
             if constexpr (async_insert)
             {
+                auto * current_block_with_partition = unmerged_block_with_partition.has_value() ? &unmerged_block_with_partition.value() : &block_with_partition;
                 std::vector<size_t> offset_idx;
                 for (const auto & raw_path : block_paths)
                 {
@@ -127,14 +135,14 @@ struct ReplicatedMergeTreeSinkImpl<async_insert>::DelayedChunk
                 }
                 std::sort(offset_idx.begin(), offset_idx.end());
 
-                auto & offsets = block_with_partition.offsets;
+                auto & offsets = current_block_with_partition->offsets;
                 size_t idx = 0, remove_count = 0;
                 auto it = offset_idx.begin();
                 std::vector<size_t> new_offsets;
                 std::vector<String> new_block_ids;
 
                 /// construct filter
-                size_t rows = block_with_partition.block.rows();
+                size_t rows = current_block_with_partition->block.rows();
                 auto filter_col = ColumnUInt8::create(rows, 1u);
                 ColumnUInt8::Container & vec = filter_col->getData();
                 UInt8 * pos = vec.data();
@@ -162,18 +170,21 @@ struct ReplicatedMergeTreeSinkImpl<async_insert>::DelayedChunk
 
                 LOG_TRACE(log, "New block IDs: {}, new offsets: {}, size: {}", toString(new_block_ids), toString(new_offsets), new_offsets.size());
 
-                block_with_partition.offsets = std::move(new_offsets);
+                current_block_with_partition->offsets = std::move(new_offsets);
                 block_id = std::move(new_block_ids);
-                auto cols = block_with_partition.block.getColumns();
+                auto cols = current_block_with_partition->block.getColumns();
                 for (auto & col : cols)
                 {
                     col = col->filter(vec, rows - remove_count);
                 }
-                block_with_partition.block.setColumns(cols);
+                current_block_with_partition->block.setColumns(cols);
 
-                LOG_TRACE(log, "New block rows {}", block_with_partition.block.rows());
+                LOG_TRACE(log, "New block rows {}", current_block_with_partition->block.rows());
 
                 initBlockIDMap();
+
+                if (unmerged_block_with_partition.has_value())
+                    block_with_partition.block = unmerged_block_with_partition->block;
             }
             else
             {
@@ -202,7 +213,7 @@ std::vector<Int64> testSelfDeduplicate(std::vector<Int64> data, std::vector<size
     BlockWithPartition block1(std::move(block), Row(), std::move(offsets));
     ProfileEvents::Counters profile_counters;
     ReplicatedMergeTreeSinkImpl<true>::DelayedChunk::Partition part(
-        &Poco::Logger::get("testSelfDeduplicate"), MergeTreeDataWriter::TemporaryPart(), 0, std::move(hashes), std::move(block1), std::move(profile_counters));
+        &Poco::Logger::get("testSelfDeduplicate"), MergeTreeDataWriter::TemporaryPart(), 0, std::move(hashes), std::move(block1), std::nullopt, std::move(profile_counters));
 
     part.filterSelfDuplicate();
 
@@ -235,8 +246,10 @@ namespace
         {
             SipHash hash;
             for (size_t i = start; i < offset; ++i)
+            {
                 for (const auto & col : cols)
                     col->updateHashWithValue(i, hash);
+            }
             union
             {
                 char bytes[16];
@@ -432,8 +445,17 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
         ProfileEvents::Counters part_counters;
         auto profile_events_scope = std::make_unique<ProfileEventsScope>(&part_counters);
 
-        /// Write part to the filesystem under temporary name. Calculate a checksum.
+        /// Some merging algorithms can mofidy the block which loses the information about the async insert offsets
+        /// when preprocessing or filtering data for asnyc inserts deduplication we want to use the initial, unmerged block
+        std::optional<BlockWithPartition> unmerged_block;
 
+        if constexpr (async_insert)
+        {
+            if (storage.writer.getMergingMode() != MergeTreeData::MergingParams::Mode::Ordinary)
+                unmerged_block.emplace(current_block);
+        }
+
+        /// Write part to the filesystem under temporary name. Calculate a checksum.
         auto temp_part = storage.writer.writeTempPart(current_block, metadata_snapshot, context);
 
         /// If optimize_on_insert setting is true, current_block could become empty after merge
@@ -446,31 +468,35 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
         if constexpr (async_insert)
         {
             /// TODO consider insert_deduplication_token
-            block_id = getHashesForBlocks(current_block, temp_part.part->info.partition_id);
+            block_id = getHashesForBlocks(unmerged_block.has_value() ? *unmerged_block : current_block, temp_part.part->info.partition_id);
             LOG_TRACE(log, "async insert part, part id {}, block id {}, offsets {}, size {}", temp_part.part->info.partition_id, toString(block_id), toString(current_block.offsets), current_block.offsets.size());
         }
-        else if (deduplicate)
-        {
-            String block_dedup_token;
-
-            /// We add the hash from the data and partition identifier to deduplication ID.
-            /// That is, do not insert the same data to the same partition twice.
-
-            const String & dedup_token = settings.insert_deduplication_token;
-            if (!dedup_token.empty())
-            {
-                /// multiple blocks can be inserted within the same insert query
-                /// an ordinal number is added to dedup token to generate a distinctive block id for each block
-                block_dedup_token = fmt::format("{}_{}", dedup_token, chunk_dedup_seqnum);
-                ++chunk_dedup_seqnum;
-            }
-
-            block_id = temp_part.part->getZeroLevelPartBlockID(block_dedup_token);
-            LOG_DEBUG(log, "Wrote block with ID '{}', {} rows{}", block_id, current_block.block.rows(), quorumLogMessage(replicas_num));
-        }
         else
         {
-            LOG_DEBUG(log, "Wrote block with {} rows{}", current_block.block.rows(), quorumLogMessage(replicas_num));
+
+            if (deduplicate)
+            {
+                String block_dedup_token;
+
+                /// We add the hash from the data and partition identifier to deduplication ID.
+                /// That is, do not insert the same data to the same partition twice.
+
+                const String & dedup_token = settings.insert_deduplication_token;
+                if (!dedup_token.empty())
+                {
+                    /// multiple blocks can be inserted within the same insert query
+                    /// an ordinal number is added to dedup token to generate a distinctive block id for each block
+                    block_dedup_token = fmt::format("{}_{}", dedup_token, chunk_dedup_seqnum);
+                    ++chunk_dedup_seqnum;
+                }
+
+                block_id = temp_part.part->getZeroLevelPartBlockID(block_dedup_token);
+                LOG_DEBUG(log, "Wrote block with ID '{}', {} rows{}", block_id, current_block.block.rows(), quorumLogMessage(replicas_num));
+            }
+            else
+            {
+                LOG_DEBUG(log, "Wrote block with {} rows{}", current_block.block.rows(), quorumLogMessage(replicas_num));
+            }
         }
 
         profile_events_scope.reset();
@@ -501,6 +527,7 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
             elapsed_ns,
             std::move(block_id),
             std::move(current_block),
+            std::move(unmerged_block),
             std::move(part_counters) /// profile_events_scope must be reset here.
         ));
     }

From 3b73e112165833e8baece650021adbb19e8f635f Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 30 Jun 2023 11:04:40 +0000
Subject: [PATCH 1420/1478] Fix tests

---
 tests/queries/0_stateless/01361_fover_remote_num_tries.sh | 2 +-
 ...6_skip_unavailable_shards_excessive_attempts.reference | 8 ++++----
 .../01956_skip_unavailable_shards_excessive_attempts.sh   | 2 +-
 .../02226_parallel_reading_from_replicas_benchmark.sh     | 2 ++
 4 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/tests/queries/0_stateless/01361_fover_remote_num_tries.sh b/tests/queries/0_stateless/01361_fover_remote_num_tries.sh
index 2ee2ec1bc76..f07ffc02e4f 100755
--- a/tests/queries/0_stateless/01361_fover_remote_num_tries.sh
+++ b/tests/queries/0_stateless/01361_fover_remote_num_tries.sh
@@ -5,4 +5,4 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CURDIR"/../shell_config.sh
 
-$CLICKHOUSE_CLIENT --connections_with_failover_max_tries 10 --query "SELECT hostName() FROM remote('128.1.2.3', default.tmp)" 2>&1 | grep -o -P 'Timeout exceeded while connecting to socket|Network is unreachable' | wc -l
+$CLICKHOUSE_CLIENT --connections_with_failover_max_tries 10 --query "SELECT hostName() FROM remote('128.1.2.3', default.tmp)" 2>&1 | grep -o -P 'Timeout exceeded while connecting to socket|Network is unreachable|Timeout: connect timed out' | wc -l
diff --git a/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.reference b/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.reference
index e39f4b962e6..ad409aac5b8 100644
--- a/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.reference
+++ b/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.reference
@@ -1,10 +1,10 @@
 255.255.255.255
-HedgedConnectionsFactory: Connection failed at try №1
+ConnectionPoolWithFailover: Connection failed at try №1
 executeQuery: Code: 519.: All attempts to get table structure failed.
 127.2,255.255.255.255
 0
-HedgedConnectionsFactory: Connection failed at try №1
+ConnectionPoolWithFailover: Connection failed at try №1
 255.255.255.255,127.2
 0
-HedgedConnectionsFactory: Connection failed at try №1
-HedgedConnectionsFactory: Connection failed at try №1
+ConnectionPoolWithFailover: Connection failed at try №1
+ConnectionPoolWithFailover: Connection failed at try №1
diff --git a/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.sh b/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.sh
index 488e2fe106a..9f9de96ca6e 100755
--- a/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.sh
+++ b/tests/queries/0_stateless/01956_skip_unavailable_shards_excessive_attempts.sh
@@ -25,7 +25,7 @@ function execute_query()
     #   clickhouse-client 2> >(wc -l)
     #
     # May dump output of "wc -l" after some other programs.
-    $CLICKHOUSE_CLIENT "${opts[@]}" --query "select * from remote('$hosts', system.one)" 2>"$stderr"
+    $CLICKHOUSE_CLIENT "${opts[@]}" --query "select * from remote('$hosts', system.one) settings use_hedged_requests=0" 2>"$stderr"
     process_log_safe "$stderr"
 }
 execute_query 255.255.255.255
diff --git a/tests/queries/0_stateless/02226_parallel_reading_from_replicas_benchmark.sh b/tests/queries/0_stateless/02226_parallel_reading_from_replicas_benchmark.sh
index 4b8f8da5480..941f024825a 100755
--- a/tests/queries/0_stateless/02226_parallel_reading_from_replicas_benchmark.sh
+++ b/tests/queries/0_stateless/02226_parallel_reading_from_replicas_benchmark.sh
@@ -17,6 +17,8 @@ opts=(
     --allow_experimental_parallel_reading_from_replicas 1
     --parallel_replicas_for_non_replicated_merge_tree 1
     --max_parallel_replicas 3
+    --use_hedged_requests 0
+    --cluster_for_parallel_replicas parallel_replicas
 
     --iterations 1
 )

From 0fea8c6d1c9080e5855b2f4532c255aa6d40c5e5 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Fri, 30 Jun 2023 13:08:11 +0200
Subject: [PATCH 1421/1478] Update 02808_custom_disk_with_user_defined_name.sh

---
 .../0_stateless/02808_custom_disk_with_user_defined_name.sh     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
index 50dee04f6a6..537e117adb9 100755
--- a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -12,7 +12,7 @@ $CLICKHOUSE_CLIENT -nm --query """
 DROP TABLE IF EXISTS test;
 CREATE TABLE test (a Int32, b String)
 ENGINE = MergeTree() ORDER BY tuple()
-SETTINGS disk = disk_s3disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3disk);
+SETTINGS disk = disk_s3disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3_disk);
 """ 2>&1 | grep -q "Disk with name \`s3disk\` already exist" && echo 'OK' || echo 'FAIL'
 
 disk_name="${CLICKHOUSE_TEST_UNIQUE_NAME}"

From f134153f4e39befdbed703eda439d96e7d539a49 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Fri, 30 Jun 2023 13:12:04 +0200
Subject: [PATCH 1422/1478] Fix race with "user_was_dropped" in ContextAccess.

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

diff --git a/src/Access/ContextAccess.h b/src/Access/ContextAccess.h
index 63604a03b4e..1259d8d72eb 100644
--- a/src/Access/ContextAccess.h
+++ b/src/Access/ContextAccess.h
@@ -221,7 +221,7 @@ private:
     mutable Poco::Logger * trace_log = nullptr;
     mutable UserPtr user;
     mutable String user_name;
-    mutable bool user_was_dropped = false;
+    mutable std::atomic<bool> user_was_dropped = false;
     mutable scope_guard subscription_for_user_change;
     mutable std::shared_ptr<const EnabledRoles> enabled_roles;
     mutable scope_guard subscription_for_roles_changes;

From 58f291997176b230395bc906fe642c5dfad4657c Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 30 Jun 2023 12:46:45 +0200
Subject: [PATCH 1423/1478] Fix

---
 src/Interpreters/Cache/FileSegment.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index e97d708ba74..5c7fb4c8109 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -648,8 +648,6 @@ void FileSegment::complete()
     if (segment_kind == FileSegmentKind::Temporary && is_last_holder)
     {
         LOG_TEST(log, "Removing temporary file segment: {}", getInfoForLogUnlocked(segment_lock));
-        detach(segment_lock, *locked_key);
-        setDownloadState(State::DETACHED, segment_lock);
         locked_key->removeFileSegment(offset(), segment_lock);
         return;
     }
@@ -798,7 +796,6 @@ bool FileSegment::assertCorrectnessUnlocked(const FileSegmentGuard::Lock &) cons
         }
 
         chassert(reserved_size >= downloaded_size);
-        chassert((reserved_size == 0) || queue_iterator);
         check_iterator(queue_iterator);
     }
 

From 96cc02ae0c83581b051ea49fd11a3c1aa97f6c54 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 30 Jun 2023 11:45:10 +0000
Subject: [PATCH 1424/1478] Add test

---
 ...sert_dedup_replicated_collapsing.reference |  8 ++++
 ...sync_insert_dedup_replicated_collapsing.sh | 39 +++++++++++++++++++
 2 files changed, 47 insertions(+)
 create mode 100644 tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.reference
 create mode 100755 tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh

diff --git a/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.reference b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.reference
new file mode 100644
index 00000000000..74624d246de
--- /dev/null
+++ b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.reference
@@ -0,0 +1,8 @@
+string1
+------------
+string1
+------------
+string1
+string1
+string2
+------------
diff --git a/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh
new file mode 100755
index 00000000000..69e0e3ecc32
--- /dev/null
+++ b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh
@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+${CLICKHOUSE_CLIENT} -q "DROP TABLE IF EXISTS 02810_async_insert_dedup_collapsing"
+${CLICKHOUSE_CLIENT} -q "CREATE TABLE 02810_async_insert_dedup_collapsing (stringvalue String, sign Int8) ENGINE = ReplicatedCollapsingMergeTree('/clickhouse/02810_async_insert_dedup/' || currentDatabase(), 'r1', sign) ORDER BY stringvalue"
+
+url="${CLICKHOUSE_URL}&async_insert=1&wait_for_async_insert=1&async_insert_busy_timeout_ms=3000&async_insert_deduplicate=1"
+
+# insert value with same key and sign so it's collapsed on insert
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string1', 1)" &
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string1', 1)" &
+
+wait
+
+${CLICKHOUSE_CLIENT} -q "SELECT stringvalue FROM 02810_async_insert_dedup_collapsing ORDER BY stringvalue"
+${CLICKHOUSE_CLIENT} -q "SELECT '------------'"
+
+# trigger same collaps algorithm but also deduplication
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string1', 1)" & 
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string1', 1)" &
+
+wait
+
+${CLICKHOUSE_CLIENT} -q "SELECT stringvalue FROM 02810_async_insert_dedup_collapsing ORDER BY stringvalue"
+${CLICKHOUSE_CLIENT} -q "SELECT '------------'"
+
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string2', 1)" &
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string2', 1), ('string1', 1)" &
+${CLICKHOUSE_CURL} -sS "$url" -d "INSERT INTO 02810_async_insert_dedup_collapsing VALUES ('string2', 1)" &
+
+wait
+
+${CLICKHOUSE_CLIENT} -q "SELECT stringvalue FROM 02810_async_insert_dedup_collapsing ORDER BY stringvalue"
+${CLICKHOUSE_CLIENT} -q "SELECT '------------'"
+
+${CLICKHOUSE_CLIENT} -q "DROP TABLE 02810_async_insert_dedup_collapsing"
\ No newline at end of file

From 9a79fd6f70b30cd56e37c8a41c8c14bf65ed11ff Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 30 Jun 2023 11:51:20 +0000
Subject: [PATCH 1425/1478] Better

---
 src/Processors/Transforms/ExpressionTransform.cpp  | 1 -
 src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp | 7 ++++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Processors/Transforms/ExpressionTransform.cpp b/src/Processors/Transforms/ExpressionTransform.cpp
index 49988932947..0d3341b000c 100644
--- a/src/Processors/Transforms/ExpressionTransform.cpp
+++ b/src/Processors/Transforms/ExpressionTransform.cpp
@@ -39,7 +39,6 @@ void ConvertingTransform::onConsume(Chunk chunk)
     expression->execute(block, num_rows);
 
     chunk.setColumns(block.getColumns(), num_rows);
-    chunk.setChunkInfo(chunk.getChunkInfo());
     cur_chunk = std::move(chunk);
 }
 
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index 718e3fc95ce..a13a96ac65e 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -7,8 +7,8 @@
 #include <Common/SipHash.h>
 #include <Common/ZooKeeper/KeeperException.h>
 #include <Common/ThreadFuzzer.h>
-#include "Storages/MergeTree/MergeAlgorithm.h"
-#include "Storages/MergeTree/MergeTreeDataWriter.h"
+#include <Storages/MergeTree/MergeAlgorithm.h>
+#include <Storages/MergeTree/MergeTreeDataWriter.h>
 #include <Storages/MergeTree/AsyncBlockIDsCache.h>
 #include <DataTypes/ObjectUtils.h>
 #include <Core/Block.h>
@@ -451,8 +451,9 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
 
         if constexpr (async_insert)
         {
+            /// we copy everything but offsets which we move because they are only used by async insert
             if (storage.writer.getMergingMode() != MergeTreeData::MergingParams::Mode::Ordinary)
-                unmerged_block.emplace(current_block);
+                unmerged_block.emplace(Block(current_block.block), Row(current_block.partition), std::move(current_block.offsets));
         }
 
         /// Write part to the filesystem under temporary name. Calculate a checksum.

From 042885c35e2e4c82e8594543619a83a0fcd4c0df Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio2368@users.noreply.github.com>
Date: Fri, 30 Jun 2023 14:25:24 +0200
Subject: [PATCH 1426/1478] fix test style

---
 .../02810_async_insert_dedup_replicated_collapsing.sh           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh
index 69e0e3ecc32..804cd894ebc 100755
--- a/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh
+++ b/tests/queries/0_stateless/02810_async_insert_dedup_replicated_collapsing.sh
@@ -5,7 +5,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 . "$CURDIR"/../shell_config.sh
 
 ${CLICKHOUSE_CLIENT} -q "DROP TABLE IF EXISTS 02810_async_insert_dedup_collapsing"
-${CLICKHOUSE_CLIENT} -q "CREATE TABLE 02810_async_insert_dedup_collapsing (stringvalue String, sign Int8) ENGINE = ReplicatedCollapsingMergeTree('/clickhouse/02810_async_insert_dedup/' || currentDatabase(), 'r1', sign) ORDER BY stringvalue"
+${CLICKHOUSE_CLIENT} -q "CREATE TABLE 02810_async_insert_dedup_collapsing (stringvalue String, sign Int8) ENGINE = ReplicatedCollapsingMergeTree('/clickhouse/{database}/02810_async_insert_dedup', 'r1', sign) ORDER BY stringvalue"
 
 url="${CLICKHOUSE_URL}&async_insert=1&wait_for_async_insert=1&async_insert_busy_timeout_ms=3000&async_insert_deduplicate=1"
 

From 84872517708ad03c764e616fd28d5d1d12593697 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Elena=20Torr=C3=B3?= <elena@tinybird.co>
Date: Fri, 30 Jun 2023 14:46:50 +0200
Subject: [PATCH 1427/1478] Update File Cache disk configuration settings
 default values

---
 docs/en/operations/storing-data.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/storing-data.md b/docs/en/operations/storing-data.md
index 5804ad8545b..3f4456d7e12 100644
--- a/docs/en/operations/storing-data.md
+++ b/docs/en/operations/storing-data.md
@@ -188,9 +188,9 @@ These settings should be defined in the disk configuration section.
 
 - `do_not_evict_index_and_mark_files` - do not evict small frequently used files according to cache policy. Default: `false`. This setting was added in version 22.8. If you used filesystem cache before this version, then it will not work on versions starting from 22.8 if this setting is set to `true`. If you want to use this setting, clear old cache created before version 22.8 before upgrading.
 
-- `max_file_segment_size` - a maximum size of a single cache file in bytes or in readable format (`ki, Mi, Gi, etc`, example `10Gi`). Default: `104857600` (`100Mi`).
+- `max_file_segment_size` - a maximum size of a single cache file in bytes or in readable format (`ki, Mi, Gi, etc`, example `10Gi`). Default: `8388608` (`8Mi`).
 
-- `max_elements` - a limit for a number of cache files. Default: `1048576`.
+- `max_elements` - a limit for a number of cache files. Default: `10000000`.
 
 File Cache **query/profile settings**:
 

From bf06e18c348d6d8bd23d4184d4bf3eee89ed4835 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 30 Jun 2023 09:03:25 -0400
Subject: [PATCH 1428/1478] docs clickhouse-static-files-uploader and demo repo

---
 .../en/engines/table-engines/mergetree-family/mergetree.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index a1c2fbdbe50..67043ef1062 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -949,7 +949,14 @@ The example uses `type=web`, but any disk type can be configured as dynamic, eve
 
 #### Example dynamic web storage
 
+:::tip
+A [demo dataset](https://github.com/ClickHouse/web-tables-demo) is hosted in GitHub.  To prepare your own tables for web storage see the tool [clickhouse-static-files-uploader](/docs/en/operations/storing-data.md/#storing-data-on-webserver)
+:::
+
+In this `ATTACH TABLE` query the `UUID` provided matches the directory name of the data, and the endpoint is the URL for the raw GitHub content.
+
 ```sql
+# highlight-next-line
 ATTACH TABLE uk_price_paid UUID 'cf712b4f-2ca8-435c-ac23-c4393efe52f7'
 (
     price UInt32,

From 2311dd9b5ddbeb8587ce7201b889c0ab1442d003 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Fri, 30 Jun 2023 15:18:54 +0200
Subject: [PATCH 1429/1478] Use TSA_GUARDED_BY() macro in the definition of
 ContextAccess.

---
 src/Access/ContextAccess.cpp | 16 +++++++-------
 src/Access/ContextAccess.h   | 43 ++++++++++++++++++++++--------------
 2 files changed, 34 insertions(+), 25 deletions(-)

diff --git a/src/Access/ContextAccess.cpp b/src/Access/ContextAccess.cpp
index 0d28edc0a10..9c57853679f 100644
--- a/src/Access/ContextAccess.cpp
+++ b/src/Access/ContextAccess.cpp
@@ -228,6 +228,12 @@ ContextAccess::ContextAccess(const AccessControl & access_control_, const Params
 }
 
 
+ContextAccess::ContextAccess(FullAccess)
+    : is_full_access(true), access(std::make_shared<AccessRights>(AccessRights::getFullAccess())), access_with_implicit(access)
+{
+}
+
+
 ContextAccess::~ContextAccess()
 {
     enabled_settings.reset();
@@ -413,14 +419,8 @@ std::optional<QuotaUsage> ContextAccess::getQuotaUsage() const
 
 std::shared_ptr<const ContextAccess> ContextAccess::getFullAccess()
 {
-    static const std::shared_ptr<const ContextAccess> res = []
-    {
-        auto full_access = std::make_shared<ContextAccess>();
-        full_access->is_full_access = true;
-        full_access->access = std::make_shared<AccessRights>(AccessRights::getFullAccess());
-        full_access->access_with_implicit = full_access->access;
-        return full_access;
-    }();
+    static const std::shared_ptr<const ContextAccess> res =
+        [] { return std::shared_ptr<ContextAccess>(new ContextAccess{kFullAccess}); }();
     return res;
 }
 
diff --git a/src/Access/ContextAccess.h b/src/Access/ContextAccess.h
index 1259d8d72eb..60bad0118fc 100644
--- a/src/Access/ContextAccess.h
+++ b/src/Access/ContextAccess.h
@@ -69,7 +69,6 @@ public:
     using Params = ContextAccessParams;
     const Params & getParams() const { return params; }
 
-    ContextAccess() { } /// NOLINT
     ContextAccess(const AccessControl & access_control_, const Params & params_);
 
     /// Returns the current user. Throws if user is nullptr.
@@ -171,10 +170,17 @@ public:
 private:
     friend class AccessControl;
 
+    struct FullAccess {};
+    static const FullAccess kFullAccess;
+
+    /// Makes an instance of ContextAccess which provides full access to everything
+    /// without any limitations. This is used for the global context.
+    explicit ContextAccess(FullAccess);
+
     void initialize();
-    void setUser(const UserPtr & user_) const;
-    void setRolesInfo(const std::shared_ptr<const EnabledRolesInfo> & roles_info_) const;
-    void calculateAccessRights() const;
+    void setUser(const UserPtr & user_) const TSA_REQUIRES(mutex);
+    void setRolesInfo(const std::shared_ptr<const EnabledRolesInfo> & roles_info_) const TSA_REQUIRES(mutex);
+    void calculateAccessRights() const TSA_REQUIRES(mutex);
 
     template <bool throw_if_denied, bool grant_option>
     bool checkAccessImpl(const AccessFlags & flags) const;
@@ -217,20 +223,23 @@ private:
 
     const AccessControl * access_control = nullptr;
     const Params params;
-    bool is_full_access = false;
-    mutable Poco::Logger * trace_log = nullptr;
-    mutable UserPtr user;
-    mutable String user_name;
+    const bool is_full_access = false;
+
     mutable std::atomic<bool> user_was_dropped = false;
-    mutable scope_guard subscription_for_user_change;
-    mutable std::shared_ptr<const EnabledRoles> enabled_roles;
-    mutable scope_guard subscription_for_roles_changes;
-    mutable std::shared_ptr<const EnabledRolesInfo> roles_info;
-    mutable std::shared_ptr<const AccessRights> access;
-    mutable std::shared_ptr<const AccessRights> access_with_implicit;
-    mutable std::shared_ptr<const EnabledRowPolicies> enabled_row_policies;
-    mutable std::shared_ptr<const EnabledQuota> enabled_quota;
-    mutable std::shared_ptr<const EnabledSettings> enabled_settings;
+    mutable std::atomic<Poco::Logger *> trace_log = nullptr;
+
+    mutable UserPtr user TSA_GUARDED_BY(mutex);
+    mutable String user_name TSA_GUARDED_BY(mutex);
+    mutable scope_guard subscription_for_user_change TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const EnabledRoles> enabled_roles TSA_GUARDED_BY(mutex);
+    mutable scope_guard subscription_for_roles_changes TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const EnabledRolesInfo> roles_info TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const AccessRights> access TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const AccessRights> access_with_implicit TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const EnabledRowPolicies> enabled_row_policies TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const EnabledQuota> enabled_quota TSA_GUARDED_BY(mutex);
+    mutable std::shared_ptr<const EnabledSettings> enabled_settings TSA_GUARDED_BY(mutex);
+
     mutable std::mutex mutex;
 };
 

From 904c533a84e5766b4e5ca5e886d7a826cefdd0d4 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 30 Jun 2023 09:32:54 -0400
Subject: [PATCH 1430/1478] spelling list

---
 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 f25d082e5a6..2802e52c288 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -2459,6 +2459,7 @@ unrounded
 untracked
 untrusted
 untuple
+uploader
 uploaders
 upperUTF
 uptime

From 91579453895b7dc88b0aec78bdde6311a6fc5a39 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Elena=20Torr=C3=B3?= <elena@tinybird.co>
Date: Fri, 30 Jun 2023 15:43:04 +0200
Subject: [PATCH 1431/1478] Add missing settings

---
 docs/en/operations/storing-data.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/operations/storing-data.md b/docs/en/operations/storing-data.md
index 3f4456d7e12..fd82c955c40 100644
--- a/docs/en/operations/storing-data.md
+++ b/docs/en/operations/storing-data.md
@@ -184,7 +184,9 @@ These settings should be defined in the disk configuration section.
 
 - `enable_filesystem_query_cache_limit` - allow to limit the size of cache which is downloaded within each query (depends on user setting `max_query_cache_size`). Default: `false`.
 
-- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached. Default: `0`, e.g. the data is cached at the first attempt to read it.
+- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached, defined by `cache_hits_threshold`. Default: `0`, e.g. the data is cached at the first attempt to read it.
+
+- `enable_bypass_cache_with_threshold` - allows to skip cache completely in case the requested read range exceeds the threshold defined by `bypass_cache_threashold`. Default: `268435456` (`256Mi`).
 
 - `do_not_evict_index_and_mark_files` - do not evict small frequently used files according to cache policy. Default: `false`. This setting was added in version 22.8. If you used filesystem cache before this version, then it will not work on versions starting from 22.8 if this setting is set to `true`. If you want to use this setting, clear old cache created before version 22.8 before upgrading.
 

From 982ded4e8f09891a968f72037637f7f9bfbd6647 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 30 Jun 2023 15:47:31 +0200
Subject: [PATCH 1432/1478] update timeouts in tests for transactions

---
 .../0_stateless/01169_alter_partition_isolation_stress.sh       | 2 +-
 .../0_stateless/01171_mv_select_insert_isolation_long.sh        | 2 +-
 tests/queries/0_stateless/01174_select_insert_isolation.sh      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/01169_alter_partition_isolation_stress.sh b/tests/queries/0_stateless/01169_alter_partition_isolation_stress.sh
index 508ad05224c..f2348c29146 100755
--- a/tests/queries/0_stateless/01169_alter_partition_isolation_stress.sh
+++ b/tests/queries/0_stateless/01169_alter_partition_isolation_stress.sh
@@ -240,7 +240,7 @@ kill -TERM $PID_1
 kill -TERM $PID_2
 wait ||:
 
-wait_for_queries_to_finish
+wait_for_queries_to_finish 40
 
 $CLICKHOUSE_CLIENT -q "SELECT type, count(n) = countDistinct(n) FROM merge(currentDatabase(), '') GROUP BY type ORDER BY type"
 $CLICKHOUSE_CLIENT -q "SELECT DISTINCT arraySort(groupArrayIf(n, type=1)) = arraySort(groupArrayIf(n, type=2)) FROM merge(currentDatabase(), '') GROUP BY _table ORDER BY _table"
diff --git a/tests/queries/0_stateless/01171_mv_select_insert_isolation_long.sh b/tests/queries/0_stateless/01171_mv_select_insert_isolation_long.sh
index 199c2b5389f..619e212c3ae 100755
--- a/tests/queries/0_stateless/01171_mv_select_insert_isolation_long.sh
+++ b/tests/queries/0_stateless/01171_mv_select_insert_isolation_long.sh
@@ -131,7 +131,7 @@ kill -TERM $PID_6
 kill -TERM $PID_7
 kill -TERM $PID_8
 wait
-wait_for_queries_to_finish
+wait_for_queries_to_finish 40
 
 $CLICKHOUSE_CLIENT --multiquery --query "
 BEGIN TRANSACTION;
diff --git a/tests/queries/0_stateless/01174_select_insert_isolation.sh b/tests/queries/0_stateless/01174_select_insert_isolation.sh
index 29ccfbb1ccb..6321f6ff01b 100755
--- a/tests/queries/0_stateless/01174_select_insert_isolation.sh
+++ b/tests/queries/0_stateless/01174_select_insert_isolation.sh
@@ -56,7 +56,7 @@ thread_select & PID_4=$!
 wait $PID_1 && wait $PID_2 && wait $PID_3
 kill -TERM $PID_4
 wait
-wait_for_queries_to_finish
+wait_for_queries_to_finish 40
 
 $CLICKHOUSE_CLIENT --multiquery --query "
 BEGIN TRANSACTION;

From 48eb1880651d381b39e2fe64f9ee6f8c64e1b303 Mon Sep 17 00:00:00 2001
From: Sergei Trifonov <sergei@clickhouse.com>
Date: Fri, 30 Jun 2023 15:53:37 +0200
Subject: [PATCH 1433/1478] Remove unused code

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

diff --git a/src/Server/TCPHandler.h b/src/Server/TCPHandler.h
index 629738fa16f..235f634afec 100644
--- a/src/Server/TCPHandler.h
+++ b/src/Server/TCPHandler.h
@@ -83,8 +83,6 @@ struct QueryState
         NOT_CANCELLED
     };
 
-    static std::string cancellationStatusToName(CancellationStatus status);
-
     /// Is request cancelled
     CancellationStatus cancellation_status = CancellationStatus::NOT_CANCELLED;
     bool is_connection_closed = false;

From 9ddf0853bff9b5bbcbf92f7bcc61e7f5b97a4aea Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Fri, 30 Jun 2023 16:12:39 +0200
Subject: [PATCH 1434/1478] Update 02808_custom_disk_with_user_defined_name.sh

---
 .../0_stateless/02808_custom_disk_with_user_defined_name.sh   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
index 537e117adb9..3fbcde66add 100755
--- a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -12,8 +12,8 @@ $CLICKHOUSE_CLIENT -nm --query """
 DROP TABLE IF EXISTS test;
 CREATE TABLE test (a Int32, b String)
 ENGINE = MergeTree() ORDER BY tuple()
-SETTINGS disk = disk_s3disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3_disk);
-""" 2>&1 | grep -q "Disk with name \`s3disk\` already exist" && echo 'OK' || echo 'FAIL'
+SETTINGS disk = disk_s3_disk(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3_disk);
+""" 2>&1 | grep -q "Disk with name \`s3_disk\` already exist" && echo 'OK' || echo 'FAIL'
 
 disk_name="${CLICKHOUSE_TEST_UNIQUE_NAME}"
 

From 0b98406bd345f54c386435a11d126c07234f1aef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Elena=20Torr=C3=B3?= <elena@tinybird.co>
Date: Fri, 30 Jun 2023 16:13:43 +0200
Subject: [PATCH 1435/1478] Add default values to False

---
 docs/en/operations/storing-data.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/storing-data.md b/docs/en/operations/storing-data.md
index fd82c955c40..17d62673a8e 100644
--- a/docs/en/operations/storing-data.md
+++ b/docs/en/operations/storing-data.md
@@ -184,9 +184,9 @@ These settings should be defined in the disk configuration section.
 
 - `enable_filesystem_query_cache_limit` - allow to limit the size of cache which is downloaded within each query (depends on user setting `max_query_cache_size`). Default: `false`.
 
-- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached, defined by `cache_hits_threshold`. Default: `0`, e.g. the data is cached at the first attempt to read it.
+- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached. Default :`false`. This threshold can be defined by `cache_hits_threshold`. Default: `0`, e.g. the data is cached at the first attempt to read it.
 
-- `enable_bypass_cache_with_threshold` - allows to skip cache completely in case the requested read range exceeds the threshold defined by `bypass_cache_threashold`. Default: `268435456` (`256Mi`).
+- `enable_bypass_cache_with_threshold` - allows to skip cache completely in case the requested read range exceeds the threshold. Default :`false`. This threshold can be defined by `bypass_cache_threashold`. Default: `268435456` (`256Mi`).
 
 - `do_not_evict_index_and_mark_files` - do not evict small frequently used files according to cache policy. Default: `false`. This setting was added in version 22.8. If you used filesystem cache before this version, then it will not work on versions starting from 22.8 if this setting is set to `true`. If you want to use this setting, clear old cache created before version 22.8 before upgrading.
 

From 689ff6f996585da91cf80eb2916f1d23706c1f30 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Fri, 30 Jun 2023 16:15:26 +0200
Subject: [PATCH 1436/1478] Update storing-data.md

---
 docs/en/operations/storing-data.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/storing-data.md b/docs/en/operations/storing-data.md
index 17d62673a8e..fe6e8e15b0c 100644
--- a/docs/en/operations/storing-data.md
+++ b/docs/en/operations/storing-data.md
@@ -184,9 +184,9 @@ These settings should be defined in the disk configuration section.
 
 - `enable_filesystem_query_cache_limit` - allow to limit the size of cache which is downloaded within each query (depends on user setting `max_query_cache_size`). Default: `false`.
 
-- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached. Default :`false`. This threshold can be defined by `cache_hits_threshold`. Default: `0`, e.g. the data is cached at the first attempt to read it.
+- `enable_cache_hits_threshold` - number which defines how many times some data needs to be read before it will be cached. Default: `false`. This threshold can be defined by `cache_hits_threshold`. Default: `0`, e.g. the data is cached at the first attempt to read it.
 
-- `enable_bypass_cache_with_threshold` - allows to skip cache completely in case the requested read range exceeds the threshold. Default :`false`. This threshold can be defined by `bypass_cache_threashold`. Default: `268435456` (`256Mi`).
+- `enable_bypass_cache_with_threshold` - allows to skip cache completely in case the requested read range exceeds the threshold. Default: `false`. This threshold can be defined by `bypass_cache_threashold`. Default: `268435456` (`256Mi`).
 
 - `do_not_evict_index_and_mark_files` - do not evict small frequently used files according to cache policy. Default: `false`. This setting was added in version 22.8. If you used filesystem cache before this version, then it will not work on versions starting from 22.8 if this setting is set to `true`. If you want to use this setting, clear old cache created before version 22.8 before upgrading.
 

From 542b03bfd1bf8b7f6af69c76c2ef1d7f86d535b0 Mon Sep 17 00:00:00 2001
From: Julio Jimenez <julio@clickhouse.com>
Date: Fri, 30 Jun 2023 10:41:31 -0400
Subject: [PATCH 1437/1478] SonarCloud: Add C++23 Experimental Flag

Signed-off-by: Julio Jimenez <julio@clickhouse.com>
---
 .github/workflows/nightly.yml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
index acf6bbe8f6a..b508758ac7c 100644
--- a/.github/workflows/nightly.yml
+++ b/.github/workflows/nightly.yml
@@ -122,7 +122,7 @@ jobs:
           sudo rm -fr "$TEMP_PATH" "$CACHES_PATH"
   SonarCloud:
     # TODO: Remove if: whenever SonarCloud supports c++23
-    if: ${{ false }}
+    # if: ${{ false }}
     runs-on: [self-hosted, builder]
     env:
       SONAR_SCANNER_VERSION: 4.8.0.2856
@@ -178,4 +178,5 @@ jobs:
             --define sonar.cfamily.build-wrapper-output="${{ env.BUILD_WRAPPER_OUT_DIR }}" \
             --define sonar.projectKey="ClickHouse_ClickHouse" \
             --define sonar.organization="clickhouse-java" \
-            --define sonar.exclusions="**/*.java,**/*.ts,**/*.js,**/*.css,**/*.sql" \
+            --define sonar.cfamily.cpp23.enabled=true \
+            --define sonar.exclusions="**/*.java,**/*.ts,**/*.js,**/*.css,**/*.sql"

From 00aeb407e5f88440ea82c423ccb701678a3e8e3f Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 30 Jun 2023 14:41:27 +0000
Subject: [PATCH 1438/1478] Wait with retries

---
 docker/test/stateless/run.sh | 31 ++++---------------------------
 tests/ci/attach_gdb.lib      |  4 +++-
 tests/ci/utils.lib           | 25 +++++++++++++++++++++++++
 3 files changed, 32 insertions(+), 28 deletions(-)
 create mode 100644 tests/ci/utils.lib

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index 914e51a9f66..7ccedb8c0b3 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -18,6 +18,9 @@ ln -s /usr/share/clickhouse-test/clickhouse-test /usr/bin/clickhouse-test
 # shellcheck disable=SC1091
 source /usr/share/clickhouse-test/ci/attach_gdb.lib || true  # FIXME: to not break old builds, clean on 2023-09-01
 
+# shellcheck disable=SC1091
+source /usr/share/clickhouse-test/ci/utils.lib
+
 # install test configs
 /usr/share/clickhouse-test/config/install.sh
 
@@ -90,30 +93,6 @@ sleep 5
 
 attach_gdb_to_clickhouse || true  # FIXME: to not break old builds, clean on 2023-09-01
 
-function run_with_retry()
-{
-    set +e
-
-    local total_retries="$1"
-    shift
-
-    local retry=0
-
-    until [ "$retry" -ge "$total_retries" ]
-    do
-        if "$@"; then
-            set -e
-            return
-        else
-            retry=$((retry + 1))
-            sleep 3
-        fi
-    done
-
-    echo "Command '$*' failed after $total_retries retries, exiting"
-    exit 1
-}
-
 function run_tests()
 {
     set -x
@@ -161,9 +140,7 @@ function run_tests()
 
     ADDITIONAL_OPTIONS+=('--report-logs-stats')
 
-    clickhouse-test "00001_select_1" > /dev/null ||:
-
-    run_with_retry 5 clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')"
+    run_with_retry 10 clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')"
 
     set +e
     clickhouse-test --testname --shard --zookeeper --check-zookeeper-session --hung-check --print-time \
diff --git a/tests/ci/attach_gdb.lib b/tests/ci/attach_gdb.lib
index 2df6243f796..e937cf6dba7 100644
--- a/tests/ci/attach_gdb.lib
+++ b/tests/ci/attach_gdb.lib
@@ -1,5 +1,7 @@
 #!/bin/bash
 
+source /usr/share/clickhouse-test/ci/utils.lib
+
 function attach_gdb_to_clickhouse()
 {
     # Set follow-fork-mode to parent, because we attach to clickhouse-server, not to watchdog
@@ -38,5 +40,5 @@ quit
     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'" ||:
+    run_with_retry 60 clickhouse-client --query "SELECT 'Connected to clickhouse-server after attaching gdb'"
 }
diff --git a/tests/ci/utils.lib b/tests/ci/utils.lib
new file mode 100644
index 00000000000..95ad50f635b
--- /dev/null
+++ b/tests/ci/utils.lib
@@ -0,0 +1,25 @@
+#!/bin/bash
+
+function run_with_retry()
+{
+    set +e
+
+    local total_retries="$1"
+    shift
+
+    local retry=0
+
+    until [ "$retry" -ge "$total_retries" ]
+    do
+        if "$@"; then
+            set -e
+            return
+        else
+            retry=$((retry + 1))
+            sleep 5
+        fi
+    done
+
+    echo "Command '$*' failed after $total_retries retries, exiting"
+    exit 1
+}
\ No newline at end of file

From 185e106c1faff2201db3f33f7497ab4a43d1c7e6 Mon Sep 17 00:00:00 2001
From: Julio Jimenez <julio@clickhouse.com>
Date: Fri, 30 Jun 2023 10:53:04 -0400
Subject: [PATCH 1439/1478] Please install NASM because NASM compiler cannot be
 found

Signed-off-by: Julio Jimenez <julio@clickhouse.com>
---
 .github/workflows/nightly.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
index b508758ac7c..3f6d9b86fd6 100644
--- a/.github/workflows/nightly.yml
+++ b/.github/workflows/nightly.yml
@@ -159,7 +159,7 @@ jobs:
       - name: Set Up Build Tools
         run: |
           sudo apt-get update
-          sudo apt-get install -yq git cmake ccache ninja-build python3 yasm
+          sudo apt-get install -yq git cmake ccache ninja-build python3 yasm nasm
           sudo bash -c "$(wget -O - https://apt.llvm.org/llvm.sh)"
       - name: Run build-wrapper
         run: |

From 5ee7f47b03d3b741db80dae38dfb169f338d9dcc Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 30 Jun 2023 17:09:56 +0200
Subject: [PATCH 1440/1478] Update autogenerated version to 23.7.1.1 and
 contributors

---
 cmake/autogenerated_versions.txt                       | 10 +++++-----
 .../System/StorageSystemContributors.generated.cpp     |  9 +++++++++
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/cmake/autogenerated_versions.txt b/cmake/autogenerated_versions.txt
index 015037b2de6..821b7b46855 100644
--- a/cmake/autogenerated_versions.txt
+++ b/cmake/autogenerated_versions.txt
@@ -2,11 +2,11 @@
 
 # NOTE: has nothing common with DBMS_TCP_PROTOCOL_VERSION,
 # only DBMS_TCP_PROTOCOL_VERSION should be incremented on protocol changes.
-SET(VERSION_REVISION 54475)
+SET(VERSION_REVISION 54476)
 SET(VERSION_MAJOR 23)
-SET(VERSION_MINOR 6)
+SET(VERSION_MINOR 7)
 SET(VERSION_PATCH 1)
-SET(VERSION_GITHASH 2fec796e73efda10a538a03af3205ce8ffa1b2de)
-SET(VERSION_DESCRIBE v23.6.1.1-testing)
-SET(VERSION_STRING 23.6.1.1)
+SET(VERSION_GITHASH d1c7e13d08868cb04d3562dcced704dd577cb1df)
+SET(VERSION_DESCRIBE v23.7.1.1-testing)
+SET(VERSION_STRING 23.7.1.1)
 # end of autochange
diff --git a/src/Storages/System/StorageSystemContributors.generated.cpp b/src/Storages/System/StorageSystemContributors.generated.cpp
index f83ee3197fe..f84c554afc0 100644
--- a/src/Storages/System/StorageSystemContributors.generated.cpp
+++ b/src/Storages/System/StorageSystemContributors.generated.cpp
@@ -226,6 +226,7 @@ const char * auto_contributors[] {
     "Carbyn",
     "Carlos Rodríguez Hernández",
     "Caspian",
+    "Chang Chen",
     "Chao Ma",
     "Chao Wang",
     "CheSema",
@@ -291,6 +292,7 @@ const char * auto_contributors[] {
     "Dmitry Belyavtsev",
     "Dmitry Bilunov",
     "Dmitry Galuza",
+    "Dmitry Kardymon",
     "Dmitry Krylov",
     "Dmitry Luhtionov",
     "Dmitry Moskowski",
@@ -408,6 +410,7 @@ const char * auto_contributors[] {
     "HeenaBansal2009",
     "Hiroaki Nakamura",
     "Hongbin",
+    "Hongbin Ma",
     "Hosun Lee",
     "HuFuwang",
     "Hui Wang",
@@ -491,6 +494,7 @@ const char * auto_contributors[] {
     "Josh Taylor",
     "João Figueiredo",
     "Julian Gilyadov",
+    "Julian Maicher",
     "Julian Zhou",
     "Julio Jimenez",
     "Junfu Wu",
@@ -917,6 +921,7 @@ const char * auto_contributors[] {
     "Thom O'Connor",
     "Thomas Berdy",
     "Thomas Casteleyn",
+    "Thomas Panetti",
     "Tian Xinhui",
     "Tiaonmmn",
     "Tigran Khudaverdyan",
@@ -1022,6 +1027,7 @@ const char * auto_contributors[] {
     "Y Lu",
     "Yakko Majuri",
     "Yakov Olkhovskiy",
+    "YalalovSM",
     "Yangkuan Liu",
     "Yatian Xu",
     "Yatsishin Ilya",
@@ -1300,6 +1306,7 @@ const char * auto_contributors[] {
     "kashwy",
     "keenwolf",
     "kevin wan",
+    "kevinyhzou",
     "kgurjev",
     "khamadiev",
     "kigerzhang",
@@ -1545,6 +1552,7 @@ const char * auto_contributors[] {
     "tiger.yan",
     "tison",
     "topvisor",
+    "tpanetti",
     "turbo jason",
     "tyrionhuang",
     "ubuntu",
@@ -1673,6 +1681,7 @@ const char * auto_contributors[] {
     "董海镔",
     "谢磊",
     "贾顺名(Jarvis)",
+    "郭小龙",
     "陈小玉",
     "靳阳",
     "黄朝晖",

From 8ed1ec49d181123227192e7dfac6ee0119a2e8d7 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Fri, 30 Jun 2023 15:21:13 +0000
Subject: [PATCH 1441/1478] Update version_date.tsv and changelogs after
 v23.6.1.1524-stable

---
 SECURITY.md                            |   1 +
 docker/keeper/Dockerfile               |   2 +-
 docker/server/Dockerfile.alpine        |   2 +-
 docker/server/Dockerfile.ubuntu        |   2 +-
 docs/changelogs/v23.6.1.1524-stable.md | 301 +++++++++++++++++++++++++
 utils/list-versions/version_date.tsv   |   1 +
 6 files changed, 306 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.6.1.1524-stable.md

diff --git a/SECURITY.md b/SECURITY.md
index 1864eb6e9e5..4ba5f13d09c 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -13,6 +13,7 @@ The following versions of ClickHouse server are currently being supported with s
 
 | Version | Supported |
 |:-|:-|
+| 23.6 | ✔️ |
 | 23.5 | ✔️ |
 | 23.4 | ✔️ |
 | 23.3 | ✔️ |
diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 6d53a6f4c51..f13fcdc14d6 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.4.25"
+ARG VERSION="23.6.1.1524"
 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 91b22346f13..5e5be3f6d73 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.4.25"
+ARG VERSION="23.6.1.1524"
 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 0ed0e4e1168..8693193455f 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -23,7 +23,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.4.25"
+ARG VERSION="23.6.1.1524"
 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.6.1.1524-stable.md b/docs/changelogs/v23.6.1.1524-stable.md
new file mode 100644
index 00000000000..6d295d61ef4
--- /dev/null
+++ b/docs/changelogs/v23.6.1.1524-stable.md
@@ -0,0 +1,301 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.6.1.1524-stable (d1c7e13d088) FIXME as compared to v23.5.1.3174-stable (2fec796e73e)
+
+#### Backward Incompatible Change
+* Delete feature `do_not_evict_index_and_mark_files` in the fs cache. This feature was only making things worse. [#51253](https://github.com/ClickHouse/ClickHouse/pull/51253) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Remove ALTER support for experimental LIVE VIEW. [#51287](https://github.com/ClickHouse/ClickHouse/pull/51287) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### New Feature
+* Add setting `session_timezone`, it is used as default timezone for session when not explicitly specified. [#44149](https://github.com/ClickHouse/ClickHouse/pull/44149) ([Andrey Zvonov](https://github.com/zvonand)).
+* Added overlay database engine and representation of a directory as a database This commit adds 4 databases: 1. DatabaseOverlay: Implements the IDatabase interface. Allow to combine multiple databases, such as FileSystem and Memory. Internally, it stores a vector with other database pointers and proxies requests to them in turn until it is executed successfully. 2. DatabaseFilesystem: allows to read-only interact with files stored on the file system. Internally, it uses TableFunctionFile to implicitly load file when a user requests the table. Result of TableFunctionFile call cached inside to provide quick access. 3. DatabaseS3: allows to read-only interact with s3 storage. It uses TableFunctionS3 to implicitly load table from s3 4. DatabaseHDFS: allows to interact with hdfs storage. It uses TableFunctionHDFS to implicitly load table from hdfs. [#48821](https://github.com/ClickHouse/ClickHouse/pull/48821) ([alekseygolub](https://github.com/alekseygolub)).
+* Add a new setting named `use_mysql_types_in_show_columns` to alter the `SHOW COLUMNS` SQL statement to display MySQL equivalent types when a client is connected via the MySQL compatibility port. [#49577](https://github.com/ClickHouse/ClickHouse/pull/49577) ([Thomas Panetti](https://github.com/tpanetti)).
+* Added option `--rename_files_after_processing <pattern>`. This closes [#34207](https://github.com/ClickHouse/ClickHouse/issues/34207). [#49626](https://github.com/ClickHouse/ClickHouse/pull/49626) ([alekseygolub](https://github.com/alekseygolub)).
+* 1. Add `TableFunctionRedis` 3. Add table engine Redis 4. Add `RedisCommon` which contains Redis related tools and types 5. Support `equals` and `in` filter push down into Redis. [#50150](https://github.com/ClickHouse/ClickHouse/pull/50150) ([JackyWoo](https://github.com/JackyWoo)).
+* Allow to skip empty files in file/s3/url/hdfs table functions using settings `s3_skip_empty_files`, `hdfs_skip_empty_files`, `engine_file_skip_empty_files`, `engine_url_skip_empty_files`. [#50364](https://github.com/ClickHouse/ClickHouse/pull/50364) ([Kruglov Pavel](https://github.com/Avogar)).
+* Clickhouse-client can now be called with a connection instead of "--host", "--port", "--user" etc. [#50689](https://github.com/ClickHouse/ClickHouse/pull/50689) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Codec DEFLATE_QPL is now controlled via server setting "enable_deflate_qpl_codec" (default: false) instead of setting "allow_experimental_codecs". This marks QPL_DEFLATE non-experimental. [#50775](https://github.com/ClickHouse/ClickHouse/pull/50775) ([Robert Schulze](https://github.com/rschu1ze)).
+
+#### Performance Improvement
+* Improve performance with enabled QueryProfiler using thread-local timer_id instead of global object. [#48778](https://github.com/ClickHouse/ClickHouse/pull/48778) ([Jiebin Sun](https://github.com/jiebinn)).
+* Rewrite CapnProto input/output format to improve its performance. Map column names and CapnProto fields case insensitive, fix reading/writing of nested structure fields. [#49752](https://github.com/ClickHouse/ClickHouse/pull/49752) ([Kruglov Pavel](https://github.com/Avogar)).
+* Optimize parquet write performance for parallel threads. [#50102](https://github.com/ClickHouse/ClickHouse/pull/50102) ([Hongbin Ma](https://github.com/binmahone)).
+* ### Documentation entry for user-facing changes Disable `parallelize_output_from_storages` for processing MATERIALIZED VIEWs and storages with one block only. [#50214](https://github.com/ClickHouse/ClickHouse/pull/50214) ([Azat Khuzhin](https://github.com/azat)).
+* Merge PR https://github.com/ClickHouse/ClickHouse/pull/46558 (Avoid processing already sorted data). Avoid block permutation during sort if the block is already sorted. [#50697](https://github.com/ClickHouse/ClickHouse/pull/50697) ([Maksim Kita](https://github.com/kitaisreal)).
+* In the earlier PRs ([#50062](https://github.com/ClickHouse/ClickHouse/issues/50062), [#50307](https://github.com/ClickHouse/ClickHouse/issues/50307)), we used to propose an optimization pattern which transforms the predicates with toYear/toYYYYMM into its equivalent but converter-free form. This transformation could bring significant performance impact to some workloads, such as SSB. However, as issue [#50628](https://github.com/ClickHouse/ClickHouse/issues/50628) indicated, these two PRs would introduce some issues which may results in incomplete query results, and as a result, they were reverted by [#50629](https://github.com/ClickHouse/ClickHouse/issues/50629). [#50951](https://github.com/ClickHouse/ClickHouse/pull/50951) ([Zhiguo Zhou](https://github.com/ZhiguoZh)).
+* Make multiple list requests to ZooKeeper in parallel to speed up reading from system.zookeeper table. [#51042](https://github.com/ClickHouse/ClickHouse/pull/51042) ([Alexander Gololobov](https://github.com/davenger)).
+* Speedup initialization of DateTime lookup tables for time zones. This should reduce startup/connect time of clickhouse client especially in debug build as it is rather heavy. [#51347](https://github.com/ClickHouse/ClickHouse/pull/51347) ([Alexander Gololobov](https://github.com/davenger)).
+
+#### Improvement
+* Allow to cast IPv6 to IPv4 address for CIDR ::ffff:0:0/96 (IPv4-mapped addresses). [#49759](https://github.com/ClickHouse/ClickHouse/pull/49759) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Update MongoDB protocol to support MongoDB 5.1 version and newer. Support for the versions with the old protocol (<3.6) is preserved. Closes [#45621](https://github.com/ClickHouse/ClickHouse/issues/45621), [#49879](https://github.com/ClickHouse/ClickHouse/issues/49879). [#50061](https://github.com/ClickHouse/ClickHouse/pull/50061) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Improved scheduling of merge selecting and cleanup tasks in `ReplicatedMergeTree`. The tasks will not be executed too frequently when there's nothing to merge or cleanup. Added settings `max_merge_selecting_sleep_ms`, `merge_selecting_sleep_slowdown_factor`, `max_cleanup_delay_period` and `cleanup_thread_preferred_points_per_iteration`. It should close [#31919](https://github.com/ClickHouse/ClickHouse/issues/31919). [#50107](https://github.com/ClickHouse/ClickHouse/pull/50107) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Support parallel replicas with the analyzer. [#50441](https://github.com/ClickHouse/ClickHouse/pull/50441) ([Raúl Marín](https://github.com/Algunenano)).
+* Add setting `input_format_max_bytes_to_read_for_schema_inference` to limit the number of bytes to read in schema inference. Closes [#50577](https://github.com/ClickHouse/ClickHouse/issues/50577). [#50592](https://github.com/ClickHouse/ClickHouse/pull/50592) ([Kruglov Pavel](https://github.com/Avogar)).
+* Respect setting input_format_as_default in schema inference. [#50602](https://github.com/ClickHouse/ClickHouse/pull/50602) ([Kruglov Pavel](https://github.com/Avogar)).
+* Make filter push down through cross join. [#50605](https://github.com/ClickHouse/ClickHouse/pull/50605) ([Han Fei](https://github.com/hanfei1991)).
+* Actual lz4 version is used now. [#50621](https://github.com/ClickHouse/ClickHouse/pull/50621) ([Nikita Taranov](https://github.com/nickitat)).
+* Allow to skip trailing empty lines in CSV/TSV/CustomSeparated formats via settings `input_format_csv_skip_trailing_empty_lines`, `input_format_tsv_skip_trailing_empty_lines` and `input_format_custom_skip_trailing_empty_lines` (disabled by default). Closes [#49315](https://github.com/ClickHouse/ClickHouse/issues/49315). [#50635](https://github.com/ClickHouse/ClickHouse/pull/50635) ([Kruglov Pavel](https://github.com/Avogar)).
+* Functions "toDateOrDefault|OrNull()" and "accuateCast[OrDefault|OrNull]()" now correctly parse numeric arguments. [#50709](https://github.com/ClickHouse/ClickHouse/pull/50709) ([Dmitry Kardymon](https://github.com/kardymonds)).
+* Currently, the csv input format can not parse the csv file with whitespace or \t field delimiter, and these delimiters is supported in spark. [#50712](https://github.com/ClickHouse/ClickHouse/pull/50712) ([KevinyhZou](https://github.com/KevinyhZou)).
+* Settings `number_of_mutations_to_delay` and `number_of_mutations_to_throw` are enabled by default now with values 500 and 1000 respectively. [#50726](https://github.com/ClickHouse/ClickHouse/pull/50726) ([Anton Popov](https://github.com/CurtizJ)).
+* Keeper improvement: add feature flags for Keeper API. Each feature flag can be disabled or enabled by defining it under `keeper_server.feature_flags` config. E.g. to enable `CheckNotExists` request, `keeper_server.feature_flags.check_not_exists` should be set to `1` on Keeper. [#50796](https://github.com/ClickHouse/ClickHouse/pull/50796) ([Antonio Andelic](https://github.com/antonio2368)).
+* The dashboard correctly shows missing values. This closes [#50831](https://github.com/ClickHouse/ClickHouse/issues/50831). [#50832](https://github.com/ClickHouse/ClickHouse/pull/50832) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* CGroups metrics related to CPU are replaced with one metric, `CGroupMaxCPU` for better usability. The `Normalized` CPU usage metrics will be normalized to CGroups limits instead of the total number of CPUs when they are set. This closes [#50836](https://github.com/ClickHouse/ClickHouse/issues/50836). [#50835](https://github.com/ClickHouse/ClickHouse/pull/50835) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Relax the thresholds for "too many parts" to be more modern. Return the backpressure during long-running insert queries. [#50856](https://github.com/ClickHouse/ClickHouse/pull/50856) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Added the possibility to use date and time arguments in syslog timestamp format in functions parseDateTimeBestEffort*() and parseDateTime64BestEffort*(). [#50925](https://github.com/ClickHouse/ClickHouse/pull/50925) ([Victor Krasnov](https://github.com/sirvickr)).
+* Suggest using `APPEND` or `TRUNCATE` for `INTO OUTFILE` when file exists. [#50950](https://github.com/ClickHouse/ClickHouse/pull/50950) ([alekar](https://github.com/alekar)).
+* Add embedded keeper-client to standalone keeper binary. [#50964](https://github.com/ClickHouse/ClickHouse/pull/50964) ([pufit](https://github.com/pufit)).
+* Command line parameter "--password" in clickhouse-client can now be specified only once. [#50966](https://github.com/ClickHouse/ClickHouse/pull/50966) ([Alexey Gerasimchuck](https://github.com/Demilivor)).
+* Fix data lakes slowness because of synchronous head requests. (Related to Iceberg/Deltalake/Hudi being slow with a lot of files). [#50976](https://github.com/ClickHouse/ClickHouse/pull/50976) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Use `hash_of_all_files` from `system.parts` to check identity of parts during on-cluster backups. [#50997](https://github.com/ClickHouse/ClickHouse/pull/50997) ([Vitaly Baranov](https://github.com/vitlibar)).
+* The system table zookeeper_connection connected_time identifies the time when the connection is established (standard format), and session_uptime_elapsed_seconds is added, which labels the duration of the established connection session (in seconds). [#51026](https://github.com/ClickHouse/ClickHouse/pull/51026) ([郭小龙](https://github.com/guoxiaolongzte)).
+* Show halves of checksums in `system.parts`, `system.projection_parts` and in error messages in the correct order. [#51040](https://github.com/ClickHouse/ClickHouse/pull/51040) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Do not replicate `ALTER PARTITION` queries and mutations through `Replicated` database if it has only one shard and the underlying table is `ReplicatedMergeTree`. [#51049](https://github.com/ClickHouse/ClickHouse/pull/51049) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Improve the progress bar for file/s3/hdfs/url table functions by using chunk size from source data and using incremental total size counting in each thread. Fix the progress bar for *Cluster functions. This closes [#47250](https://github.com/ClickHouse/ClickHouse/issues/47250). [#51088](https://github.com/ClickHouse/ClickHouse/pull/51088) ([Kruglov Pavel](https://github.com/Avogar)).
+* Add total_bytes_to_read to Progress packet in TCP protocol for better Progress bar. [#51158](https://github.com/ClickHouse/ClickHouse/pull/51158) ([Kruglov Pavel](https://github.com/Avogar)).
+* Better checking of data parts on disks with filesystem cache. [#51164](https://github.com/ClickHouse/ClickHouse/pull/51164) ([Anton Popov](https://github.com/CurtizJ)).
+* Disable cache setting `do_not_evict_index_and_mark_files` (Was enabled in `23.5`). [#51222](https://github.com/ClickHouse/ClickHouse/pull/51222) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix sometimes not correct current_elements_num in fs cache. [#51242](https://github.com/ClickHouse/ClickHouse/pull/51242) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Add random sleep before merges/mutations execution to split load more evenly between replicas in case of zero-copy replication. [#51282](https://github.com/ClickHouse/ClickHouse/pull/51282) ([alesapin](https://github.com/alesapin)).
+* The function `transform` as well as `CASE` with value matching started to support all data types. This closes [#29730](https://github.com/ClickHouse/ClickHouse/issues/29730). This closes [#32387](https://github.com/ClickHouse/ClickHouse/issues/32387). This closes [#50827](https://github.com/ClickHouse/ClickHouse/issues/50827). This closes [#31336](https://github.com/ClickHouse/ClickHouse/issues/31336). This closes [#40493](https://github.com/ClickHouse/ClickHouse/issues/40493). [#51351](https://github.com/ClickHouse/ClickHouse/pull/51351) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* We have found a bug in LLVM that makes the usage of `compile_expressions` setting unsafe. It is disabled by default. [#51368](https://github.com/ClickHouse/ClickHouse/pull/51368) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Issue [#50220](https://github.com/ClickHouse/ClickHouse/issues/50220) reports a core in `grace_hash` join. We finally reproduce the exception on local, and found that the issue is related to the failure of creating temporary file. Somehow this is triggered in https://github.com/ClickHouse/ClickHouse/pull/49816 https://github.com/ClickHouse/ClickHouse/pull/49483. [#51382](https://github.com/ClickHouse/ClickHouse/pull/51382) ([lgbo](https://github.com/lgbo-ustc)).
+
+#### Build/Testing/Packaging Improvement
+* Update contrib/re2 to 2023-06-02. [#50949](https://github.com/ClickHouse/ClickHouse/pull/50949) ([Yuriy Chernyshov](https://github.com/georgthegreat)).
+* ClickHouse server will print the list of changed settings on fatal errors. This closes [#51137](https://github.com/ClickHouse/ClickHouse/issues/51137). [#51138](https://github.com/ClickHouse/ClickHouse/pull/51138) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* In https://github.com/ClickHouse/ClickHouse/pull/51143 the fasstests failed, but the status wasn't created because of the chown `file not found`. This addresses it. Decrease the default values for `http-max-field-value-size` and `http_max_field_name_size` to 128K. [#51163](https://github.com/ClickHouse/ClickHouse/pull/51163) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update Ubuntu version in docker containers. [#51180](https://github.com/ClickHouse/ClickHouse/pull/51180) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Allow building ClickHouse with clang-17. [#51300](https://github.com/ClickHouse/ClickHouse/pull/51300) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* [SQLancer](https://github.com/sqlancer/sqlancer) check is considered stable as bugs that were triggered by it are fixed. Now failures of SQLancer check will be reported as failed check status. [#51340](https://github.com/ClickHouse/ClickHouse/pull/51340) ([Ilya Yatsishin](https://github.com/qoega)).
+* Making our CI even better. [#51494](https://github.com/ClickHouse/ClickHouse/pull/51494) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Split huge `RUN` in Dockerfile into smaller conditional. Install the necessary tools on demand in the same `RUN` layer, and remove them after that. Upgrade the OS only once at the beginning. Use a modern way to check the signed repository. Downgrade the base repo to ubuntu:20.04 to address the issues on older docker versions. Upgrade golang version to address golang vulnerabilities. [#51504](https://github.com/ClickHouse/ClickHouse/pull/51504) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* This a follow-up for [#51504](https://github.com/ClickHouse/ClickHouse/issues/51504), the cleanup was lost during refactoring. [#51564](https://github.com/ClickHouse/ClickHouse/pull/51564) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Report loading status for executable dictionaries correctly [#48775](https://github.com/ClickHouse/ClickHouse/pull/48775) ([Anton Kozlov](https://github.com/tonickkozlov)).
+* Proper mutation of skip indices and projections [#50104](https://github.com/ClickHouse/ClickHouse/pull/50104) ([Amos Bird](https://github.com/amosbird)).
+* Cleanup moving parts [#50489](https://github.com/ClickHouse/ClickHouse/pull/50489) ([vdimir](https://github.com/vdimir)).
+* Fix backward compatibility for IP types hashing in aggregate functions [#50551](https://github.com/ClickHouse/ClickHouse/pull/50551) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* 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)).
+* Query Cache: Try to fix bad cast from ColumnConst to ColumnVector<char8_t> [#50704](https://github.com/ClickHouse/ClickHouse/pull/50704) ([Robert Schulze](https://github.com/rschu1ze)).
+* 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)).
+* Avoid storing logs in Keeper containing unknown operation [#50751](https://github.com/ClickHouse/ClickHouse/pull/50751) ([Antonio Andelic](https://github.com/antonio2368)).
+* SummingMergeTree support for DateTime64 [#50797](https://github.com/ClickHouse/ClickHouse/pull/50797) ([Jordi Villar](https://github.com/jrdi)).
+* Add compat setting for non-const timezones [#50834](https://github.com/ClickHouse/ClickHouse/pull/50834) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix type of LDAP server params hash in cache entry [#50865](https://github.com/ClickHouse/ClickHouse/pull/50865) ([Julian Maicher](https://github.com/jmaicher)).
+* Fallback to parsing big integer from String instead of exception in Parquet format [#50873](https://github.com/ClickHouse/ClickHouse/pull/50873) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix checking the lock file too often while writing a backup [#50889](https://github.com/ClickHouse/ClickHouse/pull/50889) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Do not apply projection if read-in-order was enabled. [#50923](https://github.com/ClickHouse/ClickHouse/pull/50923) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix race azure blob storage iterator [#50936](https://github.com/ClickHouse/ClickHouse/pull/50936) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix erroneous `sort_description` propagation in `CreatingSets` [#50955](https://github.com/ClickHouse/ClickHouse/pull/50955) ([Nikita Taranov](https://github.com/nickitat)).
+* Fix iceberg V2 optional metadata parsing [#50974](https://github.com/ClickHouse/ClickHouse/pull/50974) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* MaterializedMySQL: Keep parentheses for empty table overrides [#50977](https://github.com/ClickHouse/ClickHouse/pull/50977) ([Val Doroshchuk](https://github.com/valbok)).
+* Fix crash in BackupCoordinationStageSync::setError() [#51012](https://github.com/ClickHouse/ClickHouse/pull/51012) ([Vitaly Baranov](https://github.com/vitlibar)).
+* 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)).
+* Fix ineffective query cache for SELECTs with subqueries [#51132](https://github.com/ClickHouse/ClickHouse/pull/51132) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix Set index with constant nullable comparison. [#51205](https://github.com/ClickHouse/ClickHouse/pull/51205) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Fix a crash in s3 and s3Cluster functions [#51209](https://github.com/ClickHouse/ClickHouse/pull/51209) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Fix core dump when compile expression [#51231](https://github.com/ClickHouse/ClickHouse/pull/51231) ([LiuNeng](https://github.com/liuneng1994)).
+* Fix use-after-free in StorageURL when switching URLs [#51260](https://github.com/ClickHouse/ClickHouse/pull/51260) ([Michael Kolupaev](https://github.com/al13n321)).
+* Updated check for parameterized view [#51272](https://github.com/ClickHouse/ClickHouse/pull/51272) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix multiple writing of same file to backup [#51299](https://github.com/ClickHouse/ClickHouse/pull/51299) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Fix fuzzer failure in ActionsDAG [#51301](https://github.com/ClickHouse/ClickHouse/pull/51301) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Remove garbage from function `transform` [#51350](https://github.com/ClickHouse/ClickHouse/pull/51350) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix MSan report in lowerUTF8/upperUTF8 [#51371](https://github.com/ClickHouse/ClickHouse/pull/51371) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* fs cache: fix a bit incorrect use_count after [#44985](https://github.com/ClickHouse/ClickHouse/issues/44985) [#51406](https://github.com/ClickHouse/ClickHouse/pull/51406) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix segfault in MathUnary [#51499](https://github.com/ClickHouse/ClickHouse/pull/51499) ([Ilya Yatsishin](https://github.com/qoega)).
+* Fix logical assert in `tupleElement()` with default values [#51534](https://github.com/ClickHouse/ClickHouse/pull/51534) ([Robert Schulze](https://github.com/rschu1ze)).
+* fs cache: remove file from opened file cache immediately when evicting file [#51596](https://github.com/ClickHouse/ClickHouse/pull/51596) ([Kseniia Sumarokova](https://github.com/kssenii)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Deprecate delete-on-destroy.txt [#49181](https://github.com/ClickHouse/ClickHouse/pull/49181) ([Alexander Gololobov](https://github.com/davenger)).
+* Attempt to increase the general runners' survival rate [#49283](https://github.com/ClickHouse/ClickHouse/pull/49283) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Refactor subqueries for IN [#49570](https://github.com/ClickHouse/ClickHouse/pull/49570) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Test plan optimization analyzer [#50095](https://github.com/ClickHouse/ClickHouse/pull/50095) ([Igor Nikonov](https://github.com/devcrafter)).
+* Implement endianness-independent serialization for quantileTiming [#50324](https://github.com/ClickHouse/ClickHouse/pull/50324) ([ltrk2](https://github.com/ltrk2)).
+* require `finalize()` call before d-tor for all writes buffers [#50395](https://github.com/ClickHouse/ClickHouse/pull/50395) ([Sema Checherinda](https://github.com/CheSema)).
+* Implement big-endian support for the deterministic reservoir sampler [#50405](https://github.com/ClickHouse/ClickHouse/pull/50405) ([ltrk2](https://github.com/ltrk2)).
+* Fix compilation error on big-endian platforms [#50406](https://github.com/ClickHouse/ClickHouse/pull/50406) ([ltrk2](https://github.com/ltrk2)).
+* Attach gdb in stateless tests [#50487](https://github.com/ClickHouse/ClickHouse/pull/50487) ([Kruglov Pavel](https://github.com/Avogar)).
+* JIT infrastructure refactoring [#50531](https://github.com/ClickHouse/ClickHouse/pull/50531) ([Maksim Kita](https://github.com/kitaisreal)).
+* Analyzer: Do not apply Query Tree optimizations on shards [#50584](https://github.com/ClickHouse/ClickHouse/pull/50584) ([Dmitry Novik](https://github.com/novikd)).
+* Increase max array size in group bitmap [#50620](https://github.com/ClickHouse/ClickHouse/pull/50620) ([Kruglov Pavel](https://github.com/Avogar)).
+* Misc Annoy index improvements [#50661](https://github.com/ClickHouse/ClickHouse/pull/50661) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix reading negative decimals in avro format [#50668](https://github.com/ClickHouse/ClickHouse/pull/50668) ([Kruglov Pavel](https://github.com/Avogar)).
+* Unify priorities for connection pools [#50675](https://github.com/ClickHouse/ClickHouse/pull/50675) ([Sergei Trifonov](https://github.com/serxa)).
+* Prostpone check of outdated parts [#50676](https://github.com/ClickHouse/ClickHouse/pull/50676) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Unify priorities: `IExecutableTask`s [#50677](https://github.com/ClickHouse/ClickHouse/pull/50677) ([Sergei Trifonov](https://github.com/serxa)).
+* Disable grace_hash join in stress tests [#50693](https://github.com/ClickHouse/ClickHouse/pull/50693) ([vdimir](https://github.com/vdimir)).
+* ReverseTransform small improvement [#50698](https://github.com/ClickHouse/ClickHouse/pull/50698) ([Maksim Kita](https://github.com/kitaisreal)).
+* Support OPTIMIZE for temporary tables  [#50710](https://github.com/ClickHouse/ClickHouse/pull/50710) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Refactor reading from object storages [#50711](https://github.com/ClickHouse/ClickHouse/pull/50711) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix data race in log message of cached buffer [#50723](https://github.com/ClickHouse/ClickHouse/pull/50723) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Add new keywords into projections documentation [#50743](https://github.com/ClickHouse/ClickHouse/pull/50743) ([YalalovSM](https://github.com/YalalovSM)).
+* Fix build for aarch64 (temporary disable azure) [#50770](https://github.com/ClickHouse/ClickHouse/pull/50770) ([alesapin](https://github.com/alesapin)).
+* Update version after release [#50772](https://github.com/ClickHouse/ClickHouse/pull/50772) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Update version_date.tsv and changelogs after v23.5.1.3174-stable [#50774](https://github.com/ClickHouse/ClickHouse/pull/50774) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update CHANGELOG.md [#50788](https://github.com/ClickHouse/ClickHouse/pull/50788) ([Ilya Yatsishin](https://github.com/qoega)).
+* Update version_date.tsv and changelogs after v23.2.7.32-stable [#50809](https://github.com/ClickHouse/ClickHouse/pull/50809) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Desctructing --> Destructing [#50810](https://github.com/ClickHouse/ClickHouse/pull/50810) ([Robert Schulze](https://github.com/rschu1ze)).
+* Don't mark a part as broken on `Poco::TimeoutException` [#50811](https://github.com/ClickHouse/ClickHouse/pull/50811) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Rename azure_blob_storage to azureBlobStorage [#50812](https://github.com/ClickHouse/ClickHouse/pull/50812) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Fix ParallelReadBuffer seek [#50820](https://github.com/ClickHouse/ClickHouse/pull/50820) ([Michael Kolupaev](https://github.com/al13n321)).
+* [RFC] Print git hash when crashing [#50823](https://github.com/ClickHouse/ClickHouse/pull/50823) ([Michael Kolupaev](https://github.com/al13n321)).
+* Add tests for function "transform" [#50833](https://github.com/ClickHouse/ClickHouse/pull/50833) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Update version_date.tsv and changelogs after v23.5.2.7-stable [#50844](https://github.com/ClickHouse/ClickHouse/pull/50844) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Updated changelog with azureBlobStorage table function & engine entry [#50850](https://github.com/ClickHouse/ClickHouse/pull/50850) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+* Update easy_tasks_sorted_ru.md [#50853](https://github.com/ClickHouse/ClickHouse/pull/50853) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Document x86 / ARM prerequisites for Docker image [#50867](https://github.com/ClickHouse/ClickHouse/pull/50867) ([Robert Schulze](https://github.com/rschu1ze)).
+* MaterializedMySQL: Add test_named_collections [#50874](https://github.com/ClickHouse/ClickHouse/pull/50874) ([Val Doroshchuk](https://github.com/valbok)).
+* Update version_date.tsv and changelogs after v22.8.18.31-lts [#50881](https://github.com/ClickHouse/ClickHouse/pull/50881) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v23.3.3.52-lts [#50882](https://github.com/ClickHouse/ClickHouse/pull/50882) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v23.4.3.48-stable [#50883](https://github.com/ClickHouse/ClickHouse/pull/50883) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* MaterializedMySQL: Add additional test case to insert_with_modify_binlog_checksum [#50884](https://github.com/ClickHouse/ClickHouse/pull/50884) ([Val Doroshchuk](https://github.com/valbok)).
+* Update broken tests list [#50886](https://github.com/ClickHouse/ClickHouse/pull/50886) ([Dmitry Novik](https://github.com/novikd)).
+* Fix LOGICAL_ERROR in snowflakeToDateTime*() [#50893](https://github.com/ClickHouse/ClickHouse/pull/50893) ([Robert Schulze](https://github.com/rschu1ze)).
+* Tests with parallel replicas are no more "always green" [#50896](https://github.com/ClickHouse/ClickHouse/pull/50896) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Slightly more information in error message about cached disk [#50897](https://github.com/ClickHouse/ClickHouse/pull/50897) ([Michael Kolupaev](https://github.com/al13n321)).
+* do not call finalize after exception [#50907](https://github.com/ClickHouse/ClickHouse/pull/50907) ([Sema Checherinda](https://github.com/CheSema)).
+* Update Annoy docs [#50912](https://github.com/ClickHouse/ClickHouse/pull/50912) ([Robert Schulze](https://github.com/rschu1ze)).
+* A bit safer UserDefinedSQLFunctionVisitor [#50913](https://github.com/ClickHouse/ClickHouse/pull/50913) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update contribe/orc in .gitmodules [#50920](https://github.com/ClickHouse/ClickHouse/pull/50920) ([San](https://github.com/santrancisco)).
+* MaterializedMySQL: Add missing DROP DATABASE for tests [#50924](https://github.com/ClickHouse/ClickHouse/pull/50924) ([Val Doroshchuk](https://github.com/valbok)).
+* Fix 'Illegal column timezone' in stress tests [#50929](https://github.com/ClickHouse/ClickHouse/pull/50929) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix tests sanity checks and avoid dropping system.query_log table [#50934](https://github.com/ClickHouse/ClickHouse/pull/50934) ([Azat Khuzhin](https://github.com/azat)).
+* Fix tests for throttling by allowing more margin of error for trottling event [#50935](https://github.com/ClickHouse/ClickHouse/pull/50935) ([Azat Khuzhin](https://github.com/azat)).
+* 01746_convert_type_with_default: Temporarily disable flaky test [#50937](https://github.com/ClickHouse/ClickHouse/pull/50937) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix the statless tests image for old commits [#50947](https://github.com/ClickHouse/ClickHouse/pull/50947) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fix logic in `AsynchronousBoundedReadBuffer::seek` [#50952](https://github.com/ClickHouse/ClickHouse/pull/50952) ([Nikita Taranov](https://github.com/nickitat)).
+* Uncomment flaky test (01746_convert_type_with_default) [#50954](https://github.com/ClickHouse/ClickHouse/pull/50954) ([Dmitry Kardymon](https://github.com/kardymonds)).
+* Fix keeper-client help message [#50965](https://github.com/ClickHouse/ClickHouse/pull/50965) ([pufit](https://github.com/pufit)).
+* fix build issue on clang 15 [#50967](https://github.com/ClickHouse/ClickHouse/pull/50967) ([Chang chen](https://github.com/baibaichen)).
+* Docs: Fix embedded video link [#50972](https://github.com/ClickHouse/ClickHouse/pull/50972) ([Robert Schulze](https://github.com/rschu1ze)).
+* Change submodule capnproto to it's fork in ClickHouse [#50987](https://github.com/ClickHouse/ClickHouse/pull/50987) ([Kruglov Pavel](https://github.com/Avogar)).
+* Attempt to make 01281_group_by_limit_memory_tracking not flaky [#50995](https://github.com/ClickHouse/ClickHouse/pull/50995) ([Dmitry Novik](https://github.com/novikd)).
+* Fix flaky 02561_null_as_default_more_formats [#51001](https://github.com/ClickHouse/ClickHouse/pull/51001) ([Igor Nikonov](https://github.com/devcrafter)).
+* Fix flaky test_seekable_formats [#51002](https://github.com/ClickHouse/ClickHouse/pull/51002) ([Kruglov Pavel](https://github.com/Avogar)).
+* Follow-up to [#50448](https://github.com/ClickHouse/ClickHouse/issues/50448) [#51006](https://github.com/ClickHouse/ClickHouse/pull/51006) ([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)).
+* Do not spam sqlancer build log [#51061](https://github.com/ClickHouse/ClickHouse/pull/51061) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Refactor IColumn::forEachSubcolumn to make it slightly harder to implement incorrectly [#51072](https://github.com/ClickHouse/ClickHouse/pull/51072) ([Michael Kolupaev](https://github.com/al13n321)).
+* MaterializedMySQL: Rename materialize_with_ddl.py -> materialized_with_ddl [#51074](https://github.com/ClickHouse/ClickHouse/pull/51074) ([Val Doroshchuk](https://github.com/valbok)).
+* Improve woboq browser report [#51077](https://github.com/ClickHouse/ClickHouse/pull/51077) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fix for part_names_mutex used after destruction [#51099](https://github.com/ClickHouse/ClickHouse/pull/51099) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix ColumnConst::forEachSubcolumn missing from previous PR [#51102](https://github.com/ClickHouse/ClickHouse/pull/51102) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix the test 02783_parsedatetimebesteffort_syslog flakiness [#51112](https://github.com/ClickHouse/ClickHouse/pull/51112) ([Victor Krasnov](https://github.com/sirvickr)).
+* Compatibility with clang-17 [#51114](https://github.com/ClickHouse/ClickHouse/pull/51114) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Make more parallel get requests to ZooKeeper in system.zookeeper [#51118](https://github.com/ClickHouse/ClickHouse/pull/51118) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix 02703_max_local_write_bandwidth flakiness [#51120](https://github.com/ClickHouse/ClickHouse/pull/51120) ([Azat Khuzhin](https://github.com/azat)).
+* Update version_date.tsv and changelogs after v23.5.3.24-stable [#51121](https://github.com/ClickHouse/ClickHouse/pull/51121) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v23.4.4.16-stable [#51122](https://github.com/ClickHouse/ClickHouse/pull/51122) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v23.3.4.17-lts [#51123](https://github.com/ClickHouse/ClickHouse/pull/51123) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v22.8.19.10-lts [#51124](https://github.com/ClickHouse/ClickHouse/pull/51124) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Fix typo [#51126](https://github.com/ClickHouse/ClickHouse/pull/51126) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Slightly better diagnostics [#51127](https://github.com/ClickHouse/ClickHouse/pull/51127) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Small fix in `MergeTreePrefetchedReadPool` [#51131](https://github.com/ClickHouse/ClickHouse/pull/51131) ([Nikita Taranov](https://github.com/nickitat)).
+* Don't report table function accesses to system.errors [#51147](https://github.com/ClickHouse/ClickHouse/pull/51147) ([Raúl Marín](https://github.com/Algunenano)).
+* Fix SQLancer branch name [#51148](https://github.com/ClickHouse/ClickHouse/pull/51148) ([Ilya Yatsishin](https://github.com/qoega)).
+* Revert "Added ability to implicitly use file/hdfs/s3 table functions in clickhouse-local" [#51149](https://github.com/ClickHouse/ClickHouse/pull/51149) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* More profile events for fs cache [#51161](https://github.com/ClickHouse/ClickHouse/pull/51161) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Unforget to pass callback to readBigAt() in ParallelReadBuffer [#51165](https://github.com/ClickHouse/ClickHouse/pull/51165) ([Michael Kolupaev](https://github.com/al13n321)).
+* Update README.md [#51179](https://github.com/ClickHouse/ClickHouse/pull/51179) ([Tyler Hannan](https://github.com/tylerhannan)).
+* Update exception message [#51187](https://github.com/ClickHouse/ClickHouse/pull/51187) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Split long test 02149_schema_inference_formats_with_schema into several tests to avoid timeout in debug [#51197](https://github.com/ClickHouse/ClickHouse/pull/51197) ([Kruglov Pavel](https://github.com/Avogar)).
+* Avoid initializing DateLUT from emptyArray function registration [#51199](https://github.com/ClickHouse/ClickHouse/pull/51199) ([Alexander Gololobov](https://github.com/davenger)).
+* Suppress check for covered parts in ZooKeeper [#51207](https://github.com/ClickHouse/ClickHouse/pull/51207) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* One more profile event for fs cache [#51223](https://github.com/ClickHouse/ClickHouse/pull/51223) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Typo: passowrd_sha256_hex --> password_sha256_hex [#51233](https://github.com/ClickHouse/ClickHouse/pull/51233) ([Robert Schulze](https://github.com/rschu1ze)).
+* Introduce settings enum field with auto-generated values list [#51237](https://github.com/ClickHouse/ClickHouse/pull/51237) ([Sergei Trifonov](https://github.com/serxa)).
+* Drop session if we fail to get Keeper API version  [#51238](https://github.com/ClickHouse/ClickHouse/pull/51238) ([Alexander Gololobov](https://github.com/davenger)).
+* Revert "Fix a crash in s3 and s3Cluster functions" [#51239](https://github.com/ClickHouse/ClickHouse/pull/51239) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* fix flaky `AsyncLoader` destructor [#51245](https://github.com/ClickHouse/ClickHouse/pull/51245) ([Sergei Trifonov](https://github.com/serxa)).
+* Docs: little cleanup of configuration-files.md [#51249](https://github.com/ClickHouse/ClickHouse/pull/51249) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix a stupid bug on Replicated database recovery [#51252](https://github.com/ClickHouse/ClickHouse/pull/51252) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* FileCache: tryReserve() slight improvement [#51259](https://github.com/ClickHouse/ClickHouse/pull/51259) ([Igor Nikonov](https://github.com/devcrafter)).
+* Ugly hotfix for "terminate on uncaught exception" in WriteBufferFromOStream [#51265](https://github.com/ClickHouse/ClickHouse/pull/51265) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Avoid too many calls to Poco::Logger::get [#51266](https://github.com/ClickHouse/ClickHouse/pull/51266) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Update version_date.tsv and changelogs after v23.3.5.9-lts [#51269](https://github.com/ClickHouse/ClickHouse/pull/51269) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Better reporting of broken parts [#51270](https://github.com/ClickHouse/ClickHouse/pull/51270) ([Anton Popov](https://github.com/CurtizJ)).
+* Update ext-dict-functions.md [#51283](https://github.com/ClickHouse/ClickHouse/pull/51283) ([Mike Kot](https://github.com/myrrc)).
+* Disable table structure check for secondary queries from Replicated db [#51284](https://github.com/ClickHouse/ClickHouse/pull/51284) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Define Thrift version for parquet and use correct arrow version [#51285](https://github.com/ClickHouse/ClickHouse/pull/51285) ([Kruglov Pavel](https://github.com/Avogar)).
+* Restore Azure build on ARM [#51288](https://github.com/ClickHouse/ClickHouse/pull/51288) ([Robert Schulze](https://github.com/rschu1ze)).
+* Query Cache: Un-comment settings in server cfg [#51294](https://github.com/ClickHouse/ClickHouse/pull/51294) ([Robert Schulze](https://github.com/rschu1ze)).
+* Require more checks [#51295](https://github.com/ClickHouse/ClickHouse/pull/51295) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix metadata loading test [#51297](https://github.com/ClickHouse/ClickHouse/pull/51297) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Scratch the strange Python code [#51302](https://github.com/ClickHouse/ClickHouse/pull/51302) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add a test for [#47865](https://github.com/ClickHouse/ClickHouse/issues/47865) [#51306](https://github.com/ClickHouse/ClickHouse/pull/51306) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add a test for [#48894](https://github.com/ClickHouse/ClickHouse/issues/48894) [#51307](https://github.com/ClickHouse/ClickHouse/pull/51307) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Add a test for [#48676](https://github.com/ClickHouse/ClickHouse/issues/48676) [#51308](https://github.com/ClickHouse/ClickHouse/pull/51308) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix long test `functions_bad_arguments` [#51310](https://github.com/ClickHouse/ClickHouse/pull/51310) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Unify merge predicate [#51344](https://github.com/ClickHouse/ClickHouse/pull/51344) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix using locks in ProcessList [#51348](https://github.com/ClickHouse/ClickHouse/pull/51348) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Add a test for [#42631](https://github.com/ClickHouse/ClickHouse/issues/42631) [#51353](https://github.com/ClickHouse/ClickHouse/pull/51353) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix performance tests due to warnings from jemalloc about Per-CPU arena disabled [#51362](https://github.com/ClickHouse/ClickHouse/pull/51362) ([Azat Khuzhin](https://github.com/azat)).
+* Fix "merge_truncate_long" test [#51369](https://github.com/ClickHouse/ClickHouse/pull/51369) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Increase timeout of Fast Test [#51372](https://github.com/ClickHouse/ClickHouse/pull/51372) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix bad tests for DNS [#51374](https://github.com/ClickHouse/ClickHouse/pull/51374) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Attempt to fix the `relax_too_many_parts` test [#51375](https://github.com/ClickHouse/ClickHouse/pull/51375) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix MySQL test in Debug mode [#51376](https://github.com/ClickHouse/ClickHouse/pull/51376) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix bad test `01018_Distributed__shard_num` [#51377](https://github.com/ClickHouse/ClickHouse/pull/51377) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix "logical error" in addressToLineWithInlines [#51379](https://github.com/ClickHouse/ClickHouse/pull/51379) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix test 01280_ttl_where_group_by [#51380](https://github.com/ClickHouse/ClickHouse/pull/51380) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Attempt to fix `test_ssl_cert_authentication` [#51384](https://github.com/ClickHouse/ClickHouse/pull/51384) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Revert "Merge pull request [#50951](https://github.com/ClickHouse/ClickHouse/issues/50951) from ZhiguoZh/20230607-toyear-fix" [#51390](https://github.com/ClickHouse/ClickHouse/pull/51390) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Two tests are twice longer in average with Analyzer and sometimes failing [#51391](https://github.com/ClickHouse/ClickHouse/pull/51391) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix 00899_long_attach_memory_limit [#51395](https://github.com/ClickHouse/ClickHouse/pull/51395) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix test 01293_optimize_final_force [#51396](https://github.com/ClickHouse/ClickHouse/pull/51396) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix test 02481_parquet_list_monotonically_increasing_offsets [#51397](https://github.com/ClickHouse/ClickHouse/pull/51397) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix test 02497_trace_events_stress_long [#51398](https://github.com/ClickHouse/ClickHouse/pull/51398) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix broken labeling for `manual approve` [#51405](https://github.com/ClickHouse/ClickHouse/pull/51405) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fix parts lifetime in `MergeTreeTransaction` [#51407](https://github.com/ClickHouse/ClickHouse/pull/51407) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix flaky test test_skip_empty_files [#51409](https://github.com/ClickHouse/ClickHouse/pull/51409) ([Kruglov Pavel](https://github.com/Avogar)).
+* fix flacky test test_profile_events_s3 [#51412](https://github.com/ClickHouse/ClickHouse/pull/51412) ([Sema Checherinda](https://github.com/CheSema)).
+* Update README.md [#51413](https://github.com/ClickHouse/ClickHouse/pull/51413) ([Tyler Hannan](https://github.com/tylerhannan)).
+* Replace try/catch logic in hasTokenOrNull() by something more lightweight [#51425](https://github.com/ClickHouse/ClickHouse/pull/51425) ([Robert Schulze](https://github.com/rschu1ze)).
+* Add retries to `tlsv1_3` tests [#51434](https://github.com/ClickHouse/ClickHouse/pull/51434) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)).
+* Update exception message [#51440](https://github.com/ClickHouse/ClickHouse/pull/51440) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* fs cache: add check for intersecting ranges [#51444](https://github.com/ClickHouse/ClickHouse/pull/51444) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Slightly better code around packets for parallel replicas [#51451](https://github.com/ClickHouse/ClickHouse/pull/51451) ([Nikita Mikhaylov](https://github.com/nikitamikhaylov)).
+* Update system_warnings test [#51453](https://github.com/ClickHouse/ClickHouse/pull/51453) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Many fixes [#51455](https://github.com/ClickHouse/ClickHouse/pull/51455) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix test 01605_adaptive_granularity_block_borders [#51457](https://github.com/ClickHouse/ClickHouse/pull/51457) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Try fix flaky 02497_storage_file_reader_selection [#51468](https://github.com/ClickHouse/ClickHouse/pull/51468) ([Kruglov Pavel](https://github.com/Avogar)).
+* Try making Keeper in `DatabaseReplicated` tests more stable [#51473](https://github.com/ClickHouse/ClickHouse/pull/51473) ([Antonio Andelic](https://github.com/antonio2368)).
+* Convert 02003_memory_limit_in_client from expect to sh test (to fix flakiness) [#51475](https://github.com/ClickHouse/ClickHouse/pull/51475) ([Azat Khuzhin](https://github.com/azat)).
+* Fix test_disk_over_web_server [#51476](https://github.com/ClickHouse/ClickHouse/pull/51476) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Delay shutdown of system and temporary databases [#51479](https://github.com/ClickHouse/ClickHouse/pull/51479) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix memory leakage in CompressionCodecDeflateQpl [#51480](https://github.com/ClickHouse/ClickHouse/pull/51480) ([Vitaly Baranov](https://github.com/vitlibar)).
+* Increase retries in test_multiple_disks/test.py::test_start_stop_moves [#51482](https://github.com/ClickHouse/ClickHouse/pull/51482) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix race in BoundedReadBuffer [#51484](https://github.com/ClickHouse/ClickHouse/pull/51484) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix flaky unit test [#51485](https://github.com/ClickHouse/ClickHouse/pull/51485) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix flaky test `test_host_regexp_multiple_ptr_records` [#51506](https://github.com/ClickHouse/ClickHouse/pull/51506) ([Nikolay Degterinsky](https://github.com/evillique)).
+* Add a comment [#51517](https://github.com/ClickHouse/ClickHouse/pull/51517) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Make `test_ssl_cert_authentication` similar to `test_tlvs1_3` [#51520](https://github.com/ClickHouse/ClickHouse/pull/51520) ([János Benjamin Antal](https://github.com/antaljanosbenjamin)).
+* Fix duplicate storage set logical error. [#51521](https://github.com/ClickHouse/ClickHouse/pull/51521) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+* Update test_storage_postgresql/test.py::test_concurrent_queries [#51523](https://github.com/ClickHouse/ClickHouse/pull/51523) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix FATAL: query context is not detached from thread group [#51540](https://github.com/ClickHouse/ClickHouse/pull/51540) ([Igor Nikonov](https://github.com/devcrafter)).
+* Update version_date.tsv and changelogs after v23.3.6.7-lts [#51548](https://github.com/ClickHouse/ClickHouse/pull/51548) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Decoupled commits from [#51180](https://github.com/ClickHouse/ClickHouse/issues/51180) for backports [#51561](https://github.com/ClickHouse/ClickHouse/pull/51561) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Try to fix deadlock in ZooKeeper client [#51563](https://github.com/ClickHouse/ClickHouse/pull/51563) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Retry chroot creation in ZK before stateless tests [#51585](https://github.com/ClickHouse/ClickHouse/pull/51585) ([Antonio Andelic](https://github.com/antonio2368)).
+* use timeout instead trap in 01443_merge_truncate_long.sh [#51593](https://github.com/ClickHouse/ClickHouse/pull/51593) ([Sema Checherinda](https://github.com/CheSema)).
+* Update version_date.tsv and changelogs after v23.5.4.25-stable [#51604](https://github.com/ClickHouse/ClickHouse/pull/51604) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Fix MergeTreeMarksLoader segfaulting if marks file is longer than expected [#51636](https://github.com/ClickHouse/ClickHouse/pull/51636) ([Michael Kolupaev](https://github.com/al13n321)).
+* Update version_date.tsv and changelogs after v23.4.5.22-stable [#51638](https://github.com/ClickHouse/ClickHouse/pull/51638) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update version_date.tsv and changelogs after v23.3.7.5-lts [#51639](https://github.com/ClickHouse/ClickHouse/pull/51639) ([robot-clickhouse](https://github.com/robot-clickhouse)).
+* Update parts.md [#51643](https://github.com/ClickHouse/ClickHouse/pull/51643) ([Ramazan Polat](https://github.com/ramazanpolat)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 4ca5d1d7497..2a098d8c1da 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,3 +1,4 @@
+v23.6.1.1524-stable	2023-06-30
 v23.5.4.25-stable	2023-06-29
 v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10

From 3f29bd1bd42f7ebff737d2196c285aa7be4c6989 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Fri, 30 Jun 2023 18:20:59 +0200
Subject: [PATCH 1442/1478] Try fix test

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

diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
index b9f9548a7b3..509d1a635b1 100755
--- a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest, no-parallel, no-random-settings
+# Tags: no-fasttest, no-parallel, no-random-settings, no-random-merge-tree-settings
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 32aa66922a5bd26b4ced763130a8a401516c365f Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Fri, 30 Jun 2023 18:31:46 +0200
Subject: [PATCH 1443/1478] Update 02808_custom_disk_with_user_defined_name.sh

---
 .../0_stateless/02808_custom_disk_with_user_defined_name.sh     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
index 3fbcde66add..a43cd6deb9e 100755
--- a/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
+++ b/tests/queries/0_stateless/02808_custom_disk_with_user_defined_name.sh
@@ -25,7 +25,7 @@ $CLICKHOUSE_CLIENT -nm --query """
 DROP TABLE IF EXISTS test;
 CREATE TABLE test (a Int32, b String)
 ENGINE = MergeTree() ORDER BY tuple()
-SETTINGS disk = disk_$disk_name(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3disk);
+SETTINGS disk = disk_$disk_name(type = cache, max_size = '100Ki', path = ${CLICKHOUSE_TEST_UNIQUE_NAME}, disk = s3_disk);
 """
 
 $CLICKHOUSE_CLIENT -nm --query """

From fe17a9b589a5bae6e2608fe101558fdcbd761107 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Fri, 30 Jun 2023 19:36:32 +0200
Subject: [PATCH 1444/1478] do not log aborted for pending mutate/merge when
 shutdown

---
 src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index b569fa73a73..d4f8d1140a2 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -182,7 +182,6 @@ void MergeTreeBackgroundExecutor<Queue>::removeTasksCorrespondingToStorage(Stora
         }
         catch (...)
         {
-            printExceptionWithRespectToAbort(log);
             pending.remove(id);
         }
 

From 4511213a1f61ae7d67c8c44b6bab0ff3fe6ebaaa Mon Sep 17 00:00:00 2001
From: Julio Jimenez <julio@clickhouse.com>
Date: Fri, 30 Jun 2023 13:52:22 -0400
Subject: [PATCH 1445/1478] job successful

Signed-off-by: Julio Jimenez <julio@clickhouse.com>
---
 .github/workflows/nightly.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
index 3f6d9b86fd6..cf61012f2bc 100644
--- a/.github/workflows/nightly.yml
+++ b/.github/workflows/nightly.yml
@@ -121,8 +121,6 @@ jobs:
           docker ps --all --quiet | xargs --no-run-if-empty docker rm -f ||:
           sudo rm -fr "$TEMP_PATH" "$CACHES_PATH"
   SonarCloud:
-    # TODO: Remove if: whenever SonarCloud supports c++23
-    # if: ${{ false }}
     runs-on: [self-hosted, builder]
     env:
       SONAR_SCANNER_VERSION: 4.8.0.2856

From 5d652c4fd5befcaabfdf0fd6c7f1beec160708b3 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Fri, 30 Jun 2023 20:30:50 +0000
Subject: [PATCH 1446/1478] Finalize ColumnObject with only default values

---
 src/Columns/ColumnObject.cpp                       | 14 ++------------
 src/Processors/QueryPlan/AggregatingStep.cpp       |  2 ++
 ...02789_object_type_invalid_num_of_rows.reference |  1 +
 3 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/src/Columns/ColumnObject.cpp b/src/Columns/ColumnObject.cpp
index 4fa0c3ee41a..07872774559 100644
--- a/src/Columns/ColumnObject.cpp
+++ b/src/Columns/ColumnObject.cpp
@@ -626,9 +626,6 @@ ColumnObject::ColumnObject(Subcolumns && subcolumns_, bool is_nullable_)
 
 void ColumnObject::checkConsistency() const
 {
-    if (num_rows && subcolumns.empty())
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "ColumnObject is inconsistent: it has no subcolumns, but has {} rows", num_rows);
-
     if (subcolumns.empty())
         return;
 
@@ -645,9 +642,9 @@ void ColumnObject::checkConsistency() const
 
 size_t ColumnObject::size() const
 {
-// #ifndef NDEBUG
+#ifndef NDEBUG
     checkConsistency();
-// #endif
+#endif
     return num_rows;
 }
 
@@ -714,8 +711,6 @@ void ColumnObject::insert(const Field & field)
     }
 
     ++num_rows;
-
-    checkConsistency();
 }
 
 void ColumnObject::insertDefault()
@@ -724,8 +719,6 @@ void ColumnObject::insertDefault()
         entry->data.insertDefault();
 
     ++num_rows;
-
-    checkConsistency();
 }
 
 Field ColumnObject::operator[](size_t n) const
@@ -783,8 +776,6 @@ void ColumnObject::insertRangeFrom(const IColumn & src, size_t start, size_t len
 
     num_rows += length;
     finalize();
-
-    checkConsistency();
 }
 
 void ColumnObject::popBack(size_t length)
@@ -793,7 +784,6 @@ void ColumnObject::popBack(size_t length)
         entry->data.popBack(length);
 
     num_rows -= length;
-    checkConsistency();
 }
 
 template <typename Func>
diff --git a/src/Processors/QueryPlan/AggregatingStep.cpp b/src/Processors/QueryPlan/AggregatingStep.cpp
index 4ac972e2a79..eebbfc04304 100644
--- a/src/Processors/QueryPlan/AggregatingStep.cpp
+++ b/src/Processors/QueryPlan/AggregatingStep.cpp
@@ -319,6 +319,8 @@ void AggregatingStep::transformPipeline(QueryPipelineBuilder & pipeline, const B
                     {
                         auto column_with_default = col.column->cloneEmpty();
                         col.type->insertDefaultInto(*column_with_default);
+                        column_with_default->finalize();
+
                         auto column = ColumnConst::create(std::move(column_with_default), 0);
                         const auto * node = &dag->addColumn({ColumnPtr(std::move(column)), col.type, col.name});
                         node = &dag->materializeNode(*node);
diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
index e69de29bb2d..7dec35f7acb 100644
--- a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
+++ b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
@@ -0,0 +1 @@
+0.02

From 5e1cfb05318b8d3d511208146db020ae560e2ff7 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Sat, 1 Jul 2023 08:53:23 +0000
Subject: [PATCH 1447/1478] Avoid copying block if optimize_on_insert is false

---
 src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index a13a96ac65e..adb162b9fe7 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -452,7 +452,7 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
         if constexpr (async_insert)
         {
             /// we copy everything but offsets which we move because they are only used by async insert
-            if (storage.writer.getMergingMode() != MergeTreeData::MergingParams::Mode::Ordinary)
+            if (settings.optimize_on_insert && storage.writer.getMergingMode() != MergeTreeData::MergingParams::Mode::Ordinary)
                 unmerged_block.emplace(Block(current_block.block), Row(current_block.partition), std::move(current_block.offsets));
         }
 

From a830ba399bd6979ab93646cd4fba6c7daf060b12 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Thu, 29 Jun 2023 16:20:54 +0200
Subject: [PATCH 1448/1478] Repro test

---
 .../02809_prewhere_and_in.reference           |  8 +++
 .../0_stateless/02809_prewhere_and_in.sql     | 56 +++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 tests/queries/0_stateless/02809_prewhere_and_in.reference
 create mode 100644 tests/queries/0_stateless/02809_prewhere_and_in.sql

diff --git a/tests/queries/0_stateless/02809_prewhere_and_in.reference b/tests/queries/0_stateless/02809_prewhere_and_in.reference
new file mode 100644
index 00000000000..fb713be9991
--- /dev/null
+++ b/tests/queries/0_stateless/02809_prewhere_and_in.reference
@@ -0,0 +1,8 @@
+PREWHERE a IN ((
+PREWHERE a IN (1, 2, 3)
+PREWHERE a IN (t_02809_set)
+PREWHERE a IN (t_02809_aux)
+PREWHERE b NOT IN ((
+PREWHERE b NOT IN (1, 2, 3)
+PREWHERE b NOT IN (t_02809_set)
+PREWHERE b NOT IN (t_02809_aux)
diff --git a/tests/queries/0_stateless/02809_prewhere_and_in.sql b/tests/queries/0_stateless/02809_prewhere_and_in.sql
new file mode 100644
index 00000000000..d2816cd5b52
--- /dev/null
+++ b/tests/queries/0_stateless/02809_prewhere_and_in.sql
@@ -0,0 +1,56 @@
+DROP TABLE IF EXISTS t_02809;
+
+CREATE TABLE t_02809(a Int64, b Int64, s String)
+ENGINE=MergeTree order by tuple()
+AS SELECT number, number%10, toString(arrayMap(i-> cityHash64(i*number), range(50))) FROM numbers(10000);
+
+CREATE TABLE t_02809_set(c Int64)
+ENGINE=Set()
+AS SELECT * FROM numbers(10);
+
+CREATE TABLE t_02809_aux(c Int64)
+ENGINE=Memory()
+AS SELECT * FROM numbers(10);
+
+
+SET optimize_move_to_prewhere=1;
+
+-- Queries with 'IN'
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE a IN (SELECT * FROM system.one)
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE a IN (1,2,3)
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE a IN t_02809_set
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE a IN t_02809_aux
+) WHERE explain LIKE '%WHERE%';
+
+
+-- Queries with 'NOT IN'
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE b NOT IN (SELECT * FROM system.one)
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE b NOT IN (1,2,3)
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE b NOT IN t_02809_set
+) WHERE explain LIKE '%WHERE%';
+
+SELECT * FROM (EXPLAIN SYNTAX
+     SELECT * FROM t_02809 WHERE b NOT IN t_02809_aux
+) WHERE explain LIKE '%WHERE%';
+
+
+DROP TABLE t_02809;
+DROP TABLE t_02809_set;
+DROP TABLE t_02809_aux;

From 05d399c0b34cd7a2e13cabbc1fd396f2b251fedb Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Thu, 29 Jun 2023 16:25:52 +0200
Subject: [PATCH 1449/1478] Handle subqueries and sets when collecting table
 columns

---
 .../MergeTree/MergeTreeWhereOptimizer.cpp         |  3 +++
 src/Storages/MergeTree/RPNBuilder.cpp             | 15 +++++++++++++++
 src/Storages/MergeTree/RPNBuilder.h               |  2 ++
 3 files changed, 20 insertions(+)

diff --git a/src/Storages/MergeTree/MergeTreeWhereOptimizer.cpp b/src/Storages/MergeTree/MergeTreeWhereOptimizer.cpp
index 25a4579c73e..1620ba98d58 100644
--- a/src/Storages/MergeTree/MergeTreeWhereOptimizer.cpp
+++ b/src/Storages/MergeTree/MergeTreeWhereOptimizer.cpp
@@ -110,6 +110,9 @@ static void collectColumns(const RPNBuilderTreeNode & node, const NameSet & colu
     if (node.isConstant())
         return;
 
+    if (node.isSubqueryOrSet())
+        return;
+
     if (!node.isFunction())
     {
         auto column_name = node.getColumnName();
diff --git a/src/Storages/MergeTree/RPNBuilder.cpp b/src/Storages/MergeTree/RPNBuilder.cpp
index 0b42111be45..a0c96c13d59 100644
--- a/src/Storages/MergeTree/RPNBuilder.cpp
+++ b/src/Storages/MergeTree/RPNBuilder.cpp
@@ -181,6 +181,21 @@ bool RPNBuilderTreeNode::isConstant() const
     }
 }
 
+bool RPNBuilderTreeNode::isSubqueryOrSet() const
+{
+    if (ast_node)
+    {
+        return
+            typeid_cast<const ASTSubquery *>(ast_node) ||
+            typeid_cast<const ASTTableIdentifier *>(ast_node);
+    }
+    else
+    {
+        const auto * node_without_alias = getNodeWithoutAlias(dag_node);
+        return node_without_alias->result_type->getTypeId() == TypeIndex::Set;
+    }
+}
+
 ColumnWithTypeAndName RPNBuilderTreeNode::getConstantColumn() const
 {
     if (!isConstant())
diff --git a/src/Storages/MergeTree/RPNBuilder.h b/src/Storages/MergeTree/RPNBuilder.h
index 6f624d93cd6..9eeb6deefd5 100644
--- a/src/Storages/MergeTree/RPNBuilder.h
+++ b/src/Storages/MergeTree/RPNBuilder.h
@@ -98,6 +98,8 @@ public:
     /// Is node constant
     bool isConstant() const;
 
+    bool isSubqueryOrSet() const;
+
     /** Get constant as constant column.
       * Node must be constant before calling these method, otherwise logical exception is thrown.
       */

From f36f981f15f0a7aed86762c32ee706ccaa415df9 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Fri, 30 Jun 2023 18:22:47 +0200
Subject: [PATCH 1450/1478] Move adding CreateSets to the end of optimizations,
 after applying key conditions and indexes

---
 .../QueryPlan/Optimizations/Optimizations.h   |  3 ++
 .../optimizePrimaryKeyCondition.cpp           |  2 --
 .../QueryPlan/Optimizations/optimizeTree.cpp  | 31 ++++++++++++++++++-
 src/Processors/QueryPlan/QueryPlan.cpp        |  1 +
 .../QueryPlan/ReadFromMergeTree.cpp           |  9 ++----
 src/Processors/QueryPlan/ReadFromMergeTree.h  |  2 +-
 .../QueryPlan/SourceStepWithFilter.h          |  3 +-
 .../System/StorageSystemZooKeeper.cpp         |  4 +--
 8 files changed, 42 insertions(+), 13 deletions(-)

diff --git a/src/Processors/QueryPlan/Optimizations/Optimizations.h b/src/Processors/QueryPlan/Optimizations/Optimizations.h
index 2b934ec440b..bc47413cbb5 100644
--- a/src/Processors/QueryPlan/Optimizations/Optimizations.h
+++ b/src/Processors/QueryPlan/Optimizations/Optimizations.h
@@ -14,6 +14,9 @@ namespace QueryPlanOptimizations
 void optimizeTreeFirstPass(const QueryPlanOptimizationSettings & settings, QueryPlan::Node & root, QueryPlan::Nodes & nodes);
 /// Second pass is used to apply read-in-order and attach a predicate to PK.
 void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_settings, QueryPlan::Node & root, QueryPlan::Nodes & nodes);
+/// Third pass is used to apply filters such as key conditions and skip indexes to the storages that support them.
+/// After that it add CreateSetsStep for the subqueries that has not be used in the filters.
+void optimizeTreeThirdPass(QueryPlan::Node & root, QueryPlan::Nodes & nodes);
 
 /// Optimization (first pass) is a function applied to QueryPlan::Node.
 /// It can read and update subtree of specified node.
diff --git a/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp b/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
index 5ef786ff975..e98386a6ee9 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizePrimaryKeyCondition.cpp
@@ -28,8 +28,6 @@ void optimizePrimaryKeyCondition(const Stack & stack)
         else
             break;
     }
-
-    source_step_with_filter->onAddFilterFinish();
 }
 
 }
diff --git a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
index d620170e29c..e788918703e 100644
--- a/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
+++ b/src/Processors/QueryPlan/Optimizations/optimizeTree.cpp
@@ -167,7 +167,6 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
         optimizePrewhere(stack, nodes);
         optimizePrimaryKeyCondition(stack);
         enableMemoryBoundMerging(*stack.back().node, nodes);
-        addPlansForSets(*stack.back().node, nodes);
 
         stack.pop_back();
     }
@@ -178,5 +177,35 @@ void optimizeTreeSecondPass(const QueryPlanOptimizationSettings & optimization_s
             "No projection is used when optimize_use_projections = 1 and force_optimize_projection = 1");
 }
 
+void optimizeTreeThirdPass(QueryPlan::Node & root, QueryPlan::Nodes & nodes)
+{
+    Stack stack;
+    stack.push_back({.node = &root});
+
+    while (!stack.empty())
+    {
+        /// NOTE: frame cannot be safely used after stack was modified.
+        auto & frame = stack.back();
+
+        /// Traverse all children first.
+        if (frame.next_child < frame.node->children.size())
+        {
+            auto next_frame = Frame{.node = frame.node->children[frame.next_child]};
+            ++frame.next_child;
+            stack.push_back(next_frame);
+            continue;
+        }
+
+        if (auto * source_step_with_filter = dynamic_cast<SourceStepWithFilter *>(frame.node->step.get()))
+        {
+            source_step_with_filter->applyFilters();
+        }
+
+        addPlansForSets(*frame.node, nodes);
+
+        stack.pop_back();
+    }
+}
+
 }
 }
diff --git a/src/Processors/QueryPlan/QueryPlan.cpp b/src/Processors/QueryPlan/QueryPlan.cpp
index cb732e58855..687260441ff 100644
--- a/src/Processors/QueryPlan/QueryPlan.cpp
+++ b/src/Processors/QueryPlan/QueryPlan.cpp
@@ -482,6 +482,7 @@ void QueryPlan::optimize(const QueryPlanOptimizationSettings & optimization_sett
 
     QueryPlanOptimizations::optimizeTreeFirstPass(optimization_settings, *root, nodes);
     QueryPlanOptimizations::optimizeTreeSecondPass(optimization_settings, *root, nodes);
+    QueryPlanOptimizations::optimizeTreeThirdPass(*root, nodes);
 
     updateDataStreams(*root);
 }
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 1e21d13e2b1..e7bf1ce2edf 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1299,13 +1299,10 @@ static void buildIndexes(
     indexes->skip_indexes = std::move(skip_indexes);
 }
 
-void ReadFromMergeTree::onAddFilterFinish()
+void ReadFromMergeTree::applyFilters()
 {
-    if (!filter_nodes.nodes.empty())
-    {
-        auto filter_actions_dag = buildFilterDAG(context, prewhere_info, filter_nodes, query_info);
-        buildIndexes(indexes, filter_actions_dag, data, context, query_info, metadata_for_reading);
-    }
+    auto filter_actions_dag = buildFilterDAG(context, prewhere_info, filter_nodes, query_info);
+    buildIndexes(indexes, filter_actions_dag, data, context, query_info, metadata_for_reading);
 }
 
 MergeTreeDataSelectAnalysisResultPtr ReadFromMergeTree::selectRangesToRead(
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index 06021cb1c5b..3e3edd4dc5c 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -226,7 +226,7 @@ public:
     size_t getNumStreams() const { return requested_num_streams; }
     bool isParallelReadingEnabled() const { return read_task_callback != std::nullopt; }
 
-    void onAddFilterFinish() override;
+    void applyFilters() override;
 
 private:
     static MergeTreeDataSelectAnalysisResultPtr selectRangesToReadImpl(
diff --git a/src/Processors/QueryPlan/SourceStepWithFilter.h b/src/Processors/QueryPlan/SourceStepWithFilter.h
index 34b6e3c6a7b..dbaff06fde6 100644
--- a/src/Processors/QueryPlan/SourceStepWithFilter.h
+++ b/src/Processors/QueryPlan/SourceStepWithFilter.h
@@ -37,7 +37,8 @@ public:
         filter_dags.push_back(std::move(filter_dag));
     }
 
-    virtual void onAddFilterFinish() {}
+    /// Apply filters that can optimize reading from storage.
+    virtual void applyFilters() {}
 
 protected:
     std::vector<ActionsDAGPtr> filter_dags;
diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index d361a4173c1..4d7f59b8ccd 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -184,7 +184,7 @@ public:
 
     void initializePipeline(QueryPipelineBuilder & pipeline, const BuildQueryPipelineSettings & settings) override;
 
-    void onAddFilterFinish() override;
+    void applyFilters() override;
 
 private:
     void fillData(MutableColumns & res_columns);
@@ -421,7 +421,7 @@ static Paths extractPath(const ActionsDAG::NodeRawConstPtrs & filter_nodes, Cont
 }
 
 
-void ReadFromSystemZooKeeper::onAddFilterFinish()
+void ReadFromSystemZooKeeper::applyFilters()
 {
     paths = extractPath(getFilterNodes().nodes, context, context->getSettingsRef().allow_unrestricted_reads_from_keeper);
 }

From 9f53c48636f511d00187e1c80547b0ff236bcd39 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Sat, 1 Jul 2023 09:19:54 +0200
Subject: [PATCH 1451/1478] Fix test with analyzer

---
 .../0_stateless/02809_prewhere_and_in.reference  | 16 ++++++++--------
 .../0_stateless/02809_prewhere_and_in.sql        | 16 ++++++++--------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/tests/queries/0_stateless/02809_prewhere_and_in.reference b/tests/queries/0_stateless/02809_prewhere_and_in.reference
index fb713be9991..3080ae862bb 100644
--- a/tests/queries/0_stateless/02809_prewhere_and_in.reference
+++ b/tests/queries/0_stateless/02809_prewhere_and_in.reference
@@ -1,8 +1,8 @@
-PREWHERE a IN ((
-PREWHERE a IN (1, 2, 3)
-PREWHERE a IN (t_02809_set)
-PREWHERE a IN (t_02809_aux)
-PREWHERE b NOT IN ((
-PREWHERE b NOT IN (1, 2, 3)
-PREWHERE b NOT IN (t_02809_set)
-PREWHERE b NOT IN (t_02809_aux)
+PREWHERE a IN
+PREWHERE a IN
+PREWHERE a IN
+PREWHERE a IN
+PREWHERE b NOT IN
+PREWHERE b NOT IN
+PREWHERE b NOT IN
+PREWHERE b NOT IN
diff --git a/tests/queries/0_stateless/02809_prewhere_and_in.sql b/tests/queries/0_stateless/02809_prewhere_and_in.sql
index d2816cd5b52..345577d6c7c 100644
--- a/tests/queries/0_stateless/02809_prewhere_and_in.sql
+++ b/tests/queries/0_stateless/02809_prewhere_and_in.sql
@@ -16,37 +16,37 @@ AS SELECT * FROM numbers(10);
 SET optimize_move_to_prewhere=1;
 
 -- Queries with 'IN'
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 13) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE a IN (SELECT * FROM system.one)
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 13) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE a IN (1,2,3)
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 13) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE a IN t_02809_set
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 13) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE a IN t_02809_aux
 ) WHERE explain LIKE '%WHERE%';
 
 
 -- Queries with 'NOT IN'
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 17) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE b NOT IN (SELECT * FROM system.one)
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 17) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE b NOT IN (1,2,3)
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 17) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE b NOT IN t_02809_set
 ) WHERE explain LIKE '%WHERE%';
 
-SELECT * FROM (EXPLAIN SYNTAX
+SELECT substring(explain, 1, 17) FROM (EXPLAIN SYNTAX
      SELECT * FROM t_02809 WHERE b NOT IN t_02809_aux
 ) WHERE explain LIKE '%WHERE%';
 

From c06afc53b4a37c526eb8b628b4102785baedee11 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Sun, 2 Jul 2023 09:52:50 +0000
Subject: [PATCH 1452/1478] Make scripts backwards compatible

---
 docker/test/stateless/run.sh | 20 ++++++++++++++++++--
 tests/ci/utils.lib           |  4 ++++
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index 7ccedb8c0b3..fe53925ecc8 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -19,7 +19,7 @@ ln -s /usr/share/clickhouse-test/clickhouse-test /usr/bin/clickhouse-test
 source /usr/share/clickhouse-test/ci/attach_gdb.lib || true  # FIXME: to not break old builds, clean on 2023-09-01
 
 # shellcheck disable=SC1091
-source /usr/share/clickhouse-test/ci/utils.lib
+source /usr/share/clickhouse-test/ci/utils.lib || true # FIXME: to not break old builds, clean on 2023-09-01
 
 # install test configs
 /usr/share/clickhouse-test/config/install.sh
@@ -93,6 +93,22 @@ sleep 5
 
 attach_gdb_to_clickhouse || true  # FIXME: to not break old builds, clean on 2023-09-01
 
+function fn_exists() {
+    declare -F "$1" > /dev/null;
+}
+
+# FIXME: to not break old builds, clean on 2023-09-01
+function try_run_with_retry() {
+    local total_retries="$1"
+    shift
+
+    if fn_exists run_with_retry; then
+        run_with_retry "$total_retries" "$@"
+    else
+        "$@"
+    fi
+}
+
 function run_tests()
 {
     set -x
@@ -140,7 +156,7 @@ function run_tests()
 
     ADDITIONAL_OPTIONS+=('--report-logs-stats')
 
-    run_with_retry 10 clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')"
+    try_run_with_retry 10 clickhouse-client -q "insert into system.zookeeper (name, path, value) values ('auxiliary_zookeeper2', '/test/chroot/', '')"
 
     set +e
     clickhouse-test --testname --shard --zookeeper --check-zookeeper-session --hung-check --print-time \
diff --git a/tests/ci/utils.lib b/tests/ci/utils.lib
index 95ad50f635b..b5ce4ae0d78 100644
--- a/tests/ci/utils.lib
+++ b/tests/ci/utils.lib
@@ -22,4 +22,8 @@ function run_with_retry()
 
     echo "Command '$*' failed after $total_retries retries, exiting"
     exit 1
+}
+
+function fn_exists() {
+    declare -F "$1" > /dev/null;
 }
\ No newline at end of file

From d85f5cc4cf46aed7419feb82dffa085b392f6bff Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 2 Jul 2023 18:02:14 +0200
Subject: [PATCH 1453/1478] Fix 02116_tuple_element with Analyzer (#51669)

* Fix 02116_tuple_element with Analyzer

* Use alternative errors in test

---------

Co-authored-by: Alexander Tokmakov <tavplubix@clickhouse.com>
---
 tests/queries/0_stateless/02116_tuple_element.sql | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/02116_tuple_element.sql b/tests/queries/0_stateless/02116_tuple_element.sql
index bedfedd7c2d..97f6c049705 100644
--- a/tests/queries/0_stateless/02116_tuple_element.sql
+++ b/tests/queries/0_stateless/02116_tuple_element.sql
@@ -17,8 +17,8 @@ EXPLAIN SYNTAX SELECT tupleElement(t1, 'a') FROM t_tuple_element;
 SELECT tupleElement(number, 1) FROM numbers(1); -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
 SELECT tupleElement(t1) FROM t_tuple_element; -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
 SELECT tupleElement(t1, 'b') FROM t_tuple_element; -- { serverError NOT_FOUND_COLUMN_IN_BLOCK, UNKNOWN_IDENTIFIER }
-SELECT tupleElement(t1, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
-SELECT tupleElement(t1, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t1, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX, NOT_FOUND_COLUMN_IN_BLOCK }
+SELECT tupleElement(t1, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX, NOT_FOUND_COLUMN_IN_BLOCK }
 SELECT tupleElement(t1, materialize('a')) FROM t_tuple_element; -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
 
 SELECT t2.1 FROM t_tuple_element;
@@ -29,8 +29,8 @@ EXPLAIN SYNTAX SELECT tupleElement(t2, 1) FROM t_tuple_element;
 
 SELECT tupleElement(t2) FROM t_tuple_element; -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
 SELECT tupleElement(t2, 'a') FROM t_tuple_element; -- { serverError NOT_FOUND_COLUMN_IN_BLOCK, UNKNOWN_IDENTIFIER }
-SELECT tupleElement(t2, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
-SELECT tupleElement(t2, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX }
+SELECT tupleElement(t2, 0) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX, NOT_FOUND_COLUMN_IN_BLOCK }
+SELECT tupleElement(t2, 3) FROM t_tuple_element; -- { serverError ILLEGAL_INDEX, NOT_FOUND_COLUMN_IN_BLOCK }
 SELECT tupleElement(t2, materialize(1)) FROM t_tuple_element; -- { serverError ILLEGAL_TYPE_OF_ARGUMENT }
 
 DROP TABLE t_tuple_element;

From 392b70d6f852a3e3912f4d2638da6f9a3fb7ddeb Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Sun, 2 Jul 2023 19:30:18 +0300
Subject: [PATCH 1454/1478] fix merge_selecting_task scheduling (#51591)

Co-authored-by: Alexey Milovidov <milovidov@clickhouse.com>
---
 src/Storages/MergeTree/MergeFromLogEntryTask.cpp      |  2 +-
 src/Storages/MergeTree/MergeTreeDataMergerMutator.cpp |  5 +++--
 src/Storages/MergeTree/MutateFromLogEntryTask.cpp     |  2 +-
 .../MergeTree/ReplicatedMergeMutateTaskBase.h         | 11 ++++++++---
 4 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
index f29d37312f9..17582e7df98 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
@@ -392,7 +392,7 @@ bool MergeFromLogEntryTask::finalize(ReplicatedMergeMutateTaskBase::PartLogWrite
     /** With `ZSESSIONEXPIRED` or `ZOPERATIONTIMEOUT`, we can inadvertently roll back local changes to the parts.
      * This is not a problem, because in this case the merge will remain in the queue, and we will try again.
      */
-    storage.merge_selecting_task->schedule();
+    finish_callback = [storage_ptr = &storage]() { storage_ptr->merge_selecting_task->schedule(); };
     ProfileEvents::increment(ProfileEvents::ReplicatedPartMerges);
 
     write_part_log({});
diff --git a/src/Storages/MergeTree/MergeTreeDataMergerMutator.cpp b/src/Storages/MergeTree/MergeTreeDataMergerMutator.cpp
index 29a1574b66e..c0acc401506 100644
--- a/src/Storages/MergeTree/MergeTreeDataMergerMutator.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataMergerMutator.cpp
@@ -239,8 +239,9 @@ MergeTreeDataMergerMutator::PartitionIdsHint MergeTreeDataMergerMutator::getPart
     if (!best_partition_id_to_optimize.empty())
         res.emplace(std::move(best_partition_id_to_optimize));
 
-    LOG_TRACE(log, "Checked {} partitions, found {} partitions with parts that may be merged: {}",
-              all_partition_ids.size(), res.size(), fmt::join(res, ", "));
+    LOG_TRACE(log, "Checked {} partitions, found {} partitions with parts that may be merged: [{}]"
+              "(max_total_size_to_merge={}, merge_with_ttl_allowed{})",
+              all_partition_ids.size(), res.size(), fmt::join(res, ", "), max_total_size_to_merge, merge_with_ttl_allowed);
     return res;
 }
 
diff --git a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
index 4c2def34e8a..ba55fb400ca 100644
--- a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
@@ -267,7 +267,7 @@ bool MutateFromLogEntryTask::finalize(ReplicatedMergeMutateTaskBase::PartLogWrit
     /** With `ZSESSIONEXPIRED` or `ZOPERATIONTIMEOUT`, we can inadvertently roll back local changes to the parts.
          * This is not a problem, because in this case the entry will remain in the queue, and we will try again.
          */
-    storage.merge_selecting_task->schedule();
+    finish_callback = [storage_ptr = &storage]() { storage_ptr->merge_selecting_task->schedule(); };
     ProfileEvents::increment(ProfileEvents::ReplicatedPartMutations);
     write_part_log({});
 
diff --git a/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.h b/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.h
index a7bf1290274..1e7f9834245 100644
--- a/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.h
+++ b/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.h
@@ -21,10 +21,10 @@ public:
         StorageReplicatedMergeTree & storage_,
         ReplicatedMergeTreeQueue::SelectedEntryPtr & selected_entry_,
         IExecutableTask::TaskResultCallback & task_result_callback_)
-        : selected_entry(selected_entry_)
+        : storage(storage_)
+        , selected_entry(selected_entry_)
         , entry(*selected_entry->log_entry)
         , log(log_)
-        , storage(storage_)
         /// This is needed to ask an asssignee to assign a new merge/mutate operation
         /// It takes bool argument and true means that current task is successfully executed.
         , task_result_callback(task_result_callback_)
@@ -52,13 +52,18 @@ protected:
     /// Will execute a part of inner MergeTask or MutateTask
     virtual bool executeInnerTask() = 0;
 
+    StorageReplicatedMergeTree & storage;
+
+    /// A callback to reschedule merge_selecting_task after destroying merge_mutate_entry
+    /// The order is important, because merge_selecting_task may rely on the number of entries in MergeList
+    scope_guard finish_callback;
+
     /// This is important not to execute the same mutation in parallel
     /// selected_entry is a RAII class, so the time of living must be the same as for the whole task
     ReplicatedMergeTreeQueue::SelectedEntryPtr selected_entry;
     ReplicatedMergeTreeLogEntry & entry;
     MergeList::EntryPtr merge_mutate_entry{nullptr};
     Poco::Logger * log;
-    StorageReplicatedMergeTree & storage;
     /// ProfileEvents for current part will be stored here
     ProfileEvents::Counters profile_counters;
     ContextMutablePtr task_context;

From aeea3dc8247fecc8f4be75c3330cce696bd054ba Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Mon, 3 Jul 2023 07:40:05 +0000
Subject: [PATCH 1455/1478] Add odbcinst dep to sqllogic docker

---
 docker/test/sqllogic/Dockerfile | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docker/test/sqllogic/Dockerfile b/docker/test/sqllogic/Dockerfile
index 83dcf7e1f56..5cf71e4d3f8 100644
--- a/docker/test/sqllogic/Dockerfile
+++ b/docker/test/sqllogic/Dockerfile
@@ -13,6 +13,7 @@ RUN apt-get update --yes \
             sqlite3 \
             unixodbc \
             unixodbc-dev \
+            odbcinst \
             sudo \
     && apt-get clean
 

From 292eec247058c6020c48d0d4c3ebd27784fed466 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Mon, 3 Jul 2023 09:40:36 +0200
Subject: [PATCH 1456/1478] Run cargo update to fix build with nightly

---
 rust/skim/Cargo.lock | 360 ++++++++++++++++++++++++++-----------------
 1 file changed, 218 insertions(+), 142 deletions(-)

diff --git a/rust/skim/Cargo.lock b/rust/skim/Cargo.lock
index badd22dad07..9f948ee1c38 100644
--- a/rust/skim/Cargo.lock
+++ b/rust/skim/Cargo.lock
@@ -14,13 +14,19 @@ dependencies = [
 
 [[package]]
 name = "aho-corasick"
-version = "0.7.20"
+version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cc936419f96fa211c1b9166887b38e5e40b19958e5b895be7c1f93adec7071ac"
+checksum = "43f6cb1bf222025340178f382c426f13757b2960e89779dfcb319c32542a5a41"
 dependencies = [
  "memchr",
 ]
 
+[[package]]
+name = "android-tzdata"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e999941b234f3131b00bc13c22d06e8c5ff726d1b6318ac7eb276997bbb4fef0"
+
 [[package]]
 name = "android_system_properties"
 version = "0.1.5"
@@ -32,9 +38,9 @@ dependencies = [
 
 [[package]]
 name = "arrayvec"
-version = "0.7.2"
+version = "0.7.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8da52d66c7071e2e3fa2a1e5c6d088fec47b593032b254f5e980de8ea54454d6"
+checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "atty"
@@ -42,7 +48,7 @@ version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d9b39be18770d11421cdb1b9947a45dd3f37e93092cbf377614828a319d5fee8"
 dependencies = [
- "hermit-abi",
+ "hermit-abi 0.1.19",
  "libc",
  "winapi",
 ]
@@ -67,15 +73,15 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bumpalo"
-version = "3.11.1"
+version = "3.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "572f695136211188308f16ad2ca5c851a712c464060ae6974944458eb83880ba"
+checksum = "a3e2c3daef883ecc1b5d58c15adae93470a91d425f3532ba1695849656af3fc1"
 
 [[package]]
 name = "cc"
-version = "1.0.77"
+version = "1.0.79"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e9f73505338f7d905b19d18738976aae232eb46b8efc15554ffc56deb5d9ebe4"
+checksum = "50d30906286121d95be3d479533b458f87493b30a4b5f79a607db8f5d11aa91f"
 
 [[package]]
 name = "cfg-if"
@@ -85,13 +91,13 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
 [[package]]
 name = "chrono"
-version = "0.4.23"
+version = "0.4.26"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16b0a3d9ed01224b22057780a37bb8c5dbfe1be8ba48678e7bf57ec4b385411f"
+checksum = "ec837a71355b28f6556dbd569b37b3f363091c0bd4b2e735674521b4c5fd9bc5"
 dependencies = [
+ "android-tzdata",
  "iana-time-zone",
  "js-sys",
- "num-integer",
  "num-traits",
  "time 0.1.45",
  "wasm-bindgen",
@@ -100,9 +106,9 @@ dependencies = [
 
 [[package]]
 name = "clap"
-version = "3.2.23"
+version = "3.2.25"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "71655c45cb9845d3270c9d6df84ebe72b4dad3c2ba3f7023ad47c144e4e473a5"
+checksum = "4ea181bf566f71cb9a5d17a59e1871af638180a18fb0035c92ae62b705207123"
 dependencies = [
  "atty",
  "bitflags",
@@ -135,9 +141,9 @@ dependencies = [
 
 [[package]]
 name = "core-foundation-sys"
-version = "0.8.3"
+version = "0.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5827cebf4670468b8772dd191856768aedcb1b0278a04f989f7766351917b9dc"
+checksum = "e496a50fda8aacccc86d7529e2c1e0892dbd0f898a6b5645b5561b89c3210efa"
 
 [[package]]
 name = "crossbeam"
@@ -155,9 +161,9 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-channel"
-version = "0.5.6"
+version = "0.5.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c2dd04ddaf88237dc3b8d8f9a3c1004b506b54b3313403944054d23c0870c521"
+checksum = "a33c2bf77f2df06183c3aa30d1e96c0695a313d4f9c453cc3762a6db39f99200"
 dependencies = [
  "cfg-if",
  "crossbeam-utils",
@@ -165,9 +171,9 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-deque"
-version = "0.8.2"
+version = "0.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "715e8152b692bba2d374b53d4875445368fdf21a94751410af607a5ac677d1fc"
+checksum = "ce6fd6f855243022dcecf8702fef0c297d4338e226845fe067f6341ad9fa0cef"
 dependencies = [
  "cfg-if",
  "crossbeam-epoch",
@@ -176,14 +182,14 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-epoch"
-version = "0.9.13"
+version = "0.9.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01a9af1f4c2ef74bb8aa1f7e19706bc72d03598c8a570bb5de72243c7a9d9d5a"
+checksum = "ae211234986c545741a7dc064309f67ee1e5ad243d0e48335adc0484d960bcc7"
 dependencies = [
  "autocfg",
  "cfg-if",
  "crossbeam-utils",
- "memoffset 0.7.1",
+ "memoffset 0.9.0",
  "scopeguard",
 ]
 
@@ -199,18 +205,18 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-utils"
-version = "0.8.14"
+version = "0.8.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fb766fa798726286dbbb842f174001dab8abc7b627a1dd86e0b7222a95d929f"
+checksum = "5a22b2d63d4d1dc0b7f1b6b2747dd0088008a9be28b6ddf0b1e7d335e3037294"
 dependencies = [
  "cfg-if",
 ]
 
 [[package]]
 name = "cxx"
-version = "1.0.83"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bdf07d07d6531bfcdbe9b8b739b104610c6508dcc4d63b410585faf338241daf"
+checksum = "e88abab2f5abbe4c56e8f1fb431b784d710b709888f35755a160e62e33fe38e8"
 dependencies = [
  "cc",
  "cxxbridge-flags",
@@ -220,9 +226,9 @@ dependencies = [
 
 [[package]]
 name = "cxx-build"
-version = "1.0.83"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d2eb5b96ecdc99f72657332953d4d9c50135af1bac34277801cc3937906ebd39"
+checksum = "5c0c11acd0e63bae27dcd2afced407063312771212b7a823b4fd72d633be30fb"
 dependencies = [
  "cc",
  "codespan-reporting",
@@ -230,31 +236,31 @@ dependencies = [
  "proc-macro2",
  "quote",
  "scratch",
- "syn",
+ "syn 2.0.23",
 ]
 
 [[package]]
 name = "cxxbridge-flags"
-version = "1.0.83"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac040a39517fd1674e0f32177648334b0f4074625b5588a64519804ba0553b12"
+checksum = "8d3816ed957c008ccd4728485511e3d9aaf7db419aa321e3d2c5a2f3411e36c8"
 
 [[package]]
 name = "cxxbridge-macro"
-version = "1.0.83"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1362b0ddcfc4eb0a1f57b68bd77dd99f0e826958a96abd0ae9bd092e114ffed6"
+checksum = "a26acccf6f445af85ea056362561a24ef56cdc15fcc685f03aec50b9c702cb6d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.23",
 ]
 
 [[package]]
 name = "darling"
-version = "0.14.2"
+version = "0.14.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b0dd3cd20dc6b5a876612a6e5accfe7f3dd883db6d07acfbf14c128f61550dfa"
+checksum = "7b750cb3417fd1b327431a470f388520309479ab0bf5e323505daf0290cd3850"
 dependencies = [
  "darling_core",
  "darling_macro",
@@ -262,27 +268,27 @@ dependencies = [
 
 [[package]]
 name = "darling_core"
-version = "0.14.2"
+version = "0.14.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a784d2ccaf7c98501746bf0be29b2022ba41fd62a2e622af997a03e9f972859f"
+checksum = "109c1ca6e6b7f82cc233a97004ea8ed7ca123a9af07a8230878fcfda9b158bf0"
 dependencies = [
  "fnv",
  "ident_case",
  "proc-macro2",
  "quote",
  "strsim",
- "syn",
+ "syn 1.0.109",
 ]
 
 [[package]]
 name = "darling_macro"
-version = "0.14.2"
+version = "0.14.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7618812407e9402654622dd402b0a89dff9ba93badd6540781526117b92aab7e"
+checksum = "a4aab4dbc9f7611d8b55048a3a16d2d010c2c8334e46304b40ac1cc14bf3b48e"
 dependencies = [
  "darling_core",
  "quote",
- "syn",
+ "syn 1.0.109",
 ]
 
 [[package]]
@@ -313,7 +319,7 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn",
+ "syn 1.0.109",
 ]
 
 [[package]]
@@ -323,7 +329,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8f0314b72bed045f3a68671b3c86328386762c93f82d98c65c3cb5e5f573dd68"
 dependencies = [
  "derive_builder_core",
- "syn",
+ "syn 1.0.109",
 ]
 
 [[package]]
@@ -349,9 +355,9 @@ dependencies = [
 
 [[package]]
 name = "either"
-version = "1.8.0"
+version = "1.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "90e5c1c8368803113bf0c9584fc495a58b86dc8a29edbf8fe877d21d9507e797"
+checksum = "7fcaabb2fef8c910e7f4c7ce9f67a1283a1715879a7c230ca9d6d1ae31f16d91"
 
 [[package]]
 name = "env_logger"
@@ -383,9 +389,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.8"
+version = "0.2.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c05aeb6a22b8f62540c194aac980f2115af067bfe15a0734d7277a768d396b31"
+checksum = "be4136b2a15dd319360be1c07d9933517ccf0be8f16bf62a3bee4f0d618df427"
 dependencies = [
  "cfg-if",
  "libc",
@@ -407,6 +413,12 @@ dependencies = [
  "libc",
 ]
 
+[[package]]
+name = "hermit-abi"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fed44880c466736ef9a5c5b5facefb5ed0785676d0c02d612db14e54f0d84286"
+
 [[package]]
 name = "humantime"
 version = "2.1.0"
@@ -415,26 +427,25 @@ checksum = "9a3a5bfb195931eeb336b2a7b4d761daec841b97f947d34394601737a7bba5e4"
 
 [[package]]
 name = "iana-time-zone"
-version = "0.1.53"
+version = "0.1.57"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "64c122667b287044802d6ce17ee2ddf13207ed924c712de9a66a5814d5b64765"
+checksum = "2fad5b825842d2b38bd206f3e81d6957625fd7f0a361e345c30e01a0ae2dd613"
 dependencies = [
  "android_system_properties",
  "core-foundation-sys",
  "iana-time-zone-haiku",
  "js-sys",
  "wasm-bindgen",
- "winapi",
+ "windows",
 ]
 
 [[package]]
 name = "iana-time-zone-haiku"
-version = "0.1.1"
+version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0703ae284fc167426161c2e3f1da3ea71d94b21bedbcc9494e92b28e334e3dca"
+checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
 dependencies = [
- "cxx",
- "cxx-build",
+ "cc",
 ]
 
 [[package]]
@@ -445,9 +456,9 @@ checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
 
 [[package]]
 name = "indexmap"
-version = "1.9.2"
+version = "1.9.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1885e79c1fc4b10f0e172c475f458b7f7b93061064d98c3293e98c5ba0c8b399"
+checksum = "bd070e393353796e801d209ad339e89596eb4c8d430d18ede6a1cced8fafbd99"
 dependencies = [
  "autocfg",
  "hashbrown",
@@ -455,9 +466,9 @@ dependencies = [
 
 [[package]]
 name = "js-sys"
-version = "0.3.60"
+version = "0.3.64"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49409df3e3bf0856b916e2ceaca09ee28e6871cf7d9ce97a692cacfdb2a25a47"
+checksum = "c5f195fe497f702db0f318b07fdd68edb16955aed830df8363d837542f8f935a"
 dependencies = [
  "wasm-bindgen",
 ]
@@ -470,27 +481,24 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.138"
+version = "0.2.147"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "db6d7e329c562c5dfab7a46a2afabc8b987ab9a4834c9d1ca04dc54c1546cef8"
+checksum = "b4668fb0ea861c1df094127ac5f1da3409a82116a4ba74fca2e58ef927159bb3"
 
 [[package]]
 name = "link-cplusplus"
-version = "1.0.7"
+version = "1.0.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9272ab7b96c9046fbc5bc56c06c117cb639fe2d509df0c421cad82d2915cf369"
+checksum = "ecd207c9c713c34f95a097a5b029ac2ce6010530c7b49d7fea24d977dede04f5"
 dependencies = [
  "cc",
 ]
 
 [[package]]
 name = "log"
-version = "0.4.17"
+version = "0.4.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "abb12e687cfb44aa40f41fc3978ef76448f9b6038cad6aef4259d3c095a2382e"
-dependencies = [
- "cfg-if",
-]
+checksum = "b06a4cde4c0f271a446782e3eff8de789548ce57dbc8eca9292c27f4a42004b4"
 
 [[package]]
 name = "memchr"
@@ -509,9 +517,9 @@ dependencies = [
 
 [[package]]
 name = "memoffset"
-version = "0.7.1"
+version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5de893c32cde5f383baa4c04c5d6dbdd735cfd4a794b0debdb2bb1b421da5ff4"
+checksum = "5a634b1c61a95585bd15607c6ab0c4e5b226e695ff2800ba0cdccddf208c406c"
 dependencies = [
  "autocfg",
 ]
@@ -541,16 +549,6 @@ dependencies = [
  "pin-utils",
 ]
 
-[[package]]
-name = "num-integer"
-version = "0.1.45"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "225d3389fb3509a24c93f5c29eb6bde2586b98d9f016636dff58d7c6f7569cd9"
-dependencies = [
- "autocfg",
- "num-traits",
-]
-
 [[package]]
 name = "num-traits"
 version = "0.2.15"
@@ -562,25 +560,25 @@ dependencies = [
 
 [[package]]
 name = "num_cpus"
-version = "1.14.0"
+version = "1.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6058e64324c71e02bc2b150e4f3bc8286db6c83092132ffa3f6b1eab0f9def5"
+checksum = "4161fcb6d602d4d2081af7c3a45852d875a03dd337a6bfdd6e06407b61342a43"
 dependencies = [
- "hermit-abi",
+ "hermit-abi 0.3.1",
  "libc",
 ]
 
 [[package]]
 name = "once_cell"
-version = "1.16.0"
+version = "1.18.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86f0b0d4bf799edbc74508c1e8bf170ff5f41238e5f8225603ca7caaae2b7860"
+checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d"
 
 [[package]]
 name = "os_str_bytes"
-version = "6.4.1"
+version = "6.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9b7820b9daea5457c9f21c69448905d723fbd21136ccf521748f23fd49e723ee"
+checksum = "4d5d9eb14b174ee9aa2ef96dc2b94637a2d4b6e7cb873c7e171f0c20c6cf3eac"
 
 [[package]]
 name = "pin-utils"
@@ -590,27 +588,27 @@ checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.47"
+version = "1.0.63"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5ea3d908b0e36316caf9e9e2c4625cdde190a7e6f440d794667ed17a1855e725"
+checksum = "7b368fba921b0dce7e60f5e04ec15e565b3303972b42bcfde1d0713b881959eb"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "quote"
-version = "1.0.21"
+version = "1.0.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbe448f377a7d6961e30f5955f9b8d106c3f5e449d493ee1b125c1d43c2b5179"
+checksum = "573015e8ab27661678357f27dc26460738fd2b6c86e46f386fde94cb5d913105"
 dependencies = [
  "proc-macro2",
 ]
 
 [[package]]
 name = "rayon"
-version = "1.6.1"
+version = "1.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6db3a213adf02b3bcfd2d3846bb41cb22857d131789e01df434fb7e7bc0759b7"
+checksum = "1d2df5196e37bcc87abebc0053e20787d73847bb33134a69841207dd0a47f03b"
 dependencies = [
  "either",
  "rayon-core",
@@ -618,9 +616,9 @@ dependencies = [
 
 [[package]]
 name = "rayon-core"
-version = "1.10.1"
+version = "1.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cac410af5d00ab6884528b4ab69d1e8e146e8d471201800fa1b4524126de6ad3"
+checksum = "4b8f95bd6966f5c87776639160a66bd8ab9895d9d4ab01ddba9fc60661aebe8d"
 dependencies = [
  "crossbeam-channel",
  "crossbeam-deque",
@@ -650,9 +648,9 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.7.0"
+version = "1.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e076559ef8e241f2ae3479e36f97bd5741c0330689e217ad51ce2c76808b868a"
+checksum = "d0ab3ca65655bb1e41f2a8c8cd662eb4fb035e67c3f78da1d61dffe89d07300f"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -661,15 +659,15 @@ dependencies = [
 
 [[package]]
 name = "regex-syntax"
-version = "0.6.28"
+version = "0.7.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "456c603be3e8d448b072f410900c09faf164fbce2d480456f50eea6e25f9c848"
+checksum = "436b050e76ed2903236f032a59761c1eb99e1b0aead2c257922771dab1fc8c78"
 
 [[package]]
 name = "rustversion"
-version = "1.0.9"
+version = "1.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97477e48b4cf8603ad5f7aaf897467cf42ab4218a38ef76fb14c2d6773a6d6a8"
+checksum = "4f3208ce4d8448b3f3e7d168a73f5e0c43a61e32930de3bceeccedb388b6bf06"
 
 [[package]]
 name = "scopeguard"
@@ -679,15 +677,15 @@ checksum = "d29ab0c6d3fc0ee92fe66e2d99f700eab17a8d57d1c1d3b748380fb20baa78cd"
 
 [[package]]
 name = "scratch"
-version = "1.0.2"
+version = "1.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c8132065adcfd6e02db789d9285a0deb2f3fcb04002865ab67d5fb103533898"
+checksum = "1792db035ce95be60c3f8853017b3999209281c24e2ba5bc8e59bf97a0c590c1"
 
 [[package]]
 name = "serde"
-version = "1.0.149"
+version = "1.0.164"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "256b9932320c590e707b94576e3cc1f7c9024d0ee6612dfbcf1cb106cbe8e055"
+checksum = "9e8c8cf938e98f769bc164923b06dce91cea1751522f46f8466461af04c9027d"
 
 [[package]]
 name = "shlex"
@@ -697,9 +695,9 @@ checksum = "43b2853a4d09f215c24cc5489c992ce46052d359b5109343cbafbf26bc62f8a3"
 
 [[package]]
 name = "skim"
-version = "0.10.2"
+version = "0.10.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cebed5f897cd6c0d80fbe30adb36c0abf7400e93043a63ae56458495642b3485"
+checksum = "e5d28de0a6cb2cdd83a076f1de9d965b973ae08b244df1aa70b432946dda0f32"
 dependencies = [
  "atty",
  "beef",
@@ -717,7 +715,7 @@ dependencies = [
  "rayon",
  "regex",
  "shlex",
- "time 0.3.17",
+ "time 0.3.22",
  "timer",
  "tuikit",
  "unicode-width",
@@ -732,9 +730,20 @@ checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"
 
 [[package]]
 name = "syn"
-version = "1.0.105"
+version = "1.0.109"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "60b9b43d45702de4c839cb9b51d9f529c5dd26a4aff255b42b1ebc03e88ee908"
+checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59fb7d6d8281a51045d62b8eb3a7d1ce347b76f312af50cd3dc0af39c87c1737"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -754,9 +763,9 @@ dependencies = [
 
 [[package]]
 name = "termcolor"
-version = "1.1.3"
+version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bab24d30b911b2376f3a13cc2cd443142f0c81dda04c118693e35b3835757755"
+checksum = "be55cf8942feac5c765c2c993422806843c9a9a45d4d5c407ad6dd2ea95eb9b6"
 dependencies = [
  "winapi-util",
 ]
@@ -769,30 +778,31 @@ checksum = "222a222a5bfe1bba4a77b45ec488a741b3cb8872e5e499451fd7d0129c9c7c3d"
 
 [[package]]
 name = "thiserror"
-version = "1.0.37"
+version = "1.0.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "10deb33631e3c9018b9baf9dcbbc4f737320d2b576bac10f6aefa048fa407e3e"
+checksum = "978c9a314bd8dc99be594bc3c175faaa9794be04a5a5e153caba6915336cebac"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.37"
+version = "1.0.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "982d17546b47146b28f7c22e3d08465f6b8903d0ea13c1660d9d84a6e7adcdbb"
+checksum = "f9456a42c5b0d803c8cd86e73dd7cc9edd429499f37a3550d286d5e86720569f"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.23",
 ]
 
 [[package]]
 name = "thread_local"
-version = "1.1.4"
+version = "1.1.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5516c27b78311c50bf42c071425c560ac799b11c30b31f87e3081965fe5e0180"
+checksum = "3fdd6f064ccff2d6567adcb3873ca630700f00b5ad3f060c25b5dcfd9a4ce152"
 dependencies = [
+ "cfg-if",
  "once_cell",
 ]
 
@@ -809,9 +819,9 @@ dependencies = [
 
 [[package]]
 name = "time"
-version = "0.3.17"
+version = "0.3.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a561bf4617eebd33bca6434b988f39ed798e527f51a1e797d0ee4f61c0a38376"
+checksum = "ea9e1b3cf1243ae005d9e74085d4d542f3125458f3a81af210d901dcd7411efd"
 dependencies = [
  "serde",
  "time-core",
@@ -819,9 +829,9 @@ dependencies = [
 
 [[package]]
 name = "time-core"
-version = "0.1.0"
+version = "0.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2e153e1f1acaef8acc537e68b44906d2db6436e2b35ac2c6b42640fff91f00fd"
+checksum = "7300fbefb4dadc1af235a9cef3737cea692a9d97e1b9cbcd4ebdae6f8868e6fb"
 
 [[package]]
 name = "timer"
@@ -848,9 +858,9 @@ dependencies = [
 
 [[package]]
 name = "unicode-ident"
-version = "1.0.5"
+version = "1.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6ceab39d59e4c9499d4e5a8ee0e2735b891bb7308ac83dfb4e80cad195c9f6f3"
+checksum = "b15811caf2415fb889178633e7724bad2509101cde276048e013b9def5e51fa0"
 
 [[package]]
 name = "unicode-width"
@@ -860,15 +870,15 @@ checksum = "c0edd1e5b14653f783770bce4a4dabb4a5108a5370a5f5d8cfe8710c361f6c8b"
 
 [[package]]
 name = "utf8parse"
-version = "0.2.0"
+version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "936e4b492acfd135421d8dca4b1aa80a7bfc26e702ef3af710e0752684df5372"
+checksum = "711b9620af191e0cdc7468a8d14e709c3dcdb115b36f838e601583af800a370a"
 
 [[package]]
 name = "vte"
-version = "0.11.0"
+version = "0.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1aae21c12ad2ec2d168c236f369c38ff332bc1134f7246350dca641437365045"
+checksum = "f5022b5fbf9407086c180e9557be968742d839e68346af7792b8592489732197"
 dependencies = [
  "arrayvec",
  "utf8parse",
@@ -899,9 +909,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.83"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eaf9f5aceeec8be17c128b2e93e031fb8a4d469bb9c4ae2d7dc1888b26887268"
+checksum = "7706a72ab36d8cb1f80ffbf0e071533974a60d0a308d01a5d0375bf60499a342"
 dependencies = [
  "cfg-if",
  "wasm-bindgen-macro",
@@ -909,24 +919,24 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-backend"
-version = "0.2.83"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4c8ffb332579b0557b52d268b91feab8df3615f265d5270fec2a8c95b17c1142"
+checksum = "5ef2b6d3c510e9625e5fe6f509ab07d66a760f0885d858736483c32ed7809abd"
 dependencies = [
  "bumpalo",
  "log",
  "once_cell",
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.23",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.83"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "052be0f94026e6cbc75cdefc9bae13fd6052cdcaf532fa6c45e7ae33a1e6c810"
+checksum = "dee495e55982a3bd48105a7b947fd2a9b4a8ae3010041b9e0faab3f9cd028f1d"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -934,22 +944,22 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.83"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "07bc0c051dc5f23e307b13285f9d75df86bfdf816c5721e573dec1f9b8aa193c"
+checksum = "54681b18a46765f095758388f2d0cf16eb8d4169b639ab575a8f5693af210c7b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.23",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.83"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c38c045535d93ec4f0b4defec448e4291638ee608530863b1e2ba115d4fff7f"
+checksum = "ca6ad05a4870b2bf5fe995117d3728437bd27d7cd5f06f13c17443ef369775a1"
 
 [[package]]
 name = "winapi"
@@ -981,3 +991,69 @@ name = "winapi-x86_64-pc-windows-gnu"
 version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "windows"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e686886bc078bc1b0b600cac0147aadb815089b6e4da64016cbd754b6342700f"
+dependencies = [
+ "windows-targets",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.48.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05d4b17490f70499f20b9e791dcf6a299785ce8af4d709018206dc5b4953e95f"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91ae572e1b79dba883e0d315474df7305d12f569b400fcf90581b06062f7e1bc"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2ef27e0d7bdfcfc7b868b317c1d32c641a6fe4629c171b8928c7b08d98d7cf3"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "622a1962a7db830d6fd0a69683c80a18fda201879f0f447f065a3b7467daa241"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4542c6e364ce21bf45d69fdd2a8e455fa38d316158cfd43b3ac1c5b1b19f8e00"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca2b8a661f7628cbd23440e50b05d705db3686f894fc9580820623656af974b1"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7896dbc1f41e08872e9d5e8f8baa8fdd2677f29468c4e156210174edc7f7b953"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a515f5799fe4961cb532f983ce2b23082366b898e52ffbce459c86f67c8378a"

From f1709b3cf4360bbd57e7740a305d2a888849197b Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 3 Jul 2023 12:58:41 +0300
Subject: [PATCH 1457/1478] better diagnostics for 01193_metadata_loading
 (#51414)

---
 tests/queries/0_stateless/01193_metadata_loading.sh | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/01193_metadata_loading.sh b/tests/queries/0_stateless/01193_metadata_loading.sh
index 63fcf8eb93b..50425eae018 100755
--- a/tests/queries/0_stateless/01193_metadata_loading.sh
+++ b/tests/queries/0_stateless/01193_metadata_loading.sh
@@ -12,7 +12,7 @@ db="test_01193_$RANDOM"
 tables=1000
 threads=10
 count_multiplier=1
-max_time_ms=5000
+max_time_ms=1500
 
 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()")
 
@@ -42,13 +42,15 @@ 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..10}; do
+for i in {1..50}; do
   $CLICKHOUSE_CLIENT -q "DETACH DATABASE $db"
-  $CLICKHOUSE_CLIENT -q "ATTACH DATABASE $db" --query_id="$db-$i";
+  $CLICKHOUSE_CLIENT --query_profiler_real_time_period_ns=100000000 --query_profiler_cpu_time_period_ns=100000000 -q "ATTACH DATABASE $db" --query_id="$db-$i";
 done
 
 $CLICKHOUSE_CLIENT -q "SYSTEM FLUSH LOGS"
-$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"
+durations=$($CLICKHOUSE_CLIENT -q "SELECT groupArray(query_duration_ms) FROM system.query_log WHERE current_database = currentDatabase() AND query_id LIKE '$db-%' AND type=2")
+$CLICKHOUSE_CLIENT -q "SELECT 'durations', '$db', $durations FORMAT Null"
+$CLICKHOUSE_CLIENT -q "SELECT if(quantile(0.5)(arrayJoin($durations)) < $max_time_ms, 'ok', toString($durations))"
 
 $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 d0c38474274ce0c64478b33230b49db574e06e11 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 3 Jul 2023 12:29:12 +0200
Subject: [PATCH 1458/1478] Fix source image for sqllogic

---
 docker/images.json | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docker/images.json b/docker/images.json
index b4f3e755bd1..e8fc329a640 100644
--- a/docker/images.json
+++ b/docker/images.json
@@ -120,11 +120,12 @@
     "docker/test/base": {
          "name": "clickhouse/test-base",
          "dependent": [
-            "docker/test/stateless",
-            "docker/test/integration/base",
             "docker/test/fuzzer",
+            "docker/test/integration/base",
             "docker/test/keeper-jepsen",
-            "docker/test/server-jepsen"
+            "docker/test/server-jepsen",
+            "docker/test/sqllogic",
+            "docker/test/stateless"
          ]
     },
     "docker/test/integration/kerberized_hadoop": {

From 22e44ced8a30763ff147174633255fab91f01d70 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Fri, 30 Jun 2023 15:51:41 +0200
Subject: [PATCH 1459/1478] Add column modification time into
 system.parts_columns

This can be useful to obtain at least some time for the part after
mutations, since mutations will change the modification time of all
parts.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../MergeTree/DataPartStorageOnDiskFull.cpp   |  5 ++++
 .../MergeTree/DataPartStorageOnDiskFull.h     |  1 +
 src/Storages/MergeTree/IDataPartStorage.h     |  1 +
 src/Storages/MergeTree/IMergeTreeDataPart.h   |  2 ++
 .../MergeTree/MergeTreeDataPartCompact.cpp    |  5 ++++
 .../MergeTree/MergeTreeDataPartCompact.h      |  2 ++
 .../MergeTree/MergeTreeDataPartInMemory.h     |  1 +
 .../MergeTree/MergeTreeDataPartWide.cpp       | 12 ++++++++
 .../MergeTree/MergeTreeDataPartWide.h         |  2 ++
 .../System/StorageSystemPartsColumns.cpp      | 10 +++++++
 .../StorageSystemProjectionPartsColumns.cpp   | 11 ++++++-
 .../02117_show_create_table_system.reference  |  2 ++
 ..._parts_columns_modification_time.reference |  6 ++++
 ...tem_parts_columns_modification_time.sql.j2 | 30 +++++++++++++++++++
 14 files changed, 89 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02806_system_parts_columns_modification_time.reference
 create mode 100644 tests/queries/0_stateless/02806_system_parts_columns_modification_time.sql.j2

diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
index e62e5a5d6b2..20b6c5a919e 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
@@ -80,6 +80,11 @@ DataPartStorageIteratorPtr DataPartStorageOnDiskFull::iterate() const
         volume->getDisk()->iterateDirectory(fs::path(root_path) / part_dir));
 }
 
+Poco::Timestamp DataPartStorageOnDiskFull::getFileLastModified(const String & file_name) const
+{
+    return volume->getDisk()->getLastModified(fs::path(root_path) / part_dir / file_name);
+}
+
 size_t DataPartStorageOnDiskFull::getFileSize(const String & file_name) const
 {
     return volume->getDisk()->getFileSize(fs::path(root_path) / part_dir / file_name);
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskFull.h b/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
index 2ceb392e80f..5d70404fcfa 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
@@ -20,6 +20,7 @@ public:
     bool isDirectory(const std::string & name) const override;
 
     DataPartStorageIteratorPtr iterate() const override;
+    Poco::Timestamp getFileLastModified(const String & file_name) 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;
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index 9d6c5d0dcba..8c9fd6d0426 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -108,6 +108,7 @@ public:
     virtual DataPartStorageIteratorPtr iterate() const = 0;
 
     /// Get metadata for a file inside path dir.
+    virtual Poco::Timestamp getFileLastModified(const std::string & file_name) const = 0;
     virtual size_t getFileSize(const std::string & file_name) const = 0;
     virtual UInt32 getRefCount(const std::string & file_name) const = 0;
 
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.h b/src/Storages/MergeTree/IMergeTreeDataPart.h
index fd73d802579..797de39b020 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.h
@@ -116,6 +116,8 @@ public:
     /// Otherwise return information about column size on disk.
     ColumnSize getColumnSize(const String & column_name) const;
 
+    virtual std::optional<time_t> getColumnModificationTime(const String & column_name) const = 0;
+
     /// NOTE: Returns zeros if secondary indexes are not found in checksums.
     /// Otherwise return information about secondary index size on disk.
     IndexSize getSecondaryIndexSize(const String & secondary_index_name) const;
diff --git a/src/Storages/MergeTree/MergeTreeDataPartCompact.cpp b/src/Storages/MergeTree/MergeTreeDataPartCompact.cpp
index 07e20f16a9f..9c47608e364 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartCompact.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartCompact.cpp
@@ -144,6 +144,11 @@ bool MergeTreeDataPartCompact::hasColumnFiles(const NameAndTypePair & column) co
     return (bin_checksum != checksums.files.end() && mrk_checksum != checksums.files.end());
 }
 
+std::optional<time_t> MergeTreeDataPartCompact::getColumnModificationTime(const String & /* column_name */) const
+{
+    return getDataPartStorage().getFileLastModified(DATA_FILE_NAME_WITH_EXTENSION).epochTime();
+}
+
 void MergeTreeDataPartCompact::checkConsistency(bool require_part_metadata) const
 {
     checkConsistencyBase();
diff --git a/src/Storages/MergeTree/MergeTreeDataPartCompact.h b/src/Storages/MergeTree/MergeTreeDataPartCompact.h
index b115692a7cf..08764eedb43 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartCompact.h
+++ b/src/Storages/MergeTree/MergeTreeDataPartCompact.h
@@ -55,6 +55,8 @@ public:
 
     bool hasColumnFiles(const NameAndTypePair & column) const override;
 
+    std::optional<time_t> getColumnModificationTime(const String & column_name) const override;
+
     String getFileNameForColumn(const NameAndTypePair & /* column */) const override { return DATA_FILE_NAME; }
 
     ~MergeTreeDataPartCompact() override;
diff --git a/src/Storages/MergeTree/MergeTreeDataPartInMemory.h b/src/Storages/MergeTree/MergeTreeDataPartInMemory.h
index db7244d8e99..2698b69b38e 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartInMemory.h
+++ b/src/Storages/MergeTree/MergeTreeDataPartInMemory.h
@@ -43,6 +43,7 @@ public:
     String getFileNameForColumn(const NameAndTypePair & /* column */) const override { return ""; }
     void renameTo(const String & new_relative_path, bool remove_new_dir_if_exists) override;
     DataPartStoragePtr makeCloneInDetached(const String & prefix, const StorageMetadataPtr & metadata_snapshot) const override;
+    std::optional<time_t> getColumnModificationTime(const String & /* column_name */) const override { return {}; }
 
     MutableDataPartStoragePtr flushToDisk(const String & new_relative_path, const StorageMetadataPtr & metadata_snapshot) const;
 
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWide.cpp b/src/Storages/MergeTree/MergeTreeDataPartWide.cpp
index f44cbdd8628..2d886e2058b 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWide.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartWide.cpp
@@ -260,6 +260,18 @@ bool MergeTreeDataPartWide::hasColumnFiles(const NameAndTypePair & column) const
     return res;
 }
 
+std::optional<time_t> MergeTreeDataPartWide::getColumnModificationTime(const String & column_name) const
+{
+    try
+    {
+        return getDataPartStorage().getFileLastModified(column_name + DATA_FILE_EXTENSION).epochTime();
+    }
+    catch (const fs::filesystem_error &)
+    {
+        return {};
+    }
+}
+
 String MergeTreeDataPartWide::getFileNameForColumn(const NameAndTypePair & column) const
 {
     String filename;
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWide.h b/src/Storages/MergeTree/MergeTreeDataPartWide.h
index 5ee497b9b21..0b2ffeb4b18 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWide.h
+++ b/src/Storages/MergeTree/MergeTreeDataPartWide.h
@@ -54,6 +54,8 @@ public:
 
     bool hasColumnFiles(const NameAndTypePair & column) const override;
 
+    std::optional<time_t> getColumnModificationTime(const String & column_name) const override;
+
 protected:
     static void loadIndexGranularityImpl(
         MergeTreeIndexGranularity & index_granularity_, MergeTreeIndexGranularityInfo & index_granularity_info_,
diff --git a/src/Storages/System/StorageSystemPartsColumns.cpp b/src/Storages/System/StorageSystemPartsColumns.cpp
index 00b958b015f..67c8d06e432 100644
--- a/src/Storages/System/StorageSystemPartsColumns.cpp
+++ b/src/Storages/System/StorageSystemPartsColumns.cpp
@@ -8,6 +8,7 @@
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/DataTypeNested.h>
+#include <DataTypes/DataTypeNullable.h>
 #include <DataTypes/NestedUtils.h>
 #include <DataTypes/DataTypeUUID.h>
 #include <Storages/VirtualColumnUtils.h>
@@ -62,6 +63,8 @@ StorageSystemPartsColumns::StorageSystemPartsColumns(const StorageID & table_id_
         {"column_data_compressed_bytes",               std::make_shared<DataTypeUInt64>()},
         {"column_data_uncompressed_bytes",             std::make_shared<DataTypeUInt64>()},
         {"column_marks_bytes",                         std::make_shared<DataTypeUInt64>()},
+        {"column_modification_time",                   std::make_shared<DataTypeNullable>(std::make_shared<DataTypeDateTime>())},
+
         {"serialization_kind",                         std::make_shared<DataTypeString>()},
         {"subcolumns.names",                           std::make_shared<DataTypeArray>(std::make_shared<DataTypeString>())},
         {"subcolumns.types",                           std::make_shared<DataTypeArray>(std::make_shared<DataTypeString>())},
@@ -235,6 +238,13 @@ void StorageSystemPartsColumns::processNextStorage(
                 columns[res_index++]->insert(column_size.data_uncompressed);
             if (columns_mask[src_index++])
                 columns[res_index++]->insert(column_size.marks);
+            if (columns_mask[src_index++])
+            {
+                if (auto column_modification_time = part->getColumnModificationTime(column.name))
+                    columns[res_index++]->insert(UInt64(column_modification_time.value()));
+                else
+                    columns[res_index++]->insertDefault();
+            }
 
             auto serialization = part->getSerialization(column.name);
             if (columns_mask[src_index++])
diff --git a/src/Storages/System/StorageSystemProjectionPartsColumns.cpp b/src/Storages/System/StorageSystemProjectionPartsColumns.cpp
index a5968597885..06becc6d91c 100644
--- a/src/Storages/System/StorageSystemProjectionPartsColumns.cpp
+++ b/src/Storages/System/StorageSystemProjectionPartsColumns.cpp
@@ -7,6 +7,7 @@
 #include <DataTypes/DataTypeDateTime.h>
 #include <DataTypes/DataTypeDate.h>
 #include <DataTypes/DataTypeUUID.h>
+#include <DataTypes/DataTypeNullable.h>
 #include <Storages/VirtualColumnUtils.h>
 #include <Databases/IDatabase.h>
 #include <Parsers/queryToString.h>
@@ -66,7 +67,8 @@ StorageSystemProjectionPartsColumns::StorageSystemProjectionPartsColumns(const S
         {"column_bytes_on_disk",                       std::make_shared<DataTypeUInt64>()},
         {"column_data_compressed_bytes",               std::make_shared<DataTypeUInt64>()},
         {"column_data_uncompressed_bytes",             std::make_shared<DataTypeUInt64>()},
-        {"column_marks_bytes",                         std::make_shared<DataTypeUInt64>()}
+        {"column_marks_bytes",                         std::make_shared<DataTypeUInt64>()},
+        {"column_modification_time",                   std::make_shared<DataTypeNullable>(std::make_shared<DataTypeDateTime>())},
     }
     )
 {
@@ -247,6 +249,13 @@ void StorageSystemProjectionPartsColumns::processNextStorage(
                 columns[res_index++]->insert(column_size.data_uncompressed);
             if (columns_mask[src_index++])
                 columns[res_index++]->insert(column_size.marks);
+            if (columns_mask[src_index++])
+            {
+                if (auto column_modification_time = part->getColumnModificationTime(column.name))
+                    columns[res_index++]->insert(UInt64(column_modification_time.value()));
+                else
+                    columns[res_index++]->insertDefault();
+            }
 
             if (has_state_column)
                 columns[res_index++]->insert(part->stateString());
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 703972279e7..3834b05601f 100644
--- a/tests/queries/0_stateless/02117_show_create_table_system.reference
+++ b/tests/queries/0_stateless/02117_show_create_table_system.reference
@@ -565,6 +565,7 @@ CREATE TABLE system.parts_columns
     `column_data_compressed_bytes` UInt64,
     `column_data_uncompressed_bytes` UInt64,
     `column_marks_bytes` UInt64,
+    `column_modification_time` Nullable(DateTime),
     `serialization_kind` String,
     `subcolumns.names` Array(String),
     `subcolumns.types` Array(String),
@@ -750,6 +751,7 @@ CREATE TABLE system.projection_parts_columns
     `column_data_compressed_bytes` UInt64,
     `column_data_uncompressed_bytes` UInt64,
     `column_marks_bytes` UInt64,
+    `column_modification_time` Nullable(DateTime),
     `bytes` UInt64,
     `marks_size` UInt64,
     `part_name` String
diff --git a/tests/queries/0_stateless/02806_system_parts_columns_modification_time.reference b/tests/queries/0_stateless/02806_system_parts_columns_modification_time.reference
new file mode 100644
index 00000000000..f1be11980bb
--- /dev/null
+++ b/tests/queries/0_stateless/02806_system_parts_columns_modification_time.reference
@@ -0,0 +1,6 @@
+Wide	key	1	1
+Wide	key	1	1
+Wide	value	1	0
+Compact	key	1	1
+Compact	key	1	1
+Compact	value	1	1
diff --git a/tests/queries/0_stateless/02806_system_parts_columns_modification_time.sql.j2 b/tests/queries/0_stateless/02806_system_parts_columns_modification_time.sql.j2
new file mode 100644
index 00000000000..eee236ff681
--- /dev/null
+++ b/tests/queries/0_stateless/02806_system_parts_columns_modification_time.sql.j2
@@ -0,0 +1,30 @@
+-- Tags: no-s3-storage
+-- Tag: no-s3-storage because S3 updates metadata for the virtual link file on metadata disk (see CreateHardlinkOperation::execute() for details)
+
+set mutations_sync=1;
+
+{# modification time of the part folder and column files not always equal, this is how much seconds of difference is allowed #}
+{% set mtime_diff_in_seconds = 5 %}
+
+{% for id, settings, file_per_column in [
+    ("wide",    "min_bytes_for_wide_part=0, min_rows_for_wide_part=0",      true),
+    ("compact", "min_bytes_for_wide_part=1000, min_rows_for_wide_part=100", false)
+]
+%}
+
+drop table if exists data_{{ id }};
+create table data_{{ id }} (key Int) engine=MergeTree() order by tuple() settings {{ settings }};
+insert into data_{{ id }} values (1);
+select sleep(3) format Null;
+select part_type, column, now()-modification_time < 10, modification_time - column_modification_time < {{ mtime_diff_in_seconds }} from system.parts_columns where database = currentDatabase() and table = 'data_{{ id }}';
+alter table data_{{ id }} add column value Int default 0;
+alter table data_{{ id }} materialize column value;
+select part_type, column, now()-modification_time < 10,
+{% if file_per_column %}
+modification_time - column_modification_time >= 3
+{% else %}
+modification_time - column_modification_time < {{ mtime_diff_in_seconds }}
+{% endif %}
+from system.parts_columns where active and database = currentDatabase() and table = 'data_{{ id }}' order by column;
+
+{% endfor %}

From 138e28cf6b98697297c35430f877782c437ddbe0 Mon Sep 17 00:00:00 2001
From: Tyler Hannan <tyler@clickhouse.com>
Date: Mon, 3 Jul 2023 13:45:39 +0200
Subject: [PATCH 1460/1478] Update README.md (#51726)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index eac036c2d9b..80a8d0e331f 100644
--- a/README.md
+++ b/README.md
@@ -23,11 +23,11 @@ curl https://clickhouse.com/ | sh
 ## Upcoming Events
 
 * [**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
 * [**ClickHouse Meetup in Singapore**](https://www.meetup.com/clickhouse-singapore-meetup-group/events/294428050/) - Jul 27
+* [**ClickHouse Meetup in Paris**](https://www.meetup.com/clickhouse-france-user-group/events/294283460) - Sep 12
 
 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.
 

From 579a446d1901b356fd1f58d98cd1cf6898de2604 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Mon, 3 Jul 2023 13:49:56 +0200
Subject: [PATCH 1461/1478] Update 02789_filesystem_cache_alignment.sh

---
 tests/queries/0_stateless/02789_filesystem_cache_alignment.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
index 509d1a635b1..912cdd3d1e8 100755
--- a/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
+++ b/tests/queries/0_stateless/02789_filesystem_cache_alignment.sh
@@ -61,7 +61,7 @@ WHERE file_segment_size < file_size AND end_offset + 1 != file_size;
 ")
 #echo $all
 
-if [ "$all" -gt "10" ]; then
+if [ "$all" -gt "1" ]; then
   echo "OK"
 else
   echo "FAIL"
@@ -105,7 +105,7 @@ SELECT count() FROM ($query2)
 WHERE file_segment_size < file_size AND file_segment_range_end + 1 != file_size;
 ")
 
-if [ "$all" -gt "10" ]; then
+if [ "$all" -gt "1" ]; then
   echo "OK"
 else
   echo "FAIL"

From d1c4a37473749172406e850a3f0c0bcc6f122a49 Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Mon, 3 Jul 2023 14:38:38 +0200
Subject: [PATCH 1462/1478] Remove MemoryPool from Poco because it's useless

---
 base/poco/Foundation/CMakeLists.txt           |   1 -
 .../poco/Foundation/include/Poco/MemoryPool.h | 116 ------------------
 base/poco/Foundation/src/MemoryPool.cpp       | 105 ----------------
 .../Net/include/Poco/Net/HTTPBasicStreamBuf.h |   5 +-
 .../include/Poco/Net/HTTPBufferAllocator.h    |  53 --------
 .../Net/include/Poco/Net/HTTPChunkedStream.h  |  13 --
 .../include/Poco/Net/HTTPFixedLengthStream.h  |  12 --
 .../Net/include/Poco/Net/HTTPHeaderStream.h   |  13 --
 base/poco/Net/include/Poco/Net/HTTPStream.h   |  13 --
 base/poco/Net/src/HTTPBufferAllocator.cpp     |  44 -------
 base/poco/Net/src/HTTPChunkedStream.cpp       |  50 +-------
 base/poco/Net/src/HTTPFixedLengthStream.cpp   |  47 +------
 base/poco/Net/src/HTTPHeaderStream.cpp        |  50 +-------
 base/poco/Net/src/HTTPSession.cpp             |   8 +-
 base/poco/Net/src/HTTPStream.cpp              |  48 +-------
 15 files changed, 10 insertions(+), 568 deletions(-)
 delete mode 100644 base/poco/Foundation/include/Poco/MemoryPool.h
 delete mode 100644 base/poco/Foundation/src/MemoryPool.cpp
 delete mode 100644 base/poco/Net/include/Poco/Net/HTTPBufferAllocator.h
 delete mode 100644 base/poco/Net/src/HTTPBufferAllocator.cpp

diff --git a/base/poco/Foundation/CMakeLists.txt b/base/poco/Foundation/CMakeLists.txt
index 358f49ed055..d0dde8a51a5 100644
--- a/base/poco/Foundation/CMakeLists.txt
+++ b/base/poco/Foundation/CMakeLists.txt
@@ -87,7 +87,6 @@ set (SRCS
     src/LoggingRegistry.cpp
     src/LogStream.cpp
     src/MD5Engine.cpp
-    src/MemoryPool.cpp
     src/MemoryStream.cpp
     src/Message.cpp
     src/Mutex.cpp
diff --git a/base/poco/Foundation/include/Poco/MemoryPool.h b/base/poco/Foundation/include/Poco/MemoryPool.h
deleted file mode 100644
index 9ab12081b5f..00000000000
--- a/base/poco/Foundation/include/Poco/MemoryPool.h
+++ /dev/null
@@ -1,116 +0,0 @@
-//
-// MemoryPool.h
-//
-// Library: Foundation
-// Package: Core
-// Module:  MemoryPool
-//
-// Definition of the MemoryPool class.
-//
-// Copyright (c) 2005-2006, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#ifndef Foundation_MemoryPool_INCLUDED
-#define Foundation_MemoryPool_INCLUDED
-
-
-#include <cstddef>
-#include <vector>
-#include "Poco/Foundation.h"
-#include "Poco/Mutex.h"
-
-
-namespace Poco
-{
-
-
-class Foundation_API MemoryPool
-/// A simple pool for fixed-size memory blocks.
-///
-/// The main purpose of this class is to speed-up
-/// memory allocations, as well as to reduce memory
-/// fragmentation in situations where the same blocks
-/// are allocated all over again, such as in server
-/// applications.
-///
-/// All allocated blocks are retained for future use.
-/// A limit on the number of blocks can be specified.
-/// Blocks can be preallocated.
-{
-public:
-    MemoryPool(std::size_t blockSize, int preAlloc = 0, int maxAlloc = 0);
-    /// Creates a MemoryPool for blocks with the given blockSize.
-    /// The number of blocks given in preAlloc are preallocated.
-
-    ~MemoryPool();
-
-    void * get();
-    /// Returns a memory block. If there are no more blocks
-    /// in the pool, a new block will be allocated.
-    ///
-    /// If maxAlloc blocks are already allocated, an
-    /// OutOfMemoryException is thrown.
-
-    void release(void * ptr);
-    /// Releases a memory block and returns it to the pool.
-
-    std::size_t blockSize() const;
-    /// Returns the block size.
-
-    int allocated() const;
-    /// Returns the number of allocated blocks.
-
-    int available() const;
-    /// Returns the number of available blocks in the pool.
-
-private:
-    MemoryPool();
-    MemoryPool(const MemoryPool &);
-    MemoryPool & operator=(const MemoryPool &);
-
-    void clear();
-
-    enum
-    {
-        BLOCK_RESERVE = 128
-    };
-
-    typedef std::vector<char *> BlockVec;
-
-    std::size_t _blockSize;
-    int _maxAlloc;
-    int _allocated;
-    BlockVec _blocks;
-    FastMutex _mutex;
-};
-
-
-//
-// inlines
-//
-inline std::size_t MemoryPool::blockSize() const
-{
-    return _blockSize;
-}
-
-
-inline int MemoryPool::allocated() const
-{
-    return _allocated;
-}
-
-
-inline int MemoryPool::available() const
-{
-    return (int)_blocks.size();
-}
-
-
-} // namespace Poco
-
-
-#endif // Foundation_MemoryPool_INCLUDED
diff --git a/base/poco/Foundation/src/MemoryPool.cpp b/base/poco/Foundation/src/MemoryPool.cpp
deleted file mode 100644
index 01c477be525..00000000000
--- a/base/poco/Foundation/src/MemoryPool.cpp
+++ /dev/null
@@ -1,105 +0,0 @@
-//
-// MemoryPool.cpp
-//
-// Library: Foundation
-// Package: Core
-// Module:  MemoryPool
-//
-// Copyright (c) 2005-2006, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#include "Poco/MemoryPool.h"
-#include "Poco/Exception.h"
-
-
-namespace Poco {
-
-
-MemoryPool::MemoryPool(std::size_t blockSize, int preAlloc, int maxAlloc):
-	_blockSize(blockSize),
-	_maxAlloc(maxAlloc),
-	_allocated(preAlloc)
-{
-	poco_assert (maxAlloc == 0 || maxAlloc >= preAlloc);
-	poco_assert (preAlloc >= 0 && maxAlloc >= 0);
-
-	int r = BLOCK_RESERVE;
-	if (preAlloc > r)
-		r = preAlloc;
-	if (maxAlloc > 0 && maxAlloc < r)
-		r = maxAlloc;
-	_blocks.reserve(r);
-	
-	try
-	{
-		for (int i = 0; i < preAlloc; ++i)
-		{
-			_blocks.push_back(new char[_blockSize]);
-		}
-	}
-	catch (...)
-	{
-		clear();
-		throw;
-	}
-}
-
-	
-MemoryPool::~MemoryPool()
-{
-	clear();
-}
-
-
-void MemoryPool::clear()
-{
-	for (BlockVec::iterator it = _blocks.begin(); it != _blocks.end(); ++it)
-	{
-		delete [] *it;
-	}
-	_blocks.clear();
-}
-
-
-void* MemoryPool::get()
-{
-	FastMutex::ScopedLock lock(_mutex);
-	
-	if (_blocks.empty())
-	{
-		if (_maxAlloc == 0 || _allocated < _maxAlloc)
-		{
-			++_allocated;
-			return new char[_blockSize];
-		}
-		else throw OutOfMemoryException("MemoryPool exhausted");
-	}
-	else
-	{
-		char* ptr = _blocks.back();
-		_blocks.pop_back();
-		return ptr;
-	}
-}
-
-	
-void MemoryPool::release(void* ptr)
-{
-	FastMutex::ScopedLock lock(_mutex);
-	
-	try
-	{
-		_blocks.push_back(reinterpret_cast<char*>(ptr));
-	}
-	catch (...)
-	{
-		delete [] reinterpret_cast<char*>(ptr);
-	}
-}
-
-
-} // namespace Poco
diff --git a/base/poco/Net/include/Poco/Net/HTTPBasicStreamBuf.h b/base/poco/Net/include/Poco/Net/HTTPBasicStreamBuf.h
index c4872d95353..c87719b63a4 100644
--- a/base/poco/Net/include/Poco/Net/HTTPBasicStreamBuf.h
+++ b/base/poco/Net/include/Poco/Net/HTTPBasicStreamBuf.h
@@ -19,7 +19,6 @@
 
 
 #include "Poco/BufferedStreamBuf.h"
-#include "Poco/Net/HTTPBufferAllocator.h"
 #include "Poco/Net/Net.h"
 
 
@@ -27,9 +26,9 @@ namespace Poco
 {
 namespace Net
 {
+    constexpr size_t HTTP_DEFAULT_BUFFER_SIZE = 8 * 1024;
 
-
-    typedef Poco::BasicBufferedStreamBuf<char, std::char_traits<char>, HTTPBufferAllocator> HTTPBasicStreamBuf;
+    typedef Poco::BasicBufferedStreamBuf<char, std::char_traits<char>> HTTPBasicStreamBuf;
 
 
 }
diff --git a/base/poco/Net/include/Poco/Net/HTTPBufferAllocator.h b/base/poco/Net/include/Poco/Net/HTTPBufferAllocator.h
deleted file mode 100644
index 5d088e35297..00000000000
--- a/base/poco/Net/include/Poco/Net/HTTPBufferAllocator.h
+++ /dev/null
@@ -1,53 +0,0 @@
-//
-// HTTPBufferAllocator.h
-//
-// Library: Net
-// Package: HTTP
-// Module:  HTTPBufferAllocator
-//
-// Definition of the HTTPBufferAllocator class.
-//
-// Copyright (c) 2005-2006, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#ifndef Net_HTTPBufferAllocator_INCLUDED
-#define Net_HTTPBufferAllocator_INCLUDED
-
-
-#include <ios>
-#include "Poco/MemoryPool.h"
-#include "Poco/Net/Net.h"
-
-
-namespace Poco
-{
-namespace Net
-{
-
-
-    class Net_API HTTPBufferAllocator
-    /// A BufferAllocator for HTTP streams.
-    {
-    public:
-        static char * allocate(std::streamsize size);
-        static void deallocate(char * ptr, std::streamsize size);
-
-        enum
-        {
-            BUFFER_SIZE = 128 * 1024
-        };
-
-    private:
-        static Poco::MemoryPool _pool;
-    };
-
-
-}
-} // namespace Poco::Net
-
-
-#endif // Net_HTTPBufferAllocator_INCLUDED
diff --git a/base/poco/Net/include/Poco/Net/HTTPChunkedStream.h b/base/poco/Net/include/Poco/Net/HTTPChunkedStream.h
index 47987b18817..5f4729c9278 100644
--- a/base/poco/Net/include/Poco/Net/HTTPChunkedStream.h
+++ b/base/poco/Net/include/Poco/Net/HTTPChunkedStream.h
@@ -21,7 +21,6 @@
 #include <cstddef>
 #include <istream>
 #include <ostream>
-#include "Poco/MemoryPool.h"
 #include "Poco/Net/HTTPBasicStreamBuf.h"
 #include "Poco/Net/Net.h"
 
@@ -80,12 +79,6 @@ namespace Net
     public:
         HTTPChunkedInputStream(HTTPSession & session);
         ~HTTPChunkedInputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
@@ -95,12 +88,6 @@ namespace Net
     public:
         HTTPChunkedOutputStream(HTTPSession & session);
         ~HTTPChunkedOutputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
diff --git a/base/poco/Net/include/Poco/Net/HTTPFixedLengthStream.h b/base/poco/Net/include/Poco/Net/HTTPFixedLengthStream.h
index 4de211fdb92..2f4df102605 100644
--- a/base/poco/Net/include/Poco/Net/HTTPFixedLengthStream.h
+++ b/base/poco/Net/include/Poco/Net/HTTPFixedLengthStream.h
@@ -78,12 +78,6 @@ namespace Net
     public:
         HTTPFixedLengthInputStream(HTTPSession & session, HTTPFixedLengthStreamBuf::ContentLength length);
         ~HTTPFixedLengthInputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
@@ -93,12 +87,6 @@ namespace Net
     public:
         HTTPFixedLengthOutputStream(HTTPSession & session, HTTPFixedLengthStreamBuf::ContentLength length);
         ~HTTPFixedLengthOutputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
diff --git a/base/poco/Net/include/Poco/Net/HTTPHeaderStream.h b/base/poco/Net/include/Poco/Net/HTTPHeaderStream.h
index bcfca984d8b..cf1a6dba2e6 100644
--- a/base/poco/Net/include/Poco/Net/HTTPHeaderStream.h
+++ b/base/poco/Net/include/Poco/Net/HTTPHeaderStream.h
@@ -21,7 +21,6 @@
 #include <cstddef>
 #include <istream>
 #include <ostream>
-#include "Poco/MemoryPool.h"
 #include "Poco/Net/HTTPBasicStreamBuf.h"
 #include "Poco/Net/Net.h"
 
@@ -74,12 +73,6 @@ namespace Net
     public:
         HTTPHeaderInputStream(HTTPSession & session);
         ~HTTPHeaderInputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
@@ -89,12 +82,6 @@ namespace Net
     public:
         HTTPHeaderOutputStream(HTTPSession & session);
         ~HTTPHeaderOutputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
diff --git a/base/poco/Net/include/Poco/Net/HTTPStream.h b/base/poco/Net/include/Poco/Net/HTTPStream.h
index 0197bc62eb2..48502347b2c 100644
--- a/base/poco/Net/include/Poco/Net/HTTPStream.h
+++ b/base/poco/Net/include/Poco/Net/HTTPStream.h
@@ -21,7 +21,6 @@
 #include <cstddef>
 #include <istream>
 #include <ostream>
-#include "Poco/MemoryPool.h"
 #include "Poco/Net/HTTPBasicStreamBuf.h"
 #include "Poco/Net/Net.h"
 
@@ -75,12 +74,6 @@ namespace Net
     public:
         HTTPInputStream(HTTPSession & session);
         ~HTTPInputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
@@ -90,12 +83,6 @@ namespace Net
     public:
         HTTPOutputStream(HTTPSession & session);
         ~HTTPOutputStream();
-
-        void * operator new(std::size_t size);
-        void operator delete(void * ptr);
-
-    private:
-        static Poco::MemoryPool _pool;
     };
 
 
diff --git a/base/poco/Net/src/HTTPBufferAllocator.cpp b/base/poco/Net/src/HTTPBufferAllocator.cpp
deleted file mode 100644
index 2944e2a6121..00000000000
--- a/base/poco/Net/src/HTTPBufferAllocator.cpp
+++ /dev/null
@@ -1,44 +0,0 @@
-//
-// HTTPBufferAllocator.cpp
-//
-// Library: Net
-// Package: HTTP
-// Module:  HTTPBufferAllocator
-//
-// Copyright (c) 2005-2006, Applied Informatics Software Engineering GmbH.
-// and Contributors.
-//
-// SPDX-License-Identifier:	BSL-1.0
-//
-
-
-#include "Poco/Net/HTTPBufferAllocator.h"
-
-
-using Poco::MemoryPool;
-
-
-namespace Poco {
-namespace Net {
-
-
-MemoryPool HTTPBufferAllocator::_pool(HTTPBufferAllocator::BUFFER_SIZE, 16);
-
-
-char* HTTPBufferAllocator::allocate(std::streamsize size)
-{
-	poco_assert_dbg (size == BUFFER_SIZE);
-
-	return reinterpret_cast<char*>(_pool.get());
-}
-
-
-void HTTPBufferAllocator::deallocate(char* ptr, std::streamsize size)
-{
-	poco_assert_dbg (size == BUFFER_SIZE);
-
-	_pool.release(ptr);
-}
-
-
-} } // namespace Poco::Net
diff --git a/base/poco/Net/src/HTTPChunkedStream.cpp b/base/poco/Net/src/HTTPChunkedStream.cpp
index f2f79da590b..376e3f55492 100644
--- a/base/poco/Net/src/HTTPChunkedStream.cpp
+++ b/base/poco/Net/src/HTTPChunkedStream.cpp
@@ -34,7 +34,7 @@ namespace Net {
 
 
 HTTPChunkedStreamBuf::HTTPChunkedStreamBuf(HTTPSession& session, openmode mode):
-	HTTPBasicStreamBuf(HTTPBufferAllocator::BUFFER_SIZE, mode),
+	HTTPBasicStreamBuf(HTTP_DEFAULT_BUFFER_SIZE, mode),
 	_session(session),
 	_mode(mode),
 	_chunk(0)
@@ -181,10 +181,6 @@ HTTPChunkedStreamBuf* HTTPChunkedIOS::rdbuf()
 // HTTPChunkedInputStream
 //
 
-
-Poco::MemoryPool HTTPChunkedInputStream::_pool(sizeof(HTTPChunkedInputStream));
-
-
 HTTPChunkedInputStream::HTTPChunkedInputStream(HTTPSession& session):
 	HTTPChunkedIOS(session, std::ios::in),
 	std::istream(&_buf)
@@ -196,34 +192,10 @@ HTTPChunkedInputStream::~HTTPChunkedInputStream()
 {
 }
 
-
-void* HTTPChunkedInputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPChunkedInputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 //
 // HTTPChunkedOutputStream
 //
 
-
-Poco::MemoryPool HTTPChunkedOutputStream::_pool(sizeof(HTTPChunkedOutputStream));
-
-
 HTTPChunkedOutputStream::HTTPChunkedOutputStream(HTTPSession& session):
 	HTTPChunkedIOS(session, std::ios::out),
 	std::ostream(&_buf)
@@ -235,24 +207,4 @@ HTTPChunkedOutputStream::~HTTPChunkedOutputStream()
 {
 }
 
-
-void* HTTPChunkedOutputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPChunkedOutputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 } } // namespace Poco::Net
diff --git a/base/poco/Net/src/HTTPFixedLengthStream.cpp b/base/poco/Net/src/HTTPFixedLengthStream.cpp
index d19f6122ee1..fd77ff71cd9 100644
--- a/base/poco/Net/src/HTTPFixedLengthStream.cpp
+++ b/base/poco/Net/src/HTTPFixedLengthStream.cpp
@@ -30,7 +30,7 @@ namespace Net {
 
 
 HTTPFixedLengthStreamBuf::HTTPFixedLengthStreamBuf(HTTPSession& session, ContentLength length, openmode mode):
-	HTTPBasicStreamBuf(HTTPBufferAllocator::BUFFER_SIZE, mode),
+	HTTPBasicStreamBuf(HTTP_DEFAULT_BUFFER_SIZE, mode),
 	_session(session),
 	_length(length),
 	_count(0)
@@ -109,9 +109,6 @@ HTTPFixedLengthStreamBuf* HTTPFixedLengthIOS::rdbuf()
 //
 
 
-Poco::MemoryPool HTTPFixedLengthInputStream::_pool(sizeof(HTTPFixedLengthInputStream));
-
-
 HTTPFixedLengthInputStream::HTTPFixedLengthInputStream(HTTPSession& session, HTTPFixedLengthStreamBuf::ContentLength length):
 	HTTPFixedLengthIOS(session, length, std::ios::in),
 	std::istream(&_buf)
@@ -124,33 +121,10 @@ HTTPFixedLengthInputStream::~HTTPFixedLengthInputStream()
 }
 
 
-void* HTTPFixedLengthInputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPFixedLengthInputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 //
 // HTTPFixedLengthOutputStream
 //
 
-
-Poco::MemoryPool HTTPFixedLengthOutputStream::_pool(sizeof(HTTPFixedLengthOutputStream));
-
-
 HTTPFixedLengthOutputStream::HTTPFixedLengthOutputStream(HTTPSession& session, HTTPFixedLengthStreamBuf::ContentLength length):
 	HTTPFixedLengthIOS(session, length, std::ios::out),
 	std::ostream(&_buf)
@@ -163,23 +137,4 @@ HTTPFixedLengthOutputStream::~HTTPFixedLengthOutputStream()
 }
 
 
-void* HTTPFixedLengthOutputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPFixedLengthOutputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 } } // namespace Poco::Net
diff --git a/base/poco/Net/src/HTTPHeaderStream.cpp b/base/poco/Net/src/HTTPHeaderStream.cpp
index 8e0091fcbe3..39b9007062d 100644
--- a/base/poco/Net/src/HTTPHeaderStream.cpp
+++ b/base/poco/Net/src/HTTPHeaderStream.cpp
@@ -26,7 +26,7 @@ namespace Net {
 
 
 HTTPHeaderStreamBuf::HTTPHeaderStreamBuf(HTTPSession& session, openmode mode):
-	HTTPBasicStreamBuf(HTTPBufferAllocator::BUFFER_SIZE, mode),
+	HTTPBasicStreamBuf(HTTP_DEFAULT_BUFFER_SIZE, mode),
 	_session(session),
 	_end(false)
 {
@@ -101,10 +101,6 @@ HTTPHeaderStreamBuf* HTTPHeaderIOS::rdbuf()
 // HTTPHeaderInputStream
 //
 
-
-Poco::MemoryPool HTTPHeaderInputStream::_pool(sizeof(HTTPHeaderInputStream));
-
-
 HTTPHeaderInputStream::HTTPHeaderInputStream(HTTPSession& session):
 	HTTPHeaderIOS(session, std::ios::in),
 	std::istream(&_buf)
@@ -116,34 +112,10 @@ HTTPHeaderInputStream::~HTTPHeaderInputStream()
 {
 }
 
-
-void* HTTPHeaderInputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPHeaderInputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 //
 // HTTPHeaderOutputStream
 //
 
-
-Poco::MemoryPool HTTPHeaderOutputStream::_pool(sizeof(HTTPHeaderOutputStream));
-
-
 HTTPHeaderOutputStream::HTTPHeaderOutputStream(HTTPSession& session):
 	HTTPHeaderIOS(session, std::ios::out),
 	std::ostream(&_buf)
@@ -155,24 +127,4 @@ HTTPHeaderOutputStream::~HTTPHeaderOutputStream()
 {
 }
 
-
-void* HTTPHeaderOutputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPHeaderOutputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 } } // namespace Poco::Net
diff --git a/base/poco/Net/src/HTTPSession.cpp b/base/poco/Net/src/HTTPSession.cpp
index cb6fdc25e9a..1e15b24ddae 100644
--- a/base/poco/Net/src/HTTPSession.cpp
+++ b/base/poco/Net/src/HTTPSession.cpp
@@ -13,8 +13,8 @@
 
 
 #include "Poco/Net/HTTPSession.h"
-#include "Poco/Net/HTTPBufferAllocator.h"
 #include "Poco/Net/NetException.h"
+#include "Poco/Net/HTTPBasicStreamBuf.h"
 #include <cstring>
 
 
@@ -70,7 +70,7 @@ HTTPSession::~HTTPSession()
 {
 	try
 	{
-		if (_pBuffer) HTTPBufferAllocator::deallocate(_pBuffer, HTTPBufferAllocator::BUFFER_SIZE);
+		if (_pBuffer) delete[] _pBuffer;
 	}
 	catch (...)
 	{
@@ -177,10 +177,10 @@ void HTTPSession::refill()
 {
 	if (!_pBuffer)
 	{
-		_pBuffer = HTTPBufferAllocator::allocate(HTTPBufferAllocator::BUFFER_SIZE);
+		_pBuffer = new char[HTTP_DEFAULT_BUFFER_SIZE];
 	}
 	_pCurrent = _pEnd = _pBuffer;
-	int n = receive(_pBuffer, HTTPBufferAllocator::BUFFER_SIZE);
+	int n = receive(_pBuffer, HTTP_DEFAULT_BUFFER_SIZE);
 	_pEnd += n;
 }
 
diff --git a/base/poco/Net/src/HTTPStream.cpp b/base/poco/Net/src/HTTPStream.cpp
index 4acb881c4f3..c2f27600569 100644
--- a/base/poco/Net/src/HTTPStream.cpp
+++ b/base/poco/Net/src/HTTPStream.cpp
@@ -26,7 +26,7 @@ namespace Net {
 
 
 HTTPStreamBuf::HTTPStreamBuf(HTTPSession& session, openmode mode):
-	HTTPBasicStreamBuf(HTTPBufferAllocator::BUFFER_SIZE, mode),
+	HTTPBasicStreamBuf(HTTP_DEFAULT_BUFFER_SIZE, mode),
 	_session(session),
 	_mode(mode)
 {
@@ -96,10 +96,6 @@ HTTPStreamBuf* HTTPIOS::rdbuf()
 // HTTPInputStream
 //
 
-
-Poco::MemoryPool HTTPInputStream::_pool(sizeof(HTTPInputStream));
-
-
 HTTPInputStream::HTTPInputStream(HTTPSession& session):
 	HTTPIOS(session, std::ios::in),
 	std::istream(&_buf)
@@ -112,33 +108,11 @@ HTTPInputStream::~HTTPInputStream()
 }
 
 
-void* HTTPInputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPInputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 //
 // HTTPOutputStream
 //
 
 
-Poco::MemoryPool HTTPOutputStream::_pool(sizeof(HTTPOutputStream));
-
-
 HTTPOutputStream::HTTPOutputStream(HTTPSession& session):
 	HTTPIOS(session, std::ios::out),
 	std::ostream(&_buf)
@@ -150,24 +124,4 @@ HTTPOutputStream::~HTTPOutputStream()
 {
 }
 
-
-void* HTTPOutputStream::operator new(std::size_t size)
-{
-	return _pool.get();
-}
-
-
-void HTTPOutputStream::operator delete(void* ptr)
-{
-	try
-	{
-		_pool.release(ptr);
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
-}
-
-
 } } // namespace Poco::Net

From a74bc6190da07904116ffa36f6ee1340afb74c91 Mon Sep 17 00:00:00 2001
From: Alexander Sapin <alesapin@gmail.com>
Date: Mon, 3 Jul 2023 15:46:30 +0200
Subject: [PATCH 1463/1478] Implement suggestion

---
 base/poco/Net/include/Poco/Net/HTTPSession.h |  2 +-
 base/poco/Net/src/HTTPSession.cpp            | 16 ++++------------
 2 files changed, 5 insertions(+), 13 deletions(-)

diff --git a/base/poco/Net/include/Poco/Net/HTTPSession.h b/base/poco/Net/include/Poco/Net/HTTPSession.h
index d0045025f5f..934b34be5d5 100644
--- a/base/poco/Net/include/Poco/Net/HTTPSession.h
+++ b/base/poco/Net/include/Poco/Net/HTTPSession.h
@@ -192,7 +192,7 @@ namespace Net
         HTTPSession & operator=(const HTTPSession &);
 
         StreamSocket _socket;
-        char * _pBuffer;
+        std::unique_ptr<char[]> _pBuffer;
         char * _pCurrent;
         char * _pEnd;
         bool _keepAlive;
diff --git a/base/poco/Net/src/HTTPSession.cpp b/base/poco/Net/src/HTTPSession.cpp
index 1e15b24ddae..d2663baaf9f 100644
--- a/base/poco/Net/src/HTTPSession.cpp
+++ b/base/poco/Net/src/HTTPSession.cpp
@@ -68,14 +68,6 @@ HTTPSession::HTTPSession(const StreamSocket& socket, bool keepAlive):
 
 HTTPSession::~HTTPSession()
 {
-	try
-	{
-		if (_pBuffer) delete[] _pBuffer;
-	}
-	catch (...)
-	{
-		poco_unexpected();
-	}
 	try
 	{
 		close();
@@ -177,10 +169,10 @@ void HTTPSession::refill()
 {
 	if (!_pBuffer)
 	{
-		_pBuffer = new char[HTTP_DEFAULT_BUFFER_SIZE];
+		_pBuffer = std::make_unique<char[]>(HTTP_DEFAULT_BUFFER_SIZE);
 	}
-	_pCurrent = _pEnd = _pBuffer;
-	int n = receive(_pBuffer, HTTP_DEFAULT_BUFFER_SIZE);
+	_pCurrent = _pEnd = _pBuffer.get();
+	int n = receive(_pBuffer.get(), HTTP_DEFAULT_BUFFER_SIZE);
 	_pEnd += n;
 }
 
@@ -199,7 +191,7 @@ void HTTPSession::connect(const SocketAddress& address)
 	_socket.setNoDelay(true);
 	// There may be leftover data from a previous (failed) request in the buffer,
 	// so we clear it.
-	_pCurrent = _pEnd = _pBuffer;
+	_pCurrent = _pEnd = _pBuffer.get();
 }
 
 

From ebd7ecb230a101bc5bed7d3ad79c9f08cba523f5 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 25 May 2023 14:44:24 +0000
Subject: [PATCH 1464/1478] Remove unstable queries from
 performance/join_set_filter

---
 tests/performance/join_set_filter.xml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/tests/performance/join_set_filter.xml b/tests/performance/join_set_filter.xml
index 7f7804853fc..712b60ae12f 100644
--- a/tests/performance/join_set_filter.xml
+++ b/tests/performance/join_set_filter.xml
@@ -34,9 +34,6 @@
     <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
     <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
 
-    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 100 = 0</query>
-    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 100 = 0</query>
-
     <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
     <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
 

From 9ea5d929a5f80466d0be721266302b67c4e54fa0 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 1 Jun 2023 13:45:58 +0200
Subject: [PATCH 1465/1478] Update tests/performance/join_set_filter.xml

---
 tests/performance/join_set_filter.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/performance/join_set_filter.xml b/tests/performance/join_set_filter.xml
index 712b60ae12f..38ff9beb827 100644
--- a/tests/performance/join_set_filter.xml
+++ b/tests/performance/join_set_filter.xml
@@ -33,7 +33,8 @@
 
     <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
     <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
-
+    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 100 = 0 AND t1.y < 10000</query>
+    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 100 = 0 AND t1.y < 10000</query>
     <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
     <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
 

From 737cff7e5703941e1e05b4f9c70b18f1f508f2f8 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Mon, 3 Jul 2023 14:42:58 +0200
Subject: [PATCH 1466/1478] Remove whole join_set_filter.xml, will resubmit

---
 tests/performance/join_set_filter.xml | 43 ---------------------------
 1 file changed, 43 deletions(-)
 delete mode 100644 tests/performance/join_set_filter.xml

diff --git a/tests/performance/join_set_filter.xml b/tests/performance/join_set_filter.xml
deleted file mode 100644
index 38ff9beb827..00000000000
--- a/tests/performance/join_set_filter.xml
+++ /dev/null
@@ -1,43 +0,0 @@
-<test>
-    <substitutions>
-       <substitution>
-           <name>table_size</name>
-           <values>
-               <value>100000000</value>
-           </values>
-       </substitution>
-    </substitutions>
-
-    <settings>
-        <join_algorithm>full_sorting_merge</join_algorithm>
-    </settings>
-
-    <create_query>
-        CREATE TABLE t1 (x UInt64, y UInt64) ENGINE = MergeTree ORDER BY y
-        AS SELECT
-            sipHash64(number, 't1_x') % {table_size} AS x,
-            sipHash64(number, 't1_y') % {table_size} AS y
-        FROM numbers({table_size})
-    </create_query>
-
-    <create_query>
-        CREATE TABLE t2 (x UInt64, y UInt64) ENGINE = MergeTree ORDER BY y
-        AS SELECT
-            sipHash64(number, 't2_x') % {table_size} AS x,
-            sipHash64(number, 't2_y') % {table_size} AS y
-        FROM numbers({table_size})
-    </create_query>
-
-    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE less(t1.y, 10000)</query>
-    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE less(t1.y, 10000)</query>
-
-    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
-    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE greater(t1.y, {table_size} - 10000)</query>
-    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 100 = 0 AND t1.y < 10000</query>
-    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 100 = 0 AND t1.y < 10000</query>
-    <query>SELECT * FROM t1 JOIN t2 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
-    <query>SELECT * FROM t2 JOIN t1 ON t1.x = t2.x WHERE t1.y % 1000 = 0</query>
-
-    <drop_query>DROP TABLE IF EXISTS t1</drop_query>
-    <drop_query>DROP TABLE IF EXISTS t2</drop_query>
-</test>

From 509a0c6f30543b364f805deaca5ba8a025ab8538 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Mon, 3 Jul 2023 13:50:40 -0400
Subject: [PATCH 1467/1478] add missing doc templates back

---
 docs/_description_templates/template-data-type.md      | 1 +
 docs/_description_templates/template-engine.md         | 1 +
 docs/_description_templates/template-function.md       | 1 +
 docs/_description_templates/template-server-setting.md | 1 +
 docs/_description_templates/template-setting.md        | 1 +
 docs/_description_templates/template-statement.md      | 1 +
 docs/_description_templates/template-system-table.md   | 1 +
 7 files changed, 7 insertions(+)
 create mode 100644 docs/_description_templates/template-data-type.md
 create mode 100644 docs/_description_templates/template-engine.md
 create mode 100644 docs/_description_templates/template-function.md
 create mode 100644 docs/_description_templates/template-server-setting.md
 create mode 100644 docs/_description_templates/template-setting.md
 create mode 100644 docs/_description_templates/template-statement.md
 create mode 100644 docs/_description_templates/template-system-table.md

diff --git a/docs/_description_templates/template-data-type.md b/docs/_description_templates/template-data-type.md
new file mode 100644
index 00000000000..b66d77c7a77
--- /dev/null
+++ b/docs/_description_templates/template-data-type.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":14.564540000000001,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-data-type.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-data-type.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-data-type.md?raw=true","headerInfo":{"blobSize":"540 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"239edb2","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-data-type.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"data_type_name {#data_type-name}","anchor":"data_type_name-data_type-name","htmlText":"data_type_name {#data_type-name}"},{"level":2,"text":"Additional Info {#additional-info} (Optional)","anchor":"additional-info-additional-info-optional","htmlText":"Additional Info {#additional-info} (Optional)"}],"lineInfo":{"truncatedLoc":"29","truncatedSloc":"17"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-data-type.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><table>\n  <thead>\n  <tr>\n  <th>toc_priority</th>\n  <th>toc_title</th>\n  </tr>\n  </thead>\n  <tbody>\n  </tbody>\n</table>\n\n<h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-data_type_name-data_type-name\" class=\"anchor\" aria-hidden=\"true\" href=\"#data_type_name-data_type-name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>data_type_name {#data_type-name}</h1>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\"><strong>Parameters</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><code>x</code> — Description. <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n<li><code>y</code> — Description. <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Examples</strong></p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-additional-info-additional-info-optional\" class=\"anchor\" aria-hidden=\"true\" href=\"#additional-info-additional-info-optional\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Additional Info {#additional-info} (Optional)</h2>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n<p dir=\"auto\"><a href=\"https://clickhouse.com/docs/en/data-types/%3Cdata-type-name%3E/\" rel=\"nofollow\">Original article</a> </p>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"N-EHr0Rgr9I38z0iGu5sqtyb4o4AwtOW1kjllryDXwFKHQnulJDSASf5e_zz3Uts_O0aS5zN9jEL88ie9T5sww"}}},"title":"ClickHouse/docs/_description_templates/template-data-type.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-engine.md b/docs/_description_templates/template-engine.md
new file mode 100644
index 00000000000..c5bb5feb85d
--- /dev/null
+++ b/docs/_description_templates/template-engine.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":10.334819,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-engine.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-engine.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-engine.md?raw=true","headerInfo":{"blobSize":"1.19 KB","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"392bc59","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-engine.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"EngineName {#enginename}","anchor":"enginename-enginename","htmlText":"EngineName {#enginename}"},{"level":2,"text":"Creating a Database {#creating-a-database}","anchor":"creating-a-database-creating-a-database","htmlText":"Creating a Database {#creating-a-database}"},{"level":2,"text":"Creating a Table {#creating-a-table}","anchor":"creating-a-table-creating-a-table","htmlText":"Creating a Table {#creating-a-table}"},{"level":2,"text":"Virtual columns {#virtual-columns} (for Table engines only)","anchor":"virtual-columns-virtual-columns-for-table-engines-only","htmlText":"Virtual columns {#virtual-columns} (for Table engines only)"},{"level":2,"text":"Data Types Support {#data_types-support} (for Database engines only)","anchor":"data-types-support-data_types-support-for-database-engines-only","htmlText":"Data Types Support {#data_types-support} (for Database engines only)"},{"level":2,"text":"Specifics and recommendations {#specifics-and-recommendations}","anchor":"specifics-and-recommendations-specifics-and-recommendations","htmlText":"Specifics and recommendations {#specifics-and-recommendations}"},{"level":2,"text":"Usage Example {#usage-example}","anchor":"usage-example-usage-example","htmlText":"Usage Example {#usage-example}"}],"lineInfo":{"truncatedLoc":"63","truncatedSloc":"40"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-engine.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-enginename-enginename\" class=\"anchor\" aria-hidden=\"true\" href=\"#enginename-enginename\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>EngineName {#enginename}</h1>\n<ul dir=\"auto\">\n<li>What the Database/Table engine does.</li>\n<li>Relations with other engines if they exist.</li>\n</ul>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-creating-a-database-creating-a-database\" class=\"anchor\" aria-hidden=\"true\" href=\"#creating-a-database-creating-a-database\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Creating a Database {#creating-a-database}</h2>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"    CREATE DATABASE ...\"><pre>    CREATE DATABASE ...</pre></div>\n<p dir=\"auto\">or</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-creating-a-table-creating-a-table\" class=\"anchor\" aria-hidden=\"true\" href=\"#creating-a-table-creating-a-table\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Creating a Table {#creating-a-table}</h2>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"    CREATE TABLE ...\"><pre>    CREATE TABLE ...</pre></div>\n<p dir=\"auto\"><strong>Engine Parameters</strong></p>\n<p dir=\"auto\"><strong>Query Clauses</strong> (for Table engines only)</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-virtual-columns-virtual-columns-for-table-engines-only\" class=\"anchor\" aria-hidden=\"true\" href=\"#virtual-columns-virtual-columns-for-table-engines-only\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Virtual columns {#virtual-columns} (for Table engines only)</h2>\n<p dir=\"auto\">List and virtual columns with description, if they exist.</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-data-types-support-data_types-support-for-database-engines-only\" class=\"anchor\" aria-hidden=\"true\" href=\"#data-types-support-data_types-support-for-database-engines-only\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Data Types Support {#data_types-support} (for Database engines only)</h2>\n<table>\n<thead>\n<tr>\n<th>EngineName</th>\n<th>ClickHouse</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>NativeDataTypeName</td>\n<td><a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/link#\">ClickHouseDataTypeName</a></td>\n</tr>\n</tbody>\n</table>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-specifics-and-recommendations-specifics-and-recommendations\" class=\"anchor\" aria-hidden=\"true\" href=\"#specifics-and-recommendations-specifics-and-recommendations\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Specifics and recommendations {#specifics-and-recommendations}</h2>\n<p dir=\"auto\">Algorithms\nSpecifics of read and write processes\nExamples of tasks\nRecommendations for usage\nSpecifics of data storage</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-usage-example-usage-example\" class=\"anchor\" aria-hidden=\"true\" href=\"#usage-example-usage-example\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Usage Example {#usage-example}</h2>\n<p dir=\"auto\">The example must show usage and use cases. The following text contains the recommended parts of this section.</p>\n<p dir=\"auto\">Input table:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Follow up with any text to clarify the example.</p>\n<p dir=\"auto\"><strong>See Also</strong></p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"mbr-hnliBQCB5MoHGpQf6OTZtY7x7nHuM4vvq5uev5jkRvDHqZJ405HujNnzpzguxK9NS23hVEnuMMKj0iOMWg"}}},"title":"ClickHouse/docs/_description_templates/template-engine.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-function.md b/docs/_description_templates/template-function.md
new file mode 100644
index 00000000000..0891e5d872d
--- /dev/null
+++ b/docs/_description_templates/template-function.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":6.875799,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-function.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-function.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-function.md?raw=true","headerInfo":{"blobSize":"1.12 KB","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"6bdc764","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-function.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"functionName {#functionname-in-lower-case}","anchor":"functionname-functionname-in-lower-case","htmlText":"functionName {#functionname-in-lower-case}"}],"lineInfo":{"truncatedLoc":"51","truncatedSloc":"29"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-function.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-functionname-functionname-in-lower-case\" class=\"anchor\" aria-hidden=\"true\" href=\"#functionname-functionname-in-lower-case\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>functionName {#functionname-in-lower-case}</h2>\n<p dir=\"auto\">Short description.</p>\n<p dir=\"auto\"><strong>Syntax</strong> (without SELECT)</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"&lt;function syntax&gt;\"><pre><span class=\"pl-k\">&lt;</span>function syntax<span class=\"pl-k\">&gt;</span></pre></div>\n<p dir=\"auto\">Alias: <code>&lt;alias name&gt;</code>. (Optional)</p>\n<p dir=\"auto\">More text (Optional).</p>\n<p dir=\"auto\"><strong>Arguments</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><code>x</code> — Description. Optional (only for optional arguments). Possible values: . Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n<li><code>y</code> — Description. Optional (only for optional arguments). Possible values: .Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Parameters</strong> (Optional, only for parametric aggregate functions)</p>\n<ul dir=\"auto\">\n<li><code>z</code> — Description. Optional (only for optional parameters). Possible values: . Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Returned value(s)</strong></p>\n<ul dir=\"auto\">\n<li>Returned values list.</li>\n</ul>\n<p dir=\"auto\">Type: <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</p>\n<p dir=\"auto\"><strong>Example</strong></p>\n<p dir=\"auto\">The example must show usage and/or a use cases. The following text contains recommended parts of an example.</p>\n<p dir=\"auto\">Input table (Optional):</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"LBpdgwbUgHW-H_hinQl7e32v5vocOJKA0kZyCn6oG8tR5lPC1iT9pq4Vvrx0Oly9XdkeP4A3tycP_V8CNxUoCQ"}}},"title":"ClickHouse/docs/_description_templates/template-function.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-server-setting.md b/docs/_description_templates/template-server-setting.md
new file mode 100644
index 00000000000..fc474059f05
--- /dev/null
+++ b/docs/_description_templates/template-server-setting.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":7.7234929999999995,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-server-setting.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-server-setting.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-server-setting.md?raw=true","headerInfo":{"blobSize":"629 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"0b37d46","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-server-setting.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"server_setting_name {#server_setting_name}","anchor":"server_setting_name-server_setting_name","htmlText":"server_setting_name {#server_setting_name}"}],"lineInfo":{"truncatedLoc":"33","truncatedSloc":"20"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-server-setting.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-server_setting_name-server_setting_name\" class=\"anchor\" aria-hidden=\"true\" href=\"#server_setting_name-server_setting_name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>server_setting_name {#server_setting_name}</h2>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">Describe what is configured in this section of settings.</p>\n<p dir=\"auto\">Possible value: ...</p>\n<p dir=\"auto\">Default value: ...</p>\n<p dir=\"auto\"><strong>Settings</strong> (Optional)</p>\n<p dir=\"auto\">If the section contains several settings, list them here. Specify possible values and default values:</p>\n<ul dir=\"auto\">\n<li>setting_1 — Description.</li>\n<li>setting_2 — Description.</li>\n</ul>\n<p dir=\"auto\"><strong>Example</strong></p>\n<div class=\"highlight highlight-text-xml notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"&lt;server_setting_name&gt;\n    &lt;setting_1&gt; ... &lt;/setting_1&gt;\n    &lt;setting_2&gt; ... &lt;/setting_2&gt;\n&lt;/server_setting_name&gt;\"><pre>&lt;<span class=\"pl-ent\">server_setting_name</span>&gt;\n    &lt;<span class=\"pl-ent\">setting_1</span>&gt; ... &lt;/<span class=\"pl-ent\">setting_1</span>&gt;\n    &lt;<span class=\"pl-ent\">setting_2</span>&gt; ... &lt;/<span class=\"pl-ent\">setting_2</span>&gt;\n&lt;/<span class=\"pl-ent\">server_setting_name</span>&gt;</pre></div>\n<p dir=\"auto\"><strong>Additional Info</strong> (Optional)</p>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"a6lijUe_lOiTRf_mzmSRAi4tMYD_1HdAhwqytaKk2q8WVWzMl0_pO4NPuTgnV7bEDlvJRWPbUudasZ-96xnpbQ"}}},"title":"ClickHouse/docs/_description_templates/template-server-setting.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-setting.md b/docs/_description_templates/template-setting.md
new file mode 100644
index 00000000000..df51a7e8241
--- /dev/null
+++ b/docs/_description_templates/template-setting.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":9.96412,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-setting.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-setting.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-setting.md?raw=true","headerInfo":{"blobSize":"503 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"fc912ab","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-setting.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"setting_name {#setting_name}","anchor":"setting_name-setting_name","htmlText":"setting_name {#setting_name}"}],"lineInfo":{"truncatedLoc":"27","truncatedSloc":"15"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-setting.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-setting_name-setting_name\" class=\"anchor\" aria-hidden=\"true\" href=\"#setting_name-setting_name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>setting_name {#setting_name}</h2>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">For the switch setting, use the typical phrase: “Enables or disables something …”.</p>\n<p dir=\"auto\">Possible values:</p>\n<p dir=\"auto\"><em>For switcher setting:</em></p>\n<ul dir=\"auto\">\n<li>0 — Disabled.</li>\n<li>1 — Enabled.</li>\n</ul>\n<p dir=\"auto\"><em>For another setting (typical phrases):</em></p>\n<ul dir=\"auto\">\n<li>Positive integer.</li>\n<li>0 — Disabled or unlimited or something else.</li>\n</ul>\n<p dir=\"auto\">Default value: <code>value</code>.</p>\n<p dir=\"auto\"><strong>Additional Info</strong> (Optional)</p>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"gFv6-keA6Z1eYZATbMVq8_sVPc-l2b8pTaH03K1R_zf9p_S7l3CUTk5r1s2F9k0122PFCjnWmo6QGtnU5OzM9Q"}}},"title":"ClickHouse/docs/_description_templates/template-setting.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-statement.md b/docs/_description_templates/template-statement.md
new file mode 100644
index 00000000000..b5ae0d9b26b
--- /dev/null
+++ b/docs/_description_templates/template-statement.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":9.954742000000001,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-statement.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-statement.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-statement.md?raw=true","headerInfo":{"blobSize":"575 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"238570c","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-statement.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"Statement name (for example, SHOW USER) {#statement-name-in-lower-case}","anchor":"statement-name-for-example-show-user-statement-name-in-lower-case","htmlText":"Statement name (for example, SHOW USER) {#statement-name-in-lower-case}"},{"level":2,"text":"Other necessary sections of the description (Optional) {#anchor}","anchor":"other-necessary-sections-of-the-description-optional-anchor","htmlText":"Other necessary sections of the description (Optional) {#anchor}"}],"lineInfo":{"truncatedLoc":"24","truncatedSloc":"14"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-statement.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-statement-name-for-example-show-user-statement-name-in-lower-case\" class=\"anchor\" aria-hidden=\"true\" href=\"#statement-name-for-example-show-user-statement-name-in-lower-case\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Statement name (for example, SHOW USER) {#statement-name-in-lower-case}</h1>\n<p dir=\"auto\">Brief description of what the statement does.</p>\n<p dir=\"auto\"><strong>Syntax</strong></p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"Syntax of the statement.\"><pre>Syntax of the statement.</pre></div>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-other-necessary-sections-of-the-description-optional-anchor\" class=\"anchor\" aria-hidden=\"true\" href=\"#other-necessary-sections-of-the-description-optional-anchor\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Other necessary sections of the description (Optional) {#anchor}</h2>\n<p dir=\"auto\">Examples of descriptions with a complicated structure:</p>\n<ul dir=\"auto\">\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/grant/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/grant/</a></li>\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/revoke/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/revoke/</a></li>\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/select/join/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/select/join/</a></li>\n</ul>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<p dir=\"auto\">Links to related topics as a list.</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"xohFK8TmjwjnIXPER5IKigBaxPXoFkjI0tOrZrMZen-7dEtqFBby2_crNRquoS1MICw8MHQZbW8PaIZu-qRJvQ"}}},"title":"ClickHouse/docs/_description_templates/template-statement.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
diff --git a/docs/_description_templates/template-system-table.md b/docs/_description_templates/template-system-table.md
new file mode 100644
index 00000000000..02d622a52cf
--- /dev/null
+++ b/docs/_description_templates/template-system-table.md
@@ -0,0 +1 @@
+{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":8.697185,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-system-table.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-system-table.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-system-table.md?raw=true","headerInfo":{"blobSize":"381 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"f2decc4","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-system-table.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"system.table_name {#system-tables_table-name}","anchor":"systemtable_name-system-tables_table-name","htmlText":"system.table_name {#system-tables_table-name}"}],"lineInfo":{"truncatedLoc":"25","truncatedSloc":"15"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-system-table.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-systemtable_name-system-tables_table-name\" class=\"anchor\" aria-hidden=\"true\" href=\"#systemtable_name-system-tables_table-name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>system.table_name {#system-tables_table-name}</h1>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">Columns:</p>\n<ul dir=\"auto\">\n<li><code>column_name</code> (<a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/path/to/data_type.md\">data_type_name</a>) — Description.</li>\n</ul>\n<p dir=\"auto\"><strong>Example</strong></p>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"SELECT * FROM system.table_name\"><pre><span class=\"pl-k\">SELECT</span> <span class=\"pl-k\">*</span> <span class=\"pl-k\">FROM</span> <span class=\"pl-c1\">system</span>.<span class=\"pl-c1\">table_name</span></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Some output. It shouldn't be too long.\"><pre lang=\"text\" class=\"notranslate\"><code>Some output. It shouldn't be too long.\n</code></pre></div>\n<p dir=\"auto\"><strong>See Also</strong></p>\n<ul dir=\"auto\">\n<li><a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/path/to/article_name.md\">Article name</a> — Some words about referenced information.</li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"9K5xHq3WERnrVDYaCTfS2yzVWybDSHIH0WqtxpxdRGaJUn9ffSZsyvtecMTgBPUdDKOj419HV6AM0YDO1eB3pA"}}},"title":"ClickHouse/docs/_description_templates/template-system-table.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file

From 584b46c5ca358d077db30777a0050cf690166a08 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 30 Jun 2023 14:38:59 +0200
Subject: [PATCH 1468/1478] Add documentation for building in docker

---
 docs/en/development/build.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/en/development/build.md b/docs/en/development/build.md
index 83a4550df88..ab47ee8aac5 100644
--- a/docs/en/development/build.md
+++ b/docs/en/development/build.md
@@ -13,6 +13,20 @@ Supported platforms:
 - AArch64
 - Power9 (experimental)
 
+## Building in docker
+We use the docker image `clickhouse/binary-builder` for our CI builds. It contains everything necessary to build the binary and packages. There is a script `docker/packager/packager` to ease the image usage:
+
+```bash
+# define a directory for the output artifacts
+output_dir="build_results"
+# a simplest build
+./docker/packager/packager --package-type=binary --output-dir "$output_dir"
+# build debian packages
+./docker/packager/packager --package-type=deb --output-dir "$output_dir"
+# by default, debian packages use thin LTO, so we can override it to speed up the build
+CMAKE_FLAGS='-DENABLE_THINLTO=' ./docker/packager/packager --package-type=deb --output-dir "$output_dir"
+```
+
 ## Building on Ubuntu
 
 The following tutorial is based on Ubuntu Linux.

From c715ee5cef3646e9ce71a26c46d72fb91ff3d551 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 3 Jul 2023 17:28:48 +0200
Subject: [PATCH 1469/1478] Replace `--build-type=debug` by `--debug-build`

---
 docker/packager/README.md      |  2 +-
 docker/packager/packager       | 16 ++++++++--------
 tests/ci/build_check.py        |  6 +++---
 tests/ci/build_report_check.py |  4 ++--
 tests/ci/ci_config.py          | 34 +++++++++++++++++-----------------
 tests/ci/report.py             |  6 +++---
 6 files changed, 34 insertions(+), 34 deletions(-)

diff --git a/docker/packager/README.md b/docker/packager/README.md
index a78feb8d7fc..3a91f9a63f0 100644
--- a/docker/packager/README.md
+++ b/docker/packager/README.md
@@ -6,7 +6,7 @@ Usage:
 Build deb package with `clang-14` in `debug` mode:
 ```
 $ mkdir deb/test_output
-$ ./packager --output-dir deb/test_output/ --package-type deb --compiler=clang-14 --build-type=debug
+$ ./packager --output-dir deb/test_output/ --package-type deb --compiler=clang-14 --debug-build
 $ ls -l deb/test_output
 -rw-r--r-- 1 root root      3730 clickhouse-client_22.2.2+debug_all.deb
 -rw-r--r-- 1 root root  84221888 clickhouse-common-static_22.2.2+debug_amd64.deb
diff --git a/docker/packager/packager b/docker/packager/packager
index 1b3df858cd2..3c3304165b3 100755
--- a/docker/packager/packager
+++ b/docker/packager/packager
@@ -112,12 +112,12 @@ def run_docker_image_with_env(
     subprocess.check_call(cmd, shell=True)
 
 
-def is_release_build(build_type: str, package_type: str, sanitizer: str) -> bool:
-    return build_type == "" and package_type == "deb" and sanitizer == ""
+def is_release_build(debug_build: bool, package_type: str, sanitizer: str) -> bool:
+    return not debug_build and package_type == "deb" and sanitizer == ""
 
 
 def parse_env_variables(
-    build_type: str,
+    debug_build: bool,
     compiler: str,
     sanitizer: str,
     package_type: str,
@@ -233,7 +233,7 @@ def parse_env_variables(
         build_target = (
             f"{build_target} clickhouse-odbc-bridge clickhouse-library-bridge"
         )
-        if is_release_build(build_type, package_type, sanitizer):
+        if is_release_build(debug_build, package_type, sanitizer):
             cmake_flags.append("-DSPLIT_DEBUG_SYMBOLS=ON")
             result.append("WITH_PERFORMANCE=1")
             if is_cross_arm:
@@ -253,8 +253,8 @@ def parse_env_variables(
 
     if sanitizer:
         result.append(f"SANITIZER={sanitizer}")
-    if build_type:
-        result.append(f"BUILD_TYPE={build_type.capitalize()}")
+    if debug_build:
+        result.append("BUILD_TYPE=DEBUG")
     else:
         result.append("BUILD_TYPE=None")
 
@@ -359,7 +359,7 @@ def parse_args() -> argparse.Namespace:
         help="ClickHouse git repository",
     )
     parser.add_argument("--output-dir", type=dir_name, required=True)
-    parser.add_argument("--build-type", choices=("debug", ""), default="")
+    parser.add_argument("--debug-build", action="store_true")
 
     parser.add_argument(
         "--compiler",
@@ -464,7 +464,7 @@ def main():
         build_image(image_with_version, dockerfile)
 
     env_prepared = parse_env_variables(
-        args.build_type,
+        args.debug_build,
         args.compiler,
         args.sanitizer,
         args.package_type,
diff --git a/tests/ci/build_check.py b/tests/ci/build_check.py
index 35b98a7c3bb..2a636faf967 100644
--- a/tests/ci/build_check.py
+++ b/tests/ci/build_check.py
@@ -45,7 +45,7 @@ def _can_export_binaries(build_config: BuildConfig) -> bool:
         return False
     if build_config["sanitizer"] != "":
         return True
-    if build_config["build_type"] != "":
+    if build_config["debug_build"]:
         return True
     return False
 
@@ -66,8 +66,8 @@ def get_packager_cmd(
         f"--package-type={package_type} --compiler={comp}"
     )
 
-    if build_config["build_type"]:
-        cmd += f" --build-type={build_config['build_type']}"
+    if build_config["debug_build"]:
+        cmd += " --debug-build"
     if build_config["sanitizer"]:
         cmd += f" --sanitizer={build_config['sanitizer']}"
     if build_config["tidy"] == "enable":
diff --git a/tests/ci/build_report_check.py b/tests/ci/build_report_check.py
index 1362f3c8934..295b6cf9740 100644
--- a/tests/ci/build_report_check.py
+++ b/tests/ci/build_report_check.py
@@ -70,7 +70,7 @@ def get_failed_report(
     message = f"{job_name} failed"
     build_result = BuildResult(
         compiler="unknown",
-        build_type="unknown",
+        debug_build=False,
         sanitizer="unknown",
         status=message,
         elapsed_seconds=0,
@@ -85,7 +85,7 @@ def process_report(
     build_config = build_report["build_config"]
     build_result = BuildResult(
         compiler=build_config["compiler"],
-        build_type=build_config["build_type"],
+        debug_build=build_config["debug_build"],
         sanitizer=build_config["sanitizer"],
         status="success" if build_report["status"] else "failure",
         elapsed_seconds=build_report["elapsed_seconds"],
diff --git a/tests/ci/ci_config.py b/tests/ci/ci_config.py
index c680b5810fc..875c5a3c8bd 100644
--- a/tests/ci/ci_config.py
+++ b/tests/ci/ci_config.py
@@ -10,7 +10,7 @@ CI_CONFIG = {
     "build_config": {
         "package_release": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "deb",
             "static_binary_name": "amd64",
@@ -21,7 +21,7 @@ CI_CONFIG = {
         },
         "coverity": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "coverity",
             "tidy": "disable",
@@ -31,7 +31,7 @@ CI_CONFIG = {
         },
         "package_aarch64": {
             "compiler": "clang-16-aarch64",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "deb",
             "static_binary_name": "aarch64",
@@ -42,7 +42,7 @@ CI_CONFIG = {
         },
         "package_asan": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "address",
             "package_type": "deb",
             "tidy": "disable",
@@ -51,7 +51,7 @@ CI_CONFIG = {
         },
         "package_ubsan": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "undefined",
             "package_type": "deb",
             "tidy": "disable",
@@ -60,7 +60,7 @@ CI_CONFIG = {
         },
         "package_tsan": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "thread",
             "package_type": "deb",
             "tidy": "disable",
@@ -69,7 +69,7 @@ CI_CONFIG = {
         },
         "package_msan": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "memory",
             "package_type": "deb",
             "tidy": "disable",
@@ -78,7 +78,7 @@ CI_CONFIG = {
         },
         "package_debug": {
             "compiler": "clang-16",
-            "build_type": "debug",
+            "debug_build": True,
             "sanitizer": "",
             "package_type": "deb",
             "tidy": "disable",
@@ -87,7 +87,7 @@ CI_CONFIG = {
         },
         "binary_release": {
             "compiler": "clang-16",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "tidy": "disable",
@@ -96,7 +96,7 @@ CI_CONFIG = {
         },
         "binary_tidy": {
             "compiler": "clang-16",
-            "build_type": "debug",
+            "debug_build": True,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "debug-amd64",
@@ -106,7 +106,7 @@ CI_CONFIG = {
         },
         "binary_darwin": {
             "compiler": "clang-16-darwin",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "macos",
@@ -116,7 +116,7 @@ CI_CONFIG = {
         },
         "binary_aarch64": {
             "compiler": "clang-16-aarch64",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "tidy": "disable",
@@ -125,7 +125,7 @@ CI_CONFIG = {
         },
         "binary_aarch64_v80compat": {
             "compiler": "clang-16-aarch64-v80compat",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "aarch64v80compat",
@@ -135,7 +135,7 @@ CI_CONFIG = {
         },
         "binary_freebsd": {
             "compiler": "clang-16-freebsd",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "freebsd",
@@ -145,7 +145,7 @@ CI_CONFIG = {
         },
         "binary_darwin_aarch64": {
             "compiler": "clang-16-darwin-aarch64",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "macos-aarch64",
@@ -155,7 +155,7 @@ CI_CONFIG = {
         },
         "binary_ppc64le": {
             "compiler": "clang-16-ppc64le",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "powerpc64le",
@@ -165,7 +165,7 @@ CI_CONFIG = {
         },
         "binary_amd64_compat": {
             "compiler": "clang-16-amd64-compat",
-            "build_type": "",
+            "debug_build": False,
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "amd64compat",
diff --git a/tests/ci/report.py b/tests/ci/report.py
index a9014acec12..0f84fbcaeb2 100644
--- a/tests/ci/report.py
+++ b/tests/ci/report.py
@@ -239,7 +239,7 @@ def read_test_results(results_path: Path, with_raw_logs: bool = True) -> TestRes
 @dataclass
 class BuildResult:
     compiler: str
-    build_type: str
+    debug_build: bool
     sanitizer: str
     status: str
     elapsed_seconds: int
@@ -484,8 +484,8 @@ def create_build_html_report(
     ):
         row = "<tr>"
         row += f"<td>{build_result.compiler}</td>"
-        if build_result.build_type:
-            row += f"<td>{build_result.build_type}</td>"
+        if build_result.debug_build:
+            row += "<td>debug</td>"
         else:
             row += "<td>relwithdebuginfo</td>"
         if build_result.sanitizer:

From 4191e3eb952bdcc136da29213f8a74d895a12ee6 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Mon, 3 Jul 2023 14:15:20 -0400
Subject: [PATCH 1470/1478] add missing doc templates back

---
 .../template-data-type.md                     | 30 ++++++++-
 .../_description_templates/template-engine.md | 64 ++++++++++++++++++-
 .../template-function.md                      | 52 ++++++++++++++-
 .../template-server-setting.md                | 34 +++++++++-
 .../template-setting.md                       | 28 +++++++-
 .../template-statement.md                     | 25 +++++++-
 .../template-system-table.md                  | 26 +++++++-
 7 files changed, 252 insertions(+), 7 deletions(-)

diff --git a/docs/_description_templates/template-data-type.md b/docs/_description_templates/template-data-type.md
index b66d77c7a77..239edb2808b 100644
--- a/docs/_description_templates/template-data-type.md
+++ b/docs/_description_templates/template-data-type.md
@@ -1 +1,29 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":14.564540000000001,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-data-type.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-data-type.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-data-type.md?raw=true","headerInfo":{"blobSize":"540 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"239edb2","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-data-type.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"data_type_name {#data_type-name}","anchor":"data_type_name-data_type-name","htmlText":"data_type_name {#data_type-name}"},{"level":2,"text":"Additional Info {#additional-info} (Optional)","anchor":"additional-info-additional-info-optional","htmlText":"Additional Info {#additional-info} (Optional)"}],"lineInfo":{"truncatedLoc":"29","truncatedSloc":"17"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-data-type.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><table>\n  <thead>\n  <tr>\n  <th>toc_priority</th>\n  <th>toc_title</th>\n  </tr>\n  </thead>\n  <tbody>\n  </tbody>\n</table>\n\n<h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-data_type_name-data_type-name\" class=\"anchor\" aria-hidden=\"true\" href=\"#data_type_name-data_type-name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>data_type_name {#data_type-name}</h1>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\"><strong>Parameters</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><code>x</code> — Description. <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n<li><code>y</code> — Description. <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Examples</strong></p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-additional-info-additional-info-optional\" class=\"anchor\" aria-hidden=\"true\" href=\"#additional-info-additional-info-optional\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Additional Info {#additional-info} (Optional)</h2>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n<p dir=\"auto\"><a href=\"https://clickhouse.com/docs/en/data-types/%3Cdata-type-name%3E/\" rel=\"nofollow\">Original article</a> </p>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"N-EHr0Rgr9I38z0iGu5sqtyb4o4AwtOW1kjllryDXwFKHQnulJDSASf5e_zz3Uts_O0aS5zN9jEL88ie9T5sww"}}},"title":"ClickHouse/docs/_description_templates/template-data-type.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+---
+toc_priority:
+toc_title:
+---
+
+# data_type_name {#data_type-name}
+
+Description.
+
+**Parameters** (Optional)
+
+-   `x` — Description. [Type name](relative/path/to/type/dscr.md#type).
+-   `y` — Description. [Type name](relative/path/to/type/dscr.md#type).
+
+**Examples**
+
+```sql
+
+```
+
+## Additional Info {#additional-info} (Optional)
+
+The name of an additional section can be any, for example, **Usage**.
+
+**See Also** (Optional)
+
+-   [link](#)
+
+[Original article](https://clickhouse.com/docs/en/data-types/<data-type-name>/) <!--hide-->
diff --git a/docs/_description_templates/template-engine.md b/docs/_description_templates/template-engine.md
index c5bb5feb85d..392bc59ed33 100644
--- a/docs/_description_templates/template-engine.md
+++ b/docs/_description_templates/template-engine.md
@@ -1 +1,63 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":10.334819,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-engine.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-engine.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-engine.md?raw=true","headerInfo":{"blobSize":"1.19 KB","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"392bc59","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-engine.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"EngineName {#enginename}","anchor":"enginename-enginename","htmlText":"EngineName {#enginename}"},{"level":2,"text":"Creating a Database {#creating-a-database}","anchor":"creating-a-database-creating-a-database","htmlText":"Creating a Database {#creating-a-database}"},{"level":2,"text":"Creating a Table {#creating-a-table}","anchor":"creating-a-table-creating-a-table","htmlText":"Creating a Table {#creating-a-table}"},{"level":2,"text":"Virtual columns {#virtual-columns} (for Table engines only)","anchor":"virtual-columns-virtual-columns-for-table-engines-only","htmlText":"Virtual columns {#virtual-columns} (for Table engines only)"},{"level":2,"text":"Data Types Support {#data_types-support} (for Database engines only)","anchor":"data-types-support-data_types-support-for-database-engines-only","htmlText":"Data Types Support {#data_types-support} (for Database engines only)"},{"level":2,"text":"Specifics and recommendations {#specifics-and-recommendations}","anchor":"specifics-and-recommendations-specifics-and-recommendations","htmlText":"Specifics and recommendations {#specifics-and-recommendations}"},{"level":2,"text":"Usage Example {#usage-example}","anchor":"usage-example-usage-example","htmlText":"Usage Example {#usage-example}"}],"lineInfo":{"truncatedLoc":"63","truncatedSloc":"40"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-engine.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-enginename-enginename\" class=\"anchor\" aria-hidden=\"true\" href=\"#enginename-enginename\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>EngineName {#enginename}</h1>\n<ul dir=\"auto\">\n<li>What the Database/Table engine does.</li>\n<li>Relations with other engines if they exist.</li>\n</ul>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-creating-a-database-creating-a-database\" class=\"anchor\" aria-hidden=\"true\" href=\"#creating-a-database-creating-a-database\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Creating a Database {#creating-a-database}</h2>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"    CREATE DATABASE ...\"><pre>    CREATE DATABASE ...</pre></div>\n<p dir=\"auto\">or</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-creating-a-table-creating-a-table\" class=\"anchor\" aria-hidden=\"true\" href=\"#creating-a-table-creating-a-table\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Creating a Table {#creating-a-table}</h2>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"    CREATE TABLE ...\"><pre>    CREATE TABLE ...</pre></div>\n<p dir=\"auto\"><strong>Engine Parameters</strong></p>\n<p dir=\"auto\"><strong>Query Clauses</strong> (for Table engines only)</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-virtual-columns-virtual-columns-for-table-engines-only\" class=\"anchor\" aria-hidden=\"true\" href=\"#virtual-columns-virtual-columns-for-table-engines-only\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Virtual columns {#virtual-columns} (for Table engines only)</h2>\n<p dir=\"auto\">List and virtual columns with description, if they exist.</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-data-types-support-data_types-support-for-database-engines-only\" class=\"anchor\" aria-hidden=\"true\" href=\"#data-types-support-data_types-support-for-database-engines-only\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Data Types Support {#data_types-support} (for Database engines only)</h2>\n<table>\n<thead>\n<tr>\n<th>EngineName</th>\n<th>ClickHouse</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>NativeDataTypeName</td>\n<td><a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/link#\">ClickHouseDataTypeName</a></td>\n</tr>\n</tbody>\n</table>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-specifics-and-recommendations-specifics-and-recommendations\" class=\"anchor\" aria-hidden=\"true\" href=\"#specifics-and-recommendations-specifics-and-recommendations\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Specifics and recommendations {#specifics-and-recommendations}</h2>\n<p dir=\"auto\">Algorithms\nSpecifics of read and write processes\nExamples of tasks\nRecommendations for usage\nSpecifics of data storage</p>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-usage-example-usage-example\" class=\"anchor\" aria-hidden=\"true\" href=\"#usage-example-usage-example\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Usage Example {#usage-example}</h2>\n<p dir=\"auto\">The example must show usage and use cases. The following text contains the recommended parts of this section.</p>\n<p dir=\"auto\">Input table:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Follow up with any text to clarify the example.</p>\n<p dir=\"auto\"><strong>See Also</strong></p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"mbr-hnliBQCB5MoHGpQf6OTZtY7x7nHuM4vvq5uev5jkRvDHqZJ405HujNnzpzguxK9NS23hVEnuMMKj0iOMWg"}}},"title":"ClickHouse/docs/_description_templates/template-engine.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+# EngineName {#enginename}
+
+-   What the Database/Table engine does.
+-   Relations with other engines if they exist.
+
+## Creating a Database {#creating-a-database}
+``` sql
+    CREATE DATABASE ...
+```
+or
+
+## Creating a Table {#creating-a-table}
+``` sql
+    CREATE TABLE ...
+```
+
+**Engine Parameters**
+
+**Query Clauses** (for Table engines only)
+
+## Virtual columns {#virtual-columns} (for Table engines only)
+
+List and virtual columns with description, if they exist.
+
+## Data Types Support {#data_types-support} (for Database engines only)
+
+|  EngineName           | ClickHouse                         |
+|-----------------------|------------------------------------|
+| NativeDataTypeName    | [ClickHouseDataTypeName](link#)    |
+
+
+## Specifics and recommendations {#specifics-and-recommendations}
+
+Algorithms
+Specifics of read and write processes
+Examples of tasks
+Recommendations for usage
+Specifics of data storage
+
+## Usage Example {#usage-example}
+
+The example must show usage and use cases. The following text contains the recommended parts of this section.
+
+Input table:
+
+``` text
+```
+
+Query:
+
+``` sql
+```
+
+Result:
+
+``` text
+```
+
+Follow up with any text to clarify the example.
+
+**See Also**
+
+-   [link](#)
diff --git a/docs/_description_templates/template-function.md b/docs/_description_templates/template-function.md
index 0891e5d872d..6bdc764c449 100644
--- a/docs/_description_templates/template-function.md
+++ b/docs/_description_templates/template-function.md
@@ -1 +1,51 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":6.875799,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-function.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-function.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-function.md?raw=true","headerInfo":{"blobSize":"1.12 KB","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"6bdc764","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-function.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"functionName {#functionname-in-lower-case}","anchor":"functionname-functionname-in-lower-case","htmlText":"functionName {#functionname-in-lower-case}"}],"lineInfo":{"truncatedLoc":"51","truncatedSloc":"29"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-function.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-functionname-functionname-in-lower-case\" class=\"anchor\" aria-hidden=\"true\" href=\"#functionname-functionname-in-lower-case\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>functionName {#functionname-in-lower-case}</h2>\n<p dir=\"auto\">Short description.</p>\n<p dir=\"auto\"><strong>Syntax</strong> (without SELECT)</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"&lt;function syntax&gt;\"><pre><span class=\"pl-k\">&lt;</span>function syntax<span class=\"pl-k\">&gt;</span></pre></div>\n<p dir=\"auto\">Alias: <code>&lt;alias name&gt;</code>. (Optional)</p>\n<p dir=\"auto\">More text (Optional).</p>\n<p dir=\"auto\"><strong>Arguments</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><code>x</code> — Description. Optional (only for optional arguments). Possible values: . Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n<li><code>y</code> — Description. Optional (only for optional arguments). Possible values: .Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Parameters</strong> (Optional, only for parametric aggregate functions)</p>\n<ul dir=\"auto\">\n<li><code>z</code> — Description. Optional (only for optional parameters). Possible values: . Default value: . <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</li>\n</ul>\n<p dir=\"auto\"><strong>Returned value(s)</strong></p>\n<ul dir=\"auto\">\n<li>Returned values list.</li>\n</ul>\n<p dir=\"auto\">Type: <a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/relative/path/to/type/dscr.md#type\">Type name</a>.</p>\n<p dir=\"auto\"><strong>Example</strong></p>\n<p dir=\"auto\">The example must show usage and/or a use cases. The following text contains recommended parts of an example.</p>\n<p dir=\"auto\">Input table (Optional):</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"\"><pre></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"\"><pre lang=\"text\" class=\"notranslate\"><code></code></pre></div>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"LBpdgwbUgHW-H_hinQl7e32v5vocOJKA0kZyCn6oG8tR5lPC1iT9pq4Vvrx0Oly9XdkeP4A3tycP_V8CNxUoCQ"}}},"title":"ClickHouse/docs/_description_templates/template-function.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+## functionName {#functionname-in-lower-case}
+
+Short description.
+
+**Syntax** (without SELECT)
+
+``` sql
+<function syntax>
+```
+
+Alias: `<alias name>`. (Optional)
+
+More text (Optional).
+
+**Arguments** (Optional)
+
+-   `x` — Description. Optional (only for optional arguments). Possible values: <values list>. Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
+-   `y` — Description. Optional (only for optional arguments). Possible values: <values list>.Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
+
+**Parameters** (Optional, only for parametric aggregate functions)
+
+-   `z` — Description. Optional (only for optional parameters). Possible values: <values list>. Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
+
+**Returned value(s)**
+
+-   Returned values list.
+
+Type: [Type name](relative/path/to/type/dscr.md#type).
+
+**Example**
+
+The example must show usage and/or a use cases. The following text contains recommended parts of an example.
+
+Input table (Optional):
+
+``` text
+```
+
+Query:
+
+``` sql
+```
+
+Result:
+
+``` text
+```
+
+**See Also** (Optional)
+
+-   [link](#)
diff --git a/docs/_description_templates/template-server-setting.md b/docs/_description_templates/template-server-setting.md
index fc474059f05..0b37d46cf41 100644
--- a/docs/_description_templates/template-server-setting.md
+++ b/docs/_description_templates/template-server-setting.md
@@ -1 +1,33 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":7.7234929999999995,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-server-setting.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-server-setting.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-server-setting.md?raw=true","headerInfo":{"blobSize":"629 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"0b37d46","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-server-setting.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"server_setting_name {#server_setting_name}","anchor":"server_setting_name-server_setting_name","htmlText":"server_setting_name {#server_setting_name}"}],"lineInfo":{"truncatedLoc":"33","truncatedSloc":"20"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-server-setting.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-server_setting_name-server_setting_name\" class=\"anchor\" aria-hidden=\"true\" href=\"#server_setting_name-server_setting_name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>server_setting_name {#server_setting_name}</h2>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">Describe what is configured in this section of settings.</p>\n<p dir=\"auto\">Possible value: ...</p>\n<p dir=\"auto\">Default value: ...</p>\n<p dir=\"auto\"><strong>Settings</strong> (Optional)</p>\n<p dir=\"auto\">If the section contains several settings, list them here. Specify possible values and default values:</p>\n<ul dir=\"auto\">\n<li>setting_1 — Description.</li>\n<li>setting_2 — Description.</li>\n</ul>\n<p dir=\"auto\"><strong>Example</strong></p>\n<div class=\"highlight highlight-text-xml notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"&lt;server_setting_name&gt;\n    &lt;setting_1&gt; ... &lt;/setting_1&gt;\n    &lt;setting_2&gt; ... &lt;/setting_2&gt;\n&lt;/server_setting_name&gt;\"><pre>&lt;<span class=\"pl-ent\">server_setting_name</span>&gt;\n    &lt;<span class=\"pl-ent\">setting_1</span>&gt; ... &lt;/<span class=\"pl-ent\">setting_1</span>&gt;\n    &lt;<span class=\"pl-ent\">setting_2</span>&gt; ... &lt;/<span class=\"pl-ent\">setting_2</span>&gt;\n&lt;/<span class=\"pl-ent\">server_setting_name</span>&gt;</pre></div>\n<p dir=\"auto\"><strong>Additional Info</strong> (Optional)</p>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"a6lijUe_lOiTRf_mzmSRAi4tMYD_1HdAhwqytaKk2q8WVWzMl0_pO4NPuTgnV7bEDlvJRWPbUudasZ-96xnpbQ"}}},"title":"ClickHouse/docs/_description_templates/template-server-setting.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+## server_setting_name {#server_setting_name}
+
+Description.
+
+Describe what is configured in this section of settings.
+
+Possible value: ...
+
+Default value: ...
+
+**Settings** (Optional)
+
+If the section contains several settings, list them here. Specify possible values and default values:
+
+-   setting_1 — Description.
+-   setting_2 — Description.
+
+**Example**
+
+```xml
+<server_setting_name>
+    <setting_1> ... </setting_1>
+    <setting_2> ... </setting_2>
+</server_setting_name>
+```
+
+**Additional Info** (Optional)
+
+The name of an additional section can be any, for example, **Usage**.
+
+**See Also** (Optional)
+
+-   [link](#)
diff --git a/docs/_description_templates/template-setting.md b/docs/_description_templates/template-setting.md
index df51a7e8241..fc912aba3e1 100644
--- a/docs/_description_templates/template-setting.md
+++ b/docs/_description_templates/template-setting.md
@@ -1 +1,27 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":9.96412,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-setting.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-setting.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-setting.md?raw=true","headerInfo":{"blobSize":"503 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"fc912ab","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-setting.md","isCSV":false,"isRichtext":true,"toc":[{"level":2,"text":"setting_name {#setting_name}","anchor":"setting_name-setting_name","htmlText":"setting_name {#setting_name}"}],"lineInfo":{"truncatedLoc":"27","truncatedSloc":"15"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-setting.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-setting_name-setting_name\" class=\"anchor\" aria-hidden=\"true\" href=\"#setting_name-setting_name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>setting_name {#setting_name}</h2>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">For the switch setting, use the typical phrase: “Enables or disables something …”.</p>\n<p dir=\"auto\">Possible values:</p>\n<p dir=\"auto\"><em>For switcher setting:</em></p>\n<ul dir=\"auto\">\n<li>0 — Disabled.</li>\n<li>1 — Enabled.</li>\n</ul>\n<p dir=\"auto\"><em>For another setting (typical phrases):</em></p>\n<ul dir=\"auto\">\n<li>Positive integer.</li>\n<li>0 — Disabled or unlimited or something else.</li>\n</ul>\n<p dir=\"auto\">Default value: <code>value</code>.</p>\n<p dir=\"auto\"><strong>Additional Info</strong> (Optional)</p>\n<p dir=\"auto\">The name of an additional section can be any, for example, <strong>Usage</strong>.</p>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"gFv6-keA6Z1eYZATbMVq8_sVPc-l2b8pTaH03K1R_zf9p_S7l3CUTk5r1s2F9k0122PFCjnWmo6QGtnU5OzM9Q"}}},"title":"ClickHouse/docs/_description_templates/template-setting.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+## setting_name {#setting_name}
+
+Description.
+
+For the switch setting, use the typical phrase: “Enables or disables something …”.
+
+Possible values:
+
+*For switcher setting:*
+
+-   0 — Disabled.
+-   1 — Enabled.
+
+*For another setting (typical phrases):*
+
+-   Positive integer.
+-   0 — Disabled or unlimited or something else.
+
+Default value: `value`.
+
+**Additional Info** (Optional)
+
+The name of an additional section can be any, for example, **Usage**.
+
+**See Also** (Optional)
+
+-   [link](#)
diff --git a/docs/_description_templates/template-statement.md b/docs/_description_templates/template-statement.md
index b5ae0d9b26b..238570c2217 100644
--- a/docs/_description_templates/template-statement.md
+++ b/docs/_description_templates/template-statement.md
@@ -1 +1,24 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":9.954742000000001,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-statement.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-statement.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-statement.md?raw=true","headerInfo":{"blobSize":"575 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"238570c","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-statement.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"Statement name (for example, SHOW USER) {#statement-name-in-lower-case}","anchor":"statement-name-for-example-show-user-statement-name-in-lower-case","htmlText":"Statement name (for example, SHOW USER) {#statement-name-in-lower-case}"},{"level":2,"text":"Other necessary sections of the description (Optional) {#anchor}","anchor":"other-necessary-sections-of-the-description-optional-anchor","htmlText":"Other necessary sections of the description (Optional) {#anchor}"}],"lineInfo":{"truncatedLoc":"24","truncatedSloc":"14"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-statement.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-statement-name-for-example-show-user-statement-name-in-lower-case\" class=\"anchor\" aria-hidden=\"true\" href=\"#statement-name-for-example-show-user-statement-name-in-lower-case\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Statement name (for example, SHOW USER) {#statement-name-in-lower-case}</h1>\n<p dir=\"auto\">Brief description of what the statement does.</p>\n<p dir=\"auto\"><strong>Syntax</strong></p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"Syntax of the statement.\"><pre>Syntax of the statement.</pre></div>\n<h2 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-other-necessary-sections-of-the-description-optional-anchor\" class=\"anchor\" aria-hidden=\"true\" href=\"#other-necessary-sections-of-the-description-optional-anchor\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>Other necessary sections of the description (Optional) {#anchor}</h2>\n<p dir=\"auto\">Examples of descriptions with a complicated structure:</p>\n<ul dir=\"auto\">\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/grant/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/grant/</a></li>\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/revoke/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/revoke/</a></li>\n<li><a href=\"https://clickhouse.com/docs/en/sql-reference/statements/select/join/\" rel=\"nofollow\">https://clickhouse.com/docs/en/sql-reference/statements/select/join/</a></li>\n</ul>\n<p dir=\"auto\"><strong>See Also</strong> (Optional)</p>\n<p dir=\"auto\">Links to related topics as a list.</p>\n<ul dir=\"auto\">\n<li><a href=\"#\">link</a></li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"xohFK8TmjwjnIXPER5IKigBaxPXoFkjI0tOrZrMZen-7dEtqFBby2_crNRquoS1MICw8MHQZbW8PaIZu-qRJvQ"}}},"title":"ClickHouse/docs/_description_templates/template-statement.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+# Statement name (for example, SHOW USER) {#statement-name-in-lower-case}
+
+Brief description of what the statement does.
+
+**Syntax**
+
+```sql
+Syntax of the statement.
+```
+
+## Other necessary sections of the description (Optional) {#anchor}
+
+Examples of descriptions with a complicated structure:
+
+- https://clickhouse.com/docs/en/sql-reference/statements/grant/
+- https://clickhouse.com/docs/en/sql-reference/statements/revoke/
+- https://clickhouse.com/docs/en/sql-reference/statements/select/join/
+
+
+**See Also** (Optional)
+
+Links to related topics as a list.
+
+-   [link](#)
diff --git a/docs/_description_templates/template-system-table.md b/docs/_description_templates/template-system-table.md
index 02d622a52cf..f2decc4bb6d 100644
--- a/docs/_description_templates/template-system-table.md
+++ b/docs/_description_templates/template-system-table.md
@@ -1 +1,25 @@
-{"payload":{"allShortcutsEnabled":true,"fileTree":{"docs/_description_templates":{"items":[{"name":"template-data-type.md","path":"docs/_description_templates/template-data-type.md","contentType":"file"},{"name":"template-engine.md","path":"docs/_description_templates/template-engine.md","contentType":"file"},{"name":"template-function.md","path":"docs/_description_templates/template-function.md","contentType":"file"},{"name":"template-server-setting.md","path":"docs/_description_templates/template-server-setting.md","contentType":"file"},{"name":"template-setting.md","path":"docs/_description_templates/template-setting.md","contentType":"file"},{"name":"template-statement.md","path":"docs/_description_templates/template-statement.md","contentType":"file"},{"name":"template-system-table.md","path":"docs/_description_templates/template-system-table.md","contentType":"file"}],"totalCount":7},"docs":{"items":[{"name":"_description_templates","path":"docs/_description_templates","contentType":"directory"},{"name":"_includes","path":"docs/_includes","contentType":"directory"},{"name":"changelogs","path":"docs/changelogs","contentType":"directory"},{"name":"en","path":"docs/en","contentType":"directory"},{"name":"ru","path":"docs/ru","contentType":"directory"},{"name":"tools","path":"docs/tools","contentType":"directory"},{"name":"zh","path":"docs/zh","contentType":"directory"},{"name":".gitignore","path":"docs/.gitignore","contentType":"file"},{"name":"README.md","path":"docs/README.md","contentType":"file"},{"name":"clean","path":"docs/clean","contentType":"file"},{"name":"mkdocs.yml","path":"docs/mkdocs.yml","contentType":"file"},{"name":"redirects.txt","path":"docs/redirects.txt","contentType":"file"}],"totalCount":12},"":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"base","path":"base","contentType":"directory"},{"name":"benchmark","path":"benchmark","contentType":"directory"},{"name":"cmake","path":"cmake","contentType":"directory"},{"name":"contrib","path":"contrib","contentType":"directory"},{"name":"docker","path":"docker","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"packages","path":"packages","contentType":"directory"},{"name":"programs","path":"programs","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"tests","path":"tests","contentType":"directory"},{"name":"utils","path":"utils","contentType":"directory"},{"name":"website","path":"website","contentType":"directory"},{"name":".clang-format","path":".clang-format","contentType":"file"},{"name":".clang-tidy","path":".clang-tidy","contentType":"file"},{"name":".editorconfig","path":".editorconfig","contentType":"file"},{"name":".gitattributes","path":".gitattributes","contentType":"file"},{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":".gitmodules","path":".gitmodules","contentType":"file"},{"name":".pylintrc","path":".pylintrc","contentType":"file"},{"name":".vimrc","path":".vimrc","contentType":"file"},{"name":".yamllint","path":".yamllint","contentType":"file"},{"name":"AUTHORS","path":"AUTHORS","contentType":"file"},{"name":"CHANGELOG.md","path":"CHANGELOG.md","contentType":"file"},{"name":"CMakeLists.txt","path":"CMakeLists.txt","contentType":"file"},{"name":"CODE_OF_CONDUCT.md","path":"CODE_OF_CONDUCT.md","contentType":"file"},{"name":"CONTRIBUTING.md","path":"CONTRIBUTING.md","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"PreLoad.cmake","path":"PreLoad.cmake","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"SECURITY.md","path":"SECURITY.md","contentType":"file"},{"name":"format_sources","path":"format_sources","contentType":"file"}],"totalCount":32}},"fileTreeProcessingTime":8.697185,"foldersToFetch":[],"reducedMotionEnabled":"system","repo":{"id":60246359,"defaultBranch":"master","name":"ClickHouse","ownerLogin":"ClickHouse","currentUserCanPush":true,"isFork":false,"isEmpty":false,"createdAt":"2016-06-02T04:28:18.000-04:00","ownerAvatar":"https://avatars.githubusercontent.com/u/54801242?v=4","public":true,"private":false,"isOrgOwned":true},"refInfo":{"name":"5f18640215159ed1ad50be1efce2cb996a49fd73","listCacheKey":"v0:1688403108.0","canEdit":false,"refType":"tree","currentOid":"5f18640215159ed1ad50be1efce2cb996a49fd73"},"path":"docs/_description_templates/template-system-table.md","currentUser":{"id":25182304,"login":"DanRoscigno","userEmail":"dan@roscigno.com"},"blob":{"rawBlob":null,"colorizedLines":null,"stylingDirectives":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":null,"configFilePath":null,"networkDependabotPath":"/ClickHouse/ClickHouse/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":false,"repoAlertsPath":"/ClickHouse/ClickHouse/security/dependabot","repoSecurityAndAnalysisPath":"/ClickHouse/ClickHouse/settings/security_analysis","repoOwnerIsOrg":true,"currentUserCanAdminRepo":false},"displayName":"template-system-table.md","displayUrl":"https://github.com/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-system-table.md?raw=true","headerInfo":{"blobSize":"381 Bytes","deleteInfo":{"deletePath":null,"deleteTooltip":"You must be on a branch to make or propose changes to this file"},"editInfo":{"editTooltip":"You must be on a branch to make or propose changes to this file"},"ghDesktopPath":null,"gitLfsPath":null,"onBranch":false,"shortPath":"f2decc4","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2FClickHouse%2FClickHouse%2Fblob%2F5f18640215159ed1ad50be1efce2cb996a49fd73%2Fdocs%2F_description_templates%2Ftemplate-system-table.md","isCSV":false,"isRichtext":true,"toc":[{"level":1,"text":"system.table_name {#system-tables_table-name}","anchor":"systemtable_name-system-tables_table-name","htmlText":"system.table_name {#system-tables_table-name}"}],"lineInfo":{"truncatedLoc":"25","truncatedSloc":"15"},"mode":"file"},"image":false,"isCodeownersFile":null,"isValidLegacyIssueTemplate":false,"issueTemplateHelpUrl":"https://docs.github.com/articles/about-issue-and-pull-request-templates","issueTemplate":null,"discussionTemplate":null,"language":"Markdown","large":false,"loggedIn":true,"newDiscussionPath":"/ClickHouse/ClickHouse/discussions/new","newIssuePath":"/ClickHouse/ClickHouse/issues/new","planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/template-system-table.md","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","dismissStackNoticePath":"/settings/dismiss-notice/publish_stack_from_file","releasePath":"/ClickHouse/ClickHouse/releases/new?marketplace=true","showPublishActionBanner":false,"showPublishStackBanner":false},"renderImageOrRaw":false,"richText":"<article class=\"markdown-body entry-content container-lg\" itemprop=\"text\"><h1 tabindex=\"-1\" dir=\"auto\"><a id=\"user-content-systemtable_name-system-tables_table-name\" class=\"anchor\" aria-hidden=\"true\" href=\"#systemtable_name-system-tables_table-name\"><svg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"><path d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"></path></svg></a>system.table_name {#system-tables_table-name}</h1>\n<p dir=\"auto\">Description.</p>\n<p dir=\"auto\">Columns:</p>\n<ul dir=\"auto\">\n<li><code>column_name</code> (<a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/path/to/data_type.md\">data_type_name</a>) — Description.</li>\n</ul>\n<p dir=\"auto\"><strong>Example</strong></p>\n<p dir=\"auto\">Query:</p>\n<div class=\"highlight highlight-source-sql notranslate position-relative overflow-auto\" dir=\"auto\" data-snippet-clipboard-copy-content=\"SELECT * FROM system.table_name\"><pre><span class=\"pl-k\">SELECT</span> <span class=\"pl-k\">*</span> <span class=\"pl-k\">FROM</span> <span class=\"pl-c1\">system</span>.<span class=\"pl-c1\">table_name</span></pre></div>\n<p dir=\"auto\">Result:</p>\n<div class=\"snippet-clipboard-content notranslate position-relative overflow-auto\" data-snippet-clipboard-copy-content=\"Some output. It shouldn't be too long.\"><pre lang=\"text\" class=\"notranslate\"><code>Some output. It shouldn't be too long.\n</code></pre></div>\n<p dir=\"auto\"><strong>See Also</strong></p>\n<ul dir=\"auto\">\n<li><a href=\"/ClickHouse/ClickHouse/blob/5f18640215159ed1ad50be1efce2cb996a49fd73/docs/_description_templates/path/to/article_name.md\">Article name</a> — Some words about referenced information.</li>\n</ul>\n</article>","renderedFileInfo":null,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"repoOwner":"ClickHouse","repoName":"ClickHouse","showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","showDependabotConfigurationBanner":null,"actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timedOut":false,"notAnalyzed":true,"symbols":[]}},"csrf_tokens":{"/ClickHouse/ClickHouse/branches":{"post":"9K5xHq3WERnrVDYaCTfS2yzVWybDSHIH0WqtxpxdRGaJUn9ffSZsyvtecMTgBPUdDKOj419HV6AM0YDO1eB3pA"}}},"title":"ClickHouse/docs/_description_templates/template-system-table.md at 5f18640215159ed1ad50be1efce2cb996a49fd73 · ClickHouse/ClickHouse","locale":"en"}
\ No newline at end of file
+# system.table_name {#system-tables_table-name}
+
+Description.
+
+Columns:
+
+-   `column_name` ([data_type_name](path/to/data_type.md)) — Description.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT * FROM system.table_name
+```
+
+Result:
+
+``` text
+Some output. It shouldn't be too long.
+```
+
+**See Also**
+
+-   [Article name](path/to/article_name.md) — Some words about referenced information.

From ec5c9a013744baee5f3e501eadbb98cd596b73e0 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@gmail.com>
Date: Mon, 3 Jul 2023 23:43:38 +0300
Subject: [PATCH 1471/1478] Revert "Fix: Invalid number of rows in Chunk column
 Object"

---
 src/Processors/QueryPlan/AggregatingStep.cpp                    | 2 --
 .../0_stateless/02789_object_type_invalid_num_of_rows.reference | 1 -
 .../0_stateless/02789_object_type_invalid_num_of_rows.sql       | 2 --
 3 files changed, 5 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
 delete mode 100644 tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql

diff --git a/src/Processors/QueryPlan/AggregatingStep.cpp b/src/Processors/QueryPlan/AggregatingStep.cpp
index eebbfc04304..4ac972e2a79 100644
--- a/src/Processors/QueryPlan/AggregatingStep.cpp
+++ b/src/Processors/QueryPlan/AggregatingStep.cpp
@@ -319,8 +319,6 @@ void AggregatingStep::transformPipeline(QueryPipelineBuilder & pipeline, const B
                     {
                         auto column_with_default = col.column->cloneEmpty();
                         col.type->insertDefaultInto(*column_with_default);
-                        column_with_default->finalize();
-
                         auto column = ColumnConst::create(std::move(column_with_default), 0);
                         const auto * node = &dag->addColumn({ColumnPtr(std::move(column)), col.type, col.name});
                         node = &dag->materializeNode(*node);
diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
deleted file mode 100644
index 7dec35f7acb..00000000000
--- a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.reference
+++ /dev/null
@@ -1 +0,0 @@
-0.02
diff --git a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql b/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
deleted file mode 100644
index a9c8a844aa0..00000000000
--- a/tests/queries/0_stateless/02789_object_type_invalid_num_of_rows.sql
+++ /dev/null
@@ -1,2 +0,0 @@
-set allow_experimental_object_type=1;
-SELECT '0.02' GROUP BY GROUPING SETS (('6553.6'), (CAST('{"x" : 1}', 'Object(\'json\')'))) settings max_threads=1; -- { serverError NOT_IMPLEMENTED }

From 29200341addefeeece3a437a740cacf249f35a61 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 3 Jul 2023 21:05:13 +0000
Subject: [PATCH 1472/1478] Add SonarCloud to README

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index eac036c2d9b..a1147f81077 100644
--- a/README.md
+++ b/README.md
@@ -16,8 +16,9 @@ curl https://clickhouse.com/ | sh
 * [YouTube channel](https://www.youtube.com/c/ClickHouseDB) has a lot of content about ClickHouse in video format.
 * [Slack](https://clickhouse.com/slack) and [Telegram](https://telegram.me/clickhouse_en) allow chatting with ClickHouse users in real-time.
 * [Blog](https://clickhouse.com/blog/) contains various ClickHouse-related articles, as well as announcements and reports about events.
-* [Code Browser (Woboq)](https://clickhouse.com/codebrowser/ClickHouse/index.html) with syntax highlight and navigation.
-* [Code Browser (github.dev)](https://github.dev/ClickHouse/ClickHouse) with syntax highlight, powered by github.dev.
+* [Code Browser (Woboq)](https://clickhouse.com/codebrowser/ClickHouse/index.html) with syntax highlighting and navigation.
+* [Code Browser (github.dev)](https://github.dev/ClickHouse/ClickHouse) with syntax highlighting, powered by github.dev.
+* [Static Analysis (SonarCloud)](https://sonarcloud.io/project/issues?resolved=false&id=ClickHouse_ClickHouse) proposes C++ quality improvements.
 * [Contacts](https://clickhouse.com/company/contact) can help to get your questions answered if there are any.
 
 ## Upcoming Events

From d263b6bf1739f4cd3431c469e60643e29dd10fe7 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 3 Jul 2023 21:17:13 +0000
Subject: [PATCH 1473/1478] Docs: Mention homebrew as an alternative and
 non-production install method

---
 docs/en/getting-started/install.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/getting-started/install.md b/docs/en/getting-started/install.md
index d44dc861888..d2e7ab30478 100644
--- a/docs/en/getting-started/install.md
+++ b/docs/en/getting-started/install.md
@@ -378,6 +378,10 @@ request](https://github.com/ClickHouse/ClickHouse/commits/master) and find CI ch
 https://s3.amazonaws.com/clickhouse/builds/PRs/.../.../binary_aarch64_v80compat/clickhouse". You can then click the link to download the
 build.
 
+### macOS-only: Install with Homebrew
+
+To install ClickHouse using the popular `brew` package manager, follow the instructions listed in the [ClickHouse Homebrew tap](https://github.com/ClickHouse/homebrew-clickhouse).
+
 ## Launch {#launch}
 
 To start the server as a daemon, run:

From e99e0ebddb712ab40e22be4ab74ebd2ae3786ba0 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 4 Jul 2023 13:26:55 +0300
Subject: [PATCH 1474/1478] Update
 01320_create_sync_race_condition_zookeeper.sh (#51742)

---
 .../01320_create_sync_race_condition_zookeeper.sh            | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01320_create_sync_race_condition_zookeeper.sh b/tests/queries/0_stateless/01320_create_sync_race_condition_zookeeper.sh
index ef45e8e63bc..aee69e64b1b 100755
--- a/tests/queries/0_stateless/01320_create_sync_race_condition_zookeeper.sh
+++ b/tests/queries/0_stateless/01320_create_sync_race_condition_zookeeper.sh
@@ -12,7 +12,10 @@ $CLICKHOUSE_CLIENT --allow_deprecated_database_ordinary=1 --query "CREATE DATABA
 
 function thread1()
 {
-    while true; do $CLICKHOUSE_CLIENT -n --query "CREATE TABLE test_01320.r (x UInt64) ENGINE = ReplicatedMergeTree('/test/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/table', 'r') ORDER BY x; DROP TABLE test_01320.r;"; done
+    while true; do
+        $CLICKHOUSE_CLIENT -n --query "CREATE TABLE test_01320.r (x UInt64) ENGINE = ReplicatedMergeTree('/test/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/table', 'r') ORDER BY x;
+        DROP TABLE test_01320.r;" 2>&1 | grep -F "Code:" | grep -v "UNKNOWN_DATABASE"
+    done
 }
 
 function thread2()

From 35c13219520b8b41c633f41423af91b9fda898e1 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 4 Jul 2023 12:35:16 +0200
Subject: [PATCH 1475/1478] Version mypy=1.4.1 falsly reports unused ignore
 comment

---
 docker/test/style/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/test/style/Dockerfile b/docker/test/style/Dockerfile
index 746cc7bb2d5..2aa0b1a62d6 100644
--- a/docker/test/style/Dockerfile
+++ b/docker/test/style/Dockerfile
@@ -18,7 +18,7 @@ RUN apt-get update && env DEBIAN_FRONTEND=noninteractive apt-get install --yes \
     python3-pip \
     shellcheck \
     yamllint \
-    && pip3 install black==23.1.0 boto3 codespell==2.2.1 dohq-artifactory mypy PyGithub unidiff pylint==2.6.2 \
+    && pip3 install black==23.1.0 boto3 codespell==2.2.1 mypy==1.3.0 PyGithub unidiff pylint==2.6.2 \
     && apt-get clean \
     && rm -rf /root/.cache/pip
 

From 463c2ba5ce13a6839dfaf12223826b9e90f143c8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 4 Jul 2023 14:07:10 +0300
Subject: [PATCH 1476/1478] Revert "Add documentation for building in docker"

---
 docker/packager/README.md      |  2 +-
 docker/packager/packager       | 16 ++++++++--------
 docs/en/development/build.md   | 14 --------------
 tests/ci/build_check.py        |  6 +++---
 tests/ci/build_report_check.py |  4 ++--
 tests/ci/ci_config.py          | 34 +++++++++++++++++-----------------
 tests/ci/report.py             |  6 +++---
 7 files changed, 34 insertions(+), 48 deletions(-)

diff --git a/docker/packager/README.md b/docker/packager/README.md
index 3a91f9a63f0..a78feb8d7fc 100644
--- a/docker/packager/README.md
+++ b/docker/packager/README.md
@@ -6,7 +6,7 @@ Usage:
 Build deb package with `clang-14` in `debug` mode:
 ```
 $ mkdir deb/test_output
-$ ./packager --output-dir deb/test_output/ --package-type deb --compiler=clang-14 --debug-build
+$ ./packager --output-dir deb/test_output/ --package-type deb --compiler=clang-14 --build-type=debug
 $ ls -l deb/test_output
 -rw-r--r-- 1 root root      3730 clickhouse-client_22.2.2+debug_all.deb
 -rw-r--r-- 1 root root  84221888 clickhouse-common-static_22.2.2+debug_amd64.deb
diff --git a/docker/packager/packager b/docker/packager/packager
index 3c3304165b3..1b3df858cd2 100755
--- a/docker/packager/packager
+++ b/docker/packager/packager
@@ -112,12 +112,12 @@ def run_docker_image_with_env(
     subprocess.check_call(cmd, shell=True)
 
 
-def is_release_build(debug_build: bool, package_type: str, sanitizer: str) -> bool:
-    return not debug_build and package_type == "deb" and sanitizer == ""
+def is_release_build(build_type: str, package_type: str, sanitizer: str) -> bool:
+    return build_type == "" and package_type == "deb" and sanitizer == ""
 
 
 def parse_env_variables(
-    debug_build: bool,
+    build_type: str,
     compiler: str,
     sanitizer: str,
     package_type: str,
@@ -233,7 +233,7 @@ def parse_env_variables(
         build_target = (
             f"{build_target} clickhouse-odbc-bridge clickhouse-library-bridge"
         )
-        if is_release_build(debug_build, package_type, sanitizer):
+        if is_release_build(build_type, package_type, sanitizer):
             cmake_flags.append("-DSPLIT_DEBUG_SYMBOLS=ON")
             result.append("WITH_PERFORMANCE=1")
             if is_cross_arm:
@@ -253,8 +253,8 @@ def parse_env_variables(
 
     if sanitizer:
         result.append(f"SANITIZER={sanitizer}")
-    if debug_build:
-        result.append("BUILD_TYPE=DEBUG")
+    if build_type:
+        result.append(f"BUILD_TYPE={build_type.capitalize()}")
     else:
         result.append("BUILD_TYPE=None")
 
@@ -359,7 +359,7 @@ def parse_args() -> argparse.Namespace:
         help="ClickHouse git repository",
     )
     parser.add_argument("--output-dir", type=dir_name, required=True)
-    parser.add_argument("--debug-build", action="store_true")
+    parser.add_argument("--build-type", choices=("debug", ""), default="")
 
     parser.add_argument(
         "--compiler",
@@ -464,7 +464,7 @@ def main():
         build_image(image_with_version, dockerfile)
 
     env_prepared = parse_env_variables(
-        args.debug_build,
+        args.build_type,
         args.compiler,
         args.sanitizer,
         args.package_type,
diff --git a/docs/en/development/build.md b/docs/en/development/build.md
index ab47ee8aac5..83a4550df88 100644
--- a/docs/en/development/build.md
+++ b/docs/en/development/build.md
@@ -13,20 +13,6 @@ Supported platforms:
 - AArch64
 - Power9 (experimental)
 
-## Building in docker
-We use the docker image `clickhouse/binary-builder` for our CI builds. It contains everything necessary to build the binary and packages. There is a script `docker/packager/packager` to ease the image usage:
-
-```bash
-# define a directory for the output artifacts
-output_dir="build_results"
-# a simplest build
-./docker/packager/packager --package-type=binary --output-dir "$output_dir"
-# build debian packages
-./docker/packager/packager --package-type=deb --output-dir "$output_dir"
-# by default, debian packages use thin LTO, so we can override it to speed up the build
-CMAKE_FLAGS='-DENABLE_THINLTO=' ./docker/packager/packager --package-type=deb --output-dir "$output_dir"
-```
-
 ## Building on Ubuntu
 
 The following tutorial is based on Ubuntu Linux.
diff --git a/tests/ci/build_check.py b/tests/ci/build_check.py
index 2a636faf967..35b98a7c3bb 100644
--- a/tests/ci/build_check.py
+++ b/tests/ci/build_check.py
@@ -45,7 +45,7 @@ def _can_export_binaries(build_config: BuildConfig) -> bool:
         return False
     if build_config["sanitizer"] != "":
         return True
-    if build_config["debug_build"]:
+    if build_config["build_type"] != "":
         return True
     return False
 
@@ -66,8 +66,8 @@ def get_packager_cmd(
         f"--package-type={package_type} --compiler={comp}"
     )
 
-    if build_config["debug_build"]:
-        cmd += " --debug-build"
+    if build_config["build_type"]:
+        cmd += f" --build-type={build_config['build_type']}"
     if build_config["sanitizer"]:
         cmd += f" --sanitizer={build_config['sanitizer']}"
     if build_config["tidy"] == "enable":
diff --git a/tests/ci/build_report_check.py b/tests/ci/build_report_check.py
index 295b6cf9740..1362f3c8934 100644
--- a/tests/ci/build_report_check.py
+++ b/tests/ci/build_report_check.py
@@ -70,7 +70,7 @@ def get_failed_report(
     message = f"{job_name} failed"
     build_result = BuildResult(
         compiler="unknown",
-        debug_build=False,
+        build_type="unknown",
         sanitizer="unknown",
         status=message,
         elapsed_seconds=0,
@@ -85,7 +85,7 @@ def process_report(
     build_config = build_report["build_config"]
     build_result = BuildResult(
         compiler=build_config["compiler"],
-        debug_build=build_config["debug_build"],
+        build_type=build_config["build_type"],
         sanitizer=build_config["sanitizer"],
         status="success" if build_report["status"] else "failure",
         elapsed_seconds=build_report["elapsed_seconds"],
diff --git a/tests/ci/ci_config.py b/tests/ci/ci_config.py
index 875c5a3c8bd..c680b5810fc 100644
--- a/tests/ci/ci_config.py
+++ b/tests/ci/ci_config.py
@@ -10,7 +10,7 @@ CI_CONFIG = {
     "build_config": {
         "package_release": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "deb",
             "static_binary_name": "amd64",
@@ -21,7 +21,7 @@ CI_CONFIG = {
         },
         "coverity": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "coverity",
             "tidy": "disable",
@@ -31,7 +31,7 @@ CI_CONFIG = {
         },
         "package_aarch64": {
             "compiler": "clang-16-aarch64",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "deb",
             "static_binary_name": "aarch64",
@@ -42,7 +42,7 @@ CI_CONFIG = {
         },
         "package_asan": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "address",
             "package_type": "deb",
             "tidy": "disable",
@@ -51,7 +51,7 @@ CI_CONFIG = {
         },
         "package_ubsan": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "undefined",
             "package_type": "deb",
             "tidy": "disable",
@@ -60,7 +60,7 @@ CI_CONFIG = {
         },
         "package_tsan": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "thread",
             "package_type": "deb",
             "tidy": "disable",
@@ -69,7 +69,7 @@ CI_CONFIG = {
         },
         "package_msan": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "memory",
             "package_type": "deb",
             "tidy": "disable",
@@ -78,7 +78,7 @@ CI_CONFIG = {
         },
         "package_debug": {
             "compiler": "clang-16",
-            "debug_build": True,
+            "build_type": "debug",
             "sanitizer": "",
             "package_type": "deb",
             "tidy": "disable",
@@ -87,7 +87,7 @@ CI_CONFIG = {
         },
         "binary_release": {
             "compiler": "clang-16",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "tidy": "disable",
@@ -96,7 +96,7 @@ CI_CONFIG = {
         },
         "binary_tidy": {
             "compiler": "clang-16",
-            "debug_build": True,
+            "build_type": "debug",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "debug-amd64",
@@ -106,7 +106,7 @@ CI_CONFIG = {
         },
         "binary_darwin": {
             "compiler": "clang-16-darwin",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "macos",
@@ -116,7 +116,7 @@ CI_CONFIG = {
         },
         "binary_aarch64": {
             "compiler": "clang-16-aarch64",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "tidy": "disable",
@@ -125,7 +125,7 @@ CI_CONFIG = {
         },
         "binary_aarch64_v80compat": {
             "compiler": "clang-16-aarch64-v80compat",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "aarch64v80compat",
@@ -135,7 +135,7 @@ CI_CONFIG = {
         },
         "binary_freebsd": {
             "compiler": "clang-16-freebsd",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "freebsd",
@@ -145,7 +145,7 @@ CI_CONFIG = {
         },
         "binary_darwin_aarch64": {
             "compiler": "clang-16-darwin-aarch64",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "macos-aarch64",
@@ -155,7 +155,7 @@ CI_CONFIG = {
         },
         "binary_ppc64le": {
             "compiler": "clang-16-ppc64le",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "powerpc64le",
@@ -165,7 +165,7 @@ CI_CONFIG = {
         },
         "binary_amd64_compat": {
             "compiler": "clang-16-amd64-compat",
-            "debug_build": False,
+            "build_type": "",
             "sanitizer": "",
             "package_type": "binary",
             "static_binary_name": "amd64compat",
diff --git a/tests/ci/report.py b/tests/ci/report.py
index 0f84fbcaeb2..a9014acec12 100644
--- a/tests/ci/report.py
+++ b/tests/ci/report.py
@@ -239,7 +239,7 @@ def read_test_results(results_path: Path, with_raw_logs: bool = True) -> TestRes
 @dataclass
 class BuildResult:
     compiler: str
-    debug_build: bool
+    build_type: str
     sanitizer: str
     status: str
     elapsed_seconds: int
@@ -484,8 +484,8 @@ def create_build_html_report(
     ):
         row = "<tr>"
         row += f"<td>{build_result.compiler}</td>"
-        if build_result.debug_build:
-            row += "<td>debug</td>"
+        if build_result.build_type:
+            row += f"<td>{build_result.build_type}</td>"
         else:
             row += "<td>relwithdebuginfo</td>"
         if build_result.sanitizer:

From 5230503651e091f4bf1944a1176aeac47c834907 Mon Sep 17 00:00:00 2001
From: Yatsishin Ilya <2159081+qoega@users.noreply.github.com>
Date: Tue, 4 Jul 2023 12:59:25 +0000
Subject: [PATCH 1477/1478] remove unused type: ignore

---
 tests/ci/commit_status_helper.py | 2 +-
 tests/ci/github_helper.py        | 2 +-
 tests/ci/merge_pr.py             | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/ci/commit_status_helper.py b/tests/ci/commit_status_helper.py
index 4437ddc52c6..efe149b0aa4 100644
--- a/tests/ci/commit_status_helper.py
+++ b/tests/ci/commit_status_helper.py
@@ -7,7 +7,7 @@ from typing import Dict, List, Literal, Optional, Union
 import logging
 
 from github import Github
-from github.GithubObject import _NotSetType, NotSet as NotSet  # type: ignore
+from github.GithubObject import _NotSetType, NotSet as NotSet
 from github.Commit import Commit
 from github.CommitStatus import CommitStatus
 from github.IssueComment import IssueComment
diff --git a/tests/ci/github_helper.py b/tests/ci/github_helper.py
index 834c8247cb8..f7256e523b1 100644
--- a/tests/ci/github_helper.py
+++ b/tests/ci/github_helper.py
@@ -111,7 +111,7 @@ class GitHub(github.Github):
             # See https://github.com/PyGithub/PyGithub/issues/2202,
             # obj._rawData doesn't spend additional API requests
             # pylint: disable=protected-access
-            repo_url = issue._rawData["repository_url"]  # type: ignore
+            repo_url = issue._rawData["repository_url"]
             if repo_url not in repos:
                 repos[repo_url] = issue.repository
             prs.append(
diff --git a/tests/ci/merge_pr.py b/tests/ci/merge_pr.py
index 2d6d81a152a..14844ed9b25 100644
--- a/tests/ci/merge_pr.py
+++ b/tests/ci/merge_pr.py
@@ -154,7 +154,7 @@ def get_workflows_for_head(repo: Repository, head_sha: str) -> List[WorkflowRun]
     return list(
         PaginatedList(
             WorkflowRun,
-            repo._requester,  # type:ignore # pylint:disable=protected-access
+            repo._requester,  # pylint:disable=protected-access
             f"{repo.url}/actions/runs",
             {"head_sha": head_sha},
             list_item="workflow_runs",

From 3cb459bd04d141ca0fffe7c1f6c389e4be434167 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 4 Jul 2023 15:50:56 +0000
Subject: [PATCH 1478/1478] Docs: Fix description of output field NON_UNIQUE
 for statement SHOW INDEXES

---
 docs/en/sql-reference/statements/show.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/show.md b/docs/en/sql-reference/statements/show.md
index f96eb55aa45..336b93db9d5 100644
--- a/docs/en/sql-reference/statements/show.md
+++ b/docs/en/sql-reference/statements/show.md
@@ -283,7 +283,7 @@ The optional keyword `EXTENDED` currently has no effect, it only exists for MySQ
 
 `SHOW INDEX` produces a result table with the following structure:
 - table - The name of the table (String)
-- non_unique - 0 if the index can contain duplicates, 1 otherwise (UInt8)
+- non_unique - 0 if the index cannot contain duplicates, 1 otherwise (UInt8)
 - key_name - The name of the index, `PRIMARY` if the index is a primary key index (String)
 - seq_in_index - Currently unused
 - column_name - Currently unused