You need to enable JavaScript to run this app.
导航
飞书多维表格
最近更新时间:2024.08.06 15:19:15首次发布时间:2022.04.08 16:20:38

1. 概述

开启飞书数据集,需先行完成接入飞书应用中“2. 基础配置”。
飞书多维表格是一款以表格为基础的业务管理工具,能够从多个维度管理项目,同时还支持多种汇总视图。 因此在项目管理、业务管理场景中,你可能会使用飞书多维表格,而非飞书表格进行数据记录。目前,飞书多维表格已支持接入数据集进行数据分析。
图片

2. 快速入门

(1)在数据准备中的数据集模块,点击左侧数据集列表上方「新建」-「新建数据集」。
图片
(2)选择连接「飞书多维表格」。
图片
(3)输入飞书多维表格链接,点击「确定」创建数据连接。
图片
(4)在数据连接中,找到并单击选择刚刚接入的那张飞书多维表格。
图片
(5)进入数据集配置界面,进行配置。
图片
数据集配置可参考数据集字段配置。数据集保存并完成创建后,将根据设置的同步频率进行数据同步。在飞书多维表格数据集中,每次同步将获取对应模型中的全量数据,写入当前分区。

3. 功能介绍

3.1 支持字段类型

飞书多维表格支持多种字段格式,包括文本、单选/多选、日期、人员、附件等。这些字段格式在接入数据集时将会进行映射处理。 其中,附件、关联、查找引用、公式字段不支持接入数据集。

多维表格字段类型

数据集映射字段类型

多行文本

string 文本

数字

double 数值

单选

string 文本

多选

array[string] 数组

日期

bigint 数值(如需转为日期格式,需进行转化)

复选框

boolean 布尔类型,1为'是',0为'否'

人员

string 文本

超链接

string 文本

创建时间

bigint 数值

最后更新时间

bigint 数值

创建人

string 文本

修改人

string 文本

3.2 日期/时间类型字段时区说明

接入数据集的日期/时间字段,与飞书多维表格中日期/时间字段的时间戳保持一致。
具体表示为:在飞书多维表格中,会根据用户当地时区,显示当地时间。但在接入智能数据洞察生成数据集后,将根据数据集所在机房显示对应时间,默认显示为 UTC+8(原始时间+8小时),通常是针对飞书多维表格的默认原始时区加上8小时,显示为符合中国时区的时间格式。

时间戳:也称为 Unix 时间戳(Unix Timestamp),是一种将日期和时间表示为数字的方式。

格式:将时间或文本类型的时间转换成时间戳 toUnixTimestamp(xxx),即将 yyyy-mm-dd hh:mm:ss 转换成时间戳。
示例

字段A

toUnixTimestamp(字段A)

扩展:toDateTime(toUnixTimestamp(字段A)+28800)

2020-12-21 18:00:00

1608544800

2020-12-22 02:00:00

扩展:对转换后的时间戳,加上8小时对应的时间戳差值28800,完成从UTC+0到UTC+8的转换,然后再通过toDateTime函数转换成可读性更强的时间格式。

3.3 注意事项

权限与功能说明:

  • 数据集 owner 需要有飞书多维表格的读权限。
  • 用户填写一个飞书表格的链接后,将把该表格下所有数据表都导入。
  • 暂不支持表格公式。
  • 暂不支持普通飞书表格中的多个 sheet 接入。
  • 若存在空行,在行数统计时会被计入([null,null,null,null]格式数据会加入到数据集里)。

命名规范:

  • 在飞书文档、表格文件命名时,请注意命名规范,在表格名和sheet名中尽量避免英文的点号'.'。
  • 列名:在列名命名时,请注意命名规范,尽量为普通文本,避免出现纯数字、图片、超链接等列名,避免命名为 p_date 或包含$,`(反引号),! 等正则表达式;由于同步时抓取的是创建时的列名,请创建数据集后,勿随便修改。 列名应为唯一值。