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

使用前提 #

1. 已完成数据源创建。详见“创建数据源”。
2. 已完成物理表创建。详见“物理表管理”。

新建逻辑表 #

1. 登录DataLeap控制台 。

2. 在右侧快速入口，单击数据服务按钮，并快速进入到数据服务 > 数据源 > 逻辑表界面。

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

   1. 在新建文件夹弹窗中，输入文件夹名称；
   2. 单击确定按钮，完成文件夹创建。

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

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

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

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

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

查看逻辑表 #

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

• 基础信息：
  展示当前逻辑表的基础信息，包括表名、数据源类型、存储路径、负责人等信息，可单击更多按钮，进行基础信息的编辑、设置主备关系以及逻辑表的删除。
• 字段信息：
  展示当前逻辑表的字段信息，可单击右上角编辑表字段按钮，进行字段信息编辑。详见编辑逻辑表。
• 预览探查：
  展示当前逻辑表的抽样数据，同时可通过该板块查询逻辑表的数据，进行初版的数据探查与验证。在SQL探查编辑界面，您可进行以下操作：
  
  • 鼠标移动至查询示例按钮，可展现查询当前逻辑表的SQL语句示例，您也可将语句添加至编辑器中。
  • 单击运行按钮，运行编辑完的SQL语句，将会在下方展现出运行结果，及查询日志等信息。
  • 单击格式化按钮，可对输入的SQL语句，进行格式化操作，使其语法结构看起来简洁明了。
  • 单击全屏按钮，可全屏展现语句编辑界面。
• 授权管理：
  展示当前逻辑表在项目下的授权信息情况，单击新增授权按钮，可针对表进行新项目的授权；若后续需要收回权限，您可单击操作列下的回收权限按钮，收回对应的权限。
• 变更记录：
  展示当前逻辑表的字段更新记录，如遇紧急情况，选择历史版本后，单击回退至该版本按钮，可将逻辑表回退至选中的历史版本。

编辑逻辑表 #

字段编辑 #

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

• 支持对表的字段信息，如字段名称、字段中文名、字段类型、字段描述、安全等级、主键信息、关联指标/维度等信息进行修改。
• 若您需要切换物理表，您可在不影响下游API的情况下，无缝切换至新的物理表：
  1. 单击编辑界面上方切换物理表按钮，进入切换物理表界面。
  2. 选择新的来源物理表名称，进行逻辑表与物理表之间的字段映射操作。
  3. 您可手动将右侧选中的物理表字段，通过拖拽方式，拖动到映射区域进行字段映射；同时，您也通过同名映射、同行映射的方式，进行字段映射。

  注意

  字段的编辑请考虑对下游的使用影响，需保证在无风险的情况下进行字段的相关更新！

基本信息编辑 #

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

设备主备关系 #

在逻辑表详情展示界面，单击右上角更多 > 设置主备关系按钮，即可为该逻辑表设置主备关系。
整表备份：
要求备份物理表和原物理表必须是同种数据源类型的物理表，且备份物理表和原物理表的字段必须完全一致。当开启整表备份时，逻辑表中所有字段都路由到备份物理表的字段上。

1. 下拉选择需备份的物理表信息，单击添加按钮，可添加多个备份物理表。
2. 在对应备份物理表字段中，选择逻辑表字段与物理表字段的映射。
3. 备份关系设置好之后，单击上线使用开关，即可把该备份表切换为线上使用的表，即实际流量会访问备份表。

删除逻辑表 #

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

目录树操作 #

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

• 搜索逻辑表：

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

• 文件夹操作：

  • 单击新建文件夹按钮，创建逻辑表存储目录路径文件夹。
  • 单击收起所有目录按钮，目录树中只展现文件夹信息。

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

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

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