Compartir a través de


Datasets - Update Datasources In Group

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

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