К основному содержанию
скилл CX Codex

fabric-onelake-2025 скилл для Claude Code: ADF и Microsoft Fabric

Скилл fabric-onelake-2025 для Claude по связке Azure Data Factory с Microsoft Fabric: коннекторы Lakehouse и Warehouse, шорткаты OneLake, вызов пайплайнов в обе стороны.

MIT 161 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill fabric-onelake-2025 -a claude-code
Открыть на GitHub

Что делает fabric-onelake-2025

Скилл разбирает связку Azure Data Factory с Microsoft Fabric: коннекторы Lakehouse и Warehouse, шорткаты OneLake и запуск пайплайнов в обе стороны. Внутри справочник по типам linked service (Lakehouse, Warehouse), списки поддерживаемых активностей и JSON-примеры в references/lakehouse-examples.md, references/warehouse-examples.md и references/onelake-patterns.md.

Аутентификация идёт через управляемую идентичность ADF (её скилл и советует ставить первой) либо сервисный принципал. Для Lakehouse нужны workspaceId и artifactId, запись — через LakehouseTableSink и LakehouseFileSink с режимами append или overwrite. У Warehouse свои endpoint и warehouse, поведения insert и upsert, а tableOption: "autoCreate" создаёт таблицу, если её нет.

Права в Fabric расходятся не мгновенно: после выдачи роли Contributor идентичности ADF подожди около 5 минут, иначе первый запуск упадёт с отказом доступа. Для Warehouse пользователя заводят отдельно, через CREATE USER ... FROM EXTERNAL PROVIDER и роли db_datareader и db_datawriter.

Какие задачи решает

  • подключить Fabric Lakehouse к ADF и копировать таблицы или файлы
  • выдать управляемой идентичности ADF роль Contributor в workspace Fabric
  • заменить копирование из ADLS Gen2 на шорткат OneLake без переноса данных
  • вызвать пайплайн Fabric из ADF и передать параметры между платформами
  • настроить upsert и autoCreate при записи в Fabric Warehouse

Примеры запросов агенту

  • Настрой linked service типа Lakehouse в ADF для workspace ws-fabric-prod, artifact ID возьми из настроек Lakehouse.
  • Переведи копирование из ADLS Gen2 в Lakehouse на шорткат OneLake, чтобы данные не дублировались.
  • Добавь Invoke Pipeline в ADF, который запускает пайплайн Fabric и передаёт дату запуска параметром.

Как установить fabric-onelake-2025

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill fabric-onelake-2025 -a claude-code

2Вручную: положить файлы

~/.claude/skills/fabric-onelake-2025/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/fabric-onelake-2025/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о fabric-onelake-2025

Как установить fabric-onelake-2025 в Claude Code?

Выполни npx skills add JosiahSiegel/claude-plugin-marketplace --skill fabric-onelake-2025 -a claude-code. Файл скилла появится по пути ~/.claude/skills/fabric-onelake-2025/SKILL.md.

Что делает fabric-onelake-2025?

Описывает подключение ADF к Fabric Lakehouse и Warehouse, паттерны шорткатов OneLake, вызов пайплайнов между платформами и выдачу прав. По каждому случаю даёт готовые JSON-примеры.

Что нужно, чтобы ADF писал в Fabric Warehouse?

Создать SQL-пользователя для идентичности ADF через CREATE USER ... FROM EXTERNAL PROVIDER и добавить его в db_datareader и db_datawriter. В workspace у идентичности должна быть роль Contributor.

Исходный текст

SKILL.md · MIT
---
name: fabric-onelake-2025
description: |
  ADF + Microsoft Fabric / OneLake 2025 integration.
  PROACTIVELY activate for: (1) Fabric Lakehouse connector in ADF, (2) Fabric Warehouse connector in ADF, (3) OneLake shortcuts and cross-workspace data, (4) Invoke Pipeline activity for cross-platform orchestration (ADF -> Fabric, Fabric -> ADF), (5) copying data between ADF and Microsoft Fabric workspaces, (6) authenticating with Fabric workspace identity, (7) cross-platform parameter passing, (8) hybrid ADF + Fabric pipeline patterns.
  Provides: Fabric connector setup, Invoke Pipeline templates, OneLake shortcut patterns, and ADF-to-Fabric migration guidance.
---

# Microsoft Fabric Integration with Azure Data Factory (2025)

## Overview

Microsoft Fabric is a unified SaaS analytics platform combining Power BI, Azure Synapse Analytics, and Azure Data Factory capabilities. ADF provides native connectors for Fabric Lakehouse and Fabric Warehouse, enabling seamless data movement between ADF and Fabric workspaces.

## Microsoft Fabric Lakehouse Connector

The Fabric Lakehouse connector enables read and write operations to Microsoft Fabric Lakehouse for tables and files.

### Supported Activities

| Activity | Supported |
|----------|-----------|
| Copy Activity (source and sink) | Yes |
| Lookup Activity | Yes |
| Get Metadata Activity | Yes |
| Delete Activity | Yes |

### Quick Reference

- **Linked service type:** `Lakehouse`
- **Authentication:** Managed Identity (preferred) or Service Principal
- **Required IDs:** `workspaceId` and `artifactId`
- **Sink types:** `LakehouseTableSink` (tables), `LakehouseFileSink` (files)
- **Source type:** `LakehouseTableSource`
- **Table action options:** `append` or `overwrite`

**Finding Workspace and Artifact IDs:**
1. Navigate to Fabric workspace in browser
2. Copy workspace ID from URL: `https://app.powerbi.com/groups/<workspaceId>/...`
3. Open Lakehouse settings to find artifact ID
4. Or use Fabric REST API to enumerate workspace items

For complete linked service, dataset, and copy activity JSON examples, see `references/lakehouse-examples.md`.

## Microsoft Fabric Warehouse Connector

The Fabric Warehouse connector provides T-SQL based data warehousing capabilities within the Fabric ecosystem.

### Supported Activities

| Activity | Supported |
|----------|-----------|
| Copy Activity (source and sink) | Yes |
| Lookup Activity | Yes |
| Get Metadata Activity | Yes |
| Script Activity | Yes |
| Stored Procedure Activity | Yes |

### Quick Reference

- **Linked service type:** `Warehouse`
- **Authentication:** System-Assigned Managed Identity (recommended), User-Assigned MI, or Service Principal
- **Required properties:** `endpoint`, `warehouse`
- **Sink type:** `WarehouseSink`
- **Write behaviors:** `insert` or `upsert`
- **Table option:** `autoCreate` (creates table if missing)

For complete linked service, copy activity, stored procedure, and script activity JSON examples, see `references/warehouse-examples.md`.

## OneLake Integration Patterns

ADF supports three integration patterns with OneLake:

| Pattern | Description | Key Benefit |
|---------|-------------|-------------|
| ADLS Gen2 Shortcuts | Reference ADLS data via OneLake shortcuts (zero-copy) | No data duplication |
| Incremental Load | Watermark-based incremental copy to Lakehouse | Efficient updates |
| Cross-Platform Invoke | Use InvokePipeline activity to call Fabric pipelines | Hybrid orchestration |

**OneLake Shortcuts** are the preferred approach when data already exists in ADLS Gen2 -- they provide instant zero-copy access without data movement. Use ADF Copy Activity only when data transformation or format conversion is needed.

For complete pipeline JSON examples for all three patterns, see `references/onelake-patterns.md`.

## Permission Configuration

### Azure Data Factory Managed Identity Permissions in Fabric

**For Fabric Lakehouse:**
1. Open Fabric workspace
2. Go to Workspace settings -> Manage access
3. Add ADF managed identity with **Contributor** role
4. Or assign **Workspace Admin** for full access

**For Fabric Warehouse:**
1. Navigate to Warehouse SQL endpoint
2. Execute SQL to create user:
```sql
CREATE USER [your-adf-name] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [your-adf-name];
ALTER ROLE db_datawriter ADD MEMBER [your-adf-name];
```

### Service Principal Permissions

**App Registration Setup:**
1. Register app in Microsoft Entra ID
2. Create client secret (store in Key Vault)
3. Add app to Fabric workspace with Contributor role
4. For Warehouse, create SQL user as shown above

## Best Practices (2025)

1. **Use Managed Identity** -- System-assigned for single ADF, user-assigned for multiple. Avoid service principal keys when possible. Store any secrets in Key Vault.

2. **Enable Staging for Large Loads** -- Use staging with compression for data volumes > 1 GB, complex transformations, or Fabric Warehouse loads.

3. **Leverage OneLake Shortcuts** -- Use `ADLS Gen2 -> OneLake Shortcut -> Direct Access` instead of `ADLS Gen2 -> Copy Activity -> Lakehouse`. No data movement, instant availability, reduced costs.

4. **Monitor Fabric Capacity Units (CU)** -- Track CU consumption per pipeline run, peak usage, and throttling. Optimize with incremental loads, off-peak scheduling, and right-sized parallelism.

5. **Use Table Option AutoCreate** -- Set `tableOption: "autoCreate"` on WarehouseSink for automatic schema management and faster development.

6. **Implement Error Handling** -- Configure retry policies on Copy activities and add WebActivity-based failure logging with `dependencyConditions: ["Failed"]`.

## Common Issues and Solutions

| Issue | Error Message | Solution |
|-------|--------------|----------|
| Permission Denied | "User does not have permission to access Fabric workspace" | Add ADF managed identity as Contributor; for Warehouse, create SQL user; allow 5 min propagation |
| Endpoint Not Found | "Unable to connect to endpoint" | Verify workspaceId/artifactId; check workspace URL; ensure Lakehouse/Warehouse is not paused |
| Schema Mismatch | "Column types do not match" | Use `tableOption: "autoCreate"` or explicit column mappings in translator |
| Performance Degradation | Slow copy performance | Enable staging, increase parallelCopies (4-8), increase DIUs (8-32), check CU throttling |

## Resources

- [Fabric Lakehouse Connector](https://learn.microsoft.com/azure/data-factory/connector-microsoft-fabric-lakehouse)
- [Fabric Warehouse Connector](https://learn.microsoft.com/azure/data-factory/connector-microsoft-fabric-warehouse)
- [OneLake Documentation](https://learn.microsoft.com/fabric/onelake/)
- [Fabric Capacity Management](https://learn.microsoft.com/fabric/enterprise/licenses)
- [ADF to Fabric Integration Guide](https://learn.microsoft.com/fabric/data-factory/how-to-ingest-data-into-fabric-from-azure-data-factory)

## Progressive Disclosure References

- **Lakehouse Examples**: `references/lakehouse-examples.md` - Complete linked service, dataset, copy activity, and lookup JSON examples
- **Warehouse Examples**: `references/warehouse-examples.md` - Complete linked service, copy activity, stored procedure, and script activity JSON examples
- **OneLake Patterns**: `references/onelake-patterns.md` - Pipeline patterns for shortcuts, incremental loads, and cross-platform Invoke Pipeline

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Данные и базы» →
using-duckdb Kurt Buhler Скилл using-duckdb позволяет читать таблицы Delta и сырые файлы в Microsoft Fabric OneLake через DuckDB локально или внутри ноутбука. CX Codex +1 ★ 1 104звёзд репо fabric-dw sdebruyn MCP-сервер fabric-dw и CLI для Microsoft Fabric Data Warehouses и SQL Analytics Endpoints: запросы, планы, права и статистика прямо из агента. CX Codex +1 ★ 10звёзд репо azure-mgmt-fabric-py Microsoft Скилл azure-mgmt-fabric-py для Claude Code и GitHub Copilot добавляет в проект Azure Fabric Management SDK для Python. Агент пишет код для создания, обновления, приостановки и удаления ёмкостей Microsoft Fabric. CX Codex +1 ★ 3 232звёзд репо azure-mgmt-fabric-dotnet Microsoft Скилл azure-mgmt-fabric-dotnet помогает писать .NET-код для управления ёмкостями Microsoft Fabric через Azure Resource Manager. Он пригодится для создания ресурсов, смены SKU и приостановки ёмкости. CX Codex +1 ★ 3 232звёзд репо microsoft-fabric-unified-analytics reason-machines Скилл microsoft-fabric-unified-analytics проводит через сборку аналитики в Microsoft Fabric: слои OneLake, очистка в Dataflow Gen2, PySpark-ноутбуки и отчёт Power BI. CX Codex +1 282установок fabric-lakehouse официальный tedvilutis Даёт контекст по Fabric Lakehouse: хранению данных, схемам, правам, Shortcuts и оптимизации таблиц. Помогает проектировать решения. CX Codex +1 8 800установок

Из того же набора96

Весь набор →
docker-git-bash-guide Скилл docker-git-bash-guide помогает настроить Docker в Windows Git Bash и устранить ошибки монтирования томов из-за автоматической конвертации путей MSYS. CX Codex +1 163установок string-manipulation-mastery Скилл string-manipulation-mastery для Claude Code помогает обрабатывать строки в Bash. Активируется для подстановок, регулярных выражений, разбора массивов и работы с пробелами. CX Codex +1 163установок git-2-49-features Скилл git-2-49-features подсказывает агенту, что появилось в Git 2.49: git backfill, path-walk API, сжатие через zlib-ng. Пригодится при переходе на новую версию. CX Codex +1 161установок process-substitution-fifos Скилл process-substitution-fifos для Claude Code помогает собирать Bash-пайплайны с process substitution, FIFO и coprocess. Передаёт данные между процессами без временных файлов. CX Codex +1 161установок aks-automatic-2025 Скилл aks-automatic-2025 для работы с Azure Kubernetes Service в режиме Automatic. Подключает знания о Karpenter, автоскейлинге, workload identity и настройках кластеров 2025 года. CX Codex +1 161установок ado-windows-git-bash-compatibility Скилл ado-windows-git-bash-compatibility для Claude и других агентов: разбирает падения пайплайнов Azure DevOps на Windows-агентах и в Git Bash — конвертацию путей, выбор shell-задачи, переводы строк. CX Codex +1 159установок azure-emulators-2025 Скилл azure-emulators-2025 для Claude Code настраивает локальные эмуляторы Azure в Docker: Azurite, Cosmos DB и SQL Server 2025. Позволяет отлаживать и тестировать без подключения к облаку. CX Codex +1 159установок advanced-features-2025 Скилл advanced-features-2025 для Claude Code настраивает хуки, MCP-серверы и распространение плагинов на уровне репозитория. Описывает сборку плагинов Claude Code для команды. CX Codex +1 159установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой