[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16174514#comment-16174514 ] Liang-Chi Hsieh commented on SPARK-21653: - I just go through all SQL expressions. Looks like we have expression description for them now, except for CASE WHEN, if I don't miss any of SQL expressions. I created a trivial ticket for CASE WHEN. > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > We have {{ExpressionDescription}} for SQL expressions. The expression > description tells what an expression's usage, arguments, and examples. Users > can understand how to use those expressions by {{DESCRIBE}} command in SQL: > {code} > spark-sql> DESCRIBE FUNCTION EXTENDED In; > Function: in > Class: org.apache.spark.sql.catalyst.expressions.In > Usage: expr1 in(expr2, expr3, ...) - Returns true if `expr` equals to any > valN. > Extended Usage: > No example/argument for in. > {code} > Not all SQL expressions have complete description now. For example, in the > above case, there is no example for function {{in}}. This task is going to > complement the expression description. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116324#comment-16116324 ] Hyukjin Kwon commented on SPARK-21653: -- Yes, there was some discussion for adding arguments in my PR. I am still fond of describing arguments as long as they look mostly correct in general and the examples produce the expected results because these are some information that did not exist before and we now generate documentation for SQL builtin functions. I am willing to push this if there are no strong objections now. > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > We have {{ExpressionDescription}} for SQL expressions. The expression > description tells what an expression's usage, arguments, and examples. Users > can understand how to use those expressions by {{DESCRIBE}} command in SQL: > {code} > spark-sql> DESCRIBE FUNCTION EXTENDED In; > Function: in > Class: org.apache.spark.sql.catalyst.expressions.In > Usage: expr1 in(expr2, expr3, ...) - Returns true if `expr` equals to any > valN. > Extended Usage: > No example/argument for in. > {code} > Not all SQL expressions have complete description now. For example, in the > above case, there is no example for function {{in}}. This task is going to > complement the expression description. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116282#comment-16116282 ] Liang-Chi Hsieh commented on SPARK-21653: - [~hyukjin.kwon] oh, yeah, looks like it's. As SPARK-17963 titled as "Add examples (extend) in each expression", I'm not sure if we intentionally leave the expressions without detailed description? > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > We have {{ExpressionDescription}} for SQL expressions. The expression > description tells what an expression's usage, arguments, and examples. Users > can understand how to use those expressions by {{DESCRIBE}} command in SQL: > {code} > spark-sql> DESCRIBE FUNCTION EXTENDED In; > Function: in > Class: org.apache.spark.sql.catalyst.expressions.In > Usage: expr1 in(expr2, expr3, ...) - Returns true if `expr` equals to any > valN. > Extended Usage: > No example/argument for in. > {code} > Not all SQL expressions have complete description now. For example, in the > above case, there is no example for function {{in}}. This task is going to > complement the expression description. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116275#comment-16116275 ] Hyukjin Kwon commented on SPARK-21653: -- BTW, sounds including SPARK-18411 and looks related with SPARK-17963. > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > We have {{ExpressionDescription}} for SQL expressions. The expression > description tells what an expression's usage, arguments, and examples. Users > can understand how to use those expressions by {{DESCRIBE}} command in SQL: > {code} > spark-sql> DESCRIBE FUNCTION EXTENDED In; > Function: in > Class: org.apache.spark.sql.catalyst.expressions.In > Usage: expr1 in(expr2, expr3, ...) - Returns true if `expr` equals to any > valN. > Extended Usage: > No example/argument for in. > {code} > Not all SQL expressions have complete description now. For example, in the > above case, there is no example for function {{in}}. This task is going to > complement the expression description. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116241#comment-16116241 ] Liang-Chi Hsieh commented on SPARK-21653: - [~sowen] I made a detailed description now for this. Is it clear now for you? > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > We have {{ExpressionDescription}} for SQL expressions. The expression > description tells what an expression's usage, arguments, and examples. Users > can understand how to use those expressions by {{DESCRIBE}} command in SQL: > {code} > spark-sql> DESCRIBE FUNCTION EXTENDED In; > Function: in > Class: org.apache.spark.sql.catalyst.expressions.In > Usage: expr1 in(expr2, expr3, ...) - Returns true if `expr` equals to any > valN. > Extended Usage: > No example/argument for in. > {code} > Not all SQL expressions have complete description now. For example, in the > above case, there is no example for function {{in}}. This task is going to > complement the expression description. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116232#comment-16116232 ] Liang-Chi Hsieh commented on SPARK-21653: - We have {{ExpressionDescription}} for SQL expressions. Not all SQL expressions have complete description now. This task is going to complement the expression description. > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > The SQL expression description is not complete now. We should complement the > expression doc. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org
[jira] [Commented] (SPARK-21653) Complement SQL expression document
[ https://issues.apache.org/jira/browse/SPARK-21653?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16116224#comment-16116224 ] Sean Owen commented on SPARK-21653: --- Before continuing, can you please describe what this means? > Complement SQL expression document > -- > > Key: SPARK-21653 > URL: https://issues.apache.org/jira/browse/SPARK-21653 > Project: Spark > Issue Type: Umbrella > Components: SQL >Affects Versions: 2.2.0 >Reporter: Liang-Chi Hsieh > > The SQL expression description is not complete now. We should complement the > expression doc. -- This message was sent by Atlassian JIRA (v6.4.14#64029) - To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org