> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexión de Azure Data Factory (ADF) a Insights

> Cree una canalización de Azure Data Factory sobre la versión heredada de PlayFab Insights para orquestar el movimiento de datos y transformar los datos de eventos del juego a gran escala para sistemas posteriores.

# Tutorial: Conexión de Azure Data Factory (ADF) a Insights

Esta guía le ayuda a empezar a usar Azure Data Factory (ADF) junto con Insights. Después de conectarse, puede usar Azure Data Factory para crear flujos de trabajo que orquesten el movimiento de datos y transformen los datos del juego a gran escala. Para obtener más información sobre otras herramientas que puede conectar a Insights, consulte [Conexión de herramientas externas a Insights](/services/playfab/data-analytics/legacy/connectivity).

En este tutorial, aprenderá a:

<Note>
  \[!div class="checklist"] \* Crear una factoría de datos en Azure \* Crear una canalización
</Note>

<Note>
  PlayFab Insights Management se retiró el 31/03/2026. Le recomendamos usar las [conexiones de Azure Data Explorer (ADX)](/services/playfab/data-analytics/export-data/data-connection-adx) para administrar su rendimiento y costos de ahora en adelante. Si su título todavía usa **Insights**, siga consultando este artículo para conocer los detalles de implementación. Para obtener más información, consulte [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## Requisitos previos

### Cuenta de PlayFab autenticada con AAD

Necesita una cuenta o un usuario de PlayFab cuyo proveedor de autenticación esté establecido en Microsoft. El proveedor de autenticación de Microsoft usa Azure Active Directory (AAD) para la autenticación, lo cual es obligatorio para usar los servicios de Azure. Consulte [Autenticación de Azure Active Directory para Game Manager](/services/playfab/identity/dev-identity/authentication/aad-authentication) para obtener instrucciones sobre cómo crear una cuenta o un usuario autenticado con AAD.

Para comprobar que la cuenta, o el usuario, está configurado para usar el proveedor de autenticación de Microsoft:

* Vaya a [developer.playfab.com](https://developer.playfab.com).
* Seleccione **Sign in with Microsoft** para acceder a su cuenta de PlayFab.

Si puede iniciar sesión, la cuenta está configurada para usar el proveedor de autenticación de Microsoft.

### Permisos de Game Manager para Insights

Debe asignar a su cuenta un [rol de usuario](/services/playfab/identity/dev-identity/permissions/playfab-user-roles) con los siguientes permisos de Game Manager habilitados:

* Estado de administrador.
* Acceso a la pestaña Explorer y a los datos asociados.
* Acceso de lectura y escritura a los datos de Analytics.

Puede crear un rol de usuario nuevo o agregar estos permisos a un rol existente.

### Otros requisitos previos

* [Crear una aplicación de Azure Active Directory (AAD) y conectarla a la base de datos de su título](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Crear una factoría de datos nueva

Para crear una factoría de datos nueva:

1. Inicie sesión en el [Azure portal](https://portal.azure.com). Desde la página principal, en **Azure Services**, seleccione **Create a resource**. Busque **Data Factory**, selecciónelo y, a continuación, seleccione **Create**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-create-resource.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=16c50c669d45848a0d9b631456d9265b" alt="Crear recurso en ADF" width="1179" height="692" data-path="images/playfab/data-analytics/legacy/connectivity/adf-create-resource.png" />
2. Rellene los campos obligatorios:
   * En **Name**, elija un nombre para su factoría de datos. El nombre debe ser *único globalmente*.
   * En **Subscription**, seleccione la suscripción de Azure en la que quiere crear la factoría de datos.
   * En **Resource Group**, use uno de los siguientes pasos:
     * Seleccione **Use existing** y seleccione un grupo de recursos existente de la lista.
     * Seleccione **Create new** y escriba el nombre de un grupo de recursos.
   * No es necesario habilitar GIT ahora mismo, así que desmarque la casilla siguiente. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-new-data-factory.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=85a775cc184fc46853364491af635308" alt="Nueva Data Factory en ADF" width="1184" height="692" data-path="images/playfab/data-analytics/legacy/connectivity/adf-new-data-factory.png" />
3. Seleccione **Create**. Una vez completada la implementación, en **Next steps**, seleccione **Go to resource**.
4. Para abrir la interfaz de usuario de Data Factory en una pestaña independiente, seleccione **Author & Monitor**.

## Crear una canalización

Ahora vamos a crear una canalización nueva para obtener datos de Insights. Para crear una canalización:

1. En la página **Let's get started**, seleccione **Create pipeline**.
2. En el panel **Activities**, bajo **Azure Data Explorer**, arrastre y suelte un **Azure Data Explorer Command** en el área de trabajo en blanco. En el panel inferior, en **General**, rellene el nombre y la descripción. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-explorer-command.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=84f37a750818fe0401711b4e5ed073ea" alt="Comando de Explorer en ADF" width="998" height="944" data-path="images/playfab/data-analytics/legacy/connectivity/adf-explorer-command.png" />
3. Seleccione la pestaña **Connection** y seleccione **New**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-explorer-command-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=bd25602c12c24f97f4f41f18b7753d9e" alt="Conexión del comando de Explorer en ADF" width="937" height="224" data-path="images/playfab/data-analytics/legacy/connectivity/adf-explorer-command-connection.png" />
4. En la ventana **New linked service (Azure Data Explorer (Kusto))**, rellene los campos:
   * En **Name**, use el identificador del título.
   * En **Account selection method**, seleccione **Enter manually**.
   * Para el **Endpoint**, use el punto de conexión de la API de PlayFab, que es `https://insights.playfab.com`.
   * En **Service Principal ID**, escriba el identificador de cliente de su aplicación de Azure.
   * En **Service Principal Key**, escriba el secreto de cliente de su aplicación de Azure.
   * En el cuadro **Database**, escriba el identificador del título completamente en mayúsculas. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-new-linked-service.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=c878805db8ac895e2230d4104e038532" alt="Nuevo servicio vinculado en ADF" width="942" height="1273" data-path="images/playfab/data-analytics/legacy/connectivity/adf-new-linked-service.png" /> Seleccione **Create**. La canalización ya está lista. Puede volver a la vista principal de la canalización haciendo clic en el nombre de la canalización.
5. Para comprobar que toda la información es correcta, seleccione **Test connection**. Si todo está configurado correctamente, devuelve una respuesta de conexión correcta. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-test-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=94738d63b129eefff8855a93807e3dea" alt="Probar conexión en ADF" width="1315" height="241" data-path="images/playfab/data-analytics/legacy/connectivity/adf-test-connection.png" />
6. Para validar y depurar la canalización, en la barra de herramientas situada encima del área de trabajo, seleccione **Validate** y, a continuación, seleccione **Debug**.

## Recursos adicionales

* [Documentación de Azure Data Factory (ADF)](https://learn.microsoft.com/en-us/azure/data-factory/)
* Para obtener información sobre otras herramientas para conectarse a Insights, consulte [Conexión de herramientas externas a Insights](/services/playfab/data-analytics/legacy/connectivity)
