Exemplos de consultas para análise programática para marketplace comercial
Este artigo fornece exemplos de consultas para os Relatórios do cliente, Uso e Pedidos do marketplace comercial da Microsoft. Você pode consultar essas consultas e criar mais consultas de acordo com seu caso de uso chamando o ponto de extremidade da API Criar 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 uso
- Painel de insights do Marketplace
- Painel de receita
- Painel de Qualidade do Serviço
- Painel de retenção de clientes
- Painel de licenças
- Painel de Qualidade do Serviço
Consultas de relatório de clientes
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 escolhida | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Listar detalhes do cliente com clientes rotativos do parceiro até a data escolhida | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Lista de novos clientes de uma área geográfica 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 | Exemplo de consulta |
|---|---|
| Listar detalhes de uso com o uso normalizado da máquina virtual (VM) para o tipo de Licença do Marketplace "Cobrado via Azure" nos últimos seis meses | 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 bruto da VM para o tipo de Licença do Marketplace "Cobrado via Azure" nos últimos doze 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 sua própria licença" nos últimos seis meses | 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 bruto da VM para o tipo de Licença do Marketplace "Traga sua própria licença" nos últimos seis meses | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Listar detalhes de uso com a data de uso, o uso normalizado diário total e em "Cobranças Estendidas Estimadas (PC/CC)" para os Planos pagos do último mês | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Listar detalhes de uso com a data de uso, o uso bruto diário total e em "Cobranças Estendidas Estimadas (PC/CC)" para os 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 o nome da oferta, o uso normalizado da VM para o tipo de Licença do Marketplace "Cobrado via Azure" nos últimos seis 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 o nome da oferta, o uso medido nos últimos seis meses | 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 da oferta de todas as ofertas nos últimos seis meses | 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 nos últimos seis 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 de pedidos.
| Descrição da Consulta | Exemplo de consulta |
|---|---|
| Listar detalhes dos pedidos para o Tipo de Licença "Enterprise" do Azure para os últimos seis meses | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para o Tipo de Licença "Pré-pago" do Azure para os últimos seis meses | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para o nome da oferta específica nos últimos seis meses | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para pedidos ativos nos últimos seis meses | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para pedidos cancelados nos últimos seis meses | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos com quantidade, início do prazo, data de término do prazo e cobranças estimadas, moeda nos últimos seis meses | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para pedidos de avaliação ativos nos últimos seis meses | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para todas as ofertas ativas nos últimos seis meses | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Listar detalhes dos pedidos para ofertas privadas ativos nos últimos seis 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ório de receita
Esses exemplos de consultas se aplicam ao relatório de Receita.
| Descrição da Consulta | Exemplo de consulta |
|---|---|
| Listar a receita cobrada do parceiro do ú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 que não são de avaliação 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 do relatório de qualidade de serviço
Esta consulta de exemplo se aplica ao relatório de qualidade de serviço.
| Descrição da Consulta | Exemplo de consulta |
|---|---|
| Listar o status de implantação das ofertas dos últimos seis meses | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Consultas do relatório de retenção do clientes
Esta consulta de exemplo se aplica ao relatório de retenção do clientes.
| Descrição da Consulta | Exemplo de consulta |
|---|---|
| Listar detalhes de retenção de clientes nos últimos seis 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 da atividade de uso e receita de todos os clientes nos últimos seis meses | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |