Azure confidential ledger 中的伺服器端程式設計

Azure 機密帳本提供伺服器端程式設計功能,可在帳本內執行自訂邏輯。 透過這些功能,你可以透過撰寫在機密環境中執行並與帳本資料互動的客製化程式碼,擴展帳本的功能。

你可以建立 使用者定義函數 (UDF)和 使用者定義端點 (UDE),以執行不同層級的自訂操作。 UDF和UDE過去分別被稱為簡單的使用者定義函數和進階的使用者定義函數。 定義 UDF 和 UDE 後,你可以直接從 Azure 機密帳本客戶端調用它們,直接在帳本引擎中執行。

UDFs 與 UDEs

Azure 機密帳本提供兩種伺服器端程式設計功能:

  • 使用者定義函數(UDF):UDF 是簡單的自訂函式,可在帳本中定義並執行。 它們允許你透過 JavaScript API 執行簡單操作,並可與現有的帳本寫入 API 整合。 欲了解更多資訊,請參閱 Azure 機密帳本中的使用者定義函數。

  • 使用者定義端點(UDE):UDE 是自訂端點,你在分類帳應用程式中定義並公開。 利用這些端點來公開可自訂參數、資料格式與驗證機制的更進階 API。 欲了解更多資訊,請參閱 Azure 機密帳本中的使用者定義端點。

以下是 UDF 與 UDE 主要功能與能力的比較:

能力 UDFs UDEs
執行自定義商業規則 是的 是的
自訂運行時間自變數 / 參數 是的 是的
公開新的 API / 端點 否 是的
執行個別函式 是的 否
在總帳分錄寫入作業之前/之後執行鉤子。 是的 否
建立和更新自定義程序代碼 是 (每個函式的精細更新/刪除) 是 (所有端點的單一應用程式套件組合更新)
自訂 JavaScript 執行時間選項 是(每一次執行) 是 (全球)
在備份節點上執行 否 是的
支援輸入和輸出的多個數據格式 否 是的
自訂驗證和授權 否 是的
目標案例 執行簡單的自定義邏輯,並與總賬 API 整合 需要自定義 API 並控制進階 JavaScript 參數的進階使用案例

在 UDF 與 UDE 之間切換

UDF與UDE是互斥的功能。 如果 UDE 已經定義,你就無法建立或執行 UDF,反之亦然。 請依照以下步驟在兩種功能間切換。

這很重要

在 UDF 與 UDE 之間切換是一種破壞性的操作。 切換到其他功能時,所有現有的 UDF 或 UDE 都會被刪除。 在進行前,先備份任何重要資料。

從UDF到UDE

要從 UDF 切換到 UDE,請刪除所有現有的 UDF:

  1. 使用 API 列出儲存在總帳GET /app/userDefinedFunctions。

  2. 使用 API 逐一DELETE /app/userDefinedFunctions/{functionId}。

從 UDE 到 UDF

若要從 UDE 切換到 UDF,請定義其模組和端點定義為空的 UDE。

  1. 使用下列結構建立新的應用程式套件組合:

    {
        "metadata": {
            "endpoints": {}
        }, 
       "modules": []
    }
    
  2. 使用 API,將應用程式套件組合 與步驟 1 PUT /app/userDefinedEndpoints 中定義的要求主體一起部署。

後續步驟

想開始在 Azure 機密帳本中進行伺服器端程式設計,請參考以下文章: