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

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

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

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

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

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

• 'Yes'または'Y' = サイズの大きい行を破棄してジョブを続行するようにオペレータに指示します。
• 'No'または'N' = サイズの大きい行が検出されたときにジョブを終了するようにオペレータに指示します(デフォルト値)。

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

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

有効値は1～38で、

デフォルト値は38です。

属性値qが38>=q>=1の場合、返されたDECIMAL (n[,m])データ項目のうちn>qのものはDECIMALに暗黙的にCASTされます。オーバーフローは明示的CASTと同様に処理されます。

メインフレーム接続のプラットフォームでは、MaxDecimalDigits属性を31以下にして、ネイティブ命令セットの容量を超える表現を回避することが推奨されます。

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

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

MinSessionsには、1以上およびExportオペレータの最大セッション数以下の値を指定する必要があります。デフォルトは1セッションです。

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

独自の通知出口ルーチンを指定する方法については、使用制限語を参照してください。

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

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

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

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

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

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

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

  NXEventStmtFetchEnd64

  NXEventReqFetchEnd64

  NXEventExportEnd64

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

  完全なTeradataオブジェクト名が、NXEventInitializeEONイベントの通知出口ルーチンに渡されます。 また、ExitEONから8バイトの符号なし整数値の形式で行カウント情報が送信されます。

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

   INTEGER OutLimit = 1000

• 指定する場合、OutLimit値は1以上である必要があります。
• OutLimitを指定しない場合、処理レコード数に制限はありません。
• OutLimitを指定すると、制限がジョブ全体ではなく、Exportオペレータの各インスタンスに適用されます。

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

tlogview -j jobid -f privatelogname

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

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

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

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

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

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

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

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

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

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にリクエストを送信します。

Teradata DatabaseではFastExportプロトコル セッションでリクエストを送信できないため、オペレータはFastExportプロトコル セッションでリクエストを送信しません。

オペレーティング システムのTeradata SQLリファレンスを参照して、SelectStmt属性に対して1つ以上の有効なTeradata SQL SELECT文を入力します。

ステートメントは単一引用符で囲む必要があります。また、各ステートメントの末尾にはセミコロンを付ける必要があります。

• 'Spool'は、応答セットをスプールすることをエクスポート オペレータに指示します。これがデフォルトです。
• 'NoSpool'は、NoSpoolメソッドを使用して試行することをエクスポート オペレータに指示します。NoSpoolがサポートされていない場合は、Spoolが使用されます。
• 'NoSpoolOnly'は、NoSpoolメソッドのみを使用することをエクスポート オペレータに指示します。NoSpoolがサポートされていない場合は、エラーによりジョブは終了します。

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

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

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

dbcNameは、ネットワークのhostsファイルに入力されているホストの名前にします。

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

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

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

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

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

Teradata DatabaseではFastExportプロトコル セッションでリクエストを送信できないため、オペレータはFastExportプロトコル セッションでリクエストを送信しません。

以下に例を示します。

• 例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にリクエストを送信します。

Teradata DatabaseではFastExportプロトコル セッションでリクエストを送信できないため、オペレータはFastExportプロトコル セッションでリクエストを送信しません。

TreatDBSRestartAsFatal値は次のとおりです。

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

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

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