> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apache Impala SSH Connector

## Intro

Apache Impala is an open source massively parallel processing (MPP) SQL query engine for data stored in a computer cluster running Apache Hadoop. It consists of different processes that run on specific hosts within your CDH cluster. The Domo Apache Impala SSH connector brings your data from Apache server securely through an SSH tunnel into Domo.

The Apache Impala SSH Connector is a "Database" connector, meaning it retrieves data from a database using a query. In the Data Center, you can access the connector page for this and other Database connectors by clicking **Database** in the toolbar at the top of the window.

This topic discusses the fields and menus that are specific to the Apache Impala SSH connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your Apache Impala database and create a DataSet, you must have the following:

* The username and password you use to log into SSH Host
* The SSH host you wish to tunnel through
* The port number of your SSH host
* The SSH private key
* The username and password you use to log into your Apache Impala database
* The host name or IP address for the database server (e.g. [db.company.com](http://db.company.com) ).
* The port number for the database
* The database name

Before you can connect to an Apache Impala database, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see [Whitelisting IP Addresses for Connectors](/s/article/360043630093 "Whitelisting IP Addresses for Connectors").

<Note>
  **Note: Domo does not support the SSH keys generated using ssh-keygen. The SSH keys need to be the DES or RSA keys (in PEM format) generated by OpenSSL.**
</Note>

## Connecting to Your Apache Impala database

This section enumerates the options in the **Credentials** and **Details** panes in the Apache Impala SSH Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your (third-party tool) account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> SSH Server Host name </td><td colspan="1" rowspan="1"> Enter the SSH host name you wish to tunnel through. </td></tr><tr><td colspan="1" rowspan="1"> SSH Port </td><td colspan="1" rowspan="1"> Enter the port number of your SSH host. </td></tr><tr><td colspan="1" rowspan="1"> SSH Username </td><td colspan="1" rowspan="1"> Enter the username you use to log into SSH Host. </td></tr><tr><td colspan="1" rowspan="1"> SSH Password </td><td colspan="1" rowspan="1"> Enter the password you use to log into SSH Host. </td></tr><tr><td colspan="1" rowspan="1"> SSH Private Key </td><td colspan="1" rowspan="1"> Enter the SSH private key. </td></tr><tr><td colspan="1" rowspan="1"> Host </td><td colspan="1" rowspan="1"><span> Enter the hostname or IP address of your database server. Example: <a href="http://db.company.com" rel="noopener" target="_blank"> db.company.com </a></span></td></tr><tr><td colspan="1" rowspan="1"> Database Port </td><td colspan="1" rowspan="1"><span> Enter your Apache Impala port number. </span></td></tr><tr><td colspan="1" rowspan="1"> Database Name </td><td colspan="1" rowspan="1"><span> Enter your Apache Impala database/schema name. </span></td></tr><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"><span> Enter your Apache Impala username. </span></td></tr><tr><td colspan="1" rowspan="1"> Password </td><td colspan="1" rowspan="1"><span> Enter your Apache Impala password. </span></td></tr><tr><td colspan="1" rowspan="1"> Database Connection String Parameter(s) </td><td colspan="1" rowspan="1"><span> Enter the parameter(s) you want to include in the database connection string. Multiple parameters are separated by a semicolon. (Example: AuthMech=3;SSL=1;AllowSelfSignedCerts=1) </span></td></tr></tbody></table>

Once you have entered valid Apache Impala credentials, you can use the same account any time you go to create a new Apache Impala SSH DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><p><span> Select a query type. </span></p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Query </td><td colspan="1" rowspan="1"> A regular SQL query without parameter. </td></tr><tr><td colspan="1" rowspan="1"> Query Parameter </td><td colspan="1" rowspan="1"> An SQL query with parameter. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Query </td><td colspan="1" rowspan="1"><span> Enter the SQL query to execute. The query will execute on the Apache Impala server and fetch the data from it. </span></td></tr><tr><td colspan="1" rowspan="1"> Query Parameter </td><td colspan="1" rowspan="1"><p><span> Enter the query parameter value. It is the initial value for query parameter. The last run date is optional. The default value for the last date is '02/01/1700' if not provided. </span></p><p><span> Example: <tt> `!{lastvalue:_id}!=1,!{lastrundate:start_date}!=02/01/1944` </tt></span></p></td></tr><tr><td colspan="1" rowspan="1"> Database Table </td><td colspan="1" rowspan="1"><p><span> Select the database table. </span></p></td></tr><tr><td colspan="1" rowspan="1"> Table Columns </td><td colspan="1" rowspan="1"><p><span> Select the table columns. </span></p></td></tr><tr><td colspan="1" rowspan="1"> Query Helper </td><td colspan="1" rowspan="1"><p><span> This query is automatically generated when you select a table and columns in the Database Table and Table Columns fields, respectively. Copy and paste this query into the Query field if you need help building a query. </span></p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## FAQs

<AccordionGroup>
  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need your Apache Impala SSH credentials (server hostname, port number, private key, username, and password) as well as your database credentials (hostname, port number, database name, username, and password). You may also provide the parameter(s) you want to include in the database connection string. Multiple parameters are separated by a semicolon. Example: AuthMech=3;SSL=1;AllowSelfSignedCerts=1.
  </Accordion>

  <Accordion title="How frequently will my data update?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    Limits depend on your server configuration.
  </Accordion>

  <Accordion title="Can I use the same Apache Impala account to create multiple datasets?">
    Yes
  </Accordion>

  <Accordion title="What do I need to be aware of while writing a query?">
    Make sure that all the words, table names, and field names are correctly spelled. Refer to the Query Helper field if you need help building a query.
  </Accordion>

  <Accordion title="Why can't I connect to my Apache Impala database? Do I need to whitelist any IP addresses?">
    Before you can connect to an Apache Impala database in Domo, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see [Whitelisting IP Addresses](/s/article/360043630093).
  </Accordion>
</AccordionGroup>
