How to use DRS URIs in a workflow

Allie Cliffe

Learn how to use DRS URIs as inputs to workflows in two different ways.

You can use DRS URIs as inputs to workflows in two ways: 1) via the data table, or 2) via direct paths in the workflow inputs configuration. In both cases, the workflows should access and process the data without further intervention. See example screenshots of each below. 

DRS URIs in a workspace data table

DRS-URIs-Overview_Link-to-data-file-in-ga4gh_drs_uri-column_Screenshot.pngNote: The workflow configuration references the table with the format "this.object"

Closeup view


DRS URIs entered directly as workflow input


Closeup view


Configuring workflows with DRS URIs metadata (PFB or TDR prefix)

If you export your data table from a data repository or the Terra Data Repo, it includes a pfb or tdr prefix in the data table.

You must include the pfb or tdr prefix when running a workflow on data from a tableThe (required) attribute syntax is this.pfb:file-type or this.tdr:file-type.

Note: This syntax will show up in the drop-down menu when you click into the attribute field (see screenshot below).


Was this article helpful?



  • Comment author
    Kei Enomoto

    Hi Allie Cliffe,

    I am trying to run a workflow on TCGA WXS bam files. For example in CESC project, some files are stored in Google Cloud and the others are in DRS. In this case, should I export them separately to my workspace and run workflow on each dataset?

    And if so, will the column names in the DRS data table automatically be prefixed with "pfb" or "tdr" or do I have to do it manually?

    Thank you,


  • Comment author
    Allie Cliffe

    Hello, Kei Enomoto.  

    I think what you are asking is “can you run a workflow with inputs from a data table column that contains both 'gs://' file references and DRS file references?"
    If I’m understanding it correctly, then yes, it should run fine. If the column includes both DRS URIs and gs:// URIs (as the one you've circled), Terra will know to look in the right place for WDL inputs from the hyperlink in the table. You shouldn’t have to do anything as long as your authorization links are current. 
    All Terra should need to run the workflow is the correct column header - in the case you've circled above,  'WXS_bam_path'. You would only need to include the 'pfb' prefix if the prefix was part of the column header in the table. 



Please sign in to leave a comment.