Skip to main content

Quick Start Guide

Get your first Microsoft Fabric environment up and running with EasyFabric in less than 10 minutes.

Prerequisites​

Before you begin, ensure you have:

  • Azure DevOps Project: Where your repository and pipelines will live.
  • Microsoft Fabric Capacity: A workspace where the objects will be deployed.
  • Visual Studio / VS Code: For editing configuration files.
  • EasyFabric License: A trial or professional license key.

Step 1: Initialize your Repository​

Clone the EasyFabric boilerplate repository to your local machine. This repository contains the directory structure required for the automation.

git clone https://github.com/EasyFabric/boilerplate.git
cd boilerplate

Step 2: Configure your Connection​

Update the Files/Connections/SourceSystem.yaml with your source details. This tells EasyFabric where to fetch the data from.

name: MySource
type: SqlServer
server: your-server.database.windows.net
database: your-db
authentication: ServicePrincipal

Step 3: Define your first Table​

Add a new YAML file in Files/Objects/MySource/Orders.yaml:

name: Orders
source_table: sales.orders
layers:
  - Bronze
  - Silver
columns:
  - name: OrderDate
    type: Date
  - name: TotalAmount
    type: Decimal(18,2)

Step 4: Deploy​

Commit and push your changes.

git add .
git commit -m "Add my first table"
git push

Navigate to your Azure DevOps Pipelines and run the Deploy-Fabric-Environment pipeline.

Step 5: Verify in Fabric​

Once the pipeline completes:

  1. Open your Microsoft Fabric Workspace.
  2. You will see a new Lakehouse named LH_Bronze and LH_Silver.
  3. Open the Orders table to see the structure deployed automatically!

Next Steps​