Beispielabfragen für programmgesteuerte Analysen für den kommerziellen Marketplace
Dieser Artikel enthält Beispielabfragen zu den Berichten über Bestellungen, Nutzung und Kunden des kommerziellen Marketplace von Microsoft. Sie können diese Abfragen referenzieren und weitere Abfragen gemäß Ihrem Anwendungsfall erstellen, indem Sie den Endpunkt "Berichtsabfrage-API erstellen" aufrufen.
Weitere Informationen zu den Spaltennamen, Attributen und Beschreibungen finden Sie in den folgenden Artikeln:
- Kundendashboard
- Bestelldashboard
- Verwendungsdashboard
- Marketplace Insights-Dashboard
- Umsatzdashboard
- Dashboard „Quality of Service“
- Kundenaufbewahrungsdashboard
- Lizenzdashboard
- Dashboard „Quality of Service“
Abfragen des Berichts „Kunden“
Diese Beispielabfragen gelten für den Bericht „Kunden“.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten von Kundendetails mit den aktiven Kund*innen des Partners bis zu dem von Ihnen ausgewählten Datum | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Auflisten von Kundendetails mit den vom Partner abgewanderten Kund*innen bis zu dem von Ihnen ausgewählten Datum | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Liste der neuen Kunden aus einem bestimmten geografischen Gebiet in den letzten sechs Monaten | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Abfragen des Berichts „Nutzung“
Diese Beispielabfragen gelten für den Bericht „Nutzung“.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten von Nutzungsdetails mit der normalisierten Nutzung virtueller Computer (VMs) für den Marketplace-Lizenztyp „Abrechnung über Azure“ für die letzten 6 Monate | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Auflisten von Nutzungsdetails mit der tatsächlichen VM-Nutzung für den Marketplace-Lizenztyp „Abrechnung über Azure“ für die letzten 12 Monate | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Auflisten von Nutzungsdetails mit der normalisierten VM-Nutzung für den Marketplace-Lizenztyp „Bring-your-own-License“ (BYOL) der letzten 6 Monate | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Auflisten von Nutzungsdetails mit der tatsächlichen VM-Nutzung für den Marketplace-Lizenztyp „Bring-your-own-License“ (BYOL) der letzten 6 Monate | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Auflisten von Nutzungsdetails mit dem Nutzungsdatum, der täglichen gesamten normalisierten Nutzung und „Geschätzten erweiterten Gebühren (PC/CC)“ für kostenpflichtige Pläne für den letzten Monat | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Auflisten von Nutzungsdetails mit dem Nutzungsdatum, der täglichen gesamten tatsächlichen Nutzung und „Geschätzten erweiterten Gebühren (PC/CC)“ für kostenpflichtige Pläne für den letzten Monat | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Auflisten von Nutzungsdetails mit dem Angebotsnamen, der normalisierten VM-Nutzung für den Marketplace-Lizenztyp „Abrechnung über Azure“ für die letzten 6 Monate | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Auflisten von Nutzungsdetails mit dem Angebotsnamen und der gemessenen Nutzung für die letzten 6 Monate | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Auflisten aller Angebotsnutzungsdetails aller Angebote für die letzten 6 Monate | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Auflisten aller Angebotsnutzungsdetails privater Angebote für die letzten 6 Monate | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Abfragen des Berichts „Bestellungen“
Diese Beispielabfragen gelten für den Bericht „Bestellungen“.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten von Auftragsdetails für den Azure-Lizenztyp „Enterprise“ für die letzten 6 Monate | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für den Azure-Lizenztyp „Nutzungsbasierte Bezahlung“ für die letzten 6 Monate | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für einen bestimmten Angebotsnamen für die letzten 6 Monate | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für aktive Bestellungen für die letzten 6 Monate | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für stornierte Bestellungen für die letzten 6 Monate | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails mit Menge, Laufzeitstart, Laufzeitende, geschätzten Gebühren und Währung für die letzten 6 Monate | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für Probeaufträge, die für die letzten 6 Monate aktiv waren | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für alle Angebote, die für die letzten 6 Monate aktiv waren | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Auflisten von Auftragsdetails für private Angebote, die für die letzten 6 Monate aktiv waren | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Umsatzberichtsabfragen
Diese Beispielabfragen gelten für den Umsatzbericht.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten des abgerechneten Umsatzes des Partners für den letzten Monat | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Auflisten des geschätzten Umsatzes (in US-Dollar) aller Transaktionen mit dem Status „Gesendet“ in den letzten drei Monaten | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Auflisten der Nicht-Testtransaktionen für das abonnementbasierte Abrechnungsmodell | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Abfragen des Quality of Service-Berichts
Diese Beispielabfrage bezieht sich auf den Quality of Service-Bericht.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten des Bereitstellungsstatus von Angeboten für die letzten 6 Monate | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Abfragen des Kundenbindungsberichts
Diese Beispielabfrage gilt für den Kundenbindungsbericht.
| Abfragebeschreibung | Beispielabfrage |
|---|---|
| Auflisten von Kundenbindungsdetails für die letzten 6 Monate | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Auflisten von Details zur Nutzungsaktivität und dem Umsatz aller Kund*innen in den letzten 6 Monaten | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |