// Copyright 2023 PingCAP, Inc. // // 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 #include #include #include #include #include #include #include #include #include #include #include #include #include namespace DB { namespace ErrorCodes { extern const int TYPE_MISMATCH; extern const int ARGUMENT_OUT_OF_BOUND; extern const int BAD_ARGUMENTS; extern const int DICTIONARY_IS_EMPTY; extern const int NOT_IMPLEMENTED; } // namespace ErrorCodes TrieDictionary::TrieDictionary( const std::string & name, const DictionaryStructure & dict_struct, DictionarySourcePtr source_ptr, const DictionaryLifetime dict_lifetime, bool require_nonempty) : name{name} , dict_struct(dict_struct) , source_ptr{std::move(source_ptr)} , dict_lifetime(dict_lifetime) , require_nonempty(require_nonempty) , logger(&Poco::Logger::get("TrieDictionary")) { createAttributes(); trie = btrie_create(); try { loadData(); calculateBytesAllocated(); } catch (...) { creation_exception = std::current_exception(); } creation_time = std::chrono::system_clock::now(); } TrieDictionary::TrieDictionary(const TrieDictionary & other) : TrieDictionary{ other.name, other.dict_struct, other.source_ptr->clone(), other.dict_lifetime, other.require_nonempty} {} TrieDictionary::~TrieDictionary() { btrie_destroy(trie); } #define DECLARE(TYPE) \ void TrieDictionary::get##TYPE( \ const std::string & attribute_name, \ const Columns & key_columns, \ const DataTypes & key_types, \ PaddedPODArray & out) const \ { \ validateKeyTypes(key_types); \ \ const auto & attribute = getAttribute(attribute_name); \ if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::TYPE)) \ throw Exception{ \ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), \ ErrorCodes::TYPE_MISMATCH}; \ \ const auto null_value = std::get(attribute.null_values); \ \ getItemsNumber( \ attribute, \ key_columns, \ [&](const size_t row, const auto value) { out[row] = value; }, \ [&](const size_t) { return null_value; }); \ } DECLARE(UInt8) DECLARE(UInt16) DECLARE(UInt32) DECLARE(UInt64) DECLARE(UInt128) DECLARE(Int8) DECLARE(Int16) DECLARE(Int32) DECLARE(Int64) DECLARE(Float32) DECLARE(Float64) #undef DECLARE void TrieDictionary::getString( const std::string & attribute_name, const Columns & key_columns, const DataTypes & key_types, ColumnString * out) const { validateKeyTypes(key_types); const auto & attribute = getAttribute(attribute_name); if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::String)) throw Exception{ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), ErrorCodes::TYPE_MISMATCH}; const auto & null_value = StringRef{std::get(attribute.null_values)}; getItemsImpl( attribute, key_columns, [&](const size_t, const StringRef value) { out->insertData(value.data, value.size); }, [&](const size_t) { return null_value; }); } #define DECLARE(TYPE) \ void TrieDictionary::get##TYPE( \ const std::string & attribute_name, \ const Columns & key_columns, \ const DataTypes & key_types, \ const PaddedPODArray & def, \ PaddedPODArray & out) const \ { \ validateKeyTypes(key_types); \ \ const auto & attribute = getAttribute(attribute_name); \ if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::TYPE)) \ throw Exception{ \ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), \ ErrorCodes::TYPE_MISMATCH}; \ \ getItemsNumber( \ attribute, \ key_columns, \ [&](const size_t row, const auto value) { out[row] = value; }, \ [&](const size_t row) { return def[row]; }); \ } DECLARE(UInt8) DECLARE(UInt16) DECLARE(UInt32) DECLARE(UInt64) DECLARE(UInt128) DECLARE(Int8) DECLARE(Int16) DECLARE(Int32) DECLARE(Int64) DECLARE(Float32) DECLARE(Float64) #undef DECLARE void TrieDictionary::getString( const std::string & attribute_name, const Columns & key_columns, const DataTypes & key_types, const ColumnString * const def, ColumnString * const out) const { validateKeyTypes(key_types); const auto & attribute = getAttribute(attribute_name); if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::String)) throw Exception{ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), ErrorCodes::TYPE_MISMATCH}; getItemsImpl( attribute, key_columns, [&](const size_t, const StringRef value) { out->insertData(value.data, value.size); }, [&](const size_t row) { return def->getDataAt(row); }); } #define DECLARE(TYPE) \ void TrieDictionary::get##TYPE( \ const std::string & attribute_name, \ const Columns & key_columns, \ const DataTypes & key_types, \ const TYPE def, \ PaddedPODArray & out) const \ { \ validateKeyTypes(key_types); \ \ const auto & attribute = getAttribute(attribute_name); \ if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::TYPE)) \ throw Exception{ \ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), \ ErrorCodes::TYPE_MISMATCH}; \ \ getItemsNumber( \ attribute, \ key_columns, \ [&](const size_t row, const auto value) { out[row] = value; }, \ [&](const size_t) { return def; }); \ } DECLARE(UInt8) DECLARE(UInt16) DECLARE(UInt32) DECLARE(UInt64) DECLARE(UInt128) DECLARE(Int8) DECLARE(Int16) DECLARE(Int32) DECLARE(Int64) DECLARE(Float32) DECLARE(Float64) #undef DECLARE void TrieDictionary::getString( const std::string & attribute_name, const Columns & key_columns, const DataTypes & key_types, const String & def, ColumnString * const out) const { validateKeyTypes(key_types); const auto & attribute = getAttribute(attribute_name); if (!isAttributeTypeConvertibleTo(attribute.type, AttributeUnderlyingType::String)) throw Exception{ name + ": type mismatch: attribute " + attribute_name + " has type " + toString(attribute.type), ErrorCodes::TYPE_MISMATCH}; getItemsImpl( attribute, key_columns, [&](const size_t, const StringRef value) { out->insertData(value.data, value.size); }, [&](const size_t) { return StringRef{def}; }); } void TrieDictionary::has(const Columns & key_columns, const DataTypes & key_types, PaddedPODArray & out) const { validateKeyTypes(key_types); const auto & attribute = attributes.front(); switch (attribute.type) { case AttributeUnderlyingType::UInt8: has(attribute, key_columns, out); break; case AttributeUnderlyingType::UInt16: has(attribute, key_columns, out); break; case AttributeUnderlyingType::UInt32: has(attribute, key_columns, out); break; case AttributeUnderlyingType::UInt64: has(attribute, key_columns, out); break; case AttributeUnderlyingType::UInt128: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Int8: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Int16: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Int32: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Int64: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Float32: has(attribute, key_columns, out); break; case AttributeUnderlyingType::Float64: has(attribute, key_columns, out); break; case AttributeUnderlyingType::String: has(attribute, key_columns, out); break; } } void TrieDictionary::createAttributes() { const auto size = dict_struct.attributes.size(); attributes.reserve(size); for (const auto & attribute : dict_struct.attributes) { attribute_index_by_name.emplace(attribute.name, attributes.size()); attributes.push_back(createAttributeWithType(attribute.underlying_type, attribute.null_value)); if (attribute.hierarchical) throw Exception{ name + ": hierarchical attributes not supported for dictionary of type " + getTypeName(), ErrorCodes::TYPE_MISMATCH}; } } void TrieDictionary::loadData() { auto stream = source_ptr->loadAll(); stream->readPrefix(); /// created upfront to avoid excess allocations const auto keys_size = dict_struct.key->size(); StringRefs keys(keys_size); const auto attributes_size = attributes.size(); while (const auto block = stream->read()) { const auto rows = block.rows(); element_count += rows; const auto key_column_ptrs = ext::map(ext::range(0, keys_size), [&](const size_t attribute_idx) { return block.safeGetByPosition(attribute_idx).column; }); const auto attribute_column_ptrs = ext::map(ext::range(0, attributes_size), [&](const size_t attribute_idx) { return block.safeGetByPosition(keys_size + attribute_idx).column; }); for (const auto row_idx : ext::range(0, rows)) { /// calculate key once per row const auto & key_column = key_column_ptrs.front(); for (const auto attribute_idx : ext::range(0, attributes_size)) { const auto & attribute_column = *attribute_column_ptrs[attribute_idx]; auto & attribute = attributes[attribute_idx]; setAttributeValue(attribute, key_column->getDataAt(row_idx), attribute_column[row_idx]); } } } stream->readSuffix(); if (require_nonempty && 0 == element_count) throw Exception{ name + ": dictionary source is empty and 'require_nonempty' property is set.", ErrorCodes::DICTIONARY_IS_EMPTY}; } template void TrieDictionary::addAttributeSize(const Attribute & attribute) { const auto & vec = *std::get>(attribute.maps); bytes_allocated += sizeof(ContainerType) + (vec.capacity() * sizeof(T)); bucket_count = vec.size(); } void TrieDictionary::calculateBytesAllocated() { bytes_allocated += attributes.size() * sizeof(attributes.front()); for (const auto & attribute : attributes) { switch (attribute.type) { case AttributeUnderlyingType::UInt8: addAttributeSize(attribute); break; case AttributeUnderlyingType::UInt16: addAttributeSize(attribute); break; case AttributeUnderlyingType::UInt32: addAttributeSize(attribute); break; case AttributeUnderlyingType::UInt64: addAttributeSize(attribute); break; case AttributeUnderlyingType::UInt128: addAttributeSize(attribute); break; case AttributeUnderlyingType::Int8: addAttributeSize(attribute); break; case AttributeUnderlyingType::Int16: addAttributeSize(attribute); break; case AttributeUnderlyingType::Int32: addAttributeSize(attribute); break; case AttributeUnderlyingType::Int64: addAttributeSize(attribute); break; case AttributeUnderlyingType::Float32: addAttributeSize(attribute); break; case AttributeUnderlyingType::Float64: addAttributeSize(attribute); break; case AttributeUnderlyingType::String: { addAttributeSize(attribute); bytes_allocated += sizeof(Arena) + attribute.string_arena->size(); break; } } } bytes_allocated += btrie_allocated(trie); } void TrieDictionary::validateKeyTypes(const DataTypes & key_types) { if (key_types.size() != 1) throw Exception{"Expected a single IP address", ErrorCodes::TYPE_MISMATCH}; const auto & actual_type = key_types[0]->getName(); if (actual_type != "UInt32" && actual_type != "FixedString(16)") throw Exception{"Key does not match, expected either UInt32 or FixedString(16)", ErrorCodes::TYPE_MISMATCH}; } template void TrieDictionary::createAttributeImpl(Attribute & attribute, const Field & null_value) { std::get(attribute.null_values) = null_value.get::Type>(); std::get>(attribute.maps) = std::make_unique>(); } TrieDictionary::Attribute TrieDictionary::createAttributeWithType( const AttributeUnderlyingType type, const Field & null_value) { Attribute attr{type, {}, {}, {}}; switch (type) { case AttributeUnderlyingType::UInt8: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::UInt16: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::UInt32: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::UInt64: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::UInt128: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Int8: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Int16: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Int32: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Int64: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Float32: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::Float64: createAttributeImpl(attr, null_value); break; case AttributeUnderlyingType::String: { std::get(attr.null_values) = null_value.get(); std::get>(attr.maps) = std::make_unique>(); attr.string_arena = std::make_unique(); break; } } return attr; } template void TrieDictionary::getItemsNumber( const Attribute & attribute, const Columns & key_columns, ValueSetter && set_value, DefaultGetter && get_default) const { if (false) {} // NOLINT #define DISPATCH(TYPE) \ else if (attribute.type == AttributeUnderlyingType::TYPE) getItemsImpl( \ attribute, \ key_columns, \ std::forward(set_value), \ std::forward(get_default)); DISPATCH(UInt8) DISPATCH(UInt16) DISPATCH(UInt32) DISPATCH(UInt64) DISPATCH(UInt128) DISPATCH(Int8) DISPATCH(Int16) DISPATCH(Int32) DISPATCH(Int64) DISPATCH(Float32) DISPATCH(Float64) #undef DISPATCH else throw Exception("Unexpected type of attribute: " + toString(attribute.type), ErrorCodes::LOGICAL_ERROR); } template void TrieDictionary::getItemsImpl( const Attribute & attribute, const Columns & key_columns, ValueSetter && set_value, DefaultGetter && get_default) const { auto & vec = *std::get>(attribute.maps); const auto & first_column = key_columns.front(); const auto rows = first_column->size(); if (first_column->isNumeric()) { for (const auto i : ext::range(0, rows)) { auto addr = static_cast(first_column->get64(i)); uintptr_t slot = btrie_find(trie, addr); set_value(i, slot != BTRIE_NULL ? static_cast(vec[slot]) : get_default(i)); } } else { for (const auto i : ext::range(0, rows)) { auto addr = first_column->getDataAt(i); if (addr.size != 16) throw Exception("Expected key to be FixedString(16)", ErrorCodes::LOGICAL_ERROR); uintptr_t slot = btrie_find_a6(trie, reinterpret_cast(addr.data)); set_value(i, slot != BTRIE_NULL ? static_cast(vec[slot]) : get_default(i)); } } query_count.fetch_add(rows, std::memory_order_relaxed); } template bool TrieDictionary::setAttributeValueImpl(Attribute & attribute, const StringRef key, const T value) { // Insert value into appropriate vector type auto & vec = *std::get>(attribute.maps); size_t row = vec.size(); vec.push_back(value); // Parse IP address and subnet length from string (e.g. 2a02:6b8::3/64) Poco::Net::IPAddress addr, mask; std::string addr_str(key.toString()); size_t pos = addr_str.find('/'); if (pos != std::string::npos) { addr = Poco::Net::IPAddress(addr_str.substr(0, pos)); mask = Poco::Net::IPAddress(std::stoi(addr_str.substr(pos + 1), nullptr, 10), addr.family()); } else { addr = Poco::Net::IPAddress(addr_str); mask = Poco::Net::IPAddress(addr.length() * 8, addr.family()); } /* * Here we might overwrite the same key with the same slot as each key can map to multiple attributes. * However, all columns have equal number of rows so it is okay to store only row number for each key * instead of building a trie for each column. This comes at the cost of additional lookup in attribute * vector on lookup time to return cell from row + column. The reason for this is to save space, * and build only single trie instead of trie for each column. */ if (addr.family() == Poco::Net::IPAddress::IPv4) { UInt32 addr_v4 = Poco::ByteOrder::toNetwork(*reinterpret_cast(addr.addr())); UInt32 mask_v4 = Poco::ByteOrder::toNetwork(*reinterpret_cast(mask.addr())); return btrie_insert(trie, addr_v4, mask_v4, row) == 0; } const auto * addr_v6 = reinterpret_cast(addr.addr()); const auto * mask_v6 = reinterpret_cast(mask.addr()); return btrie_insert_a6(trie, addr_v6, mask_v6, row) == 0; } bool TrieDictionary::setAttributeValue(Attribute & attribute, const StringRef key, const Field & value) { switch (attribute.type) { case AttributeUnderlyingType::UInt8: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::UInt16: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::UInt32: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::UInt64: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::UInt128: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Int8: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Int16: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Int32: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Int64: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Float32: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::Float64: return setAttributeValueImpl(attribute, key, value.get()); case AttributeUnderlyingType::String: { const auto & string = value.get(); const auto * const string_in_arena = attribute.string_arena->insert(string.data(), string.size()); setAttributeValueImpl(attribute, key, StringRef{string_in_arena, string.size()}); return true; } } return {}; } const TrieDictionary::Attribute & TrieDictionary::getAttribute(const std::string & attribute_name) const { const auto it = attribute_index_by_name.find(attribute_name); if (it == std::end(attribute_index_by_name)) throw Exception{name + ": no such attribute '" + attribute_name + "'", ErrorCodes::BAD_ARGUMENTS}; return attributes[it->second]; } template void TrieDictionary::has(const Attribute &, const Columns & key_columns, PaddedPODArray & out) const { const auto & first_column = key_columns.front(); const auto rows = first_column->size(); if (first_column->isNumeric()) { for (const auto i : ext::range(0, rows)) { auto addr = static_cast(first_column->get64(i)); uintptr_t slot = btrie_find(trie, addr); out[i] = (slot != BTRIE_NULL); } } else { for (const auto i : ext::range(0, rows)) { auto addr = first_column->getDataAt(i); if (unlikely(addr.size != 16)) throw Exception("Expected key to be FixedString(16)", ErrorCodes::LOGICAL_ERROR); uintptr_t slot = btrie_find_a6(trie, reinterpret_cast(addr.data)); out[i] = (slot != BTRIE_NULL); } } query_count.fetch_add(rows, std::memory_order_relaxed); } template void TrieDictionary::trieTraverse(const btrie_t * tree, Getter && getter) const { KeyType key = 0; const KeyType high_bit = ~((~key) >> 1); btrie_node_t * node; node = tree->root; std::stack stack; while (node) { stack.push(node); node = node->left; } auto get_bit = [&high_bit](size_t size) { return size ? (high_bit >> (size - 1)) : 0; }; while (!stack.empty()) { node = stack.top(); stack.pop(); if (node && node->value != BTRIE_NULL) getter(key, stack.size()); if (node && node->right) { stack.push(nullptr); key |= get_bit(stack.size()); stack.push(node->right); while (stack.top()->left) stack.push(stack.top()->left); } else key &= ~get_bit(stack.size()); } } Columns TrieDictionary::getKeyColumns() const { auto ip_column = ColumnFixedString::create(IPV6_BINARY_LENGTH); auto mask_column = ColumnVector::create(); #if defined(__SIZEOF_INT128__) auto getter = [&ip_column, &mask_column](__uint128_t ip, size_t mask) { auto * ip_array = reinterpret_cast(&ip); ip_array[0] = Poco::ByteOrder::fromNetwork(ip_array[0]); ip_array[1] = Poco::ByteOrder::fromNetwork(ip_array[1]); std::swap(ip_array[0], ip_array[1]); ip_column->insertData(reinterpret_cast(ip_array), IPV6_BINARY_LENGTH); mask_column->insert(static_cast(mask)); }; trieTraverse(trie, std::move(getter)); #else throw Exception("TrieDictionary::getKeyColumns is not implemented for 32bit arch", ErrorCodes::NOT_IMPLEMENTED); #endif return {std::move(ip_column), std::move(mask_column)}; } } // namespace DB