sqlftwダウンロードsqlftwソースコードのダウンロード

sqlftw

その他のカテゴリー

v0.1.16

ダウンロード

sqlftw

MySQL（今のところ）PHPで書かれたLexer、Parser、Language Model、および静的アナライザー

これは、約140のサポートされているSQLコマンドのそれぞれに対してSQLFTW sql コマンドインターフェイスを実装するオブジェクトを生成する検証パーサーです。コマンドは、ドメインアスペクトではなく、SQLコードの構文的な側面をモデル化します（クエリの書き込み方法を正確にモデル化します）。ただし、空白を追跡せず、現在いくつかのコメントを無視しています

このパーサーは、他の2つのプロジェクトの基礎として意図されています。

1つは、SQLコードの静的分析、特に移行の安全性とパフォーマンスを行うことです（現在、PHPMyAdminプロジェクトから非常に基本的なSQLパーサーを使用しています）
別の人がPHPSTAN（PHPの静的分析ツール）がSQLクエリとその結果をよりよく理解できるようにすることを願っています

単独では、SQLコードの構文を検証するために使用できます（例：移行）

SQL構文サポート：

MySQL 5.xからMySQL 8.0.34へのすべてのSQLコマンドをサポートし、ほぼすべての言語機能をサポートしています

サポートされていない機能ではありません。

shift-jis 、 gb18030 、 utf-16などのASCII-Incapatible Multibyteエンコーディングのサポート（解析に失敗）
引用された区切り文字（実装されていない、おそらく失敗するでしょう）
ANSIモードでの二重引用名の暗黙の文字列の連結（ "foo" "bar" ;これは文字列でサポートされていますが、名前ではありません）

受け入れられますが、無視された機能（モデルとシリアル化なし）：

式でオペレーターの優先順位を解決する（今のところ、同じ層のオペレーターは左から右に解析されます。後で実装されます）
ステートメント内の定期的なコメント（声明が収集される前のコメント）
HeatWaveプラグイン機能（Secondar_Engine）
SELECT ... PROCEDURE ANALYSE (...) - mysql 8で削除
WEIGHT_STRING(... LEVEL ...) - mysql 8で削除

mysql以外の方法で実装された機能：

パーサーは、PostgreSQLと同じように終了していないコメントにエラーを生成します（MySQLはサイレントであり、テストによると、これはバグかもしれません）
パーサーは、無効な名前でユーザー変数を読み取るときにエラーを生成します（MySQLは静かにそれらを無視し、nullを返します）
パーサーは、無効な構文を使用してオプティマイザーのヒントにエラーを生成します（MySQLは警告を生成し、AWS AuroraMySQLがエラーを作成します）

建築：

メインレイヤー：

lexer -sqlをトークン化し、パーサートークンのジェネレーターを返します
パーサー（S） - 構文を検証し、解析されたコマンドオブジェクトのジェネレーターを返します
コマンド（S）-SQLコマンドは、プレーンテキストから不変のオブジェクト表現に解析されます。プレーンテキストに戻ってシリアル化できます
プラットフォーム - 特定のプラットフォームでサポートされる機能のリスト
Formatter-設定可能なSQLステートメントシリアイザー
アナライザー - それらの静的分析ルールと計装

基本的な使用法：

 <?php

use ...

$platform = Platform::get(Platform::MYSQL, '8.0'); // version defaults to x.x.99 when no patch number is given
$config = new ParserConfig($platform);
$session = new Session($platform);
$parser = new Parser($config, $session);

// returns a Generator. will not parse anything if you don't iterate over it
$commands = $parser->parse('SELECT foo FROM ...');
foreach ($commands as $command) {
    // Parser does not throw exceptions. this allows to parse partially invalid code and not fail on first error
    if ($command instanceof InvalidCommand) {
        $e = $command->getException();
        ...
    }
    ...
}

現在の開発状態：

私たちが今いるところ：

〜99.9％MySQL言語機能が実装されています
serialialialialialialialializationを使用した基本的な単体テスト
consure数千のテーブルと移行に対してテストされました
mysqlテストスイートからほぼすべてを解析します（誤ったネガはありません）
mySQLテストスイートからのほぼすべてのエラーテストで失敗します（誤検知はありません）
mySQLテストスイートでのシリアル化テスト（予想どおりに表されるすべてのSQL機能）
mysqlテストスイートの複数のバージョンに対する並行して自動化されたテスト
☐変異テスト（実際のDBと同じように変異SQLの取り扱い、MySQLテストスイートを超えて拡張範囲）
platformプラットフォームバージョンの区別（DBサーバーの正確なパッチバージョンの解析）
☐移行静的分析ツールをこのライブラリに移植する
first First Stableバージョンのリリース？
☐その他のプラットフォーム（Mariadb、sqlite、postgresql ...）

バージョン化：

私たちは皆、セマンティックバージョンを愛していますよね？：]

しかし、このライブラリは巨大な取り組みであり、まだ迅速な初期開発段階を経ています。この段階でもバージョンとリリースをリリースすることにしました。なぜなら、それは何もないよりも優れており、数十のアルファバージョンをリリースするよりも良いと思うからです。したがって、 「0.1」を離れるまで、後方互換性を期待しないでください。最初の試みで巨大なシステムを設計することは不可能であり、多くの概念が落ち着いてその場所をクリックする必要があります。したがって、多くの変更がまだ来ています

Composerを使用する場合、このパッケージへの依存関係を正確なバージョンに常にロックしてください。たとえば、 sqlftw/sqlftw:0.1.14