Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Data Hub profiles profile is used by the Data Hub forwarding - and task agent agents to connect to an Impala database via Cloudera JDBC, and an HDFS. This profile is also used to map the input UDRs to the Data Hub forwarding and an Impala database table. 

The Data Hub profile is loaded when you start a workflow that depends relies on it. Changes to the profile become effective when you restart the workflow.

Configuration

To create a new Data Hub profile configuration, click the New Configuration button  click the Configuration button in the upper left part panel of the Desktop the Desktop window , and then select Data Hub Profile from from the menu.

The contents of the menus in the menu bar may change depending on which configuration type that has been opened in the currently active tab. The Data Hub profile uses the standard menu items and buttons that are visible for all configurations, and these are described in /wiki/spaces/MD82/pages/3769348 in the /wiki/spaces/MZD73/pages/5656992Configuration [hide]mz9[/hide].

Impala Tab

The impala tab contains connections settings for the Impala database.

Image RemovedImage Added

Data Hub profile configuration - Impala tab

SettingDescription
HostEnter the hostname or the IP address of the Impala database.
PortEnter the port number that is configured for the connection into the Impala database.
Enable TLSAllows the user to enable the TLS functionality for the connection to the Impala database.
Allow Self Signed CertCheckbox to enable the usage of Self Signed Certificates. If this checkbox is
enabled
selected, both Trust Store File Path and Trust Store Password will be disabled.
Trust Store File Path
This field is available when you have enabled TLS.

Enter the location of the trust store file.

Trust Store Password
Note
titleNote!

This field is

available when you have enabled TLS.

enabled when the Enable TLS checkbox is selected.


Trust Store Password

Enter the passphrase of the trust store file.

Key Store File Path

Note
titleNote!

This field is

available when you have enabled TLS.

enabled when the Enable TLS checkbox is selected.


Key Store File Path

Enter the location of the key store file.

Key Store Password

Note
titleNote!

This field is

available when you have enabled TLS.

enabled when the Enable TLS checkbox is selected.


Key Store Password

Enter the passphrase of the key store file.

Note
titleNote!

This field is enabled when the Enable TLS checkbox is selected.


Database NameClick the Refresh button next to Database Name to retrieve a list of available database and then select a database from the drop-down menu. The Tables Mapping tab will appear.
RefreshClick
the refresh
this to retrieve a list of available databases.
Test ConnectionClick
to 
to test the JDBC connection to the Impala database.

HDFS Tab

The HDFS tab contains the properties required for the connection to HDFS as well as properties for staging paths.

Image RemovedImage Added

Data Hub profile configuration - HDFS tab

SettingDescription
HDFS URIEnter the URI of the HDFS NameNode.
Staging PathEnter the absolute path to an existing directory on the HDFS. This directory will be used as a staging directory for the data.
MZ Temp PathEnter the path for temporarily storing the files locally before it is inserted into the HDFS staging directory.
Create DirectorySelect this to create the MZ Temp Path directory if it does not exist. 

Advanced Tab

The Advanced tab contains the properties needed for Data Hub agent to connect to any Cloudera configurations that has LDAP and Kerberos enabled.

Image RemovedImage Added

Data Hub profile configuration - Advanced tab

...

Info
titleKerberos Keytab

You will need to ensure the keytab file is located in the same host as the EC that will be running the workflow with the Data Hub agent.

Tables Mapping

...

The Tables Mapping tab contains the mapping between one or more database table and a UDR type that you have selected in this tab. 

...

Tab

Image Added

Data Hub profile configuration - Tables Mapping tab

SettingDescription
Table

Select a database table from the drop-down list. The name of the table columns and their data type will appear.

Tip
titleHint!

You can map more than one table to a UDR type. This makes it possible to use the same profile for multiple Data Hub agents.


Note
titleNote!

If you have created a new table that appears to be missing in the drop-down list, click the Refresh button in Impala tab and then reselect the database. The table should now be listed.


UDR TypeClick the Browse button and then select a UDR type that will be routed to a Data Hub agent. For information about Ultra types that can be mapped to Impala types, see Compatible Types below.
Auto Map

Click this button to automatically map UDR fields and database columns with identical names. The automatic mapping is not case-sensitive. If a field cannot be mapped, the current value in the UDR Field column remains unchanged.

ColumnThe name of the columns in the selected table.
Type

Clicking the cell, displays a list of valid Impala types. Each column must be mapped against a type. For information about Ultra types that can be mapped to Impala types, see Compatible Types below.

UDR FieldSelect a UDR field from the drop-down list. This represents selectable fields available based on the selected UDR Type above.
Date Hint

Select the date format to be stored in the table. This is required for a partition column. A date in the Ultra format can be stored as INT, BIGINT and SMALLINT types.

When the column is a partition, you must select the corresponding date format from this drop-down list:

  • yyyyMMddHH - e g 2018123013
  • yyyyMMdd - e g 20181230
  • yyyyMM - 201812

  • yyyy - 2018

The selected format determines the granularity of date pickers in the Web UI.

When you change the Date Hint value of a partition column for an existing profile, make sure to review the settings of Data Hub task workflows that depend on the updated profile and table.

Warning

If the table already contains data when you change the Date Hint of a partition column, the Data Hub task agent will fail to delete any of the partitions. To resolve this issue you must manually delete the partitions that contain the old format, e g using Cloudera Hue.

Info
titleExample - SQL statement to partition


Code Block
alter table default.cw_carrier_voice_mis drop partition (yearmonthday=201812);




When the UDR fields do not have names that matches the database columns, you can map these manually by clicking the corresponding cell and selecting the field from a drop-down list. 

Anchor
compatible-types
compatible-types
Compatible Types

The following table shows allowed mappings of Impala types to Ultra types.

...