Datasets - Update Datasources In Group

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Примечание

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

Важно!

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

Разрешения

Пользователь должен быть владельцем набора данных.
Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в статье Профили субъектов-служб в Power BI Embedded.

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

Dataset.ReadWrite.All

Ограничения

Наборы данных, созданные или измененные с помощью общедоступной конечной точки XMLA , не поддерживаются. Чтобы внести изменения в эти источники данных, администратор должен использовать клиентская библиотека Azure Analysis Services для табличной объектной модели.
Поддерживаются только следующие источники данных: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata и SAP HANA. Для других источников данных используйте вызов API обновления параметров в группе .
Изменение типа источника данных не поддерживается.
Источники данных, содержащие параметры в строка подключения, не поддерживаются.
Обновление источников данных, входящих в состав объединенных или соединенных таблиц, поддерживается только при использовании улучшенных метаданных набора данных.
Для расширенного запроса, который ссылается на несколько источников данных, обновляется только первый источник данных. Чтобы обойти это ограничение, определите источник данных в качестве параметра и используйте вызов API Update Parameters In Group .
Наборы данных с политикой добавочного обновления поддерживаются не полностью. Вызов этого API может не работать должным образом и в результате частичного обновления источников данных. Чтобы устранить эту проблему, попробуйте выполнить обновление набора данных перед вызовом этого API.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string
groupId	path	True	string uuid	идентификатор рабочей области;

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

Имя	Обязательно	Тип	Описание
updateDetails	True	UpdateDatasourceConnectionRequest[]	Массив запросов на обновление подключения к источнику данных

Ответы

Имя	Тип	Описание
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.UpdateDatasources

Request Body

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "My-Sql-Server",
          "database": "My-Sql-Database"
        }
      },
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceSelector": {
        "datasourceType": "OData",
        "connectionDetails": {
          "url": "http://services.odata.org/V4/Northwind/Northwind.svc"
        }
      },
      "connectionDetails": {
        "url": "http://services.odata.org/V4/Odata/Northwind.svc"
      }
    }
  ]
}

Sample Response

Status code:: 200

Определения

Имя	Описание
Datasource	Источник данных Power BI
DatasourceConnectionDetails	Сведения о подключении к источнику данных Power BI. Примеры см. в разделах Получение источников данных или Получение источников данных в группе.
UpdateDatasourceConnectionRequest	Запрос на обновление подключения к источнику данных набора данных Power BI
UpdateDatasourcesRequest	Запрос на обновление источников данных набора данных Power BI

Datasource

Источник данных Power BI

Имя	Тип	Описание
connectionDetails	DatasourceConnectionDetails	Сведения о подключении к источнику данных
connectionString	string	(Не рекомендуется) Источник данных строка подключения. Доступно только для DirectQuery.
datasourceId	string	Идентификатор привязанного источника данных, который пуст, если он не привязан к шлюзу
datasourceType	string	Тип источника данных
gatewayId	string	Идентификатор привязанного шлюза, который пуст, если он не привязан к шлюзу. При использовании кластера шлюза идентификатор шлюза относится к основному (первому) шлюзу в кластере и аналогичен идентификатору кластера шлюза.
name	string	(Не рекомендуется) Имя источника данных. Доступно только для DirectQuery.

DatasourceConnectionDetails

Сведения о подключении к источнику данных Power BI. Примеры см. в разделах Получение источников данных или Получение источников данных в группе.

Имя	Тип	Описание
account	string	Учетная запись подключения
classInfo	string	Сведения о классе подключения
database	string	База данных подключения
domain	string	Домен подключения
emailAddress	string	Адрес электронной почты для подключения
kind	string	Тип подключения
loginServer	string	Сервер входа подключения
path	string	Путь подключения
server	string	Сервер подключения
url	string	URL-адрес подключения

UpdateDatasourceConnectionRequest

Запрос на обновление подключения к источнику данных набора данных Power BI

Имя	Тип	Описание
connectionDetails	DatasourceConnectionDetails	Сведения о целевом подключении обновленного источника данных
datasourceSelector	Datasource	Сведения о подключении к источнику данных, который требуется обновить. Это обязательно, если набор данных содержит несколько источников данных.

UpdateDatasourcesRequest

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

Имя	Тип	Описание
updateDetails	UpdateDatasourceConnectionRequest[]	Массив запросов на обновление подключения к источнику данных