腾讯云 BI 腾讯文档建表

这篇说明腾讯云BI如何接入腾讯文档在线表格数据,包括新建数据表、自动与手动更新文档及时间格式处理,核心是授权后通过URL或我的文档选择Excel文件,并注意格式要求以避免数据异常。 新建数据表:需授权后选择文档,支持URL或我的文档方式,仅限微信/QQ登录文档。 自动更新:BI定期同步文档修改,结构变化或权限丢失时暂停更新。 手动更新:支持追加或替换数据,追加需列标题一致,替换可调整列结构。

相关产品
腾讯云 BI 产品页,含版本规格、价格与购买入口。

BI 支持接入你在腾讯文档上的在线表格数据,以用于报表配置。具体使用流程如下:

一、新建腾讯文档数据表

1. 在数据 > 数据表模块中,单击新建数据表。


2. 首次使用需要进行授权以拉取你的腾讯文档,单击授权按提示进行扫码授权即可。


3. 授权后,你可以选择“输入 URL”或者直接在“我的文档”中指定要接入的腾讯文档。若你登录错账号,可单击底部的切换账号,将回到未授权状态,此时可重新授权。


4. 若选择 URL 方式,你可以在输入框中粘贴腾讯文档的 URL,输入后单击下一步(当前版本仅支持微信、QQ 登录的文档接入,暂不支持企业微信登录的文档接入)。


5. 若选择我的文档方式,将拉取当前登录账号下,具有查看权限的在线 Excel 文件。你可通过单击的形式,指定某个 Excel 文件中的某个 sheet。同时,我们还提供了对文档名称的搜索能力,助你快速找到对应文档。

6. 指定好某个 sheet 后,底部下一步按钮将亮起,此时可单击进行下一步。若你进入错了文档,可单击文档上方的面包屑返回。


7. 在接入界面底部,我们提供了格式要求说明,方便你了解接入文档时的一些格式要求,具体格式要求如下:

·将以第一行作为字段名称,标题为空的列将不会被添加。

·若时间被 BI 识别为数值或字符,建议手动更改为对应格式。若时间为 YYYY/MM/DD HH:MM:SS 且未在文档中设置时间格式,预览时会乱码,此时在 BI 选择对应时间格式建表后可正常使用。 详情请参见 腾讯文档时间格式。

·时间可以只有日期如2021、2021/04、2021/04/31,不能只有后半部分如13:00:00,否则将返回乱码。

·单元格不能合并,否则只能取得合并单元格的第一行数据,其他行将为空值。

·若表格中有计算公式,请先在腾讯文档将单元格粘贴为数值,否则会直接返回空值而不是计算结果。

·将包含隐藏和过滤的单元格。

·若数值型字段中存在非数值型的单元格数据,将转为空值处理。

8. 单击下一步后,我们将进行字段的配置。这里的参数说明如下:

·显示名称:指数据表在 BI 上显示的名称。

·所属文件夹:数据表所属的文件夹。

·字段中文名:字段在 BI 上展示的名称,默认为文档的首行内容。

·当选择“时间”、“地理”时,可二级选择不同粒度的格式。

·空值展示:数据表存在空值的“null”和空字符 “ ”这两种空值,可以通过对展示样式进行配置。

·备注:可用于记录该字段的释义 ,在配置报表的表格组件时,可作为表头的释义

·操作:可进行字典表关联操作,当选择关联字典时,可选择需要关联的字典表进行映射。

9. 单击确认后,则建表成功,此时接入的腾讯文档可用于报表的配置。


二、自动更新腾讯文档

当你接入腾讯文档后,BI 将按一定时间周期自动更新文档数据,以及时同步你在腾讯文档上做的修改(具体更新频率在控制台上 hover 自动更新标签查看)。 

适用的场景有:

·当你在使用报表进行汇报前,发现数据有误,此时可以直接使用手机腾讯文档进行修改,修改后,使用 BI 制作的报表将自动进行变更

·当你的数据产生了增加,需要在腾讯文档中新增几行数据。新增后,使用 BI 制作的报表也会自动进行变更

当出现以下情况时,自动更新将暂停:

·当你接入的腾讯文档结构发生变化(例如新增列或者减少列),则自动更新将暂停

·当你接入的腾讯文档被删除,或者你不具备该文档的查看权限,则自动更新将暂停

三、手动更新腾讯文档

若你对已建好的腾讯文档,有跨文档或者新增/删除列的数据更新等需求,可在列表页通过“更新”操作手动进行更新。


更新方式分为“追加”和“替换”两种。


追加指在原有数据上进行新增,需保证追加表的“列标题”与被追加表的“字段显示名”完全一致。例如原先数据有50行,新的文档有60行数据,则追加后共有50+60=110行数据。如果你需要新增的数据在另一个在线 Excel 中,建议选择“追加”模式。如果在同一个在线 Excel,建议选择“替换”模式,避免产生重复数据。

替换指将完全替换原有数据!替换表无需与原表结构一致,可用于增加或删除列等场景,例如原来的数据有5列,需要新增1列到6列,此时可以将6列的文档用替换方式进行更新。若数据表已进行报表配置,不建议删除列,避免被删除的列已用于报表配置导致报表报错。

四、腾讯文档时间格式

由于腾讯文档的时间格式多种多样,不同格式的时间接入到 BI 会有不同的处理逻辑,此章节对此进行说明。
首先建议对于时间、日期的列,提前在文档中如下所示,设置恰当的时间日期格式。提前设置好接入到 BI 时,BI 便能读取设置的格式,方便后续配置。


若你未在文档中设置时间日期格式,则 BI 将根据内容自动推断。若部分内容识别为数值或字符,建议手动更改为对应格式,例如2022是年份,但是 BI 会识别为数值,请手动更改为“时间-YYYY 格式”。受文档能力限制若你的时间为 YYYY/MM/DD HH:MM:SS,且未在文档设置时间日期格式,在 BI 上接入预览时会乱码,此时手动更改为“时间 YYYY-MM-DD HH:MM:SS”,保存后再查看则不会乱码可正常使用。

赞 (0)
上一篇 4天前
下一篇 4天前