创建飞书多维表格数据源

前提条件

• 已完成飞书自建应用的创建，并获取相关授权信息。操作详情请参见获取应用授权信息。

• 已获取待接入Dataphin的飞书多维表格分享链接。操作详情请参见获取多维表格链接。

使用限制

• 飞书多维表格的数据表支持多种字段类型，您可以通过飞书多维表格解析规则，查看飞书多维表格字段与Dataphin字段类型的映射关系。

• 由于飞书侧限制，自2024年10月31日起，飞书基础免费版接口累计可调用次数为1万次/月。若该调用量无法满足需求，您可升级至其他飞书版本扩容调用次数。具体请参见飞书自建应用API调用量上限调整说明。

权限说明

仅支持拥有新建数据源权限点的自定义全局角色和超级管理员、数据源管理员、板块架构师、项目管理员系统角色创建数据源。

操作步骤

1. 在Dataphin首页，在顶部菜单栏选择管理中心 > 数据源管理。

2. 在数据源页面，单击+新建数据源。

3. 在新建数据源页面，选择飞书多维表格。

   如果您最近使用过飞书多维表格，也可以在最近使用区域选择飞书多维表格。同时，您也可以在搜索框中，输入飞书多维表格的关键词，快速搜索。

4. 在新建飞书多维表格数据源页面中，配置连接数据源参数。

   1. 配置数据源的基本信息。

      参数	说明
      数据源名称	填写数据源名称。命名规则如下： 只能包含中文、英文字母大小写、数字、下划线（_）或短划线（-）。 长度不能超过64个字符。
      数据源编码	配置数据源编码后，您可以在Flink_SQL任务或使用Dataphin JDBC客户端中，通过数据源编码.表名称或数据源编码.schema.表名称的格式直接访问Dataphin数据源表，实现快捷消费；如果需要根据任务执行环境自动切换数据源，请通过${数据源编码}.table或${数据源编码}.schema.table的变量格式访问。更多信息，请参见Flink SQL任务开发方式。 重要 数据源编码配置成功后不支持修改。 数据源编码配置成功后，才能在资产清单的对象详情页面进行数据预览。 Flink SQL中，目前仅支持MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB、GaussDB（DWS）数据源。
      数据源描述	对飞书多维表格数据源的简单描述。不得超过128个字符。
      数据源配置	基于业务数据源是否区分生产数据源和开发数据源： 如果业务数据源区分生产数据源和开发数据源，则选择生产+开发数据源。 如果业务数据源不区分生产数据源和开发数据源，则选择生产数据源。
      标签	您可以根据标签给数据源进行分类打标，如何创建标签，请参见管理数据源标签。

   2. 配置数据源与Dataphin的连接参数。

      若您的数据源配置选择生产+开发数据源，则需配置生产+开发数据源的连接信息。如果您的数据源配置为生产数据源，仅需配置生产数据源的连接信息。

      说明

      通常情况下，生产数据源和开发数据源需配置为非同一个数据源，以实现开发数据源与生产数据源的环境隔离，降低开发数据源对生产数据源的影响。但Dataphin也支持配置成同一个数据源，即相同参数值。

      参数	描述
      飞书多维表格URL	飞书多维表格地址，例如https://base.feishu.cn/base/appxxxx。详细获取步骤请参见获取多维表格链接。
      APP ID、APP Secret	输入企业版内部应用的唯一标识key和密钥。详细获取步骤请参见获取应用授权信息。

5. 选择默认资源组，该资源组用于运行与当前数据源相关任务，包括数据库SQL、离线整库迁移、数据预览等。

6. 进行测试连接或直接单击确定进行保存，完成飞书多维表格数据源的创建。

   单击测试连接，系统将测试数据源是否可以和Dataphin进行正常的连通。若直接单击确定，系统将自动对所有已选中的集群进行测试连接，但即使所选中的集群均连接失败，数据源依然可以正常创建。

   测试连接针对公共调度集群或已经在Dataphin注册且正常使用的注册调度集群进行连接测试。公共调度集群为系统默认选中，不支持取消选中。注册调度集群下不存在资源组时，不支持进行连接测试，需先创建资源组后再进行测试连接。

   • 所选集群只用于测试与当前数据源的网络连通，不用于后续相关任务的运行。

   • 测试连接时长通常在2分钟内，若超时，您可以单击图标查看具体原因并重试。

   • 无论测试结果为连接失败、连接成功或成功有风险，系统都将为您记录最终结果的生成时间。

     说明

     仅公共调度集群的测试结果包含成功有风险、连接成功、连接失败三种连接状态；在Dataphin注册的注册调度集群的测试结果仅包含连接成功、连接失败两种连接状态。

   • 测试结果为连接失败时，您可以单击图标查看具体失败原因。

   • 测试结果为成功有风险时，代表应用集群连接成功、调度集群连接失败。您可以单击图标查看日志信息。

   重要

   • 如果连接测试失败，您可以根据网络连通常见问题进行排查。详细内容，请参见网络连通解决方案。

   • 当测试连接报错为VPC_GRANT_ACCESS_API_ERROR时，可参照VPC_GRANT_ACCESS_API_ERROR错误的解决方案进行处理。

附录