🐬Spotfire 腳本錯誤完整解析：為什麼 Embedded DataTable 不能 Reload？
前言：為什麼 Spotfire 腳本常常「看起來沒錯，卻一直報錯？」
很多剛接觸 TIBCO Spotfire 的使用者，會以為它只是「拉拉圖表、連資料庫」的工具。但當你開始使用 IronPython 腳本，想要做到「下拉選單一改就重新查資料」、「自動依條件刷新報表」時，就會第一次遇到一些非常工程師導向、卻又不直覺的錯誤。
本文會用完全不需要程式背景的方式，解釋一個 Spotfire 中非常常見、也非常容易卡關的錯誤：
👉 為什麼某些資料表 不能 被腳本重新載入？
問題現象：畫面跳出一大串紅字，看不懂在說什麼
當你在 Spotfire 中：
點了下拉選單
觸發 Property Changed Script
腳本試圖重新載入資料
畫面卻跳出錯誤視窗，大意通常是：
無法執行腳本，因為資料表是儲存在分析檔中的（embedded）。
雖然錯誤訊息很長，但真正重要的只有一句話。
關鍵名詞白話解釋：什麼是 Embedded DataTable？
在 Spotfire 裡，資料表有兩種常見型態：
1️⃣ Embedded（嵌入式資料表）
你可以把它想成：
「資料已經被 存死 在報表檔裡了」
特點是：
開檔不需要連資料庫
就算離線也看得到資料
-
不能重新查詢、不能被腳本 Reload
這種模式很適合「只看結果、不需要即時更新」的報表。
2️⃣ Linked / Connected（連線式資料表）
這種資料表比較像：
「每次需要時，都去資料庫問一次」
特點是：
可以設定 SQL 條件
可以吃參數（例如下拉選單）
可以被腳本控制重新載入
如果你想要「互動式、動態更新」的報表，一定要用這種模式。
為什麼工程師常常會踩到這個雷？
因為 Spotfire 很貼心（但也很危險）：
你一開始可能是「連資料庫匯入資料」
存檔時，不小心選了「把資料一起存進分析檔」
從此這張表就變成 Embedded
但畫面上：
表格還在
圖表也正常顯示
只有在你用腳本動它時，才會爆炸 💥
從工程師角度看：Spotfire 為什麼要禁止這件事？
原因其實很合理：
Embedded DataTable 本來就「沒有資料來源可以重新查」
就像你把 Excel 存成 PDF：
你可以看
但你不能叫它「重新算一次」
Spotfire 只是很嚴格地保護資料一致性。
正確的解決思路（不用寫程式也能理解）
✅ 解法一：把資料表改成「連線式」
如果你的需求是：
下拉選單改了
資料就要跟著更新
那你就應該：
打開 Spotfire
進入資料表設定
將資料來源改成「資料庫連線」或「Information Link」
不要勾選「將資料嵌入分析檔」
這是最乾淨、最推薦的作法。
✅ 解法二：讓腳本「知道哪些資料不能動」
如果同一份報表裡：
有些資料表是連線的
有些是嵌入的
工程師通常會在腳本中：
先判斷資料表型態
只對「可以更新的資料表」動手
其他直接略過
這樣整份分析檔就不會因為一張表而全掛。
常見誤會整理（新手必看）
❌「只要是 SQL 來的資料，都能 Reload」
👉 不一定，重點是有沒有被嵌入
❌「錯誤說 Cannot execute script，一定是腳本寫錯」
👉 很多時候是資料表型態不對
❌「改一點 SQL 就能解決」
👉 這個錯誤跟 SQL 幾乎沒關係
結語：這不是 Bug，而是設計選擇
這類錯誤對初學者來說非常挫折，因為：
錯誤訊息很長
但真正原因很單純
站在軟體工程的角度來看，Spotfire 只是明確地告訴你：
「你現在用的是靜態資料，但你卻想把它當成動態資料來用。」
一旦理解 Embedded vs Connected DataTable 的差別，
這類錯誤幾乎可以一次解完，不再反覆踩雷。
留言
張貼留言