title	FinOps hubs data model
description	Learn about the tables and functions available in FinOps hubs to build your own queries, reports, and dashboards.
author	flanakin
ms.author	micflan
ms.date	02/24/2026
ms.topic	reference
ms.service	finops
ms.subservice	finops-toolkit
ms.reviewer	micflan

FinOps hub data model

FinOps hubs are a platform for cost analytics, insights, and optimization. While the core of FinOps hubs is a data pipeline that ingests, cleans, and normalizes data, the power of FinOps hubs comes from the standardized data model built on the FinOps Open Cost and Usage Specification (FOCUS).

This article explains the FinOps hubs data model – from storage folders, Azure Data Explorer tables and functions, and Power BI tables and functions – to prepare you for building your own custom queries, reports, and dashboards. For the most flexible and scalable support, we recommend deploying FinOps hubs with Data Explorer.

Prerequisites

Before you begin, you must have:

Deployed a FinOps hub instance (ideally with Data Explorer).
Configured scopes and ingested data successfully.
Have database viewer access to the Data Explorer Hub and Ingestion databases.

This walkthrough does not incur any cost; however, storage reads incur a nominal charge and maintaining an active Data Explorer cluster does incur cost.

Summarizing the data model

FinOps hubs spans storage, Data Factory, Data Explorer, and Power BI. Depending on your setup, you may interact with one or more of these.

When data is ingested into FinOps hubs, it ultimately lands in the ingestion storage container. Each folder in this container maps to a managed dataset in FinOps hubs. The folder names in the ingestion container map to the tables in Data Explorer and Microsoft Fabric. For details about these folders and the overarching data ingestion process, see How data is processed in FinOps hubs. We will not cover these folders and pipelines here.

If you configured a Data Explorer cluster name or Microsoft Fabric eventhouse query URI as part of your FinOps hub deployment, you will find a number of tables and functions in the Hub and Ingestion databases. Queries in Power BI and Data Explorer dashboards extend these tables and functions. If you use Power BI to connect to data in your storage account, you'll find a different set of functions and tables in Power BI.

The following sections will outline:

Managed datasets
Data Explorer functions
Power BI functions
Power BI tables

Note the use of "Data Explorer" covers both Azure Data Explorer and Microsoft Fabric Real-Time Intelligence (RTI) eventhouses. Tables and functions in Azure Data Explorer are the same in a Fabric eventhouse, if that is the chosen deployment model. If you see references to "Data Explorer", they also apply to a Microsoft Fabric deployment.

Schema version

One of the goals of the FinOps hubs data model is to guarantee backwards compatibility. To support this, each FinOps hub release uses a specific schema version which aligns to a specific FOCUS version. The schema version defines the columns, data types, and allowed values in the tables and functions for each managed dataset.

The following table indicates the schema version for each FinOps hub release and which FOCUS version they align to.

Release	Schema	FOCUS version
12+	`v1_2`	1.2
0.7-11	`v1_0`	1.0

Managed datasets in FinOps hubs

A managed dataset is a logical dataset that is backed by a storage folder, Data Explorer or eventhouse table, multiple Data Explorer or eventhouse functions, and a Power BI table. Managed datasets also provide versioned functions in Data Explorer that enable backwards compatibility over time. The exact resources behind a managed dataset depend on whether your FinOps hub instance uses Data Explorer or Microsoft Fabric.

Managed datasets include the following assets with a basic FinOps hubs deployment:

A folder in the ingestion storage container (for example, ingestion/Costs).
A table in Power BI storage reports that maps to the corresponding storage folder.

Managed datasets also include the following assets for FinOps hubs with Data Explorer or Microsoft Fabric:

A "raw" table in the Ingestion database (for example, Costs_raw).
A versioned "transform" function in the Ingestion database, used to transform raw data (for example, Costs_transform_v1_2()).
A versioned "final" table in the Ingestion database (for example, Costs_final_v1_2).
A versioned function in the Hub database (for example, Costs_v1_2()).
An unversioned function in the Hub database (for example, Costs()).
A table in Power BI KQL reports that wraps the corresponding versioned function.

During data ingestion, FinOps hubs transform data to the latest supported schema version. Unversioned functions, like Costs(), use the latest schema version. Unversioned functions, like Costs_v1_0(), are backwards compatible, should remain consistent, and do not need to change when upgrading your FinOps hub instance. To learn more about the data ingestion process, see How data is processed in FinOps hubs.

When querying data in FinOps hubs, always use the Hub database and avoid working with the tables and functions in the Ingestion database. Use unversioned functions for ad-hoc analysis or reports that do not require long-term backwards compatibility. Use the versioned functions for reports or systems that do require backwards compatibility and you do not want to be impacted by FinOps hub updates, which may change column names, data types, and values.

Unversioned functions call the latest versioned function, which in turn queries data from all versioned final tables in the Ingestion database. For instance, Costs() calls Costs_v1_2(), which queries the Costs_final_v1_2 and Costs_final_v1_0 tables. The v1_0 data is transformed to align to the v1_2 schema version. Conversely, Costs_v1_0() queries the same tables, but transforms data to align to the v1_0 schema version, ensuring backwards compatibility. This does not account for upstream data value changes that come from the data generators, like Microsoft Cost Management, unless explicitly stated.

This same approach is used for dataset updates that change columns within the same FOCUS version. These tables and functions will use an r# version, like Costs_final_v1_2r3, signifying the third release (r3) of the FOCUS 1.2 specification. This approach helps avoid changes that may impact custom queries and reports.

This applies to all managed datasets discussed in the following sections.

Power BI functions

Power BI storage and KQL reports include a subset of the following functions. Each of these functions is intended to be internal and we do not guarantee backward compatibility across versions.

ftk_DatetimeToJulianDate(Date inputDate)
Date/time conversion helper.
ftk_DemoFilter()
Filter used to minimize data included in the demo reports. Can be customized to filter Resource Graph subscriptions, but not designed for scale. If filtering is needed, create a feature request.
ftk_ImpalaToJulianDate(object data)
Date/time conversion helper.
ftk_Metadata(object fileContents, text dateColumn)
Parquet file parsing helper to support incremental refresh in Power BI storage reports.
ftk_ParseResourceId(text resourceId, bool getName)
Azure resource ID parsing helper. Can parse out the hierarchical resource name or resource type.
ftk_ParseResourceName(text resourceId)
Parses the hierarchical resource name from an Azure resource ID by calling the ftk_ParseResourceId function.
ftk_ParseResourceType(text resourceId)
Parses the hierarchical resource type from an Azure resource ID by calling the ftk_ParseResourceId function.
ftk_Storage([datasetType])
Reads data from Azure DataLake Storage. The datasetType parameter can be either a Cost Management export dataset or a FinOps hubs managed dataset. This function handles the differences between Cost Management export types and Finops hubs versions, which can use different folder hierarchies.

AdvisorRecommendations table

The AdvisorRecommendations table in Power BI reports that queries Azure Advisor recommendations from Azure Resource Graph.

arraystring() KQL function

The arraystring(arr: dynamic) function in Data Explorer returns a comma-delimited string for array elements.

Examples:

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

CommitmentDiscountUsage managed dataset

The CommitmentDiscountUsage managed dataset includes:

ingestion/CommitmentDiscountUsage storage folder.
CommitmentDiscountUsage_raw table in the Ingestion database.
CommitmentDiscountUsage_transform_v1_2() function in the Ingestion database.
CommitmentDiscountUsage_final_v1_2 table in the Ingestion database.
CommitmentDiscountUsage_v1_2() function in the Hub database.
CommitmentDiscountUsage() function in the Hub database.
CommitmentDiscountUsage table in Power BI reports.

The following are provided for backwards compatibility:

CommitmentDiscountUsage_transform_v1_0() function in the Ingestion database. This is no longer referenced and maintained for reference only.
CommitmentDiscountUsage_final_v1_0 table in the Ingestion database to host data ingested with FinOps hubs 0.7-0.11.
CommitmentDiscountUsage_v1_0() function in the Hub database to convert all data to FOCUS 1.0.

The CommitmentDiscountUsage_raw table supports Microsoft Cost Management reservation details export schemas for EA and MCA accounts. Data is transformed into a FOCUS-aligned dataset when ingested into the final table. This dataset does not explicitly support other clouds.

Columns in the CommitmentDiscountUsage managed dataset include:

Column	Type	Notes
ChargePeriodEnd	Date/time	Source: Hubs add-on.
ChargePeriodStart	Date/time	Source: Microsoft 2023-03-01.
CommitmentDiscountCategory	String	Source: Hubs add-on.
CommitmentDiscountId	String	Source: Microsoft 2023-03-01.
CommitmentDiscountQuantity	Real	New in FOCUS 1.2. Renamed from x_CommitmentDiscountQuantity. Source: Microsoft 2023-03-01.
CommitmentDiscountType	String	Source: Hubs add-on.
CommitmentDiscountUnit	String	New in FOCUS 1.2. Source: Hubs add-on.
ConsumedQuantity	Real	Source: Microsoft 2023-03-01.
ProviderName	String	Source: Hubs add-on.
ResourceId	String	Source: Microsoft 2023-03-01.
ResourceName	String	Source: Hubs add-on.
ResourceType	String	Source: Hubs add-on.
ServiceCategory	String	Source: Hubs add-on.
ServiceName	String	Source: Hubs add-on.
SubAccountId	String	Source: Hubs add-on.
x_CommitmentDiscountCommittedCount	Real	Source: Microsoft 2023-03-01.
x_CommitmentDiscountCommittedAmount	Real	Source: Microsoft 2023-03-01.
x_CommitmentDiscountNormalizedGroup	String	Source: Microsoft 2023-03-01.
x_CommitmentDiscountNormalizedRatio	Real	Source: Microsoft 2023-03-01.
x_IngestionTime	Date/time	Source: Hubs add-on.
x_ResourceGroupName	String	Source: Hubs add-on.
x_ResourceType	String	Source: Hubs add-on.
x_ServiceModel	String	Source: Hubs add-on.
x_SkuOrderId	String	Source: Microsoft 2023-03-01.
x_SkuSize	String	Source: Microsoft 2023-03-01.
x_SourceName	String	Source: Hubs add-on.
x_SourceProvider	String	Source: Hubs add-on.
x_SourceType	String	Source: Hubs add-on.
x_SourceVersion	String	Source: Hubs add-on.

Compliance calculation table

The Compliance calculation virtual table in Power BI reports that joins the PolicyAssignments and PolicyStates tables to summarize policy compliance.

Costs managed dataset

The Costs managed dataset includes:

ingestion/Costs storage folder.
Costs_raw table in the Ingestion database.
Costs_transform_v1_2() function in the Ingestion database.
Costs_final_v1_2 table in the Ingestion database.
Costs_v1_2() function in the Hub database.
Costs() function in the Hub database.
Costs table in Power BI reports.

The following are provided for backwards compatibility:

Costs_transform_v1_0() function in the Ingestion database. This is no longer referenced and maintained for reference only.
Costs_final_v1_0 table in the Ingestion database to host data ingested with FinOps hubs 0.7-0.11.
Costs_v1_0() function in the Hub database to convert all data to FOCUS 1.0.

The Costs_raw table supports FOCUS 1.0 data ingestion from the following service providers:

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

FinOps hubs does not support directly pulling data from other clouds, but if data is added to the ingestion storage container, it will be ingested with all custom columns.

Columns in the Costs managed dataset include:

Column	Type	Notes
AvailabilityZone	String
BilledCost	Real
BillingAccountId	String
BillingAccountName	String
BillingAccountType	String
BillingCurrency	String
BillingPeriodEnd	Date/time
BillingPeriodStart	Date/time
CapacityReservationId	String	New in FOCUS 1.2.
CapacityReservationStatus	String	New in FOCUS 1.2.
ChargeCategory	String
ChargeClass	String
ChargeDescription	String
ChargeFrequency	String
ChargePeriodEnd	Date/time
ChargePeriodStart	Date/time
CommitmentDiscountCategory	String
CommitmentDiscountId	String
CommitmentDiscountName	String
CommitmentDiscountQuantity	Real	New in FOCUS 1.2.
CommitmentDiscountStatus	String
CommitmentDiscountType	String
CommitmentDiscountUnit	String	New in FOCUS 1.2.
ConsumedQuantity	Real
ConsumedUnit	String
ContractedCost	Real
ContractedUnitPrice	Real
EffectiveCost	Real
InvoiceId	String	New in FOCUS 1.2. Renamed from x_InvoiceId.
InvoiceIssuerName	String
ListCost	Real
ListUnitPrice	Real
PricingCategory	String
PricingCurrency	String	New in FOCUS 1.2. Renamed from x_PricingCurrency.
PricingQuantity	Real
PricingUnit	String
ProviderName	String
PublisherName	String
RegionId	String
RegionName	String
ResourceId	String
ResourceName	String
ResourceType	String
ServiceCategory	String
ServiceName	String
ServiceSubcategory	String	New in FOCUS 1.2.
SkuId	String
SkuMeter	String	New in FOCUS 1.2. Renamed from x_SkuMeterName.
SkuPriceDetails	Dynamic	New in FOCUS 1.2. Transformed version of x_SkuDetails.
SkuPriceId	String
SubAccountId	String
SubAccountName	String
SubAccountType	String
Tags	Dynamic
x_AccountId	String	Source: Microsoft 1.0-preview(v1)+.
x_AccountName	String	Source: Microsoft 1.0-preview(v1)+.
x_AccountOwnerId	String	Source: Microsoft 1.0-preview(v1)+.
x_AmortizationClass	String	Source: Microsoft 1.2-preview+.
x_BilledCostInUsd	Real	Source: Microsoft 1.0-preview(v1)+.
x_BilledUnitPrice	Real	Source: Microsoft 1.0-preview(v1)+.
x_BillingAccountAgreement	String	Source: Hubs add-on.
x_BillingAccountId	String	Source: Microsoft 1.0-preview(v1)+.
x_BillingAccountName	String	Source: Microsoft 1.0-preview(v1)+.
x_BillingExchangeRate	Real	Source: Microsoft 1.0-preview(v1)+.
x_BillingExchangeRateDate	Date/time	Source: Microsoft 1.0-preview(v1)+.
x_BillingItemCode	String	Source: Alibaba 1.0.
x_BillingItemName	String	Source: Alibaba 1.0.
x_BillingProfileId	String	Source: Microsoft 1.0-preview(v1)+.
x_BillingProfileName	String	Source: Microsoft 1.0-preview(v1)+.
x_ChargeId	String	Source: Microsoft 1.0-preview(v1) only.
x_CommitmentDiscountNormalizedRatio	Real	Source: Microsoft 1.2-preview+.
x_CommitmentDiscountPercent	String	Source: Hubs add-on.
x_CommitmentDiscountSavings	String	Source: Hubs add-on.
x_CommitmentDiscountSpendEligibility	String	Source: Hubs add-on.
x_CommitmentDiscountUsageEligibility	String	Source: Hubs add-on.
x_CommitmentDiscountUtilizationAmount	String	Source: Hubs add-on.
x_CommitmentDiscountUtilizationPotential	String	Source: Hubs add-on.
x_CommodityCode	String	Source: Alibaba 1.0.
x_CommodityName	String	Source: Alibaba 1.0.
x_ConsumedCoreHours	Real	Source: Hubs add-on.
x_ContractedCostInUsd	Real	Source: Microsoft 1.0+.
x_CostAllocationRuleName	String	Source: Microsoft 1.0-preview(v1)+.
x_CostCategories	Dynamic	Source: AWS 1.0 (JSON).
x_CostCenter	String	Source: Microsoft 1.0-preview(v1)+.
x_CostType	String	Source: GCP Jan 2024.
x_Credits	Dynamic	Source: GCP Jan 2024.
x_CurrencyConversionRate	Real	Source: GCP Jun 2024.
x_CustomerId	String	Source: Microsoft 1.0-preview(v1)+.
x_CustomerName	String	Source: Microsoft 1.0-preview(v1)+.
x_Discount	Dynamic	Source: AWS 1.0 (JSON).
x_EffectiveCostInUsd	Real	Source: Microsoft 1.0-preview(v1)+.
x_EffectiveUnitPrice	Real	Source: Microsoft 1.0-preview(v1)+.
x_ExportTime	Date/time	Source: GCP Jan 2024.
x_IngestionTime	Date/time	Source: Hubs add-on.
x_InstanceID	String	Source: Alibaba 1.0.
x_InvoiceIssuerId	String	Source: Microsoft 1.0-preview(v1)+.
x_InvoiceSectionId	String	Source: Microsoft 1.0-preview(v1)+.
x_InvoiceSectionName	String	Source: Microsoft 1.0-preview(v1)+.
x_ListCostInUsd	Real	Source: Microsoft 1.0-preview(v1)+.
x_Location	String	Source: GCP Jan 2024.
x_NegotiatedDiscountSavings	String	Source: Hubs add-on.
x_NegotiatedDiscountPercent	String	Source: Hubs add-on.
x_Operation	String	Source: AWS 1.0.
x_PartnerCreditApplied	String	Source: Microsoft 1.0-preview(v1)+.
x_PartnerCreditRate	String	Source: Microsoft 1.0-preview(v1)+.
x_PricingBlockSize	Real	Source: Microsoft 1.0-preview(v1)+.
x_PricingSubcategory	String	Source: Microsoft 1.0-preview(v1)+.
x_PricingUnitDescription	String	Source: Microsoft 1.0-preview(v1)+.
x_Project	String	Source: GCP Jan 2024.
x_PublisherCategory	String	Source: Microsoft 1.0-preview(v1)+.
x_PublisherId	String	Source: Microsoft 1.0-preview(v1)+.
x_ResellerId	String	Source: Microsoft 1.0-preview(v1)+.
x_ResellerName	String	Source: Microsoft 1.0-preview(v1)+.
x_ResourceGroupName	String	Source: Microsoft 1.0-preview(v1)+.
x_ResourceType	String	Source: Microsoft 1.0-preview(v1)+.
x_ServiceCode	String	Source: AWS 1.0.
x_ServiceId	String	Source: GCP Jan 2024.
x_ServiceModel	String	Source: Microsoft 1.2-preview+.
x_ServicePeriodEnd	Date/time	Source: Microsoft 1.0-preview(v1)+.
x_ServicePeriodStart	Date/time	Source: Microsoft 1.0-preview(v1)+.
x_SkuCoreCount	String	Source: Hubs add-on.
x_SkuDescription	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuDetails	Dynamic	Source: Microsoft 1.0-preview(v1)+.
x_SkuInstanceType	String	Source: Hubs add-on.
x_SkuIsCreditEligible	Bool	Source: Microsoft 1.0-preview(v1)+.
x_SkuLicenseQuantity	String	Source: Hubs add-on.
x_SkuLicenseStatus	String	Source: Hubs add-on.
x_SkuLicenseType	String	Source: Hubs add-on.
x_SkuLicenseUnit	String	Source: Hubs add-on.
x_SkuMeterCategory	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuMeterId	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuMeterSubcategory	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuOfferId	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuOperatingSystem	String	Source: Hubs add-on.
x_SkuOrderId	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuOrderName	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuPartNumber	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuPlanName	String	Source: Microsoft 1.2-preview+.
x_SkuRegion	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuServiceFamily	String	Source: Microsoft 1.0-preview(v1)+.
x_SkuTerm	Int	Source: Microsoft 1.0-preview(v1)+.
x_SkuTier	String	Source: Microsoft 1.0-preview(v1)+.
x_SourceChanges	String	Source: Hubs add-on.
x_SourceName	String	Source: Hubs add-on.
x_SourceProvider	String	Source: Hubs add-on.
x_SourceType	String	Source: Hubs add-on.
x_SourceValues	Dynamic	Source: Hubs add-on.
x_SourceVersion	String	Source: Hubs add-on.
x_TotalDiscountPercent	String	Source: Hubs add-on.
x_TotalSavings	String	Source: Hubs add-on.
x_UsageType	String	Source: AWS 1.0.

datestring() KQL function

The datestring(start: datetime, [end: datetime]) function in Data Explorer returns a formatted date or date range (for example, Jan 1-Feb 3). Formatted dates are the shortest possible value based on the current date.

Examples:

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)) = "Dec 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"

delta() KQL function

The delta(oldValue: double, newValue: double) function in Data Explorer compares 2 values and returns the percentage change from oldValue to newValue.

Examples:

delta(1, 2.5) = 1.5
delta(2, 1.5) = -0.5

deltastring() KQL function

The deltastring(oldValue: double, newValue: double, [places: int], [useArrows: bool]) function in Data Explorer returns the percentage difference between two numbers as a string using the specified number of decimal places. The useArrows parameter indicates whether to use arrows for positive and negative changes.

Examples:

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"

diffstring() KQL function

The diffstring(oldValue: double, newValue: double, [places: int]) function in Data Explorer returns the difference between two numbers as a string with a plus or minus sign and optionally rounds it to a specified number of places.

Examples:

plusminus(1.2, 3.4) = "+2.2"
plusminus(3.4567, 1.2345, 2) = "-2.22"

Disks table

The Disks table in Power BI reports that queries Azure virtual machine managed disks from Azure Resource Graph.

HubScopes table

In Power BI, the HubScopes table summarizes the scopes that were ingested into FinOps hubs. This table is derived from the config/settings.json file in storage.

In Data Explorer, the HubScopes function summarizes the scopes that were identified in the HubSettings function.

HubSettings table

In Power BI, the HubSettings table pulls configuration settings from the config/settings.json file in storage for the FinOps hub instance.

In Data Explorer, the HubSettingsLog table holds a history of all settings.json file updates. The HubSettings() function in Data Explorer returns the latest settings entry from the HubSettingsLog table.

ifempty() KQL function

The ifempty(value: dynamic, defaultValue: dynamic) function in Data Explorer returns the defaultValue if the specified value is empty.

Examples:

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

ManagementGroups table

The ManagementGroups table in Power BI reports that queries Azure management groups from Azure Resource Graph.

monthstring() KQL function

The monthstring(date: datetime, [length: int]) function in Data Explorer returns the name of the month for the specified date (for example, "Jan" or "January"). The length parameter indicates how many characters the month name should be. By default, the full name will be used.

Examples:

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

NetworkInterfaces table

The NetworkInterfaces table in Power BI reports that queries Azure network interfaces from Azure Resource Graph.

NetworkSecurityGroups table

The NetworkSecurityGroups table in Power BI reports that queries Azure network security groups from Azure Resource Graph.

numberstring() KQL function

The numberstring(num: double, [abbrev: bool]) function in Data Explorer converts a number to a formatted and optionally abbreviated string.

Examples:

numberstring(1234) = "1.23K"
numberstring(12345) = "12.3K"
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"

parse_resourceid() KQL function

The parse_resourceid(resourceId: string) function parses the specified Azure resource ID to extract resource attributes like the name, type, resource group, and subaccount ID.

Example:

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"
}

percent() KQL function

The percent(table: (Count: long)) function in Data Explorer calculates the percentage of each record based on a required Count column.

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

percentOfTotal() KQL function

The percentOfTotal(table: (Count: long), total: long) function in Data Explorer calculates the percentage of each record based on a required Count column. This function adds a new Percent column that divides the Count column by the specified total value.

percentstring KQL function

The percentstring(num: double, [total: double], [places: int]) function in Data Explorer returns the specified number as a percentage of the total as a string, using the specified number of decimal places. If the total parameter is not specified, 1.0 is used as the default total.

Examples:

percentstring(0.5) = "50%"
percentstring(0.5, 2) = "25%"
percentstring(0.5, 3, 2) = "16.67%"

plusminus() KQL function

The ****plusminus KQL function in Data Explorer a +/- sign based on the direction of the number. plusminus(val: string) { let neg = substring(val, 0, 1) == '-'; iff(neg, val, strcat('+', val)) }

PolicyAssignments table

The PolicyAssignments table in Power BI reports that queries Azure Policy assignments from Azure Resource Graph.

PolicyDefinitions table

The PolicyDefinitions table in Power BI reports that queries Azure Policy definitions from Azure Resource Graph.

PolicyStates table

The PolicyStates table in Power BI reports that queries Azure Policy states from Azure Resource Graph.

Prices managed dataset

The Prices managed dataset includes:

ingestion/Prices storage folder.
Prices_raw table in the Ingestion database.
Prices_transform_v1_2() function in the Ingestion database.
Prices_final_v1_2 table in the Ingestion database.
Prices_v1_2() function in the Hub database.
Prices() function in the Hub database.
Prices table in Power BI reports.

The following are provided for backwards compatibility:

Prices_transform_v1_0() function in the Ingestion database. This is no longer referenced and maintained for reference only.
Prices_final_v1_0 table in the Ingestion database to host data ingested with FinOps hubs 0.7-0.11.
Prices_v1_0() function in the Hub database to convert all data to FOCUS 1.0.

The Prices_raw table supports Microsoft Cost Management export schemas for EA and MCA accounts. Data is transformed into a FOCUS-aligned dataset when ingested into the final table. This dataset does not explicitly support other clouds.

Columns in the Prices managed dataset include:

Column	Type	Notes
BillingAccountId	String
BillingAccountName	String
BillingCurrency	String
ChargeCategory	String
CommitmentDiscountCategory	String
CommitmentDiscountType	String
CommitmentDiscountUnit	String
ContractedUnitPrice	Real
ListUnitPrice	Real
PricingCategory	String
PricingCurrency	String	New in FOCUS 1.2. Renamed from x_PricingCurrency.
PricingUnit	String
SkuId	String
SkuMeter	String	New in FOCUS 1.2. Renamed from x_SkuMeterName.
SkuPriceId	String
SkuPriceIdv2	String	Source: Hubs add-on.
x_BaseUnitPrice	Real	Source: Microsoft.
x_BillingAccountAgreement	String	Source: Hubs add-on.
x_BillingAccountId	String	Source: Microsoft, MCA only.
x_BillingProfileId	String	Source: Microsoft, MCA only.
x_CommitmentDiscountNormalizedRatio	Real	Source: Hubs add-on.
x_CommitmentDiscountSpendEligibility	String	Source: Hubs add-on.
x_CommitmentDiscountUsageEligibility	String	Source: Hubs add-on.
x_ContractedUnitPriceDiscount	Real	Source: Hubs add-on.
x_ContractedUnitPriceDiscountPercent	Real	Source: Hubs add-on.
x_EffectivePeriodEnd	Date/time	Source: Microsoft.
x_EffectivePeriodStart	Date/time	Source: Microsoft.
x_EffectiveUnitPrice	Real	Source: Microsoft.
x_EffectiveUnitPriceDiscount	Real	Source: Hubs add-on.
x_EffectiveUnitPriceDiscountPercent	Real	Source: Hubs add-on.
x_IngestionTime	Date/time	Source: Hubs add-on.
x_PricingBlockSize	Real	Source: Hubs add-on.
x_PricingSubcategory	String	Source: Hubs add-on.
x_PricingUnitDescription	String	Source: Microsoft.
x_SkuDescription	String	Source: Microsoft.
x_SkuId	String	Source: Microsoft.
x_SkuIncludedQuantity	Real	Source: Microsoft, EA only.
x_SkuMeterCategory	String	Source: Microsoft.
x_SkuMeterId	String	Source: Microsoft.
x_SkuMeterSubcategory	String	Source: Microsoft.
x_SkuMeterType	String	Source: Microsoft.
x_SkuPriceType	String	Source: Microsoft.
x_SkuProductId	String	Source: Microsoft.
x_SkuRegion	String	Source: Microsoft.
x_SkuServiceFamily	String	Source: Microsoft.
x_SkuOfferId	String	Source: Microsoft, EA only.
x_SkuPartNumber	String	Source: Microsoft, EA only.
x_SkuTerm	Int	Source: Microsoft.
x_SkuTier	Real	Source: Microsoft, MCA only.
x_SourceName	String	Source: Hubs add-on.
x_SourceProvider	String	Source: Hubs add-on.
x_SourceType	String	Source: Hubs add-on.
x_SourceVersion	String	Source: Hubs add-on.
x_TotalUnitPriceDiscount	Real	Source: Hubs add-on.
x_TotalUnitPriceDiscountPercent	Real	Source: Hubs add-on.

PricingUnits table

The PricingUnits table in Power BI and Data Explorer is populated from the Pricing units open data file. This table is used to normalize Prices.

PublicIPAddresses table

The PublicIPAddresses table in Power BI reports that queries Azure public IP addresses from Azure Resource Graph.

Recommendations managed dataset

The Recommendations managed dataset includes:

ingestion/Recommendations storage folder.
Recommendations_raw table in the Ingestion database.
Recommendations_transform_v1_2() function in the Ingestion database.
Recommendations_final_v1_2 table in the Ingestion database.
Recommendations_v1_2() function in the Hub database.
Recommendations() function in the Hub database.
Recommendations table in Power BI reports.

The following are provided for backwards compatibility:

Recommendations_transform_v1_0() function in the Ingestion database. This is no longer referenced and maintained for reference only.
Recommendations_final_v1_0 table in the Ingestion database to host data ingested with FinOps hubs 0.7-0.11.
Recommendations_v1_0() function in the Hub database to convert all data to FOCUS 1.0.

The Recommendations_raw table supports Microsoft Cost Management reservation recommendation export schemas for EA and MCA accounts. Data is transformed into a FOCUS-aligned dataset when ingested into the final table. This dataset does not explicitly support other clouds.

Columns in the Recommendations managed dataset include:

Column	Type	Notes
ProviderName	String	Source: Microsoft EA+MCA 2023-05-01.
ResourceId	String
ResourceName	String
ResourceType	String
SubAccountId	String	Source: Microsoft EA+MCA 2023-05-01.
SubAccountName	String
x_EffectiveCostAfter	Real	Source: Microsoft EA+MCA 2023-05-01.
x_EffectiveCostBefore	Real	Source: Microsoft EA+MCA 2023-05-01.
x_EffectiveCostSavings	Real	Source: Microsoft EA+MCA 2023-05-01.
x_IngestionTime	Datetime	Source: Hubs add-on.
x_RecommendationCategory	String	Source: Hubs recommendations.
x_RecommendationDate	Datetime	Source: Microsoft EA+MCA 2023-05-01.
x_RecommendationDescription	String	Source: Hubs add-on.
x_RecommendationDetails	Dynamic	Contains source-specific metadata. See notes below the table.
x_RecommendationId	String	Source: Hubs recommendations.
x_ResourceGroupName	String
x_SourceName	String	Source: Hubs add-on.
x_SourceProvider	String	Source: Hubs add-on.
x_SourceType	String	Source: Hubs add-on.
x_SourceVersion	String	Source: Hubs add-on.

The x_RecommendationDetails column is a dynamic object that contains source-specific metadata. For Cost Management reservation recommendations, it includes commitment discount details like scope, term, SKU, and region. For hubs recommendations, it includes the recommendation provider, solution, type ID, resource type, and any additional properties from the query.

Regions table

The Regions table in Power BI and Data Explorer is populated from the Regions open data file. This table is used to facilitate data cleansing.

ReservationRecommendations table

The ReservationRecommendations table in Power BI pulls data from the Recommendations managed dataset, but filtered down to only reservation recommendations.

Resources table

The Resources table in Power BI reports that queries Azure resources from Azure Resource Graph.

resource_type() KQL function

The resource_type(resourceType: string) function in Data Explorer returns an object with details about the specified Azure resource type.

Examples:

resource_type('Microsoft.Compute/virtualMachines') = { "SingularDisplayName": "Virtual machine" }
resource_type('Microsoft.Billing/billingAccounts') = { "SingularDisplayName": "Billing account" }

ResourceTypes table

The ResourceTypes table in Power BI and Data Explorer is populated from the Resource types open data file. This table is used to facilitate data cleansing.

SqlDatabases table

The SqlDatabases table in Power BI reports that queries SQL Azure databases from Azure Resource Graph.

Services table

The Services table in Data Explorer is populated from the Services open data file. This table is used to facilitate data cleansing.

StorageData table

The StorageData table in Power BI is populated from all files discovered in the Azure Data Lake Storage account. This table is used to identify data ingestion errors in the Data ingestion report.

StorageErrors table

The StorageErrors table in Power BI is derived from the StorageData table. This table is used to summarize data ingestion errors in the Data ingestion report.

Subscriptions table

The Subscriptions table in Power BI reports that queries Azure subscriptions from Azure Resource Graph.

Transactions managed dataset

The Transactions managed dataset includes:

ingestion/Transactions storage folder.
Transactions_raw table in the Ingestion database.
Transactions_transform_v1_2() function in the Ingestion database.
Transactions_final_v1_2 table in the Ingestion database.
Transactions_v1_2() function in the Hub database.
Transactions() function in the Hub database.
Transactions table in Power BI reports.

The following are provided for backwards compatibility:

Transactions_transform_v1_0() function in the Ingestion database. This is no longer referenced and maintained for reference only.
Transactions_final_v1_0 table in the Ingestion database to host data ingested with FinOps hubs 0.7-0.11.
Transactions_v1_0() function in the Hub database to convert all data to FOCUS 1.0.

The Transactions_raw table supports Microsoft Cost Management reservation transactions export schemas for EA and MCA accounts. Data is transformed into a FOCUS-aligned dataset when ingested into the final table. This dataset does not explicitly support other clouds.

Columns in the Transactions managed dataset include:

Column	Type	Notes
BilledCost	Real	Source: Microsoft EA+MCA 2023-05-01.
BillingAccountId	String	Source: Microsoft EA+MCA 2023-05-01.
BillingAccountName	String	Source: Microsoft EA+MCA 2023-05-01.
BillingCurrency	String	Source: Microsoft EA+MCA 2023-05-01.
BillingPeriodEnd	Date/time	Source: Microsoft EA+MCA 2023-05-01.
BillingPeriodStart	Date/time	Source: Microsoft EA+MCA 2023-05-01.
ChargeCategory	String	Source: Hubs add-on.
ChargeClass	String	Source: Hubs add-on.
ChargeDescription	String	Source: Microsoft EA+MCA 2023-05-01.
ChargeFrequency	String	Source: Microsoft EA+MCA 2023-05-01.
ChargePeriodStart	Date/time	Source: Microsoft EA+MCA 2023-05-01.
InvoiceId	String	New in FOCUS 1.2. Renamed from x_InvoiceId. Source: Microsoft MCA 2023-05-01.
PricingQuantity	Real	Source: Microsoft EA+MCA 2023-05-01.
PricingUnit	String	Source: Hubs add-on.
ProviderName	String	Source: Hubs add-on.
RegionId	String	Source: Microsoft EA+MCA 2023-05-01.
RegionName	String	Source: Microsoft EA+MCA 2023-05-01.
SubAccountId	String	Source: Microsoft EA+MCA 2023-05-01.
SubAccountName	String	Source: Microsoft EA+MCA 2023-05-01.
x_AccountName	String	Source: Microsoft EA 2023-05-01.
x_AccountOwnerId	String	Source: Microsoft EA 2023-05-01.
x_CostCenter	String	Source: Microsoft EA 2023-05-01.
x_InvoiceNumber	String	Source: Microsoft MCA 2023-05-01.
x_InvoiceSectionId	String	Source: Microsoft MCA 2023-05-01.
x_InvoiceSectionName	String	Source: Microsoft MCA 2023-05-01.
x_IngestionTime	Date/time	Source: Hubs add-on.
x_MonetaryCommitment	Real	Source: Microsoft EA 2023-05-01.
x_Overage	Real	Source: Microsoft EA 2023-05-01.
x_PurchasingBillingAccountId	String	Source: Microsoft EA 2023-05-01.
x_SkuOrderId	String	Source: Microsoft EA+MCA 2023-05-01.
x_SkuOrderName	String	Source: Microsoft EA+MCA 2023-05-01.
x_SkuSize	String	Source: Microsoft EA+MCA 2023-05-01.
x_SkuTerm	Int	Source: Microsoft EA+MCA 2023-05-01.
x_SourceName	String	Source: Hubs add-on.
x_SourceProvider	String	Source: Hubs add-on.
x_SourceType	String	Source: Hubs add-on.
x_SourceVersion	String	Source: Hubs add-on.
x_SubscriptionId	String	Source: Microsoft EA+MCA 2023-05-01.
x_TransactionType	String	Source: Microsoft EA+MCA 2023-05-01.

updown() KQL function

The updown(value: string) function in Data Explorer returns an up or down arrow based on whether the specified value is positive or negative.

Examples:

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

VirtualMachines table

The VirtualMachines table in Power BI reports that queries Azure virtual machines from Azure Resource Graph.

Give feedback

Let us know how we're doing with a quick review. We use these reviews to improve and expand FinOps tools and resources.

[!div class="nextstepaction"] Give feedback

If you're looking for something specific, vote for an existing or create a new idea. Share ideas with others to get more votes. We focus on ideas with the most votes.

[!div class="nextstepaction"] Vote on or suggest ideas

FilesExpand file tree

data-model.md

Latest commit

History

data-model.md

File metadata and controls

FinOps hub data model

Prerequisites

Summarizing the data model

Schema version

Managed datasets in FinOps hubs

Power BI functions

AdvisorRecommendations table

arraystring() KQL function

CommitmentDiscountUsage managed dataset

Compliance calculation table

Costs managed dataset

datestring() KQL function

delta() KQL function

deltastring() KQL function

diffstring() KQL function

Disks table

HubScopes table

HubSettings table

ifempty() KQL function

ManagementGroups table

monthstring() KQL function

NetworkInterfaces table

NetworkSecurityGroups table

numberstring() KQL function

parse_resourceid() KQL function

percent() KQL function

percentOfTotal() KQL function

percentstring KQL function

plusminus() KQL function

PolicyAssignments table

PolicyDefinitions table

PolicyStates table

Prices managed dataset

PricingUnits table

PublicIPAddresses table

Recommendations managed dataset

Regions table

ReservationRecommendations table

Resources table

resource_type() KQL function

ResourceTypes table

SqlDatabases table

Services table

StorageData table

StorageErrors table

Subscriptions table

Transactions managed dataset

updown() KQL function

VirtualMachines table

Give feedback