// Copyright Epic Games, Inc. All Rights Reserved. #include "DerivedDataCache.h" #include "DerivedDataCacheInterface.h" #include "Algo/Accumulate.h" #include "Algo/AllOf.h" #include "Algo/BinarySearch.h" #include "Algo/Sort.h" #include "Async/AsyncWork.h" #include "Async/TaskGraphInterfaces.h" #include "DDCCleanup.h" #include "DerivedDataBackendInterface.h" #include "DerivedDataCache.h" #include "DerivedDataCacheMaintainer.h" #include "DerivedDataCachePrivate.h" #include "DerivedDataCacheUsageStats.h" #include "DerivedDataPluginInterface.h" #include "Features/IModularFeatures.h" #include "HAL/ThreadSafeCounter.h" #include "Misc/CommandLine.h" #include "Misc/CoreMisc.h" #include "Misc/ScopeLock.h" #include "ProfilingDebugging/CookStats.h" #include "Stats/Stats.h" #include "Stats/StatsMisc.h" #include "ZenServerInterface.h" #include DEFINE_STAT(STAT_DDC_NumGets); DEFINE_STAT(STAT_DDC_NumPuts); DEFINE_STAT(STAT_DDC_NumBuilds); DEFINE_STAT(STAT_DDC_NumExist); DEFINE_STAT(STAT_DDC_SyncGetTime); DEFINE_STAT(STAT_DDC_ASyncWaitTime); DEFINE_STAT(STAT_DDC_PutTime); DEFINE_STAT(STAT_DDC_SyncBuildTime); DEFINE_STAT(STAT_DDC_ExistTime); //#define DDC_SCOPE_CYCLE_COUNTER(x) QUICK_SCOPE_CYCLE_COUNTER(STAT_ ## x) #define DDC_SCOPE_CYCLE_COUNTER(x) TRACE_CPUPROFILER_EVENT_SCOPE(x); #if ENABLE_COOK_STATS #include "DerivedDataCacheUsageStats.h" namespace DerivedDataCacheCookStats { // Use to prevent potential divide by zero issues inline double SafeDivide(const int64 Numerator, const int64 Denominator) { return Denominator != 0 ? (double)Numerator / (double)Denominator : 0.0; } // AddCookStats cannot be a lambda because of false positives in static analysis. // See https://developercommunity.visualstudio.com/content/problem/576913/c6244-regression-in-new-lambda-processorpermissive.html static void AddCookStats(FCookStatsManager::AddStatFuncRef AddStat) { PRAGMA_DISABLE_DEPRECATION_WARNINGS; TSharedRef RootNode = GetDerivedDataCacheRef().GatherUsageStats(); PRAGMA_ENABLE_DEPRECATION_WARNINGS; { const FString StatName(TEXT("DDC.Usage")); for (const auto& UsageStatPair : RootNode->ToLegacyUsageMap()) { UsageStatPair.Value.LogStats(AddStat, StatName, UsageStatPair.Key); } } TArray> Nodes; RootNode->ForEachDescendant([&Nodes](TSharedRef Node) { if (Node->Children.IsEmpty()) { Nodes.Add(Node); } }); // Now lets add some summary data to that applies some crazy knowledge of how we set up our DDC. The goal // is to print out the global hit rate, and the hit rate of the local and shared DDC. // This is done by adding up the total get/miss calls the root node receives. // Then we find the FileSystem nodes that correspond to the local and shared cache using some hacky logic to detect a "network drive". // If the DDC graph ever contains more than one local or remote filesystem, this will only find one of them. { const TSharedRef* LocalNode = Nodes.FindByPredicate([](TSharedRef Node) { return Node->GetCacheType() == TEXT("File System") && Node->IsLocal(); }); const TSharedRef* SharedNode = Nodes.FindByPredicate([](TSharedRef Node) { return Node->GetCacheType() == TEXT("File System") && !Node->IsLocal(); }); const TSharedRef* CloudNode = Nodes.FindByPredicate([](TSharedRef Node) { return Node->GetCacheType() == TEXT("Horde Storage"); }); const TSharedRef* ZenLocalNode = Nodes.FindByPredicate([](TSharedRef Node) { return Node->GetCacheType() == TEXT("Zen") && Node->IsLocal(); }); const TSharedRef* ZenRemoteNode = Nodes.FindByPredicate([](TSharedRef Node) { return (Node->GetCacheType() == TEXT("Zen") || Node->GetCacheType() == TEXT("Horde")) && !Node->IsLocal(); }); const FDerivedDataCacheUsageStats& RootStats = RootNode->Stats.CreateConstIterator().Value(); const int64 TotalGetHits = RootStats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); const int64 TotalGetMisses = RootStats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Miss, FCookStats::CallStats::EStatType::Counter); const int64 TotalGets = TotalGetHits + TotalGetMisses; int64 LocalHits = 0; if (LocalNode) { const FDerivedDataCacheUsageStats& Stats = (*LocalNode)->Stats.CreateConstIterator().Value(); LocalHits += Stats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); } if (ZenLocalNode) { const FDerivedDataCacheUsageStats& Stats = (*ZenLocalNode)->Stats.CreateConstIterator().Value(); LocalHits += Stats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); } int64 SharedHits = 0; if (SharedNode) { // The shared DDC is only queried if the local one misses (or there isn't one). So it's hit rate is technically const FDerivedDataCacheUsageStats& Stats = (*SharedNode)->Stats.CreateConstIterator().Value(); SharedHits += Stats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); } if (ZenRemoteNode) { const FDerivedDataCacheUsageStats& Stats = (*ZenRemoteNode)->Stats.CreateConstIterator().Value(); SharedHits += Stats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); } int64 CloudHits = 0; if (CloudNode) { const FDerivedDataCacheUsageStats& Stats = (*CloudNode)->Stats.CreateConstIterator().Value(); CloudHits += Stats.GetStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); } const int64 TotalPutHits = RootStats.PutStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Hit, FCookStats::CallStats::EStatType::Counter); const int64 TotalPutMisses = RootStats.PutStats.GetAccumulatedValueAnyThread(FCookStats::CallStats::EHitOrMiss::Miss, FCookStats::CallStats::EStatType::Counter); const int64 TotalPuts = TotalPutHits + TotalPutMisses; AddStat(TEXT("DDC.Summary"), FCookStatsManager::CreateKeyValueArray( TEXT("BackEnd"), FDerivedDataBackend::Get().GetGraphName(), TEXT("HasLocalCache"), LocalNode || ZenLocalNode, TEXT("HasSharedCache"), SharedNode || ZenRemoteNode, TEXT("HasCloudCache"), !!CloudNode, TEXT("HasZenCache"), ZenLocalNode || ZenRemoteNode, TEXT("TotalGetHits"), TotalGetHits, TEXT("TotalGets"), TotalGets, TEXT("TotalGetHitPct"), SafeDivide(TotalGetHits, TotalGets), TEXT("LocalGetHitPct"), SafeDivide(LocalHits, TotalGets), TEXT("SharedGetHitPct"), SafeDivide(SharedHits, TotalGets), TEXT("CloudGetHitPct"), SafeDivide(CloudHits, TotalGets), TEXT("OtherGetHitPct"), SafeDivide((TotalGetHits - LocalHits - SharedHits - CloudHits), TotalGets), TEXT("GetMissPct"), SafeDivide(TotalGetMisses, TotalGets), TEXT("TotalPutHits"), TotalPutHits, TEXT("TotalPuts"), TotalPuts, TEXT("TotalPutHitPct"), SafeDivide(TotalPutHits, TotalPuts), TEXT("PutMissPct"), SafeDivide(TotalPutMisses, TotalPuts) )); } } FCookStatsManager::FAutoRegisterCallback RegisterCookStats(AddCookStats); } #endif void GatherDerivedDataCacheResourceStats(TArray& DDCResourceStats); void GatherDerivedDataCacheSummaryStats(FDerivedDataCacheSummaryStats& DDCSummaryStats); /** Whether we want to verify the DDC (pass in -VerifyDDC on the command line)*/ bool GVerifyDDC = false; namespace UE::DerivedData::Private { class FCacheRecordPolicyShared; } namespace UE::DerivedData { class Private::FCacheRecordPolicyShared final : public Private::ICacheRecordPolicyShared { public: inline void AddRef() const final { ReferenceCount.fetch_add(1, std::memory_order_relaxed); } inline void Release() const final { if (ReferenceCount.fetch_sub(1, std::memory_order_acq_rel) == 1) { delete this; } } inline TConstArrayView GetValuePolicies() const final { return Values; } inline void AddValuePolicy(const FCacheValuePolicy& Policy) final { Values.Add(Policy); } inline void Build() final { Algo::SortBy(Values, &FCacheValuePolicy::Id); } private: TArray> Values; mutable std::atomic ReferenceCount{0}; }; ECachePolicy FCacheRecordPolicy::GetValuePolicy(const FValueId& Id) const { if (Shared) { if (TConstArrayView Values = Shared->GetValuePolicies(); !Values.IsEmpty()) { if (int32 Index = Algo::BinarySearchBy(Values, Id, &FCacheValuePolicy::Id); Index != INDEX_NONE) { return Values[Index].Policy; } } } return DefaultValuePolicy; } void FCacheRecordPolicyBuilder::AddValuePolicy(const FCacheValuePolicy& Policy) { if (!Shared) { Shared = new Private::FCacheRecordPolicyShared; } Shared->AddValuePolicy(Policy); } FCacheRecordPolicy FCacheRecordPolicyBuilder::Build() { FCacheRecordPolicy Policy(BasePolicy); if (Shared) { Shared->Build(); const auto PolicyOr = [](ECachePolicy A, ECachePolicy B) { return A | (B & ~ECachePolicy::SkipData); }; const TConstArrayView Values = Shared->GetValuePolicies(); Policy.RecordPolicy = Algo::TransformAccumulate(Values, &FCacheValuePolicy::Policy, BasePolicy, PolicyOr); Policy.Shared = MoveTemp(Shared); } return Policy; } } // UE::DerivedData namespace UE::DerivedData::Private { /** * Implementation of the derived data cache * This API is fully threadsafe **/ class FDerivedDataCache final : public FDerivedDataCacheInterface , public ICache , public ICacheStoreMaintainer , public IDDCCleanup { /** * Async worker that checks the cache backend and if that fails, calls the deriver to build the data and then puts the results to the cache **/ friend class FBuildAsyncWorker; class FBuildAsyncWorker : public FNonAbandonableTask { public: enum EWorkerState : uint32 { WorkerStateNone = 0, WorkerStateRunning = 1 << 0, WorkerStateFinished = 1 << 1, WorkerStateDestroyed = 1 << 2, }; /** * Constructor for async task * @param InDataDeriver plugin to produce cache key and in the event of a miss, return the data. * @param InCacheKey Complete cache key for this data. **/ FBuildAsyncWorker(FDerivedDataPluginInterface* InDataDeriver, const TCHAR* InCacheKey, bool bInSynchronousForStats) : bSuccess(false) , bSynchronousForStats(bInSynchronousForStats) , bDataWasBuilt(false) , DataDeriver(InDataDeriver) , CacheKey(InCacheKey) { } virtual ~FBuildAsyncWorker() { // Record that the task is destroyed and check that it was not running or destroyed previously. { const uint32 PreviousState = WorkerState.fetch_or(WorkerStateDestroyed, std::memory_order_relaxed); checkf(!(PreviousState & WorkerStateRunning), TEXT("Destroying DDC worker that is still running! Key: %s"), *CacheKey); checkf(!(PreviousState & WorkerStateDestroyed), TEXT("Destroying DDC worker that has been destroyed previously! Key: %s"), *CacheKey); } } /** Async worker that checks the cache backend and if that fails, calls the deriver to build the data and then puts the results to the cache **/ void DoWork() { // Record that the task is running and check that it was not running, finished, or destroyed previously. { const uint32 PreviousState = WorkerState.fetch_or(WorkerStateRunning, std::memory_order_relaxed); checkf(!(PreviousState & WorkerStateRunning), TEXT("Starting DDC worker that is already running! Key: %s"), *CacheKey); checkf(!(PreviousState & WorkerStateFinished), TEXT("Starting DDC worker that is already finished! Key: %s"), *CacheKey); checkf(!(PreviousState & WorkerStateDestroyed), TEXT("Starting DDC worker that has been destroyed! Key: %s"), *CacheKey); } TRACE_CPUPROFILER_EVENT_SCOPE(DDC_DoWork); const int32 NumBeforeDDC = Data.Num(); bool bGetResult; { TRACE_CPUPROFILER_EVENT_SCOPE(DDC_Get); INC_DWORD_STAT(STAT_DDC_NumGets); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); bGetResult = FDerivedDataBackend::Get().GetRoot().GetCachedData(*CacheKey, Data); } INC_FLOAT_STAT_BY(STAT_DDC_SyncGetTime, bSynchronousForStats ? (float)ThisTime : 0.0f); } if (bGetResult) { if(GVerifyDDC && DataDeriver && DataDeriver->IsDeterministic()) { TArray CmpData; DataDeriver->Build(CmpData); const int32 NumInDDC = Data.Num() - NumBeforeDDC; const int32 NumGenerated = CmpData.Num(); bool bMatchesInSize = NumGenerated == NumInDDC; bool bDifferentMemory = true; int32 DifferentOffset = 0; if (bMatchesInSize) { bDifferentMemory = false; for (int32 i = 0; i < NumGenerated; i++) { if (CmpData[i] != Data[i]) { bDifferentMemory = true; DifferentOffset = i; break; } } } if(!bMatchesInSize || bDifferentMemory) { FString ErrMsg = FString::Printf(TEXT("There is a mismatch between the DDC data and the generated data for plugin (%s) for asset (%s). BytesInDDC:%d, BytesGenerated:%d, bDifferentMemory:%d, offset:%d"), DataDeriver->GetPluginName(), *DataDeriver->GetDebugContextString(), NumInDDC, NumGenerated, bDifferentMemory, DifferentOffset); ensureMsgf(false, TEXT("%s"), *ErrMsg); UE_LOG(LogDerivedDataCache, Error, TEXT("%s"), *ErrMsg ); } } check(Data.Num()); bSuccess = true; delete DataDeriver; DataDeriver = NULL; } else if (DataDeriver) { { TRACE_CPUPROFILER_EVENT_SCOPE(DDC_Build); INC_DWORD_STAT(STAT_DDC_NumBuilds); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); bSuccess = DataDeriver->Build(Data); bDataWasBuilt = true; } INC_FLOAT_STAT_BY(STAT_DDC_SyncBuildTime, bSynchronousForStats ? (float)ThisTime : 0.0f); } delete DataDeriver; DataDeriver = NULL; if (bSuccess) { check(Data.Num()); TRACE_CPUPROFILER_EVENT_SCOPE(DDC_Put); INC_DWORD_STAT(STAT_DDC_NumPuts); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); FDerivedDataBackend::Get().GetRoot().PutCachedData(*CacheKey, Data, true); } INC_FLOAT_STAT_BY(STAT_DDC_PutTime, bSynchronousForStats ? (float)ThisTime : 0.0f); } } if (!bSuccess) { Data.Empty(); } FDerivedDataBackend::Get().AddToAsyncCompletionCounter(-1); // Record that the task is finished and check that it was running and not finished or destroyed previously. { const uint32 PreviousState = WorkerState.fetch_xor(WorkerStateRunning | WorkerStateFinished, std::memory_order_relaxed); checkf((PreviousState & WorkerStateRunning), TEXT("Finishing DDC worker that was not running! Key: %s"), *CacheKey); checkf(!(PreviousState & WorkerStateFinished), TEXT("Finishing DDC worker that is already finished! Key: %s"), *CacheKey); checkf(!(PreviousState & WorkerStateDestroyed), TEXT("Finishing DDC worker that has been destroyed! Key: %s"), *CacheKey); } } FORCEINLINE TStatId GetStatId() const { RETURN_QUICK_DECLARE_CYCLE_STAT(FBuildAsyncWorker, STATGROUP_ThreadPoolAsyncTasks); } std::atomic WorkerState{WorkerStateNone}; /** true in the case of a cache hit, otherwise the result of the deriver build call **/ bool bSuccess; /** true if we should record the timing **/ bool bSynchronousForStats; /** true if we had to build the data */ bool bDataWasBuilt; /** Data dervier we are operating on **/ FDerivedDataPluginInterface* DataDeriver; /** Cache key associated with this build **/ FString CacheKey; /** Data to return to caller, later **/ TArray Data; }; public: /** Constructor, called once to cereate a singleton **/ FDerivedDataCache() : CurrentHandle(19248) // we will skip some potential handles to catch errors { FDerivedDataBackend::Get(); // we need to make sure this starts before we allow us to start CacheStoreMaintainers = IModularFeatures::Get().GetModularFeatureImplementations(FeatureName); GVerifyDDC = FParse::Param(FCommandLine::Get(), TEXT("VerifyDDC")); UE_CLOG(GVerifyDDC, LogDerivedDataCache, Display, TEXT("Items retrieved from the DDC will be verified (-VerifyDDC)")); } /** Destructor, flushes all sync tasks **/ ~FDerivedDataCache() { WaitForQuiescence(true); FScopeLock ScopeLock(&SynchronizationObject); for (TMap*>::TIterator It(PendingTasks); It; ++It) { It.Value()->EnsureCompletion(); delete It.Value(); } PendingTasks.Empty(); } virtual bool GetSynchronous(FDerivedDataPluginInterface* DataDeriver, TArray& OutData, bool* bDataWasBuilt = nullptr) override { DDC_SCOPE_CYCLE_COUNTER(DDC_GetSynchronous); check(DataDeriver); FString CacheKey = FDerivedDataCache::BuildCacheKey(DataDeriver); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("GetSynchronous %s from '%s'"), *CacheKey, *DataDeriver->GetDebugContextString()); FAsyncTask PendingTask(DataDeriver, *CacheKey, true); AddToAsyncCompletionCounter(1); PendingTask.StartSynchronousTask(); OutData = PendingTask.GetTask().Data; if (bDataWasBuilt) { *bDataWasBuilt = PendingTask.GetTask().bDataWasBuilt; } return PendingTask.GetTask().bSuccess; } virtual uint32 GetAsynchronous(FDerivedDataPluginInterface* DataDeriver) override { DDC_SCOPE_CYCLE_COUNTER(DDC_GetAsynchronous); FScopeLock ScopeLock(&SynchronizationObject); const uint32 Handle = NextHandle(); FString CacheKey = FDerivedDataCache::BuildCacheKey(DataDeriver); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("GetAsynchronous %s from '%s', Handle %d"), *CacheKey, *DataDeriver->GetDebugContextString(), Handle); const bool bSync = !DataDeriver->IsBuildThreadsafe(); FAsyncTask* AsyncTask = new FAsyncTask(DataDeriver, *CacheKey, bSync); check(!PendingTasks.Contains(Handle)); PendingTasks.Add(Handle,AsyncTask); AddToAsyncCompletionCounter(1); if (!bSync) { AsyncTask->StartBackgroundTask(DataDeriver->GetCustomThreadPool()); } else { AsyncTask->StartSynchronousTask(); } // Must return a valid handle check(Handle != 0); return Handle; } virtual bool PollAsynchronousCompletion(uint32 Handle) override { DDC_SCOPE_CYCLE_COUNTER(DDC_PollAsynchronousCompletion); FAsyncTask* AsyncTask = NULL; { FScopeLock ScopeLock(&SynchronizationObject); AsyncTask = PendingTasks.FindRef(Handle); } check(AsyncTask); return AsyncTask->IsDone(); } virtual void WaitAsynchronousCompletion(uint32 Handle) override { DDC_SCOPE_CYCLE_COUNTER(DDC_WaitAsynchronousCompletion); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); FAsyncTask* AsyncTask = NULL; { FScopeLock ScopeLock(&SynchronizationObject); AsyncTask = PendingTasks.FindRef(Handle); } check(AsyncTask); AsyncTask->EnsureCompletion(); UE_LOG(LogDerivedDataCache, Verbose, TEXT("WaitAsynchronousCompletion, Handle %d"), Handle); } INC_FLOAT_STAT_BY(STAT_DDC_ASyncWaitTime,(float)ThisTime); } virtual bool GetAsynchronousResults(uint32 Handle, TArray& OutData, bool* bOutDataWasBuilt = nullptr) override { DDC_SCOPE_CYCLE_COUNTER(DDC_GetAsynchronousResults); FAsyncTask* AsyncTask = NULL; { FScopeLock ScopeLock(&SynchronizationObject); PendingTasks.RemoveAndCopyValue(Handle,AsyncTask); } check(AsyncTask); const bool bDataWasBuilt = AsyncTask->GetTask().bDataWasBuilt; if (bOutDataWasBuilt) { *bOutDataWasBuilt = bDataWasBuilt; } if (!AsyncTask->GetTask().bSuccess) { UE_LOG(LogDerivedDataCache, Verbose, TEXT("GetAsynchronousResults, bDataWasBuilt: %d, Handle %d, FAILED"), (int32)bDataWasBuilt, Handle); delete AsyncTask; return false; } UE_LOG(LogDerivedDataCache, Verbose, TEXT("GetAsynchronousResults, bDataWasBuilt: %d, Handle %d, SUCCESS"), (int32)bDataWasBuilt, Handle); OutData = MoveTemp(AsyncTask->GetTask().Data); delete AsyncTask; check(OutData.Num()); return true; } virtual bool GetSynchronous(const TCHAR* CacheKey, TArray& OutData, FStringView DataContext) override { DDC_SCOPE_CYCLE_COUNTER(DDC_GetSynchronous_Data); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("GetSynchronous %s from '%.*s'"), CacheKey, DataContext.Len(), DataContext.GetData()); ValidateCacheKey(CacheKey); FAsyncTask PendingTask((FDerivedDataPluginInterface*)NULL, CacheKey, true); AddToAsyncCompletionCounter(1); PendingTask.StartSynchronousTask(); OutData = PendingTask.GetTask().Data; return PendingTask.GetTask().bSuccess; } virtual uint32 GetAsynchronous(const TCHAR* CacheKey, FStringView DataContext) override { DDC_SCOPE_CYCLE_COUNTER(DDC_GetAsynchronous_Handle); FScopeLock ScopeLock(&SynchronizationObject); const uint32 Handle = NextHandle(); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("GetAsynchronous %s from '%.*s', Handle %d"), CacheKey, DataContext.Len(), DataContext.GetData(), Handle); ValidateCacheKey(CacheKey); FAsyncTask* AsyncTask = new FAsyncTask((FDerivedDataPluginInterface*)NULL, CacheKey, false); check(!PendingTasks.Contains(Handle)); PendingTasks.Add(Handle, AsyncTask); AddToAsyncCompletionCounter(1); // This request is I/O only, doesn't do any processing, send it to the I/O only thread-pool to avoid wasting worker threads on long I/O waits. AsyncTask->StartBackgroundTask(GDDCIOThreadPool); return Handle; } virtual void Put(const TCHAR* CacheKey, TArrayView Data, FStringView DataContext, bool bPutEvenIfExists = false) override { DDC_SCOPE_CYCLE_COUNTER(DDC_Put); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("Put %s from '%.*s'"), CacheKey, DataContext.Len(), DataContext.GetData()); ValidateCacheKey(CacheKey); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); FDerivedDataBackend::Get().GetRoot().PutCachedData(CacheKey, Data, bPutEvenIfExists); } INC_FLOAT_STAT_BY(STAT_DDC_PutTime,(float)ThisTime); INC_DWORD_STAT(STAT_DDC_NumPuts); } virtual void MarkTransient(const TCHAR* CacheKey) override { ValidateCacheKey(CacheKey); FDerivedDataBackend::Get().GetRoot().RemoveCachedData(CacheKey, /*bTransient=*/ true); } virtual bool CachedDataProbablyExists(const TCHAR* CacheKey) override { DDC_SCOPE_CYCLE_COUNTER(DDC_CachedDataProbablyExists); ValidateCacheKey(CacheKey); bool bResult; INC_DWORD_STAT(STAT_DDC_NumExist); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); bResult = FDerivedDataBackend::Get().GetRoot().CachedDataProbablyExists(CacheKey); } INC_FLOAT_STAT_BY(STAT_DDC_ExistTime, (float)ThisTime); return bResult; } virtual TBitArray<> CachedDataProbablyExistsBatch(TConstArrayView CacheKeys) override { TBitArray<> Result; if (CacheKeys.Num() > 1) { DDC_SCOPE_CYCLE_COUNTER(DDC_CachedDataProbablyExistsBatch); INC_DWORD_STAT(STAT_DDC_NumExist); STAT(double ThisTime = 0); { SCOPE_SECONDS_COUNTER(ThisTime); Result = FDerivedDataBackend::Get().GetRoot().CachedDataProbablyExistsBatch(CacheKeys); check(Result.Num() == CacheKeys.Num()); } INC_FLOAT_STAT_BY(STAT_DDC_ExistTime, (float)ThisTime); } else if (CacheKeys.Num() == 1) { Result.Add(CachedDataProbablyExists(*CacheKeys[0])); } return Result; } virtual bool AllCachedDataProbablyExists(TConstArrayView CacheKeys) override { return CacheKeys.Num() == 0 || CachedDataProbablyExistsBatch(CacheKeys).CountSetBits() == CacheKeys.Num(); } virtual bool TryToPrefetch(TConstArrayView CacheKeys, FStringView DebugContext) override { if (!CacheKeys.IsEmpty()) { DDC_SCOPE_CYCLE_COUNTER(DDC_TryToPrefetch); UE_LOG(LogDerivedDataCache, VeryVerbose, TEXT("TryToPrefetch %d keys including %s from '%.*s'"), CacheKeys.Num(), *CacheKeys[0], DebugContext.Len(), DebugContext.GetData()); return FDerivedDataBackend::Get().GetRoot().TryToPrefetch(CacheKeys); } return true; } void NotifyBootComplete() override { DDC_SCOPE_CYCLE_COUNTER(DDC_NotifyBootComplete); FDerivedDataBackend::Get().NotifyBootComplete(); } void AddToAsyncCompletionCounter(int32 Addend) override { FDerivedDataBackend::Get().AddToAsyncCompletionCounter(Addend); } bool AnyAsyncRequestsRemaining() const override { return FDerivedDataBackend::Get().AnyAsyncRequestsRemaining(); } void WaitForQuiescence(bool bShutdown) override { DDC_SCOPE_CYCLE_COUNTER(DDC_WaitForQuiescence); FDerivedDataBackend::Get().WaitForQuiescence(bShutdown); } /** Get whether a Shared Data Cache is in use */ virtual bool GetUsingSharedDDC() const override { return FDerivedDataBackend::Get().GetUsingSharedDDC(); } virtual const TCHAR* GetGraphName() const override { return FDerivedDataBackend::Get().GetGraphName(); } virtual const TCHAR* GetDefaultGraphName() const override { return FDerivedDataBackend::Get().GetDefaultGraphName(); } void GetDirectories(TArray& OutResults) override { FDerivedDataBackend::Get().GetDirectories(OutResults); } PRAGMA_DISABLE_DEPRECATION_WARNINGS virtual IDDCCleanup* GetCleanup() const override { return const_cast(static_cast(this)); } PRAGMA_ENABLE_DEPRECATION_WARNINGS virtual bool IsFinished() const override { return IsIdle(); } virtual void WaitBetweenDeletes(bool bWait) override { if (!bWait) { BoostPriority(); } } virtual void GatherUsageStats(TMap& UsageStats) override { GatherUsageStats()->GatherLegacyUsageStats(UsageStats, TEXT(" 0")); } PRAGMA_DISABLE_DEPRECATION_WARNINGS virtual TSharedRef GatherUsageStats() const override { return FDerivedDataBackend::Get().GatherUsageStats(); } PRAGMA_ENABLE_DEPRECATION_WARNINGS virtual void GatherResourceStats(TArray& DDCResourceStats) const override { GatherDerivedDataCacheResourceStats(DDCResourceStats); } virtual void GatherSummaryStats(FDerivedDataCacheSummaryStats& DDCSummaryStats) const override { GatherDerivedDataCacheSummaryStats(DDCSummaryStats); } /** Get event delegate for data cache notifications */ virtual FOnDDCNotification& GetDDCNotificationEvent() { return DDCNotificationEvent; } protected: uint32 NextHandle() { return (uint32)CurrentHandle.Increment(); } private: /** * Internal function to build a cache key out of the plugin name, versions and plugin specific info * @param DataDeriver plugin to produce the elements of the cache key. * @return Assembled cache key **/ static FString BuildCacheKey(FDerivedDataPluginInterface* DataDeriver) { FString Result = FDerivedDataCacheInterface::BuildCacheKey(DataDeriver->GetPluginName(), DataDeriver->GetVersionString(), *DataDeriver->GetPluginSpecificCacheKeySuffix()); return Result; } static void ValidateCacheKey(const TCHAR* CacheKey) { checkf(Algo::AllOf(FStringView(CacheKey), IsValidCacheChar), TEXT("Invalid characters in cache key %s. Use SanitizeCacheKey or BuildCacheKey to create valid keys."), CacheKey); } /** Counter used to produce unique handles **/ FThreadSafeCounter CurrentHandle; /** Object used for synchronization via a scoped lock **/ FCriticalSection SynchronizationObject; /** Map of handle to pending task **/ TMap*> PendingTasks; /** Cache notification delegate */ FOnDDCNotification DDCNotificationEvent; public: // ICacheStore Interface void Put( TConstArrayView Requests, IRequestOwner& Owner, FOnCachePutComplete&& OnComplete) final { return FDerivedDataBackend::Get().GetRoot().Put(Requests, Owner, MoveTemp(OnComplete)); } void Get( TConstArrayView Requests, IRequestOwner& Owner, FOnCacheGetComplete&& OnComplete) final { return FDerivedDataBackend::Get().GetRoot().Get(Requests, Owner, MoveTemp(OnComplete)); } void GetChunks( TConstArrayView Requests, IRequestOwner& Owner, FOnCacheChunkComplete&& OnComplete) final { return FDerivedDataBackend::Get().GetRoot().GetChunks(Requests, Owner, MoveTemp(OnComplete)); } // ICache Interface void CancelAll() final { } ICacheStoreMaintainer& GetMaintainer() final { return *this; } // ICacheStoreMaintainer Interface bool IsIdle() const final { return Algo::AllOf(CacheStoreMaintainers, &ICacheStoreMaintainer::IsIdle); } void BoostPriority() final { for (ICacheStoreMaintainer* Maintainer : CacheStoreMaintainers) { Maintainer->BoostPriority(); } } private: TArray CacheStoreMaintainers; }; ICache* CreateCache(FDerivedDataCacheInterface** OutLegacyCache) { FDerivedDataCache* Cache = new FDerivedDataCache; if (OutLegacyCache) { *OutLegacyCache = Cache; } return Cache; } } // UE::DerivedData::Private