User's Guide (v11)

pvmdconv

Pervasive PSQL には pvmdconv という、メタデータ バージョン 1 からメタデータ バージョン 2 へ変換するための変換ユーティリティが付属しています。このコマンド ライン ユーティリティは、インストール ディレクトリの下の BIN ディレクトリにあります。

概要

pvmdconv -o <1 | 2> -d path_to_DDFs -n database_name [-
v] [-ddf] [-s server_name] [-i server_login_name] [-
c server_password] [-u database_user_name] [-p 
database_password] [-l log_file] [-<h | ?>] 

パラメーター

-o <1 | 2>
メタデータの出力形式を指定します。選択肢は 1 または 2 で、それぞれバージョン 1(V1)とバージョン 2(V2)を表します。
メモ:pvmdconv の現在のリリースはメタデータ バージョン 2 からメタデータ バージョン 1 への DDF の変換をサポートしていません。
-d path_to_DDFs
変換する DDF のある ディレクトリを指定します。新しい DDF は同じディレクトリに作成されます。
-n database_name
Pervasive PSQL データベースの名前を指定します。
[-v]
dbnames.cfg にデータベースのメタデータ バージョンを指定して変更します。たとえば、-o=2 と指定するとデータベースのメタデータ バージョンはメタデータ バージョン 2 に変更されます。"v" パラメーターを使用すると、pvmdconv は DDF のメタデータ バージョンを変更しません
[-ddf]
DDF のメタデータ バージョンを指定します。このパラメーターを使用すると、pvmdconv は dbnames.cfg 内のデータベースのメタデータ バージョンを変更しません
[-s server_name]
データベースが存在するリモート サーバーの名前または IP アドレスを指定します。このパラメーターは、実行中の pvmdconv ユーティリティが存在しているのとは別のマシンにデータベースが存在する場合に必要です。このパラメーターのデフォルトは "localhost" なので、pvmdconv とデータベースが同じマシンにある場合には不要です。
[-i server_login_name]
データベースが存在するリモート サーバーにログインするのに必要な名前を指定します。Server_login_name は、オペレーティング システムによって管理される名前です。
[-c server_password]
server_login_name のパスワードを指定します。Server_password はオペレーティング システムが管理するパスワードです。
[-u database_user_name]
データベースにログオンする権限を与えられているユーザーの名前を指定します。
[-p database_password]
database_user_name に関連付けられているパスワードを指定します。
[-l log_file]
診断メッセージをテキスト ファイルに出力します。テキスト ファイルの名前と場所は、log_file で指定します。このパラメーターを省略すると、診断メッセージは画面に表示されます。
[-<h | ?>]
ユーティリティの使用法を画面に表示します。

説明

Pvmdconv を使用すると、以下の動作を実行することができます。

別の変換動作を行うと、メタデータ変換をより細かく制御することができます。たとえば、最初の方法を選択し、DDF のみを変換してエラーをチェックすることができます。エラーが発生しなかったら、dbnames.cfg のメタデータ バージョンを更新します。

メタデータ バージョン 1(V1)から バージョン 2(V2) への変換

V1 DDF のデータは、以下の例外を除き、すべて V2 DDF に直接コピーされます。

システム テーブル
フィールドへの動作
解説
X$View
Xv$Id の値は pvview.ddf の Xv$Sequence にコピーされます。
Xv$Sequence には行ごとに 1 ずつ増加する値が含まれています。
メタデータ バージョン 2 の新しい列である Xv$Trustee の値には、明示的に -1 が格納されます。
この値には、データベースのセキュリティ設定にかかわらず -1 が格納されます。つまり、データベースがセキュリティで保護されている場合と保護されていない場合です。
メタデータ バージョン 1 データベースがセキュリティで保護されている場合、データベースが メタデータ バージョン 2 に変換されるときに、すべてのビューについて明示的に "GRANT ALL TO PUBLIC" が呼び出されます。
X$Proc
Xp$Id の値は pvproc.ddf の Xp$Sequence にコピーされます。
Xp$Sequence には行ごとに 1 ずつ増加する値が含まれています。
メタデータ バージョン 2 の新しい列である Xp$Trustee の値には、明示的に -1 が格納されます。
この値には、データベースのセキュリティ設定にかかわらず -1 が格納されます。つまり、データベースがセキュリティで保護されている場合と保護されていない場合、値には -1 が格納されます。
メタデータ バージョン 1 データベースがセキュリティで保護されている場合、データベースが メタデータ バージョン 2 に変換されるときに、すべてのストアド プロシージャについて明示的に "GRANT ALL TO PUBLIC" が呼び出されます。
X$Rights
Xr$Table の値は pvrights.ddf の Xr$Object にコピーされます。
 
デフォルト値の 1 が pvrights.ddf の Xr$Type にコピーされます。
 

メタデータ バージョン 2(V2)からバージョン 1(V1)への変換

pvmdconv の現在のリリースは、メタデータ バージョン 2 から 1の変換をサポートしていません。

Pervasive PSQL ファイルのデフォルトの保存場所については、『Getting Started with Pervasive PSQL』の Pervasive PSQL ファイルがインストールされる場所を参照してください。

デフォルトの変換

サンプル データベースの DEMODATA をメタデータ バージョン 2 に変換するには、次のようにします(Windows プラットフォームでデフォルトのインストールが行われていると仮定します)。

pvmdconv -o 2 -d file_path¥PSQL¥Demodata¥ -n demodata 

この例では、次のような結果になります。

同じ変換を実行して、変換の診断情報のログを取得するには、次のように記述します。

pvmdconv -o 2 -d file_path¥PSQL¥Demodata¥ -n demodata -l 
file_path¥PSQL¥Demodata¥¥pvmdconv_log.txt 

DDF のみの変換

サンプル データベース DEMODATA の DDF のみをメタデータ バージョン 2 に変換するには、次のようにします(Windows プラットフォームでデフォルトのインストールが行われていると仮定します)。

pvmdconv -o 2 -d file_path¥PSQL¥Demodata¥ -n demodata -
DDF 

この例では、次のような結果になります。

データベースのメタデータ バージョンの変更

サンプル データベース DEMODATA のメタデータ バージョンをメタデータ バージョン 2 に変換するには、次のようにします(Windows プラットフォームでデフォルトのインストールが行われていると仮定します)。

pvmdconv -o 2 -d file_path¥PSQL¥Demodata¥ -n demodata -v 

この例では、次のような結果になります。

メモ:この例では、DEMODATA の DDF が変換の影響を受けないとしても file_path¥PSQL¥Demodata¥に存在する必要があります。

リモート サーバーでの変換の実行

サンプル データベースの DEMODATA を次の条件でメタデータ バージョン 2 に変換するには以下のようにします。

pvmdconv -o 2 -d z:file_path¥PSQL¥Demodata¥-n demodata -
s TESTSERVER -i adminuser -c admin99user 

この例では、次のような結果になります。


pvddl

pvnetpass