SQL Inserterオペレータの必須属性値を宣言するには、Teradata PTのDEFINE OPERATOR文で属性定義リスト構文を使用します。
構文規則:
構文要素 | 説明 |
---|---|
AccountId = 'acctId' | 特定のユーザー名に関連するアカウントを指定する任意の属性。 この属性を省略すると、デフォルトでデータベースの直接所有者のアカウントIDが設定されます。 |
ARRAY | 複数の属性値を指定する任意のキーワード。 |
DataEncryption = 'option' | SQLリクエスト、応答、およびデータをセキュリティによって完全に暗号化する任意の属性。 有効な値は次のとおりです。
|
DateForm = 'option' | SQL Inserterオペレータ ジョブのDATEデータ型を指定する任意の属性。
|
DeleteLobDataFiles = 'option' | 行がデータベースにコミットされたらData Connecter Producerから遅延したLOBデータ ファイルを削除するかどうかを指定する任意選択の属性。 有効な値は次のとおりです。
これ以外の値を指定するとエラーになります。 |
LogonMech = ‘string’ | 使用するログオン メカニズムを指定する任意の属性。 認証方式によってはこの属性の指定が必須になる場合があります。 属性が8バイトを超えると、ジョブが終了されます。 LogonMechの指定要件については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>の「 ログオン セキュリティ」を参照してください。 |
LogonMechData = ' data' | 追加のログオン メカニズム データを転送する任意の属性。 外部認証方式によってはこの属性の指定が必須になります。 LogonMechDataの指定要件については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>の「ログオン セキュリティ」を参照してください。 |
LogSQL = 'option' | 対象ジョブのSQLの中で、ログに記録する数を制御する任意の属性。 有効なオプションは次のとおりです。
|
MaxSessions = ‘maxSessions’ | ログオンするセッションの最大数を指定する任意の属性。MaxSessionsには、1以上の値を指定する必要があります。1未満の値を指定すると、ジョブが終了されます。 デフォルトの値は、オペレータ インスタンスごとに1セッションです。 メイン インスタンスが、インスタンス数からInserterオペレータ セッションの均等配分を割り出します。 例えば、4つのインスタンスと16個のセッションがある場合、各インスタンスは4つのセッションにログオンします。 複数のセッションが使われている場合、データには重複するプライマリ インデックス値があり、これにより潜在的なTeradata Databaseデッドロック2631エラーが発生する可能性があります。このエラーを避けるため、TPT SQL Inserterオペレータでは複数のセッションを使用しないでください。
複数のセッションが使用されて、データがTeradata Databaseで同じ行レベルのロックにアクセスする場合、ジョブがハングする可能性があります。ハングを回避するため、TPT SQL Inserterオペレータでは複数のセッションを使用せず、1つのセッションのみを使用するようにしてください。
|
MinSessions = ‘minSessions’ | Stream オペレータ ジョブを継続するために最低限必要なセッション数を指定する任意の属性。 MinSessionsは、0よりも大きく、属性MaxSessionsで定義されている最大セッション数以下にする必要があります。 1未満の値を指定すると、ジョブが終了されます。 |
PrivateLogName = 'logName' | Teradata PT Loggerによってパブリック ログ内部に保持されるログの名前を指定する任意の属性。 プライベート ログには、オペレータによる出力がすべて記録されます。 プライベート ログは、tlogviewコマンドを次のように使用すると表示できます。ここで、jobIdはTeradata PTのジョブ名を、privateLogNameはオペレータのPrivateLogName属性の値を示します。 tlogview -j jobid -f privatelogname プライベート ログを指定しない場合、出力はすべてパブリック ログに格納されます。 tlogviewコマンドの詳細については、Teradata PTユーティリティのコマンドを参照してください。 |
QueryBandSessInfo = ’queryBandExpression’ | ジョブ セッションの存続期間中のクエリー バンドを指定する任意の属性。 queryBandExpressionは、セミコロンで区切られ、セミコロンで終了する、名前=値ペアのセットです。 ユーザーは、下記の例のようなクエリー バンド式を定義します。 ‘org=Finance;load=daily;location=west;’ QueryBandSessInfoは、ARRAY属性として指定することもできます。 クエリー バンド式の作成規則については、<Teradata Database SQLデータ定義言語 - 構文規則および例、B035-1144>と<SQLデータ定義言語 - 詳細トピック、B035-1184>を参照してください。 QueryBandSessInfo属性の値は、SQL Inserterオペレータのプライベート ログに表示されます。 QueryBandSessInfo属性の使用には、以下の規則が適用されます。
|
ReplicationOverride = ' option ' | アクティブなセッションに対する通常のレプリケーション サービス制御を上書きする任意の属性。 有効な値は、次のとおりです。
詳細については、<Teradata Replication Services Using Oracle GoldenGate、B035-1152>を参照してください。 この属性に値を設定する際には、オペレータがログインで使用するユーザーIDにREPLCONTROL権限が付与されていなければなりません。
|
RemoveBOMFromFile = 'option' | XML、JSON、またはCLOBのデータ ファイルの先頭にあるUTFバイト オーダー マーク(BOM)を検索して削除するかどうかを指定する任意選択の属性。 有効な値は次のとおりです。
RemoveBOMFromFileは、次の2つの条件が満たされている場合にのみ使用できます。 ジョブ スキーマに、AS DEFERRED BY NAMEで定義されているXMLやJSON、CLOBの列が1列以上ある。 ロード ジョブのクライアント文字セットが、Unicode文字セットである。 この2つの条件が満たされていないと、この属性で指定した値は無視されます。 |
RoleName = 'role name' | 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に渡します。Teradata Databaseはその値を検証します。妥当性検査が失敗した場合、オペレータはTeradata Databaseエラーでジョブを終了します。
C形式のコメントは値で許可され、Teradata Databaseに渡されます。
ANSI形式のコメントは、値でサポートされません。値にANSI形式のコメントが含まれている場合、オペレータはTeradata Database構文エラーでジョブを終了できます。
セミコロンは値に使用できません。これは、オペレータがリクエストごとに1つのステートメントのみを許可するためです。値にセミコロンが含まれている場合に、オペレータはオペレータ エラーでジョブを終了します。
|
TdpId = 'dbcName' | 挿入操作のTeradata Databaseマシン(非メインフレーム プラットフォーム)またはTDP(メインフレーム プラットフォーム)の名前を指定する任意の属性。 dbcNameは、最大256文字まで指定でき、ドメイン サーバー名を1つ指定できます。 TdpId属性に対して値を指定しない場合、オペレータは、システム管理者がユーザー用に設定したデフォルトのTdpIdを使用します。 メインフレームでは、1文字のTdpIdがサポートされます。 1文字だけを指定すると、TDPで始まる4文字のTdpIdの略語とみなされます。
|
TimeZoneSessInfo = 'timeZoneValue' | オプションの属性。これにより、オペレータのジョブ セッションの期間にデフォルトのタイムゾーン変位を変更できます。 この属性の値を指定すると、オペレータはSET TIME ZONE <timeZoneValue>; SQLリクエストを作成します。 セッションが接続されると、SQLセッションでTeradata Databaseにリクエストを送信します。 以下に例を示します。
オペレータはこの属性の値を検証しません。オペレータは、その値をそのままTeradata Databaseに渡します。Teradata Databaseはその値を検証します。妥当性検査が失敗した場合、オペレータはTeradata Databaseエラーでジョブを終了します。
C形式のコメントは値で許可され、Teradata Databaseに渡されます。
ANSI形式のコメントは、値でサポートされません。値にANSI形式のコメントが含まれている場合、オペレータはTeradata Database構文エラーでジョブを終了します。
セミコロンは値に使用できません。これは、オペレータが "SET TIME ZONE SQL"リクエスト内で1つのステートメントのみを許可するためです。値にセミコロンが含まれている場合に、オペレータはオペレータ エラーでジョブを終了します。
SET TIME ZONE SQLについて詳しくは、<Teradata Database SQLデータ定義言語 構文規則および例>マニュアルを参照してください。 |
TraceLevel = 'level' | オペレータによってパブリック ログ(PrivateLogName属性で指定されている場合はプライベート ログ)に書き込まれる診断メッセージの種類を指定する任意の属性。 診断トレース機能は、ログ ファイルで詳細な情報を提供するため、問題の追跡や診断に役立ちます。 トレース レベルは次のとおりです。
VARCHAR ARRAYを使用すると、複数の値を指定できます。以下に例を示します。 VARCHAR TraceLevel = 'CLI' VARCHAR TraceLevel = 'OPER' VARCHAR ARRAY TraceLevel = [ 'CLI' ] VARCHAR ARRAY TraceLevel = [ 'CLI', 'OPER' ] TraceLevel属性は、診断を支援するためにのみ指定します。 この属性によって得られる追加情報の量と種類は、ニーズの変化に合わせてリリースごとに変わります。
|
TransformGroup = 'transformgroupname' | Teradata複合データ型(CDT)のアクティブな変換の変更をサポートするオプション属性。この値は、<udt name> <transform group name>であり、オペレータの先頭には、ハードコードされた文字列"SET TRANSFORM GROUP FOR TYPE "が付加されます。RDBMSに送信される構文は次のとおりです: SET TRANSFORM GROUP FOR TYPE <udt name> <transform group name>; 例えば、次のように指定します。
"SET TRANSFORM GROUP FOR TYPE JSON CHARACTER SET LATIN TD_JSON_VARCHAR;" VARCHAR ARRAYを使用すると、複数の値を指定できます。以下に例を示します。
VARCHAR ARRAY TransformGroup = ['JSON CHARACTER SET LATIN TD_JSON_VARCHAR', 'ST_GEOMETRY TD_GEO_VARCHAR'], セッションが接続されると、SQLセッションでTeradata Databaseにリクエストを送信します。 オペレータはこの属性の値を検証しません。オペレータは、その値をそのままTeradata Databaseに渡します。Teradata Databaseはその値を検証します。妥当性検査が失敗した場合、オペレータはTeradata Databaseエラーでジョブを終了します。
C形式のコメントは値で許可され、Teradata Databaseに渡されます。
ANSI形式のコメントは、値でサポートされません。値にANSI形式のコメントが含まれている場合、オペレータはTeradata Database構文エラーでジョブを終了できます。
セミコロンは値に使用できません。これは、オペレータがリクエストごとに1つのステートメントのみを許可するためです。値にセミコロンが含まれている場合に、オペレータはオペレータ エラーでジョブを終了します。
|
TreatDBSRestartAsFatal= ‘option’ | Teradata Databaseの再起動時にジョブを終了するかどうかをオペレータに通知する任意の属性。 TreatDBSRestartAsFatal値は次のとおりです。
|
UnicodePassThrough = ' value ' | Unicode Pass Through機能を有効または無効にするようにオペレータに指示する任意の属性。 有効な値は、次のとおりです。
TPTジョブがUTF8またはUTF16のセッション文字セットを使用している場合、UnicodePassThrough属性を’On’に設定すると、オペレータはUnicodeパスを使用して文字を読み込むことができます。
|
UserPassword = 'password' | ユーザー名に関連するパスワードを指定する属性。 外部認証ログオン方式によっては、この属性と互換性がない場合があります。 パスワードの指定要件の詳細については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>の「ログオン セキュリティ」を参照してください。 |
VARCHAR | 定義済み属性のデータ型としてVARCHARを指定するキーワード。 |
WorkingDatabase = 'databaseName' | ログオン データベース以外のデータベースをデフォルト データベースとして指定する任意の属性。 この属性で指定されたデータベース名は、2つのSQLセッションを接続した直後にオペレータによって送られるTeradata SQL DATABASE文で使用されます。 WorkingDatabaseが指定されない場合、修飾されていないすべてのテーブル名において、ログオンしたユーザーに関連付けられたデフォルト データベースがWorkingDatabaseとみなされます。 |