tdloadでは、次の構文を使用します。
ここで、jobOptionsは次のいずれかです。
| 構文要素 | 説明 |
|---|---|
| -c characterSet | フラット ファイルの文字セット エンコーディング。 このオプションでクライアント セッション文字セットを設定します。 フラット ファイルがASCIIファイルではない場合は、このオプションを指定します。 |
| -d "delimiterCharacter" | 区切り形式のフラット ファイルでデータ レコードのフィールドを分離するために使用する区切り文字。 デフォルトの区切り文字はカンマ(,)です。 この点がTeradata PTスクリプトを使用する場合(パイプ文字(|)がデフォルトの区切り文字)と異なります。 フラット ファイルの区切り文字がカンマではない場合は、このオプションを指定する必要があります。
|
| -f fileName | 必須。ロード対象データを含むフラット ファイル名。 tdloadコマンドを実行しているのが、フラット ファイルが保存されているディレクトリではない場合は、fileNameには、フラット ファイルの完全修飾名が必要です。
|
| -h tdpId | ネットワークで認識されているTeradata Data Warehouse Appliance 2xxxの名前。 このオプションを指定しない場合、デフォルトのホスト名が使用されます。 推奨事項:このオプションを指定すれば、正しいシステムに確実に接続できます。 |
| -j jobVariablesFile | ジョブ変数ファイルの名前。 tdloadコマンドを実行しているのが、ジョブ変数ファイルが保存されているディレクトリではない場合は、jobVariablesFileに、完全修飾ファイル名が必要です。 |
| -L jobLogDirectory | ジョブの実行中に作成されたTeradata PTファイルの位置を指定するオプション。 jobLogDirectoryは、Teradata PTファイルが格納されているディレクトリのフルパス名です。 このオプションは、z/OSではサポートされません。 |
| -p password | 指定Teradataユーザーのパスワード。 このオプションを指定しない場合、tdloadからパスワードの入力要求が表示されます。 |
| - R restartLimit | 自動(ジョブ)再始動時のデフォルトの試行回数である5回を上書きするオプション。 -Rを指定する場合、値を入力しないと、システムでコマンドが拒否され、エラーが返されます。 restartLimitの値は、ゼロ以上の任意の整数にすることができます。 値ゼロを指定すると、ジョブが自動的に再始動されなくなります。 |
| -r checkpointDirectory | チェックポイント ファイルが“CheckpointDirectory"というディレクトリに格納されることを指定するオプション。 -r オプションを指定しないと、チェックポイント ファイルは、デフォルトのチェックポイント ディレクトリに格納されます。このディレクトリは、Teradata PTの構成ファイルで定義されています。 |
| -S | このコマンドで生成されたTeradata PTスクリプトを保存します。 |
| -t tableName | 必須。 ターゲット テーブルの名前。 指定Teradataユーザーのデフォルト データベースではないデータベースにターゲット テーブルがある場合は、--TargetWorkingDatabaseオプションも使用する必要があります。
|
| -u userName | 必須。ターゲット テーブルへのアクセス権があるTeradataユーザーのログオンID。 |
| -v | ジョブを実行せずにtdloadのバージョン番号を表示するオプション。 他のオプションとともに使用しないでください。 このオプションは、UNIXおよびWindowsプラットフォームでのみ機能します。 |
| -x | デバッグ処理を有効にします。 |
| - z checkpointInterval | チェックポイント間の時間間隔を秒単位で指定するオプション。 このオプションを指定しないと、間隔チェックポイント操作は実行されません。 チェックポイント間隔の有効な値は0～86400(秒)です。 |
| --help | ヘルプを表示します。 |
| <long_option>value | Easy Loaderは、オペレータ テンプレート内で定義されているすべての標準ジョブ変数と、汎用ジョブ変数をサポートします。これらの汎用ジョブ変数は、オペレータ テンプレートから派生し、Easy Loaderが自動的にオペレータの意思決定を行なえるようにします。汎用ジョブ変数を作成するには、単にテンプレート ジョブ変数から演算子名を削除し、オペレータがプロデューサまたはコンシューマであるかどうかに応じて‘Source’または‘Target’を追加します。 例えば、Load演算子のトレース レベル ジョブ変数は“LoadTraceLevel"であり、これを汎用にするため“TargetTraceLevel"として指定します。LoadがEasy Loaderによって選択されたConsumerオペレータである場合、“TargetTraceLevel"はロード演算子に自動的にマップされます。 その他の例と手順については、<Teradata Parallel Transporterユーザー ガイド、B035-2445>のTeradata PT Easy Loaderのセクションを参照してください。 |
一般的に使用されるlongオプションは次のとおりです。
| Longオプション | 説明 |
|---|---|
| --SelectStmt “SELECT statement(s);" | SELECT文は、Teradata Databaseテーブルからデータ選択を実行します。 SELECT文にはスペースや空白文字が入力できるため、次のようにコマンド ラインに指定する場合、文全体を二重引用符(")で囲む必要があります。 tload --SelectStmt "sel * from src_tbl;" SELECT文要求では、次のような指定はできません。
--SelectStmtオプションと-f (または、--SourceFileName)オプションは、相互に排他的です。 これらの両方がtdloadコマンド ラインで定義された場合、エラーが返されます。 --SelectStmtオプションと-- SourceTableオプションの両方が定義されている場合、--SourceTableオプションは無視され、警告メッセージがコンソールに返されます。 |
| --SourceAccountId accountId | 指定Teradataユーザーに関連付けられたアカウント。 |
| --SourceFileName fileName | 必須。ロード対象データを含むフラット ファイル名。
|
| --SourceInstances number | Teradataからデータの抽出に使用されるインスタンス数。 デフォルト値は1です。 |
| --SourceMaxSessions number | テーブルからのデータの抽出に使用されるセッションの最大数。 デフォルト値は32です。 |
| --SourceMinSessions number | テーブルからのデータの抽出に使用されるセッションの最小数。 デフォルト値は1です。 |
| --SourceTable tableName | ソース テーブルの名前。 注: 指定Teradataユーザーのデフォルト データベースではないデータベースにソース テーブルがある場合は、--SourceWorkingDatabaseオプションも使用する必要があります。 --SelectStmtオプションと-f (または、--SourceFileName)オプションは、相互に排他的です。 これらの両方がtdloadコマンド ラインで指定された場合、エラーが返されます。 --SourceTableオプションと-- SelectStmtオプションの両方が定義されている場合、--SourceTableオプションは無視され、警告メッセージがコンソールに返されます。 |
| --SourceTextDelimiter "delimiterCharacter" | 区切り形式のフラット ファイルでデータ レコードのフィールドを分離するために使用する区切り文字。 |
| --SourceTdpId tdpId | ネットワークで認識されているTeradata Databaseの名前。 |
| --SourceTraceLevel value | フラット ファイル(複数も可)からデータを読み込むオペレータでトレース メッセージを有効にします。 有効な値は次のとおりです。
|
| --SourceUserName userName | ソース テーブルへのアクセス権があるTeradataユーザーのログオンID。 |
| --SourceUserPassword password | 指定Teradataユーザーのパスワード。 このオプションを指定しない場合、tdloadからパスワードの入力要求が表示されます。 |
| --SourceWorkingDatabase databaseName | ソース テーブルが位置するデータベース。 |
| --TargetAccountId accountId | 指定Teradataユーザーに関連付けられたアカウント。 |
| --TargetErrorLimit number | データ レコードで許可されるエラーの最大数。 発生したエラー数がこの数値を超えると、ロード ジョブは終了します。 デフォルト値は1です。 |
| --TargetMaxSessions number | ロード ジョブの中で使用されるセッションの最大数。 デフォルト値は32です。 |
| --TargetMinSessions number | ロード ジョブの中で使用されるセッションの最小数。 デフォルト値は1です。 |
| --TargetTable tableName | 必須。 ターゲット テーブルの名前。 |
| --TargetTdpId tdpId | ネットワークで認識されているTeradata Databaseの名前。 |
| --TargetTraceLevel value | ターゲット テーブルにデータをロードするオペレータでトレース メッセージを有効にします。 有効な値は次のとおりです。
|
| --TargetUserName userName | 必須。ターゲット テーブルへのアクセス権があるTeradataユーザーのログオンID。 |
| --TargetUserPassword password | 指定Teradataユーザーのパスワード。 |
| --TargetWorkingDatabase databaseName | ターゲット テーブルを含むデータベース。 指定Teradataユーザーのデフォルト データベースではないデータベースにターゲット テーブルがある場合は、このオプションが必要です。
|
使用場所:
| オプション | 指定内容 |
|---|---|
| jobName | ロード ジョブを識別する固有名。 推奨事項:複数のロード ジョブが同時に動作しているときは、自分のジョブに名前を付けることを強く推奨します。 |