初期化文字列 - Access Module

Teradata® Tools and Utilities Access Moduleリファレンス

Product
Access Module
Release Number
17.10
Published
2021年10月
Language
日本語
Last Update
2021-11-16
dita:mapPath
ja-JP/uur1608578381725.ditamap
dita:ditavalPath
ja-JP/obe1474387269547.ditaval
dita:id
B035-2425
Product Category
Teradata Tools and Utilities

GCSへのデータ書き込みおよびGCSからのデータ読み取りのためのTeradata Access Module for GCSの初期化文字列の基本構文を次に示します。初期化文字列は、一連のキーワード=値のペアで構成され、各ペアはブランクで区切られます。キーワードの値は整数または文字列です(文字列は、スペースが含まれている場合以外は、引用符で囲む必要はありません)。以下に例を示します。

AccessModuleInitStr = 'Bucket=roger Prefix=monday Object=data_load_1'


構文規則:

構文要素 説明
AccessID (必須)このパラメータは、実際にはGCSのユーザーIDです。AccessIDの値は、初期化文字列パラメータAccessID、環境変数GCS_ACCESS_KEY_ID、またはGCSのcredentialsファイルで指定できます。初期化文字列パラメータAccessIDで指定されている場合、環境変数GCS_ACCESS_KEY_IDの値およびGCSのcredentialsファイルの内容は考慮されません。環境変数GCS_ACCESS_KEY_IDで設定されている場合、GCSのcredentialsファイルの内容は考慮されません。

この値をジョブ変数ファイルに格納するかどうかを決定する際には、セキュリティ ポリシーを考慮します。

また、項目名が必須の接頭辞"tptgcs_"で始まっていれば、AccessIDをTeradata Walletに格納することもできます。

AccessKey (必須)このパラメータは、実際にはGCSのパスワードです。AccessKeyの値は、初期化文字列パラメータAccessKey、環境変数GCS_SECRET_ACCESS_KEY、またはGCSのcredentialsファイルで指定できます。初期化文字列パラメータAccessKeyで指定されている場合、環境変数GCS_SECRET_ACCESS_KEYの値およびGCSのcredentialsファイルの内容は考慮されません。環境変数GCS_SECRET_ACCESS_KEYで指定されている場合、GCSのcredentialsファイルの内容は考慮されません。

この値をジョブ変数ファイルに格納するかどうかを決定する際には、セキュリティ ポリシーを考慮します。

また、項目名が必須の接頭辞"tptgcs_"で始まっていれば、AccessKeyをTeradata Walletに格納することもできます。

Bucket (必須)読み取り操作および書き込み操作に使用するGCSバケットを指定します。

このパラメータは、アクセス モジュール パラメータの初期化文字列に含める必要があります。

BufferCount (オプション)ConnectionCountで指定されるTCP接続で使用するバッファ数を指定します。

接続数の2倍が最小推奨値です。値を指定しない場合、値(2 * ConnectionCount)がデフォルトとして使用されます。

BufferSize (オプション)TCP接続に使用されるバッファのサイズを指定します。デフォルトは8MB(8388608バイト)です。利便性のために、次の乗数を使用できます。
  • k (1000)
  • K (1024)
  • m (1000*1000)
  • M (1024*1024)
例えば、デフォルトは8Mまたは8192Kと指定できます。
ConfigDir (オプション)GCSは、アプリケーション プログラムが、構成ディレクトリに格納されているcredentialsファイルから、頻繁に必要とされる一部のパラメータを取得する機能を提供します。デフォルトでは、そのディレクトリは$HOME/.gcsですが、このパラメータでオーバーライドすることができます。
ConnectionCount (オプション)GCSサービスへのTCP接続の数を指定します。

指定しないと、デフォルトの10が使用されます。

HttpsProxy (オプション)認証を必要としないHTTPSプロキシのIPアドレス(またはドメイン名)とポート番号をhttps://w.x.y.z:mという形式で指定します(w.x.y.zはプロキシ サーバーのIPアドレス、mはプロキシ サービスのポート番号)。このパラメータの詳細については、HTTPSプロキシのサポートで説明しています。
LogAPI (オプション)開発者用の追加情報が含まれているデバッグ トレース ファイルを作成します。トレース ファイルにはユーザーのAccessIDが含まれるため、Teradataによる明示的な指示がある場合を除いて、LogAPIパラメータを使用しないでください。
MaxObjectSize (オプション)このパラメータはGCSへの書き込み操作にのみ適用されます。
MaxObjectSizeの値には、整数、または整数の直後に(スペースを入れずに)次のいずれかの乗数を指定します。
  • k (1000)
  • K (1024)
  • m (1000*1000)
  • M (1024*1024)
例えば、MaxObjectSize=100mであれば、Teradata Access Module for GCSは、オブジェクトが100,000,000バイトになると現在のオブジェクトを閉じて新しいオブジェクトを開きます。Teradata Access Module for GCS常に整数個のTPTバッファを書き込むため、指定されているサイズに達する少し前にオブジェクトを閉じることがあります。また、Teradata Access Module for GCSは各オブジェクトに少なくとも1つのバッファを書き込む必要があるため、MaxObjectSizeの値が非常に小さい場合はオブジェクトが1~8メガバイトの範囲になることがあります。

AccessModuleInitStrでMaxObjectSizeが使用されている場合、オブジェクトの命名規則が変化して、各オブジェクト名は次のようになります。

<object-name>-xxx

xxxは001から始まる連続した3桁の数字です。

オブジェクト名にファイル拡張子が付いている場合、ベース名の後に3桁の数字が付加され、その後に拡張子が続きます。

<object-name>-xxx.<extension>

Object (必須)Google Cloud Storageのバケット内に作成されるオブジェクトの名前です。このオブジェクトのパス名は、Prefixの値の後にObjectが付加されたものです。
Prefix (省略可能) このオプションを選択します。Object文字列の前に、バケット内にパス名を作成します。このパラメータは、バケット内のパス名を作成するために
GCSバケット内では、ディレクトリを明示的に作成する必要はありません。GCS CLIとGUIでは、"/"の存在に基づいてオブジェクトのリストが分離されますが、それは表示上の便宜のために行なわれるだけです。パス名で"/"を使用するためにディレクトリを作成する必要はなく、パス名での1つまたは複数の"/"の存在または位置は、PrefixまたはObjectの文字列のいずれかまたは両方で指定できます。特に、Prefixを使用している場合、途中や末尾に"/"が含まれている必要はありません。”.
文字列の前に追加されます。エクスポートまたはロード スクリプトの作成上の便宜のために、一連のテーブルをエクスポートまたはロードするときに変更されないパス名の一部にこのパラメータを使用できます。
Profile (オプション)credentialsファイルはセクションに分割されます。各セクションには括弧で囲まれた見出しが付いています。Profile変数は、credentialsファイル内のセクションを選択します。[default]というセクションは必ず存在します。Profileが指定されていない場合、または"default"という値が明示的にデフォルトとして示されている(Profile=default)場合に、このセクションが使用されます。