PAD 函式

在字串左側或右側加入指定字元,將字串值填充至指定的長度下限。傳回的值屬於字串類型。

如果輸入值超過長度下限,則字串不會有任何變動。如果您需要字串符合特定長度,可以使用 LEFT、RIGHT 或 SUBSTRING 函式。

提示:您在套用填充字元後可以套用下列字串,確保所有值的長度都相同。

基本用法

資料欄參照範例:

set col: Whse_Nbr value: PAD(Whse_Nbr, 6, '0', left)

輸出:Whse_Nbr 資料欄的值設為長度最少六個字元。如果資料欄值的長度較短,則系統會在字串左側加入 0 字元。

字串常值範例:

derive type:single value:PAD('My Name', 10, '!', right)

輸出:系統會將 My Name!!!! 字串寫入新資料欄。

語法

derive type:single value:PAD(string_val,string_length,pad_string,pad_side)

引數是否必要?資料類型說明
string_val字串要套用於函式的資料欄名稱、傳回字串值的函式或字串常值
string_length整數 (正數)輸出字串中的字元數下限。
pad_string字串字串、資料欄參照或傳回字串的函式,會套用到長度低於下限的字串。預設值為空格字元。
pad_sideenum
  • left:任何填充字元都會套用到字串的左側 (預設值)
  • right:任何填充字元都會套用到字串的右側

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

string_val

用來填充的資料欄名稱、傳回字串的函式或字串常數。

  • 如果系統找不到字串或資料欄值,則會產生空白的字串結果。
  • 字串常數必須以引號括住 ('Hello, World')。
  • 不支援多個資料欄和萬用字元。

使用須知:

是否必要?資料類型示例值
字串常值或資料欄參照myColumn

string_length

產生字串的長度下限。

注意:如果輸入字串值的長度超過字串長度下限,則不會套用任何填充字元。

  • 負值對輸入字串沒有任何影響。
  • 不支援整數資料類型的資料欄參照。

使用須知:

是否必要?資料類型示例值
整數 (非負整數)5

pad_string

由一或多個字元組成的字串,用來填充輸入字串。如果沒有提供任何值,則預設的填充字串是單一空格字元。

輸入值可以是字串常值、傳回字串的函式或含有字串的資料欄。

多字元填充字串的行為:

填充字串含有多個字元時,其行為會隨著字串填充位置是在左側或右側而有所不同:

函式輸出值

PAD('12', 4, 'abc' left)

bc12

PAD('12', 4, 'abc' right)

12ab

PAD('12', 6, 'abc' left)

cabc12

PAD('12', 6, 'abc' right)

12abca

使用須知:

是否必要?資料類型示例值
字串常值、傳回字串的函式或資料欄參照'X'

pad_side

列舉值,用來決定填充字串需要套用到字串的左側或右側:

說明
left在左側套用填充字串。如果沒有指定,則這是預設值。
right在右側套用填充字串。

使用須知:

是否必要?資料類型範例值
下列其中一項:leftrightleft

範例

範例 - 數字 ID

下列範例的資料表含有四個字元的產品 ID 和產品名稱。這個資料表已匯入 Cloud Dataprep by TRIFACTA®。然而,這些產品 ID 的結構是數字,因此 Cloud Dataprep by TRIFACTA 在匯入時會將產品 ID 解讀為整數值。系統會捨棄某些值前方的零,但資料表中較後面的資料列卻包含完整定義的數字值。

來源:

prodIdprodName
1Our First Product
2Our Second Product
3Our First Product v2
1001

A New Product Line

1002A New Product Line v2

轉換:

第一步是將產品 ID 轉換成字串值:

settype col: prodId type: 'String'

然後,在這些字串的左側套用 0 做為填充字元,這樣至少所有值的長度都是四個字元。

set col:prodId value:PAD(prodId,4,'0',left)

結果:

prodIdprodName
0001Our First Product
0002Our Second Product
0003Our First Product v2
1001

A New Product Line

1002A New Product Line v2

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

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

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