sqlingo 0.14.0 → 0.15.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +64 -0
- package/README.md +46 -42
- package/README.npm.md +46 -42
- package/README.repo.md +46 -42
- package/dist/{chunk-5DWBBMY5.js → chunk-2J3ENBD5.js} +2 -2
- package/dist/chunk-2KPB5VYS.cjs +2 -0
- package/dist/{chunk-7IOXDRML.cjs.map → chunk-2KPB5VYS.cjs.map} +1 -1
- package/dist/chunk-2LGSNVQ3.js +2 -0
- package/dist/chunk-2LGSNVQ3.js.map +1 -0
- package/dist/{chunk-36DKUE7J.js → chunk-4IVIRL3R.js} +2 -2
- package/dist/chunk-4IVIRL3R.js.map +1 -0
- package/dist/{chunk-W6U3GTNX.js → chunk-5PG2W5KQ.js} +2 -2
- package/dist/chunk-5R5Y7APF.js +3 -0
- package/dist/chunk-5R5Y7APF.js.map +1 -0
- package/dist/chunk-74FI6XYQ.js +2 -0
- package/dist/chunk-74FI6XYQ.js.map +1 -0
- package/dist/{chunk-HXHC2LWI.js → chunk-7JR5AIAS.js} +2 -2
- package/dist/{chunk-KMXZA2BM.js → chunk-7N5O3DV2.js} +2 -2
- package/dist/chunk-7SCP6LGO.cjs +2 -0
- package/dist/{chunk-Q4RMMNNY.cjs.map → chunk-7SCP6LGO.cjs.map} +1 -1
- package/dist/chunk-BVGN575V.cjs +4 -0
- package/dist/{chunk-ODM62C7I.cjs.map → chunk-BVGN575V.cjs.map} +1 -1
- package/dist/{chunk-EUAMIS3V.js → chunk-CNMIO457.js} +2 -2
- package/dist/chunk-CUPQWT54.cjs +2 -0
- package/dist/chunk-CUPQWT54.cjs.map +1 -0
- package/dist/chunk-DKZBCCJD.cjs +2 -0
- package/dist/{chunk-DE2H6QX3.cjs.map → chunk-DKZBCCJD.cjs.map} +1 -1
- package/dist/chunk-DXPZ3QMG.js +2 -0
- package/dist/chunk-DXPZ3QMG.js.map +1 -0
- package/dist/{chunk-LP5HSRQB.js → chunk-EHY2BEHB.js} +2 -2
- package/dist/chunk-FFQJ6IDF.cjs +2 -0
- package/dist/{chunk-PDIIUQW2.cjs.map → chunk-FFQJ6IDF.cjs.map} +1 -1
- package/dist/chunk-FUUWLHKY.cjs +2 -0
- package/dist/{chunk-AQKYEAZ7.cjs.map → chunk-FUUWLHKY.cjs.map} +1 -1
- package/dist/chunk-ICDU5OIJ.cjs +2 -0
- package/dist/{chunk-X7BDDFU3.cjs.map → chunk-ICDU5OIJ.cjs.map} +1 -1
- package/dist/chunk-J34QL7IA.cjs +2 -0
- package/dist/{chunk-C7GYE4CR.cjs.map → chunk-J34QL7IA.cjs.map} +1 -1
- package/dist/chunk-KB3ISJ55.cjs +2 -0
- package/dist/chunk-KB3ISJ55.cjs.map +1 -0
- package/dist/chunk-KLV3GIXA.cjs +2 -0
- package/dist/chunk-KLV3GIXA.cjs.map +1 -0
- package/dist/chunk-KOR3YNSR.js +19 -0
- package/dist/chunk-KOR3YNSR.js.map +1 -0
- package/dist/chunk-KUHI26D7.cjs +2 -0
- package/dist/{chunk-VGODA24J.cjs.map → chunk-KUHI26D7.cjs.map} +1 -1
- package/dist/chunk-LEFEWQFZ.cjs +2 -0
- package/dist/chunk-LEFEWQFZ.cjs.map +1 -0
- package/dist/chunk-NVW37KMU.cjs +19 -0
- package/dist/chunk-NVW37KMU.cjs.map +1 -0
- package/dist/chunk-NYGVT47F.js +2 -0
- package/dist/chunk-NYGVT47F.js.map +1 -0
- package/dist/chunk-QRPIH752.js +2 -0
- package/dist/{chunk-XQZPNUSU.js.map → chunk-QRPIH752.js.map} +1 -1
- package/dist/chunk-RXA33NGM.cjs +3 -0
- package/dist/chunk-RXA33NGM.cjs.map +1 -0
- package/dist/chunk-SBVABUNN.cjs +2 -0
- package/dist/{chunk-467BXHF4.cjs.map → chunk-SBVABUNN.cjs.map} +1 -1
- package/dist/chunk-U5XTB4CK.cjs +2 -0
- package/dist/chunk-U5XTB4CK.cjs.map +1 -0
- package/dist/{chunk-37N6X5QX.js → chunk-WP5GVNZO.js} +2 -2
- package/dist/chunk-XE2SNLNY.js +2 -0
- package/dist/chunk-XE2SNLNY.js.map +1 -0
- package/dist/chunk-XL22Q5LT.cjs +2 -0
- package/dist/chunk-XL22Q5LT.cjs.map +1 -0
- package/dist/chunk-XMN3QM63.cjs +2 -0
- package/dist/{chunk-E4DSENBH.cjs.map → chunk-XMN3QM63.cjs.map} +1 -1
- package/dist/{chunk-NWYWTDXD.js → chunk-YM74L2OQ.js} +2 -2
- package/dist/{chunk-IT4HBN2F.js → chunk-Z2CEQ2BR.js} +2 -2
- package/dist/{chunk-F4MW2MP3.js → chunk-ZLN3NHYC.js} +2 -2
- package/dist/dialects/athena.cjs +1 -1
- package/dist/dialects/athena.d.cts +1 -1
- package/dist/dialects/athena.d.ts +1 -1
- package/dist/dialects/athena.js +1 -1
- package/dist/dialects/bigquery.cjs +2 -2
- package/dist/dialects/bigquery.cjs.map +1 -1
- package/dist/dialects/bigquery.d.cts +1 -1
- package/dist/dialects/bigquery.d.ts +1 -1
- package/dist/dialects/bigquery.js +2 -2
- package/dist/dialects/bigquery.js.map +1 -1
- package/dist/dialects/clickhouse.cjs +1 -1
- package/dist/dialects/clickhouse.cjs.map +1 -1
- package/dist/dialects/clickhouse.d.cts +3 -1
- package/dist/dialects/clickhouse.d.ts +3 -1
- package/dist/dialects/clickhouse.js +1 -1
- package/dist/dialects/clickhouse.js.map +1 -1
- package/dist/dialects/databricks.cjs +1 -1
- package/dist/dialects/databricks.cjs.map +1 -1
- package/dist/dialects/databricks.d.cts +1 -1
- package/dist/dialects/databricks.d.ts +1 -1
- package/dist/dialects/databricks.js +1 -1
- package/dist/dialects/databricks.js.map +1 -1
- package/dist/dialects/doris.cjs +1 -1
- package/dist/dialects/doris.cjs.map +1 -1
- package/dist/dialects/doris.d.cts +1 -1
- package/dist/dialects/doris.d.ts +1 -1
- package/dist/dialects/doris.js +1 -1
- package/dist/dialects/doris.js.map +1 -1
- package/dist/dialects/dremio.cjs +1 -1
- package/dist/dialects/dremio.cjs.map +1 -1
- package/dist/dialects/dremio.d.cts +1 -1
- package/dist/dialects/dremio.d.ts +1 -1
- package/dist/dialects/dremio.js +1 -1
- package/dist/dialects/dremio.js.map +1 -1
- package/dist/dialects/drill.cjs +1 -1
- package/dist/dialects/drill.cjs.map +1 -1
- package/dist/dialects/drill.d.cts +1 -1
- package/dist/dialects/drill.d.ts +1 -1
- package/dist/dialects/drill.js +1 -1
- package/dist/dialects/drill.js.map +1 -1
- package/dist/dialects/druid.cjs +1 -1
- package/dist/dialects/druid.d.cts +1 -1
- package/dist/dialects/druid.d.ts +1 -1
- package/dist/dialects/druid.js +1 -1
- package/dist/dialects/duckdb.cjs +13 -13
- package/dist/dialects/duckdb.cjs.map +1 -1
- package/dist/dialects/duckdb.d.cts +15 -1
- package/dist/dialects/duckdb.d.ts +15 -1
- package/dist/dialects/duckdb.js +4 -4
- package/dist/dialects/duckdb.js.map +1 -1
- package/dist/dialects/dune.cjs +1 -1
- package/dist/dialects/dune.d.cts +1 -1
- package/dist/dialects/dune.d.ts +1 -1
- package/dist/dialects/dune.js +1 -1
- package/dist/dialects/exasol.cjs +1 -1
- package/dist/dialects/exasol.cjs.map +1 -1
- package/dist/dialects/exasol.d.cts +1 -1
- package/dist/dialects/exasol.d.ts +1 -1
- package/dist/dialects/exasol.js +1 -1
- package/dist/dialects/exasol.js.map +1 -1
- package/dist/dialects/fabric.cjs +1 -1
- package/dist/dialects/fabric.d.cts +1 -1
- package/dist/dialects/fabric.d.ts +1 -1
- package/dist/dialects/fabric.js +1 -1
- package/dist/dialects/hive.cjs +1 -1
- package/dist/dialects/hive.d.cts +1 -1
- package/dist/dialects/hive.d.ts +1 -1
- package/dist/dialects/hive.js +1 -1
- package/dist/dialects/materialize.cjs +1 -1
- package/dist/dialects/materialize.d.cts +1 -1
- package/dist/dialects/materialize.d.ts +1 -1
- package/dist/dialects/materialize.js +1 -1
- package/dist/dialects/mysql.cjs +1 -1
- package/dist/dialects/mysql.d.cts +2 -1
- package/dist/dialects/mysql.d.ts +2 -1
- package/dist/dialects/mysql.js +1 -1
- package/dist/dialects/oracle.cjs +1 -1
- package/dist/dialects/oracle.cjs.map +1 -1
- package/dist/dialects/oracle.d.cts +2 -1
- package/dist/dialects/oracle.d.ts +2 -1
- package/dist/dialects/oracle.js +1 -1
- package/dist/dialects/oracle.js.map +1 -1
- package/dist/dialects/postgres.cjs +1 -1
- package/dist/dialects/postgres.d.cts +31 -1
- package/dist/dialects/postgres.d.ts +31 -1
- package/dist/dialects/postgres.js +1 -1
- package/dist/dialects/presto.cjs +1 -1
- package/dist/dialects/presto.d.cts +1 -1
- package/dist/dialects/presto.d.ts +1 -1
- package/dist/dialects/presto.js +1 -1
- package/dist/dialects/prql.cjs +1 -1
- package/dist/dialects/prql.d.cts +1 -1
- package/dist/dialects/prql.d.ts +1 -1
- package/dist/dialects/prql.js +1 -1
- package/dist/dialects/redshift.cjs +1 -1
- package/dist/dialects/redshift.d.cts +21 -1
- package/dist/dialects/redshift.d.ts +21 -1
- package/dist/dialects/redshift.js +1 -1
- package/dist/dialects/risingwave.cjs +1 -1
- package/dist/dialects/risingwave.d.cts +1 -1
- package/dist/dialects/risingwave.d.ts +1 -1
- package/dist/dialects/risingwave.js +1 -1
- package/dist/dialects/singlestore.cjs +1 -1
- package/dist/dialects/singlestore.cjs.map +1 -1
- package/dist/dialects/singlestore.d.cts +1 -1
- package/dist/dialects/singlestore.d.ts +1 -1
- package/dist/dialects/singlestore.js +1 -1
- package/dist/dialects/singlestore.js.map +1 -1
- package/dist/dialects/snowflake.cjs +2 -2
- package/dist/dialects/snowflake.cjs.map +1 -1
- package/dist/dialects/snowflake.d.cts +2 -1
- package/dist/dialects/snowflake.d.ts +2 -1
- package/dist/dialects/snowflake.js +2 -2
- package/dist/dialects/snowflake.js.map +1 -1
- package/dist/dialects/solr.cjs +1 -1
- package/dist/dialects/solr.d.cts +1 -1
- package/dist/dialects/solr.d.ts +1 -1
- package/dist/dialects/solr.js +1 -1
- package/dist/dialects/spark.cjs +1 -1
- package/dist/dialects/spark.d.cts +1 -1
- package/dist/dialects/spark.d.ts +1 -1
- package/dist/dialects/spark.js +1 -1
- package/dist/dialects/spark2.cjs +1 -1
- package/dist/dialects/spark2.d.cts +1 -1
- package/dist/dialects/spark2.d.ts +1 -1
- package/dist/dialects/spark2.js +1 -1
- package/dist/dialects/sqlite.cjs +1 -1
- package/dist/dialects/sqlite.d.cts +1 -1
- package/dist/dialects/sqlite.d.ts +1 -1
- package/dist/dialects/sqlite.js +1 -1
- package/dist/dialects/starrocks.cjs +1 -1
- package/dist/dialects/starrocks.cjs.map +1 -1
- package/dist/dialects/starrocks.d.cts +1 -1
- package/dist/dialects/starrocks.d.ts +1 -1
- package/dist/dialects/starrocks.js +1 -1
- package/dist/dialects/starrocks.js.map +1 -1
- package/dist/dialects/tableau.cjs +1 -1
- package/dist/dialects/tableau.d.cts +1 -1
- package/dist/dialects/tableau.d.ts +1 -1
- package/dist/dialects/tableau.js +1 -1
- package/dist/dialects/teradata.cjs +1 -1
- package/dist/dialects/teradata.d.cts +1 -1
- package/dist/dialects/teradata.d.ts +1 -1
- package/dist/dialects/teradata.js +1 -1
- package/dist/dialects/trino.cjs +1 -1
- package/dist/dialects/trino.d.cts +1 -1
- package/dist/dialects/trino.d.ts +1 -1
- package/dist/dialects/trino.js +1 -1
- package/dist/dialects/tsql.cjs +1 -1
- package/dist/dialects/tsql.d.cts +1 -1
- package/dist/dialects/tsql.d.ts +1 -1
- package/dist/dialects/tsql.js +1 -1
- package/dist/index.cjs +5 -5
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/{tokens-CBFVFIjW.d.ts → tokens-BXP7BR0y.d.cts} +75 -2
- package/dist/{tokens-CBFVFIjW.d.cts → tokens-BXP7BR0y.d.ts} +75 -2
- package/package.json +3 -3
- package/dist/chunk-34LJCOBZ.js +0 -3
- package/dist/chunk-34LJCOBZ.js.map +0 -1
- package/dist/chunk-36DKUE7J.js.map +0 -1
- package/dist/chunk-467BXHF4.cjs +0 -2
- package/dist/chunk-5HKX357Z.cjs +0 -19
- package/dist/chunk-5HKX357Z.cjs.map +0 -1
- package/dist/chunk-7IOXDRML.cjs +0 -2
- package/dist/chunk-ADMPZJZR.cjs +0 -2
- package/dist/chunk-ADMPZJZR.cjs.map +0 -1
- package/dist/chunk-AQKYEAZ7.cjs +0 -2
- package/dist/chunk-C7GYE4CR.cjs +0 -2
- package/dist/chunk-CXJYZLCO.js +0 -19
- package/dist/chunk-CXJYZLCO.js.map +0 -1
- package/dist/chunk-DE2H6QX3.cjs +0 -2
- package/dist/chunk-E4DSENBH.cjs +0 -2
- package/dist/chunk-EEJXUTGR.cjs +0 -2
- package/dist/chunk-EEJXUTGR.cjs.map +0 -1
- package/dist/chunk-EMQRVNJU.js +0 -2
- package/dist/chunk-EMQRVNJU.js.map +0 -1
- package/dist/chunk-G3OFOFNK.js +0 -2
- package/dist/chunk-G3OFOFNK.js.map +0 -1
- package/dist/chunk-GEP6I6JI.js +0 -2
- package/dist/chunk-GEP6I6JI.js.map +0 -1
- package/dist/chunk-GF27QS7D.cjs +0 -3
- package/dist/chunk-GF27QS7D.cjs.map +0 -1
- package/dist/chunk-NZVRNG6G.cjs +0 -2
- package/dist/chunk-NZVRNG6G.cjs.map +0 -1
- package/dist/chunk-ODM62C7I.cjs +0 -4
- package/dist/chunk-PDIIUQW2.cjs +0 -2
- package/dist/chunk-PWCVBJZT.cjs +0 -2
- package/dist/chunk-PWCVBJZT.cjs.map +0 -1
- package/dist/chunk-Q4RMMNNY.cjs +0 -2
- package/dist/chunk-QYADHTOF.cjs +0 -2
- package/dist/chunk-QYADHTOF.cjs.map +0 -1
- package/dist/chunk-VGODA24J.cjs +0 -2
- package/dist/chunk-X7BDDFU3.cjs +0 -2
- package/dist/chunk-XGUZVSUI.js +0 -2
- package/dist/chunk-XGUZVSUI.js.map +0 -1
- package/dist/chunk-XQZPNUSU.js +0 -2
- package/dist/chunk-Y3MAG6HE.cjs +0 -2
- package/dist/chunk-Y3MAG6HE.cjs.map +0 -1
- package/dist/chunk-YQR2MSNG.js +0 -2
- package/dist/chunk-YQR2MSNG.js.map +0 -1
- /package/dist/{chunk-5DWBBMY5.js.map → chunk-2J3ENBD5.js.map} +0 -0
- /package/dist/{chunk-W6U3GTNX.js.map → chunk-5PG2W5KQ.js.map} +0 -0
- /package/dist/{chunk-HXHC2LWI.js.map → chunk-7JR5AIAS.js.map} +0 -0
- /package/dist/{chunk-KMXZA2BM.js.map → chunk-7N5O3DV2.js.map} +0 -0
- /package/dist/{chunk-EUAMIS3V.js.map → chunk-CNMIO457.js.map} +0 -0
- /package/dist/{chunk-LP5HSRQB.js.map → chunk-EHY2BEHB.js.map} +0 -0
- /package/dist/{chunk-37N6X5QX.js.map → chunk-WP5GVNZO.js.map} +0 -0
- /package/dist/{chunk-NWYWTDXD.js.map → chunk-YM74L2OQ.js.map} +0 -0
- /package/dist/{chunk-IT4HBN2F.js.map → chunk-Z2CEQ2BR.js.map} +0 -0
- /package/dist/{chunk-F4MW2MP3.js.map → chunk-ZLN3NHYC.js.map} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,69 @@
|
|
|
1
1
|
# sqlingo
|
|
2
2
|
|
|
3
|
+
## 0.15.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 15c6a06: Fix issue #51
|
|
8
|
+
|
|
9
|
+
- Use stable class identifier internally when specifying dialects
|
|
10
|
+
- Fix MySQL UNIQUE (col) transpiling to UNIQUE (col NULLS FIRST)
|
|
11
|
+
|
|
12
|
+
## 0.15.0
|
|
13
|
+
|
|
14
|
+
### Minor Changes
|
|
15
|
+
|
|
16
|
+
- 4321928: Sync upstream sqlglot to v30.5.0
|
|
17
|
+
|
|
18
|
+
**DuckDB**
|
|
19
|
+
|
|
20
|
+
- Add `$` as a single-token identifier character (`VAR_SINGLE_TOKENS`)
|
|
21
|
+
- Add `JSON_ARRAY` parser mapping to `JsonArrayExpr`
|
|
22
|
+
- Add unsupported-function stubs with warnings: `ENCRYPT`, `DECRYPT`, `DECRYPT_RAW`, `ENCRYPT_RAW`, `PARSE_URL`, `PARSE_IP`, `SOUNDEX`, `ARRAY_UNION_AGG`
|
|
23
|
+
- Add `STUFF` transpilation: binary branch uses `UNHEX(STUFF(HEX(...)))`, non-binary branch uses `CONCAT`/`SUBSTRING`
|
|
24
|
+
- Add `SUBSTRING` transpilation for Snowflake zero-indexed `SUBSTR` (adjusts start/length to 1-based DuckDB semantics)
|
|
25
|
+
- Add `JAROWINKLER_SIMILARITY` transpilation to `JARO_WINKLER_SIMILARITY` with optional `* 100` integer-scale cast
|
|
26
|
+
- Add `BYTE_LENGTH` transpilation: wraps text args with `ENCODE` before `OCTET_LENGTH`
|
|
27
|
+
- Add `REDUCE` transpilation to `list_reduce` (drops unsupported `finish` arg, sets colon-style lambda)
|
|
28
|
+
|
|
29
|
+
**Snowflake**
|
|
30
|
+
|
|
31
|
+
- Add `integerScale: true` flag on `JAROWINKLER_SIMILARITY` so DuckDB output multiplies by 100
|
|
32
|
+
- Add `SUBSTR` function parser that sets `zeroStart: true` on `SubstringExpr`
|
|
33
|
+
- Map `DataTypeExprKind.JSON` to `VARIANT` in type mapping
|
|
34
|
+
- Transpile `JsonArrayExpr` to `TO_VARIANT(ARRAY_CONSTRUCT(...))`
|
|
35
|
+
|
|
36
|
+
**BigQuery**
|
|
37
|
+
|
|
38
|
+
- Add `FOR SYSTEM TIME` (space-separated) as an alias for `FOR SYSTEM_TIME` token
|
|
39
|
+
|
|
40
|
+
**Databricks**
|
|
41
|
+
|
|
42
|
+
- Add `IFF` as a synonym for `IF` (normalizes to `IF` on output, `IFF` on Snowflake)
|
|
43
|
+
- Add `TRY_DIVIDE` parser mapping (inherits from Spark)
|
|
44
|
+
|
|
45
|
+
**Spark**
|
|
46
|
+
|
|
47
|
+
- Add `TRY_DIVIDE` parser mapping and generator transform
|
|
48
|
+
|
|
49
|
+
**Exasol**
|
|
50
|
+
|
|
51
|
+
- Add `MINUS` as a tokenizer alias for `EXCEPT`
|
|
52
|
+
|
|
53
|
+
### Patch Changes
|
|
54
|
+
|
|
55
|
+
- 4321928: Sync upstream sqlglot v30.5.0 tests and fix bugs
|
|
56
|
+
|
|
57
|
+
- Port all missing v30.5.0 test cases across all dialect files
|
|
58
|
+
- Fix generator `EXCLUDE` bug: pass `undefined` as first arg to `this.expressions()` instead of object
|
|
59
|
+
- Fix `renameindexSql` -> `alterRenameIndexSql` method name mismatch
|
|
60
|
+
- Fix `InvisibleColumnConstraintExpr` missing empty `requiredArgs` override
|
|
61
|
+
- Fix `unnestGenerateDateArrayUsingRecursiveCte` to use `DateAddExpr` instead of `AnonymousExpr`
|
|
62
|
+
- Add `ALL` to `JoinExprKind` enum for ClickHouse ALL JOIN support
|
|
63
|
+
- Fix `parseDictProperty` to use `parseFunction() || parsePrimaryOrVar()`
|
|
64
|
+
- Sync 3 optimizer fixture files from upstream
|
|
65
|
+
- Add new test methods: `testMaxNodes`, `testGetOrRaise`, `testCompareDialects`, `testCompareDialectVersions`, `testReservedKeywords`, `testCount`, `testDistinctOn`, `testGenerateDateArray`
|
|
66
|
+
|
|
3
67
|
## 0.14.0
|
|
4
68
|
|
|
5
69
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/sqlingo)
|
|
4
4
|
[](https://github.com/huydo862003/sqlingo/blob/master/LICENSE)
|
|
5
|
-

|
|
6
6
|
<a href="https://github.com/huydo862003/Fck-AI-Slop#plan"><img src="https://img.shields.io/badge/human%20slop-90EE90"></a>
|
|
7
7
|
|
|
8
8
|
A JavaScript/TypeScript port of [SQLGlot](https://github.com/tobymao/sqlglot) which is compatible with browser and Node runtimes.
|
|
@@ -29,37 +29,34 @@ NOTICE: AI is not the decision maker, designer or maintainer for this project. I
|
|
|
29
29
|
## Installation
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
npm install sqlingo
|
|
33
|
-
# or
|
|
34
|
-
pnpm add sqlingo
|
|
32
|
+
npm install sqlingo luxon
|
|
35
33
|
```
|
|
36
34
|
|
|
37
35
|
Peer dependency: [`luxon`](https://www.npmjs.com/package/luxon) (^3.7.2) is required for date/time operations.
|
|
38
36
|
|
|
39
37
|
## Quick Start
|
|
40
38
|
|
|
41
|
-
This example demonstrates transpiling a query from Spark to Postgres and then optimizing it.
|
|
42
|
-
|
|
43
39
|
```ts
|
|
44
40
|
import { transpile, parseOne, optimize, MappingSchema } from "sqlingo";
|
|
41
|
+
import { MySQL } from "sqlingo/mysql";
|
|
45
42
|
import { Postgres } from "sqlingo/postgres";
|
|
46
|
-
import { Spark } from "sqlingo/spark";
|
|
47
43
|
|
|
48
44
|
// Transpile between dialects
|
|
49
|
-
const [pgSql] = transpile("SELECT
|
|
50
|
-
read:
|
|
45
|
+
const [pgSql] = transpile("SELECT DATE_SUB(d, INTERVAL 1 DAY) FROM t", {
|
|
46
|
+
read: MySQL,
|
|
51
47
|
write: Postgres,
|
|
52
48
|
});
|
|
53
49
|
console.log(pgSql);
|
|
54
|
-
//
|
|
50
|
+
// SELECT d - INTERVAL '1 DAY' FROM t
|
|
55
51
|
|
|
56
|
-
// Optimize
|
|
57
|
-
const sql = "SELECT a, b FROM t WHERE a + 1 = 2";
|
|
52
|
+
// Optimize a query with schema information
|
|
58
53
|
const schema = new MappingSchema({ t: { a: "int", b: "int" } });
|
|
59
|
-
|
|
60
|
-
|
|
54
|
+
const optimized = optimize(
|
|
55
|
+
parseOne("SELECT * FROM t WHERE 1 = 1 AND a > 2"),
|
|
56
|
+
{ schema },
|
|
57
|
+
);
|
|
61
58
|
console.log(optimized.sql());
|
|
62
|
-
//
|
|
59
|
+
// SELECT "t"."a" AS "a", "t"."b" AS "b" FROM "t" AS "t" WHERE "t"."a" > 2
|
|
63
60
|
```
|
|
64
61
|
|
|
65
62
|
## Core Usage
|
|
@@ -75,7 +72,7 @@ import { parse, parseOne } from "sqlingo";
|
|
|
75
72
|
const expressions = parse("SELECT 1; SELECT 2");
|
|
76
73
|
|
|
77
74
|
// Parse a single statement
|
|
78
|
-
const
|
|
75
|
+
const ast = parseOne("SELECT a, b FROM t WHERE a > 1");
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
### Transpiling
|
|
@@ -91,7 +88,8 @@ const [result] = transpile("SELECT EPOCH_MS(1618088028295)", {
|
|
|
91
88
|
read: DuckDB,
|
|
92
89
|
write: Hive,
|
|
93
90
|
});
|
|
94
|
-
|
|
91
|
+
console.log(result);
|
|
92
|
+
// SELECT FROM_UNIXTIME(1618088028295 / POW(10, 3))
|
|
95
93
|
```
|
|
96
94
|
|
|
97
95
|
### Tokenizing
|
|
@@ -102,9 +100,7 @@ Extract tokens from a SQL string for lower-level analysis.
|
|
|
102
100
|
import { tokenize } from "sqlingo";
|
|
103
101
|
import { Postgres } from "sqlingo/postgres";
|
|
104
102
|
|
|
105
|
-
const tokens = tokenize("SELECT 1",
|
|
106
|
-
dialect: Postgres,
|
|
107
|
-
});
|
|
103
|
+
const tokens = tokenize("SELECT 1", Postgres);
|
|
108
104
|
```
|
|
109
105
|
|
|
110
106
|
## SQL Builder
|
|
@@ -115,14 +111,10 @@ Build queries programmatically using a fluent API.
|
|
|
115
111
|
import { select, condition } from "sqlingo";
|
|
116
112
|
import { MySQL } from "sqlingo/mysql";
|
|
117
113
|
|
|
118
|
-
const query = select("a", "b").from("t").where(condition("a > 1")).limit(10);
|
|
114
|
+
const query = select(["a", "b"]).from("t").where(condition("a > 1")).limit(10);
|
|
119
115
|
|
|
120
|
-
console.log(
|
|
121
|
-
|
|
122
|
-
dialect: MySQL,
|
|
123
|
-
}),
|
|
124
|
-
);
|
|
125
|
-
// Output: SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
116
|
+
console.log(query.sql({ dialect: MySQL }));
|
|
117
|
+
// SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
126
118
|
```
|
|
127
119
|
|
|
128
120
|
## Optimization & Analysis
|
|
@@ -132,13 +124,13 @@ console.log(
|
|
|
132
124
|
Simplify and normalize queries based on schema information.
|
|
133
125
|
|
|
134
126
|
```ts
|
|
135
|
-
import { optimize, MappingSchema } from "sqlingo";
|
|
136
|
-
|
|
137
|
-
const schema = new MappingSchema({
|
|
138
|
-
// define your schema
|
|
139
|
-
});
|
|
127
|
+
import { optimize, parseOne, MappingSchema } from "sqlingo";
|
|
140
128
|
|
|
129
|
+
const schema = new MappingSchema({ t: { a: "int" } });
|
|
141
130
|
const optimized = optimize(parseOne("SELECT * FROM t"), { schema });
|
|
131
|
+
|
|
132
|
+
console.log(optimized.sql());
|
|
133
|
+
// SELECT "t"."a" AS "a" FROM "t" AS "t"
|
|
142
134
|
```
|
|
143
135
|
|
|
144
136
|
### Column Lineage
|
|
@@ -149,8 +141,10 @@ Trace the origin of columns through subqueries and joins.
|
|
|
149
141
|
import { lineage } from "sqlingo";
|
|
150
142
|
|
|
151
143
|
const node = lineage("b", "SELECT a AS b FROM (SELECT x AS a FROM y)");
|
|
152
|
-
console.log(node.
|
|
153
|
-
//
|
|
144
|
+
console.log(node.name);
|
|
145
|
+
// "b"
|
|
146
|
+
console.log(node.downstream[0].name);
|
|
147
|
+
// "_0.a"
|
|
154
148
|
```
|
|
155
149
|
|
|
156
150
|
## Registering a Custom Dialect
|
|
@@ -158,20 +152,30 @@ console.log(node.source.name);
|
|
|
158
152
|
You can extend the library by registering custom dialects or overriding existing behavior.
|
|
159
153
|
|
|
160
154
|
```ts
|
|
161
|
-
import { Dialect, Generator, transpile } from "sqlingo";
|
|
155
|
+
import { Dialect, Generator, ArrayAggExpr, transpile } from "sqlingo";
|
|
156
|
+
|
|
157
|
+
class MyGenerator extends Generator {
|
|
158
|
+
static get ORIGINAL_TRANSFORMS() {
|
|
159
|
+
return new Map([
|
|
160
|
+
...Generator.TRANSFORMS,
|
|
161
|
+
// Rewrite ARRAY_AGG as GROUP_CONCAT in this dialect
|
|
162
|
+
[ArrayAggExpr, function (this: Generator, e: ArrayAggExpr) {
|
|
163
|
+
return `GROUP_CONCAT(${this.sql(e, "this")})`;
|
|
164
|
+
}],
|
|
165
|
+
]);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
162
168
|
|
|
163
169
|
class MyDialect extends Dialect {
|
|
164
170
|
static DIALECT_NAME = "my_dialect";
|
|
165
|
-
|
|
166
|
-
static Generator = class extends Generator {
|
|
167
|
-
// Override how specific expressions are generated
|
|
168
|
-
};
|
|
171
|
+
static Generator = MyGenerator;
|
|
169
172
|
}
|
|
170
173
|
|
|
171
|
-
// Register for string-based lookup
|
|
172
174
|
Dialect.register(MyDialect);
|
|
173
175
|
|
|
174
|
-
const [result] = transpile("SELECT
|
|
176
|
+
const [result] = transpile("SELECT ARRAY_AGG(x) FROM t", { write: MyDialect });
|
|
177
|
+
console.log(result);
|
|
178
|
+
// SELECT GROUP_CONCAT(x) FROM t
|
|
175
179
|
```
|
|
176
180
|
|
|
177
181
|
## Supported Dialects
|
|
@@ -180,7 +184,7 @@ Athena, BigQuery, ClickHouse, Databricks, Doris, Dremio, Drill, Druid, DuckDB, D
|
|
|
180
184
|
|
|
181
185
|
## SQLGlot Compatibility
|
|
182
186
|
|
|
183
|
-
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.
|
|
187
|
+
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.5.0 (commit `64d385f`). The API surface mirrors SQLGlot's Python API, adapted to TypeScript conventions. See [CONVENTION.md](https://github.com/huydo862003/sqlingo/blob/master/packages/sqlingo/CONVENTION.md) for details.
|
|
184
188
|
|
|
185
189
|
## License
|
|
186
190
|
|
package/README.npm.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/sqlingo)
|
|
4
4
|
[](https://github.com/huydo862003/sqlingo/blob/master/LICENSE)
|
|
5
|
-

|
|
6
6
|
<a href="https://github.com/huydo862003/Fck-AI-Slop#plan"><img src="https://img.shields.io/badge/human%20slop-90EE90"></a>
|
|
7
7
|
|
|
8
8
|
A JavaScript/TypeScript port of [SQLGlot](https://github.com/tobymao/sqlglot) which is compatible with browser and Node runtimes.
|
|
@@ -29,37 +29,34 @@ NOTICE: AI is not the decision maker, designer or maintainer for this project. I
|
|
|
29
29
|
## Installation
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
npm install sqlingo
|
|
33
|
-
# or
|
|
34
|
-
pnpm add sqlingo
|
|
32
|
+
npm install sqlingo luxon
|
|
35
33
|
```
|
|
36
34
|
|
|
37
35
|
Peer dependency: [`luxon`](https://www.npmjs.com/package/luxon) (^3.7.2) is required for date/time operations.
|
|
38
36
|
|
|
39
37
|
## Quick Start
|
|
40
38
|
|
|
41
|
-
This example demonstrates transpiling a query from Spark to Postgres and then optimizing it.
|
|
42
|
-
|
|
43
39
|
```ts
|
|
44
40
|
import { transpile, parseOne, optimize, MappingSchema } from "sqlingo";
|
|
41
|
+
import { MySQL } from "sqlingo/mysql";
|
|
45
42
|
import { Postgres } from "sqlingo/postgres";
|
|
46
|
-
import { Spark } from "sqlingo/spark";
|
|
47
43
|
|
|
48
44
|
// Transpile between dialects
|
|
49
|
-
const [pgSql] = transpile("SELECT
|
|
50
|
-
read:
|
|
45
|
+
const [pgSql] = transpile("SELECT DATE_SUB(d, INTERVAL 1 DAY) FROM t", {
|
|
46
|
+
read: MySQL,
|
|
51
47
|
write: Postgres,
|
|
52
48
|
});
|
|
53
49
|
console.log(pgSql);
|
|
54
|
-
//
|
|
50
|
+
// SELECT d - INTERVAL '1 DAY' FROM t
|
|
55
51
|
|
|
56
|
-
// Optimize
|
|
57
|
-
const sql = "SELECT a, b FROM t WHERE a + 1 = 2";
|
|
52
|
+
// Optimize a query with schema information
|
|
58
53
|
const schema = new MappingSchema({ t: { a: "int", b: "int" } });
|
|
59
|
-
|
|
60
|
-
|
|
54
|
+
const optimized = optimize(
|
|
55
|
+
parseOne("SELECT * FROM t WHERE 1 = 1 AND a > 2"),
|
|
56
|
+
{ schema },
|
|
57
|
+
);
|
|
61
58
|
console.log(optimized.sql());
|
|
62
|
-
//
|
|
59
|
+
// SELECT "t"."a" AS "a", "t"."b" AS "b" FROM "t" AS "t" WHERE "t"."a" > 2
|
|
63
60
|
```
|
|
64
61
|
|
|
65
62
|
## Core Usage
|
|
@@ -75,7 +72,7 @@ import { parse, parseOne } from "sqlingo";
|
|
|
75
72
|
const expressions = parse("SELECT 1; SELECT 2");
|
|
76
73
|
|
|
77
74
|
// Parse a single statement
|
|
78
|
-
const
|
|
75
|
+
const ast = parseOne("SELECT a, b FROM t WHERE a > 1");
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
### Transpiling
|
|
@@ -91,7 +88,8 @@ const [result] = transpile("SELECT EPOCH_MS(1618088028295)", {
|
|
|
91
88
|
read: DuckDB,
|
|
92
89
|
write: Hive,
|
|
93
90
|
});
|
|
94
|
-
|
|
91
|
+
console.log(result);
|
|
92
|
+
// SELECT FROM_UNIXTIME(1618088028295 / POW(10, 3))
|
|
95
93
|
```
|
|
96
94
|
|
|
97
95
|
### Tokenizing
|
|
@@ -102,9 +100,7 @@ Extract tokens from a SQL string for lower-level analysis.
|
|
|
102
100
|
import { tokenize } from "sqlingo";
|
|
103
101
|
import { Postgres } from "sqlingo/postgres";
|
|
104
102
|
|
|
105
|
-
const tokens = tokenize("SELECT 1",
|
|
106
|
-
dialect: Postgres,
|
|
107
|
-
});
|
|
103
|
+
const tokens = tokenize("SELECT 1", Postgres);
|
|
108
104
|
```
|
|
109
105
|
|
|
110
106
|
## SQL Builder
|
|
@@ -115,14 +111,10 @@ Build queries programmatically using a fluent API.
|
|
|
115
111
|
import { select, condition } from "sqlingo";
|
|
116
112
|
import { MySQL } from "sqlingo/mysql";
|
|
117
113
|
|
|
118
|
-
const query = select("a", "b").from("t").where(condition("a > 1")).limit(10);
|
|
114
|
+
const query = select(["a", "b"]).from("t").where(condition("a > 1")).limit(10);
|
|
119
115
|
|
|
120
|
-
console.log(
|
|
121
|
-
|
|
122
|
-
dialect: MySQL,
|
|
123
|
-
}),
|
|
124
|
-
);
|
|
125
|
-
// Output: SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
116
|
+
console.log(query.sql({ dialect: MySQL }));
|
|
117
|
+
// SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
126
118
|
```
|
|
127
119
|
|
|
128
120
|
## Optimization & Analysis
|
|
@@ -132,13 +124,13 @@ console.log(
|
|
|
132
124
|
Simplify and normalize queries based on schema information.
|
|
133
125
|
|
|
134
126
|
```ts
|
|
135
|
-
import { optimize, MappingSchema } from "sqlingo";
|
|
136
|
-
|
|
137
|
-
const schema = new MappingSchema({
|
|
138
|
-
// define your schema
|
|
139
|
-
});
|
|
127
|
+
import { optimize, parseOne, MappingSchema } from "sqlingo";
|
|
140
128
|
|
|
129
|
+
const schema = new MappingSchema({ t: { a: "int" } });
|
|
141
130
|
const optimized = optimize(parseOne("SELECT * FROM t"), { schema });
|
|
131
|
+
|
|
132
|
+
console.log(optimized.sql());
|
|
133
|
+
// SELECT "t"."a" AS "a" FROM "t" AS "t"
|
|
142
134
|
```
|
|
143
135
|
|
|
144
136
|
### Column Lineage
|
|
@@ -149,8 +141,10 @@ Trace the origin of columns through subqueries and joins.
|
|
|
149
141
|
import { lineage } from "sqlingo";
|
|
150
142
|
|
|
151
143
|
const node = lineage("b", "SELECT a AS b FROM (SELECT x AS a FROM y)");
|
|
152
|
-
console.log(node.
|
|
153
|
-
//
|
|
144
|
+
console.log(node.name);
|
|
145
|
+
// "b"
|
|
146
|
+
console.log(node.downstream[0].name);
|
|
147
|
+
// "_0.a"
|
|
154
148
|
```
|
|
155
149
|
|
|
156
150
|
## Registering a Custom Dialect
|
|
@@ -158,20 +152,30 @@ console.log(node.source.name);
|
|
|
158
152
|
You can extend the library by registering custom dialects or overriding existing behavior.
|
|
159
153
|
|
|
160
154
|
```ts
|
|
161
|
-
import { Dialect, Generator, transpile } from "sqlingo";
|
|
155
|
+
import { Dialect, Generator, ArrayAggExpr, transpile } from "sqlingo";
|
|
156
|
+
|
|
157
|
+
class MyGenerator extends Generator {
|
|
158
|
+
static get ORIGINAL_TRANSFORMS() {
|
|
159
|
+
return new Map([
|
|
160
|
+
...Generator.TRANSFORMS,
|
|
161
|
+
// Rewrite ARRAY_AGG as GROUP_CONCAT in this dialect
|
|
162
|
+
[ArrayAggExpr, function (this: Generator, e: ArrayAggExpr) {
|
|
163
|
+
return `GROUP_CONCAT(${this.sql(e, "this")})`;
|
|
164
|
+
}],
|
|
165
|
+
]);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
162
168
|
|
|
163
169
|
class MyDialect extends Dialect {
|
|
164
170
|
static DIALECT_NAME = "my_dialect";
|
|
165
|
-
|
|
166
|
-
static Generator = class extends Generator {
|
|
167
|
-
// Override how specific expressions are generated
|
|
168
|
-
};
|
|
171
|
+
static Generator = MyGenerator;
|
|
169
172
|
}
|
|
170
173
|
|
|
171
|
-
// Register for string-based lookup
|
|
172
174
|
Dialect.register(MyDialect);
|
|
173
175
|
|
|
174
|
-
const [result] = transpile("SELECT
|
|
176
|
+
const [result] = transpile("SELECT ARRAY_AGG(x) FROM t", { write: MyDialect });
|
|
177
|
+
console.log(result);
|
|
178
|
+
// SELECT GROUP_CONCAT(x) FROM t
|
|
175
179
|
```
|
|
176
180
|
|
|
177
181
|
## Supported Dialects
|
|
@@ -180,7 +184,7 @@ Athena, BigQuery, ClickHouse, Databricks, Doris, Dremio, Drill, Druid, DuckDB, D
|
|
|
180
184
|
|
|
181
185
|
## SQLGlot Compatibility
|
|
182
186
|
|
|
183
|
-
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.
|
|
187
|
+
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.5.0 (commit `64d385f`). The API surface mirrors SQLGlot's Python API, adapted to TypeScript conventions. See [CONVENTION.md](https://github.com/huydo862003/sqlingo/blob/master/packages/sqlingo/CONVENTION.md) for details.
|
|
184
188
|
|
|
185
189
|
## License
|
|
186
190
|
|
package/README.repo.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/sqlingo)
|
|
4
4
|
[](https://github.com/huydo862003/sqlingo/blob/master/LICENSE)
|
|
5
|
-

|
|
6
6
|
<a href="https://github.com/huydo862003/Fck-AI-Slop#plan"><img src="https://img.shields.io/badge/human%20slop-90EE90"></a>
|
|
7
7
|
|
|
8
8
|
A JavaScript/TypeScript port of [SQLGlot](https://github.com/tobymao/sqlglot) which is compatible with browser and Node runtimes.
|
|
@@ -29,37 +29,34 @@ NOTICE: AI is not the decision maker, designer or maintainer for this project. I
|
|
|
29
29
|
## Installation
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
npm install sqlingo
|
|
33
|
-
# or
|
|
34
|
-
pnpm add sqlingo
|
|
32
|
+
npm install sqlingo luxon
|
|
35
33
|
```
|
|
36
34
|
|
|
37
35
|
Peer dependency: [`luxon`](https://www.npmjs.com/package/luxon) (^3.7.2) is required for date/time operations.
|
|
38
36
|
|
|
39
37
|
## Quick Start
|
|
40
38
|
|
|
41
|
-
This example demonstrates transpiling a query from Spark to Postgres and then optimizing it.
|
|
42
|
-
|
|
43
39
|
```ts
|
|
44
40
|
import { transpile, parseOne, optimize, MappingSchema } from "sqlingo";
|
|
41
|
+
import { MySQL } from "sqlingo/mysql";
|
|
45
42
|
import { Postgres } from "sqlingo/postgres";
|
|
46
|
-
import { Spark } from "sqlingo/spark";
|
|
47
43
|
|
|
48
44
|
// Transpile between dialects
|
|
49
|
-
const [pgSql] = transpile("SELECT
|
|
50
|
-
read:
|
|
45
|
+
const [pgSql] = transpile("SELECT DATE_SUB(d, INTERVAL 1 DAY) FROM t", {
|
|
46
|
+
read: MySQL,
|
|
51
47
|
write: Postgres,
|
|
52
48
|
});
|
|
53
49
|
console.log(pgSql);
|
|
54
|
-
//
|
|
50
|
+
// SELECT d - INTERVAL '1 DAY' FROM t
|
|
55
51
|
|
|
56
|
-
// Optimize
|
|
57
|
-
const sql = "SELECT a, b FROM t WHERE a + 1 = 2";
|
|
52
|
+
// Optimize a query with schema information
|
|
58
53
|
const schema = new MappingSchema({ t: { a: "int", b: "int" } });
|
|
59
|
-
|
|
60
|
-
|
|
54
|
+
const optimized = optimize(
|
|
55
|
+
parseOne("SELECT * FROM t WHERE 1 = 1 AND a > 2"),
|
|
56
|
+
{ schema },
|
|
57
|
+
);
|
|
61
58
|
console.log(optimized.sql());
|
|
62
|
-
//
|
|
59
|
+
// SELECT "t"."a" AS "a", "t"."b" AS "b" FROM "t" AS "t" WHERE "t"."a" > 2
|
|
63
60
|
```
|
|
64
61
|
|
|
65
62
|
## Core Usage
|
|
@@ -75,7 +72,7 @@ import { parse, parseOne } from "sqlingo";
|
|
|
75
72
|
const expressions = parse("SELECT 1; SELECT 2");
|
|
76
73
|
|
|
77
74
|
// Parse a single statement
|
|
78
|
-
const
|
|
75
|
+
const ast = parseOne("SELECT a, b FROM t WHERE a > 1");
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
### Transpiling
|
|
@@ -91,7 +88,8 @@ const [result] = transpile("SELECT EPOCH_MS(1618088028295)", {
|
|
|
91
88
|
read: DuckDB,
|
|
92
89
|
write: Hive,
|
|
93
90
|
});
|
|
94
|
-
|
|
91
|
+
console.log(result);
|
|
92
|
+
// SELECT FROM_UNIXTIME(1618088028295 / POW(10, 3))
|
|
95
93
|
```
|
|
96
94
|
|
|
97
95
|
### Tokenizing
|
|
@@ -102,9 +100,7 @@ Extract tokens from a SQL string for lower-level analysis.
|
|
|
102
100
|
import { tokenize } from "sqlingo";
|
|
103
101
|
import { Postgres } from "sqlingo/postgres";
|
|
104
102
|
|
|
105
|
-
const tokens = tokenize("SELECT 1",
|
|
106
|
-
dialect: Postgres,
|
|
107
|
-
});
|
|
103
|
+
const tokens = tokenize("SELECT 1", Postgres);
|
|
108
104
|
```
|
|
109
105
|
|
|
110
106
|
## SQL Builder
|
|
@@ -115,14 +111,10 @@ Build queries programmatically using a fluent API.
|
|
|
115
111
|
import { select, condition } from "sqlingo";
|
|
116
112
|
import { MySQL } from "sqlingo/mysql";
|
|
117
113
|
|
|
118
|
-
const query = select("a", "b").from("t").where(condition("a > 1")).limit(10);
|
|
114
|
+
const query = select(["a", "b"]).from("t").where(condition("a > 1")).limit(10);
|
|
119
115
|
|
|
120
|
-
console.log(
|
|
121
|
-
|
|
122
|
-
dialect: MySQL,
|
|
123
|
-
}),
|
|
124
|
-
);
|
|
125
|
-
// Output: SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
116
|
+
console.log(query.sql({ dialect: MySQL }));
|
|
117
|
+
// SELECT a, b FROM t WHERE a > 1 LIMIT 10
|
|
126
118
|
```
|
|
127
119
|
|
|
128
120
|
## Optimization & Analysis
|
|
@@ -132,13 +124,13 @@ console.log(
|
|
|
132
124
|
Simplify and normalize queries based on schema information.
|
|
133
125
|
|
|
134
126
|
```ts
|
|
135
|
-
import { optimize, MappingSchema } from "sqlingo";
|
|
136
|
-
|
|
137
|
-
const schema = new MappingSchema({
|
|
138
|
-
// define your schema
|
|
139
|
-
});
|
|
127
|
+
import { optimize, parseOne, MappingSchema } from "sqlingo";
|
|
140
128
|
|
|
129
|
+
const schema = new MappingSchema({ t: { a: "int" } });
|
|
141
130
|
const optimized = optimize(parseOne("SELECT * FROM t"), { schema });
|
|
131
|
+
|
|
132
|
+
console.log(optimized.sql());
|
|
133
|
+
// SELECT "t"."a" AS "a" FROM "t" AS "t"
|
|
142
134
|
```
|
|
143
135
|
|
|
144
136
|
### Column Lineage
|
|
@@ -149,8 +141,10 @@ Trace the origin of columns through subqueries and joins.
|
|
|
149
141
|
import { lineage } from "sqlingo";
|
|
150
142
|
|
|
151
143
|
const node = lineage("b", "SELECT a AS b FROM (SELECT x AS a FROM y)");
|
|
152
|
-
console.log(node.
|
|
153
|
-
//
|
|
144
|
+
console.log(node.name);
|
|
145
|
+
// "b"
|
|
146
|
+
console.log(node.downstream[0].name);
|
|
147
|
+
// "_0.a"
|
|
154
148
|
```
|
|
155
149
|
|
|
156
150
|
## Registering a Custom Dialect
|
|
@@ -158,20 +152,30 @@ console.log(node.source.name);
|
|
|
158
152
|
You can extend the library by registering custom dialects or overriding existing behavior.
|
|
159
153
|
|
|
160
154
|
```ts
|
|
161
|
-
import { Dialect, Generator, transpile } from "sqlingo";
|
|
155
|
+
import { Dialect, Generator, ArrayAggExpr, transpile } from "sqlingo";
|
|
156
|
+
|
|
157
|
+
class MyGenerator extends Generator {
|
|
158
|
+
static get ORIGINAL_TRANSFORMS() {
|
|
159
|
+
return new Map([
|
|
160
|
+
...Generator.TRANSFORMS,
|
|
161
|
+
// Rewrite ARRAY_AGG as GROUP_CONCAT in this dialect
|
|
162
|
+
[ArrayAggExpr, function (this: Generator, e: ArrayAggExpr) {
|
|
163
|
+
return `GROUP_CONCAT(${this.sql(e, "this")})`;
|
|
164
|
+
}],
|
|
165
|
+
]);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
162
168
|
|
|
163
169
|
class MyDialect extends Dialect {
|
|
164
170
|
static DIALECT_NAME = "my_dialect";
|
|
165
|
-
|
|
166
|
-
static Generator = class extends Generator {
|
|
167
|
-
// Override how specific expressions are generated
|
|
168
|
-
};
|
|
171
|
+
static Generator = MyGenerator;
|
|
169
172
|
}
|
|
170
173
|
|
|
171
|
-
// Register for string-based lookup
|
|
172
174
|
Dialect.register(MyDialect);
|
|
173
175
|
|
|
174
|
-
const [result] = transpile("SELECT
|
|
176
|
+
const [result] = transpile("SELECT ARRAY_AGG(x) FROM t", { write: MyDialect });
|
|
177
|
+
console.log(result);
|
|
178
|
+
// SELECT GROUP_CONCAT(x) FROM t
|
|
175
179
|
```
|
|
176
180
|
|
|
177
181
|
## Supported Dialects
|
|
@@ -180,7 +184,7 @@ Athena, BigQuery, ClickHouse, Databricks, Doris, Dremio, Drill, Druid, DuckDB, D
|
|
|
180
184
|
|
|
181
185
|
## SQLGlot Compatibility
|
|
182
186
|
|
|
183
|
-
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.
|
|
187
|
+
This package tracks [SQLGlot](https://github.com/tobymao/sqlglot) v30.5.0 (commit `64d385f`). The API surface mirrors SQLGlot's Python API, adapted to TypeScript conventions. See [CONVENTION.md](https://github.com/huydo862003/sqlingo/blob/master/packages/sqlingo/CONVENTION.md) for details.
|
|
184
188
|
|
|
185
189
|
## License
|
|
186
190
|
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{
|
|
2
|
-
//# sourceMappingURL=chunk-
|
|
1
|
+
import{$v as l,Eq as u,Ip as h,Lp as R,Uj as B,Yq as w,a as o,ak as f,b as i,bq as T,c as a,d as E,e as x,jo as M,nr as D,om as y,s as m,sj as A,ss as g,uj as d,wj as c,zr as S}from"./chunk-KOR3YNSR.js";var N,p;N=[m];var e=class e{static get EXPRESSION_METADATA(){let n=new Map(l.EXPRESSION_METADATA),s=o((r,t)=>{for(let O of r)n.set(O,t)},"extend");return s([A,f,d,c,h,R,S,g],{returns:"bigint"}),s([y,M,w,D],{annotator:o((r,t)=>r.annotateByArgs(t,["this"]),"annotator")}),n.set(B,{annotator:o((r,t)=>r.annotateByArgs(t,["this","expression"]),"annotator")}),n.set(u,{annotator:o((r,t)=>t.args.this?r.annotateByArgs(t,["this"]):r.setType(t,"double"),"annotator")}),n.set(T,{returns:"varbinary"}),n}};p=i(null),x(p,10,"EXPRESSION_METADATA",N,e),a(p,e),E(p,3,e),o(e,"PrestoTyping");var I=e;export{I as a};
|
|
2
|
+
//# sourceMappingURL=chunk-2J3ENBD5.js.map
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkFFQJ6IDFcjs = require('./chunk-FFQJ6IDF.cjs');var _chunkNVW37KMUcjs = require('./chunk-NVW37KMU.cjs');var O,p;O=[_chunkNVW37KMUcjs.s];var t=class t{static get EXPRESSION_METADATA(){let r=new Map(_chunkFFQJ6IDFcjs.a.EXPRESSION_METADATA),o=_chunkNVW37KMUcjs.a.call(void 0, (s,n)=>{for(let z of s)r.set(z,n)},"extend");return o([_chunkNVW37KMUcjs.uk],{returns:"double"}),o([_chunkNVW37KMUcjs.nm,_chunkNVW37KMUcjs.Qm,_chunkNVW37KMUcjs.Gq],{returns:"varchar"}),o([_chunkNVW37KMUcjs.El,_chunkNVW37KMUcjs.Jl,_chunkNVW37KMUcjs.Ds,_chunkNVW37KMUcjs.Es,_chunkNVW37KMUcjs.Fs,_chunkNVW37KMUcjs.nq],{annotator:_chunkNVW37KMUcjs.a.call(void 0, (s,n)=>s.annotateByArgs(n,["this"]),"annotator")}),r.set(_chunkNVW37KMUcjs.Jk,{returns:"bigint"}),r.set(_chunkNVW37KMUcjs.Mm,{returns:"timestampntz"}),r.set(_chunkNVW37KMUcjs.oo,{returns:"binary"}),r.set(_chunkNVW37KMUcjs.ln,{returns:"date"}),r.set(_chunkNVW37KMUcjs.$l,{returns:"int"}),r}};p=_chunkNVW37KMUcjs.b.call(void 0, null),_chunkNVW37KMUcjs.e.call(void 0, p,10,"EXPRESSION_METADATA",O,t),_chunkNVW37KMUcjs.c.call(void 0, p,t),_chunkNVW37KMUcjs.d.call(void 0, p,3,t),_chunkNVW37KMUcjs.a.call(void 0, t,"SparkTyping");var C=t;exports.a = C;
|
|
2
|
+
//# sourceMappingURL=chunk-2KPB5VYS.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/home/huydna/projects/sqlingo.js/packages/sqlingo/dist/chunk-
|
|
1
|
+
{"version":3,"sources":["/home/huydna/projects/sqlingo.js/packages/sqlingo/dist/chunk-2KPB5VYS.cjs","../src/typing/spark.ts"],"names":["_EXPRESSION_METADATA_dec","_init","cache","_SparkTyping","map","Spark2Typing","extend","__name","types","data","type","SecExpr","CollationExpr","CurrentTimezoneExpr","RandstrExpr","ArrayCompactExpr","ArrayInsertExpr","BitwiseAndAggExpr","BitwiseOrAggExpr","BitwiseXorAggExpr","OverlayExpr","e","BitmapCountExpr","LocaltimestampExpr","ToBinaryExpr","DateFromUnixDateExpr","ArraySizeExpr","__decoratorStart","__decorateElement","__decoratorMetadata","__runInitializers","SparkTyping"],"mappings":"AAAA,iIAAwC,wDAAoM,ICA5OA,CAAAA,CAAAC,CAAAA,CAqCED,CAAAA,CAAA,CAACE,mBAAAA,CAAAA,CADI,IAAMC,CAAAA,CAAN,MAAMA,CAAY,CAEvB,OAAA,IAAW,mBAAA,CAAA,CAA2C,CAEpD,IAAMC,CAAAA,CAA0B,IAAI,GAAA,CAAIC,mBAAAA,CAAa,mBAAmB,CAAA,CAElEC,CAAAA,CAASC,iCAAAA,CAACC,CAAAA,CAA8BC,CAAAA,CAAAA,EAAkC,CAC9E,GAAA,CAAA,IAAWC,EAAAA,GAAQF,CAAAA,CAAOJ,CAAAA,CAAI,GAAA,CAAIM,CAAAA,CAAMD,CAAI,CAC9C,CAAA,CAFe,QAAA,CAAA,CAIf,OAAAH,CAAAA,CAAO,CAACK,oBAAO,CAAA,CAAG,CAChB,OAAA,CAAA,QACF,CAAC,CAAA,CAEDL,CAAAA,CAAO,CACLM,oBAAAA,CACAC,oBAAAA,CACAC,oBACF,CAAA,CAAG,CACD,OAAA,CAAA,SACF,CAAC,CAAA,CAEDR,CAAAA,CAAO,CACLS,oBAAAA,CACAC,oBAAAA,CACAC,oBAAAA,CACAC,oBAAAA,CACAC,oBAAAA,CACAC,oBACF,CAAA,CAAG,CACD,SAAA,CAAWb,iCAAAA,CAAC,CAAA,CAAkBc,CAAAA,CAAAA,EAAkB,CAAA,CAAE,cAAA,CAAeA,CAAAA,CAAG,CAAC,MAAM,CAAC,CAAA,CAAjE,WAAA,CACb,CAAC,CAAA,CAEDjB,CAAAA,CAAI,GAAA,CAAIkB,oBAAAA,CAAiB,CACvB,OAAA,CAAA,QACF,CAAC,CAAA,CACDlB,CAAAA,CAAI,GAAA,CAAImB,oBAAAA,CAAoB,CAC1B,OAAA,CAAA,cACF,CAAC,CAAA,CACDnB,CAAAA,CAAI,GAAA,CAAIoB,oBAAAA,CAAc,CACpB,OAAA,CAAA,QACF,CAAC,CAAA,CACDpB,CAAAA,CAAI,GAAA,CAAIqB,oBAAAA,CAAsB,CAC5B,OAAA,CAAA,MACF,CAAC,CAAA,CACDrB,CAAAA,CAAI,GAAA,CAAIsB,oBAAAA,CAAe,CACrB,OAAA,CAAA,KACF,CAAC,CAAA,CAEMtB,CACT,CACF,CAAA,CAnDOH,CAAAA,CAAA0B,iCAAAA,IAAA,CAAA,CAELC,iCAAAA,CAAA3B,CAAA,EAAA,CAAW,qBAAA,CADXD,CAAAA,CADWG,CAAAA,CAAAA,CAAN0B,iCAAAA,CAAA5B,CAAME,CAAAA,CAAAA,CAAN2B,iCAAAA,CAAA7B,CAAA,CAAA,CAAME,CAAAA,CAAAA,CAAYI,iCAAAA,CAAAJ,CAAA,aAAA,CAAA,CAAlB,IAAM4B,CAAAA,CAAN5B,CAAAA,CAAAA,cAAAA","file":"/home/huydna/projects/sqlingo.js/packages/sqlingo/dist/chunk-2KPB5VYS.cjs","sourcesContent":[null,"import type {\n Expression,\n} from '../expressions/expressions';\nimport {\n cache,\n} from '../port_internals';\nimport {\n DataTypeExprKind,\n} from '../expressions/types';\nimport {\n SecExpr,\n ArrayCompactExpr,\n ArrayInsertExpr,\n BitwiseAndAggExpr,\n BitwiseOrAggExpr,\n BitwiseXorAggExpr,\n CollationExpr,\n CurrentTimezoneExpr,\n RandstrExpr,\n BitmapCountExpr,\n LocaltimestampExpr,\n ToBinaryExpr,\n DateFromUnixDateExpr,\n ArraySizeExpr,\n OverlayExpr,\n} from '../expressions/expressions';\nimport type {\n TypeAnnotator,\n} from '../optimizer';\nimport {\n Spark2Typing,\n} from './spark2';\nimport type {\n ExpressionMetadata,\n} from './dialect';\n\nexport class SparkTyping {\n @cache\n static get EXPRESSION_METADATA (): ExpressionMetadata {\n // Clone the Spark 2 base metadata to apply specific overrides\n const map: ExpressionMetadata = new Map(Spark2Typing.EXPRESSION_METADATA);\n\n const extend = (types: (typeof Expression)[], data: Record<string, unknown>) => {\n for (const type of types) map.set(type, data);\n };\n\n extend([SecExpr], {\n returns: DataTypeExprKind.DOUBLE,\n });\n\n extend([\n CollationExpr,\n CurrentTimezoneExpr,\n RandstrExpr,\n ], {\n returns: DataTypeExprKind.VARCHAR,\n });\n\n extend([\n ArrayCompactExpr,\n ArrayInsertExpr,\n BitwiseAndAggExpr,\n BitwiseOrAggExpr,\n BitwiseXorAggExpr,\n OverlayExpr,\n ], {\n annotator: (s: TypeAnnotator, e: Expression) => s.annotateByArgs(e, ['this']),\n });\n\n map.set(BitmapCountExpr, {\n returns: DataTypeExprKind.BIGINT,\n });\n map.set(LocaltimestampExpr, {\n returns: DataTypeExprKind.TIMESTAMPNTZ,\n });\n map.set(ToBinaryExpr, {\n returns: DataTypeExprKind.BINARY,\n });\n map.set(DateFromUnixDateExpr, {\n returns: DataTypeExprKind.DATE,\n });\n map.set(ArraySizeExpr, {\n returns: DataTypeExprKind.INT,\n });\n\n return map;\n }\n}\n"]}
|