Skip to main content

Description

Contains information about all entries inside filesystem cache for remote objects.

Columns

  • cache_name (String) โ€” Name of the cache object. Can be used in SYSTEM DESCRIBE FILESYSTEM CACHE <name>, SYSTEM DROP FILESYSTEM CACHE <name> commands
  • cache_base_path (String) โ€” Path to the base directory where all cache files (of a cache identified by cache_name) are stored.
  • cache_path (String) โ€” Path to a particular cache file, corresponding to a file segment in a source file
  • key (String) โ€” Cache key of the file segment
  • file_segment_range_begin (UInt64) โ€” Offset corresponding to the beginning of the file segment range
  • file_segment_range_end (UInt64) โ€” Offset corresponding to the (including) end of the file segment range
  • size (UInt64) โ€” Size of the file segment
  • state (String) โ€” File segment state (DOWNLOADED, DOWNLOADING, PARTIALLY_DOWNLOADED, โ€ฆ)
  • finished_download_time (DateTime) โ€” Time when file segment finished downloading.
  • cache_hits (UInt64) โ€” Number of cache hits of corresponding file segment
  • references (UInt64) โ€” Number of references to corresponding file segment. Value 1 means that nobody uses it at the moment (the only existing reference is in cache storage itself)
  • downloaded_size (UInt64) โ€” Downloaded size of the file segment
  • kind (String) โ€” File segment kind (used to distinguish between file segments added as a part of โ€˜Temporary data in cacheโ€™)
  • unbound (UInt8) โ€” Internal implementation flag
  • user_id (String) โ€” User id of the user which created the file segment
  • segment_type (String) โ€” Type of the segment. Used to separate data files(.json, .txt and etc) from data file(.bin, mark files).
  • file_size (Nullable(UInt64)) โ€” File size of the file to which current file segment belongs
Last modified on September 8, 2026