tw lineage
Explore data lineage records. Lineage must be enabled for the workspace.
tw lineage resolve
Resolve a pipeline run or a file path to its lineage record identifier (LID)
tw lineage resolve [OPTIONS]
Options
| Option | Description | Required | Default |
|---|---|---|---|
-w, --workspace | Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable) | Yes | |
--file-path | Absolute path of a file produced by a pipeline run | Yes | |
--session-id | Nextflow session ID of the run | Yes | |
--run-name | Nextflow run name | Yes |
tw lineage view
View a lineage record
tw lineage view [OPTIONS]
Options
| Option | Description | Required | Default |
|---|---|---|---|
-w, --workspace | Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable) | Yes | |
-i, --id | Lineage record identifier (LID), e.g. lid://<hash>/<path> | Yes | |
--summary | Show only the record summary (name, path or run, and labels), read from the lineage index instead of the full record. | No |
tw lineage search
Search lineage records across all the workspaces you can access
tw lineage search [OPTIONS]
Options
| Option | Description | Required | Default |
|---|---|---|---|
-q, --query | Search query. Combines free text and the qualifiers: type, workflow, task, pipeline, pipelineId, label, and workspace (org/name) or workspaceId to narrow the scope. Whitespace means AND, a comma inside a qualifier means OR. Example: -q 'type:FileOutput workspace:acme/dev multiqc'. | No | |
--max | Maximum number of records per page (capped by the server) | No | |
--page-token | Token of the page to show, as printed by a previous search with the same query | No |
tw lineage upstream
List the records one hop upstream of a task or file record. By default, the task that produced a file, or the input files of a task.
tw lineage upstream [OPTIONS]
Options
| Option | Description | Required | Default |
|---|---|---|---|
-w, --workspace | Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable) | Yes | |
-i, --id | Lineage record identifier (LID), e.g. lid://<hash>/<path> | Yes | |
-t, --type | Show only records of this type (FileOutput, TaskRun) | No |
tw lineage downstream
List the records one hop downstream of a task or file record. By default, the tasks that consumed a file, or the output files of a task.
tw lineage downstream [OPTIONS]
Options
| Option | Description | Required | Default |
|---|---|---|---|
-w, --workspace | Workspace numeric identifier or reference in OrganizationName/WorkspaceName format (defaults to TOWER_WORKSPACE_ID environment variable) | Yes | |
-i, --id | Lineage record identifier (LID), e.g. lid://<hash>/<path> | Yes | |
-t, --type | Show only records of this type (FileOutput, TaskRun) | No |