1
0
Fork 0
arangodb/arangod/IResearch/IResearchAnalyzerFeature.cpp

2507 lines
90 KiB
C++

////////////////////////////////////////////////////////////////////////////////
/// DISCLAIMER
///
/// Copyright 2017 ArangoDB GmbH, Cologne, Germany
///
/// 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.
///
/// Copyright holder is ArangoDB GmbH, Cologne, Germany
///
/// @author Andrey Abramov
/// @author Vasiliy Nabatchikov
////////////////////////////////////////////////////////////////////////////////
// otherwise define conflict between 3rdParty\date\include\date\date.h and
// 3rdParty\iresearch\core\shared.hpp
#if defined(_MSC_VER)
#include "date/date.h"
#undef NOEXCEPT
#endif
#include <string.h>
#include <cstdint>
#include <exception>
#include <iterator>
#include <map>
#include <unordered_set>
#include <vector>
#include <analysis/analyzers.hpp>
#include <analysis/delimited_token_stream.hpp>
#include <analysis/ngram_token_stream.hpp>
#include <analysis/text_token_normalizing_stream.hpp>
#include <analysis/text_token_stemming_stream.hpp>
#include <analysis/text_token_stream.hpp>
#include <analysis/token_attributes.hpp>
#include <analysis/token_streams.hpp>
#include <utils/hash_utils.hpp>
#include <utils/object_pool.hpp>
#include <velocypack/Buffer.h>
#include <velocypack/Builder.h>
#include <velocypack/Iterator.h>
#include <velocypack/Slice.h>
#include <velocypack/StringRef.h>
#include "ApplicationFeatures/ApplicationServer.h"
#include "ApplicationServerHelper.h"
#include "Aql/AqlFunctionFeature.h"
#include "Aql/AqlValue.h"
#include "Aql/ExpressionContext.h"
#include "Aql/Function.h"
#include "Aql/Functions.h"
#include "Aql/Query.h"
#include "Aql/QueryResult.h"
#include "Aql/QueryString.h"
#include "Basics/Exceptions.h"
#include "Basics/StaticStrings.h"
#include "Basics/StringUtils.h"
#include "Basics/VelocyPackHelper.h"
#include "Basics/debugging.h"
#include "Basics/error.h"
#include "Basics/system-compiler.h"
#include "Basics/voc-errors.h"
#include "Cluster/ClusterFeature.h"
#include "Cluster/ClusterInfo.h"
#include "Cluster/ServerState.h"
#include "FeaturePhases/V8FeaturePhase.h"
#include "Futures/Utilities.h"
#include "IResearchAnalyzerFeature.h"
#include "IResearchCommon.h"
#include "Logger/LogMacros.h"
#include "Logger/LoggerStream.h"
#include "Network/Methods.h"
#include "Network/NetworkFeature.h"
#include "Network/Utils.h"
#include "Rest/CommonDefines.h"
#include "Rest/GeneralRequest.h"
#include "RestHandler/RestVocbaseBaseHandler.h"
#include "RestServer/DatabaseFeature.h"
#include "RestServer/QueryRegistryFeature.h"
#include "RestServer/SystemDatabaseFeature.h"
#include "RestServer/UpgradeFeature.h"
#include "StorageEngine/EngineSelectorFeature.h"
#include "StorageEngine/StorageEngine.h"
#include "StorageEngine/TransactionState.h"
#include "Transaction/StandaloneContext.h"
#include "Utils/ExecContext.h"
#include "Utils/OperationOptions.h"
#include "Utils/OperationResult.h"
#include "Utils/SingleCollectionTransaction.h"
#include "VelocyPackHelper.h"
#include "VocBase/AccessMode.h"
#include "VocBase/LogicalCollection.h"
#include "VocBase/Methods/Collections.h"
#include "VocBase/Methods/Upgrade.h"
#include "VocBase/vocbase.h"
#include "shared.hpp"
namespace iresearch {
namespace text_format {
static const irs::text_format::type_id VPACK("vpack");
const type_id& vpack_t() { return VPACK; }
}
}
namespace {
using namespace std::literals::string_literals;
static std::string const ANALYZER_COLLECTION_NAME("_analyzers");
static char const ANALYZER_PREFIX_DELIM = ':'; // name prefix delimiter (2 chars)
static size_t const ANALYZER_PROPERTIES_SIZE_MAX = 1024 * 1024; // arbitrary value
static size_t const DEFAULT_POOL_SIZE = 8; // arbitrary value
static std::string const FEATURE_NAME("ArangoSearchAnalyzer");
static irs::string_ref const IDENTITY_ANALYZER_NAME("identity");
static auto const RELOAD_INTERVAL = std::chrono::seconds(60); // arbitrary value
bool normalize(std::string& out,
irs::string_ref const& type,
VPackSlice const properties) {
if (type.empty()) {
// in ArangoSearch we don't allow to have analyzers with empty type string
return false;
}
// for API consistency we only support analyzers configurable via jSON
return irs::analysis::analyzers::normalize(
out, type,
irs::text_format::vpack,
arangodb::iresearch::ref<char>(properties),
false);
}
class IdentityAnalyzer final : public irs::analysis::analyzer {
public:
DECLARE_ANALYZER_TYPE();
static bool normalize(const irs::string_ref& /*args*/, std::string& out) noexcept {
out.resize(VPackSlice::emptyObjectSlice().byteSize());
std::memcpy(&out[0], VPackSlice::emptyObjectSlice().begin(), out.size());
return true;
}
static irs::analysis::analyzer::ptr make(irs::string_ref const& /*args*/) {
return std::make_shared<IdentityAnalyzer>();
}
IdentityAnalyzer()
: irs::analysis::analyzer(IdentityAnalyzer::type()),
_empty(true) {
_attrs.emplace(_term);
_attrs.emplace(_inc);
}
virtual irs::attribute_view const& attributes() const noexcept override {
return _attrs;
}
virtual bool next() noexcept override {
auto empty = _empty;
_empty = true;
return !empty;
}
virtual bool reset(irs::string_ref const& data) noexcept override {
_empty = false;
_term.value(irs::ref_cast<irs::byte_type>(data));
return true;
}
private:
struct IdentityValue : irs::term_attribute {
void value(irs::bytes_ref const& data) noexcept {
value_ = data;
}
};
irs::attribute_view _attrs;
IdentityValue _term;
irs::increment _inc;
bool _empty;
}; // IdentityAnalyzer
DEFINE_ANALYZER_TYPE_NAMED(IdentityAnalyzer, IDENTITY_ANALYZER_NAME);
REGISTER_ANALYZER_VPACK(IdentityAnalyzer, IdentityAnalyzer::make, IdentityAnalyzer::normalize);
// Delimiter analyzer vpack routines ////////////////////////////
namespace delimiter_vpack {
const irs::string_ref DELIMITER_PARAM_NAME = "delimiter";
bool parse_delimiter_vpack_config(const irs::string_ref& args, std::string& delimiter) {
auto slice = arangodb::iresearch::slice<char>(args);
if (slice.isString()) {
delimiter = arangodb::iresearch::getStringRef(slice);
return true;
} else if (slice.isObject()) {
bool seen = false;
return arangodb::iresearch::getString(delimiter, slice,
DELIMITER_PARAM_NAME, seen, "") &&
seen;
}
LOG_TOPIC("4342c", WARN, arangodb::iresearch::TOPIC) <<
"Missing '" << DELIMITER_PARAM_NAME << "' while constructing delimited_token_stream from jSON "
"arguments: " << slice.toString();
return false;
}
irs::analysis::analyzer::ptr delimiter_vpack_builder(irs::string_ref const& args) noexcept {
std::string delimiter;
if (parse_delimiter_vpack_config(args, delimiter)) {
return irs::analysis::delimited_token_stream::make(delimiter);
}
return nullptr;
}
bool delimiter_vpack_normalizer(const irs::string_ref& args, std::string& out) noexcept {
std::string tmp;
if (parse_delimiter_vpack_config(args, tmp)) {
VPackBuilder vpack;
{
VPackObjectBuilder scope(&vpack);
arangodb::iresearch::addStringRef(vpack, DELIMITER_PARAM_NAME, tmp);
}
out.resize(vpack.slice().byteSize());
std::memcpy(&out[0], vpack.slice().begin(), out.size());
return true;
}
return false;
}
REGISTER_ANALYZER_VPACK(irs::analysis::delimited_token_stream,
delimiter_vpack_builder, delimiter_vpack_normalizer);
} // namespace delimiter_vpack
namespace ngram_vpack {
const irs::string_ref MIN_PARAM_NAME = "min";
const irs::string_ref MAX_PARAM_NAME = "max";
const irs::string_ref PRESERVE_ORIGINAL_PARAM_NAME = "preserveOriginal";
bool parse_ngram_vpack_config(const irs::string_ref& args, irs::analysis::ngram_token_stream::options_t& options) {
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isObject()) {
LOG_TOPIC("c0168", WARN, arangodb::iresearch::TOPIC)
<< "Not a jSON object passed while constructing ngram_token_stream, "
"arguments: " << slice.toString();
return false;
}
uint64_t min = 0, max = 0;
bool seen = false;
if (!arangodb::iresearch::getNumber(min, slice, MIN_PARAM_NAME, seen, min) || !seen) {
LOG_TOPIC("7b706", WARN, arangodb::iresearch::TOPIC)
<< "Failed to read '" << MIN_PARAM_NAME
<< "' attribute as number while constructing "
"ngram_token_stream from jSON arguments: "
<< slice.toString();
return false;
}
if (!arangodb::iresearch::getNumber(max, slice, MAX_PARAM_NAME, seen, max) || !seen) {
LOG_TOPIC("eae46", WARN, arangodb::iresearch::TOPIC)
<< "Failed to read '" << MAX_PARAM_NAME
<< "' attribute as number while constructing "
"ngram_token_stream from jSON arguments: "
<< slice.toString();
return false;
}
if (!slice.hasKey(PRESERVE_ORIGINAL_PARAM_NAME) ||
!slice.get(PRESERVE_ORIGINAL_PARAM_NAME).isBool()) {
LOG_TOPIC("e95d3", WARN, arangodb::iresearch::TOPIC)
<< "Failed to read '" << PRESERVE_ORIGINAL_PARAM_NAME
<< "' attribute as boolean while constructing "
"ngram_token_stream from jSON arguments: "
<< slice.toString();
return false;
}
options.min_gram = min;
options.max_gram = max;
options.preserve_original = slice.get(PRESERVE_ORIGINAL_PARAM_NAME).getBool();
return true;
}
irs::analysis::analyzer::ptr ngram_vpack_builder(irs::string_ref const& args) noexcept {
irs::analysis::ngram_token_stream::options_t tmp;
if (parse_ngram_vpack_config(args, tmp)) {
return irs::analysis::ngram_token_stream::make(tmp);
}
return nullptr;
}
bool ngram_vpack_normalizer(const irs::string_ref& args, std::string& out) noexcept {
irs::analysis::ngram_token_stream::options_t tmp;
if (parse_ngram_vpack_config(args, tmp)) {
VPackBuilder vpack;
{
VPackObjectBuilder scope(&vpack);
vpack.add(MIN_PARAM_NAME, VPackValue(tmp.min_gram));
vpack.add(MAX_PARAM_NAME, VPackValue(tmp.max_gram));
vpack.add(PRESERVE_ORIGINAL_PARAM_NAME, VPackValue(tmp.preserve_original));
}
out.assign(vpack.slice().startAs<char>(), vpack.slice().byteSize());
return true;
}
return false;
}
REGISTER_ANALYZER_VPACK(irs::analysis::ngram_token_stream,
ngram_vpack_builder, ngram_vpack_normalizer);
} // namespace ngram_vpack
namespace text_vpack {
// FIXME implement proper vpack parsing
irs::analysis::analyzer::ptr text_vpack_builder(irs::string_ref const& args) noexcept {
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone()) {
return irs::analysis::analyzers::get("text", irs::text_format::json,
slice.toString(),
false);
}
return nullptr;
}
bool text_vpack_normalizer(const irs::string_ref& args, std::string& out) noexcept {
std::string tmp;
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone() &&
irs::analysis::analyzers::normalize(tmp, "text", irs::text_format::json,
slice.toString(),
false)) {
auto vpack = VPackParser::fromJson(tmp);
out.assign(vpack->slice().startAs<char>(), vpack->slice().byteSize());
return true;
}
return false;
}
REGISTER_ANALYZER_VPACK(irs::analysis::text_token_stream, text_vpack_builder,
text_vpack_normalizer);
}
namespace stem_vpack {
// FIXME implement proper vpack parsing
irs::analysis::analyzer::ptr stem_vpack_builder(irs::string_ref const& args) noexcept {
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone()) {
return irs::analysis::analyzers::get("stem", irs::text_format::json,
slice.toString(),
false);
}
return nullptr;
}
bool stem_vpack_normalizer(const irs::string_ref& args, std::string& out) noexcept {
std::string tmp;
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone() &&
irs::analysis::analyzers::normalize(tmp, "stem", irs::text_format::json,
slice.toString(), false)) {
auto vpack = VPackParser::fromJson(tmp);
out.assign(vpack->slice().startAs<char>(), vpack->slice().byteSize());
return true;
}
return false;
}
REGISTER_ANALYZER_VPACK(irs::analysis::text_token_stemming_stream, stem_vpack_builder,
stem_vpack_normalizer);
}
namespace norm_vpack {
// FIXME implement proper vpack parsing
irs::analysis::analyzer::ptr norm_vpack_builder(irs::string_ref const& args) noexcept {
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone()) {//cannot be created without properties
return irs::analysis::analyzers::get("norm", irs::text_format::json,
slice.toString(),
false);
}
return nullptr;
}
bool norm_vpack_normalizer(const irs::string_ref& args, std::string& out) noexcept {
std::string tmp;
auto slice = arangodb::iresearch::slice<char>(args);
if (!slice.isNone() && //cannot be created without properties
irs::analysis::analyzers::normalize(tmp, "norm", irs::text_format::json,
slice.toString(), false)) {
auto vpack = VPackParser::fromJson(tmp);
out.assign(vpack->slice().startAs<char>(), vpack->slice().byteSize());
return true;
}
return false;
}
REGISTER_ANALYZER_VPACK(irs::analysis::text_token_normalizing_stream, norm_vpack_builder,
norm_vpack_normalizer);
}
arangodb::aql::AqlValue aqlFnTokens(arangodb::aql::ExpressionContext* expressionContext,
arangodb::transaction::Methods* trx,
arangodb::aql::VPackFunctionParameters const& args) {
if (ADB_UNLIKELY(args.empty() || args.size() > 2)) {
irs::string_ref const message =
"invalid arguments count while computing result for function 'TOKENS'";
LOG_TOPIC("740fd", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_QUERY_FUNCTION_ARGUMENT_NUMBER_MISMATCH, message);
}
if (args.size() > 1 && !args[1].isString()) { // second arg must be analyzer name
irs::string_ref const message =
"invalid analyzer name argument type while computing result for function 'TOKENS',"
" string expected";
LOG_TOPIC("d0b60", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_BAD_PARAMETER, message);
}
arangodb::iresearch::AnalyzerPool::ptr pool;
// identity now is default analyzer
auto const name = args.size() > 1 ?
arangodb::iresearch::getStringRef(args[1].slice()) :
iresearch::string_ref(arangodb::iresearch::IResearchAnalyzerFeature::identity()->name());
auto& server = arangodb::application_features::ApplicationServer::server();
if( args.size() > 1) {
auto& analyzers = server.getFeature<arangodb::iresearch::IResearchAnalyzerFeature>();
if (trx) {
auto sysVocbase =
server.hasFeature<arangodb::SystemDatabaseFeature>()
? server.getFeature<arangodb::SystemDatabaseFeature>().use()
: nullptr;
if (sysVocbase) {
pool = analyzers.get(name, trx->vocbase(), *sysVocbase);
}
} else {
pool = analyzers.get(name); // verbatim
}
} else { //do not look for identity, we already have reference)
pool = arangodb::iresearch::IResearchAnalyzerFeature::identity();
}
if (!pool) {
auto const message = "failure to find arangosearch analyzer with name '"s +
static_cast<std::string>(name) +
"' while computing result for function 'TOKENS'";
LOG_TOPIC("0d256", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_BAD_PARAMETER, message);
}
auto string_analyzer = pool->get();
if (!string_analyzer) {
auto const message = "failure to get arangosearch analyzer with name '"s +
static_cast<std::string>(name) +
"' while computing result for function 'TOKENS'";
LOG_TOPIC("d7477", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_BAD_PARAMETER, message);
}
auto& string_terms = string_analyzer->attributes().get<irs::term_attribute>();
if (ADB_UNLIKELY(!string_terms)) {
auto const message =
"failure to retrieve values from arangosearch analyzer name '"s +
static_cast<std::string>(name) +
"' while computing result for function 'TOKENS'";
LOG_TOPIC("f46f2", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_INTERNAL, message);
}
std::unique_ptr<irs::numeric_token_stream> numeric_analyzer;
const irs::term_attribute* numeric_terms = nullptr;
// to avoid copying Builder's default buffer when initializing AqlValue
// create the buffer externally and pass ownership directly into AqlValue
auto buffer = std::make_unique<arangodb::velocypack::Buffer<uint8_t>>();
arangodb::velocypack::Builder builder(*buffer);
builder.openArray();
std::vector<arangodb::velocypack::ArrayIterator> arrayIteratorStack;
auto current = args[0].slice();
do {
// stack opening non-empty arrays
while (current.isArray() && !current.isEmptyArray()) {
arrayIteratorStack.emplace_back(current);
builder.openArray();
current = arrayIteratorStack.back().value();
}
// process current item
switch (current.type()) {
case VPackValueType::String:
if (!string_analyzer->reset(arangodb::iresearch::getStringRef(current))) {
auto const message = "failure to reset arangosearch analyzer: ' "s +
static_cast<std::string>(name) +
"' while computing result for function 'TOKENS'";
LOG_TOPIC("45a2d", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_INTERNAL, message);
}
while (string_analyzer->next()) {
builder.add(
arangodb::iresearch::toValuePair(irs::ref_cast<char>(string_terms->value())));
}
break;
case VPackValueType::Bool:
builder.add(
arangodb::iresearch::toValuePair(
arangodb::basics::StringUtils::encodeBase64(irs::ref_cast<char>(
irs::boolean_token_stream::value(current.getBoolean())))));
break;
case VPackValueType::Null:
builder.add(
arangodb::iresearch::toValuePair(
arangodb::basics::StringUtils::encodeBase64(
irs::ref_cast<char>(irs::null_token_stream::value_null()))));
break;
case VPackValueType::Array: // we get there only when empty array encountered
TRI_ASSERT(current.isEmptyArray());
// empty array in = empty array out
builder.openArray();
builder.close();
break;
default:
if (current.isNumber()) { // there are many "number" types. To adopt all current and future ones just
// deal with them all here in generic way
if(!numeric_analyzer) {
numeric_analyzer = std::make_unique<irs::numeric_token_stream>();
numeric_terms = numeric_analyzer->attributes().get<irs::term_attribute>().get();
if (ADB_UNLIKELY(!numeric_terms)) {
auto const message =
"failure to retrieve values from arangosearch numeric analyzer "
"while computing result for function 'TOKENS'";
LOG_TOPIC("7d5df", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_INTERNAL, message);
}
}
// we read all numers as doubles because ArangoSearch indexes
// all numbers as doubles, so do we there, as out goal is to
// return same tokens as will be in index for this specific number
numeric_analyzer->reset(current.getNumber<double>());
while (numeric_analyzer->next()) {
builder.add(
arangodb::iresearch::toValuePair(
arangodb::basics::StringUtils::encodeBase64(
irs::ref_cast<char>(numeric_terms->value()))));
}
} else {
auto const message = "unexpected parameter type '"s + current.typeName() +
"' while computing result for function 'TOKENS'";
LOG_TOPIC("45a2e", WARN, arangodb::iresearch::TOPIC) << message;
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_BAD_PARAMETER, message);
}
}
// de-stack all closing arrays
while (!arrayIteratorStack.empty()) {
auto& currentArrayIterator = arrayIteratorStack.back();
if (!currentArrayIterator.isLast()) {
currentArrayIterator.next();
current = currentArrayIterator.value();
//next array for next item
builder.close();
builder.openArray();
break;
} else {
arrayIteratorStack.pop_back();
builder.close();
}
}
} while (!arrayIteratorStack.empty());
builder.close();
bool bufOwner = true; // out parameter from AqlValue denoting ownership
// aquisition (must be true initially)
auto release = irs::make_finally([&buffer, &bufOwner]() -> void {
// cppcheck-suppress knownConditionTrueFalse
if (!bufOwner) {
buffer.release();
}
});
return arangodb::aql::AqlValue(buffer.get(), bufOwner);
}
void addFunctions(arangodb::aql::AqlFunctionFeature& functions) {
arangodb::iresearch::addFunction(
functions,
arangodb::aql::Function{
"TOKENS", // name
".|.", // positional arguments (data[,analyzer])
// deterministic (true == called during AST optimization and will be
// used to calculate values for constant expressions)
arangodb::aql::Function::makeFlags(arangodb::aql::Function::Flags::Deterministic,
arangodb::aql::Function::Flags::Cacheable,
arangodb::aql::Function::Flags::CanRunOnDBServer),
&aqlFnTokens // function implementation
});
}
////////////////////////////////////////////////////////////////////////////////
/// @return pool will generate analyzers as per supplied parameters
////////////////////////////////////////////////////////////////////////////////
bool equalAnalyzer(
arangodb::iresearch::AnalyzerPool const& pool,
irs::string_ref const& type,
VPackSlice const properties,
irs::flags const& features) {
std::string normalizedProperties;
if (!::normalize(normalizedProperties, type, properties)) {
// failed to normalize definition
LOG_TOPIC("dfac1", WARN, arangodb::iresearch::TOPIC)
<< "failed to normalize properties for analyzer type '" << type << "' properties '"
<< properties.toString() << "'";
return false;
}
// first check non-normalizeable portion of analyzer definition
// to rule out need to check normalization of properties
if (type != pool.type() || features != pool.features()) {
return false;
}
// this check is not final as old-normalized definition may be present in database!
if (arangodb::basics::VelocyPackHelper::equal(arangodb::iresearch::slice(normalizedProperties),
pool.properties(), false)) {
return true;
}
// Here could be analyzer definition with old-normalized properties (see Issue #9652)
// To make sure properties really differ, let`s re-normalize and re-check
std::string reNormalizedProperties;
if (ADB_UNLIKELY(!::normalize(reNormalizedProperties, pool.type(), pool.properties()))) {
// failed to re-normalize definition - strange. It was already normalized once.
// Some bug in load/store?
TRI_ASSERT(FALSE);
LOG_TOPIC("a4073", WARN, arangodb::iresearch::TOPIC)
<< "failed to re-normalize properties for analyzer type '"
<< pool.type()
<< "' properties '" << pool.properties().toString() << "'";
return false;
}
return arangodb::basics::VelocyPackHelper::equal(
arangodb::iresearch::slice(normalizedProperties),
arangodb::iresearch::slice(reNormalizedProperties), false);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief get the collection containing analyzer definitions (if found)
/// taken from vocabse for single-server and from ClusterInfo on cluster
/// @note cannot use arangodb::methods::Collections::lookup(...) since it will
/// try to resolve via vocbase for the case of db-server
/// @note cannot use arangodb::CollectionNameResolver::getCollection(...) since
/// it will try to resolve via vocbase for the case of db-server
////////////////////////////////////////////////////////////////////////////////
std::shared_ptr<arangodb::LogicalCollection> getAnalyzerCollection( // get collection
TRI_vocbase_t const& vocbase // collection vocbase
) {
if (arangodb::ServerState::instance()->isSingleServer()) {
return vocbase.lookupCollection(ANALYZER_COLLECTION_NAME);
}
try {
if (vocbase.server().hasFeature<arangodb::ClusterFeature>()) {
return vocbase.server()
.getFeature<arangodb::ClusterFeature>()
.clusterInfo()
.getCollectionNT(vocbase.name(), ANALYZER_COLLECTION_NAME);
}
LOG_TOPIC("00001", WARN, arangodb::iresearch::TOPIC)
<< "failure to find 'ClusterInfo' instance while looking up Analyzer collection '" << ANALYZER_COLLECTION_NAME << "' in vocbase '" << vocbase.name() << "'";
} catch (arangodb::basics::Exception& e) {
LOG_TOPIC("00002", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while looking up Analyzer collection '" << ANALYZER_COLLECTION_NAME << "' in vocbase '" << vocbase.name() << "': " << e.code() << " " << e.what();
IR_LOG_EXCEPTION();
} catch (std::exception& e) {
LOG_TOPIC("00003", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while looking up Analyzer collection '" << ANALYZER_COLLECTION_NAME << "' in vocbase '" << vocbase.name() << "': " << e.what();
IR_LOG_EXCEPTION();
} catch (...) {
LOG_TOPIC("00004", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while looking up Analyzer collection '" << ANALYZER_COLLECTION_NAME << "' in vocbase '" << vocbase.name() << "'";
IR_LOG_EXCEPTION();
}
return nullptr;
}
std::string normalizedAnalyzerName(
std::string database, // database
irs::string_ref const& analyzer // analyzer
) {
return database.append(2, ANALYZER_PREFIX_DELIM).append(analyzer);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief read analyzers from vocbase
/// @return visitation completed fully
////////////////////////////////////////////////////////////////////////////////
arangodb::Result visitAnalyzers( // visit analyzers
TRI_vocbase_t& vocbase, // vocbase to visit
std::function<arangodb::Result(arangodb::velocypack::Slice const& slice)> const& visitor // visitor
) {
static const auto resultVisitor = [](
std::function<arangodb::Result(arangodb::velocypack::Slice const& slice)> const& visitor, // visitor
TRI_vocbase_t const& vocbase, // vocbase
arangodb::velocypack::Slice const& slice // slice to visit
)->arangodb::Result {
if (!slice.isArray()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failed to parse contents of collection '") + ANALYZER_COLLECTION_NAME + "' in database '" + vocbase.name() + " while visiting analyzers"
);
}
for (arangodb::velocypack::ArrayIterator itr(slice); itr.valid(); ++itr) {
auto res = visitor(itr.value().resolveExternal());
if (!res.ok()) {
return res;
}
}
return arangodb::Result();
};
// FIXME TODO find a better way to query a cluster collection
// workaround for aql::Query failing to execute on a cluster collection
if (arangodb::ServerState::instance()->isDBServer()) {
arangodb::NetworkFeature const& feature =
vocbase.server().getFeature<arangodb::NetworkFeature>();
arangodb::network::ConnectionPool* pool = feature.pool();
if (!pool) {
return arangodb::Result( // result
TRI_ERROR_SHUTTING_DOWN, // code
std::string("failure to find connection pool while visiting Analyzer "
"collection '") +
ANALYZER_COLLECTION_NAME + "' in vocbase '" + vocbase.name() +
"', server is likely shutting down");
}
auto collection = getAnalyzerCollection(vocbase);
if (!collection) {
return arangodb::Result(); // nothing to load
}
// RestSimpleQueryHandler::allDocuments() expects opbject (calls get() on slice)
VPackBuffer<uint8_t> buffer;
{
VPackBuilder builder(buffer);
builder.openObject();
builder.close();
}
arangodb::network::Headers headers;
std::vector<arangodb::network::FutureRes> futures;
// create a request for every shard
//for (auto& entry: collection->errorNum()) {
for (auto& entry: *(collection->shardIds())) {
auto& shardId = entry.first;
auto url = // url
"/_db/" + arangodb::basics::StringUtils::urlEncode(vocbase.name())
+ arangodb::RestVocbaseBaseHandler::SIMPLE_QUERY_ALL_PATH
+ "?collection=" + shardId;
auto f = arangodb::network::sendRequest(pool,
"shard:" + shardId, // shard
arangodb::fuerte::RestVerb::Put, // request type as per SimpleQueryHandker
url, // request url
buffer, // body
arangodb::network::Timeout(120.0), headers);
futures.emplace_back(std::move(f));
}
auto results = arangodb::futures::collectAll(futures).get();
for (auto& r : results) {
auto& res = r.get();
if (res.error != arangodb::fuerte::Error::NoError) {
return arangodb::Result(arangodb::network::fuerteToArangoErrorCode(res));
}
if (res.response->statusCode() == arangodb::fuerte::StatusNotFound) {
continue; // treat missing collection as if there are no analyzers
}
std::vector<VPackSlice> slices = res.response->slices();
if (slices.empty() || !slices[0].isObject()) {
return arangodb::Result(
TRI_ERROR_INTERNAL,
"got misformed result while visiting Analyzer collection'" + ANALYZER_COLLECTION_NAME +
"' in vocbase '" + vocbase.name() + "'");
}
VPackSlice answer = slices[0];
arangodb::Result result =
arangodb::network::resultFromBody(answer, TRI_ERROR_NO_ERROR);
if (result.fail()) {
return result;
}
if (!answer.hasKey("result")) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string(
"failed to parse result while visiting Analyzer collection '") +
ANALYZER_COLLECTION_NAME + "' in vocbase '" + vocbase.name() +
"'");
}
result = resultVisitor(visitor, vocbase, answer.get("result"));
if (!result.ok()) {
return result;
}
}
return arangodb::Result();
}
if (arangodb::ServerState::instance()->isClusterRole()) {
if (!getAnalyzerCollection(vocbase)) {
return arangodb::Result(); // treat missing collection as if there are no analyzers
}
static const auto queryString = arangodb::aql::QueryString( // query to execute
std::string("FOR d IN ") + ANALYZER_COLLECTION_NAME + " RETURN d" // query
);
arangodb::aql::Query query( // query
false, vocbase, queryString, nullptr, nullptr, arangodb::aql::PART_MAIN // args
);
auto* queryRegistry = arangodb::QueryRegistryFeature::registry();
auto result = query.executeSync(queryRegistry);
if (TRI_ERROR_ARANGO_DATA_SOURCE_NOT_FOUND == result.result.errorNumber()) {
return arangodb::Result(); // treat missing collection as if there are no analyzers
}
if (result.result.fail()) {
return result.result;
}
auto slice = result.data->slice();
return resultVisitor(visitor, vocbase, slice);
}
if (!vocbase.lookupCollection(ANALYZER_COLLECTION_NAME)) {
return arangodb::Result(); // treat missing collection as if there are no analyzers
}
arangodb::OperationOptions options;
arangodb::SingleCollectionTransaction trx( // transaction
arangodb::transaction::StandaloneContext::Create(vocbase), // context
ANALYZER_COLLECTION_NAME, // collection
arangodb::AccessMode::Type::READ // access more
);
auto res = trx.begin();
if (!res.ok()) {
return res;
}
auto commit = irs::make_finally([&trx]()->void {
// end read-only transaction
TRI_ASSERT(trx.state()->isReadOnlyTransaction());
arangodb::Result res = trx.commit();
// ignore return value here
(void) res;
});
auto result = trx.all(ANALYZER_COLLECTION_NAME, 0, 0, options);
if (!result.result.ok()) {
return result.result;
}
auto slice = arangodb::velocypack::Slice(result.buffer->data());
return resultVisitor(visitor, vocbase, slice);
}
typedef irs::async_utils::read_write_mutex::read_mutex ReadMutex;
typedef irs::async_utils::read_write_mutex::write_mutex WriteMutex;
} // namespace
namespace arangodb {
namespace iresearch {
void AnalyzerPool::toVelocyPack(
VPackBuilder& builder,
irs::string_ref const& name) {
TRI_ASSERT(builder.isOpenObject());
// if (forPersistence) {
// arangodb::iresearch::addStringRef(builder, arangodb::StaticStrings::KeyString, name);
// }
arangodb::iresearch::addStringRef(builder, StaticStrings::AnalyzerNameField, name);
arangodb::iresearch::addStringRef(builder, StaticStrings::AnalyzerTypeField, type());
builder.add(StaticStrings::AnalyzerPropertiesField, properties());
// add features
VPackArrayBuilder featuresScope(&builder, StaticStrings::AnalyzerFeaturesField);
for (auto& feature: features()) {
TRI_ASSERT(feature); // has to be non-nullptr
arangodb::iresearch::addStringRef(builder, feature->name());
}
}
void AnalyzerPool::toVelocyPack(VPackBuilder& builder,
TRI_vocbase_t const* vocbase /*= nullptr*/) {
irs::string_ref name = this->name();
if (vocbase) {
auto const split = IResearchAnalyzerFeature::splitAnalyzerName(name);
if (!split.first.null()) {
if (split.first == vocbase->name()) {
name = split.second;
} else {
name = irs::string_ref(split.second.c_str()-2, split.second.size()+2);
}
}
}
VPackObjectBuilder rootScope(&builder);
toVelocyPack(builder, name);
}
void AnalyzerPool::toVelocyPack(VPackBuilder& builder,
bool forPersistence /*= false*/) {
irs::string_ref name = this->name();
if (forPersistence) {
name = IResearchAnalyzerFeature::splitAnalyzerName(name).second;
}
VPackObjectBuilder rootScope(&builder);
toVelocyPack(builder, name);
}
/*static*/ AnalyzerPool::Builder::ptr
AnalyzerPool::Builder::make(
irs::string_ref const& type,
VPackSlice properties) {
if (type.empty()) {
// in ArangoSearch we don't allow to have analyzers with empty type string
return nullptr;
}
// for API consistency we only support analyzers configurable via jSON
return irs::analysis::analyzers::get(
type, irs::text_format::vpack, iresearch::ref<char>(properties), false);
}
AnalyzerPool::AnalyzerPool(irs::string_ref const& name)
: _cache(DEFAULT_POOL_SIZE),
_name(name) {
}
bool AnalyzerPool::init(
irs::string_ref const& type,
VPackSlice const properties,
irs::flags const& features /*= irs::flags::empty_instance()*/) {
try {
_cache.clear(); // reset for new type/properties
_config.clear();
if (!::normalize(_config, type, properties)) {
// failed to normalize analyzer definition
_config.clear();
return false;
}
if (_config.empty()) {
// even empty slice has some bytes in it.
// zero bytes output while returned true is clearly a bug
// in analyzer`s normalization function
TRI_ASSERT(!_config.empty());
// in non maintainer mode just prevent corrupted analyzer from activating
return false;
}
// ensure no reallocations will happen
_config.reserve(_config.size() + type.size());
auto instance = _cache.emplace(type, arangodb::iresearch::slice(_config));
if (instance) {
_properties = VPackSlice::noneSlice();
_type = irs::string_ref::NIL;
_key = irs::string_ref::NIL;
_properties = arangodb::iresearch::slice(_config);
if (!type.null()) {
_config.append(type);
_type = irs::string_ref(_config.c_str() + _properties.byteSize() , type.size());
}
_features = features; // store only requested features
return true;
}
} catch (arangodb::basics::Exception& e) {
LOG_TOPIC("62062", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while initializing an arangosearch analizer type '" << _type
<< "' properties '" << _properties << "': " << e.code() << " " << e.what();
IR_LOG_EXCEPTION();
} catch (std::exception& e) {
LOG_TOPIC("a9196", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while initializing an arangosearch analizer type '"
<< _type << "' properties '" << _properties << "': " << e.what();
IR_LOG_EXCEPTION();
} catch (...) {
LOG_TOPIC("7524a", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while initializing an arangosearch analizer type '"
<< _type << "' properties '" << _properties << "'";
IR_LOG_EXCEPTION();
}
_config.clear(); // set as uninitialized
_key = irs::string_ref::NIL; // set as uninitialized
_type = irs::string_ref::NIL; // set as uninitialized
_properties = VPackSlice::noneSlice(); // set as uninitialized
_features.clear(); // set as uninitialized
return false;
}
void AnalyzerPool::setKey(irs::string_ref const& key) {
if (key.null()) {
_key = irs::string_ref::NIL;
return; // nothing more to do
}
// since VPackSlice is not blind pointer
// store properties status before append.
// After reallocation all methods of Slice will not work!
const auto propertiesIsNone = _properties.isNone();
const auto propertiesByteSize = propertiesIsNone ? 0 : _properties.byteSize();
const auto keyOffset = _config.size();
_config.append(key.c_str(), key.size());
// update '_properties' since '_config' might have been reallocated during
// append(...)
if (!propertiesIsNone) {
TRI_ASSERT(propertiesByteSize <= _config.size());
_properties = arangodb::iresearch::slice(_config);
}
// update '_type' since '_config' might have been reallocated during
// append(...)
if (!_type.null()) {
TRI_ASSERT(_properties.byteSize() + _type.size() <= _config.size());
_type = irs::string_ref(_config.c_str() + _properties.byteSize(), _type.size());
}
_key = irs::string_ref(_config.c_str() + keyOffset, key.size());
}
irs::analysis::analyzer::ptr AnalyzerPool::get() const noexcept {
try {
// FIXME do not use shared_ptr
return _cache.emplace(_type, _properties).release();
} catch (arangodb::basics::Exception const& e) {
LOG_TOPIC("c9256", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while instantiating an arangosearch analizer type "
"'"
<< _type << "' properties '" << _properties << "': " << e.code() << " "
<< e.what();
IR_LOG_EXCEPTION();
} catch (std::exception& e) {
LOG_TOPIC("93baf", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while instantiating an arangosearch analizer type "
"'"
<< _type << "' properties '" << _properties << "': " << e.what();
IR_LOG_EXCEPTION();
} catch (...) {
LOG_TOPIC("08db9", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while instantiating an arangosearch analizer type "
"'"
<< _type << "' properties '" << _properties << "'";
IR_LOG_EXCEPTION();
}
return nullptr;
}
IResearchAnalyzerFeature::IResearchAnalyzerFeature(arangodb::application_features::ApplicationServer& server)
: ApplicationFeature(server, IResearchAnalyzerFeature::name()) {
setOptional(true);
startsAfter<arangodb::application_features::V8FeaturePhase>();
// used for registering IResearch analyzer functions
startsAfter<arangodb::aql::AqlFunctionFeature>();
// used for getting the system database
// containing the persisted configuration
startsAfter<arangodb::SystemDatabaseFeature>();
}
/*static*/ bool IResearchAnalyzerFeature::canUse( // check permissions
TRI_vocbase_t const& vocbase, // analyzer vocbase
arangodb::auth::Level const& level // access level
) {
auto& ctx = arangodb::ExecContext::current();
return ctx.canUseDatabase(vocbase.name(), level) && // can use vocbase
ctx.canUseCollection(vocbase.name(), ANALYZER_COLLECTION_NAME, level); // can use analyzers
}
/*static*/ bool IResearchAnalyzerFeature::canUse( // check permissions
irs::string_ref const& name, // analyzer name (already normalized)
arangodb::auth::Level const& level // access level
) {
auto& ctx = arangodb::ExecContext::current();
if (ctx.isAdminUser()) {
return true; // authentication not enabled
}
auto& staticAnalyzers = getStaticAnalyzers();
if (staticAnalyzers.find(irs::make_hashed_ref(name, std::hash<irs::string_ref>())) != staticAnalyzers.end()) {
return true; // special case for singleton static analyzers (always allowed)
}
auto split = splitAnalyzerName(name);
return split.first.null() // static analyzer (always allowed)
|| (ctx.canUseDatabase(split.first, level) // can use vocbase
&& ctx.canUseCollection(split.first, ANALYZER_COLLECTION_NAME, level) // can use analyzers
);
}
////////////////////////////////////////////////////////////////////////////////
/// @brief validate analyzer parameters and emplace into map
////////////////////////////////////////////////////////////////////////////////
arangodb::Result IResearchAnalyzerFeature::emplaceAnalyzer( // emplace
EmplaceAnalyzerResult& result, // emplacement result on success (out-param)
Analyzers& analyzers,
irs::string_ref const& name,
irs::string_ref const& type,
VPackSlice const properties,
irs::flags const& features) {
// check type available
if (!irs::analysis::analyzers::exists(type, irs::text_format::vpack, false)) {
return arangodb::Result(
TRI_ERROR_NOT_IMPLEMENTED,
"Not implemented analyzer type '" + std::string(type) + "'.");
}
// validate analyzer name
auto split = splitAnalyzerName(name);
if (!TRI_vocbase_t::IsAllowedName(false, velocypack::StringRef(split.second.c_str(), split.second.size()))) {
return arangodb::Result( // result
TRI_ERROR_BAD_PARAMETER, // code
std::string("invalid characters in analyzer name '") + std::string(split.second) + "'"
);
}
// validate that features are supported by arangod an ensure that their
// dependencies are met
for(auto& feature: features) {
if (&irs::frequency::type() == feature) {
// no extra validation required
} else if (&irs::norm::type() == feature) {
// no extra validation required
} else if (&irs::position::type() == feature) {
if (!features.check(irs::frequency::type())) {
return arangodb::Result(
TRI_ERROR_BAD_PARAMETER,
"missing feature '" + std::string(irs::frequency::type().name()) +
"' required when '" + std::string(feature->name()) + "' feature is specified");
}
} else if (feature) {
return arangodb::Result(
TRI_ERROR_BAD_PARAMETER,
"unsupported analyzer feature '" + std::string(feature->name()) + "'");
}
}
// limit the maximum size of analyzer properties
if (ANALYZER_PROPERTIES_SIZE_MAX < properties.byteSize()) {
return arangodb::Result(
TRI_ERROR_BAD_PARAMETER,
"analyzer properties size of '" + std::to_string(properties.byteSize()) +
"' exceeds the maximum allowed limit of '" + std::to_string(ANALYZER_PROPERTIES_SIZE_MAX) + "'");
}
static const auto generator = []( // key + value generator
irs::hashed_string_ref const& key, // source key
AnalyzerPool::ptr const& value // source value
)->irs::hashed_string_ref {
auto pool = std::make_shared<AnalyzerPool>(key); // allocate pool
const_cast<AnalyzerPool::ptr&>(value) = pool; // lazy-instantiate pool to avoid allocation if pool is already present
return pool ? irs::hashed_string_ref(key.hash(), pool->name()) : key; // reuse hash but point ref at value in pool
};
auto itr = irs::map_utils::try_emplace_update_key( // emplace and update key
analyzers, // destination
generator, // key generator
irs::make_hashed_ref(name, std::hash<irs::string_ref>()) // key
);
auto analyzer = itr.first->second;
if (!analyzer) {
return arangodb::Result(
TRI_ERROR_BAD_PARAMETER,
"failure creating an arangosearch analyzer instance for name '" + std::string(name) +
"' type '" + std::string(type) + "' properties '" + properties.toString() + "'");
}
// new analyzer creation, validate
if (itr.second) {
bool erase = true; // potentially invalid insertion took place
auto cleanup = irs::make_finally([&erase, &analyzers, &itr]()->void {
// cppcheck-suppress knownConditionTrueFalse
if (erase) {
analyzers.erase(itr.first); // ensure no broken analyzers are left behind
}
});
if (!analyzer->init(type, properties, features)) {
return arangodb::Result(
TRI_ERROR_BAD_PARAMETER,
"Failure initializing an arangosearch analyzer instance for name '" + std::string(name) +
"' type '" + std::string(type) + "'." +
(properties.isNone() ?
std::string(" Init without properties")
: std::string(" Properties '") + properties.toString() + "'") +
" was rejected by analyzer. Please check documentation for corresponding analyzer type.");
}
erase = false;
} else if (!equalAnalyzer(*analyzer, type, properties, features)) { // duplicate analyzer with different configuration
std::ostringstream errorText; // make it look more like velocypack toString result
errorText << "Name collision detected while registering an arangosearch analyzer.\n"
<< "Current definition is:\n{\n name:'" << name << "'\n"
<< " type: '" << type << "'\n";
if (!properties.isNone()) {
errorText << " properties:'" << properties.toString() << "'\n";
}
errorText << " features: [\n";
for (auto feature = std::begin(features); feature != std::end(features);) {
errorText << " '" << (*feature)->name() << "'";
++feature;
if (feature != std::end(features)) {
errorText << ",";
}
errorText << "\n";
}
VPackBuilder existingDefinition;
analyzer->toVelocyPack(existingDefinition, false);
errorText << " ]\n}\nPrevious definition was:\n"
<< existingDefinition.toString();
return arangodb::Result(TRI_ERROR_BAD_PARAMETER, errorText.str());
}
result = itr;
return arangodb::Result();
}
arangodb::Result IResearchAnalyzerFeature::ensure( // ensure analyzer existence if possible
EmplaceResult& result, // emplacement result on success (out-param)
irs::string_ref const& name, // analyzer name
irs::string_ref const& type, // analyzer type
VPackSlice const properties, // analyzer properties
irs::flags const& features, // analyzer features
bool isEmplace) {
try {
auto split = splitAnalyzerName(name);
WriteMutex mutex(_mutex);
SCOPED_LOCK(mutex);
if (!split.first.null()) { // do not trigger load for static-analyzer requests
// do not trigger load of analyzers on coordinator or db-server to avoid
// recursive lock aquisition in ClusterInfo::loadPlan() if called due to
// IResearchLink creation,
// also avoids extra cluster calls if it can be helped (optimization)
if (!isEmplace && arangodb::ServerState::instance()->isClusterRole()) {
auto itr = _analyzers.find( // find analyzer previous definition
irs::make_hashed_ref(name, std::hash<irs::string_ref>())
);
if (itr != _analyzers.end()) {
_analyzers.erase(itr); // remove old definition instead of reloading all
}
} else { // trigger analyzer load
auto res = loadAnalyzers(split.first);
if (!res.ok()) {
return res;
}
}
}
// validate and emplace an analyzer
EmplaceAnalyzerResult itr;
auto res = emplaceAnalyzer(itr, _analyzers, name, type, properties, features);
if (!res.ok()) {
return res;
}
auto* engine = arangodb::EngineSelectorFeature::ENGINE;
bool erase = itr.second; // an insertion took place
auto cleanup = irs::make_finally([&erase, this, &itr]()->void {
if (erase) {
_analyzers.erase(itr.first); // ensure no broken analyzers are left behind
}
});
auto pool = itr.first->second;
// new pool creation
if (itr.second) {
if (!pool) {
return arangodb::Result(
TRI_ERROR_INTERNAL,
"failure creating an arangosearch analyzer instance for name '" + std::string(name) +
"' type '" + std::string(type) +
"' properties '" + properties.toString() + "'");
}
// persist only on coordinator and single-server while not in recovery
if ((!engine || !engine->inRecovery()) // do not persist during recovery
&& (arangodb::ServerState::instance()->isCoordinator() // coordinator
|| arangodb::ServerState::instance()->isSingleServer())) {// single-server
res = storeAnalyzer(*pool);
}
if (res.ok()) {
result = std::make_pair(pool, itr.second);
// cppcheck-suppress unreadVariable
erase = false; // successful pool creation, cleanup not required
}
return res;
}
result = std::make_pair(pool, itr.second);
} catch (arangodb::basics::Exception const& e) {
return arangodb::Result( // result
e.code(), // code
"caught exception while registering an arangosearch analizer name '" + std::string(name) +
"' type '" + std::string(type) +
"' properties '" + properties.toString() +
"': " + std::to_string(e.code()) + " " + e.what());
} catch (std::exception const& e) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
"caught exception while registering an arangosearch analizer name '" + std::string(name) +
"' type '" + std::string(type) +
"' properties '" + properties.toString() + "': " + e.what());
} catch (...) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
"caught exception while registering an arangosearch analizer name '" + std::string(name) +
"' type '" + std::string(type) +
"' properties '" + properties.toString() + "'");
}
return arangodb::Result();
}
AnalyzerPool::ptr IResearchAnalyzerFeature::get( // find analyzer
irs::string_ref const& name, // analyzer name
TRI_vocbase_t const& activeVocbase, // fallback vocbase if not part of name
TRI_vocbase_t const& systemVocbase, // the system vocbase for use with empty prefix
bool onlyCached /*= false*/ // check only locally cached analyzers
) const noexcept {
try {
auto const normalizedName = normalize(name, activeVocbase, systemVocbase, true);
auto const split = splitAnalyzerName(normalizedName);
// FIXME deduplicate code below, see get(irs::string, bool)
if (!split.first.null()) { // check if analyzer is static
if (split.first != activeVocbase.name() && split.first != systemVocbase.name()) {
// accessing local analyzer from within another database
return nullptr;
}
if (!onlyCached) {
// load analyzers for database
auto res = const_cast<IResearchAnalyzerFeature*>(this)->loadAnalyzers(split.first);
if (!res.ok()) {
LOG_TOPIC("36062", WARN, arangodb::iresearch::TOPIC)
<< "failure to load analyzers for database '" << split.first << "' while getting analyzer '" << name << "': " << res.errorNumber() << " " << res.errorMessage();
TRI_set_errno(res.errorNumber());
return nullptr;
}
}
}
ReadMutex mutex(_mutex);
SCOPED_LOCK(mutex);
auto itr = _analyzers.find(
irs::make_hashed_ref(static_cast<irs::string_ref>(normalizedName),
std::hash<irs::string_ref>())
);
if (itr == _analyzers.end()) {
LOG_TOPIC("4049c", WARN, arangodb::iresearch::TOPIC)
<< "failure to find arangosearch analyzer name '" << name << "'";
return nullptr;
}
auto pool = itr->second;
if (pool) {
return pool;
}
LOG_TOPIC("1a29c", WARN, arangodb::iresearch::TOPIC)
<< "failure to get arangosearch analyzer name '" << name << "'";
TRI_set_errno(TRI_ERROR_INTERNAL);
} catch (arangodb::basics::Exception& e) {
LOG_TOPIC("29eff", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "': " << e.code() << " " << e.what();
IR_LOG_EXCEPTION();
} catch (std::exception& e) {
LOG_TOPIC("ce8d5", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "': " << e.what();
IR_LOG_EXCEPTION();
} catch (...) {
LOG_TOPIC("5505f", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "'";
IR_LOG_EXCEPTION();
}
return nullptr;
}
AnalyzerPool::ptr IResearchAnalyzerFeature::get( // find analyzer
irs::string_ref const& name, // analyzer name
bool onlyCached /*= false*/ // check only locally cached analyzers
) const noexcept {
try {
auto const split = splitAnalyzerName(name);
if (!split.first.null() && !onlyCached) { // do not trigger load for static-analyzer requests
auto res = // load analyzers for database
const_cast<IResearchAnalyzerFeature*>(this)->loadAnalyzers(split.first);
if (!res.ok()) {
LOG_TOPIC("36068", WARN, arangodb::iresearch::TOPIC)
<< "failure to load analyzers for database '" << split.first << "' while getting analyzer '" << name << "': " << res.errorNumber() << " " << res.errorMessage();
TRI_set_errno(res.errorNumber());
return nullptr;
}
}
ReadMutex mutex(_mutex);
SCOPED_LOCK(mutex);
auto itr =
_analyzers.find(irs::make_hashed_ref(name, std::hash<irs::string_ref>()));
if (itr == _analyzers.end()) {
LOG_TOPIC("4049d", WARN, arangodb::iresearch::TOPIC)
<< "failure to find arangosearch analyzer name '" << name << "'";
return nullptr;
}
auto pool = itr->second;
if (pool) {
return pool;
}
LOG_TOPIC("826db", WARN, arangodb::iresearch::TOPIC)
<< "failure to get arangosearch analyzer name '" << name << "'";
TRI_set_errno(TRI_ERROR_INTERNAL);
} catch (arangodb::basics::Exception& e) {
LOG_TOPIC("89eff", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "': " << e.code() << " " << e.what();
IR_LOG_EXCEPTION();
} catch (std::exception& e) {
LOG_TOPIC("ce8d9", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "': " << e.what();
IR_LOG_EXCEPTION();
} catch (...) {
LOG_TOPIC("55050", WARN, arangodb::iresearch::TOPIC)
<< "caught exception while retrieving an arangosearch analizer name '"
<< name << "'";
IR_LOG_EXCEPTION();
}
return nullptr;
}
////////////////////////////////////////////////////////////////////////////////
/// @brief return a container of statically defined/initialized analyzers
////////////////////////////////////////////////////////////////////////////////
/*static*/ IResearchAnalyzerFeature::Analyzers const& IResearchAnalyzerFeature::getStaticAnalyzers() {
struct Instance {
Analyzers analyzers;
Instance() {
// register the indentity analyzer
{
irs::flags const extraFeatures = {irs::frequency::type(), irs::norm::type()};
irs::string_ref const name("identity");
auto pool = std::make_shared<AnalyzerPool>(name);
if (!pool || !pool->init(IdentityAnalyzer::type().name(),
VPackSlice::emptyObjectSlice(),
extraFeatures)) {
LOG_TOPIC("26de1", WARN, arangodb::iresearch::TOPIC)
<< "failure creating an arangosearch static analyzer instance "
"for name '"
<< name << "'";
// this should never happen, treat as an assertion failure
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_INTERNAL, "failed to create arangosearch static analyzer");
}
analyzers.emplace(
irs::make_hashed_ref(irs::string_ref(pool->name()), std::hash<irs::string_ref>()),
pool);
}
// register the text analyzers
{
// Note: ArangoDB strings coming from JavaScript user input are UTF-8 encoded
irs::string_ref const locales[] = {
"de", "en", "es", "fi", "fr", "it",
"nl", "no", "pt", "ru", "sv", "zh"
};
irs::flags const extraFeatures = {
irs::frequency::type(),
irs::norm::type(),
irs::position::type()
}; // add norms + frequency/position for by_phrase
irs::string_ref const type("text");
std::string name;
VPackBuilder properties;
for (auto const& locale: locales) {
// "text_<locale>"
{
name = "text_";
name.append(locale.c_str(), locale.size());
}
// { locale: "<locale>.UTF-8", stopwords: [] }
{
properties.clear();
VPackObjectBuilder rootScope(&properties);
properties.add("locale", VPackValue(std::string(locale) + ".UTF-8"));
VPackArrayBuilder stopwordsArrayScope(&properties, "stopwords");
}
auto pool = std::make_shared<AnalyzerPool>(name);
if (!pool->init(type, properties.slice(), extraFeatures)) {
LOG_TOPIC("e25f5", WARN, arangodb::iresearch::TOPIC)
<< "failure creating an arangosearch static analyzer instance "
"for name '"
<< name << "'";
// this should never happen, treat as an assertion failure
THROW_ARANGO_EXCEPTION_MESSAGE(TRI_ERROR_INTERNAL, "failed to create arangosearch static analyzer instance");
}
analyzers.emplace(
irs::make_hashed_ref(irs::string_ref(pool->name()), std::hash<irs::string_ref>()),
pool);
}
}
}
};
static const Instance instance;
// cppcheck-suppress returnReference
return instance.analyzers;
}
/*static*/ AnalyzerPool::ptr IResearchAnalyzerFeature::identity() noexcept {
struct Identity {
AnalyzerPool::ptr instance;
Identity() {
// find the 'identity' analyzer pool in the static analyzers
auto& staticAnalyzers = getStaticAnalyzers();
irs::string_ref name = IDENTITY_ANALYZER_NAME; // hardcoded name of the identity analyzer pool
auto key = irs::make_hashed_ref(name, std::hash<irs::string_ref>());
auto itr = staticAnalyzers.find(key);
if (itr != staticAnalyzers.end()) {
instance = itr->second;
}
}
};
static const Identity identity;
return identity.instance;
}
arangodb::Result IResearchAnalyzerFeature::loadAnalyzers(
irs::string_ref const& database /*= irs::string_ref::NIL*/) {
try {
if (!server().hasFeature<arangodb::DatabaseFeature>()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find feature 'Database' while loading "
"analyzers for database '") +
std::string(database) + "'");
}
auto& dbFeature = server().getFeature<arangodb::DatabaseFeature>();
WriteMutex mutex(_mutex);
SCOPED_LOCK(mutex); // '_analyzers'/'_lastLoad' can be asynchronously read
// load all databases
if (database.null()) {
arangodb::Result res;
std::unordered_set<irs::hashed_string_ref> seen;
auto visitor = [this, &res, &seen](TRI_vocbase_t& vocbase)->void {
if (!vocbase.lookupCollection(ANALYZER_COLLECTION_NAME)) {
return; // skip databases lacking 'ANALYZER_COLLECTION_NAME' (no analyzers there, not an error)
}
auto name = irs::make_hashed_ref( // vocbase name
irs::string_ref(vocbase.name()), std::hash<irs::string_ref>() // args
);
auto result = loadAnalyzers(name);
auto itr = _lastLoad.find(name);
if (itr != _lastLoad.end()) {
seen.insert(name);
} else if (res.ok()) { // load errors take precedence
res = arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
"failure to find database last load timestamp after loading analyzers" // message
);
}
if (!result.ok()) {
res = result;
}
};
dbFeature.enumerateDatabases(visitor);
std::unordered_set<std::string> unseen; // make copy since original removed
// remove unseen databases from timestamp list
for (auto itr = _lastLoad.begin(), end = _lastLoad.end(); itr != end;) {
auto name = irs::make_hashed_ref( // vocbase name
irs::string_ref(itr->first), std::hash<irs::string_ref>() // args
);
auto seenItr = seen.find(name);
if (seenItr == seen.end()) {
unseen.insert(std::move(itr->first)); // reuse key
itr = _lastLoad.erase(itr);
} else {
++itr;
}
}
// remove no longer valid analyzers (force remove)
for (auto itr = _analyzers.begin(), end = _analyzers.end(); itr != end;) {
auto split = splitAnalyzerName(itr->first);
auto unseenItr = // ignore static analyzers
split.first.null() ? unseen.end() : unseen.find(split.first);
if (unseenItr != unseen.end()) {
itr = _analyzers.erase(itr);
} else {
++itr;
}
}
return res;
}
// .........................................................................
// after here load analyzers from a specific database
// .........................................................................
auto currentTimestamp = std::chrono::system_clock::now();
auto databaseKey = // database key used in '_lastLoad'
irs::make_hashed_ref(database, std::hash<irs::string_ref>());
auto* engine = arangodb::EngineSelectorFeature::ENGINE;
auto itr = _lastLoad.find(databaseKey); // find last update timestamp
if (!engine || engine->inRecovery()) {
// always load if inRecovery since collection contents might have changed
// unless on db-server which does not store analyzer definitions in collections
if (arangodb::ServerState::instance()->isDBServer()) {
return arangodb::Result(); // db-server should not access cluster during inRecovery
}
} else if (arangodb::ServerState::instance()->isSingleServer()) { // single server
if(itr != _lastLoad.end()) {
return arangodb::Result(); // do not reload on single-server
}
} else if (itr != _lastLoad.end() // had a previous load
&& itr->second + RELOAD_INTERVAL > currentTimestamp // timeout not reached
) {
return arangodb::Result(); // reload interval not reached
}
auto* vocbase = dbFeature.lookupDatabase(database);
if (!vocbase) {
if (engine && engine->inRecovery()) {
return arangodb::Result(); // database might not have come up yet
}
if (itr != _lastLoad.end()) {
cleanupAnalyzers(database); // cleanup any analyzers for 'database'
_lastLoad.erase(itr);
}
return arangodb::Result( // result
TRI_ERROR_ARANGO_DATABASE_NOT_FOUND, // code
std::string("failed to find database '") + std::string(database) + "' while loading analyzers"
);
}
if (!getAnalyzerCollection(*vocbase)) {
if (itr != _lastLoad.end()) {
cleanupAnalyzers(database); // cleanup any analyzers for 'database'
}
_lastLoad[databaseKey] = currentTimestamp; // update timestamp
return arangodb::Result(); // no collection means nothing to load
}
Analyzers analyzers;
auto visitor = [this, &analyzers, &vocbase](arangodb::velocypack::Slice const& slice)->arangodb::Result {
if (!slice.isObject()) {
LOG_TOPIC("5c7a5", ERR, arangodb::iresearch::TOPIC)
<< "failed to find an object value for analyzer definition while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
irs::flags features;
irs::string_ref key;
irs::string_ref name;
irs::string_ref type;
VPackSlice properties;
std::string propertiesBuf;
if (!slice.hasKey(arangodb::StaticStrings::KeyString) // no such field (required)
|| !slice.get(arangodb::StaticStrings::KeyString).isString()) {
LOG_TOPIC("1dc56", ERR, arangodb::iresearch::TOPIC)
<< "failed to find a string value for analyzer '" << arangodb::StaticStrings::KeyString
<< "' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name() << "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
key = getStringRef(slice.get(arangodb::StaticStrings::KeyString));
if (!slice.hasKey("name") // no such field (required)
|| !(slice.get("name").isString() || slice.get("name").isNull())) {
LOG_TOPIC("f5920", ERR, arangodb::iresearch::TOPIC)
<< "failed to find a string value for analyzer 'name' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
name = getStringRef(slice.get("name"));
if (!slice.hasKey("type") // no such field (required)
|| !(slice.get("type").isString() || slice.get("name").isNull())) {
LOG_TOPIC("9f5c8", ERR, arangodb::iresearch::TOPIC)
<< "failed to find a string value for analyzer 'type' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
type = getStringRef(slice.get("type"));
if (slice.hasKey("properties")) {
auto subSlice = slice.get("properties");
if (subSlice.isArray() || subSlice.isObject()) {
properties = subSlice; // format as a jSON encoded string
} else {
LOG_TOPIC("a297e", ERR, arangodb::iresearch::TOPIC)
<< "failed to find a string value for analyzer 'properties' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
}
if (slice.hasKey("features")) {
auto subSlice = slice.get("features");
if (!subSlice.isArray()) {
LOG_TOPIC("7ec8a", ERR, arangodb::iresearch::TOPIC)
<< "failed to find an array value for analyzer 'features' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
for (arangodb::velocypack::ArrayIterator subItr(subSlice);
subItr.valid();
++subItr
) {
auto subEntry = *subItr;
if (!subEntry.isString() && !subSlice.isNull()) {
LOG_TOPIC("7620d", ERR, arangodb::iresearch::TOPIC)
<< "failed to find a string value for an entry in analyzer 'features' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
auto featureName = getStringRef(subEntry);
auto* feature = irs::attribute::type_id::get(featureName, false);
if (!feature) {
LOG_TOPIC("4fedc", ERR, arangodb::iresearch::TOPIC)
<< "failed to find feature '" << featureName << "' while loading analyzer form collection '" << ANALYZER_COLLECTION_NAME
<< "' in database '" << vocbase->name()
<< "', skipping it: " << slice.toString();
return arangodb::Result(); // skip analyzer
}
features.add(*feature);
}
}
auto normalizedName = normalizedAnalyzerName(vocbase->name(), name);
EmplaceAnalyzerResult result;
auto res = emplaceAnalyzer(result, analyzers, normalizedName, type, properties, features);
if (!res.ok()) {
return res; // caught error emplacing analyzer (abort further processing)
}
if (result.second && result.first->second) {
result.first->second->setKey(key); // update key
}
return arangodb::Result();
};
auto res = visitAnalyzers(*vocbase, visitor);
if (!res.ok()) {
return res;
}
// copy over relevant analyzers from '_analyzers' and validate no duplicates
for (auto& entry: _analyzers) {
if (!entry.second) {
continue; // invalid analyzer (should never happen if insertions done via here)
}
auto split = splitAnalyzerName(entry.first);
// different database
if (split.first != vocbase->name()) {
auto result = analyzers.emplace(entry.first, entry.second);
if (!result.second) { // existing entry
if (result.first->second // valid new entry
&& !equalAnalyzer(*(entry.second), result.first->second->type(), result.first->second->properties(), result.first->second->features())) {
return arangodb::Result( // result
TRI_ERROR_BAD_PARAMETER, // code
"name collision detected while re-registering a duplicate arangosearch analizer name '" + std::string(result.first->second->name()) +
"' type '" + std::string(result.first->second->type()) +
"' properties '" + result.first->second->properties().toString() +
"', previous registration type '" + std::string(entry.second->type()) +
"' properties '" + entry.second->properties().toString() + "'"
);
}
result.first->second = entry.second; // reuse old analyzer pool to avoid duplicates in memmory
const_cast<Analyzers::key_type&>(result.first->first) = entry.first; // point key at old pool
}
continue; // done with this analyzer
}
auto itr = analyzers.find(entry.first);
if (itr == analyzers.end()) {
continue; // removed analyzer
}
if (itr->second // valid new entry
&& !equalAnalyzer(*(entry.second), itr->second->type(), itr->second->properties(), itr->second->features())) {
return arangodb::Result( // result
TRI_ERROR_BAD_PARAMETER, // code
"name collision detected while registering a duplicate arangosearch analizer name '" + std::string(itr->second->name()) +
"' type '" + std::string(itr->second->type()) +
"' properties '" + itr->second->properties().toString() +
"', previous registration type '" + std::string(entry.second->type()) +
"' properties '" + entry.second->properties().toString() + "'"
);
}
itr->second = entry.second; // reuse old analyzer pool to avoid duplicates in memmory
const_cast<Analyzers::key_type&>(itr->first) = entry.first; // point key at old pool
}
_lastLoad[databaseKey] = currentTimestamp; // update timestamp
_analyzers = std::move(analyzers); // update mappings
} catch (arangodb::basics::Exception const& e) {
return arangodb::Result( // result
e.code(), // code
std::string("caught exception while loading configuration for arangosearch analyzers from database '") + std::string(database) + "': " + std::to_string(e.code()) + " "+ e.what()
);
} catch (std::exception const& e) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while loading configuration for arangosearch analyzers from database '") + std::string(database) + "': " + e.what()
);
} catch (...) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while loading configuration for arangosearch analyzers from database '") + std::string(database) + "'"
);
}
return arangodb::Result();
}
/*static*/ std::string const& IResearchAnalyzerFeature::name() noexcept {
return FEATURE_NAME;
}
/*static*/ irs::string_ref IResearchAnalyzerFeature::extractVocbaseName(
irs::string_ref const& name) noexcept {// analyzer name (normalized)
auto split = splitAnalyzerName(name);
return split.first;
}
/*static*/ bool IResearchAnalyzerFeature::analyzerReachableFromDb(
irs::string_ref const& dbNameFromAnalyzer,
irs::string_ref const& currentDbName, bool forGetters) noexcept {
TRI_ASSERT(!currentDbName.empty());
if (dbNameFromAnalyzer.null()) { // NULL means local db name = always reachable
return true;
}
if (dbNameFromAnalyzer.empty()) { // empty name with :: means always system
if (forGetters) {
return true; // system database is always accessible for reading analyzer from any other db
}
return currentDbName == arangodb::StaticStrings::SystemDatabase;
}
return currentDbName == dbNameFromAnalyzer ||
(forGetters && dbNameFromAnalyzer == arangodb::StaticStrings::SystemDatabase);
}
/*static*/ std::pair<irs::string_ref, irs::string_ref> IResearchAnalyzerFeature::splitAnalyzerName(
irs::string_ref const& analyzer) noexcept {
// search for vocbase prefix ending with '::'
for (size_t i = 1, count = analyzer.size(); i < count; ++i) {
if (analyzer[i] == ANALYZER_PREFIX_DELIM // current is delim
&& analyzer[i - 1] == ANALYZER_PREFIX_DELIM) { // previous is also delim
auto vocbase = i > 1 // non-empty prefix, +1 for first delimiter char
? irs::string_ref(analyzer.c_str(), i - 1) // -1 for the first ':' delimiter
: irs::string_ref::EMPTY;
auto name = i < count - 1 // have suffix
? irs::string_ref(analyzer.c_str() + i + 1, count - i - 1) // +-1 for the suffix after '::'
: irs::string_ref::EMPTY; // do not point after end of buffer
return std::make_pair(vocbase, name); // prefixed analyzer name
}
}
return std::make_pair(irs::string_ref::NIL, analyzer); // unprefixed analyzer name
}
/*static*/ std::string IResearchAnalyzerFeature::normalize( // normalize name
irs::string_ref const& name, // analyzer name
TRI_vocbase_t const& activeVocbase, // fallback vocbase if not part of name
TRI_vocbase_t const& systemVocbase, // the system vocbase for use with empty prefix
bool expandVocbasePrefix /*= true*/ // use full vocbase name as prefix for active/system v.s. EMPTY/'::'
) {
auto& staticAnalyzers = getStaticAnalyzers();
if (staticAnalyzers.find(irs::make_hashed_ref(name, std::hash<irs::string_ref>())) != staticAnalyzers.end()) {
return name; // special case for singleton static analyzers
}
auto split = splitAnalyzerName(name);
if (expandVocbasePrefix) {
if (split.first.null()) {
return normalizedAnalyzerName(activeVocbase.name(), split.second);
}
if (split.first.empty()) {
return normalizedAnalyzerName(systemVocbase.name(), split.second);
}
} else {
// .........................................................................
// normalize vocbase such that active vocbase takes precedence over system
// vocbase i.e. prefer NIL over EMPTY
// .........................................................................
if (&systemVocbase == &activeVocbase || split.first.null() || (split.first == activeVocbase.name())) { // active vocbase
return split.second;
}
if (split.first.empty() || split.first == systemVocbase.name()) { // system vocbase
return normalizedAnalyzerName("", split.second);
}
}
return name; // name prefixed with vocbase (or NIL)
}
void IResearchAnalyzerFeature::prepare() {
if (!isEnabled()) {
return;
}
// load all known analyzers
::iresearch::analysis::analyzers::init();
// load all static analyzers
_analyzers = getStaticAnalyzers();
}
arangodb::Result IResearchAnalyzerFeature::remove( // remove analyzer
irs::string_ref const& name, // analyzer name
bool force /*= false*/ // force removal
) {
try {
auto split = splitAnalyzerName(name);
if (split.first.null()) {
return arangodb::Result( // result
TRI_ERROR_FORBIDDEN, // code
"built-in analyzers cannot be removed" // message
);
}
WriteMutex mutex(_mutex);
SCOPED_LOCK(mutex);
auto itr = // find analyzer
_analyzers.find(irs::make_hashed_ref(name, std::hash<irs::string_ref>()));
if (itr == _analyzers.end()) {
return arangodb::Result( // result
TRI_ERROR_ARANGO_DOCUMENT_NOT_FOUND, // code
std::string("failure to find analyzer while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
auto& pool = itr->second;
// this should never happen since analyzers should always be valid, but this
// will make the state consistent again
if (!pool) {
_analyzers.erase(itr);
return arangodb::Result( // result
TRI_ERROR_ARANGO_DOCUMENT_NOT_FOUND, // code
std::string("failure to find a valid analyzer while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
if (!force && pool.use_count() > 1) { // +1 for ref in '_analyzers'
return arangodb::Result( // result
TRI_ERROR_ARANGO_CONFLICT, // code
std::string("analyzer in-use while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
// on db-server analyzers are not persisted
// allow removal even inRecovery()
if (arangodb::ServerState::instance()->isDBServer()) {
_analyzers.erase(itr);
return arangodb::Result();
}
// .........................................................................
// after here the analyzer must be removed from the persisted store first
// .........................................................................
// this should never happen since non-static analyzers should always have a
// valid '_key' after
if (pool->_key.null()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find '") + arangodb::StaticStrings::KeyString + "' while removing arangosearch analyzer '" + std::string(name)+ "'"
);
}
auto* engine = arangodb::EngineSelectorFeature::ENGINE;
// do not allow persistence while in recovery
if (engine && engine->inRecovery()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to remove arangosearch analyzer '") + std::string(name)+ "' configuration while storage engine in recovery"
);
}
if (!server().hasFeature<arangodb::DatabaseFeature>()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find feature 'Database' while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
auto& dbFeature = server().getFeature<arangodb::DatabaseFeature>();
auto* vocbase = dbFeature.useDatabase(split.first);
if (!vocbase) {
return arangodb::Result( // result
TRI_ERROR_ARANGO_DATABASE_NOT_FOUND, // code
std::string("failure to find vocbase while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
std::shared_ptr<arangodb::LogicalCollection> collection;
auto collectionCallback = [&collection]( // store collection
std::shared_ptr<arangodb::LogicalCollection> const& col // args
)->void {
collection = col;
};
arangodb::methods::Collections::lookup( // find collection
*vocbase, ANALYZER_COLLECTION_NAME, collectionCallback // args
);
if (!collection) {
return arangodb::Result( // result
TRI_ERROR_ARANGO_DATA_SOURCE_NOT_FOUND, // code
std::string("failure to find collection while removing arangosearch analyzer '") + std::string(name)+ "'"
);
}
arangodb::SingleCollectionTransaction trx( // transaction
arangodb::transaction::StandaloneContext::Create(*vocbase), // transaction context
ANALYZER_COLLECTION_NAME, // collection name
arangodb::AccessMode::Type::WRITE // collection access type
);
auto res = trx.begin();
if (!res.ok()) {
return res;
}
arangodb::velocypack::Builder builder;
arangodb::OperationOptions options;
builder.openObject();
addStringRef(builder, arangodb::StaticStrings::KeyString, pool->_key);
builder.close();
auto result = // remove
trx.remove(ANALYZER_COLLECTION_NAME, builder.slice(), options);
if (!result.ok()) {
trx.abort();
return result.result;
}
auto commitResult = trx.commit();
if (!commitResult.ok()) {
return commitResult;
}
_analyzers.erase(itr);
} catch (arangodb::basics::Exception const& e) {
return arangodb::Result( // result
e.code(), // code
std::string("caught exception while removing configuration for arangosearch analyzer name '") + std::string(name) + "': " + std::to_string(e.code()) + " "+ e.what()
);
} catch (std::exception const& e) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while removing configuration for arangosearch analyzer name '") + std::string(name) + "': " + e.what()
);
} catch (...) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while removing configuration for arangosearch analyzer name '") + std::string(name) + "'"
);
}
return arangodb::Result();
}
void IResearchAnalyzerFeature::start() {
if (!isEnabled()) {
return;
}
#ifdef ARANGODB_ENABLE_MAINTAINER_MODE
// sanity check: we rely on this condition is true internally
{
if (server().hasFeature<arangodb::SystemDatabaseFeature>()) {
auto& sysDbFeature = server().getFeature<arangodb::SystemDatabaseFeature>();
if (sysDbFeature.use()) { // feature/db may be absent in some unit-test enviroment
TRI_ASSERT(sysDbFeature.use()->name() == arangodb::StaticStrings::SystemDatabase);
}
}
}
#endif
// register analyzer functions
{
if (server().hasFeature<arangodb::aql::AqlFunctionFeature>()) {
auto& functions = server().getFeature<arangodb::aql::AqlFunctionFeature>();
addFunctions(functions);
} else {
LOG_TOPIC("7dcd9", WARN, arangodb::iresearch::TOPIC)
<< "failure to find feature 'AQLFunctions' while registering "
"IResearch functions";
}
}
auto res = loadAnalyzers();
if (!res.ok()) {
THROW_ARANGO_EXCEPTION(res);
}
}
void IResearchAnalyzerFeature::stop() {
if (!isEnabled()) {
return;
}
{
WriteMutex mutex(_mutex);
SCOPED_LOCK(mutex); // '_analyzers' can be asynchronously read
_analyzers = getStaticAnalyzers(); // clear cache and reload static analyzers
}
}
arangodb::Result IResearchAnalyzerFeature::storeAnalyzer(AnalyzerPool& pool) {
if (!server().hasFeature<arangodb::DatabaseFeature>()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find feature 'Database' while persising arangosearch analyzer '") + pool.name()+ "'"
);
}
auto& dbFeature = server().getFeature<arangodb::DatabaseFeature>();
if (pool.type().null()) {
return arangodb::Result( // result
TRI_ERROR_BAD_PARAMETER, // code
std::string("failure to persist arangosearch analyzer '") + pool.name()+ "' configuration with 'null' type"
);
}
auto* engine = arangodb::EngineSelectorFeature::ENGINE;
// do not allow persistence while in recovery
if (engine && engine->inRecovery()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to persist arangosearch analyzer '") + pool.name()+ "' configuration while storage engine in recovery"
);
}
auto split = splitAnalyzerName(pool.name());
auto* vocbase = dbFeature.useDatabase(split.first);
if (!vocbase) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find vocbase while persising arangosearch analyzer '") + pool.name()+ "'"
);
}
try {
auto collection = getAnalyzerCollection(*vocbase);
if (!collection) {
return arangodb::Result( // result
TRI_ERROR_ARANGO_DATA_SOURCE_NOT_FOUND, // code
std::string("failure to find collection '") +
ANALYZER_COLLECTION_NAME +
"' in vocbase '" + vocbase->name() +
"' vocbase while persising arangosearch analyzer '" + pool.name()+ "'"
);
}
arangodb::SingleCollectionTransaction trx( // transaction
arangodb::transaction::StandaloneContext::Create(*vocbase), // transaction context
ANALYZER_COLLECTION_NAME, // collection name
arangodb::AccessMode::Type::WRITE // collection access type
);
auto res = trx.begin();
if (!res.ok()) {
return res;
}
arangodb::velocypack::Builder builder;
// for storing in db analyzers collection - store only analyzer name
pool.toVelocyPack(builder, true);
arangodb::OperationOptions options;
options.waitForSync = true;
auto result = trx.insert(ANALYZER_COLLECTION_NAME, builder.slice(), options);
if (!result.ok()) {
trx.abort();
return result.result;
}
auto slice = result.slice();
if (!slice.isObject()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to parse result as a JSON object while persisting configuration for arangosearch analyzer name '") + pool.name() + "'"
);
}
auto key = slice.get(arangodb::StaticStrings::KeyString);
if (!key.isString()) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("failure to find the resulting key field while persisting configuration for arangosearch analyzer name '") + pool.name() + "'"
);
}
res = trx.commit();
if (!res.ok()) {
trx.abort();
return res;
}
pool.setKey(getStringRef(key));
} catch (arangodb::basics::Exception const& e) {
return arangodb::Result( // result
e.code(), // code
std::string("caught exception while persisting configuration for arangosearch analyzer name '") + pool.name() + "': " + std::to_string(e.code()) + " "+ e.what()
);
} catch (std::exception const& e) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while persisting configuration for arangosearch analyzer name '") + pool.name() + "': " + e.what()
);
} catch (...) {
return arangodb::Result( // result
TRI_ERROR_INTERNAL, // code
std::string("caught exception while persisting configuration for arangosearch analyzer name '") + pool.name() + "'"
);
}
return arangodb::Result();
}
bool IResearchAnalyzerFeature::visit( // visit all analyzers
std::function<bool(AnalyzerPool::ptr const& analyzer)> const& visitor // visitor
) const {
Analyzers analyzers;
{
ReadMutex mutex(_mutex);
SCOPED_LOCK(mutex);
analyzers = _analyzers;
}
for (auto& entry: analyzers) {
if (entry.second && !visitor(entry.second)) {
return false; // termination request
}
}
return true;
}
bool IResearchAnalyzerFeature::visit( // visit analyzers
std::function<bool(AnalyzerPool::ptr const& analyzer)> const& visitor, // visitor
TRI_vocbase_t const* vocbase // analyzers for vocbase
) const {
// static analyzer visitation
if (!vocbase) {
for (auto& entry: getStaticAnalyzers()) {
if (entry.second && !visitor(entry.second)) {
return false; // termination request
}
}
return true;
}
auto res = const_cast<IResearchAnalyzerFeature*>(this)->loadAnalyzers( // load analyzers for database
vocbase->name() // args
);
if (!res.ok()) {
LOG_TOPIC("73695", WARN, arangodb::iresearch::TOPIC)
<< "failure to load analyzers while visiting database '" << vocbase->name() << "': " << res.errorNumber() << " " << res.errorMessage();
TRI_set_errno(res.errorNumber());
return false;
}
Analyzers analyzers;
{
ReadMutex mutex(_mutex);
SCOPED_LOCK(mutex);
analyzers = _analyzers;
}
for (auto& entry: analyzers) {
if (entry.second // have entry
&& (splitAnalyzerName(entry.first).first == vocbase->name()) // requested vocbase
&& !visitor(entry.second) // termination request
) {
return false;
}
}
return true;
}
void IResearchAnalyzerFeature::cleanupAnalyzers(irs::string_ref const& database) {
if (ADB_UNLIKELY(database.empty())) {
TRI_ASSERT(FALSE);
return;
}
for (auto itr = _analyzers.begin(), end = _analyzers.end(); itr != end;) {
auto split = splitAnalyzerName(itr->first);
if (split.first == database) {
itr = _analyzers.erase(itr);
} else {
++itr;
}
}
}
void IResearchAnalyzerFeature::invalidate(const TRI_vocbase_t& vocbase) {
WriteMutex mutex(_mutex);
SCOPED_LOCK(mutex);
auto database = irs::string_ref(vocbase.name());
auto itr = _lastLoad.find(
irs::make_hashed_ref(database, std::hash<irs::string_ref>()));
if (itr != _lastLoad.end()) {
cleanupAnalyzers(database);
_lastLoad.erase(itr);
}
}
} // namespace iresearch
} // namespace arangodb
// -----------------------------------------------------------------------------
// --SECTION-- END-OF-FILE
// -----------------------------------------------------------------------------