SQL查询结果导出为钉钉表格文档

新增钉钉应用

1. 进入钉钉开放平台，单击右上角的开发者后台进行登录，切换至业务目标钉钉组织。

2. 单击顶部导航栏上的应用开发，默认进入应用开发的钉钉应用页签。

3. 单击右侧创建应用，在弹出面板内，配置应用名称和应用描述，以及应用图标。

4. 完成配置后，单击保存，即可进入应用配置页面。

配置应用权限

在应用配置页面，单击开发配置 > 权限管理，进入对新建应用的权限配置页面。在该页面可以对不同的组织成员配置该应用不同权限，以及权限信息。

1. 权限范围：配置该应用的权限范围，圈定可以使用该钉钉应用的成员。

2. 配置应用权限，详情如下表所示：

   配置钉钉应用权限

   权限信息	接口	权限点code
   个人手机号信息	获取个人信息	Contact.User.mobile
   通讯录个人信息读权限	获取用户通讯录个人信息	Contact.User.Read
   调用SNS API时需要具备的基本权限	查询个人授权记录	snsapi_base
   调用企业API基础权限	生成jsapi	qyapi_base
   	生成微应用管理后台accessToken
   	通过业务主键拉取单条连接器主数据
   	分页拉取连接器主数据
   	同步连接器数据
   	获取企业accessToken（企业内部应用）
   	更新工作通知状态栏
   	通过免登码获取用户userid(v2)
   	使用服务助手推送消息
   	获取用户签到记录
   	自定义机器人接入发送消息
   	撤回工作通知消息
   	异步发送工作通知消息接口
   	获取工作通知消息的发送结果
   	获取工作通知消息的发送进度
   	获取通讯录权限范围
   	获取jsapi_ticket
   	上传媒体文件
   	获取报表假期数据
   	获取智能考勤报表的列值
   	获取考勤报表列定义
   	查询是否启用智能统计报表
   	获取用户考勤组
   	计算请假时长
   	获取考勤组列表详情
   	查询企业考勤排班详情
   获取钉钉开放接口用户访问凭证的基础权限	获取用户token	open_app_api_base
   	根据sns临时授权码获取用户信息
   知识库文档写权限	删除知识库文档成员	Document.WorkspaceDocument.Write
   	修改知识库文档成员
   	创建知识库文档
   	添加知识库文档成员
   钉钉表格读权限	获取所有工作表	Document.Workbook.Read
   	获取工作表
   	获取单元格区域
   钉钉表格写权限	设置行隐藏或显示	Document.Workbook.Write
   	设置列隐藏或显示
   	删除行
   	删除列
   	查看更多
   知识库文档读权限	查询目录树	Document.WorkspaceDocument.Read
   	查询知识库节点（包括文档和文件夹）
   知识库搜索权限	搜索知识库	Wiki.Workspace.Search
   知识库写权限	新建知识库	Wiki.Workspace.Write
   知识库读权限	获取知识库列表	Wiki.Workspace.Read
   	批量获取知识库
   	获取我的文档
   	获取知识库
   知识库节点读权限	获取节点列表	Wiki.Node.Read
   	通过链接获取节点
   	批量获取节点
   	获取节点

配置安全设置

在应用配置页面，单击开发配置 > 安全设置进入安全设置页面，对重定向URL（回调域名）进行配置。该域名信息如下：

• 中国地域重定向URL参照如下：

  华东1（杭州）：https://da-cn-hangzhou.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华东2（上海）：https://da-cn-shanghai.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华北2（北京）：https://da-cn-beijing.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华北3（张家口）：https://da-cn-zhangjiakou.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华北6（乌兰察布）：https://da-cn-wulanchabu.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华南1（深圳）：https://da-cn-shenzhen.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  中国香港（香港）：https://da-cn-hongkong.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华东2 金融云（上海）：https://da-cn-cn-shanghai-finance-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华北金融云2（北京）：https://da-cn-beijing-finance-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华南1 金融云（深圳）：https://da-cn-shenzhen-finance-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  华北2（北京）阿里政务云1：https://da-cn-north-2-gov-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback

• 国外地域重定向URL参照如下：

  日本（东京）：https://da-ap-northeast-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  新加坡：https://da-ap-southeast-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  美国（弗吉尼亚）：https://da-us-east-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  美国（硅谷）：https://da-us-west-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  英国（伦敦）：https://da-eu-west-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  印度尼西亚（雅加达）：https://da-ap-southeast-5.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  德国（法兰克福）：https://da-eu-central-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  马来西亚（吉隆坡）：https://da-ap-southeast-3.data.aliyun.com/api/v1/oa/dingtalk/auth/callback
  沙特（利雅得）：https://da-me-central-1.data.aliyun.com/api/v1/oa/dingtalk/auth/callback

发布应用

1. 完成所有配置项后，单击应用发布 > 版本管理与发布，进入版本发布页面。

2. 单击创建新版本，进入版本信息编辑页面。

3. 配置好相应描述信息后，即可进行应用发布。

钉钉应用接入

1. 进入SQL查询页面。

   登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的数据分析与服务 > 数据分析，单击进入数据分析页面，单击左侧导航栏的SQL查询进入SQL查询页面。

2. 单击左侧导航栏的更多 > 系统管理，进入系统管理页面后，单击办公软件集成页签，切换至办公软件集成页面。

3. 选择钉钉应用接入，并编辑配置钉钉应用接入，详细信息如下：

   配置项	说明
   钉钉应用名称	进入钉钉开放平台 > 应用开发，单击钉钉侧配置完成的钉钉应用配置，然后单击左侧导航栏上的基础信息 > 凭证与基础信息查看应用名称、Client ID、Client Secret。
   Client ID
   Client Secret

4. 配置完成后，单击确认保存钉钉应用接入信息。

查询结果并导出表格

1. 通过SQL查询与分析并成功获得查询结果后，单击结果栏右上角的导出 > 钉钉表格。

   

   重要

   若不出现该选项，请前往安全中心 > 数据查询与分析管控 > 查询结果管控中打开查询结果的允许下载。更多说明，请参见数据查询与分析管控。

2. 在弹出导出至钉钉表格的配置项，详细配置如下：

   新建钉钉表格模式

   

   配置项	说明
   目标文件	选择新建表格。每次导出会在钉钉文档内配置的文件夹内创建新的钉钉表格文件。
   文件夹链接	配置钉钉应用所在项目的钉钉文档文件夹链接，为导出的SQL查询结果提供文件夹。
   表格名称	对导出的文件进行命名。

   获取钉钉文档文件夹链接。

   1. 登录钉钉文档，并切换至应用所属的钉钉组织。

   2. 在右上角单击新建 > 文件夹，创建文件夹。

   3. 鼠标悬浮在已创建文件夹上单击右键，选择复制链接，即可获取到相应钉钉文档链接。

      

   导入已有钉钉表格模式

   

   配置项	说明
   目标文件	选择导入已有表格。每次导出会在选择的表格文档内新建新的Sheet，并将查询结果写入其中。
   表格ID	需导入SQL查询结果的表格文档ID，为导出的SQL查询结果提供一个表格文件。
   Sheet名称	对导出SQL查询结果写入的Sheet命名。

   获取钉钉表格ID。

   1. 登录钉钉文档，并切换至应用所属的钉钉组织。

   2. 进入已有的文件夹，并打开或新建当前SQL查询结果期望写入的表格文件。

   3. 单击表格文档左上角的表格 > 文档信息，会出现文档信息的弹窗，弹窗内即可按基本信息 > 表格ID找到该表格的ID。