trait ExpressionDescription extends Annotation
- Annotations
- @DeveloperApi() @Retention()
- Alphabetic
- By Inheritance
- ExpressionDescription
- Annotation
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Abstract Value Members
- abstract def annotationType(): Class[_ <: Annotation]
- Definition Classes
- Annotation
- abstract def arguments(): String
- Annotations
- @AnnotationDefault()
- abstract def deprecated(): String
- Annotations
- @AnnotationDefault()
- abstract def examples(): String
- Annotations
- @AnnotationDefault()
- abstract def group(): String
Valid group names are almost the same with one defined as
groupnameinsql/functions.scala.Valid group names are almost the same with one defined as
groupnameinsql/functions.scala. But,collection_funcsis split into fine-grained three groups:array_funcs,map_funcs, andjson_funcs. SeeExpressionInfofor the detailed group names.- Annotations
- @AnnotationDefault()
- abstract def note(): String
- Annotations
- @AnnotationDefault()
- abstract def since(): String
- Annotations
- @AnnotationDefault()
- abstract def source(): String
- Annotations
- @AnnotationDefault()
- abstract def usage(): String
::DeveloperApi::
::DeveloperApi::
A function description type which can be recognized by FunctionRegistry, and will be used to show the usage of the function in human language.
usage()will be used for the function usage in brief way.These below are concatenated and used for the function usage in verbose way, suppose arguments, examples, note, group, source, since and deprecated will be provided.
arguments()describes arguments for the expression.examples()describes examples for the expression.note()contains some notes for the expression optionally.group()describes the category that the expression belongs to. The valid value is "agg_funcs", "array_funcs", "datetime_funcs", "json_funcs", "map_funcs" and "window_funcs".source()describe the source of the function. The valid value is "built-in", "hive", "python_udf", "scala_udf", "java_udf".since()contains version information for the expression. Version is specified by, for example, "2.2.0".deprecated()contains deprecation information for the expression optionally, for example, "Deprecated since 2.2.0. Use something else instead".The format, in particular for
arguments(),examples(),note(),group(),source(),since()anddeprecated(), should strictly be as follows.@ExpressionDescription( ... arguments = """ Arguments: * arg0 - ... .... * arg1 - ... .... """, examples = """ Examples: > SELECT ...; ... > SELECT ...; ... """, note = """ ... """, group = "agg_funcs", source = "built-in", since = "3.0.0", deprecated = """ ... """)We can refer the function name by
_FUNC_, inusage(),arguments(),examples()andnote()as it is registered inFunctionRegistry.Note that, if
extended()is defined,arguments(),examples(),note(),group(),since()anddeprecated()should be not defined together.extended()exists for backward compatibility.Note this contents are used in the SparkSQL documentation for built-in functions. The contents here are considered as a Markdown text and then rendered.
- Annotations
- @AnnotationDefault()
- abstract def extended(): String
- Annotations
- @Deprecated @AnnotationDefault()
- Deprecated
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()