Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

Native query test helper (#69402)

Romeo Van Snick82d5e7b7ed32
diff --git a/e2e/support/helpers/api/createTestQuery.ts b/e2e/support/helpers/api/createTestQuery.ts
index 194b206efc5..57799c61647 100644
--- a/e2e/support/helpers/api/createTestQuery.ts
+++ b/e2e/support/helpers/api/createTestQuery.ts
@@ -1,5 +1,6 @@
import type {
OpaqueDatasetQuery,
+ TestNativeQuerySpecWithDatabase,
TestQuerySpecWithDatabase,
} from "metabase-types/api";
@@ -10,3 +11,15 @@ export function createTestQuery(
.request<OpaqueDatasetQuery>("POST", "/api/testing/query", querySpec)
.then(({ body }) => body);
}
+
+export function createTestNativeQuery(
+ nativeQuerySpec: TestNativeQuerySpecWithDatabase,
+): Cypress.Chainable<OpaqueDatasetQuery> {
+ return cy
+ .request<OpaqueDatasetQuery>(
+ "POST",
+ "/api/testing/native-query",
+ nativeQuerySpec,
+ )
+ .then(({ body }) => body);
+}
diff --git a/e2e/support/helpers/api/index.ts b/e2e/support/helpers/api/index.ts
index e821bc377bd..6bf188ddf11 100644
--- a/e2e/support/helpers/api/index.ts
+++ b/e2e/support/helpers/api/index.ts
@@ -30,7 +30,7 @@ export { createQuestionAndDashboard } from "./createQuestionAndDashboard";
export { createReaction } from "./createReaction";
export { createSnippet } from "./createSnippet";
export { createSnippetFolder } from "./createSnippetFolder";
-export { createTestQuery } from "./createTestQuery";
+export { createTestQuery, createTestNativeQuery } from "./createTestQuery";
export { createTimeline } from "./createTimeline";
export { createTimelineEvent } from "./createTimelineEvent";
export { createTimelineWithEvents } from "./createTimelineWithEvents";
diff --git a/e2e/test/scenarios/native/native-reproductions.cy.spec.ts b/e2e/test/scenarios/native/native-reproductions.cy.spec.ts
index 59575efb010..dca03cff175 100644
--- a/e2e/test/scenarios/native/native-reproductions.cy.spec.ts
+++ b/e2e/test/scenarios/native/native-reproductions.cy.spec.ts
@@ -1,6 +1,6 @@
const { H } = cy;
-import { WRITABLE_DB_ID } from "e2e/support/cypress_data";
+import { SAMPLE_DB_ID, WRITABLE_DB_ID } from "e2e/support/cypress_data";
import { SAMPLE_DATABASE } from "e2e/support/cypress_sample_database";
import type {
NativeQuestionDetails,
@@ -76,23 +76,20 @@ describe("issue 16584", () => {
});
describe("issue 38083", () => {
- const QUESTION = {
- name: "SQL query with a date parameter",
- native: {
- query: "select * from people where state = {{ state }} limit 1",
- "template-tags": {
- state: {
- id: "6b8b10ef-0104-1047-1e1b-2492d5954555",
- type: "text" as const,
- name: "state",
- "display-name": "State",
- "widget-type": "string/=",
- default: "CA",
- required: true,
- },
+ const QUERY = {
+ database: SAMPLE_DB_ID,
+ query: "select * from people where state = {{ state }} limit 1",
+ templateTags: {
+ state: {
+ type: "text",
+ name: "state",
+ "display-name": "State",
+ "widget-type": "string/=",
+ default: "CA",
+ required: true,
},
},
- };
+ } as const;
beforeEach(() => {
H.restore();
@@ -100,14 +97,17 @@ describe("issue 38083", () => {
});
it("should not show the revert to default icon when the default value is selected (metabase#38083)", () => {
- H.createNativeQuestion(QUESTION, {
- visitQuestion: true,
- });
+ H.createTestNativeQuery(QUERY)
+ .then((dataset_query) =>
+ H.createCard({
+ name: "SQL query with a date parameter",
+ dataset_query,
+ }),
+ )
+ .then((card) => H.visitQuestion(card.id));
H.filterWidget()
- .filter(
- `:contains("${QUESTION.native["template-tags"].state["display-name"]}")`,
- )
+ .filter(`:contains("${QUERY.templateTags.state["display-name"]}")`)
.icon("revert")
.should("not.exist");
});
diff --git a/frontend/src/metabase-lib/query.ts b/frontend/src/metabase-lib/query.ts
index 125ef2655be..6054bf9e209 100644
--- a/frontend/src/metabase-lib/query.ts
+++ b/frontend/src/metabase-lib/query.ts
@@ -8,6 +8,7 @@ import type {
LegacyDatasetQuery,
OpaqueDatasetQuery,
TableId,
+ TestNativeQuerySpec,
TestQuerySpec,
} from "metabase-types/api";
@@ -164,3 +165,10 @@ export function createTestQuery(
): Query {
return ML.test_query(metadataProvider, querySpec);
}
+
+export function createTestNativeQuery(
+ metadataProvider: MetadataProvider,
+ nativeQuerySpec: TestNativeQuerySpec,
+): Query {
+ return ML.test_native_query(metadataProvider, nativeQuerySpec);
+}
diff --git a/frontend/src/metabase-lib/query.unit.spec.ts b/frontend/src/metabase-lib/query.unit.spec.ts
index e9e7ba31003..ce0d70b5b33 100644
--- a/frontend/src/metabase-lib/query.unit.spec.ts
+++ b/frontend/src/metabase-lib/query.unit.spec.ts
@@ -2,6 +2,7 @@ import * as Lib from "metabase-lib";
import {
ORDERS_ID,
PEOPLE_ID,
+ PRODUCTS,
PRODUCTS_ID,
} from "metabase-types/api/mocks/presets";
@@ -475,3 +476,159 @@ describe("createTestQuery", () => {
});
});
});
+
+describe("createTestNativeQuery", () => {
+ it.each(["text", "number", "date", "boolean"] as const)(
+ "should create a native query with a %s tag",
+ (type) => {
+ const queryText = "SELECT * FROM ORDERS WHERE ID = {{x}} ";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ x: {
+ type,
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ x: {
+ id: expect.any(String),
+ type,
+ name: "x",
+ "display-name": "X",
+ },
+ });
+ },
+ );
+
+ it("should create a native query with a dimension template tag", () => {
+ const queryText = "SELECT * FROM ORDERS WHERE {{x}}";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ x: {
+ type: "dimension",
+ dimension: PRODUCTS.CATEGORY,
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ x: {
+ id: expect.any(String),
+ type: "dimension",
+ name: "x",
+ "display-name": "X",
+ dimension: ["field", PRODUCTS.CATEGORY, { "base-type": "type/Text" }],
+ "widget-type": "text",
+ },
+ });
+ });
+
+ it("should create a native query with a temporal unit template tag", () => {
+ const queryText = "SELECT * FROM ORDERS WHERE {{x}}";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ x: {
+ type: "temporal-unit",
+ dimension: PRODUCTS.CREATED_AT,
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ x: {
+ id: expect.any(String),
+ type: "temporal-unit",
+ name: "x",
+ "display-name": "X",
+ dimension: [
+ "field",
+ PRODUCTS.CREATED_AT,
+ { "base-type": "type/DateTime" },
+ ],
+ },
+ });
+ });
+
+ it("should create a native query with a snippet tag", () => {
+ const queryText = "SELECT * FROM ORDERS WHERE {{snippet: foo}}";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ "snippet: foo": {
+ type: "snippet",
+ "snippet-id": 12,
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ "snippet: foo": {
+ id: expect.any(String),
+ type: "snippet",
+ name: "snippet: foo",
+ "snippet-id": 12,
+ "snippet-name": "foo",
+ "display-name": "Snippet: Foo",
+ },
+ });
+ });
+
+ it("should create a native query with a card tag", () => {
+ const queryText = "SELECT * FROM ORDERS WHERE {{#1-users}}";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ "#1-users": {
+ type: "card",
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ "#1-users": {
+ id: expect.any(String),
+ type: "card",
+ name: "#1-users",
+ "display-name": "#1 Users",
+ "card-id": 1,
+ },
+ });
+ });
+
+ it("should add default, required properties", () => {
+ const queryText = "SELECT * FROM ORDERS WHERE ID = {{x}} ";
+ const query = Lib.createTestNativeQuery(SAMPLE_PROVIDER, {
+ query: queryText,
+ templateTags: {
+ x: {
+ type: "text",
+ default: "CA",
+ required: true,
+ "widget-type": "string/contains",
+ },
+ },
+ });
+
+ expect(Lib.rawNativeQuery(query)).toBe(queryText);
+ expect(Lib.templateTags(query)).toEqual({
+ x: {
+ id: expect.any(String),
+ type: "text",
+ name: "x",
+ required: true,
+ default: "CA",
+ "widget-type": "string/contains",
+ "display-name": "X",
+ },
+ });
+ });
+});
diff --git a/frontend/src/metabase-types/api/query.ts b/frontend/src/metabase-types/api/query.ts
index 684b784f654..f506d412d43 100644
--- a/frontend/src/metabase-types/api/query.ts
+++ b/frontend/src/metabase-types/api/query.ts
@@ -3,7 +3,7 @@ import type { UiParameter } from "metabase-lib/v1/parameters/types";
import type { CardId } from "./card";
import type { DatabaseId } from "./database";
-import type { TemplateTags, TemporalUnit } from "./dataset";
+import type { TemplateTag, TemplateTags, TemporalUnit } from "./dataset";
import type { FieldId } from "./field";
import type { SegmentId } from "./segment";
import type { TableId } from "./table";
@@ -546,3 +546,19 @@ export type TestQuerySpec = {
export type TestQuerySpecWithDatabase = TestQuerySpec & {
database: DatabaseId;
};
+
+export type TestTemplateTag = Pick<TemplateTag, "type"> &
+ Partial<Omit<TemplateTag, "dimension" | "type">> & {
+ dimension?: TableId;
+ };
+
+export type TestTemplateTags = Record<string, TestTemplateTag>;
+
+export type TestNativeQuerySpec = {
+ query: string;
+ templateTags?: TestTemplateTags;
+};
+
+export type TestNativeQuerySpecWithDatabase = TestNativeQuerySpec & {
+ database: DatabaseId;
+};
diff --git a/src/metabase/lib/core.cljc b/src/metabase/lib/core.cljc
index e619ac644fb..7b463f4dabc 100644
--- a/src/metabase/lib/core.cljc
+++ b/src/metabase/lib/core.cljc
@@ -443,6 +443,7 @@
with-wrapped-native-query
wrap-native-query-with-mbql]
[lib.query.test-spec
+ test-native-query
test-query]
[lib.ref
field-ref-id
diff --git a/src/metabase/lib/js.cljs b/src/metabase/lib/js.cljs
index 24b78d15367..fd84f1cdaa2 100644
--- a/src/metabase/lib/js.cljs
+++ b/src/metabase/lib/js.cljs
@@ -2792,3 +2792,10 @@
(-> js-query-spec
(js->clj :keywordize-keys true)
(->> (lib.query.test-spec/test-query metadata-providerable))))
+
+(defn ^:export test-native-query
+ "Creates a native query from a test native query spec."
+ [metadata-providerable js-native-query-spec]
+ (-> js-native-query-spec
+ (js->clj :keywordize-keys true)
+ (->> (lib.query.test-spec/test-native-query metadata-providerable))))
diff --git a/src/metabase/lib/query/test_spec.cljc b/src/metabase/lib/query/test_spec.cljc
index 139324c059d..37a1a8742a2 100644
--- a/src/metabase/lib/query/test_spec.cljc
+++ b/src/metabase/lib/query/test_spec.cljc
@@ -15,14 +15,17 @@
[metabase.lib.limit :as lib.limit]
[metabase.lib.metadata :as lib.metadata]
[metabase.lib.metadata.calculation :as lib.metadata.calculation]
+ [metabase.lib.native :as lib.native]
[metabase.lib.order-by :as lib.order-by]
[metabase.lib.query :as lib.query]
+ [metabase.lib.ref :as lib.ref]
[metabase.lib.schema :as lib.schema]
[metabase.lib.schema.binning :as lib.schema.binning]
[metabase.lib.schema.expression :as lib.schema.expression]
[metabase.lib.schema.join :as lib.schema.join]
[metabase.lib.schema.metadata :as lib.schema.metadata]
[metabase.lib.schema.ref :as lib.schema.ref]
+ [metabase.lib.schema.template-tag :as lib.schema.template-tag]
[metabase.lib.schema.temporal-bucketing :as lib.schema.temporal-bucketing]
[metabase.lib.schema.test-spec :as lib.schema.test-spec]
[metabase.lib.stage :as lib.stage]
@@ -330,3 +333,47 @@
source (->> stages first :source (find-source metadata-providerable))
query (lib.query/query metadata-providerable source)]
(reduce-kv append-stage-clauses query stages)))
+
+(mu/defn- field-id->field-ref :- :mbql.clause/field
+ [query :- ::lib.schema/query
+ field-id :- pos-int?]
+ (->> field-id
+ (lib.metadata/field query)
+ lib.ref/ref))
+
+(mu/defn- adjust-template-tag
+ [query :- ::lib.schema/query
+ spec :- ::lib.schema.test-spec/test-template-tag-spec]
+ (u/update-if-exists spec :dimension #(field-id->field-ref query %)))
+
+(mu/defn- adjust-template-tags :- ::lib.schema.template-tag/template-tag-map
+ [query :- ::lib.schema/query
+ inferred-template-tags :- ::lib.schema.template-tag/template-tag-map
+ template-tags-spec :- [:maybe ::lib.schema.test-spec/test-template-tags-spec]]
+ (merge-with merge
+ inferred-template-tags
+ (update-vals template-tags-spec #(adjust-template-tag query %))))
+
+(mu/defn- add-template-tags :- ::lib.schema/query
+ [query :- ::lib.schema/query
+ template-tags-spec :- [:maybe ::lib.schema.test-spec/test-template-tags-spec]]
+ (let [inferred-template-tags (or (lib.native/template-tags query) {})]
+ (->> template-tags-spec
+ (adjust-template-tags query inferred-template-tags)
+ (lib.native/with-template-tags query))))
+
+(def parse-native-query-spec
+ "Parser for native-query-spec."
+ (mc/coercer [:ref ::lib.schema.test-spec/test-native-query-spec]
+ (mtx/transformer
+ mtx/json-transformer
+ (mtx/key-transformer {:decode #(-> % u/->kebab-case-en keyword)})
+ mtx/default-value-transformer)))
+
+(mu/defn test-native-query :- ::lib.schema/query
+ "Creates a native query from a test native query spec."
+ [metadata-providerable :- ::lib.schema.metadata/metadata-providerable
+ native-query-spec :- :any]
+ (let [{:keys [query template-tags]} (parse-native-query-spec native-query-spec)]
+ (-> (lib.native/native-query metadata-providerable query)
+ (add-template-tags template-tags))))
diff --git a/src/metabase/lib/schema/test_spec.cljc b/src/metabase/lib/schema/test_spec.cljc
index d2bbc526b55..53aa193d30d 100644
--- a/src/metabase/lib/schema/test_spec.cljc
+++ b/src/metabase/lib/schema/test_spec.cljc
@@ -1,12 +1,14 @@
(ns metabase.lib.schema.test-spec
"Schemas for creating a query for testing purposes."
(:require
+ [malli.core :as mc]
[metabase.lib.schema.binning :as lib.schema.binning]
[metabase.lib.schema.common :as lib.schema.common]
[metabase.lib.schema.id :as lib.schema.id]
[metabase.lib.schema.join :as lib.schema.join]
[metabase.lib.schema.literal :as literal]
[metabase.lib.schema.order-by :as lib.schema.order-by]
+ [metabase.lib.schema.template-tag :as lib.schema.template-tag]
[metabase.lib.schema.temporal-bucketing :as lib.schema.temporal-bucketing]
[metabase.util.malli.registry :as mr]))
@@ -124,3 +126,63 @@
(mr/def ::test-query-spec
[:map
[:stages [:sequential ::test-stage-spec]]])
+
+(mr/def ::test-common-spec
+ [:map
+ [:name {:optional true} [:ref ::lib.schema.template-tag/name]]
+ [:display-name {:optional true} [:ref ::lib.schema.common/non-blank-string]]])
+
+(mr/def ::test-field-filter-spec
+ [:merge
+ [:ref ::lib.schema.template-tag/field-filter]
+ [:ref ::test-common-spec]
+ [:map
+ [:dimension [:or ::lib.schema.id/field string?]]
+ [:widget-type {:default :text} [:ref ::lib.schema.template-tag/widget-type]]]])
+
+(mr/def ::test-temporal-unit-spec
+ [:merge
+ [:ref ::lib.schema.template-tag/temporal-unit]
+ [:ref ::test-common-spec]
+ [:map
+ [:dimension [:or ::lib.schema.id/field string?]]]])
+
+(mr/def ::test-snippet-spec
+ [:merge
+ [:ref ::lib.schema.template-tag/snippet]
+ [:ref ::test-common-spec]
+ [:map
+ [:snippet-name {:optional true} ::lib.schema.common/non-blank-string]]])
+
+(mr/def ::test-source-query-spec
+ [:merge
+ [:ref ::lib.schema.template-tag/source-query]
+ [:ref ::test-common-spec]
+ [:map
+ [:card-id {:optional true} ::lib.schema.id/card]]])
+
+(mr/def ::test-raw-value-spec
+ [:merge
+ [:ref ::lib.schema.template-tag/raw-value]
+ [:ref ::test-common-spec]])
+
+(mr/def ::test-template-tag-spec
+ [:map
+ [:type ::lib.schema.template-tag/type]]
+ [:multi {:dispatch (comp keyword :type)}
+ [:temporal-unit [:ref ::test-temporal-unit-spec]]
+ [:dimension [:ref ::test-field-filter-spec]]
+ [:snippet [:ref ::test-snippet-spec]]
+ [:card [:ref ::test-source-query-spec]]
+ ;; :number, :text, :date, :boolean
+ [::mc/default [:ref ::test-raw-value-spec]]])
+
+(mr/def ::test-template-tags-spec
+ [:map-of
+ ::lib.schema.template-tag/name
+ ::test-template-tag-spec])
+
+(mr/def ::test-native-query-spec
+ [:map
+ [:query string?]
+ [:template-tags {:optional true :default {}} [:maybe [:ref ::test-template-tags-spec]]]])
diff --git a/src/metabase/testing_api/api.clj b/src/metabase/testing_api/api.clj
index abeaa308dab..f4c2de5c5e8 100644
--- a/src/metabase/testing_api/api.clj
+++ b/src/metabase/testing_api/api.clj
@@ -253,3 +253,14 @@
[:ref ::lib.schema.test-spec/test-query-spec]]]
(-> (lib-be/application-database-metadata-provider database)
(lib/test-query query-spec)))
+
+(api.macros/defendpoint :post "/native-query" :- ::lib.schema/query
+ "Creates a native query from a test query spec."
+ [_route-params
+ _query-params
+ {:keys [database], :as native-query-spec} :- [:merge
+ [:map
+ [:database ::lib.schema.id/database]]
+ [:ref ::lib.schema.test-spec/test-native-query-spec]]]
+ (-> (lib-be/application-database-metadata-provider database)
+ (lib/test-native-query native-query-spec)))
diff --git a/test/metabase/lib/query/test_spec_test.cljc b/test/metabase/lib/query/test_spec_test.cljc
index 68cd7dee5d7..a55fd9028a9 100644
--- a/test/metabase/lib/query/test_spec_test.cljc
+++ b/test/metabase/lib/query/test_spec_test.cljc
@@ -1004,3 +1004,270 @@
(is (empty? (lib/fields query 2)))
(is (= 25 (lib/current-limit query 2))))))
+
+(deftest ^:parallel test-native-query-basic-test
+ (testing "test-native-query creates a basic native query without template tags"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM orders"})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM orders"))
+ (is (empty? (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-text-tag-test
+ (testing "test-native-query creates a native query with text template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues WHERE name = {{venue_name}}"
+ :template-tags {"venue_name" {:type :text
+ :name "venue_name"
+ :display-name "Venue Name"}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE name = {{venue_name}}"))
+
+ (is (=? {"venue_name" {:type :text
+ :name "venue_name"
+ :display-name "Venue Name"}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-number-tag-test
+ (testing "test-native-query creates a native query with number template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues WHERE price = {{price}}"
+ :template-tags {"price" {:type :number
+ :name "price"
+ :display-name "Price"}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE price = {{price}}"))
+ (is (=? {"price" {:type :number
+ :name "price"
+ :display-name "Price"}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-date-tag-test
+ (testing "test-native-query creates a native query with date template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM orders WHERE created_at = {{date}}"
+ :template-tags {"date" {:type :date
+ :name "date"
+ :display-name "Date"}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM orders WHERE created_at = {{date}}"))
+ (is (=? {"date" {:type :date
+ :name "date"
+ :display-name "Date"}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-boolean-tag-test
+ (testing "test-native-query creates a native query with boolean template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM users WHERE active = {{is_active}}"
+ :template-tags {"is_active" {:type :boolean
+ :name "is_active"
+ :display-name "Is Active"}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM users WHERE active = {{is_active}}"))
+
+ (is (=? {"is_active" {:type :boolean
+ :name "is_active"
+ :display-name "Is Active"}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-dimension-tag-test
+ (testing "test-native-query creates a native query with dimension (field-filter) template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues WHERE {{category_filter}}"
+ :template-tags {"category_filter" {:type :dimension
+ :name "category_filter"
+ :display-name "Category Filter"
+ :dimension (meta/id :venues :category-id)
+ :widget-type :text}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE {{category_filter}}"))
+
+ (is (=? {"category_filter" {:type :dimension
+ :name "category_filter"
+ :display-name "Category Filter"
+ :dimension [:field {} (meta/id :venues :category-id)]
+ :widget-type :text}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-temporal-unit-tag-test
+ (testing "test-native-query creates a native query with temporal-unit template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM orders WHERE {{date_unit}}"
+ :template-tags {"date_unit" {:type :temporal-unit
+ :name "date_unit"
+ :display-name "Date Unit"
+ :dimension (meta/id :orders :created-at)}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM orders WHERE {{date_unit}}"))
+
+ (is (=? {"date_unit" {:type :temporal-unit
+ :name "date_unit"
+ :display-name "Date Unit"
+ :dimension [:field {} (meta/id :orders :created-at)]}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-snippet-tag-test
+ (testing "test-native-query creates a native query with snippet template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM {{snippet: my-snippet}}"
+ :template-tags {"snippet: my-snippet" {:type :snippet
+ :name "snippet: my-snippet"
+ :display-name "My Snippet"
+ :snippet-name "my-snippet"}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM {{snippet: my-snippet}}"))
+
+ (is (=? {"snippet: my-snippet" {:type :snippet
+ :name "snippet: my-snippet"
+ :display-name "My Snippet"
+ :snippet-name "my-snippet"}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-card-tag-test
+ (testing "test-native-query creates a native query with card (source-query) template tag"
+ (let [query (lib.query.test-spec/test-native-query
+ lib.tu/metadata-provider-with-card
+ {:database-id (meta/id)
+ :query "SELECT * FROM {{#123}}"
+ :template-tags {"#123" {:type :card
+ :name "#123"
+ :display-name "Card 123"
+ :card-id 1}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM {{#123}}"))
+
+ (is (=? {"#123" {:type :card
+ :name "#123"
+ :display-name "Card 123"
+ :card-id 1}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-with-multiple-tags-test
+ (testing "test-native-query creates a native query with multiple template tags"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues WHERE name = {{name}} AND price > {{min_price}} AND {{category_filter}}"
+ :template-tags {"name" {:type :text
+ :name "name"
+ :display-name "Name"}
+ "min_price" {:type :number
+ :name "min_price"
+ :display-name "Min Price"}
+ "category_filter" {:type :dimension
+ :name "category_filter"
+ :display-name "Category Filter"
+ :dimension (meta/id :venues :category-id)
+ :widget-type :text}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE name = {{name}} AND price > {{min_price}} AND {{category_filter}}"))
+
+ (is (=? {"name" {:type :text
+ :name "name"
+ :display-name "Name"}
+ "min_price" {:type :number
+ :name "min_price"
+ :display-name "Min Price"}
+ "category_filter" {:type :dimension
+ :name "category_filter"
+ :display-name "Category Filter"
+ :dimension [:field {} (meta/id :venues :category-id)]
+ :widget-type :text}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-inferred-tags-test
+ (testing "test-native-query infers template tags from query text"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues WHERE name = {{venue_name}}"
+ :template-tags {"venue_name" {:type :text
+ :display-name "Custom Name"
+ :default "Foo"
+ :widget-type "string/contains"
+ :required true}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE name = {{venue_name}}"))
+
+ (is (=? {"venue_name" {:type :text
+ :name "venue_name"
+ :display-name "Custom Name"
+ :default "Foo"
+ :required true
+ :widget-type "string/contains"
+ :id string?}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-empty-template-tags-test
+ (testing "test-native-query handles explicit empty template tags"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM orders"
+ :template-tags {}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM orders"))
+ (is (empty? (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-inferred-tags-test-from-js
+ (testing "test-native-query infers template tags from query text, when passing spec from JS"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ "query" "SELECT * FROM venues WHERE name = {{venue_name}}"
+ "templateTags" {"venue_name" {:type :text
+ :displayName "Custom Name"
+ :default "Foo"
+ :widgetType "string/contains"
+ :required true}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues WHERE name = {{venue_name}}"))
+
+ (is (=? {"venue_name" {:type :text
+ :name "venue_name"
+ :display-name "Custom Name"
+ :default "Foo"
+ :required true
+ :widget-type "string/contains"
+ :id string?}}
+ (lib/template-tags query))))))
+
+(deftest ^:parallel test-native-query-inferred-optional-tags-test
+ (testing "test-native-query infers optional template tags from query text"
+ (let [query (lib.query.test-spec/test-native-query
+ meta/metadata-provider
+ {:database-id (meta/id)
+ :query "SELECT * FROM venues [WHERE name = {{venue_name}}]"
+ :template-tags {"venue_name" {:type :text
+ :display-name "Custom Name"
+ :default "Foo"
+ :widget-type "string/contains"
+ :required true}}})]
+ (is (=? (lib/raw-native-query query)
+ "SELECT * FROM venues [WHERE name = {{venue_name}}]"))
+
+ (is (=? {"venue_name" {:type :text
+ :name "venue_name"
+ :display-name "Custom Name"
+ :default "Foo"
+ :required true
+ :widget-type "string/contains"
+ :id string?}}
+ (lib/template-tags query))))))