Updated 构建语义模型 (markdown)

构建语义模型.md

@@ -1,10 +1,23 @@
-构建语义模型是使用超音数的第一步。在这个模块中, 它可以连接上你的数据库引擎, 并通过简单方便的方式来帮助你将物理数据建模为数据源、维度和指标等逻辑概念。建模完成后, 你就可以在问答中通过自然语言的方式来和你的物理数据交互啦~
+构建语义模型是使用超音数的第一步。在这个模块中, 它可以连接上你的数据库引擎, 并通过简单方便的方式来帮助你将物理数据建模为维度和指标等逻辑概念。建模完成后, 你就可以在问答中通过自然语言的方式来和你的物理数据交互啦~
 
 **问题示例**
 
 为了帮助你更好地理解建模的过程, 我们通过一个问题示例来进行介绍: 超音数本身作为一个产品, 那么如何用语义建模来统计它的埋点访问数据呢？比如超音数在一段时间内的访问用户数是多少？这些用户的访问次数和停留时长是怎样的？这些用户来自哪些部门？这些用户看了哪些页面？分别看了多少次？等我们建模完成, 这些问题的答案也就浮出水面了。
 
-### 数据库连接
+
+在超音数中, 模型归属于主题域, 主题域类似于一个分类的概念, 用户可以按自己的业务场景去创建主题域, 然后在主题域下面创建模型。
+
+### **1. 创建一个主题域**
+
+如图1-1所示, 为了统计超音数的埋点访问情况, 我们创建了一个叫"超音数"的主题域作为示例:
+
+<div align="center" >
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/a2a8dd3e-ff37-443f-a5db-6e026aa553dd  width="60%"/>
+    <p>图1-1 主题域示例</p>
+</div>
+
+### **2. 创建一个数据库连接**
+
 为了进行数据查询, 我们首先需要创建一个数据库连接, 创建一个数据库连接主要分为三个步骤, 
 1. 填写连接信息
 2. 点击测试连接, 若连接测试通过, 则可点击保存。否则, 返回步骤1
@@ -13,67 +26,40 @@
 如图1-1所示, 由于超音数的埋点访问数据被存放在H2数据库中, 因此我们创建了一个H2数据库实例作为例子。除了H2数据库以外, 我们还支持MySQL, ClickHouse等多种常见数据库。
 
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/b77ddbe0-0330-43ac-bffb-76409da4efe2/>
-    <p>图1-1 数据库连接示例</p>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/190d11e3-5670-4912-ac76-9d5deb4a2ec9/>
+    <p>图2-1 数据库连接示例</p>
 </div>
 
 
-需要说明的是, 在这里创建数据库之后, 并不是所有人都可以查询这个数据库链接的数据, 需要在图1-1表单上进行授权。
+需要说明的是, 在这里创建数据库之后, 并不是所有人都可以查询这个数据库链接的数据, 需要在图1-2表单上进行授权。
 
 **管理员**: 可以编辑这个数据库链接的人
 
 **使用者**: 可以使用这个数据库链接查询数据的人
 
 
-### 模型管理
-
-在超音数中, 模型归属于主题域, 主题域类似于一个分类的概念, 用户可以按自己的业务场景去创建主题域, 
-然后在主题域下面创建模型。
-
-### **1. 创建一个主题域**
-
-如图1-1所示, 为了统计超音数的埋点访问情况, 我们创建了一个叫"超音数"的主题域作为示例:
-
+### **3. 创建数据模型**
+有了数据库连接之后, 我们就可以把物理数据抽象为一个个数据模型。在超音数中, 数据模型是对数据库中数据的一种逻辑层面上的抽象, 它既可以直接指代一张物理表, 也可以由一段SQL逻辑表示而成。数据模型中涉及的字段可被指定为维度或者度量, 而这些维度和度量又可以衍生出更复杂的维度和指标。如图3-1, 超音数提供了两种创建数据模型的方式。
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/a2a8dd3e-ff37-443f-a5db-6e026aa553dd  width="60%"/>
-    <p>图2-1 主题域示例</p>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/229515ab-8f2d-409c-916b-a850a2106ddb/>
+    <p>图3-1 数据模型创建方式</p>
 </div>
 
-### **2. 创建一个模型**
-有了超音数这个主题域之后, 我们在超音数这个主题域下创建一个叫"超音数"的模型, 接下来即可基于这个模型来创建
-数据源、指标、维度等
+其中, **快速创建** 可以直接指定一张物理表来把它创建为数据模型, 而**SQL脚本** 则提供了更为灵活的数据模型创建方式, 我们可以通过写一条逻辑SQL来把它指定为数据模型
 
+如图3-2为通过**SQL脚本**的方式创建数据模型, 首先需要我们填写一些基本信息, 如数据模型名称和描述。
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/b0a93c7c-c682-4208-a9e4-52de5c64aa92 width="40%"/>
-    <p>图2-2 模型示例</p>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/801f725b-05cb-4857-991c-a24047f75be3/>
+    <p>图3-2 数据模型基本信息</p>
 </div>
 
-
-
-### **3. 创建数据源**
-创建模型之后, 我们首先需要把物理数据抽象为一个个数据源。在超音数中, 数据源是对数据库中数据的一种逻辑层面上的抽象, 它既可以直接指代一张物理表, 也可以由一段SQL逻辑表示而成。数据源中涉及的字段可被指定为维度或者度量, 而这些维度和度量又可以衍生出更复杂的维度和指标。如图3-1, 超音数提供了两种创建数据源方式。
-<div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/d537c5e1-3531-4fa3-a59d-192358176d1c/>
-    <p>图3-1 数据源创建方式</p>
-</div>
-
-其中, **快速创建** 可以直接指定一张物理表来把它创建为数据源, 而**SQL脚本** 则提供了更为灵活的数据源创建方式, 我们可以通过写一条逻辑SQL来把它指定为数据源
-
-如图3-2为通过**SQL脚本**的方式创建数据源, 首先我们写一条SQL来表达我们的数据源逻辑, 然后点击运行, 就可以看到这条SQL查询出来的数据, 校验数据无误之后, 我们可以点击生成数据源, 需要注意的是, 这里创建数据源选择数据库链接的时候, 需要有数据库的使用者权限.
+然后我们写一条SQL来表达我们的数据模型逻辑, 然后点击运行, 就可以看到这条SQL查询出来的数据, 校验数据无误之后, 我们可以点击生成数据模型, 需要注意的是, 这里创建数据模型选择数据库链接的时候, 需要有数据库的使用者权限.
 <div align="center" >
     <img src=https://github.com/tencentmusic/supersonic/assets/22031277/51f74df4-1b66-4191-90c1-bb71a797c39d/>
-    <p>图3-2 SQL脚本</p>
+    <p>图3-3 SQL脚本</p>
 </div>
 
-
-如图3-3所示, 点击生成数据源之后, 需要我们填写一些基本信息, 如数据源名称和描述, 填写完成之后, 点击下一步
-<div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/a234bc22-4d58-46b4-88a3-5b60339531cc/>
-    <p>图3-3 数据源基本信息</p>
-</div>
-
-
-如图3-4所示, 填写完基本信息之后, 需要填写一些字段信息, 把数据源的字段指定为维度或者度量, 其中日期和主键为特殊的维度。
+如图3-4所示, 执行完SQL之后, 根据SQL执行结果, 需要填写一些字段信息, 把数据模型的字段指定为维度或者度量, 其中日期和主键为特殊的维度。
 
 **维度**主要用于筛选和分组
 
@@ -81,42 +67,41 @@
 
 **日期字段**主要用于标识, 方便问答进行数据查询。
 
-**主键**则用于不同数据源之间的连接字段, 若多个不同数据源存在相同的主键, 则可以进行多数据源连接
+**主键**则用于不同数据模型之间的连接字段, 有了连接字段后，就可以在画布进行连接关系的配置, 配置完成, 在查询模型数据的时候, 多个模型之间就可以进行Join连接了
 
 <div align="center" >
     <img src=https://github.com/tencentmusic/supersonic/assets/22031277/7f7e811c-b5a3-41c8-a779-ad31f6272847/>
-    <p>图3-4 数据源字段信息</p>
+    <p>图3-4 数据模型字段信息</p>
 </div>
 
 把字段指定为维度/度量之后, 还可选择是否勾选**快速创建**单选框。若**勾选**, 则会直接把选中的维度/度量批量创建到维度/指标列表。
 若**不勾选**, 但字段已被选定为维度/度量, 该字段虽然不会直接被创建到维度/指标列表, 但是后续在创建衍生维度/指标的时候也可作为表达式中的字段被用上。
-如图3-5所示, 为我们创建的3个数据源示例, 分别为超音数用户停留时长统计, 访问次数和访问人数统计, 用户部门统计。
-
+如图3-5所示, 为我们创建的3个数据模型示例, 分别为超音数用户停留时长统计, 访问次数和访问人数统计, 用户部门统计。
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/6c898fa1-38b6-42df-bfd3-53eb25ea633e/>
-    <p>图3-5 数据源列表</p>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/c29d4fae-da13-46ed-91b4-1b5af745ed9b/>
+    <p>图3-5 模型列表</p>
 </div>
 
 
 ### **4. 创建维度**
-如图4-1, 为刚刚创建数据源时, 通过勾选**快速创建**按钮创建出来的维度。分别为用户名, 用户所在的部门, 用户浏览过的超音数页面。
+如图4-1, 为刚刚创建数据模型时, 通过勾选**快速创建**按钮创建出来的维度。分别为用户名, 用户所在的部门, 用户浏览过的超音数页面。
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/058807cc-43cc-4940-ac08-68fdf823dd5c/>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/d962de44-4850-43a2-9c59-2f731b81a8de/>
     <p>图4-1 维度列表</p>
 </div>
 
 若我们需要更复杂的维度, 如我们需要根据页面来划分模块, 那我们可以点击创建按钮来创建一个更复杂的维度。如图4-2所示
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/e030d2cc-5967-469a-9877-6dde12c8ef95/>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/0e3749e5-17de-4f94-9ffd-0d972ffd5518/>
     <p>图4-2 维度创建</p>
 </div>
 
 ### **5. 创建指标**
 和维度类似, 如图5-1为通过**快速创建**按钮创建出来的指标, 分别为访问超音数的次数, 人数和停留时长。这几个指标都可以在用户、部门 、页面等分组粒度上进行计算。
 <div align="center" >
-    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/e71cd379-c886-45f7-bb05-103cae03939c/>
+    <img src=https://github.com/tencentmusic/supersonic/assets/22031277/79c9b267-c3ae-43bb-8820-414481b1d326/>
     <p>图5-1 指标列表</p>
 </div>
 
 
-到此为止, 我们就成功把超音数的访问统计数据建模成了相关的数据源、维度和指标。通过在问答中直接对这些维度和指标进行提问, 就可以回答我们在介绍开头提到的那些问题啦！
+到此为止, 我们就成功把超音数的访问统计数据建模成了相关的数据模型、维度和指标。通过在问答中直接对这些维度和指标进行提问, 就可以回答我们在介绍开头提到的那些问题啦！