MySQL ユーザーの作成と管理

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスに対して次の操作を行う方法について説明します。

デフォルトのユーザーアカウントを構成します。
他のユーザーアカウントを作成、削除、更新します。

Cloud SQL でのユーザーの詳細については、MySQL ユーザーをご覧ください。

始める前に

以下のタスクを完了する前に、Cloud SQL インスタンスを作成します。詳細については、インスタンスの作成をご覧ください。

データベースの管理クライアントを使用してユーザーを管理する場合は、インスタンスでデフォルトユーザーを構成しておく必要があります。詳細については、デフォルトアカウントの構成をご覧ください。

また、インスタンスに接続された管理クライアントを構成しておく必要があります。詳細については、外部アプリケーションのための接続オプションをご覧ください。

デフォルトユーザーアカウントの構成

新しい Cloud SQL インスタンスを作成する場合、インスタンスに接続するには、デフォルトユーザーアカウントを構成しておく必要があります。

Cloud SQL for MySQL では、デフォルトユーザーは root@% です。

デフォルトユーザーを構成するには:

Console

Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスをクリックして [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
% (any host) のホスト値で root ユーザーを検索し、その他の操作メニューから [パスワードを変更] を選択します。
覚えやすく強力なパスワードを指定し、[OK] をクリックします。

gcloud

デフォルトユーザーのパスワードを設定します。

gcloud sql users set-password root \
    --host=% --instance=[INSTANCE_NAME] --prompt-for-password

REST v1beta4

次のリクエストでは、users:update メソッドを使用して、root ユーザーアカウント

（'root'@'%'）を更新します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

project-id: 実際のプロジェクト ID
instance-id: 目的のインスタンス ID
password: ユーザーのパスワード

HTTP メソッドと URL:

PUT https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25

JSON 本文のリクエスト:

{
  "name": "root",
  "password": "password"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 以下のコマンドでは、ご利用のユーザーアカウントで gcloud を認証する際に gcloud init または gcloud auth login を使用していることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PUT \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PUT `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2020-02-07T22:38:41.217Z",
  "startTime": "2020-02-07T22:38:41.217Z",
  "endTime": "2020-02-07T22:38:44.801Z",
  "operationType": "UPDATE_USER",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

ユーザーを作成する

ユーザーを作成するには、次のようにします。

Console

Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
[ユーザーを追加] をクリックします。
[ユーザーアカウントをインスタンス instance_name に追加] ページで、次の情報を追加します。
- ユーザー名
- パスワード
- ホスト（オプション）
  
  デフォルトは '%' です。これは、ホストリストが制限されていないことを意味します。IP アドレスまたは IP アドレスの範囲を指定することもできます。この場合、これらのアドレスから接続しているユーザーだけがデータベースにアクセスできます。
[作成] をクリックします。

Cloud SQL を使用して作成されたユーザーには、cloudsqlsuperuser ロールと関連付けられている権限（CREATEROLE、CREATEDB、LOGIN）があります。これらのユーザーによって作成されたユーザーは、データベース接続権限を持つことができます。これにより、ユーザーが削除されるのを防ぐことができます。

Cloud SQL を使用して作成されたユーザーは、FILE と SUPER を除くすべての権限を持っています。ユーザーの権限を変更する必要がある場合は、mysql クライアントで GRANT コマンドまたは REVOKE コマンドを使用します。

gcloud

ユーザーを作成します。

gcloud sql users create [user_name] \
   --host=[HOST] --instance=[INSTANCE_NAME] --password=[PASSWORD]

Cloud SQL のユーザー名の長さの上限は、オンプレミス MySQL と同じで、MySQL 8.0 では 32 文字、それ以前のバージョンでは 16 文字です。

REST v1beta4

以下のリクエストでは、users:insert メソッドを使用してユーザーアカウント「user_name」を作成します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

project-id: 実際のプロジェクト ID
instance-id: 目的のインスタンス ID
user-id: ユーザーの ID
password: ユーザーのパスワード

HTTP メソッドと URL:

POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users

JSON 本文のリクエスト:

{
  "name": "user-id",
  "password": "password"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2020-02-07T22:44:16.656Z",
  "startTime": "2020-02-07T22:44:16.686Z",
  "endTime": "2020-02-07T22:44:20.437Z",
  "operationType": "CREATE_USER",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Cloud SQL のユーザー名の長さの上限は、オンプレミス MySQL と同じで、MySQL 8.0 では 32 文字、それ以前のバージョンでは 16 文字です。

MySQL クライアント

mysql プロンプトで、ユーザーを作成します。

  CREATE USER '[USER_NAME]'@'%'
     IDENTIFIED BY '[PASSWORD]';

ユーザーテーブルを表示することによって、ユーザーの作成を確認できます。

SELECT user, host FROM mysql.user;

第 2 世代インスタンスの場合、出力は次の例のようになります。

+----------+-----------+
| user     | host      |
+----------+-----------+
| root     | %         |
| newuser  | %         |
+----------+-----------+
1 row in set (0.01 sec)

GRANT ステートメントでユーザーに権限を付与します。詳細については、MySQL によって提供される権限をご覧ください。
mysql.user テーブルをフラッシュして、変更が反映されていることを確認します。
```
  FLUSH TABLES mysql.user;
```

ユーザーのパスワードの変更

ユーザーのパスワードを変更するには:

Console

Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
更新するユーザーのその他アイコンをクリックします。
[パスワードを変更] を選択し、新しいパスワードを指定して、[OK] をクリックします。

gcloud

パスワードを更新します。

gcloud sql users set-password [USER_NAME] \
   --host=[HOST] --instance=[INSTANCE_NAME] --prompt-for-password

REST v1beta4

次のリクエストでは、users:update メソッドを使用して、ユーザーアカウント user_name'@'%' のパスワードを更新します。ユーザーが別のホストを使用している場合は、その正しいホストで呼び出しを変更する必要があります。

後述のリクエストのデータを使用する前に、次のように置き換えます。

project-id: 実際のプロジェクト ID
instance-id: 目的のインスタンス ID
user-id: ユーザーの ID
password: ユーザーのパスワード

HTTP メソッドと URL:

PUT https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=user-id

JSON 本文のリクエスト:

{
  "name": "user-id",
  "password": "password"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PUT \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=user-id

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PUT `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=user-id" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2020-02-07T22:38:41.217Z",
  "startTime": "2020-02-07T22:38:41.217Z",
  "endTime": "2020-02-07T22:38:44.801Z",
  "operationType": "UPDATE_USER",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

MySQL クライアント

mysql プロンプトで、パスワードを変更します。
```
SET PASSWORD FOR [USER] = PASSWORD('auth_string');
```
mysql.user テーブルをフラッシュして、変更が反映されていることを確認します。
```
FLUSH TABLES mysql.user;
```

ユーザーの更新

ホストや権限などのユーザープロパティを更新するには、mysql クライアントを使用する必要があります。詳細については、MySQL のドキュメントの MySQL ユーザーアカウント管理をご覧ください。

ユーザーを一覧表示する

ユーザーを一覧表示するには:

Console

Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。

gcloud

このインスタンスのユーザーを一覧表示します。

gcloud sql users list --instance=[INSTANCE_NAME]

このコマンドのパラメータの完全なリストについては、gcloud sql users list のリファレンスページをご覧ください。

REST v1beta4

次のリクエストでは、users:list メソッドを使用して、インスタンスに定義されているユーザーを一覧表示します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

project-id: 実際のプロジェクト ID
instance-id: 目的のインスタンス ID

HTTP メソッドと URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#usersList",
  "items": [
    {
      "kind": "sql#user",
      "etag": "--redacted--",
      "name": "sqlserver",
      "host": "",
      "instance": "instance-id",
      "project": "project-id",
      "sqlserverUserDetails": {
        "serverRoles": [
          "CustomerDbRootRole"
        ]
      }
    },
    {
      "kind": "sql#user",
      "etag": "--redacted--",
      "name": "user-id-1",
      "host": "",
      "instance": "instance-id",
      "project": "project-id",
      "sqlserverUserDetails": {
        "serverRoles": [
          "CustomerDbRootRole"
        ]
      }
    },
    {
      "kind": "sql#user",
      "etag": "--redacted--",
      "name": "user-id-2",
      "host": "",
      "instance": "instance-id",
      "project": "project-id",
      "sqlserverUserDetails": {
        "serverRoles": [
          "CustomerDbRootRole"
        ]
      }
    },
    {
      ...
    },
    {
      ...
    }
  ]
}

MySQL クライアント

mysql のプロンプトで、MySQL ユーザーを一覧表示します。

SELECT user, host FROM mysql.user;

root ユーザーアカウントのみが構成されている第 2 世代インスタンスの場合、出力は次の例のようになります。

+------+-----------+
| user | host      |
+------+-----------+
| root | %         |
+------+-----------+
1 row in set (0.01 sec)

この例では、ユーザー 'root'@'%' を追加したインスタンスのユーザーが示されています。パスワードフィールドには、パスワードのハッシュが表示されています。

ユーザーの削除

ユーザーを削除するには:

ユーザーを削除する前に、そのユーザーが所有するすべてのオブジェクトを削除するか、ユーザーの所有権の割り当てを変更して、他のオブジェクトにロールが付与されている権限をすべて取り消す必要があります。

Console

Google Cloud Console の [Cloud SQL インスタンス] ページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
削除するユーザーのその他アイコンをクリックします。
[削除] を選択し、[OK] をクリックします。

gcloud

ユーザーを削除します。

gcloud sql users delete [USER_NAME] --host=[HOST] --instance=[INSTANCE_NAME]

REST v1beta4

以下のリクエストでは、users:delete メソッドを使用して、指定したユーザーアカウントを削除します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

project-id: 実際のプロジェクト ID
instance-id: 目的のインスタンス ID
user-id: ユーザーの ID

HTTP メソッドと URL:

DELETE https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=&name=user-id

JSON 本文のリクエスト:

{
  "name": "user-id",
  "host": ""
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=&name=user-id

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=&name=user-id" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2020-02-07T22:38:41.217Z",
  "startTime": "2020-02-07T22:38:41.217Z",
  "endTime": "2020-02-07T22:38:44.801Z",
  "operationType": "DELETE_USER",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

MySQL クライアント

mysql プロンプトで、ユーザーを削除します。
```
DROP USER '[USER_NAME]'@'[HOST_NAME]';
```
DROP USER ステートメントの詳細については、MySQL のドキュメントをご覧ください。
mysql.user テーブルをフラッシュして、変更が反映されていることを確認します。
```
FLUSH TABLES mysql.user;
```

次のステップ

Cloud SQL でのユーザーの操作の詳細について学習する。
MySQL のドキュメントでユーザーの作成方法を確認する。
インスタンスへの接続について学習する。

MySQL ユーザーの作成と管理

始める前に

デフォルト ユーザー アカウントの構成

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

ユーザーを作成する

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

MySQL クライアント

ユーザーのパスワードの変更

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

MySQL クライアント

ユーザーの更新

ユーザーを一覧表示する

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

MySQL クライアント

ユーザーの削除

Console

gcloud

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

MySQL クライアント

次のステップ

デフォルトユーザーアカウントの構成