本文將為您介紹在DataWorks數據分析SQL查詢功能中,如何將查詢結果導出至釘釘表格。
背景介紹
DataWorks在進行SQL查詢后,可直接通過釘釘應用,將查詢結果以釘釘文檔的形式導出在釘釘內,避免了將查詢數據下載為Excel文件帶來的數據安全問題。
釘釘側配置
新增釘釘應用
進入釘釘開放平臺,單擊右上角的開發者后臺進行登錄,切換至業務目標釘釘組織。
單擊釘釘開放平臺頂部導航欄上的應用開發,進入應用開發頁面。
在應用開發頁面,單擊左側導航欄
進入釘釘應用頁面。單擊右側創建應用,在彈出面板內,配置應用名稱和應用描述,以及應用圖標。
完成配置后,單擊保存,即可進入應用配置頁面。
配置應用權限
在應用配置頁面,單擊
進入對新建應用的權限配置頁面,在該頁面可以對不同的組織成員配置對該應用的不同權限,以及權限信息。權限范圍:按需求配置該應用的權限范圍,圈定可以使用該釘釘應用的成員。
配置應用權限,詳情如下表所示:
權限信息
接口
權限點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
重定向URL只需填寫URL即可。
如果需要重定向多個地域,將URL用
,
隔開寫入即可。
發布應用
完成所有配置項后,單擊
單擊創建新版本進入版本信息編輯頁面,配置好相應描述信息后,單擊發布,即可進行應用發布。DataWorks側配置
新增應用
進入SQL查詢頁面。
登錄DataWorks控制臺,切換至目標地域后,單擊左側導航欄的 ,在下拉框中選擇對應工作空間后單擊進入SQL查詢。
單擊左側導航欄的
,進入系統管理頁面后,單擊辦公軟件集成,切換至辦公軟件集成頁面。選擇釘釘應用接入,并編輯配置釘釘應用接入,詳細信息如下:
配置完成后,單擊確認保存釘釘應用接入信息。
配置查詢
在DataWorks中通過SQL查詢出結果,可以使用導出按鈕將結果導出至釘釘文檔表格中,以下為詳細操作步驟。
進入SQL查詢頁面。
登錄DataWorks控制臺,切換至目標地域后,單擊左側導航欄的 ,在下拉框中選擇對應工作空間后單擊進入SQL查詢。
創建SQL查詢。
手動新建
在頁面左側區域,單擊我的文件右側的圖標,選擇新建文件,根據界面提示創建SQL查詢文件。
首次進入SQL查詢頁面或當前窗口沒有打開SQL文件時,單擊右側頁面中的新建SQL查詢窗口。
歡迎頁或已有SQL文件被打開時,單擊已打開文件名稱右側的創建新的SQL查詢窗口。
設置SQL執行數據源。
在圖示位置選擇當前SQL查詢需要查詢的工作空間、引擎類型或數據源。
說明僅支持選擇已授權您使用的數據源,若無目標數據源,您需要先聯系管理員授權相關數據源的使用權限,并授予數據分析師、開發、運維或空間管理員其中一種權限。即可正常進行SQL查詢。
您可以在系統管理中修改任務運行時的資源組。
執行查詢語句。
在SQL編輯框內編輯對應數據源的查詢代碼,完成后執行對應命令即可獲取查詢結果。
導出表格
完成配置SQL查詢并成功運行SQL語句后,會在頁面下方出現查詢結果欄,單擊結果欄左側的
后,會彈出導出至釘釘表格的配置項,詳細配置如下:新建釘釘表格模式
配置項 | 配置內容 | 說明 |
目標文件 | 新建表格。 | 選擇新建表格的,每次導出會在釘釘文檔內配置的文件夾內創建新的釘釘表格文件。 |
文件夾鏈接 | 配置釘釘應用所在項目的釘釘文檔文件夾鏈接。 | 為導出的SQL查詢結果提供一個文件夾。 |
表格名稱 | 自定義文件名稱。 | 對導出的文件進行命名。 |
登錄釘釘文檔,并切換至應用所屬的釘釘組織。
在右上角單擊
,創建文件夾。鼠標懸浮在已創建文件夾上單擊右鍵,選擇復制鏈接,即可獲取到相應釘釘文檔鏈接。
導入已有釘釘表格模式
配置項 | 配置內容 | 說明 |
目標文件 | 導入已有表格。 | 選擇導入已有表格,每次導出會在選擇的表格文檔內新建新的Sheet,并將查詢結果寫入其中。 |
表格ID | 需導入SQL查詢結果的表格文檔ID。 | 為導出的SQL查詢結果提供一個表格文件。 |
Sheet名稱 | 自定義Sheet文件。 | 對導出SQL查詢結果寫入的Sheet命名。 |
登錄釘釘文檔,并切換至應用所屬的釘釘組織。
進入已有的文件夾,并打開或新建當前SQL查詢結果期望寫入的表格文件。
單擊表格文檔左上角的
,會出現文檔信息的彈窗,彈窗內即可按 找到該表格的ID。