- Documentation Library
- Table of Contents
- MySQL 3.23/4.0/4.1 Manual
- Table of Contents
- 11.1.3 C API 関数の説明
- 11.1.3.1 mysql_affected_rows()
- 11.1.3.2 mysql_change_user()
- 11.1.3.3 mysql_character_set_name()
- 11.1.3.4 mysql_close()
- 11.1.3.5 mysql_connect()
- 11.1.3.6 mysql_create_db()
- 11.1.3.7 mysql_data_seek()
- 11.1.3.8 mysql_debug()
- 11.1.3.9 mysql_drop_db()
- 11.1.3.10 mysql_dump_debug_info()
- 11.1.3.11 mysql_eof()
- 11.1.3.12 mysql_errno()
- 11.1.3.13 mysql_error()
- 11.1.3.14 mysql_escape_string()
- 11.1.3.15 mysql_fetch_field()
- 11.1.3.16 mysql_fetch_fields()
- 11.1.3.17 mysql_fetch_field_direct()
- 11.1.3.18 mysql_fetch_lengths()
- 11.1.3.19 mysql_fetch_row()
- 11.1.3.20 mysql_field_count()
- 11.1.3.21 mysql_field_seek()
- 11.1.3.22 mysql_field_tell()
- 11.1.3.23 mysql_free_result()
- 11.1.3.24 mysql_get_client_info()
- 11.1.3.25 mysql_get_client_version()
- 11.1.3.26 mysql_get_host_info()
- 11.1.3.27 mysql_get_proto_info()
- 11.1.3.28 mysql_get_server_info()
- 11.1.3.29 mysql_get_server_version()
- 11.1.3.30 mysql_info()
- 11.1.3.31 mysql_init()
- 11.1.3.32 mysql_insert_id()
- 11.1.3.33 mysql_kill()
- 11.1.3.34 mysql_list_dbs()
- 11.1.3.35 mysql_list_fields()
- 11.1.3.36 mysql_list_processes()
- 11.1.3.37 mysql_list_tables()
- 11.1.3.38 mysql_num_fields()
- 11.1.3.39 mysql_num_rows()
- 11.1.3.40 mysql_options()
- 11.1.3.41 mysql_ping()
- 11.1.3.42 mysql_query()
- 11.1.3.43 mysql_real_connect()
- 11.1.3.44 mysql_real_escape_string()
- 11.1.3.45 mysql_real_query()
- 11.1.3.46 mysql_reload()
- 11.1.3.47 mysql_row_seek()
- 11.1.3.48 mysql_row_tell()
- 11.1.3.49 mysql_select_db()
- 11.1.3.50 mysql_set_server_option()
- 11.1.3.51 mysql_shutdown()
- 11.1.3.52 mysql_sqlstate()
- 11.1.3.53 mysql_ssl_set()
- 11.1.3.54 mysql_stat()
- 11.1.3.55 mysql_store_result()
- 11.1.3.56 mysql_thread_id()
- 11.1.3.57 mysql_use_result()
- 11.1.3.58 mysql_warning_count()
- 11.1.3.59 mysql_commit()
- 11.1.3.60 mysql_rollback()
- 11.1.3.61 mysql_autocommit()
- 11.1.3.62 mysql_more_results()
- 11.1.3.63 mysql_next_result()
my_bool mysql_change_user(MYSQL *mysql, const char
*user, const char *password, const char *db)
説明
ユーザを変更し、db
で指定されたデータベースを
mysql
で指定された接続のデフォルト（カレント）データベースにします。このデータベースは、その後実行されるクエリで明示的なデータベース指定子のないテーブル参照が行われる際のデフォルトになります。
この関数は、MySQL 3.23.3 で導入されました。
mysql_change_user()
は、指定したユーザが認証されない場合、またはそのユーザがデータベースを使用する権限を持たない場合に、失敗します。この場合、ユーザおよびデータベースは変更されません。
デフォルトデータベースを使用しない場合、db
パラメータを NULL
に設定します。
MySQL 4.0.6
以降、このコマンドは、新しい接続が確立した場合は常に、任意のアクティブなトランザクションの
ROLLBACK
の実行、すべてのテンポラリテーブルのクローズ、ロックされたすべてのテーブルのアンロック、および状態のリセットを行います。この処理は、ユーザが変更されなかった場合も必ず行われます。
戻り値
正常終了した場合は 0。エラーが発生した場合は 0 以外。
エラー
mysql_real_connect()
が返すエラーと同じ。
-
CR_COMMANDS_OUT_OF_SYNCコマンドが正しい順序で実行されなかった。
-
CR_SERVER_GONE_ERRORMySQL サーバがいなくなった。
-
CR_SERVER_LOSTクエリの実行中にサーバへの接続が切断された。
-
CR_UNKNOWN_ERROR不明なエラーが発生した。
-
ER_UNKNOWN_COM_ERRORMySQL サーバでこのコマンドが実装されていない（バージョンが古いと考えられる）。
-
ER_ACCESS_DENIED_ERRORユーザまたはパスワードが正しくない。
-
ER_BAD_DB_ERRORデータベースが存在しない。
-
ER_DBACCESS_DENIED_ERRORユーザがデータベースへのアクセス権を持っていない。
-
ER_WRONG_DB_NAMEデータベース名が長すぎる。
例
if (mysql_change_user(&mysql, "user", "password", "new_database"))
{
fprintf(stderr, "Failed to change user. Error: %s\n",
mysql_error(&mysql));
}
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
