Add FOCUS 1.4 hub functions (HubSetup_v1_4.kql) by flanakin · Pull Request #2128 · microsoft/finops-toolkit

flanakin · 2026-05-06T15:22:04Z

Summary

Renames HubSetup_v1_3.kql → HubSetup_v1_4.kql, consolidating all hub functions (including ContractCommitment) for FOCUS 1.4 GA
Updates HubSetup_Latest.kql to alias all unversioned functions (Costs(), Prices(), etc.) to their _v1_4() counterparts
Adds ContractCommitment() unversioned alias in HubSetup_Latest.kql
Updates app.bicep and .build.config to reference v1_4 hub scripts

Test plan

HubSetup_v1_4.kql contains functions for all datasets: CommitmentDiscountUsage, ContractCommitment, Costs, Prices, Recommendations, Transactions
HubSetup_Latest.kql aliases all unversioned functions to _v1_4()
Costs_v1_4() unions Costs_final_v1_4, Costs_final_v1_2, and Costs_final_v1_0 for backward compatibility

🤖 Generated with Claude Code

Adds IngestionSetup_v1_3.kql with Costs/Prices/CommitmentDiscountUsage/ Recommendations/Transactions transforms and final tables renamed for FOCUS 1.3. Cost and Usage gains 8 new FOCUS 1.3 columns: AllocatedMethodId/Details/ResourceId/ResourceName/Tags (data-generator split cost allocation), ContractApplied (per-row contract commitment application), ServiceProviderName + HostProviderName (replacing the deprecated ProviderName/PublisherName, with empty-fallback for back compat). Costs_raw now carries the new columns so downstream v1_2 transforms keep working and v1_3 transforms can read them directly. The v1_3 file is wired into the Bicep deployment alongside v1_0 and v1_2. The unversioned Costs() function still aliases to v1_2 — phase 2 adds Costs_v1_3() and retargets Latest. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Adds HubSetup_v1_3.kql with Costs_v1_3, Prices_v1_3, CommitmentDiscountUsage_v1_3, Recommendations_v1_3, and Transactions_v1_3 that union the new Costs_final_v1_3 with the existing Costs_final_v1_2 and Costs_final_v1_0 tables. For v1_2 data unioned into the v1_3 view, the 8 new FOCUS 1.3 columns default to null/empty and ServiceProviderName/HostProviderName are populated from the deprecated ProviderName/PublisherName for back compat. The same defaults apply to the v1_0 union arm on top of the existing v1_0 -> v1_2 conversion. HubSetup_Latest.kql aliases now point to *_v1_3 functions so the unversioned Costs(), Prices(), etc. return the latest schema. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Consolidates FOCUS 1.3 and 1.4 column additions into a single v1_4 ingestion setup file. Removes the intermediate v1_3 file, adds ContractCommitment_raw table definition, and updates app.bicep and .build.config to reference v1_4. Co-Authored-By: Claude <noreply@anthropic.com>

…cus14-phase2-hubs-1.3

Renames HubSetup_v1_3.kql to HubSetup_v1_4.kql, consolidating all hub functions (including ContractCommitment) for FOCUS 1.4 GA. Updates HubSetup_Latest.kql to alias all unversioned functions to v1_4. Updates app.bicep and .build.config to reference v1_4. Co-Authored-By: Claude <noreply@anthropic.com>

- Pluralize ContractCommitments_raw / _transform_v1_4 / _final_v1_4 / mapping / update policy - Add BillingPeriods_raw + IngestionSetup_v1_4 transforms/finals/policies (FOCUS 1.4 supplemental dataset) - Add InvoiceDetails_raw + IngestionSetup_v1_4 transforms/finals/policies (FOCUS 1.4 supplemental dataset) - Add 12 ContractCommitment* per-row columns + CommitmentProgramEligibilityDetails + InvoiceDetailId to Costs_raw, Costs_final_v1_4, and Costs_transform_v1_4 - Fix x_Source* annotations on ContractCommitments_raw to Hubs v1_4+ - Update Costs_raw ProviderName/PublisherName annotations to FOCUS 0.5-1.3 (removed in 1.4; kept for back compat) - Update Costs_raw Region annotation: deprecated -> removed - File #2159 for the FOCUS 1.4 native-columns architecture research 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Michael Flanakin <flanakin@users.noreply.github.com> Co-Authored-By: Claude <noreply@anthropic.com>

…cus14-phase2-hubs-1.3

- Rename ContractCommitment_v1_4() -> ContractCommitments_v1_4() (and update folder label) - Add BillingPeriods_v1_4() and InvoiceDetails_v1_4() hub functions - Add BillingPeriods(), ContractCommitments() (renamed), and InvoiceDetails() unversioned aliases in HubSetup_Latest.kql - Add CommitmentProgramEligibilityDetails + 12 ContractCommitment* + InvoiceDetailId column defaults to Costs_final_v1_0 and Costs_final_v1_2 union arms (back-compat shims) and add them to the project list 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Michael Flanakin <flanakin@users.noreply.github.com> Co-Authored-By: Claude <noreply@anthropic.com>

flanakin · 2026-05-26T07:25:05Z

🤖 [AI][Claude Code] PR Update Summary

Cascade of PR #2126 feedback (#2126 review threads 1, 4, 5, 6):

✅ Pluralized ContractCommitment_v1_4() -> ContractCommitments_v1_4()
✅ Added BillingPeriods_v1_4() and InvoiceDetails_v1_4() hub functions with matching HubSetup_Latest aliases
✅ Added new FOCUS 1.4 column defaults (CommitmentProgramEligibilityDetails, 12 ContractCommitment* columns, InvoiceDetailId) to the Costs_v1_4() back-compat union arms
✅ Updated Costs_v1_4() project list to include the new columns

Depends on PR #2126 (ingestion side).

flanakin · 2026-05-27T06:46:27Z

Should this be in this PR? It's already in PR #2127

flanakin · 2026-05-27T06:47:15Z

Same comment: This is already in PR @2126

Do we want to review it here or there?

flanakin · 2026-05-27T06:53:35Z

+// BillingPeriods_final_v1_4
+.create-or-alter function
+with (docstring = 'Gets all billing periods aligned to FOCUS 1.4.', folder = 'BillingPeriods')
+BillingPeriods_v1_4()


Sort this list alphabetically. BillingPeriods should be before CommitmentDiscountUsage and InvoiceDetails should be after Costs.

flanakin · 2026-05-27T06:54:42Z

We're missing the updates to the HubSetup_v1_0.kql and HubSetup_v1_2.kql functions to backport v1_4 data to those schemas.

flanakin · 2026-05-28T10:08:51Z

+        PricingCurrency,
+        PricingQuantity,
+        PricingUnit,
+        // ProviderName and PublisherName removed in FOCUS 1.4. Use ServiceProviderName / HostProviderName.


Suggested change

// ProviderName and PublisherName removed in FOCUS 1.4. Use ServiceProviderName / HostProviderName.

flanakin · 2026-05-28T10:11:09Z

+
+
+//======================================================================================================================
+// Latest FOCUS version


This section doesn't belong in this file. It's in the HubSetup_Latest.kql file already

flanakin · 2026-05-28T10:25:22Z

+with (docstring = 'Gets all commitment discount usage records aligned to FOCUS 1.4.', folder = 'CommitmentDiscountUsage')
+CommitmentDiscountUsage_v1_4()
+{
+    database('Ingestion').CommitmentDiscountUsage_final_v1_4


Suggested change

database('Ingestion').CommitmentDiscountUsage_final_v1_4

database('Ingestion').CommitmentDiscountUsage_final_v1_4

| union (database('Ingestion').CommitmentDiscountUsage_final_v1_2)

flanakin · 2026-05-28T10:42:20Z

+with (docstring = 'Gets all prices aligned to FOCUS 1.4.', folder = 'Prices')
+Prices_v1_4()
+{
+    database('Ingestion').Prices_final_v1_4


Suggested change

database('Ingestion').Prices_final_v1_4

database('Ingestion').Prices_final_v1_4

| union (database('Ingestion').Prices_final_v1_2)

flanakin · 2026-05-28T10:42:56Z

+with (docstring = 'Gets all recommendations aligned to FOCUS 1.4.', folder = 'Recommendations')
+Recommendations_v1_4()
+{
+    database('Ingestion').Recommendations_final_v1_4


Suggested change

database('Ingestion').Recommendations_final_v1_4

database('Ingestion').Recommendations_final_v1_4

| union (database('Ingestion').Recommendations_final_v1_2)

flanakin · 2026-05-28T10:43:43Z

+with (docstring = 'Gets all transactions aligned to FOCUS 1.4.', folder = 'Transactions')
+Transactions_v1_4()
+{
+    database('Ingestion').Transactions_final_v1_4


Suggested change

database('Ingestion').Transactions_final_v1_4

database('Ingestion').Transactions_final_v1_4

| union (database('Ingestion').Transactions_final_v1_2)

flanakin and others added 2 commits May 6, 2026 08:07

Copilot AI review requested due to automatic review settings May 6, 2026 15:22

flanakin requested review from MSBrett and RolandKrummenacher as code owners May 6, 2026 15:22

microsoft-github-policy-service Bot requested a review from helderpinto May 6, 2026 15:22

microsoft-github-policy-service Bot added the Needs: Review 👀 PR that is ready to be reviewed label May 6, 2026

Copilot started reviewing on behalf of flanakin May 6, 2026 15:22 View session

microsoft-github-policy-service Bot assigned MSBrett May 6, 2026

microsoft-github-policy-service Bot added the Tool: FinOps hubs Data pipeline solution label May 6, 2026

microsoft-github-policy-service Bot assigned helderpinto and RolandKrummenacher May 6, 2026

This was referenced May 6, 2026

Add ContractCommitment dataset #2130

Closed

FOCUS 1.3 and 1.4 support across the toolkit #2120

Open

flanakin changed the base branch from flanakin/focus14-phase1-ingestion-1.3 to flanakin/focus14 May 6, 2026 23:00

flanakin marked this pull request as draft May 6, 2026 23:16

flanakin added this to the v15 milestone May 15, 2026

flanakin and others added 3 commits May 17, 2026 13:24

Merge branch 'flanakin/focus14-phase1-ingestion-1.3' into flanakin/fo…

7d9d295

…cus14-phase2-hubs-1.3

flanakin changed the title ~~Add FOCUS 1.3 hub functions (HubSetup_v1_3.kql)~~ Add FOCUS 1.4 hub functions (HubSetup_v1_4.kql) May 17, 2026

flanakin mentioned this pull request May 17, 2026

Add FOCUS 1.4-preview hub functions (HubSetup_v1_4.kql) #2134

Closed

3 tasks

flanakin mentioned this pull request May 26, 2026

Add FOCUS 1.4 ingestion (IngestionSetup_v1_4.kql) #2126

Draft

3 tasks

flanakin and others added 2 commits May 26, 2026 00:22

Merge branch 'flanakin/focus14-phase1-ingestion-1.3' into flanakin/fo…

6f2ec90

…cus14-phase2-hubs-1.3

This was referenced May 26, 2026

Refresh Claude Code plugin skill files for FOCUS 1.4 #2135

Draft

Add FOCUS 1.4 schema tests and changelog entries #2136

Draft

flanakin commented May 28, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add FOCUS 1.4 hub functions (HubSetup_v1_4.kql)#2128

Add FOCUS 1.4 hub functions (HubSetup_v1_4.kql)#2128
flanakin wants to merge 8 commits into
flanakin/focus14from
flanakin/focus14-phase2-hubs-1.3

flanakin commented May 6, 2026 •

edited

Loading

Uh oh!

flanakin commented May 26, 2026

Uh oh!

flanakin May 27, 2026

Uh oh!

flanakin May 27, 2026

Uh oh!

flanakin May 27, 2026

Uh oh!

flanakin May 27, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

flanakin May 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants



		//======================================================================================================================
		// Latest FOCUS version

	database('Ingestion').CommitmentDiscountUsage_final_v1_4
	database('Ingestion').CommitmentDiscountUsage_final_v1_4
	\| union (database('Ingestion').CommitmentDiscountUsage_final_v1_2)

	database('Ingestion').Prices_final_v1_4
	database('Ingestion').Prices_final_v1_4
	\| union (database('Ingestion').Prices_final_v1_2)

	database('Ingestion').Recommendations_final_v1_4
	database('Ingestion').Recommendations_final_v1_4
	\| union (database('Ingestion').Recommendations_final_v1_2)

	database('Ingestion').Transactions_final_v1_4
	database('Ingestion').Transactions_final_v1_4
	\| union (database('Ingestion').Transactions_final_v1_2)

Conversation

flanakin commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

flanakin commented May 26, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

flanakin commented May 6, 2026 •

edited

Loading