投影管理
概述
投影管理用于统一管理智能投影、待加速查询、智能投影策略、投影回收策略、投影回收站和投影操作记录。
智能投影策略支持以下两种加速模式：
| 加速模式 | 适用场景 | 识别范围 | 投影创建方式 |
|---|---|---|---|
| 查询级加速 | 针对重复出现且耗时较长的查询进行专属加速 | 查询用户或用户组、相同查询的出现次数、单次查询耗时 | 自动创建或人工确认创建 |
| 资产级加速 | 按资产范围持续识别查询热点并自动创建投影 | catalog、schema、table、view、查询用户、排除范围和热点条件 | 系统自动创建 |
原“智能加速策略”现归为资产级加速。已有资产范围、排除范围和热点阈值等配置方式保持不变。
功能入口
进入 平台管理 > 投影管理，可以使用以下功能：
- 智能投影：查看由智能投影策略创建的投影。
- 待加速查询：查看查询级加速识别出的候选查询，并执行人工确认、重试、忽略等操作。
- 智能投影策略：创建和管理查询级加速或资产级加速策略。
- 投影回收策略：配置智能投影和人工投影的回收规则。
- 投影回收站：查看和恢复已回收的投影。
- 投影操作记录：查看投影删除等操作记录。
智能投影
智能投影页面展示基于查询级加速或资产级加速策略创建的投影，支持：
- 根据投影名称或关联视图搜索。
- 根据投影状态筛选。
- 查看投影命中的策略和加速模式。
- 查看关联视图、可影响 SQL 数、存储大小和创建时间。
- 删除不再需要的智能投影。
智能投影策略
智能投影策略页面展示策略名称、状态、加速模式、加速对象、排除对象和描述。列表支持按名称和状态筛选，并支持新建、编辑、启用、停用和删除策略。
只有处于已启用状态的策略会继续识别查询并触发加速。编辑策略时应先确认修改后的用户、资产范围和触发条件是否符合预期。
查询级加速
适用场景
查询级加速适合以下场景：
- 同一批用户会反复执行相同或等价的查询。
- 查询单次运行时间较长，适合通过预计算减少重复计算。
- 希望为具体查询创建专属视图和投影，而不是按整个资产范围持续发现热点。
- 希望由系统自动创建投影，或先由管理员确认候选查询后再创建。
系统会对已启用策略中的查询用户或用户组进行观察。只有查询可以被安全识别、单次运行耗时超过阈值，并且相同查询在统计窗口内的出现次数超过阈值时，才会形成查询级加速候选。
页面中的“超过”表示严格大于。例如配置“1 天内相同查询超过 5 次”，第 6 次满足其他条件的查询才会超过次数阈值。
示例
假设分析师用户组每天重复执行客户销售汇总查询，可以创建以下策略：
| 配置项 | 示例值 |
|---|---|
| 策略名称 | 客户销售重复查询加速 |
| 加速模式 | 查询级加速 |
| 查询用户 | 分析师用户组 |
| 统计窗口 | 1 天 |
| 相同查询次数 | 超过 5 次 |
| 单次查询耗时 | 超过 20 秒 |
| 投影创建 | 人工确认创建 |
| 投影初始化 | 创建后自动启用并刷新 |
使用人工确认创建时，系统先将满足条件的查询放入待加速查询，管理员确认后再创建视图和投影。
新建查询级加速策略
- 进入 平台管理 > 投影管理 > 智能投影策略。
- 单击右上角 新建智能投影策略。
- 填写策略名称和描述。策略名称必填，最多 256 个字符。
- 在 加速模式 中选择 查询级加速。
- 在 查询用户 中选择至少一个用户或用户组。
- 配置触发条件：
- 统计窗口：支持天、月、年，数值必须大于 0。
- 相同查询次数：必须大于 0。
- 单次查询耗时：以秒为单位，必须大于 0。
- 选择投影创建方式：
- 自动创建：识别到待加速 SQL 后，系统直接创建视图和投影。
- 人工确认创建：识别到待加速 SQL 后，先进入待加速查询列表，由管理员确认。
- 根据需要设置 创建后自动启用并刷新。开启后，投影创建成功会立即启用并执行首次全量刷新。
- 单击 创建。新策略创建后默认为已启用状态。
处理待加速查询
当查询级加速策略使用人工确认创建时，进入 平台管理 > 投影管理 > 待加速查询 处理候选查询。
页面支持按状态、命中策略和推荐时间筛选。默认推荐时间范围为最近 7 天。
不同状态对应的操作如下：
| 状态 | 说明 | 可执行操作 |
|---|---|---|
| 待确认 | 查询已满足策略条件，尚未创建投影 | 查看、立即加速、忽略 |
| 创建中 | 正在创建视图或投影 | 查看 |
| 已加速 | 关联投影已经创建 | 查看、删除关联投影 |
| 创建失败 | 创建视图或投影失败 | 查看、重新加速 |
| 已忽略 | 管理员暂不处理该候选 | 查看、恢复 |
| 已过期 | 候选已经过期 | 查看 |
| 未知 | 无法识别的状态 | 查看 |
只有待确认和创建失败的记录可以加入批量选择。单击 批量加速 后，系统会立即加速待确认查询，并重新处理创建失败的查询。
以下操作会改变候选状态或关联资源：
- 立即加速：为当前查询创建视图和智能投影。
- 忽略：将候选标记为已忽略，不再作为当前待确认项处理。
- 恢复：将已忽略候选恢复为待确认状态。
- 重新加速：重新尝试为创建失败的候选生成智能投影。
- 删除关联投影：依次删除候选关联的投影和视图，并将候选恢复为待确认状态。执行前应确认下游依赖。
查看查询详情
在待加速查询列表单击 查看，可以查看：
- 命中策略、推荐时间、关联投影和当前状态。
- 原始查询 SQL，支持复制和在 SQL 中查找。
- 查询记录，包括查询时间、查询用户和查询耗时。
- 创建失败时的失败原因。
验证查询级加速结果
- 在待加速查询列表确认记录状态变为 已加速。
- 单击关联投影，检查投影状态和首次刷新结果。
- 在 智能投影 页面确认加速模式为 查询级加速，并核对命中策略。
- 再次执行相同查询，确认查询能够使用已创建且可用的投影。
投影尚未创建成功、未启用或未完成首次刷新时，后续查询暂时不能使用该投影。
资产级加速
资产级加速是原“智能加速策略”的新名称。它按配置的资产和用户范围持续识别查询热点，并根据查询计算量和数据规模动态创建智能投影。
新建资产级加速策略
- 进入 平台管理 > 投影管理 > 智能投影策略。
- 单击右上角 新建智能投影策略。
- 填写策略名称和描述。
- 在 加速模式 中选择 资产级加速。
- 填写 加速对象。支持 catalog、schema、table、view 的完整路径，多个路径使用换行分隔。
- 选择需要加速的查询用户或用户组。
- 如果部分对象或用户不需要加速，开启 排除范围，填写排除对象并选择排除用户。
- 配置触发条件：统计窗口内相同查询的次数，以及单次查询耗时。
- 单击 创建。
配置说明
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 名称 | 是 | 策略名称，最多 256 个字符 |
| 描述 | 否 | 策略用途说明 |
| 加速对象 | 是 | catalog、schema、table 或 view 的完整路径；多个路径换行分隔 |
| 查询用户 | 是 | 支持选择用户或用户组 |
| 排除范围 | 否 | 开启后，命中排除对象或排除用户的查询不参与当前策略 |
| 统计窗口 | 是 | 支持天、月、年，数值不小于 1 |
| 相同查询次数 | 是 | 在统计窗口内需要超过的查询次数 |
| 单次查询耗时 | 否 | 以秒为单位；用于排除执行时间较短的查询 |
配置资产路径时，应确保路径真实存在且当前集群可以访问。catalog 或 schema 路径会覆盖其下级对象；table 或 view 路径只覆盖指定对象。
管理智能投影策略
在智能投影策略列表中，可以执行以下操作：
- 编辑：修改基础信息和加速策略。编辑查询级加速策略时，可以在自动创建和人工确认创建之间切换。
- 启用/停用：停用后，策略不再识别新的查询；重新启用后继续按当前配置工作。
- 删除：删除策略前，应确认是否仍需要使用由该策略创建的智能投影。
投影回收策略
投影回收策略页面展示已经创建的回收策略。创建策略后，系统会根据配置自动回收投影。页面支持：
- 根据策略名称和状态筛选。
- 新建和编辑回收策略。
- 启用、停用或删除回收策略。
新建投影回收策略
新建投影回收策略时，需要填写基础信息和回收策略。可以为智能投影和人工投影配置不同规则。
默认规则为：7 天内未被使用的投影自动回收；回收后可以在投影回收站查看；回收 30 天后系统自动删除。
回收规则还支持根据投影大小和使用情况进行自定义。
人工投影可以根据回收对象、视图类型和用户配置回收范围。
投影回收站
投影回收站展示当前租户下已回收的投影记录，可以按页面提供的操作恢复或删除投影。
投影操作记录
投影操作记录展示当前租户下的投影删除等操作记录。
常见问题
查询级加速一直没有产生候选
按以下顺序检查：
- 策略是否为已启用状态。
- 查询用户是否属于策略配置的用户或用户组。
- 单次查询运行耗时是否严格超过配置阈值。
- 相同查询在统计窗口内的次数是否严格超过配置阈值。
- 查询是否可以被系统安全识别并用于创建可复用投影。
人工确认策略没有自动创建投影
这是预期行为。进入待加速查询，对待确认记录执行立即加速或批量加速。
创建失败后如何处理
单击查看确认失败原因，处理资源、权限或源对象问题后，单击重新加速。
资产级加速没有覆盖预期对象
检查加速对象的完整路径、查询用户和排除范围。排除对象或排除用户命中后，查询不会参与当前策略。
生成说明
本文基于以下代码和当前分支页面整理：
workstation/src/pages/Manage/IntelligentRpStrategy/workstation/src/pages/Manage/PendingAccelerationQuery/workstation/src/pages/Manage/IntelligentRp/workstation/src/services/rpManage/workstation/src/locales/zh-CN/rpManage.tsdwstardis/web/src/main/java/com/aloudata/dws/web/management/platform/PlatformIntelligentRpStrategyController.javatardis/tardis-intelligence/tardis/tardis-intelligence-common/
待确认事项数量：0。