Conexión de linaje de datos
Utiliza Alteryx One para transferir metadatos de linaje de Server a un catálogo de datos externo. Cada espacio de trabajo admite una conexión individual entre un Server y un catálogo.
Atención
Para habilitar la funcionalidad de linaje de datos, se debe asignar el rol de administrador a la entidad de servicio utilizada para la comunicación entre Server y Alteryx One. Actualmente no se admiten roles personalizados basados en el rol de administrador con capacidades reducidas.
Como resultado, la entidad de servicio requiere temporalmente permisos más amplios de los previstos. Esta limitación afecta solo a Alteryx One y no afecta a Server ni a ningún código que se ejecute en él. Somos conscientes de este problema y planeamos resolverlo en una actualización futura.
Antes de comenzar
Asegúrate de que las direcciones IP Alteryx One estén en la lista blanca. Estas direcciones IP se pueden encontrar en la página de documentación de Introducción a Alteryx One Platform.
Proporcionamos información de linaje de datos para ejecuciones de Alteryx Server en el formato OpenLineage, un estándar abierto para capturar metadatos de pipeline. Esto permite una integración perfecta con los principales consumidores de eventos de OpenLineage, incluidos Collibra y Atlan, lo que apoya la gobernanza, el descubrimiento y la colaboración. Ten en cuenta que Collibra y Atlan no están configurados ni administrados por Alteryx.
Para obtener más información sobre las herramientas compatibles y los tipos de conexión, ve a Herramientas compatibles para el linaje a nivel de columna.
Seguridad de linaje de datos
No se almacena información de linaje en Server ni en la nube. Los datos solo fluyen en tránsito, y esto se cifra mediante el cifrado TLS.
Runtime Behavior and Proxy Configuration
How Data Lineage Executes at Runtime
Data Lineage network calls are executed under the operating system account used by AlteryxService, not under the workflow Run As user.
This means:
Proxy configuration and authentication must be valid for the AlteryxService account.
Run As credentials do not affect Data Lineage connectivity.
As a result, it is possible for Test Connection to succeed (which runs in the interactive user context) while lineage events fail at runtime. This typically occurs when proxy settings are configured for the signed-in user but not for the AlteryxService account.
Proxy and Service Account Requirements
If your environment requires a proxy—especially one that requires authentication—AlteryxService should run under a dedicated user or service account that:
Has proxy access properly configured.
Can authenticate to the proxy.
Has appropriate network permissions (for example, outbound HTTPS/port 443 access).
When AlteryxService runs as SYSTEM, authenticated proxy scenarios might be unsupported or unreliable at the operating system level. This can cause runtime lineage failures even if Test Connection reports success.
Importante
Run As credentials do not control or affect Data Lineage connectivity. All lineage-related network communication is performed by the AlteryxService account.
Datos enviados desde Alteryx Server al Lineage Cloud Service
Cuando se ejecuta un flujo de trabajo en Alteryx Server, recopilamos información de linaje de datos a nivel de flujo de trabajo.
Cuando se ejecuta un flujo de trabajo, se producen los siguientes eventos:
INICIO: comienza la ejecución del flujo de trabajo.
EJECUCIÓN: el flujo de trabajo ingresa un estado de ejecución. Puede permanecer en este estado o en bucle hasta que avance a un resultado.
Estados de resultado: después de ejecutarse, el flujo de trabajo puede pasar a uno de los varios resultados posibles:
COMPLETO: el flujo de trabajo finaliza correctamente.
ANULADO: el flujo de trabajo se detiene intencionalmente antes de finalizar.
ERROR: el flujo de trabajo encuentra un error y falla.
Para cada evento, recopilamos los metadatos relevantes necesarios para que el Lineage Cloud Service pueda crear los eventos de OpenLineage.
Evento INICIAR enviado al inicio de la ejecución
{
"eventTime": "2024-11-22T00:00:00Z",
"eventType": "START",
"job": {
"name": "TestWorkflow"
},
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
}
}
Evento EJECUCIÓN enviado al establecer conjuntos de datos de entrada/salida
{
"eventTime": "2024-11-22T00:01:00Z",
"eventType": "RUNNING",
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
},
"job": {
"name": "TestWorkflow"
},
"inputs": [
{
"name": "input_a.csv",
"namespace": "file"
}
]
}Evento COMPLETO enviado cuando la ejecución es correcta
{
"eventTime": "2024-11-22T00:04:00Z",
"eventType": "COMPLETE",
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
},
"job": {
"name": "TestWorkflow"
}
}Evento ERROR enviado cuando la ejecución falla
{
"eventTime": "2024-10-21T14:30:00Z",
"eventType": "FAIL",
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
},
"job": {
"name": "TestWorkflow"
}
}
Metadatos adicionales
Una vez activados estos eventos, AlteryxService consolida todos los eventos relevantes y proporciona los metadatos adicionales para el envío final al Lineage Cloud Service, como:
job.name: una cadena concatenada que contiene el nombre del flujo de trabajo y el ID de la aplicación del servicio.
Ejemplo:
GenerateSalesDetail|01JTKMDMZZPXDD8NY51XKR5A5FPropietario: el ID de usuario del propietario del flujo de trabajo.
Estudio: el ID de suscripción asociado al estudio del flujo de trabajo (solo para ejecuciones manuales).
URL de Server: una URL de Server que te envía a la página de detalles del flujo de trabajo en la interfaz de usuario de Server.
El
serviceIdcorresponde al campoappInfos.serviceId, que se asigna al campoAS_Applications.id(oAS__application_iden el registroAS_Queue).ServerJob.id: el identificador de tarea único.
Datos enviados desde Lineage Cloud Services al consumidor de linaje
Una vez que el Lineage Cloud Service ha recibido los metadatos de Alteryx Server, envía los eventos de OpenLineage con formato relevantes para el consumidor de linaje.
Ejemplo de JSON de Open Lineage START
{
"eventType": "START",
"eventTime": "2024-12-20T13:39:37.554Z",
"run": {
"runId": "acde070d-8c4c-4f0d-9d8a-162843c10333"
},
"job": {
"namespace": "Alteryx-demo",
"name": "Lineage Connection Workflow|5ea20186a171a51bc4c37155",
},
"producer": "us1.alteryxcloud.com/lineageservice:0.0.1 ",
"schemaUrl": "https://tools.ietf.org/html/rfc6901"
}Ejemplo de JSON de Open Lineage COMPLETE
{
"eventType": "COMPLETE",
"eventTime": "2024-12-20T14:00:37.554Z",
"run": {
"runId": "acde070d-8c4c-4f0d-9d8a-162843c10333"
},
"job": {
"namespace": "Alteryx-demo",
"name": "Lineage Connection Workflow|5ea20186a171a51bc4c37155"
},
"inputs": [{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.AYX_COLORADO_STORES_SUMMARIZE"
},
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.yxdb"
}],
"outputs": [
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.yxdb"
},
{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.LAINE_TABLE"
}],
"producer": "us1.alteryxcloud.com/lineageservice:0.0.1 ",
"schemaUrl": "https://tools.ietf.org/html/rfc6901"
}Ejemplo de JSON de Open Lineage FAIL
{
"eventType": "FAIL",
"eventTime": "2024-12-20T14:00:37.554Z",
"run": {
"runId": "acde070d-8c4c-4f0d-9d8a-162843c10333"
},
"job": {
"namespace": "Alteryx-demo",
"name": "Lineage Connection Workflow|5ea20186a171a51bc4c37155"
},
"inputs": [{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.AYX_COLORADO_STORES_SUMMARIZE"
},
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.yxdb"
}],
"outputs": [
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.yxdb"
},
{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.LAINE_TABLE"
}],
"producer": "us1.alteryxcloud.com/lineageservice:0.0.1 ",
"schemaUrl": "https://tools.ietf.org/html/rfc6901"
}Ejemplo de JSON de Open Lineage ABORT
{
"eventType": "ABORT",
"eventTime": "2024-12-20T14:00:37.554Z",
"run": {
"runId": "acde070d-8c4c-4f0d-9d8a-162843c10333"
},
"job": {
"namespace": "Alteryx-demo",
"name": "Lineage Connection Workflow|5ea20186a171a51bc4c37155"
},
"inputs": [{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.AYX_COLORADO_STORES_SUMMARIZE"
},
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.csv"
}],
"outputs": [
{
"namespace": "file",
"name": "E:/ProgramData/Alteryx/Service/Staging/State Population Output.csv"
},
{
"namespace": "snowflake://tjb31106",
"name": "AYX_LINEAGE_DB.ELLENS_DATA.LAINE_TABLE"
}],
"producer": "us1.alteryxcloud.com/lineageservice:0.0.1 ",
"schemaUrl": "https://tools.ietf.org/html/rfc6901"
}Ejemplo de JSON de Open Lineage COMPLETE
{
"eventType": "COMPLETE",
"eventTime": "2025-10-06T17:46:27.695Z",
"run": {
"runId": "173fc3f9-1501-4749-beae-32b56796596e",
"facets": {
"nominalTime": null,
"parent": null
}
},
"job": {
"namespace": "AlteryxTest",
"name": "ProductSales|68c48138430ae827850e8498",
"facets": {
"documentation": null,
"sourceCodeLocation": {
"_producer": "https://ayx-sandbox.bender.rocks/data-lineage-service/v1/datalineage",
"_schemaURL": "https://openlineage.io/spec/facets/1-0-1/SourceCodeLocationJobFacet.json",
"type": "Alteryx Server",
"url": "http://AYX-LT-5MGCB54/gallery/#/app/app/68c48138430ae827850e8498/?type=service"
},
"sql": null,
"jobType": null,
"ownership": {
"owners": [
{
"name": "68b9acee6065b0e905f38ea3",
"type": "USER"
},
{
"name": "68b9acee6065b0e905f38ea0",
"type": "SUBSCRIPTION"
}
],
"_producer": "https://ayx-sandbox.bender.rocks/data-lineage-service/v1/datalineage",
"_schemaURL": "https://openlineage.io/spec/facets/1-0-1/OwnershipJobFacet.json"
},
"serverJob": {
"id": "68e40070b8565a17ce0ac2e7",
"_producer": "https://ayx-sandbox.bender.rocks/data-lineage-service/v1/datalineage",
"_schemaURL": "https://openlineage.io/spec/2-0-2/OpenLineage.json#/definitions/BaseFacet"
}
}
},
"inputs": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\Products.xlsx",
"facets": {
"documentation": null,
"schema": null,
"dataSource": null,
"description": null,
"lifecycleStateChange": null,
"columnLineage": null,
"symlinks": null
},
"inputFacets": {},
"outputFacets": null
},
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\OrderDetails.xlsx",
"facets": {
"documentation": null,
"schema": null,
"dataSource": null,
"description": null,
"lifecycleStateChange": null,
"columnLineage": null,
"symlinks": null
},
"inputFacets": {},
"outputFacets": null
}
],
"outputs": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\TotalSales.csv",
"facets": {
"documentation": null,
"schema": null,
"dataSource": null,
"description": null,
"lifecycleStateChange": null,
"columnLineage": {
"_producer": "https://ayx-sandbox.bender.rocks/data-lineage-service/v1/datalineage",
"_schemaURL": "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json",
"fields": {
"OrderID": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\OrderDetails.xlsx",
"field": "OrderID",
"transformations": [
{
"subtype": "IDENTITY",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"Category": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\Products.xlsx",
"field": "Category",
"transformations": [
{
"subtype": "IDENTITY",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"NewCount": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\OrderDetails.xlsx",
"field": "Quantity",
"transformations": [
{
"subtype": "TRANSFORMATION",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"ProductID": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\Products.xlsx",
"field": "ProductID",
"transformations": [
{
"subtype": "IDENTITY",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"TotalSale": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\OrderDetails.xlsx",
"field": "Quantity",
"transformations": [
{
"subtype": "TRANSFORMATION",
"type": "DIRECT"
}
]
},
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\Products.xlsx",
"field": "UnitPrice",
"transformations": [
{
"subtype": "TRANSFORMATION",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"ProductName": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\Products.xlsx",
"field": "ProductName",
"transformations": [
{
"subtype": "IDENTITY",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
},
"OrderDetailID": {
"inputFields": [
{
"namespace": "file",
"name": "C:\\ProgramData\\Alteryx\\Service\\Staging\\45816_d3034dfd34e946a48485299407c307a0\\_externals\\1\\OrderDetails.xlsx",
"field": "OrderDetailID",
"transformations": [
{
"subtype": "IDENTITY",
"type": "DIRECT"
}
]
}
],
"transformationDescription": null,
"transformationType": null
}
}
},
"symlinks": null
},
"inputFacets": null,
"outputFacets": {}
}
],
"producer": "https://ayx-sandbox.bender.rocks/data-lineage-service/v1/datalineage",
"schemaURL": "https://openlineage.io/spec/2-0-2/OpenLineage.json#/$defs/RunEvent"
}Datos almacenados en el Lineage Cloud Service
Solo almacenamos la información de configuración que se utiliza para establecer la conexión entre Lineage Cloud Service y Lineage Consumer.
Período de retención de datos: Indefinido.
Configuración de Atlan
Punto de conexión de Open Lineage:
https://alteryx.atlan.com/v1/lineageEspacio de nombres Open Lineage:
Alteryx-AtlanMétodo de autenticación:
Token de portadorToken de portador:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMTIzNDU2IiwidXNlcm5hbWUiOiJ0ZXN0X3VzZXIiLCJleHAiOjE3MTQ5MDYwMDB9.SflKxwRJS
Configuración de Collibra
Punto de conexión:
http://localhost:8888/debug.testEspacio de nombres:
Alteryx_CollibraMétodo de autenticación:
Ninguno
Configurar conexiones de datos de linaje
Para configurar el linaje de la conexión de datos, ve a Consola de administración > Conexión de linaje de datos.
Consumidor de datos: catálogo de datos externos
Configura, edita o elimina una conexión de catálogo de datos.
Configurar conexiones de catálogos de datos
Para habilitar la transferencia de metadatos de linaje desde Server, configura un catálogo de datos, como Atlan o Collibra.
En el menú, ve a Admin Console > Data Lineage Connection.
En Data Consumer, selecciona Set Up para un catálogo de datos externo.
Se abre una página de Data Catalog Setup.
En Private Network, selecciona la casilla de verificación Data Catalog is on Private Network si tu catálogo de datos está implementado en un entorno de red privada al que no se puede acceder desde Internet pública.
En Punto de conexión de OpenLineage, ingresa la URL completa donde Alteryx debe enviar los datos de eventos de OpenLineage.
En Espacio de nombres de OpenLineage, ingresa el espacio de nombres de la tarea de OpenLineage. Consulta la documentación de tu catálogo de datos para obtener más información sobre los requisitos de espacio de nombres.
En Método de autenticación, selecciona tu método de autenticación en el menú desplegable.
Selecciona Ninguno o Token de portador.
Si seleccionas Ninguno, no se pasan credenciales de autenticación al conectarte al catálogo de datos. Utiliza esta opción solo si tu catálogo no requiere autenticación. Si el catálogo requiere autenticación, al seleccionar Ninguno, se producirán fallas de conexión.
Si seleccionas Token de portador, ingresa el token (tal como se creó en tu catálogo de datos) en el campo Token de portador.
En Nivel de linaje de datos, selecciona Conjunto de datos o Columna en el menú desplegable.
El nivel de linaje de datos define qué tan detallado quieres que sea el seguimiento del linaje.Esta configuración solo se aplica a las ejecuciones nuevas. Si el servicio de linaje está inactivo, Server utiliza la última configuración conocida o se ajusta de forma predeterminada a nivel de conjunto de datos. Una vez que se restaura el servicio, las nuevas ejecuciones siguen el nivel seleccionado.
Para obtener más información sobre los tipos de conexión, ve a Herramientas compatibles para linaje a nivel de columna, sección Tipos de conexión compatibles.
Selecciona Dataset si deseas definir el linaje solo a nivel de conjunto de datos. Alteryx no envía información de asignación.
El linaje a nivel de conjunto de datos muestra cómo conjuntos de datos completos (como tablas, archivos o vistas) se mueven y transforman entre los sistemas. Proporciona una visión general de alto nivel del flujo de datos.
Selecciona Column si deseas definir el linaje hasta columnas individuales.
El linaje a nivel de columna rastrea el recorrido de campos o atributos individuales dentro de un conjunto de datos. Explica exactamente cómo se generó, transformó o agregó cada columna. Para obtener más información, consulta Herramientas compatibles para linaje a nivel de columna.
Para probar esta conexión, selecciona Test Connection.
Nota
Si seleccionaste la casilla de verificación Data Catalog is on Private Network en el paso 4, el botón Test Connection aparecerá atenuado. Para probar tu conexión, ve a Alteryx System Settings > Controller > Connections - Alteryx One. Consulta el Controlador para obtener más información.
Selecciona Guardar.
Ahora que has configurado tu conexión de catálogo de datos. Aparecerá en la sección Data Consumer.
Editar o eliminar la conexión del catálogo de datos
Ve a la sección Data Consumer y busca la conexión de datos que deseas editar o eliminar. A continuación, selecciona View Details para ver los detalles de conexión del catálogo de datos.
Para editar una conexión de catálogo de datos, selecciona Edit.
Para eliminar una conexión de catálogo de datos, selecciona el menú de tres puntos y, a continuación, selecciona Delete.
Fuentes de datos: Server
Una vez que configures el catálogo de datos externo, puedes conectar Alteryx One a tu Server para transferir metadatos de linaje al catálogo de datos.
Configurar la conexión a Server
A fin de enviar metadatos de linaje a tu catálogo, habilita Server para que se conecte con el espacio de trabajo de Alteryx One.
En el menú, ve a Admin Console > Data Lineage Connection.
En Data Source, selecciona Set Up para Server.
Se abre una página Set Up Server.
Ingresa el nombre de Server para ayudar a identificarlo en este espacio de trabajo.
Genera el payload del enlace de Server. Para ello, ve a Create Server Link Payload y selecciona Generate Payload. Cópialo y pégalo en tu configuración del sistema de Alteryx para completar la configuración. Para obtener más información sobre dónde ingresar el payload del enlace de Server y cómo probarlo en Server, ve a Controlador.
El payload incluye el ID de cliente y el secreto de cliente asociados con la entidad de servicio.
Selecciona Listo.
Ya has configurado tu conexión de Server.
Editar o eliminar una conexión de Server
Ve a la sección Data Source y busca la conexión de datos de Server que deseas editar o eliminar. A continuación, selecciona View Details para ver los detalles de conexión de Server.
Para editar una conexión de catálogo de datos, selecciona Edit.
Para eliminar una conexión de catálogo de datos, selecciona el menú de tres puntos y, a continuación, selecciona Delete.