Table of Contents

Search

  1. Preface
  2. Introduction to Cloud Integration Hub
  3. Hub administration
  4. Project and Asset Management
  5. Applications
  6. Topics
  7. Data Integration tasks
  8. Publications
  9. Subscriptions
  10. Tracking and monitoring
  11. Cloud Integration Hub REST APIs
  12. Glossary

Cloud Integration Hub

Cloud Integration Hub

Creating a subscription

Use the Navigator to create subscriptions.
The following conditions must exist before you create a subscription:
  • An application or applications that consume data must exist. You can either use existing applications, or create and save new applications.
  • A topic from which to consume data must exist. You can either use an existing topic, or create and save a new topic.
  • If the subscription triggers a mapping task, a subscription task must exist in
    Informatica Intelligent Cloud Services
    . If the subscription triggers a synchronization task, you can either select a subscription task that exists in
    Informatica Intelligent Cloud Services
    or create the task.
You can also create subscriptions on the topic page. For more information, see Creating a topic.
  1. In the Navigator, click
    New
    Subscription
    .
    The
    New Subscription
    page appears.
  2. Enter the subscription name. Optionally, enter a description for the subscription.
  3. Choose the subscription mode, enabled or disabled.
    A disabled subscription does not run according to schedule or by an external API. You can only run a disabled subscription from the
    Explore
    page or from the topic page of the topic that the subscription subscribes to.
  4. Select the data consumption method:
    • Consume data with a Data Integration task
      . The subscription process triggers a
      Data Integration
      task to retrieve the data from the topic or topics in the
      Cloud Integration Hub
      publication repository and write the data to the subscribing application. Select this method to consume batch data into files, applications, and repositories.
    • Consume data with an API
      . Use the Consume Data REST API to consume the data from a specific topic in the
      Cloud Integration Hub
      publication repository. Select this method for high frequency, event-driven subscriptions.
      After you configure the subscription properties, you can copy the following URLs from the subscription page:
      • URL of the REST API. Use this URL to consume the data.
      • URL of the Swagger structure for the topic from which the subscription consumes data. Use the structure in the subscription request.
      You use the URLs when you create the request that runs the subscription.
  5. If the subscription consumes data with an API, you can define a notification URL.
    Cloud Integration Hub
    sends notifications to this URL when data is ready to consume.
  6. If the subscription triggers a
    Data Integration
    task, you can define the subscription as an unbound subscription.
    A subscription that is not restricted to specific publication instances. It consumes all the publication events data in the publication repository for the topics that the subscription subscribes to.
  7. Choose the application that subscribes to the data.
  8. Choose the topic from which the application consumes the data and then click
    Add Topic
    . If the subscription triggers a
    Data Integration
    task, you can add as many topics as required.
  9. If the subscription triggers a
    Data Integration
    task, perform the following tasks:
    1. If you added more than one topic to the subscription, specify the maximum number of hours to wait for all associated publications to finish publishing the data, after the first publication is ready for consumption.
      • If all the publications finish publishing the data during the time interval, the subscription process starts after the last publication is ready for consumption.
      • If one or more of the publications do not finish publishing the data during the time interval, the subscription process is cancelled and no data is delivered.
    2. If the task that defines the subscription mapping exists in
      Informatica Intelligent Cloud Services
      , choose the task. If not, click
      Create New Task
      to create a synchronization task.
    3. To create a new task, enter the following properties in the
      Create New Task
      window and click
      Create
      :
      Task Name
      Enter a name for the task.
      The name of the task must be unique within the organization. The task name is not case sensitive.
      The task name can contain alphanumeric characters, spaces, and the following special characters: _ . + -
      Source
      Select the topic table to consume data from. The format of the object is
      TopicName/tableName
      .
      Connection
      Select the target connection that connects to the target to consume data to.
      Target
      Select the target table to consume the data to. The
      Create New Task
      window shows the first 200 tables in the list.
      Cloud Integration Hub
      creates the task in the default folder and assigns the task to the subscription.
    4. If the subscription subscribes to large amounts of data, increase the read batch size to optimize the performance of the subscription.
      Increasing the batch size increases the memory consumption of the Secure Agent and might impact the performance of the Secure Agent machine.
    5. Select the method and the frequency of data consumption.
      When published data is ready
      Runs the subscription immediately after the published data is ready.
      Manually or by an external trigger
      No schedule. You can use the following methods to run the subscription:
      • Run manually from the
        Cloud Integration Hub
        explorer.
      • Run by an API. Call a command-line API or a REST API that starts the subscription.
      If a file subscription uses this scheduling option and publishes multiple files, all the files must be present in the source location when the subscription starts.
      By schedule
      Runs the subscription according to the defined schedule. Select one of the following options:
      • Every n minutes. Runs the subscription in intervals of up to 60 minutes. You select the number of minutes from the list.
      • Hourly. Runs the subscription in intervals of up to 24 hours. You select the number of hours from the list.
      • Daily. Runs the subscription at the same hour every day.
      • Weekly. Runs the subscription every week on one or more days at the same hour.
      • Monthly. Runs the subscription every month on a specific date or a specific day at the same hour.
      Define the delivery intervals in the
      Repeat running
      area.
  10. Click
    Save
    .