付録 A データベーススキーマ
この付録には、データベーススキーマの情報が表形式で記載されています。次の各項目について説明します。
スキーマテーブル
sge_job
sge_job テーブルは、各配列タスク (配列タスク番号 1 の付いた非配列ジョブに対して 1 レコード) および緊密に統合された並列ジョブ内で開始される各並列タスクに対して 1 つのレコードを格納します。
N1GE 6.0 システムでは、ジョブ、配列タスク、または並列タスクがスケジュールされるとすぐにレコードが作成されます。レコードは、ジョブの実行中に更新されます。
N1GE のジョブ、配列ジョブ、並列ジョブ、およびこれらの違いについての簡単な説明は、『Sun Grid Engine ユーザーズガイド』を参照してください。特に、用語集が導入として役立ちます。
|
列
|
タイプ
|
説明
|
|
j_id
|
Integer
|
一意のレコード識別子
|
|
j_job_number
|
integer
|
JOB_ID
|
|
j_task_number
|
integer
|
配列タスクの ID。
|
|
j_pe_taskid
|
text
|
緊密に統合された並列タスクの ID。
|
|
j_job_name
|
text
|
ジョブの名前 (スクリプト名、または発行オプション -N を使用した値のセット)
|
|
j_group
|
text
|
ジョブが実行された一次グループの UNIX グループ名。
グループテーブルを参照します。
|
|
j_owner
|
text
|
ジョブが実行された UNIX ユーザーアカウント。
ユーザーテーブルを参照します。
|
|
j_account
|
text
|
発行オプション -A を使用したアカウントの文字列セット。
|
|
j_priority
|
integer
|
発行オプション -p を使用した優先順位設定、またはキュー構成で割り当てられた優先順位設定。
|
|
j_submission_time
|
timestamp
|
ジョブ発行の時間。
|
|
j_project
|
text
|
プロジェクト (Sun Grid Engine、Enterprise Edition のみ)
プロジェクトテーブルを参照します。
|
|
j_department
|
text
|
部署 (Sun Grid Engine、Enterprise Edition のみ)
部署テーブルを参照します。
|
sge_job_usage
sge_job_usage テーブルは、時間ごとのジョブのリソース使用率を保持します。
N1GE 5.3 システムでは、完了ジョブ、配列タスク、および並列タスクごとに 1 レコードのみ存在します。ju_curr_time 列はジョブの終了時刻を保持します (sge_job の j_end_time)。
N1GE 6.0 システムでは、オンラインの使用量も格納されます。これにより、1 つのジョブ、配列タスク、および並列タスクに対して複数のレコードが sge_job に格納されることになります。ジョブのリソース使用率は、時間ごとに監視でき (ju_curr_time)、ジョブごとの最終レコード、配列タスク、または並列タスクは、アカウンティングで使用可能な総使用量を保持します。このレコードの ju_curr_time は sge_job の j_end_time と等しくなります。
|
列
|
タイプ
|
説明
|
|
ju_id
|
Integer
|
一意のレコード識別子
|
|
ju_parent
|
Integer
|
sge_job テーブルへの参照
|
|
ju_curr_time
|
Integer
|
使用量に対する現在の時刻
|
|
ju_qname
|
text
|
ジョブが実行されたキューの名前。N1GE 6.0 システムでは、クラスタキューの名前になります。
キューテーブルのキューを参照します。
|
|
ju_hostname
|
text
|
ジョブが実行されたホストの名前。
ホストテーブルのホストを参照します。
|
|
ju_start_time
|
timestamp
|
ジョブの開始時間。
|
|
ju_end_time
|
timestamp
|
ジョブの終了時間。
|
|
ju_failed
|
integer
|
if != 0 は問題が発生したことを表します
|
|
ju_exit_status
|
integer
|
ジョブの終了状態
|
|
ju_granted_pe
|
text
|
そのジョブ用に選択された並列環境。
|
|
ju_slots
|
integer
|
ジョブに振り分けられたスロットの数。
|
|
ju_state
|
text
|
ジョブの状態
|
|
ju_ru_wallclock
|
integer
|
end_time から start_time を引いた値
|
|
ju_ru_utime
|
double
|
使用されたユーザー時間
|
|
ju_ru_stime
|
double
|
使用されたシステム時間
|
|
ju_ru_maxrss
|
integer
|
最大常駐セットサイズ
|
|
ju_ru_ixrss
|
integer
|
現在は 0
|
|
ju_ru_ismrss
|
integer
|
|
|
ju_ru_idrss
|
integer
|
全体の常駐セットサイズ
|
|
ju_ru_isrss
|
integer
|
現在は 0
|
|
ju_ru_minflt
|
integer
|
物理 I/O を必要としないページフォルト
|
|
ju_ru_majflt
|
integer
|
物理 I/O を必要とするページフォルト
|
|
ju_ru_nswap
|
integer
|
スワップ
|
|
ju_ru_inblock
|
integer
|
ブロック入力操作
|
|
ju_ru_oublock
|
integer
|
ブロック出力操作
|
|
ju_ru_msgsnd
|
integer
|
送信済みメッセージ
|
|
ju_ru_msgrcv
|
integer
|
受信済みメッセージ
|
|
ju_ru_nsignals
|
integer
|
受信済み信号
|
|
ju_ru_nvcsw
|
integer
|
任意コンテキスト切り替え
|
|
ju_ru_nivcsw
|
integer
|
強制コンテキスト切り替え
|
|
ju_cpu
|
double
|
CPU 時間使用量 (秒)。
|
|
ju_mem
|
double
|
全体のメモリー使用量 (G バイト秒)。
|
|
ju_io
|
double
|
I/O 操作で転送されたデータ量。
|
|
ju_iow
|
double
|
I/O 待ち時間 (秒)。
|
|
ju_maxvmem
|
double
|
仮想メモリーの最大サイズ (バイト)。
|
sge_job_request
ジョブの要求に対するリソースを格納します。
現在、2 種類の要求 (qsub オプション) を扱うことができます。
-
-l リソース要求。例: -l arch=solaris,mem_total=100M
各要求に対して 1 つのレコードが作成されます。
-
-q キュー要求。例: -q balrog。q
「キュー」および要求内容を変数として含むレコードが 1 つ作成されます。
|
列
|
タイプ
|
説明
|
|
jr_id
|
Integer
|
一意のレコード識別子
|
|
jr_parent
|
Integer
|
sge_job テーブルへの参照
|
|
jr_variable
|
text
|
要求された複合変数の名前
|
|
jr_value
|
text
|
要求された値
|
sge_job_log
sge_job_log テーブルは、ジョブのログ情報を格納します。
|
列
|
タイプ
|
説明
|
|
jl_id
|
Integer
|
一意のレコード識別子
|
|
jl_parent
|
integer
|
sge_job テーブルへの参照
|
|
jl_time
|
unix timestamp
|
ジョブのログインエントリが生成された時間。
|
|
jl_event
|
text
|
|
|
jl_job_number
|
integer
|
|
|
jl_task_number
|
integer
|
|
|
jl_pe_task_id
|
text
|
|
|
jl_state
|
text
|
報告されたイベント後のジョブの状態
|
|
jl_user
|
text
|
イベントに対して処理を開始したユーザー
|
|
jl_host
|
text
|
イベントの処理を開始したホスト
|
|
jl_state_time
|
unix timestamp
|
ジョブが特定の状態にあった時間。以下の説明を参照。
|
|
jl_message
|
text
|
何が発生したのかを説明するメッセージ
|
sge_share_log
sge_share_log テーブルは、N1GE(EE) 共有ツリーの構成および使用率についての情報を格納します。
詳細は、N1GE の sharetree(5) マニュアルページを参照してください。
|
列
|
タイプ
|
説明
|
|
sl_id
|
Integer
|
共有ログレコードの一意の識別子
|
|
sl_curr_time
|
timestamp
|
現在の時刻
|
|
sl_usage_time
|
timestamp
|
使用時間
|
|
sl_node
|
text
|
共有ツリー内のノード名
|
|
sl_user
|
text
|
ユーザー名 (ジョブの所有者)
ユーザーテーブルを参照します。
|
|
sl_project
|
text
|
プロジェクトの名前
プロジェクトテーブルを参照します。
|
|
sl_shares
|
integer
|
共有ツリーで構成された共有
|
|
sl_job_count
|
integer
|
共有ツリーポリシーとみなされるジョブの数
|
|
sl_level
|
double
|
このツリーレベル内の共有 (%)
|
|
sl_total
|
double
|
共有ツリー全体における共有の合計 (%)
|
|
sl_long_target_share
|
double
|
対象となる長期共有 (%)
|
|
sl_short_target_share
|
double
|
対象となる短期共有 (%)
|
|
sl_actual_share
|
double
|
実際の共有 (%)
|
|
sl_usage
|
double
|
複合的な使用状況。CPU 、メモリー、および I/O のウェイトを構成できます。
|
|
sl_cpu
|
double
|
CPU 使用量 (秒)
|
|
sl_mem
|
double
|
全体のメモリー使用量 (G バイト秒)
|
|
sl_io
|
double
|
I/O 操作で転送されたデータ量。
|
|
sl_ltcpu
|
double
|
長期 CPU
|
|
sl_ltmem
|
double
|
長期メモリー
|
|
sl_ltio
|
double
|
長期 I/O
|
sge_host
sge_host テーブルには、クラスタ内のすべてのホストが一覧表示されます。
|
列
|
タイプ
|
説明
|
|
h_id
|
Integer
|
一意のホスト識別子
|
|
h_hostname
|
text
|
ホスト名。
|
sge_host_values
sge_host_values テーブルは、負荷平均などの変更される可能性のあるホスト変数の値を格納します。
さらに、時間平均や合計などの派生ホスト値も格納されます。
|
列
|
タイプ
|
説明
|
|
hv_hostname
|
text
|
ホストテーブルを参照します。
|
|
hv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
hv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
hv_variable
|
text
|
load_avg などの変数名。
|
|
hv_value
|
text
|
0.34 などの変数値。
|
|
hv_dvalue
|
double precision
|
数値としての変数値。
|
|
hv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
sge_queue
sge_queue テーブルには、クラスタ内で構成されたすべてのキューが一覧表示されます。
|
列
|
タイプ
|
説明
|
|
q_id
|
Integer
|
一意のキュー識別子
|
|
q_qname
|
text
|
キューの名前
|
|
q_hostname
|
text
|
ホストの名前
|
sge_queue_values
sge_queue_values テーブルは、空きスロットの数などの変更される可能性のあるキュー変数の値を格納します。
さらに、時間平均や合計などの派生キュー値も格納されます。
|
列
|
タイプ
|
説明
|
|
qv_parent
|
integer
|
sge_queue テーブルの q_id を参照します。
|
|
qv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
qv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
qv_variable
|
text
|
slots などの変数名。
|
|
qv_value
|
text
|
5 などの変数値。
|
|
qv_dvalue
|
double precision
|
数値としての変数値。
|
|
qv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
sge_department
データベースで参照されるすべての部署が一覧表示されます。
|
列
|
タイプ
|
説明
|
|
d_id
|
Integer
|
一意の部署の識別子
|
|
d_department
|
text
|
部署の名前。
|
テーブル 9: sge_department テーブル
sge_department_values
sge_department_values テーブルは、変更される可能性のある部署関連の変数値を格納します。これらの値は現在、時間平均、合計などの派生値です。
|
列
|
タイプ
|
説明
|
|
dv_parent
|
integer
|
sge_department テーブルの d_id を参照します。
|
|
dv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
dv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
dv_variable
|
text
|
h_sum_jobs などの変数名。
|
|
dv_value
|
text
|
5 などの変数値。
|
|
dv_dvalue
|
double precision
|
数値としての変数値。
|
|
dv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
sge_project
データベースで参照されるすべてのプロジェクトが一覧表示されます。
|
列
|
タイプ
|
説明
|
|
p_id
|
Integer
|
一意のプロジェクト識別子
|
|
p_project
|
text
|
プロジェクトの名前
|
sge_project_values
sge_project_values テーブルは、変更される可能性のあるプロジェクト関連の変数値を格納します。これらの値は現在、時間平均、合計などの派生値です。
|
列
|
タイプ
|
説明
|
|
pv_parent
|
integer
|
sge_queue テーブルの q_id を参照します。
|
|
pv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
pv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
pv_variable
|
text
|
h_avg_cpu などの変数名
|
|
pv_value
|
text
|
345.5 などの変数値
|
|
pv_dvalue
|
double precision
|
数値としての変数値。
|
|
pv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
sge_user
データベースで参照されるすべてのユーザーが一覧表示されます。
|
列
|
タイプ
|
説明
|
|
u_id
|
Integer
|
一意のユーザー ID
|
|
u_user
|
text
|
ユーザーの名前。
|
sge_user_values
sge_user_values テーブルは、変更される可能性のあるユーザー関連の変数値を格納します。これらの値は現在、時間平均、合計などの派生キュー値です。
|
列
|
タイプ
|
説明
|
|
uv_parent
|
integer
|
sge_queue テーブルの q_id を参照します。
|
|
uv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
uv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
uv_variable
|
text
|
h_sum_cpu などの変数名
|
|
uv_value
|
text
|
23.2 などの変数値
|
|
uv_dvalue
|
double precision
|
数値としての変数値。
|
|
uv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
sge_group
データベースで参照されるすべてのユーザーグループが一覧表示されます。
|
列
|
タイプ
|
説明
|
|
g_id
|
Integer
|
一意のグループ ID
|
|
g_group
|
text
|
グループの名前。
|
テーブル 15: sge_group テーブル
sge_group_values
sge_group_values テーブルは、変更される可能性のあるグループ関連の変数値を格納します。これらの値は現在、時間平均、合計などの派生値です。
|
列
|
タイプ
|
説明
|
|
gv_parent
|
integer
|
sge_queue テーブルの q_id を参照します。
|
|
gv_time_start
|
timestamp
|
値の有効期間の開始時。
|
|
gv_time_end
|
timestamp
|
値の有効期間の終了時。
|
|
gv_variable
|
text
|
h_sum_jobs などの変数名。
|
|
gv_value
|
text
|
53 などの変数値
|
|
gv_dvalue
|
double precision
|
数値としての変数値。
|
|
gv_dconfig
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)。
|
定義済みビューのリスト
view_accounting
ジョブ、配列タスク、および緊密に統合されたタスクのアカウンティングレコードです。完了したジョブのみが含まれます。
|
列
|
タイプ
|
説明
|
|
job_number
|
integer
|
ジョブ番号
|
|
task_number
|
integer
|
配列タスクの ID
|
|
pe_taskid
|
text
|
緊密に統合された並列タスクの ID
|
|
name
|
text
|
ジョブの名前 (スクリプト名、または発行オプション -N を使用した値のセット)
|
|
groupname
|
text
|
ジョブが実行された一次グループの UNIX グループ名。グループテーブルを参照します。
|
|
username
|
text
|
ジョブが実行された UNIX ユーザーアカウント。ユーザーテーブルを参照します。
|
|
account
|
text
|
発行オプション -A を使用したアカウントの文字列セット
|
|
project
|
text
|
プロジェクト。プロジェクトテーブルを参照します
|
|
department
|
text
|
部署。部署テーブルを参照します
|
|
submission_time
|
timestamp
|
ジョブ発行の時間
|
|
start_time
|
timestamp
|
ジョブの開始時間
|
|
end_time
|
timestamp
|
ジョブの終了時間
|
|
wallclock_time
|
integer
|
end_time から start_time を引いた値
|
|
cpu
|
double
|
CPU 時間使用量 (秒)
|
|
io
|
double
|
I/O 操作で転送されたデータ量
|
|
iow
|
double
|
I/O 待ち時間 (秒)
|
|
maxvmem
|
double
|
仮想メモリーの最大サイズ (バイト単位)
|
|
wait_time
|
integer
|
start_time から submission_time を引いた値
|
|
turnaround_time
|
integer
|
end_time から submission_time を引いた値
|
view_job_times
view_accounting と同じですが、緊密に統合された並列ジョブのタスクは含まれていません。
view_jobs_completed
時間ごとの完了ジョブ (1 時間につき 1 レコード) が表示されます。
|
列
|
タイプ
|
説明
|
|
completed
|
integer
|
完了ジョブ
|
|
time
|
timestamp
|
ジョブの終了時間
|
view_job_log
ジョブのログ (発行、状態変更、ジョブ終了など) が表示されます。
|
列
|
タイプ
|
説明
|
|
job_number
|
integer
|
ジョブ番号
|
|
task_number
|
integer
|
配列タスクの ID
|
|
pe_taskid
|
text
|
緊密に統合された並列タスクの ID
|
|
name
|
text
|
ジョブの名前 (スクリプト名、または発行オプション -N を使用した値のセット)
|
|
username
|
text
|
ジョブが実行された一次グループの UNIX グループ名。グループテーブルを参照します
|
|
account
|
text
|
ジョブが実行された UNIX ユーザーアカウント。ユーザーテーブルを参照します
|
|
project
|
text
|
プロジェクト。プロジェクトテーブルを参照します
|
|
department
|
text
|
部署。部署テーブルを参照します
|
|
time
|
timestamp
|
ジョブのログエントリが生成された時間
|
|
event
|
text
|
記録されたイベント
|
|
state
|
text
|
報告されたイベント後のジョブの状態
|
|
initiator
|
text
|
イベントに対して処理を開始したユーザー
|
|
host
|
text
|
イベントの処理を開始したホスト
|
|
message
|
text
|
何が発生したのかを説明するメッセージ
|
view_department_values
部署に固有の変数です。
|
列
|
タイプ
|
説明
|
|
department
|
text
|
部署の名前
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
h_sum_jobs などの変数名
|
|
str_value
|
text
|
5 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
view_group_values
グループに固有の変数です。
|
列
|
タイプ
|
説明
|
|
groupname
|
text
|
グループの名前
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
h_sum_jobs などの変数名
|
|
str_value
|
text
|
53 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
view_host_values
ホストに固有の変数です。
|
列
|
タイプ
|
説明
|
|
hostname
|
text
|
ホスト名
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
load_avg などの変数名
|
|
str_value
|
text
|
0.34 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
view_project_values
プロジェクトに固有の変数です。
|
列
|
タイプ
|
説明
|
|
project
|
text
|
プロジェクトの名前
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
h_avg_cpu などの変数名
|
|
str_value
|
text
|
345.5 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
view_queue_values
キューに固有の変数です。
|
列
|
タイプ
|
説明
|
|
qname
|
text
|
キューの名前
|
|
hostname
|
text
|
ホストの名前
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
slots などの変数名
|
|
str_value
|
text
|
5 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
view_user_values
ユーザーに固有の変数です。
|
列
|
タイプ
|
説明
|
|
username
|
text
|
ユーザーの名前
|
|
time_start
|
timestamp
|
値の有効期間の開始時
|
|
time_end
|
timestamp
|
値の有効期間の終了時
|
|
variable
|
text
|
h_sum_cpu などの変数名
|
|
str_value
|
text
|
23.2 などの変数値
|
|
num_value
|
double precision
|
数値としての変数値
|
|
num_config
|
double precision
|
消費可能リソースの場合: 消費可能リソースで使用可能な最大値 (構成した値)
|
派生値のリスト
データベースに格納されている派生値によって、クエリーの処理時間を大幅に短縮できます。レポートデータベースには、時間ごとの集計値 (合計、平均、最小、最大) が含まれます。1 年後といったある程度の期間のあとに、これらの値を、日単位、週単位、月単位などの値にまとめることもできます。
次の派生値が生成されます。
|
表
|
variable
|
説明
|
|
sge_host_values
|
h_sum_cpu、d_sum_cpu、m_sum_cpu
|
ホストごとおよび時間、日、月ごとの CPU 使用量
|
|
sge_user_values
|
h_sum_cpu、d_sum_cpu、m_sum_cpu
|
ユーザーごとおよび時間、日、月ごとの CPU 使用量
|
|
sge_group_values
|
h_sum_cpu、d_sum_cpu、m_sum_cpu
|
グループごとおよび時間、日、月ごとの CPU 使用量
|
|
sge_department_values
|
h_sum_cpu、d_sum_cpu、m_sum_cpu
|
部署ごとおよび時間、日、月ごとの CPU 使用量
|
|
sge_project_values
|
h_sum_cpu、d_sum_cpu、m_sum_cpu
|
プロジェクトごとおよび時間、日、月ごとの CPU 使用量
|
|
sge_host_values
|
h_avg_load
|
ホスト負荷の平均
|
|
sge_host_values
|
h_max_load
|
ホスト負荷の最大
|
|
|
|
|
すべての派生値の生成に関する規則は、構成ファイルで指定できます。