Package org.elasticsearch.xpack.esql.datasources.cache

Class ExternalSourceCacheService

java.lang.Object

org.elasticsearch.xpack.esql.datasources.cache.ExternalSourceCacheService

All Implemented Interfaces:

Closeable, AutoCloseable

public class ExternalSourceCacheService
extends Object
implements Closeable

Coordinator-only, in-memory cache service for external source metadata. Maintains two independent caches:

• Schema cache (20% of budget, 5m TTL) — shared across users
• Listing cache (80% of budget, 30s TTL) — isolated by credential hash

Uses hard TTL via setExpireAfterWrite for the initial implementation. Lazy TTL with ETag revalidation is deferred to a follow-up PR.

Constructor Summary

Constructors

Constructor	Description
ExternalSourceCacheService(Settings settings)

Method Summary

Modifier and Type	Method	Description
void	clearAll()
void	close()
FileList	getOrComputeListing(ListingCacheKey key, CacheLoader<ListingCacheKey,FileList> loader)	Returns a cached file listing or stores the provided one.
SchemaCacheEntry	getOrComputeSchema(SchemaCacheKey key, CacheLoader<SchemaCacheKey,SchemaCacheEntry> loader)	Returns a cached schema entry or computes it via the loader.
boolean	isEnabled()
void	setEnabled(boolean enabled)
Map<String,Object>	usageStats()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ExternalSourceCacheService

public ExternalSourceCacheService(Settings settings)

Method Details

getOrComputeSchema

public SchemaCacheEntry getOrComputeSchema(SchemaCacheKey key,
 CacheLoader<SchemaCacheKey,SchemaCacheEntry> loader)
                                    throws Exception

Returns a cached schema entry or computes it via the loader. The loader is only invoked on a cache miss. When the cache is disabled, the loader is called directly (bypassing the cache).

Throws:

Exception

getOrComputeListing

public FileList getOrComputeListing(ListingCacheKey key,
 CacheLoader<ListingCacheKey,FileList> loader)
                             throws Exception

Returns a cached file listing or stores the provided one. The loader is only invoked on a cache miss. When the cache is disabled, the loader is called directly (bypassing the cache).

Throws:

Exception

setEnabled

public void setEnabled(boolean enabled)

isEnabled

public boolean isEnabled()

clearAll

public void clearAll()

usageStats

public Map<String,Object> usageStats()

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable