1. Stream Analytics Documentation
  2. Manage
  3. Pipelines
  4. Manage Pipelines
  5. Exporting and Importing a Pipeline and Its Dependent Artifacts

4.5.2.4 Exporting and Importing a Pipeline and Its Dependent Artifacts

The export and import features let you migrate your pipeline and its contents between Oracle Stream Analytics systems (such as development and production). You also have the option to migrate only select artifacts. You can import a pipeline developed with the latest version of Oracle Stream Analytics. On re-import, the existing metadata is overwritten with the newly imported metadata if the pipeline is not published. You can delete the imported artifacts by right-clicking them and selecting Delete.

To export a pipeline:

  1. On the Catalog page, hover the mouse over, or select the pipeline that you want to export to another GGSA instance.
  2. Click the Export option that appears to your right side on the screen.
  3. The selected pipeline and its dependent artifacts are exported as a JSON zip file, to your computer's default Downloads folder.

To import a pipeline:

  1. Go to the GGSA instance to which you want to import the exported metadata.
  2. On the Catalog page, click Import.
  3. In the Import dialog box, click Select, to locate and select the exported zip file on your computer.
  4. On the Import Resources tab, you can select an existing connection from the catalog, or use the imported connection.Select an existing connection from Catalog
  5. Click Import.

The imported pipeline and its dependent artifacts are available on the Catalog page.

Note:

  • Each pipeline should have a unique name. If you are importing an updated version of a pipeline, you can retain the same name. If you are importing a new pipeline and if a pipeline with the same name already exists in the catalog, change the name of the pipeline that you are importing.
  • If you have already exported a pipeline with the same name, update the pipeline name as below:
    1. Create a directory exportUpdate.
    2. Copy the exported zip, say exportNameUpdateExample.zip, to the folder exportUpdate.
    3. Unzip the file exportNameUpdateExample.zip.
    4. Open the json file in edit mode.
    5. Search for pipeline/ artifact name in the json file. For example, if Nano pipeline was the name given to the pipeline, update it to Nano pipeline updated.
    6. Update the json file in exportNameUpdateExample.zip.
    7. Import this zip.
    8. The pipeline is automatically assigned a name, using the display name.
    9. The draft pipeline and publish pipeline topic are created as below:
      1. sx_Nanopipelineupdated_Nano_Stream_draft
      2. sx_Nanopipelineupdated_Nano_Stream_public