C 初期化パラメータ
init.ora
ファイルのOracle Database初期化パラメータは、ゲートウェイ初期化パラメータと異なります。エージェント固有のメカニズムを使用して初期化パラメータ・ファイルにゲートウェイ・パラメータを設定するか、DBMS_HS
パッケージを使用してOracleデータ・ディクショナリにゲートウェイ・パラメータを設定します。ゲートウェイ初期化パラメータ・ファイルは、ゲートウェイの起動時に使用可能である必要があります。初期化パラメータに加えた変更は、次のゲートウェイ・セッションまで反映されません。
次のトピックには、ゲートウェイごとに設定可能なゲートウェイ初期化パラメータのリストとその説明が含まれます。また、初期化パラメータ・ファイルの構文についても説明します。
初期化パラメータ・ファイルの構文
初期化パラメータ・ファイルの構文は次のとおりです。
-
ファイルは一連のコマンドで構成されています。
-
各コマンドは、個別の行で始まる必要があります。
-
行の終わりは、コマンド終端文字で認識されます(円記号でエスケープされない場合)。
-
初期化パラメータ・ファイルに構文エラーがあると、設定はすべて無効です。
-
パラメータ値は次のように設定します。
[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に転送されず、動的パフォーマンス・ビューやグラフィカル・ユーザー・インタフェースにも表示されません)。 -
Oracle Database Gateway for Sybaseの初期化パラメータ
この項では、Oracle Database Gateway for Sybaseで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
Oracle Database Gateway for Informixの初期化パラメータ
この項では、Oracle Database Gateway for Informixで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
Oracle Database Gateway for Teradataの初期化パラメータ
この項では、Oracle Database Gateway for Teradataで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
Oracle Database Gateway for SQL Serverの初期化パラメータ
この項では、Oracle Database Gateway for SQL Serverで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
Oracle Database Gateway for ODBCの初期化パラメータ
この項では、Oracle Database Gateway for ODBCで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
Oracle Database Gateway for DRDAの初期化パラメータ
この項では、Oracle Database Gateway for DRDAで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。
HS_CALL_NAME
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
該当なし |
SQL文で参照できるリモート・ファンクションを指定します。値は、リモート・ファンクションとその所有者をセミコロンで区切った次の形式のリストです。
owner_name.function_name
次に例を示します。
owner1.A1;owner2.A2;owner3.A3
リモート・ファンクションに所有者名が指定されていない場合、デフォルトの所有者名がリモート・データベースへの接続に使用されるユーザー名になります(この名前は、異機種間サービス・データベース・リンクの作成時に指定されたものですが、DBリンクで指定されていない場合はユーザー・セッションから取得されます)。
所有者名およびファンクション名のエントリでは、大/小文字が区別されます。
HS_DB_DOMAIN
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
1から199文字 |
Oracle以外のシステムにおける一意のネットワーク・サブアドレスを指定します。HS_DB_DOMAIN
初期化パラメータは、Oracle Databaseリファレンスで説明されているDB_DOMAIN
初期化パラメータと同様です。HS_DB_DOMAIN
初期化パラメータは、Oracle Names Serverを使用する場合は必須です。HS_DB_NAME
およびHS_DB_DOMAIN
初期化パラメータでは、Oracle以外のシステムのグローバル名を定義します。
注意:
コオペラティブ・サーバー環境では、HS_DB_NAME
およびHS_DB_DOMAIN
初期化パラメータを組み合せて一意のアドレスを構成する必要があります。
HS_DB_INTERNAL_NAME
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
1から16の16進文字 |
異機種間サービス・エージェントの接続先となるインスタンスを識別する一意の16進数を指定します。このパラメータの値は、グローバル・ネーム・サービスがアクティブ化されたときにトランザクションIDの一部として使用されます。一意でない数値を指定すると、トランザクションで2フェーズ・コミットのリカバリ・アクションが必要な場合に問題が発生する可能性があります。
HS_LANGUAGE
プロパティ | 説明 |
---|---|
デフォルト値 |
システム固有 |
値の範囲 |
任意の有効な言語名(最大255文字) |
異機種間サービスに、Oracle以外のデータソースのキャラクタ・セット、言語および地域情報を提供します。値には次の書式を使用する必要があります。
language[_territory.character_set]
注意:
グローバリゼーション・サポートの初期化パラメータは、エラー・メッセージ、SQLサービスのデータ、および分散外部プロシージャのパラメータに影響します。
キャラクタ・セット
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」を参照してください。
言語
HS_LANGUAGE
初期化パラメータの言語構成要素により、次の項目が決定されます。
-
日付の月日の名前
-
日時に対するAD、BC、PMおよびAMの記号
-
デフォルトのソート・メカニズム
Oracleでは、異機種間サービスの汎用メッセージに対応するエラー・メッセージ(ORA-25000
からORA-28000
)の言語は決定されません。これらは、Oracle Databaseのセッション設定により制御されます。
HS_LONG_PIECE_TRANSFER_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
64 KB |
値の範囲 |
2GB以下の任意の値 |
転送されるLONG
データのピース・サイズを設定します。ピース・サイズを小さくすると、メモリー要件は減少しますが、すべてのデータをフェッチするためのラウンドトリップ回数は増加します。ピース・サイズを大きくすると、ラウンドトリップ回数は減少しますが、内部的に中間ピースを格納するためのメモリー要件は増大します。つまり、この初期化パラメータは、ラウンドトリップ回数とメモリー要件(およびネットワーク待機時間またはレスポンス時間)の最適なトレードオフ関係に基づいて、最高のパフォーマンスを発揮するようにシステムをチューニングする場合に使用します。
HS_OPEN_CURSORS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle以外のシステムのインスタンスに対する1つの接続でオープンできるカーソルの最大数を定義します。
この値は、Oracle Databaseのオープン・カーソルの数を超えることはできません。そのため、Oracle DatabaseのOPEN_CURSORS
初期化パラメータと同じ値を設定することをお薦めします。
HS_RPC_FETCH_REBLOCKING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle DatabaseとOracle以外のデータ・ストアに接続された異機種間サービス・エージェントとの間におけるデータ転送のパフォーマンスを異機種間サービスにより最適化するかどうかを制御します。
次の値を指定できます。
-
OFF
を指定すると、エージェントからサーバーにデータを即座に送信するように、フェッチされたデータの再ブロッキングが無効化されます。 -
ON
では再ブロック化が可能です。これは、Oracle以外のシステムからフェッチされたデータがエージェントにバッファされ、フェッチされたデータの量がHS_RPC_FETCH_SIZE
初期化パラメータの値以上になるまでOracleデータベースに送信されないことを意味します。ただし、フェッチでそれ以上データが存在しないことが示された場合、またはOracle以外のシステムがエラーをレポートした場合は、バッファされたデータが即時に返されます。
HS_RPC_FETCH_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
1から10000000 |
内部データ・バッファリングを調整して、サーバーとエージェント・プロセス間のデータ転送レートを最適化します。
値を増やすと、指定されたデータ量を転送するために必要なネットワークのラウンドトリップの回数が減りますが、データ帯域幅が増え、問合せの発行から問合せのすべてのフェッチの完了までとして測定されるレイテンシが短縮される傾向があります。一方、最初のフェッチ結果は追加データが使用可能になるまで送信されないため、フェッチ・サイズを増やすと問合せの初期フェッチの結果のレイテンシが増大します。
HS_FDS_SHAREABLE_NAME
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
適用なし |
ODBCドライバ・マネージャのフルパス名を指定します。
このパラメータは、必須パラメータです。形式は次のとおりです。
HS_FDS_SHAREABLE_NAME=odbc_installation_path/lib/libodbc.sl
説明:
odbc_installation_path
は、ODBCドライバのインストール先のパスです。
HS_TIME_ZONE
プロパティ | 説明 |
---|---|
[+|-]hh:mmのデフォルト値 |
|
[+|-]hh:mmの値の範囲 |
有効な日時書式マスク |
現在のSQLセッションに対応するデフォルトのローカル・タイムゾーンの置換を指定します。書式マスク[+|-]hh:mmは、UTC(協定世界時、旧称グリニッジ標準時)の前後の時間および分を示すために指定します。次に例を示します。
HS_TIME_ZONE = [+ | -] hh:mm
HS_TRANSACTION_MODEL
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle以外のデータベースがトランザクションによって更新されるときに使用されるトランザクション・モデルのタイプを指定します。
次の値を指定できます。
-
COMMIT_CONFIRM
は、Oracle以外のデータベースに対する読取りおよび書込みアクセス権を付与し、ゲートウェイを分散更新に加えることができます。コミット確認モデルを使用するには、次のものをOracle以外のデータベースに作成する必要があります。-
トランザクション・ログ表。デフォルトの表名は
HS_TRANSACTION_LOG
です。HS_FDS_TRANSACTION_LOG
パラメータを使用して別の名前を設定できます。トランザクション・ログ表には、パブリックに設定されたSELECT
、DELETE
およびINSERT
権限を付与する必要があります。 -
リカバリ・アカウント。アカウント名は、
HS_FDS_RECOVERY_ACCOUNT
パラメータで割り当てます。 -
リカバリ・アカウントのパスワード。パスワードは、
HS_FDS_RECOVERY_PWD
パラメータで割り当てます。COMMIT_CONFIRM
は、Oracle Database Gateway for ODBCには適用されません。Oracle Database Gateway for ODBCのデフォルト値は、SINGLE_SITE
です。
-
-
READ_ONLY
は、Oracle以外のデータベースに対する読取りアクセスを提供します。 -
READ_ONLY_AUTOCOMMIT
は、ロギングされていないOracle以外のデータベースへの読取りアクセスを提供します。READ_ONLY_AUTOCOMMITは、Oracle Database Gateway for ODBCには適用されません。 -
SINGLE_SITE
は、Oracle以外のデータベースに対する読取り/書込みアクセスを提供します。ただし、ゲートウェイを分散更新に加えることはできません。 -
SINGLE_SITE_AUTOCOMMIT
は、ロギングされていないOracle以外のデータベースに対する読取り/書込みアクセスを提供します。更新は即時にコミットされ、ゲートウェイを分散更新に加えることはできません。SINGLE_SITE_AUTOCOMMITは、Oracle Database Gateway for ODBCには適用されません。
IFILE
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
有効なパラメータ・ファイル名 |
IFILE
初期化パラメータを使用して、現在の初期化ファイル内に別の初期化ファイルを埋め込みます。値は絶対パスである必要があり、環境変数を含めることはできません。3レベルのネスト制限は適用されません。
関連項目:
HS_FDS_CONNECT_INFO
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
適用なし |
HS_FDS_CONNECT_INFO
では、Oracle以外のシステムに対する接続を記述します。
デフォルトの初期化パラメータ・ファイルには、このパラメータのエントリがすでに含まれています。このリリースのゲートウェイでは、IPv6をサポートできます。IPv6アドレス形式を指定する場合は、ポート番号との分離を示すために、IPv6仕様を角カッコで囲む必要があります。ゲートウェイのHS_FDS_CONNECT_INFO
の構文は、次のとおりです。
Oracle Database Gateway for Sybaseの場合:
HS_FDS_CONNECT_INFO=host_name:port_number/database_name
ここで、host_name
はSybaseデータベースをホストするマシンのホスト名またはIPアドレス、port_number
はSybaseデータベース・サーバーのポート番号、database_name
はSybaseデータベースの名前です。
Oracle Database Gateway for Informixの場合:
HS_FDS_CONNECT_INFO=host_name:port_number/server_name/database_name
ここで、host_name
はInformixデータベースをホストするマシンのホスト名またはIPアドレス、port_number
はInformixデータベース・サーバーのポート番号、server_name
はInformixデータ用のサーバー・マシンの名前、database_name
はInformixデータベースの名前です。
Oracle Database Gateway for Teradataの場合:
HS_FDS_CONNECT_INFO=host_alias:port_number[/database_name]
ここで、host_alias
はTeradataデータベースをホストするマシンのホスト・エイリアス名またはIPアドレス、port_number
はTeradataデータベース・サーバーのポート番号、database_name
はTeradataデータベースの名前です。database_name
変数はオプションです。
Oracle Database Gateway for SQL Serverの場合:
HS_FDS_CONNECT_INFO= host_name/[instance_name][/database_name]
ここで、host_name
はSQL Serverデータベースをホストするマシンのホスト名またはIPアドレス、instance_name
はマシンで稼働するSQL Serverのインスタンス、database_name
はSQL Serverデータベースの名前です。instance_name
とdatabase_name
は両方ともオプションです。instance_name
を省略してdatabase_name
を指定する場合、スラッシュ(/
)が必要です。つまり、次のようになります。
HS_FDS_CONNECT_INFO= host_name//database_name
Oracle Database Gateway for ODBCの場合:
HS_FDS_CONNECT_INFO=dsn_value
ここで、dsn_valueは、Microsoft WindowsのODBCデータソース アドミニストレータで定義したシステムDSNの名前です。
Oracle Database Gateway for DRDAの場合:
HS_FDS_CONNECT_INFO=IP_address:Port_number/Database_name,Type
IP_address
は、DB2 DRDAサーバーのホスト名またはIPアドレスです。
Port_number
は、DB2 DRDAサーバーのポート番号です。
Database_name
は、DB2サーバーのデータベース名です。
Type
(大/小文字を区別しない)は次のいずれかです。
-
ZOS (DB2 UDB for z/OS)、
-
IOS (DB2 UDB for iSeries)、または
-
LUW (DB2 UDB for Linux, UNIX, and Windows)
次に例を示します。
HS_FDS_CONNECT_INFO=[2001:0db8:20C:F1FF:FEC6:38AF]:1300/DB2M,ZOS
HS_FDS_PROC_IS_FUNC
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
関数からの戻り値を使用できるようにします。デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに戻り値を返しません。
注意:
この初期化パラメータを設定する場合、すべての既存のストアド・プロシージャについて、戻り値を処理するようにプロシージャ実行文の構文を変更する必要があります。
HS_FDS_RECOVERY_ACCOUNT
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
任意の有効なユーザーID |
コミット確認トランザクション・モデルに使用するリカバリ・アカウントの名前を指定します。ユーザー名とパスワードを備えたアカウントをOracle以外のシステムで設定する必要があります。コミット確認モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
DRDAの場合、HS_FDS_RECOVERY_ACCOUNT
は、分散トランザクションがインダウト状態になった場合にゲートウェイで使用されるユーザーIDを指定します。このユーザーIDは、パッケージに対する実行権限を持っている必要があり、IBMデータベースに定義されている必要があります。
分散トランザクションがインダウト状態になると、Oracle Databaseは、HS_FDS_RECOVERY_ACCOUNT
を使用してIBMデータベースに接続し、トランザクションのステータスを確認します。このパラメータが存在しない場合、ゲートウェイはRECOVER
のユーザーIDへの接続を試みます。
リカバリ・アカウントの名前では、大/小文字が区別されます。
HS_FDS_RECOVERY_PWD
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
任意の有効なパスワード |
Oracle以外のシステムで設定されたコミット確認トランザクション・モデルで使用されるリカバリ・アカウントのパスワードを指定します。コミット確認モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
HS_FDS_RECOVERY_PWD
は、HS_FDS_RECOVERY_ACCOUNT
とともに使用されます。リカバリ・ユーザーは、分散トランザクションがインダウト状態になった場合にOracle以外のデータベースに接続します。
リカバリ・アカウントのパスワード名では、大/小文字が区別されます。
HS_FDS_RESULTSET_SUPPORT
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
ストアド・プロシージャから返される結果セットを使用できるようにします。デフォルトでは、すべてのストアド・プロシージャは、ユーザーに結果セットを返しません。
注意:
この初期化パラメータを設定する場合、次の作業をする必要があります。
-
すべての既存のストアド・プロシージャについて、結果セットを処理するようにプロシージャ実行文の構文を変更します。
-
異機種間サービスのシーケンシャル・モードで作業します。
HS_FDS_TRANSACTION_LOG
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
有効な表名 |
Oracle以外のシステムでトランザクション・ロギング用に作成される表の名前を指定します。トランザクション・モデルの詳細は、HS_TRANSACTION_MODEL
パラメータを参照してください。
HS_FDS_REPORT_REAL_AS_DOUBLE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
Oracle Database Gateway for SQL Server、Oracle Database Gateway for ODBCおよびOracle Database Gateway for SybaseでSINGLE FLOAT PRECISION
フィールドをDOUBLE FLOAT PRECISION
フィールドとして処理できるようにします。
HS_FDS_CAPABILITY
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
Oracle Database Gateway for DRDAユーザーズ・ガイドの第4章「アプリケーションの開発」を参照 |
構文 |
|
HS_FDS_ISOLATION_LEVEL
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
{ |
構文 |
|
HS_FDS_ISOLATION_LEVEL
では、作成時にパッケージに対して定義される分離レベルを指定します。リモートDRDAデータベースに送信されるすべてのSQL文は、この分離レベルで実行されます。分離レベルは、アプリケーションのパフォーマンスに大きく影響します。デフォルト以外の分離レベルを指定する場合は、慎重に行ってください。分離レベルの詳細は、IBM社のデータベース・マニュアルを参照してください。
次の表に、分離レベルとその説明を示します。このレベルは、制御の少ない順に並んでいます(CHG
はカーソル固定の信頼性が最も低く、RR
は最も高くなっています)。固定度が高くなるほど、サーバー上のリソースをより多く使用し、長期間にわたりそれらのリソースをロックする可能性があることに注意してください。
HS_FDS_PACKAGE_COLLID
HS_IDLE_TIMEOUT
プロパティ | 説明 |
---|---|
デフォルト値 |
0 (タイムアウトなし) |
値の範囲 |
0-9999 (分) |
構文 |
|
この機能は、Oracle Net TCPプロトコルでのみ使用できます。
ここで指定された期間、接続されたゲートウェイ・セッションのアクティビティがない場合、ゲートウェイ・セッションは保留中の更新(存在する場合)をロールバックして自動的に終了します。
HS_FDS_MBCS_TO_GRAPHIC
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
TRUE
に設定されている場合、DB2 (var)graphic列に挿入されるようになっている任意のシングルバイト・キャラクタは、挿入操作前に同等のダブルバイト値に変換されます。
HS_FDS_GRAPHIC_TO_MBCS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
TRUE
に設定されている場合、同等のシングルバイト文字を持つことができるDB2 (var)graphic列にダブルバイト文字を使用すると、ユーザーに送信される前に同等のシングルバイトに変換されます。
HS_FDS_TIMESTAMP_MAPPING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
CHAR
に設定されている場合、Oracle以外のターゲット・タイムスタンプはCHAR(26)
にマップされます。DATE
(デフォルト)に設定されている場合、Oracle以外のターゲット・タイムスタンプはOracle DATE
にマップされます。TIMESTAMP
に設定されている場合、Oracle以外のターゲット・タイムスタンプはOracle TIMESTAMP
にマップされます。
HS_FDS_DATE_MAPPING
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
CHAR
に設定されている場合、Oracle以外のターゲット日付はCHAR(10)
にマップされます。DATE
に設定されている場合、Oracle以外のターゲット日付はOracle Dateにマップされます。
HS_FDS_ARRAY_EXEC
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
TRUE
に設定されている場合、ゲートウェイは配列操作を使用して、リモート・データ・ソースに対するバインドを含む文を挿入、更新、削除します。配列のサイズは、HS_FDS_FETCH_ROWS
初期化パラメータの値によって決まります。
FALSE
に設定されている場合、ゲートウェイは文の挿入、更新および削除に配列操作を使用しません。かわりに、値ごとに1つの文が発行されます。
HS_FDS_QUOTE_IDENTIFIER
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
デフォルトでは、FDSでサポートされている場合、ゲートウェイは、識別子を引用符で囲みます。ただし、ユーザーはこの動作を上書きできます。HS_FDS_QUOTE_IDENTIFIER
は、指定された値に応じて、引用符付きの識別子をサポートできるよう、ターゲットの機能をオーバーライドします。
HS_NLS_LENGTH_SEMANTICS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
このリリースのゲートウェイでは、Oracleデータベース・キャラクタ・セマンティクスと同等のキャラクタ・セマンティクス機能、つまり、NLS_LENGTH_SEMANTICS
.が含まれています。HS_NLS_LENGTH_SEMANTICS
がCHAR
に設定されている場合、Oracle以外のデータベースの(VAR)CHAR
列はCHAR
セマンティクスを持つものとして解釈されます。ゲートウェイでHS_NLS_LENGTH_SEMANTICS=CHAR
設定が使用されない唯一の状況は、Oracleとゲートウェイの両方で同じマルチバイト・キャラクタ・セットが使用されている場合です。
HS_KEEP_REMOTE_COLUMN_SIZE
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
パラメータ・タイプ |
文字列 |
HS_KEEP_REMOTE_COLUMN_SIZE
は、Oracle以外のデータベースからOracleデータベースへのデータ変換中に(VAR)CHAR
データ型の長さを計算する際に比率の拡大を抑制するかどうかを指定します。REMOTE
に設定されている場合は、Oracle以外のデータベースとゲートウェイの間で拡大が抑制されます。LOCAL
に設定されている場合は、ゲートウェイとOracleデータベースの間で拡大が抑制されます。ALL
に設定されている場合は、Oracle以外のデータベースからOracleデータベースの場合に拡大が抑制されます。
パラメータを設定した場合、リモート列サイズの報告、暗黙的な結果のバッファ・サイズの計算、およびローカルOracleデータベースでの初期化の際に拡大が抑制されます。ゲートウェイがWindowsとHS_LANGUAGE=AL32UTF8
で実行されている場合は、他の比率に関連するパラメータの操作に影響があるため、このパラメータを指定する必要はありません。これは、Oracle以外のデータベースからOracleデータベースの場合のリモート列サイズにのみ影響します。これは、INSERT
、UPDATE
またはDELETE
の操作時にゲートウェイを介してOracleデータベースからOracle以外のデータベースに移動するデータの比率の計算には影響しません。
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
などです。
HS_FDS_SUPPORT_STATISTICS
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
デフォルトでは、Oracle以外のデータベースの統計を収集します。HS_FDS_SUPPORT_STATISTICS
パラメータをFALSE
に設定することで、リモート・データベース統計の収集を無効にするよう選択できます。
HS_FDS_RSET_RETURN_ROWCOUNT
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
TRUE
に設定されている場合、ゲートウェイは、ストアド・プロシージャ内で実行されたDML文の行数を返します。行数は、符号付き整数型の単一行、単一列の結果セットとして返されます。
FALSE
に設定されている場合、ゲートウェイは、ストアド・プロシージャ内で実行されたDML文の行数をスキップします。これはデフォルト動作であり、11.1以前のゲートウェイの動作です。
HS_FDS_SQLLEN_INTERPRETATION
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
このパラメータは、64ビット・プラットフォームでのみ有効です。ODBC標準は、64ビット・プラットフォームで(内部ODBCコンストラクトの) SQLLEN
を64ビットとして指定しますが、一部のODBCドライバ・マネージャおよびドライバはこの規則に違反し、32ビットとして実装します。ゲートウェイが動作を補正できるように、これらのタイプのドライバ・マネージャおよびドライバを使用する場合はHS_FDS_SQLLEN_INTERPRETATION=32
を指定する必要があります。
HS_FDS_AUTHENTICATE_METHOD
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
ユーザーIDとパスワードをリモートDB2サーバーに送信して認証を行う方法を指定します。有効な値は次のとおりです。
-
CLEARTEXT
: ユーザーIDとパスワードがクリアテキストでサーバーに送信されます(デフォルト)。 -
ENCRYPT
: パスワードが暗号化されてサーバーに送信されます。 -
ENCRYPT_BOTH
: ユーザーIDとパスワードが暗号化されてサーバーに送信されます。 -
CLIENT
: サーバーではなくクライアント側でユーザーIDが検証されます。 -
KERBEROS
: ユーザーIDの認証にKerberosを使用します。
HS_FDS_ENCRYPT_SESSION
プロパティ | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
|
構文 |
|
DB2へのセッションを暗号化する方法を指定します。有効な値は次のとおりです。
-
NONE
: データ・セッションは暗号化されません(デフォルト)。 -
SSL
: SSLを使用してデータ・セッションを暗号化します(DB2for iSeriesでのみサポートされています)。 -
DB2
: データ・セッションにDB2暗号化プロトコルを使用します(DB2 for LUWおよびDB2 for z/OSの場合にのみサポートされ、認証がCLEARTEXT
、ENCRYPT
またはENCRYPT_BOTH
である場合にのみ使用できます)。
HS_FDS_TRUSTSTORE_FILE
プロパティ | 説明 |
---|---|
デフォルト値 |
なし |
値の範囲 |
|
構文 |
|
トラストストア・ファイルの場所を示すパスを指定します。トラストストア・ファイルには、SSLサーバー認証のクライアント・マシンで信頼されている有効な認証局(CA)のリストが含まれます。