//////////////////////////////////////////////////////////////////////////////// /// DISCLAIMER /// /// Copyright 2018 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 //////////////////////////////////////////////////////////////////////////////// #include #include "LogicalDataSource.h" #include "Basics/StaticStrings.h" #include "Basics/VelocyPackHelper.h" #include "Basics/conversions.h" #include "Cluster/ClusterInfo.h" #include "Cluster/ServerState.h" #include "RestServer/ServerIdFeature.h" #include "VocBase/LogicalCollection.h" #include "VocBase/ticks.h" #include "velocypack/StringRef.h" #include "Logger/Logger.h" namespace { std::string ensureGuid(std::string&& guid, TRI_voc_cid_t id, TRI_voc_cid_t planId, std::string const& name, bool isSystem) { if (!guid.empty()) { return std::move(guid); } guid.reserve(64); // view GUIDs are added to the ClusterInfo. To avoid conflicts // with collection names we always put in a '/' which is an illegal // character for collection names. Stringified collection or view // id numbers can also not conflict, first character is always 'h' if (arangodb::ServerState::instance()->isCoordinator() || arangodb::ServerState::instance()->isDBServer()) { TRI_ASSERT(planId); // ensured by LogicalDataSource constructor + '_id' != 0 guid.append("c"); guid.append(std::to_string(planId)); guid.push_back('/'); if (arangodb::ServerState::instance()->isDBServer()) { // we add the shard name to the collection. If we ever // replicate shards, we can identify them cluster-wide guid.append(name); } } else if (isSystem) { guid.append(name); } else { TRI_ASSERT(id); // ensured by ensureId(...) char buf[sizeof(TRI_server_id_t) * 2 + 1]; auto len = TRI_StringUInt64HexInPlace(arangodb::ServerIdFeature::getId(), buf); guid.append("h"); guid.append(buf, len); TRI_ASSERT(guid.size() > 3); guid.push_back('/'); guid.append(std::to_string(id)); } return std::move(guid); } TRI_voc_cid_t ensureId(TRI_voc_cid_t id) { if (id) { return id; } if (!arangodb::ServerState::instance()->isCoordinator() // not coordinator && !arangodb::ServerState::instance()->isDBServer() // not db-server ) { return TRI_NewTickServer(); } auto* ci = arangodb::ClusterInfo::instance(); if (!ci) { THROW_ARANGO_EXCEPTION_MESSAGE( // exception TRI_ERROR_INTERNAL, // code "failure to find 'ClusterInfo' instance while generating LogicalDataSource ID" // message ); } id = ci->uniqid(1); if (!id) { THROW_ARANGO_EXCEPTION_MESSAGE( // exception TRI_ERROR_INTERNAL, // code "invalid zero value returned for uniqueid by 'ClusterInfo' while generating LogicalDataSource ID" // message ); } return id; } bool readIsSystem(arangodb::velocypack::Slice definition) { if (!definition.isObject()) { return false; } static const std::string empty; auto name = arangodb::basics::VelocyPackHelper::getStringValue( definition, arangodb::StaticStrings::DataSourceName, empty); if (!TRI_vocbase_t::IsSystemName(name)) { return false; } // same condition as in LogicalCollection return arangodb::basics::VelocyPackHelper::readBooleanValue( definition, arangodb::StaticStrings::DataSourceSystem, false); } ////////////////////////////////////////////////////////////////////////////// /// @brief create an arangodb::velocypack::ValuePair for a string value ////////////////////////////////////////////////////////////////////////////// arangodb::velocypack::ValuePair toValuePair(std::string const& value) { return arangodb::velocypack::ValuePair(&value[0], value.size(), arangodb::velocypack::ValueType::String); } } // namespace namespace arangodb { /*static*/ LogicalDataSource::Type const& LogicalDataSource::Type::emplace( arangodb::velocypack::StringRef const& name) { struct Less { bool operator()(arangodb::velocypack::StringRef const& lhs, arangodb::velocypack::StringRef const& rhs) const noexcept { return lhs.compare(rhs) < 0; } }; static std::mutex mutex; static std::map types; std::lock_guard lock(mutex); auto itr = types.emplace(name, Type()); if (itr.second && name.data()) { const_cast(itr.first->second._name) = name.toString(); // update '_name' const_cast(itr.first->first) = itr.first->second.name(); // point key at value stored in '_name' } return itr.first->second; } LogicalDataSource::LogicalDataSource(Category const& category, Type const& type, TRI_vocbase_t& vocbase, velocypack::Slice const& definition, uint64_t planVersion) : LogicalDataSource( category, type, vocbase, basics::VelocyPackHelper::extractIdValue(definition), basics::VelocyPackHelper::getStringValue(definition, StaticStrings::DataSourceGuid, ""), basics::VelocyPackHelper::stringUInt64(definition.get(StaticStrings::DataSourcePlanId)), basics::VelocyPackHelper::getStringValue(definition, StaticStrings::DataSourceName, ""), planVersion, readIsSystem(definition), basics::VelocyPackHelper::readBooleanValue(definition, StaticStrings::DataSourceDeleted, false)) {} LogicalDataSource::LogicalDataSource(Category const& category, Type const& type, TRI_vocbase_t& vocbase, TRI_voc_cid_t id, std::string&& guid, TRI_voc_cid_t planId, std::string&& name, uint64_t planVersion, bool system, bool deleted) : _name(std::move(name)), _category(category), _type(type), _vocbase(vocbase), _id(ensureId(id)), _planId(planId ? planId : _id), _planVersion(planVersion), _guid(ensureGuid(std::move(guid), _id, _planId, _name, system)), _deleted(deleted), _system(system) { TRI_ASSERT(_id); TRI_ASSERT(!_guid.empty()); } Result LogicalDataSource::properties(velocypack::Builder& builder, Serialization context) const { if (!builder.isOpenObject()) { return Result(TRI_ERROR_BAD_PARAMETER, "invalid builder provided for data-source definition"); } builder.add(StaticStrings::DataSourceGuid, toValuePair(guid())); // required for dump/restore builder.add(StaticStrings::DataSourceId, velocypack::Value(std::to_string(id()))); builder.add(StaticStrings::DataSourceName, toValuePair(name())); // note: includeSystem and forPersistence are not 100% synonymous, // however, for our purposes this is an okay mapping; we only set // includeSystem if we are persisting the properties if (context == Serialization::Persistence || context == Serialization::PersistenceWithInProgress) { builder.add(StaticStrings::DataSourceDeleted, velocypack::Value(deleted())); builder.add(StaticStrings::DataSourceSystem, velocypack::Value(system())); // FIXME not sure if the following is relevant // Cluster Specific builder.add(StaticStrings::DataSourcePlanId, velocypack::Value(std::to_string(planId()))); } return appendVelocyPack(builder, context); } } // namespace arangodb // ----------------------------------------------------------------------------- // --SECTION-- END-OF-FILE // -----------------------------------------------------------------------------