User Guide > Connections > Azure EventHub Connection
  

Azure EventHub Connection

Use the Azure EventHub connection to access Azure Event Hub as source or target. You can create and manage an Azure EventHub connection in the Developer tool or through infacmd.

Prerequisites

Before you create an Azure Eventhub connection, verify the following prerequisites:
  1. 1. You must have a Microsoft Azure account with a minimum role of contributor.
  2. 2. Verify that you have an Active Directory application created.
  3. 3. Verify that your Active Directory application has permissions for the following API:
  4. 4. Verify that the Azure Active Directory application is added with a reader role to your Azure account subscription.
  5. 5. Verify that you have an EventHub Namespace.

General Properties

The following table describes the general connection properties for the AzureEventHub connection:
Property
Description
Name
The name of the connection. The name is not case sensitive and must be unique within the domain. You can change this property after you create the connection. The name cannot exceed 128 characters, contain spaces, or contain the following special characters:
~ ` ! $ % ^ & * ( ) - + = { [ } ] | \ : ; " ' < , > . ? /
ID
The string that the Data Integration Service uses to identify the connection. The ID is not case sensitive. It must be 255 characters or less and must be unique in the domain. You cannot change this property after you create the connection. Default value is the connection name.
Description
The description of the connection. Enter a string that you can use to identify the connection. The description cannot exceed 4,000 characters.
Location
The domain where you want to create the connection. Select the domain name.
Type
The connection type. Select Messaging/AzureEventHub

Connection Properties

The following table describes the connection properties for the AmazonKinesis connection:
Property
Description
Tenant ID
The ID of the tenant that the data belongs to. This ID is the Directory ID of the Azure Active Directory.
Subscription ID
The ID of the Azure subscription.
Resource Group Name
The name of the Azure resource group associated with the event hub namespace.
Client Application ID
The ID of the application created under the Azure Active Directory.
Client Secret Key
The secret key generated for the application.
Event Hub Namespace
The name of the Event Hub Namespace that is associated with the resource group name.
Shared Access Policy Name
The name of the Event Hub Namespace Shared Access Policy.
The policy must apply to all data objects that are associated with this connection.
To read from Event Hubs, you must have Listen permission. To write to an Event hub, the policy must have Send permission.
Shared Access Policy Primary Key
The primary key of the Event Hub Namespace Shared Access Policy.

Creating an Azure EventHub Connection using Informatica Command Line Program

You can use the infacmd command line program to create an Azure EventHub connection. Access the command from the <Informatica installation directory>/clients/DeveloperClient/infacmd directory.
On UNIX, run the following command:
sh infacmd.sh createConnection
On Windows, run the following command:
infacmd.bat createConnection
Enter connection options in the following format:
... -o option_name='value' option_name='value' ...
For example, On UNIX you can run the following command to create an Azure EventHub connection:
sh infacmd.sh createConnection -dn <domain name> -un <domain user> -pd <domain password> -cn <connection name> -cid <connection id> -ct AZUREEVENTHUB -o tenantID='tenant id' subscriptionID='subscription id' resourceName='resource name' clientID='client id' clientSecretKey='secret key' eventHubNamespace='namespace' sasPolicyName=<policy name> sasPolicyPrimaryKey=<policy key>