diff --git a/Builds/CMake/RippledCore.cmake b/Builds/CMake/RippledCore.cmake index e8fc5327d78..3f8874a24a3 100644 --- a/Builds/CMake/RippledCore.cmake +++ b/Builds/CMake/RippledCore.cmake @@ -404,13 +404,18 @@ target_sources (rippled PRIVATE src/ripple/app/paths/impl/DirectStep.cpp src/ripple/app/paths/impl/PaySteps.cpp src/ripple/app/paths/impl/XRPEndpointStep.cpp - src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.cpp - src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.cpp - src/ripple/app/rdb/impl/RelationalDBInterface.cpp - src/ripple/app/rdb/impl/RelationalDBInterface_global.cpp - src/ripple/app/rdb/impl/RelationalDBInterface_nodes.cpp - src/ripple/app/rdb/impl/RelationalDBInterface_postgres.cpp - src/ripple/app/rdb/impl/RelationalDBInterface_shards.cpp + src/ripple/app/rdb/backend/detail/impl/Node.cpp + src/ripple/app/rdb/backend/detail/impl/Shard.cpp + src/ripple/app/rdb/backend/impl/PostgresDatabase.cpp + src/ripple/app/rdb/backend/impl/SQLiteDatabase.cpp + src/ripple/app/rdb/impl/Download.cpp + src/ripple/app/rdb/impl/PeerFinder.cpp + src/ripple/app/rdb/impl/RelationalDatabase.cpp + src/ripple/app/rdb/impl/ShardArchive.cpp + src/ripple/app/rdb/impl/State.cpp + src/ripple/app/rdb/impl/UnitaryShard.cpp + src/ripple/app/rdb/impl/Vacuum.cpp + src/ripple/app/rdb/impl/Wallet.cpp src/ripple/app/tx/impl/ApplyContext.cpp src/ripple/app/tx/impl/BookTip.cpp src/ripple/app/tx/impl/CancelCheck.cpp diff --git a/Builds/levelization/results/loops.txt b/Builds/levelization/results/loops.txt index 7d72154410b..6635302d2d3 100644 --- a/Builds/levelization/results/loops.txt +++ b/Builds/levelization/results/loops.txt @@ -8,13 +8,13 @@ Loop: ripple.app ripple.net ripple.app > ripple.net Loop: ripple.app ripple.nodestore - ripple.nodestore ~= ripple.app + ripple.app > ripple.nodestore Loop: ripple.app ripple.overlay ripple.overlay ~= ripple.app Loop: ripple.app ripple.peerfinder - ripple.peerfinder ~= ripple.app + ripple.app > ripple.peerfinder Loop: ripple.app ripple.rpc ripple.rpc > ripple.app diff --git a/src/ripple/app/ledger/Ledger.cpp b/src/ripple/app/ledger/Ledger.cpp index 0757bb4f473..8816e0b3eed 100644 --- a/src/ripple/app/ledger/Ledger.cpp +++ b/src/ripple/app/ledger/Ledger.cpp @@ -29,8 +29,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include @@ -927,9 +927,11 @@ saveValidatedLedger( return true; } - auto res = dynamic_cast( - &app.getRelationalDBInterface()) - ->saveValidatedLedger(ledger, current); + auto const res = dynamic_cast(&app.getRelationalDatabase()) + ->saveValidatedLedger(ledger, current); + + if (!res) + Throw("Failed to get relational database"); // Clients can now trust the database for // information about this ledger sequence. @@ -1051,7 +1053,7 @@ std::tuple, std::uint32_t, uint256> getLatestLedger(Application& app) { const std::optional info = - app.getRelationalDBInterface().getNewestLedgerInfo(); + app.getRelationalDatabase().getNewestLedgerInfo(); if (!info) return {std::shared_ptr(), {}, {}}; return {loadLedgerHelper(*info, app, true), info->seq, info->hash}; @@ -1061,7 +1063,7 @@ std::shared_ptr loadByIndex(std::uint32_t ledgerIndex, Application& app, bool acquire) { if (std::optional info = - app.getRelationalDBInterface().getLedgerInfoByIndex(ledgerIndex)) + app.getRelationalDatabase().getLedgerInfoByIndex(ledgerIndex)) { std::shared_ptr ledger = loadLedgerHelper(*info, app, acquire); finishLoadByIndexOrHash(ledger, app.config(), app.journal("Ledger")); @@ -1074,7 +1076,7 @@ std::shared_ptr loadByHash(uint256 const& ledgerHash, Application& app, bool acquire) { if (std::optional info = - app.getRelationalDBInterface().getLedgerInfoByHash(ledgerHash)) + app.getRelationalDatabase().getLedgerInfoByHash(ledgerHash)) { std::shared_ptr ledger = loadLedgerHelper(*info, app, acquire); finishLoadByIndexOrHash(ledger, app.config(), app.journal("Ledger")); @@ -1163,9 +1165,12 @@ flatFetchTransactions(ReadView const& ledger, Application& app) return {}; } - auto nodestoreHashes = dynamic_cast( - &app.getRelationalDBInterface()) - ->getTxHashes(ledger.info().seq); + auto const db = + dynamic_cast(&app.getRelationalDatabase()); + if (!db) + Throw("Failed to get relational database"); + + auto nodestoreHashes = db->getTxHashes(ledger.info().seq); return flatFetchTransactions(app, nodestoreHashes); } diff --git a/src/ripple/app/ledger/impl/LedgerMaster.cpp b/src/ripple/app/ledger/impl/LedgerMaster.cpp index 4cc19581543..ce373e25765 100644 --- a/src/ripple/app/ledger/impl/LedgerMaster.cpp +++ b/src/ripple/app/ledger/impl/LedgerMaster.cpp @@ -34,8 +34,7 @@ #include #include #include -#include -#include +#include #include #include #include @@ -273,10 +272,10 @@ LedgerMaster::getValidatedLedgerAge() #ifdef RIPPLED_REPORTING if (app_.config().reporting()) - return static_cast( - &app_.getRelationalDBInterface()) + return static_cast(&app_.getRelationalDatabase()) ->getValidatedLedgerAge(); #endif + std::chrono::seconds valClose{mValidLedgerSign.load()}; if (valClose == 0s) { @@ -299,8 +298,7 @@ LedgerMaster::isCaughtUp(std::string& reason) #ifdef RIPPLED_REPORTING if (app_.config().reporting()) - return static_cast( - &app_.getRelationalDBInterface()) + return static_cast(&app_.getRelationalDatabase()) ->isCaughtUp(reason); #endif @@ -733,7 +731,7 @@ LedgerMaster::tryFill(Job& job, std::shared_ptr ledger) mCompleteLedgers.insert(range(minHas, maxHas)); } maxHas = minHas; - ledgerHashes = app_.getRelationalDBInterface().getHashesByIndex( + ledgerHashes = app_.getRelationalDatabase().getHashesByIndex( (seq < 500) ? 0 : (seq - 499), seq); it = ledgerHashes.find(seq); @@ -917,8 +915,8 @@ LedgerMaster::setFullLedger( { // Check the SQL database's entry for the sequence before this // ledger, if it's not this ledger's parent, invalidate it - uint256 prevHash = app_.getRelationalDBInterface().getHashByIndex( - ledger->info().seq - 1); + uint256 prevHash = + app_.getRelationalDatabase().getHashByIndex(ledger->info().seq - 1); if (prevHash.isNonZero() && prevHash != ledger->info().parentHash) clearLedger(ledger->info().seq - 1); } @@ -1624,7 +1622,7 @@ LedgerMaster::getValidatedLedger() #ifdef RIPPLED_REPORTING if (app_.config().reporting()) { - auto seq = app_.getRelationalDBInterface().getMaxLedgerSeq(); + auto seq = app_.getRelationalDatabase().getMaxLedgerSeq(); if (!seq) return {}; return getLedgerBySeq(*seq); @@ -1660,8 +1658,7 @@ LedgerMaster::getCompleteLedgers() { #ifdef RIPPLED_REPORTING if (app_.config().reporting()) - return static_cast( - &app_.getRelationalDBInterface()) + return static_cast(&app_.getRelationalDatabase()) ->getCompleteLedgers(); #endif std::lock_guard sl(mCompleteLock); @@ -1706,7 +1703,7 @@ LedgerMaster::getHashBySeq(std::uint32_t index) if (hash.isNonZero()) return hash; - return app_.getRelationalDBInterface().getHashByIndex(index); + return app_.getRelationalDatabase().getHashByIndex(index); } std::optional @@ -1933,7 +1930,7 @@ LedgerMaster::fetchForHistory( fillInProgress = mFillInProgress; } if (fillInProgress == 0 && - app_.getRelationalDBInterface().getHashByIndex(seq - 1) == + app_.getRelationalDatabase().getHashByIndex(seq - 1) == ledger->info().parentHash) { { @@ -2329,7 +2326,7 @@ LedgerMaster::getFetchPackCacheSize() const std::optional LedgerMaster::minSqlSeq() { - return app_.getRelationalDBInterface().getMinLedgerSeq(); + return app_.getRelationalDatabase().getMinLedgerSeq(); } } // namespace ripple diff --git a/src/ripple/app/main/Application.cpp b/src/ripple/app/main/Application.cpp index 60381b15863..115f4fd0339 100644 --- a/src/ripple/app/main/Application.cpp +++ b/src/ripple/app/main/Application.cpp @@ -45,8 +45,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include @@ -219,7 +219,7 @@ class ApplicationImp : public Application, public BasicApp boost::asio::steady_timer sweepTimer_; boost::asio::steady_timer entropyTimer_; - std::unique_ptr mRelationalDBInterface; + std::unique_ptr mRelationalDatabase; std::unique_ptr mWalletDB; std::unique_ptr overlay_; @@ -874,11 +874,11 @@ class ApplicationImp : public Application, public BasicApp return *txQ_; } - RelationalDBInterface& - getRelationalDBInterface() override + RelationalDatabase& + getRelationalDatabase() override { - assert(mRelationalDBInterface.get() != nullptr); - return *mRelationalDBInterface; + assert(mRelationalDatabase.get() != nullptr); + return *mRelationalDatabase; } DatabaseCon& @@ -904,14 +904,14 @@ class ApplicationImp : public Application, public BasicApp //-------------------------------------------------------------------------- bool - initRDBMS() + initRelationalDatabase() { assert(mWalletDB.get() == nullptr); try { - mRelationalDBInterface = - RelationalDBInterface::init(*this, *config_, *m_jobQueue); + mRelationalDatabase = + RelationalDatabase::init(*this, *config_, *m_jobQueue); // wallet database auto setup = setup_DatabaseCon(*config_, m_journal); @@ -1056,8 +1056,7 @@ class ApplicationImp : public Application, public BasicApp ledgerCleaner_->stop(); if (reportingETL_) reportingETL_->stop(); - if (auto pg = dynamic_cast( - &*mRelationalDBInterface)) + if (auto pg = dynamic_cast(&*mRelationalDatabase)) pg->stop(); m_nodeStore->stop(); perfLog_->stop(); @@ -1139,7 +1138,7 @@ class ApplicationImp : public Application, public BasicApp doSweep() { if (!config_->standalone() && - !getRelationalDBInterface().transactionDbHasSpace(*config_)) + !getRelationalDatabase().transactionDbHasSpace(*config_)) { signalStop(); } @@ -1164,8 +1163,7 @@ class ApplicationImp : public Application, public BasicApp cachedSLEs_.sweep(); #ifdef RIPPLED_REPORTING - if (auto pg = dynamic_cast( - &*mRelationalDBInterface)) + if (auto pg = dynamic_cast(&*mRelationalDatabase)) pg->sweep(); #endif @@ -1260,7 +1258,7 @@ ApplicationImp::setup() if (!config_->standalone()) timeKeeper_->run(config_->SNTP_SERVERS); - if (!initRDBMS() || !initNodeStore()) + if (!initRelationalDatabase() || !initNodeStore()) return false; if (shardStore_) @@ -2151,7 +2149,7 @@ ApplicationImp::nodeToShards() void ApplicationImp::setMaxDisallowedLedger() { - auto seq = getRelationalDBInterface().getMaxLedgerSeq(); + auto seq = getRelationalDatabase().getMaxLedgerSeq(); if (seq) maxDisallowedLedger_ = *seq; diff --git a/src/ripple/app/main/Application.h b/src/ripple/app/main/Application.h index 0fc927ff65a..53155ca4f8d 100644 --- a/src/ripple/app/main/Application.h +++ b/src/ripple/app/main/Application.h @@ -99,7 +99,7 @@ class ValidatorList; class ValidatorSite; class Cluster; -class RelationalDBInterface; +class RelationalDatabase; class DatabaseCon; class SHAMapStore; @@ -251,8 +251,8 @@ class Application : public beast::PropertyStream::Source openLedger() = 0; virtual OpenLedger const& openLedger() const = 0; - virtual RelationalDBInterface& - getRelationalDBInterface() = 0; + virtual RelationalDatabase& + getRelationalDatabase() = 0; virtual std::chrono::milliseconds getIOLatency() = 0; diff --git a/src/ripple/app/main/DBInit.h b/src/ripple/app/main/DBInit.h index 00cfc104df0..3d2f42717b2 100644 --- a/src/ripple/app/main/DBInit.h +++ b/src/ripple/app/main/DBInit.h @@ -72,12 +72,22 @@ inline constexpr std::array LgrDBInit{ // Transaction database holds transactions and public keys inline constexpr auto TxDBName{"transaction.db"}; -inline constexpr std::array TxDBPragma +// In C++17 omitting the explicit template parameters caused +// a crash +inline constexpr std::array TxDBPragma { "PRAGMA page_size=4096;", "PRAGMA journal_size_limit=1582080;", "PRAGMA max_page_count=2147483646;", + #if (ULONG_MAX > UINT_MAX) && !defined(NO_SQLITE_MMAP) "PRAGMA mmap_size=17179869184;" +#else + + // Provide an explicit `no-op` SQL statement + // in order to keep the size of the array + // constant regardless of the preprocessor + // condition evaluation + "PRAGMA sqlite_noop_statement;" #endif }; @@ -117,12 +127,22 @@ inline constexpr std::array TxDBInit{ // The Ledger Meta database maps ledger hashes to shard indexes inline constexpr auto LgrMetaDBName{"ledger_meta.db"}; -inline constexpr std::array LgrMetaDBPragma +// In C++17 omitting the explicit template parameters caused +// a crash +inline constexpr std::array LgrMetaDBPragma { "PRAGMA page_size=4096;", "PRAGMA journal_size_limit=1582080;", "PRAGMA max_page_count=2147483646;", + #if (ULONG_MAX > UINT_MAX) && !defined(NO_SQLITE_MMAP) "PRAGMA mmap_size=17179869184;" +#else + + // Provide an explicit `no-op` SQL statement + // in order to keep the size of the array + // constant regardless of the preprocessor + // condition evaluation + "PRAGMA sqlite_noop_statement;" #endif }; @@ -141,12 +161,22 @@ inline constexpr std::array LgrMetaDBInit{ // Transaction Meta database maps transaction IDs to shard indexes inline constexpr auto TxMetaDBName{"transaction_meta.db"}; -inline constexpr std::array TxMetaDBPragma +// In C++17 omitting the explicit template parameters caused +// a crash +inline constexpr std::array TxMetaDBPragma { "PRAGMA page_size=4096;", "PRAGMA journal_size_limit=1582080;", "PRAGMA max_page_count=2147483646;", + #if (ULONG_MAX > UINT_MAX) && !defined(NO_SQLITE_MMAP) "PRAGMA mmap_size=17179869184;" +#else + + // Provide an explicit `no-op` SQL statement + // in order to keep the size of the array + // constant regardless of the preprocessor + // condition evaluation + "PRAGMA sqlite_noop_statement;" #endif }; diff --git a/src/ripple/app/main/Main.cpp b/src/ripple/app/main/Main.cpp index 21423395382..0e0a15e7e0a 100644 --- a/src/ripple/app/main/Main.cpp +++ b/src/ripple/app/main/Main.cpp @@ -19,7 +19,7 @@ #include #include -#include +#include #include #include #include diff --git a/src/ripple/app/main/NodeIdentity.cpp b/src/ripple/app/main/NodeIdentity.cpp index 5f7cca7a594..a2051bbb674 100644 --- a/src/ripple/app/main/NodeIdentity.cpp +++ b/src/ripple/app/main/NodeIdentity.cpp @@ -19,7 +19,7 @@ #include #include -#include +#include #include #include #include diff --git a/src/ripple/app/misc/NetworkOPs.cpp b/src/ripple/app/misc/NetworkOPs.cpp index ed93caa0f43..87bf0ad5591 100644 --- a/src/ripple/app/misc/NetworkOPs.cpp +++ b/src/ripple/app/misc/NetworkOPs.cpp @@ -37,9 +37,8 @@ #include #include #include -#include -#include -#include +#include +#include #include #include #include @@ -3306,8 +3305,9 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) #ifdef RIPPLED_REPORTING if (app_.config().reporting()) { - if (dynamic_cast( - &app_.getRelationalDBInterface())) + // Use a dynamic_cast to return DatabaseType::None + // on failure. + if (dynamic_cast(&app_.getRelationalDatabase())) { return DatabaseType::Postgres; } @@ -3315,16 +3315,18 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) } else { - if (dynamic_cast( - &app_.getRelationalDBInterface())) + // Use a dynamic_cast to return DatabaseType::None + // on failure. + if (dynamic_cast(&app_.getRelationalDatabase())) { return DatabaseType::Sqlite; } return DatabaseType::None; } #else - if (dynamic_cast( - &app_.getRelationalDBInterface())) + // Use a dynamic_cast to return DatabaseType::None + // on failure. + if (dynamic_cast(&app_.getRelationalDatabase())) { return DatabaseType::Sqlite; } @@ -3410,17 +3412,16 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) auto getMoreTxns = [&](std::uint32_t minLedger, std::uint32_t maxLedger, - std::optional - marker) + std::optional marker) -> std::optional>> { + RelationalDatabase::AccountTxs, + std::optional>> { switch (dbType) { case Postgres: { - auto db = static_cast( - &app_.getRelationalDBInterface()); - RelationalDBInterface::AccountTxArgs args; + auto db = static_cast( + &app_.getRelationalDatabase()); + RelationalDatabase::AccountTxArgs args; args.account = accountId; LedgerRange range{minLedger, maxLedger}; args.ledger = range; @@ -3436,7 +3437,7 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) } if (auto txns = - std::get_if( + std::get_if( &txResult.transactions); txns) { @@ -3452,9 +3453,9 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) } } case Sqlite: { - auto db = static_cast( - &app_.getRelationalDBInterface()); - RelationalDBInterface::AccountTxPageOptions options{ + auto db = static_cast( + &app_.getRelationalDatabase()); + RelationalDatabase::AccountTxPageOptions options{ accountId, minLedger, maxLedger, marker, 0, true}; return db->newestAccountTxPage(options); } @@ -3515,7 +3516,7 @@ NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo) return; } - std::optional marker{}; + std::optional marker{}; while (!subInfo.index_->stopHistorical_) { auto dbResult = diff --git a/src/ripple/app/misc/SHAMapStoreImp.cpp b/src/ripple/app/misc/SHAMapStoreImp.cpp index 5fce4cd72e9..cece8539e01 100644 --- a/src/ripple/app/misc/SHAMapStoreImp.cpp +++ b/src/ripple/app/misc/SHAMapStoreImp.cpp @@ -20,8 +20,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include @@ -620,19 +620,17 @@ SHAMapStoreImp::clearPrior(LedgerIndex lastRotated) if (health()) return; - RelationalDBInterfaceSqlite* iface = - dynamic_cast( - &app_.getRelationalDBInterface()); + SQLiteDatabase* const db = + dynamic_cast(&app_.getRelationalDatabase()); + + if (!db) + Throw("Failed to get relational database"); clearSql( lastRotated, "Ledgers", - [&iface]() -> std::optional { - return iface->getMinLedgerSeq(); - }, - [&iface](LedgerIndex min) -> void { - iface->deleteBeforeLedgerSeq(min); - }); + [db]() -> std::optional { return db->getMinLedgerSeq(); }, + [db](LedgerIndex min) -> void { db->deleteBeforeLedgerSeq(min); }); if (health()) return; @@ -642,11 +640,11 @@ SHAMapStoreImp::clearPrior(LedgerIndex lastRotated) clearSql( lastRotated, "Transactions", - [&iface]() -> std::optional { - return iface->getTransactionsMinLedgerSeq(); + [&db]() -> std::optional { + return db->getTransactionsMinLedgerSeq(); }, - [&iface](LedgerIndex min) -> void { - iface->deleteTransactionsBeforeLedgerSeq(min); + [&db](LedgerIndex min) -> void { + db->deleteTransactionsBeforeLedgerSeq(min); }); if (health()) return; @@ -654,11 +652,11 @@ SHAMapStoreImp::clearPrior(LedgerIndex lastRotated) clearSql( lastRotated, "AccountTransactions", - [&iface]() -> std::optional { - return iface->getAccountTransactionsMinLedgerSeq(); + [&db]() -> std::optional { + return db->getAccountTransactionsMinLedgerSeq(); }, - [&iface](LedgerIndex min) -> void { - iface->deleteAccountTransactionsBeforeLedgerSeq(min); + [&db](LedgerIndex min) -> void { + db->deleteAccountTransactionsBeforeLedgerSeq(min); }); if (health()) return; diff --git a/src/ripple/app/misc/SHAMapStoreImp.h b/src/ripple/app/misc/SHAMapStoreImp.h index 7119bd3af38..c62cbbd8451 100644 --- a/src/ripple/app/misc/SHAMapStoreImp.h +++ b/src/ripple/app/misc/SHAMapStoreImp.h @@ -22,8 +22,8 @@ #include #include -#include -#include +#include +#include #include #include #include diff --git a/src/ripple/app/misc/impl/AccountTxPaging.cpp b/src/ripple/app/misc/impl/AccountTxPaging.cpp index 5c1e8017018..433463e2826 100644 --- a/src/ripple/app/misc/impl/AccountTxPaging.cpp +++ b/src/ripple/app/misc/impl/AccountTxPaging.cpp @@ -31,7 +31,7 @@ namespace ripple { void convertBlobsToTxResult( - RelationalDBInterface::AccountTxs& to, + RelationalDatabase::AccountTxs& to, std::uint32_t ledger_index, std::string const& status, Blob const& rawTxn, diff --git a/src/ripple/app/misc/impl/AccountTxPaging.h b/src/ripple/app/misc/impl/AccountTxPaging.h index ad3c40e56f7..6b8f235b5a8 100644 --- a/src/ripple/app/misc/impl/AccountTxPaging.h +++ b/src/ripple/app/misc/impl/AccountTxPaging.h @@ -20,7 +20,7 @@ #ifndef RIPPLE_APP_MISC_IMPL_ACCOUNTTXPAGING_H_INCLUDED #define RIPPLE_APP_MISC_IMPL_ACCOUNTTXPAGING_H_INCLUDED -#include +#include #include #include #include @@ -31,7 +31,7 @@ namespace ripple { void convertBlobsToTxResult( - RelationalDBInterface::AccountTxs& to, + RelationalDatabase::AccountTxs& to, std::uint32_t ledger_index, std::string const& status, Blob const& rawTxn, diff --git a/src/ripple/app/misc/impl/AmendmentTable.cpp b/src/ripple/app/misc/impl/AmendmentTable.cpp index be59320be4b..5f75d29540a 100644 --- a/src/ripple/app/misc/impl/AmendmentTable.cpp +++ b/src/ripple/app/misc/impl/AmendmentTable.cpp @@ -19,7 +19,7 @@ #include #include -#include +#include #include #include #include diff --git a/src/ripple/app/misc/impl/Manifest.cpp b/src/ripple/app/misc/impl/Manifest.cpp index 6df5dd6b53d..3992ed564fb 100644 --- a/src/ripple/app/misc/impl/Manifest.cpp +++ b/src/ripple/app/misc/impl/Manifest.cpp @@ -18,7 +18,7 @@ //============================================================================== #include -#include +#include #include #include #include diff --git a/src/ripple/app/misc/impl/Transaction.cpp b/src/ripple/app/misc/impl/Transaction.cpp index ee391c7a9ec..9adef982d01 100644 --- a/src/ripple/app/misc/impl/Transaction.cpp +++ b/src/ripple/app/misc/impl/Transaction.cpp @@ -21,9 +21,8 @@ #include #include #include -#include -#include -#include +#include +#include #include #include #include @@ -134,9 +133,15 @@ Transaction::load( Transaction::Locator Transaction::locate(uint256 const& id, Application& app) { - return dynamic_cast( - &app.getRelationalDBInterface()) - ->locateTransaction(id); + auto const db = + dynamic_cast(&app.getRelationalDatabase()); + + if (!db) + { + Throw("Failed to get relational database"); + } + + return db->locateTransaction(id); } std::variant< @@ -148,9 +153,14 @@ Transaction::load( std::optional> const& range, error_code_i& ec) { - return dynamic_cast( - &app.getRelationalDBInterface()) - ->getTransaction(id, range, ec); + auto const db = dynamic_cast(&app.getRelationalDatabase()); + + if (!db) + { + Throw("Failed to get relational database"); + } + + return db->getTransaction(id, range, ec); } // options 1 to include the date of the transaction diff --git a/src/ripple/app/rdb/Download.h b/src/ripple/app/rdb/Download.h new file mode 100644 index 00000000000..b72b5ec57e7 --- /dev/null +++ b/src/ripple/app/rdb/Download.h @@ -0,0 +1,79 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_DOWNLOAD_H_INCLUDED +#define RIPPLE_APP_RDB_DOWNLOAD_H_INCLUDED + +#include +#include +#include +#include +#include +#include +#include + +namespace ripple { + +/** + * @brief openDatabaseBodyDb Opens a database that will store the contents of a + * file being downloaded, returns its descriptor, and starts a new + * download process or continues an existing one. + * @param setup Path to the database and other opening parameters. + * @param path Path of the new file to download. + * @return Pair containing a unique pointer to the database and the amount of + * bytes already downloaded if a download is being continued. + */ +std::pair, std::optional> +openDatabaseBodyDb( + DatabaseCon::Setup const& setup, + boost::filesystem::path const& path); + +/** + * @brief databaseBodyDoPut Saves a new fragment of a downloaded file. + * @param session Session with the database. + * @param data Downloaded fragment of file data to save. + * @param path Path to the file currently being downloaded. + * @param fileSize Size of the portion of the file already downloaded. + * @param part The index of the most recently updated database row. + * @param maxRowSizePad A constant padding value that accounts for other data + * stored in each row of the database. + * @return Index of the most recently updated database row. + */ +std::uint64_t +databaseBodyDoPut( + soci::session& session, + std::string const& data, + std::string const& path, + std::uint64_t fileSize, + std::uint64_t part, + std::uint16_t maxRowSizePad); + +/** + * @brief databaseBodyFinish Finishes the download process and writes the file + * to disk. + * @param session Session with the database. + * @param fout Opened file into which the downloaded data from the database will + * be written. + */ +void +databaseBodyFinish(soci::session& session, std::ofstream& fout); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/PeerFinder.h b/src/ripple/app/rdb/PeerFinder.h new file mode 100644 index 00000000000..06cd80f670b --- /dev/null +++ b/src/ripple/app/rdb/PeerFinder.h @@ -0,0 +1,76 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_PEERFINDER_H_INCLUDED +#define RIPPLE_APP_RDB_PEERFINDER_H_INCLUDED + +#include +#include +#include + +namespace ripple { + +/** + * @brief initPeerFinderDB Opens a session with the peer finder database. + * @param session Session with the peer finder database. + * @param config Path to the database and other opening parameters. + * @param j Journal. + */ +void +initPeerFinderDB( + soci::session& session, + BasicConfig const& config, + beast::Journal j); + +/** + * @brief updatePeerFinderDB Updates the peer finder database to a new version. + * @param session Session with the database. + * @param currentSchemaVersion New version of the database. + * @param j Journal. + */ +void +updatePeerFinderDB( + soci::session& session, + int currentSchemaVersion, + beast::Journal j); + +/** + * @brief readPeerFinderDB Reads all entries from the peer finder database and + * invokes the given callback for each entry. + * @param session Session with the database. + * @param func Callback to invoke for each entry. + */ +void +readPeerFinderDB( + soci::session& session, + std::function const& func); + +/** + * @brief savePeerFinderDB Saves a new entry to the peer finder database. + * @param session Session with the database. + * @param v Entry to save which contains information about a new peer. + */ +void +savePeerFinderDB( + soci::session& session, + std::vector const& v); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/README.md b/src/ripple/app/rdb/README.md new file mode 100644 index 00000000000..1a68a1ae5e3 --- /dev/null +++ b/src/ripple/app/rdb/README.md @@ -0,0 +1,102 @@ +# Relational Database Interface + +The guiding principles of the Relational Database Interface are summarized below: + +* All hard-coded SQL statements should be stored in the [files](#source-files) under the `ripple/app/rdb` directory. With the exception of test modules, no hard-coded SQL should be added to any other file in rippled. +* The base class `RelationalDatabase` is inherited by derived classes that each provide an interface for operating on distinct relational database systems. +* For future use, the shard store will be used if the node store is absent. + +## Overview + +Firstly, the interface `RelationalDatabase` is inherited by the classes `SQLiteDatabase` and `PostgresDatabase` which are used to operate the software's main data store (for storing transactions, accounts, ledgers, etc.). Secondly, the files under the `detail` directory provide supplementary functions that are used by these derived classes to access the underlying databases. Lastly, the remaining files in the interface (located at the top level of the module) are used by varied parts of the software to access any secondary relational databases. + +## Configuration + +The config section `[relational_db]` has a property named `backend` whose value designates which database implementation will be used for node or shard databases. Presently the only valid value for this property is `sqlite`: + +``` +[relational_db] +backend=sqlite +``` + +## Source Files + +The Relational Database Interface consists of the following directory structure (as of November 2021): + +``` +src/ripple/app/rdb/ +├── backend +│   ├── detail +│   │   ├── impl +│   │   │   ├── Node.cpp +│   │   │   └── Shard.cpp +│   │   ├── Node.h +│   │   └── Shard.h +│   ├── impl +│   │   ├── PostgresDatabase.cpp +│   │   └── SQLiteDatabase.cpp +│   ├── PostgresDatabase.h +│   └── SQLiteDatabase.h +├── impl +│   ├── Download.cpp +│   ├── PeerFinder.cpp +│   ├── RelationalDatabase.cpp +│   ├── ShardArchive.cpp +│   ├── State.cpp +│   ├── UnitaryShard.cpp +│   ├── Vacuum.cpp +│   └── Wallet.cpp +├── Download.h +├── PeerFinder.h +├── RelationalDatabase.h +├── README.md +├── ShardArchive.h +├── State.h +├── UnitaryShard.h +├── Vacuum.h +└── Wallet.h +``` + +### File Contents +| File | Contents | +| ----------- | ----------- | +| `Node.[h\|cpp]` | Defines/Implements methods used by `SQLiteDatabase` for interacting with SQLite node databases| +| `Shard.[h\|cpp]` | Defines/Implements methods used by `SQLiteDatabase` for interacting with SQLite shard databases | +| `PostgresDatabase.[h\|cpp]` | Defines/Implements the class `PostgresDatabase`/`PostgresDatabaseImp` which inherits from `RelationalDatabase` and is used to operate on the main stores | +|`SQLiteDatabase.[h\|cpp]`| Defines/Implements the class `SQLiteDatabase`/`SQLiteDatabaseImp` which inherits from `RelationalDatabase` and is used to operate on the main stores | +| `Download.[h\|cpp]` | Defines/Implements methods for persisting file downloads to a SQLite database | +| `PeerFinder.[h\|cpp]` | Defines/Implements methods for interacting with the PeerFinder SQLite database | +|`RelationalDatabase.cpp`| Implements the static method `RelationalDatabase::init` which is used to initialize an instance of `RelationalDatabase` | +| `RelationalDatabase.h` | Defines the abstract class `RelationalDatabase`, the primary class of the Relational Database Interface | +| `ShardArchive.[h\|cpp]` | Defines/Implements methods used by `ShardArchiveHandler` for interacting with SQLite databases containing metadata regarding shard downloads | +| `State.[h\|cpp]` | Defines/Implements methods for interacting with the State SQLite database which concerns ledger deletion and database rotation | +| `UnitaryShard.[h\|cpp]` | Defines/Implements methods used by a unitary instance of `Shard` for interacting with the various SQLite databases thereof. These files are distinct from `Shard.[h\|cpp]` which contain methods used by `SQLiteDatabaseImp` | +| `Vacuum.[h\|cpp]` | Defines/Implements a method for performing the `VACUUM` operation on SQLite databases | +| `Wallet.[h\|cpp]` | Defines/Implements methods for interacting with Wallet SQLite databases | + +## Classes + +The abstract class `RelationalDatabase` is the primary class of the Relational Database Interface and is defined in the eponymous header file. This class provides a static method `init()` which, when invoked, creates a concrete instance of a derived class whose type is specified by the system configuration. All other methods in the class are virtual. Presently there exist two classes that derive from `RelationalDatabase`, namely `SQLiteDatabase` and `PostgresDatabase`. + +## Database Methods + +The Relational Database Interface provides three categories of methods for interacting with databases: + +* Free functions for interacting with SQLite databases used by various components of the software. These methods feature a `soci::session` parameter which facilitates connecting to SQLite databases, and are defined and implemented in the following files: + + * `Download.[h\|cpp]` + * `PeerFinder.[h\|cpp]` + * `ShardArchive.[h\|cpp]` + * `State.[h\|cpp]` + * `UnitaryShard.[h\|cpp]` + * `Vacuum.[h\|cpp]` + * `Wallet.[h\|cpp]` + + +* Free functions used exclusively by `SQLiteDatabaseImp` for interacting with SQLite databases owned by the node store or shard store. Unlike the free functions in the files listed above, these are not intended to be invoked directly by clients. Rather, these methods are invoked by derived instances of `RelationalDatabase`. These methods are defined in the following files: + + * `Node.[h|cpp]` + * `Shard.[h|cpp]` + + +* Member functions of `RelationalDatabase`, `SQLiteDatabase`, and `PostgresDatabase` which are used to access the main stores (node store, shard store). The `SQLiteDatabase` class will access the node store by default, but will use shard databases if the node store is not present and the shard store is available. The class `PostgresDatabase` uses only the node store. diff --git a/src/ripple/app/rdb/RelationalDBInterface.md b/src/ripple/app/rdb/RelationalDBInterface.md deleted file mode 100644 index 302c9befeba..00000000000 --- a/src/ripple/app/rdb/RelationalDBInterface.md +++ /dev/null @@ -1,288 +0,0 @@ -# Relational Database Interface - -Here are main principles of Relational DB interface: - -1) All SQL hard code is in the files described below in Files section. -No hard-coded SQL should be added to any other file in rippled, except related -to tests for specific SQL implementations. -2) Pure interface class `RelationalDBInterface` can have several -implementations for different relational database types. -3) For future use, if the node database is absent, then shard databases will -be used. - -## Configuration - -Section `[relational_db]` of the configuration file contains parameter -`backend`. The value of this parameter is the name of relational database -implementation used for node or shard databases. At the present, the only valid -value of this parameter is `sqlite`. - -## Files - -The following source files are related to Relational DB interface: - -- `ripple/app/rdb/RelationalDBInterface.h` - definition of main pure class of -the interface, `RelationalDBInterface`; -- `ripple/app/rdb/impl/RelationalDBInterface.cpp` - implementation of static -method `init()` of the class `RelationalDBInterface`; -- `ripple/app/rdb/backend/RelationalDBInterfaceSqlite.h` - definition of pure -class `RelationalDBInterfaceSqlite` derived from `RelationalDBInterface`; -this is base class for sqlite implementation of the interface; -- `ripple/app/rdb/backend/RelationalDBInterfaceSqlite.cpp` - implementation of -`RelationalDBInterfaceSqlite`-derived class for the case of sqlite databases; -- `ripple/app/rdb/backend/RelationalDBInterfacePostgres.h` - definition of pure -class `RelationalDBInterfacePostgres` derived from `RelationalDBInterface`; -this is base class for postgres implementation of the interface; -- `ripple/app/rdb/backend/RelationalDBInterfacePostgres.cpp` - implementation -of `RelationalDBInterfacePostgres`-derived class for the case of postgres -databases; -- `ripple/app/rdb/RelationalDBInterface_global.h` - definitions of global -methods for all sqlite databases except of node and shard; -- `ripple/app/rdb/impl/RelationalDBInterface_global.cpp` - implementations of -global methods for all sqlite databases except of node and shard; -- `ripple/app/rdb/RelationalDBInterface_nodes.h` - definitions of global -methods for sqlite node databases; -- `ripple/app/rdb/impl/RelationalDBInterface_nodes.cpp` - implementations of -global methods for sqlite node databases; -- `ripple/app/rdb/RelationalDBInterface_shards.h` - definitions of global -methods for sqlite shard databases; -- `ripple/app/rdb/impl/RelationalDBInterface_shards.cpp` - implementations of -global methods for sqlite shard databases; -- `ripple/app/rdb/RelationalDBInterface_postgres.h` - definitions of internal -methods for postgres databases; -- `ripple/app/rdb/impl/RelationalDBInterface_postgres.cpp` - implementations of -internal methods for postgres databases; - -## Classes - -The main class of the interface is `class RelationalDBInterface`. It is defined -in the file `RelationalDBInterface.h`. This class has static method `init()` -which allow to create proper `RelationalDBInterface`-derived class specified -in the config. All other methods are pure virtual. These methods do not use -database as a parameter. It assumed that implementation of class derived from -`RelationalDBInterface` holds all database pointers inside and uses appropriate -databases (nodes or shards) to get return values required by each method. - -At the present, there are two implementations of the derived classes - -`class RelationalDBInterfaceSqlite` for sqlite database (it is located in the -file `RelationalDBInterfaceSqlite.cpp`) and -`class RelationalDBInterfacePostgres` for postgres database (it is located in -the file `RelationalDBInterfacePostgres.cpp`) - -## Methods - -There are 3 types of methods for SQL interface: - -1) Global methods for work with all databases except of node. In particular, -methods related to shards datavases only. These methods are sqlite-specific. -They use `soci::session` as database pointer parameter. Defined and -implemented in files `RelationalDBInterface_global.*` and -`RelationalDBInterface_shard.*`. - -2) Global methods for work with node databases, and also with shard databases. -For sqlite case, these methods are internal for `RelationalDBInterfaceSqlite` -implementation of the class `RelationalDBInterface`. They use `soci::session` -as database pointer parameter. Defined and implemented in files -`RelationalDBInterface_nodes.*`. For postgres case, these methods are internal -for `RelationalDBInterfacePostgres` implementation of the class -`RelationalDBInterface`. They use `std::shared_ptr` as database pointer -parameter. Defined and implemented in files `RelationalDBInterface_postgres.*`. - -3) Virtual methods of class `RelationalDBInterface` and also derived classes -`RelationalDBInterfaceSqlite` and `RelationalDBInterfacePostgres`. -Calling such a method resulted in calling corresponding method from -`RelationalDBInterface`-derived class. For sqlite case, such a method tries to -retrieve information from node database, and if this database not exists - then -from shard databases. For both node and shard databases, calls to global -methods of type 2) performed. For postgres case, such a method retrieves -information only from node database by calling a global method of type 2). - -## Methods lists - -### Type 1 methods - -#### Files RelationalDBInterface_global.* - -Wallet DB methods: -``` -makeWalletDB -makeTestWalletDB -getManifests -saveManifests -addValidatorManifest -getNodeIdentity -getPeerReservationTable -insertPeerReservation -deletePeerReservation -createFeatureVotes -readAmendments -voteAmendment -``` - -State DB methods: -``` -initStateDB -getCanDelete -setCanDelete -getSavedState -setSavedState -setLastRotated -``` - -DatabaseBody DB methods: -``` -openDatabaseBodyDb -databaseBodyDoPut -databaseBodyFinish -``` - -Vacuum DB method: -``` -doVacuumDB -``` - -PeerFinder DB methods: -``` -initPeerFinderDB -updatePeerFinderDB -readPeerFinderDB -savePeerFinderDB -``` - -#### Files RelationalDBInterface_shards.* - -Shards DB methods: -``` -makeShardCompleteLedgerDBs -makeShardIncompleteLedgerDBs -updateLedgerDBs -``` - -Shard acquire DB methods: -``` -makeAcquireDB -insertAcquireDBIndex -selectAcquireDBLedgerSeqs -selectAcquireDBLedgerSeqsHash -updateAcquireDB -``` - -Shard archive DB methods: -``` -makeArchiveDB -readArchiveDB -insertArchiveDB -deleteFromArchiveDB -dropArchiveDB -``` - -### Type 2 methods - -#### Files RelationalDBInterface_nodes.* - -``` -makeLedgerDBs -getMinLedgerSeq -getMaxLedgerSeq -deleteByLedgerSeq -deleteBeforeLedgerSeq -getRows -getRowsMinMax -saveValidatedLedger -getLedgerInfoByIndex -getOldestLedgerInfo -getNewestLedgerInfo -getLimitedOldestLedgerInfo -getLimitedNewestLedgerInfo -getLedgerInfoByHash -getHashByIndex -getHashesByIndex -getHashesByIndex -getTxHistory -getOldestAccountTxs -getNewestAccountTxs -getOldestAccountTxsB -getNewestAccountTxsB -oldestAccountTxPage -newestAccountTxPage -getTransaction -DbHasSpace -``` - -#### Files RelationalDBInterface_postgres.* - -``` -getMinLedgerSeq -getMaxLedgerSeq -getCompleteLedgers -getValidatedLedgerAge -getNewestLedgerInfo -getLedgerInfoByIndex -getLedgerInfoByHash -getHashByIndex -getHashesByIndex -getTxHashes -getAccountTx -locateTransaction -writeLedgerAndTransactions -getTxHistory -``` - -### Type 3 methods - -#### Files RelationalDBInterface.* - -``` -init -getMinLedgerSeq -getMaxLedgerSeq -getLedgerInfoByIndex -getNewestLedgerInfo -getLedgerInfoByHash -getHashByIndex -getHashesByIndex -getTxHistory -ledgerDbHasSpace -transactionDbHasSpace -``` - -#### Files backend/RelationalDBInterfaceSqlite.* - -``` -getTransactionsMinLedgerSeq -getAccountTransactionsMinLedgerSeq -deleteTransactionByLedgerSeq -deleteBeforeLedgerSeq -deleteTransactionsBeforeLedgerSeq -deleteAccountTransactionsBeforeLedgerSeq -getTransactionCount -getAccountTransactionCount -getLedgerCountMinMax -saveValidatedLedger -getLimitedOldestLedgerInfo -getLimitedNewestLedgerInfo -getOldestAccountTxs -getNewestAccountTxs -getOldestAccountTxsB -getNewestAccountTxsB -oldestAccountTxPage -newestAccountTxPage -oldestAccountTxPageB -newestAccountTxPageB -getTransaction -getKBUsedAll -getKBUsedLedger -getKBUsedTransaction -``` - -#### Files backend/RelationalDBInterfacePostgres.* - -``` -sweep -getCompleteLedgers -getValidatedLedgerAge -writeLedgerAndTransactions -getTxHashes -getAccountTx -locateTransaction -``` diff --git a/src/ripple/app/rdb/RelationalDBInterface_global.h b/src/ripple/app/rdb/RelationalDBInterface_global.h deleted file mode 100644 index 3eb0469ee8e..00000000000 --- a/src/ripple/app/rdb/RelationalDBInterface_global.h +++ /dev/null @@ -1,333 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACE_GLOBAL_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACE_GLOBAL_H_INCLUDED - -#include -#include -#include -#include -#include -#include -#include - -namespace ripple { - -/* Wallet DB */ - -/** - * @brief makeWalletDB Opens wallet DB and returns it. - * @param setup Path to database and other opening parameters. - * @return Unique pointer to database descriptor. - */ -std::unique_ptr -makeWalletDB(DatabaseCon::Setup const& setup); - -/** - * @brief makeTestWalletDB Opens test wallet DB with arbitrary name. - * @param setup Path to database and other opening parameters. - * @param dbname Name of database. - * @return Unique pointer to database descriptor. - */ -std::unique_ptr -makeTestWalletDB(DatabaseCon::Setup const& setup, std::string const& dbname); - -/** - * @brief getManifests Loads manifest from wallet DB and stores it in the cache. - * @param session Session with database. - * @param dbTable Name of table in the database to extract manifest from. - * @param mCache Cache to store manifest. - * @param j Journal. - */ -void -getManifests( - soci::session& session, - std::string const& dbTable, - ManifestCache& mCache, - beast::Journal j); - -/** - * @brief saveManifests Saves all given manifests to database. - * @param session Session with database. - * @param dbTable Name of database table to save manifest into. - * @param isTrusted Callback returned true if key is trusted. - * @param map Map to save which points public keys to manifests. - * @param j Journal. - */ -void -saveManifests( - soci::session& session, - std::string const& dbTable, - std::function const& isTrusted, - hash_map const& map, - beast::Journal j); - -/** - * @brief addValidatorManifest Saves manifest of validator to database. - * @param session Session with database. - * @param serialized Manifest of validator in raw format. - */ -void -addValidatorManifest(soci::session& session, std::string const& serialized); - -/** - * @brief getNodeIdentity Returns public and private keys of this node. - * @param session Session with database. - * @return Pair of public and private keys. - */ -std::pair -getNodeIdentity(soci::session& session); - -/** - * @brief getPeerReservationTable Returns peer reservation table. - * @param session Session with database. - * @param j Journal. - * @return Peer reservation hash table. - */ -std::unordered_set, KeyEqual> -getPeerReservationTable(soci::session& session, beast::Journal j); - -/** - * @brief insertPeerReservation Adds entry to peer reservation table. - * @param session Session with database. - * @param nodeId public key of node. - * @param description Description of node. - */ -void -insertPeerReservation( - soci::session& session, - PublicKey const& nodeId, - std::string const& description); - -/** - * @brief deletePeerReservation Deletes entry from peer reservation table. - * @param session Session with database. - * @param nodeId Public key of node to remove. - */ -void -deletePeerReservation(soci::session& session, PublicKey const& nodeId); - -/** - * @brief createFeatureVotes Creates FeatureVote table if it is not exists. - * @param session Session with walletDB database. - * @return true if the table already exists - */ -bool -createFeatureVotes(soci::session& session); - -// For historical reasons the up-vote and down-vote integer representations -// are unintuitive. -enum class AmendmentVote : int { up = 0, down = 1 }; - -/** - * @brief readAmendments Read all amendments from FeatureVotes table. - * @param session Session with walletDB database. - * @param callback Callback called for each amendment passing its hash, name - * and the flag if it should be vetoed as callback parameters - */ -void -readAmendments( - soci::session& session, - std::function amendment_hash, - boost::optional amendment_name, - boost::optional vote)> const& callback); - -/** - * @brief voteAmendment Set veto value for particular amendment. - * @param session Session with walletDB database. - * @param amendment Hash of amendment. - * @param name Name of amendment. - * @param vote Whether to vote in favor of this amendment. - */ -void -voteAmendment( - soci::session& session, - uint256 const& amendment, - std::string const& name, - AmendmentVote vote); - -/* State DB */ - -struct SavedState -{ - std::string writableDb; - std::string archiveDb; - LedgerIndex lastRotated; -}; - -/** - * @brief initStateDB Opens DB session with State DB. - * @param session Structure to open session in. - * @param config Path to database and other opening parameters. - * @param dbName Name of database. - */ -void -initStateDB( - soci::session& session, - BasicConfig const& config, - std::string const& dbName); - -/** - * @brief getCanDelete Returns ledger sequence which can be deleted. - * @param session Session with database. - * @return Ledger sequence. - */ -LedgerIndex -getCanDelete(soci::session& session); - -/** - * @brief setCanDelete Updates ledger sequence which can be deleted. - * @param session Session with database. - * @param canDelete Ledger sequence to save. - * @return Previous value of ledger sequence whic can be deleted. - */ -LedgerIndex -setCanDelete(soci::session& session, LedgerIndex canDelete); - -/** - * @brief getSavedState Returns saved state. - * @param session Session with database. - * @return The SavedState structure which contains names of - * writable DB, archive DB and last rotated ledger sequence. - */ -SavedState -getSavedState(soci::session& session); - -/** - * @brief setSavedState Saves given state. - * @param session Session with database. - * @param state The SavedState structure which contains names of - * writable DB, archive DB and last rotated ledger sequence. - */ -void -setSavedState(soci::session& session, SavedState const& state); - -/** - * @brief setLastRotated Updates last rotated ledger sequence. - * @param session Session with database. - * @param seq New value of last rotated ledger sequence. - */ -void -setLastRotated(soci::session& session, LedgerIndex seq); - -/* DatabaseBody DB */ - -/** - * @brief openDatabaseBodyDb Opens file download DB and returns its descriptor. - * Start new download process or continue existing one. - * @param setup Path to database and other opening parameters. - * @param path Path of new file to download. - * @return Pair of unique pointer to database and current downloaded size - * if download process continues. - */ -std::pair, std::optional> -openDatabaseBodyDb( - DatabaseCon::Setup const& setup, - boost::filesystem::path const& path); - -/** - * @brief databaseBodyDoPut Saves new fragment of downloaded file. - * @param session Session with database. - * @param data Downloaded piece to file data tp save. - * @param path Path of downloading file. - * @param fileSize Size of downloaded piece of file. - * @param part Sequence number of downloaded file part. - * @param maxRowSizePad Maximum size of file part to save. - * @return Number of saved parts. Downloaded piece may be splitted - * into several parts of size not large that maxRowSizePad. - */ -std::uint64_t -databaseBodyDoPut( - soci::session& session, - std::string const& data, - std::string const& path, - std::uint64_t fileSize, - std::uint64_t part, - std::uint16_t maxRowSizePad); - -/** - * @brief databaseBodyFinish Finishes download process and writes file to disk. - * @param session Session with database. - * @param fout Opened file to write downloaded data from database. - */ -void -databaseBodyFinish(soci::session& session, std::ofstream& fout); - -/* Vacuum DB */ - -/** - * @brief doVacuumDB Creates, initialises DB, and performs its cleanup. - * @param setup Path to database and other opening parameters. - * @return True if vacuum process completed successfully. - */ -bool -doVacuumDB(DatabaseCon::Setup const& setup); - -/* PeerFinder DB */ - -/** - * @brief initPeerFinderDB Opens session with peer finder database. - * @param session Structure to open session in. - * @param config Path to database and other opening parameters. - * @param j Journal. - */ -void -initPeerFinderDB( - soci::session& session, - BasicConfig const& config, - beast::Journal j); - -/** - * @brief updatePeerFinderDB Update peer finder DB to new version. - * @param session Session with database. - * @param currentSchemaVersion New version of database. - * @param j Journal. - */ -void -updatePeerFinderDB( - soci::session& session, - int currentSchemaVersion, - beast::Journal j); - -/** - * @brief readPeerFinderDB Read all entries from peer finder DB and call - * given callback for each entry. - * @param session Session with database. - * @param func Callback to call for each entry. - */ -void -readPeerFinderDB( - soci::session& session, - std::function const& func); - -/** - * @brief savePeerFinderDB Save new entry to peer finder DB. - * @param session Session with database. - * @param v Entry to save which contains information about new peer. - */ -void -savePeerFinderDB( - soci::session& session, - std::vector const& v); - -} // namespace ripple - -#endif diff --git a/src/ripple/app/rdb/RelationalDBInterface_postgres.h b/src/ripple/app/rdb/RelationalDBInterface_postgres.h deleted file mode 100644 index f5838813b5e..00000000000 --- a/src/ripple/app/rdb/RelationalDBInterface_postgres.h +++ /dev/null @@ -1,248 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2021 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACE_POSTGRES_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACE_POSTGRES_H_INCLUDED - -#include -#include -#include -#include -#include -#include -#include - -namespace ripple { - -class PgPool; - -using AccountTxMarker = RelationalDBInterface::AccountTxMarker; -using AccountTxArgs = RelationalDBInterface::AccountTxArgs; -using AccountTxResult = RelationalDBInterface::AccountTxResult; -using AccountTransactionsData = RelationalDBInterface::AccountTransactionsData; - -/** - * @brief getMinLedgerSeq Returns minimum ledger sequence - * from Postgres database - * @param pgPool Link to postgres database - * @param app Application - * @param j Journal - * @return Minimum ledger sequence if any, none if no ledgers - */ -std::optional -getMinLedgerSeq(std::shared_ptr const& pgPool, beast::Journal j); - -/** - * @brief getMaxLedgerSeq Returns maximum ledger sequence - * from Postgres database - * @param pgPool Link to postgres database - * @param app Application - * @return Maximum ledger sequence if any, none if no ledgers - */ -std::optional -getMaxLedgerSeq(std::shared_ptr const& pgPool); - -/** - * @brief getCompleteLedgers Returns string which contains - * list of completed ledgers - * @param pgPool Link to postgres database - * @param app Application - * @return String with completed ledgers - */ -std::string -getCompleteLedgers(std::shared_ptr const& pgPool); - -/** - * @brief getValidatedLedgerAge Returns age of last - * validated ledger - * @param pgPool Link to postgres database - * @param app Application - * @param j Journal - * @return Age of last validated ledger - */ -std::chrono::seconds -getValidatedLedgerAge(std::shared_ptr const& pgPool, beast::Journal j); - -/** - * @brief getNewestLedgerInfo Load latest ledger info from Postgres - * @param pgPool Link to postgres database - * @param app reference to Application - * @return Ledger info - */ -std::optional -getNewestLedgerInfo(std::shared_ptr const& pgPool, Application& app); - -/** - * @brief getLedgerInfoByIndex Load ledger info by index (AKA sequence) - * from Postgres - * @param pgPool Link to postgres database - * @param ledgerIndex the ledger index (or sequence) to load - * @param app reference to Application - * @return Ledger info - */ -std::optional -getLedgerInfoByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - Application& app); - -/** - * @brief getLedgerInfoByHash Load ledger info by hash from Postgres - * @param pgPool Link to postgres database - * @param hash Hash of the ledger to load - * @param app reference to Application - * @return Ledger info - */ -std::optional -getLedgerInfoByHash( - std::shared_ptr const& pgPool, - uint256 const& ledgerHash, - Application& app); - -/** - * @brief getHashByIndex Given a ledger sequence, - * return the ledger hash - * @param pgPool Link to postgres database - * @param ledgerIndex Ledger sequence - * @param app Application - * @return Hash of ledger - */ -uint256 -getHashByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - Application& app); - -/** - * @brief getHashesByIndex Given a ledger sequence, - * return the ledger hash and the parent hash - * @param pgPool Link to postgres database - * @param ledgerIndex Ledger sequence - * @param[out] ledgerHash Hash of ledger - * @param[out] parentHash Hash of parent ledger - * @param app Application - * @return True if the data was found - */ -bool -getHashesByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - uint256& ledgerHash, - uint256& parentHash, - Application& app); - -/** - * @brief getHashesByIndex Given a contiguous range of sequences, - * return a map of sequence -> (hash, parent hash) - * @param pgPool Link to postgres database - * @param minSeq Lower bound of range - * @param maxSeq Upper bound of range - * @param app Application - * @return Mapping of all found ledger sequences to their hash and parent hash - */ -std::map -getHashesByIndex( - std::shared_ptr const& pgPool, - std::uint32_t minSeq, - std::uint32_t maxSeq, - Application& app); - -/** - * @brief getTxHashes Returns vector of tx hashes by given ledger - * sequence - * @param pgPool Link to postgres database - * @param seq Ledger sequence - * @param app Application - * @return Vector of tx hashes - */ -std::vector -getTxHashes( - std::shared_ptr const& pgPool, - LedgerIndex seq, - Application& app); - -/** - * @brief locateTransaction Returns information used to locate - * a transaction. Function is specific to postgres backend. - * @param pgPool Link to postgres database - * @param id Hash of the transaction. - * @param app Application - * @return Information used to locate a transaction. Contains a nodestore - * hash and ledger sequence pair if the transaction was found. - * Otherwise, contains the range of ledgers present in the database - * at the time of search. - */ -Transaction::Locator -locateTransaction( - std::shared_ptr const& pgPool, - uint256 const& id, - Application& app); - -/** - * @brief getTxHistory Returns most recent 20 transactions starting - * from given number or entry. - * @param pgPool Link to postgres database - * @param startIndex First number of returned entry. - * @param app Application - * @param j Journal - * @return Vector of sharded pointers to transactions sorted in - * descending order by ledger sequence. - */ -std::vector> -getTxHistory( - std::shared_ptr const& pgPool, - LedgerIndex startIndex, - Application& app, - beast::Journal j); - -/** - * @brief getAccountTx Get last account transactions specifies by - * passed argumenrs structure. - * @param pgPool Link to postgres database - * @param args Arguments which specify account and whose tx to return. - * @param app Application - * @param j Journal - * @return Vector of account transactions and RPC status of responce. - */ -std::pair -getAccountTx( - std::shared_ptr const& pgPool, - AccountTxArgs const& args, - Application& app, - beast::Journal j); - -/** - * @brief writeLedgerAndTransactions Write new ledger and transaction - * data to Postgres. - * @param pgPool Pool of Postgres connections - * @param info Ledger info to write. - * @param accountTxData Transaction data to write - * @param j Journal (for logging) - * @return True if success, false if failure. - */ -bool -writeLedgerAndTransactions( - std::shared_ptr const& pgPool, - LedgerInfo const& info, - std::vector const& accountTxData, - beast::Journal& j); - -} // namespace ripple - -#endif diff --git a/src/ripple/app/rdb/RelationalDBInterface_shards.h b/src/ripple/app/rdb/RelationalDBInterface_shards.h deleted file mode 100644 index 16ef67d210d..00000000000 --- a/src/ripple/app/rdb/RelationalDBInterface_shards.h +++ /dev/null @@ -1,257 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACE_SHARDS_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACE_SHARDS_H_INCLUDED - -#include -#include -#include -#include -#include - -namespace ripple { - -struct DatabasePair -{ - std::unique_ptr ledgerDb; - std::unique_ptr transactionDb; -}; - -/* Shard DB */ - -/** - * @brief makeMetaDBs Opens ledger and transaction 'meta' databases which - * map ledger hashes and transaction IDs to the index of the shard - * that holds the ledger or transaction. - * @param config Config object. - * @param setup Path to database and opening parameters. - * @param checkpointerSetup Database checkpointer setup. - * @return Struct DatabasePair which contains unique pointers to the ledger - * and transaction databases. - */ -DatabasePair -makeMetaDBs( - Config const& config, - DatabaseCon::Setup const& setup, - DatabaseCon::CheckpointerSetup const& checkpointerSetup); - -/** - * @brief saveLedgerMeta Stores (transaction ID -> shard index) and - * (ledger hash -> shard index) mappings in the meta databases. - * @param ledger The ledger. - * @param app Application object. - * @param lgrMetaSession Session to ledger meta database. - * @param txnMetaSession Session to transaction meta database. - * @param shardIndex The index of the shard that contains this ledger. - * @return True on success. - */ -bool -saveLedgerMeta( - std::shared_ptr const& ledger, - Application& app, - soci::session& lgrMetaSession, - soci::session& txnMetaSession, - std::uint32_t shardIndex); - -/** - * @brief getShardIndexforLedger Queries the ledger meta database to - * retrieve the index of the shard that contains this ledger. - * @param session Session to the database. - * @param hash Hash of the ledger. - * @return The index of the shard on success, otherwise an unseated value. - */ -std::optional -getShardIndexforLedger(soci::session& session, LedgerHash const& hash); - -/** - * @brief getShardIndexforTransaction Queries the transaction meta database to - * retrieve the index of the shard that contains this transaction. - * @param session Session to the database. - * @param id ID of the transaction. - * @return The index of the shard on success, otherwise an unseated value. - */ -std::optional -getShardIndexforTransaction(soci::session& session, TxID const& id); - -/** - * @brief makeShardCompleteLedgerDBs Opens shard databases for already - * verified shard and returns its descriptors. - * @param config Config object. - * @param setup Path to database and other opening parameters. - * @return Pair of unique pointers to opened ledger and transaction databases. - */ -DatabasePair -makeShardCompleteLedgerDBs( - Config const& config, - DatabaseCon::Setup const& setup); - -/** - * @brief makeShardIncompleteLedgerDBs Opens shard databases for not - * fully downloaded or verified shard and returns its descriptors. - * @param config Config object. - * @param setup Path to database and other opening parameters. - * @param checkpointerSetup Checkpointer parameters. - * @return Pair of unique pointers to opened ledger and transaction databases. - */ -DatabasePair -makeShardIncompleteLedgerDBs( - Config const& config, - DatabaseCon::Setup const& setup, - DatabaseCon::CheckpointerSetup const& checkpointerSetup); - -/** - * @brief updateLedgerDBs Save given ledger to shard databases. - * @param txdb Session with transaction DB. - * @param lgrdb Sessiob with ledger DB. - * @param ledger Ledger to save. - * @param index Index of the shard which the ledger belonfs to. - * @param stop Link to atomic flag which can stop the process if raised. - * @param j Journal - * @return True if ledger was successfully saved. - */ -bool -updateLedgerDBs( - soci::session& txdb, - soci::session& lgrdb, - std::shared_ptr const& ledger, - std::uint32_t index, - std::atomic& stop, - beast::Journal j); - -/* Shard acquire DB */ - -/** - * @brief makeAcquireDB Opens shard acquire DB and returns its descriptor. - * @param setup Path to DB and other opening parameters. - * @param checkpointerSetup Checkpointer parameters. - * @return Uniqye pointer to opened database. - */ -std::unique_ptr -makeAcquireDB( - DatabaseCon::Setup const& setup, - DatabaseCon::CheckpointerSetup const& checkpointerSetup); - -/** - * @brief insertAcquireDBIndex Adds new shard index to shard acquire DB. - * @param session Session with database. - * @param index Index to add. - */ -void -insertAcquireDBIndex(soci::session& session, std::uint32_t index); - -/** - * @brief selectAcquireDBLedgerSeqs Returns set of acquired ledgers for - * given shard. - * @param session Session with database. - * @param index Shard index. - * @return Pair which contains true if such as index found in database, - * and string which contains set of ledger sequences. - * If set of sequences was not saved than none is returned. - */ -std::pair> -selectAcquireDBLedgerSeqs(soci::session& session, std::uint32_t index); - -struct AcquireShardSeqsHash -{ - std::optional sequences; - std::optional hash; -}; - -/** - * @brief selectAcquireDBLedgerSeqsHash Returns set of acquired ledgers and - * hash for given shard. - * @param session Session with database. - * @param index Shard index. - * @return Pair which contains true of such an index found in database, - * and the AcquireShardSeqsHash structure which contains string - * with ledger sequences set and string with last ledger hash. - * If set of sequences or hash were not saved than none is returned. - */ -std::pair -selectAcquireDBLedgerSeqsHash(soci::session& session, std::uint32_t index); - -/** - * @brief updateAcquireDB Updates information in acquire DB. - * @param session Session with database. - * @param ledger Ledger to save into database. - * @param index Shard index. - * @param lastSeq Last acqyured ledger sequence. - * @param seqs Current set or acquired ledger sequences if it's not empty. - */ -void -updateAcquireDB( - soci::session& session, - std::shared_ptr const& ledger, - std::uint32_t index, - std::uint32_t lastSeq, - std::optional const& seqs); - -/* Archive DB */ - -/** - * @brief makeArchiveDB Opens shard archive DB and returns its descriptor. - * @param dir Path to database to open. - * @param dbName Name of database. - * @return Unique pointer to opened database. - */ -std::unique_ptr -makeArchiveDB(boost::filesystem::path const& dir, std::string const& dbName); - -/** - * @brief readArchiveDB Read entries from shard archive database and calls - * fiven callback for each entry. - * @param db Session with database. - * @param func Callback to call for each entry. - */ -void -readArchiveDB( - DatabaseCon& db, - std::function const& func); - -/** - * @brief insertArchiveDB Adds entry to shard archive database. - * @param db Session with database. - * @param shardIndex Shard index to add. - * @param url Shard download url to add. - */ -void -insertArchiveDB( - DatabaseCon& db, - std::uint32_t shardIndex, - std::string const& url); - -/** - * @brief deleteFromArchiveDB Deletes entry from shard archive DB. - * @param db Session with database. - * @param shardIndex Shard index to remove from DB. - */ -void -deleteFromArchiveDB(DatabaseCon& db, std::uint32_t shardIndex); - -/** - * @brief dropArchiveDB Removes table in shard archive DB. - * @param db Session with database. - */ -void -dropArchiveDB(DatabaseCon& db); - -} // namespace ripple - -#endif diff --git a/src/ripple/app/rdb/RelationalDBInterface.h b/src/ripple/app/rdb/RelationalDatabase.h similarity index 76% rename from src/ripple/app/rdb/RelationalDBInterface.h rename to src/ripple/app/rdb/RelationalDatabase.h index a0d01545bc5..e0f791101fb 100644 --- a/src/ripple/app/rdb/RelationalDBInterface.h +++ b/src/ripple/app/rdb/RelationalDatabase.h @@ -17,8 +17,8 @@ */ //============================================================================== -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACE_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACE_H_INCLUDED +#ifndef RIPPLE_APP_RDB_RELATIONALDATABASE_H_INCLUDED +#define RIPPLE_APP_RDB_RELATIONALDATABASE_H_INCLUDED #include #include @@ -45,7 +45,7 @@ struct LedgerRange uint32_t max; }; -class RelationalDBInterface +class RelationalDatabase { public: struct CountMinMax @@ -135,56 +135,61 @@ class RelationalDBInterface }; /** - * @brief init Creates and returns appropriate interface based on config. + * @brief init Creates and returns an appropriate RelationalDatabase + * instance based on configuration. * @param app Application object. * @param config Config object. * @param jobQueue JobQueue object. * @return Unique pointer to the interface. */ - static std::unique_ptr + static std::unique_ptr init(Application& app, Config const& config, JobQueue& jobQueue); - virtual ~RelationalDBInterface() = default; + virtual ~RelationalDatabase() = default; /** - * @brief getMinLedgerSeq Returns minimum ledger sequence in Ledgers table. - * @return Ledger sequence or none if no ledgers exist. + * @brief getMinLedgerSeq Returns the minimum ledger sequence in the Ledgers + * table. + * @return Ledger sequence or no value if no ledgers exist. */ virtual std::optional getMinLedgerSeq() = 0; /** - * @brief getMaxLedgerSeq Returns maximum ledger sequence in Ledgers table. + * @brief getMaxLedgerSeq Returns the maximum ledger sequence in the Ledgers + * table. * @return Ledger sequence or none if no ledgers exist. */ virtual std::optional getMaxLedgerSeq() = 0; /** - * @brief getLedgerInfoByIndex Returns ledger by its sequence. + * @brief getLedgerInfoByIndex Returns a ledger by its sequence. * @param ledgerSeq Ledger sequence. - * @return Ledger or none if ledger not found. + * @return The ledger if found, otherwise no value. */ virtual std::optional getLedgerInfoByIndex(LedgerIndex ledgerSeq) = 0; /** - * @brief getNewestLedgerInfo Returns info of newest saved ledger. - * @return Ledger info or none if ledger not found. + * @brief getNewestLedgerInfo Returns the info of the newest saved ledger. + * @return Ledger info if found, otherwise no value. */ virtual std::optional getNewestLedgerInfo() = 0; /** - * @brief getLedgerInfoByHash Returns info of ledger with given hash. + * @brief getLedgerInfoByHash Returns the info of the ledger with given + * hash. * @param ledgerHash Hash of the ledger. - * @return Ledger or none if ledger not found. + * @return Ledger if found, otherwise no value. */ virtual std::optional getLedgerInfoByHash(uint256 const& ledgerHash) = 0; /** - * @brief getHashByIndex Returns hash of ledger with given sequence. + * @brief getHashByIndex Returns the hash of the ledger with the given + * sequence. * @param ledgerIndex Ledger sequence. * @return Hash of the ledger. */ @@ -192,39 +197,40 @@ class RelationalDBInterface getHashByIndex(LedgerIndex ledgerIndex) = 0; /** - * @brief getHashesByIndex Returns hash of the ledger and hash of parent - * ledger for the ledger of given sequence. + * @brief getHashesByIndex Returns the hashes of the ledger and its parent + * as specified by the ledgerIndex. * @param ledgerIndex Ledger sequence. - * @return Struct LedgerHashPair which contain hashes of the ledger and - * its parent ledger. + * @return Struct LedgerHashPair which contains hashes of the ledger and + * its parent. */ virtual std::optional getHashesByIndex(LedgerIndex ledgerIndex) = 0; /** - * @brief getHashesByIndex Returns hash of the ledger and hash of parent - * ledger for all ledgers with sequences from given minimum limit - * to given maximum limit. + * @brief getHashesByIndex Returns hashes of each ledger and its parent for + * all ledgers within the provided range. * @param minSeq Minimum ledger sequence. * @param maxSeq Maximum ledger sequence. - * @return Map which points sequence number of found ledger to the struct - * LedgerHashPair which contains ledger hash and its parent hash. + * @return Container that maps the sequence number of a found ledger to the + * struct LedgerHashPair which contains the hashes of the ledger and + * its parent. */ virtual std::map getHashesByIndex(LedgerIndex minSeq, LedgerIndex maxSeq) = 0; /** - * @brief getTxHistory Returns most recent 20 transactions starting from - * given number or entry. + * @brief getTxHistory Returns the 20 most recent transactions starting from + * the given number. * @param startIndex First number of returned entry. - * @return Vector of sharded pointers to transactions sorted in + * @return Vector of shared pointers to transactions sorted in * descending order by ledger sequence. */ virtual std::vector> getTxHistory(LedgerIndex startIndex) = 0; /** - * @brief ledgerDbHasSpace Checks if ledger database has available space. + * @brief ledgerDbHasSpace Checks if the ledger database has available + * space. * @param config Config object. * @return True if space is available. */ @@ -232,7 +238,7 @@ class RelationalDBInterface ledgerDbHasSpace(Config const& config) = 0; /** - * @brief transactionDbHasSpace Checks if transaction database has + * @brief transactionDbHasSpace Checks if the transaction database has * available space. * @param config Config object. * @return True if space is available. diff --git a/src/ripple/app/rdb/ShardArchive.h b/src/ripple/app/rdb/ShardArchive.h new file mode 100644 index 00000000000..20c4382b056 --- /dev/null +++ b/src/ripple/app/rdb/ShardArchive.h @@ -0,0 +1,78 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_SHARDARCHIVE_H_INCLUDED +#define RIPPLE_APP_RDB_SHARDARCHIVE_H_INCLUDED + +#include +#include + +namespace ripple { + +/** + * @brief makeArchiveDB Opens the shard archive database and returns its + * descriptor. + * @param dir Path to the database to open. + * @param dbName Name of the database. + * @return Unique pointer to the opened database. + */ +std::unique_ptr +makeArchiveDB(boost::filesystem::path const& dir, std::string const& dbName); + +/** + * @brief readArchiveDB Reads entries from the shard archive database and + * invokes the given callback for each entry. + * @param db Session with the database. + * @param func Callback to invoke for each entry. + */ +void +readArchiveDB( + DatabaseCon& db, + std::function const& func); + +/** + * @brief insertArchiveDB Adds an entry to the shard archive database. + * @param db Session with the database. + * @param shardIndex Shard index to add. + * @param url Shard download url to add. + */ +void +insertArchiveDB( + DatabaseCon& db, + std::uint32_t shardIndex, + std::string const& url); + +/** + * @brief deleteFromArchiveDB Deletes an entry from the shard archive database. + * @param db Session with the database. + * @param shardIndex Shard index to remove from the database. + */ +void +deleteFromArchiveDB(DatabaseCon& db, std::uint32_t shardIndex); + +/** + * @brief dropArchiveDB Removes a table in the shard archive database. + * @param db Session with the database. + */ +void +dropArchiveDB(DatabaseCon& db); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/State.h b/src/ripple/app/rdb/State.h new file mode 100644 index 00000000000..fe74d5f19d3 --- /dev/null +++ b/src/ripple/app/rdb/State.h @@ -0,0 +1,98 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_STATE_H_INCLUDED +#define RIPPLE_APP_RDB_STATE_H_INCLUDED + +#include +#include +#include +#include +#include +#include +#include + +namespace ripple { + +struct SavedState +{ + std::string writableDb; + std::string archiveDb; + LedgerIndex lastRotated; +}; + +/** + * @brief initStateDB Opens a session with the State database. + * @param session Provides a session with the database. + * @param config Path to the database and other opening parameters. + * @param dbName Name of the database. + */ +void +initStateDB( + soci::session& session, + BasicConfig const& config, + std::string const& dbName); + +/** + * @brief getCanDelete Returns the ledger sequence which can be deleted. + * @param session Session with the database. + * @return Ledger sequence. + */ +LedgerIndex +getCanDelete(soci::session& session); + +/** + * @brief setCanDelete Updates the ledger sequence which can be deleted. + * @param session Session with the database. + * @param canDelete Ledger sequence to save. + * @return Previous value of the ledger sequence which can be deleted. + */ +LedgerIndex +setCanDelete(soci::session& session, LedgerIndex canDelete); + +/** + * @brief getSavedState Returns the saved state. + * @param session Session with the database. + * @return The SavedState structure which contains the names of the writable + * database, the archive database and the last rotated ledger sequence. + */ +SavedState +getSavedState(soci::session& session); + +/** + * @brief setSavedState Saves the given state. + * @param session Session with the database. + * @param state The SavedState structure which contains the names of the + * writable database, the archive database and the last rotated ledger + * sequence. + */ +void +setSavedState(soci::session& session, SavedState const& state); + +/** + * @brief setLastRotated Updates the last rotated ledger sequence. + * @param session Session with the database. + * @param seq New value of the last rotated ledger sequence. + */ +void +setLastRotated(soci::session& session, LedgerIndex seq); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/UnitaryShard.h b/src/ripple/app/rdb/UnitaryShard.h new file mode 100644 index 00000000000..d2ac773dbd3 --- /dev/null +++ b/src/ripple/app/rdb/UnitaryShard.h @@ -0,0 +1,155 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_UNITARYSHARD_H_INCLUDED +#define RIPPLE_APP_RDB_UNITARYSHARD_H_INCLUDED + +#include +#include +#include +#include +#include + +namespace ripple { + +struct DatabasePair +{ + std::unique_ptr ledgerDb; + std::unique_ptr transactionDb; +}; + +/** + * @brief makeShardCompleteLedgerDBs Opens shard databases for verified shards + * and returns their descriptors. + * @param config Config object. + * @param setup Path to the databases and other opening parameters. + * @return Pair of unique pointers to the opened ledger and transaction + * databases. + */ +DatabasePair +makeShardCompleteLedgerDBs( + Config const& config, + DatabaseCon::Setup const& setup); + +/** + * @brief makeShardIncompleteLedgerDBs Opens shard databases for partially + * downloaded or unverified shards and returns their descriptors. + * @param config Config object. + * @param setup Path to the databases and other opening parameters. + * @param checkpointerSetup Checkpointer parameters. + * @return Pair of unique pointers to the opened ledger and transaction + * databases. + */ +DatabasePair +makeShardIncompleteLedgerDBs( + Config const& config, + DatabaseCon::Setup const& setup, + DatabaseCon::CheckpointerSetup const& checkpointerSetup); + +/** + * @brief updateLedgerDBs Saves the given ledger to shard databases. + * @param txdb Session with the transaction databases. + * @param lgrdb Session with the ledger databases. + * @param ledger Ledger to save. + * @param index Index of the shard that owns the ledger. + * @param stop Reference to an atomic flag that can stop the process if raised. + * @param j Journal + * @return True if the ledger was successfully saved. + */ +bool +updateLedgerDBs( + soci::session& txdb, + soci::session& lgrdb, + std::shared_ptr const& ledger, + std::uint32_t index, + std::atomic& stop, + beast::Journal j); + +/** + * @brief makeAcquireDB Opens the shard acquire database and returns its + * descriptor. + * @param setup Path to the database and other opening parameters. + * @param checkpointerSetup Checkpointer parameters. + * @return Unique pointer to the opened database. + */ +std::unique_ptr +makeAcquireDB( + DatabaseCon::Setup const& setup, + DatabaseCon::CheckpointerSetup const& checkpointerSetup); + +/** + * @brief insertAcquireDBIndex Adds a new shard index to the shard acquire + * database. + * @param session Session with the database. + * @param index Index to add. + */ +void +insertAcquireDBIndex(soci::session& session, std::uint32_t index); + +/** + * @brief selectAcquireDBLedgerSeqs Returns the set of acquired ledgers for + * the given shard. + * @param session Session with the database. + * @param index Shard index. + * @return Pair which contains true if such an index was found in the database, + * and a string which contains the set of ledger sequences. + * If no sequences were saved then the optional will have no value. + */ +std::pair> +selectAcquireDBLedgerSeqs(soci::session& session, std::uint32_t index); + +struct AcquireShardSeqsHash +{ + std::optional sequences; + std::optional hash; +}; + +/** + * @brief selectAcquireDBLedgerSeqsHash Returns the set of acquired ledger + * sequences and the last ledger hash for the shard with the provided + * index. + * @param session Session with the database. + * @param index Shard index. + * @return Pair which contains true if such an index was found in the database + * and the AcquireShardSeqsHash structure which contains a string with + * the ledger sequences and a string with last ledger hash. If the set + * of sequences or hash were not saved then no value is returned. + */ +std::pair +selectAcquireDBLedgerSeqsHash(soci::session& session, std::uint32_t index); + +/** + * @brief updateAcquireDB Updates information in the acquire DB. + * @param session Session with the database. + * @param ledger Ledger to save into the database. + * @param index Shard index. + * @param lastSeq Last acquired ledger sequence. + * @param seqs Current set of acquired ledger sequences if it's not empty. + */ +void +updateAcquireDB( + soci::session& session, + std::shared_ptr const& ledger, + std::uint32_t index, + std::uint32_t lastSeq, + std::optional const& seqs); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/Vacuum.h b/src/ripple/app/rdb/Vacuum.h new file mode 100644 index 00000000000..3db18da045a --- /dev/null +++ b/src/ripple/app/rdb/Vacuum.h @@ -0,0 +1,37 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_VACUUM_H_INCLUDED +#define RIPPLE_APP_RDB_VACUUM_H_INCLUDED + +#include + +namespace ripple { + +/** + * @brief doVacuumDB Creates, initialises, and performs cleanup on a database. + * @param setup Path to the database and other opening parameters. + * @return True if the vacuum process completed successfully. + */ +bool +doVacuumDB(DatabaseCon::Setup const& setup); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/Wallet.h b/src/ripple/app/rdb/Wallet.h new file mode 100644 index 00000000000..6bf6ca9ea83 --- /dev/null +++ b/src/ripple/app/rdb/Wallet.h @@ -0,0 +1,170 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_WALLET_H_INCLUDED +#define RIPPLE_APP_RDB_WALLET_H_INCLUDED + +#include +#include +#include +#include +#include +#include + +namespace ripple { + +/** + * @brief makeWalletDB Opens the wallet database and returns it. + * @param setup Path to the database and other opening parameters. + * @return Unique pointer to the database descriptor. + */ +std::unique_ptr +makeWalletDB(DatabaseCon::Setup const& setup); + +/** + * @brief makeTestWalletDB Opens a test wallet database with an arbitrary name. + * @param setup Path to the database and other opening parameters. + * @param dbname Name of the database. + * @return Unique pointer to the database descriptor. + */ +std::unique_ptr +makeTestWalletDB(DatabaseCon::Setup const& setup, std::string const& dbname); + +/** + * @brief getManifests Loads a manifest from the wallet database and stores it + * in the cache. + * @param session Session with the database. + * @param dbTable Name of the database table from which the manifest will be + * extracted. + * @param mCache Cache for storing the manifest. + * @param j Journal. + */ +void +getManifests( + soci::session& session, + std::string const& dbTable, + ManifestCache& mCache, + beast::Journal j); + +/** + * @brief saveManifests Saves all given manifests to the database. + * @param session Session with the database. + * @param dbTable Name of the database table that will store the manifest. + * @param isTrusted Callback that returns true if the key is trusted. + * @param map Maps public keys to manifests. + * @param j Journal. + */ +void +saveManifests( + soci::session& session, + std::string const& dbTable, + std::function const& isTrusted, + hash_map const& map, + beast::Journal j); + +/** + * @brief addValidatorManifest Saves the manifest of a validator to the + * database. + * @param session Session with the database. + * @param serialized Manifest of the validator in raw format. + */ +void +addValidatorManifest(soci::session& session, std::string const& serialized); + +/** + * @brief getNodeIdentity Returns the public and private keys of this node. + * @param session Session with the database. + * @return Pair of public and private keys. + */ +std::pair +getNodeIdentity(soci::session& session); + +/** + * @brief getPeerReservationTable Returns the peer reservation table. + * @param session Session with the database. + * @param j Journal. + * @return Peer reservation hash table. + */ +std::unordered_set, KeyEqual> +getPeerReservationTable(soci::session& session, beast::Journal j); + +/** + * @brief insertPeerReservation Adds an entry to the peer reservation table. + * @param session Session with the database. + * @param nodeId Public key of the node. + * @param description Description of the node. + */ +void +insertPeerReservation( + soci::session& session, + PublicKey const& nodeId, + std::string const& description); + +/** + * @brief deletePeerReservation Deletes an entry from the peer reservation + * table. + * @param session Session with the database. + * @param nodeId Public key of the node to remove. + */ +void +deletePeerReservation(soci::session& session, PublicKey const& nodeId); + +/** + * @brief createFeatureVotes Creates the FeatureVote table if it does not exist. + * @param session Session with the wallet database. + * @return true if the table already exists + */ +bool +createFeatureVotes(soci::session& session); + +// For historical reasons the up-vote and down-vote integer representations +// are unintuitive. +enum class AmendmentVote : int { up = 0, down = 1 }; + +/** + * @brief readAmendments Reads all amendments from the FeatureVotes table. + * @param session Session with the wallet database. + * @param callback Callback called for each amendment with its hash, name and + * optionally a flag denoting whether the amendment should be vetoed. + */ +void +readAmendments( + soci::session& session, + std::function amendment_hash, + boost::optional amendment_name, + boost::optional vote)> const& callback); + +/** + * @brief voteAmendment Set the veto value for a particular amendment. + * @param session Session with the wallet database. + * @param amendment Hash of the amendment. + * @param name Name of the amendment. + * @param vote Whether to vote in favor of this amendment. + */ +void +voteAmendment( + soci::session& session, + uint256 const& amendment, + std::string const& name, + AmendmentVote vote); + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.h b/src/ripple/app/rdb/backend/PostgresDatabase.h similarity index 53% rename from src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.h rename to src/ripple/app/rdb/backend/PostgresDatabase.h index 7149f475fb6..e8673611279 100644 --- a/src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.h +++ b/src/ripple/app/rdb/backend/PostgresDatabase.h @@ -17,55 +17,47 @@ */ //============================================================================== -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACEPOSTGRES_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACEPOSTGRES_H_INCLUDED +#ifndef RIPPLE_APP_RDB_BACKEND_POSTGRESDATABASE_H_INCLUDED +#define RIPPLE_APP_RDB_BACKEND_POSTGRESDATABASE_H_INCLUDED -#include +#include namespace ripple { -class RelationalDBInterfacePostgres : public RelationalDBInterface +class PostgresDatabase : public RelationalDatabase { public: - /** There is only one implementation of this interface: - * RelationalDBInterfacePostgresImp. It wraps a stoppable object (PgPool) - * that does not follow RAII, and it does not go through the effort of - * following RAII either. The owner of the only object of that type - * (ApplicationImp) holds it by the type of its interface instead of its - * implementation, and thus the lifetime management methods need to be - * part of the interface. - */ virtual void stop() = 0; /** - * @brief sweep Sweep the database. Method is specific for postgres backend. + * @brief sweep Sweeps the database. */ virtual void sweep() = 0; /** - * @brief getCompleteLedgers Returns string which contains list of - * completed ledgers. Method is specific for postgres backend. - * @return String with completed ledger numbers + * @brief getCompleteLedgers Returns a string which contains a list of + * completed ledgers. + * @return String with completed ledger sequences */ virtual std::string getCompleteLedgers() = 0; /** - * @brief getValidatedLedgerAge Returns age of last - * validated ledger. Method is specific for postgres backend. - * @return Age of last validated ledger in seconds + * @brief getValidatedLedgerAge Returns the age of the last validated + * ledger. + * @return Age of the last validated ledger in seconds */ virtual std::chrono::seconds getValidatedLedgerAge() = 0; /** - * @brief writeLedgerAndTransactions Write new ledger and transaction data - * into database. Method is specific for Postgres backend. + * @brief writeLedgerAndTransactions Writes new ledger and transaction data + * into the database. * @param info Ledger info to write. * @param accountTxData Transaction data to write - * @return True if success, false if failure. + * @return True on success, false on failure. */ virtual bool writeLedgerAndTransactions( @@ -73,32 +65,30 @@ class RelationalDBInterfacePostgres : public RelationalDBInterface std::vector const& accountTxData) = 0; /** - * @brief getTxHashes Returns vector of tx hashes by given ledger - * sequence. Method is specific to postgres backend. + * @brief getTxHashes Returns a vector of the hashes of transactions + * belonging to the ledger with the provided sequence. * @param seq Ledger sequence - * @return Vector of tx hashes + * @return Vector of transaction hashes */ virtual std::vector getTxHashes(LedgerIndex seq) = 0; /** - * @brief getAccountTx Get last account transactions specifies by - * passed argumenrs structure. Function if specific to postgres - * backend. - * @param args Arguments which specify account and whose tx to return. - * @param app Application - * @param j Journal - * @return Vector of account transactions and RPC status of responce. + * @brief getAccountTx Get the last account transactions specified by the + * AccountTxArgs struct. + * @param args Arguments which specify the account and which transactions to + * return. + * @return Vector of account transactions and the RPC status response. */ virtual std::pair getAccountTx(AccountTxArgs const& args) = 0; /** * @brief locateTransaction Returns information used to locate - * a transaction. Function is specific to postgres backend. + * a transaction. * @param id Hash of the transaction. * @return Information used to locate a transaction. Contains a nodestore - * hash and ledger sequence pair if the transaction was found. + * hash and a ledger sequence pair if the transaction was found. * Otherwise, contains the range of ledgers present in the database * at the time of search. */ @@ -110,9 +100,9 @@ class RelationalDBInterfacePostgres : public RelationalDBInterface * network * @param[out] reason if the database is not caught up, reason contains a * helpful message describing why - * @return false if the most recently written - * ledger has a close time over 3 minutes ago, or if there are - * no ledgers in the database. true otherwise + * @return false if the most recently written ledger has a close time + * over 3 minutes ago, or if there are no ledgers in the + * database. true otherwise */ virtual bool isCaughtUp(std::string& reason) = 0; diff --git a/src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.cpp b/src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.cpp deleted file mode 100644 index 8b9a962106e..00000000000 --- a/src/ripple/app/rdb/backend/RelationalDBInterfacePostgres.cpp +++ /dev/null @@ -1,298 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include - -namespace ripple { - -class RelationalDBInterfacePostgresImp : public RelationalDBInterfacePostgres -{ -public: - RelationalDBInterfacePostgresImp( - Application& app, - Config const& config, - JobQueue& jobQueue) - : app_(app) - , j_(app_.journal("PgPool")) - , pgPool_( -#ifdef RIPPLED_REPORTING - make_PgPool(config.section("ledger_tx_tables"), j_) -#endif - ) - { - assert(config.reporting()); -#ifdef RIPPLED_REPORTING - if (config.reporting() && !config.reportingReadOnly()) // use pg - { - initSchema(pgPool_); - } -#endif - } - - void - stop() override - { -#ifdef RIPPLED_REPORTING - pgPool_->stop(); -#endif - } - - void - sweep() override; - - std::optional - getMinLedgerSeq() override; - - std::optional - getMaxLedgerSeq() override; - - std::string - getCompleteLedgers() override; - - std::chrono::seconds - getValidatedLedgerAge() override; - - bool - writeLedgerAndTransactions( - LedgerInfo const& info, - std::vector const& accountTxData) override; - - std::optional - getLedgerInfoByIndex(LedgerIndex ledgerSeq) override; - - std::optional - getNewestLedgerInfo() override; - - std::optional - getLedgerInfoByHash(uint256 const& ledgerHash) override; - - uint256 - getHashByIndex(LedgerIndex ledgerIndex) override; - - std::optional - getHashesByIndex(LedgerIndex ledgerIndex) override; - - std::map - getHashesByIndex(LedgerIndex minSeq, LedgerIndex maxSeq) override; - - std::vector - getTxHashes(LedgerIndex seq) override; - - std::vector> - getTxHistory(LedgerIndex startIndex) override; - - std::pair - getAccountTx(AccountTxArgs const& args) override; - - Transaction::Locator - locateTransaction(uint256 const& id) override; - - bool - ledgerDbHasSpace(Config const& config) override; - - bool - transactionDbHasSpace(Config const& config) override; - - bool - isCaughtUp(std::string& reason) override; - -private: - Application& app_; - beast::Journal j_; - std::shared_ptr pgPool_; - - bool - dbHasSpace(Config const& config); -}; - -void -RelationalDBInterfacePostgresImp::sweep() -{ -#ifdef RIPPLED_REPORTING - pgPool_->idleSweeper(); -#endif -} - -std::optional -RelationalDBInterfacePostgresImp::getMinLedgerSeq() -{ - return ripple::getMinLedgerSeq(pgPool_, j_); -} - -std::optional -RelationalDBInterfacePostgresImp::getMaxLedgerSeq() -{ - return ripple::getMaxLedgerSeq(pgPool_); -} - -std::string -RelationalDBInterfacePostgresImp::getCompleteLedgers() -{ - return ripple::getCompleteLedgers(pgPool_); -} - -std::chrono::seconds -RelationalDBInterfacePostgresImp::getValidatedLedgerAge() -{ - return ripple::getValidatedLedgerAge(pgPool_, j_); -} - -bool -RelationalDBInterfacePostgresImp::writeLedgerAndTransactions( - LedgerInfo const& info, - std::vector const& accountTxData) -{ - return ripple::writeLedgerAndTransactions(pgPool_, info, accountTxData, j_); -} - -std::optional -RelationalDBInterfacePostgresImp::getLedgerInfoByIndex(LedgerIndex ledgerSeq) -{ - return ripple::getLedgerInfoByIndex(pgPool_, ledgerSeq, app_); -} - -std::optional -RelationalDBInterfacePostgresImp::getNewestLedgerInfo() -{ - return ripple::getNewestLedgerInfo(pgPool_, app_); -} - -std::optional -RelationalDBInterfacePostgresImp::getLedgerInfoByHash(uint256 const& ledgerHash) -{ - return ripple::getLedgerInfoByHash(pgPool_, ledgerHash, app_); -} - -uint256 -RelationalDBInterfacePostgresImp::getHashByIndex(LedgerIndex ledgerIndex) -{ - return ripple::getHashByIndex(pgPool_, ledgerIndex, app_); -} - -std::optional -RelationalDBInterfacePostgresImp::getHashesByIndex(LedgerIndex ledgerIndex) -{ - LedgerHashPair p; - if (!ripple::getHashesByIndex( - pgPool_, ledgerIndex, p.ledgerHash, p.parentHash, app_)) - return {}; - return p; -} - -std::map -RelationalDBInterfacePostgresImp::getHashesByIndex( - LedgerIndex minSeq, - LedgerIndex maxSeq) -{ - return ripple::getHashesByIndex(pgPool_, minSeq, maxSeq, app_); -} - -std::vector -RelationalDBInterfacePostgresImp::getTxHashes(LedgerIndex seq) -{ - return ripple::getTxHashes(pgPool_, seq, app_); -} - -std::vector> -RelationalDBInterfacePostgresImp::getTxHistory(LedgerIndex startIndex) -{ - return ripple::getTxHistory(pgPool_, startIndex, app_, j_); -} - -std::pair -RelationalDBInterfacePostgresImp::getAccountTx(AccountTxArgs const& args) -{ - return ripple::getAccountTx(pgPool_, args, app_, j_); -} - -Transaction::Locator -RelationalDBInterfacePostgresImp::locateTransaction(uint256 const& id) -{ - return ripple::locateTransaction(pgPool_, id, app_); -} - -bool -RelationalDBInterfacePostgresImp::dbHasSpace(Config const& config) -{ - /* Postgres server could be running on a different machine. */ - - return true; -} - -bool -RelationalDBInterfacePostgresImp::ledgerDbHasSpace(Config const& config) -{ - return dbHasSpace(config); -} - -bool -RelationalDBInterfacePostgresImp::transactionDbHasSpace(Config const& config) -{ - return dbHasSpace(config); -} - -std::unique_ptr -getRelationalDBInterfacePostgres( - Application& app, - Config const& config, - JobQueue& jobQueue) -{ - return std::make_unique( - app, config, jobQueue); -} -bool -RelationalDBInterfacePostgresImp::isCaughtUp(std::string& reason) -{ -#ifdef RIPPLED_REPORTING - using namespace std::chrono_literals; - auto age = PgQuery(pgPool_)("SELECT age()"); - if (!age || age.isNull()) - { - reason = "No ledgers in database"; - return false; - } - if (std::chrono::seconds{age.asInt()} > 3min) - { - reason = "No recently-published ledger"; - return false; - } -#endif - return true; -} - -} // namespace ripple diff --git a/src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.h b/src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.h deleted file mode 100644 index 085f59628d1..00000000000 --- a/src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.h +++ /dev/null @@ -1,302 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACESQLITE_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACESQLITE_H_INCLUDED - -#include - -namespace ripple { - -class RelationalDBInterfaceSqlite : public RelationalDBInterface -{ -public: - /** - * @brief getTransactionsMinLedgerSeq Returns minimum ledger sequence - * among records in the Transactions table. - * @return Ledger sequence or none if no ledgers exist. - */ - virtual std::optional - getTransactionsMinLedgerSeq() = 0; - - /** - * @brief getAccountTransactionsMinLedgerSeq Returns minimum ledger - * sequence among records in the AccountTransactions table. - * @return Ledger sequence or none if no ledgers exist. - */ - virtual std::optional - getAccountTransactionsMinLedgerSeq() = 0; - - /** - * @brief deleteTransactionByLedgerSeq Deletes transactions from ledger - * with given sequence. - * @param ledgerSeq Ledger sequence. - */ - virtual void - deleteTransactionByLedgerSeq(LedgerIndex ledgerSeq) = 0; - - /** - * @brief deleteBeforeLedgerSeq Deletes all ledgers with given sequence - * and all sequences below it. - * @param ledgerSeq Ledger sequence. - */ - virtual void - deleteBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; - - /** - * @brief deleteTransactionsBeforeLedgerSeq Deletes all transactions with - * given ledger sequence and all sequences below it. - * @param ledgerSeq Ledger sequence. - */ - virtual void - deleteTransactionsBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; - - /** - * @brief deleteAccountTransactionsBeforeLedgerSeq Deletes all account - * transactions with given ledger sequence and all sequences - * below it. - * @param ledgerSeq Ledger sequence. - */ - virtual void - deleteAccountTransactionsBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; - - /** - * @brief getTransactionCount Returns number of transactions. - * @return Number of transactions. - */ - virtual std::size_t - getTransactionCount() = 0; - - /** - * @brief getAccountTransactionCount Returns number of account - * transactions. - * @return Number of account transactions. - */ - virtual std::size_t - getAccountTransactionCount() = 0; - - /** - * @brief getLedgerCountMinMax Returns minumum ledger sequence, - * maximum ledger sequence and total number of saved ledgers. - * @return Struct CountMinMax which contain minimum sequence, - * maximum sequence and number of ledgers. - */ - virtual struct CountMinMax - getLedgerCountMinMax() = 0; - - /** - * @brief saveValidatedLedger Saves ledger into database. - * @param ledger The ledger. - * @param current True if ledger is current. - * @return True is saving was successfull. - */ - virtual bool - saveValidatedLedger( - std::shared_ptr const& ledger, - bool current) = 0; - - /** - * @brief getLimitedOldestLedgerInfo Returns info of oldest ledger - * from ledgers with sequences greater or equal to given. - * @param ledgerFirstIndex Minimum ledger sequence. - * @return Ledger info or none if ledger not found. - */ - virtual std::optional - getLimitedOldestLedgerInfo(LedgerIndex ledgerFirstIndex) = 0; - - /** - * @brief getLimitedNewestLedgerInfo Returns info of newest ledger - * from ledgers with sequences greater or equal to given. - * @param ledgerFirstIndex Minimum ledger sequence. - * @return Ledger info or none if ledger not found. - */ - virtual std::optional - getLimitedNewestLedgerInfo(LedgerIndex ledgerFirstIndex) = 0; - - /** - * @brief getOldestAccountTxs Returns oldest transactions for given - * account which match given criteria starting from given offset. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. - * @return Vector of pairs of found transactions and their metadata - * sorted in ascending order by account sequence. - */ - virtual AccountTxs - getOldestAccountTxs(AccountTxOptions const& options) = 0; - - /** - * @brief getNewestAccountTxs Returns newest transactions for given - * account which match given criteria starting from given offset. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. - * @return Vector of pairs of found transactions and their metadata - * sorted in descending order by account sequence. - */ - virtual AccountTxs - getNewestAccountTxs(AccountTxOptions const& options) = 0; - - /** - * @brief getOldestAccountTxsB Returns oldest transactions in binary form - * for given account which match given criteria starting from given - * offset. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. - * @return Vector of tuples of found transactions, their metadata and - * account sequences sorted in ascending order by account sequence. - */ - virtual MetaTxsList - getOldestAccountTxsB(AccountTxOptions const& options) = 0; - - /** - * @brief getNewestAccountTxsB Returns newest transactions in binary form - * for given account which match given criteria starting from given - * offset. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. - * @return Vector of tuples of found transactions, their metadata and - * account sequences sorted in descending order by account - * sequence. - */ - virtual MetaTxsList - getNewestAccountTxsB(AccountTxOptions const& options) = 0; - - /** - * @brief oldestAccountTxPage Returns oldest transactions for given - * account which match given criteria starting from given marker. - * @param options Struct AccountTxPageOptions which contain criteria to - * match: the account, minimum and maximum ledger numbers to search, - * marker of first returned entry, number of transactions to return, - * flag if this number unlimited. - * @return Vector of pairs of found transactions and their metadata - * sorted in ascending order by account sequence and marker - * for next search if search not finished. - */ - virtual std::pair> - oldestAccountTxPage(AccountTxPageOptions const& options) = 0; - - /** - * @brief newestAccountTxPage Returns newest transactions for given - * account which match given criteria starting from given marker. - * @param options Struct AccountTxPageOptions which contain criteria to - * match: the account, minimum and maximum ledger numbers to search, - * marker of first returned entry, number of transactions to return, - * flag if this number unlimited. - * @return Vector of pairs of found transactions and their metadata - * sorted in descending order by account sequence and marker - * for next search if search not finished. - */ - virtual std::pair> - newestAccountTxPage(AccountTxPageOptions const& options) = 0; - - /** - * @brief oldestAccountTxPageB Returns oldest transactions in binary form - * for given account which match given criteria starting from given - * marker. - * @param options Struct AccountTxPageOptions which contain criteria to - * match: the account, minimum and maximum ledger numbers to search, - * marker of first returned entry, number of transactions to return, - * flag if this number unlimited. - * @return Vector of tuples of found transactions, their metadata and - * account sequences sorted in ascending order by account - * sequence and marker for next search if search not finished. - */ - virtual std::pair> - oldestAccountTxPageB(AccountTxPageOptions const& options) = 0; - - /** - * @brief newestAccountTxPageB Returns newest transactions in binary form - * for given account which match given criteria starting from given - * marker. - * @param options Struct AccountTxPageOptions which contain criteria to - * match: the account, minimum and maximum ledger numbers to search, - * marker of first returned entry, number of transactions to return, - * flag if this number unlimited. - * @return Vector of tuples of found transactions, their metadata and - * account sequences sorted in descending order by account - * sequence and marker for next search if search not finished. - */ - virtual std::pair> - newestAccountTxPageB(AccountTxPageOptions const& options) = 0; - - /** - * @brief getTransaction Returns transaction with given hash. If not found - * and range given then check if all ledgers from the range are - * present in the database. - * @param id Hash of the transaction. - * @param range Range of ledgers to check, if present. - * @param ec Default value of error code. - * @return Transaction and its metadata if found, TxSearched::all if range - * given and all ledgers from range are present in the database, - * TxSearched::some if range given and not all ledgers are present, - * TxSearched::unknown if range not given or deserializing error - * occured. In the last case error code returned via ec link - * parameter, in other cases default error code not changed. - */ - virtual std::variant - getTransaction( - uint256 const& id, - std::optional> const& range, - error_code_i& ec) = 0; - - /** - * @brief getKBUsedAll Returns space used by all databases. - * @return Space in kilobytes. - */ - virtual uint32_t - getKBUsedAll() = 0; - - /** - * @brief getKBUsedLedger Returns space used by ledger database. - * @return Space in kilobytes. - */ - virtual uint32_t - getKBUsedLedger() = 0; - - /** - * @brief getKBUsedTransaction Returns space used by transaction - * database. - * @return Space in kilobytes. - */ - virtual uint32_t - getKBUsedTransaction() = 0; - - /** - * @brief Closes the ledger database - */ - virtual void - closeLedgerDB() = 0; - - /** - * @brief Closes the transaction database - */ - virtual void - closeTransactionDB() = 0; -}; - -} // namespace ripple - -#endif diff --git a/src/ripple/app/rdb/backend/SQLiteDatabase.h b/src/ripple/app/rdb/backend/SQLiteDatabase.h new file mode 100644 index 00000000000..07f9be3e228 --- /dev/null +++ b/src/ripple/app/rdb/backend/SQLiteDatabase.h @@ -0,0 +1,313 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2020 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_BACKEND_SQLITEDATABASE_H_INCLUDED +#define RIPPLE_APP_RDB_BACKEND_SQLITEDATABASE_H_INCLUDED + +#include + +namespace ripple { + +class SQLiteDatabase : public RelationalDatabase +{ +public: + /** + * @brief getTransactionsMinLedgerSeq Returns the minimum ledger sequence + * stored in the Transactions table. + * @return Ledger sequence or no value if no ledgers exist. + */ + virtual std::optional + getTransactionsMinLedgerSeq() = 0; + + /** + * @brief getAccountTransactionsMinLedgerSeq Returns the minimum ledger + * sequence stored in the AccountTransactions table. + * @return Ledger sequence or no value if no ledgers exist. + */ + virtual std::optional + getAccountTransactionsMinLedgerSeq() = 0; + + /** + * @brief deleteTransactionByLedgerSeq Deletes transactions from the ledger + * with the given sequence. + * @param ledgerSeq Ledger sequence. + */ + virtual void + deleteTransactionByLedgerSeq(LedgerIndex ledgerSeq) = 0; + + /** + * @brief deleteBeforeLedgerSeq Deletes all ledgers with a sequence number + * less than or equal to the given ledger sequence. + * @param ledgerSeq Ledger sequence. + */ + virtual void + deleteBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; + + /** + * @brief deleteTransactionsBeforeLedgerSeq Deletes all transactions with + * a sequence number less than or equal to the given ledger + * sequence. + * @param ledgerSeq Ledger sequence. + */ + virtual void + deleteTransactionsBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; + + /** + * @brief deleteAccountTransactionsBeforeLedgerSeq Deletes all account + * transactions with a sequence number less than or equal to the + * given ledger sequence. + * @param ledgerSeq Ledger sequence. + */ + virtual void + deleteAccountTransactionsBeforeLedgerSeq(LedgerIndex ledgerSeq) = 0; + + /** + * @brief getTransactionCount Returns the number of transactions. + * @return Number of transactions. + */ + virtual std::size_t + getTransactionCount() = 0; + + /** + * @brief getAccountTransactionCount Returns the number of account + * transactions. + * @return Number of account transactions. + */ + virtual std::size_t + getAccountTransactionCount() = 0; + + /** + * @brief getLedgerCountMinMax Returns the minimum ledger sequence, + * maximum ledger sequence and total number of saved ledgers. + * @return Struct CountMinMax which contains the minimum sequence, + * maximum sequence and number of ledgers. + */ + virtual struct CountMinMax + getLedgerCountMinMax() = 0; + + /** + * @brief saveValidatedLedger Saves a ledger into the database. + * @param ledger The ledger. + * @param current True if the ledger is current. + * @return True if saving was successful. + */ + virtual bool + saveValidatedLedger( + std::shared_ptr const& ledger, + bool current) = 0; + + /** + * @brief getLimitedOldestLedgerInfo Returns the info of the oldest ledger + * whose sequence number is greater than or equal to the given + * sequence number. + * @param ledgerFirstIndex Minimum ledger sequence. + * @return Ledger info if found, otherwise no value. + */ + virtual std::optional + getLimitedOldestLedgerInfo(LedgerIndex ledgerFirstIndex) = 0; + + /** + * @brief getLimitedNewestLedgerInfo Returns the info of the newest ledger + * whose sequence number is greater than or equal to the given + * sequence number. + * @param ledgerFirstIndex Minimum ledger sequence. + * @return Ledger info if found, otherwise no value. + */ + virtual std::optional + getLimitedNewestLedgerInfo(LedgerIndex ledgerFirstIndex) = 0; + + /** + * @brief getOldestAccountTxs Returns the oldest transactions for the + * account that matches the given criteria starting from the provided + * offset. + * @param options Struct AccountTxOptions which contains the criteria to + * match: the account, ledger search range, the offset of the first + * entry to return, the number of transactions to return, a flag if + * this number is unlimited. + * @return Vector of pairs of found transactions and their metadata + * sorted in ascending order by account sequence. + */ + virtual AccountTxs + getOldestAccountTxs(AccountTxOptions const& options) = 0; + + /** + * @brief getNewestAccountTxs Returns the newest transactions for the + * account that matches the given criteria starting from the provided + * offset. + * @param options Struct AccountTxOptions which contains the criteria to + * match: the account, the ledger search range, the offset of the + * first entry to return, the number of transactions to return, a + * flag if this number unlimited. + * @return Vector of pairs of found transactions and their metadata + * sorted in descending order by account sequence. + */ + virtual AccountTxs + getNewestAccountTxs(AccountTxOptions const& options) = 0; + + /** + * @brief getOldestAccountTxsB Returns the oldest transactions in binary + * form for the account that matches the given criteria starting from + * the provided offset. + * @param options Struct AccountTxOptions which contains the criteria to + * match: the account, the ledger search range, the offset of the + * first entry to return, the number of transactions to return, a + * flag if this number unlimited. + * @return Vector of tuples of found transactions, their metadata and + * account sequences sorted in ascending order by account sequence. + */ + virtual MetaTxsList + getOldestAccountTxsB(AccountTxOptions const& options) = 0; + + /** + * @brief getNewestAccountTxsB Returns the newest transactions in binary + * form for the account that matches the given criteria starting from + * the provided offset. + * @param options Struct AccountTxOptions which contains the criteria to + * match: the account, the ledger search range, the offset of the + * first entry to return, the number of transactions to return, a + * flag if this number is unlimited. + * @return Vector of tuples of found transactions, their metadata and + * account sequences sorted in descending order by account + * sequence. + */ + virtual MetaTxsList + getNewestAccountTxsB(AccountTxOptions const& options) = 0; + + /** + * @brief oldestAccountTxPage Returns the oldest transactions for the + * account that matches the given criteria starting from the + * provided marker. + * @param options Struct AccountTxPageOptions which contains the criteria to + * match: the account, the ledger search range, the marker of first + * returned entry, the number of transactions to return, a flag if + * this number is unlimited. + * @return Vector of pairs of found transactions and their metadata + * sorted in ascending order by account sequence and a marker + * for the next search if the search was not finished. + */ + virtual std::pair> + oldestAccountTxPage(AccountTxPageOptions const& options) = 0; + + /** + * @brief newestAccountTxPage Returns the newest transactions for the + * account that matches the given criteria starting from the provided + * marker. + * @param options Struct AccountTxPageOptions which contains the criteria to + * match: the account, the ledger search range, the marker of the + * first returned entry, the number of transactions to return, a flag + * if this number unlimited. + * @return Vector of pairs of found transactions and their metadata + * sorted in descending order by account sequence and a marker + * for the next search if the search was not finished. + */ + virtual std::pair> + newestAccountTxPage(AccountTxPageOptions const& options) = 0; + + /** + * @brief oldestAccountTxPageB Returns the oldest transactions in binary + * form for the account that matches the given criteria starting from + * the provided marker. + * @param options Struct AccountTxPageOptions which contains criteria to + * match: the account, the ledger search range, the marker of the + * first returned entry, the number of transactions to return, a flag + * if this number unlimited. + * @return Vector of tuples of found transactions, their metadata and + * account sequences sorted in ascending order by account + * sequence and a marker for the next search if the search was not + * finished. + */ + virtual std::pair> + oldestAccountTxPageB(AccountTxPageOptions const& options) = 0; + + /** + * @brief newestAccountTxPageB Returns the newest transactions in binary + * form for the account that matches the given criteria starting from + * the provided marker. + * @param options Struct AccountTxPageOptions which contains the criteria to + * match: the account, the ledger search range, the marker of the + * first returned entry, the number of transactions to return, a flag + * if this number is unlimited. + * @return Vector of tuples of found transactions, their metadata and + * account sequences sorted in descending order by account + * sequence and a marker for the next search if the search was not + * finished. + */ + virtual std::pair> + newestAccountTxPageB(AccountTxPageOptions const& options) = 0; + + /** + * @brief getTransaction Returns the transaction with the given hash. If a + * range is provided but the transaction is not found, then check if + * all ledgers in the range are present in the database. + * @param id Hash of the transaction. + * @param range Range of ledgers to check, if present. + * @param ec Default error code value. + * @return Transaction and its metadata if found, otherwise TxSearched::all + * if a range is provided and all ledgers from the range are present + * in the database, TxSearched::some if a range is provided and not + * all ledgers are present, TxSearched::unknown if the range is not + * provided or a deserializing error occurred. In the last case the + * error code is returned via the ec parameter, in other cases the + * default error code is not changed. + */ + virtual std::variant + getTransaction( + uint256 const& id, + std::optional> const& range, + error_code_i& ec) = 0; + + /** + * @brief getKBUsedAll Returns the amount of space used by all databases. + * @return Space in kilobytes. + */ + virtual uint32_t + getKBUsedAll() = 0; + + /** + * @brief getKBUsedLedger Returns the amount of space space used by the + * ledger database. + * @return Space in kilobytes. + */ + virtual uint32_t + getKBUsedLedger() = 0; + + /** + * @brief getKBUsedTransaction Returns the amount of space used by the + * transaction database. + * @return Space in kilobytes. + */ + virtual uint32_t + getKBUsedTransaction() = 0; + + /** + * @brief Closes the ledger database + */ + virtual void + closeLedgerDB() = 0; + + /** + * @brief Closes the transaction database + */ + virtual void + closeTransactionDB() = 0; +}; + +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/RelationalDBInterface_nodes.h b/src/ripple/app/rdb/backend/detail/Node.h similarity index 94% rename from src/ripple/app/rdb/RelationalDBInterface_nodes.h rename to src/ripple/app/rdb/backend/detail/Node.h index 338e94fb2a7..fa7e39c8329 100644 --- a/src/ripple/app/rdb/RelationalDBInterface_nodes.h +++ b/src/ripple/app/rdb/backend/detail/Node.h @@ -17,18 +17,19 @@ */ //============================================================================== -#ifndef RIPPLE_CORE_RELATIONALDBINTERFACE_NODES_H_INCLUDED -#define RIPPLE_CORE_RELATIONALDBINTERFACE_NODES_H_INCLUDED +#ifndef RIPPLE_APP_RDB_BACKEND_DETAIL_NODE_H_INCLUDED +#define RIPPLE_APP_RDB_BACKEND_DETAIL_NODE_H_INCLUDED #include #include -#include +#include #include #include #include #include namespace ripple { +namespace detail { /* Need to change TableTypeCount if TableType is modified. */ enum class TableType { Ledgers, Transactions, AccountTransactions }; @@ -116,7 +117,7 @@ getRows(soci::session& session, TableType type); * @return Struct CountMinMax which contain minimum sequence, * maximum sequence and number of rows. */ -RelationalDBInterface::CountMinMax +RelationalDatabase::CountMinMax getRowsMinMax(soci::session& session, TableType type); /** @@ -232,7 +233,7 @@ getHashesByIndex( * @param maxSeq Maximum ledger sequence. * @param j Journal. * @return Map which points sequence number of found ledger to the struct - * LedgerHashPair which contauns ledger hash and its parent hash. + * LedgerHashPair which contains ledger hash and its parent hash. */ std::map getHashesByIndex( @@ -283,12 +284,12 @@ getTxHistory( * skipped. We need to skip some quantity of transactions if option * offset is > 0 in the options structure. */ -std::pair +std::pair getOldestAccountTxs( soci::session& session, Application& app, LedgerMaster& ledgerMaster, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j); @@ -314,12 +315,12 @@ getOldestAccountTxs( * skipped. We need to skip some quantity of transactions if option * offset is > 0 in the options structure. */ -std::pair +std::pair getNewestAccountTxs( soci::session& session, Application& app, LedgerMaster& ledgerMaster, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j); @@ -345,11 +346,11 @@ getNewestAccountTxs( * skipped. We need to skip some quantity of transactions if option * offset is > 0 in the options structure. */ -std::pair, int> +std::pair, int> getOldestAccountTxsB( soci::session& session, Application& app, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j); @@ -375,11 +376,11 @@ getOldestAccountTxsB( * skipped. We need to skip some quantity of transactions if option * offset is > 0 in the options structure. */ -std::pair, int> +std::pair, int> getNewestAccountTxsB( soci::session& session, Application& app, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j); @@ -404,7 +405,7 @@ getNewestAccountTxsB( * sequence and marker for next search if search not finished. * Also number of transactions processed during this call. */ -std::pair, int> +std::pair, int> oldestAccountTxPage( soci::session& session, AccountIDCache const& idCache, @@ -412,7 +413,7 @@ oldestAccountTxPage( std::function< void(std::uint32_t, std::string const&, Blob&&, Blob&&)> const& onTransaction, - RelationalDBInterface::AccountTxPageOptions const& options, + RelationalDatabase::AccountTxPageOptions const& options, int limit_used, std::uint32_t page_length); @@ -437,7 +438,7 @@ oldestAccountTxPage( * sequence and marker for next search if search not finished. * Also number of transactions processed during this call. */ -std::pair, int> +std::pair, int> newestAccountTxPage( soci::session& session, AccountIDCache const& idCache, @@ -445,7 +446,7 @@ newestAccountTxPage( std::function< void(std::uint32_t, std::string const&, Blob&&, Blob&&)> const& onTransaction, - RelationalDBInterface::AccountTxPageOptions const& options, + RelationalDatabase::AccountTxPageOptions const& options, int limit_used, std::uint32_t page_length); @@ -465,7 +466,7 @@ newestAccountTxPage( * occured. In the last case error code modified in ec link * parameter, in other cases default error code remained. */ -std::variant +std::variant getTransaction( soci::session& session, Application& app, @@ -483,6 +484,7 @@ getTransaction( bool dbHasSpace(soci::session& session, Config const& config, beast::Journal j); +} // namespace detail } // namespace ripple #endif diff --git a/src/ripple/app/rdb/backend/detail/Shard.h b/src/ripple/app/rdb/backend/detail/Shard.h new file mode 100644 index 00000000000..ac88c24bd78 --- /dev/null +++ b/src/ripple/app/rdb/backend/detail/Shard.h @@ -0,0 +1,90 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2020 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#ifndef RIPPLE_APP_RDB_BACKEND_DETAIL_SHARD_H_INCLUDED +#define RIPPLE_APP_RDB_BACKEND_DETAIL_SHARD_H_INCLUDED + +#include +#include +#include +#include +#include +#include + +namespace ripple { +namespace detail { + +/** + * @brief makeMetaDBs Opens ledger and transaction 'meta' databases which + * map ledger hashes and transaction IDs to the index of the shard + * that holds the ledger or transaction. + * @param config Config object. + * @param setup Path to database and opening parameters. + * @param checkpointerSetup Database checkpointer setup. + * @return Struct DatabasePair which contains unique pointers to the ledger + * and transaction databases. + */ +DatabasePair +makeMetaDBs( + Config const& config, + DatabaseCon::Setup const& setup, + DatabaseCon::CheckpointerSetup const& checkpointerSetup); + +/** + * @brief saveLedgerMeta Stores (transaction ID -> shard index) and + * (ledger hash -> shard index) mappings in the meta databases. + * @param ledger The ledger. + * @param app Application object. + * @param lgrMetaSession Session to ledger meta database. + * @param txnMetaSession Session to transaction meta database. + * @param shardIndex The index of the shard that contains this ledger. + * @return True on success. + */ +bool +saveLedgerMeta( + std::shared_ptr const& ledger, + Application& app, + soci::session& lgrMetaSession, + soci::session& txnMetaSession, + std::uint32_t shardIndex); + +/** + * @brief getShardIndexforLedger Queries the ledger meta database to + * retrieve the index of the shard that contains this ledger. + * @param session Session to the database. + * @param hash Hash of the ledger. + * @return The index of the shard on success, otherwise an unseated value. + */ +std::optional +getShardIndexforLedger(soci::session& session, LedgerHash const& hash); + +/** + * @brief getShardIndexforTransaction Queries the transaction meta database to + * retrieve the index of the shard that contains this transaction. + * @param session Session to the database. + * @param id ID of the transaction. + * @return The index of the shard on success, otherwise an unseated value. + */ +std::optional +getShardIndexforTransaction(soci::session& session, TxID const& id); + +} // namespace detail +} // namespace ripple + +#endif diff --git a/src/ripple/app/rdb/impl/RelationalDBInterface_nodes.cpp b/src/ripple/app/rdb/backend/detail/impl/Node.cpp similarity index 86% rename from src/ripple/app/rdb/impl/RelationalDBInterface_nodes.cpp rename to src/ripple/app/rdb/backend/detail/impl/Node.cpp index 748265e624b..c51f39826a7 100644 --- a/src/ripple/app/rdb/impl/RelationalDBInterface_nodes.cpp +++ b/src/ripple/app/rdb/backend/detail/impl/Node.cpp @@ -23,8 +23,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include @@ -35,10 +35,11 @@ #include namespace ripple { +namespace detail { /** - * @brief to_string Returns name of table by table ID. - * @param type Table ID. + * @brief to_string Returns the name of a table according to its TableType. + * @param type An enum denoting the table's type. * @return Name of the table. */ static std::string @@ -47,6 +48,7 @@ to_string(TableType type) static_assert( TableTypeCount == 3, "Need to modify switch statement if enum is modified"); + switch (type) { case TableType::Ledgers: @@ -56,7 +58,7 @@ to_string(TableType type) case TableType::AccountTransactions: return "AccountTransactions"; default: - assert(0); + assert(false); return "Unknown"; } } @@ -166,10 +168,10 @@ getRows(soci::session& session, TableType type) return rows; } -RelationalDBInterface::CountMinMax +RelationalDatabase::CountMinMax getRowsMinMax(soci::session& session, TableType type) { - RelationalDBInterface::CountMinMax res; + RelationalDatabase::CountMinMax res; session << "SELECT COUNT(*) AS rows, " "MIN(LedgerSeq) AS first, " "MAX(LedgerSeq) AS last " @@ -379,12 +381,12 @@ saveValidatedLedger( } /** - * @brief getLedgerInfo Returns info of ledger with special condition - * given as SQL query. - * @param session Session with database. - * @param sqlSuffix Special condition for found the ledger. + * @brief getLedgerInfo Returns the info of the ledger retrieved from the + * database by using the provided SQL query suffix. + * @param session Session with the database. + * @param sqlSuffix SQL string used to specify the sought ledger. * @param j Journal. - * @return Ledger info or none if ledger not found. + * @return Ledger info or no value if the ledger was not found. */ static std::optional getLedgerInfo( @@ -675,21 +677,22 @@ getTxHistory( } /** - * @brief transactionsSQL Returns SQL query to select oldest or newest - * transactions in decoded or binary form for given account which - * match given criteria starting from given offset. + * @brief transactionsSQL Returns a SQL query for selecting the oldest or newest + * transactions in decoded or binary form for the account that matches + * the given criteria starting from the provided offset. * @param app Application object. - * @param selection List of table fields to select from database. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. + * @param selection List of table fields to select from the database. + * @param options Struct AccountTxOptions which contains the criteria to match: + * the account, the ledger search range, the offset of the first entry to + * return, the number of transactions to return, and a flag if this + * number is unlimited. * @param limit_used Number of transactions already returned in calls - * to another shard databases, if shard databases are used. - * None if node database is used. + * to other shard databases, if shard databases are used. + * No value if the node database is used. * @param descending True for descending order, false for ascending. * @param binary True for binary form, false for decoded. - * @param count True for count number of transaction, false for select it. + * @param count True for counting the number of transactions, false for + * selecting them. * @param j Journal. * @return SQL query string. */ @@ -697,7 +700,7 @@ static std::string transactionsSQL( Application& app, std::string selection, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, bool descending, bool binary, @@ -782,39 +785,40 @@ transactionsSQL( } /** - * @brief getAccountTxs Returns oldest or newest transactions for given - * account which match given criteria starting from given offset. - * @param session Session with database. + * @brief getAccountTxs Returns the oldest or newest transactions for the + * account that matches the given criteria starting from the provided + * offset. + * @param session Session with the database. * @param app Application object. * @param ledgerMaster LedgerMaster object. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. + * @param options Struct AccountTxOptions which contains the criteria to match: + * the account, the ledger search range, the offset of the first entry to + * return, the number of transactions to return, and a flag if this + * number is unlimited. * @param limit_used Number of transactions already returned in calls - * to another shard databases, if shard databases are used. - * None if node database is used. + * to other shard databases, if shard databases are used. + * No value if the node database is used. * @param descending True for descending order, false for ascending. * @param j Journal. - * @return Vector of pairs of found transactions and its metadata - * sorted in given order by account sequence. - * Also the number of transactions processed or skipped. - * If this number is >= 0, then it means number of transactions - * processed, if it is < 0, then -number means number of transactions - * skipped. We need to skip some quantity of transactions if option - * offset is > 0 in the options structure. + * @return Vector of pairs of found transactions and their metadata sorted by + * account sequence in the specified order along with the number of + * transactions processed or skipped. If this number is >= 0, then it + * represents the number of transactions processed, if it is < 0, then + * -number represents the number of transactions skipped. We need to + * skip some number of transactions if option offset is > 0 in the + * options structure. */ -static std::pair +static std::pair getAccountTxs( soci::session& session, Application& app, LedgerMaster& ledgerMaster, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, bool descending, beast::Journal j) { - RelationalDBInterface::AccountTxs ret; + RelationalDatabase::AccountTxs ret; std::string sql = transactionsSQL( app, @@ -884,7 +888,7 @@ getAccountTxs( if (!total && limit_used) { - RelationalDBInterface::AccountTxOptions opt = options; + RelationalDatabase::AccountTxOptions opt = options; opt.offset = 0; std::string sql1 = transactionsSQL( app, "COUNT(*)", opt, limit_used, descending, false, false, j); @@ -898,12 +902,12 @@ getAccountTxs( return {ret, total}; } -std::pair +std::pair getOldestAccountTxs( soci::session& session, Application& app, LedgerMaster& ledgerMaster, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j) { @@ -911,12 +915,12 @@ getOldestAccountTxs( session, app, ledgerMaster, options, limit_used, false, j); } -std::pair +std::pair getNewestAccountTxs( soci::session& session, Application& app, LedgerMaster& ledgerMaster, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j) { @@ -925,38 +929,38 @@ getNewestAccountTxs( } /** - * @brief getAccountTxsB Returns oldest or newset transactions in binary - * form for given account which match given criteria starting from - * given offset. - * @param session Session with database. + * @brief getAccountTxsB Returns the oldest or newest transactions in binary + * form for the account that matches given criteria starting from + * the provided offset. + * @param session Session with the database. * @param app Application object. - * @param options Struct AccountTxOptions which contain criteria to match: - * the account, minimum and maximum ledger numbers to search, - * offset of first entry to return, number of transactions to return, - * flag if this number unlimited. - * @param limit_used Number or transactions already returned in calls - * to another shard databases, if shard databases are used. - * None if node database is used. + * @param options Struct AccountTxOptions which contains the criteria to match: + * the account, the ledger search range, the offset of the first entry to + * return, the number of transactions to return, and a flag if this + * number is unlimited. + * @param limit_used Number of transactions already returned in calls to other + * shard databases, if shard databases are used. No value if the node + * database is used. * @param descending True for descending order, false for ascending. * @param j Journal. - * @return Vector of tuples of found transactions, its metadata and - * account sequences sorted in given order by account - * sequence. Also number of transactions processed or skipped. - * If this number is >= 0, then it means number of transactions - * processed, if it is < 0, then -number means number of transactions - * skipped. We need to skip some quantity of transactions if option - * offset is > 0 in the options structure. + * @return Vector of tuples each containing (the found transactions, their + * metadata, and their account sequences) sorted by account sequence in + * the specified order along with the number of transactions processed + * or skipped. If this number is >= 0, then it represents the number of + * transactions processed, if it is < 0, then -number represents the + * number of transactions skipped. We need to skip some number of + * transactions if option offset is > 0 in the options structure. */ -static std::pair, int> +static std::pair, int> getAccountTxsB( soci::session& session, Application& app, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, bool descending, beast::Journal j) { - std::vector ret; + std::vector ret; std::string sql = transactionsSQL( app, @@ -1005,7 +1009,7 @@ getAccountTxsB( if (!total && limit_used) { - RelationalDBInterface::AccountTxOptions opt = options; + RelationalDatabase::AccountTxOptions opt = options; opt.offset = 0; std::string sql1 = transactionsSQL( app, "COUNT(*)", opt, limit_used, descending, true, false, j); @@ -1019,22 +1023,22 @@ getAccountTxsB( return {ret, total}; } -std::pair, int> +std::pair, int> getOldestAccountTxsB( soci::session& session, Application& app, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j) { return getAccountTxsB(session, app, options, limit_used, false, j); } -std::pair, int> +std::pair, int> getNewestAccountTxsB( soci::session& session, Application& app, - RelationalDBInterface::AccountTxOptions const& options, + RelationalDatabase::AccountTxOptions const& options, std::optional const& limit_used, beast::Journal j) { @@ -1042,28 +1046,28 @@ getNewestAccountTxsB( } /** - * @brief accountTxPage Searches oldest or newest transactions for given - * account which match given criteria starting from given marker - * and calls callback for each found transaction. - * @param session Session with database. + * @brief accountTxPage Searches for the oldest or newest transactions for the + * account that matches the given criteria starting from the provided + * marker and invokes the callback parameter for each found transaction. + * @param session Session with the database. * @param idCache Account ID cache. * @param onUnsavedLedger Callback function to call on each found unsaved - * ledger within given range. - * @param onTransaction Callback function to call on eahc found transaction. - * @param options Struct AccountTxPageOptions which contain criteria to - * match: the account, minimum and maximum ledger numbers to search, - * marker of first returned entry, number of transactions to return, - * flag if this number unlimited. - * @param limit_used Number or transactions already returned in calls - * to another shard databases. + * ledger within the given range. + * @param onTransaction Callback function to call on each found transaction. + * @param options Struct AccountTxPageOptions which contains the criteria to + * match: the account, the ledger search range, the marker of the first + * returned entry, the number of transactions to return, and a flag if + * this number unlimited. + * @param limit_used Number of transactions already returned in calls + * to other shard databases. * @param page_length Total number of transactions to return. * @param forward True for ascending order, false for descending. - * @return Vector of tuples of found transactions, its metadata and - * account sequences sorted in given order by account - * sequence and marker for next search if search not finished. - * Also number of transactions processed during this call. + * @return Vector of tuples of found transactions, their metadata and account + * sequences sorted in the specified order by account sequence, a marker + * for the next search if the search was not finished and the number of + * transactions processed during this call. */ -static std::pair, int> +static std::pair, int> accountTxPage( soci::session& session, AccountIDCache const& idCache, @@ -1071,7 +1075,7 @@ accountTxPage( std::function< void(std::uint32_t, std::string const&, Blob&&, Blob&&)> const& onTransaction, - RelationalDBInterface::AccountTxPageOptions const& options, + RelationalDatabase::AccountTxPageOptions const& options, int limit_used, std::uint32_t page_length, bool forward) @@ -1106,7 +1110,7 @@ accountTxPage( findSeq = options.marker->txnSeq; } - std::optional newmarker; + std::optional newmarker; if (limit_used > 0) newmarker = options.marker; @@ -1244,7 +1248,7 @@ accountTxPage( return {newmarker, total}; } -std::pair, int> +std::pair, int> oldestAccountTxPage( soci::session& session, AccountIDCache const& idCache, @@ -1252,7 +1256,7 @@ oldestAccountTxPage( std::function< void(std::uint32_t, std::string const&, Blob&&, Blob&&)> const& onTransaction, - RelationalDBInterface::AccountTxPageOptions const& options, + RelationalDatabase::AccountTxPageOptions const& options, int limit_used, std::uint32_t page_length) { @@ -1267,7 +1271,7 @@ oldestAccountTxPage( true); } -std::pair, int> +std::pair, int> newestAccountTxPage( soci::session& session, AccountIDCache const& idCache, @@ -1275,7 +1279,7 @@ newestAccountTxPage( std::function< void(std::uint32_t, std::string const&, Blob&&, Blob&&)> const& onTransaction, - RelationalDBInterface::AccountTxPageOptions const& options, + RelationalDatabase::AccountTxPageOptions const& options, int limit_used, std::uint32_t page_length) { @@ -1290,7 +1294,7 @@ newestAccountTxPage( false); } -std::variant +std::variant getTransaction( soci::session& session, Application& app, @@ -1436,4 +1440,5 @@ dbHasSpace(soci::session& session, Config const& config, beast::Journal j) return true; } +} // namespace detail } // namespace ripple diff --git a/src/ripple/app/rdb/backend/detail/impl/Shard.cpp b/src/ripple/app/rdb/backend/detail/impl/Shard.cpp new file mode 100644 index 00000000000..374c4ae7f67 --- /dev/null +++ b/src/ripple/app/rdb/backend/detail/impl/Shard.cpp @@ -0,0 +1,149 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2020 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include +#include +#include +#include +#include +#include +#include + +namespace ripple { +namespace detail { + +DatabasePair +makeMetaDBs( + Config const& config, + DatabaseCon::Setup const& setup, + DatabaseCon::CheckpointerSetup const& checkpointerSetup) +{ + // ledger meta database + auto lgrMetaDB{std::make_unique( + setup, + LgrMetaDBName, + LgrMetaDBPragma, + LgrMetaDBInit, + checkpointerSetup)}; + + if (!config.useTxTables()) + return {std::move(lgrMetaDB), nullptr}; + + // transaction meta database + auto txMetaDB{std::make_unique( + setup, TxMetaDBName, TxMetaDBPragma, TxMetaDBInit, checkpointerSetup)}; + + return {std::move(lgrMetaDB), std::move(txMetaDB)}; +} + +bool +saveLedgerMeta( + std::shared_ptr const& ledger, + Application& app, + soci::session& lgrMetaSession, + soci::session& txnMetaSession, + std::uint32_t const shardIndex) +{ + std::string_view constexpr lgrSQL = + R"sql(INSERT OR REPLACE INTO LedgerMeta VALUES + (:ledgerHash,:shardIndex);)sql"; + + auto const hash = to_string(ledger->info().hash); + lgrMetaSession << lgrSQL, soci::use(hash), soci::use(shardIndex); + + if (!app.config().useTxTables()) + return true; + + AcceptedLedger::pointer const aLedger = [&app, ledger] { + try + { + auto aLedger = + app.getAcceptedLedgerCache().fetch(ledger->info().hash); + if (!aLedger) + { + aLedger = std::make_shared(ledger, app); + app.getAcceptedLedgerCache().canonicalize_replace_client( + ledger->info().hash, aLedger); + } + + return aLedger; + } + catch (std::exception const&) + { + JLOG(app.journal("Ledger").warn()) + << "An accepted ledger was missing nodes"; + } + + return AcceptedLedger::pointer{nullptr}; + }(); + + if (!aLedger) + return false; + + soci::transaction tr(txnMetaSession); + + for (auto const& [_, acceptedLedgerTx] : aLedger->getMap()) + { + (void)_; + + std::string_view constexpr txnSQL = + R"sql(INSERT OR REPLACE INTO TransactionMeta VALUES + (:transactionID,:shardIndex);)sql"; + + auto const transactionID = + to_string(acceptedLedgerTx->getTransactionID()); + + txnMetaSession << txnSQL, soci::use(transactionID), + soci::use(shardIndex); + } + + tr.commit(); + return true; +} + +std::optional +getShardIndexforLedger(soci::session& session, LedgerHash const& hash) +{ + std::uint32_t shardIndex; + session << "SELECT ShardIndex FROM LedgerMeta WHERE LedgerHash = '" << hash + << "';", + soci::into(shardIndex); + + if (!session.got_data()) + return std::nullopt; + + return shardIndex; +} + +std::optional +getShardIndexforTransaction(soci::session& session, TxID const& id) +{ + std::uint32_t shardIndex; + session << "SELECT ShardIndex FROM TransactionMeta WHERE TransID = '" << id + << "';", + soci::into(shardIndex); + + if (!session.got_data()) + return std::nullopt; + + return shardIndex; +} + +} // namespace detail +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/RelationalDBInterface_postgres.cpp b/src/ripple/app/rdb/backend/impl/PostgresDatabase.cpp similarity index 71% rename from src/ripple/app/rdb/impl/RelationalDBInterface_postgres.cpp rename to src/ripple/app/rdb/backend/impl/PostgresDatabase.cpp index d242c8b4bd4..5ee4ce5519d 100644 --- a/src/ripple/app/rdb/impl/RelationalDBInterface_postgres.cpp +++ b/src/ripple/app/rdb/backend/impl/PostgresDatabase.cpp @@ -1,7 +1,7 @@ //------------------------------------------------------------------------------ /* This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2021 Ripple Labs Inc. + Copyright (c) 2020 Ripple Labs Inc. Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above @@ -17,73 +17,137 @@ */ //============================================================================== -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include #include +#include #include -#include +#include +#include +#include +#include +#include namespace ripple { -using TxnsData = RelationalDBInterface::AccountTxs; -using TxnsDataBinary = RelationalDBInterface::MetaTxsList; +class PgPool; -using LedgerHash = RelationalDBInterface::LedgerHash; -using LedgerSequence = RelationalDBInterface::LedgerSequence; -using LedgerShortcut = RelationalDBInterface::LedgerShortcut; +using AccountTxResult = RelationalDatabase::AccountTxResult; +using TxnsData = RelationalDatabase::AccountTxs; +using TxnsDataBinary = RelationalDatabase::MetaTxsList; -std::optional -getMinLedgerSeq(std::shared_ptr const& pgPool, beast::Journal j) +class PostgresDatabaseImp final : public PostgresDatabase { +public: + PostgresDatabaseImp( + Application& app, + Config const& config, + JobQueue& jobQueue) + : app_(app) + , j_(app_.journal("PgPool")) + , pgPool_( #ifdef RIPPLED_REPORTING - auto seq = PgQuery(pgPool)("SELECT min_ledger()"); - if (!seq) - { - JLOG(j.error()) << "Error querying minimum ledger sequence."; - } - else if (!seq.isNull()) - return seq.asInt(); + make_PgPool(config.section("ledger_tx_tables"), j_) #endif - return {}; -} - -std::optional -getMaxLedgerSeq(std::shared_ptr const& pgPool) -{ + ) + { + assert(config.reporting()); #ifdef RIPPLED_REPORTING - auto seq = PgQuery(pgPool)("SELECT max_ledger()"); - if (seq && !seq.isNull()) - return seq.asBigInt(); + if (config.reporting() && !config.reportingReadOnly()) // use pg + { + initSchema(pgPool_); + } #endif - return {}; -} + } -std::string -getCompleteLedgers(std::shared_ptr const& pgPool) -{ + void + stop() override + { #ifdef RIPPLED_REPORTING - auto range = PgQuery(pgPool)("SELECT complete_ledgers()"); - if (range) - return range.c_str(); + pgPool_->stop(); #endif - return "error"; -} + } -std::chrono::seconds -getValidatedLedgerAge(std::shared_ptr const& pgPool, beast::Journal j) -{ - using namespace std::chrono_literals; -#ifdef RIPPLED_REPORTING - auto age = PgQuery(pgPool)("SELECT age()"); - if (!age || age.isNull()) - JLOG(j.debug()) << "No ledgers in database"; - else - return std::chrono::seconds{age.asInt()}; -#endif - return weeks{2}; -} + void + sweep() override; + + std::optional + getMinLedgerSeq() override; + + std::optional + getMaxLedgerSeq() override; + + std::string + getCompleteLedgers() override; + + std::chrono::seconds + getValidatedLedgerAge() override; + + bool + writeLedgerAndTransactions( + LedgerInfo const& info, + std::vector const& accountTxData) override; + + std::optional + getLedgerInfoByIndex(LedgerIndex ledgerSeq) override; + + std::optional + getNewestLedgerInfo() override; + + std::optional + getLedgerInfoByHash(uint256 const& ledgerHash) override; + + uint256 + getHashByIndex(LedgerIndex ledgerIndex) override; + + std::optional + getHashesByIndex(LedgerIndex ledgerIndex) override; + + std::map + getHashesByIndex(LedgerIndex minSeq, LedgerIndex maxSeq) override; + + std::vector + getTxHashes(LedgerIndex seq) override; + + std::vector> + getTxHistory(LedgerIndex startIndex) override; + + std::pair + getAccountTx(AccountTxArgs const& args) override; + + Transaction::Locator + locateTransaction(uint256 const& id) override; + + bool + ledgerDbHasSpace(Config const& config) override; + + bool + transactionDbHasSpace(Config const& config) override; + + bool + isCaughtUp(std::string& reason) override; + +private: + Application& app_; + beast::Journal j_; + std::shared_ptr pgPool_; + + bool + dbHasSpace(Config const& config); +}; /** - * @brief loadLedgerInfos Load the ledger info for the specified + * @brief loadLedgerInfos Loads the ledger info for the specified * ledger/s from the database * @param pgPool Link to postgres database * @param whichLedger Specifies the ledger to load via ledger sequence, @@ -254,152 +318,30 @@ loadLedgerHelper( return infos[0]; } -std::optional -getNewestLedgerInfo(std::shared_ptr const& pgPool, Application& app) -{ - return loadLedgerHelper(pgPool, {}, app); -} - -std::optional -getLedgerInfoByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - Application& app) -{ - return loadLedgerHelper(pgPool, uint32_t{ledgerIndex}, app); -} - -std::optional -getLedgerInfoByHash( - std::shared_ptr const& pgPool, - uint256 const& ledgerHash, - Application& app) -{ - return loadLedgerHelper(pgPool, uint256{ledgerHash}, app); -} - -uint256 -getHashByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - Application& app) -{ - auto infos = loadLedgerInfos(pgPool, ledgerIndex, app); - assert(infos.size() <= 1); - if (infos.size()) - return infos[0].hash; - return {}; -} - -bool -getHashesByIndex( - std::shared_ptr const& pgPool, - std::uint32_t ledgerIndex, - uint256& ledgerHash, - uint256& parentHash, - Application& app) -{ - auto infos = loadLedgerInfos(pgPool, ledgerIndex, app); - assert(infos.size() <= 1); - if (infos.size()) - { - ledgerHash = infos[0].hash; - parentHash = infos[0].parentHash; - return true; - } - return false; -} - -std::map -getHashesByIndex( - std::shared_ptr const& pgPool, - std::uint32_t minSeq, - std::uint32_t maxSeq, - Application& app) -{ - std::map ret; - auto infos = loadLedgerInfos(pgPool, std::make_pair(minSeq, maxSeq), app); - for (auto& info : infos) - { - ret[info.seq] = {info.hash, info.parentHash}; - } - return ret; -} - -std::vector -getTxHashes( - std::shared_ptr const& pgPool, - LedgerIndex seq, - Application& app) -{ - std::vector nodestoreHashes; - #ifdef RIPPLED_REPORTING - auto log = app.journal("Ledger"); - - std::string query = - "SELECT nodestore_hash" - " FROM transactions " - " WHERE ledger_seq = " + - std::to_string(seq); - auto res = PgQuery(pgPool)(query.c_str()); - - if (!res) - { - JLOG(log.error()) << __func__ - << " : Postgres response is null - query = " << query; - assert(false); - return {}; - } - else if (res.status() != PGRES_TUPLES_OK) - { - JLOG(log.error()) << __func__ - << " : Postgres response should have been " - "PGRES_TUPLES_OK but instead was " - << res.status() << " - msg = " << res.msg() - << " - query = " << query; - assert(false); - return {}; - } - - JLOG(log.trace()) << __func__ << " Postgres result msg : " << res.msg(); - - if (res.isNull() || res.ntuples() == 0) - { - JLOG(log.debug()) << __func__ - << " : Ledger not found. query = " << query; - return {}; - } - else if (res.ntuples() > 0) - { - if (res.nfields() != 1) - { - JLOG(log.error()) << __func__ - << " : Wrong number of fields in Postgres " - "response. Expected 1, but got " - << res.nfields() << " . query = " << query; - assert(false); - return {}; - } - } +static bool +writeToLedgersDB(LedgerInfo const& info, PgQuery& pgQuery, beast::Journal& j) +{ + JLOG(j.debug()) << __func__; + auto cmd = boost::format( + R"(INSERT INTO ledgers + VALUES (%u,'\x%s', '\x%s',%u,%u,%u,%u,%u,'\x%s','\x%s'))"); - JLOG(log.trace()) << __func__ << " : result = " << res.c_str() - << " : query = " << query; - for (size_t i = 0; i < res.ntuples(); ++i) - { - char const* nodestoreHash = res.c_str(i, 0); - uint256 hash; - if (!hash.parseHex(nodestoreHash + 2)) - assert(false); + auto ledgerInsert = boost::str( + cmd % info.seq % strHex(info.hash) % strHex(info.parentHash) % + info.drops.drops() % info.closeTime.time_since_epoch().count() % + info.parentCloseTime.time_since_epoch().count() % + info.closeTimeResolution.count() % info.closeFlags % + strHex(info.accountHash) % strHex(info.txHash)); + JLOG(j.trace()) << __func__ << " : " + << " : " + << "query string = " << ledgerInsert; - nodestoreHashes.push_back(hash); - } -#endif + auto res = pgQuery(ledgerInsert.data()); - return nodestoreHashes; + return res; } -#ifdef RIPPLED_REPORTING enum class DataFormat { binary, expanded }; static std::variant flatFetchTransactions( @@ -448,7 +390,7 @@ flatFetchTransactions( static std::pair processAccountTxStoredProcedureResult( - AccountTxArgs const& args, + RelationalDatabase::AccountTxArgs const& args, Json::Value& result, Application& app, beast::Journal j) @@ -538,36 +480,392 @@ processAccountTxStoredProcedureResult( } #endif -std::pair -getAccountTx( - std::shared_ptr const& pgPool, - AccountTxArgs const& args, - Application& app, - beast::Journal j) +void +PostgresDatabaseImp::sweep() { #ifdef RIPPLED_REPORTING - pg_params dbParams; + pgPool_->idleSweeper(); +#endif +} - char const*& command = dbParams.first; - std::vector>& values = dbParams.second; - command = - "SELECT account_tx($1::bytea, $2::bool, " - "$3::bigint, $4::bigint, $5::bigint, $6::bytea, " - "$7::bigint, $8::bool, $9::bigint, $10::bigint)"; - values.resize(10); - values[0] = "\\x" + strHex(args.account); - values[1] = args.forward ? "true" : "false"; +std::optional +PostgresDatabaseImp::getMinLedgerSeq() +{ +#ifdef RIPPLED_REPORTING + auto seq = PgQuery(pgPool_)("SELECT min_ledger()"); + if (!seq) + { + JLOG(j_.error()) << "Error querying minimum ledger sequence."; + } + else if (!seq.isNull()) + return seq.asInt(); +#endif + return {}; +} - static std::uint32_t const page_length(200); - if (args.limit == 0 || args.limit > page_length) - values[2] = std::to_string(page_length); +std::optional +PostgresDatabaseImp::getMaxLedgerSeq() +{ +#ifdef RIPPLED_REPORTING + auto seq = PgQuery(pgPool_)("SELECT max_ledger()"); + if (seq && !seq.isNull()) + return seq.asBigInt(); +#endif + return {}; +} + +std::string +PostgresDatabaseImp::getCompleteLedgers() +{ +#ifdef RIPPLED_REPORTING + auto range = PgQuery(pgPool_)("SELECT complete_ledgers()"); + if (range) + return range.c_str(); +#endif + return "error"; +} + +std::chrono::seconds +PostgresDatabaseImp::getValidatedLedgerAge() +{ + using namespace std::chrono_literals; +#ifdef RIPPLED_REPORTING + auto age = PgQuery(pgPool_)("SELECT age()"); + if (!age || age.isNull()) + JLOG(j_.debug()) << "No ledgers in database"; else - values[2] = std::to_string(args.limit); + return std::chrono::seconds{age.asInt()}; +#endif + return weeks{2}; +} - if (args.ledger) +bool +PostgresDatabaseImp::writeLedgerAndTransactions( + LedgerInfo const& info, + std::vector const& accountTxData) +{ +#ifdef RIPPLED_REPORTING + JLOG(j_.debug()) << __func__ << " : " + << "Beginning write to Postgres"; + + try { - if (auto range = std::get_if(&args.ledger.value())) - { + // Create a PgQuery object to run multiple commands over the same + // connection in a single transaction block. + PgQuery pg(pgPool_); + auto res = pg("BEGIN"); + if (!res || res.status() != PGRES_COMMAND_OK) + { + std::stringstream msg; + msg << "bulkWriteToTable : Postgres insert error: " << res.msg(); + Throw(msg.str()); + } + + // Writing to the ledgers db fails if the ledger already exists in the + // db. In this situation, the ETL process has detected there is another + // writer, and falls back to only publishing + if (!writeToLedgersDB(info, pg, j_)) + { + JLOG(j_.warn()) << __func__ << " : " + << "Failed to write to ledgers database."; + return false; + } + + std::stringstream transactionsCopyBuffer; + std::stringstream accountTransactionsCopyBuffer; + for (auto const& data : accountTxData) + { + std::string txHash = strHex(data.txHash); + std::string nodestoreHash = strHex(data.nodestoreHash); + auto idx = data.transactionIndex; + auto ledgerSeq = data.ledgerSequence; + + transactionsCopyBuffer << std::to_string(ledgerSeq) << '\t' + << std::to_string(idx) << '\t' << "\\\\x" + << txHash << '\t' << "\\\\x" << nodestoreHash + << '\n'; + + for (auto const& a : data.accounts) + { + std::string acct = strHex(a); + accountTransactionsCopyBuffer + << "\\\\x" << acct << '\t' << std::to_string(ledgerSeq) + << '\t' << std::to_string(idx) << '\n'; + } + } + + pg.bulkInsert("transactions", transactionsCopyBuffer.str()); + pg.bulkInsert( + "account_transactions", accountTransactionsCopyBuffer.str()); + + res = pg("COMMIT"); + if (!res || res.status() != PGRES_COMMAND_OK) + { + std::stringstream msg; + msg << "bulkWriteToTable : Postgres insert error: " << res.msg(); + assert(false); + Throw(msg.str()); + } + + JLOG(j_.info()) << __func__ << " : " + << "Successfully wrote to Postgres"; + return true; + } + catch (std::exception& e) + { + JLOG(j_.error()) << __func__ + << "Caught exception writing to Postgres : " + << e.what(); + assert(false); + return false; + } +#else + return false; +#endif +} + +std::optional +PostgresDatabaseImp::getLedgerInfoByIndex(LedgerIndex ledgerSeq) +{ + return loadLedgerHelper(pgPool_, ledgerSeq, app_); +} + +std::optional +PostgresDatabaseImp::getNewestLedgerInfo() +{ + return loadLedgerHelper(pgPool_, {}, app_); +} + +std::optional +PostgresDatabaseImp::getLedgerInfoByHash(uint256 const& ledgerHash) +{ + return loadLedgerHelper(pgPool_, ledgerHash, app_); +} + +uint256 +PostgresDatabaseImp::getHashByIndex(LedgerIndex ledgerIndex) +{ + auto infos = loadLedgerInfos(pgPool_, ledgerIndex, app_); + assert(infos.size() <= 1); + if (infos.size()) + return infos[0].hash; + return {}; +} + +std::optional +PostgresDatabaseImp::getHashesByIndex(LedgerIndex ledgerIndex) +{ + LedgerHashPair p; + auto infos = loadLedgerInfos(pgPool_, ledgerIndex, app_); + assert(infos.size() <= 1); + if (infos.size()) + { + p.ledgerHash = infos[0].hash; + p.parentHash = infos[0].parentHash; + return p; + } + return {}; +} + +std::map +PostgresDatabaseImp::getHashesByIndex(LedgerIndex minSeq, LedgerIndex maxSeq) +{ + std::map ret; + auto infos = loadLedgerInfos(pgPool_, std::make_pair(minSeq, maxSeq), app_); + for (auto& info : infos) + { + ret[info.seq] = {info.hash, info.parentHash}; + } + return ret; +} + +std::vector +PostgresDatabaseImp::getTxHashes(LedgerIndex seq) +{ + std::vector nodestoreHashes; + +#ifdef RIPPLED_REPORTING + auto log = app_.journal("Ledger"); + + std::string query = + "SELECT nodestore_hash" + " FROM transactions " + " WHERE ledger_seq = " + + std::to_string(seq); + auto res = PgQuery(pgPool_)(query.c_str()); + + if (!res) + { + JLOG(log.error()) << __func__ + << " : Postgres response is null - query = " << query; + assert(false); + return {}; + } + else if (res.status() != PGRES_TUPLES_OK) + { + JLOG(log.error()) << __func__ + << " : Postgres response should have been " + "PGRES_TUPLES_OK but instead was " + << res.status() << " - msg = " << res.msg() + << " - query = " << query; + assert(false); + return {}; + } + + JLOG(log.trace()) << __func__ << " Postgres result msg : " << res.msg(); + + if (res.isNull() || res.ntuples() == 0) + { + JLOG(log.debug()) << __func__ + << " : Ledger not found. query = " << query; + return {}; + } + else if (res.ntuples() > 0) + { + if (res.nfields() != 1) + { + JLOG(log.error()) << __func__ + << " : Wrong number of fields in Postgres " + "response. Expected 1, but got " + << res.nfields() << " . query = " << query; + assert(false); + return {}; + } + } + + JLOG(log.trace()) << __func__ << " : result = " << res.c_str() + << " : query = " << query; + for (size_t i = 0; i < res.ntuples(); ++i) + { + char const* nodestoreHash = res.c_str(i, 0); + uint256 hash; + if (!hash.parseHex(nodestoreHash + 2)) + assert(false); + + nodestoreHashes.push_back(hash); + } +#endif + + return nodestoreHashes; +} + +std::vector> +PostgresDatabaseImp::getTxHistory(LedgerIndex startIndex) +{ + std::vector> ret; + +#ifdef RIPPLED_REPORTING + if (!app_.config().reporting()) + { + assert(false); + Throw( + "called getTxHistory but not in reporting mode"); + } + + std::string sql = boost::str( + boost::format("SELECT nodestore_hash, ledger_seq " + " FROM transactions" + " ORDER BY ledger_seq DESC LIMIT 20 " + "OFFSET %u;") % + startIndex); + + auto res = PgQuery(pgPool_)(sql.data()); + + if (!res) + { + JLOG(j_.error()) << __func__ + << " : Postgres response is null - sql = " << sql; + assert(false); + return {}; + } + else if (res.status() != PGRES_TUPLES_OK) + { + JLOG(j_.error()) << __func__ + << " : Postgres response should have been " + "PGRES_TUPLES_OK but instead was " + << res.status() << " - msg = " << res.msg() + << " - sql = " << sql; + assert(false); + return {}; + } + + JLOG(j_.trace()) << __func__ << " Postgres result msg : " << res.msg(); + + if (res.isNull() || res.ntuples() == 0) + { + JLOG(j_.debug()) << __func__ << " : Empty postgres response"; + assert(false); + return {}; + } + else if (res.ntuples() > 0) + { + if (res.nfields() != 2) + { + JLOG(j_.error()) << __func__ + << " : Wrong number of fields in Postgres " + "response. Expected 1, but got " + << res.nfields() << " . sql = " << sql; + assert(false); + return {}; + } + } + + JLOG(j_.trace()) << __func__ << " : Postgres result = " << res.c_str(); + + std::vector nodestoreHashes; + std::vector ledgerSequences; + for (size_t i = 0; i < res.ntuples(); ++i) + { + uint256 hash; + if (!hash.parseHex(res.c_str(i, 0) + 2)) + assert(false); + nodestoreHashes.push_back(hash); + ledgerSequences.push_back(res.asBigInt(i, 1)); + } + + auto txns = flatFetchTransactions(app_, nodestoreHashes); + for (size_t i = 0; i < txns.size(); ++i) + { + auto const& [sttx, meta] = txns[i]; + assert(sttx); + + std::string reason; + auto txn = std::make_shared(sttx, reason, app_); + txn->setLedger(ledgerSequences[i]); + txn->setStatus(COMMITTED); + ret.push_back(txn); + } + +#endif + return ret; +} + +std::pair +PostgresDatabaseImp::getAccountTx(AccountTxArgs const& args) +{ +#ifdef RIPPLED_REPORTING + pg_params dbParams; + + char const*& command = dbParams.first; + std::vector>& values = dbParams.second; + command = + "SELECT account_tx($1::bytea, $2::bool, " + "$3::bigint, $4::bigint, $5::bigint, $6::bytea, " + "$7::bigint, $8::bool, $9::bigint, $10::bigint)"; + values.resize(10); + values[0] = "\\x" + strHex(args.account); + values[1] = args.forward ? "true" : "false"; + + static std::uint32_t const page_length(200); + if (args.limit == 0 || args.limit > page_length) + values[2] = std::to_string(page_length); + else + values[2] = std::to_string(args.limit); + + if (args.ledger) + { + if (auto range = std::get_if(&args.ledger.value())) + { values[3] = std::to_string(range->min); values[4] = std::to_string(range->max); } @@ -587,8 +885,8 @@ getAccountTx( } else { - JLOG(j.error()) << "doAccountTxStoredProcedure - " - << "Error parsing ledger args"; + JLOG(j_.error()) << "doAccountTxStoredProcedure - " + << "Error parsing ledger args"; return {}; } } @@ -600,52 +898,52 @@ getAccountTx( } for (size_t i = 0; i < values.size(); ++i) { - JLOG(j.trace()) << "value " << std::to_string(i) << " = " - << (values[i] ? values[i].value() : "null"); + JLOG(j_.trace()) << "value " << std::to_string(i) << " = " + << (values[i] ? values[i].value() : "null"); } - auto res = PgQuery(pgPool)(dbParams); + auto res = PgQuery(pgPool_)(dbParams); if (!res) { - JLOG(j.error()) << __func__ - << " : Postgres response is null - account = " - << strHex(args.account); + JLOG(j_.error()) << __func__ + << " : Postgres response is null - account = " + << strHex(args.account); assert(false); return {{}, {rpcINTERNAL, "Postgres error"}}; } else if (res.status() != PGRES_TUPLES_OK) { - JLOG(j.error()) << __func__ - << " : Postgres response should have been " - "PGRES_TUPLES_OK but instead was " - << res.status() << " - msg = " << res.msg() - << " - account = " << strHex(args.account); + JLOG(j_.error()) << __func__ + << " : Postgres response should have been " + "PGRES_TUPLES_OK but instead was " + << res.status() << " - msg = " << res.msg() + << " - account = " << strHex(args.account); assert(false); return {{}, {rpcINTERNAL, "Postgres error"}}; } - JLOG(j.trace()) << __func__ << " Postgres result msg : " << res.msg(); + JLOG(j_.trace()) << __func__ << " Postgres result msg : " << res.msg(); if (res.isNull() || res.ntuples() == 0) { - JLOG(j.debug()) << __func__ - << " : No data returned from Postgres : account = " - << strHex(args.account); + JLOG(j_.debug()) << __func__ + << " : No data returned from Postgres : account = " + << strHex(args.account); assert(false); return {{}, {rpcINTERNAL, "Postgres error"}}; } char const* resultStr = res.c_str(); - JLOG(j.trace()) << __func__ << " : " - << "postgres result = " << resultStr - << " : account = " << strHex(args.account); + JLOG(j_.trace()) << __func__ << " : " + << "postgres result = " << resultStr + << " : account = " << strHex(args.account); Json::Value v; Json::Reader reader; bool success = reader.parse(resultStr, resultStr + strlen(resultStr), v); if (success) { - return processAccountTxStoredProcedureResult(args, v, app, j); + return processAccountTxStoredProcedureResult(args, v, app_, j_); } #endif // This shouldn't happen. Postgres should return a parseable error @@ -654,10 +952,7 @@ getAccountTx( } Transaction::Locator -locateTransaction( - std::shared_ptr const& pgPool, - uint256 const& id, - Application& app) +PostgresDatabaseImp::locateTransaction(uint256 const& id) { #ifdef RIPPLED_REPORTING auto baseCmd = boost::format(R"(SELECT tx('%s');)"); @@ -665,11 +960,11 @@ locateTransaction( std::string txHash = "\\x" + strHex(id); std::string sql = boost::str(baseCmd % txHash); - auto res = PgQuery(pgPool)(sql.data()); + auto res = PgQuery(pgPool_)(sql.data()); if (!res) { - JLOG(app.journal("Transaction").error()) + JLOG(app_.journal("Transaction").error()) << __func__ << " : Postgres response is null - tx ID = " << strHex(id); assert(false); @@ -677,7 +972,7 @@ locateTransaction( } else if (res.status() != PGRES_TUPLES_OK) { - JLOG(app.journal("Transaction").error()) + JLOG(app_.journal("Transaction").error()) << __func__ << " : Postgres response should have been " "PGRES_TUPLES_OK but instead was " @@ -687,11 +982,11 @@ locateTransaction( return {}; } - JLOG(app.journal("Transaction").trace()) + JLOG(app_.journal("Transaction").trace()) << __func__ << " Postgres result msg : " << res.msg(); if (res.isNull() || res.ntuples() == 0) { - JLOG(app.journal("Transaction").debug()) + JLOG(app_.journal("Transaction").debug()) << __func__ << " : No data returned from Postgres : tx ID = " << strHex(id); // This shouldn't happen @@ -700,7 +995,7 @@ locateTransaction( } char const* resultStr = res.c_str(); - JLOG(app.journal("Transaction").debug()) + JLOG(app_.journal("Transaction").debug()) << "postgres result = " << resultStr; Json::Value v; @@ -733,210 +1028,50 @@ locateTransaction( return {}; } -#ifdef RIPPLED_REPORTING -static bool -writeToLedgersDB(LedgerInfo const& info, PgQuery& pgQuery, beast::Journal& j) +bool +PostgresDatabaseImp::dbHasSpace(Config const& config) { - JLOG(j.debug()) << __func__; - auto cmd = boost::format( - R"(INSERT INTO ledgers - VALUES (%u,'\x%s', '\x%s',%u,%u,%u,%u,%u,'\x%s','\x%s'))"); + /* Postgres server could be running on a different machine. */ - auto ledgerInsert = boost::str( - cmd % info.seq % strHex(info.hash) % strHex(info.parentHash) % - info.drops.drops() % info.closeTime.time_since_epoch().count() % - info.parentCloseTime.time_since_epoch().count() % - info.closeTimeResolution.count() % info.closeFlags % - strHex(info.accountHash) % strHex(info.txHash)); - JLOG(j.trace()) << __func__ << " : " - << " : " - << "query string = " << ledgerInsert; - - auto res = pgQuery(ledgerInsert.data()); - - return res; + return true; } -#endif bool -writeLedgerAndTransactions( - std::shared_ptr const& pgPool, - LedgerInfo const& info, - std::vector const& accountTxData, - beast::Journal& j) +PostgresDatabaseImp::ledgerDbHasSpace(Config const& config) { -#ifdef RIPPLED_REPORTING - JLOG(j.debug()) << __func__ << " : " - << "Beginning write to Postgres"; - - try - { - // Create a PgQuery object to run multiple commands over the same - // connection in a single transaction block. - PgQuery pg(pgPool); - auto res = pg("BEGIN"); - if (!res || res.status() != PGRES_COMMAND_OK) - { - std::stringstream msg; - msg << "bulkWriteToTable : Postgres insert error: " << res.msg(); - Throw(msg.str()); - } - - // Writing to the ledgers db fails if the ledger already exists in the - // db. In this situation, the ETL process has detected there is another - // writer, and falls back to only publishing - if (!writeToLedgersDB(info, pg, j)) - { - JLOG(j.warn()) << __func__ << " : " - << "Failed to write to ledgers database."; - return false; - } - - std::stringstream transactionsCopyBuffer; - std::stringstream accountTransactionsCopyBuffer; - for (auto const& data : accountTxData) - { - std::string txHash = strHex(data.txHash); - std::string nodestoreHash = strHex(data.nodestoreHash); - auto idx = data.transactionIndex; - auto ledgerSeq = data.ledgerSequence; - - transactionsCopyBuffer << std::to_string(ledgerSeq) << '\t' - << std::to_string(idx) << '\t' << "\\\\x" - << txHash << '\t' << "\\\\x" << nodestoreHash - << '\n'; - - for (auto const& a : data.accounts) - { - std::string acct = strHex(a); - accountTransactionsCopyBuffer - << "\\\\x" << acct << '\t' << std::to_string(ledgerSeq) - << '\t' << std::to_string(idx) << '\n'; - } - } - - pg.bulkInsert("transactions", transactionsCopyBuffer.str()); - pg.bulkInsert( - "account_transactions", accountTransactionsCopyBuffer.str()); - - res = pg("COMMIT"); - if (!res || res.status() != PGRES_COMMAND_OK) - { - std::stringstream msg; - msg << "bulkWriteToTable : Postgres insert error: " << res.msg(); - assert(false); - Throw(msg.str()); - } + return dbHasSpace(config); +} - JLOG(j.info()) << __func__ << " : " - << "Successfully wrote to Postgres"; - return true; - } - catch (std::exception& e) - { - JLOG(j.error()) << __func__ << "Caught exception writing to Postgres : " - << e.what(); - assert(false); - return false; - } -#else - return false; -#endif +bool +PostgresDatabaseImp::transactionDbHasSpace(Config const& config) +{ + return dbHasSpace(config); } -std::vector> -getTxHistory( - std::shared_ptr const& pgPool, - LedgerIndex startIndex, - Application& app, - beast::Journal j) +std::unique_ptr +getPostgresDatabase(Application& app, Config const& config, JobQueue& jobQueue) { - std::vector> ret; + return std::make_unique(app, config, jobQueue); +} +bool +PostgresDatabaseImp::isCaughtUp(std::string& reason) +{ #ifdef RIPPLED_REPORTING - if (!app.config().reporting()) - { - assert(false); - Throw( - "called getTxHistory but not in reporting mode"); - } - - std::string sql = boost::str( - boost::format("SELECT nodestore_hash, ledger_seq " - " FROM transactions" - " ORDER BY ledger_seq DESC LIMIT 20 " - "OFFSET %u;") % - startIndex); - - auto res = PgQuery(pgPool)(sql.data()); - - if (!res) - { - JLOG(j.error()) << __func__ - << " : Postgres response is null - sql = " << sql; - assert(false); - return {}; - } - else if (res.status() != PGRES_TUPLES_OK) - { - JLOG(j.error()) << __func__ - << " : Postgres response should have been " - "PGRES_TUPLES_OK but instead was " - << res.status() << " - msg = " << res.msg() - << " - sql = " << sql; - assert(false); - return {}; - } - - JLOG(j.trace()) << __func__ << " Postgres result msg : " << res.msg(); - - if (res.isNull() || res.ntuples() == 0) - { - JLOG(j.debug()) << __func__ << " : Empty postgres response"; - assert(false); - return {}; - } - else if (res.ntuples() > 0) - { - if (res.nfields() != 2) - { - JLOG(j.error()) << __func__ - << " : Wrong number of fields in Postgres " - "response. Expected 1, but got " - << res.nfields() << " . sql = " << sql; - assert(false); - return {}; - } - } - - JLOG(j.trace()) << __func__ << " : Postgres result = " << res.c_str(); - - std::vector nodestoreHashes; - std::vector ledgerSequences; - for (size_t i = 0; i < res.ntuples(); ++i) + using namespace std::chrono_literals; + auto age = PgQuery(pgPool_)("SELECT age()"); + if (!age || age.isNull()) { - uint256 hash; - if (!hash.parseHex(res.c_str(i, 0) + 2)) - assert(false); - nodestoreHashes.push_back(hash); - ledgerSequences.push_back(res.asBigInt(i, 1)); + reason = "No ledgers in database"; + return false; } - - auto txns = flatFetchTransactions(app, nodestoreHashes); - for (size_t i = 0; i < txns.size(); ++i) + if (std::chrono::seconds{age.asInt()} > 3min) { - auto const& [sttx, meta] = txns[i]; - assert(sttx); - - std::string reason; - auto txn = std::make_shared(sttx, reason, app); - txn->setLedger(ledgerSequences[i]); - txn->setStatus(COMMITTED); - ret.push_back(txn); + reason = "No recently-published ledger"; + return false; } - #endif - return ret; + return true; } } // namespace ripple diff --git a/src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.cpp b/src/ripple/app/rdb/backend/impl/SQLiteDatabase.cpp similarity index 75% rename from src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.cpp rename to src/ripple/app/rdb/backend/impl/SQLiteDatabase.cpp index cd5277fb9a9..e6ec44399a0 100644 --- a/src/ripple/app/rdb/backend/RelationalDBInterfaceSqlite.cpp +++ b/src/ripple/app/rdb/backend/impl/SQLiteDatabase.cpp @@ -23,43 +23,41 @@ #include #include #include -#include -#include -#include -#include +#include +#include +#include #include #include #include #include #include #include -#include -#include #include namespace ripple { -class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite +class SQLiteDatabaseImp final : public SQLiteDatabase { public: - RelationalDBInterfaceSqliteImp( + SQLiteDatabaseImp( Application& app, Config const& config, JobQueue& jobQueue) : app_(app) , useTxTables_(config.useTxTables()) - , j_(app_.journal("Ledger")) + , j_(app_.journal("SQLiteDatabaseImp")) { - DatabaseCon::Setup setup = setup_DatabaseCon(config, j_); + DatabaseCon::Setup const setup = setup_DatabaseCon(config, j_); if (!makeLedgerDBs( config, setup, DatabaseCon::CheckpointerSetup{&jobQueue, &app_.logs()})) { - JLOG(app_.journal("RelationalDBInterfaceSqlite").fatal()) - << "AccountTransactions database should not have a primary key"; - Throw( - "AccountTransactions database initialization failed."); + std::string_view constexpr error = + "Failed to create ledger databases"; + + JLOG(j_.fatal()) << error; + Throw(error.data()); } if (app.getShardStore() && @@ -68,10 +66,11 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite setup, DatabaseCon::CheckpointerSetup{&jobQueue, &app_.logs()})) { - JLOG(app_.journal("RelationalDBInterfaceSqlite").fatal()) - << "Error during meta DB init"; - Throw( - "Shard meta database initialization failed."); + std::string_view constexpr error = + "Failed to create metadata databases"; + + JLOG(j_.fatal()) << error; + Throw(error.data()); } } @@ -105,7 +104,7 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite std::size_t getAccountTransactionCount() override; - RelationalDBInterface::CountMinMax + RelationalDatabase::CountMinMax getLedgerCountMinMax() override; bool @@ -199,12 +198,12 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite std::unique_ptr lgrMetaDB_, txMetaDB_; /** - * @brief makeLedgerDBs Opens node ledger and transaction databases, - * and saves its descriptors into internal variables. + * @brief makeLedgerDBs Opens ledger and transaction databases for the node + * store, and stores their descriptors in private member variables. * @param config Config object. - * @param setup Path to database and other opening parameters. + * @param setup Path to the databases and other opening parameters. * @param checkpointerSetup Checkpointer parameters. - * @return True if node databases opened succsessfully. + * @return True if node databases opened successfully. */ bool makeLedgerDBs( @@ -213,10 +212,10 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite DatabaseCon::CheckpointerSetup const& checkpointerSetup); /** - * @brief makeMetaDBs Opens shard index lookup databases, and saves - * their descriptors into internal variables. + * @brief makeMetaDBs Opens shard index lookup databases, and stores + * their descriptors in private member variables. * @param config Config object. - * @param setup Path to database and other opening parameters. + * @param setup Path to the databases and other opening parameters. * @param checkpointerSetup Checkpointer parameters. * @return True if node databases opened successfully. */ @@ -227,7 +226,8 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite DatabaseCon::CheckpointerSetup const& checkpointerSetup); /** - * @brief seqToShardIndex Converts ledgers sequence to shard index. + * @brief seqToShardIndex Provides the index of the shard that stores the + * ledger with the given sequence. * @param ledgerSeq Ledger sequence. * @return Shard index. */ @@ -238,7 +238,8 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief firstLedgerSeq Returns first ledger sequence for given shard. + * @brief firstLedgerSeq Returns the sequence of the first ledger stored in + * the shard specified by the shard index parameter. * @param shardIndex Shard Index. * @return First ledger sequence. */ @@ -249,7 +250,8 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief lastLedgerSeq Returns last ledger sequence for given shard. + * @brief lastLedgerSeq Returns the sequence of the last ledger stored in + * the shard specified by the shard index parameter. * @param shardIndex Shard Index. * @return Last ledger sequence. */ @@ -260,8 +262,8 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief existsLedger Checks if node ledger DB exists. - * @return True if node ledger DB exists. + * @brief existsLedger Checks if the node store ledger database exists. + * @return True if the node store ledger database exists. */ bool existsLedger() @@ -270,8 +272,9 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief existsTransaction Checks if node transaction DB exists. - * @return True if node transaction DB exists. + * @brief existsTransaction Checks if the node store transaction database + * exists. + * @return True if the node store transaction database exists. */ bool existsTransaction() @@ -290,8 +293,9 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief checkoutTransaction Checks out and returns node ledger DB. - * @return Session to node ledger DB. + * @brief checkoutTransaction Checks out and returns node store ledger + * database. + * @return Session to the node store ledger database. */ auto checkoutLedger() @@ -300,8 +304,9 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief checkoutTransaction Checks out and returns node transaction DB. - * @return Session to node transaction DB. + * @brief checkoutTransaction Checks out and returns the node store + * transaction database. + * @return Session to the node store transaction database. */ auto checkoutTransaction() @@ -310,9 +315,9 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief doLedger Checks out ledger database for shard - * containing given ledger and calls given callback function passing - * shard index and session with the database to it. + * @brief doLedger Checks out the ledger database owned by the shard + * containing the given ledger, and invokes the provided callback + * with a session to that database. * @param ledgerSeq Ledger sequence. * @param callback Callback function to call. * @return Value returned by callback function. @@ -327,9 +332,9 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief doTransaction Checks out transaction database for shard - * containing given ledger and calls given callback function passing - * shard index and session with the database to it. + * @brief doTransaction Checks out the transaction database owned by the + * shard containing the given ledger, and invokes the provided + * callback with a session to that database. * @param ledgerSeq Ledger sequence. * @param callback Callback function to call. * @return Value returned by callback function. @@ -344,12 +349,12 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief iterateLedgerForward Checks out ledger databases for - * all shards in ascending order starting from given shard index - * until shard with the largest index visited or callback returned - * false. For each visited shard calls given callback function - * passing shard index and session with the database to it. - * @param firstIndex Start shard index to visit or none if all shards + * @brief iterateLedgerForward Checks out ledger databases for all shards in + * ascending order starting from the given shard index, until all + * shards in range have been visited or the callback returns false. + * For each visited shard, we invoke the provided callback with a + * session to the database and the current shard index. + * @param firstIndex First shard index to visit or no value if all shards * should be visited. * @param callback Callback function to call. * @return True if each callback function returned true, false otherwise. @@ -366,12 +371,13 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief iterateTransactionForward Checks out transaction databases for - * all shards in ascending order starting from given shard index - * until shard with the largest index visited or callback returned - * false. For each visited shard calls given callback function - * passing shard index and session with the database to it. - * @param firstIndex Start shard index to visit or none if all shards + * @brief iterateTransactionForward Checks out transaction databases for all + * shards in ascending order starting from the given shard index, + * until all shards in range have been visited or the callback + * returns false. For each visited shard, we invoke the provided + * callback with a session to the database and the current shard + * index. + * @param firstIndex First shard index to visit or no value if all shards * should be visited. * @param callback Callback function to call. * @return True if each callback function returned true, false otherwise. @@ -388,12 +394,13 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief iterateLedgerBack Checks out ledger databases for - * all shards in descending order starting from given shard index - * until shard with the smallest index visited or callback returned - * false. For each visited shard calls given callback function - * passing shard index and session with the database to it. - * @param firstIndex Start shard index to visit or none if all shards + * @brief iterateLedgerBack Checks out ledger databases for all + * shards in descending order starting from the given shard index, + * until all shards in range have been visited or the callback + * returns false. For each visited shard, we invoke the provided + * callback with a session to the database and the current shard + * index. + * @param firstIndex First shard index to visit or no value if all shards * should be visited. * @param callback Callback function to call. * @return True if each callback function returned true, false otherwise. @@ -410,12 +417,13 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite } /** - * @brief iterateTransactionForward Checks out transaction databases for - * all shards in descending order starting from given shard index - * until shard with the smallest index visited or callback returned - * false. For each visited shard calls given callback function - * passing shard index and session with the database to it. - * @param firstIndex Start shard index to visit or none if all shards + * @brief iterateTransactionBack Checks out transaction databases for all + * shards in descending order starting from the given shard index, + * until all shards in range have been visited or the callback + * returns false. For each visited shard, we invoke the provided + * callback with a session to the database and the current shard + * index. + * @param firstIndex First shard index to visit or no value if all shards * should be visited. * @param callback Callback function to call. * @return True if each callback function returned true, false otherwise. @@ -433,26 +441,26 @@ class RelationalDBInterfaceSqliteImp : public RelationalDBInterfaceSqlite }; bool -RelationalDBInterfaceSqliteImp::makeLedgerDBs( +SQLiteDatabaseImp::makeLedgerDBs( Config const& config, DatabaseCon::Setup const& setup, DatabaseCon::CheckpointerSetup const& checkpointerSetup) { auto [lgr, tx, res] = - ripple::makeLedgerDBs(config, setup, checkpointerSetup); + detail::makeLedgerDBs(config, setup, checkpointerSetup); txdb_ = std::move(tx); lgrdb_ = std::move(lgr); return res; } bool -RelationalDBInterfaceSqliteImp::makeMetaDBs( +SQLiteDatabaseImp::makeMetaDBs( Config const& config, DatabaseCon::Setup const& setup, DatabaseCon::CheckpointerSetup const& checkpointerSetup) { auto [lgrMetaDB, txMetaDB] = - ripple::makeMetaDBs(config, setup, checkpointerSetup); + detail::makeMetaDBs(config, setup, checkpointerSetup); txMetaDB_ = std::move(txMetaDB); lgrMetaDB_ = std::move(lgrMetaDB); @@ -461,13 +469,13 @@ RelationalDBInterfaceSqliteImp::makeMetaDBs( } std::optional -RelationalDBInterfaceSqliteImp::getMinLedgerSeq() +SQLiteDatabaseImp::getMinLedgerSeq() { /* if databases exists, use it */ if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getMinLedgerSeq(*db, TableType::Ledgers); + return detail::getMinLedgerSeq(*db, detail::TableType::Ledgers); } /* else use shard databases, if available */ @@ -476,7 +484,8 @@ RelationalDBInterfaceSqliteImp::getMinLedgerSeq() std::optional res; iterateLedgerForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - res = ripple::getMinLedgerSeq(session, TableType::Ledgers); + res = detail::getMinLedgerSeq( + session, detail::TableType::Ledgers); return !res; }); return res; @@ -487,7 +496,7 @@ RelationalDBInterfaceSqliteImp::getMinLedgerSeq() } std::optional -RelationalDBInterfaceSqliteImp::getTransactionsMinLedgerSeq() +SQLiteDatabaseImp::getTransactionsMinLedgerSeq() { if (!useTxTables_) return {}; @@ -495,7 +504,7 @@ RelationalDBInterfaceSqliteImp::getTransactionsMinLedgerSeq() if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getMinLedgerSeq(*db, TableType::Transactions); + return detail::getMinLedgerSeq(*db, detail::TableType::Transactions); } if (shardStoreExists()) @@ -503,7 +512,8 @@ RelationalDBInterfaceSqliteImp::getTransactionsMinLedgerSeq() std::optional res; iterateTransactionForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - res = ripple::getMinLedgerSeq(session, TableType::Transactions); + res = detail::getMinLedgerSeq( + session, detail::TableType::Transactions); return !res; }); return res; @@ -513,7 +523,7 @@ RelationalDBInterfaceSqliteImp::getTransactionsMinLedgerSeq() } std::optional -RelationalDBInterfaceSqliteImp::getAccountTransactionsMinLedgerSeq() +SQLiteDatabaseImp::getAccountTransactionsMinLedgerSeq() { if (!useTxTables_) return {}; @@ -521,7 +531,8 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionsMinLedgerSeq() if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getMinLedgerSeq(*db, TableType::AccountTransactions); + return detail::getMinLedgerSeq( + *db, detail::TableType::AccountTransactions); } if (shardStoreExists()) @@ -529,8 +540,8 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionsMinLedgerSeq() std::optional res; iterateTransactionForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - res = ripple::getMinLedgerSeq( - session, TableType::AccountTransactions); + res = detail::getMinLedgerSeq( + session, detail::TableType::AccountTransactions); return !res; }); return res; @@ -540,12 +551,12 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionsMinLedgerSeq() } std::optional -RelationalDBInterfaceSqliteImp::getMaxLedgerSeq() +SQLiteDatabaseImp::getMaxLedgerSeq() { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getMaxLedgerSeq(*db, TableType::Ledgers); + return detail::getMaxLedgerSeq(*db, detail::TableType::Ledgers); } if (shardStoreExists()) @@ -553,7 +564,8 @@ RelationalDBInterfaceSqliteImp::getMaxLedgerSeq() std::optional res; iterateLedgerBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - res = ripple::getMaxLedgerSeq(session, TableType::Ledgers); + res = detail::getMaxLedgerSeq( + session, detail::TableType::Ledgers); return !res; }); return res; @@ -563,8 +575,7 @@ RelationalDBInterfaceSqliteImp::getMaxLedgerSeq() } void -RelationalDBInterfaceSqliteImp::deleteTransactionByLedgerSeq( - LedgerIndex ledgerSeq) +SQLiteDatabaseImp::deleteTransactionByLedgerSeq(LedgerIndex ledgerSeq) { if (!useTxTables_) return; @@ -572,27 +583,29 @@ RelationalDBInterfaceSqliteImp::deleteTransactionByLedgerSeq( if (existsTransaction()) { auto db = checkoutTransaction(); - ripple::deleteByLedgerSeq(*db, TableType::Transactions, ledgerSeq); + detail::deleteByLedgerSeq( + *db, detail::TableType::Transactions, ledgerSeq); return; } if (shardStoreExists()) { doTransaction(ledgerSeq, [&](soci::session& session) { - ripple::deleteByLedgerSeq( - session, TableType::Transactions, ledgerSeq); + detail::deleteByLedgerSeq( + session, detail::TableType::Transactions, ledgerSeq); return true; }); } } void -RelationalDBInterfaceSqliteImp::deleteBeforeLedgerSeq(LedgerIndex ledgerSeq) +SQLiteDatabaseImp::deleteBeforeLedgerSeq(LedgerIndex ledgerSeq) { if (existsLedger()) { auto db = checkoutLedger(); - ripple::deleteBeforeLedgerSeq(*db, TableType::Ledgers, ledgerSeq); + detail::deleteBeforeLedgerSeq( + *db, detail::TableType::Ledgers, ledgerSeq); return; } @@ -601,16 +614,15 @@ RelationalDBInterfaceSqliteImp::deleteBeforeLedgerSeq(LedgerIndex ledgerSeq) iterateLedgerBack( seqToShardIndex(ledgerSeq), [&](soci::session& session, std::uint32_t shardIndex) { - ripple::deleteBeforeLedgerSeq( - session, TableType::Ledgers, ledgerSeq); + detail::deleteBeforeLedgerSeq( + session, detail::TableType::Ledgers, ledgerSeq); return true; }); } } void -RelationalDBInterfaceSqliteImp::deleteTransactionsBeforeLedgerSeq( - LedgerIndex ledgerSeq) +SQLiteDatabaseImp::deleteTransactionsBeforeLedgerSeq(LedgerIndex ledgerSeq) { if (!useTxTables_) return; @@ -618,7 +630,8 @@ RelationalDBInterfaceSqliteImp::deleteTransactionsBeforeLedgerSeq( if (existsTransaction()) { auto db = checkoutTransaction(); - ripple::deleteBeforeLedgerSeq(*db, TableType::Transactions, ledgerSeq); + detail::deleteBeforeLedgerSeq( + *db, detail::TableType::Transactions, ledgerSeq); return; } @@ -627,15 +640,15 @@ RelationalDBInterfaceSqliteImp::deleteTransactionsBeforeLedgerSeq( iterateTransactionBack( seqToShardIndex(ledgerSeq), [&](soci::session& session, std::uint32_t shardIndex) { - ripple::deleteBeforeLedgerSeq( - session, TableType::Transactions, ledgerSeq); + detail::deleteBeforeLedgerSeq( + session, detail::TableType::Transactions, ledgerSeq); return true; }); } } void -RelationalDBInterfaceSqliteImp::deleteAccountTransactionsBeforeLedgerSeq( +SQLiteDatabaseImp::deleteAccountTransactionsBeforeLedgerSeq( LedgerIndex ledgerSeq) { if (!useTxTables_) @@ -644,8 +657,8 @@ RelationalDBInterfaceSqliteImp::deleteAccountTransactionsBeforeLedgerSeq( if (existsTransaction()) { auto db = checkoutTransaction(); - ripple::deleteBeforeLedgerSeq( - *db, TableType::AccountTransactions, ledgerSeq); + detail::deleteBeforeLedgerSeq( + *db, detail::TableType::AccountTransactions, ledgerSeq); return; } @@ -654,15 +667,15 @@ RelationalDBInterfaceSqliteImp::deleteAccountTransactionsBeforeLedgerSeq( iterateTransactionBack( seqToShardIndex(ledgerSeq), [&](soci::session& session, std::uint32_t shardIndex) { - ripple::deleteBeforeLedgerSeq( - session, TableType::AccountTransactions, ledgerSeq); + detail::deleteBeforeLedgerSeq( + session, detail::TableType::AccountTransactions, ledgerSeq); return true; }); } } std::size_t -RelationalDBInterfaceSqliteImp::getTransactionCount() +SQLiteDatabaseImp::getTransactionCount() { if (!useTxTables_) return 0; @@ -670,7 +683,7 @@ RelationalDBInterfaceSqliteImp::getTransactionCount() if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getRows(*db, TableType::Transactions); + return detail::getRows(*db, detail::TableType::Transactions); } if (shardStoreExists()) @@ -678,7 +691,8 @@ RelationalDBInterfaceSqliteImp::getTransactionCount() std::size_t rows = 0; iterateTransactionForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - rows += ripple::getRows(session, TableType::Transactions); + rows += + detail::getRows(session, detail::TableType::Transactions); return true; }); return rows; @@ -688,7 +702,7 @@ RelationalDBInterfaceSqliteImp::getTransactionCount() } std::size_t -RelationalDBInterfaceSqliteImp::getAccountTransactionCount() +SQLiteDatabaseImp::getAccountTransactionCount() { if (!useTxTables_) return 0; @@ -696,7 +710,7 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionCount() if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getRows(*db, TableType::AccountTransactions); + return detail::getRows(*db, detail::TableType::AccountTransactions); } if (shardStoreExists()) @@ -704,8 +718,8 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionCount() std::size_t rows = 0; iterateTransactionForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - rows += - ripple::getRows(session, TableType::AccountTransactions); + rows += detail::getRows( + session, detail::TableType::AccountTransactions); return true; }); return rows; @@ -714,13 +728,13 @@ RelationalDBInterfaceSqliteImp::getAccountTransactionCount() return 0; } -RelationalDBInterface::CountMinMax -RelationalDBInterfaceSqliteImp::getLedgerCountMinMax() +RelationalDatabase::CountMinMax +SQLiteDatabaseImp::getLedgerCountMinMax() { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getRowsMinMax(*db, TableType::Ledgers); + return detail::getRowsMinMax(*db, detail::TableType::Ledgers); } if (shardStoreExists()) @@ -728,7 +742,8 @@ RelationalDBInterfaceSqliteImp::getLedgerCountMinMax() CountMinMax res{0, 0, 0}; iterateLedgerForward( {}, [&](soci::session& session, std::uint32_t shardIndex) { - auto r = ripple::getRowsMinMax(session, TableType::Ledgers); + auto r = + detail::getRowsMinMax(session, detail::TableType::Ledgers); if (r.numberOfRows) { res.numberOfRows += r.numberOfRows; @@ -745,13 +760,13 @@ RelationalDBInterfaceSqliteImp::getLedgerCountMinMax() } bool -RelationalDBInterfaceSqliteImp::saveValidatedLedger( +SQLiteDatabaseImp::saveValidatedLedger( std::shared_ptr const& ledger, bool current) { if (existsLedger()) { - if (!ripple::saveValidatedLedger( + if (!detail::saveValidatedLedger( *lgrdb_, *txdb_, app_, ledger, current)) return false; } @@ -769,7 +784,7 @@ RelationalDBInterfaceSqliteImp::saveValidatedLedger( auto lgrMetaSession = lgrMetaDB_->checkoutDb(); auto txMetaSession = txMetaDB_->checkoutDb(); - return ripple::saveLedgerMeta( + return detail::saveLedgerMeta( ledger, app_, *lgrMetaSession, @@ -781,19 +796,22 @@ RelationalDBInterfaceSqliteImp::saveValidatedLedger( } std::optional -RelationalDBInterfaceSqliteImp::getLedgerInfoByIndex(LedgerIndex ledgerSeq) +SQLiteDatabaseImp::getLedgerInfoByIndex(LedgerIndex ledgerSeq) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getLedgerInfoByIndex(*db, ledgerSeq, j_); + auto const res = detail::getLedgerInfoByIndex(*db, ledgerSeq, j_); + + if (res.has_value()) + return res; } if (shardStoreExists()) { std::optional res; doLedger(ledgerSeq, [&](soci::session& session) { - res = ripple::getLedgerInfoByIndex(session, ledgerSeq, j_); + res = detail::getLedgerInfoByIndex(session, ledgerSeq, j_); return true; }); return res; @@ -803,12 +821,15 @@ RelationalDBInterfaceSqliteImp::getLedgerInfoByIndex(LedgerIndex ledgerSeq) } std::optional -RelationalDBInterfaceSqliteImp::getNewestLedgerInfo() +SQLiteDatabaseImp::getNewestLedgerInfo() { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getNewestLedgerInfo(*db, j_); + auto const res = detail::getNewestLedgerInfo(*db, j_); + + if (res.has_value()) + return res; } if (shardStoreExists()) @@ -816,7 +837,7 @@ RelationalDBInterfaceSqliteImp::getNewestLedgerInfo() std::optional res; iterateLedgerBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - if (auto info = ripple::getNewestLedgerInfo(session, j_)) + if (auto info = detail::getNewestLedgerInfo(session, j_)) { res = info; return false; @@ -831,13 +852,16 @@ RelationalDBInterfaceSqliteImp::getNewestLedgerInfo() } std::optional -RelationalDBInterfaceSqliteImp::getLimitedOldestLedgerInfo( - LedgerIndex ledgerFirstIndex) +SQLiteDatabaseImp::getLimitedOldestLedgerInfo(LedgerIndex ledgerFirstIndex) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getLimitedOldestLedgerInfo(*db, ledgerFirstIndex, j_); + auto const res = + detail::getLimitedOldestLedgerInfo(*db, ledgerFirstIndex, j_); + + if (res.has_value()) + return res; } if (shardStoreExists()) @@ -846,7 +870,7 @@ RelationalDBInterfaceSqliteImp::getLimitedOldestLedgerInfo( iterateLedgerForward( seqToShardIndex(ledgerFirstIndex), [&](soci::session& session, std::uint32_t shardIndex) { - if (auto info = ripple::getLimitedOldestLedgerInfo( + if (auto info = detail::getLimitedOldestLedgerInfo( session, ledgerFirstIndex, j_)) { res = info; @@ -862,13 +886,16 @@ RelationalDBInterfaceSqliteImp::getLimitedOldestLedgerInfo( } std::optional -RelationalDBInterfaceSqliteImp::getLimitedNewestLedgerInfo( - LedgerIndex ledgerFirstIndex) +SQLiteDatabaseImp::getLimitedNewestLedgerInfo(LedgerIndex ledgerFirstIndex) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getLimitedNewestLedgerInfo(*db, ledgerFirstIndex, j_); + auto const res = + detail::getLimitedNewestLedgerInfo(*db, ledgerFirstIndex, j_); + + if (res.has_value()) + return res; } if (shardStoreExists()) @@ -876,7 +903,7 @@ RelationalDBInterfaceSqliteImp::getLimitedNewestLedgerInfo( std::optional res; iterateLedgerBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - if (auto info = ripple::getLimitedNewestLedgerInfo( + if (auto info = detail::getLimitedNewestLedgerInfo( session, ledgerFirstIndex, j_)) { res = info; @@ -892,12 +919,15 @@ RelationalDBInterfaceSqliteImp::getLimitedNewestLedgerInfo( } std::optional -RelationalDBInterfaceSqliteImp::getLedgerInfoByHash(uint256 const& ledgerHash) +SQLiteDatabaseImp::getLedgerInfoByHash(uint256 const& ledgerHash) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getLedgerInfoByHash(*db, ledgerHash, j_); + auto const res = detail::getLedgerInfoByHash(*db, ledgerHash, j_); + + if (res.has_value()) + return res; } if (auto shardStore = app_.getShardStore()) @@ -906,11 +936,11 @@ RelationalDBInterfaceSqliteImp::getLedgerInfoByHash(uint256 const& ledgerHash) auto lgrMetaSession = lgrMetaDB_->checkoutDb(); if (auto const shardIndex = - ripple::getShardIndexforLedger(*lgrMetaSession, ledgerHash)) + detail::getShardIndexforLedger(*lgrMetaSession, ledgerHash)) { shardStore->callForLedgerSQLByShardIndex( *shardIndex, [&](soci::session& session) { - res = ripple::getLedgerInfoByHash(session, ledgerHash, j_); + res = detail::getLedgerInfoByHash(session, ledgerHash, j_); return false; // unused }); } @@ -922,19 +952,22 @@ RelationalDBInterfaceSqliteImp::getLedgerInfoByHash(uint256 const& ledgerHash) } uint256 -RelationalDBInterfaceSqliteImp::getHashByIndex(LedgerIndex ledgerIndex) +SQLiteDatabaseImp::getHashByIndex(LedgerIndex ledgerIndex) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getHashByIndex(*db, ledgerIndex); + auto const res = detail::getHashByIndex(*db, ledgerIndex); + + if (res.isNonZero()) + return res; } if (shardStoreExists()) { uint256 hash; doLedger(ledgerIndex, [&](soci::session& session) { - hash = ripple::getHashByIndex(session, ledgerIndex); + hash = detail::getHashByIndex(session, ledgerIndex); return true; }); return hash; @@ -944,19 +977,22 @@ RelationalDBInterfaceSqliteImp::getHashByIndex(LedgerIndex ledgerIndex) } std::optional -RelationalDBInterfaceSqliteImp::getHashesByIndex(LedgerIndex ledgerIndex) +SQLiteDatabaseImp::getHashesByIndex(LedgerIndex ledgerIndex) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getHashesByIndex(*db, ledgerIndex, j_); + auto const res = detail::getHashesByIndex(*db, ledgerIndex, j_); + + if (res.has_value()) + return res; } if (shardStoreExists()) { std::optional res; doLedger(ledgerIndex, [&](soci::session& session) { - res = ripple::getHashesByIndex(session, ledgerIndex, j_); + res = detail::getHashesByIndex(session, ledgerIndex, j_); return true; }); return res; @@ -966,14 +1002,15 @@ RelationalDBInterfaceSqliteImp::getHashesByIndex(LedgerIndex ledgerIndex) } std::map -RelationalDBInterfaceSqliteImp::getHashesByIndex( - LedgerIndex minSeq, - LedgerIndex maxSeq) +SQLiteDatabaseImp::getHashesByIndex(LedgerIndex minSeq, LedgerIndex maxSeq) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::getHashesByIndex(*db, minSeq, maxSeq, j_); + auto const res = detail::getHashesByIndex(*db, minSeq, maxSeq, j_); + + if (!res.empty()) + return res; } if (shardStoreExists()) @@ -986,7 +1023,7 @@ RelationalDBInterfaceSqliteImp::getHashesByIndex( shardMaxSeq = maxSeq; doLedger(minSeq, [&](soci::session& session) { auto r = - ripple::getHashesByIndex(session, minSeq, shardMaxSeq, j_); + detail::getHashesByIndex(session, minSeq, shardMaxSeq, j_); res.insert(r.begin(), r.end()); return true; }); @@ -1000,7 +1037,7 @@ RelationalDBInterfaceSqliteImp::getHashesByIndex( } std::vector> -RelationalDBInterfaceSqliteImp::getTxHistory(LedgerIndex startIndex) +SQLiteDatabaseImp::getTxHistory(LedgerIndex startIndex) { if (!useTxTables_) return {}; @@ -1008,7 +1045,11 @@ RelationalDBInterfaceSqliteImp::getTxHistory(LedgerIndex startIndex) if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getTxHistory(*db, app_, startIndex, 20, false).first; + auto const res = + detail::getTxHistory(*db, app_, startIndex, 20, false).first; + + if (!res.empty()) + return res; } if (shardStoreExists()) @@ -1017,7 +1058,7 @@ RelationalDBInterfaceSqliteImp::getTxHistory(LedgerIndex startIndex) int quantity = 20; iterateTransactionBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - auto [tx, total] = ripple::getTxHistory( + auto [tx, total] = detail::getTxHistory( session, app_, startIndex, quantity, true); txs.insert(txs.end(), tx.begin(), tx.end()); if (total > 0) @@ -1040,9 +1081,8 @@ RelationalDBInterfaceSqliteImp::getTxHistory(LedgerIndex startIndex) return {}; } -RelationalDBInterface::AccountTxs -RelationalDBInterfaceSqliteImp::getOldestAccountTxs( - AccountTxOptions const& options) +RelationalDatabase::AccountTxs +SQLiteDatabaseImp::getOldestAccountTxs(AccountTxOptions const& options) { if (!useTxTables_) return {}; @@ -1052,7 +1092,7 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxs( if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getOldestAccountTxs( + return detail::getOldestAccountTxs( *db, app_, ledgerMaster, options, {}, j_) .first; } @@ -1069,7 +1109,7 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxs( if (opt.maxLedger && shardIndex > seqToShardIndex(opt.maxLedger)) return false; - auto [r, total] = ripple::getOldestAccountTxs( + auto [r, total] = detail::getOldestAccountTxs( session, app_, ledgerMaster, opt, limit_used, j_); ret.insert(ret.end(), r.begin(), r.end()); if (!total) @@ -1101,9 +1141,8 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxs( return {}; } -RelationalDBInterface::AccountTxs -RelationalDBInterfaceSqliteImp::getNewestAccountTxs( - AccountTxOptions const& options) +RelationalDatabase::AccountTxs +SQLiteDatabaseImp::getNewestAccountTxs(AccountTxOptions const& options) { if (!useTxTables_) return {}; @@ -1113,7 +1152,7 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxs( if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getNewestAccountTxs( + return detail::getNewestAccountTxs( *db, app_, ledgerMaster, options, {}, j_) .first; } @@ -1130,7 +1169,7 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxs( if (opt.minLedger && shardIndex < seqToShardIndex(opt.minLedger)) return false; - auto [r, total] = ripple::getNewestAccountTxs( + auto [r, total] = detail::getNewestAccountTxs( session, app_, ledgerMaster, opt, limit_used, j_); ret.insert(ret.end(), r.begin(), r.end()); if (!total) @@ -1162,9 +1201,8 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxs( return {}; } -RelationalDBInterface::MetaTxsList -RelationalDBInterfaceSqliteImp::getOldestAccountTxsB( - AccountTxOptions const& options) +RelationalDatabase::MetaTxsList +SQLiteDatabaseImp::getOldestAccountTxsB(AccountTxOptions const& options) { if (!useTxTables_) return {}; @@ -1172,7 +1210,7 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxsB( if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getOldestAccountTxsB(*db, app_, options, {}, j_).first; + return detail::getOldestAccountTxsB(*db, app_, options, {}, j_).first; } if (shardStoreExists()) @@ -1187,7 +1225,7 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxsB( if (opt.maxLedger && shardIndex > seqToShardIndex(opt.maxLedger)) return false; - auto [r, total] = ripple::getOldestAccountTxsB( + auto [r, total] = detail::getOldestAccountTxsB( session, app_, opt, limit_used, j_); ret.insert(ret.end(), r.begin(), r.end()); if (!total) @@ -1219,9 +1257,8 @@ RelationalDBInterfaceSqliteImp::getOldestAccountTxsB( return {}; } -RelationalDBInterface::MetaTxsList -RelationalDBInterfaceSqliteImp::getNewestAccountTxsB( - AccountTxOptions const& options) +RelationalDatabase::MetaTxsList +SQLiteDatabaseImp::getNewestAccountTxsB(AccountTxOptions const& options) { if (!useTxTables_) return {}; @@ -1229,7 +1266,7 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxsB( if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getNewestAccountTxsB(*db, app_, options, {}, j_).first; + return detail::getNewestAccountTxsB(*db, app_, options, {}, j_).first; } if (shardStoreExists()) @@ -1244,7 +1281,7 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxsB( if (opt.minLedger && shardIndex < seqToShardIndex(opt.minLedger)) return false; - auto [r, total] = ripple::getNewestAccountTxsB( + auto [r, total] = detail::getNewestAccountTxsB( session, app_, opt, limit_used, j_); ret.insert(ret.end(), r.begin(), r.end()); if (!total) @@ -1277,10 +1314,9 @@ RelationalDBInterfaceSqliteImp::getNewestAccountTxsB( } std::pair< - RelationalDBInterface::AccountTxs, - std::optional> -RelationalDBInterfaceSqliteImp::oldestAccountTxPage( - AccountTxPageOptions const& options) + RelationalDatabase::AccountTxs, + std::optional> +SQLiteDatabaseImp::oldestAccountTxPage(AccountTxPageOptions const& options) { if (!useTxTables_) return {}; @@ -1302,7 +1338,7 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPage( if (existsTransaction()) { auto db = checkoutTransaction(); - auto newmarker = ripple::oldestAccountTxPage( + auto newmarker = detail::oldestAccountTxPage( *db, idCache, onUnsavedLedger, @@ -1325,7 +1361,7 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPage( if (opt.maxLedger != UINT32_MAX && shardIndex > seqToShardIndex(opt.minLedger)) return false; - auto [marker, total] = ripple::oldestAccountTxPage( + auto [marker, total] = detail::oldestAccountTxPage( session, idCache, onUnsavedLedger, @@ -1347,10 +1383,9 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPage( } std::pair< - RelationalDBInterface::AccountTxs, - std::optional> -RelationalDBInterfaceSqliteImp::newestAccountTxPage( - AccountTxPageOptions const& options) + RelationalDatabase::AccountTxs, + std::optional> +SQLiteDatabaseImp::newestAccountTxPage(AccountTxPageOptions const& options) { if (!useTxTables_) return {}; @@ -1372,7 +1407,7 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPage( if (existsTransaction()) { auto db = checkoutTransaction(); - auto newmarker = ripple::newestAccountTxPage( + auto newmarker = detail::newestAccountTxPage( *db, idCache, onUnsavedLedger, @@ -1395,7 +1430,7 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPage( if (opt.minLedger && shardIndex < seqToShardIndex(opt.minLedger)) return false; - auto [marker, total] = ripple::newestAccountTxPage( + auto [marker, total] = detail::newestAccountTxPage( session, idCache, onUnsavedLedger, @@ -1417,10 +1452,9 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPage( } std::pair< - RelationalDBInterface::MetaTxsList, - std::optional> -RelationalDBInterfaceSqliteImp::oldestAccountTxPageB( - AccountTxPageOptions const& options) + RelationalDatabase::MetaTxsList, + std::optional> +SQLiteDatabaseImp::oldestAccountTxPageB(AccountTxPageOptions const& options) { if (!useTxTables_) return {}; @@ -1441,7 +1475,7 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPageB( if (existsTransaction()) { auto db = checkoutTransaction(); - auto newmarker = ripple::oldestAccountTxPage( + auto newmarker = detail::oldestAccountTxPage( *db, idCache, onUnsavedLedger, @@ -1464,7 +1498,7 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPageB( if (opt.maxLedger != UINT32_MAX && shardIndex > seqToShardIndex(opt.minLedger)) return false; - auto [marker, total] = ripple::oldestAccountTxPage( + auto [marker, total] = detail::oldestAccountTxPage( session, idCache, onUnsavedLedger, @@ -1486,10 +1520,9 @@ RelationalDBInterfaceSqliteImp::oldestAccountTxPageB( } std::pair< - RelationalDBInterface::MetaTxsList, - std::optional> -RelationalDBInterfaceSqliteImp::newestAccountTxPageB( - AccountTxPageOptions const& options) + RelationalDatabase::MetaTxsList, + std::optional> +SQLiteDatabaseImp::newestAccountTxPageB(AccountTxPageOptions const& options) { if (!useTxTables_) return {}; @@ -1510,7 +1543,7 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPageB( if (existsTransaction()) { auto db = checkoutTransaction(); - auto newmarker = ripple::newestAccountTxPage( + auto newmarker = detail::newestAccountTxPage( *db, idCache, onUnsavedLedger, @@ -1533,7 +1566,7 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPageB( if (opt.minLedger && shardIndex < seqToShardIndex(opt.minLedger)) return false; - auto [marker, total] = ripple::newestAccountTxPage( + auto [marker, total] = detail::newestAccountTxPage( session, idCache, onUnsavedLedger, @@ -1554,8 +1587,8 @@ RelationalDBInterfaceSqliteImp::newestAccountTxPageB( return {}; } -std::variant -RelationalDBInterfaceSqliteImp::getTransaction( +std::variant +SQLiteDatabaseImp::getTransaction( uint256 const& id, std::optional> const& range, error_code_i& ec) @@ -1566,7 +1599,7 @@ RelationalDBInterfaceSqliteImp::getTransaction( if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::getTransaction(*db, app_, id, range, ec); + return detail::getTransaction(*db, app_, id, range, ec); } if (auto shardStore = app_.getShardStore(); shardStore) @@ -1575,7 +1608,7 @@ RelationalDBInterfaceSqliteImp::getTransaction( auto txMetaSession = txMetaDB_->checkoutDb(); if (auto const shardIndex = - ripple::getShardIndexforTransaction(*txMetaSession, id)) + detail::getShardIndexforTransaction(*txMetaSession, id)) { shardStore->callForTransactionSQLByShardIndex( *shardIndex, [&](soci::session& session) { @@ -1589,7 +1622,7 @@ RelationalDBInterfaceSqliteImp::getTransaction( if (low <= high) range1 = ClosedInterval(low, high); } - res = ripple::getTransaction(session, app_, id, range1, ec); + res = detail::getTransaction(session, app_, id, range1, ec); return res.index() == 1 && std::get(res) != @@ -1604,19 +1637,19 @@ RelationalDBInterfaceSqliteImp::getTransaction( } bool -RelationalDBInterfaceSqliteImp::ledgerDbHasSpace(Config const& config) +SQLiteDatabaseImp::ledgerDbHasSpace(Config const& config) { if (existsLedger()) { auto db = checkoutLedger(); - return ripple::dbHasSpace(*db, config, j_); + return detail::dbHasSpace(*db, config, j_); } if (shardStoreExists()) { return iterateLedgerBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - return ripple::dbHasSpace(session, config, j_); + return detail::dbHasSpace(session, config, j_); }); } @@ -1624,7 +1657,7 @@ RelationalDBInterfaceSqliteImp::ledgerDbHasSpace(Config const& config) } bool -RelationalDBInterfaceSqliteImp::transactionDbHasSpace(Config const& config) +SQLiteDatabaseImp::transactionDbHasSpace(Config const& config) { if (!useTxTables_) return true; @@ -1632,14 +1665,14 @@ RelationalDBInterfaceSqliteImp::transactionDbHasSpace(Config const& config) if (existsTransaction()) { auto db = checkoutTransaction(); - return ripple::dbHasSpace(*db, config, j_); + return detail::dbHasSpace(*db, config, j_); } if (shardStoreExists()) { return iterateTransactionBack( {}, [&](soci::session& session, std::uint32_t shardIndex) { - return ripple::dbHasSpace(session, config, j_); + return detail::dbHasSpace(session, config, j_); }); } @@ -1647,7 +1680,7 @@ RelationalDBInterfaceSqliteImp::transactionDbHasSpace(Config const& config) } std::uint32_t -RelationalDBInterfaceSqliteImp::getKBUsedAll() +SQLiteDatabaseImp::getKBUsedAll() { if (existsLedger()) { @@ -1669,7 +1702,7 @@ RelationalDBInterfaceSqliteImp::getKBUsedAll() } std::uint32_t -RelationalDBInterfaceSqliteImp::getKBUsedLedger() +SQLiteDatabaseImp::getKBUsedLedger() { if (existsLedger()) { @@ -1691,7 +1724,7 @@ RelationalDBInterfaceSqliteImp::getKBUsedLedger() } std::uint32_t -RelationalDBInterfaceSqliteImp::getKBUsedTransaction() +SQLiteDatabaseImp::getKBUsedTransaction() { if (!useTxTables_) return 0; @@ -1716,25 +1749,21 @@ RelationalDBInterfaceSqliteImp::getKBUsedTransaction() } void -RelationalDBInterfaceSqliteImp::closeLedgerDB() +SQLiteDatabaseImp::closeLedgerDB() { lgrdb_.reset(); } void -RelationalDBInterfaceSqliteImp::closeTransactionDB() +SQLiteDatabaseImp::closeTransactionDB() { txdb_.reset(); } -std::unique_ptr -getRelationalDBInterfaceSqlite( - Application& app, - Config const& config, - JobQueue& jobQueue) +std::unique_ptr +getSQLiteDatabase(Application& app, Config const& config, JobQueue& jobQueue) { - return std::make_unique( - app, config, jobQueue); + return std::make_unique(app, config, jobQueue); } } // namespace ripple diff --git a/src/ripple/app/rdb/impl/Download.cpp b/src/ripple/app/rdb/impl/Download.cpp new file mode 100644 index 00000000000..0905ee577b1 --- /dev/null +++ b/src/ripple/app/rdb/impl/Download.cpp @@ -0,0 +1,152 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include +#include + +namespace ripple { + +std::pair, std::optional> +openDatabaseBodyDb( + DatabaseCon::Setup const& setup, + boost::filesystem::path const& path) +{ + // SOCI requires boost::optional (not std::optional) as the parameter. + boost::optional pathFromDb; + boost::optional size; + + auto conn = std::make_unique( + setup, "Download", DownloaderDBPragma, DatabaseBodyDBInit); + + auto& session = *conn->checkoutDb(); + + session << "SELECT Path FROM Download WHERE Part=0;", + soci::into(pathFromDb); + + // Try to reuse preexisting + // database. + if (pathFromDb) + { + // Can't resuse - database was + // from a different file download. + if (pathFromDb != path.string()) + { + session << "DROP TABLE Download;"; + } + + // Continuing a file download. + else + { + session << "SELECT SUM(LENGTH(Data)) FROM Download;", + soci::into(size); + } + } + + return {std::move(conn), (size ? *size : std::optional())}; +} + +std::uint64_t +databaseBodyDoPut( + soci::session& session, + std::string const& data, + std::string const& path, + std::uint64_t fileSize, + std::uint64_t part, + std::uint16_t maxRowSizePad) +{ + std::uint64_t rowSize = 0; + soci::indicator rti; + + std::uint64_t remainingInRow = 0; + + auto be = + dynamic_cast(session.get_backend()); + BOOST_ASSERT(be); + + // This limits how large we can make the blob + // in each row. Also subtract a pad value to + // account for the other values in the row. + auto const blobMaxSize = + sqlite_api::sqlite3_limit(be->conn_, SQLITE_LIMIT_LENGTH, -1) - + maxRowSizePad; + + std::string newpath; + + auto rowInit = [&] { + session << "INSERT INTO Download VALUES (:path, zeroblob(0), 0, :part)", + soci::use(newpath), soci::use(part); + + remainingInRow = blobMaxSize; + rowSize = 0; + }; + + session << "SELECT Path,Size,Part FROM Download ORDER BY Part DESC " + "LIMIT 1", + soci::into(newpath), soci::into(rowSize), soci::into(part, rti); + + if (!session.got_data()) + { + newpath = path; + rowInit(); + } + else + remainingInRow = blobMaxSize - rowSize; + + auto insert = [&session, &rowSize, &part, &fs = fileSize]( + auto const& data) { + std::uint64_t updatedSize = rowSize + data.size(); + + session << "UPDATE Download SET Data = CAST(Data || :data AS blob), " + "Size = :size WHERE Part = :part;", + soci::use(data), soci::use(updatedSize), soci::use(part); + + fs += data.size(); + }; + + size_t currentBase = 0; + + while (currentBase + remainingInRow < data.size()) + { + if (remainingInRow) + { + insert(data.substr(currentBase, remainingInRow)); + currentBase += remainingInRow; + } + + ++part; + rowInit(); + } + + insert(data.substr(currentBase)); + + return part; +} + +void +databaseBodyFinish(soci::session& session, std::ofstream& fout) +{ + soci::rowset rs = + (session.prepare << "SELECT Data FROM Download ORDER BY PART ASC;"); + + // iteration through the resultset: + for (auto it = rs.begin(); it != rs.end(); ++it) + fout.write(it->data(), it->size()); +} + +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/PeerFinder.cpp b/src/ripple/app/rdb/impl/PeerFinder.cpp new file mode 100644 index 00000000000..46dca3760c7 --- /dev/null +++ b/src/ripple/app/rdb/impl/PeerFinder.cpp @@ -0,0 +1,271 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include + +namespace ripple { + +void +initPeerFinderDB( + soci::session& session, + BasicConfig const& config, + beast::Journal j) +{ + DBConfig m_sociConfig(config, "peerfinder"); + m_sociConfig.open(session); + + JLOG(j.info()) << "Opening database at '" << m_sociConfig.connectionString() + << "'"; + + soci::transaction tr(session); + session << "PRAGMA encoding=\"UTF-8\";"; + + session << "CREATE TABLE IF NOT EXISTS SchemaVersion ( " + " name TEXT PRIMARY KEY, " + " version INTEGER" + ");"; + + session << "CREATE TABLE IF NOT EXISTS PeerFinder_BootstrapCache ( " + " id INTEGER PRIMARY KEY AUTOINCREMENT, " + " address TEXT UNIQUE NOT NULL, " + " valence INTEGER" + ");"; + + session << "CREATE INDEX IF NOT EXISTS " + " PeerFinder_BootstrapCache_Index ON " + "PeerFinder_BootstrapCache " + " ( " + " address " + " ); "; + + tr.commit(); +} + +void +updatePeerFinderDB( + soci::session& session, + int currentSchemaVersion, + beast::Journal j) +{ + soci::transaction tr(session); + // get version + int version(0); + { + // SOCI requires a boost::optional (not std::optional) parameter. + boost::optional vO; + session << "SELECT " + " version " + "FROM SchemaVersion WHERE " + " name = 'PeerFinder';", + soci::into(vO); + + version = vO.value_or(0); + + JLOG(j.info()) << "Opened version " << version << " database"; + } + + { + if (version < currentSchemaVersion) + { + JLOG(j.info()) << "Updating database to version " + << currentSchemaVersion; + } + else if (version > currentSchemaVersion) + { + Throw( + "The PeerFinder database version is higher than expected"); + } + } + + if (version < 4) + { + // + // Remove the "uptime" column from the bootstrap table + // + + session << "CREATE TABLE IF NOT EXISTS " + "PeerFinder_BootstrapCache_Next ( " + " id INTEGER PRIMARY KEY AUTOINCREMENT, " + " address TEXT UNIQUE NOT NULL, " + " valence INTEGER" + ");"; + + session << "CREATE INDEX IF NOT EXISTS " + " PeerFinder_BootstrapCache_Next_Index ON " + " PeerFinder_BootstrapCache_Next " + " ( address ); "; + + std::size_t count; + session << "SELECT COUNT(*) FROM PeerFinder_BootstrapCache;", + soci::into(count); + + std::vector list; + + { + list.reserve(count); + std::string s; + int valence; + soci::statement st = + (session.prepare << "SELECT " + " address, " + " valence " + "FROM PeerFinder_BootstrapCache;", + soci::into(s), + soci::into(valence)); + + st.execute(); + while (st.fetch()) + { + PeerFinder::Store::Entry entry; + entry.endpoint = beast::IP::Endpoint::from_string(s); + if (!is_unspecified(entry.endpoint)) + { + entry.valence = valence; + list.push_back(entry); + } + else + { + JLOG(j.error()) << "Bad address string '" << s + << "' in Bootcache table"; + } + } + } + + if (!list.empty()) + { + std::vector s; + std::vector valence; + s.reserve(list.size()); + valence.reserve(list.size()); + + for (auto iter(list.cbegin()); iter != list.cend(); ++iter) + { + s.emplace_back(to_string(iter->endpoint)); + valence.emplace_back(iter->valence); + } + + session << "INSERT INTO PeerFinder_BootstrapCache_Next ( " + " address, " + " valence " + ") VALUES ( " + " :s, :valence" + ");", + soci::use(s), soci::use(valence); + } + + session << "DROP TABLE IF EXISTS PeerFinder_BootstrapCache;"; + + session << "DROP INDEX IF EXISTS PeerFinder_BootstrapCache_Index;"; + + session << "ALTER TABLE PeerFinder_BootstrapCache_Next " + " RENAME TO PeerFinder_BootstrapCache;"; + + session << "CREATE INDEX IF NOT EXISTS " + " PeerFinder_BootstrapCache_Index ON " + "PeerFinder_BootstrapCache " + " ( " + " address " + " ); "; + } + + if (version < 3) + { + // + // Remove legacy endpoints from the schema + // + + session << "DROP TABLE IF EXISTS LegacyEndpoints;"; + + session << "DROP TABLE IF EXISTS PeerFinderLegacyEndpoints;"; + + session << "DROP TABLE IF EXISTS PeerFinder_LegacyEndpoints;"; + + session << "DROP TABLE IF EXISTS PeerFinder_LegacyEndpoints_Index;"; + } + + { + int const v(currentSchemaVersion); + session << "INSERT OR REPLACE INTO SchemaVersion (" + " name " + " ,version " + ") VALUES ( " + " 'PeerFinder', :version " + ");", + soci::use(v); + } + + tr.commit(); +} + +void +readPeerFinderDB( + soci::session& session, + std::function const& func) +{ + std::string s; + int valence; + soci::statement st = + (session.prepare << "SELECT " + " address, " + " valence " + "FROM PeerFinder_BootstrapCache;", + soci::into(s), + soci::into(valence)); + + st.execute(); + while (st.fetch()) + { + func(s, valence); + } +} + +void +savePeerFinderDB( + soci::session& session, + std::vector const& v) +{ + soci::transaction tr(session); + session << "DELETE FROM PeerFinder_BootstrapCache;"; + + if (!v.empty()) + { + std::vector s; + std::vector valence; + s.reserve(v.size()); + valence.reserve(v.size()); + + for (auto const& e : v) + { + s.emplace_back(to_string(e.endpoint)); + valence.emplace_back(e.valence); + } + + session << "INSERT INTO PeerFinder_BootstrapCache ( " + " address, " + " valence " + ") VALUES ( " + " :s, :valence " + ");", + soci::use(s), soci::use(valence); + } + + tr.commit(); +} + +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/RelationalDBInterface_global.cpp b/src/ripple/app/rdb/impl/RelationalDBInterface_global.cpp deleted file mode 100644 index 17b86f0cabc..00000000000 --- a/src/ripple/app/rdb/impl/RelationalDBInterface_global.cpp +++ /dev/null @@ -1,836 +0,0 @@ -//------------------------------------------------------------------------------ -/* - This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. - - Permission to use, copy, modify, and/or distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -*/ -//============================================================================== - -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include - -namespace ripple { - -/* Wallet DB */ - -std::unique_ptr -makeWalletDB(DatabaseCon::Setup const& setup) -{ - // wallet database - return std::make_unique( - setup, WalletDBName, std::array(), WalletDBInit); -} - -std::unique_ptr -makeTestWalletDB(DatabaseCon::Setup const& setup, std::string const& dbname) -{ - // wallet database - return std::make_unique( - setup, dbname.data(), std::array(), WalletDBInit); -} - -void -getManifests( - soci::session& session, - std::string const& dbTable, - ManifestCache& mCache, - beast::Journal j) -{ - // Load manifests stored in database - std::string const sql = "SELECT RawData FROM " + dbTable + ";"; - soci::blob sociRawData(session); - soci::statement st = (session.prepare << sql, soci::into(sociRawData)); - st.execute(); - while (st.fetch()) - { - std::string serialized; - convert(sociRawData, serialized); - if (auto mo = deserializeManifest(serialized)) - { - if (!mo->verify()) - { - JLOG(j.warn()) << "Unverifiable manifest in db"; - continue; - } - - mCache.applyManifest(std::move(*mo)); - } - else - { - JLOG(j.warn()) << "Malformed manifest in database"; - } - } -} - -static void -saveManifest( - soci::session& session, - std::string const& dbTable, - std::string const& serialized) -{ - // soci does not support bulk insertion of blob data - // Do not reuse blob because manifest ecdsa signatures vary in length - // but blob write length is expected to be >= the last write - soci::blob rawData(session); - convert(serialized, rawData); - session << "INSERT INTO " << dbTable << " (RawData) VALUES (:rawData);", - soci::use(rawData); -} - -void -saveManifests( - soci::session& session, - std::string const& dbTable, - std::function const& isTrusted, - hash_map const& map, - beast::Journal j) -{ - soci::transaction tr(session); - session << "DELETE FROM " << dbTable; - for (auto const& v : map) - { - // Save all revocation manifests, - // but only save trusted non-revocation manifests. - if (!v.second.revoked() && !isTrusted(v.second.masterKey)) - { - JLOG(j.info()) << "Untrusted manifest in cache not saved to db"; - continue; - } - - saveManifest(session, dbTable, v.second.serialized); - } - tr.commit(); -} - -void -addValidatorManifest(soci::session& session, std::string const& serialized) -{ - soci::transaction tr(session); - saveManifest(session, "ValidatorManifests", serialized); - tr.commit(); -} - -std::pair -getNodeIdentity(soci::session& session) -{ - { - // SOCI requires boost::optional (not std::optional) as the parameter. - boost::optional pubKO, priKO; - soci::statement st = - (session.prepare - << "SELECT PublicKey, PrivateKey FROM NodeIdentity;", - soci::into(pubKO), - soci::into(priKO)); - st.execute(); - while (st.fetch()) - { - auto const sk = parseBase58( - TokenType::NodePrivate, priKO.value_or("")); - auto const pk = parseBase58( - TokenType::NodePublic, pubKO.value_or("")); - - // Only use if the public and secret keys are a pair - if (sk && pk && (*pk == derivePublicKey(KeyType::secp256k1, *sk))) - return {*pk, *sk}; - } - } - - // If a valid identity wasn't found, we randomly generate a new one: - auto [newpublicKey, newsecretKey] = randomKeyPair(KeyType::secp256k1); - - session << str( - boost::format("INSERT INTO NodeIdentity (PublicKey,PrivateKey) " - "VALUES ('%s','%s');") % - toBase58(TokenType::NodePublic, newpublicKey) % - toBase58(TokenType::NodePrivate, newsecretKey)); - - return {newpublicKey, newsecretKey}; -} - -std::unordered_set, KeyEqual> -getPeerReservationTable(soci::session& session, beast::Journal j) -{ - std::unordered_set, KeyEqual> table; - // These values must be boost::optionals (not std) because SOCI expects - // boost::optionals. - boost::optional valPubKey, valDesc; - // We should really abstract the table and column names into constants, - // but no one else does. Because it is too tedious? It would be easy if we - // had a jOOQ for C++. - soci::statement st = - (session.prepare - << "SELECT PublicKey, Description FROM PeerReservations;", - soci::into(valPubKey), - soci::into(valDesc)); - st.execute(); - while (st.fetch()) - { - if (!valPubKey || !valDesc) - { - // This represents a `NULL` in a `NOT NULL` column. It should be - // unreachable. - continue; - } - auto const optNodeId = - parseBase58(TokenType::NodePublic, *valPubKey); - if (!optNodeId) - { - JLOG(j.warn()) << "load: not a public key: " << valPubKey; - continue; - } - table.insert(PeerReservation{*optNodeId, *valDesc}); - } - - return table; -} - -void -insertPeerReservation( - soci::session& session, - PublicKey const& nodeId, - std::string const& description) -{ - session << "INSERT INTO PeerReservations (PublicKey, Description) " - "VALUES (:nodeId, :desc) " - "ON CONFLICT (PublicKey) DO UPDATE SET " - "Description=excluded.Description", - soci::use(toBase58(TokenType::NodePublic, nodeId)), - soci::use(description); -} - -void -deletePeerReservation(soci::session& session, PublicKey const& nodeId) -{ - session << "DELETE FROM PeerReservations WHERE PublicKey = :nodeId", - soci::use(toBase58(TokenType::NodePublic, nodeId)); -} - -bool -createFeatureVotes(soci::session& session) -{ - soci::transaction tr(session); - std::string sql = - "SELECT count(*) FROM sqlite_master " - "WHERE type='table' AND name='FeatureVotes'"; - // SOCI requires boost::optional (not std::optional) as the parameter. - boost::optional featureVotesCount; - session << sql, soci::into(featureVotesCount); - bool exists = static_cast(*featureVotesCount); - - // Create FeatureVotes table in WalletDB if it doesn't exist - if (!exists) - { - session << "CREATE TABLE FeatureVotes ( " - "AmendmentHash CHARACTER(64) NOT NULL, " - "AmendmentName TEXT, " - "Veto INTEGER NOT NULL );"; - tr.commit(); - } - return exists; -} - -void -readAmendments( - soci::session& session, - std::function amendment_hash, - boost::optional amendment_name, - boost::optional vote)> const& callback) -{ - // lambda that converts the internally stored int to an AmendmentVote. - auto intToVote = [](boost::optional const& dbVote) - -> boost::optional { - return safe_cast(dbVote.value_or(1)); - }; - - soci::transaction tr(session); - std::string sql = - "SELECT AmendmentHash, AmendmentName, Veto FROM FeatureVotes"; - // SOCI requires boost::optional (not std::optional) as parameters. - boost::optional amendment_hash; - boost::optional amendment_name; - boost::optional vote_to_veto; - soci::statement st = - (session.prepare << sql, - soci::into(amendment_hash), - soci::into(amendment_name), - soci::into(vote_to_veto)); - st.execute(); - while (st.fetch()) - { - callback(amendment_hash, amendment_name, intToVote(vote_to_veto)); - } -} - -void -voteAmendment( - soci::session& session, - uint256 const& amendment, - std::string const& name, - AmendmentVote vote) -{ - soci::transaction tr(session); - std::string sql = - "INSERT INTO FeatureVotes (AmendmentHash, AmendmentName, Veto) VALUES " - "('"; - sql += to_string(amendment); - sql += "', '" + name; - sql += "', '" + std::to_string(safe_cast(vote)) + "');"; - session << sql; - tr.commit(); -} - -/* State DB */ - -void -initStateDB( - soci::session& session, - BasicConfig const& config, - std::string const& dbName) -{ - open(session, config, dbName); - - session << "PRAGMA synchronous=FULL;"; - - session << "CREATE TABLE IF NOT EXISTS DbState (" - " Key INTEGER PRIMARY KEY," - " WritableDb TEXT," - " ArchiveDb TEXT," - " LastRotatedLedger INTEGER" - ");"; - - session << "CREATE TABLE IF NOT EXISTS CanDelete (" - " Key INTEGER PRIMARY KEY," - " CanDeleteSeq INTEGER" - ");"; - - std::int64_t count = 0; - { - // SOCI requires boost::optional (not std::optional) as the parameter. - boost::optional countO; - session << "SELECT COUNT(Key) FROM DbState WHERE Key = 1;", - soci::into(countO); - if (!countO) - Throw( - "Failed to fetch Key Count from DbState."); - count = *countO; - } - - if (!count) - { - session << "INSERT INTO DbState VALUES (1, '', '', 0);"; - } - - { - // SOCI requires boost::optional (not std::optional) as the parameter. - boost::optional countO; - session << "SELECT COUNT(Key) FROM CanDelete WHERE Key = 1;", - soci::into(countO); - if (!countO) - Throw( - "Failed to fetch Key Count from CanDelete."); - count = *countO; - } - - if (!count) - { - session << "INSERT INTO CanDelete VALUES (1, 0);"; - } -} - -LedgerIndex -getCanDelete(soci::session& session) -{ - LedgerIndex seq; - session << "SELECT CanDeleteSeq FROM CanDelete WHERE Key = 1;", - soci::into(seq); - ; - return seq; -} - -LedgerIndex -setCanDelete(soci::session& session, LedgerIndex canDelete) -{ - session << "UPDATE CanDelete SET CanDeleteSeq = :canDelete WHERE Key = 1;", - soci::use(canDelete); - return canDelete; -} - -SavedState -getSavedState(soci::session& session) -{ - SavedState state; - session << "SELECT WritableDb, ArchiveDb, LastRotatedLedger" - " FROM DbState WHERE Key = 1;", - soci::into(state.writableDb), soci::into(state.archiveDb), - soci::into(state.lastRotated); - - return state; -} - -void -setSavedState(soci::session& session, SavedState const& state) -{ - session << "UPDATE DbState" - " SET WritableDb = :writableDb," - " ArchiveDb = :archiveDb," - " LastRotatedLedger = :lastRotated" - " WHERE Key = 1;", - soci::use(state.writableDb), soci::use(state.archiveDb), - soci::use(state.lastRotated); -} - -void -setLastRotated(soci::session& session, LedgerIndex seq) -{ - session << "UPDATE DbState SET LastRotatedLedger = :seq" - " WHERE Key = 1;", - soci::use(seq); -} - -/* DatabaseBody DB */ - -std::pair, std::optional> -openDatabaseBodyDb( - DatabaseCon::Setup const& setup, - boost::filesystem::path const& path) -{ - // SOCI requires boost::optional (not std::optional) as the parameter. - boost::optional pathFromDb; - boost::optional size; - - auto conn = std::make_unique( - setup, "Download", DownloaderDBPragma, DatabaseBodyDBInit); - - auto& session = *conn->checkoutDb(); - - session << "SELECT Path FROM Download WHERE Part=0;", - soci::into(pathFromDb); - - // Try to reuse preexisting - // database. - if (pathFromDb) - { - // Can't resuse - database was - // from a different file download. - if (pathFromDb != path.string()) - { - session << "DROP TABLE Download;"; - } - - // Continuing a file download. - else - { - session << "SELECT SUM(LENGTH(Data)) FROM Download;", - soci::into(size); - } - } - - return {std::move(conn), (size ? *size : std::optional())}; -} - -std::uint64_t -databaseBodyDoPut( - soci::session& session, - std::string const& data, - std::string const& path, - std::uint64_t fileSize, - std::uint64_t part, - std::uint16_t maxRowSizePad) -{ - std::uint64_t rowSize = 0; - soci::indicator rti; - - std::uint64_t remainingInRow = 0; - - auto be = - dynamic_cast(session.get_backend()); - BOOST_ASSERT(be); - - // This limits how large we can make the blob - // in each row. Also subtract a pad value to - // account for the other values in the row. - auto const blobMaxSize = - sqlite_api::sqlite3_limit(be->conn_, SQLITE_LIMIT_LENGTH, -1) - - maxRowSizePad; - - std::string newpath; - - auto rowInit = [&] { - session << "INSERT INTO Download VALUES (:path, zeroblob(0), 0, :part)", - soci::use(newpath), soci::use(part); - - remainingInRow = blobMaxSize; - rowSize = 0; - }; - - session << "SELECT Path,Size,Part FROM Download ORDER BY Part DESC " - "LIMIT 1", - soci::into(newpath), soci::into(rowSize), soci::into(part, rti); - - if (!session.got_data()) - { - newpath = path; - rowInit(); - } - else - remainingInRow = blobMaxSize - rowSize; - - auto insert = [&session, &rowSize, &part, &fs = fileSize]( - auto const& data) { - std::uint64_t updatedSize = rowSize + data.size(); - - session << "UPDATE Download SET Data = CAST(Data || :data AS blob), " - "Size = :size WHERE Part = :part;", - soci::use(data), soci::use(updatedSize), soci::use(part); - - fs += data.size(); - }; - - size_t currentBase = 0; - - while (currentBase + remainingInRow < data.size()) - { - if (remainingInRow) - { - insert(data.substr(currentBase, remainingInRow)); - currentBase += remainingInRow; - } - - ++part; - rowInit(); - } - - insert(data.substr(currentBase)); - - return part; -} - -void -databaseBodyFinish(soci::session& session, std::ofstream& fout) -{ - soci::rowset rs = - (session.prepare << "SELECT Data FROM Download ORDER BY PART ASC;"); - - // iteration through the resultset: - for (auto it = rs.begin(); it != rs.end(); ++it) - fout.write(it->data(), it->size()); -} - -/* Vacuum DB */ - -bool -doVacuumDB(DatabaseCon::Setup const& setup) -{ - boost::filesystem::path dbPath = setup.dataDir / TxDBName; - - uintmax_t const dbSize = file_size(dbPath); - assert(dbSize != static_cast(-1)); - - if (auto available = space(dbPath.parent_path()).available; - available < dbSize) - { - std::cerr << "The database filesystem must have at least as " - "much free space as the size of " - << dbPath.string() << ", which is " << dbSize - << " bytes. Only " << available << " bytes are available.\n"; - return false; - } - - auto txnDB = - std::make_unique(setup, TxDBName, TxDBPragma, TxDBInit); - auto& session = txnDB->getSession(); - std::uint32_t pageSize; - - // Only the most trivial databases will fit in memory on typical - // (recommended) software. Force temp files to be written to disk - // regardless of the config settings. - session << boost::format(CommonDBPragmaTemp) % "file"; - session << "PRAGMA page_size;", soci::into(pageSize); - - std::cout << "VACUUM beginning. page_size: " << pageSize << std::endl; - - session << "VACUUM;"; - assert(setup.globalPragma); - for (auto const& p : *setup.globalPragma) - session << p; - session << "PRAGMA page_size;", soci::into(pageSize); - - std::cout << "VACUUM finished. page_size: " << pageSize << std::endl; - - return true; -} - -/* PeerFinder DB */ - -void -initPeerFinderDB( - soci::session& session, - BasicConfig const& config, - beast::Journal j) -{ - DBConfig m_sociConfig(config, "peerfinder"); - m_sociConfig.open(session); - - JLOG(j.info()) << "Opening database at '" << m_sociConfig.connectionString() - << "'"; - - soci::transaction tr(session); - session << "PRAGMA encoding=\"UTF-8\";"; - - session << "CREATE TABLE IF NOT EXISTS SchemaVersion ( " - " name TEXT PRIMARY KEY, " - " version INTEGER" - ");"; - - session << "CREATE TABLE IF NOT EXISTS PeerFinder_BootstrapCache ( " - " id INTEGER PRIMARY KEY AUTOINCREMENT, " - " address TEXT UNIQUE NOT NULL, " - " valence INTEGER" - ");"; - - session << "CREATE INDEX IF NOT EXISTS " - " PeerFinder_BootstrapCache_Index ON " - "PeerFinder_BootstrapCache " - " ( " - " address " - " ); "; - - tr.commit(); -} - -void -updatePeerFinderDB( - soci::session& session, - int currentSchemaVersion, - beast::Journal j) -{ - soci::transaction tr(session); - // get version - int version(0); - { - // SOCI requires a boost::optional (not std::optional) parameter. - boost::optional vO; - session << "SELECT " - " version " - "FROM SchemaVersion WHERE " - " name = 'PeerFinder';", - soci::into(vO); - - version = vO.value_or(0); - - JLOG(j.info()) << "Opened version " << version << " database"; - } - - { - if (version < currentSchemaVersion) - { - JLOG(j.info()) << "Updating database to version " - << currentSchemaVersion; - } - else if (version > currentSchemaVersion) - { - Throw( - "The PeerFinder database version is higher than expected"); - } - } - - if (version < 4) - { - // - // Remove the "uptime" column from the bootstrap table - // - - session << "CREATE TABLE IF NOT EXISTS " - "PeerFinder_BootstrapCache_Next ( " - " id INTEGER PRIMARY KEY AUTOINCREMENT, " - " address TEXT UNIQUE NOT NULL, " - " valence INTEGER" - ");"; - - session << "CREATE INDEX IF NOT EXISTS " - " PeerFinder_BootstrapCache_Next_Index ON " - " PeerFinder_BootstrapCache_Next " - " ( address ); "; - - std::size_t count; - session << "SELECT COUNT(*) FROM PeerFinder_BootstrapCache;", - soci::into(count); - - std::vector list; - - { - list.reserve(count); - std::string s; - int valence; - soci::statement st = - (session.prepare << "SELECT " - " address, " - " valence " - "FROM PeerFinder_BootstrapCache;", - soci::into(s), - soci::into(valence)); - - st.execute(); - while (st.fetch()) - { - PeerFinder::Store::Entry entry; - entry.endpoint = beast::IP::Endpoint::from_string(s); - if (!is_unspecified(entry.endpoint)) - { - entry.valence = valence; - list.push_back(entry); - } - else - { - JLOG(j.error()) << "Bad address string '" << s - << "' in Bootcache table"; - } - } - } - - if (!list.empty()) - { - std::vector s; - std::vector valence; - s.reserve(list.size()); - valence.reserve(list.size()); - - for (auto iter(list.cbegin()); iter != list.cend(); ++iter) - { - s.emplace_back(to_string(iter->endpoint)); - valence.emplace_back(iter->valence); - } - - session << "INSERT INTO PeerFinder_BootstrapCache_Next ( " - " address, " - " valence " - ") VALUES ( " - " :s, :valence" - ");", - soci::use(s), soci::use(valence); - } - - session << "DROP TABLE IF EXISTS PeerFinder_BootstrapCache;"; - - session << "DROP INDEX IF EXISTS PeerFinder_BootstrapCache_Index;"; - - session << "ALTER TABLE PeerFinder_BootstrapCache_Next " - " RENAME TO PeerFinder_BootstrapCache;"; - - session << "CREATE INDEX IF NOT EXISTS " - " PeerFinder_BootstrapCache_Index ON " - "PeerFinder_BootstrapCache " - " ( " - " address " - " ); "; - } - - if (version < 3) - { - // - // Remove legacy endpoints from the schema - // - - session << "DROP TABLE IF EXISTS LegacyEndpoints;"; - - session << "DROP TABLE IF EXISTS PeerFinderLegacyEndpoints;"; - - session << "DROP TABLE IF EXISTS PeerFinder_LegacyEndpoints;"; - - session << "DROP TABLE IF EXISTS PeerFinder_LegacyEndpoints_Index;"; - } - - { - int const v(currentSchemaVersion); - session << "INSERT OR REPLACE INTO SchemaVersion (" - " name " - " ,version " - ") VALUES ( " - " 'PeerFinder', :version " - ");", - soci::use(v); - } - - tr.commit(); -} - -void -readPeerFinderDB( - soci::session& session, - std::function const& func) -{ - std::string s; - int valence; - soci::statement st = - (session.prepare << "SELECT " - " address, " - " valence " - "FROM PeerFinder_BootstrapCache;", - soci::into(s), - soci::into(valence)); - - st.execute(); - while (st.fetch()) - { - func(s, valence); - } -} - -void -savePeerFinderDB( - soci::session& session, - std::vector const& v) -{ - soci::transaction tr(session); - session << "DELETE FROM PeerFinder_BootstrapCache;"; - - if (!v.empty()) - { - std::vector s; - std::vector valence; - s.reserve(v.size()); - valence.reserve(v.size()); - - for (auto const& e : v) - { - s.emplace_back(to_string(e.endpoint)); - valence.emplace_back(e.valence); - } - - session << "INSERT INTO PeerFinder_BootstrapCache ( " - " address, " - " valence " - ") VALUES ( " - " :s, :valence " - ");", - soci::use(s), soci::use(valence); - } - - tr.commit(); -} - -} // namespace ripple diff --git a/src/ripple/app/rdb/impl/RelationalDBInterface.cpp b/src/ripple/app/rdb/impl/RelationalDatabase.cpp similarity index 76% rename from src/ripple/app/rdb/impl/RelationalDBInterface.cpp rename to src/ripple/app/rdb/impl/RelationalDatabase.cpp index 1ef456bcb5f..8a3ce5b016d 100644 --- a/src/ripple/app/rdb/impl/RelationalDBInterface.cpp +++ b/src/ripple/app/rdb/impl/RelationalDatabase.cpp @@ -18,26 +18,20 @@ //============================================================================== #include -#include +#include #include #include namespace ripple { -extern std::unique_ptr -getRelationalDBInterfaceSqlite( - Application& app, - Config const& config, - JobQueue& jobQueue); +extern std::unique_ptr +getSQLiteDatabase(Application& app, Config const& config, JobQueue& jobQueue); -extern std::unique_ptr -getRelationalDBInterfacePostgres( - Application& app, - Config const& config, - JobQueue& jobQueue); +extern std::unique_ptr +getPostgresDatabase(Application& app, Config const& config, JobQueue& jobQueue); -std::unique_ptr -RelationalDBInterface::init( +std::unique_ptr +RelationalDatabase::init( Application& app, Config const& config, JobQueue& jobQueue) @@ -73,14 +67,14 @@ RelationalDBInterface::init( if (use_sqlite) { - return getRelationalDBInterfaceSqlite(app, config, jobQueue); + return getSQLiteDatabase(app, config, jobQueue); } else if (use_postgres) { - return getRelationalDBInterfacePostgres(app, config, jobQueue); + return getPostgresDatabase(app, config, jobQueue); } - return std::unique_ptr(); + return std::unique_ptr(); } } // namespace ripple diff --git a/src/ripple/app/rdb/impl/ShardArchive.cpp b/src/ripple/app/rdb/impl/ShardArchive.cpp new file mode 100644 index 00000000000..6880aa00136 --- /dev/null +++ b/src/ripple/app/rdb/impl/ShardArchive.cpp @@ -0,0 +1,68 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include + +namespace ripple { + +std::unique_ptr +makeArchiveDB(boost::filesystem::path const& dir, std::string const& dbName) +{ + return std::make_unique( + dir, dbName, DownloaderDBPragma, ShardArchiveHandlerDBInit); +} + +void +readArchiveDB( + DatabaseCon& db, + std::function const& func) +{ + soci::rowset rs = + (db.getSession().prepare << "SELECT * FROM State;"); + + for (auto it = rs.begin(); it != rs.end(); ++it) + { + func(it->get(1), it->get(0)); + } +} + +void +insertArchiveDB( + DatabaseCon& db, + std::uint32_t shardIndex, + std::string const& url) +{ + db.getSession() << "INSERT INTO State VALUES (:index, :url);", + soci::use(shardIndex), soci::use(url); +} + +void +deleteFromArchiveDB(DatabaseCon& db, std::uint32_t shardIndex) +{ + db.getSession() << "DELETE FROM State WHERE ShardIndex = :index;", + soci::use(shardIndex); +} + +void +dropArchiveDB(DatabaseCon& db) +{ + db.getSession() << "DROP TABLE State;"; +} + +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/State.cpp b/src/ripple/app/rdb/impl/State.cpp new file mode 100644 index 00000000000..8f8beb0c7e1 --- /dev/null +++ b/src/ripple/app/rdb/impl/State.cpp @@ -0,0 +1,130 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include + +namespace ripple { + +void +initStateDB( + soci::session& session, + BasicConfig const& config, + std::string const& dbName) +{ + open(session, config, dbName); + + session << "PRAGMA synchronous=FULL;"; + + session << "CREATE TABLE IF NOT EXISTS DbState (" + " Key INTEGER PRIMARY KEY," + " WritableDb TEXT," + " ArchiveDb TEXT," + " LastRotatedLedger INTEGER" + ");"; + + session << "CREATE TABLE IF NOT EXISTS CanDelete (" + " Key INTEGER PRIMARY KEY," + " CanDeleteSeq INTEGER" + ");"; + + std::int64_t count = 0; + { + // SOCI requires boost::optional (not std::optional) as the parameter. + boost::optional countO; + session << "SELECT COUNT(Key) FROM DbState WHERE Key = 1;", + soci::into(countO); + if (!countO) + Throw( + "Failed to fetch Key Count from DbState."); + count = *countO; + } + + if (!count) + { + session << "INSERT INTO DbState VALUES (1, '', '', 0);"; + } + + { + // SOCI requires boost::optional (not std::optional) as the parameter. + boost::optional countO; + session << "SELECT COUNT(Key) FROM CanDelete WHERE Key = 1;", + soci::into(countO); + if (!countO) + Throw( + "Failed to fetch Key Count from CanDelete."); + count = *countO; + } + + if (!count) + { + session << "INSERT INTO CanDelete VALUES (1, 0);"; + } +} + +LedgerIndex +getCanDelete(soci::session& session) +{ + LedgerIndex seq; + session << "SELECT CanDeleteSeq FROM CanDelete WHERE Key = 1;", + soci::into(seq); + ; + return seq; +} + +LedgerIndex +setCanDelete(soci::session& session, LedgerIndex canDelete) +{ + session << "UPDATE CanDelete SET CanDeleteSeq = :canDelete WHERE Key = 1;", + soci::use(canDelete); + return canDelete; +} + +SavedState +getSavedState(soci::session& session) +{ + SavedState state; + session << "SELECT WritableDb, ArchiveDb, LastRotatedLedger" + " FROM DbState WHERE Key = 1;", + soci::into(state.writableDb), soci::into(state.archiveDb), + soci::into(state.lastRotated); + + return state; +} + +void +setSavedState(soci::session& session, SavedState const& state) +{ + session << "UPDATE DbState" + " SET WritableDb = :writableDb," + " ArchiveDb = :archiveDb," + " LastRotatedLedger = :lastRotated" + " WHERE Key = 1;", + soci::use(state.writableDb), soci::use(state.archiveDb), + soci::use(state.lastRotated); +} + +void +setLastRotated(soci::session& session, LedgerIndex seq) +{ + session << "UPDATE DbState SET LastRotatedLedger = :seq" + " WHERE Key = 1;", + soci::use(seq); +} + +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/RelationalDBInterface_shards.cpp b/src/ripple/app/rdb/impl/UnitaryShard.cpp similarity index 68% rename from src/ripple/app/rdb/impl/RelationalDBInterface_shards.cpp rename to src/ripple/app/rdb/impl/UnitaryShard.cpp index acda4ea1d4a..129343571dd 100644 --- a/src/ripple/app/rdb/impl/RelationalDBInterface_shards.cpp +++ b/src/ripple/app/rdb/impl/UnitaryShard.cpp @@ -1,7 +1,7 @@ //------------------------------------------------------------------------------ /* This file is part of rippled: https://github.com/ripple/rippled - Copyright (c) 2020 Ripple Labs Inc. + Copyright (c) 2021 Ripple Labs Inc. Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above @@ -10,152 +10,20 @@ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ //============================================================================== -#include -#include -#include -#include -#include -#include +#include #include -#include -#include -#include -#include +#include #include namespace ripple { -DatabasePair -makeMetaDBs( - Config const& config, - DatabaseCon::Setup const& setup, - DatabaseCon::CheckpointerSetup const& checkpointerSetup) -{ - // ledger meta database - auto lgrMetaDB{std::make_unique( - setup, - LgrMetaDBName, - LgrMetaDBPragma, - LgrMetaDBInit, - checkpointerSetup)}; - - if (config.useTxTables()) - { - // transaction meta database - auto txMetaDB{std::make_unique( - setup, - TxMetaDBName, - TxMetaDBPragma, - TxMetaDBInit, - checkpointerSetup)}; - - return {std::move(lgrMetaDB), std::move(txMetaDB)}; - } - - return {std::move(lgrMetaDB), nullptr}; -} - -bool -saveLedgerMeta( - std::shared_ptr const& ledger, - Application& app, - soci::session& lgrMetaSession, - soci::session& txnMetaSession, - std::uint32_t const shardIndex) -{ - std::string_view constexpr lgrSQL = - R"sql(INSERT OR REPLACE INTO LedgerMeta VALUES - (:ledgerHash,:shardIndex);)sql"; - - auto const hash = to_string(ledger->info().hash); - lgrMetaSession << lgrSQL, soci::use(hash), soci::use(shardIndex); - - if (app.config().useTxTables()) - { - AcceptedLedger::pointer const aLedger = [&app, ledger] { - try - { - auto aLedger = - app.getAcceptedLedgerCache().fetch(ledger->info().hash); - if (!aLedger) - { - aLedger = std::make_shared(ledger, app); - app.getAcceptedLedgerCache().canonicalize_replace_client( - ledger->info().hash, aLedger); - } - - return aLedger; - } - catch (std::exception const&) - { - JLOG(app.journal("Ledger").warn()) - << "An accepted ledger was missing nodes"; - } - - return AcceptedLedger::pointer{nullptr}; - }(); - - if (!aLedger) - return false; - - soci::transaction tr(txnMetaSession); - - for (auto const& [_, acceptedLedgerTx] : aLedger->getMap()) - { - (void)_; - - std::string_view constexpr txnSQL = - R"sql(INSERT OR REPLACE INTO TransactionMeta VALUES - (:transactionID,:shardIndex);)sql"; - - auto const transactionID = - to_string(acceptedLedgerTx->getTransactionID()); - - txnMetaSession << txnSQL, soci::use(transactionID), - soci::use(shardIndex); - } - - tr.commit(); - } - - return true; -} - -std::optional -getShardIndexforLedger(soci::session& session, LedgerHash const& hash) -{ - std::uint32_t shardIndex; - session << "SELECT ShardIndex FROM LedgerMeta WHERE LedgerHash = '" << hash - << "';", - soci::into(shardIndex); - - if (!session.got_data()) - return std::nullopt; - - return shardIndex; -} - -std::optional -getShardIndexforTransaction(soci::session& session, TxID const& id) -{ - std::uint32_t shardIndex; - session << "SELECT ShardIndex FROM TransactionMeta WHERE TransID = '" << id - << "';", - soci::into(shardIndex); - - if (!session.got_data()) - return std::nullopt; - - return shardIndex; -} - DatabasePair makeShardCompleteLedgerDBs( Config const& config, @@ -334,8 +202,6 @@ updateLedgerDBs( return true; } -/* Shard acquire db */ - std::unique_ptr makeAcquireDB( DatabaseCon::Setup const& setup, @@ -447,50 +313,4 @@ updateAcquireDB( } } -/* Archive DB */ - -std::unique_ptr -makeArchiveDB(boost::filesystem::path const& dir, std::string const& dbName) -{ - return std::make_unique( - dir, dbName, DownloaderDBPragma, ShardArchiveHandlerDBInit); -} - -void -readArchiveDB( - DatabaseCon& db, - std::function const& func) -{ - soci::rowset rs = - (db.getSession().prepare << "SELECT * FROM State;"); - - for (auto it = rs.begin(); it != rs.end(); ++it) - { - func(it->get(1), it->get(0)); - } -} - -void -insertArchiveDB( - DatabaseCon& db, - std::uint32_t shardIndex, - std::string const& url) -{ - db.getSession() << "INSERT INTO State VALUES (:index, :url);", - soci::use(shardIndex), soci::use(url); -} - -void -deleteFromArchiveDB(DatabaseCon& db, std::uint32_t shardIndex) -{ - db.getSession() << "DELETE FROM State WHERE ShardIndex = :index;", - soci::use(shardIndex); -} - -void -dropArchiveDB(DatabaseCon& db) -{ - db.getSession() << "DROP TABLE State;"; -} - } // namespace ripple diff --git a/src/ripple/app/rdb/impl/Vacuum.cpp b/src/ripple/app/rdb/impl/Vacuum.cpp new file mode 100644 index 00000000000..aad456cc5a8 --- /dev/null +++ b/src/ripple/app/rdb/impl/Vacuum.cpp @@ -0,0 +1,67 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include +#include + +namespace ripple { + +bool +doVacuumDB(DatabaseCon::Setup const& setup) +{ + boost::filesystem::path dbPath = setup.dataDir / TxDBName; + + uintmax_t const dbSize = file_size(dbPath); + assert(dbSize != static_cast(-1)); + + if (auto available = space(dbPath.parent_path()).available; + available < dbSize) + { + std::cerr << "The database filesystem must have at least as " + "much free space as the size of " + << dbPath.string() << ", which is " << dbSize + << " bytes. Only " << available << " bytes are available.\n"; + return false; + } + + auto txnDB = + std::make_unique(setup, TxDBName, TxDBPragma, TxDBInit); + auto& session = txnDB->getSession(); + std::uint32_t pageSize; + + // Only the most trivial databases will fit in memory on typical + // (recommended) hardware. Force temp files to be written to disk + // regardless of the config settings. + session << boost::format(CommonDBPragmaTemp) % "file"; + session << "PRAGMA page_size;", soci::into(pageSize); + + std::cout << "VACUUM beginning. page_size: " << pageSize << std::endl; + + session << "VACUUM;"; + assert(setup.globalPragma); + for (auto const& p : *setup.globalPragma) + session << p; + session << "PRAGMA page_size;", soci::into(pageSize); + + std::cout << "VACUUM finished. page_size: " << pageSize << std::endl; + + return true; +} + +} // namespace ripple diff --git a/src/ripple/app/rdb/impl/Wallet.cpp b/src/ripple/app/rdb/impl/Wallet.cpp new file mode 100644 index 00000000000..c6040964bde --- /dev/null +++ b/src/ripple/app/rdb/impl/Wallet.cpp @@ -0,0 +1,292 @@ +//------------------------------------------------------------------------------ +/* + This file is part of rippled: https://github.com/ripple/rippled + Copyright (c) 2021 Ripple Labs Inc. + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ +//============================================================================== + +#include +#include + +namespace ripple { + +std::unique_ptr +makeWalletDB(DatabaseCon::Setup const& setup) +{ + // wallet database + return std::make_unique( + setup, WalletDBName, std::array(), WalletDBInit); +} + +std::unique_ptr +makeTestWalletDB(DatabaseCon::Setup const& setup, std::string const& dbname) +{ + // wallet database + return std::make_unique( + setup, dbname.data(), std::array(), WalletDBInit); +} + +void +getManifests( + soci::session& session, + std::string const& dbTable, + ManifestCache& mCache, + beast::Journal j) +{ + // Load manifests stored in database + std::string const sql = "SELECT RawData FROM " + dbTable + ";"; + soci::blob sociRawData(session); + soci::statement st = (session.prepare << sql, soci::into(sociRawData)); + st.execute(); + while (st.fetch()) + { + std::string serialized; + convert(sociRawData, serialized); + if (auto mo = deserializeManifest(serialized)) + { + if (!mo->verify()) + { + JLOG(j.warn()) << "Unverifiable manifest in db"; + continue; + } + + mCache.applyManifest(std::move(*mo)); + } + else + { + JLOG(j.warn()) << "Malformed manifest in database"; + } + } +} + +static void +saveManifest( + soci::session& session, + std::string const& dbTable, + std::string const& serialized) +{ + // soci does not support bulk insertion of blob data + // Do not reuse blob because manifest ecdsa signatures vary in length + // but blob write length is expected to be >= the last write + soci::blob rawData(session); + convert(serialized, rawData); + session << "INSERT INTO " << dbTable << " (RawData) VALUES (:rawData);", + soci::use(rawData); +} + +void +saveManifests( + soci::session& session, + std::string const& dbTable, + std::function const& isTrusted, + hash_map const& map, + beast::Journal j) +{ + soci::transaction tr(session); + session << "DELETE FROM " << dbTable; + for (auto const& v : map) + { + // Save all revocation manifests, + // but only save trusted non-revocation manifests. + if (!v.second.revoked() && !isTrusted(v.second.masterKey)) + { + JLOG(j.info()) << "Untrusted manifest in cache not saved to db"; + continue; + } + + saveManifest(session, dbTable, v.second.serialized); + } + tr.commit(); +} + +void +addValidatorManifest(soci::session& session, std::string const& serialized) +{ + soci::transaction tr(session); + saveManifest(session, "ValidatorManifests", serialized); + tr.commit(); +} + +std::pair +getNodeIdentity(soci::session& session) +{ + { + // SOCI requires boost::optional (not std::optional) as the parameter. + boost::optional pubKO, priKO; + soci::statement st = + (session.prepare + << "SELECT PublicKey, PrivateKey FROM NodeIdentity;", + soci::into(pubKO), + soci::into(priKO)); + st.execute(); + while (st.fetch()) + { + auto const sk = parseBase58( + TokenType::NodePrivate, priKO.value_or("")); + auto const pk = parseBase58( + TokenType::NodePublic, pubKO.value_or("")); + + // Only use if the public and secret keys are a pair + if (sk && pk && (*pk == derivePublicKey(KeyType::secp256k1, *sk))) + return {*pk, *sk}; + } + } + + // If a valid identity wasn't found, we randomly generate a new one: + auto [newpublicKey, newsecretKey] = randomKeyPair(KeyType::secp256k1); + + session << str( + boost::format("INSERT INTO NodeIdentity (PublicKey,PrivateKey) " + "VALUES ('%s','%s');") % + toBase58(TokenType::NodePublic, newpublicKey) % + toBase58(TokenType::NodePrivate, newsecretKey)); + + return {newpublicKey, newsecretKey}; +} + +std::unordered_set, KeyEqual> +getPeerReservationTable(soci::session& session, beast::Journal j) +{ + std::unordered_set, KeyEqual> table; + // These values must be boost::optionals (not std) because SOCI expects + // boost::optionals. + boost::optional valPubKey, valDesc; + // We should really abstract the table and column names into constants, + // but no one else does. Because it is too tedious? It would be easy if we + // had a jOOQ for C++. + soci::statement st = + (session.prepare + << "SELECT PublicKey, Description FROM PeerReservations;", + soci::into(valPubKey), + soci::into(valDesc)); + st.execute(); + while (st.fetch()) + { + if (!valPubKey || !valDesc) + { + // This represents a `NULL` in a `NOT NULL` column. It should be + // unreachable. + continue; + } + auto const optNodeId = + parseBase58(TokenType::NodePublic, *valPubKey); + if (!optNodeId) + { + JLOG(j.warn()) << "load: not a public key: " << valPubKey; + continue; + } + table.insert(PeerReservation{*optNodeId, *valDesc}); + } + + return table; +} + +void +insertPeerReservation( + soci::session& session, + PublicKey const& nodeId, + std::string const& description) +{ + session << "INSERT INTO PeerReservations (PublicKey, Description) " + "VALUES (:nodeId, :desc) " + "ON CONFLICT (PublicKey) DO UPDATE SET " + "Description=excluded.Description", + soci::use(toBase58(TokenType::NodePublic, nodeId)), + soci::use(description); +} + +void +deletePeerReservation(soci::session& session, PublicKey const& nodeId) +{ + session << "DELETE FROM PeerReservations WHERE PublicKey = :nodeId", + soci::use(toBase58(TokenType::NodePublic, nodeId)); +} + +bool +createFeatureVotes(soci::session& session) +{ + soci::transaction tr(session); + std::string sql = + "SELECT count(*) FROM sqlite_master " + "WHERE type='table' AND name='FeatureVotes'"; + // SOCI requires boost::optional (not std::optional) as the parameter. + boost::optional featureVotesCount; + session << sql, soci::into(featureVotesCount); + bool exists = static_cast(*featureVotesCount); + + // Create FeatureVotes table in WalletDB if it doesn't exist + if (!exists) + { + session << "CREATE TABLE FeatureVotes ( " + "AmendmentHash CHARACTER(64) NOT NULL, " + "AmendmentName TEXT, " + "Veto INTEGER NOT NULL );"; + tr.commit(); + } + return exists; +} + +void +readAmendments( + soci::session& session, + std::function amendment_hash, + boost::optional amendment_name, + boost::optional vote)> const& callback) +{ + // lambda that converts the internally stored int to an AmendmentVote. + auto intToVote = [](boost::optional const& dbVote) + -> boost::optional { + return safe_cast(dbVote.value_or(1)); + }; + + soci::transaction tr(session); + std::string sql = + "SELECT AmendmentHash, AmendmentName, Veto FROM FeatureVotes"; + // SOCI requires boost::optional (not std::optional) as parameters. + boost::optional amendment_hash; + boost::optional amendment_name; + boost::optional vote_to_veto; + soci::statement st = + (session.prepare << sql, + soci::into(amendment_hash), + soci::into(amendment_name), + soci::into(vote_to_veto)); + st.execute(); + while (st.fetch()) + { + callback(amendment_hash, amendment_name, intToVote(vote_to_veto)); + } +} + +void +voteAmendment( + soci::session& session, + uint256 const& amendment, + std::string const& name, + AmendmentVote vote) +{ + soci::transaction tr(session); + std::string sql = + "INSERT INTO FeatureVotes (AmendmentHash, AmendmentName, Veto) VALUES " + "('"; + sql += to_string(amendment); + sql += "', '" + name; + sql += "', '" + std::to_string(safe_cast(vote)) + "');"; + session << sql; + tr.commit(); +} + +} // namespace ripple diff --git a/src/ripple/app/reporting/ReportingETL.cpp b/src/ripple/app/reporting/ReportingETL.cpp index 3008ae78253..52958045d11 100644 --- a/src/ripple/app/reporting/ReportingETL.cpp +++ b/src/ripple/app/reporting/ReportingETL.cpp @@ -17,7 +17,7 @@ */ //============================================================================== -#include +#include #include #include @@ -167,8 +167,7 @@ ReportingETL::loadInitialLedger(uint32_t startingSequence) if (app_.config().reporting()) { #ifdef RIPPLED_REPORTING - dynamic_cast( - &app_.getRelationalDBInterface()) + dynamic_cast(&app_.getRelationalDatabase()) ->writeLedgerAndTransactions(ledger->info(), accountTxData); #endif } @@ -595,69 +594,69 @@ ReportingETL::runETLPipeline(uint32_t startSequence) loadQueue.push({}); }}; - std::thread loader{ - [this, &lastPublishedSequence, &loadQueue, &writeConflict]() { - beast::setCurrentThreadName("rippled: ReportingETL load"); - size_t totalTransactions = 0; - double totalTime = 0; - while (!writeConflict) - { - std::optional, - std::vector>> - result{loadQueue.pop()}; - // if result is an empty optional, the transformer thread has - // stopped and the loader should stop as well - if (!result) - break; - if (isStopping()) - continue; - - auto& ledger = result->first; - auto& accountTxData = result->second; - - auto start = std::chrono::system_clock::now(); - // write to the key-value store - flushLedger(ledger); - - auto mid = std::chrono::system_clock::now(); + std::thread loader{[this, + &lastPublishedSequence, + &loadQueue, + &writeConflict]() { + beast::setCurrentThreadName("rippled: ReportingETL load"); + size_t totalTransactions = 0; + double totalTime = 0; + while (!writeConflict) + { + std::optional, + std::vector>> + result{loadQueue.pop()}; + // if result is an empty optional, the transformer thread has + // stopped and the loader should stop as well + if (!result) + break; + if (isStopping()) + continue; + + auto& ledger = result->first; + auto& accountTxData = result->second; + + auto start = std::chrono::system_clock::now(); + // write to the key-value store + flushLedger(ledger); + + auto mid = std::chrono::system_clock::now(); // write to RDBMS // if there is a write conflict, some other process has already // written this ledger and has taken over as the ETL writer #ifdef RIPPLED_REPORTING - if (!dynamic_cast( - &app_.getRelationalDBInterface()) - ->writeLedgerAndTransactions( - ledger->info(), accountTxData)) - writeConflict = true; + if (!dynamic_cast(&app_.getRelationalDatabase()) + ->writeLedgerAndTransactions( + ledger->info(), accountTxData)) + writeConflict = true; #endif - auto end = std::chrono::system_clock::now(); + auto end = std::chrono::system_clock::now(); - if (!writeConflict) - { - publishLedger(ledger); - lastPublishedSequence = ledger->info().seq; - } - // print some performance numbers - auto kvTime = ((mid - start).count()) / 1000000000.0; - auto relationalTime = ((end - mid).count()) / 1000000000.0; - - size_t numTxns = accountTxData.size(); - totalTime += kvTime; - totalTransactions += numTxns; - JLOG(journal_.info()) - << "Load phase of etl : " - << "Successfully published ledger! Ledger info: " - << detail::toString(ledger->info()) - << ". txn count = " << numTxns - << ". key-value write time = " << kvTime - << ". relational write time = " << relationalTime - << ". key-value tps = " << numTxns / kvTime - << ". relational tps = " << numTxns / relationalTime - << ". total key-value tps = " - << totalTransactions / totalTime; + if (!writeConflict) + { + publishLedger(ledger); + lastPublishedSequence = ledger->info().seq; } - }}; + // print some performance numbers + auto kvTime = ((mid - start).count()) / 1000000000.0; + auto relationalTime = ((end - mid).count()) / 1000000000.0; + + size_t numTxns = accountTxData.size(); + totalTime += kvTime; + totalTransactions += numTxns; + JLOG(journal_.info()) + << "Load phase of etl : " + << "Successfully published ledger! Ledger info: " + << detail::toString(ledger->info()) + << ". txn count = " << numTxns + << ". key-value write time = " << kvTime + << ". relational write time = " << relationalTime + << ". key-value tps = " << numTxns / kvTime + << ". relational tps = " << numTxns / relationalTime + << ". total key-value tps = " << totalTransactions / totalTime; + } + }}; // wait for all of the threads to stop loader.join(); diff --git a/src/ripple/app/reporting/ReportingETL.h b/src/ripple/app/reporting/ReportingETL.h index 540cc5bfd3d..71e08adf1f3 100644 --- a/src/ripple/app/reporting/ReportingETL.h +++ b/src/ripple/app/reporting/ReportingETL.h @@ -21,7 +21,7 @@ #define RIPPLE_APP_REPORTING_REPORTINGETL_H_INCLUDED #include -#include +#include #include #include #include @@ -50,7 +50,7 @@ #include namespace ripple { -using AccountTransactionsData = RelationalDBInterface::AccountTransactionsData; +using AccountTransactionsData = RelationalDatabase::AccountTransactionsData; /** * This class is responsible for continuously extracting data from a diff --git a/src/ripple/net/impl/DatabaseBody.ipp b/src/ripple/net/impl/DatabaseBody.ipp index 061a630255c..cdc7da2bc41 100644 --- a/src/ripple/net/impl/DatabaseBody.ipp +++ b/src/ripple/net/impl/DatabaseBody.ipp @@ -17,7 +17,7 @@ */ //============================================================================== -#include +#include namespace ripple { diff --git a/src/ripple/nodestore/impl/DatabaseShardImp.cpp b/src/ripple/nodestore/impl/DatabaseShardImp.cpp index 1dc5dab6c5f..bf1f2b5b8cb 100644 --- a/src/ripple/nodestore/impl/DatabaseShardImp.cpp +++ b/src/ripple/nodestore/impl/DatabaseShardImp.cpp @@ -20,7 +20,7 @@ #include #include #include -#include +#include #include #include #include @@ -799,14 +799,12 @@ DatabaseShardImp::doImportDatabase() std::optional info; if (sortOrder == std::string("asc")) { - info = dynamic_cast( - &app_.getRelationalDBInterface()) + info = dynamic_cast(&app_.getRelationalDatabase()) ->getLimitedOldestLedgerInfo(earliestLedgerSeq()); } else { - info = dynamic_cast( - &app_.getRelationalDBInterface()) + info = dynamic_cast(&app_.getRelationalDatabase()) ->getLimitedNewestLedgerInfo(earliestLedgerSeq()); } if (info) @@ -925,7 +923,7 @@ DatabaseShardImp::doImportDatabase() // Verify SQLite ledgers are in the node store { auto const ledgerHashes{ - app_.getRelationalDBInterface().getHashesByIndex( + app_.getRelationalDatabase().getHashesByIndex( firstSeq, lastSeq)}; if (ledgerHashes.size() != maxLedgers(shardIndex)) continue; @@ -2025,6 +2023,13 @@ DatabaseShardImp::callForLedgerSQLByLedgerSeq( LedgerIndex ledgerSeq, std::function const& callback) { + if (ledgerSeq < earliestLedgerSeq_) + { + JLOG(j_.warn()) << "callForLedgerSQLByLedgerSeq ledger seq too early: " + << ledgerSeq; + return false; + } + return callForLedgerSQLByShardIndex(seqToShardIndex(ledgerSeq), callback); } diff --git a/src/ripple/nodestore/impl/Shard.cpp b/src/ripple/nodestore/impl/Shard.cpp index dc5033c969b..911eedef6b5 100644 --- a/src/ripple/nodestore/impl/Shard.cpp +++ b/src/ripple/nodestore/impl/Shard.cpp @@ -19,8 +19,7 @@ #include #include -#include -#include +#include #include #include #include @@ -28,9 +27,6 @@ #include #include -#include -#include - namespace ripple { namespace NodeStore { diff --git a/src/ripple/nodestore/impl/Shard.h b/src/ripple/nodestore/impl/Shard.h index 17001a6b829..b7516e5f1e6 100644 --- a/src/ripple/nodestore/impl/Shard.h +++ b/src/ripple/nodestore/impl/Shard.h @@ -21,7 +21,7 @@ #define RIPPLE_NODESTORE_SHARD_H_INCLUDED #include -#include +#include #include #include #include diff --git a/src/ripple/overlay/impl/OverlayImpl.cpp b/src/ripple/overlay/impl/OverlayImpl.cpp index 47e03a76b19..6ed046f0403 100644 --- a/src/ripple/overlay/impl/OverlayImpl.cpp +++ b/src/ripple/overlay/impl/OverlayImpl.cpp @@ -22,8 +22,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include diff --git a/src/ripple/overlay/impl/PeerReservationTable.cpp b/src/ripple/overlay/impl/PeerReservationTable.cpp index 6e88da123f3..6f39d12e99c 100644 --- a/src/ripple/overlay/impl/PeerReservationTable.cpp +++ b/src/ripple/overlay/impl/PeerReservationTable.cpp @@ -19,8 +19,8 @@ #include -#include -#include +#include +#include #include #include #include diff --git a/src/ripple/peerfinder/impl/StoreSqdb.h b/src/ripple/peerfinder/impl/StoreSqdb.h index 7d43136ae96..879bee83b6f 100644 --- a/src/ripple/peerfinder/impl/StoreSqdb.h +++ b/src/ripple/peerfinder/impl/StoreSqdb.h @@ -20,7 +20,7 @@ #ifndef RIPPLE_PEERFINDER_STORESQDB_H_INCLUDED #define RIPPLE_PEERFINDER_STORESQDB_H_INCLUDED -#include +#include #include #include #include diff --git a/src/ripple/rpc/handlers/AccountTx.cpp b/src/ripple/rpc/handlers/AccountTx.cpp index e383b66feed..e5e7d54382a 100644 --- a/src/ripple/rpc/handlers/AccountTx.cpp +++ b/src/ripple/rpc/handlers/AccountTx.cpp @@ -21,8 +21,8 @@ #include #include #include -#include -#include +#include +#include #include #include #include @@ -42,14 +42,14 @@ namespace ripple { -using TxnsData = RelationalDBInterface::AccountTxs; -using TxnsDataBinary = RelationalDBInterface::MetaTxsList; -using TxnDataBinary = RelationalDBInterface::txnMetaLedgerType; -using AccountTxArgs = RelationalDBInterface::AccountTxArgs; -using AccountTxResult = RelationalDBInterface::AccountTxResult; +using TxnsData = RelationalDatabase::AccountTxs; +using TxnsDataBinary = RelationalDatabase::MetaTxsList; +using TxnDataBinary = RelationalDatabase::txnMetaLedgerType; +using AccountTxArgs = RelationalDatabase::AccountTxArgs; +using AccountTxResult = RelationalDatabase::AccountTxResult; -using LedgerShortcut = RelationalDBInterface::LedgerShortcut; -using LedgerSpecifier = RelationalDBInterface::LedgerSpecifier; +using LedgerShortcut = RelationalDatabase::LedgerShortcut; +using LedgerSpecifier = RelationalDatabase::LedgerSpecifier; // parses args into a ledger specifier, or returns a grpc status object on error std::variant, grpc::Status> @@ -257,9 +257,15 @@ doAccountTxHelp(RPC::Context& context, AccountTxArgs const& args) { context.loadType = Resource::feeMediumBurdenRPC; if (context.app.config().reporting()) - return dynamic_cast( - &context.app.getRelationalDBInterface()) - ->getAccountTx(args); + { + auto const db = dynamic_cast( + &context.app.getRelationalDatabase()); + + if (!db) + Throw("Failed to get relational database"); + + return db->getAccountTx(args); + } AccountTxResult result; @@ -274,7 +280,7 @@ doAccountTxHelp(RPC::Context& context, AccountTxArgs const& args) result.marker = args.marker; - RelationalDBInterface::AccountTxPageOptions options = { + RelationalDatabase::AccountTxPageOptions options = { args.account, result.ledgerRange.min, result.ledgerRange.max, @@ -282,21 +288,23 @@ doAccountTxHelp(RPC::Context& context, AccountTxArgs const& args) args.limit, isUnlimited(context.role)}; + auto const db = + dynamic_cast(&context.app.getRelationalDatabase()); + + if (!db) + Throw("Failed to get relational database"); + if (args.binary) { if (args.forward) { - auto [tx, marker] = dynamic_cast( - &context.app.getRelationalDBInterface()) - ->oldestAccountTxPageB(options); + auto [tx, marker] = db->oldestAccountTxPageB(options); result.transactions = tx; result.marker = marker; } else { - auto [tx, marker] = dynamic_cast( - &context.app.getRelationalDBInterface()) - ->newestAccountTxPageB(options); + auto [tx, marker] = db->newestAccountTxPageB(options); result.transactions = tx; result.marker = marker; } @@ -305,17 +313,13 @@ doAccountTxHelp(RPC::Context& context, AccountTxArgs const& args) { if (args.forward) { - auto [tx, marker] = dynamic_cast( - &context.app.getRelationalDBInterface()) - ->oldestAccountTxPage(options); + auto [tx, marker] = db->oldestAccountTxPage(options); result.transactions = tx; result.marker = marker; } else { - auto [tx, marker] = dynamic_cast( - &context.app.getRelationalDBInterface()) - ->newestAccountTxPage(options); + auto [tx, marker] = db->newestAccountTxPage(options); result.transactions = tx; result.marker = marker; } diff --git a/src/ripple/rpc/handlers/AccountTxOld.cpp b/src/ripple/rpc/handlers/AccountTxOld.cpp index 9c5bb0bcebb..1bc64247c36 100644 --- a/src/ripple/rpc/handlers/AccountTxOld.cpp +++ b/src/ripple/rpc/handlers/AccountTxOld.cpp @@ -21,7 +21,7 @@ #include #include #include -#include +#include #include #include #include @@ -152,7 +152,7 @@ doAccountTxOld(RPC::JsonContext& context) ret[jss::account] = context.app.accountIDCache().toBase58(*raAccount); Json::Value& jvTxns = (ret[jss::transactions] = Json::arrayValue); - RelationalDBInterface::AccountTxOptions options = { + RelationalDatabase::AccountTxOptions options = { *raAccount, uLedgerMin, uLedgerMax, @@ -162,15 +162,15 @@ doAccountTxOld(RPC::JsonContext& context) if (bBinary) { - std::vector txns; + std::vector txns; if (bDescending) - txns = dynamic_cast( - &context.app.getRelationalDBInterface()) + txns = dynamic_cast( + &context.app.getRelationalDatabase()) ->getNewestAccountTxsB(options); else - txns = dynamic_cast( - &context.app.getRelationalDBInterface()) + txns = dynamic_cast( + &context.app.getRelationalDatabase()) ->getOldestAccountTxsB(options); for (auto it = txns.begin(), end = txns.end(); it != end; ++it) @@ -189,15 +189,15 @@ doAccountTxOld(RPC::JsonContext& context) } else { - RelationalDBInterface::AccountTxs txns; + RelationalDatabase::AccountTxs txns; if (bDescending) - txns = dynamic_cast( - &context.app.getRelationalDBInterface()) + txns = dynamic_cast( + &context.app.getRelationalDatabase()) ->getNewestAccountTxs(options); else - txns = dynamic_cast( - &context.app.getRelationalDBInterface()) + txns = dynamic_cast( + &context.app.getRelationalDatabase()) ->getOldestAccountTxs(options); for (auto it = txns.begin(), end = txns.end(); it != end; ++it) diff --git a/src/ripple/rpc/handlers/GetCounts.cpp b/src/ripple/rpc/handlers/GetCounts.cpp index d59e7014b1a..6fe7e26a280 100644 --- a/src/ripple/rpc/handlers/GetCounts.cpp +++ b/src/ripple/rpc/handlers/GetCounts.cpp @@ -22,7 +22,7 @@ #include #include #include -#include +#include #include #include #include @@ -75,23 +75,23 @@ getCountsJson(Application& app, int minObjectCount) if (!app.config().reporting() && app.config().useTxTables()) { - auto dbKB = dynamic_cast( - &app.getRelationalDBInterface()) - ->getKBUsedAll(); + auto const db = + dynamic_cast(&app.getRelationalDatabase()); + + if (!db) + Throw("Failed to get relational database"); + + auto dbKB = db->getKBUsedAll(); if (dbKB > 0) ret[jss::dbKBTotal] = dbKB; - dbKB = dynamic_cast( - &app.getRelationalDBInterface()) - ->getKBUsedLedger(); + dbKB = db->getKBUsedLedger(); if (dbKB > 0) ret[jss::dbKBLedger] = dbKB; - dbKB = dynamic_cast( - &app.getRelationalDBInterface()) - ->getKBUsedTransaction(); + dbKB = db->getKBUsedTransaction(); if (dbKB > 0) ret[jss::dbKBTransaction] = dbKB; diff --git a/src/ripple/rpc/handlers/TxHistory.cpp b/src/ripple/rpc/handlers/TxHistory.cpp index 7fa7fc76f9b..4c76bfac026 100644 --- a/src/ripple/rpc/handlers/TxHistory.cpp +++ b/src/ripple/rpc/handlers/TxHistory.cpp @@ -20,7 +20,7 @@ #include #include #include -#include +#include #include #include #include @@ -54,8 +54,7 @@ doTxHistory(RPC::JsonContext& context) if ((startIndex > 10000) && (!isUnlimited(context.role))) return rpcError(rpcNO_PERMISSION); - auto trans = - context.app.getRelationalDBInterface().getTxHistory(startIndex); + auto trans = context.app.getRelationalDatabase().getTxHistory(startIndex); Json::Value obj; Json::Value& txs = obj[jss::txs]; diff --git a/src/ripple/rpc/impl/RPCHelpers.cpp b/src/ripple/rpc/impl/RPCHelpers.cpp index 5c42aae969b..d3649dfb985 100644 --- a/src/ripple/rpc/impl/RPCHelpers.cpp +++ b/src/ripple/rpc/impl/RPCHelpers.cpp @@ -21,7 +21,7 @@ #include #include #include -#include +#include #include #include #include @@ -537,7 +537,7 @@ isValidated( { assert(hash->isNonZero()); uint256 valHash = - app.getRelationalDBInterface().getHashByIndex(seq); + app.getRelationalDatabase().getHashByIndex(seq); if (valHash == ledger.info().hash) { // SQL database doesn't match ledger chain diff --git a/src/ripple/rpc/impl/ShardArchiveHandler.cpp b/src/ripple/rpc/impl/ShardArchiveHandler.cpp index c52c1b50174..36af5588942 100644 --- a/src/ripple/rpc/impl/ShardArchiveHandler.cpp +++ b/src/ripple/rpc/impl/ShardArchiveHandler.cpp @@ -18,7 +18,7 @@ //============================================================================== #include -#include +#include #include #include #include diff --git a/src/test/app/Manifest_test.cpp b/src/test/app/Manifest_test.cpp index 47b16d94883..db66e09e518 100644 --- a/src/test/app/Manifest_test.cpp +++ b/src/test/app/Manifest_test.cpp @@ -20,7 +20,7 @@ #include #include #include -#include +#include #include #include #include diff --git a/src/test/app/SHAMapStore_test.cpp b/src/test/app/SHAMapStore_test.cpp index fd21983a48b..010c83a4210 100644 --- a/src/test/app/SHAMapStore_test.cpp +++ b/src/test/app/SHAMapStore_test.cpp @@ -19,7 +19,7 @@ #include #include -#include +#include #include #include #include @@ -65,7 +65,7 @@ class SHAMapStore_test : public beast::unit_test::suite auto const seq = json[jss::result][jss::ledger_index].asUInt(); std::optional oinfo = - env.app().getRelationalDBInterface().getLedgerInfoByIndex(seq); + env.app().getRelationalDatabase().getLedgerInfoByIndex(seq); if (!oinfo) return false; const LedgerInfo& info = oinfo.value(); @@ -120,8 +120,7 @@ class SHAMapStore_test : public beast::unit_test::suite ledgerCheck(jtx::Env& env, int const rows, int const first) { const auto [actualRows, actualFirst, actualLast] = - dynamic_cast( - &env.app().getRelationalDBInterface()) + dynamic_cast(&env.app().getRelationalDatabase()) ->getLedgerCountMinMax(); BEAST_EXPECT(actualRows == rows); @@ -133,8 +132,7 @@ class SHAMapStore_test : public beast::unit_test::suite transactionCheck(jtx::Env& env, int const rows) { BEAST_EXPECT( - dynamic_cast( - &env.app().getRelationalDBInterface()) + dynamic_cast(&env.app().getRelationalDatabase()) ->getTransactionCount() == rows); } @@ -142,8 +140,7 @@ class SHAMapStore_test : public beast::unit_test::suite accountTransactionCheck(jtx::Env& env, int const rows) { BEAST_EXPECT( - dynamic_cast( - &env.app().getRelationalDBInterface()) + dynamic_cast(&env.app().getRelationalDatabase()) ->getAccountTransactionCount() == rows); } diff --git a/src/test/nodestore/DatabaseShard_test.cpp b/src/test/nodestore/DatabaseShard_test.cpp index 88bcd49771a..5c074b14938 100644 --- a/src/test/nodestore/DatabaseShard_test.cpp +++ b/src/test/nodestore/DatabaseShard_test.cpp @@ -21,7 +21,7 @@ #include #include #include -#include +#include #include #include #include @@ -1762,9 +1762,9 @@ class DatabaseShard_test : public TestBase } void - testRelationalDBInterfaceSqlite(std::uint64_t const seedValue) + testSQLiteDatabase(std::uint64_t const seedValue) { - testcase("Relational DB Interface SQLite"); + testcase("SQLite Database"); using namespace test::jtx; @@ -1782,8 +1782,8 @@ class DatabaseShard_test : public TestBase BEAST_EXPECT(shardStore->getShardInfo()->finalized().empty()); BEAST_EXPECT(shardStore->getShardInfo()->incompleteToString().empty()); - auto rdb = dynamic_cast( - &env.app().getRelationalDBInterface()); + auto rdb = + dynamic_cast(&env.app().getRelationalDatabase()); BEAST_EXPECT(rdb); @@ -1796,7 +1796,7 @@ class DatabaseShard_test : public TestBase return; } - // Close these databases to force the RelationalDBInterfaceSqlite + // Close these databases to force the SQLiteDatabase // to use the shard databases and lookup tables. rdb->closeLedgerDB(); rdb->closeTransactionDB(); @@ -1814,7 +1814,7 @@ class DatabaseShard_test : public TestBase for (auto const& ledger : data.ledgers_) { // Compare each test ledger to the data retrieved - // from the RelationalDBInterfaceSqlite class + // from the SQLiteDatabase class if (shardStore->seqToShardIndex(ledger->seq()) < shardStore->earliestShardIndex() || @@ -1829,8 +1829,7 @@ class DatabaseShard_test : public TestBase for (auto const& transaction : ledger->txs) { // Compare each test transaction to the data - // retrieved from the RelationalDBInterfaceSqlite - // class + // retrieved from the SQLiteDatabase class error_code_i error{rpcSUCCESS}; @@ -1885,7 +1884,7 @@ class DatabaseShard_test : public TestBase testPrepareWithHistoricalPaths(seedValue()); testOpenShardManagement(seedValue()); testShardInfo(seedValue()); - testRelationalDBInterfaceSqlite(seedValue()); + testSQLiteDatabase(seedValue()); } }; diff --git a/src/test/rpc/ShardArchiveHandler_test.cpp b/src/test/rpc/ShardArchiveHandler_test.cpp index 296699b3c7c..37c9d016843 100644 --- a/src/test/rpc/ShardArchiveHandler_test.cpp +++ b/src/test/rpc/ShardArchiveHandler_test.cpp @@ -17,7 +17,7 @@ */ //============================================================================== -#include +#include #include #include #include diff --git a/src/test/rpc/Transaction_test.cpp b/src/test/rpc/Transaction_test.cpp index a20a20aa617..08e97c1c20a 100644 --- a/src/test/rpc/Transaction_test.cpp +++ b/src/test/rpc/Transaction_test.cpp @@ -17,7 +17,7 @@ */ //============================================================================== -#include +#include #include #include #include @@ -119,8 +119,7 @@ class Transaction_test : public beast::unit_test::suite const auto deletedLedger = (startLegSeq + endLegSeq) / 2; { // Remove one of the ledgers from the database directly - dynamic_cast( - &env.app().getRelationalDBInterface()) + dynamic_cast(&env.app().getRelationalDatabase()) ->deleteTransactionByLedgerSeq(deletedLedger); } diff --git a/src/test/rpc/Tx_test.cpp b/src/test/rpc/Tx_test.cpp index e4e0507b996..8cfd36c5d86 100644 --- a/src/test/rpc/Tx_test.cpp +++ b/src/test/rpc/Tx_test.cpp @@ -19,7 +19,7 @@ #include #include -#include +#include #include #include #include @@ -769,8 +769,7 @@ class Tx_test : public beast::unit_test::suite const auto deletedLedger = (startLegSeq + endLegSeq) / 2; { // Remove one of the ledgers from the database directly - dynamic_cast( - &env.app().getRelationalDBInterface()) + dynamic_cast(&env.app().getRelationalDatabase()) ->deleteTransactionByLedgerSeq(deletedLedger); }