Sdílet prostřednictvím


Datasets - Update Parameters

Aktualizace hodnoty parametrů pro zadanou datovou sadu z části Pracovní prostor.

Poznámka

S tímto voláním rozhraní API doporučujeme používat rozšířená metadata datové sady .

Důležité

  • Pokud používáte rozšířená metadata datové sady, aktualizujte datovou sadu, aby se použily nové hodnoty parametrů.
  • Pokud nepoužíváte rozšířená metadata datové sady, počkejte 30 minut, než se dokončí operace aktualizace zdrojů dat, a pak datovou sadu aktualizujte.

Oprávnění

Uživatel musí být vlastníkem datové sady.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

  • Datové sady vytvořené nebo upravené pomocí veřejného koncového bodu XMLA se nepodporují. Aby správce tyto datové sady změnil, musí použít klientskou knihovnu Azure Analysis Services pro tabulkový objektový model.
  • Připojení DirectQuery se podporují jenom s rozšířenými metadaty datové sady.
  • Datové sady s Azure Analysis Services živými připojeními se nepodporují.
  • Maximálně 100 parametrů na požadavek.
  • V datové sadě musí existovat všechny zadané parametry.
  • Hodnoty parametrů by měly být očekávaného typu.
  • Seznam parametrů nemůže být prázdný ani obsahovat duplicitní parametry.
  • V názvech parametrů se rozlišují malá a velká písmena.
  • Parametr IsRequired musí mít neprázdnou hodnotu.
  • Typy parametrů Any se Binary nedají aktualizovat.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
path True

string

ID datové sady

Text požadavku

Name Vyžadováno Typ Description
updateDetails True

UpdateMashupParameterDetails[]

Seznam parametrů datové sady, které se mají aktualizovat

Odpovědi

Name Typ Description
200 OK

OK

Příklady

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Definice

Name Description
UpdateMashupParameterDetails

Podrobnosti o aktualizaci parametru datové sady Power BI

UpdateMashupParametersRequest

Žádost o aktualizaci parametru datové sady Power BI

UpdateMashupParameterDetails

Podrobnosti o aktualizaci parametru datové sady Power BI

Name Typ Description
name

string

Název parametru

newValue

string

Nová hodnota parametru

UpdateMashupParametersRequest

Žádost o aktualizaci parametru datové sady Power BI

Name Typ Description
updateDetails

UpdateMashupParameterDetails[]

Seznam parametrů datové sady, které se mají aktualizovat