Datasets - Update Datasources

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Примечание

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

Важно!

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

Разрешения

Пользователь должен быть владельцем набора данных.

Ограничения

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

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

Dataset.ReadWrite.All

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

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

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

Ответы

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

Примеры

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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[]	Массив запросов на обновление подключения к источнику данных