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

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

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

• ’Y’または'Yes' = Selectorオペレータは、XML、JSON、またはCLOBの出力データ ファイルの先頭に、該当するUTF BOMを追加します。
• ’N’または'No' = Selectorオペレータは、XML(JSONまたはCLOB)の出力データ ファイルの先頭に、該当するUTFバイト オーダー マーク(BOM)を追加しません(デフォルト)。

AddBOMToFileは、次の2つの条件が満たされている場合にのみ使用できます。

1. ジョブ スキーマに、AS DEFERRED BY NAMEで定義されているXML、JSON、またはCLOBの列が1列以上ある。
2. ロード ジョブのクライアント文字セットが、Unicode文字セットである。

この2つの条件が満たされていないと、この属性で指定した値は無視されます。

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

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

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

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

• RU = 非コミット読み取り
• SR = (デフォルト)逐次化

データベースが分離レベルの変更に成功すると、次のメッセージがプライベート ログに書き込まれます。

Session Isolation Level: RU

SQL Selectorオペレータで作成されるファイル名の形式は以下のとおりです。

<column-name>_<job-id>_p<#>_r<#>

構文規則:

• "p"の後の#は、SQL Selectorコピーの識別情報です。
• “r"の後の#は、"Teradata Databaseから返される行順序です。

例えば、以下のスキーマがあるとします。

DEFINE SCHEMA <schema-name>
  (
    COL2 BLOB AS DEFERRED BY NAME,
    COL3 CLOB AS DEFERRED BY NAME,
    COL4 XML AS DEFERRED BY NAME,
    COL5 JSON(1000000) AS DEFERRED BY NAME,
  );

LobFileBaseNameの値が"my_test"の場合、

ファイル名は以下のようになります。

• my_test_COL2_<job-id>_p1_r1
• my_test_COL3_<job-id>_p1_r1
• my_text_COL4_<job-id>_pl_r1
• my_text_COL5_<job-id>_pl_r1
• my_test COL2_<job-id>_p1_r2
• my_test_COL3_<job-id>_p1_r2
• my_test_COL4_<job-id>_pl_r2
• my_test_COL5_<job-id>_pl_r2
• my_test_COL2_<job-id>_p1_r3
• my_test_COL3_<job-id>_p1_r3
• my_test_COL4_<job-id>_pl_r3
• my_test_COL5_<job-id>_pl_r3

以下同様に続きます。

’file-extensions’の例には、次のものがあります。

• ’jpg’:ファイルの’ccc.jpg’が画像ファイルであることを示します。
• ’gif’:ファイルの’ddd.gif’が画像ファイルであることを示します。
• ’html’:ファイルの’aaa.html’がhtmlファイルであることを示します。
• * 'json':ファイルがJSONファイルであることを示します。

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

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

デフォルト値は38です。

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

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

INTEGER OutLimit = 1000

指定する場合、OutLimit値は1以上である必要があります。

OutLimitを指定しない場合、処理レコード数に制限はありません。

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

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

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

この機能を使用すると、Teradata Databaseからデータを文字形式で抽出した後、DataConnectorオペレータを使用してそのデータを「区切り」(VARTEXT)形式に変換してテキスト ファイルに保存できます。 文字形式(フィールド レポート モード)でデータをエクスポートする場合は、スキーマで定義された列がVARCHARである必要があります。

値は次のいずれかです。

• 'Yes' ('Y') = レポート モード(文字形式でデータを返します)
• 'No' ('N') = 標識モード(デフォルト)

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

SQL Selectorオペレータは、単一または複数のSELECT文を実行依頼できます。 指定されたSELECT文は、Teradata Databaseに送信される単一のリクエストとして処理されます。 リクエスト全体は、1MB(Teradata Databaseの制約)より大きくできません。

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

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

この属性の値を指定すると、オペレータは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' = オペレータ固有のアクティビティについてのトレース機能を有効にします。
• '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機能を無効にする。