ttRestore

説明

ttBackup C関数またはttBackupユーティリティを使用して作成したバックアップから、接続文字列で指定したデータベースをリストアします。データベースがすでに存在している場合、ttRestoreはデータベースを上書きしません。

『Oracle TimesTen In-Memory Databaseリファレンス』のttRestoreも参照してください。

必要な権限

インスタンス管理者

構文

ttRestore (ttUtilHandle handle, const char* connStr, 
           ttRestoreType type, const char* backupDir, 
           const char* baseName, ttUtFileHandle stream,
           unsigned intflags)

パラメータ

パラメータ	型	説明
`handle`	`ttUtilHandle`	`ttUtilAllocEnv`を使用して割り当てられるTimesTenユーティリティ・ライブラリ環境ハンドルを指定します。
`connStr`	`const char*`	これは、リストアするデータベースについて記述する接続文字列を指定する、空文字で終了する文字列です。
`type`	`ttRestoreType`	ファイル・バックアップまたはストリーム・バックアップのどちらからデータベースをリストアするかを指定します。有効な値は、次のとおりです。 `TT_RESTORE_FILE`: `backupDir`および`baseName`パラメータで指定されたバックアップ・パスにあるファイル・バックアップから、データベースをリストアします。 `TT_RESTORE_STREAM`: 指定したストリームから読み取られたストリーム・バックアップから、データベースをリストアします。
`backupDir`	`const char*`	`TT_RESTORE_FILE`の場合、バックアップ・ファイルが保存されるディレクトリを指定します。 `TT_RESTORE_STREAM`の場合、このパラメータは無視されます。
`baseName`	`const char*`	`TT_RESTORE_FILE`の場合、`backupDir`パラメータで指定されたバックアップ・ディレクトリにあるバックアップ・ファイルの接頭辞を指定します。 `NULL`を指定すると、バックアップ・ファイルのファイル接頭辞には、データベースのODBC定義に設定された`DataStore`属性のファイル名部分が適用されます。 `TT_RESTORE_STREAM`の場合、このパラメータは無視されます。
`stream`	`ttUtFileHandle`	`TT_RESTORE_STREAM`の場合、バックアップを読み取るストリームを指定します。 LinuxまたはUNIXの場合は、`read(2)`を使用して読み込むことができる整数ファイル記述子です。0(ゼロ)を渡すと、`stdin`からバックアップが読み取られます。 Windowsの場合は、`ReadFile`を使用して読み込むことができるハンドルです。`GetStdHandle(STD_INPUT_HANDLE)`の結果を渡すと、標準入力から読み取られます。 `TT_RESTORE_FILE`の場合、このパラメータは無視されます。アプリケーションで、このパラメータに対して`TTUTIL_INVALID_FILE_HANDLE`を渡すことができます。
`flags`	`unsigned int`	これは、将来使用するために予約されています。0(ゼロ)に設定します。