D 初期化パラメータ
init.ora
ファイルのOracle Database初期化パラメータは、ゲートウェイ初期化パラメータと異なります。 エージェント固有のメカニズムを使用して初期化パラメータ・ファイルにゲートウェイ・パラメータを設定するか、DBMS_HS
パッケージを使用してOracleデータ・ディクショナリにゲートウェイ・パラメータを設定します。 ゲートウェイ初期化パラメータ・ファイルは、ゲートウェイの起動時に使用可能である必要があります。
次のトピックには、ゲートウェイごとに設定可能なゲートウェイ初期化パラメータのリストとその説明が含まれます。 このトピックでは、初期化パラメータ・ファイルの構文についても説明します:
D.1 初期化パラメータ・ファイルの構文
初期化パラメータ・ファイルの構文は次のとおりです。
-
ファイルは一連のコマンドで構成されています。
-
各コマンドは、個別の行で始まる必要があります。
-
行の終わりは、コマンド終端文字で認識されます(円記号でエスケープされない場合)。
-
初期化パラメータ・ファイルに構文エラーがあると、設定はすべて無効です。
-
パラメータ値は次のように設定します。
[SET][PRIVATE] parameter=value
説明:
parameter
は初期化パラメータの名前です。 この名前は、任意の文字から始まる文字列であり、文字、数字およびアンダースコアで構成されます。 初期化パラメータの名前では大/小文字が区別されます。value
は初期化パラメータの値です。 大文字と小文字が区別されます。 初期化パラメータの値は、次のいずれかになります。-
円記号、空白、二重引用符(")が含まれない文字列。
-
二重引用符で始まり、二重引用符で終わる引用符付き文字列。 引用符付き文字列内では、次の文字列が使用できます。
-
円記号(\)はエスケープ文字です。
-
\nは新しい行を挿入します。
-
\tはタブを挿入します。
-
\は二重引用符を挿入します。
-
\\: バックスラッシュを挿入します。
行末の円記号は、文字列が次の行に続くことを示します。 その他の文字の前に円記号を付けると、その円記号は無視されます。
-
たとえば、エージェントのトレースを有効化するには、
HS_FDS_TRACE_LEVEL
初期化パラメータを次のように設定します。HS_FDS_TRACE_LEVEL=ON
SET
およびPRIVATE
は、オプションのキーワードです。 どちらも初期化パラメータ名としては使用できません。 ほとんどのパラメータは初期化パラメータとしてのみ必要とされるため、通常は、SET
またはPRIVATE
キーワードを使用する必要はありません。SET
またはPRIVATE
のいずれも指定しない場合、パラメータはエージェントの初期化パラメータとしてのみ使用されます。SET
を指定すると、そのパラメータ値は初期化パラメータとして使用されるだけでなく、エージェント・プロセスの環境変数として設定されます。SET
は、ドライバやOracle以外のシステムで環境変数として必要とされるパラメータ値に使用します。PRIVATE
を指定すると、その初期化パラメータはエージェントに対してプライベートとなり、Oracle Databaseにアップロードされません。 ほとんどのパラメータは、プライベートに設定しません。 ただし、初期化パラメータ・ファイルにパスワードなどの機密情報を格納している場合、初期化パラメータとその値はアップロード時に暗号化されないため、機密情報のサーバーへのアップロードを避けたいことがあります。 初期化パラメータをプライベートに設定すると、アップロードは実行されず、動的パフォーマンス・ビューにも表示されなくなります。PRIVATE
は、パラメータ値にユーザー名やパスワードなどの機密情報が含まれる場合にのみ、初期化パラメータに使用します。SET PRIVATE
を指定すると、そのパラメータ値はエージェント・プロセスの環境変数として設定され、かつプライベートになります(Oracle Databaseに転送されず、動的パフォーマンス・ビューやグラフィカル・ユーザー・インタフェースにも表示されません)。 -
D.2 Oracle Database Gateway for Teradata初期化パラメータ
Oracle Database Gateway for Teradataに設定できる初期化ファイルのパラメータは次のとおりです:
D.3 HS_DB_DOMAIN
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle以外のシステムにおける一意のネットワーク・サブアドレスを指定します。 HS_DB_DOMAIN
初期化パラメータは、DB_DOMAIN
初期化パラメータと似ています(「Oracle Databaseリファレンス」で説明)。 HS_DB_DOMAIN
初期化パラメータは、Oracle Names Serverを使用する場合は必須です。 HS_DB_NAME
およびHS_DB_DOMAIN
初期化パラメータでは、Oracle以外のシステムのグローバル名を定義します。
注意:
コオペラティブ・サーバー環境では、HS_DB_NAME
およびHS_DB_DOMAIN
初期化パラメータを組み合せて一意のアドレスを構成する必要があります。
D.4 HS_DB_INTERNAL_NAME
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
異機種間サービス・エージェントの接続先となるインスタンスを識別する一意の16進数を指定します。 このパラメータの値は、グローバル・ネーム・サービスがアクティブ化されたときにトランザクションIDの一部として使用されます。 一意でない数値を指定すると、トランザクションで2フェーズ・コミットのリカバリ・アクションが必要な場合に問題が発生する可能性があります。
D.7 HS_LANGUAGE
プロパティ | 説明 |
---|---|
デフォルト値 |
システム固有 |
値の範囲 |
任意の有効な言語名(最大 |
異機種間サービスに、Oracle以外のデータソースのキャラクタ・セット、言語および地域情報を提供します。 値には次の書式を使用する必要があります。
language[_territory.character_set]
注意:
グローバリゼーション・サポートの初期化パラメータは、エラー・メッセージ、SQLサービスのデータ、および分散外部プロシージャのパラメータに影響します。
D.7.1 文字セット
Oracle Databaseのキャラクタ・セットとOracle以外のデータソースのキャラクタ・セットは、同じであることが理想的です。 ほとんどの場合、HS_LANGUAGE
はキャラクタ・セット・マッピングとパフォーマンスを最適化するためのOracleデータベース・キャラクタ・セットと完全に同じに設定する必要があります。 同じでない場合、異機種間サービスは、Oracle以外のデータソースのキャラクタ・セットをOracle Databaseのキャラクタ・セットに変換し、それを再び元に戻そうとします。 この変換により、パフォーマンスが低下する可能性があります。 状況によっては、異機種間サービスは、あるキャラクタ・セットから別のキャラクタ・セットに文字を変換できません。
注意:
指定するキャラクタ・セットは、エージェントがインストールされているプラットフォームにおけるオペレーティング・システムのキャラクタ・セットのスーパーセットである必要があります。
データベース・キャラクタ・セットとしてUnicodeを使用するOracleデータベースとOracle以外のデータベースが増えているため、ゲートウェイもUnicodeキャラクタ・セットで実行することをお薦めします。 そのためには、HS_LANGUAGE=AL32UTF8
を設定する必要があります。 ただし、ゲートウェイがWindowsで実行される場合、Microsoft ODBCドライバ・マネージャ・インタフェースはダブルバイト・キャラクタ・セットUCS2でのみデータを交換できます。 これにより、説明されているバッファおよび列サイズの比率が拡大します。 適切なサイズに調整する方法の説明は、HS_FDS_REMOTE_DB_CHARSETを参照してください。
D.7.2 言語
HS_LANGUAGE
初期化パラメータの言語構成要素により、次の項目が決定されます。
-
日付の月日の名前
-
日時に対するAD、BC、PMおよびAMの記号
-
デフォルトのソート・メカニズム
Oracleでは、異機種間サービスの汎用メッセージに対応するエラー・メッセージ(ORA-25000
からORA-28000
)の言語は決定されません。 これらは、Oracle Databaseのセッション設定により制御されます。
D.8 HS_LONG_PIECE_TRANSFER_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
転送されるLONG
データのピース・サイズを設定します。 ピース・サイズを小さくすると、メモリー要件は減少しますが、すべてのデータをフェッチするためのラウンドトリップ回数は増加します。 ピース・サイズを大きくすると、ラウンドトリップ回数は減少しますが、内部的に中間ピースを格納するためのメモリー要件は増大します。 つまり、この初期化パラメータは、ラウンドトリップ回数とメモリー要件(およびネットワーク待機時間またはレスポンス時間)の最適なトレードオフ関係に基づいて、最高のパフォーマンスを発揮するようにシステムをチューニングする場合に使用します。
D.9 HS_OPEN_CURSORS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle以外のシステムのインスタンスに対する1つの接続でオープンできるカーソルの最大数を定義します。
この値は、Oracle Databaseのオープン・カーソルの数を超えることはできません。 そのため、Oracle DatabaseのOPEN_CURSORS
初期化パラメータと同じ値を設定することをお薦めします。
D.10 HS_RPC_FETCH_REBLOCKING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle DatabaseとOracle以外のデータ・ストアに接続された異機種間サービス・エージェントとの間におけるデータ転送のパフォーマンスを異機種間サービスにより最適化するかどうかを制御します。
次の値を指定できます。
-
OFF
を指定すると、エージェントからサーバーにデータを即座に送信するように、フェッチされたデータの再ブロッキングが無効化されます。 -
ON
では再ブロック化が可能です。これは、Oracle以外のシステムからフェッチされたデータがエージェントにバッファされ、フェッチされたデータの量がHS_RPC_FETCH_SIZE
初期化パラメータの値以上になるまでOracleデータベースに送信されないことを意味します。 ただし、フェッチでそれ以上データが存在しないことが示された場合、またはOracle以外のシステムがエラーをレポートした場合は、バッファされたデータが即時に返されます。
D.11 HS_RPC_FETCH_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
内部データ・バッファリングを調整して、サーバーとエージェント・プロセス間のデータ転送レートを最適化します。
値を増やすと、指定されたデータ量を転送するために必要なネットワークのラウンドトリップの回数が減りますが、データ帯域幅が増え、問合せの発行から問合せのすべてのフェッチの完了までとして測定されるレイテンシが短縮される傾向があります。 一方、最初のフェッチ結果は追加データが使用可能になるまで送信されないため、フェッチ・サイズを増やすと問合せの初期フェッチの結果のレイテンシが増大します。
D.12 HS_TIME_ZONE
プロパティ | 説明 |
---|---|
[+|-]hh:mmのデフォルト値 |
|
[+|-]hh:mmの値の範囲 |
有効な日時書式マスク |
現在のSQLセッションに対応するデフォルトのローカル・タイムゾーンの置換を指定します。 書式マスク[+|-]hh:mmは、UTC(協定世界時、旧称グリニッジ標準時)の前後の時間および分を示すために指定します。 次に例を示します。
HS_TIME_ZONE = [+ | -] hh:mm
D.13 HS_TRANSACTION_MODEL
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle以外のデータベースがトランザクションによって更新されるときに使用されるトランザクション・モデルのタイプを指定します。
次の値を指定できます。
-
COMMIT_CONFIRM
は、Oracle以外のデータベースへの読取りおよび書込みアクセスを提供し、ゲートウェイを分散更新の一部として使用できるようにします。 Commit-Confirmモデルを使用するには、Oracle以外のデータベースに次のアイテムを作成する必要があります:-
トランザクション・ログ表。 デフォルトの表名は
HS_TRANSACTION_LOG
です。HS_FDS_TRANSACTION_LOG
パラメータを使用して別の名前を設定できます。 トランザクション・ログ表には、パブリックに設定されたSELECT
、DELETE
およびINSERT
権限を付与する必要があります。 -
リカバリ・アカウント。 アカウント名は、
HS_FDS_RECOVERY_ACCOUNT
パラメータで割り当てます。 -
リカバリ・アカウント・パスワード。 パスワードは、
HS_FDS_RECOVERY_PWD
パラメータで割り当てます。
-
-
READ_ONLY
は、Oracle以外のデータベースに対する読取りアクセスを提供します。 -
SINGLE_SITE
は、Oracle以外のデータベースに対する読取り/書込みアクセスを提供します。 ただし、ゲートウェイを分散更新に加えることはできません。 -
READ_ONLY_AUTOCOMMIT
は、ロギングを使用しないOracle以外のデータベースへの読取り専用アクセスを提供します。 -
SINGLE_SITE_AUTOCOMMIT
は、ロギングなしでOracle以外のデータベースへの読取りおよび書込みアクセスを提供します。 ゲートウェイは分散アップデートに参加できません。 さらに、Oracle以外のデータベースへの更新はただちにコミットされます。
D.14 IFILE
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
有効なパラメータ・ファイル名 |
IFILE
初期化パラメータを使用して、現在の初期化ファイル内に別の初期化ファイルを埋め込みます。 値は絶対パスである必要があり、環境変数を含めることはできません。 3レベルのネスト制限は適用されません。
関連項目:
D.15 HS_FDS_TIMESTAMP_MAPPING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
CHAR
に設定すると、Oracle以外のターゲット・タイムスタンプはCHAR(26)
にマップされます。 DATE
(デフォルト)に設定すると、Oracle以外のターゲット・タイムスタンプはOracle DATE
にマップされます。 TIMESTAMP
に設定すると、Oracle以外のターゲット・タイムスタンプはOracle TIMESTAMP
にマップされます。
D.16 HS_FDS_DATE_MAPPING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
CHAR
に設定すると、Oracle以外のターゲット日付はCHAR(10)
にマップされます。 DATE
に設定すると、Oracle以外のターゲット日付はOracleの日付にマップされます。
D.17 HS_FDS_CONNECT_INFO
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
該当なし |
Oracle以外のシステムへの接続を記述するHS_FDS_CONNECT_INFO
。
デフォルトの初期化パラメータ・ファイルには、このパラメータのエントリがすでに含まれています。 ゲートウェイのHS_FDS_CONNECT_INFO
の構文は、次のとおりです。
HS_FDS_CONNECT_INFO=host_alias:port_number[/database_name]
ここで、host_alias
はTeradataデータベースをホストしているマシンのホスト別名またはIPアドレス、port_number
はTeradataデータベース・サーバーのポート番号、database_name
はTeradataデータベース名です。 database_name
変数はオプションです。
このリリースではIPv6形式がサポートされているため、hostname
の代わりにIPv6形式を入力できますが、IPv6仕様を大カッコで囲む必要があります。
次に例を示します。
HS_FDS_CONNECT_INFO=[2001:0db8:20c:f1ff:fec6:38af]:port_number/…
D.18 HS_FDS_DEFAULT_OWNER
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
該当なし |
SQL文に所有者が指定されない場合に、Oracle以外のデータベース表で使用される表の所有者の名前です。
注意:
このパラメータが指定されず、所有者がSQL文に明示的に指定されていない場合、Oracleユーザーのユーザー名またはデータベース・リンクの作成時に指定されたユーザー名が使用されます。
D.19 HS_FDS_TRANSACTION_ISOLATION
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
{ |
構文 |
|
HS_FDS_TRANSACTION_ISOLATION
は、ゲートウェイがOracle以外のデータベースでオープンするトランザクションに使用される分離レベルを指定します。
READ_UNCOMMITTED
、READ_COMMITTED
、REPEATABLE_READ
、およびSERIALIZABLE
の分離レベルは、SQL標準で定義され、ANSIとISO/IECの両方で採用されている4つの分離レベルです。 それらの追加情報については、「Oracle Databaseの概念」を参照してください。
ゲートウェイ・トランザクションは、Oracleデータベース・トランザクションで発生する可能性のある予防可能読み取り現象とは異なるため、使用されているOracleトランザクション分離レベルより低い分離レベルを指定する場合は注意が必要です。
D.20 HS_FDS_PROC_IS_FUNC
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
関数からの戻り値を使用できるようにします。 デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに戻り値を返しません。
注意:
この初期化パラメータを設定する場合、すべての既存のストアド・プロシージャについて、戻り値を処理するようにプロシージャ実行文の構文を変更する必要があります。
D.21 HS_FDS_RECOVERY_ACCOUNT
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
任意の有効なユーザーID |
コミット確認トランザクション・モデルに使用するリカバリ・アカウントの名前を指定します。 ユーザー名とパスワードを備えたアカウントをOracle以外のシステムで設定する必要があります。 コミット確認モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
リカバリ・アカウントの名前では、大/小文字が区別されます。
D.22 HS_FDS_RECOVERY_PWD
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
任意の有効なパスワード |
Oracle以外のシステムで設定されたコミット確認トランザクション・モデルで使用されるリカバリ・アカウントのパスワードを指定します。 コミット確認モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
リカバリ・アカウントのパスワード名では、大/小文字が区別されます。
D.24 HS_FDS_TRANSACTION_LOG
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
有効な表名 |
Oracle以外のシステムでトランザクション・ロギング用に作成される表の名前を指定します。 トランザクション・モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
D.27 HS_NLS_LENGTH_SEMANTICS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
D.28 HS_KEEP_REMOTE_COLUMN_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
パラメータ・タイプ |
String |
HS_KEEP_REMOTE_COLUMN_SIZE
は、Oracle以外のデータベースからゲートウェイへ、次にOracleデータベースへのデータ変換時に(VAR)CHAR
データ型の長さを計算する際に比率拡張を抑制するかどうかを指定します。 REMOTE
に設定すると、Oracle以外のデータベースとゲートウェイの間の拡張は抑制されます。 LOCAL
に設定すると、ゲートウェイとOracleデータベース間の拡張が抑制されます。 ALL
に設定すると、Oracle以外のデータベースからOracleデータベースへの展開が抑制されます。
このパラメータを設定すると、リモート・カラム・サイズをレポートし、暗黙の結果として生じるバッファ・サイズを計算し、ローカルのOracleデータベースでインスタンス化するときに、展開が抑制されます。 これは、Oracle以外のデータベースからOracleデータベースへのリモート・カラム・サイズに対してのみ有効です。 ゲートウェイがWindowsおよびHS_LANGUAGE=AL32UTF8
で実行されている場合は、このパラメータを指定しないでください。このパラメータは、他の比率関連のパラメータ操作に影響します。 INSERT
、UPDATE
、またはDELETE
の間に、OracleデータベースからOracle以外のデータベースに移動するデータの比率をゲートウェイ経由で計算することは効果がありません。
D.29 HS_FDS_REMOTE_DB_CHARSET
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
該当なし |
構文 |
|
このパラメータは、HS_LANGUAGE
がAL32UTF8
に設定され、ゲートウェイがWindowsで実行されている場合にのみ有効です。 データベース・キャラクタ・セットとしてUnicodeを使用するOracleデータベースとOracle以外のデータベースが増えているため、ゲートウェイもUnicodeキャラクタ・セットで実行することをお薦めします。 そのためには、HS_LANGUAGE=AL32UTF8
を設定する必要があります。 ただし、ゲートウェイがWindowsで実行される場合、Microsoft ODBCドライバ・マネージャ・インタフェースはダブルバイト・キャラクタ・セットUCS2でのみデータを交換できます。 これにより、説明されているバッファおよび列サイズの比率が拡大します。 これを補うために、HS_FDS_REMOTE_DB_CHARSET
が対応するOracle以外のデータベース・キャラクタ・セットに設定されている場合、ゲートウェイは列サイズを再調整できます。 たとえば、HS_FDS_REMOTE_DB_CHARSET=KO16KSC5601
です。
D.30 HS_FDS_SUPPORT_STATISTICS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
デフォルトでは、Oracle以外のデータベースから統計を収集します。 HS_FDS_SUPPORT_STATISTICS
パラメータをFALSE
に設定すると、リモート・データベース統計の収集を無効にすることができます。
D.31 HS_FDS_ARRAY_EXEC
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
TRUE
に設定されている場合、ゲートウェイはリモート・データ・ソースに対するバインドを含むinsert、update、delete文に対して配列操作を使用します。 配列のサイズは、HS_FDS_FETCH_ROWS
initパラメータの値によって決まります。
FALSE
に設定されている場合、ゲートウェイは挿入、更新、および削除文に対して配列操作を使用しません。 代わりに、すべての値に対して1つの文が発行されます。