17.00 - 17.05 - tdr.Read - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
17.05
Published
2020年6月
Content Type
プログラミング リファレンス
Publication ID
B035-1147-170K-JPN
Language
日本語 (日本)

目的

入力ストリームから行を読み取ります。

構文

tdr.Read(  handle  )
handle
パラメータ型: raw vector

tdr.Open関数によって返される入力ストリームのハンドル。

戻り値

以下のいずれかの結果を示す整数。

戻りコード 説明
0 処理は正常に終了しました。
-1 ストリームの最後に到達しました。
-2 テーブル演算子が中止されました。
-3 入力されたパラメータが無効な型です。
-4 入力されたパラメータが無効な値です。
-5 この関数はコントラクト関数内で呼び出されました。

使用上の注意

この関数を呼び出す前に、tdr.Open関数を呼び出して入力ストリームをオープンする必要があります。次にtdr.Openからこの関数の引数として返されたハンドルを渡します。

この関数は、テーブル演算子から呼び出された場合にのみ有効です。

例: 入力ストリームからの行の読み取り

この例では、入力ストリームをオープンし、入力ストリームから正常に読み取られた行数をカウントします。

# 入力ストリームをオープン。
library(tdr);
stream <- 0;
options <- 0;
direction <- "R";
inHandle <- tdr.Open(direction, stream, options);

# 入力ストリームから行を読み取ります。

nrrows <- 0;
while (tdr.Read(inHandle) == 0) {
  nrrows <- nrrows+1;
}