13.7.1.5 RENAME USER 構文

RENAME USER old_user TO new_user
    [, old_user TO new_user] ...

RENAME USER ステートメントは、既存の MySQL アカウントの名前を変更します。存在しない古いアカウント、またはすでに存在する新しいアカウントに対しては、エラーが発生します。このステートメントを使用するには、mysql データベースに対するグローバルな CREATE USER 権限または UPDATE 権限が必要です。

各アカウント名には、セクション6.2.3「アカウント名の指定」で説明されている形式が使用されます。例:

RENAME USER 'jeffrey'@'localhost' TO 'jeff'@'127.0.0.1';

アカウント名のユーザー名の部分のみを指定した場合は、'%' のホスト名の部分が使用されます。

RENAME USER により、古いユーザーによって保持されていた権限は新しいユーザーによって保持される権限になります。ただし、RENAME USER は、古いユーザーが作成したどのデータベースまたはそれらのデータベース内のどのオブジェクトも自動的には削除したり、無効にしたりしません。これには、DEFINER 属性に古いユーザーが指定されているストアドプログラムまたはビューが含まれます。このようなオブジェクトにアクセスしようとすると、それが定義者のセキュリティーコンテキストで実行された場合は、エラーが生成される可能性があります。(セキュリティーコンテキストについては、セクション20.6「ストアドプログラムおよびビューのアクセスコントロール」を参照してください。)

権限の変更は、セクション6.2.6「権限変更が有効化される時期」に示されているように有効になります。