Download this notebook from: semantic-link-labs/notebooks/Capacity Migration.ipynb at main · microsoft/semantic-link-labs · GitHu...
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
