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

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

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

• ’No’ = Streamオペレータは既存のエラー テーブルを使用しません(デフォルト)。
• ’Yes’ = Stream オペレータは既存のエラー テーブルを使用するか、またはエラー テーブルが存在しない場合にエラー テーブルを作成します。

  エラー テーブルが存在する場合、Streamオペレータはそのテーブルの行数を表示します。

  既存のエラー テーブルの構造がStreamオペレータの必要とするエラー テーブルと適合しない場合は、Streamオペレータがエラー メッセージを表示してジョブを終了します。

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

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

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

• ’On’ = Streamオペレータはジョブ全体でArraySupportを使用します。
• ’Off’ = StreamオペレータはArraySupportを使用しません。

ArraySupportの値が指定されていない場合でも、以下の基準が満たされていれば、配列サポートは有効になり、Streamオペレータはジョブ全体に対してこの機能を使用します。

• Teradata DatabaseとCLIv2の両方で配列サポート機能がサポートされている。
• DML文が単一のDML文またはAtomic UPSERT文である。
• SerializeがOnの場合にはジョブ ステップに単一のDMLグループが含まれている必要がある。

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

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

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

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

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

CheckpointRowCount値は次のとおりです。

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

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

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

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

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

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

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

• ’Yes’ = Stream オペレータはジョブ終了時にエラー テーブルが空の場合に削除します(デフォルト)。Teradata PTはDROP TABLE文を自動的に実行します。
• ’No’ = Stream オペレータはジョブ終了時にエラー テーブルが空の場合でも削除しません。

  多数の小さな(短時間で終了する)ロード ジョブを定期的に実行する場合は、このようなジョブに対してDropErrorTableを’No’に設定することで、Teradata Databaseデータ ディクショナリに対する更新の回数が減少します。

  エラー テーブルが削除されない場合は、次のジョブの開始時にAppendErrorTableを’Yes’に設定することで、そのエラー テーブルを使用できます。

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

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

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

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

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

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

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

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

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

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

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

例えば、LDILoadGroup = ’Grp1’

LDILoadJob値は次のとおりです。

• ’No’(’N’) = 分離負荷なし(デフォルト)
• ’Yes’(’Y’) = 分離負荷を要求します。Stream オペレータは、"BEGIN ISOLATED LOADING ON <target table(s)> USING QUERY_BAND 'LDILoadGroup=<...>;' IN MULTIPLE SESSION;"を送信します。複数のセッションでは、ターゲット テーブルが修飾されている場合、Teradata Databaseへのリクエスト。ターゲット テーブルは、「すべての孤立したロード」として作成する必要があります。

  例:

  CREATE TABLE   testtable,
  	          FALLBACK,
  	          WITH ISOLATED LOADING FOR ALL
     (COL1       VARCHAR(5),
      COL2       VARCHAR(5));');

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

• 'Yes' = すべてのSQLをログに出力します。 最大長は1Mです。
• 'No' = SQLをログに出力しません。
• 値または属性が省略されていない = SQLのすべてが32 K未満の場合、最大32 KのSQLを表示する定義済みの制限を受け入れます。ログに記録されるSQLが32Kを超える場合は、最初の32 Kバイトに表示を切り捨てます。

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

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

• SELECT
• INSERT
• DELETE

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

• DROP
• CREATE

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

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

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

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

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

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

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

デフォルトは1です。

• libnotfyext.dll for Windows platforms
• libnotfyext.dylib for the Apple OS X platform
• libnotfyext.so for all other UNIX platforms
• NOTFYEXT for z/OS platforms

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

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

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

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

  Solaris、AIX、Linux、およびHP-UXの各プラットフォームの場合、イベントの送り先は/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')= 最大可能パック係数を決定します。

PauseLDI値は次のとおりです。

• ’No’(’N’) = Stream オペレータは、"QUERY_BAND 'LDILoadGroup = <値>のための最後の孤立した読み込み"を送信します。"QUERY_BAND 'LDILoadGroup = <値>; ' を使用して<ターゲット テーブル>の孤立した読み込みを開始する場合、Teradata Databaseへ送信"がされます。
• ’Yes’(’Y’) = Stream オペレータは、"QUERY_BAND 'LDILoadGroup = <値>"に対し、Teradata Databaseに最後の孤立した読み込みを送信しません。

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

Periodicity属性の使用には、以下の条件および規則が適用されます。

• 有効な値は1～600の整数です。
• デフォルト値は4です。すなわち、1分あたり15秒の期間4回になります。
• ステートメントのレートが無制限の場合、Periodicityの値は無視されます。
• ユーザーは、ジョブの実行中にTeradata PTの外部コマンド インターフェース ユーティリティtwbcmdを使用してPeriodicityの値を変更できます。

プライベート ログは、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 Database SQLデータ定義言語 - 構文規則および例、B035-1144>と<SQLデータ定義言語 - 詳細トピック、B035-1184>を参照してください。

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

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

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

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

• ’Yes’(’Y’) = エラー テーブルをキュー テーブルとして作成します。
• ’No’(’N’) = エラー テーブルを非キュー テーブルとして作成します(デフォルト)。

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

レート属性の使用には、以下の条件および規則が適用されます。

• ステートメントのレートは正の整数でなければなりません。
• ステートメントのレートが指定されていない場合、レートは無制限になります。
• ステートメントのレートがステートメントのパック係数の値よりも小さい場合、Streamオペレータは、パック係数よりも少ない数のリクエストを送信します。
• ステートメントのレートが無効な場合、Streamオペレータは、エラー メッセージを表示し、戻りコード8で終了します。
• Serializationが使用されているされていない場合: Packの値に達するまで、Streamオペレータは、セッション入力"bucket"に連続的な行を追加します。 次に、データを送信し、セッション リスト内の次のセッションに進み、新しい入力バケットの充填を開始します。 ただし、ステートメントのレート/周期(R/P)がパック係数の値よりも小さい場合には、バケットの内容がTeradata Databaseに送信される前に、R/Pの行のみがセッション バケットに追加されます。
• Serializationが使用されていない場合: serialization列のデータはハッシュされ、結果の値がセッション リストのインデックスとして使用され、データ行に対するセッションが選択されます。 このため、serializationの使用時にR/Pがパック係数の値よりも小さい場合には、Teradata Databaseに送信されるR/Pの行が複数のセッション間で分散される可能性があります。
• ユーザーは、ジョブの実行中にTeradata PTの外部コマンド インターフェース ユーティリティtwbcmdを使用してステートメントのRate値を変更できます。

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

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

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

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

Robustの値は次のいずれかです。

• 'Yes' ('Y') = 堅固動作再始動ロジックを使用します(デフォルト)。 堅固動作モードでは、パックされたリクエストごとに、チェックポイントとチェックポイントの間にいくつかの「部分チェックポイント」行がログに書き込まれます。 それらの行は、チェックポイントが書き込まれるたびに削除されます。 堅固動作モードの回復時、Streamオペレータは、最後に記録されたチェックポイント以降、どれくらいの処理が完了したかを突き止める必要があります。 これは、一連の"部分チェックポイント"をTeradata Databaseから読み取り直して整列し、ジョブが中断されたときに不完全なまま残されたトランザクションすべてを再処理することによって達成されます。
• 'No' ('N') = 単純再始動ロジックを使用します(デフォルト)。 この場合、再始動を実行すると、Streamオペレータはジョブ内の最後のチェックポイントから処理を開始します。 チェックポイント後に発生した処理はすべて再実行されます。 この方法を使用すると、堅固動作ロジックにある追加のデータベース書き込みに余分なオーバーヘッドがかからりません。そのため、操作の結果を変更せずに繰り返すことができる特定のDML文に適しています。

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

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

SET ROLE <role name>;

例:

SET ROLE All;

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

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

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

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

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

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

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

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

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

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

TreatDBSRestartAsFatal値は次のとおりです。

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

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

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