pyspark.pandas.DataFrame.rename

DataFrame。 重命名 ( 映射器:聯盟[Dict類型,調用(任何),誰,沒有一個)=沒有一個,指數:聯盟[Dict類型,調用(任何),誰,沒有一個)=沒有一個,:聯盟[Dict類型,調用(任何),誰,沒有一個)=沒有一個,:聯盟(int,str]=“指數”,原地:bool=,水平:可選(int]=沒有一個,錯誤:str=“忽略” )→可選(pyspark.pandas.frame.DataFrame]

改變軸標簽。函數/ dict值必須是唯一的(一對一)。標簽不包含在dict /係列將保持不變。額外的標簽列出不拋出一個錯誤。

參數
映射器 dict-like或函數

Dict-like或函數轉換適用於軸的值。使用映射器指定目標的軸映射器,或指數

指數 dict-like或函數

選擇指定軸(“映射器,軸= 0”相當於“指數=映射器”)。

dict-like或函數

選擇指定軸(“映射器,軸= 1”相當於“列=映射器”)。

int或str,默認“指數”

軸與映射的目標。可以是軸名稱(“指數”、“列”)或數字(0,1)。

原地 bool,默認的錯誤

是否要返回一個新的DataFrame。

水平 int或級別名稱,默認沒有

對於MultiIndex,隻有重命名標簽指定的水平。

錯誤 {“忽略”,“提高”},默認“忽略”

如果“提高”,提高KeyError當一個dict-like映射器,指數,或索引中包含標簽,不存在被改變了。如果“忽略”,現有鍵將重命名和額外的鍵將被忽略。

返回
DataFrame更名為軸標簽。
提出了
KeyError

如果沒有找到任何標簽在選定的軸和“錯誤=‘提高’”。

例子

> > >psdf1=psDataFrame({“一個”:(1,2,3),“B”:(4,5,6]})> > >psdf1重命名(={“一個”:“一個”,“B”:“c”})一個c0 1 41 2 52 3 6
> > >psdf1重命名(指數={1:10,2:20.})一個B0 1 410 2 520 3 6
> > >psdf1重命名(={“一個”:“一個”,“C”:“c”},錯誤=“提高”)回溯(最近的電話):KeyError:指數不包括價值的映射器”
> > >defstr_lower(年代)- >str:返回str較低的(年代)> > >psdf1重命名(str_lower,=“列”)一個b0 1 41 2 52 3 6
> > >defmul10(x)- >int:返回x*10> > >psdf1重命名(mul10,=“指數”)一個B0 1 410 2 520 3 6
> > >idx=pdMultiIndexfrom_tuples(((“X”,“一個”),(“X”,“B”),(“Y”,“C”),(“Y”,' D ')))> > >psdf2=psDataFrame([[1,2,3,4),(5,6,7,8]],=idx)> > >psdf2重命名(=str_lower,水平=0)x yA B C D0 1 2 3 41 5 6 7 8
> > >psdf3=psDataFrame([[1,2),(3,4),(5,6),(7,8]],指數=idx,=列表(“ab”))> > >psdf3重命名(指數=str_lower)一個bx 1 2b 3 4y c 5 6d 7 8