一、功能
该视图为会话级视图，每个会话独立保留各自的决策历史，不同会话之间的数据互不可见。视图的数据采集与保留行为受以下系统变量控制：
·tdsql_enable_proxy_decision：是否开启决策追踪，默认 OFF。
·tdsql_proxy_decision_history_size：单个会话最多保留的决策行数，默认 10。
·tdsql_proxy_decision_max_mem_size：单条决策记录允许占用的最大字节数，默认 1048576（1 MB）。
注意：说明：
注意：会话级视图查询本身不会被记录为一条新的代理决策。仅当 tdsql_enable_proxy_decision 为 ON 时，新执行的 SQL 才会写入该视图；将该变量从 ON 切换为 OFF 会清空当前会话的历史记录。
二、支持版本
适用于 TDSQL Boundless V21.6.3.0 及以上版本。
三、字段说明
| 字段名 | 数据类型 | 说明 |
| SEQ | bigint unsigned | 当前会话内的决策序号，按 SQL 进入计算节点的时间顺序单调递增。结合 ORDER BY SEQ DESC 可获取最近一条记录。 |
| QUERY | varchar(65535) | 被追踪的 SQL 语句原文。语句长度受 tdsql_proxy_decision_max_mem_size 限制，超出时会被截断。 |
| FINAL_ACTION | varchar(64) | 该 SQL 的最终路由动作，取值如下：proxy_remote：成功代理到远端节点执行。exec_in_this_node：在当前节点本地执行。fallback_to_local：原本判定为代理执行，但因故回退到本节点执行。error_before_proxy：在进入代理前发生错误。error：代理过程中发生错误。 |
| TRACE | varchar(65535) | 完整的代理决策路径，使用 JSON 文本格式表达。包含 phases 数组与 final 对象两部分：phases：决策阶段数组，每个阶段对象由 phase 字段标识所处阶段（取值为 dispatch_precheck、before_prepare、post_prepare），steps 字段记录该阶段触发的判定步骤；每个步骤包含 stage（判定项名称）、outcome（判定结果，如 accept / reject / defer / choose / remote）、cause（判定原因）以及可选的 detail（补充信息）。final：最终决策对象，包含 action（同 FINAL_ACTION 列）和 reason（最终动作产生的原因）。当单条记录超过 tdsql_proxy_decision_max_mem_size 限制时，TRACE 内容会被安全截断，但仍保证返回的字符串是合法 JSON。 |
| MISSING_BYTES_BEYOND_MAX_MEM_SIZE | int unsigned | 因 tdsql_proxy_decision_max_mem_size 限制而被截断丢弃的字节数。值为 0 表示当前记录未发生截断；非 0 表示已发生截断，可适当调大 tdsql_proxy_decision_max_mem_size 以保留完整 TRACE。 |
四、示例
示例 1：开启决策追踪，并查询最近一条 SQL 的最终动作与决策路径。
SET SESSION tdsql_enable_proxy = ON;SET SESSION tdsql_enable_proxy_decision = ON;SELECT /*+ PROXY(1) */ SUM(v) FROM t1;SELECT * FROM information_schema.PROXY_DECISION ORDER BY SEQ DESC LIMIT 1\\G
输出示例：
*************************** 1. row *************************** SEQ: 12 QUERY: SELECT /*+ PROXY(1) */ SUM(v) FROM t1 FINAL_ACTION: proxy_remote TRACE: {"phases": [{"phase": "dispatch_precheck", "steps": [{"stage": "can_proxy_in_dispatch", "outcome": "defer", "cause": "regular_dml_deferred_to_prepare"}]}, {"phase": "before_prepare", "steps": [{"stage": "can_proxy_sql_property", "outcome": "accept", "cause": "hint_node_id_forced"}]}, {"phase": "post_prepare", "steps": [{"stage": "proxy_if_possible", "outcome": "choose", "cause": "initiative_proxy"}, {"stage": "determine_executor_node", "outcome": "choose", "cause": "route_found", "detail": "node_id=1"}, {"stage": "prepare_proxy_transaction", "outcome": "choose", "cause": "proxy_transaction_prepared", "detail": "node_id=1"}, {"stage": "proxy_query", "outcome": "remote", "cause": "proxy_remote"}]}], "final": {"action": "proxy_remote", "reason": "proxy_remote"}}MISSING_BYTES_BEYOND_MAX_MEM_SIZE: 0
示例 2：诊断未按预期代理的 SQL，定位被拒原因。
SET SESSION tdsql_enable_proxy = ON;SET SESSION tdsql_enable_proxy_decision = ON;/*## broadcast */ SELECT COUNT(*) FROM t1;SELECT FINAL_ACTION, TRACE FROM information_schema.PROXY_DECISION ORDER BY SEQ DESC LIMIT 1\\G
输出示例：
*************************** 1. row ***************************FINAL_ACTION: exec_in_this_node TRACE: {"phases": [{"phase": "dispatch_precheck", "steps": [{"stage": "can_proxy_in_dispatch", "outcome": "defer", "cause": "regular_dml_deferred_to_prepare"}]}, {"phase": "before_prepare", "steps": [{"stage": "can_proxy_sql_property", "outcome": "reject", "cause": "broadcast_all_nodes"}]}, {"phase": "post_prepare", "steps": []}], "final": {"action": "exec_in_this_node", "reason": "rejected_before_proxy"}}
通过 TRACE 中的 outcome=reject、cause=broadcast_all_nodes 可定位到：该 SQL 因被识别为需要广播到所有节点的查询，从而在 before_prepare 阶段被拒绝代理，最终在本节点执行。
示例 3：检查最近一段时间内 SQL 的代理动作分布，统计是否存在大量本地回退。
SELECT FINAL_ACTION, COUNT(*) AS cnt FROM information_schema.PROXY_DECISION GROUP BY FINAL_ACTION ORDER BY cnt DESC;
输出示例：
+——————-+—–+| FINAL_ACTION | cnt |+——————-+—–+| proxy_remote | 7 || exec_in_this_node | 2 || fallback_to_local | 1 |+——————-+—–+
若 fallback_to_local 占比偏高，可结合对应行的 TRACE 列分析回退原因，进而判断是否需要调整路由配置或排查节点连通性。
示例 4：通过 MISSING_BYTES_BEYOND_MAX_MEM_SIZE 识别被截断的 TRACE，并调大配额以保留完整内容。
SELECT SEQ, MISSING_BYTES_BEYOND_MAX_MEM_SIZE FROM information_schema.PROXY_DECISION WHERE MISSING_BYTES_BEYOND_MAX_MEM_SIZE > 0;SET SESSION tdsql_proxy_decision_max_mem_size = 4194304;
将 tdsql_proxy_decision_max_mem_size 调大后，新写入的决策记录将按更大的上限保留 TRACE 内容；已写入的历史记录不会自动重新填充。