이 페이지에는 SQL Server용 Cloud SQL의 알려진 문제와 함께 이러한 문제를 방지하거나 복구하는 방법이 나와 있습니다.
인스턴스 연결 문제
만료된 SSL/TLS 인증서
인스턴스가 SSL을 사용하도록 구성된 경우 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지로 이동하여 인스턴스를 엽니다. 인스턴스의 연결 페이지를 열고 보안 탭을 선택한 후 서버 인증서가 유효한지 확인합니다. 만료된 경우 새 인증서를 추가하고 새 인증서로 순환시켜야 합니다.
해당 프로젝트에 존재하지 않는 인스턴스에 연결하려고 할 경우 해당 인스턴스에 액세스할 수 있는 권한이 없다는 오류 메시지만 표시됩니다.
Cloud SQL 인스턴스를 만들 수 없음
Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID] 오류 메시지가 표시되면 Cloud SQL 인스턴스를 다시 만들어 보세요.
관리 문제
대규모 내보내기 작업은 인스턴스 가용성에 부정적인 영향을 미칠 수 있습니다.
대규모 내보내기를 시작하기 전에 데이터베이스 크기의 25% 이상을 사용할 수 있는지 확인하세요(인스턴스에서). 이렇게 하면 공격적인 자동 증가 문제를 방지할 수 있어서 인스턴스 가용성에 영향을 줄 수 있습니다.
SQL Server 인스턴스에서 SQL Server Express 버전을 사용하는 경우:
새 인스턴스를 만들 때 플래그를 지정하면 인스턴스 생성에 실패합니다.
기존 인스턴스에 데이터베이스 플래그를 설정할 수 없습니다.
장기 실행 Cloud SQL 가져오기 및 내보내기 인스턴스 작업을 취소하거나 중지할 수 없습니다.
Cloud SQL 인스턴스에서 한 번에 작업 하나만 실행할 수 있습니다. 장기 실행 작업을 시작할 때 인스턴스에서 다른 작업을 수행할 필요가 없는지 확인하세요.
가져오기 또는 내보내기 작업과 같은 장기 실행 Cloud SQL 인스턴스 작업을 시작하는 경우 인스턴스를 다시 시작하지 않으면 작업을 취소할 수 없습니다.
BAK 파일에서 가져오기를 취소하면 가져올 데이터베이스가 부분 상태로 유지됩니다. 데이터베이스를 삭제해야 합니다. SQL 파일에서 가져오기를 취소하는 경우 부분 데이터를 수동으로 삭제해야 합니다.
데이터 가져오기 및 내보내기 문제
읽기 전용 데이터베이스 또는 단일 사용자 모드 데이터베이스에 있는 BAK 파일(가져오기용)을 만들지 마세요. 읽기 전용 데이터베이스 또는 단일 사용자 모드 데이터베이스에서 BAK 파일을 만들고 이 파일을 가져오면 오류가 발생할 수 있습니다.
대규모 데이터베이스(예: 데이터가 500GB 이상인 데이터베이스)에서 데이터를 가져오고 내보내려는 경우 가져오기 및 내보내기 작업을 완료하는 데 시간이 오래 걸릴 수 있습니다. 또한 가져오기 또는 내보내기가 진행되는 동안 다른 작업(예: 백업 작업)을 수행할 수 없습니다. 가져오기 및 내보내기 프로세스의 성능을 향상시킬 수 있는 옵션은 gcloud 또는 API를 사용하여 이전 백업을 복원하는 것입니다.
Cloud Storage는 최대 단일 객체 크기를 5TB까지 지원합니다. 데이터베이스가 5TB보다 크면 Cloud Storage로 내보내기 작업이 실패합니다. 이 경우 내보내기 파일을 보다 작은 세그먼트로 분할해야 합니다.
트랜잭션 로그 및 디스크 증가
로그는 매일 한 번씩 영구 삭제되며, 지속적으로 진행되지 않습니다. 로그 보관 일수가 백업 수와 동일하게 구성된 경우 백업 발생 시점에 따라 1일 치의 로깅이 손실될 수 있습니다. 예를 들어 로그 보관을 7일로 설정하고 백업 보관을 7개로 설정하면 6~7일 동안의 로그가 유지됩니다.
백업 수는 로그 보관 일수보다 최소 1일 이상으로 설정해야 로그 보관 기간을 지정된 최소 일수 이상으로 유지할 수 있습니다.
Cloud Monitoring 또는 Cloud Logging 관련 문제
다음 리전 이름의 인스턴스는 특정 컨텍스트에서 다음과 같이 잘못 표시됩니다.
us-central1은 us-central로 표시됩니다.
europe-west1은 europe으로 표시됩니다.
asia-east1은 asia로 표시됩니다.
이 문제는 다음 상황에서 발생합니다.
Cloud Monitoring의 알림
측정항목 탐색기
Cloud Logging
리소스 메타데이터 라벨을 사용하여 Cloud Monitoring의 알림과 측정항목 탐색기의 문제를 완화할 수 있습니다. cloudsql_database 모니터링 리소스 라벨 region 대신 시스템 메타데이터 라벨 region을 사용합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-13(UTC)"],[],[],null,["# Known issues\n\n\u003cbr /\u003e\n\n[MySQL](/sql/docs/mysql/known-issues \"View this page for the MySQL database engine\") \\| [PostgreSQL](/sql/docs/postgres/known-issues \"View this page for the PostgreSQL database engine\") \\| SQL Server\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis page lists known issues with Cloud SQL for SQL Server, along with\nways you can avoid or recover from these issues.\n\n### Instance connection issues\n\n- Expired SSL/TLS certificates\n\n\n If your instance is configured to use SSL, go to the\n [Cloud SQL Instances page](https://console.cloud.google.com/sql/instances)\n in the Google Cloud console and open the instance. Open its **Connections** page, select the\n **Security** tab and make sure that your server certificate is valid. If it has expired, you must\n add a new certificate and rotate to it.\n\n \u003cbr /\u003e\n\n- Cloud SQL Auth Proxy version\n\n If you are connecting using the Cloud SQL Auth Proxy, make sure you are using the\n most recent version. For more information, see\n [Keeping the Cloud SQL Auth Proxy up to date](/sql/docs/sqlserver/sql-proxy#keep-current).\n- Not authorized to connect\n\n If you try to connect to an instance that does not exist in that project,\n the error message only says that you are not authorized to access that\n instance.\n- Can't create a Cloud SQL instance\n\n If you see the `Failed to create subnetwork. Router status is temporarily\n unavailable. Please try again later. Help Token: [token-ID]` error\n message, try to create the Cloud SQL instance again.\n\n### Administrative issues\n\n\u003cbr /\u003e\n\n- A large export operation can adversely affect instance availability\n\n Before starting a large export, ensure that at least 25 percent of the\n database size is free (on the instance). Doing so helps prevent\n issues with aggressive autogrowth, which can affect the availability\n of the instance.\n - If your SQL Server instance uses a SQL Server Express edition:\n\n - If you specify a flag when you create a new instance, then creating the instance fails.\n\n - You can't set database flags on an existing instance.\n\n - Long-running Cloud SQL import and export instance operations can't be cancelled or stopped\n\n Only one operation can run at a time on a Cloud SQL instance. Make sure you\n don't need to perform other operations on an\n instance when you start a long-running operation.\n\n When you start a long-running Cloud SQL instance operation, such as an\n import or export operation, there's no way to cancel the operation without\n [restarting](/sql/docs/sqlserver/start-stop-restart-instance#restart) the instance.\n - If you cancel an import from a BAK file, then the database that you're importing is left in a partial state. You must drop the database. If you cancel an import from a SQL file, then you must clean up partial data manually.\n\n### Issues with importing and exporting data\n\n- Do not create a BAK file (for import) from a read-only database or from a\n database that is in single-user mode. If you create a BAK file from a read-only\n database or from a database that is in single-user mode, and import that file,\n an error may occur.\n\n \u003cbr /\u003e\n\n- If you're trying to import and export data from a large database (for example,\n a database that has 500 GB of data or greater), then the import and export\n operations might take a long time to complete. In addition, other operations\n (for example, the backup operation) aren't available for you to perform\n while the import or export is occurring. A potential option to improve the\n performance of the import and export process is to [restore a previous backup](/sql/docs/sqlserver/backup-recovery/restoring#projectid) using `gcloud`\n or the API.\n\n- Cloud SQL supports bulk insert only on SQL Server 2022.\n\n- Cloud SQL only supports the `RAW` [codepage](https://learn.microsoft.com/en-us/sql/t-sql/statements/bulk-insert-transact-sql?view=sql-server-ver16).\n\n- Cloud SQL doesn't support bulk insert on read replicas.\n\n- Cloud SQL supports bulk insert only for importing data to tables.\n\n\u003c!-- --\u003e\n\n- Cloud Storage supports a [maximum single-object size up five terabytes](/storage-transfer/docs/known-limitations-transfer#object-limit). If you have databases larger than 5TB, the export operation to Cloud Storage fails. In this case, you need to break down your export files into smaller segments.\n\n### Transaction logs and disk growth\n\nLogs are purged once daily, not continuously. When the number of days of log\nretention is configured to be the same as the number of backups, a day of\nlogging might be lost, depending on when the backup occurs. For example, setting\nlog retention to seven days and backup retention to seven backups means that\nbetween six and seven days of logs will be retained.\n\nWe recommend setting the number of backups to at least one more than the days of\nlog retention to guarantee a minimum of specified days of log retention.\n\n### Issues related to Cloud Monitoring or Cloud Logging\n\nInstances with the following region names are displayed incorrectly in certain\ncontexts, as follows:\n\n- `us-central1` is displayed as `us-central`\n- `europe-west1` is displayed as `europe`\n- `asia-east1` is displayed as `asia`\n\nThis issue occurs in the following contexts:\n\n- Alerting in Cloud Monitoring\n- Metrics Explorer\n- Cloud Logging\n\nYou can mitigate the issue for Alerting in Cloud Monitoring, and for Metrics\nExplorer, by using\n[Resource metadata labels](https://cloud.google.com/monitoring/api/v3/metric-model#meta-labels).\nUse the system metadata label `region` instead of the\n[cloudsql_database](https://cloud.google.com/monitoring/api/resources#tag_cloudsql_database)\nmonitored resource label `region`."]]
