逻辑表管理

逻辑表是数据开发者在平台进行逻辑建模后产生的虚拟表，是物理表的一个映射。通过逻辑表屏蔽底层存储细节，完成物理表字段类型转换、规范命名、备份容灾配置等。您在实际配置 API 时必须使用逻辑表，不支持直接使用物理表。

1 使用前提

1. 已完成数据源创建。详见创建数据源。

2. 已完成物理表创建。详见物理表管理。

2 新建逻辑表

1. 登录 DataLeap租户控制台 。

2. 在概览界面顶部服务窗口，单击数据服务按钮，可快速进入到数据服务功能界面。

3. 在数据服务界面，上方导航栏中切换至数据源页签，直接进入逻辑表界面。

4. 在目录树中，单击新建文件夹按钮，创建逻辑表存储目录路径：

   

   1. 在新建文件夹弹窗中，输入文件夹名称；

   2. 单击确定按钮，完成文件夹创建。

5. 文件夹创建完成后，单击目录树上的新建逻辑表按钮，左侧即展现新建逻辑表界面。

6. 在新建逻辑表界面，目前支持极简模式和标准模式来创建逻辑表：

   • 极简模式：支持快速批量创建逻辑表，通过在待选物理表窗口，同时选择多张物理表来批量创建多张逻辑表，并指定默认授权项目。您也可对逻辑表名称、存储路径进行信息编辑。

   • 标准模式（推荐）：支持单张逻辑表创建，配置说明如下：

     配置项	说明
     数据源类型	下拉选择要创建逻辑表所对应的数据源类型，目前支持选择 MySQL、ByteHouse、Doris、StarRocks 数据源类型。
     物理表选择	在对应数据源类型下，待选窗口展现已创建成功且当前登录用户为 Owner 的物理表信息，根据实际情况，单击选择物理表名称，进行对应逻辑表的创建。 说明 您也可以在创建物理表的过程中，直接选择是否创建同名逻辑表。详见新建物理表。
     逻辑表字段	默认展示物理表所有字段，可根据实际情况配置逻辑表所需字段，并进行字段中文名、字段描述、字段安全等级的编辑。
     查询约束	查询约束用于避免慢查询，与主键无关；一条查询约束是一组字段, 可设置多条；若设置约束，则查询的入参必须传其中一条约束的全部字段，否则将 sql 无法执行。
     基本信息	设置逻辑表基本信息： 默认授权项目：逻辑表创建时可以选择默认授权的项目；创建后，您也可以通过逻辑表-授权管理tab来查看已授权的项目； 逻辑表名称：用于标识逻辑表，API 开发用该信息，一般情况下与物理表同名； 存储目录：下拉选择逻辑表保存的目录路径，展现已创建的文件夹名称； 安全等级：设置表安全等级，分为 L1-公开、L2-内部、L3-秘密、L4-机密 4 种安全等级。 描述：逻辑表相关信息补充，方便后续维护管理； 下游 API 使用管控：API 使用该逻辑表时，API 发布可以增加通知或审核，管控方式支持 API 发布审核、API 发布通知、无需发布管理三种方式。

7. 以上配置完成后，单击保存按钮，完成逻辑表创建。

3 查看逻辑表

逻辑表创建完成后，在目录树中单击逻辑表名称，便会在右侧展现出逻辑表详情：

• 基础信息：

  展示当前逻辑表的基础信息，包括表名、数据源类型、存储路径、负责人等信息，可单击更多进行基础信息的编辑、添加标签、设置主备关系以及逻辑表的删除。编辑操作详见编辑逻辑表。

• 字段信息：

  展示当前逻辑表的字段信息，可单击右上角编辑表字段按钮，进行字段信息编辑。详见编辑逻辑表。

• 预览探查：

  展示当前逻辑表的抽样数据，同时可通过该板块查询逻辑表的数据，进行初版的数据探查与验证。在 SQL 探查编辑界面，您可进行以下操作：
  

  • 鼠标移动至查询示例按钮，可展现查询当前逻辑表的 SQL 语句示例，您也可将语句添加至编辑器中。

  • 单击运行按钮，运行编辑完的 SQL 语句，将会在下方展现出运行结果，及查询日志等信息。

  • 单击格式化按钮，可对输入的 SQL 语句，进行格式化操作，使其语法结构看起来简洁明了。

  • 单击全屏按钮，可全屏展现语句编辑界面。
    

• 授权管理：

  展示当前逻辑表所属项目的情况，可针对表进行新项目的授权和回收权限操作。

• 变更记录：

  展示当前逻辑表的字段更新记录，如遇紧急情况，选择历史版本后，单击回退至该版本按钮，可将逻辑表回退至选中的历史版本。

4 编辑逻辑表

4.1 字段编辑

在逻辑表详情界面，您可在字段信息页签，进行编辑逻辑表字段信息：
单击编辑表字段按钮，进入编辑字段信息界面：

• 支持对表的字段信息，如字段名称、字段中文名、字段类型、字段描述、安全等级、主键信息、关联指标/维度等信息进行修改。

• 若您需要切换物理表，您可在不影响下游 API 的情况下，无缝切换至新的物理表：

  • 单击编辑界面上方切换物理表按钮，进入切换物理表界面。

  • 选择新的来源物理表名称，进行逻辑表与物理表之间的字段映射操作。

  • 您可手动将右侧选中的物理表字段，通过拖拽方式，拖动到映射区域进行字段映射；同时，您也通过同名映射、同行映射的方式，进行字段映射。

4.2 基本信息编辑

在逻辑表详情展示界面，单击右上角更多 > 编辑按钮，进入逻辑表基本信息的编辑：

4.3 设置主备关系

在逻辑表详情展示界面，单击右上角更多 > 设置主备关系按钮，即可为该逻辑表设置主备关系。

支持整表备份：

要求备份物理表和原物理表必须是同种数据源类型的物理表，且备份物理表和原物理表的字段必须完全一致。当开启整表备份时，逻辑表中所有字段都路由到备份物理表的字段上。

• 下拉选择需备份的物理表信息，单击添加按钮，可添加多个备份物理表。

• 在对应备份物理表字段中，选择逻辑表字段与物理表字段的映射。

• 备份关系设置好之后，单击上线使用开关，即可把该备份表切换为线上使用的表，即实际流量会访问备份表。

4.4 删除逻辑表

当此逻辑表不再需要 API 访问时，您可将其逻辑表删除。
在逻辑表详情展示界面，单击右上角更多 > 删除按钮，二次弹窗中单击确定， 即可删除该逻辑表。

5 目录树操作

逻辑表创建完成后，您可在目录树进行以下操作：

• 搜索逻辑表：

  • 您可输入逻辑表名/ID/表负责人/描述等信息，对逻辑表进行搜索。

  • 打开输入栏右侧折叠按钮，可设置逻辑表搜索范围，也可根据数据源类型、标签、负责人信息，进行搜索。

  

• 文件夹操作：

  • 单击新建文件夹按钮，创建逻辑表存储目录路径文件夹。

  • 单击收起所有目录按钮，目录树中只展现文件夹信息。

• 定位逻辑表：

  右侧打开逻辑表详情窗口时，您可通过定位按钮，快速定位到物理表在目录树中的位置。

• 单逻辑表操作：

  单击逻辑表名称右侧更多按钮，可进行以下操作：

  操作	说明
  标签	为当前逻辑表添加标签信息，方便快速搜索过滤。操作详见 4.2 基本信息编辑。
  变更负责人	将逻辑表负责人变更为当前项目下其他成员。成员管理详见项目管理。
  移动	将逻辑表从当前目录位置，移动到其他目标文件夹路径下。
  删除	将当前逻辑表进行删除。