DataStream API Tutorial

    In this tutorial, you will learn how to write a simple Python DataStream pipeline. The pipeline will read data from a csv file, compute the word frequency and write the results to an output file.

    Prerequisites

    This walkthrough assumes that you have some familiarity with Python, but you should be able to follow along even if you come from a different programming language.

    If you get stuck, check out the . In particular, Apache Flink’s user mailing list consistently ranks as one of the most active of any Apache project and a great way to get help quickly.

    How To Follow Along

    If you want to follow along, you will require a computer with:

    • Java 8 or 11
    • Python 3.6, 3.7 or 3.8

    Once PyFlink is installed, you can move on to write a Python DataStream job.

    DataStream API applications begin by declaring an execution environment (StreamExecutionEnvironment), the context in which a streaming program is executed. This is what you will use to set the properties of your job (e.g. default parallelism, restart strategy), create your sources and finally trigger the execution of the job.

    1. env = StreamExecutionEnvironment.get_execution_environment()
    2. env.set_runtime_mode(RuntimeExecutionMode.BATCH)
    3. env.set_parallelism(1)

    Once a StreamExecutionEnvironment is created, you can use it to declare your source. Sources ingest data from external systems, such as Apache Kafka, Rabbit MQ, or Apache Pulsar, into Flink Jobs.

    To keep things simple, this walkthrough uses a source which reads data from a file.

    1. ds.sink_to(
    2.     sink=FileSink.for_row_format(
    3.         base_path=output_path,
    4.         encoder=Encoder.simple_string_encoder())
    5.     .with_output_file_config(
    6.         OutputFileConfig.builder()
    7.         .with_part_prefix("prefix")
    8.         .with_part_suffix(".ext")
    9.         .build())
    10.     .with_rolling_policy(RollingPolicy.default_rolling_policy())
    11.     .build()
    12. )
    14. def split(line):
    15.     yield from line.split()
    17. # 计算词频
    18. ds = ds.flat_map(split) \
    19.        .map(lambda i: (i, 1), output_type=Types.TUPLE([Types.STRING(), Types.INT()])) \
    20.        .key_by(lambda i: i[0]) \
    21.        .reduce(lambda i, j: (i[0], i[1] + j[1]))

    The last step is to execute the actual PyFlink DataStream API job. PyFlink applications are built lazily and shipped to the cluster for execution only once fully formed. To execute an application, you simply call env.execute().

    The complete code so far:

    1. import argparse
    2. import logging
    3. import sys
    5. from pyflink.common import WatermarkStrategy, Encoder, Types
    6. from pyflink.datastream import StreamExecutionEnvironment, RuntimeExecutionMode
    7. from pyflink.datastream.connectors import (FileSource, StreamFormat, FileSink, OutputFileConfig,
    8.                                            RollingPolicy)
    11. word_count_data = ["To be, or not to be,--that is the question:--",
    12.                    "Whether 'tis nobler in the mind to suffer",
    13.                    "The slings and arrows of outrageous fortune",
    14.                    "Or to take arms against a sea of troubles,",
    15.                    "And by opposing end them?--To die,--to sleep,--",
    16.                    "No more; and by a sleep to say we end",
    17.                    "The heartache, and the thousand natural shocks",
    18.                    "That flesh is heir to,--'tis a consummation",
    19.                    "To sleep! perchance to dream:--ay, there's the rub;",
    20.                    "For in that sleep of death what dreams may come,",
    22.                    "Must give us pause: there's the respect",
    23.                    "That makes calamity of so long life;",
    24.                    "For who would bear the whips and scorns of time,",
    25.                    "The oppressor's wrong, the proud man's contumely,",
    26.                    "The pangs of despis'd love, the law's delay,",
    27.                    "The insolence of office, and the spurns",
    28.                    "That patient merit of the unworthy takes,",
    29.                    "When he himself might his quietus make",
    30.                    "With a bare bodkin? who would these fardels bear,",
    31.                    "To grunt and sweat under a weary life,",
    32.                    "But that the dread of something after death,--",
    33.                    "The undiscover'd country, from whose bourn",
    34.                    "No traveller returns,--puzzles the will,",
    35.                    "And makes us rather bear those ills we have",
    36.                    "Than fly to others that we know not of?",
    37.                    "Thus conscience does make cowards of us all;",
    38.                    "And thus the native hue of resolution",
    39.                    "Is sicklied o'er with the pale cast of thought;",
    40.                    "And enterprises of great pith and moment,",
    41.                    "With this regard, their currents turn awry,",
    42.                    "And lose the name of action.--Soft you now!",
    43.                    "The fair Ophelia!--Nymph, in thy orisons",
    44.                    "Be all my sins remember'd."]
    47. def word_count(input_path, output_path):
    48.     env = StreamExecutionEnvironment.get_execution_environment()
    49.     env.set_runtime_mode(RuntimeExecutionMode.BATCH)
    50.     # write all the data to one file
    51.     env.set_parallelism(1)
    53.     # define the source
    54.     if input_path is not None:
    55.         ds = env.from_source(
    56.             source=FileSource.for_record_stream_format(StreamFormat.text_line_format(),
    57.                                                        input_path)
    58.                              .process_static_file_set().build(),
    59.             watermark_strategy=WatermarkStrategy.for_monotonous_timestamps(),
    60.             source_name="file_source"
    61.         )
    62.     else:
    63.         print("Executing word_count example with default input data set.")
    64.         print("Use --input to specify file input.")
    65.         ds = env.from_collection(word_count_data)
    67.     def split(line):
    68.         yield from line.split()
    69.     # compute word count
    71.         .map(lambda i: (i, 1), output_type=Types.TUPLE([Types.STRING(), Types.INT()])) \
    72.         .key_by(lambda i: i[0]) \
    73.         .reduce(lambda i, j: (i[0], i[1] + j[1]))
    75.     # define the sink
    76.     if output_path is not None:
    77.         ds.sink_to(
    78.             sink=FileSink.for_row_format(
    79.                 base_path=output_path,
    80.                 encoder=Encoder.simple_string_encoder())
    81.             .with_output_file_config(
    82.                 OutputFileConfig.builder()
    83.                 .with_part_prefix("prefix")
    84.                 .with_part_suffix(".ext")
    85.                 .build())
    86.             .with_rolling_policy(RollingPolicy.default_rolling_policy())
    87.             .build()
    88.         )
    89.     else:
    90.         print("Printing result to stdout. Use --output to specify output path.")
    91.         ds.print()
    93.     # submit for execution
    94.     env.execute()
    97. if __name__ == '__main__':
    98.     logging.basicConfig(stream=sys.stdout, level=logging.INFO, format="%(message)s")
    100.     parser = argparse.ArgumentParser()
    101.     parser.add_argument(
    102.         '--input',
    103.         dest='input',
    104.         required=False,
    105.         help='Input file to process.')
    106.     parser.add_argument(
    107.         '--output',
    108.         dest='output',
    109.         required=False,
    110.         help='Output file to write results to.')
    112.     argv = sys.argv[1:]
    113.     known_args, _ = parser.parse_known_args(argv)
    115.     word_count(known_args.input, known_args.output)

    Now that you defined your PyFlink program, you can run the example you just created on the command line:

    The command builds and runs your PyFlink program in a local mini cluster. You can alternatively submit it to a remote cluster using the instructions detailed in .

    1. (a,5)
    2. (Be,1)
    3. (Is,1)

    This walkthrough gives you the foundations to get started writing your own PyFlink DataStream API programs. You can also refer to PyFlink Examples for more examples. To learn more about the Python DataStream API, please refer to for more details.