Datasets - Update Datasources In Group

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Novedades los orígenes de datos del conjunto de datos especificado del área de trabajo especificada.

Nota

Se recomienda usar metadatos de conjunto de datos mejorados con esta llamada API.

Importante

El origen de datos original y el nuevo origen de datos deben tener exactamente el mismo esquema.
Si usa metadatos mejorados del conjunto de datos, actualice el conjunto de datos para obtener datos de los nuevos orígenes de datos.
Si no usa metadatos de conjunto de datos mejorados, espere 30 minutos hasta que finalice la operación de actualización de orígenes de datos y, a continuación, actualice el conjunto de datos.

Permisos

El usuario debe ser el propietario del conjunto de datos.
Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

No se admiten los conjuntos de datos creados o modificados mediante el punto de conexión XMLA público. Para realizar cambios en esos orígenes de datos, el administrador debe usar la biblioteca cliente de Azure Analysis Services para el modelo de objetos tabulares.
Solo se admiten estos orígenes de datos: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata y SAP HANA. Para otros orígenes de datos, use la llamada a update parameters in Group API (Actualizar parámetros en la API de grupo ).
No se admite el cambio del tipo de origen de datos.
No se admiten orígenes de datos que contengan parámetros en el cadena de conexión.
La actualización de orígenes de datos que forman parte de tablas combinadas o combinadas solo se admite si usa metadatos mejorados del conjunto de datos.
Para una consulta avanzada que haga referencia a varios orígenes de datos, solo se actualizará el primer origen de datos. Para superar esta limitación, defina el origen de datos como parámetro y use la llamada a update parameters in Group API ( Actualizar parámetros en la API de grupo ).
Los conjuntos de datos con la directiva de actualización incremental no son totalmente compatibles, es posible que llamar a esta API no funcione según lo esperado y el resultado de la actualización parcial de orígenes de datos, para superar esto, puede intentar ejecutar una actualización del conjunto de datos antes de llamar a esta API.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string
groupId	path	True	string uuid	Identificador del área de trabajo

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
updateDetails	True	UpdateDatasourceConnectionRequest[]	Matriz de solicitudes de actualización de conexión del origen de datos

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

Ejemplos

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

Definiciones

Nombre	Description
Datasource	Un origen de datos de Power BI
DatasourceConnectionDetails	Detalles de conexión del origen de datos de Power BI. Vea ejemplos en Obtener orígenes de datos o Obtener orígenes de datos en grupo.
UpdateDatasourceConnectionRequest	Solicitud de actualización de la conexión del origen de datos del conjunto de datos de Power BI
UpdateDatasourcesRequest	Solicitud de actualización de orígenes de datos del conjunto de datos de Power BI

Datasource

Un origen de datos de Power BI

Nombre	Tipo	Description
connectionDetails	DatasourceConnectionDetails	Detalles de conexión del origen de datos
connectionString	string	(En desuso) El origen de datos cadena de conexión. Solo está disponible para DirectQuery.
datasourceId	string	Identificador de origen de datos enlazado, que está vacío cuando no está enlazado a una puerta de enlace.
datasourceType	string	Tipo de origen de datos
gatewayId	string	Identificador de puerta de enlace enlazado, que está vacío cuando no está enlazado a una puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster y es similar al identificador del clúster de puerta de enlace.
name	string	(En desuso) Nombre del origen de datos. Solo está disponible para DirectQuery.

DatasourceConnectionDetails

Detalles de conexión del origen de datos de Power BI. Vea ejemplos en Obtener orígenes de datos o Obtener orígenes de datos en grupo.

Nombre	Tipo	Description
account	string	La cuenta de conexión
classInfo	string	Información de la clase de conexión
database	string	La base de datos de conexión
domain	string	Dominio de conexión
emailAddress	string	La dirección de correo electrónico de conexión
kind	string	El tipo de conexión
loginServer	string	El servidor de inicio de sesión de conexión
path	string	Ruta de acceso de conexión
server	string	El servidor de conexión
url	string	La dirección URL de conexión

UpdateDatasourceConnectionRequest

Solicitud de actualización de la conexión del origen de datos del conjunto de datos de Power BI

Nombre	Tipo	Description
connectionDetails	DatasourceConnectionDetails	Detalles de la conexión de destino del origen de datos actualizado
datasourceSelector	Datasource	Detalles de conexión del origen de datos que necesita actualización. Esto es obligatorio cuando un conjunto de datos tiene más de un origen de datos.

UpdateDatasourcesRequest

Solicitud de actualización de orígenes de datos del conjunto de datos de Power BI

Nombre	Tipo	Description
updateDetails	UpdateDatasourceConnectionRequest[]	Matriz de solicitudes de actualización de conexión del origen de datos