如何通过Airtable.Net客户端API筛选含特定关联记录的表格行？

我之前用Airtable.Net客户端处理多值关联字段筛选时也踩过同样的坑，给你梳理下正确的解决思路和代码实现：

为什么之前的公式无效？ #

• 直接用{fieldname} = "<object_id>"：这个语法只适用于单值关联字段，多值关联字段存储的是记录ID数组，等于号只会匹配数组完全等于单个ID的情况（也就是字段只有这一个关联记录），所以大部分场景下返回空。
• 用空格作为ARRAYJOIN的分隔符：虽然记录ID本身不含空格，但Airtable在处理多值字段时，用空格分隔可能会出现匹配偏差（比如ID的首尾被空格影响），而且更稳妥的是用逗号或竖线这类无歧义的分隔符。

正确的筛选公式构建方法 #

要筛选多值关联字段中包含特定记录的行，核心思路是把关联字段的ID数组拼接成字符串，再检查目标ID是否存在其中：

FIND("<目标记录ID>", ARRAYJOIN({关联字段名}, ",")) > 0

• ARRAYJOIN({关联字段名}, ",")：把多值关联字段里的所有记录ID用逗号拼接成一个字符串
• FIND("<目标记录ID>", ...)：检查目标ID是否在拼接后的字符串中，返回位置大于0则说明存在

Airtable.Net中的代码实现 #

注意在C#中构建公式时，要正确转义双引号（用逐字字符串@会更方便，里面的双引号用两个""表示）：

using AirtableApiClient;

// 替换成你的Airtable配置
var apiKey = "your_api_key_here";
var baseId = "your_base_id_here";
var tableName = "your_table_name_here";
var targetRecordId = "recXYZ123456789"; // 要匹配的关联记录ID

using var airtableBase = new AirtableBase(apiKey, baseId);

// 构建筛选公式，这里的"关联项目"替换成你的实际关联字段名
var filterFormula = $@"FIND(""{targetRecordId}"", ARRAYJOIN({{关联项目}}, ",")) > 0";

// 执行查询，可指定要返回的字段
var query = airtableBase.Query<YourCustomRecordModel>()
    .FilterByFormula(filterFormula)
    .Fields("标题", "描述", "关联项目");

try
{
    var response = await query.ExecuteAsync();
    if (response.Success)
    {
        var matchingRows = response.Records;
        // 处理匹配到的记录
        foreach (var record in matchingRows)
        {
            Console.WriteLine($"匹配到记录：{record.Fields["标题"]}");
        }
    }
    else
    {
        Console.WriteLine($"查询失败：{response.Error.Message}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"发生异常：{ex.Message}");
}

额外注意事项 #

• 确保目标记录ID是正确的rec开头格式，比如rec123abc456def，不要写错。
• 如果担心ID和分隔符冲突（虽然概率极低），可以把ARRAYJOIN的分隔符换成更独特的字符，比如|，公式改为FIND("<目标ID>", ARRAYJOIN({字段名}, "|")) > 0。

内容的提问来源于stack exchange，提问作者Richard Comish