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

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

出力バッファ サイズとLoadテーブル内の行のサイズによって、データベースに送信する各パーセルの最大行数が決まります。 大きなバッファ サイズを指定すると、各パーセルに格納できるデータが増えるため、処理のオーバーヘッドを軽減できます。

有効値は1～16384です。ただし、16384を指定した場合、実際のバッファ サイズは16775552バイトとなるため、16MBより少なくなります。 1未満の値を指定すると、エラー メッセージが表示され、ジョブが終了されます。

オペレータがTeradata Database 16.00以降と通信している場合、デフォルトのバッファ サイズは1024KBです。

オペレータが16.00よりも前のバージョンのTeradata Databaseと通信している場合、デフォルトのバッファ サイズは64KBです。

指定可能な最大のバッファ サイズは、通常、16384KBです。値はデータベースへの接続時に検証されます。

バッファ サイズに最大値を超える値を指定した場合、オペレータはその値を指定可能な最大サイズまで減らします。

この属性は、TPTスクリプトモードでのみ使用できます。

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

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

ErrorLimitには0より大きい値を指定する必要があります。 無効な値を指定すると、Loadオペレータはジョブを終了します。 デフォルトでは、ErrorLimit値は無制限です。

ErrorLimit値はLoadオペレータの各インスタンスに適用されます。

• データ変換エラー
• 制約違反
• AMP構成の変更

以上のエラーは、Loadオペレータ ジョブの取得フェーズで常に発生します。

ErrorTable1には、新しいテーブル名を指定する必要があります。 一時停止したLoadオペレータ ジョブを再始動する場合を除き、既存のテーブル名と重複する名前は使用しないでください。

ErrorTable1のデフォルトの名前はttname_ETです。

詳細については、ErrorTable1およびエラー テーブルの自動生成を参照してください。

ErrorTable2には、新しいテーブル名を指定する必要があります。 Loadオペレータ ジョブを再始動する場合を除き、既存のテーブル名と重複する名前は使用しないでください。

ErrorTable2のデフォルトの名前はttname_UVです。

詳細については、ErrorTable2およびエラー テーブルの自動生成を参照してください。

新しいジョブを実行する場合、新しいテーブル名には、既存のテーブル名とは異なる名前を指定してください。 これにより、Loadオペレータは新しい再始動ログ テーブルを作成します。

一時停止したジョブを再始動する場合、再始動ログ テーブルが存在する必要があります。Loadオペレータは最後のチェックポイントからジョブを再始動します。 再始動したジョブでは、引き続き既存の再始動ログ テーブルを使用します。

ジョブが正常に完了すると、オペレータは再始動ログ テーブルを削除します。 再始動ログ テーブルの指定に失敗すると、ジョブが終了されます。

ユーザーは、さらに、再始動ログ テーブルを格納するデータベースに対してのDROP権限とCREATE権限を持っている必要があります。

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

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

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

デフォルトは、使用可能なAMPごとに1セッションです。最大値は、使用可能なAMP数を超えることはできません。

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

• Windowsプラットフォームの場合、libnotfyext.dll
• Apple macOSプラットフォームの場合、libnotfyext.dylib
• 他のすべてのUNIXプラットフォームの場合、libnotfyext.so
• z/OSプラットフォームの場合、NOTFYEXT

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

• 'Yes' (または'Y') = 通知出口ルーチンをDLLとして構築します(デフォルト)。
• 'No' (または'N') = 通知出口ルーチンをDLLとして構築しません。

他の値を指定すると、ジョブが終了します。

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

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

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

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

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

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

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

  NFEventCheckPoint64

  NFEventPhaseIEnd64

  NFEventPhaseIIEnd64

  NFEventDropErrTableI64

  NFEventDropErrTableII64

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

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

  NFEventInitializeEON

  NFEventPhaseIBeginEON

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

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

• Loadオペレータの通常のジョブの場合は、'N[o]'。通常のジョブでは、取得フェーズ中にデータベースに送られたすべての行がAMP上の最終的な宛先に分散されます(デフォルト)。
• 取得フェーズの完了後に一時停止し、適用フェーズをスキップする場合は、'Y[es]'。

その他の値を指定すると、ジョブが終了されます。

PauseAcq属性値を指定しないと、Loadオペレータは取得フェーズが完了しても、一時停止せずに適用フェーズに移行します。 その結果、取得フェーズでデータベースに送信された全行がAMP上のターゲット テーブルに挿入されます。

プライベート ログは、tlogviewコマンドを次のように使用すると表示できます。ここで、jobIdはTeradata PTのジョブ名を、privateLogNameはオペレータの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属性の値は、Loadオペレータのプライベート ログに表示されます。

データベース環境にセキュリティを実装する任意の属性。オペレータの先頭には、"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セッションのデータベースにリクエストを送信します。

データベースはFastLoadプロトコル セッションでのリクエスト送信を許可していないので、オペレータはFastLoadプロトコル セッションでリクエストを送信しません。

ターゲット テーブルは、Loadジョブを実行する前にすでにデータベースに存在し、セカンダリ インデックスや結合インデックスが定義されていない空の状態である必要があります。 一時停止したLoadオペレータのジョブを再始動する場合を除き、既存のテーブル名は指定できません。

NoPIとして定義されたターゲット テーブルの場合は、ターゲット テーブルが空でなければならないという制限は適用されません。

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

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

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

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

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

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

データベースはFastLoadプロトコル セッションでのリクエスト送信を許可していないので、オペレータはFastLoadプロトコル セッションでリクエストを送信しません。

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セッションは不要であるため、オペレータは補助SQLセッションではリクエストを送信しません。

データベースはFastLoadプロトコル セッションでのリクエスト送信を許可していないので、オペレータはFastLoadプロトコル セッションでリクエストを送信しません。

列にユーザー定義型(UDT)が含まれる場合、この属性を使用すると、テーブル内の列をすべてロードできます。

この属性をYesに設定しても、完全にサポートされた有効なINSERT文がすでに存在する場合はエラーとなります。

有効なtableNameはTargetTable属性で使用されているテーブルの名前に一致し、指定するDML文では次のように最後の空白以外の文字はセミコロンです。

INS[ERT] [INTO] <tablename> ;