Retrieve Real-Time Data

To automatically retrieve content that is pushed from DataSift, create a new Fetch Task by following these steps. The connector runs each fetch task automatically, based on the schedule that is configured in the configuration file.

To create a new Fetch Task

  1. Stop the connector.
  2. Open the connector’s configuration file in a text editor.
  3. In the [FetchTasks] section of the configuration file, specify the number of fetch tasks using the Number parameter. If you are configuring the first fetch task, type Number=1. If one or more fetch tasks have already been configured, increase the value of the Number parameter by one (1). Below the Number parameter, specify the names of the fetch tasks, starting from zero (0). For example:

    [FetchTasks]
    Number=1
    0=RealTime
  4. Below the [FetchTasks] section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

    [FetchTasks]
    Number=1
    0=RealTime
    					
    [RealTime]
  5. In the new section, set the following parameters so that the connector can access the DataSift repository.

    DatasiftUsername The user name to use to authenticate with DataSift.
    DatasiftApiKey The API key that is used to authenticate with DataSift.

    For example:

    [RealTime]
    DatasiftUsername=username
    DatasiftApiKey=APIkey
  6. Set exactly one of the parameters StreamDefinition, StreamHash, or SubscriptionID to define the stream that you want to retrieve. For example:

    [RealTime]
    DatasiftUsername=username
    DatasiftApiKey=APIkey
    StreamDefinition=twitter.geo geo_radius "51.5070,-0.1280:25"
  7. (Optional) When retrieving data in real-time, the connector's synchronize action does not end. If you want to limit the duration of the task, set the configuration parameter TaskMaxDuration. For example, to specify a maximum duration of one hour:

    [RealTime]
    DatasiftUsername=username
    DatasiftApiKey=APIkey
    StreamDefinition=twitter.geo geo_radius "51.5070,-0.1280:25"
    TaskMaxDuration=01:00:00
  8. Save and close the configuration file.

    You can now start the connector.


_FT_HTML5_bannerTitle.htm