設定資料上傳

本頁涵蓋管理員如何設定資料上傳,以便使用者可以將 CSV 檔案上傳到您的 Metabase。如需設定完成後如何上傳資料,請查看上傳資料

Upload CSV data to a collection in Metabase

上傳 CSV 資料最適合用於試算表資料的臨時分析。如果您有大量資料,或需要定期更新或新增資料,我們建議您設定一種方式將資料直接載入資料庫,然後將 Metabase 連接到該資料庫。

管理上傳設定

若要管理上傳設定,管理員可以按下 cmd/ctrl + K 並搜尋「設定 - 上傳」,或按一下右上角的齒輪圖示,然後依序按一下管理設定 > 設定 > 上傳

支援上傳的資料庫

設定上傳

管理員需要執行一些操作才能支援 CSV 上傳

使用具有寫入權限的資料庫使用者帳戶連線到資料庫

若要將資料上傳到 Metabase,管理員需要將您的 Metabase 連線到支援上傳的資料庫,並使用具有該資料庫寫入權限的資料庫使用者帳戶。

您也可以將資料上傳到 Metabase 隨附的範例資料庫 (H2 資料庫),但我們不建議將範例資料庫用於任何您想要保留的資料。

如需更多資訊,請查看

選取您要儲存資料的資料庫和結構描述

如果 Metabase 使用具有寫入權限的資料庫使用者帳戶連線到資料庫,管理員可以透過以下方式啟用上傳

  • 按一下首頁右上角的齒輪圖示,並導覽至管理設定 > 設定 > 上傳
  • 選取 Metabase 應用於儲存資料的資料庫。

當使用者將 CSV 上傳到集合時,Metabase 將會

  • 在管理員選取用於儲存上傳的資料庫和結構描述中,建立一個表格來儲存該資料。
  • 建立一個 模型,包裝上傳的表格,並將該模型儲存到使用者上傳 CSV 資料的集合中。

指定 Metabase 要預先添加到上傳表格的前置詞

管理員可以選擇性地指定文字字串,添加到 Metabase 建立的表格前面,以儲存上傳的資料。

將人員新增至具有資料存取權的群組,以存取上傳結構描述

為了上傳 CSV,使用者必須加入一個群組,該群組對您選取用於儲存上傳資料的結構描述具有「可以檢視」的 檢視資料 存取權,以及「查詢產生器存取權或更高權限」的 建立查詢 權限。請參閱群組資料權限

主索引鍵自動產生

當您上傳 CSV 時,Metabase 會建立一個唯一的主索引鍵欄,名為 _mb_row_id,作為上傳 CSV 表格的第一個 (最左邊) 欄。此 _mb_row_id 欄將包含自動產生的整數。Metabase 也會忽略上傳中任何欄位名稱與資料庫中自動產生主索引鍵欄位名稱相同的欄位 (例如,CSV 中的 _MB row-ID 在資料庫中會是 _mb_row_id_MB_ROW_ID)。

如果您不想要此自動產生的 ID 欄,您可以隨時從 Metabase 建立的模型中移除該欄。造訪模型,按一下資訊 i 圖示,然後按一下模型詳細資訊。從模型詳細資訊頁面,按一下編輯定義按鈕。在查詢產生器的「資料」區段中,按一下表格旁邊的向下箭頭,取消選取新增的 ID 欄,然後儲存您的變更。

資料類型錯誤

Metabase 會嘗試猜測每個欄位的資料類型,但如果某些項目與其他項目不同,Metabase 可能無法正確猜測類型。例如,如果您有一個欄位以整數 (如 100、130、140) 開頭,然後稍後出現浮點數 105.5,Metabase 可能會拒絕上傳。若要修正此問題,您需要使用試算表軟體調整格式,以便在上傳之前將所有整數格式化為浮點數 (例如,100.00、130.00、140.00 等等)。

檔案大小限制

CSV 檔案大小不得超過 50 MB。

雖然 Metabase 將上傳限制為 50 MB,但您用來執行 Metabase 的伺服器可能會施加更低的限制。例如,NGINX 的預設用戶端上傳限制為 1 MB。因此,您可能需要變更伺服器設定,以允許上傳高達 50 MB 的檔案。Metabase Cloud 的使用者不必擔心這個問題。

如果您的檔案大於 50 MB,此處的變通方法是將資料分割成多個檔案,並將這些檔案附加到現有模型

日期格式

目前,Metabase 僅能辨識從上傳 CSV 中具有以下格式的字串取得的日期和日期時間

日期

表示年、月和日,不含時間資訊。

格式yyyy-MM-dd

範例2023-01-01

日期時間

表示年、月、日、小時。分鐘、秒和秒的小數部分為選填。

格式yyyy-MM-ddTHH:mm:ss.SSS。“T” 分隔符號也可以是空格 (“ ”)。

範例:

  • 2023-01-01 00
  • 2023-01-01 00:00:00.000
  • 2023-01-01T00:00:00.000
  • 2023-01-01 00:00:00.0000000

含偏移量的日期時間

表示與 協調世界時 (UTC) 的偏移量的日期時間。偏移量中的分鐘和秒為選填。

格式:

日期時間格式

  • yyyy-MM-ddTHH:mm.
  • yyyy-MM-ddTHH:mm:ss.
  • yyyy-MM-ddTHH:mm:ss.SSS (以及任意數量的 S)。

“T” 分隔符號也可以是空格 (“ ”)。

偏移量

  • Z (適用於 UTC)
  • +HH-HH
  • +HH:mm-HH:mm
  • +HH:mm:ss-HH:mm:ss

範例:

  • 2023-01-01 00:00:00+00:00:00
  • 2023-01-01T00:00:00+00:00:00

刪除上傳建立的模型和表格

刪除上傳建立的模型

刪除上傳的表格僅適用於 ProEnterprise 方案(包括自架和 Metabase Cloud)。

您可以將模型移至垃圾桶,方法是點擊右上角的三個點並選擇移至垃圾桶

如需完全刪除模型,請參閱永久刪除項目

刪除上傳建立的表格

刪除上傳的表格僅適用於 ProEnterprise 方案(包括自架和 Metabase Cloud)。

若要刪除上傳建立的表格,請前往管理設定 > 設定 > 上傳

管理上傳下方,Metabase 將列出模型底層的表格。

當您刪除表格時,Metabase 將讓您選擇同時將基於此表格的所有模型和問題傳送到垃圾桶

關於將資料上傳到 MySQL 資料庫的注意事項

為了加快上傳到 MySQL 資料庫的速度,我們建議您將 local_infile 設定為 ON。您需要在 MySQL 中設定此 local_infile,而不是 Metabase。命令列格式為 --local-infile=ON

如果 local_infile 停用(設定為 OFF),Metabase 將自動回退到以較慢的方式上傳 CSV。

如需更多背景資訊,請查看

閱讀其他Metabase 版本的文件。