Catalog Configuration File
The catalog configuration file (count_catalog.yml) allows you to apply catalog-wide settings.
Currently this supports caching & scheduling. Caching can be optionally configured.
All new catalogs created will have this file pre-filled by default. Existing catalog will now see this file, but it will be empty and will need populating.
Caching applied in the catalog maintainer file will be overruled by any view level caching settings applied. Leave the view level caching settings empty if you'd like them to default to the catalog maintainer settings.
The Schema
| Field name | Description |
|---|---|
| version | The API version for catalog definition files. Currently supported versions: 1. |
| caching | Catalog-wide caching settings for view source dependencies attached to connections. Optional. |
| caching.duration | How long source dependency results are cached (in seconds). Optional. |
| caching.schedule | A cron expression for the source dependency refresh schedule. This value may need to be enclosed in single quotation marks. Optional. |
| caching.wait_for_cache | Whether cells should wait for view caches to exist instead of querying the connection directly while caches are being generated (default: false). Optional. |
| default_connection | The default connection key to use for views and datasets that do not explicitly specify a connection. This must be a connection that is available in the catalog. Optional. |
| lookml | Settings for using LookML files in Count catalogs. Optional. |
| lookml.connection | The connection key to use when converting or extending LookML views. Optional. Defaults to the default connection. |
| lookml.automatic_conversion | Settings related to automatic conversion of LookML files. Optional. |
| lookml.automatic_conversion.enabled | Whether or not to automatically convert LookML files placed in the catalog directory. Optional. Defaults to false. |
| lookml.automatic_conversion.include | A list of glob patterns to limit which LookML files are automatically converted when "lookml.automatic_conversion.enabled" is true. Optional. Default to all paths. |
| lookml.automatic_conversion.exclude | A list of glob patterns to exclude LookML files from automatic conversion when "lookml.automatic_conversion.enabled" is true. Optional. |
| lookml.caching | Caching settings for views generated from LookML conversion. If not specified, no caching settings will be included in converted views. Optional. |
| lookml.caching.duration | How long converted view source dependency results are cached (in seconds). |
| lookml.caching.schedule | A cron expression for the converted view source dependency refresh schedule. This value may need to be enclosed in single quotation marks. Optional. |
| lookml.caching.wait_for_cache | Whether cells should wait for converted view caches to exist instead of querying the connection directly while caches are being generated. Optional. Default to false. |
Example YAML
The default catalog maintainer file has the following YAML, which can be configured to your preferences.
Loading code...