中文文档pyspark.sql.functions

9.1 pyspark.sql.functions.abs(col): New in version 1.3.

一组内置函数,计算绝对值

9.2 pyspark.sql.functions.acos(col):New in version 1.4.

计算给定值的余弦逆;返回的角度在0.0到pi的范围内。

9.3 pyspark.sql.functions.add_months(startmonths): New in version 1.5.

返回开始后几个月的日期

 df=sqlContext.createDataFrame([('2015-04-08',)],['d'])

df.select(add_months(df.d,1).alias('d')).collect()

[Row(d=datetime.date(2015, 5, 8))]

9.4 pyspark.sql.functions.approxCountDistinct(colrsd=None):New in version 1.3.

返回一个新列以获得列的近似非重复计数。

tmp=sqlContext.createDataFrame([{'age':1,'name':'bob'},{'age':2,'name':'alice'}])

tmp.agg(approxCountDistinct(tmp.age).alias('c')).collect()

[Row(c=2)]

9.5 pyspark.sql.functions.array(*cols):New in version 1.4.

建立新列

参数:cols – 具有相同数据类型的列名(字符串)列表或列表达式列表。

In [458]: tmp.select(array('age','age').alias('arr')).show()

+------+

|  arr|

+------+

|[1, 1]|

|[2, 2]|

+------+

In [456]: tmp.select(array([tmp.age,tmp.age]).alias("arr")).show()

+------+

|  arr|

+------+

|[1, 1]|

|[2, 2]|

+------+

9.6 pyspark.sql.functions.array_contains(colvalue): New in version 1.5.

集合函数:如果数组包含给定值,则返回True。集合元素和值的类型必须相同。

参数:col– 包含数组的列的名称

           value – 检查值是否在col中     

In [468]: df2=sqlContext.createDataFrame([(["a","b","c"],),([],)],['data'])

In [469]: df2.show()

+---------+

|    data|

+---------+

|[a, b, c]|

|      []|

+---------+

In [470]: df2.select(array_contains(df2.data,"a")).collect()

Out[470]: [Row(array_contains(data, a)=True), Row(array_contains(data, a)=False)]

9.7 pyspark.sql.functions.asc(col):New in version 1.3.

返回:根据给定列名的升序返回排序表达式

In [471]: df4.sort(asc("year")).collect()

Out[471]:

[Row(year=2012, course=u'dotNET', earnings=10000),

Row(year=2012, course=u'dotNET', earnings=5000),

Row(year=2012, course=u'Java', earnings=20000),

Row(year=2012, course=u'c', earnings=9999),

Row(year=2013, course=u'dotNET', earnings=48000),

Row(year=2013, course=u'Java', earnings=30000)]

9.8 pyspark.sql.functions.ascii(col):New in version 1.5.

计算字符串列的第一个字符的数值。

In [493]: df3=sqlContext.createDataFrame([('alice','bob')],['name'])

In [494]: df3.show()

+-----+---+

| name| _2|

+-----+---+

|alice|bob|

+-----+---+

In [495]: df3.select(ascii(df3.name))

Out[495]: DataFrame[ascii(name): int]

In [496]: df3.select(ascii(df3.name)).show()

+-----------+

|ascii(name)|

+-----------+

|        97|

+-----------+

9.9 pyspark.sql.functions.asin(col) New in version 1.4.

计算给定值的正弦逆;返回的角度在pi/2到pi/2的范围内。

In [500]: df3=sqlContext.createDataFrame([{'asin':0.5},{'asin':0.6}])

In [501]: df3.show()

+----+

|asin|

+----+

| 0.5|

| 0.6|

+----+

In [503]: df3.select(asin(df3.asin)).show()

+------------------+

|        ASIN(asin)|

+------------------+

|0.5235987755982989|

|0.6435011087932844|

+------------------+

9.10 pyspark.sql.functions.atan(col):New in version 1.4.

计算反正切值

9.11 pyspark.sql.functions.atan2(col1col2):New in version 1.4.

返回直角坐标(x,y)拓扑坐标(r,theta)转换后的角度θ。

9.12 pyspark.sql.functions.avg(col):New in version 1.3.

聚合函数:返回组中的值的平均值。

9.14 pyspark.sql.functions.base64(col):New in version 1.5.

计算二进制列的BASE64编码并将其作为字符串列返回。

9.15 pyspark.sql.functions.bin(col):New in version 1.5.

返回给定列的二进制值的字符串表示形式。

df.select(bin(df.age).alias('c')).collect()[Row(c=u'10'), Row(c=u'101')]

9.16 pyspark.sql.functions.bitwiseNOT(col):New in version 1.4.

计算 bitwise not.

9.17 pyspark.sql.functions.broadcast(df):New in version 1.6.

将标记为足够小,以便在广播变量join中使用。

9.18 pyspark.sql.functions.cbrt(col):New in version 1.4.

计算给定值的立方根。

9.19 pyspark.sql.functions.ceil(col):New in version 1.4.

计算给定值的上限。

9.20 pyspark.sql.functions.coalesce(*cols):New in version 1.4.

返回非空的第一列。

In [504]: cDf=sqlContext.createDataFrame([(None,None),(1,None),(None,2)],("a","b"))

In [505]: cDf.show()

+----+----+

|  a|  b|

+----+----+

|null|null|

|  1|null|

|null|  2|

+----+----+

In [506]:  cDf.select('*',coalesce(cDf["a"],lit(0.0))).show()

+----+----+----------------+

|  a|  b|coalesce(a, 0.0)|

+----+----+----------------+

|null|null|            0.0|

|  1|null|            1.0|

|null|  2|            0.0|

+----+----+----------------+

In [507]: cDf.select('*',coalesce('a')).show()

+----+----+-----------+

|  a|  b|coalesce(a)|

+----+----+-----------+

|null|null|      null|

|  1|null|          1|

|null|  2|      null|

+----+----+-----------+

9.21 pyspark.sql.functions.col(col):New in version 1.3.

根据给定的列名返回列。

9.22 pyspark.sql.functions.collect_list(col):New in version 1.6.

聚合函数:返回所有对象的列表。

In [515]: df3=sqlContext.createDataFrame([{'asin':0.5},{'asin':0.7},{'asin':0.7}])

In [516]:  df3.select(collect_list('asin')).show()

+------------------+

|collect_list(asin)|

+------------------+

|  [0.5, 0.7, 0.7]|

+------------------+

9.23 pyspark.sql.functions.collect_set(col):New in version 1.3.

聚合函数:返回非重复对象的列表。

In [517]: df3.select(collect_set('asin')).show()

+-----------------+

|collect_set(asin)|

+-----------------+

|      [0.5, 0.7]|

+-----------------+

9.24 pyspark.sql.functions.column(col):New in version 1.3.

根据给定的列名返回列。

In [518]: df3.select(column('asin')).show()

+----+

|asin|

+----+

| 0.5|

| 0.7|

| 0.7|

+----+

9.25  pyspark.sql.functions.concat(*cols):New in version 1.5.

将多个输入字符串列连接到一个字符串列中。

df=sqlContext.createDataFrame([('abcd','123')],['s','d'])

 df.select(concat(df.s,df.d).alias('s')).collect()[Row(s=u'abcd123')]

9.26 pyspark.sql.functions.concat_ws(sep*cols):New in version 1.5.

使用给定的分隔符将多个输入字符串列连接到一个字符串列中。 df=sqlContext.createDataFrame([('abcd','123')],['s','d'])

df.select(concat_ws('-',df.s,df.d).alias('s')).collect()[Row(s=u'abcd-123')]

9.27 pyspark.sql.functions.conv(colfromBasetoBase):New in version 1.5.

将字符串列中的数字从一个基转换为另一个基。

df=sqlContext.createDataFrame([("010101",)],['n'])

df.select(conv(df.n,2,16).alias('hex')).collect()[Row(hex=u'15')]

9.28 pyspark.sql.functions.corr(col1col2):New in version 1.6.

返回col1和col2的皮尔逊相关系数。

>>> a=[x*x-2*x+3.5 for x in range(20)]

>>> b=range(20)

>>> corrDf=sqlContext.createDataFrame(zip(a,b))

>>> corrDf=corrDf.agg(corr(corrDf._1,corrDf._2).alias('c'))

>>> corrDf.select Expr('abs(c - 0.9572339139475857) < 1e-16 as t').collect()[Row(t=True)]

9.29 pyspark.sql.functions.cos(col):New in version 1.4.

计算余弦值。

9.30 pyspark.sql.functions.cosh(col):New in version 1.4.

计算给定值的双曲余弦。

9.31 pyspark.sql.functions.count(col):New in version 1.3.

聚合函数:返回组中的项数。

9.32 pyspark.sql.functions.countDistinct(col*cols):New in version 1.3.

返回列或列的不同计数的新列。

>>> df.agg(countDistinct(df.age,df.name).alias('c')).collect()[Row(c=2)]

>>> df.agg(countDistinct("age","name").alias('c')).collect()[Row(c=2)]

9.33 pyspark.sql.functions.crc32(col):New in version 1.5.

计算二进制列的循环冗余检查值(CRC32),并将该值作为bigint返回。

>>> sqlContext.createDataFrame([('ABC',)],['a']).select(crc32('a').alias('crc32')).collect()[Row(crc32=2743272264)]

9.34 pyspark.sql.functions.cumeDist():New in version 1.6.

窗口功能:。。注意:在1.6中已弃用,请改用cume_dist。

9.35 pyspark.sql.functions.cume_dist():New in version 1.6.

窗口函数:返回窗口分区内值的累积分布,即当前行以下的行的分数。

9.36 pyspark.sql.functions.current_date():New in version 1.5.

以日期列的形式返回当前日期。

In [530]: tmp.select(current_date()).show()

+--------------+

|current_date()|

+--------------+

|    2020-03-30|

|    2020-03-30|

+--------------+

9.37 pyspark.sql.functions.current_timestamp()

将当前时间戳作为时间戳列返回。

9.38 pyspark.sql.functions.date_add(startdays):New in version 1.5.

返回start后days天的日期

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['d'])

>>> df.select(date_add(df.d,1).alias('d')).collect()[Row(d=datetime.date(2015, 4, 9))]

9.39 pyspark.sql.functions.date_format(dateformat):New in version 1.5.

将日期/时间戳/字符串转换为由第二个参数给定日期格式指定格式的字符串值。

一个模式可能是例如dd.MM.yyyy,可能会返回一个字符串,如“18 .03.1993”。 可以使用Java类java.text.SimpleDateFormat的所有模式字母。

注意:尽可能使用像年份这样的专业功能。 这些受益于专门的实施。

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])>>> df.select(date_format('a','MM/dd/yyy').alias('date')).collect()[Row(date=u'04/08/2015')]

9.40 pyspark.sql.functions.date_sub(startdays):New in version 1.5.

返回start前days天的日期

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['d'])

>>> df.select(date_sub(df.d,1).alias('d')).collect()[Row(d=datetime.date(2015, 4, 7))]

9.42 pyspark.sql.functions.datediff(endstart):New in version 1.5.

返回从start到end的天数。

>>> df=sqlContext.createDataFrame([('2015-04-08','2015-05-10')],['d1','d2'])

>>> df.select(datediff(df.d2,df.d1).alias('diff')).collect()[Row(diff=32)]

9.42 pyspark.sql.functions.dayofmonth(col):New in version 1.5

将给定日期的月份的天解压为整数。

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(dayofmonth('a').alias('day')).collect()[Row(day=8)]

9.43 pyspark.sql.functions.dayofyear(col):New in version 1.5.

将给定日期的年份中的某一天提取为整数。

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(dayofyear('a').alias('day')).collect()[Row(day=98)]

9.44 pyspark.sql.functions.decode(colcharset):New in version 1.5.

使用提供的字符集(US-ASCII、'ISO-8859-1'、'UTF-8'、'UTF-16BE'、'UTF-16LE'、'UTF-16'中的一个)将第一个参数从二进制文件计算为字符串。

9.45 pyspark.sql.functions.denseRank():New in version 1.6.

窗口功能:。。注意:在1.6中已弃用,请用dense_rank。

9.46 pyspark.sql.functions.dense_rank():New in version 1.6.

窗口函数:返回窗口分区内的行的等级,没有任何间隙。

In [544]: window = Window.partitionBy("name").orderBy("age").rowsBetween(-1, 1)

In [545]: tmp.select(dense_rank().over(window))

rank和denseRank的区别在于,当有关系时,denseRank在排序顺序上没有差距。 也就是说,如果你使用密集排名进行比赛,并且有三个人排在第二位,那么你会说所有三个排在第二位,下一个排在第三位。

9.47 pyspark.sql.functions.desc(col):New in version 1.3.

基于给定列名称的降序返回一个排序表达式。

9.48 pyspark.sql.functions.encode(colcharset):New in version 1.5.

使用提供的字符集(‘US-ASCII’, ‘ISO-8859-1’, ‘UTF-8’, ‘UTF-16BE’, ‘UTF-16LE’, ‘UTF-16’之一)将第一个参数从字符串计算为二进制

9.49 pyspark.sql.functions.exp(col):New in version 1.4.

计算指数值。

9.50 pyspark.sql.functions.explode(col):New in version 1.4.

返回给定数组或映射中每个元素的新行。

>>> from pyspark.sqlimport Row

In [551]: eDF=sqlContext.createDataFrame([Row(a=1,intlist=[1,2,3],mapfield={"a":"b"})])

In [552]: eDF.show()

+---+---------+--------+

|  a|  intlist|mapfield|

+---+---------+--------+

|  1|[1, 2, 3]|[a -> b]|

+---+---------+--------+

In [553]:  eDF.select(explode(eDF.intlist).alias("anInt")).collect()

Out[553]: [Row(anInt=1), Row(anInt=2), Row(anInt=3)]

In [554]: eDF.select(explode(eDF.mapfield).alias("key","value")).show()

+---+-----+

|key|value|

+---+-----+

|  a|    b|

+---+-----+

In [563]: eDF.select(explode(eDF.intlist)).show()

+---+

|col|

+---+

|  1|

|  2|

|  3|

+---+

9.51 pyspark.sql.functions.expm1(col):New in version 1.4.

计算给定值的指数减1。

9.52 pyspark.sql.functions.expr(str):New in version 1.5.

Parses the expression string into the column that it represents

In [564]: tmp.select(expr("min(age)")).collect()

Out[564]: [Row(min(age)=1)]

9.53 pyspark.sql.functions.factorial(col):New in version 1.5.

计算给定值的阶乘。

>>> df=sqlContext.createDataFrame([(5,)],['n'])

>>> df.select(factorial(df.n).alias('f')).collect()[Row(f=120)]

9.54 pyspark.sql.functions.first(col):New in version 1.3.

聚合函数:返回组中的第一个值。

9.55 pyspark.sql.functions.floor(col):New in version 1.4.

计算给定值的最小。

9.56 pyspark.sql.functions.format_number(cold):New in version 1.5.

将数字X格式化为像'#, - #, - #.-'这样的格式,四舍五入到小数点后的位置,并以字符串形式返回结果。

参数:●  col – 要格式化的数值的列名称

         ●  d – N小数位

>>> sqlContext.createDataFrame([(5,)],['a']).select(format_number('a',4).alias('v')).collect()[Row(v=u'5.0000')]

9.57 pyspark.sql.functions.format_string(format*cols):New in version 1.5.

以printf样式格式化参数,并将结果作为字符串列返回。

参数:●  format – 要格式化的格式

         ●  cols - 要格式化的列

In [569]: df=sqlContext.createDataFrame([(5,"hello")],['a','b'])

In [570]: df.select(format_string('%d %s',df.a,df.b).alias('v')).collect()

Out[570]: [Row(v=u'5 hello')]

9.58 pyspark.sql.functions.from_unixtime(timestampformat='yyyy-MM-dd HH:mm:ss'):New in version 1.5.

将来自(1970-01-01 00:00:00 UTC)的秒数转换为以给定格式表示当前系统时区中该时刻的时间戳的字符串。

9.59 pyspark.sql.functions.from_utc_timestamp(timestamptz):New in version 1.5.

假设时间戳是UTC,并转换为给定的时区

>>> df=sqlContext.createDataFrame([('1997-02-28 10:30:00',)],['t'])>>> df.select(from_utc_timestamp(df.t,"PST").alias('t')).collect()[Row(t=datetime.datetime(1997, 2, 28, 2, 30))]

9.60 pyspark.sql.functions.get_json_object(colpath):New in version 1.6.

从基于指定的json路径的json字符串中提取json对象,并返回提取的json对象的json字符串。 如果输入的json字符串无效,它将返回null。

参数:●  col – json格式的字符串列

         ●  path – 提取json对象的路径

>>> data=[("1",'''{"f1": "value1", "f2": "value2"}'''),("2",'''{"f1": "value12"}''')]

>>> df=sqlContext.createDataFrame(data,("key","jstring"))

>>>df.select(df.key,get_json_object(df.jstring,'$.f1').alias("c0"),get_json_object(df.jstring,'$.f2').alias("c1")).collect()[Row(key=u'1', c0=u'value1', c1=u'value2'), Row(key=u'2', c0=u'value12', c1=None)]

9.61 pyspark.sql.functions.greatest(*cols):New in version 1.5.

返回列名称列表的最大值,跳过空值。 该功能至少需要2个参数。 如果所有参数都为空,它将返回null

>>> df=sqlContext.createDataFrame([(1,4,3)],['a','b','c'])

>>> df.select(greatest(df.a,df.b,df.c).alias("greatest")).collect()[Row(greatest=4)]

9.62 pyspark.sql.functions.hex(col):New in version 1.5.

计算给定列的十六进制值,可以是StringType,BinaryType,IntegerType或LongType

>>> sqlContext.createDataFrame([('ABC',3)],['a','b']).select(hex('a'),hex('b')).collect()[Row(hex(a)=u'414243', hex(b)=u'3')]

9.63 pyspark.sql.functions.hour(col):New in version 1.5.

将给定日期的小时数提取为整数。

>>> df=sqlContext.createDataFrame([('2015-04-08 13:08:15',)],['a'])>>> df.select(hour('a').alias('hour')).collect()[Row(hour=13)]

9.64 pyspark.sql.functions.hypot(col1col2):New in version 1.4.

计算sqrt(a ^ 2 ^ + b ^ 2 ^),无中间上溢或下溢。

9.65 pyspark.sql.functions.initcap(col):New in version 1.5.

在句子中将每个单词的第一个字母翻译成大写。

>>> sqlContext.createDataFrame([('ab cd',)],['a']).select(initcap("a").alias('v')).collect()[Row(v=u'Ab Cd')]

9.66 pyspark.sql.functions.input_file_name():New in version 1.6.

为当前Spark任务的文件名创建一个字符串列。

9.67 pyspark.sql.functions.instr(strsubstr):New in version 1.5.

找到给定字符串中第一次出现substr列的位置。 如果其中任一参数为null,则返回null。

注:位置不是从零开始的,但是基于1的索引,如果在str中找不到substr,则返回0。

>>> df=sqlContext.createDataFrame([('abcd',)],['s',])

>>> df.select(instr(df.s,'b').alias('s')).collect()[Row(s=2)]

9.68 pyspark.sql.functions.isnan(col):New in version 1.6.

如果列是NaN,则返回true的表达式。

>>> df=sqlContext.createDataFrame([(1.0,float('nan')),(float('nan'),2.0)],("a","b"))

>>> df.select(isnan("a").alias("r1"),isnan(df.a).alias("r2")).collect()[Row(r1=False, r2=False), Row(r1=True, r2=True)]

9.69 pyspark.sql.functions.isnull(col):New in version 1.6.

如果列为null,则返回true的表达式

>>> df=sqlContext.createDataFrame([(1,None),(None,2)],("a","b"))

>>> df.select(isnull("a").alias("r1"),isnull(df.a).alias("r2")).collect()[Row(r1=False, r2=False), Row(r1=True, r2=True)]

9.70 pyspark.sql.functions.json_tuple(col*fields):New in version 1.6.

根据给定的字段名称为json列创建一个新行。

参数:●  col – json格式的字符串列

 ●  fields – 要提取的字段列表

>>> data=[("1",'''{"f1": "value1", "f2": "value2"}'''),("2",'''{"f1": "value12"}''')]

>>> df=sqlContext.createDataFrame(data,("key","jstring"))

>>> df.select(df.key,json_tuple(df.jstring,'f1','f2')).collect()[Row(key=u'1', c0=u'value1', c1=u'value2'), Row(key=u'2', c0=u'value12', c1=None)]

9.71 pyspark.sql.functions.kurtosis(col):New in version 1.6.

聚合函数:返回组中的值的峰度。

9.72 pyspark.sql.functions.lag(colcount=1default=None):New in version 1.4.

窗口函数:返回当前行之前偏移行的值;如果当前行之前的行数小于偏移量,则返回defaultValue。 例如,一个偏移量将返回窗口分区中任何给定点的前一行。

这相当于SQL中的LAG函数。

参数:●  col – 列或表达式的名称

         ●  count – 要延伸的行数

        ●  default – 默认值

9.73 pyspark.sql.functions.last(col):New in version 1.3.

聚合函数:返回组中的最后一个值。

9.74 pyspark.sql.functions.last_day(date):New in version 1.5.

返回给定日期所属月份的最后一天。

>>> df=sqlContext.createDataFrame([('1997-02-10',)],['d'])

>>> df.select(last_day(df.d).alias('date')).collect()[Row(date=datetime.date(1997, 2, 28))]

9.75 pyspark.sql.functions.lead(colcount=1default=None):New in version 1.4.

Window函数:返回当前行之后偏移行的值;如果当前行之后的行数小于偏移行,则返回defaultValue。 例如,一个偏移量将返回窗口分区中任意给定点的下一行。

这相当于SQL中的LEAD函数。

参数:●  col – 列或表达式的名称

         ●  count – 要延伸的行数

         ●  default – 默认值

9.76 pyspark.sql.functions.least(*cols):New in version 1.5.

返回列名称列表的最小值,跳过空值。 该功能至少需要2个参数。 如果所有参数都为空,它将返回null

>>> df=sqlContext.createDataFrame([(1,4,3)],['a','b','c'])

>>> df.select(least(df.a,df.b,df.c).alias("least")).collect()[Row(least=1)]

9.77 pyspark.sql.functions.length(col):New in version 1.5.

计算字符串或二进制表达式的长度

>>> sqlContext.createDataFrame([('ABC',)],['a']).select(length('a').alias('length')).collect()

[Row(length=3)]

9.78 pyspark.sql.functions.levenshtein(leftright):New in version 1.5.

计算两个给定字符串的Levenshtein距离。

>>> df0=sqlContext.createDataFrame([('kitten','sitting',)],['l','r'])

>>> df0.select(levenshtein('l','r').alias('d')).collect()[Row(d=3)]

9.79 pyspark.sql.functions.lit(col):New in version 1.3.

创建一个文字值的列

9.80 pyspark.sql.functions.locate(substrstrpos=0):New in version 1.5.

找到第一个出现的位置在位置pos后面的字符串列中。

注:位置不是从零开始,而是从1开始。 如果在str中找不到substr,则返回0。

参数: substr – 一个字符串

         str – 一个StringType的列

         pos – 起始位置(基于零)

>>> df=sqlContext.createDataFrame([('abcd',)],['s',])

>>> df.select(locate('b',df.s,1).alias('s')).collect()[Row(s=2)]

9.81 pyspark.sql.functions.log(arg1arg2=None):New in version 1.5.

返回第二个参数的第一个基于参数的对数。

如果只有一个参数,那么这个参数就是自然对数

>>> df.select(log(10.0,df.age).alias('ten')).map(lambdal:str(l.ten)[:7]).collect()['0.30102', '0.69897']

>>> df.select(log(df.age).alias('e')).map(lambdal:str(l.e)[:7]).collect()['0.69314', '1.60943']

9.82 pyspark.sql.functions.log10(col):New in version 1.4.

计算Base 10中给定值的对数。

9.83 pyspark.sql.functions.log1p(col):New in version 1.4.

计算给定值的自然对数加1。

9.84 pyspark.sql.functions.log2(col):New in version 1.5.

返回参数的基数为2的对数。

>>> sqlContext.createDataFrame([(4,)],['a']).select(log2('a').alias('log2')).collect()[Row(log2=2.0)]

9.85 pyspark.sql.functions.lower(col):New in version 1.5.

将字符串列转换为小写。

9.86 pyspark.sql.functions.lpad(collenpad):New in version 1.5.

用pad填充字符串列的宽度len

>>> df=sqlContext.createDataFrame([('abcd',)],['s',])

>>> df.select(lpad(df.s,6,'#').alias('s')).collect()[Row(s=u'##abcd')]

9.87 pyspark.sql.functions.ltrim(col):New in version 1.5.

从左端修剪指定字符串值的空格。

9.88 pyspark.sql.functions.max(col):New in version 1.3.

聚合函数:返回组中表达式的最大值。

9.89 pyspark.sql.functions.md5(col):New in version 1.5.

计算MD5摘要并以32个字符的十六进制字符串的形式返回值。

>>> sqlContext.createDataFrame([('ABC',)],['a']).select(md5('a').alias('hash')).collect()[Row(hash=u'902fbdd2b1df0c4f70b4a5d23525e932')]

9.90 pyspark.sql.functions.mean(col):New in version 1.3.

聚合函数:返回组中的值的平均值

9.91 pyspark.sql.functions.min(col):New in version 1.3.

聚合函数:返回组中表达式的最小值。

9.92 pyspark.sql.functions.minute(col):New in version 1.5.

提取给定日期的分钟数为整数

>>> df=sqlContext.createDataFrame([('2015-04-08 13:08:15',)],['a'])

>>> df.select(minute('a').alias('minute')).collect()[Row(minute=8)]

9.92 pyspark.sql.functions.monotonicallyIncreasingId():New in version 1.4.

注意在1.6中不推荐使用monotonically_increasing_id

9.93 pyspark.sql.functions.monotonically_increasing_id():New in version 1.6.

生成单调递增的64位整数的列。

生成的ID保证是单调递增和唯一的,但不是连续的。 当前的实现将分区ID放在高31位,并将每个分区内的记录号放在低33位。 假设

dataframe 的分区少于10亿个,每个分区少于80亿条记录

例如,考虑一个DataFrame有两个分区,每个分区有三个记录。 该表达式将返回以下ID:0,1,2,8589934592(1L << 33),

8589934593,8589934594

>>> df0=sc.parallelize(range(2),2).mapPartitions(lambdax:[(1,),(2,),(3,)]).toDF(['col1'])>>> df0.select(monotonically_increasing_id().alias('id')).collect()[Row(id=0), Row(id=1), Row(id=2), Row(id=8589934592), Row(id=8589934593), Row(id=8589934594)]

9.94 pyspark.sql.functions.month(col):New in version 1.5.

将给定日期的月份提取为整数

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(month('a').alias('month')).collect()[Row(month=4)]

9.95 pyspark.sql.functions.months_between(date1date2):New in version 1.5.

返回date1和date2之间的月数。

>>> df=sqlContext.createDataFrame([('1997-02-28 10:30:00','1996-10-30')],['t','d'])

>>> df.select(months_between(df.t,df.d).alias('months')).collect()[Row(months=3.9495967...)]

9.96 pyspark.sql.functions.nanvl(col1col2):New in version 1.6.

如果不是NaN,则返回col1;如果col1是NaN,则返回col2

两个输入都应该是浮点列(DoubleType或FloatType)

Both inputs should be floating point columns (DoubleType or FloatType).

>>> df=sqlContext.createDataFrame([(1.0,float('nan')),(float('nan'),2.0)],("a","b"))>>> df.select(nanvl("a","b").alias("r1"),nanvl(df.a,df.b).alias("r2")).collect()[Row(r1=1.0, r2=1.0), Row(r1=2.0, r2=2.0)]

9.97 pyspark.sql.functions.next_day(datedayOfWeek):New in version 1.5.

返回晚于日期列值的第一个日期

星期几参数不区分大小写,并接受:“Mon”, “Tue”, “Wed”, “Thu”, “Fri”, “Sat”, “Sun”.

>>> df=sqlContext.createDataFrame([('2015-07-27',)],['d'])

>>> df.select(next_day(df.d,'Sun').alias('date')).collect()[Row(date=datetime.date(2015, 8, 2))]

9.98 pyspark.sql.functions.ntile(n):New in version 1.4.

窗口函数:在有序的窗口分区中返回ntile组ID(从1到n)。 例如,如果n是4,则第一季度行将得到值1,第二季度将得到2,第三季度将得到3,并且最后一个季度将得到4。

这相当于SQL中的NTILE函数。

9.99 pyspark.sql.functions.percentRank():New in version 1.6.

窗口函数:.. note ::在1.6中不推荐使用,而是使用percent_rank

9.100 pyspark.sql.functions.percent_rank():New in version 1.6.

窗口函数:返回窗口分区内行的相对等级(即百分位数)

9.101 pyspark.sql.functions.pow(col1col2):New in version 1.4.

返回第一个参数的第二个参数的次方。pow(23) 2**3

9.102 pyspark.sql.functions.quarter(col):New in version 1.5.

提取给定日期的四分之一整数

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(quarter('a').alias('quarter')).collect()[Row(quarter=2)]

9.103 pyspark.sql.functions.rand(seed=None):New in version 1.4.

用i.i.d生成一个随机列 来自U的样本[0.0,1.0]。

9.104 pyspark.sql.functions.randn(seed=None):New in version 1.4.

用i.i.d生成一列 来自标准正态分布的样本。

9.105 pyspark.sql.functions.rank():New in version 1.6.

窗口函数:返回窗口分区内的行的等级

rank和denseRank的区别在于,当有关系时,denseRank在排序顺序上没有差距。 也就是说,如果你使用密集排名进行比赛,并且有

三个人排在第二位,那么你会说所有三个排在第二位,下一个排在第三位。

这相当于SQL中的RANK函数。

9.106 pyspark.sql.functions.regexp_extract(strpatternidx):New in version 1.5.

从指定的字符串列中提取由java正则表达式标识的特定(idx)组

>>> df=sqlContext.createDataFrame([('100-200',)],['str'])

>>> df.select(regexp_extract('str','(\d+)-(\d+)',1).alias('d')).collect()[Row(d=u'100')]

9.107 pyspark.sql.functions.regexp_replace(strpatternreplacement):New in version 1.5.

将与regexp匹配的指定字符串值的所有子字符串替换为rep

>>> df=sqlContext.createDataFrame([('100-200',)],['str'])

>>> df.select(regexp_replace('str','(\d+)','--').alias('d')).collect()[Row(d=u'-----')]

9.108 pyspark.sql.functions.repeat(coln):New in version 1.5.

重复一个字符串列n次,并将其作为新的字符串列返回

>>> df=sqlContext.createDataFrame([('ab',)],['s',])>>> df.select(repeat(df.s,3).alias('s')).collect()[Row(s=u'ababab')]

9.109 pyspark.sql.functions.reverse(col):New in version 1.5.

反转字符串列并将其作为新的字符串列返回

9.110 pyspark.sql.functions.rint(col):New in version 1.4.

返回值最接近参数的double值,等于一个数学整数。

9.111 pyspark.sql.functions.round(colscale=0):New in version 1.5.

如果scale> = 0,将e的值舍入为小数点的位数,或者在scale <0的时候将其舍入到整数部分。

>>> sqlContext.createDataFrame([(2.546,)],['a']).select(round('a',1).alias('r')).collect()[Row(r=2.5)]

9.112 pyspark.sql.functions.rowNumber():New in version 1.6.

窗口函数:.. note:1.6中不推荐使用,而是使用row_number

9.113 pyspark.sql.functions.row_number():New in version 1.6.

窗口函数:返回窗口分区内从1开始的连续编号。

9.114 pyspark.sql.functions.rpad(collenpad):New in version 1.5.

右键将字符串列填充到宽度为len的pad

>>> df=sqlContext.createDataFrame([('abcd',)],['s',])

>>> df.select(rpad(df.s,6,'#').alias('s')).collect()[Row(s=u'abcd##')]

9.115 pyspark.sql.functions.rtrim(col):New in version 1.5.

从右端修剪指定字符串值的空格

9.116 pyspark.sql.functions.second(col):New in version 1.5.

将给定日期的秒数提取为整数

>>> df=sqlContext.createDataFrame([('2015-04-08 13:08:15',)],['a'])>>> df.select(second('a').alias('second')).collect()[Row(second=15)]

9.117 pyspark.sql.functions.sha1(col):New in version 1.5.

返回SHA-1的十六进制字符串结果

>>> sqlContext.createDataFrame([('ABC',)],['a']).select(sha1('a').alias('hash')).collect()[Row(hash=u'3c01bdbb26f358bab27f267924aa2c9a03fcfdb8')]

9.118 pyspark.sql.functions.sha2(colnumBits):New in version 1.5.

返回SHA-2系列散列函数(SHA-224,SHA-256,SHA-384和SHA-512)的十六进制字符串结果。 numBits表示结果的所需位长度,其值

必须为224,256,384,512或0(相当于256)

>>> digests=df.select(sha2(df.name,256).alias('s')).collect()>>> digests[0]Row(s=u'3bc51062973c458d5a6f2d8d64a023246354ad7e064b1e4e009ec8a0699a3043')>>> digests[1]Row(s=u'cd9fb1e148ccd8442e5aa74904cc73bf6fb54d1d54d333bd596aa9bb4bb4e961')

9.119 pyspark.sql.functions.shiftLeft(colnumBits):New in version 1.5.

移动给定值numBits左侧

>>> sqlContext.createDataFrame([(21,)],['a']).select(shiftLeft('a',1).alias('r')).collect()[Row(r=42)]

9.120 pyspark.sql.functions.shiftRight(colnumBits):New in version 1.5.

将给定值numBits右移

>>> sqlContext.createDataFrame([(42,)],['a']).select(shiftRight('a',1).alias('r')).collect()[Row(r=21)]

9.121 pyspark.sql.functions.shiftRightUnsigned(colnumBits):New in version 1.5.

无符号移位给定值numBits的权利

>>> df=sqlContext.createDataFrame([(-42,)],['a'])>>> df.select(shiftRightUnsigned('a',1).alias('r')).collect()[Row(r=9223372036854775787)]

9.122 pyspark.sql.functions.signum(col):New in version 1.4.

计算给定值的符号

9.123 pyspark.sql.functions.sin(col):New in version 1.4.

计算给定值的正弦值

9.124 pyspark.sql.functions.sinh(col):New in version 1.4.

 计算给定值的双曲正弦值

9.125 pyspark.sql.functions.size(col):New in version 1.5.

集合函数:返回存储在列中的数组或映射的长度

参数:col – 列或表达式名称

>>> df=sqlContext.createDataFrame([([1,2,3],),([1],),([],)],['data'])

>>> df.select(size(df.data)).collect()[Row(size(data)=3), Row(size(data)=1), Row(size(data)=0)]

9.126 pyspark.sql.functions.skewness(col):New in version 1.6.

聚合函数:返回组中值的偏度

9.127 pyspark.sql.functions.sort_array(colasc=True):New in version 1.5.

集合函数:按升序对给定列的输入数组进行排序。

参数:col – 列或表达式名称

>>> df=sqlContext.createDataFrame([([2,1,3],),([1],),([],)],['data'])

>>> df.select(sort_array(df.data).alias('r')).collect()[Row(r=[1, 2, 3]), Row(r=[1]), Row(r=[])]

>>> df.select(sort_array(df.data,asc=False).alias('r')).collect()[Row(r=[3, 2, 1]), Row(r=[1]), Row(r=[])]

9.128 pyspark.sql.functions.soundex(col):New in version 1.5.

返回字符串的SoundEx编码

>>> df=sqlContext.createDataFrame([("Peters",),("Uhrbach",)],['name'])

>>> df.select(soundex(df.name).alias("soundex")).collect()[Row(soundex=u'P362'), Row(soundex=u'U612')]

9.129 pyspark.sql.functions.sparkPartitionId():New in version 1.4.

注意在1.6中不推荐使用spark_partition_id。

9.130 pyspark.sql.functions.spark_partition_id():New in version 1.6.

Spark任务的分区ID列

请注意,这是不确定的,因为它取决于数据分区和任务调度

>>> df.repartition(1).select(spark_partition_id().alias("pid")).collect()[Row(pid=0), Row(pid=0)]

9.131 pyspark.sql.functions.split(strpattern):New in version 1.5.

将模式分割(模式是正则表达式)。

注:pattern是一个字符串表示正则表达式。

>>> df=sqlContext.createDataFrame([('ab12cd',)],['s',])

>>> df.select(split(df.s,'[0-9]+').alias('s')).collect()[Row(s=[u'ab', u'cd'])]

9.132 pyspark.sql.functions.sqrt(col):New in version 1.3.

计算指定浮点值的平方根

9.133 pyspark.sql.functions.stddev(col):New in version 1.6.

聚合函数:返回组中表达式的无偏样本标准差

9.134 pyspark.sql.functions.stddev_pop(col):New in version 1.6.

聚合函数:返回一个组中表达式的总体标准差

9.135 pyspark.sql.functions.stddev_samp(col):New in version 1.6.

聚合函数:返回组中表达式的无偏样本标准差

9.136 pyspark.sql.functions.struct(*cols):New in version 1.4.

创建一个新的结构列。

列:cols – 列名称(字符串)列表或列表达式列表

>>> df.select(struct('age','name').alias("struct")).collect()[Row(struct=Row(age=2, name=u'Alice')), Row(struct=Row(age=5, name=u'Bob'))]

>>> df.select(struct([df.age,df.name]).alias("struct")).collect()[Row(struct=Row(age=2, name=u'Alice')), Row(struct=Row(age=5, name=u'Bob'))]

9.137 pyspark.sql.functions.substring(strposlen):New in version 1.5.

子字符串从pos开始,长度为len,当str是字符串类型时,或者返回从字节pos开始的字节数组的片段,当str是二进制类型时,长度

>>> df=sqlContext.createDataFrame([('abcd',)],['s',])>>> df.select(substring(df.s,1,2).alias('s')).collect()[Row(s=u'ab')]

9.138 pyspark.sql.functions.substring_index(strdelimcount):New in version 1.5.

在计数定界符delimiter之前,返回字符串str的子串。 如果count是正数,则返回最后一个分隔符左边的数字(从左数起)。 如果计数为负数,则返回最后一个分隔符右边的数字(从右数起)。 substring_index搜索delim时执行区分大小写的匹配

>>> df=sqlContext.createDataFrame([('a.b.c.d',)],['s'])

>>> df.select(substring_index(df.s,'.',2).alias('s')).collect()[Row(s=u'a.b')]

>>> df.select(substring_index(df.s,'.',-3).alias('s')).collect()[Row(s=u'b.c.d')]

9.139 pyspark.sql.functions.sum(col):New in version 1.3.

聚合函数:返回表达式中所有值的总和。

9.140 pyspark.sql.functions.sumDistinct(col):New in version 1.3.

聚合函数:返回表达式中不同值的总和

9.141 pyspark.sql.functions.tan(col):New in version 1.4.

计算给定值的正切值

9.142 pyspark.sql.functions.tanh(col):New in version 1.4.

计算给定值的双曲正切

9.143 pyspark.sql.functions.toDegrees(col)

Converts an angle measured in radians to an approximately equivalent angle measured in degrees.

New in version 1.4.

9.144 pyspark.sql.functions.toRadians(col):New in version 1.4.

将以弧度度量的角度转换为以度数度量的近似等效角度。

9.145 pyspark.sql.functions.to_date(col)[source]

将StringType或TimestampType的列转换为DateType

>>> df=sqlContext.createDataFrame([('1997-02-28 10:30:00',)],['t'])>>> df.select(to_date(df.t).alias('date')).collect()[Row(date=datetime.date(1997, 2, 28))]

New in version 1.5.

9.146 pyspark.sql.functions.to_utc_timestamp(timestamptz):New in version 1.5.

假定给定的时间戳在给定的时区并转换为UTC

>>> df=sqlContext.createDataFrame([('1997-02-28 10:30:00',)],['t'])

>>> df.select(to_utc_timestamp(df.t,"PST").alias('t')).collect()[Row(t=datetime.datetime(1997, 2, 28, 18, 30))]

9.147 pyspark.sql.functions.translate(srcColmatchingreplace):New in version 1.5.

一个函数通过匹配的字符转换srcCol中的任何字符。 替换中的字符对应于匹配的字符。当字符串中的任何字符与匹配中的字符匹配时,翻译将发生

>>> sqlContext.createDataFrame([('translate',)],['a']).select(translate('a',"rnlt","123").alias('r')).collect()[Row(r=u'1a2s3ae')]

9.148 pyspark.sql.functions.trim(col):New in version 1.5.

修剪指定字符串列的两端空格。

9.149 pyspark.sql.functions.trunc(dateformat):New in version 1.5.

返回截断到格式指定单位的日期

参数: format – ‘year’, ‘YYYY’, ‘yy’ or ‘month’, ‘mon’, ‘mm’

>>> df=sqlContext.createDataFrame([('1997-02-28',)],['d'])

>>> df.select(trunc(df.d,'year').alias('year')).collect()[Row(year=datetime.date(1997, 1, 1))]

>>> df.select(trunc(df.d,'mon').alias('month')).collect()[Row(month=datetime.date(1997, 2, 1))]

9.150 pyspark.sql.functions.udf(freturnType=StringType):New in version 1.3.

创建一个表示用户定义函数(UDF)的列表达式。

>>> frompyspark.sql.typesimportIntegerType

>>> slen=udf(lambdas:len(s),IntegerType())

>>> df.select(slen(df.name).alias('slen')).collect()[Row(slen=5), Row(slen=3)]

9.151 pyspark.sql.functions.unbase64(col):New in version 1.5.

解码BASE64编码的字符串列并将其作为二进制列返回

9.152 pyspark.sql.functions.unhex(col):New in version 1.5.

十六进制的反转。 将每对字符解释为十六进制数字,并转换为数字的字节表示形式

>>> sqlContext.createDataFrame([('414243',)],['a']).select(unhex('a')).collect()[Row(unhex(a)=bytearray(b'ABC'))]

9.153 pyspark.sql.functions.unix_timestamp(timestamp=Noneformat='yyyy-MM-dd HH:mm:ss'):New in version 1.5.

使用默认时区和默认语言环境,将具有给定模式的时间字符串(默认为'yyyy-MM-dd HH:mm:ss')转换为Unix时间戳(以秒为单位),如果失败则返回null。如果时间戳记为“无”,则返回当前时间戳。

9.154 pyspark.sql.functions.upper(col):New in version 1.5.

将字符串列转换为大写

9.155 pyspark.sql.functions.var_pop(col):New in version 1.6.

聚合函数:返回组中值的总体方差

9.156 pyspark.sql.functions.var_samp(col):New in version 1.6.

聚合函数:返回组中值的无偏差

9.157 pyspark.sql.functions.variance(col):New in version 1.6.

聚合函数:返回组中值的总体方差

9.158 pyspark.sql.functions.weekofyear(col):New in version 1.5.

将一个给定日期的星期数解压为整数。

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(weekofyear(df.a).alias('week')).collect()[Row(week=15)]

9.159 pyspark.sql.functions.when(conditionvalue):New in version 1.4.

评估条件列表并返回多个可能的结果表达式之一。 如果不调用Column.otherwise(),则不匹配条件返回None

参数:condition – 一个布尔的列表达式.

value – 一个文字值或一个Column表达式

>>> df.select(when(df['age']==2,3).otherwise(4).alias("age")).collect()[Row(age=3), Row(age=4)]

>>> df.select(when(df.age==2,df.age+1).alias("age")).collect()[Row(age=3), Row(age=None)]

9.160 pyspark.sql.functions.year(col):New in version 1.5.

将给定日期的年份提取为整数

>>> df=sqlContext.createDataFrame([('2015-04-08',)],['a'])

>>> df.select(year('a').alias('year')).collect()[Row(year=2015)]

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,045评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,114评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,120评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,902评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,828评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,132评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,590评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,258评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,408评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,335评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,385评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,068评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,660评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,747评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,967评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,406评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,970评论 2 341

推荐阅读更多精彩内容