fabric-onelake-perf-remediate

Diagnose and remediate OneLake performance issues with PowerShell, T-SQL, and Spark SQL workflows.

16|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/PatrickGallucci/fabric-skills --skill fabric-onelake-perf-remediate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fabric-onelake-perf-remediate
Source: https://github.com/PatrickGallucci/fabric-skills/tree/main/skills/fabric-onelake-perf-remediate
Command: npx skills add https://github.com/PatrickGallucci/fabric-skills --skill fabric-onelake-perf-remediate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Az.Accounts, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Diagnose and resolve Microsoft Fabric OneLake performance issues across capacity, data layout, and cross-region access to keep your lakehouse responsive and cost-effective.

Core Features & Use Cases

  • Diagnostic workflows for capacity throttling, cold cache latency, small file problems, Delta table fragmentation, and cross-region latency.
  • Guidance for enabling and tuning V-Order, OPTIMIZE, and VACUUM, plus Direct Lake remediation and region latency testing.
  • PowerShell, T-SQL, and Spark SQL diagnostic routines with ready-to-run checks and scripts.

Quick Start

Begin by running the OneLake Performance health checks to identify bottlenecks and apply recommended remediation steps.

Frequently Asked Questions about fabric-onelake-perf-remediate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose slow OneLake lakehouse queries and cold cache latency?

OneLake performance diagnostics analyze capacity utilization, Delta file fragmentation, and cold cache latency using PowerShell, T-SQL, and Spark SQL routines to pinpoint lakehouse query bottlenecks. Ready-to-run scripts guide you through identifying and resolving these specific performance issues.

What is the best way to fix Delta table fragmentation and small-file proliferation in Fabric?

Remediating Delta table fragmentation and small-file proliferation in Fabric involves applying OPTIMIZE and VACUUM commands. This skill provides deterministic workflows and tuning guidance for these operations to resolve data layout issues and improve lakehouse responsiveness.

Why does my Fabric capacity experience throttling and how can I optimize it?

Fabric capacity throttling typically stems from workload spikes exceeding SKU limits. This skill diagnoses throttling by analyzing capacity utilization across regions and provides remediation guidance to optimize resources, adjust SKU sizing, and prevent Spark throttling.

How do I test cross-region latency for OneLake and resolve Direct Lake fallback scenarios?

Testing OneLake cross-region latency and resolving Direct Lake fallback scenarios utilizes included diagnostic routines. These workflows measure regional access delays and provide targeted remediation steps to restore query performance and fallback behavior.

Do I need PowerShell and Az.Accounts to run OneLake diagnostics?

Yes, PowerShell and the Az.Accounts module are required to run OneLake diagnostics. The skill validates these prerequisites and leverages them alongside T-SQL and Spark SQL to execute deterministic performance checks and remediation workflows.

When should I enable V-Order in Microsoft Fabric and how do I tune it?

Enable V-Order in Microsoft Fabric to optimize Delta table file layouts for faster read performance. This skill provides specific tuning guidance for V-Order alongside OPTIMIZE and VACUUM workflows to safely remediate performance bottlenecks.