IDAX.EXPORT_MODEL - モデルのエクスポート

このストアード・プロシージャーを使用して、モデルを別のデータベースにインポートできるようにエクスポートします。

許可

ステートメントの許可 ID が保持する特権に、少なくとも以下のいずれかの権限が含まれていなければなりません。

DATAACCESS 権限
エクスポートされたすべてのモデル内のすべての表に対する SELECT 特権。
注: acl パラメーターを使用するには、ステートメントの許可 ID に以下のいずれかの権限も含まれている必要があります。
- SECADM
- DBADM
- SQLADM
- ACCESSCTRL
- DATAACCESS

構文

IDAX.EXPORT_MODEL(in parameter_string varchar(32672))

パラメーターの説明

parameter_string

コンマで区切られた <parameter>=<value> 項目のペアを含む必須の 1 ストリング・パラメーター。

データ型: VARCHAR(32672)

以下のリストに、パラメーター値を示します。

directory: 必須。; エクスポート・ファイル用のターゲット・ディレクトリーの絶対パス。; ディレクトリーが既に存在している必要があります。.; エクスポートされたモデルには専用のディレクトリー (または一時ディレクトリー) を使用することを検討してください。このディレクトリーを使用すると、データベース・プロセスが失敗した場合に残されるすべての中間ファイルのクリーンアップが容易になります。
name: 必須。; エクスポート・ファイルのファイル名。
acl: オプション。; エクスポート・ファイルにモデル特権 (アクセス制御リスト) を含めるかどうかを指定します。; デフォルト: false
all: オプション。; すべてのスキーマからのモデルをエクスポートするかどうかを指定します。デフォルトでは、現行スキーマのモデルのみがエクスポートされます。
注: all パラメーターを true に設定した場合、schema パラメーターは使用できません。; デフォルト: false
log: オプション。; (.elog 拡張子を持つ) ログ・ファイルに書き込むかどうかを指定します。このログ・ファイルには、正常にエクスポートされたモデルのリストおよびエクスポート操作でスキップされたモデルに関するエラー・メッセージが含まれます。; デフォルト: false
model: オプション。; エクスポートされるモデルの名前。; 複数のモデル名はセミコロンを使用して区切ります。モデル名に大/小文字混合を使用する場合は、名前を二重引用符で囲む必要があります。; <schema>.<model> のように、モデル名をスキーマ名で修飾できます。スキーマ名を含めない場合、プロシージャーでは、現行スキーマに存在するモデルがエクスポートされます。
overwrite: オプション。; 名前の競合が発生した場合に実行するアクション。; ターゲット・ディレクトリー内のファイルの名前が name パラメーターで指定した名前と同じ場合、エクスポート操作はデフォルトで失敗します。overwrite=true を指定した場合、エクスポート・ファイルがターゲット・ディレクトリーに書き込まれる前に既存のファイルが削除されます。; デフォルト: false
resume: オプション。; モデルをエクスポートできない場合に EXPORT_MODEL プロシージャーを停止するかどうかを指定します。デフォルトでは、エクスポートできないモデルはスキップされ、エクスポート操作は続行されます。; デフォルト: true
schema: オプション。; モデルのエクスポート元のスキーマを指定します。
注: all パラメーターを true に設定した場合、schema パラメーターは指定できません。; デフォルト: 現行スキーマ
where: オプション。; エクスポートされるモデルをフィルタリングする節。LIST_MODELS プロシージャーによって表示されるモデルはいずれも、WHERE 節によってフィルタリングできます。

戻される情報

EXPORT_MODEL プロシージャーは、正常にエクスポートされたすべてのモデルの名前を含む結果セットを戻します。resume パラメーターを true に設定した場合、結果セットには、スキップされたモデル (ユーザーがエクスポート特権を持たないモデルを除く) の名前および付随するエラー・メッセージも含まれます。

例

以下の例では、現行スキーマからのすべてのモデルを /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('directory=/tmp, name=foo')
```
以下の例では、スキーマ SAMPLE からのすべてのモデルを /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('schema=sample, directory=/tmp, name=foo')
```
以下の例では、すべてのスキーマからのすべてのモデルを /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('all=true, directory=/tmp, name=foo')
```
以下の例では、現行スキーマからのモデル M1 および M2 を /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('model=sample.m1;test.m2, directory=/tmp, name=foo')
```
以下の例では、現行スキーマからのモデル M1 および M2 を /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('model=m1;m2, directory=/tmp, name=foo')
```
以下の例では、モデル SAMPLE.M1 および TEST.M2 を /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('model=sample.m1;test.m2, directory=/tmp, name=foo')
```
以下の例では、現行スキーマからのモデル M1 と、モデル名が「T」で始まる現行スキーマからのすべてのモデルを /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('model=m1, where=modelname like ''T%'', di-rectory=/tmp, name=foo')
```
以下の例では、モデル名が「T」で始まるスキーマ SAMPLE からのモデルを /tmp/foo.mdl にエクスポートします。
```
call idax.export_model('schema=sample, where=modelname like ''T%'', directory=/tmp, name=foo')
```