用途:在 LookML 中使用 Liquid 变量,实现动态 SQL、HTML 与链接,并支持查询优化。
主要能力:提供输出语法 {{ value }} 与标签语法 {% if condition %};常用变量包括 value(原始值,适合比较)、rendered_value(格式化值,适合展示)、_filters['view.field'](用户筛选值)、parameter_name._parameter_value(参数值)。高级场景含聚合感知(按 _in_query 动态选择表)、动态联表(sql_on/sql_where)、按所选字段切换计算逻辑,以及字符串拆分与循环解析复杂参数。
必要用法与最佳实践:向 SQL 字符串字面量插入用户输入时,始终用 | sql_quote 防止注入;方言需要字面 TRUE/FALSE 时对 _in_query 或 _is_selected 追加 | sql_boolean,如 {{ view.field._in_query | sql_boolean }}。注意 _in_query 会检查 SELECT、Filters 和 required_fields,不限于可见列;_is_selected 在计算总计(行/列/总计)时对维度返回 false,需要逻辑在总计中保留时用 _in_query。性能上避免在链接参数引用未在查询中的 {{ field._value }},以免加入 GROUP BY 导致行膨胀,仅需结果行值时改用 row['view.field']。
限制:资料未提供安装命令、收费与价格信息。其余功能与用法以官方文档为准。