TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続

機械翻訳について

TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続

アプリケーションがネットワーク・レイテンシの影響を受けやすく、アプリケーションとデータベース間のネットワーク・レイテンシを削減する場合は、TCP Fast Open (TFO)を有効にできます。

アプリケーションの特性に応じて、TFO接続はクライアント接続のネットワーク待機時間を短縮することでアプリケーションのパフォーマンスを向上させることができます。

TCP Fast Open (TFO)接続の前提条件
Autonomous DatabaseでTCP Fast Open (TFO)接続を使用するための前提条件をリストします。
TCP Fast Openを使用したJDBC Thin接続
Autonomous DatabaseでTCP Fast Open (TFO)でJDBC Thin接続を使用するための要件について説明します。
Pythonを使用したTCP高速オープン接続
Autonomous DatabaseでTCP Fast Open (TFO)接続でPythonを使用するための要件について説明します。
Oracle Call Interface Client for CまたはSQL*Plus接続を使用したTCP高速オープン接続
Oracle Call InterfaceクライアントをTCP Fast Open (TFO)とともに使用してCまたはSQL*PlusとAutonomous Databaseに接続するための要件について説明します。

親トピック: 接続およびネットワークのオプションと機能

TCP Fast Open (TFO)接続の前提条件

Autonomous DatabaseでTCP Fast Open (TFO)接続を使用するための前提条件をリストします。

TCP Fast Open (TFO)を使用してAutonomous Databaseインスタンスに接続するには、クライアント・アプリケーションで次のものが必要です:

クライアントは、Oracle Cloud InfrastructureのVM上で実行する必要があります。
次の条件の1つに該当している必要があります。
- Autonomous Databaseはプライベート・エンドポイント上にあります。
- Autonomous Databaseがパブリック・エンドポイント上にある場合、トラフィックがサービス・ゲートウェイを経由するように、クライアントVMとデータベース間のルーティング・ルールを構成する必要があります。
  
  詳細については、「サービス・ゲートウェイを使用したAutonomous Databaseへのアクセス」と「プライベート・エンドポイントを使用したネットワーク・アクセスの構成」を参照してください。
VMはLinuxで実行されている必要があります。サポートされているプラットフォーム: Oracle Linux x86_64およびOracle Linux Arm (aarch64)。
次のOSレベルのカーネル・パラメータを設定する必要があります:
- rootユーザーとして、次のパラメータを設定します:
  - sysctl -w net.ipv4.tcp_fastopen=5
  - sysctl -w net.ipv4.tcp_fastopen_blackhole_timeout_sec=0
  OSレベルのカーネル・パラメータ値を確認します:
```
cat /proc/sys/net/ipv4/tcp_fastopen
5
cat /proc/sys/net/ipv4/tcp_fastopen_blackhole_timeout_sec
0
```

親トピック: TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続

TCP Fast Openを使用したJDBC Thin接続

Autonomous DatabaseでTCP Fast Open (TFO)でJDBC Thin接続を使用するための要件について説明します。

クライアント環境とクライアントの前提条件が満たされていることを確認します。詳細については、「TCP Fast Open (TFO)接続の前提条件」を参照してください。

TCP Fast Open (TFO)でJDBCを使用するには、次のステップを実行します:

最新のJDBCシン・ドライバをダウンロードします。
ページOracle Database JDBCドライバおよびCompanion Jarsのダウンロードから:
- 「Oracle Database 23ai JDBCドライバ& UCPのダウンロード - 無料リリース」の下で使用可能なドライバから、ドライバ・バージョン23.4以上を選択します。
- 「Oracle Database 19c JDBCドライバ& UCPのダウンロード - 長期リリース」で使用可能なドライバからドライバ・バージョン19.23以上を選択
Oracle JDBC TCP Fast Open (TFO)ライブラリ・ファイルをダウンロードします。
1. Oracle Database JDBCドライバおよびCompanion Jarsのダウンロードページで、「Oracle JDBC TCP Fast Open (TFO)ライブラリv1」を展開
2. クライアント・プラットフォーム用のネイティブ・ライブラリ.zipをダウンロードします:
  - JDBC TFO Library for Linux x86_64、Intel上のLinux用のライブラリ・ファイルx86_64。
  - Linux on Armのarm64用のJDBC TFOライブラリ(Linux AARCH64ライブラリ・ファイル)。
アプリケーションを実行する環境にネイティブ・ライブラリをロードします。

ライブラリ・パスに次の環境変数を設定します:
1. LD_PRELOADをエクスポートします。
  export LD_PRELOAD=path_to/libtfojdbc1.so;
2. JDK 8を使用している場合は、LD_LIBRARY_PATHをエクスポートします。
  
  たとえば:
  export LD_LIBRARY_PATH=path_of_libtfojdbc1.so:path_to/jdk_8_home/jre/lib/amd64:path_to/jdk_8_home/jre/lib/amd64/server;
3. JDK 17を使用している場合は、LD_LIBRARY_PATHをエクスポートします。
  
  たとえば:
  export LD_LIBRARY_PATH=extracted_binaries_path:path_to/jdk_17_home/lib;
アプリケーションのTCP Fast Open (TFO)オプションを有効にします。

次に、データベースへのクライアント接続でTFOを有効にするためのオプションの一部を示します:
- クライアント・アプリケーションで、次の接続プロパティを設定します:
  properties.put(OracleConnection.CONNECTION_PROPERTY_NET_USE_TCP_FAST_OPEN, "true");
  デフォルトでは、プロパティ OracleConnection.CONNECTION_PROPERTY_NET_USE_TCP_FAST_OPENはfalse (無効)に設定されています。
- JDBC URLにTFOプロパティを追加します。
  
  たとえば:
```
jdbc:oracle:thin:@tcps://xxx.adb.yyy.oraclecloud.com:1521/zzz.adb.oraclecloud.com?oracle.net.useTcpFastOpen=true 
```
  または
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=xxx.adb.yyy.oraclecloud.com) (PORT=1521))(CONNECT_DATA=(SERVICE_NAME=zzz.adb.oraclecloud.com)))?oracle.net.useTcpFastOpen=true
```
- 接続URLのCONNECT_DATAセクションに次のTNSパラメータを追加します。
  
  たとえば:
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=xxx.adb.yyy.oraclecloud.com)(PORT=1521))
        (CONNECT_DATA=(USE_TCP_FAST_OPEN =ON)(SERVICE_NAME=zzz.adb.oraclecloud.com)))
```
- 接続URLのCONNECT_DATAセクションに次のTNSパラメータを追加します。
  
  たとえば:
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=xxx.adb.yyy.oraclecloud.com)(PORT=1521))(CONNECT_DATA=(TFO=ON)(SERVICE_NAME=zzz.adb.oraclecloud.com)))
```
アプリケーションを実行します。

親トピック: TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続

Pythonを使用したTCP高速オープン接続

Autonomous DatabaseでTCP Fast Open (TFO)接続でPythonを使用するための要件について説明します。

TCP Fast Open (TFO)でPythonを使用するには、次のステップを実行します:

Pythonおよびpython-oracledbドライバをインストールします。

最新バージョンのpython-orabledbを使用します(バージョン2.1.0以降が必要です)。

詳細については、「Pythonおよびpython-oracledbドライバのインストール」を参照してください。
Autonomous Databaseインスタンスに接続するときに、use_tcp_fast_open接続パラメータを追加します。
たとえば、次のいずれかのオプションを使用します:
詳細については、「Autonomous DatabaseへのPythonアプリケーションの接続」を参照してください。

親トピック: TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続

Oracle Call Interface Client for CまたはSQL*Plus接続を使用したTCP高速オープン接続

Oracle Call InterfaceクライアントをTCP Fast Open (TFO)とともに使用してCまたはSQL*PlusとAutonomous Databaseに接続するための要件について説明します。

ノート:

mTLS接続またはTLS接続を使用してTCP Fast Open (TFO)を有効にできます。詳細については、「mTLSまたはTLSを使用したAutonomous Databaseへのセキュアな接続」と「Autonomous DatabaseでTLSを許可するか、相互TLS (mTLS)認証のみを必要とするようにネットワーク・オプションを更新」を参照してください。

Oracle Call InterfaceをTCP Fast Open (TFO)とともに使用するには、次のステップを実行します:

Linux用の最新のOracleインスタント・クライアント(バージョン23.4以上または19.23以上)をダウンロードします。

Linux x86-64については、「Linux用Oracle Instant Clientダウンロードx86-64 (64ビット)」を参照してください。

Linux ARMについては、「Linux ARM用Oracle Instant Clientダウンロード(aarch64)」を参照してください。

USE_TCP_FAST_OPENパラメータを値YESに設定して接続します。

たとえば、Autonomous Databaseへの接続に使用する接続文字列で、パラメータUSE_TCP_FAST_OPENをconnect_dataに追加します:

(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)
   (port=1522)(host=example.us-phoenix-1.oraclecloud.com))
   (connect_data= (USE_TCP_FAST_OPEN=yes)(service_name=example_medium.adb.oraclecloud.com))
       (security=(ssl_server_dn_match=yes)))

または、sqlnet.oraパラメータを設定します:

USE_TCP_FAST_OPEN=yes

親トピック: TCP Fast Open (TFO)を使用したクライアントのAutonomous Databaseへの接続