Skip to main content

Denodo

Connection Type

ODBC (64-bit)

Driver Details

Bulk write support is available for standard and in-database workflows. In-Database processing requires 64-bit database drivers. You can download the driver from Denodo Drivers.

Type of Support

Read & Write (Materialized tables only), In-Database

Validated On

  • Database Version: Denodo Platform 8, Denodo Cloud

  • Client Version: 9.03.06.04

The Denodo cache engine must be enabled in the Server. Go to Denodo documentation for more details on how to activate the cache.

Alteryx Tools Used to Connect

Standard Workflow Processing

Input Data Tool

Input Data Tool Icon

Link

Output Data Tool

Output Data Tool Icon

Link

In-Database Workflow Processing

Connect In-DB Tool

Blue icon with database being plugged in.

Link

Data Stream In Tool

Blue icon with a stream-like object flowing into a database.

Link

Configure a Connection Using a DSN

  1. Go to ODBC and OLEDB Database Connections | Alteryx Help for information on how to create a Data Source Name (DSN) using the Denodo ODBC driver, and how to map it to the Input or Output tools.

  2. For more information on DSN configuration, go to the Denodo documentation.

    1. To use username and password authentication, save the username and password with the DSN or enter it when you configure the connection in Alteryx.

    2. To use Kerberos authentication, select Use Kerberos in the ODBC DSN and set the Krbsrvname to the "service class" of the Service Principal Name of the Server. Usually, the default of HTTP is correct. Your Denodo admin can help verify the value. When you use Kerberos authentication, any entry for username and password is ignored.

Configure a Connection Using a DSN and DCM

  1. Drag an Input Data tool or Output Data tool onto the Designer canvas.

  2. Select the Use Data Connection Manager (DCM) check box.

  3. In the Data Connections window, go to Data Sources and select Denodo ODBC. If Alteryx can't detect an ODBC driver, a pop-up indicates that you need to install a driver.

  4. The Connection Manager window opens. Select +New to add a new data source.

  5. The dropdown pre-selects Denodo ODBC by default.

  6. Enter a descriptive Data Source Name for the new data source, for example, "Denodo Marketing Server DSN".

  7. Select the ODBC DSN field to see a list of available DSNs and select a DSN to use for the data source. If you don’t have a DSN configured, go to the Denodo documentation to create one.

  8. Select Save.

  9. To link a credential, select + Connect Credential.

    1. Select an Authentication Method from the dropdown.

      1. Select Username and Password to authenticate with a username and password.

        1. From the Credential dropdown, select an existing Credential or select Create New Credential to enter a new username and password.

          1. Give the new credential a Credential Name.

          2. If applicable, select a Vault.

          3. Enter the username and password.

          4. Use Test Connection to make sure it has been configured correctly.

          5. Select Create and Link to link the new Credential to the Data Source.

        2. To use Kerberos authentication, select No Credentials. For this option, you must have your ODBC DSN configured for Kerberos authentication.

          1. Use Test Connection to make sure it has been configured correctly.

          2. Select Link to link the Credential to the Data Source.

  10. Select Connect to use the Data Source and Credential in an Input Data our Output tool.

Configure a DSN-less Connection Using DCM

  1. Drag an Input Data tool or Output Data tool onto the Designer canvas.

  2. Select the Use Data Connection Manager (DCM) check box.

  3. In the Data Connections window, go to Data sources and select Denodo Quick Connect. If Alteryx cannot detect an ODBC driver, a pop up prompts you to install a driver.

  4. The Connection Manager window opens. Select +New to add a new data source. If Alteryx can't detect an ODBC driver, a pop up prompts you to install a driver.

  5. The dropdown pre-selects Denodo ODBC DSN-less.

  6. Enter the information for the connection:

    1. Enter a descriptive Data Source Name for the connection, for example, "Denodo Cloud Instance DSN-less".

    2. Enter the Host name.

    3. Select the Driver field to change the driver selection. The default should be set to DenodoODBC Unicode(x64).

    4. Enter the Database name.

    5. Change the Port if needed. The default is set to 9996.

    6. Select SSL Mode. The default is set to Disable. Select Require if SSL is required for the connection.

    7. The User Agent is set to Alteryx_OnPrem by default to help with logging on the Denodo side.

  7. Select Save to save the new data source.

  8. To link a credential, select + Connect Credential.

    1. Select an Authentication Method from the dropdown.

      1. Select Username and Password to authenticate with a username and password.

        1. From the Credential dropdown, select an existing Credential or select Create New Credential to enter a new username and password.

          1. Give the new credential a Credential Name.

          2. If applicable, select a Vault.

          3. Enter the username and password.

          4. Use Test Connection to make sure it has been configured correctly.

          5. Select Create and Link to link the new Credential to the Data Source.

      2. To use Kerberos Authentication, select Kerberos - SSPI.

        1. From the Credential dropdown, select an existing Credential or select Create New Credential.

          1. Give the new credential a Credential Name.

          2. If applicable, select a Vault.

          3. Set the Krbsrvname to the "service class" of the Service Principal Name of the Server. Usually, the default of HTTP is correct. Your Denodo admin can help verify the value.

          4. Use Test Connection to make sure it has been configured correctly.

          5. Select Create and Link to link the Credential to the Data Source.

  9. Select Connect to use the Data Source and Credential in an Input Data our Output Data tool.

Configure a Denodo Bulk Connection to Write Data

The Denodo Bulk option uses Postgres' libpq API to write the data, which allows for faster loads. It's only available in the Output Data tool if DCM is used.

Note

The Denodo Bulk option is currently only available to write materialized tables and it always treats table names and column headers as quoted.

  1. Drag an Output Data tool onto the Designer canvas.

  2. Select the Use Data Connection Manager (DCM) check box.

  3. In the Data Connections window, go to Data sources and select Denodo Bulk.

  4. The Connection Manager window opens. Select +New to add a new data source.

  5. The dropdown pre-selects Denodo ODBC DSN-less.

  6. Enter the information for the connection:

    1. Enter a descriptive Data Source Name for the connection, for example, "Denodo Bulk Materialize Tables".

    2. Enter the Host name.

    3. Select the Driver field to change the driver choice. The default should be set to DenodoODBC Unicode(x64).

    4. Enter the Database name.

    5. Change the Port if needed. The default is set to 9996.

    6. Select SSL Mode. The default is set to Disable. Select Require if SSL is required for the connection.

    7. The User Agent is set to Alteryx_OnPrem by default to help with logging on the Denodo side.

  7. Select Save to save the new data source.

  8. To link a credential, select + Connect Credential.

    1. Select an Authentication Method from the dropdown.

      1. Select Username and Password to authenticate using a username and password.

        1. From the Credential dropdown, select an existing Credential or select Create New Credential to enter a new username and password.

          1. Give the new credential a Credential Name.

          2. If applicable, select a Vault.

          3. Enter the Username and Password.

          4. Use Test Connection to make sure it has been configured correctly.

          5. Click Create and Link to link the new Credential to the Data Source.

      2. Select Kerberos - SSPI to use Kerberos Authentication.

        1. From the Credential dropdown, choose an existing credential or select Create New Credential to create a new credential.

          1. Give the new credential a Credential Name.

          2. If applicable, select a Vault.

          3. Set the Krbsrvname to the "service class" of the Service Principal Name of the Server. Usually, the default of HTTP is correct. Your Denodo admin can help verify the value.

          4. Use Test Connection to make sure it has been configured correctly.

          5. Select Create and Link to link the Credential to the Data Source.

  9. Select Connect to use the Data Source and Credential in an Input Data our Output Data tool.

Configure an InDB Connection

To connect to Denodo using the InDB tools, create a new connection via the Manage In-DB Connections window. Select Denodo as the Data Source and Select New to create a new connection and give it a Connection Name.

Note

Denodo InDB is only supported using DCM. You must have DCM enabled to use Denodo InDB. The InDB tools only support writing to materialized tables and always treat table names and column headers as quoted.

Configure the Read tab

  1. Select Setup Connection to set up a new connection.

  2. Follow the instructions above to Configure a Connection using a DSN and DCM or to Configure a DSN-less Connection using DCM.

Configure the Write tab

The Write tab allows 2 options: None or Denodo Bulk Loader.

  1. If None is selected, no further configuration is needed but you won't be able to write using the InDB tools.

  2. To use the Denodo Bulk Loader, follow the instructions above to Configure a Denodo Bulk Connection to Write Data.

Limitations

  • For Remote table Write support, see Denodo: Remote Table Support.

  • COUNT DISTINCT is not supported in the InDB tools for Denodo. To COUNT DISTINCT: Use a Summarize InDB tool to group by the field to be counted. This returns a list of unique values. Filter out NULL values. Use a Summarize tool for a row count of every unique value.

  • Database is a required field when you connect to Denodo. If you don't provide a database name, this error displays: "connction string lacks some options" or "Missing database name in call to CC_connect".

  • Denodo has character limitations for passwords. If you store your password in DCM, you need to escape these characters: % as %25, + as %2B, { as %7B and } as %7D. Go to the Denodo documentation for more information.

  • These Postgres data types are not supported by Denodo:

    • Postgres boolean data type.

    • Oracle Time data type.