语义视图自动构建-云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

云原生数据仓库 AnalyticDB MySQL 版支持通过SQL材料自动构建语义视图草稿。在控制台创建构建任务、审阅和编辑草稿后，可采纳草稿并创建正式语义视图。

前提条件

语义视图功能目前处于公测阶段，部分地域尚未开放。如需使用，请提交工单或联系技术支持。
已完成RAM用户与数据库账号绑定。
SQL 引用的库表和字段已存在于目标集群，名称与实际环境一致。

语义视图沿用 AnalyticDB MySQL版普通视图的数据库权限要求。采纳草稿创建正式视图需要目标对象范围的 CREATE VIEW 权限，以及所引用对象的 SELECT 权限；查看正式定义需要 SHOW VIEW 和 SELECT 权限。授权方法参见数据库权限模型。

访问语义视图自动推荐

登录AnalyticDB MySQL版控制台，选择地域并进入目标集群。
在左侧导航栏，选择数据管理 > 视图自动推荐，切换到语义视图页签。
页面以任务列表展示构建任务。单击任务行的详情可打开任务页签，查看该任务的材料、构建状态和生成结果。

构建任务

任务列表提供以下操作：

操作	控制台说明
创建任务	单击创建任务打开表单。任务名称按需填写，目标数据库为必填项，用于指定正式视图所在数据库。提交后，新任务显示在列表中。
查看任务	列表展示目标数据库、生成内容、状态和创建时间等信息。单击详情可打开对应任务。
刷新列表	单击刷新获取最新任务状态和生成结果。

任务详情根据当前阶段显示材料准备或草稿确认区域。进入 确认采纳 阶段后，可在草稿列表中查看本次构建生成的语义视图。

SQL 材料

上传文件

任务处于 准备材料 阶段时，上传文件 入口用于添加构建材料。上传对话框提供以下配置：

配置项	说明
选择文件	仅支持 .sql 文件，单个文件不超过 2 MB，每次选择一份。
业务含义	用于补充查询用途、时间口径、筛选范围及需要关注的计算规则。
重要程度	可选重点、普通或参考，默认为普通。建议核心分析材料选择重点，一般业务查询选择普通，背景材料选择参考。

单击确定提交文件。一个任务可以依次上传多份 SQL 文件，并将这些材料用于同一次构建。材料列表展示文件名、大小和上传状态，可通过刷新查看最新结果。

说明

建议选用同一业务主题下具有代表性的查询，保留完整的聚合表达式、筛选条件和表连接条件。上传材料用于辅助生成语义定义，不会导入业务数据，也不代表执行这些 SQL。

开始构建与查看输入

开始构建 用于提交当前任务的全部材料。提交前，应在材料列表中确认所需文件已上传完成。

重要

开始构建后，该任务的材料不可再修改。 如需补充或修正材料，请使用整理后的完整输入创建新任务。任务详情中的 上下文输入 可用于查看本次提交的材料。

构建状态可通过刷新更新。构建成功后，页面展示生成的草稿；一个任务可能生成多个草稿，文件数与草稿数不一定一一对应。

草稿详情与编辑

草稿列表中的详情入口打开 语义视图详情。详情页提供概览和 YAML 两种查看方式。

页面区域	可用操作
视图信息	查看视图名称和业务描述；通过旁边的编辑入口修改并保存。
概览	展开逻辑表及其维度、事实、指标、过滤器，或查看视图级的派生指标、关系和已验证查询。可在条目提供的编辑入口中修改相应内容。
YAML	查看完整定义，按需复制或下载。该页签为只读展示。

语义对象编辑表单中的字段以当前页面为准。单击 保存并同步 YAML 后，修改会写入草稿定义；重新打开条目或切换到 YAML，可核对保存结果。保存草稿不会创建或更新正式视图。

审阅时，可重点核对物理表映射、字段和计算表达式、筛选条件，以及关系中的左右逻辑表和关联列。对象结构以语义YAML内容规范为准。各类对象在控制台中的查看和编辑位置，参见语义视图详情与管理。

采纳草稿

采纳用于将审阅后的草稿创建为正式语义视图。控制台提供以下入口：

入口	用途
草稿行的采纳	采纳当前行的草稿。
草稿详情中的采纳此视图	采纳正在查看的草稿。
草稿列表中的批量采纳	采纳已勾选的多个草稿。

采纳会直接提交，操作前应确认目标数据库、视图名称和草稿内容。成功后，草稿状态显示为 已采纳。构建成功 表示已生成草稿，采纳成功 才表示正式视图已创建。

正式视图可在 数据管理 > 数据目录 > 目标数据库 > 语义视图 中查询。单击视图名可查看已写入的定义，并进行后续管理或 DryRun 验证。

说明

名称冲突时，应先核对已有正式对象。需要创建独立视图的，可修改草稿名称并保存后再采纳；已有正式视图的修改通过正式视图管理入口完成。

常见问题

问题	处理方法
文件上传失败	检查文件格式、大小及页面错误提示，确认上传成功后再构建。
构建失败	查看任务错误信息，核对目标数据库、SQL 中的库表字段及账号权限。
采纳失败	查看草稿的上次错误或操作提示，检查名称冲突、对象缺失与权限问题。
正式列表查不到已采纳视图	刷新列表，核对目标数据库、视图名称及账号权限。

无法定位问题时，保留任务及错误信息并联系技术支持。