当前位置：首页 > article >正文

使用 Temporal 管理和调度 Couchbase SQL 脚本的实际例子

article 2025/1/18 9:04:26

场景描述

目标：使用 Temporal 管理和调度一组 Couchbase SQL 脚本来完成以下任务：

同步数据：从其他数据源同步数据到 Couchbase。

执行数据聚合：运行统计 SQL 查询。

清理过期数据：定期清理 Couchbase 中过期或无效的数据。

提供任务失败的自动重试、定时调度、任务状态跟踪。

实现步骤

Couchbase SQL 脚本准备

sync_data.sql：

INSERT INTO bucket-name (KEY, VALUE)
SELECT META().id, new_data.*
FROM source-bucket new_data
WHERE META().id NOT IN (SELECT RAW META().id FROM bucket-name);

aggregate_data.sql：

SELECT category, COUNT(*) AS count
FROM bucket-name
WHERE type = “product”
GROUP BY category;

cleanup_expired_data.sql：

DELETE FROM bucket-name
WHERE expiration_date < NOW_STR();

安装依赖

确保安装了以下库：

pip install temporalio couchbase

Temporal Workflow 和 Activity 实现

Temporal 的核心是 Workflow（描述流程）和 Activity（执行具体任务）。

Activity 实现

创建一个 Activity，用来执行 SQL 脚本。

from couchbase.cluster import Cluster, ClusterOptions

from couchbase.auth import PasswordAuthenticator

Couchbase Activity

class CouchbaseActivities:
def init(self, couchbase_host, username, password):
self.cluster = Cluster(
f’couchbase://{couchbase_host}',
ClusterOptions(PasswordAuthenticator(username, password))
)
self.query_service = self.cluster.query_indexes()

def execute_sql(self, sql_file_path):
    with open(sql_file_path, 'r') as file:
        query = file.read()
    result = self.query_service.query(query)
    print(f"Executed SQL from {sql_file_path}: {result}")
    return result

Workflow 定义

定义一个 Workflow，描述任务的执行顺序。

from temporalio import workflow

@workflow.defn

class CouchbaseWorkflow:
@workflow.run
async def run(self):
activities = workflow.ActivityStub(CouchbaseActivities)

    # 1. 同步数据
    await activities.execute_sql('/path/to/sync_data.sql')

    # 2. 数据聚合
    await activities.execute_sql('/path/to/aggregate_data.sql')

    # 3. 清理过期数据
    await activities.execute_sql('/path/to/cleanup_expired_data.sql')

Worker 实现

将 Workflow 和 Activity 注册到 Temporal Worker。

from temporalio.worker import Worker

from couchbase_activities import CouchbaseActivities

from couchbase_workflow import CouchbaseWorkflow

async def main():
worker = Worker(
host=“localhost:7233”, # Temporal 服务地址
task_queue=“couchbase_task_queue”,
workflows=[CouchbaseWorkflow],
activities=[CouchbaseActivities(“localhost”, “username”, “password”)]
)
await worker.run()

if name == “main”:
import asyncio
asyncio.run(main())

Workflow 启动代码

使用 Temporal 客户端启动 Workflow。

from temporalio.client import Client

async def main():
client = await Client.connect(“localhost:7233”)

# 启动 Workflow
handle = await client.start_workflow(
    CouchbaseWorkflow.run,
    id="couchbase_sql_workflow",
    task_queue="couchbase_task_queue",
)
print(f"Started workflow with ID: {handle.id}")

if name == “main”:
import asyncio
asyncio.run(main())

Temporal 的特性应用

任务调度：

Temporal 支持定时任务。可以通过 Temporal.schedule 定义定时运行的 Workflow。

自动重试：

每个 Activity 都可以配置重试策略。

from temporalio import activity
@activity.defn(retry_policy=activity.RetryPolicy(max_attempts=3))
async def execute_sql(sql_file_path):
…

任务依赖：

Workflow 中通过顺序执行 Activity 描述任务依赖关系。

可观察性：

使用 Temporal Web 界面查看 Workflow 和 Activity 的运行状态、历史和日志。

使用 Temporal 的优势