現在のデータベースの空のコピーを作成します。

定義位置

Database

構文

public Database createCopy(String server, String dbfile)
   throws NotesException

public Database createCopy(String server, String dbfile, int maxsize)
   throws NotesException

パラメータ

String server

新規データベースが配置されるサーバーの名前です。ローカルコピーを作成するには null または空の文字列 ("") を指定します。

新規コピーのファイル名です。

メモ このパラメータは R5 で新しく追加されました。

新規データベースの最大サイズを (ギガバイトで) 割り当てます。このパラメータは、Release 4 系のデータベース、または Release 5 にアップグレードしていないサーバーで作成されたデータベースにのみ有効です。4 より大きい数を指定すると、ランタイムエラーが発生します。

Database

新規コピーを返します。

指定したファイル名のデータベースが既に存在する場合は、例外が生成されます。

コピーには、現在のデータベースと同じ設計要素、アクセス制御リスト、およびタイトルが含まれます。コピーに文書は含まれません。

このコピーはレプリカではありません。

サーバーへのリモート (IIOP) 呼び出しを使用するプログラムは、別のサーバー上のデータベースを生成またはアクセスすることはできません。このような場合、server パラメータはそのプログラムが実行されるサーバーと同じものを示していなければなりません。これには次の 2 つの方法があります。

• null または空の文字列 ("") を使用して現在使用中のコンピュータを表す。最も安全な方法です。
• プログラムが実行されるサーバーの名前が server の名前と一致することを確認する。

新規データベースには元のデータベースの ACL がコピーされますが、そのコピーデータベースの ACL を変更したい場合があります。たとえば、ユーザー自身がコピー元データベースの管理者でないときでも、コピーされたデータベースの ［管理者］ のアクセス権を必要とするときがあります。コピーの ACL を変更するには、メソッド grantAccess と revokeAccess を使用します。

クロスリファレンス

LotusScript NotesDatabase クラスの CreateCopy メソッド

式言語の FileDatabaseCopy@コマンド

例
関連項目

データベースの作成、圧縮、削除、複製を行う

用語集