MySQL Shell 9.0  /  ...  /  傳回自訂結果

10.4.2 傳回自訂結果

SQL 處理常式函數可以傳回結果物件。若要定義自訂結果,請使用 shell.create_result(data)data 可以是字典(用於單一結果),或是字典清單(用於多個結果)。

單一結果

單一結果的資料字典必須是字典,並包含下列項目

  • affectedItemsCount:(整數) 受處理 SQL 影響的項目數。

  • info:(字串) 定義結果的額外資訊。

  • executionTime:(雙精度浮點數) 處理 SQL 所需的時間,以秒為單位。

  • autoIncrementValue:(整數) 最後自動產生的插入 ID。

  • warnings:描述由處理 SQL 產生之警告的文件清單。

  • columns:(選擇性) 描述結果資料行中繼資料的清單。

  • data:(選擇性) 定義結果中包含的資料。請參閱第 10.4.3 節「結果資料規格」

多個結果

若要支援多個結果,請在 data 參數中定義字典清單。如需關於允許的字典元素之資訊,請參閱單一結果

您也可以在此清單中新增錯誤定義字典,以指出 SQL 處理期間發生的錯誤。錯誤字典必須具有下列屬性

  • error:(字串) 錯誤的描述。

  • code:(整數) 與錯誤相關聯的程式碼。