1. C#ドライバ開発者ガイド
  2. プロキシ・サーバーの使用方法

プロキシ・サーバーの使用方法

プロキシ・サーバーは、表C# APIからのネットワーク・トラフィックを受け入れ、Oracle NoSQL Databaseストアが理解できるリクエストに変換してから、変換したリクエストをストアに転送するJavaアプリケーションです。プロキシは、ストアのレスポンスを解釈し、それらをクライアントに転送する逆変換サービスも提供します。

プロキシ・サーバーは、管理対象にすることも管理対象外にすることもできます。

  • 管理対象プロキシ・サーバー: プロキシ・サーバーが管理対象に設定されている場合、ドライバ自体が、アプリケーションに指定されている構成に基づいてプロキシ・サーバーを管理します。ユーザーは、プロキシ・サーバーを起動または構成する必要はありません。デフォルトでは、プロキシ・サーバーは管理対象です。ストアへの接続を参照してください。

  • 管理対象外プロキシ・サーバー: 管理対象外の場合、プロキシ・サーバーは、C#クライアントがストアにアクセスする前に、ネットワークでアクセス可能な任意のマシンで実行されている必要があります。リソース要件は最小限で、多くの場合、クライアント・ノードが実行されているのと同じマシンで実行できます。

    java -cpコマンド・ライン・オプションを使用するかCLASSPATH環境変数を使用することで、クラス・パスに一連のjarファイルが設定されている必要があります。jarファイルはドライバに付属しており、次の場所にあります。

    • PathToYourC#ProjectFolder\packages\Oracle.nosql.driver.4.x.x\lib\java\*

    プロキシ・サーバー自体は、oracle.kv.proxy.KVProxyコマンドを使用して起動します。少なくとも、プロキシ・サーバーの起動時には次の情報が必要です。

    • -helper-hosts

      これは、プロキシ・サーバーがストアへの接続に使用できるOracle NoSQL Databaseストレージ・ノードを表す1つ以上のhost:portペアのリストです。

    • -port

      ストアがプロキシ・サーバーをリスニングするポート。

    • -store

      プロキシ・サーバーが接続するストアの名前。

    他の一連のコマンド・ライン・オプションを使用できます。特に、安全なストアでプロキシ・サーバーを使用している場合は、プロキシ・サーバーに認証情報を提供する必要があります。また、プロキシ・サーバーにストア名を識別することが必要になる可能性があります。プロキシ・サーバーとそのコマンド・ライン・オプションの詳細な説明は、Pythonドライバ開発者ガイドのプロキシ・サーバー・リファレンスを参照してください。

    このクイック・スタート・ガイドで提供している単純な例は、secure-config disabledおよびデフォルトとしての他のすべての値で起動されたkvliteインスタンスに接続しているプロキシ・サーバーで動作するように作成されています。jarファイルの場所は、CLASSPATH環境変数を使用して指定されました。プロキシ・サーバーの起動に使用したコマンド・ライン・コールは次のとおりです。 

    java oracle.kv.proxy.KVProxy -port 7010 -helper-hosts localhost:5000 -store kvstore