運算子和不合法報錯- FineBI帮助文档 FineBI帮助文档

1. 作用

函式計算格式已經說明在 FineBI 中使用函式的計算組成以及基礎的計算文法，但有時使用者也會遇到書寫公式報錯的問題，可根據提示完成公式的正確書寫。

本文將詳細介紹運算子和表式的文法，幫助使用者瞭解 FineBI 的公式校驗方案，正確有效的寫出需要的函式。

2. 運算子文法

2.1 +

概念	運算子在應用於數字時表示相加，在應用於字串時表示串聯。
支援組合型別	除日期欄位日期欄位之外，支援其他任意型別組合
傳回結果型別	參數中存在正文欄位，結果為正文欄位日期數值則為日期欄位如果全是數值則為數值欄位

概念

運算子在應用於數字時表示相加，在應用於字串時表示串聯。

支援組合型別

除日期欄位日期欄位之外，支援其他任意型別組合

傳回結果型別

參數中存在正文欄位，結果為正文欄位

日期數值則為日期欄位

如果全是數值則為數值欄位

不合法提示：「不支援日期+日期操作」，如下圖所示：

日期+日期.jpg

2.2 -

概念	- 運算子在應用於數字時表示相減，在應用於表式時表示求反。
支援組合型別	兩個數值型別或者兩個日期型別欄位注：不支援數值欄位-日期欄位。
傳回結果型別	日期型別-日期型別傳回結果為時間戳日期型別-數值型別傳回結果為日期型別其餘傳回結果為數值型別

概念

- 運算子在應用於數字時表示相減，在應用於表式時表示求反。

支援組合型別

兩個數值型別或者兩個日期型別欄位

注：不支援數值欄位-日期欄位。

傳回結果型別

日期型別-日期型別傳回結果為時間戳

日期型別-數值型別傳回結果為日期型別

其餘傳回結果為數值型別

不合法提示：

「不支援數值-日期操作」，如下圖所示：

2數值-日期.jpg

其他非法的減法：「文字不能作為減數或被減數」，如下圖所示：

4文字不能作為減數正確顯示.jpg 2.3 /

概念	/ 運算子表示數值相除
支援組合型別	兩個數值型別參數
傳回結果型別	數值型別

不合法提示：「/:操作符兩端必須為數值型別」，如下圖所示：

5操作符兩端必須為數值正確顯示.jpg

2.4 *，%，^

概念	* 運算子表示數值相乘 % 運算子傳回除法運算的餘數 ^ 乘方計算數位的指定次冪
支援組合型別	兩個數值型別參數
傳回結果型別	數值型別

概念

* 運算子表示數值相乘

% 運算子傳回除法運算的餘數

^ 乘方計算數位的指定次冪

支援組合型別

兩個數值型別參數

傳回結果型別

數值型別

不合法提示：「*:操作符兩端必須為數值型別」，如下圖所示：

6乘號兩端.jpg 2.5 >,<,<=,>= (比較)

概念	>（大於） <（小於） >=（大於或等於） <=（小於或等於）
支援組合型別	兩個相同型別參數
傳回結果型別	布林型別

概念

>（大於）

<（小於）

>=（大於或等於）

<=（小於或等於）

支援組合型別

兩個相同型別參數

傳回結果型別

布林型別

不合法提示：「>=:操作符兩端欄位型別必須相同」，如下圖所示：

7大於等於號.jpg

2.6 =,!=,== (比較)

概念	== 或 =（等於） != （不等於）
支援組合型別	兩個相同型別參數或者參數中有 null
傳回結果型別	布林型別

概念

== 或 =（等於）

!= （不等於）

支援組合型別

兩個相同型別參數

或者參數中有 null

傳回結果型別

布林型別

不合法提示：「!=:操作符兩端欄位型別必須相同」，如下圖所示：

!= 操作符兩端類型不一致显示正确.jpg

3. 表式文法

FineBI 的函式表式寫法參見：表式文法

當使用者使用以下書寫方式時，會出現報錯提示。

3.1 運算子表式不完整

例如使用者書寫如下的表式：ABS(合同金額)+ ，則會報錯「語法錯誤，缺少標示符」：

3缺少標識符.jpg

3.2 字元錯誤

例如需要新增一欄，該列全部指派為 1，此時輸入 "1，由於缺少一半英文雙引號，會出現如下報錯「字元錯誤」：

8字元錯誤.jpg 3.3 文法錯誤

即其他的文法錯誤。

4. 具體函式型別不合法提示

4.1 正文函式

函式	結果型別	不合法提示
LEN	數值	LEN不符合 (任意型別) 的參數要求
CHAR	正文	CHAR不符合 (數值) 的參數要求
CODE	數值	CODE不符合 (正文) 的參數要求
REPLACE	正文	REPLACE不符合 (任意型別,任意型別,任意型別) 或 (任意型別,數值,數值,任意型別) 的參數要求
STARTWITH	bool	STARTWITH不符合 (任意型別,任意型別) 的參數要求
ENDWITH	bool	ENDWITH不符合 (任意型別,任意型別) 的參數要求
EXACT	bool	EXACT不符合 (任意型別,任意型別) 的參數要求
INDEXOF	正文	INDEXOF不符合 (任意型別,數值) 的參數要求
REPEAT	正文	REPEAT不符合 (任意型別,數值) 的參數要求
LEFT	正文	LEFT不符合(任意型別) 或 (任意型別,數值) 的參數要求
RIGHT	正文	RIGHT不符合(任意型別) 或 (任意型別,數值) 的參數要求
TODOUBLE	數值	TODOUBLE不符合 (任意型別) 的參數要求
TOINTEGER	數值	TOINTEGER不符合 (任意型別) 的參數要求
LOWER	正文	LOWER不符合 (正文) 的參數要求
TRIM	正文	TRIM不符合 (正文) 的參數要求
UPPER	正文	UPPER不符合 (正文) 的參數要求
CONCATENATE	正文	CONCATENATE:不符合(任意型別...)的參數要求
MID	正文	MID不符合 (任意型別,數值,數值) 的參數要求
REGEXP	BOOL	實時資料：REGEXP不符合 (正文,正文) 的參數要求抽取資料：REGEXP:不符合(正文,正文) 或 (正文,正文,數值) 的參數要求
FORMAT	正文	實時資料：FORMAT不符合 (日期,正文) 的參數要求抽取資料：FORMAT不符合 (任意型別,正文) 的參數要求
FIND	數值	FIND不符合 (任意型別,任意型別) 或 (任意型別,任意型別,數值) 的參數要求
NUMTO	正文	NUMTO不符合 (數值)或(數值,布爾)的參數要求
PROPER	正文	PROPER:不符合(正文)的參數要求
SPLIT	正文	SPLIT不符合(任意類型,任意型別)的參數要求
SUBSTITUTE	正文	SUNSTITUTE不符合(任意型別,任意型別,任意型別,[數值])的參數要求

4.2 日期函式

函式	結果型別	不合法提示
DATE	日期	DATE不符合(數值,數值,數值)的參數要求
DATEDELTA	日期	不符合(日期/正文,數值)的參數要求
MONTHDELTA	時間
YEARDELTA	日期
DATEDIF	數值	DATEDIF不符合(日期/正文,日期/正文,正文)的參數要求
DATESUBDATE	數值	DATESUBDATE不符合(日期/正文,日期/正文,正文)的參數要求
DATETONUMBER	數值	DATETONUMBER不符合(日期/正文)的參數要求
DAYVALUE	數值	DAYVALUE不符合(日期/正文)的參數要求
DAYSOFMONTH	數值	不符合(日期/正文)的參數要求
DAYSOFQUARTER	數值	不符合(日期/正文)的參數要求
DAYSOFYEAR	數值	實時資料：不符合(日期/正文)的參數要求抽取資料：不符合(任意型別...)的參數要求
YEAR	數值	#函式名#不符合() 或 (日期/正文)的參數要求
WEEK	數值
DAY	數值
HOUR	數值
MINUTE	數值
MONTH	數值
SECOND	數值
TIME	時間	實時資料：TIME:不符合(數值,數值,數值)的參數要求抽取資料：TIME不符合(數值/正文,數值/正文,數值/正文)的參數要求
TODATE	時間	實時資料：TODATE不符合(任意型別) 或 (正文,正文)的參數要求抽取資料：TODATE:不符合(數值/日期/正文) 或 (正文,正文)或(正文,正文,正文)的參數要求
NOW	時間	NOW不符合()的參數要求
TODAY	時間	TODAY不符合()的參數要求
WEEKDATE	時間	WEEKDATE不符合(數值,數值,數值,數值)的參數要求
WEEKDAY	數值	WEEKDAY不符合(日期/正文)的參數要求
DAYS360	數值	DAYS360:不符合(日期/正文,日期/正文,正文/數值)的參數要求注：實時資料不支援該函式。
LUNAR	正文	LUNAR不符合(數值/正文,數值/正文,數值/正文) 的參數要求注：實時資料不支援該函式。

4.3 數學和三角函式

函式 / 公式名	傳回型別	公式不合法提示
PI	數值	PI不符合(數值)或()的參數要求
INT	數值	實時資料：不符合(數值)的參數要求抽取資料：不符合(正文/數值)的參數要求
CEILING	數值	#函式名#不符合(數值)的參數要求
CEILING
Floor
SQRT
LN
SQRT
ABS
ACOS
ASIN
ATAN
LOG10
SIN
TAN
COS
EXP
DEGREES
SIGN
RADIANS
RAND	數值	RAND不符合()的參數要求
MIN	任意型別	實時資料：不符合所有參數為相同型別的要求抽取資料：不符合(數值...)的參數要求
MAX	任意型別	實時資料：不符合所有參數為相同型別的要求抽取資料：不符合(數值...)的參數要求
RANDBETWEEN	數值	#函式名#不符合(數值,數值)的參數要求
MOD
POWER
ROUND
ATAN2
PROMOTION
LOG	數值	#函式名#不符合(數值,數值)或(數值)的參數要求
TRUNC	數值	#函式名#不符合(數值,數值)或(數值)的參數要求

4.4 邏輯函式

函式	結果型別	不合法提示
AND	bool	AND的參數型別必須為布林型別或數值型別
OR	bool	OR的參數型別必須為布林型別為bool型別或數值型別
IF	第一個為 bool 型別或數值型別（0或者1），第二個和第三個參數相同型別，兩個參數中有空，傳回非空參數型別；兩個參數型別不同：傳回正文型別。	IF:表式的第一個參數不符合布林型別或數值型別" IF:不符合(布爾/數值,參數,參數)的參數要求注：實時資料中表式的結果型別必須相同。
SWITCH	傳回結果參數中第一個非空的參數型別(switch函式，第2n 1個參數是傳回參數n>0)	抽取資料：SWITCH:的參數至少3個實時資料：SWITCH:表式的結果型別必須相同 SWITCH:的參數至少3個
\|\|、	bool	#符號#只能連結兩個布林型別或數值型別的表式

4.5 其他函式

函式	結果型別	不合法提示
ISNULL	bool	實時資料：ISNULL不符合(任意型別)的參數要求抽取資料：ISNULL:不符合(任意型別...) 的參數要求
NVL	排除空(null) ，如果其他傳回結果參數的型別相同，則傳回結果參數中第一個非空且非空字串的參數型別(NVL函式，所有參數都是傳回參數)	NVL不符合所有參數為相同型別的要求

函式

結果型別

不合法提示

ISNULL

bool

實時資料：ISNULL不符合(任意型別)的參數要求

抽取資料：ISNULL:不符合(任意型別...) 的參數要求

NVL

排除空(null) ，如果其他傳回結果參數的型別相同，則傳回結果參數中第一個非空且非空字串的參數型別(NVL函式，所有參數都是傳回參數)

NVL不符合所有參數為相同型別的要求

4.6 聚合函式

函式 / 公式名	結果型別	不合法提示
SUM_AGG	數值	#函式名#不符合 (數值) 的參數要求
AVG_AGG
VAR_AGG
MEDIAN_AGG
STDEV_AGG
PERCENTILE_AGG 注：僅實時資料支援。	數值	PERCENTILE_AGG不符合 (數值,數值) 的參數要求 PERCENTILE_AGG第二個常數數值型別參數必須在0到1之間
MAX_AGG	同參數型別	#函式名#不符合 (任意型別) 的參數要求
MIN_AGG	同參數型別	#函式名#不符合 (任意型別) 的參數要求
APPROX_COUNT_AGG 注：僅實時資料支援。	數值	#函式名#不符合 (任意型別) 的參數要求
COUNT_AGG
COUNTD_AGG

聚合函式組合場景下的不合法報錯：

錯誤代碼	含義	舉例	不合法提示
61500002	明細過濾後的指標不符合聚合函式	ABS(欄位)，欄位進行了明細過濾	#函式名#明細過濾後的指標僅支援聚合函式
61500003	無法將聚合參數和非聚合參數混合使用	SUM_AGG(欄位1) 欄位2	無法將聚合參數和非聚合參數混合使用
61500004	聚合函式不能巢聚合函式	SUM_AGG(SUM_AGG(欄位)))	#函式名#聚合函式不能巢聚合函式

4.7 快速計算函式

函式	結果型別	不合法提示
SAME_PERIOD	數值	SAME_PERIOD不符合(數值) 或 (數值,正文) 的參數要求 SAME_PERIOD第二個常數正文型別參數必須為"Y","M","W"(不區分大小寫)
ACC_SUM		ACC_SUM不符合(數值) 或 (數值,數值) 的參數要求 ACC_SUM第二個常數數值型別參數必須為0,1
PREVIOUS_PERIOD		PREVIOUS_PERIOD不符合(數值) 的參數要求
PERIOD_ANLS		PERIOD_ANLS不符合(數值) 或 (數值,正文) 的參數要求 PERIOD_ANLS第二個常數正文型別參數必須為Y","M","W"(不區分大小寫)
PERIOD_TD		PERIOD_TD不符合(數值) 或 (數值,正文) 的參數要求 PERIOD_TD第二個常數正文型別參數必須為Y","M","W"(不區分大小寫)
RANK_ANLS		RANK_ANLS不符合(數值) 或 (數值,數值) 或 (數值,正文) 或 (數值,數值,正文)的參數要求 RANK_ANLS第二個常數數值型別參數必須為0,1 RANK_ANLS第三個常數正文型別參數必須為"asc","desc"(不區分大小寫)
TOTAL		TOTAL不符合(數值) 或 (數值,數值) 或 (數值,正文) 或 (數值,數值,正文)的參數要求 TOTAL第二個數值型別參數必須為0,1 TOTAL第三個常數正文型別參數必須為"sum","avg","min","max"(不區分大小寫)

通用報錯提示：

含義	舉例	不合法提示
參數中包含非聚合函式或者常數，或者第一個參數不是聚合函式	TOTAL(合同金額)(「合同金額」為欄位)	#函式名#中參數只有是聚合函式或者常數,且第一個參數必須為聚合函式

4.8 控制計算粒度函式

函式	結果型別	不合法提示
FIXED	數值	#函式名#必須包含參數 #函式名#維度不能為聚合函式 #函式名#最後一個參數必須是聚合函式
INCLUDE
EXCLUDE

函式

結果型別

不合法提示

FIXED

數值

#函式名#必須包含參數

#函式名#維度不能為聚合函式

#函式名#最後一個參數必須是聚合函式

INCLUDE

EXCLUDE

已经是第一篇

已经是最后一篇

有帮助
没帮助
只是浏览
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

運算子和不合法報錯

1. 作用

2. 運算子文法

2.1 +

2.2 -

2.4 *，%，^

2.6 =,!=,== (比較)

3. 表式文法

3.1 運算子表式不完整

3.2 字元錯誤

4. 具體函式型別不合法提示

4.1 正文函式

4.2 日期函式

4.3 數學和三角函式

4.4 邏輯函式

4.5 其他函式

4.6 聚合函式

4.7 快速計算函式

4.8 控制計算粒度函式

附件列表