アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> getSqlPlan
 
getSqlPlan
提供されたsqlTextをTDVサーバー内で直接実行し、実行プランを返します。 rootNodeTitleは、このsqlText実行プランの名前です。
SQLステートメントまたはSQLスクリプトの実行プランはsqlTextで取得できます。入力パラメータのない一般的なSELECT、UPDATE、INSERT、DELETESQLがサポートされています。 SQLスクリプトの入力パラメーターもサポートされています。
parametersエレメントには、TDVスクリプトへの入力となる一連のパラメーターが含まれています。パラメータには次の2つのエレメントが含まれます。
definition:このパラメーター値のSQL言語タイプ。たとえば、VARCHAR(40)またはBIGINT
value:このパラメーターの値。
このオペレーションを呼び出すことができるのは、ACCESS_TOOLS権限を持つユーザーのみです。
ロケーション
/services/webservices/system/admin/execute/operations/
リクエストエレメント
rootNodeTitle(オプション):このsqlText実行プランの名前。デフォルトは実行プランです。
sqlText:実行するSQL。
parameters(オプション):実行入力として使用するパラメータの名前と値のペア。
応答エレメント
queryPlanRoot:ルートプラン。次のものが含まれます。
name:クエリプランノード名。
type:このクエリプランノードのタイプ。
properties(オプション):現在のノードとその子ノードのプロパティのリスト(任意の深さまで)。
エラー解析
RuntimeError:実行中にエラーが発生した場合。
セキュリティ:ユーザーがACCESS_TOOLS権限およびその他の適切な特権を持っていない場合。