飞书多维表格
最近更新时间：2023.05.24 16:48:01
首次发布时间：2022.04.08 16:20:38
开启飞书数据集，需先行完成接入飞书应用中“2. 基础配置”。
飞书多维表格是一款以表格为基础的业务管理工具，能够从多个维度管理项目，同时还支持多种汇总视图。 因此在项目管理、业务管理场景中，你可能会使用飞书多维表格，而非飞书表格进行数据记录。目前，飞书多维表格已支持接入数据集进行数据分析。
（1）在数据准备中的数据集模块，点击左侧数据集列表上方「新建」-「新建数据集」。
（2）选择连接「飞书多维表格」。
（3）输入飞书多维表格链接，点击「确定」创建数据连接。
（4）在数据连接中，找到并单击选择刚刚接入的那张飞书多维表格。
（5）进入数据集配置界面，进行配置。
数据集配置可参考数据集字段配置。数据集保存并完成创建后，将根据设置的同步频率进行数据同步。在飞书多维表格数据集中，每次同步将获取对应模型中的全量数据，写入当前分区。
3.1 支持字段类型
飞书多维表格支持多种字段格式，包括文本、单选/多选、日期、人员、附件等。这些字段格式在接入数据集时将会进行映射处理。 其中，附件、关联、查找引用、公式字段不支持接入数据集。
| 多维表格字段类型 | 数据集映射字段类型 |
|---|---|
| 多行文本 | string 文本 |
| 数字 | double 数值 |
| 单选 | string 文本 |
| 多选 | array[string] 数组 |
| 日期 | bigint 数值（如需转为日期格式，需进行转化） |
| 复选框 | boolean 布尔类型，1为'是'，0为'否' |
| 人员 | string 文本 |
| 超链接 | string 文本 |
| 创建时间 | bigint 数值 |
| 最后更新时间 | bigint 数值 |
| 创建人 | string 文本 |
| 修改人 | string 文本 |
3.2 日期/时间类型字段时区说明
接入数据集的日期/时间字段，与飞书多维表格中日期/时间字段的时间戳保持一致。
在飞书多维表格中，会根据用户当地时区，显示当地时间。但在接入数据集后，将根据数据集所在机房显示对应时间，默认显示为 UTC+8。
3.3 注意事项
数据集 owner 需要有飞书多维表格的读权限。
填写一个链接，会把该表格下所有数据表都导入。
文档需要起名，不能是“未命名表格”，文档和 sheet 名字不要包含英文的点号'.'，否则可能会导致文档 schema 获取失败。
列名尽量是一个普通文本，不能是纯数字，不能是图片、超链接，不能命名为 p_date，不要包含$，`(反引号)，!，否则会同步失败；创建数据集之后飞书表格的列名不要随便修改，否则会导致同步失败。
列名不能重复，否则会报错。
建议行不要为空，空行计入到 sheet 的行数里面，将[null,null,null,null]格式数据加入到数据集里，影响统计。
不支持表格公式
不支持普通飞书表格中的多维表格 sheet 接入