Jupyter中SPARQLWrapper如何在三引号SPARQL查询内插入外部变量

三种写法的问题分别是：

• 直接写'q'：SPARQL语法中单引号用于包裹字符串字面量，写法里的'q'只是查询语句中的固定字符串，不会关联外部Python变量q；同时SPARQL中URI不能用单引号包裹，需直接使用尖括号包裹的完整URI格式。
• 用.format()报400错误：一是漏写了SPARQL WHERE子句必需的包裹大括号，占位符直接占了语法大括号的位置，替换后查询结构破碎；二是.format()会将字符串中所有未转义的{}识别为占位符，SPARQL原生的语法大括号未做转义时会被误解析，最终生成的查询不符合SPARQL语法规范。
• 用f-string报语法错误：f-string默认将所有{}识别为Python表达式插值位，直接写SPARQL的WHERE块大括号时，Python会把大括号内的SPARQL语法（以?开头的SPARQL变量）当成Python代码解析，?不符合Python语法规则，同时代码还漏写了WHERE块的闭合大括号，结构不完整。

方案1：转义大括号后使用f-string（推荐，写法简洁） #

核心规则：f-string中所有属于SPARQL原生语法的大括号，都需要双写为{{和}}做转义，只有要插入Python变量的位置使用单大括号{变量名}即可。
可直接运行的参考代码：

!pip install SPARQLWrapper
from SPARQLWrapper import SPARQLWrapper, JSON

# 定义要插入的URI变量，直接存储带尖括号的标准SPARQL URI格式
target_uri = '<http://data.europeana.eu/item/08517/3395FCFC5812F76279634269BE601072BF09183B>'
# 补全查询需要的前缀定义
prefix = """
PREFIX ore: <http://www.openarchives.org/ore/terms/>
"""
# SPARQL原生大括号全部双写转义，变量位置用单大括号插值
query_content = f"""
select *
where {{
  ?providerProxy ore:proxyFor {target_uri} ;
                 ?p ?o 
}}
"""
# 初始化SPARQL端点，替换为你实际使用的端点地址
sparql = SPARQLWrapper("https://sparql.europeana.eu/")
query = prefix + query_content
sparql.setQuery(query)
sparql.setReturnFormat(JSON)
results = sparql.query().convert()

print(results)
print('------')
for result in results["results"]["bindings"]:
  p = result["p"]["value"]
  o = result["o"]["value"]
  print(p + " : " + o)

方案2：字符串直接拼接（新手友好，无需记忆转义规则） #

如果记不住大括号转义规则，直接将SPARQL语句拆分为多段，用+拼接外部变量即可，不需要处理任何符号转义，出错概率极低：

target_uri = '<http://data.europeana.eu/item/08517/3395FCFC5812F76279634269BE601072BF09183B>'
prefix = """
PREFIX ore: <http://www.openarchives.org/ore/terms/>
"""
# 拆分语句直接拼接变量，无需转义
query_content = """
select *
where {
  ?providerProxy ore:proxyFor """ + target_uri + """ ;
                 ?p ?o 
}
"""
# 后续查询逻辑与方案1完全一致
sparql = SPARQLWrapper("https://sparql.europeana.eu/")
query = prefix + query_content
sparql.setQuery(query)
sparql.setReturnFormat(JSON)
results = sparql.query().convert()

• 插入URI时不要额外添加单引号或双引号，SPARQL中URI直接用尖括号包裹即可，额外加引号会被识别为字符串字面量，导致查询无结果。
• 如果插入普通字符串值（非URI），需要在插值位置外层添加对应引号，例如查询标签匹配的场景写法为?s rdfs:label "{str_var}"，大括号转义规则与上述方案一致。
• 若查询参数来自外部用户输入，需要先对特殊字符做转义过滤，避免SPARQL注入风险。

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