创建和管理 MySQL 用户

本页面介绍如何对 Cloud SQL 实例执行以下操作:

  • 配置默认用户帐号。
  • 创建、删除和更新其他用户帐号。

如需了解用户如何使用 Cloud SQL,请参阅 MySQL 用户

准备工作

在完成以下任务之前,请先创建一个 Cloud SQL 实例。如需了解详情,请参阅创建实例

如果您计划使用数据库的管理客户端来管理用户,必须已在实例上配置默认用户。如需了解详情,请参阅配置默认帐号

此外,您必须已配置一个与您的实例相连的管理客户端。如需了解详情,请参阅外部应用连接方案

配置默认用户帐号

创建新的 Cloud SQL 实例时,您必须首先配置默认用户帐号,之后才能连接到该实例。

对于 Cloud SQL for MySQL,默认用户为 root

如需配置默认用户,请按如下所述操作:

控制台

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。

    转到“Cloud SQL 实例”页面

  2. 点击实例打开其“概览”页面。
  3. 从导航菜单中选择用户
  4. 找到“主机”值为 % (any host)root 用户,并从“更多操作”菜单 “更多操作”图标。 中选择更改密码
  5. 输入一个您能记住且安全系数高的密码,然后点击确定

gcloud

为默认用户设置密码:

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

REST v1beta4

以下请求使用 users:update 方法更新根用户帐号

('root'@'%')。

在使用下面的任何请求数据之前,请先进行以下替换:

  • project-id:您的项目 ID
  • instance-id:所需的实例 ID
  • user-id:用户的 ID
  • password:用户的密码

HTTP 方法和网址:

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

请求 JSON 正文:

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

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 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"
}

创建用户

如需创建用户,请按如下所述操作

控制台

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。

    转到“Cloud SQL 实例”页面

  2. 选择实例以打开其“概览”页面。
  3. 从导航菜单中选择用户
  4. 点击添加用户
  5. 将一个用户帐号添加到实例 instance_name 页面中,添加以下信息:
    • 用户名
    • 密码
    • 主机(可选)。

      默认值是“%”,表示主机列表不受限制。您还可以提供 IP 地址或 IP 地址范围,表示只有从这些地址连接的用户才能访问数据库。

  6. 点击创建

使用 Cloud SQL 创建的用户拥有与 cloudsqlsuperuser 角色关联的权限:CREATEROLECREATEDBLOGIN。由这些用户创建的用户可以拥有数据库连接权限,这样可以防止用户被删除。

使用 Cloud SQL 创建的用户拥有除 FILESUPER 以外的所有权限。如果您需要更改用户的权限,请在 mysql 客户端中使用 GRANTREVOKE 命令。

gcloud

创建用户:

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

使用 Cloud SQL 创建的用户拥有与 cloudsqlsuperuser 角色关联的权限:CREATEROLECREATEDBLOGIN。由这些用户创建的用户可以拥有数据库连接权限,这样可以防止用户被删除。

使用 Cloud SQL 创建的用户拥有除 FILESUPER 以外的所有权限。如果您需要更改用户的权限,请在 mysql 客户端中使用 GRANTREVOKE 命令。

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 方法和网址:

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

请求 JSON 正文:

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

如需发送您的请求,请展开以下选项之一:

您应该会收到类似以下内容的 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 创建的用户拥有与 cloudsqlsuperuser 角色关联的权限:CREATEROLECREATEDBLOGIN。由这些用户创建的用户可以拥有数据库连接权限,这样可以防止用户被删除。

使用 Cloud SQL 创建的用户拥有除 FILESUPER 以外的所有权限。如果您需要更改用户的权限,请在 mysql 客户端中使用 GRANTREVOKE 命令。

Cloud SQL 和本地 MySQL 的用户名长度限制一样;MySQL 8.0 为 32 个字符,较低版本为 16 个字符。

MySQL 客户端

  1. mysql 提示符处,运行如下命令来创建用户:
      CREATE USER '[USER_NAME]'@'%'
         IDENTIFIED BY '[PASSWORD]';
      
  2. 您可以通过显示用户表来确认创建用户:
    SELECT user, host FROM mysql.user;
    
    对于第二代实例,输出类似于下面的示例:
    +----------+-----------+
    | user     | host      |
    +----------+-----------+
    | root     | %         |
    | newuser  | %         |
    +----------+-----------+
    1 row in set (0.01 sec)
    
  3. 使用 GRANT 语句授予用户权限。 如需了解详情,请参阅 MySQL 提供的权限
  4. 刷新 mysql.user 表以确保更改持续有效:
      FLUSH TABLES mysql.user;
    

更改用户密码

如需更改用户密码,请按如下所述操作

控制台

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。

    转到“Cloud SQL 实例”页面

  2. 选择实例以打开其“概览”页面。
  3. 从导航菜单中选择用户
  4. 点击要更新的用户对应的“更多操作”菜单 “更多操作”图标。
  5. 选择更改密码,指定新密码,然后点击确定

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 方法和网址:

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

请求 JSON 正文:

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

如需发送您的请求,请展开以下选项之一:

您应该会收到类似以下内容的 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 客户端

  1. mysql 提示符处,运行如下命令来更改密码:
    SET PASSWORD FOR [USER] = PASSWORD('auth_string');
    
  2. 刷新 mysql.user 表以确保更改持续有效:
    FLUSH TABLES mysql.user;
    

更新用户

如需更新主机或权限等用户属性,您必须使用 mysql 客户端。如需了解详情,请参阅 MySQL 文档中的 MySQL 用户帐号管理

列出用户

如需列出用户,请按如下所述操作

控制台

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。

    转到“Cloud SQL 实例”页面

  2. 选择实例以打开其“概览”页面。
  3. 从导航菜单中选择用户

gcloud

列出此实例的用户:

gcloud sql users list --instance=[INSTANCE_NAME]

如需查看此命令的完整参数列表,请参阅 gcloud sql users list 参考页面

REST v1beta4

以下请求使用 users:list 方法列出为实例定义的用户。

在使用下面的请求数据之前,请先进行以下替换:

  • project-id:您的项目 ID
  • instance-id:所需的实例 ID

HTTP 方法和网址:

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

如需发送您的请求,请展开以下选项之一:

您应该会收到类似以下内容的 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;

对于仅配置了根用户帐号的第二代实例,输出类似于下面的示例:

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

此示例显示添加了 user'root'@'%' 的实例的用户。密码字段显示密码的哈希值。

删除用户

如需删除用户,请按如下所述操作

在删除用户之前,您必须先放弃该用户拥有的所有对象或重新分配其所有权,并撤消该角色对其他对象拥有的任何特权。

控制台

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。

    转到“Cloud SQL 实例”页面

  2. 选择实例以打开其“概览”页面。
  3. 从导航菜单中选择用户
  4. 点击要删除的用户对应的“更多操作”菜单 “更多操作”图标。
  5. 选择删除,然后点击确定

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 方法和网址:

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

请求 JSON 正文:

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

如需发送您的请求,请展开以下选项之一:

您应该会收到类似以下内容的 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 客户端

  1. mysql 提示符处,运行如下命令来删除用户:
    DROP USER '[USER_NAME]'@'[HOST_NAME]';
    

    如需详细了解 DROP USER 语句,请参阅 MySQL 文档

  2. 刷新 mysql.user 表以确保更改持续有效:
    FLUSH TABLES mysql.user;
    

后续步骤