Python pyspark DataFrame.rename用法及代碼示例

本文簡要介紹 pyspark.pandas.DataFrame.rename 的用法。

用法: DataFrame.rename(mapper: Union[Dict, Callable[[Any], Any], None] = None, index: Union[Dict, Callable[[Any], Any], None] = None, columns: Union[Dict, Callable[[Any], Any], None] = None, axis: Union[int, str] = 'index', inplace: bool = False, level: Optional[int] = None, errors: str = 'ignore') → Optional[pyspark.pandas.frame.DataFrame]

更改軸標簽。函數/字典值必須是唯一的(一對一)。字典/係列中未包含的標簽將保持原樣。列出的額外標簽不會引發錯誤。

參數：

mapper：類似字典或函數: 類似字典或函數的轉換應用於該軸的值。使用 mapper 和 axis 指定要通過 mapper 或 index 和 columns 定位的軸。
index：類似字典或函數: 指定軸的替代方法(“mapper,axis=0”相當於“index=mapper”)。
columns：類似字典或函數: 指定軸的替代方法(“mapper,axis=1”相當於“columns=mapper”)。
axis：int或str，默認‘index’: 使用映射器定位的軸。可以是軸名稱 (‘index’, ‘columns’) 或編號 (0, 1)。
inplace：布爾值，默認為 False: 是否返回一個新的 DataFrame。
level：int 或級別名稱，默認 None: 在 MultiIndex 的情況下，僅重命名指定級別的標簽。
errors：{‘ignore’, ‘raise}, 默認 ‘ignore’: 如果 ‘raise’，當類似字典 mapper 、 index 或 columns 包含正在轉換的索引中不存在的標簽時，引發 KeyError 。如果‘ignore’，現有的鍵將被重命名，額外的鍵將被忽略。

DataFrame 帶有重命名的軸標簽。

拋出：

KeyError: 如果在所選軸和“errors=’raise’” 中未找到任何標簽。

例子：

>>> psdf1 = ps.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> psdf1.rename(columns={"A": "a", "B": "c"})  
   a  c
0  1  4
1  2  5
2  3  6

>>> psdf1.rename(index={1: 10, 2: 20})  
    A  B
0   1  4
10  2  5
20  3  6

>>> def str_lower(s) -> str:
...     return str.lower(s)
>>> psdf1.rename(str_lower, axis='columns')  
   a  b
0  1  4
1  2  5
2  3  6

>>> def mul10(x) -> int:
...     return x * 10
>>> psdf1.rename(mul10, axis='index')  
    A  B
0   1  4
10  2  5
20  3  6

>>> idx = pd.MultiIndex.from_tuples([('X', 'A'), ('X', 'B'), ('Y', 'C'), ('Y', 'D')])
>>> psdf2 = ps.DataFrame([[1, 2, 3, 4], [5, 6, 7, 8]], columns=idx)
>>> psdf2.rename(columns=str_lower, level=0)  
   x     y
   A  B  C  D
0  1  2  3  4
1  5  6  7  8

>>> psdf3 = ps.DataFrame([[1, 2], [3, 4], [5, 6], [7, 8]], index=idx, columns=list('ab'))
>>> psdf3.rename(index=str_lower)  
     a  b
x a  1  2
  b  3  4
y c  5  6
  d  7  8

相關用法

注：本文由純淨天空篩選整理自spark.apache.org大神的英文原創作品 pyspark.pandas.DataFrame.rename。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

拋出：

例子：