API-Anpassung
API-Anpassung inwatsonx.data bietet Instanzadministratoren die Möglichkeit, JVM, CONFIG, Katalog und Velox anzupassen (Presto (C++)) Eigenschaften fürPresto (Java ) UndPresto (C++)-Engines über eine API.
Presto ( Java ) Motoren in watsonx.data Lite-Plan-Instanzen erlauben nur die Anpassung von Tags, Beschreibung und Anzeigename des Motors.
Bei dieser Anpassungsmethode müssen Sie die Parameter nicht im Pod hinzufügen, den Pod neu starten (wenn eine CPD-Bereitstellung vorhanden ist) oder sich an das Supportpersonal wenden (wennSaaS Bereitstellung) zur Anpassung. Außerdem sind keine besonderen Zugriffsrechte oder Berechtigungen für das Backend-System erforderlich. Die API-Anpassung ist eine einheitliche Möglichkeit, zulässige Eigenschaften anzupassen inwatsonx.data, unabhängig von der Bereitstellung. Die API-Anpassung wird durch die PATCH-API unterstützt. API-Endpunkte und Beispielanfragen fürPresto (Java ) UndPresto (C++)-Engines sind wie folgt:
PATCH-API (Presto (Java ) Motor)
Endpunkt
/presto_engines/{engine_id}
Anforderungshauptteil
Der API-Anpassungspatch muss die folgenden Felder enthalten: configuration, jvm, catalog, event_listener, jmx_exporter_config, log_config, global und
andere Felder als optional.
{
"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"
]
}
PATCH-API (Presto (C++)-Engine)
Endpunkt
/prestissimo_engines/{engine_id}
Anforderungshauptteil
Der API-Anpassungspatch muss die folgenden Felder enthalten: configuration, jvm, catalog, velox, log_config, global und andere Felder als optional.
optimizer_properties für presto (C++) kann nicht angepasst werden, wenn Materialized Query Tables auf der Konfigurationsregisterkarte aktiviert sind.
{
"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"
]
}
Das Curl-Beispiel zur API-Anpassung finden Sie in Aktualisieren Sie die Presto-Engine.
Eine Liste der Eigenschaften, die über eine API angepasst werden können, finden Sie unterPresto (Java ), sehen:
- Konfigurationseigenschaften fürPresto(Java)- Koordinator- und Worker-Knoten
- JVM-Eigenschaften fürPresto(Java)- Koordinator- und Worker-Knoten
- Katalogeigenschaften fürPresto(Java)
Eine Liste der Eigenschaften, die über eine API angepasst werden können, finden Sie unterPresto (C++), siehe:
- Konfigurationseigenschaften fürPresto(C++)- Arbeitsknoten
- Konfigurationseigenschaften fürPresto(C++)- Koordinatorknoten
- Katalogeigenschaften fürPresto(C++)
- Velox Eigenschaften fürPresto(C++)
Für Eigenschaften, die unter Anleitung deswatsonx.data Support-Team, siehe Eigenschaften können unter Anleitung des Supports angepasst werden.
Sie können System Access Control (SAC)-Plug-in-Protokolle mit DEBUG-Informationen erhalten. Um DEBUG Protokolle des SAC-Plug-ins in Presto zu aktivieren, lösen Sie die Anpassungs-API aus und fügen "com.ibm.openlakehouse.prestodb": "DEBUG" unter log_config hinzu.
"log_config": {
"coordinator": {
"com.ibm.openlakehouse.prestodb": "DEBUG"
},
"worker": {}
}
Weitere Informationen finden Sie unter Update presto engine.