Update filter syntax to use arrays instead of comma-separated strings

[IrakliJani]

This pull request updates the documentation for filtering with multiple values in both metrics and tables. The changes replace the comma-separated string syntax with an array-based approach for specifying multiple filter values.

Key changes include:

• Updated the metrics documentation to clarify that filtering with a list of values generates a SQL IN clause
• Modified all examples in the tables documentation to use YAML arrays instead of comma-separated strings for multiple values (e.g., ["active", "pending", "approved"] instead of "active,pending,approved")
• Added explanatory text about SQL IN clause generation for better understanding
• Updated the filter operators table to reflect the new array syntax

The new syntax provides better YAML structure and makes the relationship to SQL IN clauses more explicit.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
lightdash	🟢 Ready	View Preview	Apr 9, 2026, 11:39 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[IrakliJani]

• Update filter syntax to use arrays instead of comma-separated strings #533 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

🤖 Documentation Bot

✅ All checks passed! No issues found.