Capacity Migration

mikova — Fri, 21 Mar 2025 20:59:59 GMT

Download this notebook from: semantic-link-labs/notebooks/Capacity Migration.ipynb at main · microsoft/semantic-link-labs · GitHub

Install the latest .whl package

Check here to see the latest version.

%pip install semantic-link-labs

Requirements

Must have an Azure Subscription
Must register an App
- Permissions: Will need the Contributor role at the scope where the resources will be created, which is often the subscription level
Azure Key Vault
- Set up within the Azure Subscription
- Save secrets for the Tenant ID, Client ID (Application ID), Client Secret
- Permissions: Ensure the user who will be executing the notebooks has “Key Vault Secrets User”
Fabric Permissions
- User should be a tenant admin. This ensures they have the necessary authority to execute and manage the notebooks without encountering permission issues.

Result

F skus are created for each (specified) capacity
- Within the same region as the P SKU
- Equivalent SKU size as the P SKU
- Same admins as listed on the P SKU
- All workspaces are migrated to the corresponding new capacity
The names of the newly created F SKU capacities will be an alphanumeric lowercase version of the P SKU capacity name, suffixed with 'fsku'. As an example: "My capacity_3!" -> "mycapacity3fsku".

Import the library and set the initial parameters

import sempy_labs as labs
import sempy_labs.admin as admin

azure_subscription_id = '' # Enter your Azure subscription ID
resource_group = '' # Enter the name of the resource group (to be used to create the new F skus)

key_vault_uri = '', # Enter your key vault URI
key_vault_tenant_id = '', # Enter the key vault key to the secret storing your Tenant ID
key_vault_client_id = '', # Enter the key vault key to the secret storing your Client ID (Application ID)
key_vault_client_secret = '' # Enter the key vault key to the secret storing your Client Secret

Migrate a single P SKU -> F SKU

Set the 'capacities' parameter to the single P SKU.

with labs.service_principal_authentication(
    key_vault_uri=key_vault_uri, 
    key_vault_tenant_id=key_vault_tenant_id,
    key_vault_client_id=key_vault_client_id,
    key_vault_client_secret=key_vault_client_secret):

    labs.migrate_capacities(
        azure_subscription_id = azure_subscription_id,
        resource_group = resource_group,
        capacities = 'CapacityA',
        p_sku_only = True,
    )

Migrate a list of P SKUs to F SKUs

Set the 'capacities' parameter to a list of P SKUs.

with labs.service_principal_authentication(
    key_vault_uri=key_vault_uri, 
    key_vault_tenant_id=key_vault_tenant_id,
    key_vault_client_id=key_vault_client_id,
    key_vault_client_secret=key_vault_client_secret):

    labs.migrate_capacities(
        azure_subscription_id = azure_subscription_id,
        resource_group = resource_group,
        capacities = ['CapacityA', 'CapacityB', 'CapacityC'],
        p_sku_only = True,
    )

Migrate all P SKUs to F SKUs

Set the 'capacities' parameter to None.

with labs.service_principal_authentication(
    key_vault_uri=key_vault_uri, 
    key_vault_tenant_id=key_vault_tenant_id,
    key_vault_client_id=key_vault_client_id,
    key_vault_client_secret=key_vault_client_secret):

    labs.migrate_capacities(
        azure_subscription_id = azure_subscription_id,
        resource_group = resource_group,
        capacities = None,
        p_sku_only = True,
    )

Migrate a list of P SKUs to F SKUs; associate each capacity with a specific resource group

This process ensures that each F SKU is created within the resource group specified in the resource_group_mapping dictionary.

resource_group_mapping = {
    "CapacityA": "ResourceGroupA",
    "CapacityB": "ResourceGroupA",
    "CapacityC": "ResourceGroupB",
}

with labs.service_principal_authentication(
    key_vault_uri=key_vault_uri, 
    key_vault_tenant_id=key_vault_tenant_id,
    key_vault_client_id=key_vault_client_id,
    key_vault_client_secret=key_vault_client_secret):

    labs.migrate_capacities(
        azure_subscription_id = azure_subscription_id,
        resource_group = resource_group_mapping,
        capacities = ['CapacityA', 'CapacityB', 'CapacityC'],
        p_sku_only = True,
    )

Migrate a single source capacity to a target capacity (target capacity already created)

source_capacity = '' # Enter the Source capacity name
target_capacity = '' # Enter the Target capacity name (already exists) 

admin.assign_workspaces_to_capacity(
    source_capacity=source_capacity,
    target_capacity=target_capacity,
    workspace=None,
)

Migrate a list of source capacities to target capacities (target capacity already created)

capacity_mapping = {
    "capacitya": "capacityanew", # Format is "Source SKU": "Target SKU"
    "capacityb": "capacitybnew",
    "capacityc": "capacitycnew",
}

capacities = list(capacity_mapping.keys())

for capacity in capacities:
    admin.assign_workspaces_to_capacity(
        source_capacity=capacity,
        target_capacity=capacity_mapping.get(capacity),
        workspace=None,
    )

Migrate a Fabric Trial Capacity (FT1) to a Fabric Capacity (F SKU)

with labs.service_principal_authentication(
    key_vault_uri=key_vault_uri, 
    key_vault_tenant_id=key_vault_tenant_id,
    key_vault_client_id=key_vault_client_id,
    key_vault_client_secret=key_vault_client_secret):

    labs.migrate_fabric_trial_capacity(
        azure_subscription_id = azure_subscription_id,
        resource_group = resource_group,
        source_capacity = '', # The name of the Trial capacity.
        target_capacity = '', # The name of Fabric capacity (if it does not exist it will be created).
        target_capacity_sku = "F64", # Defaults to F64 but can specify the required SKU.
        target_capacity_admin_members = None, # Setting this to None will use the same admin members as the Trial capacity.
    )

https%3A%2F%2Fgithub.com%2Fmicrosoft%2Fsemantic-link-labs%2Fblob%2Fmain%2Fnotebooks%2FCapacity%2520Migration.ipynb

topic Capacity Migration in Notebook Gallery