Exemplos de consultas para análise programática para mercado comercial
Este artigo fornece exemplos de consultas para os relatórios de Pedidos, Uso e Clientes do mercado comercial da Microsoft. Você pode encaminhar essas consultas e criar mais consultas de acordo com seu caso de uso chamando o ponto de extremidade Criar API de Consulta de Relatório .
Para obter mais informações sobre os nomes de coluna, atributos e descrições, consulte estes artigos:
- Painel de clientes
- Painel de pedidos
- Painel de utilização
- Painel do Marketplace Insights
- Painel de receitas
- Painel de Qualidade de Serviço
- Painel de retenção de clientes
- Painel de licenças
- Painel de Qualidade de Serviço
Os clientes relatam consultas
Essas consultas de exemplo se aplicam ao relatório Clientes.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar detalhes do cliente com clientes ativos do parceiro até a data que você escolher | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Liste os detalhes do cliente com clientes churned do parceiro até a data que você escolher | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Lista de novos clientes de uma geografia específica nos últimos seis meses | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Consultas de relatório de uso
Essas consultas de exemplo se aplicam ao relatório de uso.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar detalhes de uso com o uso normalizado da Máquina Virtual (VM) para o tipo de Licença do Marketplace "Faturado pelo Azure" para os últimos 6M | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Listar detalhes de uso com o uso do VM Raw para o tipo de Licença do Marketplace "Faturado através do Azure" para os últimos 12M | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Listar detalhes de uso com VM Uso normalizado para o tipo de licença do Marketplace "Traga sua própria licença" para os últimos 6M | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Listar detalhes de uso com o uso do VM Raw para o tipo de licença do Marketplace "Traga sua própria licença" para os últimos 6M | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Liste os detalhes de uso com Data de uso, uso normalizado total diário e "Encargos estendidos estimados (PC/CC)" para planos pagos no último mês | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Liste os detalhes de uso com Data de uso, uso bruto total diário e "Encargos estendidos estimados (PC/CC)" para planos pagos no último mês | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Listar detalhes de uso com Nome da oferta, VM Uso normalizado para o tipo de licença do Marketplace "Faturado através do Azure" para os últimos 6M | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Listar detalhes de uso com Nome da oferta, uso medido para os últimos 6M | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Listar todos os detalhes de uso de todas as ofertas para os últimos 6M | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Listar todos os detalhes de uso da oferta de ofertas privadas para os últimos 6M | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Consultas de relatório de pedidos
Essas consultas de exemplo se aplicam ao relatório Pedidos.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar detalhes do pedido do Tipo de Licença do Azure como "Enterprise" para os últimos 6M | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido do Tipo de Licença do Azure como "Pay as You Go" para os últimos 6M | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para o nome da oferta específica para os últimos 6M | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para pedidos ativos para os últimos 6M | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para pedidos cancelados para os últimos 6M | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido com quantidade, início do prazo, data de término do prazo e encargos estimados, moeda para os últimos 6M | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para pedidos de avaliação ativos nos últimos 6M | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para todas as ofertas que estão ativas nos últimos 6M | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes do pedido para ofertas particulares ativas nos últimos 6M | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Consultas de relatório de receita
Essas consultas de exemplo se aplicam ao relatório de receita.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar a receita faturada do parceiro no último 1 mês | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Listar a receita estimada em USD de todas as transações com status enviado nos últimos 3 meses | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Lista de transações não experimentais para o modelo de cobrança baseado em assinatura | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Consultas de relatórios de qualidade de serviço
Esta consulta de exemplo aplica-se ao relatório Qualidade de serviço.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar o status de implantação das ofertas dos últimos 6 meses | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Consultas de relatório de retenção de clientes
Esta consulta de exemplo aplica-se ao relatório de retenção de clientes.
| Descrição da consulta | Consulta de exemplo |
|---|---|
| Listar detalhes de retenção de clientes dos últimos 6 meses | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Listar detalhes de uso, atividade e receita de todos os clientes nos últimos 6 meses | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |