Query di esempio per l'analisi a livello di codice per il marketplace commerciale
Questo articolo fornisce query di esempio per gli ordini, l'utilizzo e i report dei clienti del marketplace commerciale Microsoft. È possibile fare riferimento a queste query e creare altre query in base al caso d'uso chiamando l'endpoint dell'API Crea query report.
Per altre informazioni sui nomi, gli attributi e le descrizioni delle colonne, vedere gli articoli seguenti:
- Dashboard dei clienti
- Dashboard Ordini
- Dashboard utilizzo
- Dashboard di Marketplace Insights
- Dashboard ricavi
- Dashboard Qualità del servizio
- Dashboard di conservazione dei clienti
- Dashboard licenze
- Dashboard Qualità del servizio
I clienti segnalano query
Queste query di esempio si applicano al report Clienti.
| Descrizione query | Query di esempio |
|---|---|
| Elencare i dettagli del cliente con i clienti attivi del partner fino alla data scelta | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Elencare i dettagli dei clienti con i clienti in blocchi del partner fino alla data scelta | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Elenco di nuovi clienti da una geografia specifica negli ultimi sei mesi | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Query di report sull'utilizzo
Queste query di esempio si applicano al report Utilizzo.
| Descrizione query | Query di esempio |
|---|---|
| Elencare i dettagli di utilizzo con l'utilizzo normalizzato della macchina virtuale per il tipo di licenza "Fatturato tramite Azure" marketplace per gli ultimi 6M | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con l'utilizzo non elaborato della macchina virtuale per il tipo di licenza "Fatturato tramite Azure" del Marketplace per gli ultimi 12M | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Elencare i dettagli di utilizzo con l'utilizzo normalizzato della macchina virtuale per il tipo di licenza marketplace "Bring Your Own License" per gli ultimi 6M | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con utilizzo non elaborato della macchina virtuale per il tipo di licenza marketplace "Bring Your Own License" per l'ultimo 6M | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con data di utilizzo, utilizzo normalizzato giornaliero giornaliero e "Addebiti estesi stimati (PC/CC)" per i piani a pagamento per l'ultimo mese | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Elencare i dettagli di utilizzo con data di utilizzo, utilizzo non elaborato giornaliero giornaliero e "Addebiti estesi stimati (PC/CC)" per i piani a pagamento per l'ultimo mese | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Elencare i dettagli di utilizzo con il nome dell'offerta, l'utilizzo normalizzato della macchina virtuale per il tipo di licenza di Marketplace "Fatturato tramite Azure" per gli ultimi 6 MILIONI | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con il nome dell'offerta, l'utilizzo a consumo per gli ultimi 6M | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Elencare tutti i dettagli di utilizzo dell'offerta per tutte le offerte per gli ultimi 6 milioni | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Elencare tutti i dettagli di utilizzo delle offerte private per gli ultimi 6 milioni | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Ordina query di report
Queste query di esempio si applicano al report Orders.
| Descrizione query | Query di esempio |
|---|---|
| Elencare i dettagli dell'ordine per il tipo di licenza di Azure come "Enterprise" per gli ultimi 6M | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per il tipo di licenza di Azure come "Pagamento in base al consumo" per gli ultimi 6 MILIONI | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per il nome dell'offerta specifico per l'ultimo 6M | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per gli ordini attivi per gli ultimi 6 MILIONI | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per gli ordini annullati per l'ultimo 6M | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine con quantità, inizio termine, data di fine del termine e costi stimati, valuta per gli ultimi 6 MILIONI | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per gli ordini di valutazione attivi per gli ultimi 6M | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per tutte le offerte attive per l'ultimo 6M | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per le offerte private attive per gli ultimi 6 MILIONI | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Query di report sulle entrate
Queste query di esempio si applicano al report Ricavi.
| Descrizione query | Query di esempio |
|---|---|
| Elencare i ricavi fatturati del partner per gli ultimi 1 mese | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Elencare i ricavi stimati in USD di tutte le transazioni con stato inviato negli ultimi 3 mesi | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Elenco di transazioni non di valutazione per il modello di fatturazione basato su sottoscrizione | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Query di report sulla qualità del servizio
Questa query di esempio si applica al report Qualità del servizio.
| Descrizione query | Query di esempio |
|---|---|
| Elencare lo stato di distribuzione delle offerte per gli ultimi 6 mesi | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Query dei report di conservazione dei clienti
Questa query di esempio si applica al report di conservazione dei clienti.
| Descrizione query | Query di esempio |
|---|---|
| Elencare i dettagli di conservazione dei clienti per gli ultimi 6 mesi | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli sulle attività di utilizzo e sui ricavi di tutti i clienti negli ultimi 6 mesi | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |