Store

儲存在 Parquet 檔案中

Parquet 是強力輸入的檔案格式，其中每個欄位包含單一特定資料類型 (例如 in32、雙重、時間戳記或文字)。Qlik Sense 將內部資料儲存為鬆散輸入的雙重內容，其中來自不同來源的資料可以混合到相同的欄位中。由於 Parquet 的每個欄位中只能儲存一個雙重部分，知道每個欄位包含的內容很重要。依照預設，Qlik Sense 使用欄位類型決定應如何儲存欄位。以特定格式在 Parquet 檔案中儲存資料時，您必須指定欄位在載入時是什麼資料類型。若您嘗試以 Parquet 檔案將資料儲存到不相容的欄位中，例如在文字欄位中儲存數字或在時間戳記欄位中儲存文字，結果會是 Null 值。

載入您打算以 Parquet 儲存的資料時，可以變更預設行為。您可以格式化以變更資料類型，或標記以在 Parquet 強制特定欄類型。

格式化資料以儲存於 Parquet

您可以使用 Qlik Sense 格式化功能以分類資料。例如，Text()、Num()、Interval() 或 Timestamp() 可以在以 Parquet 儲存資料時強制資料格式。Qlik Sense 可以將資料儲存到將近 20 個資料類型，視欄位屬性和自動欄位標記而定。如需詳細資訊，請參閱解譯函數。

範例： 以 Num() 和 Text() 格式化資料

下列範例展示準備資料以儲存於 Parquet。Num() 套用至數字欄位。Text() 套用至文字和混合欄位。在混合情況下，Text() 可防止像 Parquet 中的數字欄位那樣來處理，並有變更為 Null 值的文字值。

標記資料以儲存於 Parquet

您使用 $parquet 標記來標記資料，以便在以 Parquet 儲存資料時強制特定欄類型。新增對應的控制標記以強制每個資料類型。例如，若要在 Parquet 將欄位儲存為 INT32，在載入指令碼中以 $parquet-int32 標記。根據資料類型，將會儲存雙重資料的字串或數字呈現。

下列 Parquet 控制標記可用來標記欄位，以儲存於 Parquet 檔案。

範例： 標記資料以儲存於 Parquet

在此範例中，兩個標記用來定義 Parquet 的資料。欄位 num 以 $parquet-int32 標記，以定義為將會在 Parquet 設定為 INT32 的數字欄位。

在 Parquet 檔案中儲存巢狀資料

您可以將表格內嵌至結構化資料中，以在 Parquet 檔案中儲存多個表格。Store 支援結構化節點並以星狀結構描述列出節點。也可以使用 Delimiter is 說明符，以巢狀模式儲存單一表格。

儲存表格時，指定您要納入的表格並以逗號分隔。例如：STORE Table1, Table2, Table3 INTO [lib://<file location>/<file name>.parquet] (parquet);。您可以在 Store 陳述式使用欄位清單，以控制儲存哪些欄位。例如 STORE Field1, Field2, FROM Table1, Table2 INTO [lib://<file location>/<file name>.parquet] (parquet);。欄位清單中的所有欄位必須位於一個或多個列出的表格。Store 陳述式中的第一個表格將會作為星狀結構描述中的事實資料表使用。

欄位名稱用來控制如何建立和內嵌群組。依照預設，欄位名稱會以句號 (.) 分為節點。可以設定系統變數 FieldNameDelimiter 或使用說明符 Delimiter is，以變更分隔符號。說明符將會覆寫系統變數。如需詳細資訊，請參閱 在資料載入編輯器中使用變數。

欄位名稱透過分隔符號分割，部分用來透過巢狀群組建立結構描述。例如，STORE Field1, Field1.Field2, Field1.Field3, Field1.Field4 FROM Table1 INTO [nested.parquet] (parquet, delimiter is '.'); 將會透過 Fields1, Field2 和 Field3, Field4 建立兩個群組 (Group1 和 Group2)。

在 Parquet 儲存巢狀資料時，表格之間的金鑰會轉換為結構描述中的連結節點。表格會轉換為結構描述中的結構化節點。您可以使用欄位名稱覆寫預設轉換。

範例： 在 Parquet 檔案中儲存巢狀資料

產生的 Parquet 檔案有下列結構描述：

限制

在 Parquet 中儲存巢狀資料有下列限制：

• 儲存不支援地圖節點。

• 儲存不包括從載入中的巢狀 parquet 檔案產生的索引鍵欄位。

• 您無法從表格一同儲存未與索引鍵欄位連結的資料。

• 巢狀檔案反正規化資料模型。不會儲存非參考的值，將會複製參考多次的值。

在 Qlik Cloud 的載入指令碼中使用 Store 陳述式時，您可以參考要儲存所建立檔案的空間中的確切資料夾。按照有效空間資料夾路徑的規則。此外，以下行為也適用且是 Store 陳述式所獨有：

• 如果空間存在但指定的資料夾路徑不存在，則會在空間中建立路徑。根據定義的資料夾結構，可能會建立一個或多個資料夾。會產生檔案並儲存於該處。

• 如果空間存在，但指定的資料夾路徑使用無效的資料夾分隔符號 (例如 \、\\、//、/./ 或 /../)，則仍會執行 Store 陳述式。輸出檔案會改為儲存在目標空間的上層路徑中，並且將具有包含其完整路徑的名稱，而不僅僅是指定的名稱。

• 如果空間不存在，則 Store 陳述式無法執行並傳回錯誤。

以下範例示範如何在 Store 陳述式內參考空間中的特定資料夾路徑。

範例： 在空間上層路徑儲存檔案

在此範例中，整個表格 mytable 作為名為 myfile.qvd 的檔案匯出到 Qlik Cloud 分析 中。檔案已新增至空間 TeamSharedSpace。該檔案沒有位於任何特定資料夾中，而是位於空間中的上層路徑。

Store * from mytable into [lib://TeamSharedSpace:DataFiles/myfile.qvd];

範例： 將檔案儲存到空間內的特定資料夾路徑

在此範例中，整個表格 mytable 作為名為 myfile.qvd的檔案匯出到 Qlik Cloud 分析 中。該檔案已新增至空間 TeamSharedSpace 內的資料夾 SalesData 中。

Store * from mytable into [lib://TeamSharedSpace:DataFiles/SalesData/myfile.qvd];