创建飞书电子表格数据源

登录飞书开放平台，点击创建企业自建应用，在创建弹窗中维护应用的相关信息，完成后点击创建。

Quick BI是通过API接口读取飞书电子表格数据，因此您需要为当前应用申请飞书API接口的权限。在应用的开发者后台，选择左侧导航栏权限管理，在API权限页签下为当前创建的应用配置所需权限。

您需要勾选以下API权限并点击批量开通。

• 查看、评论、编辑和管理云空间中所有文件

• 查看、评论、编辑和管理电子表格

• 查看、评论和导出电子表格

• 管理应用自身资源

• 获取应用信息

点击提示弹窗中的确认并前往创建应用版本。

在跳转版本管理与发布页面中，选择创建版本。

维护版本详情，完成后点击保存 > 申请线上发布，即可完成当前应用的发布。

在应用的开发者后台 > 凭证与基础信息页面，复制并保存当前应用的App ID与App Secret。

在飞书云文档的文档列表中，找到需要接入Quick BI的目标电子表格，点击其操作列下拉列表中的分享。

在分享文档弹窗中设置链接的分享范围。

点击复制链接按钮，复制并保存当前电子表格的分享链接。

登录Quick BI工作台 > 数据源，点击数据源页面右上角的新建数据源。

在新建数据源页面选择应用服务 > 飞书电子表格。

在跳转配置页面中，填入通过步骤一、步骤二获取的飞书端相关授权信息。

• 如果您的组织已在组织管理 > 办公软件接入处完成飞书接口授权，那么在创建飞书电子表格数据源时，系统将自动为您读取已授权的应用，请确保该应用已被授予飞书侧电子表格相关接口的调用权限。

• 如果您的组织未在组织管理> 办公软件接入处完成飞书接口授权，您需要将在步骤一中创建的企业自建应用的相关授权信息配置在此处。

  配置内容	配置说明
  AppKey	填入飞书应用的唯一标识，对应飞书开发者后台凭证与基础信息页面中的 App ID。
  AppSecret	填入飞书应用的密钥，在创建当前应用时由飞书平台自动生成。对应飞书开发者后台凭证与基础信息页面中的App Secret。
  飞书电子表格链接	填入飞书电子表格分享链接，对应飞书文档分享页面中复制的链接。

点击连接测试，测试通过后页面上即会显示授权应用的信息。

点击确定连接，系统将自动解析读取当前URL下的所有Sheet页内容：

• 当所有Sheet页解析成功时，将跳转至数据预览页面。您可以在此预览以下信息并进行相关操作。

  展示内容	配置内容	配置操作
  区域 ① 电子表格在Quick BI系统中的展示名称	重命名展示名称	数据源展示名称为电子表格在Quick BI系统中的展示名称。当确认连接表格时，系统会自动识别表格名称，并作为该表格在Quick BI系统中的展示名称，您可以根据实际需求自定义修改。 说明 展示名称不允许使用特殊字符，且前后不能包含空格。
  区域② 电子表格的分享链接	跳转查看源文档	点击表格链接旁的图标，即可在跳转新窗口中查看当前表格在飞书端的源文档。
  区域 ③ 电子表格的表格页数量及标题	切换表格页	单击页签切换表格页以预览不同表格页中的数据内容，数据内容（即区域④）会随着页签的切换而相应调整。
  	重命名表格页	双击名称以根据实际业务意义重命名当前表格页，默认读取飞书端电子表格中的表格页名称。 说明 表格页名称不允许使用特殊字符，且前后不能包含空格。
  区域 ④ 电子表格的数据内容	数据预览	在数据预览页签下预览数据内容，并进行以下操作。 修改字段名称：单击字段名称输入框，修改字段名。 修改字段类型：点击字段类型图标，在下拉列表中选择合适的字段类型。支持的类型包括文本、数值、日期。 说明 不支持继承飞书源文档中的计算公式，导入后仅保留数值。
  	字段详情	表格接入后，会以数据库表的形式存储，数据库字段名称和字段类型为生成数据库表的字段名和类型，而字段名称对应飞书电子表格中数据表的字段名称。 您可以在此根据实际情况重命名字段名称、修改字段类型。当不需要使用某一个字段时，点击图标即可将其删除。 说明 不支持继承飞书源文档中的计算公式，导入后仅保留数值。
  	设置定时同步	当您需要每天向Quick BI电子表格数据源中定时同步最新业务数据时，您可以将定时同步开关置于开启状态，并在数据定时同步弹窗中设置每天需要同步数据的时间点。 设定完成后，也可以通过点击图标修改已有的定时同步设置。 说明 每次同步都会全量覆盖原有数据，单个表格页的同步上限为10000行和100列。 该项设置仅对当前Sheet页生效，如果您有多个Sheet页需要同步，请逐一切换至相应Sheet页页签设置定时同步时间。
  	设置标题行	系统默认将电子表格的首行识别为表头行，第二行开始识别为要同步的数据。您也可以根据实际情况，在此修改当前Sheet的标题行，点击刷新按钮即可生效。 说明 输入的数字需为大于0的整数。 请确保标题行中没有空字段，否则将触发报错。

• 当存在解析失败的Sheet页时，您可以在数据预览页面查看该Sheet页解析失败的原因，并在根据提示调整内容后，通过点击右上角刷新按钮完成更正；如果该Sheet页无实际业务意义，您也可以不对该Sheet页进行内容更正，后续完成其他Sheet页信息确认后，连接飞书电子表格时，该解析失败的Sheet页将会被自动过滤。

完成配置后点击确认并连接，完成飞书表格数据源创建。

回到数据源页面，在数据源列表中找到刚才接入的飞书电子表格数据源，点击各表格页操作列的图标以同步数据。

（可选）您可以在数据源页面中，查看并管理已创建的飞书电子表格数据源及其下的表格页，支持进行以下操作。

• 预览Sheet页：在名称列找到需要预览的Sheet页，点击其名称，即可在预览数据页面查看当前Sheet页的内容。

• 设置定时同步：点击定时同步开关，修改定时同步功能的开启状态；也可以在定时同步开启的前提下，点击图标修改定时同步的时间点。

• 创建数据集：点击图标，即可跳转至数据集创建页面，在当前表格页的基础上创建数据集。关于创建数据集的详细操作说明，请参见创建并管理数据集。

  说明

  请确保当前表格页的同步状态为成功，否则无法基于此表格页创建数据集。

• 同步数据：点击图标以手动触发同步任务。

• 查看同步记录：点击图标，在查看日志弹窗中查看当前表格页的历史更新记录，展示的内容包括：更新的时间、状态、耗时、日志信息，且支持根据特定的时间范围查询相关日志。

飞书电子表格列表中，找到目标数据源并点击编辑按钮。

在飞书电子表格的选择数据界面，修改飞书应用的授权信息。

点击连通测试，校验通过后点击确定连接，即可跳转至预览数据界面。您可以在此根据实际需求编辑电子表格的展示名称、定时同步设置、字段名称、数据类型等信息，具体操作说明同创建数据源中的第5步。

完成编辑后点击确认并连接。