資料工作流程

CSV 工作流程:保留字串、關聯合併、主鍵比對與 SQL 匯出

CSV 有欄位,沒有通用型別系統。先保留原始字串,直到明確的接收契約指定可進行哪些轉換。

內容更新: · 維護者:Hung Chi-Hsueh · 修正回報

解析資料紀錄,不是直接切實體行

RFC 4180 允許引號欄位內含逗號與換行;欄位內的引號以兩個引號表示。直接依逗號或換行切割會破壞這些紀錄,請明確選擇分隔符號,或使用第一筆紀錄偵測並檢查結果;數量並列會被拒絕。UTF-8 檔案嚴格解碼,CSV parser 可移除一個開頭 UTF-8 BOM。

有欄名時,欄位編輯器拒絕空白或重複名稱;無欄名資料會建立編號欄名,CSV 匯出可不含欄名。兩種模式都拒絕缺欄或多欄,並保留 001、空字串、空白與引號內換行等字串值。單欄純文字匯出會保留欄內換行,但項目邊界可能混淆;需要明確邊界時請選 CSV 或 JSON。輸入上限為 5 MiB、20,000 資料列、含表頭的 100,000 格與 200 欄;前 100 列只是預覽,匯出包含完整選取結果。

明確選擇資料變更

選欄、排序與改名會改變匯出結構,不會修改原始檔。篩選支援區分大小寫的相等、包含或略過空欄位,只有空白的欄位仍保留。可依單一來源欄位去重:先篩選,再依包含大小寫與空格的原始值保留第一筆,最後排序。列排序可選字元順序或自然排序;自然排序依瀏覽器 Intl 資料,並非精確十進位運算。下載前請檢查列數、順序與表頭。

主鍵比對必須能唯一識別資料列;單欄不足時請使用複合主鍵。資料列或欄位重新排序不應造成假的修改,重複主鍵必須先處理。空主鍵值和其他字串一樣可能碰撞。

Join 補資料,Diff 比對版本

訂單使用 sku、商品表使用 code 時,請明確配對 sku 與 code,再追加 category。Left Join 保留每筆主表紀錄及原順序;Inner Join 只保留命中紀錄,主表鍵可重複。本工具刻意要求查表鍵唯一,不會選第一/最後筆,也不展開多對多;這是工具限制,不是通用 SQL 規定。

可配對一至三組鍵欄位,每個組成值都區分大小寫、逐字比對:001 不同於 1,空白維持原樣。任一組成值為空字串時,主表視為未命中,查表則拒絕;只有空白的值仍是字面字串,不視為空鍵。輸出欄名衝突必須自行改名,不會覆寫主表值。

預覽狀態可區分未命中與已命中的空字串,但 CSV 沒有 null 型別,兩者都會匯出空欄位;預覽狀態及來源紀錄編號不加入輸出。匯出使用 UTF-8、逗號與 CRLF,不保留原始引號排版。輸出最多 20,000 筆、含表頭 100,000 格、200 欄、16 MiB;複製上限 1 MiB,下載保留符合上限的完整資料。前 100 筆與每值 1,000 字元只是預覽。Worker 取消、來源/設定變更與五秒逾時都會使舊匯出失效。

CSV 與 SQL 的安全界線不同

CSV 引號只保留欄位語法,不會消除試算表公式。以 =、+、-、@ 開頭的值可能被試算表解讀;工具不會暗中加前綴或改寫值。匯入不可信資料時,請明確以文字處理並遵守試算表安全指引。

PostgreSQL INSERT 匯出需要明確的表格/欄位識別字、字串跳脫與型別選擇。空 CSV 字串不會自動變成 SQL NULL;識別碼轉數字會失去前導零,請保留為文字。產生的語句不會執行,也不能證明目標資料庫 Schema 會接受它。

本機處理不代表匯出內容已匿名或不敏感;分享前請檢查資料。輸入不上傳、不儲存、不放進網址,來源修改後會清除舊匯出結果。

範例
id,note
001,"a,b"
002,"two
lines"

-- 識別碼保持文字:
INSERT INTO "example" ("id") VALUES ('001');

資料可信度

資料來源