商业市场的自定义查询规范

合作伙伴可以使用此查询规范轻松地构建自定义查询,以便从分析表中提取数据。 查询可用于仅选择符合特定条件的所需列和指标。 语言规范的核心是可在其基础上编写自定义查询的数据集定义。

数据集

自定义查询可以针对具有列和指标的数据集而运行,其方式与针对某个具有表和列的数据库运行某些查询的方式相同。 可通过数据集 API 获取可用于构建查询的数据集的完整列表。

下面是显示为 JSON 的数据集的示例。

{
            "datasetName": "ISVUsage",
            "selectableColumns": [
                "MarketplaceSubscriptionId",
                "MonthStartDate",
                "OfferType",
                "AzureLicenseType",
                "MarketplaceLicenseType",
                "SKU",
                "CustomerCountry",
                "IsPreviewSKU",
                "SKUBillingType",
                "VMSize",
                "CloudInstanceName",
                "OfferName",
                "IsPrivateOffer",
                "DeploymentMethod",
                "CustomerName",
                "CustomerCompanyName",
                "UsageDate",
                "IsNewCustomer",
                "CoreSize",
                "TrialEndDate",
                "CustomerCurrencyCC",
                "PriceCC",
                "PayoutCurrencyPC",
                "EstimatedPricePC",
                "UsageReference",
                "UsageUnit",
                "CustomerId",
                "BillingAccountId",
                "MeterDimension",
                "MeterId",
                "PartnerCenterDetectedAnomaly",
                "PublisherMarkedAnomaly",
                "NewReportedUsage",
                "ActionTakenAt",
                "ActionTakenBy",
                "PlanId",
                "ReferenceId",
                "ListPriceUSD",
                "DiscountedPriceUSD",
                "IsPrivatePlan",
                "OfferId",
                "PrivateOfferId",
                "PrivateOfferName",
                "BillingId",
                "PlanType",
                "CustomerAccess",
                "PublisherAccess",
                "CustomerAdjustmentUSD",
                "MultiParty",
                "PartnerInfo",
                "SalesNotes",
                "IsCustomMeter",
                "AssetId",
                "IsMultisolution",
                "VMSubscription"
            ],
            "availableMetrics": [
                "NormalizedUsage",
                "MeteredUsage",
                "RawUsage",
                "EstimatedExtendedChargeCC",
                "EstimatedExtendedChargePC",
                "EstimatedFinancialImpactUSD"
            ],
            "availableDateRanges": [
                "LAST_MONTH",
                "LAST_3_MONTHS",
                "LAST_6_MONTHS",
                "LAST_1_YEAR",
                "LAST_3_YEARS"
            ],
            "minimumRecurrenceInterval": 1
        }

数据集的各个部分

  • 数据集名称类似于数据库表名称。 例如,ISVUsage。 数据集包含可以选择的列(如 MarketplaceSubscriptionId)的列表。
  • 数据集还包含指标,指标类似于数据库中的聚合函数。 例如,NormalizedUsage。
  • 存在可以导出其范围内数据的固定时间跨度。

在数据集上构建查询

下面是一些示例查询,它们演示了如何提取各种类型的数据。

查询 说明
SELECT MarketplaceSubscriptionId,CustomerId FROM ISVUsage TIMESPAN LAST_MONTH 此查询获取过去一个月的每一 MarketplaceSubscriptionId 个及其对应的 CustomerId 查询。
SELECT MarketplaceSubscriptionId, EstimatedExtendedChargeCC FROM ISVUsage ORDER BY EstimatedExtendedChargeCC LIMIT 10 此查询按每个订阅下销售的许可证数的减少顺序获取前 10 个订阅。
SELECT CustomerId, NormalizedUsage, RawUsage FROM ISVUsage WHERE NormalizedUsage > 100000 ORDER BY NormalizedUsage TIMESPAN LAST_6_MONTHS 此查询获取 NormalizedUsage 和 RawUsage 的所有客户,其 NormalizedUsage 大于 100,000。
SELECT MarketplaceSubscriptionId, MonthStartDate, NormalizedUsage FROM ISVUsage WHERE CustomerId IN ('2a31c234-1f4e-4c60-909e-76d234f93161', '80780748-3f9a-11eb-b378-0242ac130002') 此查询按以下两CustomerId个值获取MarketplaceSubscriptionId每月的规范化用法: 2a31c234-1f4e-4c60-909e-76d234f9316180780748-3f9a-11eb-b378-0242ac130002

查询规范

此部分介绍查询定义和结构。

语法参考

下表介绍了查询中使用的符号。

符号 含义
可选
* 零个或更多
+ 一个或更多
| 或/列表之一

查询定义

查询语句包含以下子句:SelectClause、FromClause、WhereClause?、OrderClause?、LimitClause? 和 TimeSpan?。

  • SelectClauseSELECT ColumOrMetricName (, ColumOrMetricName)*
    • ColumOrMetricName:在数据集中定义的列和指标
  • FromClauseFROM DatasetName
    • DatasetName:在数据集中定义的数据集名称
  • WhereClauseWHERE FilterCondition (AND FilterCondition)*
    • FilterCondition:ColumOrMetricName 运算符值
      • Operator: = | > | < | >= | <= | != | LIKE | NOT LIKE | IN | NOT IN
      • :数字 |StringLiteral |MultiNumberList |MultiStringList
        • Number:-? [0-9]+ (. [0-9] [0-9]*)?
        • StringLiteral: ' [a-zA-Z0-9_]*'
        • MultiNumberList: (Number (,Number)*)
        • MultiStringList:(StringLiteral (,StringLiteral)*)
  • OrderClauseORDER BY OrderCondition (,OrderCondition)*
    • OrderCondition:ColumOrMetricName (ASC | DESC)*
  • LimitClauseLIMIT [0-9]+
  • TimeSpan: TIMESPAN ( TODAY |昨天 |LAST_7_DAYS |LAST_14_DAYS |LAST_30_DAYS |LAST_90_DAYS |LAST_180_DAYS |LAST_365_DAYS |LAST_MONTH |LAST_3_MONTHS |LAST_6_MONTHS |LAST_1_YEAR)

查询结构

报表查询由多个部分组成:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT
  • TIMESPAN

下面对每个部分进行了介绍。

SELECT

查询的这一部分指定导出的列。 可以选择的列是数据集的 selectableColumnsavailableMetrics 部分列出的字段。 如果所选字段列表中包含一个指标列,则会针对非对称列的每个非重复组合计算指标。

示例:

  • SELECT OfferName, NormalizedUsage

DISTINCT

在 SELECT 之后添加 DISTINCT 关键字可确保最终导出的数据没有任何重复行。 DISTINCT 关键字的工作方式与是否选择了指标列无关。

示例:

  • SELECT DISTINCT MarketplaceSubscriptionId, OfferType

FROM

查询的此部分指示需要从中导出数据的数据集。 此处提供的数据集名称需要是数据集 API 返回的有效数据集名称。

示例:

  • FROM ISVUsage
  • FROM ISVOrder

WHERE

查询的此部分用于指定数据集上的筛选条件。 只有匹配此子句中列出的所有条件的行才会出现在最终导出的文件中。 筛选条件可以位于 selectableColumnsavailableMetrics 中列出的任意列上。 仅当运算符为 INNOT IN 时,筛选条件中指定的值才能是数字列表或字符串列表。 这些值始终可以作为文本字符串提供,它们将转换为本机类型的列。 需要使用 AND 运算将多个筛选条件分开。

示例:

  • MarketplaceSubscriptionId = '868368da-957d-4959-8992-3c12dc7e6260'
  • CustomerName LIKE '%Contosso%'
  • CustomerId NOT IN (1000, 1001, 1002)
  • OrderQuantity=100
  • OrderQuantity='100'
  • MarketplaceSubscriptionId='7b487ac0-ce12-b732-dcd6-91a1e4e74a50' AND CustomerId=' 0f8b7fa0-eb83-a183-1225-ca153ef807aa'

ORDER BY

查询的此部分指定已导出行的排序条件。 可以在其上定义排序的列需要来自数据集的 selectableColumnsavailableMetrics。 如果没有指定的排序方向,则默认为 DESC 列上。 可以通过使用逗号来分隔条件,在多个列上定义排序。

示例:

  • ORDER BY NormalizedUsage ASC, EstimatedExtendedCharge(CC) DESC
  • ORDER BY CustomerName ASC, NormalizedUsage

LIMIT

查询的这一部分指定导出的行数。 指定的数字必须是非零正整数。

TIMESPAN

查询的此部分指定一个持续时间,该时间范围内的数据需要导出。 可能的值应来自数据集定义中的 availableDateRanges 字段。

查询规范中的区分大小写

规范完全不区分大小写。 可以使用大写或小写来指定预定义关键字、列名称和值。

另请参阅