目的
Get Rowは、データ行を抽出するサービス関数です。
構造
#include <pxoper.h> PXSTC_Code PX_GetRow(PX_TableSchemaHandle tableSchemaHandle, PX_Count * columnCount, PX_Indicator ** nullIndicator, PX_ByteOffset ** offsets, PX_Length ** lengths, PX_Addr * rowAddr, PX_Length * rowLength);
次のような場合に当てはまります。
| パラメータ | 機能 | 指定 |
|---|---|---|
| columnCount | 出力 | データ行に関連する列数へのポインタ |
| lengths | 出力 | 対応する列値の長さを表わす整数配列へのポインタ |
| nullIndicator | 出力 | 対応する列値がNULLかどうかを示す標識バイトの配列へのポインタ |
| offsets | 出力 | 対応する列位置をデータ行の先頭からのバイト数で示した整数配列へのポインタ |
| rowAddr | 出力 | データ行のアドレスへのポインタ |
| rowLength | 出力 | データ行の長さへのポインタ |
| tableSchemaHandle | 入力 | データ行の取得先となるテーブル スキーマ ハンドル |
戻りコード
以下のGet Row関数のステータス コードは、Teradata PTオペレータ インターフェースによって定義されます。
| ステータス コード | 意味 |
|---|---|
| PXSTC_BadHandle | 未定義のデータ スキーマ ハンドル |
| PXSTC_Success | データ行の抽出の成功 |
| PXSTC_EndOfData | データの終わり |
使用上の注意
Get Row関数を定義する場合の注意事項は、以下を考慮してください。
| 対象 | 使用上の注意 |
|---|---|
| 戻りデータの形式 | Get Row関数によって返されるデータ行には、常に、NULL標識バイトの接頭辞が付けられています。 |
| ステータス | 関数ステータスがPXSTC_Successの場合:
|
| 関連項目 |