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

   # Background
   Hi community,
   This issue is for #26878.
   
   ShardingSphere parser engine helps users parse a SQL to get the AST 
(Abstract Syntax Tree) and visit this tree to get SQLStatement (Java Object). 
Currently, we are planning to enhance the support for Oracle SQL parsing in 
ShardingSphere.
   
   More details:
   
https://shardingsphere.apache.org/document/current/en/reference/sharding/parse/
   
   # Task
   This issue is to support more oracle sql parse, as follows:
   ```sql
   SET SERVEROUTPUT ON
   DECLARE
      agent            sys.aq$_agent;
      test_agent_list  DBMS_AQ.aq$_agent_list_t;
   BEGIN
      test_agent_list(1) := sys.aq$_agent(NULL, 'test.obj_queue',  NULL);
      test_agent_list(2) := sys.aq$_agent(NULL, 'test.priority_queue', NULL);
      DBMS_AQ.LISTEN(
         agent_list   =>   test_agent_list, 
         wait         =>   0, 
         agent        =>   agent);
      DBMS_OUTPUT.PUT_LINE('Message in Queue: ' ||  agent.address);
   END;
   ```
   
   ```sql
   SET SERVEROUTPUT ON
   DECLARE
      dequeue_options       DBMS_AQ.dequeue_options_t;
      message_properties    DBMS_AQ.message_properties_t;
      message_handle        RAW(16);
      message               test.message_typ;
      no_messages           exception;
      end_of_group          exception;
      PRAGMA EXCEPTION_INIT (no_messages, -25228);
      PRAGMA EXCEPTION_INIT (end_of_group, -25235);
   BEGIN
      dequeue_options.wait       := DBMS_AQ.NO_WAIT;
      dequeue_options.navigation := DBMS_AQ.FIRST_MESSAGE;
      LOOP
        BEGIN
        DBMS_AQ.DEQUEUE(
           queue_name         => 'test.group_queue',
           dequeue_options    => dequeue_options,
           message_properties => message_properties,
           payload            => message,
           msgid              => message_handle);
        DBMS_OUTPUT.PUT_LINE(message.subject || ': ' || message.text );
        dequeue_options.navigation := DBMS_AQ.NEXT_MESSAGE;
        EXCEPTION
          WHEN end_of_group THEN
            DBMS_OUTPUT.PUT_LINE ('Finished ' || message.subject);
            COMMIT;
            dequeue_options.navigation := DBMS_AQ.NEXT_TRANSACTION;
        END;
      END LOOP;
      EXCEPTION
        WHEN no_messages THEN
          DBMS_OUTPUT.PUT_LINE ('No more messages');
   END;
   ```
   
   ```sql
   SET SERVEROUTPUT ON
   DECLARE
      dequeue_options     DBMS_AQ.dequeue_options_t;
      message_properties  DBMS_AQ.message_properties_t;
      message_handle      RAW(16);
      message             test.message_typ;
   BEGIN
      dequeue_options.dequeue_mode := DBMS_AQ.BROWSE;
      LOOP
         DBMS_AQ.DEQUEUE(
           queue_name              => 'test.obj_queue',
           dequeue_options         => dequeue_options,
           message_properties      => message_properties,
           payload                 => message,
           msgid                   => message_handle);
         DBMS_OUTPUT.PUT_LINE ('Browsed Message Text: ' || message.text);
         EXIT WHEN message.subject = 'PINK';
      END LOOP;
      dequeue_options.dequeue_mode := DBMS_AQ.REMOVE;
      dequeue_options.msgid        := message_handle;
      DBMS_AQ.DEQUEUE(
              queue_name           => 'test.obj_queue',
              dequeue_options      => dequeue_options,
              message_properties   => message_properties,
              payload              => message,
              msgid                => message_handle);
      DBMS_OUTPUT.PUT_LINE('Removed Message Text: ' || message.text);
      COMMIT;
   END;
   ```
   
   ```sql
   SET SERVEROUTPUT ON
   DECLARE
      dequeue_options     DBMS_AQ.dequeue_options_t;
      message_properties  DBMS_AQ.message_properties_t;
      message_handle      RAW(16);
      message             test.message_typ;
   BEGIN
      dequeue_options.dequeue_mode := DBMS_AQ.LOCKED;
      LOOP
         DBMS_AQ.dequeue(
           queue_name         => 'test.obj_queue',
           dequeue_options    => dequeue_options,
           message_properties => message_properties,
           payload            => message,
           msgid              => message_handle);
         DBMS_OUTPUT.PUT_LINE('Locked Message Text: ' || message.text);
         EXIT WHEN message.subject = 'PURPLE';
      END LOOP;
      dequeue_options.dequeue_mode := DBMS_AQ.REMOVE;
      dequeue_options.msgid        := message_handle;
      DBMS_AQ.DEQUEUE(
        queue_name           => 'test.obj_queue',
        dequeue_options      => dequeue_options,
        message_properties   => message_properties,
        payload              => message,
        msgid                => message_handle);
      DBMS_OUTPUT.PUT_LINE('Removed Message Text: ' || message.text);
      COMMIT;
   END;
   ```
   
   ```sql
   SET (nested_table)
   ```
   
   # Process
   1. First confirm that this is a correct oracle sql syntax, if not please 
ignore;
   2. Compare SQL definitions in Oficial SQL Doc and ShardingSphere SQL Doc;
   3. If there is any difference in ShardingSphere SQL Doc, please correct them 
by referring to the Official SQL Doc;
   4. Run mvn install the current_file_module;
   5. Check whether there are any exceptions. If indeed, please fix them. 
(Especially xxxVisitor.class);
   6. Add new corresponding SQL case in SQL Cases and expected parsed result in 
Expected Statment XML;
   7. Run SQLParserParameterizedTest to make sure no exceptions.
   
   # Relevant Skills
   1. Master JAVA language
   2. Have a basic understanding of Antlr `g4` file
   3. Be familiar with Oracle SQLs


-- 
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: 
[email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to