Partilhar via


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 referir-se a estas consultas e criar mais consultas conforme o seu caso de uso chamando o endpoint da API Create Report Query.

Para obter mais informações sobre os nomes de coluna, atributos e descrições, consulte estes artigos:

Os clientes relatam consultas

Essas consultas de exemplo se aplicam ao relatório de Clientes.

Descrição da Consulta Exemplo de consulta
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 de clientes desistentes do parceiro até à data que 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órios de utilização

Essas consultas de exemplo se aplicam ao relatório de uso.

Descrição da Consulta Exemplo de consulta
Liste os detalhes de uso com o uso normalizado da Máquina Virtual (VM) para o tipo de Licença do Marketplace "Faturado pelo Azure" nos últimos 6 meses. SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS
Listar os detalhes de uso com o uso bruto de VM para o tipo de Licença do Marketplace "faturado através do Azure" para os últimos 12 meses. 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 o uso normalizado da VM para o tipo de licença do Marketplace "Traga a Sua Própria Licença" para os últimos 6 meses. SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS
Listar os detalhes de utilização com a utilização Raw da VM para o tipo de licença Marketplace "Traga Sua Própria Licença" dos últimos 6 meses. 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 total diário normalizado e "Encargos estendidos estimados (PC/CC)" para planos pagos do último mês. SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH
Liste os detalhes de utilização com Data de Utilização, total diário de utilização bruta e "Encargos Estendidos Estimados (PC/CC)" para planos pagos do ú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, uso normalizado de VM para o tipo de licença do Marketplace "cobrado pelo Azure" para os últimos 6 meses. 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 os detalhes de uso de todas as ofertas dos últimos 6 meses SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH
Listar todos os detalhes de utilização de ofertas privadas dos últimos 6 meses 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 Exemplo de consulta
Listar detalhes do pedido para o Tipo de Licença do Azure como "Enterprise" para os últimos 6 meses. 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 "Pague conforme o uso" para os últimos 6 meses 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 de uma oferta específica dos últimos 6 meses SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS
Listar detalhes de encomendas para ordens ativas dos últimos 6 meses SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Listar detalhes de encomendas canceladas dos últimos 6 meses SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS
Listar detalhes da encomenda com quantidade, data de início do prazo, data de término do prazo e custos estimados, em moeda dos últimos 6 meses SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Apresentar detalhes de encomendas de teste ativas nos últimos 6 meses. SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS
Listem os detalhes dos pedidos para todas as ofertas que estejam ativas nos últimos 6 meses. SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Listar detalhes da encomenda para ofertas particulares ativas nos últimos 6 meses SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS

Consultas de relatórios de receitas

Essas consultas de exemplo se aplicam ao relatório de receita.

Descrição da Consulta Exemplo de consulta
Listar a receita faturada pelo parceiro no último 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 Exemplo de consulta
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 Exemplo de consulta
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