Configurar a distribuição do modelo semântico

Pode ativar o scale-out no serviço Power BI, ou usar as APIs REST do Power BI Datasets. Antes de configurar o modelo semântico, leia a visão geral da expansão do modelo semântico do Power BI.

Ativar escalonamento horizontal no serviço Power BI

Para permitir a escalonabilidade do seu modelo semântico no Power BI Service, siga estes passos:

  1. No Power BI Service, abre o espaço de trabalho com o modelo semântico para o qual queres ativar o scale-out.

  2. Selecione as mais opções do modelo semântico (...).

  3. No menu, selecione Definições.

  4. Na página das definições, ativa o formato de armazenamento de modelos semânticos grandes se não estiver ativado.

  5. Ativar Query scale-out e selecionar Aplicar.

    Uma captura de ecrã que mostra como ativar a escalabilidade no serviço Power BI.

Permitir ampliação horizontal usando as APIs REST dos Datasets

Esta secção descreve a utilização das APIs REST dos Power BI Datasets para configurar a escalabilidade semântica dos modelos.

Obter ID do conjunto de dados

Para obter o datasetId, use Get-PowerBIDataset. Deve especificar um workspaceId e um nome semântico do modelo.

Login-PowerBI | Out-Null

$workspaceId = '<enter workspaceId>'

$datasetId = Get-PowerBIDataset -WorkspaceId $workspaceId `
    | Where{$_.Name -match "<enter semantic model name>"} `
    | Select-Object -ExpandProperty Id -First 1 `
    | ForEach-Object {$_.Guid}

Write-Host
Write-Host "Workspace Id: $workspaceId"
Write-Host "Dataset Id: $datasetId"

Obtenha a configuração atual de scale-out

Antes de configurar a expansão da capacidade do modelo semântico, determine a configuração atual.

###
# Get current scale-out configuration
###
Login-PowerBI | Out-Null

$workspaceId = '<enter workspaceId>'

$datasetId = Get-PowerBIDataset -WorkspaceId $workspaceId `
    | Where{$_.Name -match "<enter semantic model name>"} `
    | Select-Object -ExpandProperty Id -First 1 `
    | ForEach-Object {$_.Guid}

$response = Invoke-PowerBIRestMethod -Url "groups/$workspaceId/datasets/$datasetId" -Method Get | ConvertFrom-Json

$response.queryScaleOutSettings | Format-List

if ($response.queryScaleOutSettings.maxReadOnlyReplicas -eq -1 `
    -or $response.queryScaleOutSettings.maxReadOnlyReplicas -gt 0)
{
    Write-Host "Semantic model scale-out is enabled."
}
else
{
    Write-Host "Semantic model scale-out is disabled."
}

Permitir escalonamento semântico de modelos

Para permitir o escalonamento semântico do modelo, defina maxReadOnlyReplicas para -1, ou qualquer valor que não seja 0. Um valor de -1 permite ao Power BI criar tantas réplicas de apenas leitura quanto a capacidade do Power BI suportar. Também pode definir explicitamente o número de réplicas para um valor inferior ao máximo de capacidade. Recomenda-se definir maxReadOnlyReplicas para -1.

###
# Enable scale-out
###
Login-PowerBI | Out-Null

$workspaceId = '<enter workspaceId>'

$datasetId = Get-PowerBIDataset -WorkspaceId $workspaceId `
    | Where{$_.Name -match "<enter semantic model name>"} `
    | Select-Object -ExpandProperty Id -First 1 `
    | ForEach-Object {$_.Guid}

Invoke-PowerBIRestMethod -Url "groups/$workspaceId/datasets/$datasetId" `
    -Method Patch -Body '{ "queryScaleOutSettings": { "maxReadOnlyReplicas": -1 }}'

Invoke-PowerBIRestMethod -Url "groups/$workspaceId/datasets/$datasetId" -Method Get `
    | ConvertFrom-Json | Select-Object -ExpandProperty queryScaleOutSettings `
    | ForEach { 
        if($_.maxReadOnlyReplicas -eq -1)
        { 
            Write-Host "Success! Semantic model scale-out has been enabled."
        } else
        {
            Write-Host "Something went wrong! Semantic model scale-out is still disabled." -ForegroundColor Red
        }
     }

Desativar a expansão da capacidade do modelo semântico

Para desativar o escalonamento semântico do modelo, defina maxReadOnlyReplicas para 0.

###
# Disable scale-out
###
Login-PowerBI | Out-Null

$workspaceId = '<enter workspaceId>'

$datasetId = Get-PowerBIDataset -WorkspaceId $workspaceId `
    | Where{$_.Name -match "<enter semantic model name>"} `
    | Select-Object -ExpandProperty Id -First 1 `
    | ForEach-Object {$_.Guid}

Invoke-PowerBIRestMethod -Url "groups/$workspaceId/datasets/$datasetId" `
    -Method Patch -Body '{ "queryScaleOutSettings": { "maxReadOnlyReplicas": 0 }}'

Invoke-PowerBIRestMethod -Url "groups/$workspaceId/datasets/$datasetId" -Method Get `
    | ConvertFrom-Json | Select-Object -ExpandProperty queryScaleOutSettings `
    | ForEach { 
        if($_.maxReadOnlyReplicas -eq 0)
        { 
            Write-Host "Success! Semantic model scale-out has been disabled."
        } else
        {
            Write-Host "Something went wrong! Semantic model scale-out is still enabled." -ForegroundColor Red
        }
     }

Conteúdo relacionado

  • Last updated on