You need to enable JavaScript to run this app.
导航

飞书多维表格

最近更新时间2024.02.21 14:03:24

首次发布时间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 转换成时间戳。
示例

字段AtoUnixTimestamp(字段A)扩展:toDateTime(toUnixTimestamp(字段A)+28800)
2020-12-21 18:00:0016085448002020-12-22 02:00:00

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

3.3 注意事项

  • 数据集 owner 需要有飞书多维表格的读权限。

  • 填写一个链接,会把该表格下所有数据表都导入。

  • 文档需要起名,不能是“未命名表格”,文档和 sheet 名字不要包含英文的点号'.',否则可能会导致文档 schema 获取失败。

  • 列名尽量是一个普通文本,不能是纯数字,不能是图片、超链接,不能命名为 p_date,不要包含$,`(反引号),!,否则会同步失败;创建数据集之后飞书表格的列名不要随便修改,否则会导致同步失败。

  • 列名不能重复,否则会报错。

  • 建议行不要为空,空行计入到 sheet 的行数里面,将[null,null,null,null]格式数据加入到数据集里,影响统计。

  • 不支持表格公式

  • 不支持普通飞书表格中的多维表格 sheet 接入