创建飞书电子表格数据源

步骤一：获取应用授权信息

您需要在飞书开放平台中创建企业自建应用，并获取相关授权信息，用于后续在Quick BI中创建数据源时认证使用。具体操作说明如下。

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

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

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

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

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

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

   • 管理应用自身资源

   • 获取应用信息

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

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

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

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

步骤二：获取电子表格链接

登录飞书云文档，找到需要接入Quick BI的目标电子表格，复制并保存分享链接。具体操作如下。

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

   说明

   对于接入Quick BI的飞书电子表格，目前存在以下限制，请您提前确认表格是否符合限制。

   • 仅支持识别飞书普通电子表格。

   • 单个表格页列数不超过100列，行数不能超过10000行。

   • 飞书电子表格中的数据需为结构化数据，且避免在一列数据中存在不同的数据类型。

   • 请确保不存在电子表格首列为空、中间列为空、列名重复、存在合并单元格的情况，否则可能会导致数据解析、同步异常。

   • 不支持继承表格中的计算公式，导入后将仅保留数值。

   • 飞书电子表格Sheet页中的内容不能为空，且Sheet页数量需控制在5个以内。

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

   说明

   当链接分享范围设置为仅文档协作者可通过链接访问时，需要添加当前自建应用到表格的文档应用中。

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

步骤三：创建数据源

获取飞书授权信息及电子表格分享链接后，您需要将其添加至Quick BI数据源新建页面中，以接入飞书中的电子表格。具体操作说明如下。

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

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

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

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

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

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

   说明

   最多仅支持解析5个Sheet页。

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

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

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

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

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

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

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

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

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

     说明

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

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

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

步骤四：编辑数据源

将飞书电子表格接入Quick BI平台后，支持编辑该数据源的授权信息、表格分享链接、数据源展示名称等信息，具体操作如下。

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

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

   配置内容	配置说明
   已授权应用	点击已授权应用下拉框中的图标，页面中即会显示AppKey和AppSecret的输入框，在此维护新应用的AppKey和AppSecret。
   飞书电子表格链接	填入新表格的分享链接。

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

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