LarkSheet(飞书表格)-v1 连接器


LarkSheet(飞书表格)-v1 连接器

上级文档:连接器

BitSail 飞书表格连接器可用于支持读取飞书表格,主要功能如下:

依赖引入

<dependency>
   <groupId>com.bytedance.bitsail</groupId>
   <artifactId>connector-larksheet</artifactId>
   <version>${revision}</version>
</dependency>

飞书表格读取

支持数据类型

飞书表格连接器以 string 格式读取所有数据。

参数

读连接器参数在job.reader中配置,实际使用时请注意路径前缀。示例:

{
  "job": {
    "reader": {
      "class": "com.bytedance.bitsail.connector.legacy.larksheet.source.LarkSheetInputFormat",
      "sheet_urls": "https://e4163pj5kq.feishu.cn/sheets/shtcnQmZNlZ9PjZUJKT5oU3Sjjg?sheet=ZbzDHq",
      "columns": [
        {
          "name": "id",
          "type": "string"
        },
        {
          "name": "datetime",
          "type": "string"
        }
      ]
    }
  }
}

必需参数

参数名称是否必须参数枚举值参数描述
class飞书表格读连接器名, com.bytedance.bitsail.connector.legacy.larksheet.source.LarkSheetInputFormat
sheet_urls要读取的飞书表格列表。多个表格链接用英文逗号分隔。
columns描述字段名称和字段类型。字段名称与飞书表格中的header相关(header即为第一行)。

下面的参数用于鉴权,用户至少需要设置 (sheet_token) 或者 (app_id and app_secret)其中一种。

参数名称是否必须参数枚举值参数描述
sheet_token至少设置下述一项:
1. sheet_token
2. app_id 和 app_secret
用于飞书 open api鉴权的token.
app_id使用 app_id 和 app_secret 来生成用于飞书 open api鉴权的token.
app_secret

注意,sheet_token可能在任务运行中过期。 如果使用app_idapp_secret,会主动刷新过期token。

可选参数

参数名称是否必须参数枚举值参数描述
reader_parallelism_num读并发
batch_size从open api一次拉取的数据行数
skip_nums对于每个表格可指定跳过开头的行数。用list表示

相关文档

配置示例文档:LarkSheet(飞书表格)连接器示例