本页面介绍如何启用和使用 Cloud SQL 内置身份验证。
如需查看概览，请参阅 Cloud SQL 内置数据库身份验证。创建用户之前的准备工作
- 创建 Cloud SQL 实例。如需了解详情，请参阅创建实例。
- 为实例启用密码政策。如需了解详情，请参阅实例密码政策。
如果您计划使用数据库的管理客户端来管理用户，请执行以下操作：
将客户端连接到实例。请参阅外部应用连接方案。
通过设置密码在实例上配置默认用户。请参阅为默认用户账号设置密码。
为默认用户账号设置密码
创建新的 Cloud SQL 实例时，您必须先为默认用户账号设置密码，然后才能连接到该实例。
对于 Cloud SQL for MySQL，默认用户为root@%。这表示具有用户名 root 的数据库用户，该用户可以从任何主机 (@%) 连接。控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
- 找到
root用户，然后从“更多操作”菜单
中选择更改密码。
请考虑所列的密码的规定，这些规定源自为实例设置的密码政策。
- 提供一个您能记住且安全系数高的密码，然后点击确定。
gcloud
使用 gcloud sql users set-password 命令为默认用户设置密码，如下所示。
在运行该命令之前，请将 INSTANCE_NAME 替换为实例的名称。
gcloud sql users set-password root \ --host=% \ --instance=INSTANCE_NAME \ --prompt-for-password
REST v1
如需更新默认用户账号的密码，请使用 PUT 请求和 users:update 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- password：用户的密码
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25
请求 JSON 正文：
{
"name": "root",
"password": "password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/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://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
REST v1beta4
如需更新默认用户账号的密码，请使用 PUT 请求和 users:update 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- password：用户的密码
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25
请求 JSON 正文：
{
"name": "root",
"password": "password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
创建用户
设置默认用户账号后，您可以创建其他用户。
控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
- 点击添加用户账号。
在向实例添加用户账号 instance_name 页面中，您可以选择用户是使用内置数据库方法（用户名和密码）还是作为 IAM 用户进行身份验证。
- 选择内置身份验证（默认设置），并添加以下信息：
- 用户名。
- 可选。密码。 提供一个您能记住且安全系数高的密码。
- 可选。用户密码政策。
- 主机名部分的默认值为允许任何主机，这意味着用户可以从任何 IP 地址连接。 （可选）选择按 IP 地址或地址范围限制主机，然后在主机部分中输入 IP 地址或地址范围。然后，用户只能从指定的一个或多个 IP 地址进行连接。
- 点击添加。
在使用 MySQL 8.0 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得 cloudsqlsuperuser 角色，并具有与此角色关联的以下权限：CREATEROLE、CREATEDB 和 LOGIN。
在使用 MySQL 5.7 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得除 FILE 和 SUPER 之外的所有权限。如果您需要更改这些用户的权限，则在 mysql 客户端中使用 GRANT 或 REVOKE 命令。
gcloud
如需创建用户，请使用 gcloud sql users create 命令。
替换以下内容：
- USER_NAME：用户名。
- HOST：用户的主机名，可以是特定 IP 地址、地址范围或任何主机 (
%)。 - INSTANCE_NAME：实例的名称。
- PASSWORD：用户的密码。
gcloud sql users create USER_NAME \ --host=HOST \ --instance=INSTANCE_NAME \ --password=PASSWORD
在使用 MySQL 8.0 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得 cloudsqlsuperuser 角色，并具有与此角色关联的以下权限：CREATEROLE、CREATEDB 和 LOGIN。
在使用 MySQL 5.7 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得除 FILE 和 SUPER 之外的所有权限。如果您需要更改这些用户的权限，则在 mysql 客户端中使用 GRANT 或 REVOKE 命令。
Cloud SQL 和本地 MySQL 的用户名长度限制一样；MySQL 8.0 为 32 个字符，较低版本为 16 个字符。
创建用户时，您可以添加用户密码政策参数。
Terraform
如需创建用户，请使用 Terraform 资源。
应用更改
如需在 Google Cloud 项目中应用 Terraform 配置，请完成以下部分中的步骤。
准备 Cloud Shell
- 启动 Cloud Shell。
-
设置要在其中应用 Terraform 配置的默认 Google Cloud 项目。
您只需为每个项目运行一次以下命令，即可在任何目录中运行它。
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
如果您在 Terraform 配置文件中设置显式值，则环境变量会被替换。
准备目录
每个 Terraform 配置文件都必须有自己的目录（也称为“根模块”）。
-
在 Cloud Shell 中，创建一个目录，并在该目录中创建一个新文件。文件名必须具有
.tf扩展名，例如main.tf。在本教程中，该文件称为main.tf。mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
如果您按照教程进行操作，可以在每个部分或步骤中复制示例代码。
将示例代码复制到新创建的
main.tf中。（可选）从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段，则建议这样做。
- 查看和修改要应用到您的环境的示例参数。
- 保存更改。
-
初始化 Terraform。您只需为每个目录执行一次此操作。
terraform init
（可选）如需使用最新的 Google 提供程序版本，请添加
-upgrade选项：terraform init -upgrade
应用更改
-
查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期：
terraform plan
根据需要更正配置。
-
通过运行以下命令并在提示符处输入
yes来应用 Terraform 配置：terraform apply
等待 Terraform 显示“应用完成！”消息。
- 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源，以确保 Terraform 已创建或更新它们。
删除更改
如需删除更改，请执行以下操作：
- 如需停用删除防护，请在 Terraform 配置文件中将
deletion_protection参数设置为false。deletion_protection = "false"
- 运行以下命令并在提示符处输入
yes，以应用更新后的 Terraform 配置：terraform apply
-
运行以下命令并在提示符处输入
yes，以移除之前使用 Terraform 配置应用的资源：terraform destroy
REST v1
如需创建用户，请使用 POST 请求和 users:insert 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- user-id：用户的 ID
- password：用户的密码
HTTP 方法和网址：
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users
请求 JSON 正文：
{
"name": "user-id",
"password": "password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/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://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
在使用 MySQL 8.0 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得 cloudsqlsuperuser 角色，并具有与此角色关联的以下权限：CREATEROLE、CREATEDB 和 LOGIN。
在使用 MySQL 5.7 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得除 FILE 和 SUPER 之外的所有权限。如果您需要更改这些用户的权限，则在 mysql 客户端中使用 GRANT 或 REVOKE 命令。
Cloud SQL 和本地 MySQL 的用户名长度限制一样；MySQL 8.0 为 32 个字符，较低版本为 16 个字符。
创建用户时，您可以添加用户密码政策参数。
REST v1beta4
如需创建用户，请使用 POST 请求和 users:insert 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- user-id：用户的 ID
- password：用户的密码
HTTP 方法和网址：
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users
请求 JSON 正文：
{
"name": "user-id",
"password": "password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
在使用 MySQL 8.0 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得 cloudsqlsuperuser 角色，并具有与此角色关联的以下权限：CREATEROLE、CREATEDB 和 LOGIN。
在使用 MySQL 5.7 和 Cloud SQL 的身份验证方法的实例上创建的用户会自动获得除 FILE 和 SUPER 之外的所有权限。如果您需要更改这些用户的权限，则在 mysql 客户端中使用 GRANT 或 REVOKE 命令。
Cloud SQL 和本地 MySQL 的用户名长度限制一样；MySQL 8.0 为 32 个字符，较低版本为 16 个字符。
创建用户时，您可以添加用户密码政策参数。
mysql 客户端
- 如需创建用户，请在
mysql提示符下使用以下 CREATE USER 语句：CREATE USER 'USER_NAME'@'%' IDENTIFIED BY 'PASSWORD';（可选）添加用户密码政策参数。
- 您可以通过显示用户表来确认创建用户：
SELECT user, host FROM mysql.user;
对于第二代实例，输出类似于下面的示例：+----------+-----------+ | user | host | +----------+-----------+ | root | % | | newuser | % | +----------+-----------+ 1 row in set (0.01 sec)
- 使用
GRANT语句授予用户权限。 如需了解详情，请参阅 MySQL 提供的权限。 -
刷新
mysql.user表以确保更改持续有效：FLUSH TABLES mysql.user;
设置用户密码政策
您可以使用内置身份验证类型设置密码政策。
控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
- 点击您要更改其政策的用户的“更多操作”菜单 。
- 选择修改密码政策。
- 在密码政策部分中，选择以下一个或多个选项：
- 设置将来会到期的密码：指定密码将在多少天后失效并且用户需要创建新密码。
- 失败的尝试达到规定次数后锁定用户：指定用户输入错误密码的最大次数，在此之后账户将被锁定。
仅受 Cloud SQL for MySQL 8.0 支持。
- 更改密码时需要输入当前密码：当用户尝试更改密码时要求用户输入现有密码。
gcloud
如需设置用户密码政策，请使用 gcloud sql users set-password-policy 命令。
使用 --password-policy-enable-password-verification 强制用户在尝试更改密码时输入其现有密码。如需停用此参数，请使用 --no-password-policy-enable-password-verification。
替换以下内容：
- USER_NAME：用户名。
- INSTANCE_NAME：实例的名称。
- HOST：用户的主机名，可以是特定 IP 地址、地址范围或任何主机 (
%)。 - PASSWORD_POLICY_ALLOWED_FAILED_ATTEMPTS（可选）：用户在锁定账号之前可以错误地尝试密码的次数。使用
--password-policy-enable-failed-attempts-check启用检查，使用--no-password-policy-enable-failed-attempts-check停用检查。 - PASSWORD_POLICY_PASSWORD_EXPIRATION_DURATION（可选）：指定密码失效且用户需要创建新密码之前的天数。
gcloud sql users set-password-policy USER_NAME \ --instance=INSTANCE_NAME \ --host=HOST \ --password-policy-enable-failed-attempts-check \ --password-policy-allowed-failed-attempts=PASSWORD_POLICY_ALLOWED_FAILED_ATTEMPTS \ --password-policy-password-expiration-duration=PASSWORD_POLICY_PASSWORD_EXPIRATION_DURATION \ --password-policy-enable-password-verification
如需移除用户密码政策，请使用 --clear-password-policy 参数。
gcloud sql users set-password-policy USER_NAME \ --instance=INSTANCE_NAME \ --host=HOST \ --clear-password-policy
如需查看用户密码政策，请参阅列出用户。
REST v1
如需设置用户密码政策，请将 PUT 请求与 users:update 方法结合使用。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：实例 ID
- USER_ID：用户的 ID
- PASSWORD：用户的密码
- FAILED_ATTEMPTS_CHECK：设置为
true以启用锁定账号之前登录尝试失败次数检查。 - NUMBER_OF_ATTEMPTS：锁定账户之前账号登录尝试失败次数。
- PASSWORD_EXPIRATION_DURATION：密码到期后，用户需要创建新密码的天数。
- VERIFY_PASSWORD：设置为
true以强制用户在尝试更改密码时输入密码。
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID/users?name=USER_ID
请求 JSON 正文：
{
"name": "USER_ID",
"password": "PASSWORD",
"data":
{
"passwordValidationUserPolicy" : {
{
"enableFailedAttemptsCheck" : "FAILED_ATTEMPTS_CHECK",
"allowedFailedAttempts" : "NUMBER_OF_ATTEMPTS",
"passwordExpirationDuration" : "PASSWORD_EXPIRATION_DURATION",
"enablePasswordVerification" : "VERIFY_PASSWORD"
}
},
}
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
如需查看用户密码政策，请参阅列出用户。
REST v1beta4
如需设置用户密码政策，请将 PUT 请求与 users:update 方法结合使用。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：实例 ID
- USER_ID：用户的 ID
- PASSWORD：用户的密码
- FAILED_ATTEMPTS_CHECK：设置为
true以启用锁定账号之前登录尝试失败次数检查。 - NUMBER_OF_ATTEMPTS：锁定账户之前账号登录尝试失败次数。
- PASSWORD_EXPIRATION_DURATION：密码到期后，用户需要创建新密码的天数。
- VERIFY_PASSWORD：设置为
true以强制用户在尝试更改密码时输入密码。
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/users?name=USER_ID
请求 JSON 正文：
{
"name": "USER_ID",
"password": "PASSWORD",
"data":
{
"passwordValidationUserPolicy" : {
{
"enableFailedAttemptsCheck" : "FAILED_ATTEMPTS_CHECK",
"allowedFailedAttempts" : "NUMBER_OF_ATTEMPTS",
"passwordExpirationDuration" : "PASSWORD_EXPIRATION_DURATION",
"enablePasswordVerification" : "VERIFY_PASSWORD"
}
},
}
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
如需查看用户密码政策，请参阅列出用户。
mysql 客户端
如需设置用户密码政策，请在 mysql 提示符下使用以下 ALTER USER 语句：
ALTER USER USER_NAME
FAILED_LOGIN_ATTEMPTS ALLOWED_FAILED_ATTEMPTS
PASSWORD EXPIRE INTERVAL PASSWORD_EXPIRATION_DURATION DAY
PASSWORD REQUIRE CURRENT;
替换以下内容：
- USER_NAME：用户名。
- ALLOWED_FAILED_ATTEMPTS（可选）：用户在锁定账号之前可以错误地尝试密码的次数。
- PASSWORD_EXPIRATION_DURATION（可选）：指定密码失效且用户需要创建新密码之前的天数。
使用 PASSWORD REQUIRE CURRENT 选项以使用户在尝试更改密码时必须输入其现有密码。
如需查看用户密码政策，请参阅列出用户。
列出用户
控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
该列表显示了每个用户的
User name、Host name和Authentication类型。此外，对于内置身份验证类型，也会指示
Password status。
gcloud
使用 gcloud sql users list 命令列出此实例的用户：
gcloud sql users list \ --instance=INSTANCE_NAME
该命令会为每个用户返回 Name、Host 和身份验证 Type。
此外，对于内置身份验证类型，还会返回密码政策设置和状态。例如：
NAME HOST TYPE PASSWORD_POLICY
user1 BUILT_IN {'allowedFailedAttempts': 2,
'enableFailedAttemptsCheck': True,
'passwordExpirationDuration': '7d',
'status': {
'locked': True,
'passwordExpirationTime': '2022-07-01T19:53:45.822742904Z'
}
}
REST v1
如需列出为实例定义的用户，请使用 GET 请求和 users:list 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
HTTP 方法和网址：
GET https://sqladmin.googleapis.com/v1/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"
]
}
},
{
...
},
{
...
}
]
}
如果设置了用户密码政策，则响应的 items 部分将包含 passwordPolicy 部分。以下代码示例展示了 passwordPolicy 部分。
{
...
"passwordValidationUserPolicy" : {
{
"enableFailedAttemptsCheck" : true,
"allowedFailedAttempts" : 8,
"passwordExpirationDuration" : "7d",
"enablePasswordVerification" : true
}
},
...
}
REST v1beta4
如需列出为实例定义的用户，请使用 GET 请求和 users:list 方法。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
HTTP 方法和网址：
GET https://sqladmin.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"
]
}
},
{
...
},
{
...
}
]
}
如果设置了用户密码政策，则响应的 items 部分将包含 passwordPolicy 部分。以下代码示例展示了 passwordPolicy 部分。
{
...
"passwordValidationUserPolicy" : {
{
"enableFailedAttemptsCheck" : true,
"allowedFailedAttempts" : 8,
"passwordExpirationDuration" : "7d",
"enablePasswordVerification" : true
}
},
...
}
mysql 客户端
如需列出 MySQL 用户，请在 mysql 提示符下使用以下 SELECT 语句：
SELECT user, host FROM mysql.user;
对于仅配置了 root 用户账号的第二代实例，输出类似于下面的示例：
+------+-----------+ | user | host | +------+-----------+ | root | % | +------+-----------+ 1 row in set (0.01 sec)
此示例显示具有 root 用户的实例的用户。此用户可以从任何主机 (%) 连接。密码字段显示密码的哈希值。
更改用户密码
您可以通过以下任一方式更改用户密码。
控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
- 点击要更新的用户对应的“更多操作”菜单 。
- 选择更改密码。
- 指定新密码。
此外，如果您要继续使用旧密码，请选择启用双密码按钮。
- 点击确定。
gcloud
使用 gcloud sql users set-password 命令更改密码。
替换以下内容：
- USER_NAME：用户名。
- HOST：用户的主机名，可以是特定 IP 地址、地址范围或任何主机 (
%)。 - INSTANCE_NAME：实例的名称。
- PASSWORD：密码。它必须符合密码政策的要求（如果已设置）。
（可选）对于 MySQL 8.0，您可以继续允许用户将旧密码与 --retain-password 选项结合使用。如需舍弃旧密码，请使用 --discard-dual-password 选项。
gcloud sql users set-password USER_NAME \ --host=HOST \ --instance=INSTANCE_NAME \ --password=PASSWORD
REST v1
如需更改用户密码，请使用 PUT 请求和 users:update 方法。
以下请求会更新用户账号 user_name'@'% 的密码。 如果您的用户有不同的主机，则必须对调用执行修改，以使用正确的主机。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- user-id：用户的 ID
- password：用户的密码
- dual-password：以下枚举值之一：
DUAL_PASSWORD：用户可以继续使用旧密码。NO_DUAL_PASSWORD：用户无法使用旧密码。NO_MODIFY_DUAL_PASSWORD：双重密码状态保持不变。
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=user-id
请求 JSON 正文：
{
"name": "user-id",
"password": "password",
"retainedPassword" : "dual-password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/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://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
REST v1beta4
如需更改用户密码，请使用 PUT 请求和 users:update 方法。
以下请求会更新用户账号 user_name'@'% 的密码。 如果您的用户有不同的主机，则必须对调用执行修改，以使用正确的主机。
在使用任何请求数据之前，请先进行以下替换：
- project-id：您的项目 ID
- instance-id：所需的实例 ID
- user-id：用户的 ID
- password：用户的密码
- dual-password：以下枚举值之一：
DUAL_PASSWORD：用户可以继续使用旧密码。NO_DUAL_PASSWORD：用户无法使用旧密码。NO_MODIFY_DUAL_PASSWORD：双重密码状态保持不变。
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=user-id
请求 JSON 正文：
{
"name": "user-id",
"password": "password",
"retainedPassword" : "dual-password"
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
mysql 客户端
- 如需更改密码，请在
mysql提示符下使用以下 SET PASSWORD 语句：SET PASSWORD FOR USER_NAME = PASSWORD('auth_string'); - 刷新
mysql.user表以确保更改持续有效：FLUSH TABLES mysql.user;
如果用户由于密码政策设置而被锁定，请更改密码以解锁密码。更改密码时，确保密码遵循密码政策。
移除用户密码政策
您可以移除具有内置身份验证类型的用户的密码政策。
gcloud
如需移除用户密码政策，请使用 gcloud sql users set-password-policy 命令和 --clear-password-policy 参数。
替换以下内容：
- USER_NAME：用户名
- INSTANCE_NAME：实例的名称
- HOST：用户的主机名，可以是特定 IP 地址、地址范围或任何主机 (
%)
gcloud sql users set-password-policy USER_NAME \ --instance=INSTANCE_NAME \ --host=HOST \ --clear-password-policy
REST v1
如需移除用户密码政策，请将 PUT 请求与 users:update 方法结合使用。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：实例 ID
- USER_ID：用户的 ID
- PASSWORD：用户的密码
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID/users?name=USER_ID
请求 JSON 正文：
{
"name": "USER_ID",
"password": "PASSWORD",
"data":
{
"passwordValidationUserPolicy" : {}
}
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
REST v1beta4
如需移除用户密码政策，请将 PUT 请求与 users:update 方法结合使用。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：实例 ID
- USER_ID：用户的 ID
- PASSWORD：用户的密码
HTTP 方法和网址：
PUT https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/users?name=USER_ID
请求 JSON 正文：
{
"name": "USER_ID",
"password": "PASSWORD",
"data":
{
"passwordValidationUserPolicy" : {}
}
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
移除用户
默认用户可以移除用户。
在移除用户之前，您必须先丢弃该用户拥有的所有对象或重新分配其所有权，并撤消相应角色对其他对象授予的任何权限。
控制台
-
在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。
- 如需打开实例的概览页面，请点击实例名称。
- 从 SQL 导航菜单中选择用户。
- 点击要移除的用户对应的“更多操作”图标 。
- 选择移除，然后再次选择移除。
gcloud
使用 gcloud sql users delete 命令移除用户。
替换以下内容：
- USER_NAME：用户名。
- HOST：用户的主机名，可以是特定 IP 地址、地址范围或任何主机 (
%)。 - INSTANCE_NAME：实例的名称。
gcloud sql users delete USER_NAME \ --host=HOST \ --instance=INSTANCE_NAME
REST v1
以下请求使用 users:delete 方法删除指定的用户账号。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：所需的实例 ID
- USERNAME：用户或服务账号的电子邮件地址
HTTP 方法和网址：
DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/users?host=&name=USERNAME
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
以下请求使用 users:delete 方法删除指定的用户账号。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID
- INSTANCE_ID：所需的实例 ID
- USERNAME：用户或服务账号的电子邮件地址
HTTP 方法和网址：
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/users?host=&name=USERNAME
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
mysql 客户端
- 如需删除用户，请在
mysql提示符下使用以下 DROP USER 语句：DROP USER 'USER_NAME'@'HOST_NAME';
- 刷新
mysql.user表以确保更改持续有效：FLUSH TABLES mysql.user;
更新用户属性
如需更新主机或权限等用户属性，您必须使用mysql 客户端。如需了解详情，请参阅 MySQL 文档中的 MySQL 用户账号管理。
后续步骤
- 详细了解 Cloud SQL 如何与用户配合运作。
- 阅读关于用户创建的 MySQL 文档。
- 了解如何连接到实例。