Connessione di derivazione dei dati
Utilizza Alteryx One per trasferire i metadati di derivazione da Server a un catalogo dati esterno. Ogni spazio di lavoro supporta una connessione "uno a uno" tra un Server e un catalogo.
Attenzione
Per abilitare la funzionalità di derivazione dei dati, l'entità di servizio utilizzata per la comunicazione tra Server e Alteryx One deve disporre del ruolo di Amministratore. I ruoli personalizzati con funzionalità ridotte basati sul ruolo di Amministratore non sono attualmente supportati.
Di conseguenza, l'entità di servizio deve avere temporaneamente autorizzazioni più ampie del previsto. Questo limite riguarda solo Alteryx One e non influisce su Server o su qualsiasi codice eseguito su di esso. Siamo a conoscenza di questo problema e prevediamo di risolverlo in un aggiornamento futuro.
Prima di iniziare
Assicurati che gli indirizzi IP di Alteryx One siano inseriti in un elenco di indirizzi consentiti. Questi indirizzi IP sono disponibili nella pagina di documentazione Inizia con Alteryx One Platform.
Le informazioni sulla derivazione dei dati per l'esecuzione su Alteryx Server vengono fornite nel formato OpenLineage, uno standard aperto per l'acquisizione dei metadati nella pipeline, che garantisce una perfetta integrazione con i principali consumer di eventi OpenLineage, tra cui Collibra e Atlan, a supporto di governance, rilevamento e collaborazione. Collibra e Atlan non vengono configurati o gestiti da Alteryx, ma sono strumenti esterni integrabili con la piattaforma Alteryx.
Per ulteriori informazioni sugli strumenti e i tipi di connessioni supportati, vai a Strumenti supportati per la derivazione dei dati a livello di colonna.
Sicurezza della derivazione dei dati
Su Server o Cloud non viene memorizzata nessuna informazione relativa alla derivazione dei dati. I dati si limitano a transitare in questi ambienti, in un formato crittografato con TLS per garantirne sicurezza.
Dati inviati da Alteryx Server al servizio Cloud di derivazione dei dati
Quando un flusso di lavoro viene eseguito su Alteryx Server, noi raccogliamo informazioni sulla derivazione dei dati a livello di flusso di lavoro.
Durante l'esecuzione di un flusso di lavoro, si verificano gli eventi che seguono:
START: inizia l'esecuzione del flusso di lavoro.
RUNNING: il flusso di lavoro passa a uno stato di esecuzione, o ciclo, in cui potrebbe rimanere fino a quando non prosegue verso il risultato.
Esiti possibili: dopo l'esecuzione, il flusso di lavoro può avere uno degli esiti seguenti:
COMPLETE: il flusso di lavoro è terminato correttamente.
ABORT: il flusso di lavoro è stato interrotto intenzionalmente prima del completamento.
FAIL: il flusso di lavoro non è riuscito a causa di un errore.
Per ogni evento, raccogliamo i metadati necessari per consentire la creazione degli eventi OpenLineage da parte del servizio Cloud di derivazione dei dati.
Evento di START inviato all'inizio dell'esecuzione
{
"eventTime": "2024-11-22T00:00:00Z",
"eventType": "START",
"job": {
"name": "TestWorkflow"
},
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
}
}
Evento RUNNING inviato alla definizione dei dataset di input/output
{
"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 COMPLETE inviato al termine dell'esecuzione
{
"eventTime": "2024-11-22T00:04:00Z",
"eventType": "COMPLETE",
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
},
"job": {
"name": "TestWorkflow"
}
}Evento FAIL inviato in caso di fallimento dell'esecuzione
{
"eventTime": "2024-10-21T14:30:00Z",
"eventType": "FAIL",
"run": {
"runId": "00000000-0000-0000-0000-000000000000"
},
"job": {
"name": "TestWorkflow"
}
}
Metadati aggiuntivi
Dopo l'attivazione di questi eventi, AlteryxService consolida tutti gli eventi rilevanti e fornisce i metadati necessari per preparare l'invio al servizio Cloud di derivazione dei dati, ad esempio:
job.name: stringa concatenata che contiene il nome del flusso di lavoro e l'ID dell'app di servizio.
Esempio:
GenerateSalesDetail|01JTKMDMZZPXDD8NY51XKR5A5FProprietario: ID utente del proprietario del flusso di lavoro.
Studio: ID dell'abbonamento associato allo studio del flusso di lavoro (solo per le esecuzioni manuali).
URL server: URL che punta alla pagina dei dettagli del flusso di lavoro nell'interfaccia utente di Server.
Il valore di
serviceIdcorrisponde a quello del campoappInfos.serviceId, che è associato al campoAS_Applications.id(o al campoAS__application_idnel recordAS_Queue).ServerJob.id: identificatore univoco del processo.
Dati inviati dai servizi Cloud di derivazione dei dati al relativo consumer
Una volta che il servizio Cloud di derivazione dei dati ha ricevuto i metadati da Alteryx Server, invia gli eventi OpenLineage formattati pertinenti al relativo consumer.
Esempio di codice JSON per l'evento OpenLineage 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"
}Esempio di codice JSON per l'evento OpenLineage 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"
}Esempio di codice JSON per l'evento OpenLineage 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"
}Esempio di codice JSON per l'evento OpenLineage 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"
}Esempio di codice JSON per l'evento OpenLineage 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"
}Dati memorizzati nel servizio Cloud di derivazione dei dati
Vengono memorizzate solo le informazioni di configurazione utilizzate per stabilire la connessione tra il servizio Cloud di derivazione dei dati e il relativo consumer.
Periodo di conservazione dei dati: indefinito.
Configurazione di Atlan
Endpoint OpenLineage:
https://alteryx.atlan.com/v1/lineageSpazio dei nomi OpenLineage:
Alteryx-AtlanMetodo di autenticazione:
Bearer tokenBearer token:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMTIzNDU2IiwidXNlcm5hbWUiOiJ0ZXN0X3VzZXIiLCJleHAiOjE3MTQ5MDYwMDB9.SflKxwRJS
Configurazione di Collibra
Endpoint:
http://localhost:8888/debug.testSpazio dei nomi:
Alteryx_CollibraMetodo di autenticazione:
None
Configurazione della connessione di derivazione dei dati
Per impostare la connessione di derivazione dei dati, accedi a Console di amministrazione > Connessione di derivazione dei dati.
Consumer di dati: catalogo dati esterno
Impostazione, modifica o eliminazione di una connessione al catalogo dati.
Configurazione della connessione al catalogo dati
Per consentire il trasferimento dei metadati di derivazione dei dati da Server, devi configurare un catalogo dati, ad esempio Atlan o Collibra.
Nel menu, vai a Console di amministrazione > Connessione di derivazione dei dati.
In Consumer dati, seleziona Imposta per un Catalogo dati esterno.
Viene visualizzata la pagina Impostazione catalogo dati.
Se il catalogo dati è implementato in un ambiente di rete privata non accessibile pubblicamente da Internet, in Rete privata seleziona la casella di spunta Il catalogo dati utilizza la rete privata.
In Endpoint OpenLineage, inserisci l'URL completo a cui Alteryx deve inviare i dati degli eventi OpenLineage.
In Spazio dei nomi OpenLineage, inserisci lo spazio dei nomi dei processi OpenLineage. Per ulteriori informazioni sui requisiti dello spazio dei nomi, consulta la documentazione del catalogo dati.
Nella sezione Metodo di autenticazione, seleziona il tuo metodo di autenticazione dal menu a discesa.
Seleziona Nessuno o Bearer token.
Se selezioni Nessuno, le credenziali di autenticazione non vengono trasmesse durante la connessione al catalogo dati. Utilizza questa opzione solo se il catalogo non richiede alcuna autenticazione. Se scegli Nessuno ma il catalogo richiede l'autenticazione, si verificano errori di connessione.
Se selezioni Bearer token, inserisci nel campo Bearer token il token creato nel tuo catalogo dati.
In Livello di derivazione dei dati seleziona Dataset o Colonna dal menu a discesa.
Il valore di Livello di derivazione dei dati indica quanto deve essere dettagliato il tracciamento eseguito dalla derivazione.Questa impostazione si applica solo ai nuovi processi. Se il servizio di derivazione non è attivo, Server utilizza l'ultima impostazione nota oppure lascia l'impostazione predefinita sul livello del dataset. Una volta ripristinato il servizio, alle esecuzioni successive viene applicato il livello selezionato.
Per ulteriori informazioni sui tipi di connessione, vai a Strumenti supportati per la derivazione dei dati a livello di colonna, sezione Tipi di connessione supportati.
Seleziona Dataset se desideri definire la derivazione dei dati solo a livello di dataset. Alteryx non invia informazioni di mappatura.
La derivazione dei dati a livello di dataset mostra come gli interi dataset (ad esempio tabelle, file o viste) vengono trasformati e spostati da un sistema all'altro, fornendo una panoramica ad alto livello del flusso di dati.
Seleziona Colonna se desideri definire la derivazione dei dati fino alle singole colonne.
La derivazione dei dati a livello di colonna traccia il percorso dei singoli campi o attributi all'interno di un dataset, spiegando esattamente come ciascuna colonna è stata generata, trasformata o aggregata. Per ulteriori informazioni, vai a Strumenti supportati per derivazione dei dati a livello di colonna.
Per testare questa connessione, seleziona Verifica connessione.
Nota
Se hai selezionato la casella di spunta Il catalogo dati utilizza la rete privata nel Passaggio 4, il pulsante Verifica connessione è disattivato. Per verificare la connessione, vai a Impostazioni di sistema Alteryx > Controller > Connessioni - Alteryx One. Per ulteriori informazioni, consulta la sezione Controller.
Seleziona Salva.
Ora che la connessione al catalogo dati è stata impostata, viene visualizzata nella sezione Consumer dati.
Modifica o eliminazione della connessione al catalogo dati
Vai alla sezione Consumer dati e individua la connessione dati che desideri modificare o eliminare, quindi seleziona Mostra dettagli per visualizzare i dettagli della connessione al catalogo dati.
Per modificare una connessione al catalogo dati, seleziona Modifica.
Per eliminare una connessione al catalogo dati, apri il menu con i 3 puntini e scegli Elimina.
Origine dati: Server
Dopo aver impostato il catalogo dati esterno, puoi connettere Alteryx One a Server per trasferire i metadati della derivazione al catalogo dati.
Configurazione della connessione a Server
Per inviare i metadati di derivazione al catalogo, devi consentire a Server di connettersi a uno spazio di lavoro Alteryx One.
Nel menu, vai a Console di amministrazione > Connessione di derivazione dei dati.
In Origine dati, seleziona Configura per Server.
Viene visualizzata la pagina Configura server.
Inserisci il nome del server per identificarlo nello spazio di lavoro.
Ora devi generare il payload del collegamento a Server A tale scopo, vai a Crea payload del collegamento a Server e seleziona Genera payload. Copia e incolla le Impostazioni di sistema Alteryx per completare la configurazione. Per ulteriori informazioni su dove immettere il payload del collegamento a Server e su come verificarlo in Server, vai a Controller.
Il payload include l'ID client e il Segreto client associati all'entità di servizio.
Seleziona Fatto.
La configurazione della connessione a Server è terminata.
Modifica o eliminazione di una connessione a Server
Vai alla sezione Origine dati e individua la connessione dati Server che desideri modificare o eliminare, quindi seleziona Mostra dettagli per visualizzare i dettagli della connessione a Server.
Per modificare una connessione al catalogo dati, seleziona Modifica.
Per eliminare una connessione al catalogo dati, apri il menu con i 3 puntini e scegli Elimina.