Configuración de Microsoft 365 en una actividad de copia
Las canalizaciones de datos de Microsoft Fabric se integran con Microsoft Graph data connect, lo que le permite incorporar los datos de la organización enriquecidos en su inquilino de Microsoft 365 a Fabric y Azure de forma escalable y crear aplicaciones de análisis y extraer información basada en estos valiosos recursos de datos. La integración con Privileged Access Management proporciona control de acceso seguro para los datos protegidos valiosos en Microsoft 365. Consulte este vínculo para obtener información general sobre Microsoft Graph data connect.
En este artículo se describe cómo usar la actividad de copia en una canalización de datos para copiar datos de Microsoft 365. Por ahora, dentro de una sola actividad de copia, puede ingerir datos de Microsoft 365 en Microsoft Fabric Lakehouse Table, Azure Blob Storage, Azure Data Lake Storage Gen1 y Azure Data Lake Storage Gen2. El formato de datos admitido es Avro, texto delimitado, JSON, ORC y formato Parquet.
Requisitos previos
Para copiar datos de Microsoft 365, es preciso completar los siguientes pasos de requisitos previos:
- El administrador de inquilinos de Microsoft 365 debe completar las acciones de incorporación como se describe aquí.
- Cree y configure una aplicación web de Microsoft Entra en Microsoft Entra ID. Para obtener instrucciones, vaya a Creación de una aplicación de Microsoft Entra.
- Anote los siguientes valores, que se utilizan para definir la conexión para Microsoft 365: id. de inquilino. Para obtener instrucciones, vaya a Obtención del identificador de inquilino.
- Identificador de aplicación y clave de aplicación. Para obtener instrucciones, vaya a Obtención del id. y la clave de autenticación de la aplicación. Agregue la identidad del usuario que va a realizar la solicitud de acceso a los datos como propietario de la aplicación web de Microsoft Entra (desde >Configuración>Propietarios>Agregar propietario de la aplicación web de Microsoft Entra).
- La identidad del usuario debe pertenecer a la organización de Microsoft 365 de la que obtendrá los datos. Además, no debe un usuario invitado.
Aprobar nuevas solicitudes de acceso a los datos
Si es la primera vez que solicita datos para este contexto (una combinación de los datos de tabla a los que se accede, la cuenta de destino en la que se cargan los datos y la identidad de usuario que realiza la solicitud de acceso a los datos), el estado de la actividad de copia se muestra como En curso. Solo cuando seleccione el vínculo Detalles en Acciones, el estado se mostrará como RequestingConsent. Un miembro del grupo de aprobadores de acceso a datos debe aprobar la solicitud en Privileged Access Management antes de pasar a la extracción de datos.
Consulte las preguntas más frecuentes sobre cómo el aprobador puede aprobar la solicitud de acceso a datos. Consulte el artículo Integración de conexión de datos con PAM para obtener una explicación de la integración general con Privileged Access Management, incluido cómo configurar el grupo aprobador de acceso a datos.
Configuración admitida
Para la configuración de cada pestaña en la actividad de copia, vaya a las secciones siguientes respectivamente.
General
Para la configuración de la pestaña General , vaya a General.
Origen
Las siguientes propiedades son compatibles con Microsoft 365 en la pestaña Origen de una actividad de copia.
Se requieren las siguientes propiedades:
- Tipo de banco de datos : seleccione Externo.
- Conexión: seleccione una conexión de Microsoft 365 en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Microsoft 365 seleccionando Nuevo.
- Tabla: nombre de la tabla que se va a extraer de Microsoft 365. Para obtener una vista previa de los datos de ejemplo, seleccione Vista previa de los datos de ejemplo.
En Avanzado, puede especificar los campos siguientes:
Ámbito: puede seleccionar Todos los usuarios o grupos en el inquilino de Microsoft 365 o Seleccionar grupos del inquilino de Microsoft 365
Si selecciona Todos los usuarios o grupos en el inquilino de Microsoft 365, se muestra el filtro de ámbito.
- Filtro de ámbito: puede usar una expresión de predicado que se aplica en todo el inquilino para filtrar las filas específicas que extraer de Microsoft 365. El formato de predicado debe coincidir con el formato de consultas de las API de Microsoft Graph, por ejemplo,
https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.
Si selecciona Seleccionar grupos en el inquilino de Microsoft 365, puede seleccionar Agregar grupos de usuarios para seleccionar grupos del inquilino de Microsoft 365. Utilice esta propiedad para seleccionar hasta 10 grupos de usuarios para los que se recuperan los datos. Si no se especifica ningún grupo, se devuelven datos para toda la organización.
- Filtro de ámbito: puede usar una expresión de predicado que se aplica en todo el inquilino para filtrar las filas específicas que extraer de Microsoft 365. El formato de predicado debe coincidir con el formato de consultas de las API de Microsoft Graph, por ejemplo,
Filtro de fecha: especificar el nombre de la columna de filtro DateTime. Utilice esta propiedad para limitar el intervalo de tiempo para que se extraigan los datos de Microsoft 365. Si el conjunto de datos tiene una o varias columnas DateTime, debe especificar una columna aquí. Consulte Filtrado para obtener una lista de conjuntos de datos que requieren este filtro DateTime.
Especifique la Hora de inicio (UTC) y la Hora de finalización (UTC) para filtrar al seleccionar una columna de filtro DateTime.
Asignación
Para la configuración de la pestañaAsignación, vaya a Configurar las asignaciones en la ficha Asignación .
Configuración
Para la configuración de la pestaña Parámetros, vaya a Configurar los otros parámetros en parámetros de pestaña.
Resumen de tabla
Las tablas siguientes contienen más información sobre la actividad de copia en Microsoft 365.
Información de origen
| Nombre | Descripción | Value | Obligatorio | Propiedad de script JSON |
|---|---|---|---|---|
| Tipo de almacén de datos | El tipo de almacén de datos. | Externo | Sí | / |
| Connection | La conexión al almacén de datos de origen. | <su conexión> | Sí | conexión |
| Tabla | Nombre de la tabla que se va a extraer de Microsoft 365. | <table> | Sí | table |
| Ámbito | Cuando el grupo de usuarios no se especifica, puede usar una expresión de predicado que se aplica en todo el inquilino para filtrar las filas específicas que extraer de Microsoft 365. El formato de predicado debe coincidir con el formato de consultas de las API de Microsoft Graph, por ejemplo, https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<el ámbito> | Sí | scope |
| Filtro de ámbito | Cuando la propiedad allowedGroups no se especifica, puede usar una expresión de predicado que se aplica en todo el inquilino para filtrar las filas específicas que extraer de Microsoft 365. El formato de predicado debe coincidir con el formato de consultas de las API de Microsoft Graph, por ejemplo, https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<filtro de ámbito> | No | userScopeFilterUri |
| Identificador de grupo | Predicado de la selección de grupo. Utilice esta propiedad para seleccionar hasta 10 grupos de usuarios para los que se recuperan los datos. Si no se especifica ningún grupo, se devuelven datos para toda la organización. | <id. de grupo> | No | allowedGroups |
| Filtro de fecha (Nombre de la columna) |
Nombre de la columna de filtro DateTime. Utilice esta propiedad para limitar el intervalo de tiempo para que se extraigan los datos de Microsoft 365. | <la columna de filtro DateTime> | Sí, si los datos tienen una o varias columnas DateTime. | dateFilterColumn |
| Hora de inicio (UTC) | Valor DateTime de inicio para el filtro. | <hora de inicio> | Sí, si se especifica dateFilterColumn |
startTime |
| Hora de finalización (UTC) | Valor DateTime de fin para el filtro. | <hora de finalización> | Sí, si se especifica dateFilterColumn |
endTime |