Skip to main content

Blue icon with a stream-like object flowing out of a database. Data Stream Out Tool

User Role Requirements

User Role*

Tool/Feature Access

Full User

✓

Basic User

X

*Applies to Alteryx One Professional and Enterprise Edition customers on Designer versions 2025.1+.

Use Data Stream Out to stream data from an In-DB workflow out to Alteryx Designer.

In-Database enables blending and analysis against large sets of data without moving the data out of a database and can provide significant performance improvements over traditional analysis methods. For more about the In-Database tool category, refer to In-Database Overview.

Configure the Tool

Use the Configuration window to customize the Data Stream Out tool.

  • Advanced Query Options: Use this section to define Pre- and Post-SQL statements to execute. Pre- and post-SQL statements are compatible with the Bulk Loaders, OCI, ODBC, and OLE DB technologies.

    To configure your SQL statements...

    1. Use the 3-dot menu associated with either the Pre or Post Statement fields to launch the Configure Pre/Post SQL Statements window, which includes the SQL Editor and Stored Procedures tabs.

    2. Next, define SQL statements as needed:

      • Pre-SQL Statement: Define a SQL statement to execute before the in-database execution.

      • Post-SQL Statement: Define a SQL statement to execute after the in-database execution.

    3. To configure Pre-SQL and Post-SQL statements...

      • Use the SQL Editor tab to define a SQL statement to execute before/after the In-DB execution. When the workflow runs, the Results window displays messages to show that the tool is executing SQL statements, along with a label (PreSQL/PostSQL).

        • All SQL statements are sent directly to the database. Pre-SQL statements do not return data. While SQL can return data, Designer doesn't do anything with it.

        • If there are multiple streams of In-DB tools, there is no guaranteed order of execution between different streams. The Results window displays the order.

      • Use the Stored Procedures tab to select and configure a stored procedure call for your database. You can select a Parameter and set a Value for your stored procedures if needed. All stored procedures are sent directly to the database.

        • If a stored procedure is executed successfully, it returns any necessary status messages or warnings in the Results window.

        • If a stored procedure returns data, Designer does not return it anywhere. The data is not displayed in the Results window.

        Important

        Stored procedures are supported for these connections:

        • SQL Server for ODBC and Bulk Writer

        • Oracle for ODBC Only

    4. Select OK when you're finished or Cancel to return to the tool configuration window.

  • Sort records before streaming out: This is an optional setting. When checked, the incoming data is sorted by the field specification below.

    • Name: Select the field to sort on.

    • Order: Choose either Ascending or Descending.

    • Use the up and down arrows to change the order, and the "-" button to delete a field.

Connect a standard tool to the output of the Data Stream Out tool.

In this section: