이 페이지는 Cloud Translation API를 통해 번역되었습니다.

쿼리 통계를 사용하여 쿼리 성능 향상

MySQL | PostgreSQL | SQL Server

이 페이지에서는 쿼리 통계 대시보드를 사용하여 성능 문제를 감지하고 분석하는 방법을 설명합니다.

소개

쿼리 통계는 Cloud SQL 데이터베이스의 쿼리 성능 문제를 감지하고 진단하고 방지하는 데 도움이 됩니다. 직관적인 모니터링을 지원하고 성능 문제를 감지하는 것뿐만 아니라 근본 원인까지 파악하는 데 도움을 주는 진단 정보를 제공합니다.

쿼리 통계는 다음 단계에 대한 안내를 통해 Cloud SQL 쿼리 성능을 향상시킬 수 있게 해줍니다.

Cloud SQL Enterprise Plus 버전의 통계 쿼리

Cloud SQL Enterprise Plus 버전을 사용하는 경우 쿼리 통계의 추가 기능에 액세스하여 고급 쿼리 성능 진단을 실행할 수 있습니다. 쿼리 통계 대시보드의 표준 기능 외에도 Cloud SQL Enterprise Plus 버전의 쿼리 통계를 사용하면 다음 작업을 할 수 있습니다.

최대 20KB의 긴 쿼리 텍스트 캡처
측정항목의 30일 보관 기간을 더 길게 유지
색인 자문으로 색인 추천 받기
활성 쿼리에서 세션 종료

다음 표에서는 Cloud SQL Enterprise 버전의 쿼리 통계 기능 요구사항 및 기능을 Cloud SQL Enterprise Plus 버전의 쿼리 통계와 비교합니다.

비교 영역	Cloud SQL Enterprise 버전의 쿼리 통계	Cloud SQL Enterprise Plus 버전의 통계 쿼리
지원되는 데이터베이스 버전	다음 인스턴스의 모든 버전: SQL Server Web SQL Server Standard SQL Server Enterprise SQL Server Express 버전 인스턴스에서는 쿼리 통계가 지원되지 않습니다.	SQL Server Enterprise 버전 2019 또는 2022
지원되는 머신 유형	모든 머신 유형에서 지원됨	공유 코어 머신 유형을 사용하는 인스턴스에서는 지원되지 않습니다.
지원되는 리전	Cloud SQL 지역 위치	Cloud SQL Enterprise Plus 버전 지역 위치
측정항목 보관 기간	7일	30일
최대 쿼리 길이 제한	4,500바이트	20KB
색인 자문 담당자 추천	해당 사항 없음	사용 가능
활성 쿼리에서 세션 종료	해당 사항 없음	사용 가능

Cloud SQL Enterprise Plus 버전 인스턴스의 미리보기 중에 Cloud SQL Enterprise Plus 버전의 쿼리 통계를 사용 설정하려면 Cloud SQL Enterprise Plus 버전의 쿼리 통계 사용 설정의 단계를 따르세요.

가격 책정

쿼리 통계는 추가 비용 없이 사용할 수 있습니다. 또한 미리보기 중인 Cloud SQL Enterprise Plus 버전의 쿼리 통계를 사용 설정하는 데는 비용이 들지 않습니다.

스토리지 요구사항

쿼리 통계는 인스턴스에 측정항목 데이터를 저장하며 스토리지 자동 증가 설정을 사용 설정 상태로 유지해야 합니다. 해당하는 스토리지 요금이 적용됩니다.

시작하기 전에

쿼리 통계를 사용하기 전에 다음을 실행합니다.

필수 역할 및 권한 추가
스토리지 자동 증가 사용 설정이 인스턴스에 사용 설정되어 있는지 확인합니다.

필수 역할 및 권한

쿼리 통계를 사용하려면 역할에 필요한 Identity and Access Management 권한을 부여하거나 사용자 계정에 필요한 권한을 제공해야 합니다.

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

쿼리 통계 대시보드에서 이전 쿼리 실행 데이터에 액세스하는 데 필요한 권한을 얻으려면 관리자에게 Cloud SQL 인스턴스를 호스팅하는 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

데이터베이스 통계 모니터링 뷰어 (roles/databaseinsights.monitoringViewer)
Cloud SQL 뷰어 (roles/cloudsql.viewer)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 쿼리 통계 대시보드의 이전 쿼리 실행 데이터에 액세스하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

쿼리 통계 대시보드에서 이전 쿼리 실행 데이터에 액세스하려면 다음 권한이 필요합니다.

databaseinsights.aggregatedStats.query
databaseinsights.timeSeries.query

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

예를 들어 Database Insights에서 관리자에게 Database Insights 뷰어 (roles/databaseinsights.viewer) 사전 정의된 역할을 부여해 달라고 요청할 수 있습니다. 그런 다음 Cloud SQL에서 관리자에게 다음 사전 정의된 역할 중 하나를 부여해 달라고 요청할 수 있습니다.

Cloud SQL 편집기 (roles/cloudsql.editor)
Cloud SQL 관리자(roles/cloudsql.admin)

저장용량 자동 증가 사용 설정

스토리지 자동 증가를 사용 설정하는 인스턴스 설정이 사용 설정된 상태로 유지되는지 확인합니다.

이전에 이 인스턴스 설정을 사용 중지한 경우 쿼리 통계를 사용 설정하기 전에 스토리지 자동 증가를 다시 사용 설정하세요.

쿼리 통계 사용 설정

Cloud SQL 대시보드에 대한 액세스 권한이 있는 사용자는 쿼리 통계 측정항목에 액세스할 수 있습니다. 인스턴스를 업데이트할 권한이 있으면 쿼리 통계를 사용 설정할 수 있습니다. Cloud SQL 인스턴스에 필요한 권한 목록은 Cloud SQL 프로젝트 액세스 제어를 참고하세요. 이러한 권한이 없는데 인스턴스에 쿼리 통계를 사용 설정하려면 관리자에게 문의하세요.

콘솔

인스턴스에 쿼리 통계 사용 설정

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
구성 타일에서 구성 수정을 클릭합니다.
인스턴스 맞춤설정 섹션에서 쿼리 통계를 펼칩니다.
쿼리 통계 사용 설정 체크박스를 선택합니다.
선택사항입니다. 다음 쿼리 통계 추가 기능 중 하나 이상을 선택합니다.

쿼리 길이 맞춤설정

기본값: 1024

쿼리 길이 제한을 256~4500바이트의 지정된 값으로 설정합니다. 쿼리 길이가 길수록 분석 쿼리에 더 유용하지만 더 많은 메모리가 필요합니다. 쿼리 길이를 변경하려면 인스턴스를 다시 시작해야 합니다.

저장을 클릭합니다.

여러 인스턴스에 쿼리 통계 사용 설정

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
행에서 작업 더보기 메뉴를 클릭합니다.
쿼리 통계 사용 설정을 선택합니다.
대화상자에서 여러 인스턴스에 쿼리 통계 사용 설정 체크박스를 선택합니다.
사용 설정을 클릭합니다.
이후 대화상자에서 쿼리 통계를 사용 설정할 인스턴스를 선택합니다.
쿼리 통계 사용 설정을 클릭합니다.
참고: 이 단계에서는 기본 구성을 기반으로 인스턴스에 쿼리 통계를 사용 설정합니다.

gcloud

gcloud를 사용하여 Cloud SQL 인스턴스에 쿼리 통계를 사용 설정하려면 INSTANCE_ID를 인스턴스의 ID로 바꾼 후 다음과 같이 --insights-config-query-insights-enabled 플래그와 함께 gcloud sql instances patch를 실행합니다.

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled

또한 다음 선택적인 플래그를 하나 이상 사용합니다.

--insights-config-query-string-length

기본 쿼리 길이 제한을 256~4500바이트의 지정된 값으로 설정합니다. 기본 쿼리 길이는 1024바이트입니다. 쿼리 길이가 길수록 분석 쿼리에 더 유용하지만 더 많은 메모리가 필요합니다. 쿼리 길이를 변경하려면 인스턴스를 다시 시작해야 합니다.

다음을 바꿉니다.

INSIGHTS_CONFIG_QUERY_STRING_LENGTH: 저장할 쿼리 문자열 길이(바이트)입니다.
API_TIER_STRING: 인스턴스에 사용할 커스텀 인스턴스 구성입니다.
REGION: 인스턴스의 리전입니다.

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--tier=API_TIER_STRING \
--region=REGION

REST v1

REST API를 사용해서 Cloud SQL 인스턴스에 대해 쿼리 통계를 사용 설정하려면 insightsConfig 설정을 사용해서 instances.patch 메서드를 호출합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : true } }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

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

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Terraform

Terraform을 사용하여 Cloud SQL 인스턴스에 대한 쿼리 통계를 사용 설정하려면 query_insights_enabled 플래그를 true로 설정합니다.

또한 다음과 같은 선택적인 플래그를 하나 이상 사용할 수 있습니다.

query_string_length: 기본값은 1024이며 바이트 단위로 256~4500 사이의 값으로 구성할 수 있습니다.
record_application_tags: 쿼리에서 애플리케이션 태그를 기록하려면 값을 true로 설정합니다.
record_client_address: 클라이언트 IP 주소를 기록하려면 값을 true로 설정합니다.
query_plans_per_minute: 기본값은 5이며 5~20 사이의 값으로 구성할 수 있습니다.

예를 들면 다음과 같습니다.

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 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

쿼리 완료 후 수분 내에 쿼리 통계에서 측정항목을 사용할 수 있습니다.

Cloud SQL Enterprise Plus 버전에서 쿼리 통계 사용 설정

Google Cloud 콘솔을 사용하여야만 Cloud SQL 인스턴스에서 Cloud SQL Enterprise Plus 버전의 쿼리 통계를 사용 설정할 수 있습니다.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
수정을 클릭합니다.
저장용량 섹션에서 스토리지 용량 자동 증가 사용 설정 체크박스가 선택되어 있는지 확인합니다.
인스턴스 맞춤설정 섹션에서 쿼리 통계를 펼칩니다.
Enterprise Plus 기능 사용 설정 체크박스를 선택합니다.
Cloud SQL Enterprise Plus 버전에 쿼리 통계를 사용 설정한 후 다음 필드를 업데이트할 수 있습니다.
- 쿼리 길이 맞춤설정: 쿼리 길이의 제한을 바이트 단위로 지정합니다. 256에서 20480 사이의 숫자를 지정할 수 있습니다. 지정된 한도를 초과하는 쿼리 문자열은 표시에서 잘립니다. 쿼리 길이 제한이 높을수록 메모리가 더 많이 필요합니다. 기본값은 10240바이트 (10KB)입니다.
저장을 클릭합니다.

쿼리 통계 대시보드 보기

쿼리 통계 대시보드에는 선택한 요소를 기반으로 쿼리 부하가 표시됩니다. 쿼리 부하는 선택한 기간 내의 인스턴스에 있는 모든 쿼리의 전체 작업을 측정한 것입니다. 대시보드는 쿼리 부하를 볼 수 있는 일련의 필터를 제공합니다.

쿼리 통계 대시보드를 열려면 다음 단계를 수행합니다.

인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
왼쪽 탐색 패널에서 쿼리 통계 탭을 선택하거나 쿼리 통계로 이동하여 쿼리 및 성능에 대한 자세한 정보 보기 링크를 클릭합니다.

쿼리 통계 대시보드가 열립니다. 인스턴스에 대한 다음 정보가 표시됩니다.

데이터베이스에 대한 드롭다운 메뉴가 있는 쿼리 통계 대시보드를 보여줍니다. 드롭다운 메뉴 오른쪽에 시간 범위를 설정하는 필터가 있습니다.

데이터베이스: 특정 데이터베이스 또는 모든 데이터베이스의 쿼리 부하를 필터링합니다.
시간 범위: 1시간, 6시간, 1일, 7일, 30일 또는 커스텀 범위와 같은 시간 범위별로 쿼리 부하를 필터링합니다.
데이터베이스 부하 그래프: 필터링된 데이터를 기반으로 쿼리 부하 그래프를 표시합니다.
쿼리 및 데이터베이스: 선택한 쿼리 또는 선택한 데이터베이스에 따라 쿼리 부하를 필터링합니다. 데이터베이스 부하 필터링을 참고하세요.

모든 쿼리의 데이터베이스 부하를 확인합니다.

데이터베이스 쿼리 부하는 선택한 데이터베이스에서 실행된 쿼리가 시간에 따라 수행되는 작업 (CPU 초)을 측정합니다. 실행 중인 각 쿼리는 CPU 리소스, IO 리소스 또는 잠금 리소스를 사용하거나 대기합니다. 데이터베이스 쿼리 부하는 지정된 기간에 완료된 모든 쿼리에 걸린 시간과 실제로 경과한 시간의 비율입니다.

최상위 수준 쿼리 통계 대시보드에 실행 시간별 데이터베이스 부하 그래프가 표시됩니다. 대시보드의 드롭다운 메뉴를 사용하면 모든 데이터베이스 또는 특정 데이터베이스에 대한 그래프를 필터링할 수 있습니다.

그래프의 색상이 지정된 선은 실행 시간별 데이터베이스 부하를 보여줍니다. 그래프를 검토하고 필터링 옵션을 사용하여 다음 질문에 답하세요.

쿼리 부하가 높은가요? 시간이 지남에 따라 그래프가 급증하거나 상승했나요? 높은 부하가 없으면 쿼리에 문제가 없는 것입니다.
부하는 얼마 동안 높은 상태였나요? 지금만 높은가요? 아니면 오랜 시간 동안 높았나요? 범위 선택기를 사용하여 여러 기간을 선택해서 문제가 지속된 기간을 확인합니다. 쿼리 부하 급증이 관측된 기간을 확인하려면 화면을 확대합니다. 타임라인을 최대 1주까지 표시하려면 화면을 축소합니다.
어떤 데이터베이스에서 부하가 발생하나요? 데이터베이스 드롭다운 메뉴에서 다른 데이터베이스를 선택하여 부하가 가장 높은 데이터베이스를 찾습니다.

데이터베이스 부하 필터링

쿼리별로 데이터베이스 부하를 필터링할 수 있습니다. Cloud SQL Enterprise Plus 버전에서 쿼리 통계를 사용하는 경우 데이터베이스 부하 차트를 맞춤설정하여 다음 측정기준 중 하나를 사용하여 표시된 데이터를 분류할 수 있습니다.

모든 쿼리
데이터베이스

데이터베이스 로드 차트를 맞춤설정하려면 실행 시간별 데이터베이스 로드 드롭다운에서 측정기준을 선택합니다.

데이터베이스 부하에 가장 큰 영향을 미치는 요소 보기

데이터베이스 부하에 가장 많이 기여하는 요소를 보려면 데이터베이스 부하별 상위 측정기준 표를 사용하세요. 데이터베이스 부하별 상위 크기 표에는 실행 시간별 데이터베이스 부하 차트 드롭다운에서 선택한 기간 및 측정기준에 대해 가장 큰 기여도를 보인 항목이 표시됩니다. 기간 또는 측정기준을 수정하여 다른 측정기준 또는 기간의 주요 기여자를 확인할 수 있습니다.

데이터 부하별 상위 크기 표에서 다음 탭을 선택할 수 있습니다.

Tab	설명
검색어	테이블에는 총 실행 시간별로 정규화된 상위 쿼리가 표시됩니다. 각 쿼리에 대해 열에 표시되는 데이터는 다음과 같이 표시됩니다. 평균 실행 시간 (밀리초): 쿼리가 실행되는 평균 시간입니다. 총 실행 시간 (밀리초): 특정 쿼리에 소요된 총 실행 시간입니다. 반환된 행 평균: 쿼리로 가져온 평균 행 수입니다. 호출된 횟수: 애플리케이션에서 쿼리를 호출한 횟수입니다.
데이터베이스	이 표에는 선택한 기간 동안 실행된 모든 쿼리에서 부하에 기여한 상위 데이터베이스의 목록이 표시됩니다. 데이터베이스에서 소비한 평균 시간 (밀리초): 쿼리가 특정 데이터베이스에서 소비한 평균 시간입니다. 데이터베이스에 소비된 총 시간 (밀리초): 쿼리가 특정 데이터베이스에 소비한 총 실행 시간입니다.

Tab

설명

검색어

테이블에는 총 실행 시간별로 정규화된 상위 쿼리가 표시됩니다. 각 쿼리에 대해 열에 표시되는 데이터는 다음과 같이 표시됩니다.

평균 실행 시간 (밀리초): 쿼리가 실행되는 평균 시간입니다.
총 실행 시간 (밀리초): 특정 쿼리에 소요된 총 실행 시간입니다.
반환된 행 평균: 쿼리로 가져온 평균 행 수입니다.
호출된 횟수: 애플리케이션에서 쿼리를 호출한 횟수입니다.

데이터베이스

이 표에는 선택한 기간 동안 실행된 모든 쿼리에서 부하에 기여한 상위 데이터베이스의 목록이 표시됩니다.

데이터베이스에서 소비한 평균 시간 (밀리초): 쿼리가 특정 데이터베이스에서 소비한 평균 시간입니다.
데이터베이스에 소비된 총 시간 (밀리초): 쿼리가 특정 데이터베이스에 소비한 총 실행 시간입니다.

쿼리로 필터링

쿼리 테이블에는 쿼리 부하가 가장 많이 발생하는 쿼리의 개요가 제공됩니다. 테이블은 쿼리 통계 대시보드에서 선택한 기간 및 옵션에 대한 정규화된 모든 쿼리를 보여줍니다. 이 테이블은 선택한 기간의 총 실행 시간을 기준으로 쿼리를 정렬합니다.

표를 정렬하려면 열 제목을 선택합니다. 표에는 다음 속성이 표시됩니다.

쿼리: 정규화된 쿼리 문자열입니다. 기본적으로 쿼리 통계에는 쿼리 문자열에 1, 024자까지만 표시됩니다.
데이터베이스: 쿼리가 실행된 데이터베이스입니다.
평균 실행 시간(밀리초): 쿼리가 실행되는 평균 시간입니다.
총 실행 시간 (밀리초): 쿼리가 실행되는 총 시간입니다.
호출된 횟수: 애플리케이션이 쿼리를 호출한 횟수입니다.
반환된 행 평균: 쿼리로 반환된 평균 행 수입니다.

쿼리 통계는 정규화된 쿼리만 저장하고 표시합니다.

쿼리 통계 사용 중지

콘솔

Google Cloud 콘솔을 사용하여 Cloud SQL 인스턴스에 대해 쿼리 통계를 사용 중지하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
구성 타일에서 구성 수정을 클릭합니다.
구성 옵션 섹션에서 쿼리 통계를 펼칩니다.
쿼리 통계 사용 설정 체크박스를 선택 취소합니다.
저장을 클릭합니다.

gcloud

gcloud를 사용하여 Cloud SQL 인스턴스의 쿼리 통계를 사용 중지하려면 INSTANCE_ID을 인스턴스 ID로 바꾼 후 다음과 같이 --no-insights-config-query-insights-enabled 플래그와 함께 gcloud sql instances patch를 실행합니다.

gcloud sql instances patch INSTANCE_ID 

--no-insights-config-query-insights-enabled

REST

REST API를 사용하여 Cloud SQL 인스턴스에 대해 쿼리 통계를 사용 중지하려면 다음과 같이 queryInsightsEnabled를 false로 설정하여 instances.patch 메서드를 호출합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

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

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Cloud SQL Enterprise Plus 버전에서 쿼리 통계 사용 중지

Cloud SQL Enterprise Plus 버전에서 쿼리 통계를 사용 중지하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
수정을 클릭합니다.
인스턴스 맞춤설정 섹션에서 쿼리 통계를 펼칩니다.
Enterprise Plus 기능 사용 설정 체크박스를 선택 해제합니다.
저장을 클릭합니다.

다음 단계

출시 블로그: 개발자를 위한 데이터베이스 관측: Cloud SQL Insights 소개
블로그: Cloud SQL Insights로 쿼리 성능 문제 해결 기술 향상
동영상: Cloud SQL Insights 소개
팟캐스트: Cloud SQL Insights‏
Insights Codelab