LISTUNIQUE 函式

將資料欄的一組唯一值擷取到儲存在新資料欄中的陣列。此函式一般屬於匯總的一部分。

提示:如要針對產生的陣列產生唯一值,請在這項函式之後的下一步驟中套用 ARRAYUNIQUE 函式。請參閱 ARRAYUNIQUE 函式

輸入資料欄可以是任何類型。

  • 根據預設,清單中值的數量上限為 1000。如要變更值的數量上限,請指定 limit 參數的值。
  • 此函式屬於匯總作業的一部分,可以依照群組傳回一組不重複的值。請參閱 Pivot 轉換

如需針對資料列累計範圍計算的此函式版本,請參閱 ROLLINGLIST 函式

基本用法

pivot value:LISTUNIQUE(Name, 500) group:Month limit:1

輸出:產生由兩個資料欄組成的資料表,其中含有 Month 的唯一值,以及依照不同 Month 值分組且由 Name 資料欄中所有值 (上限數為 500) 組成的陣列。limit 參數可定義輸出資料欄的數量上限。

語法

pivot value:LISTUNIQUE(function_col_ref, [limit_int]) [group:group_col_ref] [limit:limit_count]

引數是否必要?資料類型說明
function_col_ref字串要套用於函式的資料欄名稱
limit_int整數 (正數)要擷取至清單陣列的唯一值數量上限,範圍從 11000

如要進一步瞭解 grouplimit 參數,請參閱 Pivot 轉換

如要進一步瞭解語法標準,請參閱語言文件語法附註

function_col_ref

資料欄名稱,系統會從該資料欄依照組別來擷取唯一值的清單。

  • 輸入內容不得為文字值。
  • 不支援多個資料欄和萬用字元。

使用須知:

是否必要?資料類型範例值
字串 (資料欄參照)myValues

limit_int

非負整數,定義要擷取至清單陣列的唯一值數量上限。

注意:如果需要指定此引數,則這個值必須介於 1 到 1000 (含) 之間。

注意:在一般匯總作業中,由於資料欄中的所有值皆分別插入至單一儲存格,因此請勿在 LISTUNIQUE 函式呼叫中使用限制引數。在這種情況下,如果您同時指定了 group 參數,或許可以使用限制引數。錯誤使用 LISTUNIQUE 函式可能會造成應用程式當機。

使用須知:

是否必要?資料類型範例值
整數50

範例

範例 - 本月售出的顏色

此範例說明下列函式:

  • LIST - 將單一資料欄的最多 1000 個值擷取至新資料欄中的陣列。請參閱 LIST 函式
  • LISTUNIQUE - 將單一資料欄的最多 1000 個不重複值擷取至新資料欄中的陣列。請參閱 LISTUNIQUE 函式

您有下列一組兩個月的訂單,並想要辨認每個月每項產品售出的顏色集合,以及每個月銷售產品的總數量。

來源:

OrderIdDateItemQtyColor
10011/15/15Pants1red
10021/15/15Shirt2green
10031/15/15Hat3blue
10041/16/15Shirt4yellow
10051/16/15Hat5red
10061/20/15Pants6green
10071/15/15Hat7blue
10084/15/15Shirt8yellow
10094/15/15Shoes9brown
10104/16/15Pants1red
10114/16/15Hat2green
10124/16/15Shirt3blue
10134/20/15Shoes4black
10144/20/15Hat5blue
10154/20/15Pants6black

轉換:

若依照月份追蹤,您的資料欄必須含有從日期中擷取的月份值:

set col:Date value:DATEFORMAT(Date, 'MMM yyyy')

您可使用下列轉換指令,檢查各顏色間的不重複值清單:

pivot value: LISTUNIQUE(Color, 1000) group: Date limit:10

日期listunique_Color
Jan 2015["green","blue","red","yellow"]
Apr 2015["brown","blue","red","yellow","black","green"]

刪除以上的轉換指令。

您可以在資料集裡匯總資料,並按格式重新設定後的 Date 值分組,然後將 LIST 函式套用到 Color 資料欄。在同一個匯總作業中,您也可以在 Qty 資料欄加入總和函式:

pivot value: LIST(Color, 1000) SUM(Qty) group: Date limit:10

結果:

Datelist_Colorsum_Qty
Jan 2015["green","blue","blue","red","green","red","yellow"]28
Apr 2015["brown","blue","red","yellow","black","blue","black","green"]38

必要時,您可以使用下列指令拆分清單陣列資料:

unnest col:list_Color

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Google Cloud Dataprep 說明文件
需要協助嗎?請前往我們的支援網頁