Compartir a través de


Ejecución del examen de metadatos

En el siguiente tutorial breve se muestra cómo usar las API de escáner para recuperar metadatos de los elementos de Fabric de la organización. Se supone que un administrador de Fabric ha configurado el examen de metadatos en su organización.

Para obtener una lista de los metadatos de artefacto y subartefacto que devuelve el examen de metadatos, consulte la documentación de la API Admin - WorkspaceInfo GetScanResult.

Estas son las API de escáner. Admiten nubes públicas y soberanas.

Importante

La aplicación que desarrolle para el examen se puede autenticar mediante un token de acceso de administrador delegado estándar o una entidad de servicio. Las dos rutas de autenticación se excluyen mutuamente. Cuando se ejecuta en una entidad de servicio, no debe haber permisos necesarios para el consentimiento del administrador de Power BI establecidos en la aplicación. Para más información, vea Habilitación de la autenticación de entidad de servicio para las API de administración de solo lectura.

Paso 1: Realización de un examen completo

Llame a workspaces/modified sin el parámetro modifiedSince para obtener la lista completa de identificadores de área de trabajo del inquilino. Este examen recupera todas las áreas de trabajo del inquilino, incluidas las personales y las compartidas. Si desea excluir áreas de trabajo personales del examen, use el parámetro workspaces/modified excludePersonalWorkspaces.

Divida la lista en fragmentos de 100 áreas de trabajo como máximo.

Para cada fragmento de 100 áreas de trabajo:

Llame a workspaces/getInfo para desencadenar una llamada de examen para estas 100 áreas de trabajo. En la respuesta, recibe el valor scanId que se usará en los pasos siguientes. En el encabezado de ubicación, también recibirá el identificador uniforme de recursos (URI) para llamar al paso siguiente.

Nota

No se pueden realizar más de 16 llamadas simultáneamente. El autor de la llamada debe esperar una respuesta de examen correcta o con errores de la API scanStatus antes de invocar otra llamada.

Si no se devuelven algunos metadatos que esperaba recibir, consulte con el administrador de Fabric para asegurarse de que ha habilitado todos los modificadores de administrador pertinentes.

Use el URI del encabezado de ubicación que ha recibido al llamar a workspaces/getInfo y sondee workspaces/scanStatus/{scan_id} hasta que el estado devuelto sea "Correcto". Este estado significa que el resultado del examen está listo. Se recomienda usar un intervalo de sondeo de 30-60 segundos. En el encabezado de ubicación, también recibirá el URI para llamar al paso siguiente. Úselo solo cuando el estado sea "Correcto".

Use el URI del encabezado de ubicación que ha recibido al llamar a workspaces/scanStatus/{scan-id} y lea los datos mediante workspaces/scanResult/{scan_id}. Los datos contienen la lista de áreas de trabajo, la información de artefactos y otros metadatos en función de los parámetros pasados en la llamada a workspaces/getInfo.

Paso 2: Realización de un examen incremental

Ahora que tiene todas las áreas de trabajo, los metadatos y el linaje de sus recursos, se recomienda realizar solo exámenes incrementales que hagan referencia al examen anterior.

Llame a workspaces/modified con el parámetro modifiedSince establecido en la hora de inicio del último examen para obtener las áreas de trabajo que han cambiado y que, por lo tanto, requieren otro examen. El parámetro modifiedSince se debe establecer para una fecha dentro de los últimos 30 días.

Divida esta lista en fragmentos de hasta 100 áreas de trabajo y obtenga los datos de estas áreas de trabajo modificadas mediante las tres llamadas API, workspaces/getInfo, workspaces/scanStatus/{scan_id} y workspaces/scanResult/{scan_id}, como se ha descrito en el paso 1.

Consideraciones y limitaciones

  • Los modelos semánticos que no se han actualizado o vuelto a publicar se devolverán en las respuestas de API, pero sin su información y expresiones subartifact. Por ejemplo, en la respuesta verá el nombre del modelo semántico y el linaje, pero no los nombres de tabla y columna del modelo semántico.
  • Los modelos semánticos que solo contienen tablas DirectQuery devolverán metadatos subartifact solo si se ha realizado algún tipo de acción en el modelo semántico, como alguien que crea un informe sobre él, alguien que ve un informe basado en él, etc.
  • Los modelos semánticos en tiempo real, los que tienen seguridad de nivel de objeto, los que tienen una conexión dinámica a AS-Azure y AS local, y los modelos semánticos de fidelidad completa de Excel no se admiten para metadatos de subartefacto. En el caso de los conjuntos de datos no admitidos, la respuesta devuelve el motivo por el que no se obtienen los metadatos de subartefacto del conjunto de datos. Se encuentra en un campo denominado schemaRetrievalError, por ejemplo, schemaRetrievalError: solicitud no admitida. Los conjunto de datos de RealTime no están admitidos.
  • La API no devuelve metadatos de subartefacto para modelos semánticos mayores de 1 GB en áreas de trabajo compartidas. En las áreas de trabajo Premium, no hay ninguna limitación de tamaño en los modelos semánticos.

Licencias

El examen de metadatos no requiere ninguna licencia especial. Funciona para todos los metadatos de su inquilino, incluidos los de los artículos ubicados en áreas de trabajo no Premium.