# 从 Zoho CRM 实体中读取
<a name="zoho-crm-reading-from-entities"></a>

**先决条件**

您要从中读取内容的 Zoho CRM 对象。您将需要对象名称。

**同步源支持的实体**：


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \$1 | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| 产品 | 支持 | 是 | 是 | 是 | 是 | 
| 报价 | 支持 | 是 | 是 | 是 | 是 | 
| 采购订单 | 支持 | 是 | 是 | 是 | 是 | 
| 解决方案 | 支持 | 是 | 是 | 是 | 是 | 
| Call | 支持 | 是 | 是 | 是 | 是 | 
| 任务 | 支持 | 是 | 是 | 是 | 是 | 
| 事件 | 支持 | 是 | 是 | 是 | 是 | 
| 发票 | 支持 | 是 | 是 | 是 | 是 | 
| Account | 支持 | 是 | 是 | 是 | 是 | 
| 联系人 | 支持 | 是 | 是 | 是 | 是 | 
| Vendor | 支持 | 是 | 是 | 是 | 是 | 
| 活动 | 支持 | 是 | 是 | 是 | 是 | 
| 交易 | 支持 | 是 | 是 | 是 | 是 | 
| 线索 | 支持 | 是 | 是 | 是 | 是 | 
| 自定义模块 | 支持 | 是 | 是 | 是 | 是 | 
| 销售订单 | 支持 | 是 | 是 | 是 | 是 | 
| 价目表 | 支持 | 是 | 是 | 是 | 是 | 
| 案例 | 支持 | 是 | 是 | 是 | 是 | 

**示例：**

```
zoho_read = glueContext.create_dynamic_frame.from_options(
    connection_type="ZOHO",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v7",
        "INSTANCE_URL": "https://www.zohoapis.in/"
    }
```

**异步源支持的实体**：


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \$1 | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| 产品 | 是 | 否 | 否 | 是 | 否 | 
| 报价 | 是 | 否 | 否 | 是 | 否 | 
| 采购订单 | 是 | 否 | 否 | 是 | 否 | 
| 解决方案 | 是 | 否 | 否 | 是 | 否 | 
| Call | 是 | 否 | 否 | 是 | 否 | 
| 任务 | 是 | 否 | 否 | 是 | 否 | 
| 事件 | 是 | 否 | 否 | 是 | 否 | 
| 发票 | 是 | 否 | 否 | 是 | 否 | 
| Account | 是 | 否 | 否 | 是 | 否 | 
| 联系人 | 是 | 否 | 否 | 是 | 否 | 
| Vendor | 是 | 否 | 否 | 是 | 否 | 
| 活动 | 是 | 否 | 否 | 是 | 否 | 
| 交易 | 是 | 否 | 否 | 是 | 否 | 
| 线索 | 是 | 否 | 否 | 是 | 否 | 
| 自定义模块 | 是 | 否 | 否 | 是 | 否 | 
| 销售订单 | 是 | 否 | 否 | 是 | 否 | 
| 价目表 | 是 | 否 | 否 | 是 | 否 | 
| 案例 | 是 | 否 | 否 | 是 | 否 | 

**示例：**

```
zoho_read = glueContext.create_dynamic_frame.from_options(
    connection_type="ZOHO",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v7",
        "INSTANCE_URL": "https://www.zohoapis.in/",
        "TRANSFER_MODE": "ASYNC"
    }
```

**Zoho CRM 字段详细信息**：

Zoho CRM 提供用于动态获取所支持实体元数据的端点。因此，可在数据类型级别捕获运算符支持。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/glue/latest/dg/zoho-crm-reading-from-entities.html)

## 对查询进行分区
<a name="zoho-crm-reading-partitioning-queries"></a>

异步模式下不支持分区。

**基于筛选条件的分区（同步模式）**：

如果您想在 Spark 中利用并发，可以提供其他 Spark 选项：`PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用这些参数，原始查询将被拆分为 `NUM_PARTITIONS` 个子查询，这些子查询可以由 Spark 任务同时执行。
+ `PARTITION_FIELD`：用于对查询进行分区的字段的名称。
+ `LOWER_BOUND`：所选分区字段的**包含**下限值。

  对于“日期时间”字段，我们接受 Spark SQL 查询中使用的 Spark 时间戳格式。

  有效值示例：

  ```
  "2024-09-30T01:01:01.000Z"
  ```
+ `UPPER_BOUND`：所选分区字段的**排除**上限值。
+ `NUM_PARTITIONS`：分区的数量。

示例：

```
zoho_read = glueContext.create_dynamic_frame.from_options(
    connection_type="zohocrm",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v7",
        "PARTITION_FIELD": "Created_Time"
        "LOWER_BOUND": "2022-01-01T01:01:01.000Z"
        "UPPER_BOUND": "2024-01-01T01:01:01.000Z"
        "NUM_PARTITIONS": "10"
    }
```