リポジトリーのインストールをサポートしているデータベースが使用可能でなければならず、アプリケーションが pureQuery クライアントの最適化を使用するよう構成されている必要があります。 pureQuery のシステム要件については、System requirements for Optim™ pureQuery Runtime を参照してください。
以下のセクションでは、ManageRepository ユーティリティーについて説明しています。
ダイアグラムで使用される規則を理解するには、構文図の読み方を参照してください。
リポジトリー・レベルの ManageRepository 操作には、データベース内でのリポジトリーの作成と削除、リポジトリーの妥当性検査、およびリポジトリーのバージョンの表示などがあります。
リポジトリーの作成、リポジトリーの削除、またはリポジトリーのバインドに必要な SQL ステートメントを表示するには、-generateScriptOnly オプションを使用します。 ステートメントは操作を実行せずに生成されます。SQL ステートメントを変更して発行する場合は、-verify repository を使用してリポジトリーを検査できます。
pureQuery クライアント最適化用の pureQuery ファイルから得られた情報のみを収めるリポジトリーを作成するには、-repositoryType オプションに -pureQueryRuntimeOnly パラメーターを指定します。 このリポジトリーには、キャプチャーされた SQL データは保管されません。
(1) >>-------java--com.ibm.pdq.tools.ManageRepository---------------> >--+- -create repository-- -repositoryType--+-pureQueryOnly--------+-+--> | '-pureQueryRuntimeOnly-' | | (2) | +------- -bind packages-------------------------------------------+ +- -verify repository---------------------------------------------+ +- -report--+-repositoryData-- -file--file-name-+-----------------+ | '-repositoryVersion-----------------' | '- -delete repository--+--------------------+---------------------' | .-FALSE-. | '- -force--+-TRUE--+-' >--| connection information |-----------------------------------> >--+-------------------------------------------------+----------> | (3) | '------- -generateScriptOnly--path-to-script-file-' >--+--------+-------------------------------------------------->< '- -help-' connection information |-- -repositoryURL--URL-to-repository-database------------------> >-- -repositoryUsername--user-ID-- -repositoryPassword--password--> >-- -repositoryDriverClass--driverclass-------------------------|
以下のリストでは、サポートされている ManageRepository オプションおよび変数について説明しています。
このコマンドによりデータが置換されることを示すメッセージが表示されます。この操作を取り消すオプションがユーザーに提供されます。
-generateScriptOnly オプションを使用して、リポジトリーを作成する SQL ステートメントを含む SQL スクリプトを生成します。このとき、リポジトリーは作成されません。スクリプトを確認したら、スクリプトを実行してリポジトリーを作成できます。SQL ステートメントを変更してスクリプトを実行する場合、-verify repository を使用してリポジトリーを検査できます。
リポジトリーが作成されると、ManageRepository ユーティリティーの -grant オプションおよび -revoke オプションを使用して、作成されたパッケージに対する特権の付与および取り消しが行われます。パッケージへのアクセス権限の付与について詳しくは、ランタイム・グループの特権の管理操作を参照してください。
-generateScriptOnly オプションを使用して、バインド操作を実行せずに、スクリプトのみを生成します。
返される出力には、リポジトリー内の異なるコンポーネントの情報、および誤った許可や列の欠落した表など、リポジトリーの問題を示すメッセージが含まれます。
-generateScriptOnly オプションを使用して、リポジトリーを検証せずに SQL スクリプトを生成します。
-force TRUE を使用すると、メッセージを表示せずに削除の確認が行われます。
-generateScriptOnly オプションを使用して、リポジトリーを削除せずに SQL スクリプトを生成します。
リポジトリーを作成するスクリプトに対し、いくつかのオブジェクト名を変更するための修正を加えることができます。 ただし、スキーマ名、表名、列名はいずれも変更できません。 ManageRepository スクリプトの操作については、使用上の注意 を参照してください。
スクリプトを確認して変更すると、データベース管理者はこのスクリプトを実行してリポジトリーを作成できるようになります。例えばデータベース管理者は、スクリプト内の SQL ステートメントに表スペースを追加できます。
リポジトリーの作成後、-verify repository オプションを使用してリポジトリーを検査できます。
-bind packages オプションでは、コレクション名およびパッケージ名はユーティリティーにより選択され、ユーザーはこれを変更できません。
以下のリストでは、リポジトリー・データベースへの接続に必要な情報について説明しています。
ManageRepository ランタイム・グループ操作には、リポジトリー内のランタイム・グループおよびグループのバージョンの作成、管理、および削除があります。
ランタイム・グループ・バージョンに保管される pureQuery データには、pureQuery 構成情報、pureQueryXML データ、および pureQuery クライアントの最適化により使用可能になったアプリケーションからオプションでキャプチャーされる SQL データが含まれます。
ランタイム・グループ・バージョンには、ランタイムおよびグループのアクティブ・バージョンを識別するために pureQuery ランタイムにより使用されるその他の情報も含まれます。
(1) >>-------java--com.ibm.pdq.tools.ManageRepository---------------> >--+- -create runtimeGroup--+--------------------+------------------------------------------------+--> | '-| pureQuery data |-' | +- -update runtimeGroup--+--------------------+------------------------------------------------+ | '-| pureQuery data |-' | +- -delete runtimeGroup--+--------------------+------------------------------------------------+ | | .-FALSE-. | | | '- -force--+-TRUE--+-' | +- -delete incremental-- -inputDirectory--path-to-directory-- -incrementalCapture--file-prefix-+ +- -list runtimeGroupVersions------------------------------------------------------------------+ +- -activate runtimeGroup----------------------------------------------------------------------+ +- -deactivate runtimeGroup--------------------------------------------------------------------+ '- -copy runtimeGroup--+---------------------------------+-- -targetVersion--target-version----' '- -sourceVersion--source-version-' >-- -runtimeGroupId--GroupID------------------------------------> (2) >-------- -runtimeGroupVersion--version-------------------------> >--+--------------------------------+--+--------+---------------> '- -contact--contact-information-' '- -help-' >--| connection information |---------------------------------->< pureQuery data (3) |-------- -inputDirectory--path-to-directory--------------------> >--+----------------------------------------+-------------------> '- -pureQueryXml--pureQueryXML-file-name-' >--+------------------------------------------+-----------------> '- -pureQueryProperties--runtime-prop-file-' >--+------------------------------------------+-----------------> '- -optionsFileForConfigure -genProps-file-' >--+--------------------------------------+---------------------| '- -optionsFileForBind -bindProps-file-' connection information |-- -repositoryURL--URL-to-repository-database------------------> >-- -repositoryUsername--user-ID-- -repositoryPassword--password--> >-- -repositoryDriverClass--driverclass-------------------------|
以下のリストでは、サポートされている ManageRepository オプションおよび変数について説明しています。
runtimeGroupId がリポジトリー内に既に存在する場合は、エラーが表示されます。
デフォルトをオーバーライドして他のプロパティーを指定するには、プロパティーとその値を含むファイルを指定します。
メッセージを表示せずに削除を許可するには、-force TRUE オプションを使用します。
キャプチャーされた SQL データとランタイム・グループ・バージョンの pureQueryXML データのマージ後は、このバージョンのキャプチャーされた SQL データを削除できます。
pureQuery Runtime がリポジトリー内のランタイム・グループにアクセスする際には、アクティブなランタイム・グループ・バージョンの pureQuery 情報が使用されます。
pureQuery Runtime がリポジトリー内のランタイム・グループにアクセスする際には、アクティブではないランタイム・グループの pureQuery 情報は無視されます。
source-version が指定されない場合、アクティブなランタイム・グループ・バージョンが使用されます。source-version が指定されておらず、アクティブなランタイム・グループ・バージョンがない場合は、エラーが表示されます。
以下のリストでは、pureQuery データ・オプションについて説明しています。
以下のリストでは、リポジトリー・データベースへの接続に必要な情報について説明しています。
特権の管理操作は、SQL キャプチャー・データがリポジトリー・データベースに保管された後に実行されます。管理者は、リポジトリー・データベース表への読み取りおよび書き込みの許可をアプリケーションに付与する必要があります。
(1) >>-------java--com.ibm.pdq.tools.ManageRepository---------------> >--+- -revoke-+-------------------------------------------------> '- -grant--' .-,----------------. V | >----"--grantees--(----authorization-ID-+--) -"-----------------> >-- -privilege--+-tableAccess----------+------------------------> | (2) | '-------executePackage-' >-- -accessLevel -+-APPLICATION-+--| connection information |---> '-MANAGER-----' >--+--------+--+-------------------------------------------+--->< '- -help-' '- -generateScriptOnly--path-to-output-file-' connection information |-- -repositoryURL--URL- to-repository-database-----------------> >-- -repositoryUsername--user-ID-- -repositoryPassword--password--> >-- -repositoryDriverClass--driverclass-------------------------|
以下のリストでは、サポートされている ManageRepository オプションおよび変数について説明しています。
-revoke オプションでは、ロールを指定する必要はありません。
"grantees(test1, test2, user1)"
PUBLIC を ID として指定できます。
authorization-ID とデータベース・ユーザー ID の表記では、大/小文字の別が同じでなければなりません。 例えば、DB2® ユーザー ID が大文字で表記されている場合、authorization-ID も大文字で入力する必要があります。
通常のリポジトリーではなく、Optim Performance Manager リポジトリーが対象である場合、使用できるアクセス・レベルは MANAGER のみです。
スクリプトを確認して変更すると、データベース管理者はこのスクリプトを実行してリポジトリーを作成できるようになります。リポジトリーの作成後、-verify repository オプションを使用してリポジトリーを検査できます。
-bind packages オプションでは、コレクション名およびパッケージ名はユーティリティーにより選択され、ユーザーはこれを変更できません。
以下のリストでは、リポジトリー・データベースへの接続に必要な情報について説明しています。
(1) >>-------java--com.ibm.pdq.tools.ManageRepository---------------> >--+- -export data-- -file--path-to-zip-file-name-+-------------> +- -extract runtimeGroup--| pureQuery data |---+ '- -import data-- -file--path-to-zip-file-name-' >-- -runtimeGroupId--group-ID-----------------------------------> >-- -runtimeGroupVersion--version-ID----------------------------> >--| connection information |-----------------------------------> >--+-----------------------------------------------+------------> | (2) | '-------| captured SQL connection information |-' >--+--------+-------------------------------------------------->< '- -help-' pureQuery data (3) |-------- -outputDirectory--path-to-directory-------------------> >--+----------------------------------------+-------------------> '- -pureQueryXml--pureQueryXML-file-name-' >--+------------------------------------------+-----------------> '- -pureQueryProperties--runtime-prop-file-' >--+------------------------------------------+-----------------> '- -optionsFileForConfigure--genProps-file-' >--+--------------------------------------+---------------------> '- -optionsFileForBind -bindProps-file-' >--+------------------------------+-----------------------------| '- -incrementalCapture--prefix-' connection information |-- -repositoryURL--repository-database-URL---------------------> >-- -repositoryUsername--user-ID-- -repositoryPassword--password--> >-- -repositoryDriverClass--driverclass-------------------------| captured SQL connection information |-- -incrementalRepositoryURL--repository-database-URL----------> >-- -incrementalRepositoryUsername--user-ID-- -incrementalRepositoryPassword--password--> >-- -incrementalRepositoryDriverClass--driverclass--------------|
以下のリストでは、サポートされている ManageRepository オプションおよび変数について説明しています。
ODS エクスポート UI を介してデータがエクスポートされ、エクスポートする pureQuery プロジェクトが複数選択された場合は、最後のプロジェクトの pureQuery データのみが -runtimeGroupId オプションにより指定されたランタイム・グループにインポートされます。
以下のリストでは、pureQuery データ・オプションについて説明しています。
testApp_1.pdqxml testApp_2.pdqxml
キャプチャーされた SQL データは、pureQueryXML データを含むリポジトリーとは別のリポジトリーから取り出すことができます。キャプチャーされた SQL データベースを含むリポジトリーのコマンド行で、接続情報を指定してください。
以下のリストでは、リポジトリー・データベースへの接続に必要な情報について説明しています。
extract runtimeGroup オプションと共にのみ使用されます。pureQuery データの抽出時、キャプチャーされた SQL を含むリポジトリーが、他の pureQuery データとは別個のリポジトリー・データベース内にある場合があります。 以下のリストでは、キャプチャーされた SQL を含むリポジトリー・データベースへの接続に必要な接続情報について説明しています。
ManageRepostiory -report pureQueryXMLChanges オプションは、2 つの pureQueryXML ファイルの違いの HTML レポートを作成します。
ManageRepository ユーティリティーが比較する pureQueryXML ファイルは、ファイル・システム上に置かれている必要があります。データベースへの接続が必要です。
(1) >>-------java--com.ibm.pdq.tools.ManageRepository---------------> >-- -report pureQueryXMLChanges-- -oldPureQueryXml--pureQueryXML-file-- -newPureQueryXml--pureQueryXML-file-- -file--report-file->< connection information |-- -repositoryURL--URL-to-repository-database------------------> >-- -repositoryUsername--user-ID-- -repositoryPassword--password--> >-- -repositoryDriverClass--driverclass-------------------------|
以下のリストでは、レポートの生成に使用する ManageRepository のオプションと変数について説明しています。
以下のリストでは、リポジトリー・データベースへの接続に必要な情報について説明しています。
静的 SQL をサポートするプラットフォームでは、-grant privilege オプションおよび -privilege EXECUTEPACKAGE オプションを使用して、静的にバインドされたステートメントを使用するメタデータ・リポジトリーへのアクセス権限をアプリケーションに与えることができます。静的 SQL をサポートするプラットフォームでは、-bind packages の発行後に、ManageRepository ユーティリティーにより、バインドされたパッケージを使用するか、動的 SQL ステートメントを発行することができます。バインドされたパッケージが存在しないか、ユーザーにバインドされたパッケージの実行特権がない場合、ManageRepository は動的 SQL を使用してリポジトリー表にアクセスします。
動的プラットフォームでは、-grant privilege オプションおよび -privilege TABLEACCESS オプションを使用して、基礎となるメタデータ・リポジトリー表へのアクセス権限を動的アプリケーションに与えることができます。静的 SQL をサポートしていないプラットフォームで使用できるオプションは、このオプションのみです。
Optim Performance Manager および Optim Performance Manager Extended Insight では、pureQueryXML データを使用することができます。 ManageRepository ユーティリティーを使用して、Optim Performance Manager リポジトリーに pureQueryXML データをアップロードできます。
ManageRepository ユーティリティーを使用して Optim Performance Manager リポジトリーにアップロードできるのは pureQueryXML データのみです。 pureQuery ランタイム・プロパティーなどの他のデータはアップロードできません。
ManageRepository ユーティリティーを使用して、Optim Performance Manager リポジトリーでランタイム・グループを作成、更新、削除、およびリストすることができます。 その他の ManageRepository コマンドはサポートされていません。
create user IBMPDQ identified by password
リポジトリーを作成する場合は、データベースに対する管理特権を持つすべてのユーザーがリポジトリーを作成できます。
java com.ibm.pdq.tools.ManageRepository -create repository -repositoryType pureQueryOnly -repositoryURL jdbc:db2://test.ora.com:17593/test -repositoryUsername tiger -repositoryPassword testpwd -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
SQL ステートメントを変更してスクリプトを実行する場合、-verify repository を使用してリポジトリーを検査できます。
カスタマイズされたスクリプトを使用してリポジトリーを作成する場合、カスタマイズされたスクリプトを使用してそのリポジトリーを削除する必要があります。 リポジトリーを削除するコマンドで -generateScriptOnly を指定することにより、リポジトリーを削除するためのスクリプトを作成します。 このスクリプトを実行する前に、リポジトリーの作成に使用したスクリプト内の、変更されたオブジェクト名を変更してください。
db2 connect to sample db2 -tvf filename
DB2 コマンド行については、DB2 インフォメーション・センターの『コマンド行プロセッサー (CLP)』を参照してください。
java com.ibm.pdq.tools.ManageRepository -create repository -repositoryType pureQueryOnly -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE -repositoryUsername mytestid -repositoryPassword testpwd -repositoryDriverClass com.ibm.db2.jcc.DB2Driver以下のコマンドは、データベースに対する接続を作成し、 そのデータベース内にリポジトリーを作成できる SQL スクリプトを生成します。
java com.ibm.pdq.tools.ManageRepository -create repository -repositoryType pureQueryOnly -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE -repositoryUsername mytestid -repositoryPassword testpwd -repositoryDriverClass com.ibm.db2.jcc.DB2Driver -generateScriptOnly D:¥test¥scripts¥createtest.sql
java com.ibm.pdq.tools.ManageRepository –delete repository -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE -repositoryUsername mytestid -repositoryPassword testpwd -repositoryDriverClass com.ibm.db2.jcc.DB2Driver