表格匯入
我的表格匯入能應付真實工具匯出的內容嗎?
tabular-import 預設集用一個指令為這個問題建立出整組真實測試檔案,並在旁邊放一個
manifest.json,說明你的系統應如何回應每個檔案。以下所有內容都依此版本的預設值從程式中讀取。
它通常能發現什麼?
- 以分號分隔的檔案被讀成單一欄位,因為分隔符號是假設的,而不是偵測出來的
- CRLF 檔案被拆成多列,每列後面多出一個空列
- 沒有標題列的表格,第一列資料被當成欄位名稱吞掉
- 匯入只保留能顯示的欄位,其餘的默默丟棄
- 讀取器逐行讀取 JSON 記錄,遇到第一個有縮排的文件就停下來
組合裡有什麼?
使用預設值時,如 tfg preset show tabular-import 所回報的:
| 檔案數 | 13 |
|---|---|
| 其配方中的 target 數 | 13 |
| 總大小 | 3 080 060 B |
| 格式 | csv, json, xlsx |
以及該組合的清單對你的系統有何預期:
| 預期 | 意義 | 檔案數 |
|---|---|---|
accept | 你的系統應該接受這個檔案。 | 8 |
unspecified | 取決於你的系統規則。由你決定,然後檢查實際發生的是否符合你的本意。 | 5 |
你可以變更什麼?
| 設定 | 接受 | 預設值 | 作用 |
|---|---|---|---|
--rows |
1 - 200000 列 | 1000 |
試算表有多少列。檔案會寫成這麼多列恰好打包出的大小,所以上面的預算會隨這個值變動。 |
--columns |
1 - 32768 欄 | 10 |
試算表每列有多少欄。列數乘以欄數有上限,超出時會在寫入任何內容之前被拒絕。 |
如何執行?
查看組合的開銷、建置它,或取出它的配方來編輯:
tfg preset show tabular-import
tfg generate --preset tabular-import --out ./tabular-import
tfg preset eject tabular-import > tabular-import.yaml
也可以在你自己的配方中以它為基礎,放在測試旁邊:
version: 1
extends: preset:tabular-import