20.11.2. スクリプトのメタデータ
スクリプトのメタデータは、スクリプトの実行方法に影響を与えるためにユーザーがサーバーに提供できるスクリプトに関する追加情報です。スクリプトの最初の行については、特別にフォーマットされたコメントに含まれています。
プロパティーは key=value ペアとして指定され、コンマで区切ります。複数の異なるコメントスタイルを使用できます: The //, ;;, # dependsing on the scripting language you use.必要に応じて複数の行にメタデータを分割でき、一重引用符(')または二重引用符(")引用符を使用して値を区切ることができます。
以下は、有効なメタデータコメントの例です。
// name=test, language=javascript // mode=local, parameters=[a,b,c]
// name=test, language=javascript
// mode=local, parameters=[a,b,c]
20.11.2.1. メタデータのプロパティー リンクのコピーリンクがクリップボードにコピーされました!
以下のメタデータプロパティーキーを使用できます。
Mode: スクリプトの実行モードを定義します。以下の値のいずれかになります。
- local: スクリプトは、要求を処理するノードによってのみ実行されます。スクリプト自体はクラスター化された操作を呼び出すことができます。
- Distributed: 分散エグゼキューターサービスを使用してスクリプトを実行します。
- language: スクリプトの実行に使用するスクリプトエンジンを定義します(例: Javascript)。
- 拡張機能: スクリプトの実行に使用するスクリプトエンジンを指定する代替方法(js など)
- Role: スクリプトの実行に必要な特定のロール
- parameters: このスクリプトの有効なパラメーター名の配列。この一覧に含まれていないパラメーター名を指定する呼び出しにより、例外が発生します。
-
datatype: キャッシュに保存されているデータのタイプ、パラメーターおよび戻り値に関するメディアタイプ(MIME とも呼ばれる)形式の情報を提供する任意のプロパティー。現在、
テキスト/警告である単一の値のみを許可します。charset=utf-8は、データが String UTF-8 形式であることを示します。このメタデータパラメーターは、特定タイプのデータのみをサポートするリモートクライアント用に設計されており、パラメーターの取得、保存、および使用が容易になります。
実行モードはスクリプトの特徴であるため、異なるモードでスクリプトを呼び出すためにクライアントでは特別なことは必要ありません。