文档

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

更新时间:

本文将为您介绍在DataWorks数据分析SQL查询功能中,如何将查询结果导出至钉钉表格。

背景介绍

DataWorks在进行SQL查询后,可直接通过钉钉应用,将查询结果以钉钉文档的形式导出在钉钉内,避免了将查询数据下载为Excel文件带来的数据安全问题。

钉钉侧配置

新增钉钉应用

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

  2. 单击钉钉开放平台顶部导航栏上的应用开发,进入应用开发页面。

  3. 在应用开发页面,单击左侧导航栏企业内部应用 > 钉钉应用进入钉钉应用页面。

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

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

image

配置应用权限

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

  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-2.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
说明
  • 重定向URL只需填写URL即可。

  • 如果需要重定向多个地域,将URL用,隔开写入即可。

发布应用

完成所有配置项后,单击开发配置 > 版本管理与发布单击创建新版本进入版本信息编辑页面,配置好相应描述信息后,单击发布,即可进行应用发布。image

DataWorks侧配置

新增应用

  1. 进入SQL查询页面。

    登录DataWorks控制台,切换至目标地域后,单击左侧导航栏的数据分析 > SQL查询,在下拉框中选择对应工作空间后单击进入SQL查询

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

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

    • 钉钉应用名称:请进入钉钉开放平台 > 应用开发,单击钉钉侧配置完成的钉钉应用配置,然后单击左侧导航栏上的基础信息 > 凭证与基础信息查看应用名称。

    • Client ID:请进入钉钉开放平台 > 应用开发,单击钉钉侧配置完成的钉钉应用配置,然后单击左侧导航栏上的基础信息 > 凭证与基础信息查看Client ID。

    • Client Secret:请进入钉钉开放平台 > 应用开发,单击钉钉侧配置完成的钉钉应用配置,然后单击左侧导航栏上的基础信息 > 凭证与基础信息查看Client Secret。

    image

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

配置查询

在DataWorks中通过SQL查询出结果,可以使用导出按钮将结果导出至钉钉文档表格中,以下为详细操作步骤。

  1. 进入SQL查询页面。

    登录DataWorks控制台,切换至目标地域后,单击左侧导航栏的数据分析 > SQL查询,在下拉框中选择对应工作空间后单击进入SQL查询

  2. 创建SQL查询。

    • 手动新建

      在页面左侧区域,单击我的文件右侧的添加图标,选择新建文件,根据界面提示创建SQL查询文件。

      image

    • 首次进入SQL查询页面或当前窗口没有打开SQL文件时,单击右侧页面中的新建SQL查询窗口。

      sql查询

    • 欢迎页或已有SQL文件被打开时,单击已打开文件名称右侧的创建新的SQL查询窗口。

      image

  3. 设置SQL执行数据源。

    在图示位置选择当前SQL查询需要查询的工作空间、引擎类型或数据源。选择数据源

    说明
    • 仅支持选择已授权您使用的数据源,若无目标数据源,您需要先联系管理员授权相关数据源的使用权限,并授予数据分析师、开发、运维或空间管理员其中一种权限。即可正常进行SQL查询。

    • 您可以在系统管理中修改任务运行时的资源组。

  4. 执行查询语句。

    在SQL编辑框内编辑对应数据源的查询代码,完成后执行对应命令即可获取查询结果。

    image

导出表格

完成配置SQL查询并成功运行SQL语句后,会在页面下方出现查询结果栏,单击结果栏左侧的导出 > 钉钉表格后,会弹出导出至钉钉表格的配置项,详细配置如下:

新建钉钉表格模式

image

配置项

配置内容

说明

目标文件

新建表格。

选择新建表格的,每次导出会在钉钉文档内配置的文件夹内创建新的钉钉表格文件。

文件夹链接

配置钉钉应用所在项目的钉钉文档文件夹链接。

为导出的SQL查询结果提供一个文件夹。

表格名称

自定义文件名称。

对导出的文件进行命名。

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

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

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

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

    image

导入已有钉钉表格模式

image

配置项

配置内容

说明

目标文件

导入已有表格。

选择导入已有表格,每次导出会在选择的表格文档内新建新的Sheet,并将查询结果写入其中。

表格ID

需导入SQL查询结果的表格文档ID。

为导出的SQL查询结果提供一个表格文件。

Sheet名称

自定义Sheet文件。

对导出SQL查询结果写入的Sheet命名。

获取钉钉表格ID。

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

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

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

    image