Módosíthatja az adatforrások kapcsolati sztringjeit a Power BI-jelentésekben a PowerShell – Power BI jelentéskészítő kiszolgáló API-jaival

Lehetővé tesszük Power BI directQuery- és frissítési jelentések kapcsolatainak frissítését.

Fontos

Ez egyúttal kompatibilitástörő változás ahhoz képest, ahogy ezt a korábbi kiadásokban lehetett beállítani. Ha a Power BI jelentéskészítő kiszolgáló 2020. októberinél korábbi verzióját használja, lásd: Az adatforrások kapcsolati sztringjeinek módosítása a PowerShellel – 2020. októberinél korábbi Power BI jelentéskészítő kiszolgáló

Előfeltételek

  • Töltse le a Power BI jelentéskészítő kiszolgáló Power BI jelentéskészítő kiszolgáló és Power BI Desktop legújabb kiadását.
  • A jelentéskészítő kiszolgálóra optimalizált Power BI Desktop 2020. októberi vagy újabb kiadásával mentett jelentés, amelyen engedélyezve van a bővített adathalmaz-metaadatok használata.
  • Egy paraméterezett kapcsolatokat használó jelentés. A közzététel után csak a paraméterezett kapcsolatokkal és adatbázisokkal rendelkező jelentések frissíthetők.
  • Ez a példa a Reporting Services PowerShell-eszközeit használja. Ugyanezt az új REST API-k használatával érheti el.

Jelentés létrehozása paraméterezett kapcsolatokkal

  1. Hozzon létre egy SQL Server-kapcsolatot egy kiszolgálóhoz. Az alábbi példában a localhosthoz kapcsolódunk egy ReportServer nevű adatbázishoz, és az adatokat az ExecutionLog naplóból kérjük le.

    Connect to the SQL Server database

    Az M-lekérdezés ekkor a következőképpen néz ki:

    let
        Source = Sql.Database("localhost", "ReportServer"),
        dbo_ExecutionLog3 = Source{[Schema="dbo",Item="ExecutionLog3"]}[Data]
    in
        dbo_ExecutionLog3
    
  2. Válassza a Paraméterek kezelése lehetőséget a Power Query-szerkesztő menüszalagon.

    Select Manage Parameters

  3. Hozzon létre paramétereket a kiszolgálónévhez és az adatbázisnévhez.

    Manage Parameters, set servername and databasename.

  4. Szerkessze az első kapcsolat lekérdezését, és rendelje hozzá az adatbázist és a kiszolgálónevet.

    Map the Server and Database name

    A lekérdezés most a következőképpen néz ki:

    let
        Source = Sql.Database(ServerName, Databasename),
        dbo_ExecutionLog3 = Source{[Schema="dbo",Item="ExecutionLog3"]}[Data]
    in
        dbo_ExecutionLog3
    
    1. Tegye közzé ezt a jelentést a kiszolgálón. Ebben a példában a jelentés neve executionlogparameter. Az alábbi kép egy példa egy adatforrás-kezelési oldalra.

    The data source management page.

A paraméterek frissítése a PowerShell-eszközökkel

  1. Nyissa meg a PowerShellt, és telepítse a legújabb Reporting Services-eszközöket az itt található utasítások alapján: https://github.com/microsoft/ReportingServicesTools.

  2. A jelentés paraméterének lekéréséhez használja az új REST DataModelParameters API-t a következő PowerShell-hívással:

    Get-RsRestItemDataModelParameters '/executionlogparameter'
    
        Name         Value
        ----         -----
        ServerName   localhost
        Databasename ReportServer
    
  3. A hívás eredményét egy változóba mentjük:

    $parameters = Get-RsRestItemDataModelParameters '/executionlogparameter'
    
  4. Képezz le egy szótárra a paraméterértékek eléréséhez.

    $parameterdictionary = @{}
    foreach ($parameter in $parameters) { $parameterdictionary.Add($parameter.Name, $parameter); }
    
    
  5. Ezt a változót a módosítandó értékekkel frissítjük.

  6. Frissítse a kívánt paraméterek értékeit:

    $parameterdictionary[“ServerName”].Value = 'myproductionserver'
    $parameterdictionary[“Databasename”].Value = 'myproductiondatabase'
    
  7. A frissített értékek használatával a Set-RsRestItemDataModelParameters parancsmaggal frissíthetjük a kiszolgáló értékeit:

    Set-RsRestItemDataModelParameters -RsItem '/executionlogparameter' -DataModelParameters $parameters
    $parameterdictionary.Values
    
  8. A paraméterek frissítése után a kiszolgáló frissíti a paraméterekhez kötött összes adatforrást. Az Adatforrás szerkesztése párbeszédpanelre visszatérve elvileg beállíthatja a frissített kiszolgáló és adatbázis hitelesítő adatait.

    Set credentials for the updated server and database.

További lépések

Oldalakra osztott jelentések adatforrásai a Power BI jelentéskészítő kiszolgálón

További kérdései vannak? Kérdezze meg a Power BI közösségét