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

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

• 'None' = クラスタ内で停止したAMPが1台未満のみの場合に限り、Updateジョブの開始、再始動、または続行を許可します。
• 'Apply' = AMPが停止した場合、Updateオペレータ ジョブが適用フェーズに移行すること、または適用フェーズを終了することを禁止します(デフォルト)。
• 'All' = AMPが停止した場合、Updateオペレータ ジョブを一時停止します。

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

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

デフォルトのバッファ サイズは1024Kbytesです。 指定可能な最大のバッファ サイズは、通常、16384KBです。 値はTeradata Databaseへの接続時に検証されます。

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

CheckpointRowCount値は次のとおりです。

• ’No’ (’No’) = Updateオペレータは、チェックポイントで送信された行を出力しません(デフォルト)。
• ’Yes’ (’Y’) = Updateオペレータは、チェックポイントで送信された行を出力します。

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

有効な値は次のとおりです。

• ’On’ = すべてのSQLリクエスト、応答、およびデータが暗号化されます。
• ’Off’ = 暗号化されません(デフォルト)。

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

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

指定可能なオプションは次のとおりです。

• 'Yes' (または'Y') = DELETEタスクを実行します。DELETEタスクでは、APPLYステートメントの中でのSELECTセクションの有無に基づいて、行を取得するかどうかを判断します。
• 'No' (または'N') = DELETEタスクを実行しません(デフォルト)。

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

値を何も指定しない場合は、'NO'値を指定したことになります。その場合、UpdateオペレータはIMPORTタスクを実行します。上記のルールは何も適用されません。

DeleteTask属性処理を有効にした場合、影響を受けるのは次の任意の属性のみです。

• TenacityHours
• TenacitySleep
• AmpCheck

有効な値は次のとおりです。

• ’Yes’ = Updateオペレータはエラー テーブルが空の場合にのみ削除します(デフォルト)。Teradata PTはDROP TABLE文を自動的に実行します。

  多数の更新ジョブを定期的に実行する場合は、’Yes’を指定すると、データ ディクショナリに対して多数の更新が実行され、結果として性能問題が発生します。

• ’No’ = Updateオペレータはエラー テーブルが空の場合でも削除しません。 ユーザーがエラー テーブルに対して手動でDROP TABLE文を実行する必要があります。


  テーブルが削除されていない状態で、同じ名前のテーブルを使用するTeradata PTジョブを実行すると、DBSエラーが発生するか、予測不能な結果が生じる可能性があります。

有効な値は次のとおりです。

• ’Yes’ = Updateオペレータは再始動ログ テーブルを削除します(デフォルト)。Teradata PTはDROP TABLE文を自動的に実行します。

  多数の更新ジョブを定期的に実行する場合は、’Yes’を指定すると、データ ディクショナリに対して多数の更新が実行され、結果として性能問題が発生します。

• ’No’ = Updateオペレータは再始動ログ テーブルを削除しません。 ユーザーが再始動ログ テーブルに対して手動でDROP TABLE文を実行する必要があります。

  テーブルが削除されていない状態で、同じ名前のテーブルを使用するTeradata PTジョブを実行すると、DBSエラーが発生するか、予測不能な結果が生じる可能性があります。

有効な値は次のとおりです。

• ’Yes’ = Updateオペレータは作業テーブルを削除します(デフォルト)。Teradata PTはDROP TABLE文を自動的に実行します。

  多数の更新ジョブを定期的に実行する場合は、’Yes’を指定すると、データ ディクショナリに対して多数の更新が実行され、結果として性能問題が発生します。

• ’No’ = Updateオペレータは作業テーブルを削除しません。 ユーザーが作業テーブルに対して手動でDROP TABLE文を実行する必要があります。

  テーブルが削除されていない状態で、同じ名前のテーブルを使用するTeradata PTジョブを実行すると、DBSエラーが発生するか、予測不能な結果が生じる可能性があります。

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

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

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

このテーブルには、新しい名前を指定する必要があります。 一時停止したUpdateオペレータ ジョブを再始動する場合を除き、既存のテーブル名は指定できません。

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

有効なオプションは次のとおりです。

• 'Yes' = すべてのSQLをログに出力します。 最大長は1Mです。
• 'No' = SQLをログに出力しません。
• 値なし、または属性指定の除外時は、事前定義の制限を使用します。最大32KのSQLを表示します(SQL全体が32K未満の場合)。 ログ対象のSQLが32Kを超える場合は、表示が最初の32KBに切り捨てられます。

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

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

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

再始動ログ テーブルで必要とされる権限は次のとおりです。

• SELECT
• INSERT
• DELETE

再始動ログ テーブルを含むデータベースで必要とされる権限は以下のとおりです。

• DROP
• CREATE

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

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

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

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

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

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

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

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

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

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

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

• 'None' = イベントをログに記録しません(デフォルト)。
• 'Msg' = イベントをログに送ります。
  • Windowsの場合、イベントはイベント ビューアで閲覧できるイベント ログに送られます。 メッセージはアプリケーション ログに送られます。
  • Solaris、AIX、およびHP-UXの各プラットフォームの場合、イベントの送り先は/etc/syslog.confファイルで指定された設定値に依存します。
  • SLES11の場合、イベントの送り先は/etc/syslog-ng.confファイルで指定された設定値に依存します。
  • z/OSシステムの場合、イベントはジョブ ログに送られます。
• 'Exit' = イベントをユーザー定義の通知出口ルーチンに送ります。 行カウント情報は、4バイトの符号無し整数値になります。
• 'Exit64' = イベントをユーザー定義の通知出口ルーチンに送ります。 行カウント情報は、次のイベントについては、8バイトの符号無し整数値になります。
  • NMEventCheckPoint64
  • NMEventPhaseIEnd64
  • NMEventImportEnd64
  • NMEventPhaseIIEnd64
  • NMEventErrorTableI64
  • NMEventErrorTableII64
• 'ExitEON' = イベントをユーザー定義の通知出口ルーチンに送ります。

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

  • NMEventInitializeEON
  • NMEventPhaseBeginEON
  • NMEventDeletesBeginEON

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

文字列の最大長は次のとおりです。

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

有効値は1～16383で、デフォルト値は16383です。

PACK係数は、このジョブが拡張MultiLoadプロトコルを使用するときにのみ適用されます。

PACK係数は、Array Insert文で含めることになるデータ レコード数を、Updateオペレータに通知します。 Array Insert文は、このジョブの取得フェーズ中にTeradata Databaseに送信されます。

• 'Yes' (または'Y') = Updateオペレータ ジョブを取得フェーズ後に一時停止します。
• 'No'(または'N')= 一時停止しません(デフォルト)。

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

PauseAcq属性値を指定しないと、Updateオペレータは取得フェーズが完了しても一時停止せずに、適用フェーズに移行します。

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

tlogview -j jobid -f privatelogname

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

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

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

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

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

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

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

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

QueryBandSessInfo属性の使用には、以下の規則が適用されます。

• デフォルトでは、QueryBandSessInfo属性に有効な値が指定されるまで、クエリー バンドはオフになります。
• QueryBandSessInfo属性に値が含まれている場合、Updateオペレータは、必要なSET QUERY BAND SQLを構成し、UpdateオペレータのSQLセッションの一部として発行して、Teradata Databaseにリクエストを伝達します。
• Updateオペレータはクエリー バンド式をチェックせず、Teradata Databaseに式をそのまま渡します。
• ジョブを実行するTeradata Databaseのバージョンでクエリー バンド機能がサポートされていない場合、クエリー バンドは実行されません。 ただし、オペレータはエラーを無視してジョブの残りの部分を実行します。
• クエリー バンド式に構文エラーがあると、Teradata Databaseはエラーを返します。 すると、Updateオペレータはジョブを終了し、エラーをユーザーに報告します。

有効な値は、次のとおりです。

• ‘On’ = アクティブなセッションに対する通常のレプリケーション サービス制御を上書きします。
• ‘Off’ = アクティブなセッションに関して、通常のレプリケーション サービスの上書きがオフになります(変更データの取得がアクティブな場合)。
• ’None’ = 上書きのリクエストはTeradata Databaseに送られません(デフォルト)。

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

テーブルがすでに存在している必要があります。

有効な値は次のとおりです。

• 'Yes'または‘Y’ = FastFail機能を有効にします。 DBSで保留にされていると見なされる場合、ジョブは正常に終了します。
• 'No'または‘N’ = FastFail機能は有効になりません(デフォルト)。 何らかの理由でジョブが保留になっているとTASMルールで判断された場合、ジョブはハングしたように見えます。

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

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

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

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

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

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

Teradata DatabaseではMultiLoadプロトコル セッションでリクエストを送信できないため、オペレータはMultiLoadプロトコル セッションでリクエストを送信しません。オペレータは、ジョブが従来のMultiLoadプロトコルを使用する場合に、MultiLoadプロトコル セッションを使用します。

ジョブが拡張MultiLoadプロトコルを使用する場合、オペレータはセッションが接続された後にデータSQLセッションでTeradata Databaseにリクエストを送信します。

以下に例を示します。

• 例1: 次の例では、セッションのデフォルトのタイムゾーン変位をシステム デフォルトのタイムゾーンであるLOCALに設定します。

  VARCHAR TimeZoneSessInfo = 'LOCAL'

• 例2: 次の例では、セッションのデフォルトのタイムゾーン変位を、ログオンしているユーザーのデフォルトのタイムゾーンであるUSERに設定します。

  VARCHAR TimeZoneSessInfo = 'USER'

• 例3: 次の例では、セッションのデフォルトのタイムゾーン変位を単純な定数タイムゾーン文字列式に設定します。

  VARCHAR TimeZoneSessInfo = '''America Pacific'''

  値内のどの単一引用符文字(')も、TPTジョブ スクリプトで2つの連続した単一引用符文字として入力する必要があります。これにより、正しい値がTeradata Databaseに送信されます。

SET TIME ZONE SQLについて詳しくは、<Teradata Database SQLデータ定義言語 構文規則および例>マニュアルを参照してください。

トレース レベルは次のとおりです。

• 'None' = トレース機能を無効にします(デフォルト)。
• ’CLI’ = CLIに関連するアクティビティ(Teradata Databaseとの対話)についてのトレース機能を有効にします。
• '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名> <変換グループ名>;

"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セッションが接続されると、オペレータはそのセッションでTeradata Databaseにリクエストを送信します。

メイン制御SQLセッションが接続されると、オペレータはそのセッションでTeradata Databaseにリクエストを送信します。

Teradata DatabaseではMultiLoadプロトコル セッションでのリクエスト送信が許可されていないため、オペレータはMultiLoadプロトコル セッションではリクエストを送信しません。ジョブで従来のMultiLoadプロトコルが使用されている場合に、オペレータはMultiLoadプロトコル セッションを使用します。さらに、Teradata Databaseでは補助SQLセッションは不要であるため、ジョブで従来のMultiLoadプロトコルが使用されている場合に、オペレータは補助SQLセッションではリクエストを送信しません。

ジョブが拡張MultiLoadプロトコルを使用する場合、オペレータはセッションが接続された後にデータSQLセッションおよび補助SQLセッションでTeradata Databaseにリクエストを送信します。

TreatDBSRestartAsFatal値は次のとおりです。

• '’No’(’N’) = Teradata Databaseの再起動が発生した場合、オペレータは終了しない(デフォルト)。Teradata Databaseの再起動は、再試行可能な処理として扱われます。
• ’Yes'(’Y’) = Teradata Databaseの再起動が発生した場合、オペレータは終了する。

有効な値は、次のとおりです。

• ’On’ = オペレータ内のUnicode Pass Through機能を有効にする。
• ’Off’ = (デフォルト)オペレータ内のUnicode Pass Through機能を無効にする。

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