Примеры запросов для программной аналитики для коммерческой платформы
В этой статье приведены примеры запросов к отчетам о заказах, использовании и клиентах коммерческой площадки Microsoft. Вы можете ссылаться на эти запросы и создавать дополнительные запросы в зависимости от вашего сценария использования, вызвав конечную точку API для создания запросов отчетов.
Дополнительные сведения о именах столбцов, атрибутах и описаниях см. в следующих статьях:
- панель мониторинга клиентов
- панель мониторинга заказов
- панель мониторинга использования
- панель мониторинга Marketplace Insights
- панель мониторинга выручки
- панель мониторинга качества обслуживания
- панель мониторинга удержания клиентов
- панель управления лицензиями
- Показатели качества обслуживания
Запросы, о которых сообщают клиенты
Эти примеры запросов применяются к отчету "Клиенты".
| Описание запросов | пример запроса |
|---|---|
| Список сведений о клиентах с активными клиентами партнера до выбранной вами даты. | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Выведите список сведений о клиентах, включая ушедших клиентов партнера, до выбранной вами даты. | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Список новых клиентов из определенного географического региона за последние шесть месяцев | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Запросы отчета об использовании
Эти примеры запросов применяются к отчету об использовании.
| Описание запроса | пример запроса |
|---|---|
| Перечислите сведения об использовании с нормализованным использованием ВМ для типа лицензии "Выставлено через Azure" на Marketplace за последние 6 месяцев. | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Перечисление сведений об использовании с сырьевой мощностью ВМ для типа лицензии Marketplace "Выставление счетов через Azure" за последние 12 месяцев. | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Список сведений об использовании с нормализованным использованием виртуальной машины для типа лицензии Marketplace "Принести собственную лицензию" за последние 6 месяцев. | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Перечислить детали использования и необработанное использование виртуальной машины для лицензии типа "Принести собственную лицензию" в Marketplace за последние 6 месяцев. | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Укажите сведения об использовании с датой использования, нормализованным ежедневным использованием и «Предполагаемые расширенные расходы (PC/CC)» для платных планов за последний месяц | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Список данных об использовании с датой использования, ежедневным общим объемом использования без обработки и "Предполагаемыми расширенными расходами (PC/CC)" за платные планы за прошедший месяц. | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Список сведений об использовании с названием предложения, нормализованным использованием ВМ для типа лицензии Marketplace "Выставление счетов через Azure" за последние 6 месяцев. | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Перечисление сведений об использовании с названием предложения, учтенное использование за последние 6 месяцев | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Перечислите всю информацию об использовании всех предложений за последние 6 месяцев | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Перечислите все сведения об использовании частных предложений за последние 6 месяцев. | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Запросы на отчеты о заказах
Эти примерные запросы применяются к отчету "Заказы".
| Описание запроса | пример запроса |
|---|---|
| Список сведений о заказе для типа лицензии Azure как Enterprise для последних 6M | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Перечислите детали заказа для типа лицензии Azure "Оплата по мере использования" за последние 6 месяцев. | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Детали заказа для конкретного предложения за последние 6 месяцев | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Список сведений об активных заказах за последние 6 месяцев. | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Список сведений об отмененных заказах за последние 6 месяцев | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Перечисление сведений о заказах с количеством, датой начала срока, датой окончания срока, расчетными расходами и валютой за последние 6 месяцев. | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Сведения о заказах для пробных заказов, активных в течение последних 6 месяцев | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Список сведений о заказах по всем предложениям, активных в течение последних 6 месяцев. | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Сведения о заказах для частных предложений, активных в течение последних 6 месяцев | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Вопросы отчета о доходах
Эти примеры запросов применяются к отчету о доходах.
| Описание запроса | пример запроса |
|---|---|
| Список выставленных доходов партнера за последний месяц | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Перечислите предполагаемую выручку в долларах США для всех транзакций со статусом "отправлено" за последние три месяца | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Список непробовых транзакций для модели выставления счетов на основе подписки | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Качество запросов отчета об обслуживании
Этот пример запроса применяется к отчету о качестве обслуживания.
| Описание запроса | пример запроса |
|---|---|
| Перечисление статусов развертывания предложений за последние 6 месяцев | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Запросы отчета об удержании клиентов
Этот пример запроса применяется к отчету об удержании клиентов.
| Описание запроса | пример запроса |
|---|---|
| Перечислите информацию об удержании клиентов за последние 6 месяцев | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Перечисление сведений об активности использования и выручке всех клиентов за последние 6 месяцев | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |