Ansible Playbook拼接SQL条件串的特殊字符转义问题咨询

核心转义规则 #

Jinja2作为Ansible的模板渲染引擎，处理字符串内特殊引号的核心逻辑非常简单：字符串的包裹引号和内部需要保留的引号选用不同类型，即可无需额外转义直接保留内容。

• 用双引号包裹整个Jinja字符串字面量时，内部需要的单引号属于普通字符，会被原样输出，是这类场景下零转义成本、最不易出错的写法
• 若强制用单引号包裹Jinja字符串，内部的单引号必须通过反斜杠转义（如\'）或YAML层面的连续单引号转义，极易因为数错引号数量导致格式错误
• 禁止使用quote过滤器处理SQL字符串，该过滤器是为shell命令行转义设计的，会额外添加不符合SQL语法的shell转义字符，破坏SQL结构

原代码的问题定位 #

你原有写法的格式问题本质不是转义不足，而是遗漏了SQL语法要求的两类单引号：

• 拼接主机名和域名的分隔符是字符串常量.，必须用单引号包裹（SQL中所有字符串常量都需要单引号定界，原写法漏写后变成了无效的||.||结构）
• LIKE操作的匹配值%主机名%是字符串常量，必须用单引号包裹（原写法漏写后变成了无效的like %xxx%结构）

修正后的完整任务配置 #

需要先初始化空的条件列表，避免首次执行时因变量不存在报错；同时搭配YAML折叠块标量写法，彻底规避YAML层面的引号转义问题：

# 初始化空列表，避免首次执行时变量未定义报错
- name: Init query condition list
  set_fact:
    query_conditionals_list: []
  when: query_conditionals_list is not defined

- name: Query Conditionals
  set_fact:
    # 折叠块标量写法：YAML解析器不会识别块内的引号作为语法定界符
    query_conditionals_list: >-
      {{ query_conditionals_list + [
        "(server.primary_name||'.'||server.arpa_domain like '%" ~ item ~ "%')"
      ] }}
  with_items: "{{ server_names }}"
  loop_control:
    label: "{{ item }}"

- name: Join names
  set_fact:
    query_conditionals: "{{ query_conditionals_list | join(' OR ') }}"

渲染效果验证 #

当循环处理的item值为示例主机名web-prod-01时，生成的单条SQL条件完全符合要求结构：
(server.primary_name||'.'||server.arpa_domain like '%web-prod-01%')
多条件通过OR拼接后即可直接用于SQL查询，不会出现单引号丢失、语法不兼容的问题。

补充说明：用~运算符替代+做字符串拼接时，会自动将非字符串类型的变量值转为字符串格式，适配多类型变量的拼接场景，比纯加法拼接更稳定。

内容的提问来源于stack exchange，提问作者radicaled