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。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

抛出：

例子：