この章では、PSQL の Distributed Tuning Interface について説明します。以下の項目が含まれます。

Distributed Tuning Interface（DTI）の目的は、PSQL コンポーネントの設定、監視、および診断のためのアプリケーション プログラミング インターフェイスを提供することにあります。

ユーザー アプリケーションは、API レベルではクライアントの OS エンコードを使用します。DTI は、サーバーおよびクライアント上の OS エンコード間の相違について内部的に対処します。

古いバージョンのクライアントがサーバーと通信している場合、データベース エンジンでは、そのクライアントで使用しているエンコードとサーバーで使用可能なエンコードに互換性があるものと想定しています。

利用可能な API のカテゴリは、表 2 の DTI 関数グループに要約されています。

通常、DTI アプリケーションでしたいことと言えば、DTI 関数のいずれかを呼び出すことと、すべての設定を表示したり変更したりすることでしょう。このフル アクセスを確保するには、サーバー マシン上で管理者レベルの権限を持つユーザーの名前とパスワードを提供することにより、サーバーに接続します。これは、DTI アプリケーションがターミナル サービス セッションを介してローカルで実行されている場合、あるいはリモートで実行されている場合に適用されます。ローカルで実行されているアプリケーションでは、ユーザー名とパスワードを省略できます。省略しても、任意の DTI 関数の呼び出しや、すべての設定の表示および変更は行えます。DTI を使ってサーバーへの接続を行うを参照してください。

管理者レベルの権限がない場合、ターミナル サーバー セッションを介してローカルで実行されているアプリケーションやリモートで実行されているアプリケーションは、ほとんどの DTI 関数に対してアクセス エラーを返します。関数のサブセットのみが動作します。たとえば、フル アクセスが許可されている場合に設定を変更できる関数の多くは、読み取り専用のアクセスに制限されます。

DTI 関数は次のヘッダー ファイルに定義されています。

次の表は、DTI のリンク ライブラリと、そのライブラリが最初に利用できるようになった PSQL のバージョンの一覧です。表で定義されているように、アプリケーションを適切なライブラリにリンクします。

DTI の関数については、Distributed Tuning Interface のリファレンスで説明します。

DTI を呼び出す場合は、まず PvStart()関数を呼び出す必要があります。その後、セッションを終了するまでに複数の DTI 関数を呼び出すことができます。

セッションを終了するときは、PvStop()関数を呼び出してセッションを閉じる必要があります。

DTI アクセス方法のためのランタイム ファイルは、デフォルトで PSQL データベース エンジンおよび PSQL クライアントと一緒にインストールされます。DTI アプリケーションを作成するためには、少なくとも PSQL クライアントが必要です。

ヘッダー ファイルとサンプル ファイルは AG-TECH PSQL Library からダウンロードできます。特定の開発環境に関するサンプル ファイルは、次の表に示すように別々のディレクトリにインストールされます。

詳細については、PSQL データベース エンジンでインストールされる DTI 用の readme ファイル（readme_dti.htm）を参照してください。

ここでは、DTI でよく使用される主要なタスクを説明します。

サーバーへの接続ハンドルを取得する手順を説明します。多くの DTI 関数にとって、これは最初の手順です。

接続ハンドルは多くの DTI 関数で必要となります。同時に複数の接続を開くことができます。ただし、それぞれの接続または関数について、PvDisconnect() 関数を呼び出してハンドルを解放する必要があります。

設定関数の多くは、パラメーターとして設定 ID を使用します。次の手順は、設定 ID を取得するために必要不可欠な関数について説明します。

多くの関数で、関数呼び出しを行うときに DTI 構造体を渡すことが要求されます。以下のサンプル コードでは、構造体を含む関数呼び出しの例を示します。DTI 構造体の詳細については、DTI 構造体を参照してください。