官方文档

字段配置

数据集字段大纲右侧齿轮菜单:字段类型、展示格式、聚合、日期粒度、空值与排序,以及各功能适用的字段类型。

字段大纲里,每个字段右侧有一个齿轮。点开后是该字段的配置菜单。菜单项是否出现、点进去有哪些选项,取决于字段是维度还是度量,以及字段类型。改完后请保存数据集,仪表板、数据大屏、复杂报表才会按新配置取数。

产品入口:菜单 数据中心 → 数据集,打开数据集后进入数据处理,左侧为字段大纲。数据预览表头上的齿轮,打开的是同一套菜单。

建模步骤见 新建数据集。

1. 先看字段类型标记

字段名前的色标表示当前类型,不是按字段名猜的。名字叫 create_time,标记仍是 Str 时,它是文本,不会出现日期格式。维度用蓝色标记,度量用绿色标记。

标记类型说明
Str文本普通字符串。不会出现日期格式
Dt日期、日期时间日期只到日;日期时间含时分秒
No整数、小数只有度量上的整数、小数才能设数值格式
Geo地理才出现「地理数据匹配」
Img图片URL 链接或文件上传
T/F布尔
{}JSON

2. 菜单项对哪些字段有效

下表只说明会不会出现。出现之后的选项差异,写在后面各节。维度上的整数、小数没有数值展示格式。日期度量有日期展示格式,没有数值展示格式。粒度字段(年、季、月、周、日、时)固定为维度。

菜单文本日期 / 日期时间整数或小数度量地理粒度字段其他类型
字段信息编辑是是是是是是
字段类型切换是是是是是是
默认聚合方式仅度量仅度量仅度量仅度量否仅度量
日期展示格式否是否否是,且只有本粒度否
数值展示格式否否是否否否
空值展示样式是是是是是是
排序是是是是是是
新建是是是是是是
复制字段 / 复制物理字段名 / 编辑字段描述是是是是是是
转换为聚合 / 非聚合否否仅度量上的计算字段否否仅度量上的计算字段
同步日期粒度否是(原始日期字段)否否否否
地理数据匹配否否否是否否
隐藏字段 / 移动到 / 删除是是是是是是

3. 字段信息编辑

所有字段都可以改。

项能否改说明
字段显示名能大纲、预览表头、下游图表里看到的名字。最长 150 字。不改变物理列名
物理字段名不能只展示,对应数据表里的列
字段描述能选「文本」写说明,或选「链接」填地址

计算字段点这一项时,打开的是计算字段编辑器,而不是上面这个简表。

4. 字段类型切换

所有字段都可以切换。切换的是数据集里的类型,不会改数据库里的列类型。

留在维度:

选项结果
文本文本维度
日期日期维度。之后才能设日期展示格式、同步日期粒度
地理地理维度。之后才出现「地理数据匹配」
数字整数维度。仍是维度,不会出现数值展示格式
图片(URL链接)按链接显示图片
图片(文件上传)按上传文件显示图片

转为度量:

选项结果
数字整数度量。这时才有「数值展示格式」和「默认聚合方式」
文本文本度量。没有数值展示格式

从日期或日期时间改成非日期时,该字段下的年、季、月、周、日、时会一并删除,并提示已清除日期粒度。日期时间改成日期时,只去掉「时」。

文本列里如果存的是 2020-01-06 08:00:00 这种值,必须先切成日期,日期格式才会出现。只改显示名不够。

5. 默认聚合方式

只在度量上出现。维度,以及由日期同步出来的粒度字段,都没有这一项。拖到仪表板度量槽时,默认用这里选的聚合。图表里如果又改了聚合,以图表上的设置为准。

选项含义
求和数值相加。未单独选过时按求和
平均值平均值
计数行数
计数(去重)不重复值的个数
最大值 / 最小值
总体标准差 / 总体方差 / 样本方差

6. 展示格式设置

展示格式决定字段在数据预览,以及保存后在仪表板、数据大屏、复杂报表里怎么显示。它跟字段是维度还是度量无关,跟类型有关。

6.1 日期展示格式

字段能选的格式
日期(没有粒度)日格式,见下表
日期时间(没有粒度)日格式,再加三档时分秒
年 / 季 / 月 / 周 / 日 / 时只有该粒度自己的一套,不会混进别的粒度

原始日期字段上不会出现周、月、年那些格式。要按周、按月展示,先做「同步日期粒度」,再在对应粒度字段上设格式。菜单里写的是格式本身,例如 YYYY-MM-DD,不是某一天的样例。

日期

菜单2020-01-06 的效果
自动保持取出的原始值,不改写
YYYY-MM-DD2020-01-06
YYYYMMDD20200106
YYYY/MM/DD2020/01/06
YYYY年M月D日2020年1月6日
中文年月日二〇二〇年一月六日
MMDD0106
MM-DD01-06
MM/DD01/06
M月D日1月6日
DDMMYYYY06012020
MM/DD/YYYY01/06/2020

日期时间额外三项。字段类型必须是日期时间。只在齿轮里切成「日期」时没有这三项,可在「字段详情」把类型改为日期时间。

菜单效果示例
YYYY-MM-DD HH:mm:ss2020-01-06 14:30:00
YYYY/MM/DD HH:mm:ss2020/01/06 14:30:00
YYYY-MM-DD HH:mm2020-01-06 14:30

粒度字段

粒度可选格式默认
日与上表「日期」相同YYYY-MM-DD
时YYYY-MM-DD HH、YYYY/MM/DD HH、YYYY年M月D日 H时YYYY-MM-DD HH
周YYYY-WW周、YYYYMMDD~YYYYMMDD、YYYY/MM/DD~YYYY/MM/DD、YYYY-WW周(MMDD~MMDD)、中文周、MM/DD~MM/DD、MMDD~MMDDYYYY-WW周
月YYYY-MM、YYYYMM、YYYY/MM、YYYY年M月、中文年月、M月YYYY-MM
季YYYY-Q季度、YYYYQ、YYYY年第Q季度、中文季度YYYY-Q季度
年YYYY、YYYY年、中文年YYYY

周按 ISO 周,周一为一周的开始。2020-01-06 用 YYYY-WW周 得到 2020-02周,周范围是 20200106~20200112。没有财年格式。

原始日期字段设了具体格式之后,仪表板分组会按格式化之后的文案合并。同一天的 08:00 和 18:30,格式为 YYYY-MM-DD 时合成一行 2020-01-06,度量仍按字段上的聚合方式相加或计数。选「自动」则不合并、不改写。

粒度字段先按粒度分组(周就是一周一行),再套展示格式。同一周只换格式,行数不变。

保存数据集后,分组表才会变成新格式。只在数据集里改、不保存,仪表板仍是原来的值。

6.2 数值展示格式

仅整数或小数,且角色为度量。维度上的数字、文本度量、日期度量都没有这一项。图表度量槽上如果另外设了数值格式,以图表上的为准。

菜单含义
自动不套数值格式
整数四舍五入为整数,带千分位
小数(1位) / 小数(2位)保留相应小数,带千分位
百分比 / 百分比(1位) / 百分比(2位)先乘 100 再加 %
自定义只接受 #,##0.00 这种写法。百分比在前面加 %,例如 %#,##0.00

6.3 空值展示样式

所有字段都有。维度可以分别设置空值(NULL)和空字符串。度量只有空值,没有空字符串。

  • 维度 · 空值:不设置、-、{空}、null、自定义。
  • 维度 · 空字符串:不设置、-、{空字符}、null、自定义。
  • 度量 · 空值:不设置、-、null、不展示、自定义。

自定义只能是中文、英文、数字,以及 _ / \ | ( ) [ ],最长 150 字。@ 这类符号不能保存。

{空}、{空字符}、不展示,画面上都是空白,只是适用的值不同:空值管 NULL,空字符串管空文本。

7. 排序

所有字段都可以设默认排序。图表槽位上如果又排了序,以图表为准。

选项行为
不排序不附加顺序
升序 / 降序按字段值
自定义打开「字段排序」,一行一个值,从上到下就是展示顺序,例如先「高」再「中」再「低」

8. 新建

从当前字段的菜单打开,不要求当前字段是某种类型。

子项作用适用
新建计算字段用表达式生成新字段。可指定名称、类型(文本、整数、小数、日期、日期时间、布尔或自动推断)和描述。维度、度量分组标题旁的 + 也是这个入口新字段自行选择做维度或度量
新建分组维度按条件把一个维度划成几组,例如年龄划成年龄段。未命中的值进「其他」基于已有维度
新建层级结构多个维度从粗到细组成钻取层级,例如国家 → 省 → 市。日期粒度字段不会被收进层级只能选维度

9. 复制、描述、隐藏、移动、删除

菜单适用行为
复制字段全部复制一份,名称后加 _copy,显示名后加「副本」。新字段需保存后才有正式编号
复制物理字段名全部把物理列名复制到剪贴板,方便写 SQL 或对字段
编辑字段描述全部与「字段信息编辑」里的描述相同,可写文本或链接
转换为聚合 / 转换为非聚合仅度量上的计算字段表达式里已经写了 SUM、AVG、COUNT 等聚合函数时,菜单是「转换为非聚合」,否则是「转换为聚合」。公式本身仍在计算字段编辑器里改
隐藏字段 / 取消隐藏全部隐藏后,大纲在勾选「不展示隐藏字段」时不再列出;预览也可不再显示该列。隐藏不是删除
移动到全部移入已有文件夹或层级。还没有文件夹、层级时,子菜单为「暂无文件夹或层级结构」。维度和度量互转请用「字段类型切换」
删除全部从数据集字段列表移除,不删数据库的列。被计算字段引用时不能删。删除日期源字段时,其下年、季、月、周、日、时一并删除

10. 同步日期粒度

只出现在原始的日期、日期时间字段上。文本不行。已经生成出来的「年」「周」等粒度字段上不再出现这一项。作用是在源字段下面补齐粒度维度,不在物理表里加列。

源字段类型生成的粒度
日期年、季、月、周、日
日期时间年、季、月、周、日、时

显示名默认为「源字段显示名(年)」这种形式,例如 创建时间(周)。物理列与源字段相同。粒度字段一律是维度,挂在源字段下面;源字段仍留在原来的维度或度量分组里。

  • 再点一次只补缺的粒度,不会生成重复字段。
  • 已经改过的显示名和展示格式会保留。
  • 字段还没保存、没有编号时,会提示先保存数据集再同步。
  • 每个粒度字段带好该粒度的默认展示格式(周默认 YYYY-WW周,月默认 YYYY-MM)。
  • 删除源字段,或把源字段改成非日期,粒度字段会一起去掉。

在仪表板里请把粒度字段拖进维度(例如 创建时间(周))。原始日期字段只有日格式和时分秒格式。

11. 地理数据匹配

只在类型为地理的字段上出现。文本、日期、数字都没有。用于把地理字段对应到国家、省、市、区,供地图使用。先用「字段类型切换 → 地理」。

12. 常见问题

齿轮里只有「空值展示样式」,没有日期格式。
看字段标记。是 Str 就是文本。打开「字段类型切换」,改成「日期」。标记变成 Dt 后,再进「展示格式设置」就能看到「日期展示格式」,并出现「同步日期粒度」。

为什么格式写的是 YYYY-MM-DD,不是 2020-01-06?
菜单显示的是格式,不是某一天的样例。预览和仪表板里才会变成具体日期。

数据集里改了日期格式,分组表还是原来的时间。
先保存数据集。分组表读取的是已保存的字段配置。原始日期字段在选择了具体格式后,会按格式化结果分组合并;选「自动」则仍是原始值。

想按周汇总,在 create_time 里找不到周格式。
在日期字段上点「同步日期粒度」,再打开 create_time(周) 设置 YYYY-WW周 等周格式,把这个粒度字段用到图表维度上。

数字维度为什么不能设小数、百分比?
数值展示格式只给整数、小数度量。请用「字段类型切换 → 转换为度量 → 数字」。

空字符串选项在度量上看不到。
度量只设置空值(NULL)。空字符串样式只给维度,包含日期维度和粒度字段。