必須属性および任意属性 - Parallel Transporter

この属性を省略すると、デフォルトでデータベースの直接所有者のアカウントIDが設定されます。

デフォルトでは、エラー テーブルがすでに存在する場合はStreamオペレータがエラー メッセージを表示してジョブを終了します。

ジョブの再始動時は、エラー テーブルが存在していても、Streamオペレータがエラー メッセージを表示してジョブを終了することはありません。

これらの基準のいずれかが満たされていないと、デフォルト値は'Off'になり、StreamオペレータはArraySupportを使用しません。

ArraySupportの値が’On’に設定されており、データベースまたはTeradata CLIv2のいずれかで配列サポート機能がサポートされていない場合、Stream オペレータは致命的なエラーで終了します。

ARRAYSUPPORT DMLオプションがジョブのAPPLY文の一部として使用されていると、StreamオペレータのArraySupport属性に指定された値は、DMLの値によって上書きされます。

値の範囲は、下限値が2で、上限値はありません。デフォルト値は3です。割振り可能なリクエスト バッファの最大数は、接続されたセッション数の倍数(Buffers * connected_sessions)になります。

リクエスト バッファはグローバル リソースであるため、バッファは必要に応じてあらゆるセッションに割り当てられ、その後解放プールに戻されます。セッションに割り当てられるリクエスト バッファの数は、どの時点でも、ゼロからBuffers * connected_sessionsの間で変化します。

接続文字列の詳細については、<Teradata® Call-Level Interface Version 2リファレンス - ワークステーション接続システム, B035-2418>を参照してください。

• 'integerDate' = 整数のDATEデータ型(デフォルト)
• 'ansiDate' = ANSI固定長のCHAR(10) DATEデータ型

これ以外の値を指定するとエラーになります。

VARCHAR DropMacro = '<Y[es]|N[o]>'

デフォルトでは、Streamオペレータは、成功したジョブの終了時にマクロを削除します。DropMacroの値がNまたはNoである場合、マクロに対してDROP MACRO文が発行されるまで、そのマクロはデータベースに残ったままです。保持されているマクロは、明示的に削除されるまでデータベースによって維持されるため、使用しなくなったマクロがないか定期的に確認して削除する必要があります。

この数値が概数であるのは、Stream オペレータからデータベースに一度に複数のデータ行が送信されるからです。 エラー制限値を超えたことを示すメッセージをTeradata PTが処理するまでに、エラー制限値に指定された実際の数を上回るレコードがエラー テーブルにロードされている可能性があります。

ErrorLimitには、1以上の値を指定する必要があります。 無効な値を指定すると、Stream オペレータ ジョブは終了します。 デフォルトでは、ErrorLimit値は無制限です。

エラー テーブル名の先頭に修飾子としてデータベース名を付けます。 つまり、大きなサイズのPERM 領域が含まれるデータベースを指定した場合、この方法を使用すると、ロードに関係するテーブルを格納するすべてのデータベースのPERM領域を増やす必要がなくなります。

エラー テーブルのデータベースを指定しない場合、テーブルはユーザー ログオンに関連するデータベースに置かれます。

デフォルトでは、エラー テーブルは新規のテーブルでなければなりません。 このデフォルトは変更可能です。 AppendErrorTable属性を'Yes'または'Y'に設定すると、新規のエラー テーブルも既存のエラー テーブルも使用できるようになります。

Streamオペレータ ジョブを再始動する場合、またはAppendErrorTable属性を'Yes'または'Y'に設定してエラー テーブルを再使用する場合を除き、既存のテーブル名と重複する名前は使用しないでください。

テーブル名を指定しない場合、Spreamオペレータによってテーブル名が作成されます。

ユーザー提供のエラー テーブルの名前は、データベースでテーブル名に許容されている最大長を超えてはいけません。

この値は、LDILoadJobが’Yes’(’Y’)に設定されている場合に必要です。

例えば、LDILoadGroup = ’Grp1’

LogonMechの指定要件については、<Teradata® Parallel Transporterユーザー ガイド, B035-2445>の「ログオン セキュリティ」を参照してください。

再始動ログ テーブルが存在しない場合、Streamオペレータが再始動ログを作成します。 再始動ログ テーブルが存在する場合、Streamオペレータは最後のチェックポイントから再始動します。 再始動ログ テーブルの指定に失敗すると、ジョブが終了されます。

Streamオペレータは、再始動ログ テーブルを自動的に保守します。 再始動ログ テーブルに少しでも手が加えられると、再始動機能は無効になります。

再始動ログ テーブルの名前を完全修飾しない場合、再始動ログ テーブルはユーザーのデフォルト(ログオン)のデータベースに作成されます。 WorkingDatabase属性を使用する場合は、再始動ログ テーブルをデフォルト(ログオン時)のデータベース内に置く予定であっても、再始動ログ テーブルの名前を完全修飾する必要があります。

デフォルトのマクロ データベースは、再始動ログ テーブルのデータベースです。

MaxSessionsには、1以上の値を指定する必要があります。1未満の値を指定すると、ジョブが終了されます。

デフォルトは、オペレータ インスタンスごとに1セッションです。

メイン インスタンスが、インスタンスの数からStreamオペレータ セッションの均等配分を割り出します。 例えば、4つのインスタンスと16個のStreamオペレータ セッションがある場合、各インスタンスは4つのStreamオペレータ セッションにログオンします。

MinSessionsには、1以上およびStreamオペレータの最大セッション数以下の値を指定する必要があります。 1未満の値を指定すると、ジョブが終了されます。

デフォルトは1です。

• libnotfyext.dll for Windows platforms
• Apple macOSプラットフォームの場合、libnotfyext.dylib
• libnotfyext.so for all other UNIX platforms
• NOTFYEXT for z/OS platforms

独自の通知出口ルーチンを指定する方法については、非推奨の構文を参照してください。

• 'Off' = イベントの通知は実行されません(デフォルト)。
• 'Low' = 通知レベル「低」の欄に「あり」と表示されているイベントが通知されます。
• 'Med' = 通知レベル「中」の欄に「あり」と表示されているイベントが通知されます。
• 'High' = 通知レベル「高」の欄に「あり」と表示されているイベントが通知されます。
• "Ultra’ = 通知レベル「超」の欄に「あり」と表示されているイベントが通知されます。

• 'None' = イベントをログに記録しません(デフォルト)。
• 'Msg' = イベントをログに送ります。

  Windowsの場合、イベントはイベント ビューアで閲覧できるイベント ログに送られます。 メッセージはアプリケーション ログに送られます。

  Solaris、AIX、およびLinuxの各プラットフォームの場合、イベントの送り先は/etc/syslog.confファイルで指定された設定値に依存します。

  SLES11の場合、イベントの送り先は/etc/syslog-ng.confファイルで指定された設定値に依存します。

  z/OSシステムの場合、イベントはジョブ ログに送られます。

• 'Exit' = イベントをユーザー定義の通知出口ルーチンに送ります。 行カウント情報は、4バイトの符号無し整数値になります。
• 'Exit64' = イベントをユーザー定義の通知出口ルーチンに送ります。 行カウント情報は、次のイベントについては、8バイトの符号無し整数値になります。

  NMEventCkptBeg64

  NMEventCkptEnd64

  NMEventErrorTable64

  NMEventRunStats64

  NMEventImportEnd64

• 'ExitEON' = イベントをユーザー定義の通知出口ルーチンに送ります。

  完全なTeradataオブジェクト名が、NMEventInitializeEONイベントの通知出口ルーチンに渡されます。

  また、ExitEONから8バイトの符号なし整数値の形式で行カウント情報が送信されます。

• NotifyMethodが'Exit'の場合、80バイト
• NotifyMethodが'Msg'の場合、16バイト

APPLY指定内のオペレータの各コピーに対して、Teradata PTは、<operator object name> + <process Id>によって構成されるOperatorCommandIdのデフォルト値を生成します。 別の識別子を割り当てる必要がある場合は、以下のことを実行します。

Streamオペレータに対するDEFINE OPERATOR文内でoperatorCommandID属性を宣言します。

任意選択で、Streamオペレータの参照されたコピー内(APPLY文内)でOperatorCommandID属性に値を割り当てることができます。 値が割り当てられていない場合、Teradata PTはシステム生成値を提供します。 以下のように、レート値の変更が必要なジョブ ステップの番号をOperatorCommandIDの値として指定することが有用になる場合があります。

APPLY <dml1> TO OPERATOR ( Stream_Oper[2] ATTRIBUTES ( OperatorCommandID = ‘ratestep#1’)),
APPLY <dml2> TO OPERATOR ( Stream_Oper[3] ATTRIBUTES ( OperatorCommandID = ‘ratestep#2’)),

twbcmdユーティリティを使用して、特定のStreamオペレータのコピーにレートの値を割り当てます。

twbcmdユーティリティを使用したレート値の変更については、twbcmdを参照してください。

• 'No' ('N') = パックなし(デフォルト)
• 'Yes'('Y')= 最大可能パック係数を決定します。

例えば、次のように指定します。 ステートメントのレートが1600でRate値が10の場合、処理されるステートメントの最大数は、6(60/10)秒ごとに160(1600/10)ステートメントとなります。

プライベート ログは、tlogviewコマンドを次のように使用すると表示できます。ここで、jobIdはTeradata PTのジョブ名を、privateLogNameはStream オペレータのPrivateLogName属性の値を示します。

tlogview -j jobid -f privatelogname

プライベート ログを指定しない場合、出力はすべてパブリック ログに格納されます。

デフォルトでは、診断トレース メッセージは生成されません。 診断トレース メッセージは、ユーザーがTraceLevel属性に有効な値を設定している場合にのみ生成されます。

tlogviewコマンドの詳細については、Teradata PTユーティリティのコマンドを参照してください。

queryBandExpressionは、セミコロンで区切られ、セミコロンで終了する、名前=値ペアのセットです。 ユーザーは、下記の例のようなクエリー バンド式を定義します。

‘org=Finance;load=daily;location=west;’

QueryBandSessInfoは、ARRAY属性として指定することもできます。

クエリー バンド式の作成規則については、Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144およびTeradata Vantage™ - SQLデータ定義言語 - 詳細トピック, B035-1184を参照してください。

QueryBandSessInfo属性の値は、Streamオペレータのプライベート ログに表示されます。

この属性は、Streamストリームと、Streamオペレータ内のエラー テーブルに固有なものです。 この属性は、SELECTおよびCONSUMEデータベース オペレーション(行を返してそれを削除する)を使用しているときに発生したエラーを取得する際に特に便利です。 エラー テーブルをキュー テーブルとして使用することで、エラー テーブル内の行を削除する手間を省くことができます。

詳細については、<Teradata Replication Services Using Oracle GoldenGate>を参照してください。

「堅固動作モード」では、リクエストが発行されるたびに1つのデータベース行が再始動ログ テーブルに書き込まれます。 再始動ログ テーブルにおけるこの行の集まりは、リクエスト ログと呼ぶことができます。リクエストは完全に終了するか完全にロールバックするかのどちらかであることがデータベースによって保証されているため、リクエスト ログには常にインポートの完了ステータスが正確に反映されます。

堅固動作再始動ロジックを使用するかどうかが確かでない場合は、Robustパラメータを'Yes'に設定すると常に安全を確保できます。

データベースにセキュリティを実装する任意の属性。オペレータの先頭には、"SET ROLE"の値が付加されます。構文は、次のようにデータベースに送信されます。

SET ROLE <role name>;

例:

SET ROLE All;

"SET ROLE"コマンドの使用の詳細については、<Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144>を参照してください。

VARCHAR ARRAYを使用すると、複数の値を指定できます。以下に例を示します。

VARCHAR ARRAY RoleName = ['role name1', 'role name2'],

セッションが接続されると、オペレータはメイン コントロール セッションとデータSQLセッションでデータベースにリクエストを送信します。

dbcNameは、最大256文字まで指定でき、ドメイン サーバー名を1つ指定できます。

TdpId属性に対して値を指定しない場合、オペレータは、システム管理者がユーザー用に設定したデフォルトのTdpIDを使用します。

デフォルト値は4時間です。 Tenacity機能を有効にするためには、hoursに０以上の値を指定する必要があります。 0を指定すると、Tenacity機能は無効になります。 0未満の値を指定すると、Streamオペレータ ジョブが終了されます。

分数には0以上の値を指定する必要があります。1未満の値を指定すると、Stream オペレータはエラー メッセージを返してジョブを終了します。デフォルトは6分間です。

この属性の値を指定すると、オペレータはSET TIME ZONE <timeZoneValue>; SQLリクエストを作成します。

セッションが接続されると、オペレータはメイン コントロール セッションとデータSQLセッションでデータベースにリクエストを送信します。

SET TIME ZONE SQLについて詳しくは、Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144を参照してください。

• 'None' = トレース機能を無効にします(デフォルト)。
• ’CLI’ = CLIに関連するアクティビティ(データベースとの対話)についてのトレース機能を有効にします。
• 'PX' = Teradata PTインフラストラクチャに関連するアクティビティについてのトレース機能を有効にします。
• 'Oper' = オペレータ固有のアクティビティについてのトレース機能を有効にします。
• 'Notify' = 通知機能に関連するアクティビティについてトレース機能を有効にします。
• 'All' = 上記すべてのアクティビティについてのトレース機能を有効にします。

VARCHAR ARRAYを使用すると、複数の値を指定できます。以下に例を示します。

VARCHAR TraceLevel = 'CLI'
VARCHAR TraceLevel = 'OPER'
VARCHAR ARRAY TraceLevel = [ 'CLI' ]
VARCHAR ARRAY TraceLevel = [ 'CLI', 'OPER' ]

SET TRANSFORM GROUP FOR TYPE <udt name> <transform group name>;

"SET TRANSFORM GROUP FOR TYPE JSON CHARACTER SET LATIN TD_JSON_VARCHAR;"

VARCHAR ARRAY TransformGroup = ['JSON CHARACTER SET LATIN TD_JSON_VARCHAR', 'ST_GEOMETRY TD_GEO_VARCHAR'],

セッションが接続されると、オペレータはメイン コントロール セッションとデータSQLセッションでデータベースにリクエストを送信します。