You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shardingsphere.apache.org by GitBox <gi...@apache.org> on 2022/10/17 11:10:32 UTC

[GitHub] [shardingsphere] tianhao960 opened a new issue, #21616: tools to generate railroad diagrams for sql statment

tianhao960 opened a new issue, #21616:
URL: https://github.com/apache/shardingsphere/issues/21616

   ## Feature Request
   
   ### Is your feature request related to a problem?
   no
   
   ### Describe the feature you would like.
    railroad diagrams could show the possible options for a SQL statement as below. 
   Compared to text representation, the visual diagrams give users an intuitive way to explore the grammar and discover features.
   
   and we can develop a tool to generate the diagram and put it to the docs, that's will helpful.
   
   ![image](https://user-images.githubusercontent.com/1155952/196162406-9113666d-2010-4412-877d-c9f5da252156.png)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [shardingsphere] strongduanmu commented on issue #21616: tools to generate railroad diagrams for sql statment

Posted by GitBox <gi...@apache.org>.
strongduanmu commented on issue #21616:
URL: https://github.com/apache/shardingsphere/issues/21616#issuecomment-1280693496

   Looks cool, let's start it.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [shardingsphere] mlycore commented on issue #21616: tools to generate railroad diagrams for sql statment

Posted by "mlycore (via GitHub)" <gi...@apache.org>.
mlycore commented on issue #21616:
URL: https://github.com/apache/shardingsphere/issues/21616#issuecomment-1407683798

   Agree with @TeslaCN and @RaigorJiang . IMO, since there is already provided railway diagrams for DistSQL, we should make it clear that if there are some differences with this enhancement.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [shardingsphere] RaigorJiang commented on issue #21616: tools to generate railroad diagrams for sql statment

Posted by "RaigorJiang (via GitHub)" <gi...@apache.org>.
RaigorJiang commented on issue #21616:
URL: https://github.com/apache/shardingsphere/issues/21616#issuecomment-1407548754

   I agree with @TeslaCN , ShardingSphere does not need to provide syntax descriptions for the multiple supported dialects.
   ShardingSphere has its own DistSQL, and we also added a railroad diagram for the DistSQL syntax, please refer to https://shardingsphere.apache.org/document/current/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/register-storage-unit/


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [shardingsphere] strongduanmu commented on issue #21616: tools to generate railroad diagrams for sql statment

Posted by "strongduanmu (via GitHub)" <gi...@apache.org>.
strongduanmu commented on issue #21616:
URL: https://github.com/apache/shardingsphere/issues/21616#issuecomment-1407901218

   I think this work is meaningful. A mature distributed database should be able to describe the range of syntax it supports. For example, cockroachdb and tidb are compatible with postgresql and mysql, but they also provide sql syntax railway diagrams.
   
   PostgreSQL sql grammar - https://www.cockroachlabs.com/docs/stable/sql-grammar.html.
   TiDB sql grammar - https://docs.pingcap.com/zh/tidb/stable/sql-statement-add-column.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [shardingsphere] TeslaCN commented on issue #21616: tools to generate railroad diagrams for sql statment

Posted by GitBox <gi...@apache.org>.
TeslaCN commented on issue #21616:
URL: https://github.com/apache/shardingsphere/issues/21616#issuecomment-1381173082

   Do we really need MySQL syntax in our documents? I think users will not learn usage of MySQL from ShardingSphere.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@shardingsphere.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org