Edit Parameters
Skill for defining and modifying dynamic parameters in the Lightdash semantic layer.
Purpose
Enables the creation of dynamic, reusable variables that users can modify at runtime in dbt YAML or lightdash.config.yml.
Behavior
- •Parameter Scope: Define parameters either at the project level (
lightdash.config.yml) or the model level (dbt YAML). - •Type Safety: Ensure parameters use supported types (
string,number,date). - •Template Usage: Reference parameters in SQL using
${lightdash.parameters.name}or${ld.parameters.name}. - •Reference Consultation: ALWAYS check
references/basics.mdandreferences/advanced.mdfor syntax patterns.
References
- •Basics: Parameter definition and simple types.
- •Advanced: Multi-select, custom options, and joined model parameters.
- •Global Config: Project-level parameters.
- •SQL Templating: Using
${lightdash.parameters.name}.
Rules
- •ALWAYS provide a
defaultvalue for parameters. - •Add clear
descriptiontags to help end-users understand the parameter's effect. - •Prefer model-level parameters for better encapsulation.
- •Refer to
read-parametersto verify existing variables before adding new ones.