发布到 kafka 主题的浮士德示例

Question

我很好奇您应该如何表达您希望将消息传递到浮士德的 Kafka 主题。 他们自述文件中的示例似乎没有写入主题：

import faust

class Greeting(faust.Record):
    from_name: str
    to_name: str

app = faust.App('hello-app', broker='kafka://localhost')
topic = app.topic('hello-topic', value_type=Greeting)

@app.agent(topic)
async def hello(greetings):
    async for greeting in greetings:
        print(f'Hello from {greeting.from_name} to {greeting.to_name}')

@app.timer(interval=1.0)
async def example_sender(app):
    await hello.send(
        value=Greeting(from_name='Faust', to_name='you'),
    )

if __name__ == '__main__':
    app.main()

我希望上面代码中的hello.send向主题发布消息，但似乎没有。

有许多阅读主题的示例，以及许多使用 cli 推送临时消息的示例。 梳理完文档后，我没有看到任何明确的在代码中发布到主题的示例。 我只是疯了，上面的代码应该可以工作吗？

Answer 1

您可以使用sink告诉 Faust 在哪里交付代理函数的结果。 如果需要，您还可以一次使用多个主题作为接收器。

@app.agent(topic_to_read_from, sink=[destination_topic])
async def fetch(records):
    async for record in records:
        result = do_something(record)
        yield result

Answer 2

send()函数是正确调用以写入主题的函数。 您甚至可以指定一个特定的分区，就像等效的 Java API 调用一样。

这是send()方法的参考：

https://faust.readthedocs.io/en/latest/reference/faust.topics.html#faust.topics.Topic.send

Answer 3

如果您只想要 Faust 生产者（不与消费者/接收器结合），那么原始问题实际上具有正确的代码位，这是一个功能齐全的脚本，可将消息发布到任何 Kafka 均可使用的“faust_test”Kafka 主题/浮士德消费者。

像这样运行下面的代码： python faust_producer.py worker

"""Simple Faust Producer"""
import faust

if __name__ == '__main__':
    """Simple Faust Producer"""

    # Create the Faust App
    app = faust.App('faust_test_app', broker='localhost:9092')
    topic = app.topic('faust_test')

    # Send messages
    @app.timer(interval=1.0)
    async def send_message(message):
        await topic.send(value='my message')

    # Start the Faust App
    app.main()

Answer 4

所以我们刚遇到需要向接收sink主题以外的主题发送消息。

我们找到的最简单的方法是： foo = await my_topic.send_soon(value="wtfm8") 。

您还可以使用 asyncio 事件循环直接使用send ，如下所示。

loop = asyncio.get_event_loop()
foo = await ttopic.send(value="wtfm8??")
loop.run_until_complete(foo)

Answer 5

不知道这有多么重要，但我在尝试学习 Faust 时遇到了这个问题。 从我读到的，这是正在发生的事情：

topic = app.topic('hello-topic', value_type=Greeting)

这里的误解是您创建的主题是您尝试使用/读取的主题。 您创建的主题当前不执行任何操作。

await hello.send(
        value=Greeting(from_name='Faust', to_name='you'),
    )

这实质上创建了一个中间 kstream，它将值发送到您的 hello(greetings) 函数。 def hello(...) 将在有新消息发送到流时被调用，并将处理正在发送的消息。

@app.agent(topic)
async def hello(greetings):
    async for greeting in greetings:
        print(f'Hello from {greeting.from_name} to {greeting.to_name}')

这是从 hello.send(...) 接收 kafka 流并简单地将其打印到控制台（没有输出到创建的“主题”）。 您可以在此处向新主题发送消息。 因此，您可以执行以下操作而不是打印：

topic.send(value = "my message!")

或者：

这是你在做什么：

1. example_sender() 向 hello(...) 发送消息（通过中间 kstream）
2. hello(...) 接收消息并打印它 注意：没有向正确的主题发送消息

您可以执行以下操作：

1. example_sender() 向 hello(...) 发送消息（通过中间 kstream）

2. hello(...) 接收消息并打印

3. hello(...) 还向创建的主题发送一条新消息（假设您正在尝试转换原始数据）

    app = faust.App('hello-app', broker='kafka://localhost') topic = app.topic('hello-topic', value_type=Greeting) output_topic = app.topic('test_output_faust', value_type=str) @app.agent(topic) async def hello(greetings): async for greeting in greetings: new_message = f'Hello from {greeting.from_name} to {greeting.to_name}' print(new_message) await output_topic.send(value=new_message)

Answer 6

我找到了如何使用 Faust 将数据发送到 kafka 主题的解决方案，但我并不真正了解它是如何工作的。

Faust 中有几种方法： send(), cast(), ask_nowait(), ask() 。 在文档中，它们被称为 RPC 操作。

创建发送任务后，您需要在Client-Only Mode 模式下运行 Faust 应用程序。 （ start_client(), maybe_start_client() ）

以下代码（produce() 函数）演示了它们的应用程序（注意注释）：

import asyncio

import faust


class Greeting(faust.Record):
    from_name: str
    to_name: str


app = faust.App('hello-app', broker='kafka://localhost')
topic = app.topic('hello-topic', value_type=Greeting)
result_topic = app.topic('result-topic', value_type=str)


@app.agent(topic)
async def hello(greetings):
    async for greeting in greetings:
        s = f'Hello from {greeting.from_name} to {greeting.to_name}'
        print(s)
        yield s


async def produce(to_name):
    # send - universal method for sending data to a topic
    await hello.send(value=Greeting(from_name='SEND', to_name=to_name), force=True)
    await app.maybe_start_client()
    print('SEND')

    # cast - allows you to send data without waiting for a response from the agent
    await hello.cast(value=Greeting(from_name='CAST', to_name=to_name))
    await app.maybe_start_client()
    print('CAST')

    # ask_nowait - it seems to be similar to cast
    p = await hello.ask_nowait(
        value=Greeting(from_name='ASK_NOWAIT', to_name=to_name),
        force=True,
        reply_to=result_topic
    )
    # without this line, ask_nowait will not work; taken from the ask implementation
    await app._reply_consumer.add(p.correlation_id, p)
    await app.maybe_start_client()
    print(f'ASK_NOWAIT: {p.correlation_id}')

    # blocks the execution flow
    # p = await hello.ask(value=Greeting(from_name='ASK', to_name=to_name), reply_to=result_topic)
    # print(f'ASK: {p.correlation_id}')


if __name__ == '__main__':
    loop = asyncio.get_event_loop()
    loop.run_until_complete(produce('Faust'))

使用命令faust -A <example> worker

然后我们可以启动应用程序的客户端部分并检查一切是否正常： python <example.py>

<example.py> 输出：

SEND
CAST
ASK_NOWAIT: bbbe6795-5a99-40e5-a7ad-a9af544efd55

值得注意的是，您还会看到交付后发生的一些错误的回溯，这不会干扰程序（似乎如此）

浮士德工人输出：

[2022-07-19 12:06:27,959] [1140] [WARNING] Hello from SEND to Faust 
[2022-07-19 12:06:27,960] [1140] [WARNING] Hello from CAST to Faust 
[2022-07-19 12:06:27,962] [1140] [WARNING] Hello from ASK_NOWAIT to Faust 

我不明白为什么它会这样工作，为什么这么难，为什么文档中写的很少 😓。