fbsql_db_status
指定したデータベースの状態を取得する
説明
int fbsql_db_status
( string $database_name
[, resource $link_identifier
] )
パラメータ
-
database_name
-
データベース名。
-
link_identifier
-
fbsql_connect あるいは
fbsql_pconnect が返す FrontBase リンク ID。
指定しなかった場合は、この関数は FrontBase
サーバーでオープンしているリンクを探します。見つからないときは
fbsql_connect に引数を指定せずにコールしたときと同様にして作成します。
返り値
現在の状態を表す整数値を返します。これは、以下の定数のいずれかです。
-
false
- host の exec ハンドラが無効です。このエラーは、
link_identifier
がポート番号を用いてデータベースへ直接接続する場合に発生します。
FBExec はサーバーで利用可能ですが、接続が行われていません。
-
FBSQL_UNKNOWN
- 状態は不明です。
-
FBSQL_STOPPED
-
FBSQL_STOPPED - データベースは実行されていません。
データベースを開始するには、fbsql_start_db
を使用してください。
-
FBSQL_STARTING
- データベースは起動中です。
-
FBSQL_RUNNING
-
データベースは実行中で、SQL 処理を実行可能です。
-
FBSQL_STOPPING
- データベースは停止中です。
-
FBSQL_NOEXEC
-
FBExec がサーバーで実行されておらず、
データベースの状態を取得することはできません。
参考
- fbsql_start_db
- fbsql_stop_db