質問
HULFT Square Designerで作成したスクリプトをSnowflakeなどの外部システムから呼び出して実行することはできますか?また、エンドポイントURLの取得方法や複数スクリプトの同時実行方法についても教えてください。
回答
HULFT Square Designerで作成したスクリプトを外部システム(Snowflakeなど)から呼び出して実行することは、「REST APIジョブ」機能を利用することで実現可能です。
REST APIジョブは、ウェブブラウザまたは外部システム等からHTTP RESTリクエストを送信することにより、スクリプトを実行できる機能です。
設定手順については、以下の公式チュートリアルをご参照ください。
【公式】Bearer認証でREST APIジョブのエンドポイントを呼び出してみよう
■ エンドポイントURLの取得手順
1. [ジョブ] [REST APIジョブ] でREST APIジョブの一覧を表示する
2. 対象ジョブの列にマウスカーソルを合わせ、列の右端に表示される点三つの欄をクリックする
3. 表示されたメニューから [情報] をクリックする
4. 表示されたページの最下部にある [URL] 欄に記載されているURLがエンドポイントのURL
■ 同期実行のタイムアウトと非同期実行について
・REST APIジョブの同期実行におけるリクエストタイムアウトは29秒です。スクリプトの処理が29秒を超える場合は、リクエストヘッダーに「X-HSQ-Async: true」を指定して非同期実行をご検討ください。
・非同期実行の場合、スクリプトの実行結果を直接受領することはできません。ジョブで実行するスクリプトでCSVファイル等に実行結果を出力し、そのCSVファイルから実行結果を取得するポーリング用APIプロジェクトを別途作成する方法があります。
■ 複数スクリプトの同時実行について
・仕様上の制約として、1つのAPIプロジェクトを複数のREST APIジョブと紐づけることはできません(APIプロジェクトとREST APIジョブは1対1で紐づける必要があります)。
・ただし、1つのAPIプロジェクト内に複数のリソース(HTTPメソッド)を作成し、それぞれのリソースに異なるスクリプトを設定することは可能です。この構成では、1つのAPIプロジェクトに対して1つのREST APIジョブを作成し、リソース単位で異なるスクリプトを呼び出せます。
・複数のリソースを指定してREST APIジョブを同時に実行した場合、1度目の処理完了を待たずに2度目の処理が開始されます(待機状態にはなりません)。
・APIプロジェクト1つあたりに設定できるHTTPメソッド数にシステム上の上限は特に設けられていません。
コメント
0件のコメント
記事コメントは受け付けていません。