@simplysm/orm-common 13.0.69 → 13.0.70

package/tests/expr/utility.spec.ts

@@ -0,0 +1,182 @@
+import { describe, expect, it } from "vitest";
+import { createTestDb } from "../setup/TestDbContext";
+import { expr } from "../../src/expr/expr";
+import { createQueryBuilder } from "../../src/query-builder/query-builder";
+import { dialects } from "../setup/test-utils";
+import "../setup/test-utils"; // toMatchSql matcher
+import * as expected from "./utility.expected";
+
+describe("Expr - Utility functions", () => {
+  //#region ========== ROW_NUM ==========
+
+  describe("rowNum - row number (without window)", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        rowNum: expr.rowNum(),
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        rowNum: { type: "rowNum" },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.rowNum[dialect]);
+    });
+  });
+
+  //#endregion
+
+  //#region ========== RANDOM ==========
+
+  describe("random - random value", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        randomVal: expr.random(),
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        randomVal: { type: "random" },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.random[dialect]);
+    });
+  });
+
+  //#endregion
+
+  //#region ========== CAST ==========
+
+  describe("cast - type conversion to INT", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        ageInt: expr.cast(item.age, { type: "int" }),
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        ageInt: {
+          type: "cast",
+          source: { type: "column", path: ["T1", "age"] },
+          targetType: { type: "int" },
+        },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.castToInt[dialect]);
+    });
+  });
+
+  describe("cast - type conversion to VARCHAR", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        ageStr: expr.cast(item.age, { type: "varchar", length: 50 }),
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        ageStr: {
+          type: "cast",
+          source: { type: "column", path: ["T1", "age"] },
+          targetType: { type: "varchar", length: 50 },
+        },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.castToVarchar[dialect]);
+    });
+  });
+
+  //#endregion
+
+  //#region ========== RAW ==========
+
+  describe("raw - Basic raw SQL", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        serverTime: expr.raw("DateTime")`NOW()`,
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        serverTime: {
+          type: "raw",
+          sql: "NOW()",
+          params: [],
+        },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.rawBasic[dialect]);
+    });
+  });
+
+  describe("raw - raw SQL with parameters", () => {
+    const db = createTestDb();
+    const def = db
+      .user()
+      .select((item) => ({
+        id: item.id,
+        combined: expr.raw("string")`CONCAT(${item.name}, ' - ', ${item.email})`,
+      }))
+      .getSelectQueryDef();
+
+    it("Verify QueryDef", () => {
+      expect(def.select).toMatchObject({
+        id: { type: "column", path: ["T1", "id"] },
+        combined: {
+          type: "raw",
+          sql: "CONCAT($1, ' - ', $2)",
+          params: [
+            { type: "column", path: ["T1", "name"] },
+            { type: "column", path: ["T1", "email"] },
+          ],
+        },
+      });
+    });
+
+    it.each(dialects)("[%s] Verify SQL", (dialect) => {
+      const builder = createQueryBuilder(dialect);
+      expect(builder.build(def)).toMatchSql(expected.rawWithParam[dialect]);
+    });
+  });
+
+  //#endregion
+});

package/tests/select/basic.expected.ts

@@ -0,0 +1,322 @@
+/**
+ * SELECT - Basic test expected SQL
+ */
+import { mysql, pgsql, tsql } from "@simplysm/core-common";
+import type { ExpectedSql } from "../setup/test-utils";
+
+//#region ========== Basic SELECT ==========
+
+export const selectAll: ExpectedSql = {
+  mysql: mysql`
+    SELECT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT *
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT *
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectColumns: ExpectedSql = {
+  mysql: mysql`
+    SELECT \`T1\`.\`id\` AS \`id\`, \`T1\`.\`name\` AS \`name\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT [T1].[id] AS [id], [T1].[name] AS [name]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT "T1"."id" AS "id", "T1"."name" AS "name"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectConcat: ExpectedSql = {
+  mysql: mysql`
+    SELECT CONCAT(IFNULL(\`T1\`.\`email\`, ''), IFNULL('@test.com', '')) AS \`email\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT CONCAT([T1].[email], N'@test.com') AS [email]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT COALESCE("T1"."email", '') || COALESCE('@test.com', '') AS "email"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectAggregate: ExpectedSql = {
+  mysql: mysql`
+    SELECT
+      COUNT(\`T1\`.\`id\`) AS \`cnt\`,
+      SUM(\`T1\`.\`age\`) AS \`total\`,
+      AVG(\`T1\`.\`age\`) AS \`avg\`,
+      MIN(\`T1\`.\`age\`) AS \`min\`,
+      MAX(\`T1\`.\`age\`) AS \`max\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT
+      COUNT([T1].[id]) AS [cnt],
+      SUM([T1].[age]) AS [total],
+      AVG([T1].[age]) AS [avg],
+      MIN([T1].[age]) AS [min],
+      MAX([T1].[age]) AS [max]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT
+      COUNT("T1"."id") AS "cnt",
+      SUM("T1"."age") AS "total",
+      AVG("T1"."age") AS "avg",
+      MIN("T1"."age") AS "min",
+      MAX("T1"."age") AS "max"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectIfNull2: ExpectedSql = {
+  mysql: mysql`
+    SELECT COALESCE(\`T1\`.\`email\`, 'N/A') AS \`email\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT COALESCE([T1].[email], N'N/A') AS [email]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT COALESCE("T1"."email", 'N/A') AS "email"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectIfNull3: ExpectedSql = {
+  mysql: mysql`
+    SELECT COALESCE(\`T1\`.\`email\`, \`T1\`.\`name\`, 'N/A') AS \`contact\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT COALESCE([T1].[email], [T1].[name], N'N/A') AS [contact]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT COALESCE("T1"."email", "T1"."name", 'N/A') AS "contact"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectNullIf: ExpectedSql = {
+  mysql: mysql`
+    SELECT NULLIF(\`T1\`.\`name\`, 'N/A') AS \`name\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT NULLIF([T1].[name], N'N/A') AS [name]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT NULLIF("T1"."name", 'N/A') AS "name"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectSubstring: ExpectedSql = {
+  mysql: mysql`
+    SELECT SUBSTRING(\`T1\`.\`name\`, 1, 3) AS \`shortName\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT SUBSTRING([T1].[name], 1, 3) AS [shortName]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT SUBSTRING("T1"."name", 1, 3) AS "shortName"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectSubstringNoLength: ExpectedSql = {
+  mysql: mysql`
+    SELECT SUBSTRING(\`T1\`.\`name\`, 3) AS \`suffix\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT SUBSTRING([T1].[name], 3, LEN([T1].[name])) AS [suffix]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT SUBSTRING("T1"."name" FROM 3) AS "suffix"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectIndexOf: ExpectedSql = {
+  mysql: mysql`
+    SELECT LOCATE('@', \`T1\`.\`email\`) AS \`atPos\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT CHARINDEX(N'@', [T1].[email]) AS [atPos]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT POSITION('@' IN "T1"."email") AS "atPos"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectLeast: ExpectedSql = {
+  mysql: mysql`
+    SELECT LEAST(\`T1\`.\`age\`, 50) AS \`minAge\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT (SELECT MIN(v) FROM (VALUES ([T1].[age]), (50)) AS t(v)) AS [minAge]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT LEAST("T1"."age", 50) AS "minAge"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectGreatest: ExpectedSql = {
+  mysql: mysql`
+    SELECT GREATEST(\`T1\`.\`age\`, 18) AS \`maxAge\`
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT (SELECT MAX(v) FROM (VALUES ([T1].[age]), (18)) AS t(v)) AS [maxAge]
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT GREATEST("T1"."age", 18) AS "maxAge"
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+//#endregion
+
+//#region ========== 옵션 ==========
+
+export const selectDistinct: ExpectedSql = {
+  mysql: mysql`
+    SELECT DISTINCT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+  `,
+  mssql: tsql`
+    SELECT DISTINCT *
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT DISTINCT *
+    FROM "TestSchema"."User" AS "T1"
+  `,
+};
+
+export const selectLock: ExpectedSql = {
+  mysql: mysql`
+    SELECT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+    FOR UPDATE
+  `,
+  mssql: tsql`
+    SELECT *
+    FROM [TestDb].[TestSchema].[User] AS [T1] WITH (UPDLOCK, ROWLOCK)
+  `,
+  postgresql: pgsql`
+    SELECT *
+    FROM "TestSchema"."User" AS "T1"
+    FOR UPDATE
+  `,
+};
+
+export const selectDistinctLock: ExpectedSql = {
+  mysql: mysql`
+    SELECT DISTINCT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+    FOR UPDATE
+  `,
+  mssql: tsql`
+    SELECT DISTINCT *
+    FROM [TestDb].[TestSchema].[User] AS [T1] WITH (UPDLOCK, ROWLOCK)
+  `,
+  postgresql: pgsql`
+    SELECT DISTINCT *
+    FROM "TestSchema"."User" AS "T1"
+    FOR UPDATE
+  `,
+};
+
+//#endregion
+
+//#region ========== 제한 ==========
+
+export const selectTop: ExpectedSql = {
+  mysql: mysql`
+    SELECT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+    LIMIT 10
+  `,
+  mssql: tsql`
+    SELECT TOP 10 *
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+  `,
+  postgresql: pgsql`
+    SELECT *
+    FROM "TestSchema"."User" AS "T1"
+    LIMIT 10
+  `,
+};
+
+export const selectLimit: ExpectedSql = {
+  mysql: mysql`
+    SELECT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+    ORDER BY \`T1\`.\`id\`
+    LIMIT 0, 10
+  `,
+  mssql: tsql`
+    SELECT *
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+    ORDER BY [T1].[id]
+    OFFSET 0 ROWS FETCH NEXT 10 ROWS ONLY
+  `,
+  postgresql: pgsql`
+    SELECT *
+    FROM "TestSchema"."User" AS "T1"
+    ORDER BY "T1"."id"
+    LIMIT 10 OFFSET 0
+  `,
+};
+
+export const selectLimitOffset: ExpectedSql = {
+  mysql: mysql`
+    SELECT *
+    FROM \`TestDb\`.\`User\` AS \`T1\`
+    ORDER BY \`T1\`.\`id\`
+    LIMIT 20, 10
+  `,
+  mssql: tsql`
+    SELECT *
+    FROM [TestDb].[TestSchema].[User] AS [T1]
+    ORDER BY [T1].[id]
+    OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY
+  `,
+  postgresql: pgsql`
+    SELECT *
+    FROM "TestSchema"."User" AS "T1"
+    ORDER BY "T1"."id"
+    LIMIT 10 OFFSET 20
+  `,
+};
+
+// 랜덤 샘플링은 examples/sampling.spec.ts 참고
+
+//#endregion