nzudxrunharness コマンド

シミュレーション・テスト環境内で、ユーザー定義関数またはユーザー定義集約を実行します。このハーネスでは、オブジェクトのメモリー使用率に関する情報が表示され、UDF/UDA の呼び出し時にバッファー上書きを検出することもできます。このコマンドは、標準出力およびオプションで標準ログ・ファイルに対するメッセージを表示します。このコマンドを実行するには、nz ユーザーとしてログインする必要があります。

このコマンドの構文は、以下のとおりです。

nzudxrunharness [OPTION]...

次の表では、コマンドの任意のインスタンスで使用できるオプションについて説明します。

表 1. nzudxrunharness 汎用オプション
オプション	説明
--ディレクトリ `データディレクトリ`	データ・ディレクトリーの場所を指定します。通常は、/nz/data です。
--ベース `ベース`	Netezza Performance Server・ソフトウェアのベース・ディレクトリまたはホーム・ディレクトリを指定します。デフォルトは /nz/kit です。
--ユーザー `ユーザー`	このコマンドを実行するNetezza Performance Serverデータベース・ユーザーを指定します。ユーザーは、管理者であるか、UDX があるターゲット・データベースを所有するユーザーでなければなりません。デフォルトは NZ_USER の値です。
--pw `パスワード`	Netezza Performance Serverのユーザー・パスワードを指定します。デフォルトは NZ_PASSWORD の値です。
--データベース `データベース`	UDX を実行するデータベースを指定します。デフォルトは NZ_DATABASE 環境変数値です。
--スキーマ `スキーマ`	UDX を実行するスキーマを指定します。デフォルトは NZ_SCHEMA 環境変数値です。
-h	コマンドの使用量を表示します。

次の表では、コマンドの入力ファイルを指定するために使用するオプションについて説明します。

表 2. nzudxrunharness 入力ファイル・オプション
オプション	説明
--ファイル `テストファイル`	テスト・データ・ファイルのパス名を指定します。列は、引数に関して予期される順序で、コンマ (,) で区切って指定する必要があります。
--グループ `コル`	(集約のための) グループ分けに使用するテスト・データ・ファイル内の列番号を指定します。テスト・データ・ファイルは、既にグループ化されていなければなりません。
--sep `セパレータ`	テスト・ファイル内で区切り文字として使用される文字を指定します。デフォルトはコンマ (,) です。
--エスケープ `エスケープ`	テスト・ファイルで使用するエスケープ文字を指定します。デフォルトはありません。
--引用	テスト・ファイルで二重引用符を使用します。
--ヘキサン入力	ファイル内のデータが 16 進入力データであることを指定します。
--生成する	制御ファイルを生成しますが、ハーネスは実行しません。詳細については、テストハーネスの制御ファイルを参照してください。

次の表では、コマンドのその他のランダム入力オプションについて説明します。

テーブル3。 nzudxrunharness ランダム入力オプション
オプション	説明
--列 `行`	シミュレートする行数を指定します。デフォルトは 100 です。
--グループ `グループ`	シミュレートするグループ数を指定します。デフォルトは 5 です。
--ナル `ヌルス`	NULL 引数を指定します。値はコロンで区切られたフィールド番号のストリングとして指定します (例: 1:2:3:5)。デフォルトは非 NULL です。

次の表では、コマンド出力オプションについて説明します。

テーブル4。 nzudxrunharness 出力オプション
オプション	説明
--プリント	戻り値をプリントします。
--ヘックス	戻り値を、16 進形式のストリングでプリントします。
--ノバリデート	バッファー・オーバーランの検証ステップをスキップします。 (検証なしで実行すると、ハーネスの実行速度が向上します。)
--デシベル	デバッガーを始動します。

次の表では、テストする UDX を指定するオプションについて説明します。

テーブル5。 nzudxrunharness UDX オプション
オプション	説明
--名前 `名称`	関数または集約の名前を指定します。関数や集約の名前は、一意の名前であればそのまま指定することも、`func`(`return`) のように完全なシグニチャーを使用することもできます。
--ファンク	関数で作動します (デフォルト)。
--アグ	集約で作動します。

次の表では、定義した UDX 値をオーバーライドするために使用するオプションについて説明します。

テーブル6。 nzudxrunharness UDX オーバーライド・オプション
オプション	説明
--マスクNONE、DEBUG、TRACE	マスク・オーバーライドのロギングを指定します。有効な値は NONE、DEBUG、または TRACE です。 DEBUG、TRACE のコンマ区切りの組み合わせを指定して、両方のタイプのメッセージをログに記録することも指定できます。
--オーバー `オーバーライド`	ストリング列サイズのオーバーライドを指定します。値は 1-40:2-400 として指定され、最初の数値は列 (1 ベース) です。 2 番目の数値は文字サイズ (バイト・サイズではない) です。
--バーグ `コルス`	VARARGS UDX の引数情報を指定します。値は、コロンで区切った一連のタイプとして指定できます。例 : `VARCHAR(100):NUMERIC(10,3):INT4`
--フェンス	ハーネスを fenced モードで実行します。この設定は、データベース内の UDX に定義されたフェンス設定をオーバーライドします。
--フェンスなし	ハーネスを unfenced モードで実行します。この設定は、データベース内の UDX に定義されたフェンス設定をオーバーライドします。
--オブジェクト `ファイル`	データベース内の UDX に指定されたオブジェクト・ファイルの代わりに使用するオブジェクト・ファイルを指定します。ライブラリー・オブジェクト・ファイルの場所に必要である可能性があるので、--data オプションを --object オプションと共に使用することもできます。
--閉じる	dlopen()で利用可能になったUNIX共有ライブラリへの参照を閉じるために、テストハーネスがCライブラリ関数'dlclose()を呼び出さないことを指定する。テスト・ハーネスは、デフォルトで dlclose() を呼び出します。 valgrind や callgrind などのデバッグ・ツールを使用してテスト・ハーネスを実行している場合、このオプションを指定して、ハーネスが自動的に dlclose() を呼び出さないようにします。これにより、デバッグで使用できるシンボル名およびその他の値にアクセスできるようになります。ただし、これは dlclose() が呼び出された後に使用できなくなる可能性があります。 (valgrind デバッグ環境について詳しくは、http://valgrind.org を参照してください)。
--ファイナル	ユーザー定義表関数の場合、TABLE WITH FINAL の振る舞いを使用して表関数を呼び出します。

テスト・ハーネスは、提供されるデータ・ファイルを使用する、または --rows、--groups、および --nulls フラグに基づきランダム・データを作成することにより、指定された UDX を実行します。 --nulls フラグを使用すると、指定された列は時間中の約 50% は NULL になります。また、ランダム・データを使用している場合、ストリングは引数シグニチャーまたは --over で指定されたオーバーライドのいずれかに基づいて、最大容量まで埋め込まれます。提供されたデータ・ファイルの使用は、アルゴリズムの正しさをテストする最適な方法です。

--mask フラグを使用すると、logMsg 呼び出しの結果が表示されます。 --print フラグおよび --hex フラグは、評価または performFinalResult の結果を表示します。ハーネスは、オブジェクト・ファイル内で検出される外部ルーチンもプリントします。 --dbg フラグは、実際のオブジェクトをデバッグできるように、デバッガーを呼び出します。デバッガーを使用する場合、UDX のホスト・オブジェクト・ファイルがデバッグ・シンボルでコンパイルされていることを確認します。 (通常は、この代わりに最適化モードを使用してコンパイルします。)

データファイルでは、intervalやtimetzのように複数の情報を持つタイプは、コロン（:）で区切られたフィールドを持たなければならない。ヌルは<NULL>で指定できる。