Zoho crm Logo

在COQL查询中的JOINs

SQL JOIN子句用于将数据库中两个或多个表的记录组合在一起。JOIN是通过使用两个表中的公共值来组合字段的一种方式。
在COQL中,您可以借助查找字段建立JOIN或关系,这些字段使用.(点)运算符将一个模块与另一个模块关联起来。

假设你想在两个表 - 联系人和账户之间建立一个JOIN。 
在联系人中,账户名称是对账户模块的查找字段。contacts

在账户中,Parent_Account字段是对账户本身的另一种查找,代表一个账户的父账户。账户

假设你想要从联系人中获取记录,其中与联系人关联的账户的父账户是“King”。

COQL查询

{
"select_query": "select 'Account_Name','Account_Name.Account_Name','Account_Name.Parent_Account','Account_Name.Parent_Account.Account_Name' from Contacts where (Account_Name.Parent_Account.Account_Name = 'King') limit 1 "
}

在这里,Account_Name将给出与联系人关联的账户的ID和显示字段值,Account_Name.Account_Name将给出账户的名称,Account_Name.Parent_Account将给出父账户的ID,Account_Name.Parent_Account.Account_Name将给出父账户的账户名称。如您所见,您可以使用.(点)运算符来检索通过查找字段JOIN的记录。

Response

{
    "data": [
        {
            "Account_Name.Parent_Account.Account_Name": "King",
            "Account_Name.Parent_Account": {
                "name": "King",
                "id": "5725767000005679001"
            },
            "Account_Name.Account_Name": "Zoho",
            "Account_Name": {
                "name": "Zoho",
                "id": "5725767000005329058"
            },
            "id": "5725767000005329061"
        }
    ],
    "info": {
        "count": 1,
        "more_records": false
    }
}

COQL中的JOIN类型

COQL支持两种类型的JOIN,这取决于在查询中如何以及在哪里使用查找字段:

  • 基础JOIN
  • 选择连接

基础 JOIN

当在SELECT列之外使用查找字段,如在WHERE,ORDER BY,GROUP BY子句或聚合列中时,将创建一个基础JOIN。

Example:

{
  "select_query": "select id from Contacts where Owner.role is not null"
}
// Owner.role is the Base JOIN used in the WHERE clause

注意

如果两个查找字段指向同一模块,它们将在基础JOIN中被视为单独的JOIN。

示例:

{ 
"select_query": "select id from Contacts order by Owner.role, Created_By.profile" 
} 
// Owner and Created_By are two lookup fields pointing to the Users module used in the Base JOIN. In this case, COQL will treat them as two separate JOINs. 

选择列 JOIN

当查找字段仅在SELECT列中使用,而不在WHERE,ORDER BY,GROUP BY子句或聚合列中使用时,将创建SELECT列JOIN。

Example:

{
  "select_query": "select Owner.profile, Created_By.role from Contacts where id is not null"
}
// Owner.profile and Created_By.role lookup fields are used only in the SELECT column. Hence, this is considered a SELECT column JOIN.

注意

如果在SELECT子句中的两个查找字段指向同一个模块,它们不会创建多个JOIN。COQL通过将它们视为单个JOIN来优化这一点。 

示例:在上述SELECT列JOIN查询中,两个查找字段都指向同一个模块(用户模块),所以COQL将其视为单个JOIN。

嵌套JOINs行为

如果你的查询包含嵌套的JOINs,如lookup_field_1.lookup_field_2.field,那么:

  1. 第一个JOIN(lookup_field_1.lookup_field_2)变成了基础JOIN。
  2. 第二个JOIN(lookup_field_2.field)被视为以下两者之一:
    • 如果它在WHERE,ORDER BY,GROUP BY子句或聚合列中使用,则被视为基础JOIN。
    • 如果它仅在SELECT列中使用,则被视为SELECT列JOIN。