Skip to content

Quick Start

This guide will get you up and running with fabias in minutes.

Inside Microsoft Fabric

When running inside a Fabric notebook, authentication is automatic:

import fabias

# Get current workspace (auth is automatic)
ws = fabias.workspace()
print(f"Working in: {ws.name}")

# Run a pipeline
pipeline = ws.pipeline("Daily ETL")
job = pipeline.run()
job.wait()
print(f"Status: {job.status}")

Standalone Usage

For standalone usage outside Fabric, provide credentials:

import fabias
from fabias import ServicePrincipalAuth

# Create auth
auth = ServicePrincipalAuth(
    tenant_id="your-tenant-id",
    client_id="your-client-id",
    client_secret="your-client-secret"
)

# Configure client
fabias.client(auth=auth)

# Now use the API
ws = fabias.workspace("GENESIS")
for pipeline in ws.pipelines():
    print(pipeline.name)

Common Operations

List Workspaces

for ws in fabias.workspaces():
    print(f"{ws.name}: {ws.id}")

Access Lakehouse

ws = fabias.workspace("Analytics")
lakehouse = ws.lakehouse("DataLake")
print(f"Lakehouse ID: {lakehouse.id}")

Manage Connections

# List all connections
for conn in fabias.connections():
    print(f"{conn.name}: {conn.connectivityType}")

# Get specific connection
sql_conn = fabias.connection("SQL Server Prod")

Git Sync

ws = fabias.workspace("GENESIS")
git = ws.git

# Check status
status = git.status()
print(f"Synced: {status.is_synced}")

# Pull changes
if status.has_changes:
    git.pull()

Next Steps