この章では、tnsnames.oraファイルの構成パラメータの完全なリストを提供します。
ここでは、次の項目について説明します。
このtnsnames.oraファイルは、ローカル・ネーミング・メソッドの接続記述子にマップされるネット・サービス名、またはリスナーのプロトコル・アドレスにマップされるネット・サービス名が含まれた構成ファイルです。
ネット・サービス名は、接続記述子に含まれているデータベース・ネットワーク・アドレスにマップされる別名です。接続記述子には、プロトコル・アドレスによるリスナーの位置、および接続先データベースのサービス名が含まれています。(他のデータベース・サーバーのクライアントである)クライアントとデータベース・サーバーは、アプリケーションとの接続時にネット・サービス名を使用します。
デフォルトで、tnsnames.oraファイルはORACLE_HOME/network/adminディレクトリに配置されます。Oracle Netはこの構成ファイルを探すために他のディレクトリを確認することもあります。たとえば、次の順序でtnsnames.oraファイルを確認します。
環境変数TNS_ADMINで指定されたディレクトリ。指定されたディレクトリにファイルがない場合、ファイルは存在しないとみなされます。
TNS_ADMIN環境変数が設定されていない場合、Oracle NetはORACLE_HOME/network/adminディレクトリを確認します。
|
注意: Microsoft Windowsでは、プロセスの環境で設定されている場合、TNS_ADMIN環境変数が使用されます。環境でTNS_ADMIN環境変数が定義されていない場合、またはプロセスが環境のないサービスの場合、レジストリがスキャンされTNS_ADMINパラメータが検索されます。 |
|
関連項目: オペレーティング・システム固有のOracleドキュメントを参照してください。 |
tnsnames.oraファイルの基本的な構文は、例6-1のとおりです。
例6-1 tnsnames.oraファイルの基本的な書式
net_service_name= (DESCRIPTION=(ADDRESS=(protocol_address_information))(CONNECT_DATA= (SERVICE_NAME=service_name)))
この例では、DESCRIPTIONには接続記述子、ADDRESSにはプロトコル・アドレス、CONNECT_DATAにはデータベース・サービス識別情報が含まれています。
tnsnames.oraファイルには、1つ以上の接続記述子を持つネット・サービス名を含めることができます。各接続記述子には、1つ以上のプロトコル・アドレスを含めることができます。例6-2には、複数のアドレスを持つ2つの接続記述子が示されています。DESCRIPTION_LISTは、接続記述子のリストを定義します。
例6-2 tnsnames.ora内に複数の接続記述子を持つネット・サービス名
net_service_name= (DESCRIPTION_LIST= (DESCRIPTION= (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information)) (CONNECT_DATA= (SERVICE_NAME=service_name))) (DESCRIPTION= (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information)) (CONNECT_DATA= (SERVICE_NAME=service_name))))
|
注意: Oracle Connection Managerを使用している場合、Oracle Net Managerでは、1つのネット・サービス名に対する複数の接続記述子の作成はサポートしていません。 |
tnsnames.oraファイルは、それぞれ独自の特性を備えた複数のアドレス・リストを持つ接続記述子もサポートします。例6-3では、2つのアドレス・リストが示されています。最初のアドレス・リストには、クライアント・ロード・バランシングがあり、接続時フェイルオーバーがないという特徴があり、ADDRESS_LIST内のプロトコル・アドレスにのみ影響を与えます。2番目のプロトコル・アドレス・リストには、接続時フェイルオーバーがありクライアント・ロード・バランシングがないという特徴があり、ADDRESS_LIST内のプロトコル・アドレスにのみ影響を与えます。クライアントは、最初に第1または第2のプロトコル・アドレスを無作為に試行し、次に、第3および第4のプロトコル・アドレスを順に試行します。
例6-3 tnsnames.ora内の複数アドレス・リスト
net_service_name= (DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on) (FAILOVER=off) (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information))) (ADDRESS_LIST= (LOAD_BALANCE=off) (FAILOVER=on) (ADDRESS=(protocol_address_information)) (ADDRESS=(protocol_address_information))) (CONNECT_DATA= (SERVICE_NAME=service_name)))
tnsnames.oraファイル内の接続記述子にOracle Connection Managerのプロトコル・アドレスが少なくとも2つ含まれている場合、接続時フェイルオーバーとロード・バランシングのパラメータをファイル内に含めることができます。
例6-4では、複数のOracle Connection Managerプロトコル・アドレスのフェイルオーバーが示されています。
例6-4 tnsnames.ora内の複数Oracle Connection Managerアドレス
sample1=
(DESCRIPTION=
(SOURCE_ROUTE=yes)
(ADDRESS=(PROTOCOL=tcp)(HOST=host1)(PORT=1630)) # 1
(ADDRESS_LIST=
(FAILOVER=on)
(LOAD_BALANCE=off) # 2
(ADDRESS=(PROTOCOL=tcp)(HOST=host2a)(PORT=1630))
(ADDRESS=(PROTOCOL=tcp)(HOST=host2b)(PORT=1630)))
(ADDRESS=(PROTOCOL=tcp)(HOST=host3)(PORT=1521)) # 3
(CONNECT_DATA=(SERVICE_NAME=Sales.us.example.com)))
例6-4の構文では、次の処理が行われます。
次の記述によって、クライアントは、最初のOracle Connection Managerのプロトコル・アドレスに接続するように指示されます。
(ADDRESS=(PROTOCOL=tcp)(HOST=host1)(PORT=1630))
次に、最初のOracle Connection Managerは、別のOracle Connection Managerの第1プロトコル・アドレスに接続するように指示されます。第1プロトコル・アドレスへの接続に失敗した場合は、第2プロトコル・アドレスへの接続が試行されます。この順序は、次の構成によって指定されます。
(ADDRESS_LIST= (FAILOVER=ON) (LOAD_BALANCE=off) (ADDRESS=(PROTOCOL=tcp)(HOST=host2a)(PORT=1630)) (ADDRESS=(PROTOCOL=tcp)(HOST=host2b)(PORT=1630))
次に、Oracle Connection Managerは、次のプロトコル・アドレスを使用してデータベース・サービスに接続します。
(ADDRESS=(PROTOCOL=tcp)(HOST=host3)(PORT=1521))
例6-5では、2つのOracle Connection Managerと2つのプロトコル・アドレスのクライアント・ロード・バランシングが示されています。
例6-5 tnsnames.ora内のクライアント・ロード・バランシング
sample2=
(DESCRIPTION=
(LOAD_BALANCE=on) # 1
(FAILOVER=on)
(ADDRESS_LIST=
(SOURCE_ROUTE=yes)
(ADDRESS=(PROTOCOL=tcp)(HOST=host1)(PORT=1630)) # 2
(ADDRESS=(PROTOCOL=tcp)(HOST=host2)(PORT=1521)))
(ADDRESS_LIST=
(SOURCE_ROUTE=yes)
(ADDRESS=(PROTOCOL=tcp)(HOST=host3)(port=1630))
(ADDRESS=(PROTOCOL=tcp)(HOST=host4)(port=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com))) # 3
例6-5の構文では、次の処理が行われます。
クライアントは、ADDRESS_LISTを無作為に選択し、選択したADDRESS_LISTに障害がある場合、別のリストにフェイルオーバーするように指示されます。この指示は、LOAD_BALANCEパラメータとFAILOVERパラメータがonに設定されていることで示されます。
ADDRESS_LISTが選択されると、クライアントは、最初にそのADDRESS_LISTに指定されているポート1630を使用するOracle Connection Managerプロトコル・アドレスを使用して、Oracle Connection Managerに接続します。
次に、Oracle Connection Managerは、ADDRESS_LISTに指定されているプロトコル・アドレスを使用してデータベース・サービスに接続します。
各接続記述子は、DESCRIPTIONパラメータの中に組み込まれています。複数の接続記述子は、DESCRIPTION_LISTパラメータによって記述されます。これらのパラメータについては、この項で説明します。
用途
接続記述子のコンテナを指定します。このパラメータは、DESCRIPTION_LISTパラメータの下に配置します。
例
net_service_name= (DESCRIPTION= (ADDRESS=...) (CONNECT_DATA=(SERVICE_NAME=sales.us.example.com)))
tnsnames.oraファイルのプロトコル・アドレス・セクションは、リスナーのプロトコル・アドレスを指定します。リスナーのプロトコル・アドレスが1つのみの場合、ADDRESSパラメータを使用します。アドレスが複数ある場合は、ADDRESS_LISTパラメータを使用します。
用途
単一のリスナー・プロトコル・アドレスを定義します。このパラメータは、ADDRESS_LISTパラメータまたはDESCRIPTIONパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales-svr)(PORT=1521))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com))
用途
プロトコル・アドレスのリストを定義します。リスナーのプロトコル・アドレスが1つのみの場合、ADDRESS_LISTは不要です。このパラメータは、DESCRIPTIONパラメータまたはDESCRIPTION_LISTパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com)))
アドレスが複数の場合は、次のパラメータが使用可能です。
用途
接続文字列内のDESCRIPTIONパラメータの下に(ENABLE=broken)を埋め込むことにより、サポートされているTCP転送のキープアライブ機能をネット・サービス・クライアントに対して有効にできます。キープアライブ機能によって、コール元は終了したリモート・サーバーを検出できます。ただし、通常、通知に2時間以上かかります。クライアント側では、tcp_keepaliveのデフォルト値はoffです。オペレーティング・システムのTCP構成はプラットフォームによって異なりますが、実際のキープアライブ時間の詳細情報を定義します。
値
BROKEN
例
net_service_name=
(DESCRIPTION=
(ENABLE=broken)
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com))
複数のプロトコル・アドレスに対して接続時フェイルオーバーを使用可能または使用禁止にします。
このパラメータをon、yesまたはtrueに設定すると、Oracle Netは、接続時に最初のプロトコル・アドレスに障害があった場合に別のアドレスにフェイルオーバーします。このパラメータをoff、noまたはfalseに設定すると、Oracle Netは、1つのプロトコル・アドレスを使用します。
このパラメータは、DESCRIPTION_LISTパラメータ、DESCRIPTIONパラメータまたはADDRESS_LISTパラメータの下に配置します。
|
重要: listener.oraのSID_LIST_listener_nameセクションには、GLOBAL_DBNAMEパラメータを設定しないでください。静的に構成されたグローバル・データベース名では、接続時フェイルオーバーは無効になります。 |
デフォルト
on: DESCRIPTION_LIST、DESCRIPTIONおよびADDRESS_LISTの場合
値
yes | on | true
no | off | false
例
net_service_name=
(DESCRIPTION=
(FAILOVER=on)
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com)))
用途
複数のプロトコル・アドレスに対してクライアント・ロード・バランシングを使用可能または使用禁止にします。
このパラメータをon、yesまたはtrueに設定すると、Oracle Netは、無作為の順序でアドレスのリストを進み、各種リスナーまたはOracle Connection Managerのプロトコル・アドレスにかかる負荷を均衡化します。このパラメータをoff、noまたはfalseに設定すると、Oracle Netは、アドレス・リストの最初のアドレスを試します。接続が失敗し、フェイルオーバー・パラメータが有効になると、Oracle Netは、1つのアドレスが正常に作動するまでアドレスを順番に試します。
このパラメータは、DESCRIPTION_LISTパラメータ、DESCRIPTIONパラメータまたはADDRESS_LISTパラメータの下に配置します。
デフォルト
on: DESCRIPTION_LISTの場合
値
yes | on | true
no | off | false
例
net_service_name=
(DESCRIPTION=
(LOAD_BALANCE=on)
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com))
用途
セッションの受信操作に使用するバッファ領域をバイト数で指定します。このパラメータは、TCP/IP、SSL付きTCP/IP、SDPの各プロトコルでサポートされます。
このパラメータは、DESCRIPTIONパラメータの下またはプロトコル・アドレスの最後に配置します。
|
注意: オペレーティング・システムによっては、他のプロトコルもこのパラメータをサポートしている場合があります。他のプロトコルの詳細は、オペレーティング・システムのマニュアルを参照してください。 |
デフォルト
このパラメータのデフォルト値は、オペレーティング・システムによって異なります。
使用方法
クライアントの接続記述子にこのパラメータを設定すると、クライアント側のsqlnet.oraファイルのRECV_BUF_SIZEパラメータが上書きされます。
例
net_service_name= (DESCRIPTION= (ADDRESS_LIST= (ADDRESS=(PROTOCOL=tcp)(HOST=sales1-server)(PORT=1521) (RECV_BUF_SIZE=11784)) (ADDRESS=(PROTOCOL=tcp)(HOST=sales2-server)(PORT=1521) (RECV_BUF_SIZE=11784)) (CONNECT_DATA= (SERVICE_NAME=sales.us.example.com)))net_service_name= (DESCRIPTION= (RECV_BUF_SIZE=11784) (ADDRESS_LIST= (ADDRESS=(PROTOCOL=tcp)(HOST=hr1-server)(PORT=1521) (ADDRESS=(PROTOCOL=tcp)(HOST=hr2-server)(PORT=1521)) (CONNECT_DATA= (SERVICE_NAME=hr.us.example.com)))
|
関連項目: このパラメータの構成方法の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
ネットワークを介して送信されるデータ・パッケージの転送レートを、指定されたセション・データ・ユニット(SDU)・サイズで最適化するようにOracle Netに指示します。
このパラメータは、DESCRIPTIONパラメータの下に配置します。
デフォルト
8192バイト(8KB)
値
512から65535バイト
使用方法
クライアントの接続記述子にこのパラメータを設定すると、クライアント側のsqlnet.oraファイルのDEFAULT_SDU_SIZEパラメータが上書きされます。
例
net_service_name=
(DESCRIPTION=
(SDU=8192)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-server)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-server)(PORT=1521)))
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com))
|
関連項目: SDUの使用方法と構成情報の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
セッションの送信操作に使用するバッファ領域をバイト数で指定します。このパラメータは、TCP/IP、SSL付きTCP/IP、SDPの各プロトコルでサポートされます。
|
注意: オペレーティング・システムによっては、他のプロトコルもこのパラメータをサポートしている場合があります。他のプロトコルの詳細は、オペレーティング・システムのマニュアルを参照してください。 |
このパラメータは、DESCRIPTIONパラメータの下またはプロトコル・アドレスの最後に配置します。
デフォルト
このパラメータのデフォルト値は、オペレーティング・システムによって異なります。
使用方法
クライアントの接続記述子にこのパラメータを設定すると、クライアント側のsqlnet.oraファイルのSEND_BUF_SIZEパラメータが上書きされます。
例
net_service_name= (DESCRIPTION= (ADDRESS_LIST= (ADDRESS=(PROTOCOL=tcp)(HOST=sales1-server)(PORT=1521) (SEND_BUF_SIZE=11784)) (ADDRESS=(PROTOCOL=tcp)(HOST=sales2-server)(PORT=1521) (SEND_BUF_SIZE=11784)) (CONNECT_DATA= (SERVICE_NAME=sales.us.example.com)))net_service_name= (DESCRIPTION= (SEND_BUF_SIZE=11784) (ADDRESS_LIST= (ADDRESS=(PROTOCOL=tcp)(HOST=hr1-server)(PORT=1521) (ADDRESS=(PROTOCOL=tcp)(HOST=hr2-server)(PORT=1521)) (CONNECT_DATA= (SERVICE_NAME=hr.us.example.com)))
|
関連項目: このパラメータの構成方法の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
複数のプロトコル・アドレスによるルーティングを使用可能にします。
onまたはyesに設定すると、Oracle Netは、接続先に到達するまで順番に各アドレスを使用します。
Oracle Connection Managerを使用するには、クライアントからOracle Connection Managerへの第1接続、およびOracle Connection Managerからリスナーへの第2接続が必要です。
このパラメータは、DESCRIPTION_LISTパラメータ、DESCRIPTIONパラメータまたはADDRESS_LISTパラメータの下に配置します。
デフォルト
off
値
yes | on
no | off
例
net_service_name=
(DESCRIPTION=
(SOURCE_ROUTE=on)
(ADDRESS=(PROTOCOL=tcp)(HOST=cman-pc)(PORT=1630))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales.us.example.com))
|
関連項目: 構成情報の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
Oracle RDBデータベースに使用するサービスのタイプを指定します。このパラメータは、アプリケーションがOracle RDBとOracleデータベース・サービスの両方をサポートし、この両者間のロード・バランシングをアプリケーションで行うようにする場合にのみ使用してください。
このパラメータは、DESCRIPTIONパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION_LIST=
(DESCRIPTION=
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=generic)
(RDB_DATABASE=[.mf]mf_personal.rdb)
(GLOBAL_NAME=alpha5))
(TYPE_OF_SERVICE=rdb_database))
(DESCRIPTION=
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com))
(TYPE_OF_SERVICE=oracle11_database)))
tnsnames.oraファイルの接続データ・セクションでは、接続先サービスの名前を指定します。使用できるパラメータは、次のとおりです。
用途
SERVICE_NAMEなど、接続先サービスを定義します。
このパラメータは、DESCRIPTIONパラメータの下に配置します。
使用上の注意
CONNECT_DATAには、次のパラメータも指定できます。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521))
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)))
用途
実行時に最初のリスナーが失敗した場合に別のリスナーにフェイルオーバーするようOracle Netに指示します。構成に従って、実行していたセッションまたはSELECT文が自動的にフェイルオーバーされます。
この種類のフェイルオーバーは、透過的アプリケーション・フェイルオーバー(TAF)と呼ばれます。接続時フェイルオーバーのFAILOVERパラメータと混同しないでください。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
追加パラメータ
FAILOVER_MODEは、次のパラメータをサポートします。
BACKUP: フェイルオーバー・ノードをネット・サービス名により指定します。フェイルオーバー・ノードに対しては個別のネット・サービス名を作成する必要があります。
TYPE: フェイルオーバー・タイプを指定します。Oracle Call Interface(OCI)アプリケーションでは、デフォルトで3種類のOracle Netフェイルオーバー機能を使用できます。
SESSION: セッションをフェイルオーバーします。たとえば、ユーザーの接続が消失した場合、バックアップ上にそのユーザーの新規セッションが自動的に作成されます。このタイプのフェイルオーバーは、リカバリ選択を試行しません。
SELECT: オープン・カーソルを持つユーザーはフェッチに失敗してもフェッチを継続できます。ただし、このモードは、通常の選択操作ではクライアント側のオーバーヘッドを伴います。
NONE: これがデフォルトで、フェイルオーバー機能は使用されません。このパラメータを使用して、フェイルオーバーの発生回避を明示的に指定することもできます。
METHOD: 1次ノードからバックアップ・ノードへのフェイルオーバーの実行速度を指定します。
BASIC: フェイルオーバー時に接続を確立します。このオプションでは、フェイルオーバー時間までバックアップ・データベース・サーバーでの作業はほとんど不要です。
PRECONNECT: 接続を事前に確立します。これは、速いフェイルオーバーを提供しますが、バックアップ・インスタンスがサポート対象の全インスタンスからの全接続をサポートできることが必要です。
RETRIES: フェイルオーバー後の接続試行回数を指定します。DELAYが指定されている場合、RETRIESは5回の試行回数にデフォルト設定されます。
DELAY: 接続試行の間隔を秒数で指定します。RETRIESが指定されている場合、DELAYは1秒にデフォルト設定されます。
|
注意: コールバック関数が登録されている場合、RETRIESパラメータおよびDELAYパラメータは無視されます。 |
|
関連項目: 構成情報の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
Oracle RDBデータベースを識別します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=generic)
(RDB_DATABASE=[.mf]mf_personal.rdb)
(GLOBAL_NAME=alpha5)))
用途
Oracle以外のシステムには異機種間サービスを介して接続するようにOracle Netに指示します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
デフォルト
なし
値
ok
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SID=sales6)
(HS=ok)))
|
関連項目: 構成情報の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
アクセスするデータベース・インスタンスを識別します。値は、初期化パラメータ・ファイルのINSTANCE_NAMEパラメータに指定されている値に設定します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)
(INSTANCE_NAME=sales1)))
|
関連項目: INSTANCE_NAMEの使用方法の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
用途
Oracle RDBデータベースのファイル名を指定します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)
(RDB_DATABASE= [.mf]mf_personal.rdb)))
用途
クライアントを特定タイプのサービス・ハンドラに接続するようにリスナーに指示します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
値
dedicated: クライアントのリクエストが専用サーバー・プロセスによって処理されるかどうかを指定します。
shared: クライアントのリクエストが共有サーバー・プロセスによって処理されるかどうかを指定します。
|
注意: クライアントが共有サーバー・プロセスでデータベースに接続するには、共有サーバーはデータベース初期化ファイルに構成されている必要があります。sqlnet.oraファイルの |
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)
(SERVER=dedicated)))
|
関連項目:
|
用途
アクセスするOracle Databaseデータベース・サービスを識別します。値は、初期化パラメータ・ファイルのSERVICE_NAMESパラメータに指定されている値に設定します。
このパラメータは、CONNECT_DATAパラメータの下に配置します。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)))
|
関連項目: SERVICE_NAMEパラメータの使用方法の詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。 |
tnsnames.oraファイルのセキュリティ・セクションでは、Oracle Advanced Security機能で使用するセキュリティに関連する次のパラメータを指定します。
用途
安全な接続を可能にします。このパラメータは、DESCRIPTIONパラメータの下に配置します。
使用上の注意
SECURITYには、SSL_SERVER_CERT_DNパラメータを指定できます。
例
net_service_name=
(DESCRIPTION=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521))
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com))
(SECURITY=
(SSL_SERVER_CERT_DN="cn=sales,cn=OracleContext,dc=us,dc=acme,dc=com")))
用途
データベース・サーバーの識別名(DN)を指定します。クライアントは、この情報を使用して、各サーバーに予定しているDNリストを取得し、データベース・サーバーのDNがそのサービス名と一致していることを確認します。
使用上の注意
このパラメータをsqlnet.oraのSSL_SERVER_DN_MATCHパラメータとともに使用して、サーバーDNの一致を可能にします。
net_service_name=
(DESCRIPTION=
(ADDRESS=...)
(ADDRESS=...)
(CONNECT_DATA=
(SERVICE_NAME=finance.us.example.com))
(SECURITY=
(SSL_SERVER_CERT_DN="cn=finance,cn=OracleContext,dc=us,dc=acme,dc=com")))
|
関連項目: 『Oracle Databaseセキュリティ・ガイド』 |
tnsnames.oraファイルのタイムアウト・セクションでは、TNS接続文字列を介してタイムアウトと再試行の構成を指定できます。次のパラメータを接続文字列のDESCRIPTIONレベルで設定できるようになりました。
用途
クライアントがOracle DatabaseへのOracle Net接続を確立するときのタイムアウト時間を秒数で指定します。このパラメータは、DESCRIPTIONパラメータの下に配置します。
使用上の注意
CONNECT_TIMEOUTで指定されたタイムアウト間隔は、TCP接続のタイムアウト間隔のスーパーセットです。これには、リクエストされたサービスを提供するデータベース・インスタンスに接続される時間が含まれていますが、TCP接続の期間は含まれません。
CONNECT_TIMEOUTのデフォルト値は、TCP_CONNECT_TIMEOUTパラメータによって異なります。CONNECT_TIMEOUT値をTCP_CONNECT_TIMEOUT値よりわずかに大きい値に設定することをお薦めします。
タイムアウト間隔は、ADDRESS_LIST内の各ADDRESSおよびホスト名にマッピングされている各IPアドレスに適用されます。
CONNECT_TIMEOUTパラメータは、sqlnet.oraパラメータのSQLNET.OUTBOUND_CONNECT_TIMEOUTと同等で、このパラメータより優先されます。
例
net_service_name=
(DESCRIPTION=
(CONNECT_TIMEOUT=10)(RETRY_COUNT=3)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521)))
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)))
用途
接続試行を終了するまでに、ADDRESSリストを反復する回数を指定します。デフォルトは0です。
このパラメータは、DESCRIPTIONパラメータの下に配置します。
使用上の注意
DESCRIPTION_LISTを指定している場合、指定した再試行回数に基づいて、各DESCRIPTIONが反復されます。RETRY_COUNTは、接続文字列のDESCRIPTIONレベルでしかサポートされません。
Oracle Real Application Clusters環境でSCANリスナーを使用しており、FAILOVER = onと指定している場合に、RETRY_COUNTパラメータを2に設定すると、SCAN IPアドレスが3回ずつ反復され、接続が9回(3 * 3)試行されます。
net_service_name=
(DESCRIPTION_LIST=
(DESCRIPTION=
(CONNECT_TIMEOUT=10)(RETRY_COUNT=3)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1a-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1b-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales1.example.com)))
(DESCRIPTION=
(CONNECT_TIMEOUT=60)(RETRY_COUNT=1)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2a-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2b-svr)(PORT=1521)))
(CONNECT_DATA=(SERVICE_NAME=sales2.us.example.com))))
用途
クライアントがOracle DatabaseへのOracle Net接続を確立するときのトランスポート・タイムアウト時間を秒数で指定します。
このパラメータは、DESCRIPTIONパラメータの下に配置されます。
使用上の注意
TRANSPORT_CONNECT_TIMEOUTパラメータは、クライアントがデータベース・サーバーへのTCP接続を確立する時間を秒数で指定します。デフォルト値は60秒です。
タイムアウト間隔は、ADDRESS_LISTの記述内の各ADDRESSおよびホスト名にマッピングされている各IPアドレスに適用されます。TRANSPORT_CONNECT_TIMEOUTパラメータは、sqlnet.oraパラメータのTCP.CONNECT_TIMEOUTと同等で、このパラメータより優先されます。
例
net_service_name =
(DESCRIPTION=
(TRANSPORT_CONNECT_TIMEOUT=10)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=sales1-svr)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=sales2-svr)(PORT=1521))
(CONNECT_DATA=
(SERVICE_NAME=sales.us.example.com)))