Bagikan melalui

Mengonfigurasi peluasan skala model semantik

  • Artikel

Anda dapat mengaktifkan peluasan skala dalam layanan Power BI, atau menggunakan REST API Himpunan Data Power BI. Sebelum mengonfigurasi model semantik, baca gambaran umum peluasan skala model semantik Power BI.

Mengaktifkan peluasan skala dalam layanan Power BI

Untuk mengaktifkan peluasan skala untuk model semantik Anda di layanan Power BI, ikuti langkah-langkah berikut:

  1. Di layanan Power BI, buka ruang kerja dengan model semantik yang ingin Anda aktifkan peluasan skalanya.

  2. Pilih opsi lainnya model semantik (...).

  3. Dari menu, pilih Pengaturan.

  4. Di halaman pengaturan, aktifkan Format penyimpanan model semantik besar jika tidak diaktifkan.

  5. Aktifkan Peluasan skala Kueri dan pilih Terapkan.

    A screenshot showing how to enable scale out in Power BI service.

Mengaktifkan peluasan skala menggunakan REST API Himpunan Data

Bagian ini menjelaskan penggunaan REST API Himpunan Data Power BI untuk mengonfigurasi peluasan skala model semantik.

Dapatkan datasetId

Untuk mendapatkan datasetId, gunakan Get-PowerBIDataset. Anda harus menentukan workspaceId dan nama model semantik.

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"

Mendapatkan konfigurasi peluasan skala saat ini

Sebelum mengonfigurasi peluasan skala model semantik, tentukan konfigurasi saat ini.

###
# 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."
}

Mengaktifkan peluasan skala model semantik

Untuk mengaktifkan peluasan skala model semantik, atur maxReadOnlyReplicas ke -1, atau nilai non-0 apa pun. Nilai -1 memungkinkan Power BI membuat replika baca-saja sebanyak yang didukung kapasitas Power BI Anda. Anda juga dapat secara eksplisit mengatur jumlah replika ke nilai yang lebih rendah dari kapasitas maksimum. Pengaturan maxReadOnlyReplicas ke -1 disarankan.

###
# 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
        }
     }

Menonaktifkan peluasan skala model semantik

Untuk menonaktifkan peluasan skala model semantik, atur maxReadOnlyReplicas ke 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
        }
     }

Konten terkait