• Data Ingestion Service

dis
  1. Help Center
  2. Data Ingestion Service
  3. User Guide
  4. Getting Started
  5. Creating a DIS Stream

Creating a DIS Stream

You can create a DIS stream on the DIS management console.

Procedure

  1. Log in to the DIS management console.

    Figure 1 DIS management console

  2. Click in the upper left corner of the page and select a region and project.
  3. On the homepage, click Create Stream and configure stream parameters.

    Table 1 Stream parameters

    Parameter

    Description

    Remarks

    Region

    Physical location of the cloud service. You can select a different region from the drop-down list.

    -

    Basic Information

    Stream Name

    Name of the DIS stream to be created. A stream name is 1 to 64 characters long. Only letters, digits, hyphens (-), and underscores (_) are allowed.

    -

    Stream Type

    • Common: Each partition supports a read speed of up to 2 MB/s and a write speed of up to 1 MB/s or 1,000 records/s.
    • Advanced: Each partition supports a read speed of up to 10 MB/s and a write speed of up to 5 MB/s or 2,000 records/s.

    -

    Partitions

    Partitions are the base throughput unit of a DIS stream.
    • For a common DIS stream, the value of Partitions is an integer from 1 to 50. A tenant can create a maximum of 50 partitions.
    • For an advanced DIS stream, the value of Partitions is an integer from 1 to 10. A tenant can create a maximum of 10 partitions.

    -

    Partition Calculator

    Calculator used to calculate the estimated number of partitions based on the information you entered.
    1. Click Partition Calculator.
    2. In the Partition Calculator dialog box, configure the Average Record Size (KB), Max. Records Written, and Consumer Applications parameters. The Estimated Partitions field then displays the recommended number of partitions. The value of this field cannot be modified.
      NOTE:
      Partition calculation formulas:
      • Based on the record quantity (the final value must be rounded up):

        Common stream: Maximum records written x (1 + 20%)/1000 (20% is the reserved partition percentage.)

        Advanced stream: Maximum records written x (1 + 20%)/2000 (20% is the reserved partition percentage.)

      • Based on the traffic (the final value must be rounded up):

        Common stream: Average record size x (1 + 20%) x Maximum records written/ (1 x 1024 KB) (20% is the reserved partition percentage.)

        Advanced stream: Average record size x (1 + 20%) x Maximum records written/ (5 x 1024 KB) (20% is the reserved partition percentage.)

      • Based on the consumer program quantity (the final value must be rounded up): (Number of consumer programs/2) x Number of partitions calculated based on the traffic (The result of the number of consumer programs/2 must reserve two decimals.)

        The largest value among the values calculated based on the previous three formulas is considered as the estimated partition value.

    3. Click Use Estimated Value. The estimated value is automatically used as the value of Partitions.

    -

    Data Retention (days)

    The maximum number of days for which data can be preserved in DIS. Data will be deleted when the retention period expires.

    Value range: an integer ranging from 1 to 3.

    -

    Auto-Scaling

    You can choose to enable or disable auto-scaling when creating a stream.

    You can click or to disable or enable auto-scaling.

    NOTE:

    You can choose whether to enable auto-scaling when creating a stream. You can also modify the auto-scaling attributes for a created stream.

    Scaling Range

    Set the maximum and minimum number of partitions that you can add or remove. The number of the target partitions for automatic scaling-up does not exceed the upper limit, and the number of the target partitions for automatic scale-down is not smaller than the lower limit.

    -

  4. Click Buy Now. The Details page is displayed.
  5. Click Submit.