DDLオペレータの必須および任意の属性値を宣言するには、Teradata PTのDEFINE OPERATOR文で属性定義リスト構文を使用します。 次の構文図の属性の説明については、このセクションの「DDLオペレータの属性定義」のテーブルを参照してください。 属性の説明に続けて、オペレータの一般例を示します。
構文規則:
| 構文要素 | 説明 |
|---|---|
| AccountId = acctId' | 特定のユーザー名に関連するアカウントを指定する任意の属性。 この属性を省略すると、デフォルトでデータベースの直接所有者のアカウントIDが設定されます。 |
| ARRAY | 複数の属性値を指定する任意のキーワード。 |
| ConnectString = 'connectionString' | 接続文字列を指定する任意選択の属性。この接続文字列はCLIに渡され、CLIが接続文字列を検証します。 接続文字列の詳細については、<Teradata® Call-Level Interface Version 2リファレンス - ワークステーション接続システム, B035-2418>を参照してください。 TPTの接続文字列機能は、z/OSを除くすべてのプラットフォームで利用できます。
|
| DataEncryption = ‘option’ | SQLリクエスト、応答、およびデータの完全暗号化を可能にする任意の属性。 有効な値は次のとおりです。
|
| ErrorList = ‘nnnn’ | 無視するデータベース エラーのリスト(番号別)を指定する任意の属性。 この属性を使用すると既知のデータベース エラーが抑制されるため、ジョブの終了を回避できます。 この属性は、DDL文の発行後、Teradataサーバーからエラーが返されたときはジョブを終了するように設定されているデフォルトのオペレータ動作をオーバーライドします。 以下に、テーブルの削除中にデータベース エラー3807が発生した場合、DDLオペレータが不良ステータス コードを返さないようにする例を示します。 DEFINE OPERATOR DDLOP
DESCRIPTION 'DDL OPERATOR'
.
ATTRIBUTES
(
VARCHAR ErrorList = '3807',
;
ErrorList属性を使用して、複数のエラー コードを抑制することもできます。 |
| LogonMech = 'string' | 使用するログオン メカニズムを指定する任意の属性。 認証方式によってはこの属性の指定が必須になる場合があります。
属性が8バイトを超えると、ジョブが終了されます。 LogonMechの指定要件については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>の「 ログオン セキュリティ」を参照してください。 |
| LogonMechData = 'data' | 追加のログオン メカニズム データを転送する任意の属性。 外部認証方式によってはこの属性の指定が必須になります。
LogonMechDataの指定要件については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>の「 ログオン セキュリティ」を参照してください。 |
| LogSQL = 'option' | 対象ジョブのSQLの中で、ログに記録する数を制御する任意の属性。 有効なオプションは次のとおりです。
|
| PrivateLogName = 'logName' | Teradata PT Loggerによってパブリック ログ内部に保持されるログの名前を指定する任意の属性。 プライベート ログには、オペレータによる出力がすべて記録されます。 プライベート ログは、tlogviewコマンドを次のように使用すると表示できます。ここで、jobIdはTeradata PTのジョブ名を、privateLogNameはオペレータのPrivateLogName属性の値を示します。 tlogview -j jobid -f privatelogname プライベート ログを指定しない場合、出力はすべてパブリック ログに格納されます。 tlogviewコマンドの詳細については、Teradata PTユーティリティのコマンドを参照してください。 |
| QueryBandSessInfo = ’queryBand Expression’ | ジョブ セッションの存続期間中のクエリー バンドを指定する任意の属性。 queryBandExpressionは、セミコロンで区切られ、セミコロンで終了する、名前=値ペアのセットです。 ユーザーは、下記の例のようなクエリー バンド式を定義します。 ‘org=Finance;load=daily;location=west;’ QueryBandSessInfoは、ARRAY属性として指定することもできます。 クエリー バンド式の作成規則については、Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144およびTeradata Vantage™ - SQLデータ定義言語 - 詳細トピック, B035-1184を参照してください。 QueryBandSessInfo属性の値は、DDLオペレータのプライベート ログに表示されます。 QueryBandSessInfo属性の使用には、以下の規則が適用されます。
|
| ReplicationOverride = ‘option’ | アクティブなセッションに対する通常のレプリケーション サービス制御を上書きする任意選択の属性。 有効な値は次のいずれかです。
詳細については、<Teradata Replication Services Using Oracle GoldenGate>を参照してください。 この属性に値を設定する際には、オペレータがログインで使用するユーザーIDにREPLCONTROL権限が付与されていなければなりません。
|
| RestartAtFirstDMLGroup = 'option' | 再起動後にDDLオペレータが再開するDML文を指定する任意選択の属性。 有効な値は次のとおりです。
動作の例を以下に示します。
CREATE TABLE A (...); CREATE TABLE B (...); CREATE TABLE C (...); 例えば、テーブルCの作成中にジョブが失敗した場合、ジョブの再始動時のデフォルトの動作は、DDLオペレータが'CREATE TABLE C'のDML文で再開することです。ただし、RestartAtFirstDMLGroupが'Yes'に設定されている場合は、DDLオペレータは'CREATE TABLE A'のDML文で再開されます。 |
| RoleName = 'role name' | データベース環境にセキュリティを実装する任意選択の属性。オペレータの先頭に"SET ROLE"という値が付加されます。次のような構文でデータベースに送信されます。 SET ROLE <role name>; 例: SET ROLE All; SET ROLEコマンドの使用の詳細については、<Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144>を参照してください。 VARCHAR ARRAYを使用すると、複数の値を指定できます。以下に例を示します。 VARCHAR ARRAY RoleName = ['role name1', 'role name2'], SQLセッションが接続されると、オペレータはそのセッションでデータベースにリクエストを送信します。
|
| SPLOPT = ‘option’ | DDLオペレータを使用して、インライン ストアド プロシージャの作成、置換、および削除をサポートする任意選択の属性。DDLオペレータはストアド プロシージャを実行しません。ストアド プロシージャはSHOW PROCEDURE文で取り出すことができます。 64Kを超えるストアド プロシージャ コマンドの場合、Teradata PTは64Kブロックでリクエストを1度に1つずつ送信します。 有効な値は次のとおりです。
|
| SQLCmdFileName = SQLfilepathname | 完全なSQLファイル名を指定する任意のVARCHAR属性。指定された<SQLFile>では、各SQLコマンドはセミコロンで終わる必要があります。 |
| TdpId = 'dbcName' | DDLオペレータ ジョブのデータベース マシン(非メインフレーム プラットフォーム)またはTDP(メインフレーム プラットフォーム)の名前を指定する任意の属性。 dbcNameは、最大256文字まで指定でき、ドメイン サーバー名を1つ指定できます。 TdpId属性に対して値を指定しない場合、オペレータは、システム管理者がユーザー用に設定したデフォルトのTdpIdを使用します。 メインフレームでは、1文字のTdpIdがサポートされます。 1文字だけを指定すると、TDPで始まる4文字のTdpIdの略語とみなされます。
|
| TimeZoneSessInfo = 'timeZoneValue' | オペレータのジョブ セッションの期間にデフォルトのタイムゾーンの変位を変更できるようにする任意選択の属性。 この属性の値を指定すると、オペレータはSET TIME ZONE <timeZoneValue>; SQLリクエストを作成します。 SQLセッションが接続されると、オペレータはそのセッションでデータベースにリクエストを送信します。 以下に例を示します。
SET TIME ZONE SQLについて詳しくは、Teradata Vantage™ - SQLデータ定義言語-構文規則および例, B035-1144を参照してください。 |
| 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セッションが接続されると、オペレータはそのセッションでデータベースにリクエストを送信します。
|
| TreatDBSRestartAsFatal= ‘option’ | データベースの再起動時にジョブを終了するかどうかをオペレータに指示する任意選択の属性。 有効な値は次のとおりです。
|
| UnicodePassThrough = ‘value’ | Unicode Pass Through機能を有効または無効にするようにオペレータに指示する任意選択の属性。 有効な値は次のいずれかです。
TPTジョブがUTF8またはUTF16セッション文字セットを使用している場合、UnicodePassThrough属性を'On'に設定して、オペレータが文字を通じてデータをデータベースに送信できるようにすることができます。
|
| Username = 'userId' | データベースのユーザー名を指定する属性。 一部の外部認証ログオン方式は、この属性の使用に対応していません。UserNameの指定要件の詳細については、<Teradata® Parallel Transporterユーザー ガイド, B035-2445>の「ログオン セキュリティ」を参照してください。
|
| UserPassword = 'password' | ユーザー名に関連するパスワードを指定する属性。 一部の外部認証ログオン方式は、この属性の使用に対応していません。UserPasswordの指定要件の詳細については、<Teradata® Parallel Transporterユーザー ガイド, B035-2445>の「ログオン セキュリティ」を参照してください。
|
| VARCHAR | 定義済み属性のデータ型としてVARCHARを指定するキーワード。 |
| WorkingDatabase = ‘databaseName’ | ログオン データベース以外のデータベースをデフォルト データベースとして指定する任意の属性。 この属性で指定されたデータベース名は、2つのSQLセッションを接続した直後にオペレータによって送られるSQL DATABASE文で使用されます。 WorkingDatabaseが指定されない場合、修飾されていないすべてのテーブル名において、ログオンしたユーザーに関連付けられたデフォルト データベースがWorkingDatabaseとみなされます。 |