Поделиться через


Datasets - Update Parameters In Group

Обновления значения параметров для указанного набора данных из указанной рабочей области.

Примечание

В этом вызове API рекомендуется использовать расширенные метаданные набора данных .

Важно!

  • Если вы используете расширенные метаданные набора данных, обновите набор данных, чтобы применить новые значения параметров.
  • Если вы не используете расширенные метаданные набора данных, подождите 30 минут, пока завершится операция обновления источников данных, а затем обновите набор данных.

Разрешения

Требуемая область

Dataset.ReadWrite.All

Ограничения

  • Наборы данных, созданные или измененные с помощью общедоступной конечной точки XMLA , не поддерживаются. Чтобы внести изменения в эти наборы данных, администратор должен использовать клиентская библиотека Azure Analysis Services для табличной объектной модели.
  • Подключения DirectQuery поддерживаются только с расширенными метаданными набора данных.
  • Наборы данных с Azure Analysis Services динамическими подключениями не поддерживаются.
  • Не более 100 параметров на запрос.
  • Все указанные параметры должны существовать в наборе данных.
  • Значения параметров должны иметь ожидаемый тип.
  • Список параметров не может быть пустым или содержать повторяющиеся параметры.
  • В именах параметров учитывается регистр.
  • Параметр IsRequired должен иметь непустое значение.
  • Параметры типов Any и Binary не могут быть обновлены.

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

Параметры URI

Имя В Обязательно Тип Описание
datasetId
path True

string

groupId
path True

string

uuid

идентификатор рабочей области;

Текст запроса

Имя Обязательно Тип Описание
updateDetails True

UpdateMashupParameterDetails[]

Список параметров набора данных для обновления

Ответы

Имя Тип Описание
200 OK

ОК

Примеры

Example

Sample Request

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

Sample Response

Определения

Имя Описание
UpdateMashupParameterDetails

Сведения об обновлении параметра набора данных Power BI

UpdateMashupParametersRequest

Запрос на обновление для параметра набора данных Power BI

UpdateMashupParameterDetails

Сведения об обновлении параметра набора данных Power BI

Имя Тип Описание
name

string

Имя параметра

newValue

string

Новое значение параметра

UpdateMashupParametersRequest

Запрос на обновление для параметра набора данных Power BI

Имя Тип Описание
updateDetails

UpdateMashupParameterDetails[]

Список параметров набора данных для обновления