变量

变量（Variables）可以帮助配置时间范围、消除硬编码值，或为模型配置提供数据。在 Recurve 项目中，你可以将变量定义为资产，并在多个模型中共享使用。

Recurve 中的变量有两种作用域：

• 局部变量：使用 Jinja 语法在模型中定义，作用范围仅限于当前模型。

• 全局变量：在 库/ Library > 变量/ Variables 中定义，属于项目级资产，项目内的任何模型都可以访问。

通常提到“变量”时，我们指的是全局变量。

变量会显式地定义类型，避免强制转换，并防止格式错误。在构建模型（无论是在预览、控制台还是管道中）时，若模型涉及变量，你可以使用预设的默认值，也可以根据需要输入自定义值来覆盖它们。

定义变量

按照以下步骤定义项目变量：

1. 打开 Recurve 项目，进入 库/ Library > 变量/ Variables。

2. 点击 + “新建/ Add New”。

3. 输入变量名称、数据类型、描述和默认值。

   Recurve 支持创建带有显式数据类型的项目变量。

1. 点击 “创建/ Add”。

新创建的变量将显示在 库/ Library 的 变量/ Variables 部分。

默认情况下，创建的变量是启用状态，可以立即在模型中使用。如果需要停用变量，可以通过关闭 “启用/ Active” 选项来禁用它。

使用变量

你可以在模型中使用 {{ var('variable_name') }} 表达式来引用已定义的变量。

例如，以下模型使用了在项目库中定义的 min_order_dateime 变量。

select 
    id as order_id,
    customer as customer_id,
    ordered_at as order_date

from {{ source("jaffle_shop", "raw_orders") }}

where ordered_at >= {{ var('min_order_datetime') }}