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. You must have a Microsoft Azure account with a minimum role of contributor.
- 2. Verify that you have an Active Directory application created.
- 3. Verify that your Active Directory application has permissions for the following API:
- - Windows Azure Service Management API
- - Windows Azure Active Directory
- 4. Verify that the Azure Active Directory application is added with a reader role to your Azure account subscription.
- 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>