Skip to content

Configuration

All configuration options for ckanext-tables are prefixed with ckanext.tables..

Cache settings

These options control how downloaded resource data is cached. They apply to file-based Resource Data Sources (CSV, XLSX, ORC, Parquet, Feather).

ckanext.tables.cache.backend

The storage backend used to cache downloaded table data.

  • pickle — data is cached as pickle files on disk. Simple and requires no additional infrastructure. The cache directory is controlled by ckanext.tables.cache.pickle.cache_dir.
  • redis — data is stored in Redis using CKAN's built-in Redis connection. Suitable for multi-worker deployments where shared cache is needed.

Unknown values fall back to pickle with a warning in the logs.
Type string
Default pickle
Allowed values pickle, redis 
ckanext.tables.cache.backend = redis

ckanext.tables.cache.pickle.cache_dir

Directory where pickle cache files are written. Only used when the pickle cache backend is enabled.

If the directory does not exist it will be created automatically. If creation fails (e.g. due to permissions), the system temp directory is used as a fallback.

Note

It's recommended to set this directory to a persistent location with appropriate permissions.

For example, you can set it to %(ckan.storage_path)/tables-cache in your CKAN config.
Type string
Default /tmp/tables-cache 
ckanext.tables.cache.pickle.cache_dir = /var/cache/ckanext-tables