SAP テーブルデータの取得方法として、ページ単位の取得またはストリーミング取得のいずれかを選択します。

Possible Values

default, stream

データ型

string

デフォルト値

"default"

解説

次のいずれかの読み取りモードを選択します。

• default（デフォルト）: 各ページに対して独立した読み取りを実行し、テーブル全体をページ単位で取得します。
• stream: 単一のストリーミング読み取りを介してテーブルデータを取得します。SAP ERP はコールバックを通じて後続のバッチを送信し、読み取りが進行中の間、本製品 は到着した行を結果セットに追加していきます。

ストリーミングを使用すると、ページごとに読み取りを繰り返す必要がなくなり、本製品 が結果全体をメモリに保持する必要もなくなるため、大規模なテーブルに対するクエリの実行時間とメモリ消費量を削減できます。

この接続プロパティのみで、増分レプリケーションを含め、読み取りモードが決まります。いずれのモードでも、ReadTableFunction は、本製品 がデータの読み取りに使用する関数モジュールの名前を指定します。

1 つの接続は単一の関数モジュールを介して読み取りを行うため、ReadTableFunction が解決する関数モジュールは、メタデータの参照やSELECT COUNT(*) クエリを含め、その接続上のすべての読み取りに使用されます。

要件

この接続プロパティをstream に設定する前に、お使いの環境が次の両方の要件を満たしていることを確認してください。

• 接続先のSAP ERP システムに、カスタム関数モジュールZ_STREAM_READ_TABLE がインストールされ、有効化されていること。本製品 には、この関数モジュールのソースがインストールディレクトリの"db" サブフォルダーに含まれています。このモジュールは顧客側でインストールするものであるため、お使いのSAP ERP 管理者が、カスタム関数モジュールの命名規則に従って、たとえばZCDATA_STREAM_READ_TABLE や/CDATA/STREAM_READ_TABLE のような名前空間付きの名前を付けている場合があります。インストールされている名前がZ_STREAM_READ_TABLE であっても、ReadTableFunction には明示的にその名前を設定してください。このプロパティがstream に設定されている場合、本製品 は、設定された関数モジュールがCALLBACK_FM インポートパラメーターを公開していることを検証し、このパラメーターが存在しない場合はその関数モジュールを拒否します。
• 接続でサポートされているRFC ライブラリが使用されていること。ストリーミングはClassic、Classic_Unicode、NetWeaver、およびJCo の各接続でサポートされていますが、Soap ではサポートされていません。

接続でSAP Java Connector (JCo) を使用する場合は、CallBackProgramID およびCallBackDestination も設定してください。この要件は、Java ベースの展開でConnectionType がClassic、Classic_Unicode、またはNetWeaver に設定されている場合にも適用されます。SAP SM59 の設定要件および同時接続に関する制限については、CallBackDestination を参照してください。

"db" サブフォルダーには、ABAP リリースの範囲ごとに異なるZ_STREAM_READ_TABLE の3 つのバリアントが含まれています。1 つは7.50 より前のリリース用、1 つは7.50 および7.51 用、もう1 つは7.52 以降用です。3 つのバリアントはすべて同じ関数名と同じインターフェースを宣言しているため、お使いのSAP ERP システムのABAP リリースに一致するバリアントのみをインストールしてください。