Cloud SQL 错误消息

检查是否存在以下情况：

• 应用在退出前未调用 mysql_close()。
• 通信错误。
• 应用可能处于休眠状态的时间超过了在“wait_timeout”或“interactive_timeout”中指定的秒数，未向服务器发出任何请求。请参阅第 5.1.7 节：服务器系统变量。
• 应用在数据传输过程中突然终止。
• max_allowed_packet 变量值可能太小，或者查询需要的内存多于为 mysqld 分配的内存。这可以通过将 max_allowed_packet 标志增加到更大的数字来解决。

更新外部数据库中的定义器，例如从 root@localhost 更新为 root@% 或非超级用户。如需了解详情，请参阅存储对象访问权限控制。

• 用户名（或密码）不正确。
• 用户正在通过 @XXX 以外的网址进行连接。
• 用户对他们尝试连接到的数据库没有正确的权限。

请尝试以下操作 ...

• 验证用户名和相应的密码。
• 检查连接的来源，查看它与用户具有访问权限的网址是否匹配。
• 在数据库中检查用户的授予权限。

您需要修改专用连接。使用以下命令，并务必使用 --force 参数：

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

请尝试以下操作：

1. 连接到数据库（例如，使用 Cloud Shell）并以根用户身份登录。
2. 执行 USE mysql;。
3. 使用语法授予以下权限：

   GRANT PERMISSION_1,PERMISSION_2 ON *.* TO 'root' WITH GRANT OPTION;
      

   • 选择
   • INSERT
   • 更新
   • 删除
   • 创建
   • DROP
   • 重新加载
   • SHUTDOWN
   • PROCESS
   • REFERENCES
   • INDEX
   • ALTER
   • SHOW DATABASES
   • CREATE TEMPORARY TABLES
   • LOCK TABLES
   • EXECUTE
   • REPLICATION SLAVE
   • REPLICATION CLIENT
   • CREATE VIEW
   • SHOW VIEW
   • CREATE ROUTINE
   • ALTER ROUTINE
   • CREATE USER
   • 活动
   • TRIGGER
   • CREATE TABLESPACE
4. 执行 USE 'Database_Name';，其中 Database_Name 是要在其中创建视图的数据库。
5. 在该会话中执行所有创建视图并提交。

对于 Illegal Argument，请检查请求以确保每个参数都允许使用，并且参数的每个值都是有效的。对于其他所有原因，请检查日志文件，查看是否有更多信息。

您需要修改专用连接。使用以下命令，并务必使用 --force 参数：

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

如果您正尝试执行导出，但 Cloud Storage 在特定时间范围内未收到任何数据，则连接会重置。

请尝试使用 pg_dump 执行手动导出操作。

如果可以，请移除 Cloud SQL 实例中的所有 Authorized Networks 条目。否则，请创建副本（不包含 Authorized Networks 条目）。

使用 sp_helpdb 命令获取有关数据库的信息。

请考虑以下解决方案：

• 手动扩展磁盘可用空间或减少数据库中的数据。
• 确保已为数据库实例启用 Automatic storage increase。
• 添加更多文件组，并将数据移入其中。
• 确保增长不会受到限制。使用 ALTER DATABASE 命令启用自动增长（如果尚未启用），并增大文件大小。
• 管理 tempdb 文件。使用 DBCC OPENTRAN 和 DBCC SQLPERF 命令检查可能导致 tempdb 文件或事务日志增大的未结事务。

使用默认用户进行连接，然后更改用户。

对主实例进行修改以将其升级为更大的磁盘。

在分配的 IP 范围中找不到可用块。请为该服务提供商分配新的范围。

分配的 IP 范围中没有更多的可用地址。

请考虑以下可能出现的情况：

• 专用服务连接所分配 IP 地址范围的大小小于 /24。
• 专用服务连接所分配 IP 范围的大小对于 Cloud SQL 实例数量而言太小。
• 如果在多个区域中创建实例，则分配的 IP 地址范围大小要求将更大。请参阅分配的范围大小。

对于上述每种场景，您可以选择展开现有 IP 范围，也可以选择分配其他 IP 范围给专用服务连接。

如果您要分配新的范围，请注意不要创建与任何现有分配重叠的分配。

创建新的 IP 地址范围后，使用以下命令更新 VPC 对等互连：

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK
--project=PROJECT_ID \
--force

如果要扩展现有分配，请注意只能扩大分配范围，不能缩减分配范围。例如，如果原始分配是 10.0.10.0/24，则新分配至少为 10.0.10.0/23。

一般来说，如果从 /24 分配开始，对于每个条件（额外的实例类型组、额外的区域），将“/子网掩码位数”递减 1 是一种较好的做法。例如，如果尝试在同一分配中创建两个实例类型组，则从 /24 递减到 /23 就足够了。

扩展现有 IP 地址范围后，使用以下命令更新 VPC 对等互连：

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force

目前不支持从 Cloud Shell 连接到仅使用专用 IP 地址的实例。

将 mysqldump 与 max_allowed_packet 选项搭配使用。

如需详细了解如何使用 mysqldump 标志进行托管式导入迁移，请参阅允许和默认的初始同步标志

检查确认您的操作系统和文件系统支持此大小的文件。检查确认磁盘未满，或者磁盘配额未用尽。您可以通过 Google Cloud 控制台申请增加配额，也可以对实例进行修改以将其升级为更大的磁盘。

如需修复服务权限，请停用 Service Networking API，等待五分钟，然后重新启用。

在您的项目中启用 Service Networking API。如果您在尝试为 Cloud SQL 实例分配专用 IP 地址时看到此错误并且您使用共享 VPC，则还需要为宿主项目启用 Service Networking API。

找到锁定表的进程并停止该进程。

1. 使用以下命令进行诊断：sql> show processlist;

   列表中的第一项可能是占用锁的项，后面的项正在等待获取该锁。

2. SHOW INNODB STATUS 命令可能也会有用。
3. 运行 KILL <var>PID</var> 命令：

在您的项目中启用 Service Networking API。如果您在尝试为 Cloud SQL 实例分配专用 IP 地址时看到此错误并且您使用共享 VPC，则还需要为宿主项目启用 Service Networking API。

等待上一个操作完成后，再开始另一个操作。

对目标实例进行修改以增加其存储空间大小。

通过 Google Cloud 控制台申请增加配额。

增加 max_connections 标志的值。请参阅配置数据库标志。

验证 GOOGLE_APPLICATION_CREDENTIALS 环境变量中存储的位置包含有效的服务账号密钥 JSON 文件，并且该变量指向正确的位置。

在创建副本时，将 innodb_large_prefix 标志设置为 ON，或使用该标志更新现有副本。

创建新的服务器证书并轮替。

• 用户可能没有所需的所有 Cloud Storage 权限。
• 数据库表可能不存在。

请尝试以下操作 ...

• 检查核实您对存储桶至少拥有 WRITER 权限，并且对导出文件至少拥有 READER 权限。如需详细了解如何在 Cloud Storage 中配置访问权限控制，请参阅创建和管理访问权限控制列表。
• 确保表已存在。如果表已存在，请确认您对存储桶拥有正确的权限。

如果在导出操作期间使用以下语句，则转储事务可能会失败：

• ALTER TABLE
• CREATE TABLE
• DROP TABLE
• RENAME TABLE
• TRUNCATE TABLE

从转储操作中移除所有这些语句。

增加 temp_file_limit 大小。 请参阅配置数据库标志。

[Warning] InnoDB: Load table db.table failed, the table has missing
foreign key indexes. Turn off 'foreign_key_checks' and try again.
[Warning] InnoDB: Cannot open table db/table from the internal data
dictionary of InnoDB though the .frm file for the table exists.
See InnoDB troubleshooting
for more information.
      

数据库重启后，MySQL 需要在首次访问时将表加载到 InnoDB 字典缓存中。如果检测到差异，它将阻止访问该表。

mysql> select * from db.table;
ERROR 1146 (42S02): Table db.table doesn't exist
      

对 MySQL 会话停用 foreign_key_checks 后可重新访问该表。访问表并将其加载到字典缓存中后，在下一次数据库重启之前，InnoDB 不会再检查和处理外键不匹配的问题。

您应修复外键不匹配的问题，以避免出现任何其他问题。

1. 对 mysql 客户端会话停用 foreign_key_checks 并访问该表。

   mysql> SET SESSION FOREIGN_KEY_CHECKS=0;
               

2. 检查父表和子表，并识别外键和引用键列之间的不匹配问题。

   mysql> SHOW CREATE TABLE parent_table;
   mysql> SHOW CREATE TABLE child_table;
               

   验证相应列是否具有类似的数据类型。固定精度类型（例如 INTEGER 和 DECIMAL）的大小和符号应相同。对于非二进制（字符）字符串列，字符集和排序规则必须相同。

3. 使用 ALTER TABLE 语句修复不匹配问题。某些操作可能需要先删除外键限制条件，然后应用更改，之后再重新添加外键。
4. 重新启用 foreign_key_checks。

   mysql> SET SESSION FOREIGN_KEY_CHECKS=1;
               

使用 CSV 格式，并运行多个较小的导出作业，以减小每项操作的规模和长度。

降低 max_connections 标志值，或联系客户服务以请求移除标志，后跟 hard drain。这会强制实例在使用新配置（没有标志或设置）的其他主机上重启。

• 在数据库级层，数据库用户必须存在且其密码一致
• 在项目级层，用户可能没有正确的 IAM 权限，包括 serviceusage.services.use 或 cloudsql.instances.connect 权限。
• 在网络级层，如果 Cloud SQL 实例使用公共 IP，则连接的来源 IP 必须在已获授权的网络中。

请尝试以下操作 ...

• 确保用户存在且其密码一致。
• 将 Service Usage Consumer 角色分配给用户账号： 此角色包含 serviceusage.services.use 权限。
• 如果使用公共 IP，请确保来源 IP 在已获授权的网络中。

如果您转储 MySQL 5.7 数据库中的数据，并将其导入 MySQL 8.0 数据库，请确保使用 MySQL 5.7 中的 mysqldump 二进制文件。如果您使用的是 MySQL 8.0 中的 mysqldump 二进制文件，则需要添加 --column-statistics=0 标志。

在问题获得修复之前，请参阅 GitHub 上的这一讨论，其中包括了解决方法。

• 当您尝试重新使用与最近删除的实例相同的名称时，可能会发生这种情况。
• 还可能是由间歇性连接问题引起的。
• 日志可能显示项目未启用 Service Networking API。
• 尝试并行创建多个实例时也会出现此错误。例如，Terraform 脚本可实现此尝试。
• 另一个原因是特定资源已用尽或已超出配额限制。在日志中查找 Quota 'INTERNAL_FORWARDING_RULES_WITH_TARGET_INSTANCE_PER_NETWORK' exceeded. Limit: 100.0 globally 等条目
• 如因 IP 范围中没有更多可用的地址，子网创建失败，则会发生此错误。

• 实例名称在删除大约一周后才能重新使用。
• 如果是间歇性连接问题，则唯一的补救方法是重试。
• 为项目启用 Service Networking API。
• 并行实例创建脚本仅会成功创建一个实例。对该脚本进行修改，等到每个实例创建操作完成后再继续执行下一步。
• 分配新范围。