Datasets - Update Datasources In Group

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

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

Примечание.

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

Это важно

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

Разрешения

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

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

Dataset.ReadWrite.All

Ограничения

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

Образец запроса

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

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

{
  "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"
      }
    }
  ]
}

Пример ответа

Код состояния:: 200

Определения

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

Datasource

Object

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

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

DatasourceConnectionDetails

Object

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

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

UpdateDatasourceConnectionRequest

Object

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

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

UpdateDatasourcesRequest

Object

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

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

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

Datasets - Update Datasources In Group

Разрешения

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

Ограничения

Параметры URI

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

Ответы

Примеры

Example

Образец запроса

Пример ответа

Определения

Datasource

DatasourceConnectionDetails

UpdateDatasourceConnectionRequest

UpdateDatasourcesRequest

Дополнительные ресурсы