Export Your Data From Pachyderm¶

After you build a pipeline, you probably want to see the results that the pipeline has produced. Every commit into an input repository results in a corresponding commit into an output repository.

To access the results of a pipeline, you can use one of the following methods:

• By running the pachctl get file command. This command returns the contents of the specified file.
  To get the list of files in a repo, you should first run the pachctl list file command. See Export Your Data with pachctl.
  

• By configuring the pipeline. A pipeline can push or expose output data to external sources. You can configure the following data exporting methods in a Pachyderm pipeline:

  • An egress property enables you to export your data to an external datastore, such as Amazon S3, Google Cloud Storage, and others.
    See Export data by using egress.
    
  • A service. A Pachyderm service exposes the results of the pipeline processing on a specific port in the form of a dashboard or similar endpoint.
    See Service.
    
  • Configure your code to connect to an external data source. Because a pipeline is a Docker container that runs your code, you can egress your data to any data source, even to those that the egress field does not support, by connecting to that source from within your code.

• By using the S3 gateway. Pachyderm Enterprise users can reuse their existing tools and libraries that work with object store to export their data with the S3 gateway.
  See Using the S3 Gateway.

Export Your Data with pachctl¶

The pachctl get file command enables you to get the contents of a file in a Pachyderm repository. You need to know the file path to specify it in the command.

To export your data with pachctl:

1. Get the list of files in the repository:

   pachctl list file <repo>@<branch>
   

   Example:

   pachctl list commit data@master
   

   System Response:

   REPO   BRANCH COMMIT                           PARENT                           STARTED           DURATION           SIZE
   data master 230103d3c6bd45b483ab6d0b7ae858d5 f82b76f463ca4799817717a49ab74fac 2 seconds ago  Less than a second 750B
   data master f82b76f463ca4799817717a49ab74fac <none>                           40 seconds ago Less than a second 375B
   

2. Get the contents of a specific file:

   pachctl get file <repo>@<branch>:<path/to/file>
   

   Example:

   pachctl get file data@master:user_data.csv
   

   System Response:

   1,cyukhtin0@stumbleupon.com,144.155.176.12
   2,csisneros1@over-blog.com,26.119.26.5
   3,jeye2@instagram.com,13.165.230.106
   4,rnollet3@hexun.com,58.52.147.83
   5,bposkitt4@irs.gov,51.247.120.167
   6,vvenmore5@hubpages.com,161.189.245.212
   7,lcoyte6@ask.com,56.13.147.134
   8,atuke7@psu.edu,78.178.247.163
   9,nmorrell8@howstuffworks.com,28.172.10.170
   10,afynn9@google.com.au,166.14.112.65
   

   Also, you can view the parent, grandparent, and any previous revision by using the caret (^) symbol with a number that corresponds to an ancestor in sequence:

   • To view a parent of a commit:

     1. List files in the parent commit:

        pachctl list commit <repo>@<branch-or-commit>^:<path/to/file>
        

     2. Get the contents of a file:

        pachctl get file <repo>@<branch-or-commit>^:<path/to/file>
        

   • To view an <n> parent of a commit:

     1. List files in the parent commit:

        pachctl list commit <repo>@<branch-or-commit>^<n>:<path/to/file>
        

        Example:

        NAME           TYPE SIZE
        /user_data.csv file 375B
        

     2. Get the contents of a file:

        pachctl get file <repo>@<branch-or-commit>^<n>:<path/to/file>
        

        Example:

        pachctl get file datas@master^4:user_data.csv
        

     You can specify any number in the ^<n> notation. If the file exists in that commit, Pachyderm returns it. If the file does not exist in that revision, Pachyderm displays the following message:

     pachctl get file <repo>@<branch-or-commit>^<n>:<path/to/file>
     

     System Response:

     file "<path/to/file>" not found
     

Export Your Data with egress¶

The egress field in the Pachyderm pipeline specification enables you to push the results of a pipeline to an external datastore such as Amazon S3, Google Cloud Storage, or Azure Blob Storage. After the user code has finished running, but before the job is marked as successful, Pachyderm pushes the data to the specified destination.

You can specify the following egress protocols for the corresponding storage:

"egress": {
   "URL": "s3://bucket/dir"
},