← 返回博客

DataFocus · 博客

將 CSV、Excel 和 JSON 檔案匯入 OT Flash

從桌面上的一份表格到繫結本體、可搜尋的 OT Flash 資料表,只用資料表管理、本體管理和資料搜尋三個介面,一步步走完。

要把 CSV 或 Excel 檔案匯入 OT Flash,先開啟 Tables(資料表管理),點選 Import Table,選擇 “Import table from local”,選定檔案格式(CSV、EXCEL 或 JSON)並上傳檔案,設定解析選項,確認列名和型別,最後點選 Submit。新資料表會出現在資料表列表的最前面。若要讓它成為某個本體的一部分,開啟該本體的 Data Tables 模組,使用 Import data table;之後就可以在資料搜尋(Data Search)中輸入 “Sales by Region” 這樣的關鍵詞進行搜尋。你的角色需要能看到 Tables 選單,這由管理員分配。

下面的步驟依據 OT Flash r57 使用者手冊(英文),手冊自帶的示例匯入的是名為 Manual_Sample_Store_Monthly_Sales.csv 的檔案。本文使用的樣例是一個結構相同的小型假設檔案,不是真實公司的資料。

四種匯入方式該選哪一種?

點選 Import Table 後,OT Flash 提供四種方式。選哪一種,取決於資料現在放在哪裡。

方式適用場景通常由誰負責
Import table from local資料是你電腦上的 CSV、Excel 或 JSON 檔案分析師
Import table from external data source資料在已連線的資料庫裡資料維護人員或管理員
Import from API資料可以通過 API 獲取資料維護人員
HTTP source資料通過 HTTP 送達資料維護人員

本地檔案是唯一不需要事先配置任何東西的路徑。其餘三種依賴別人已經配置好的連線;對於外部資料庫,手冊建議使用專用的只讀賬號,並且只授予需要分析的那些表的訪問許可權。本文講本地檔案這條路徑,結尾再回到其他幾種。

如何準備檔案,才能讓各列順利匯入?

大多數匯入問題在你點選任何按鈕之前就已經決定了。下面是一份簡短的檢查清單:

  1. 把列名放在第一行。 解析介面會問 “Are the column names already defined in the file header?”,第一行是列名時就勾選。有表頭行,之後搜尋時的列名也更易讀。
  2. 一個檔案或一個工作表只放一張表。 一個檔案匯入後是一張資料表。如果工作簿裡有多個標籤頁,請把每一個單獨匯出或另存。
  3. 每一列只放一種值。 一列裡數字和 “n/a” 之類的文本混在一起,很難被識別為數值型別。要麼在檔案裡清理,要麼在型別步驟裡決定如何處理。
  4. 刪除彙總行和空行。 底部的合計行會在搜尋時被再次求和。解析器可以忽略空行和有錯誤的行,但合計行是有效資料,不會被跳過。
  5. 使用人們會輸入的列名。 搜尋按列名匹配,所以 “Sales” 比 “Net_Sales_Amt_USD_v2” 好。之後可以改名,但改得越少,意外越少。
  6. 不要超過大小限制。 手冊規定檔案必須小於 50 MB。
  7. 避免與搜尋關鍵詞重名。 如果列名與某個搜尋關鍵詞相同,系統在匯入時會在後面追加序號(如 _1)來重新命名。之後可以在資料表詳情裡設定顯示名。

下面是一個示意檔案(假設資料,未在產品中實際執行),列與手冊樣例相同,共五列:

Store,City,Month,Orders,Sales
Harbor,Rotterdam,2026-01,420,18350.50
Harbor,Rotterdam,2026-02,398,17020.00
Ridge,Denver,2026-01,512,24110.75
Ridge,Denver,2026-02,487,22980.25

如何匯入檔案並檢查資料表?

  1. 在左側選單中開啟 Tables,然後點選 Import Table。
  2. 選擇 Import table from local,彈出 Import locale table 對話方塊。
  3. 選擇檔案格式:CSV、EXCEL 或 JSON。點選 Please Select File,選好檔案,再點選 Upload。
  4. 設定解析選項。選擇分隔符(CSV 通常是 COMMA),確認表頭行復選框,並決定是否忽略空行、忽略錯誤資料,以及是否丟棄最後一列之後的資料。Show/Hide Advanced Parsing Options 可以展開更多選項。點選 Next。
  5. 在列設定介面,檢查資料表名稱,需要的話新增描述,選擇要匯入的列,並調整列名和資料型別,例如 string、int 或 double。右側會顯示樣例值,Preview 可以預覽匯入後的資料。
  6. 點選 Submit。

你看到的左側選單取決於管理員分配的角色和許可權,所以如果看不到 Tables,應該先去問這一點。

JSON 的流程相同,只是在第 3 步選擇 JSON 作為檔案格式。手冊沒有說明巢狀 JSON 的展開規則,所以一開始最穩妥的形態是:鍵一致的扁平記錄陣列。

匯入之後應該檢查什麼?

開啟資料表卡片上的 Detail 按鈕。在 Columns 標籤頁中,檢查每一列的型別是否符合預期。有兩項設定會影響搜尋:

  • Column Type:ATTRIBUTE 列用於分組和篩選,MEASURE 列用於聚合。
  • Aggregation:指標的預設聚合方式,例如 SUM。

在樣例中,Store、City 和 Month 應當是屬性,Orders 和 Sales 應當是指標。用 Preview data 把幾行資料與原始檔對照。如果業務上對某一列有別的叫法,就在這裡設定它的 Display Name;搜尋匹配的正是這個名稱。

如何把資料表繫結到本體?

OT Flash 中的本體(Ontology)是圍繞一個業務主題組織起來的知識空間,把相關的資料表、業務文件、指標和資料看板放在一起。每個本體有 11 個模組,包括 Data Tables、Data Explore 和 Document Center。

如果你還沒有建立本體,建立時只需要填寫 Name 並選一個圖示。之後在 Data Tables 中匯入相關的資料表,在 Document Center 中上傳業務文件。

對於你剛匯入的新資料表:

  1. 在左側選單開啟 Ontology(本體管理),進入對應你主題的本體,例如一個關於零售門店業績的本體。
  2. 開啟 Data Tables 模組,它會列出已經繫結到該本體的資料表。
  3. 點選 Import data table,從系統中選擇剛匯入的資料表。
  4. 如果本體裡有不止一張資料表,用 Relationships 標籤頁設定它們之間的關聯,方式與 Tables 章節中相同。

匯入資料表和繫結到本體是兩個獨立的步驟:前者把表放進系統,後者把表加入本體。

如何做第一次搜尋?

在 BI Workspace 下開啟 Data Search(資料搜尋),選擇你的資料表,輸入列名和關鍵詞。在一張含有 Sales 指標和 Region 屬性的表裡輸入 “Sales by Region”,系統會計算結果並選擇圖表;指標列預設求和。用上面的樣例檔案,“Sales by City” 會給出每個城市一個合計值。

如果你輸入的是完整的問句而不是關鍵詞,系統會請 FocusGPT(智慧問數)把它解析成搜尋語句,顯示解析後的語句,並提供 Revert 選項。右側欄會顯示結果背後的 SQL 和 FocusGPT 的分析摘要,可以很快核實 Sales 是不是對你預期的那些行求和。把某一個城市的合計與原始表格中的手工求和對一下,是一個不錯的首次檢查。

什麼時候該把一次性上傳改成定時匯入?

本地上傳只是一份快照。如果你每週一都要替換檔案,那你做的就是本該由定時任務完成的工作。手冊中的 Table Task 標籤頁用於管理從資料來源匯入的資料表的定時匯入任務,顯示每個任務的 Data Source、Import Type、定時匯入時間、狀態和上次匯入時間。從外部資料來源匯入資料表時,嚮導的第三步可以設定匯入型別和可選的定時計劃。

一條實用的判斷規則:

  • 保留本地檔案:資料是一次性提取、一份問卷,或者很少變化的檔案。
  • 改用外部資料來源:同一個檔案反覆從資料庫匯出。請資料維護人員連線資料來源並設定定時匯入。
  • 考慮 API 或 HTTP 匯入:資料由其他系統產生,而不是來自資料庫。

哪些情況不適合?

檔案上傳無法讓兩個系統保持同步;含有合併單元格、多行表頭,或同一個工作表裡放了多張表的電子表格,需要先清理,才能變成一張資料表。50 MB 及以上的檔案超出了本地匯入的接受範圍,應當放進資料庫,走外部資料來源這條路徑。

下一步

OT Flash 免費發行。可以從版本與下載頁面或 GitHub 倉庫獲取,安裝映象、發行說明、系統要求和支援的平臺都發布在那裡;Tables 和 Ontology 章節請參考 r57 使用者手冊(英文)。