apache/shardingsphere

Support parsing Oracle CHANGE DB_UNIQUE_NAME sql

Open

#27.017 geöffnet am 13. Juli 2023

Auf GitHub ansehen
 (2 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)Java (6.902 Forks)batch import
db: Oraclegood first issuein: SQL parsetype: enhancement

Repository-Metriken

Stars
 (20.714 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 3T 14h) (194 gemergte PRs in 30 T)

Beschreibung

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:

CHANGE DB_UNIQUE_NAME FROM BOSTON_A TO BOSTON_B;

CHECK ((A IS NULL AND B IS NULL AND C IS NULL) OR
       (A IS NOT NULL AND B IS NOT NULL AND C IS NOT NULL))

CASE WHEN expr1 IS NOT NULL THEN expr1 ELSE expr2 END

CHECK ((C1 IS NULL AND C2 IS NULL) OR (C1 IS NOT NULL AND C2 IS NOT NULL))

CHECK (column_name IS NOT NULL)

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

Contributor Guide

Research-Richtung
Bestätigen Sie zunächst anhand der offiziellen Oracle SQL Dokumentation, dass jede bereitgestellte SQL Anweisung eine gültige Oracle Syntax ist. Vergleichen Sie dann die SQL Definitionen in der SQL Parser Grammatik von ShardingSphere (g4 Dateien) mit der offiziellen Syntax und korrigieren Sie etwaige Abweichungen. Passen Sie die entsprechenden Visitor Klassen (z. B. OracleDMLVisitor) an, um die neuen Token und Strukturen zu verarbeiten. Fügen Sie schließlich SQL Testfälle im Verzeichnis SQL Cases und erwartete Parse Ergebnisse in der Expected Statement XML hinzu und führen Sie dann SQLParserParameterizedTest aus, um die Korrektheit zu überprüfen.
Tech Stack
java
Domain
backenddatabase
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Halber Tag
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
JavaAntlrOracle SQL
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
50