Key Visualizer 액세스

Key Visualizer는 기본적으로 Spanner에서 사용 설정되어 있습니다.

시작하기 전에

Key Visualizer를 보려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

  • spanner.databases.read

세분화된 액세스 제어 사용자는 다음에 대한 액세스 권한을 부여받아야 합니다.

  • spanner_sys_reader 시스템 역할 또는 해당 구성원 역할 중 하나

자세한 내용은 세분화된 액세스 제어 정보 및 세분화된 액세스 제어 시스템 역할을 참조하세요.

Key Visualizer 인터페이스 액세스

Google Cloud console에서 Key Visualizer 도구에 액세스합니다.

Key Visualizer에 액세스하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔의 Spanner 페이지에서 인스턴스를 선택합니다.

  2. 조사할 데이터베이스를 선택합니다.

  3. 탐색 메뉴의 관측 가능성에서 Key Visualizer를 선택합니다.

Key Visualizer 사용 중지

Key Visualizer는 enable_key_visualizer 데이터베이스 옵션으로 제어됩니다. 기본값은 true입니다.

Key Visualizer를 중지하려면 enable_key_visualizer 데이터베이스 옵션 값을 false로 설정합니다. Key Visualizer를 사용 중지하는 DDL 문법은 다음과 같습니다.

ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)

데이터베이스 ID에 문자, 숫자 또는 밑줄 이외의 문자가 포함된 경우에는 ID를 백틱(``)으로 묶어야 합니다.

gcloud 명령어를 사용하거나 UpdateDatabaseDdl gRPC/REST 요청에서 문을 보낼 수 있습니다. 예를 들면 다음과 같습니다.

gcloud spanner databases ddl update database_id --instance=instance_id \
    --ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'

enable_key_visualizer 값을 명시적으로 설정한 후에는 개요 페이지에서 동등한 DDL 표시를 클릭하거나 ddl describe gcloud 명령어를 사용하여 값을 확인할 수 있습니다.

gcloud spanner databases ddl describe `database_id` --instance=instance_id

Key Visualizer 다시 사용 설정

Key Visualizer를 다시 사용 설정하려면 이전 안내에 따라 enable_key_visualizer 데이터베이스 옵션 값을 true로 설정합니다.

데이터베이스에 처음으로 다시 사용 설정하면 Key Visualizer 히트맵은 처음 몇 분 동안에는 비어 있지만 Spanner는 측정항목을 수집합니다.

다음 단계