APIカスタマイズ

APIカスタマイズwatsonx.dataインスタンス管理者がJVM、CONFIG、カタログ、Veloxをカスタマイズする方法を提供します(Presto(C++))のプロパティPresto(Java) そしてPresto(C++) エンジンを API 経由で実行します。

Presto ( ) Lite プランインスタンスのエンジンは、タグ、説明文、エンジン表示名のカスタマイズのみが可能です。 Java watsonx.data

このカスタマイズ方法では、ポッド内にパラメータを追加したり、ポッドを再起動したり(CPD展開がある場合)、サポート担当者に連絡したり(SaaSカスタマイズ用のデプロイメント。 また、バックエンド システムへの特別なアクセスや権限も必要ありません。 APIカスタマイズは、許可されたプロパティをカスタマイズするための統一された方法です。watsonx.data展開に関係なく。 API のカスタマイズは PATCH API を通じてサポートされます。 APIエンドポイントとサンプルリクエストPresto(Java) そしてPresto(C++) エンジンは次のとおりです。

パッチAPI(Presto(Java)エンジン

エンドポイント

/presto_engines/{engine_id}

要求本文

APIカスタマイズ・パッチには、必須フィールドとして configurationjvmcatalogevent_listenerjmx_exporter_configlog_configglobal 、オプションとしてその他のフィールドが必要です。

{
    "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カスタマイズ・パッチには、必須フィールドとして configurationjvmcatalogveloxlog_configglobal 、オプションとしてその他のフィールドが必要です。

optimizer_properties マテリアライズド・クエリー・テーブルが設定タブで有効になっている場合、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": {}
       }

詳しくは プレストエンジンの更新 をご覧ください。