Compartilhar via

Modelo de dados do hub FinOps

Os hubs FinOps são uma plataforma para análise de custos, insights e otimização. Embora o núcleo dos hubs FinOps seja um pipeline de dados que ingere, limpe e normalize dados, o poder dos hubs FinOps vem do modelo de dados padronizado criado na Especificação de Uso e Custo Aberto do FinOps (FOCUS).

Este artigo explica o modelo de dados dos hubs FinOps – de pastas de armazenamento, tabelas e funções do Azure Data Explorer e tabelas e funções do Power BI – para prepará-lo para a criação de suas próprias consultas, relatórios e dashboards personalizados. Para obter o suporte mais flexível e escalonável, recomendamos implantar hubs FinOps com o Data Explorer.


Pré-requisitos

Antes de começar, você precisa ter:

Este passo a passo não incorre em nenhum custo; no entanto, as leituras de armazenamento incorrem em uma cobrança nominal e a manutenção de um cluster ativo do Data Explorer incorre em custo.


Resumindo o modelo de dados

Os hubs FinOps abrangem armazenamento, Data Factory, Data Explorer e Power BI. Dependendo da configuração, você pode interagir com uma ou mais delas.

Quando os dados são ingeridos em hubs FinOps, ele acaba caindo no contêiner de armazenamento de ingestão . Cada pasta nesse contêiner é mapeada para um conjunto de dados gerenciado em hubs FinOps. Os nomes de pasta no mapa de contêiner de ingestão para as tabelas no Data Explorer e no Microsoft Fabric. Para obter detalhes sobre essas pastas e o processo de ingestão de dados abrangente, consulte Como os dados são processados em hubs FinOps. Não abordaremos essas pastas e pipelines aqui.

Se você configurou um nome de cluster do Data Explorer ou o URI de consulta da casa de eventos do Microsoft Fabric como parte da implantação do hub FinOps, encontrará várias tabelas e funções nos bancos de dados Hub e Ingestão . As consultas nos painéis do Power BI e do Data Explorer estendem essas tabelas e funções. Se você usar o Power BI para se conectar aos dados em sua conta de armazenamento, encontrará um conjunto diferente de funções e tabelas no Power BI.

As seções a seguir descreverão:

  • Conjuntos de dados gerenciados
  • Funções do Data Explorer
  • Funções do Power BI
  • Tabelas do Power BI

Observe que o uso do "Data Explorer" abrange as casas de eventos do Azure Data Explorer e do Microsoft Fabric Real-Time Intelligence (RTI). Tabelas e funções no Azure Data Explorer são as mesmas em uma casa de eventos do Fabric, se esse for o modelo de implantação escolhido. Se você vir referências ao "Data Explorer", elas também se aplicam a uma implantação do Microsoft Fabric.


Versão do esquema

Uma das metas do modelo de dados dos hubs FinOps é garantir a compatibilidade com versões anteriores. Para dar suporte a isso, cada versão do hub FinOps usa uma versão de esquema específica que se alinha a uma versão específica do FOCUS. A versão do esquema define as colunas, os tipos de dados e os valores permitidos nas tabelas e funções para cada conjunto de dados gerenciado.

A tabela a seguir indica a versão do esquema para cada versão do hub FinOps e a qual versão FOCUS eles se alinham.

Liberação Schema Versão focus
12+ v1_2 1,2
0.7-11 v1_0 1,0

Conjuntos de dados gerenciados em hubs FinOps

Um conjunto de dados gerenciado é um conjunto de dados lógico que é apoiado por uma pasta de armazenamento, data explorer ou tabela eventhouse, várias funções do Data Explorer ou eventhouse e uma tabela do Power BI. Os conjuntos de dados gerenciados também fornecem funções com versão no Data Explorer que permitem a compatibilidade com versões anteriores ao longo do tempo. Os recursos exatos por trás de um conjunto de dados gerenciado dependem se a instância do hub FinOps usa o Data Explorer ou o Microsoft Fabric.

Os conjuntos de dados gerenciados incluem os seguintes ativos com uma implantação básica de hubs FinOps:

  • Uma pasta no contêiner de armazenamento de ingestão (por exemplo, ingestão/custos).
  • Uma tabela nos relatórios de armazenamento do Power BI que é mapeada para a pasta de armazenamento correspondente.

Os conjuntos de dados gerenciados também incluem os seguintes ativos para hubs FinOps com o Data Explorer ou o Microsoft Fabric:

  • Uma tabela "bruta" no banco de dados de ingestão (por exemplo, Costs_raw).
  • Uma função de "transformação" com versão no banco de dados ingestão , usada para transformar dados brutos (por exemplo, Costs_transform_v1_2()).
  • Uma tabela "final" com versão no banco de dados ingestão (por exemplo, Costs_final_v1_2).
  • Uma função com controle de versão no banco de dados hub (por exemplo, Costs_v1_2()).
  • Uma função não inversa no banco de dados hub (por exemplo, Custos()).
  • Uma tabela em relatórios KQL do Power BI que encapsula a função com versão correspondente.

Durante a ingestão de dados, os hubs FinOps transformam dados para a versão de esquema com suporte mais recente. Funções não inversas, como Custos(), usam a versão de esquema mais recente. As funções não inversas, como Costs_v1_0(), são compatíveis com versões anteriores, devem permanecer consistentes e não precisam ser alteradas ao atualizar a instância do hub FinOps. Para saber mais sobre o processo de ingestão de dados, consulte Como os dados são processados em hubs FinOps.

Ao consultar dados em hubs FinOps, sempre use o banco de dados hub e evite trabalhar com as tabelas e funções no banco de dados de ingestão . Use funções não inversas para análise ad hoc ou relatórios que não exigem compatibilidade com versões anteriores de longo prazo. Use as funções com controle de versão para relatórios ou sistemas que exigem compatibilidade com versões anteriores e você não deseja ser afetado pelas atualizações do hub FinOps, que podem alterar nomes de coluna, tipos de dados e valores.

As funções não inversas chamam a função com versão mais recente, que, por sua vez, consulta dados de todas as tabelas finais com versão no banco de dados ingestão . Por exemplo, Costs() chama Costs_v1_2(), que consulta as tabelas Costs_final_v1_2 e Costs_final_v1_0 . Os dados de v1_0 são transformados para se alinharem à versão do esquema v1_2 . Por outro lado, Costs_v1_0() consulta as mesmas tabelas, mas transforma dados para se alinharem à versão do esquema v1_0 , garantindo compatibilidade com versões anteriores. Isso não contabiliza alterações de valor de dados upstream provenientes dos geradores de dados, como o Gerenciamento de Custos da Microsoft, a menos que explicitamente declarado.

Essa mesma abordagem é usada para atualizações de conjunto de dados que alteram colunas na mesma versão FOCUS. Essas tabelas e funções usarão uma versão r# , como Costs_final_v1_2r3, significando a terceira versão (r3) da especificação FOCUS 1.2. Essa abordagem ajuda a evitar alterações que possam afetar consultas e relatórios personalizados.

Isso se aplica a todos os conjuntos de dados gerenciados discutidos nas seções a seguir.


Funções do Power BI

O armazenamento do Power BI e os relatórios KQL incluem um subconjunto das funções a seguir. Cada uma dessas funções destina-se a ser interna e não garantimos compatibilidade com versões anteriores.

  • ftk_DatetimeToJulianDate(Data inputDate)
    Auxiliar de conversão de data/hora.
  • ftk_DemoFilter()
    Filtro usado para minimizar os dados incluídos nos relatórios de demonstração. Pode ser personalizado para filtrar assinaturas do Resource Graph, mas não projetado para escala. Se a filtragem for necessária, crie uma solicitação de recurso.
  • ftk_ImpalaToJulianDate(dados do objeto)
    Auxiliar de conversão de data/hora.
  • ftk_Metadata(object fileContents, text dateColumn)
    Auxiliar de análise de arquivos parquet para dar suporte à atualização incremental em relatórios de armazenamento do Power BI.
  • ftk_ParseResourceId(text resourceId, bool getName)
    Auxiliar de análise de ID de recursos do Azure. Pode analisar o nome do recurso hierárquico ou o tipo de recurso.
  • ftk_ParseResourceName(text resourceId)
    Analisa o nome do recurso hierárquico de uma ID de recurso do Azure chamando a função ftk_ParseResourceId .
  • ftk_ParseResourceType(text resourceId)
    Analisa o tipo de recurso hierárquico de uma ID de recurso do Azure chamando a função ftk_ParseResourceId .
  • ftk_Storage([datasetType])
    Lê dados do Armazenamento de DataLake do Azure. O parâmetro datasetType pode ser um conjunto de dados de exportação de Gerenciamento de Custos ou um conjunto de dados gerenciado de hubs FinOps. Essa função lida com as diferenças entre os tipos de exportação de Gerenciamento de Custos e as versões de hubs finops, que podem usar hierarquias de pastas diferentes.

Tabela AdvisorRecommendations

A tabela AdvisorRecommendations no Power BI relata que consulta as recomendações do Assistente do Azure do Azure Resource Graph.


Função KQL arraystring()

A função arraystring(arr: dynamic) no Data Explorer retorna uma cadeia de caracteres delimitada por vírgulas para elementos de matriz.

Exemplos:

  • arraystring(dynamic(['x'])) = "x"
  • arraystring(dynamic([1, 2, 3])) = "1, 2, 3"
  • arraystring(dynamic(['a', 'b', 'c'])) = "a, b, c"

Conjunto de dados gerenciado CommitmentDiscountUsage

O conjunto de dados gerenciado CommitmentDiscountUsage inclui:

  • pasta de armazenamento ingestion/CommitmentDiscountUsage.
  • CommitmentDiscountUsage_raw tabela no banco de dados ingestão .
  • CommitmentDiscountUsage_transform_v1_2() função no banco de dados ingestão .
  • CommitmentDiscountUsage_final_v1_2 tabela no banco de dados ingestão .
  • função CommitmentDiscountUsage_v1_2()no banco de dados hub.
  • Função CommitmentDiscountUsage() no banco de dados hub .
  • Tabela CommitmentDiscountUsage em relatórios do Power BI.

O seguinte é fornecido para compatibilidade com versões anteriores:

  • CommitmentDiscountUsage_transform_v1_0() função no banco de dados ingestão . Isso não é mais referenciado e mantido somente para referência.
  • CommitmentDiscountUsage_final_v1_0 tabela no banco de dados ingestão para hospedar dados ingeridos com os hubs FinOps 0.7-0.11.
  • CommitmentDiscountUsage_v1_0() função no banco de dados hub para converter todos os dados em FOCUS 1.0.

A tabela CommitmentDiscountUsage_raw dá suporte a esquemas de exportação de detalhes de reserva do Gerenciamento de Custos da Microsoft para contas EA e MCA. Os dados são transformados em um conjunto de dados alinhado ao FOCUS quando ingeridos na tabela final. Esse conjunto de dados não dá suporte explicitamente a outras nuvens.

As colunas no conjunto de dados gerenciado CommitmentDiscountUsage incluem:

Coluna Tipo Anotações
Fim do Período de Cobrança Date/time Origem: complemento de hubs.
ChargePeriodStart Date/time Fonte: Microsoft 2023-03-01.
CategoriaDeDescontoPorCompromisso String Origem: complemento de hubs.
IdentificadorDeDescontoPorCompromisso String Fonte: Microsoft 2023-03-01.
CommitmentDiscountQuantity Real Novidades no FOCUS 1.2. Renomeado de x_CommitmentDiscountQuantity. Fonte: Microsoft 2023-03-01.
TipoDeDescontoPorCompromisso String Origem: complemento de hubs.
CommitmentDiscountUnit String Novidades no FOCUS 1.2. Origem: complemento de hubs.
QuantidadeConsumida Real Fonte: Microsoft 2023-03-01.
ProviderName String Origem: complemento de hubs.
ResourceId String Fonte: Microsoft 2023-03-01.
NomeDoRecurso String Origem: complemento de hubs.
TipoDeRecurso String Origem: complemento de hubs.
Categoria de Serviço String Origem: complemento de hubs.
NomeDoServiço String Origem: complemento de hubs.
SubAccountId String Origem: complemento de hubs.
x_CommitmentDiscountCommittedCount Real Fonte: Microsoft 2023-03-01.
x_CommitmentDiscountCommittedAmount Real Fonte: Microsoft 2023-03-01.
x_CommitmentDiscountNormalizedGroup String Fonte: Microsoft 2023-03-01.
x_CommitmentDiscountNormalizedRatio Real Fonte: Microsoft 2023-03-01.
x_IngestionTime Date/time Origem: complemento de hubs.
x_NomeDoGrupoDeRecursos String Origem: complemento de hubs.
x_ResourceType String Origem: complemento de hubs.
x_ServiceModel String Origem: complemento de hubs.
x_SkuOrderId String Fonte: Microsoft 2023-03-01.
x_SkuSize String Fonte: Microsoft 2023-03-01.
x_SourceName String Origem: complemento de hubs.
x_SourceProvider String Origem: complemento de hubs.
x_SourceType String Origem: complemento de hubs.
x_SourceVersion String Origem: complemento de hubs.

Tabela de cálculo de conformidade

A tabela virtual de cálculo de conformidade no Power BI relata que une as tabelas PolicyAssignments e PolicyStates para resumir a conformidade da política.


Conjunto de dados gerenciado de custos

O conjunto de dados gerenciado de custos inclui:

  • pasta de armazenamento de ingestão/custos .
  • Costs_raw tabela no banco de dados ingestão .
  • Costs_transform_v1_2() função no banco de dados ingestão .
  • Costs_final_v1_2 tabela no banco de dados ingestão .
  • função Costs_v1_2()no banco de dados hub.
  • Função Costs()no banco de dados hub.
  • Tabela de custos em relatórios do Power BI.

O seguinte é fornecido para compatibilidade com versões anteriores:

  • Costs_transform_v1_0() função no banco de dados ingestão . Isso não é mais referenciado e mantido somente para referência.
  • Costs_final_v1_0 tabela no banco de dados ingestão para hospedar dados ingeridos com hubs FinOps 0.7-0.11.
  • Costs_v1_0() função no banco de dados hub para converter todos os dados em FOCUS 1.0.

A tabela Costs_raw dá suporte à ingestão de dados FOCUS 1.0 dos seguintes provedores de serviços:

  • Microsoft Cloud
  • Alibaba Cloud
  • Amazon Web Services (AWS)
  • GCP (Google Cloud Platform)
  • Oracle Cloud Infrastructure (OCI)
  • Nuvem da Tencent

Os hubs FinOps não dão suporte à extração direta de dados de outras nuvens, mas se os dados forem adicionados ao contêiner de armazenamento de ingestão , eles serão ingeridos com todas as colunas personalizadas.

As colunas no conjunto de dados gerenciado de custos incluem:

Coluna Tipo Anotações
Zona de Disponibilidade String
Custo faturado Real
Identificação da conta de cobrança String
Nome da Conta de Cobrança String
Tipo de conta de cobrança String
Moeda de Cobrança String
FimPeríodoDeFaturamento Date/time
Início do Período de Cobrança Date/time
CapacityReservationId String Novidades no FOCUS 1.2.
CapacityReservationStatus String Novidades no FOCUS 1.2.
Categoria de carga String
Classe de carga String
Descrição da carga String
Frequência de carga String
Fim do Período de Cobrança Date/time
ChargePeriodStart Date/time
CategoriaDeDescontoPorCompromisso String
IdentificadorDeDescontoPorCompromisso String
Nome do Desconto por Compromisso String
CommitmentDiscountQuantity Real Novidades no FOCUS 1.2.
StatusDeDescontoPorCompromisso String
TipoDeDescontoPorCompromisso String
CommitmentDiscountUnit String Novidades no FOCUS 1.2.
QuantidadeConsumida Real
Unidade consumida String
Custo contratado Real
Preço Unitário Contratado Real
Custo efetivo Real
ID da Fatura String Novidades no FOCUS 1.2. Renomeado de x_InvoiceId.
Nome_doEmissor_de_Fatura String
ListCost Real
ListUnitPrice Real
Categoria de preços String
PricingCurrency String Novidades no FOCUS 1.2. Renomeado de x_PricingCurrency.
PreçoQuantidade Real
Unidade de Preços String
ProviderName String
PublisherName String
Identificação da região String
Nome da Região String
ResourceId String
NomeDoRecurso String
TipoDeRecurso String
Categoria de Serviço String
NomeDoServiço String
Subcategoria de serviço String Novidades no FOCUS 1.2.
SkuId String
SkuMeter String Novidades no FOCUS 1.2. Renomeado de x_SkuMeterName.
SkuPriceDetails Dinâmico Novidades no FOCUS 1.2. Versão transformada do x_SkuDetails.
SkuPriceId String
SubAccountId String
Nome da SubConta String
Tipo de Subconta String
Etiquetas Dinâmico
x_AccountId String Fonte: Microsoft 1.0-preview(v1)+.
x_AccountName String Fonte: Microsoft 1.0-preview(v1)+.
x_AccountOwnerId String Fonte: Microsoft 1.0-preview(v1)+.
x_AmortizationClass String Fonte: Microsoft 1.2-preview+.
x_BilledCostInUsd Real Fonte: Microsoft 1.0-preview(v1)+.
x_BilledUnitPrice Real Fonte: Microsoft 1.0-preview(v1)+.
x_BillingAccountAgreement String Origem: complemento de hubs.
x_BillingAccountId String Fonte: Microsoft 1.0-preview(v1)+.
x_BillingAccountName String Fonte: Microsoft 1.0-preview(v1)+.
x_BillingExchangeRate Real Fonte: Microsoft 1.0-preview(v1)+.
x_BillingExchangeRateDate Date/time Fonte: Microsoft 1.0-preview(v1)+.
x_BillingItemCode String Fonte: Alibaba 1.0.
x_BillingItemName String Fonte: Alibaba 1.0.
x_BillingProfileId String Fonte: Microsoft 1.0-preview(v1)+.
x_BillingProfileName String Fonte: Microsoft 1.0-preview(v1)+.
x_ChargeId String Fonte: Somente Microsoft 1.0-preview(v1).
x_CommitmentDiscountNormalizedRatio Real Fonte: Microsoft 1.2-preview+.
x_CommitmentDiscountPercent String Origem: complemento de hubs.
x_CommitmentDiscountSavings String Origem: complemento de hubs.
x_CommitmentDiscountSpendEligibility String Origem: complemento de hubs.
x_CommitmentDiscountUsageEligibility String Origem: complemento de hubs.
x_CommitmentDiscountUtilizationAmount String Origem: complemento de hubs.
x_CommitmentDiscountUtilizationPotential String Origem: complemento de hubs.
x_CommodityCode String Fonte: Alibaba 1.0.
x_CommodityName String Fonte: Alibaba 1.0.
x_ConsumedCoreHours Real Origem: complemento de hubs.
x_ContractedCostInUsd Real Fonte: Microsoft 1.0+.
x_CostAllocationRuleName String Fonte: Microsoft 1.0-preview(v1)+.
x_CostCategories Dinâmico Fonte: AWS 1.0 (JSON).
x_CostCenter String Fonte: Microsoft 1.0-preview(v1)+.
x_CostType String Fonte: GCP Jan 2024.
x_Credits Dinâmico Fonte: GCP Jan 2024.
x_CurrencyConversionRate Real Fonte: GCP Jun 2024.
x_CustomerId String Fonte: Microsoft 1.0-preview(v1)+.
x_CustomerName String Fonte: Microsoft 1.0-preview(v1)+.
x_Discount Dinâmico Fonte: AWS 1.0 (JSON).
x_EffectiveCostInUsd Real Fonte: Microsoft 1.0-preview(v1)+.
x_EffectiveUnitPrice Real Fonte: Microsoft 1.0-preview(v1)+.
x_ExportTime Date/time Fonte: GCP Jan 2024.
x_IngestionTime Date/time Origem: complemento de hubs.
x_InstanceID String Fonte: Alibaba 1.0.
x_InvoiceIssuerId String Fonte: Microsoft 1.0-preview(v1)+.
x_SeçãoDeFaturaId String Fonte: Microsoft 1.0-preview(v1)+.
x_InvoiceSectionName String Fonte: Microsoft 1.0-preview(v1)+.
x_ListCostInUsd Real Fonte: Microsoft 1.0-preview(v1)+.
x_Location String Fonte: GCP Jan 2024.
x_NegotiatedDiscountSavings String Origem: complemento de hubs.
x_NegotiatedDiscountPercent String Origem: complemento de hubs.
x_Operation String Fonte: AWS 1.0.
x_PartnerCreditApplied String Fonte: Microsoft 1.0-preview(v1)+.
x_PartnerCreditRate String Fonte: Microsoft 1.0-preview(v1)+.
x_PricingBlockSize Real Fonte: Microsoft 1.0-preview(v1)+.
x_SubcategoriaDePreços String Fonte: Microsoft 1.0-preview(v1)+.
x_PricingUnitDescription String Fonte: Microsoft 1.0-preview(v1)+.
x_Project String Fonte: GCP Jan 2024.
x_PublisherCategory String Fonte: Microsoft 1.0-preview(v1)+.
x_PublisherId String Fonte: Microsoft 1.0-preview(v1)+.
x_ResellerId String Fonte: Microsoft 1.0-preview(v1)+.
x_ResellerName String Fonte: Microsoft 1.0-preview(v1)+.
x_NomeDoGrupoDeRecursos String Fonte: Microsoft 1.0-preview(v1)+.
x_ResourceType String Fonte: Microsoft 1.0-preview(v1)+.
x_ServiceCode String Fonte: AWS 1.0.
x_ServiceId String Fonte: GCP Jan 2024.
x_ServiceModel String Fonte: Microsoft 1.2-preview+.
x_ServicePeriodEnd Date/time Fonte: Microsoft 1.0-preview(v1)+.
x_ServicePeriodStart Date/time Fonte: Microsoft 1.0-preview(v1)+.
x_SkuCoreCount String Origem: complemento de hubs.
x_SkuDescription String Fonte: Microsoft 1.0-preview(v1)+.
x_DetalhesDoProduto (x_SkuDetails) Dinâmico Fonte: Microsoft 1.0-preview(v1)+.
x_SkuInstanceType String Origem: complemento de hubs.
x_SkuIsCreditEligible Bool Fonte: Microsoft 1.0-preview(v1)+.
x_SkuLicenseQuantity String Origem: complemento de hubs.
x_SkuLicenseStatus String Origem: complemento de hubs.
x_SkuLicenseType String Origem: complemento de hubs.
x_SkuLicenseUnit String Origem: complemento de hubs.
x_SkuMeterCategoria String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuMeterId String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuMeterSubcategory String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuOfferId String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuOperatingSystem String Origem: complemento de hubs.
x_SkuOrderId String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuOrderName String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuPartNumber String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuPlanName String Fonte: Microsoft 1.2-preview+.
x_SkuRegion String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuServiceFamily String Fonte: Microsoft 1.0-preview(v1)+.
x_SkuTerm Int Fonte: Microsoft 1.0-preview(v1)+.
x_SkuTier String Fonte: Microsoft 1.0-preview(v1)+.
x_SourceChanges String Origem: complemento de hubs.
x_SourceName String Origem: complemento de hubs.
x_SourceProvider String Origem: complemento de hubs.
x_SourceType String Origem: complemento de hubs.
x_SourceValues Dinâmico Origem: complemento de hubs.
x_SourceVersion String Origem: complemento de hubs.
x_TotalDiscountPercent String Origem: complemento de hubs.
x_TotalSavings String Origem: complemento de hubs.
x_UsageType String Fonte: AWS 1.0.

Função KQL datestring()

A função datestring(start: datetime, [end: datetime]) no Data Explorer retorna um intervalo de datas ou data formatado (por exemplo, 1º de janeiro a 3 de fevereiro). As datas formatadas são o valor mais curto possível com base na data atual.

Exemplos:

  • datestring(datetime(2025-01-01)) = "Jan 1"
  • datestring(datetime(2024-01-01)) = "Jan 1, 2024"
  • datestring(datetime(2025-01-01), datetime(2025-01-01)) = "Jan 1"
  • datestring(datetime(2025-01-01), datetime(2025-01-15)) = "Jan 1-15"
  • datestring(datetime(2025-01-01), datetime(2025-01-31)) = "Jan 2025"
  • datestring(datetime(2025-01-01), datetime(2025-03-31)) = "Jan-Mar"
  • datestring(datetime(2024-01-01), datetime(2024-03-31)) = "Jan-Mar 2024"
  • datestring(datetime(2025-01-01), datetime(2025-02-15)) = "Jan 1-Feb 15"
  • datestring(datetime(2024-07-01), datetime(2025-06-31)) = "Jul 2024-Jun 2025"
  • datestring(datetime(2024-12-16), datetime(2025-01-15)) = "Dez 16, 2024-Jan 15, 2025"
  • datestring(datetime(2025-01-01), datetime(2025-12-31)) = "2025"
  • datestring(datetime(2024-01-01), datetime(2025-12-31)) = "2024-2025"

Função KQL delta()

A função delta(oldValue: double, newValue: double) no Data Explorer compara dois valores e retorna a alteração percentual de oldValue para newValue.

Exemplos:

  • delta(1, 2.5) = 1,5
  • delta(2, 1.5) = -0,5

Função KQL deltastring()

A função deltastring(oldValue: double, newValue: double, [places: int], [useArrows: bool]) no Data Explorer retorna a diferença percentual entre dois números como uma cadeia de caracteres usando o número especificado de casas decimais. O parâmetro useArrows indica se as setas devem ser usadas para alterações positivas e negativas.

Exemplos:

  • deltastring(1.2, 3.4) = "+2,2"
  • deltastring(3.4567, 1.2345, 2) = "-2,22"
  • deltastring(1.2, 3.4, 1, true) = "↑2.2"
  • deltastring(3.4567, 1.2345, 2, true) = "↓2,22"

Função KQL diffstring()

A função diffstring(oldValue: double, newValue: double, [places: int]) no Data Explorer retorna a diferença entre dois números como uma cadeia de caracteres com um sinal de mais ou menos e, opcionalmente, arredonda-a para um número especificado de locais.

Exemplos:

  • plusminus(1.2, 3.4) = "+2,2"
  • plusminus(3.4567, 1.2345, 2) = "-2,22"

Tabela de discos

A tabela Discos no Power BI relata que consulta discos gerenciados de máquina virtual do Azure do Azure Resource Graph.


Tabela HubScopes

No Power BI, a tabela HubScopes resume os escopos que foram ingeridos em hubs FinOps. Essa tabela é derivada do arquivo de configuração/settings.json no armazenamento.

No Data Explorer, a função HubScopes resume os escopos identificados na função HubSettings.


Tabela HubSettings

No Power BI, a tabela HubSettings extrai as configurações do arquivo de configuração/settings.json no armazenamento para a instância do hub FinOps.

No Data Explorer, a tabela HubSettingsLog contém um histórico de todas as atualizações de arquivo settings.json. A função HubSettings() no Data Explorer retorna a entrada de configurações mais recente da tabela HubSettingsLog .


Função KQL ifempty()

A função ifempty(value: dynamic, defaultValue: dynamic) no Data Explorer retorna o defaultValue se o valor especificado estiver vazio.

Exemplos:

  • ifempty('', '(empty)') = "(vazio)"
  • ifempty(null, '(empty)') = "(vazio)"
  • ifempty(123, '(empty)') = 123

Tabela ManagementGroups

A tabela ManagementGroups no Power BI relata que consulta grupos de gerenciamento do Azure do Azure Resource Graph.


Função KQL monthstring()

A função monthstring(date: datetime, [length: int]) no Data Explorer retorna o nome do mês para a data especificada (por exemplo, "Jan" ou "Janeiro"). O parâmetro de comprimento indica quantos caracteres o nome do mês deve ser. Por padrão, o nome completo será usado.

Exemplos:

  • monthstring(datetime(2025-01-01)) = "Janeiro"
  • monthstring(datetime(2025-01-01), 3) = "Jan"
  • monthstring(datetime(2025-01-01), 1) = "J"

Tabela NetworkInterfaces

A tabela NetworkInterfaces no Power BI relata que consulta interfaces de rede do Azure do Azure Resource Graph.


Tabela NetworkSecurityGroups

A tabela NetworkSecurityGroups no Power BI relata que consulta grupos de segurança de rede do Azure do Azure Resource Graph.


Função KQL numberstring()

A função numberstring(num: double, [abbrev: bool]) no Data Explorer converte um número em uma cadeia de caracteres formatada e, opcionalmente, abreviada.

Exemplos:

  • numberstring(1234) = "1,23 K"
  • numberstring(12345) = "12,3 K"
  • numberstring(1234567) = "1,23M"
  • numberstring(12345678) = "12,3"
  • numberstring(1234567890) = "1,23B"
  • numberstring(12345678901) = "12,3B"
  • numberstring(1234567890123) = "1,23T"
  • numberstring(12345678901234) = "12,3T"
  • numberstring(1234567, false) = "1.234.567"

Função KQL parse_resourceid()

A função parse_resourceid(resourceId: string) analisa a ID de recurso do Azure especificada para extrair atributos de recurso, como o nome, o tipo, o grupo de recursos e a ID de subcontagem.

Exemplo:

parse_resourceid('/subscriptions/###/resourceGroups/foo/providers/Microsoft.Compute/virtualMachines/bar')

{
    "ResourceId": "/subscriptions/###/resourceGroups/foo/providers/Microsoft.Compute/virtualMachines/bar",
    "ResourceName": "bar",
    "SubAccountId": "###",
    "x_ResourceGroupName": "foo",
    "x_ResourceProvider": "Microsoft.Compute",
    "x_ResourceType": "microsoft.compute/virtualmachines"
}

Função KQL percent()

A função percent(table: (Count: long)) no Data Explorer calcula a porcentagem de cada registro com base em uma coluna Count necessária.

{ let total = todouble(toscalar(t | summarize sum(Count))); percentOfTotal(t, total) }


Função KQL percentOfTotal()

A função percentOfTotal(table: (Count: long), total: long) no Data Explorer calcula a porcentagem de cada registro com base em uma coluna Count necessária. Essa função adiciona uma nova coluna Percent que divide a coluna Count pelo valor total especificado.


Função KQL percentstring

A função percentstring(num: double, [total: double], [places: int]) no Data Explorer retorna o número especificado como um percentual do total como uma cadeia de caracteres, usando o número especificado de casas decimais. Se o parâmetro total não for especificado, 1.0 será usado como o total padrão.

Exemplos:

  • percentstring(0.5) = "50%"
  • percentstring(0.5, 2) = "25%"
  • percentstring(0.5, 3, 2) = "16,67%"

Função KQL plusminus()

A função ****plusminus KQL no Data Explorer um sinal +/- com base na direção do número. plusminus(val: string) { let neg = substring(val, 0, 1) == '-'; iff(neg, val, strcat('+', val)) }


Tabela PolicyAssignments

A tabela PolicyAssignments no Power BI relata que consulta as atribuições do Azure Policy do Azure Resource Graph.


Tabela PolicyDefinitions

A tabela PolicyDefinitions no Power BI relata que consulta as definições do Azure Policy do Azure Resource Graph.


Tabela PolicyStates

A tabela PolicyStates no Power BI relata que consulta os estados do Azure Policy do Azure Resource Graph.


Conjunto de dados gerenciado de preços

O conjunto de dados gerenciado de preços inclui:

  • pasta de armazenamento de ingestão/preços .
  • Prices_raw tabela no banco de dados ingestão .
  • Prices_transform_v1_2() função no banco de dados ingestão .
  • Prices_final_v1_2 tabela no banco de dados ingestão .
  • função Prices_v1_2()no banco de dados hub.
  • Função Prices() no banco de dados hub .
  • Tabela de preços em relatórios do Power BI.

O seguinte é fornecido para compatibilidade com versões anteriores:

  • Prices_transform_v1_0() função no banco de dados ingestão . Isso não é mais referenciado e mantido somente para referência.
  • Prices_final_v1_0 tabela no banco de dados ingestão para hospedar dados ingeridos com os hubs FinOps 0.7-0.11.
  • Prices_v1_0() função no banco de dados hub para converter todos os dados em FOCUS 1.0.

A tabela Prices_raw dá suporte a esquemas de exportação do Gerenciamento de Custos da Microsoft para contas EA e MCA. Os dados são transformados em um conjunto de dados alinhado ao FOCUS quando ingeridos na tabela final. Esse conjunto de dados não dá suporte explicitamente a outras nuvens.

As colunas no conjunto de dados gerenciado de preços incluem:

Coluna Tipo Anotações
Identificação da conta de cobrança String
Nome da Conta de Cobrança String
Moeda de Cobrança String
Categoria de carga String
CategoriaDeDescontoPorCompromisso String
TipoDeDescontoPorCompromisso String
CommitmentDiscountUnit String
Preço Unitário Contratado Real
ListUnitPrice Real
Categoria de preços String
PricingCurrency String Novidades no FOCUS 1.2. Renomeado de x_PricingCurrency.
Unidade de Preços String
SkuId String
SkuMeter String Novidades no FOCUS 1.2. Renomeado de x_SkuMeterName.
SkuPriceId String
SkuPriceIdv2 String Origem: complemento de hubs.
x_BaseUnitPrice Real Fonte: Microsoft.
x_BillingAccountAgreement String Origem: complemento de hubs.
x_BillingAccountId String Fonte: Microsoft, somente MCA.
x_BillingProfileId String Fonte: Microsoft, somente MCA.
x_CommitmentDiscountNormalizedRatio Real Origem: complemento de hubs.
x_CommitmentDiscountSpendEligibility String Origem: complemento de hubs.
x_CommitmentDiscountUsageEligibility String Origem: complemento de hubs.
x_ContractedUnitPriceDiscount Real Origem: complemento de hubs.
x_ContractedUnitPriceDiscountPercent Real Origem: complemento de hubs.
x_EffectivePeriodEnd Date/time Fonte: Microsoft.
x_EffectivePeriodStart Date/time Fonte: Microsoft.
x_EffectiveUnitPrice Real Fonte: Microsoft.
x_EffectiveUnitPriceDiscount Real Origem: complemento de hubs.
x_EffectiveUnitPriceDiscountPercent Real Origem: complemento de hubs.
x_IngestionTime Date/time Origem: complemento de hubs.
x_PricingBlockSize Real Origem: complemento de hubs.
x_SubcategoriaDePreços String Origem: complemento de hubs.
x_PricingUnitDescription String Fonte: Microsoft.
x_SkuDescription String Fonte: Microsoft.
x_SkuId String Fonte: Microsoft.
x_SkuIncludedQuantity Real Fonte: Microsoft, somente EA.
x_SkuMeterCategoria String Fonte: Microsoft.
x_SkuMeterId String Fonte: Microsoft.
x_SkuMeterSubcategory String Fonte: Microsoft.
x_SkuMeterType String Fonte: Microsoft.
x_SkuPriceType String Fonte: Microsoft.
x_SkuProductId String Fonte: Microsoft.
x_SkuRegion String Fonte: Microsoft.
x_SkuServiceFamily String Fonte: Microsoft.
x_SkuOfferId String Fonte: Microsoft, somente EA.
x_SkuPartNumber String Fonte: Microsoft, somente EA.
x_SkuTerm Int Fonte: Microsoft.
x_SkuTier Real Fonte: Microsoft, somente MCA.
x_SourceName String Origem: complemento de hubs.
x_SourceProvider String Origem: complemento de hubs.
x_SourceType String Origem: complemento de hubs.
x_SourceVersion String Origem: complemento de hubs.
x_TotalUnitPriceDiscount Real Origem: complemento de hubs.
x_TotalUnitPriceDiscountPercent Real Origem: complemento de hubs.

Tabela PricingUnits

A tabela PricingUnits no Power BI e no Data Explorer é preenchida do arquivo de dados aberto de unidades de preços. Esta tabela é usada para normalizar preços.


Tabela PublicIPAddresses

A tabela PublicIPAddresses no Power BI relata que consulta endereços IP públicos do Azure do Azure Resource Graph.


Conjunto de dados gerenciado de recomendações

O conjunto de dados gerenciado de recomendações inclui:

  • pasta de armazenamento de ingestão/recomendações.
  • Recommendations_raw tabela no banco de dados ingestão .
  • Recommendations_transform_v1_2() função no banco de dados ingestão .
  • Recommendations_final_v1_2 tabela no banco de dados ingestão .
  • função Recommendations_v1_2()no banco de dados hub.
  • Função Recommendations()no banco de dados hub.
  • Tabela de recomendações em relatórios do Power BI.

O seguinte é fornecido para compatibilidade com versões anteriores:

  • função Recommendations_transform_v1_0() no banco de dados ingestão . Isso não é mais referenciado e mantido somente para referência.
  • Recommendations_final_v1_0 tabela no banco de dados ingestão para hospedar dados ingeridos com os hubs FinOps 0.7-0.11.
  • Recommendations_v1_0() função no banco de dados hub para converter todos os dados em FOCUS 1.0.

A tabela Recommendations_raw dá suporte a esquemas de exportação de recomendação de reserva do Gerenciamento de Custos da Microsoft para contas EA e MCA. Os dados são transformados em um conjunto de dados alinhado ao FOCUS quando ingeridos na tabela final. Esse conjunto de dados não dá suporte explicitamente a outras nuvens.

As colunas no conjunto de dados gerenciado de recomendações incluem:

Coluna Tipo Anotações
ProviderName String Fonte: Microsoft EA+MCA 2023-05-01.
ResourceId String
NomeDoRecurso String
TipoDeRecurso String
SubAccountId String Fonte: Microsoft EA+MCA 2023-05-01.
Nome da SubConta String
x_EffectiveCostAfter Real Fonte: Microsoft EA+MCA 2023-05-01.
x_EffectiveCostBefore Real Fonte: Microsoft EA+MCA 2023-05-01.
x_EffectiveCostSavings Real Fonte: Microsoft EA+MCA 2023-05-01.
x_IngestionTime Data e hora Origem: complemento de hubs.
x_RecommendationDate Data e hora Fonte: Microsoft EA+MCA 2023-05-01.
x_RecommendationDescription String Origem: complemento de hubs.
x_RecommendationDetails Dinâmico Fonte: Microsoft EA+MCA 2023-05-01.
x_NomeDoGrupoDeRecursos String
x_SourceName String Origem: complemento de hubs.
x_SourceProvider String Origem: complemento de hubs.
x_SourceType String Origem: complemento de hubs.
x_SourceVersion String Origem: complemento de hubs.

Tabela de regiões

A tabela Regiões no Power BI e no Data Explorer é preenchida do arquivo de dados aberto Regiões. Esta tabela é usada para facilitar a limpeza de dados.


Tabela ReservationRecommendations

A tabela ReservationRecommendations no Power BI extrai dados do conjunto de dados gerenciado de Recomendações, mas filtrado apenas para recomendações de reserva.


Tabela de recursos

A tabela Recursos no Power BI relata que consulta os recursos do Azure do Azure Resource Graph.


Função KQL resource_type()

A função resource_type(resourceType: string) no Data Explorer retorna um objeto com detalhes sobre o tipo de recurso do Azure especificado.

Exemplos:

  • resource_type('Microsoft.Compute/virtualMachines') = { "SingularDisplayName": "Máquina virtual" }
  • resource_type('Microsoft.Billing/billingAccounts') = { "SingularDisplayName": "Conta de cobrança" }

Tabela ResourceTypes

A tabela ResourceTypes no Power BI e no Data Explorer é preenchida do arquivo de dados aberto dos tipos de recursos. Esta tabela é usada para facilitar a limpeza de dados.


Tabela SqlDatabases

A tabela SqlDatabases no Power BI relata que consulta bancos de dados sql do Azure do Azure Resource Graph.


Tabela de serviços

A tabela Serviços no Data Explorer é preenchida do arquivo de dados aberto dos Serviços. Esta tabela é usada para facilitar a limpeza de dados.


Tabela StorageData

A tabela StorageData no Power BI é preenchida de todos os arquivos descobertos na conta do Azure Data Lake Storage. Esta tabela é usada para identificar erros de ingestão de dados no relatório de ingestão de dados.


Tabela StorageErrors

A tabela StorageErrors no Power BI é derivada da tabela StorageData. Esta tabela é usada para resumir erros de ingestão de dados no relatório de ingestão de dados.


Tabela de assinaturas

A tabela Assinaturas no Power BI relata que consulta assinaturas do Azure do Azure Resource Graph.


Conjunto de dados gerenciado de transações

O conjunto de dados gerenciado de transações inclui:

  • pasta de armazenamento de ingestão/transações .
  • Transactions_raw tabela no banco de dados ingestão .
  • função Transactions_transform_v1_2() no banco de dados ingestão .
  • Transactions_final_v1_2 tabela no banco de dados ingestão .
  • função Transactions_v1_2()no banco de dados hub.
  • Função Transactions()no banco de dados hub.
  • Tabela de transações em relatórios do Power BI.

O seguinte é fornecido para compatibilidade com versões anteriores:

  • Transactions_transform_v1_0() função no banco de dados ingestão . Isso não é mais referenciado e mantido somente para referência.
  • Transactions_final_v1_0 tabela no banco de dados ingestão para hospedar dados ingeridos com os hubs FinOps 0.7-0.11.
  • Transactions_v1_0() função no banco de dados hub para converter todos os dados em FOCUS 1.0.

A tabela Transactions_raw dá suporte a esquemas de exportação de transações de reserva do Gerenciamento de Custos da Microsoft para contas EA e MCA. Os dados são transformados em um conjunto de dados alinhado ao FOCUS quando ingeridos na tabela final. Esse conjunto de dados não dá suporte explicitamente a outras nuvens.

As colunas no conjunto de dados gerenciado transações incluem:

Coluna Tipo Anotações
Custo faturado Real Fonte: Microsoft EA+MCA 2023-05-01.
Identificação da conta de cobrança String Fonte: Microsoft EA+MCA 2023-05-01.
Nome da Conta de Cobrança String Fonte: Microsoft EA+MCA 2023-05-01.
Moeda de Cobrança String Fonte: Microsoft EA+MCA 2023-05-01.
FimPeríodoDeFaturamento Date/time Fonte: Microsoft EA+MCA 2023-05-01.
Início do Período de Cobrança Date/time Fonte: Microsoft EA+MCA 2023-05-01.
Categoria de carga String Origem: complemento de hubs.
Classe de carga String Origem: complemento de hubs.
Descrição da carga String Fonte: Microsoft EA+MCA 2023-05-01.
Frequência de carga String Fonte: Microsoft EA+MCA 2023-05-01.
ChargePeriodStart Date/time Fonte: Microsoft EA+MCA 2023-05-01.
ID da Fatura String Novidades no FOCUS 1.2. Renomeado de x_InvoiceId. Fonte: Microsoft MCA 2023-05-01.
PreçoQuantidade Real Fonte: Microsoft EA+MCA 2023-05-01.
Unidade de Preços String Origem: complemento de hubs.
ProviderName String Origem: complemento de hubs.
Identificação da região String Fonte: Microsoft EA+MCA 2023-05-01.
Nome da Região String Fonte: Microsoft EA+MCA 2023-05-01.
SubAccountId String Fonte: Microsoft EA+MCA 2023-05-01.
Nome da SubConta String Fonte: Microsoft EA+MCA 2023-05-01.
x_AccountName String Fonte: Microsoft EA 2023-05-01.
x_AccountOwnerId String Fonte: Microsoft EA 2023-05-01.
x_CostCenter String Fonte: Microsoft EA 2023-05-01.
x_InvoiceNumber String Fonte: Microsoft MCA 2023-05-01.
x_SeçãoDeFaturaId String Fonte: Microsoft MCA 2023-05-01.
x_InvoiceSectionName String Fonte: Microsoft MCA 2023-05-01.
x_IngestionTime Date/time Origem: complemento de hubs.
x_MonetaryCommitment Real Fonte: Microsoft EA 2023-05-01.
x_Overage Real Fonte: Microsoft EA 2023-05-01.
x_PurchasingBillingAccountId String Fonte: Microsoft EA 2023-05-01.
x_SkuOrderId String Fonte: Microsoft EA+MCA 2023-05-01.
x_SkuOrderName String Fonte: Microsoft EA+MCA 2023-05-01.
x_SkuSize String Fonte: Microsoft EA+MCA 2023-05-01.
x_SkuTerm Int Fonte: Microsoft EA+MCA 2023-05-01.
x_SourceName String Origem: complemento de hubs.
x_SourceProvider String Origem: complemento de hubs.
x_SourceType String Origem: complemento de hubs.
x_SourceVersion String Origem: complemento de hubs.
x_SubscriptionId String Fonte: Microsoft EA+MCA 2023-05-01.
x_TransactionType String Fonte: Microsoft EA+MCA 2023-05-01.

função KQL updown()

A função updown(value: string) no Data Explorer retorna uma seta para cima ou para baixo com base em se o valor especificado é positivo ou negativo.

Exemplos:

  • updown(1) = "↑"
  • updown(-1) = "↓"

Tabela VirtualMachines

A tabela VirtualMachines no Power BI relata que consulta máquinas virtuais do Azure do Azure Resource Graph.


Envie comentários

Deixe-nos saber como estamos indo com uma avaliação rápida. Usamos essas revisões para melhorar e expandir ferramentas e recursos do FinOps.

Envie comentários

Se você estiver procurando algo específico, vote em um existente ou crie uma ideia. Compartilhe ideias com outras pessoas para obter mais votos. Nos concentramos em ideias com a maioria dos votos.

Votar ou sugerir ideias


  • Last updated on