SPSS
実環境ではまだテストされていません。結果をお知らせください。コードはベンダーのドキュメントに沿って作成しています。support@taskbeacon.io までご連絡ください。
SPSS Statistics の Python 3 連携(BEGIN PROGRAM PYTHON3)を使います。
コード
これは Code(コード)タブが生成するコードです(開始、エラー、行数 にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
* --- TaskBeacon: SPSS Statistics with the Python 3 integration ---.
BEGIN PROGRAM PYTHON3.
import json, urllib.request
import spss
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
spss.Submit(r"""
* --- your syntax here (the example data: replace it, e.g. GET FILE='C:\data\sales.sav'.) ---.
DATA LIST FREE / amount.
BEGIN DATA
12.5 7 3
END DATA.
""")
except spss.SpssError as e:
tb_ping("/fail", {"error": str(e)[:200]})
raise
tb_ping("", {"rows": spss.GetCaseCount()})
END PROGRAM.仕組み
コードはスクリプトの開始時に /start、正常に終わったときに行数付きでそのままのアドレス、失敗したときに /fail を ping し、エラーメッセージを送ります。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。報告できる内容もご覧ください。
SPSS シンタックスをスケジュールで実行する
SPSS Statistics は、シンタックスをプロダクション ジョブとして無人で実行します。SPSS で Utilities → Production Facility を開き、.sps ファイル(先頭に TaskBeacon のブロックを入れたもの)を追加して、ジョブを .spj ファイルとして保存します。次に、入力待ちにならないよう --production … silent を付けてコマンドラインから起動します(IBM のページではこのスイッチを -production とも記載しています)。
"C:\Program Files\IBM\SPSS Statistics\stats.exe" --production "C:\jobs\sales.spj" silent
この行を Task Scheduler(操作:Start a program(プログラムの開始))に入れます。stats.exe のフォルダーはバージョンによって異なります。IBM はこれらのスイッチを "Command line options" で説明しています(バージョン 23 のドキュメント、2015年頃のもの。お使いのバージョンのドキュメントを確認してください)。
終了コードだけでは足りない理由
プロダクション ジョブは、中のコマンドが失敗していても、目に見える失敗なしに終わることがあります。詳細はジョブの出力ファイルにありますが、何事もなければ誰も開きません。
上のコードはシンタックスを Python の中で spss.Submit を通して実行するので、SPSS のエラーは spss.SpssError を発生させ、メッセージ付きで /fail を送ります。
行数を報告する
最後にコードは spss.GetCaseCount()、つまりアクティブなデータセットのケース数を送ります。その行の前に、対象のデータセットをアクティブにしてください。
よくある問題
- BEGIN PROGRAM が失敗する。 Python 3 の統合機能がインストールされ、有効になっている必要があります(最近のバージョンでは SPSS Statistics に付属しています)。
- シンタックス内のパス。
GET FILEではフルパスを使ってください。プロダクション ジョブの作業フォルダーはシンタックスのフォルダーではありません。 - ネットワーク ドライブ。 ログアウト中に実行されるタスクからは、割り当てたドライブ文字が見えません。UNC パスを使ってください。
ユースケース: SPSS Statistics の本番ジョブが失敗したときにアラートを受け取る。その他のご質問: FAQ