API自訂
API客製化在watsonx.data為實例管理員提供了一種自訂 JVM、CONFIG、目錄和 Velox 的方法（Presto(C++)) 的屬性Presto(Java） 和Presto透過 API 的 (C++) 引擎。
Presto ( ) Lite 計劃實例中的引擎僅允許標籤、描述和引擎顯示名稱的自訂。Java watsonx.data
這種自訂方法不需要您在 pod 內部新增參數、重新啟動 pod（如果有 CPD 部署）或聯絡支援人員（如果有）SaaS部署）進行客製化。 它也不需要對後端系統的任何特殊存取和特權。 API自訂是一種統一的方式來自訂允許的屬性watsonx.data，無論部署如何。 透過 PATCH API 支援 API 自訂。 API 端點和範例請求Presto(Java） 和Presto(C++) 引擎如下：
補丁 API（Presto(Java） 引擎）
端點
/presto_engines/{engine_id}
要求內文
API 自訂修補程式必須包含下列必填欄位 configuration, jvm, catalog, event_listener, jmx_exporter_config, log_config, global 以及其他可選欄位。
{
"description": "updated description for presto engine",
"engine_display_name": "sampleEngine",
"engine_properties": {
"configuration": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"jvm": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"catalog": {
"property_1": "property_value",
"property_2": "property_value"
},
"event_listener": {
"property_1": "property_value",
"property_2": "property_value"
},
"log_config": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"global": {
"enable-mixed-case-support": "true"
}
},
"engine_restart": "force",
"remove_engine_properties": {
"configuration": {
"coordinator": [
"property1",
"property2"
],
"worker": [
"property1",
"property2"
]
},
"jvm": {
"coordinator": [
"property1",
"property2"
],
"worker": [
"property1",
"property2"
]
},
"event_listener": [
"property1",
"property2"
]
},
"catalog": {
"catalog_name": [
"property1",
"property2"
]
},
"global": {},
"tags": [
"tag1",
"tag2"
]
}
補丁 API（Presto（C++）引擎）
端點
/prestissimo_engines/{engine_id}
要求內文
API 自訂修補程式必須包含下列必填欄位 configuration, jvm, catalog, velox, log_config, global 以及其他可選欄位。
optimizer_properties 如果從組態索引標籤啟動了 Materialized Query Tables，則無法自訂 presto (C++)。
{
"description": "updated description for prestissimo engine",
"engine_display_name": "sampleEngine",
"engine_properties": {
"configuration": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"jvm": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"catalog": {
"catalog_name": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
}
},
"velox": {
"property_1": "property_value",
"property_2": "property_value"
},
"log_config": {
"coordinator": {
"property_1": "property_value",
"property_2": "property_value"
},
"worker": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"optimizer_properties":{
"property_1": "property_value",
"property_2": "property_value"
},
"global": {
"property_1": "property_value",
"property_2": "property_value"
}
},
"engine_restart": "force",
"remove_engine_properties": {
"configuration": {
"coordinator": [
"property1",
"property2"
],
"worker": [
"property1",
"property2"
]
},
"catalog": {
"catalog_name": {
"coordinator": [
"property1",
"property2"
],
"worker": [
"property1",
"property2"
]
}
},
"jvm": {
"coordinator": [
"property1",
"property2"
]
},
"log_config": {
"coordinator": [
"property1",
"property2"
],
"worker": [
"property1",
"property2"
]
},
"velox": [
"property1",
"property2"
]
},
"tags": [
"tag1",
"tag2"
]
}
您可以在以下位置找到 API 自訂的curl 範例 更新急速引擎。
有關可透過 API 自訂的屬性列表Presto(Java），看：
有關可透過 API 自訂的屬性列表Presto(C++)，參見：
對於必須在業主指導下定制的房產watsonx.data支援團隊，請參閱 在支援指導下定制的屬性。
您可以獲得帶有 DEBUG 資訊的系統存取控制 (SAC) 插件日誌。 若要在Presto中啟用 SAC 外掛程式的 DEBUG 日誌，請觸發自訂 API 並在 log_config 下方新增 "com.ibm.openlakehouse.prestodb": "DEBUG"。
"log_config": {
"coordinator": {
"com.ibm.openlakehouse.prestodb": "DEBUG"
},
"worker": {}
}
有關更多信息，請參閱 更新 presto 引擎。