sql_to_dax

作者: microsoft

将SQL聚合表达式转换为DAX度量的指南。

npx skills add https://github.com/microsoft/semantic-link-labs --skill sql_to_dax

SKILL.md — SQL to DAX Metric Translation

Purpose

Translate analytical SQL aggregation expressions into equivalent DAX measures.

The goal is semantic equivalence, not syntactic similarity.

The generated DAX should:

  • Follow Power BI / Tabular best practices
  • Prefer iterator functions when row context is required
  • Use DIVIDE instead of / NULLIF(...,0)
  • Fully qualify columns using 'table'[column]
  • Use CALCULATE where filter context translation is required
  • Preserve aggregation semantics exactly
  • Avoid SQL constructs unsupported in DAX by rewriting logically

SQL Identifier Parsing Rules

The SQL source may reference columns using any of the following formats:

column_name
table.column_name
table.`column name`

The translator must normalize all forms into valid DAX column references.


Identifier Normalization Rules

SQL FormatDAX Format
column_name'table'[column_name]
table.column_name'table'[column_name]
table.column name'table'[column name]

Backtick Handling

SQL backticks must be removed during translation.

SQL

dim_product.`standard cost`

DAX

'dim_product'[standard cost]

Unqualified Column Resolution

If a column is referenced without a table qualifier:

SUM(SALES_AMOUNT)

The translator should:

  1. Infer the table from model metadata if available
  2. Prefer the primary fact table in the expression
  3. Fully qualify the final DAX output

DAX

SUM('fact_sales'[SALES_AMOUNT])

Important — bare identifiers inside scalar aggregates must NOT become iterators.

When a SQL aggregate wraps a single bare identifier (e.g. SUM(ORIGINAL_SALES_AMOUNT), SUM(COST_OF_GOODS_SOLD)) and that identifier is not declared as a column in the model metadata, the translator must still emit the scalar aggregation form against the default/owning table:

SUM('fact_returns'[ORIGINAL_SALES_AMOUNT])

It must not fall through to the iterator form:

SUMX('fact_returns', ORIGINAL_SALES_AMOUNT)   -- INVALID

Iterators (SUMX, AVERAGEX, etc.) are reserved for cases where the aggregate argument contains arithmetic or references multiple columns. A single bare token is always a scalar aggregation.


Mixed Identifier Formats

Expressions may mix styles.

SQL

SUM(fact_sales.`sales amount` - DISCOUNT_AMOUNT)

DAX

SUMX(
    'fact_sales',
    'fact_sales'[sales amount] -
    'fact_sales'[DISCOUNT_AMOUNT]
)

Core Translation Rules


1. Aggregate Functions

SQL

SUM(column)

DAX

SUM('table'[column])

SQL

AVG(column)

DAX

AVERAGE('table'[column])

SQL

COUNT(DISTINCT column)

DAX

DISTINCTCOUNT('table'[column])

2. Arithmetic Inside Aggregations

If arithmetic occurs inside SUM/AVG/etc., use iterator functions.

SQL

SUM(price * quantity)

DAX

SUMX(
    'table',
    'table'[price] * 'table'[quantity]
)

SQL

SUM(revenue - discount)

DAX

SUMX(
    'table',
    'table'[revenue] - 'table'[discount]
)

SQL

AVG(quantity * cost)

DAX

AVERAGEX(
    'table',
    'table'[quantity] * 'table'[cost]
)

Iterator Function Rules

Use iterator functions when:

  • Multiple columns participate in row-level arithmetic
  • Expressions exist inside aggregate functions
  • Mixed table references occur inside aggregation
SQL AggregateDAX Iterator
SUM(expr)SUMX(table, expr)
AVG(expr)AVERAGEX(table, expr)
MIN(expr)MINX(table, expr)
MAX(expr)MAXX(table, expr)

Safe Division


SQL NULLIF Pattern

SQL

SUM(sales) / NULLIF(SUM(cost), 0)

DAX

DIVIDE(
    SUM('table'[sales]),
    SUM('table'[cost])
)

Nested NULLIF

SQL

365 / NULLIF(metric, 0)

DAX

DIVIDE(
    365,
    [metric]
)

Percentage Calculations


SQL

(metric / total) * 100

DAX

DIVIDE(
    [metric],
    [total]
) * 100

ROUND Translation


SQL

ROUND(expression, 2)

DAX

ROUND(expression, 2)

DIV0 Translation

DIV0 means divide-by-zero-safe division.

SQL

DIV0(a, b)

DAX

DIVIDE(a, b)

Window Function Translation


Rolling Window SUM

Translate <agg>(<inner>) OVER (ORDER BY <col> ROWS BETWEEN N PRECEDING AND CURRENT ROW) into a CALCULATE wrapping the inner aggregation with a DATESINPERIOD filter over the ORDER BY column.

Rules:

  • The window's ORDER BY column becomes the date column passed to DATESINPERIOD. It is resolved through the column map and fully qualified as 'table'[column].
  • MAX(<order_col>) is used as the anchor date.
  • ROWS BETWEEN N PRECEDING AND CURRENT ROW becomes -N, DAY. The skill preserves the literal N from the SQL (e.g. 89 PRECEDING → -89, DAY) rather than rounding up to the inclusive day count.
  • When the inner expression is itself an aggregate (a non-standard but common Snowflake/BigQuery pattern such as SUM(SUM(...)) OVER (...)), the redundant outer aggregate is stripped and only the inner aggregation body is preserved.
  • The inner aggregation body is translated using the normal aggregation rules (including the additive distribution rule that turns SUM(a - b) into (SUM(a) - SUM(b))).

SQL

SUM(metric)
OVER (
    ORDER BY DATE_KEY
    ROWS BETWEEN 89 PRECEDING AND CURRENT ROW
)

DAX

CALCULATE(
    [metric],
    DATESINPERIOD(
        'dim_date'[date_key],
        MAX('dim_date'[date_key]),
        -89,
        DAY
    )
)

Rolling Window over a Nested Aggregate

SQL

SUM(
    SUM(EXTENDED_AMOUNT - DISCOUNT_AMOUNT)
) OVER (
    ORDER BY DATE_KEY
    ROWS BETWEEN 89 PRECEDING AND CURRENT ROW
)

DAX

CALCULATE(
    (
        SUM('fact_sales'[sales_amount])
        - SUM('fact_sales'[discount_amount])
    ),
    DATESINPERIOD(
        'dim_date'[date_key],
        MAX('dim_date'[date_key]),
        -89,
        DAY
    )
)

Equivalently (when distribution is not applied), the inner body may be emitted in iterator form:

CALCULATE(
    SUMX(
        'fact_sales',
        'fact_sales'[sales_amount] - 'fact_sales'[discount_amount]
    ),
    DATESINPERIOD(
        'dim_date'[date_key],
        MAX('dim_date'[date_key]),
        -89,
        DAY
    )
)

Unbounded Window

An unbounded window (OVER () with no PARTITION BY, ORDER BY, or frame) ignores the current filter context entirely. Translate it to the iterator form of the aggregate over ALL(<table>) — not to CALCULATE(<agg>, ALL(<table>)).

SQL aggregateDAX
SUM(col) OVER ()SUMX(ALL('table'), 'table'[col])
AVG(col) OVER ()AVERAGEX(ALL('table'), 'table'[col])
MIN(col) OVER ()MINX(ALL('table'), 'table'[col])
MAX(col) OVER ()MAXX(ALL('table'), 'table'[col])
COUNT(col) OVER ()COUNTX(ALL('table'), 'table'[col])
COUNT(*) OVER ()COUNTROWS(ALL('table'))
COUNT(DISTINCT col) OVER ()CALCULATE(DISTINCTCOUNT('table'[col]), ALL('table'))

SQL

MAX(cutoff) OVER ()

DAX

MAXX(ALL('table'), 'table'[cutoff])

SQL

SUM(amount) OVER ()

DAX

SUMX(ALL('table'), 'table'[amount])

CASE WHEN Translation


Conditional DISTINCTCOUNT

SQL

COUNT(DISTINCT CASE
    WHEN order_count > 1
    THEN customer_key
END)

DAX

CALCULATE(
    DISTINCTCOUNT('table'[customer_key]),
    'table'[order_count] > 1
)

Multi-Table Arithmetic

When expressions reference multiple tables:

  • Preserve table qualification
  • Use iterator functions
  • Choose the fact table as the iterator table when possible

Iterator Table Selection from Relationships

When an X-function (SUMX, AVERAGEX, COUNTX, MINX, MAXX) is needed and the inner expression references two tables that participate in a relationship, choose the iterator table as the "from" side of that relationship (typically the many / fact side). Wrap any column reference to the "to" side (typically the one / dimension side) in RELATED(...).

This rule is independent of the table that the measure is defined on — what matters is which table is on the many side of the relationship linking the two referenced tables.

Example

Given a relationship: fact_sales (Many) → dim_product (One)

SQL

SUM(dim_product.standard_cost * fact_sales.quantity_sold)

DAX

SUMX(
    'fact_sales',
    RELATED('dim_product'[standard_cost]) *
    'fact_sales'[quantity_sold]
)

Even when this measure is authored on the dim_product table, the iterator table is still fact_sales because fact_sales is the "from" side of the relationship.


SQL

SUM(dim_product.standard_cost * fact_sales.quantity)

DAX

SUMX(
    'fact_sales',
    RELATED('dim_product'[standard_cost]) *
    'fact_sales'[quantity]
)

SQL

SUM(
    (EXTENDED_AMOUNT - DISCOUNT_AMOUNT)
    - (STANDARD_COST * QUANTITY)
)

DAX

SUMX(
    'fact_sales',
    ('fact_sales'[EXTENDED_AMOUNT] - 'fact_sales'[DISCOUNT_AMOUNT])
    -
    (
        RELATED('dim_product'[STANDARD_COST]) *
        'fact_sales'[QUANTITY]
    )
)

KPI Translation Patterns


Profit

SQL

SUM(revenue - cost)

DAX

SUMX(
    'fact',
    'fact'[revenue] - 'fact'[cost]
)

Margin %

SQL

SUM(profit)
/
NULLIF(SUM(revenue), 0)

DAX

DIVIDE(
    [Profit],
    [Revenue]
)

Return Rate %

SQL

SUM(return_amount)
/
NULLIF(SUM(original_sales_amount), 0)

DAX

DIVIDE(
    SUM('fact_returns'[return_amount]),
    SUM('fact_sales'[original_sales_amount])
)

Table Qualification Rules


Always Qualify Columns

Preferred:

'fact_sales'[sales_amount]

Avoid:

[sales_amount]

Relationship Translation


SQL Join Semantics

When SQL implies dimension lookup:

SQL

dim_product.standard_cost

inside fact aggregation becomes:

DAX

RELATED('dim_product'[standard_cost])

Translation Heuristics


Detect Iterator Requirement

Use X-iterators when:

  • Expression contains operators inside aggregation
  • More than one column appears inside SUM/AVG/etc.
  • Arithmetic mixes dimensions and facts

Detect Measure References

Nested aggregates inside a window function are flattened — the redundant outer aggregate is dropped and only the inner aggregate body is wrapped in CALCULATE.

SQL

SUM(SUM(revenue)) OVER (
    ORDER BY DATE_KEY
    ROWS BETWEEN 89 PRECEDING AND CURRENT ROW
)

DAX

CALCULATE(
    SUM('fact_sales'[revenue]),
    DATESINPERIOD(
        'dim_date'[date_key],
        MAX('dim_date'[date_key]),
        -89,
        DAY
    )
)

Common SQL → DAX Mappings

SQLDAX
SUM(col)SUM(table[col])
AVG(col)AVERAGE(table[col])
COUNT(DISTINCT col)DISTINCTCOUNT(table[col])
NULLIF(x,0)DIVIDE(... )
ROUND(x,n)ROUND(x,n)
CASE WHENCALCULATE/FILTER
OVER(...)CALCULATE + time intelligence
SUM(a*b)SUMX(table,a*b)

Example Translations


Example 1

SQL

SUM(store_sales.ss_sales_price * store_sales.ss_quantity)

DAX

SUMX(
    'store_sales',
    'store_sales'[ss_sales_price] *
    'store_sales'[ss_quantity]
)

Example 2

SQL

SUM(ATTRIBUTED_REVENUE)
/
NULLIF(SUM(SPEND_AMOUNT), 0)

DAX

DIVIDE(
    SUM('fact_marketing'[ATTRIBUTED_REVENUE]),
    SUM('fact_marketing'[SPEND_AMOUNT])
)

Example 3

SQL

(
  COUNT(DISTINCT CASE
    WHEN CUSTOMER_ORDER_COUNT > 1
    THEN CUSTOMER_KEY
  END)
  /
  NULLIF(COUNT(DISTINCT CUSTOMER_KEY), 0)
) * 100

DAX

DIVIDE(
    CALCULATE(
        DISTINCTCOUNT('customer'[CUSTOMER_KEY]),
        'customer'[CUSTOMER_ORDER_COUNT] > 1
    ),
    DISTINCTCOUNT('customer'[CUSTOMER_KEY])
) * 100

Output Requirements

Generated DAX must:

  • Be valid Power BI DAX syntax
  • Use proper indentation
  • Use uppercase DAX functions
  • Prefer DIVIDE over /
  • Prefer iterators over invalid scalar arithmetic
  • Preserve business semantics exactly
  • Avoid unnecessary CALCULATE wrappers
  • Use RELATED for dimension attribute access
  • Use measures when semantic reuse is implied

Important Semantic Differences

SQL is row-set based.

DAX is filter-context based.

Correct translation often requires:

  • Iterator functions
  • Context transition
  • Relationship navigation
  • Measure decomposition

Do not attempt direct token replacement.

来自 microsoft 的更多技能

oss-growth
microsoft
OSS增长黑客角色
agent-framework-azure-ai-py
microsoft
使用Microsoft Agent Framework Python SDK(agent-framework-azure-ai)构建Azure AI Foundry代理。在创建使用AzureAIAgentsProvider的持久化代理、使用托管工具(代码解释器、文件搜索、网络搜索)、集成MCP服务器、管理对话线程或实现流式响应时使用。涵盖函数工具、结构化输出和多工具代理。
development
airunway-aks-setup
microsoft
在AKS上设置AI Runway——从裸集群到运行模型。涵盖集群验证、控制器安装、GPU评估、提供商设置和首次部署。适用场景:“设置AI Runway”、“接入AKS集群”、“安装AI Runway”、“airunway设置”、“将模型部署到AKS”、“在AKS上进行GPU推理”、“在AKS上配置KAITO”、“在AKS上运行LLM”、“在AKS上使用vLLM”、“在AKS上设置模型服务”、“AI Runway控制器”。
devops
appinsights-instrumentation
microsoft
使用Azure Application Insights对Web应用进行插桩的指南。提供遥测模式、SDK设置和配置参考。适用场景:如何对应用进行插桩、App Insights SDK、遥测模式、什么是App Insights、Application Insights指南、插桩示例、APM最佳实践。
devops
applicationinsights-web-ts
microsoft
使用Application Insights JavaScript SDK(@microsoft/applicationinsights-web)为浏览器/Web应用添加检测。用于真实用户监控(RUM)——页面视图、点击、AJAX/fetch依赖项、异常、自定义事件,以及与后端OpenTelemetry追踪关联的浏览器端GenAI代理追踪。涵盖SDK加载器脚本和npm设置、框架扩展(React、React Native、Angular)、点击分析、遥测初始化器,以及从浏览器发出的代理/工具/模型跨度所遵循的OTel GenAI语义约定。
devops
azure-ai-anomalydetector-java
microsoft
使用适用于 Java 的 Azure AI 异常检测器 SDK 构建异常检测应用程序。在实现单变量/多变量异常检测、时间序列分析或 AI 驱动的监控时使用。
development
azure-ai-language-conversations-py
microsoft
使用azure-ai-language-conversations Python SDK实现对话语言理解(CLU)。当使用ConversationAnalysisClient分析对话意图和实体、构建NLP功能或将语言理解集成到应用程序中时使用。
development
azure-ai-ml-py
microsoft
Azure Machine Learning SDK v2 for Python。用于机器学习工作区、作业、模型、数据集、计算资源和管道。 触发词:“azure-ai-ml”、“MLClient”、“工作区”、“模型注册表”、“训练作业”、“数据集”。
development