UpdateDataQualityEvaluationTask - DataWorks

更新資料品質校驗任務。

說明

目前該API介面已標記為棄用，推薦使用替代API：dataworks-public(2024-05-18) - UpdateDataQualityScan。

介面說明

需要購買 DataWorks 基礎版及以上版本才能使用。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:UpdateDataQualityEvaluationTask

update

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
Target	object	否	資料品質監控物件。
DatabaseType	string	否	資料表所屬的資料庫類型 maxcompute hologres cdh analyticdb_for_mysql starrocks emr analyticdb_for_postgresql	maxcompute
TableGuid	string	否	資料表在資料地圖中的唯一 ID。	odsp.openapi.ods_d_openapi_log
PartitionSpec	string	否	分割區資料表的分割區設定。	dt=$[yyyymmdd-1]
Description	string	否	品質監控任務描述。	OpenAPI data quality monitoring test.
Name	string	否	品質監控任務名稱。	OpenAPI data quality monitoring test.
RuntimeConf	string	否	擴充配置，JSON 格式的字串，只對 EMR 類型的資料品質監控生效。 queue：執行 EMR 資料品質校驗時，使用的 yarn 佇列，預設為本專案配置的佇列 sqlEngine：執行 EMR 的資料校驗時，採用的 SQL 引擎 HIVE_SQL SPARK_SQL	{ "queue": "default", "sqlEngine": "SPARK_SQL" }
Trigger	object	否	資料品質校驗任務的觸發配置。
Type	string	否	品質監控觸發類型。 ByScheduledTaskInstance：關聯排程任務觸發 ByManual：手動觸發	ByScheduledTaskInstance
TaskIds	array	否	排程任務 ID 清單，在 Type 為 ByScheduledTaskInstance 時有效。
	integer	否	排程任務節點 ID。	1004979033
ProjectId	integer	是	專案空間 Id。	10000
Hooks	array<object>	否	回呼設定。
	object	否	Hook
Type	string	否	資料品質校驗結束後，執行的 Hook 動作。 BlockTaskInstance：封鎖排程任務	ByScheduledTaskInstance
Condition	string	否	Hook 觸發條件，當滿足這個條件時，會觸發 Hook 動作。目前只能支援兩種條件運算式：只指定一組規則嚴重類型和規則校驗狀態，如`${severity} == "High" AND ${status} == "Critical"`，代表執行的規則中，如果有 severity 為 High 的規則校驗結果是 Critical，則滿足條件。指定多組規則嚴重類型和規則校驗狀態，如`(${severity} == "High" AND ${status} == "Critical") OR (${severity} == "Normal" AND ${status} == "Critical") OR (${severity} == "Normal" AND ${status} == "Error")`，代表執行的規則中，如果有 severity 為 High 的規則校驗結果是 Critical、或者 severity 為 Normal 的規則校驗結果是 Critical、或者 severity 為 Normal 的規則校驗結果是 Error，則滿足條件，條件運算式中 severity 的列舉與 DataQualityRule 中 severity 的列舉一致、status 的列舉與 DataQualityResult 中的 status 一致。	${severity} == "High" AND ${status} == "Critical"
Notifications	object	否	通知訂閱配置。
Condition	string	否	通知觸發條件，當滿足這個條件時，會觸發訊息通知。目前只能支援兩種條件運算式：只指定一組規則嚴重類型和規則校驗狀態，如`${severity} == "High" AND ${status} == "Critical"`，代表執行的規則中，如果有 severity 為 High 的規則校驗結果是 Critical，則滿足條件。指定多組規則嚴重類型和規則校驗狀態，如`(${severity} == "High" AND ${status} == "Critical") OR (${severity} == "Normal" AND ${status} == "Critical") OR (${severity} == "Normal" AND ${status} == "Error")`，代表執行的規則中，如果有 severity 為 High 的規則校驗結果是 Critical、或者 severity 為 Normal 的規則校驗結果是 Critical、或者 severity 為 Normal 的規則校驗結果是 Error，則滿足條件，條件運算式中 severity 的列舉與 DataQualityRule 中 severity 的列舉一致、status 的列舉與 DataQualityResult 中的 status 一致。	${severity} == "High" AND ${status} == "Critical"
Notifications	array<object>	否	通知設定。
	array<object>	否	通知設定。
NotificationReceivers	array<object>	否	告警接收人設定。
	object	否	告警接收人設定。
ReceiverType	string	否	告警接收人類型。枚舉值： WebhookUrl : 自訂 Webhook 位址。 FeishuUrl : 飛書通知位址。 DingdingUrl : 釘釘群機器人位址。 WeixinUrl : 微信通知位址。 AliUid : 阿里雲使用者 ID。	DingdingUrl
Extension	string	否	警示發送時的額外參數設定，JSON 格式，支援的 key 如下： atAll：發送釘釘警示時，是否需要在群組裡 @所有人。ReceiverType 為 DingdingUrl 時生效。	{ "atAll": true }
ReceiverValues	array	否	告警接收人。
	string	否	接收方取值。當接收方類型為阿里雲 ID 時，接收方取值為具體阿里雲使用者 ID。當接收方類型為 DingdingUrl 時，接收方取值為具體釘釘機器人的警示位址。當接收方類型為 WeixinUrl 時，接收方取值為具體企業微信的警示位址。當接收方類型為 FeishuUrl 時，接收方取值為具體飛書的警示位址。當接收方類型為 WebhookUrl 時，接收方取值為具體自訂 Webhook 的警示位址。	https://api.fc.aliyuncs.com/webhook
NotificationChannels	array<object>	否	通知方式。
	object	否	通知方式。
Channels	array	否	通知方式。
	string	否	通知方式 Dingding：釘釘群機器人 Mail：郵件 Weixin：微信通知 Feishu：飛書通知 Phone：電話 Sms：簡訊 Webhook：自訂 Webhook	Mail
DataSourceId	integer	否	資料來源 ID，您可以呼叫 ListDataSources 取得資料來源的 ID。	358750
DataQualityRules	array<object>	否	資料品質監控關聯的資料品質規則清單。
	array<object>	否
Name	string	否	資料品質規則名稱。	OpenAPI test rules
Enabled	boolean	否	資料品質規則是否啟用。	true
Severity	string	否	規則對於業務的等級（對應頁面上的強弱規則），可選的列舉值： Normal High	Normal
Description	string	否	資料品質規則描述資訊。	OpenAPI test rules
TemplateCode	string	否	規則所引用的規則範本唯一識別碼。	SYSTEM:field:null_value:fixed:0
SamplingConfig	object	否	樣本採集時，所需的參數。
Metric	string	否	取樣的指標名稱。 Count：資料表列數 Min：欄位最小值 Max：欄位最大值 Avg：欄位平均值 DistinctCount：欄位唯一值個數 DistinctPercent：欄位唯一值個數與資料列數佔比 DuplicatedCount：欄位重複值個數 DuplicatedPercent：欄位重複值個數與資料列數佔比 TableSize：資料表大小 NullValueCount：欄位為空的列數 NullValuePercent：欄位為空的比例 GroupCount：按欄位值聚合後每個值與對應的資料列數 CountNotIn：列舉值不匹配的列數 CountDistinctNotIn：列舉值不匹配的唯一值個數 UserDefinedSql：透過自訂 SQL 進行樣本採集	CountNotIn
MetricParameters	string	否	樣本採集時，所需的參數。	{ "Columns": [ "id", "name" ] , "SQL": "select count(1) from table;"}
SettingConfig	string	否	具體執行取樣語句前，插入執行的一些執行階段參數設定語句，最長 1000 個字元。目前僅支援 MaxCompute。	odps.sql.type.system.odps2=True,odps.sql.hive.compatible=True
SamplingFilter	string	否	採樣時，對不關注的資料進行二次篩選的條件，最多 16777215 個字元。	status != 'Succeeded'
CheckingConfig	object	否	樣本校驗設定。
Type	string	否	閾值計算方式。 Fluctation：波動範圍校驗 Auto：智慧閾值校驗 FluctationDiscreate：離散值波動範圍校驗 Average：平均值波動範圍校驗 Fixed：固定值校驗	Fixed
ReferencedSamplesFilter	string	否	有些類型的閾值需要查詢出一些參考樣本，然後對參考樣本的值進行彙總得出進行比較的閾值，這裡使用一個運算式來表示參考樣本的查詢方式。	{"bizdate": ["-1"]}
Thresholds	object	否	校驗閾值設定。
Expected	object	否	期望的閾值設定。
Operator	string	否	比較運算子。 > >= < <= != =	=
Value	string	否	閾值數值。	0
Expression	string	否	閾值運算式。波動率類型規則必須使用運算式方式表示波動閾值。如：波動上升大於 0.01： $checkValue > 0.01 波動下降大於 0.01：$checkValue < -0.01 波動率絕對值：abs($checkValue) > 0.01 固定值類型規則也可以使用運算式方式設定閾值，如果同時設定，運算式優先順序高於 Operator 和 Value。	$checkValue > 0.01
Warned	object	否	普通警告的閾值設定。
Operator	string	否	比較運算子。 > >= < <= != =	>
Value	string	否	閾值數值。	0.001
Expression	string	否	閾值運算式。波動率類型規則必須使用運算式方式表示波動閾值。如：波動上升大於 0.01： $checkValue > 0.01 波動下降大於 0.01：$checkValue < -0.01 波動率絕對值：abs($checkValue) > 0.01 固定值類型規則也可以使用運算式方式設定閾值，如果同時設定，運算式優先順序高於 Operator 和 Value。	$checkValue > 0.01
Critical	object	否	嚴重警告的閾值設定。
Operator	string	否	比較運算子。 > >= < <= != =	>
Value	string	否	閾值數值。	0.01
Expression	string	否	閾值運算式。波動率類型規則必須使用運算式方式表示波動閾值。如：波動上升大於 0.01： $checkValue > 0.01 波動下降大於 0.01：$checkValue < -0.01 波動率絕對值：abs($checkValue) > 0.01 固定值類型規則也可以使用運算式方式設定閾值，如果同時設定，運算式優先順序高於 Operator 和 Value。	$checkValue > 0.01
ErrorHandlers	array<object>	否	品質規則校驗問題處理器。
	object	否
Type	string	否	處理器類型： SaveErrorData：保留問題資料	SaveErrorData
ErrorDataFilter	string	否	如果是自訂 SQL 規則，需要使用者指定 SQL 來篩選問題資料。	SELECT * FROM ods_d_openapi_log WHERE status = 'Error'
Id	integer	否	校驗規則的 ID。您可以呼叫 ListQualityRules 介面取得規則 ID。	1022171560
Id	integer	是	資料品質監控 ID。	7227061794

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
Success	boolean	請求是否成功。	true
RequestId	string	請求 ID。用於定位日誌，排查問題。	8abcb91f-d266-4073-b907-2ed670378ed1

樣本

正常返回樣本

JSON格式

{
  "Success": true,
  "RequestId": "8abcb91f-d266-4073-b907-2ed670378ed1"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。