Claude Data 인증 쿼리 검수: Test·Publish와 배지를 따로 확인하는 법

TL;DR

핵심 3줄 요약

이 글에서 다룰 내용

기능 정의

언제 쓰면 좋은가

이미 승인된 비민감 내부 Data 사본에서 집계 정의 한 가지를 수정한 뒤 조직 재사용 전에 검수할 때 사용합니다. 기존 차트 쿼리 하나를 검수합니다. 새 연결이나 대시보드는 만들지 않습니다.

시작 전 확인

Certified queries와 live sharing은 beta입니다. Team은 Data와 두 beta가 기본 on입니다. Enterprise의 Data 기본 on 예정일은 2026년 11월 20일로 확인일 기준 미래입니다.

Enterprise에서 owner가 이미 설정을 저장한 경우는 예외입니다. 두 beta는 기본 off입니다. 조직에서 이미 허용한 계정만 대상으로 하며 예정일이 지났다는 이유만으로 현재 사용 권한을 가정하지 않습니다.

이 글에서는 컴퓨터 웹의 기존 자기 로그인 세션에서 검토하도록 범위를 정했습니다. 이는 저자의 실습 범위이며 모든 기기의 화면이 같다는 뜻은 아닙니다. 이미 허용된 기능·계정·설정·저장 경로·기존 MCP 읽기 소스와 승인 사본이 없으면 활성화·설치·연결·권한 승격 없이 보류합니다.

가상 별칭은 사본 D-A, 미인증 차트 쿼리 Q-A, 실행자 E-A, 자료팀 승인자 R-A, 현재 설정 확인 담당 A-A입니다. 실제 SQL과 관측값은 이 글에 제시하지 않습니다.

실행 순서

1. 미인증 기준선과 저장 정책을 확인합니다

먼저 기존 승인 기록으로 D-A와 Q-A를 식별하고 읽기 소스의 범위·사용량·비용을 승인받습니다. 대시보드를 여는 것만으로 조회가 일어날 수 있으므로 Test 직전에만 비용을 검토하지 않습니다. 승인된 비민감 기존 사본이 없으면 새 사본 생성이나 공유 확대 없이 보류합니다.

그 뒤 Q-A가 이미 certified라면 이번 미인증 실습을 중단합니다. E-A의 현재 유효 쓰기 권한과 기존 공유·연결·다른 쿼리 상태를 승인 내부 환경에 기록합니다.

A-A는 Organization settings > Artifacts > Templates > Data > Certified queries의 현재 on 상태와 승인된 marketplace·plugin을 확인합니다. Data가 off이면 하위 설정은 숨겨집니다. 이번 작업에서는 설정을 변경하지 않습니다.

Git-backed plugin이면 직접 UI Publish 경로를 중단하고 GitHub pull request review로 관리합니다. 실제 저장 정책 확인 전에는 진행하지 않습니다. 설정을 열람할 관리자 권한이 없는 E-A는 A-A에게 확인을 요청하며 자신의 권한을 올려 화면을 열지 않습니다.

조직 설정 확인에는 Owner·Primary Owner 또는 적절한 관리자 권한이 있는 Enterprise custom role이 필요합니다. 이 담당자의 설정 확인과 R-A의 지표 정의 승인은 서로 다른 판단입니다.

2. 정의·원문·실행 영향을 따로 승인받습니다

R-A는 Q-A 원문, 수정 승인본, 승인 문서를 대조합니다. 지표 정의·기간·timezone·단위·허용 table/column·조인과 중복키·NULL·필터·원자료 검산·금지 출력을 확인하는 항목은 저자 체크리스트이지 제품 자동 검사 항목이 아닙니다.

승인은 쿼리 수정, 허용 읽기 범위, 원격 Test의 사용량·비용, Publish의 조직 재사용 영향을 나눠 받습니다. 담당자가 실제 연결·권한·허용 테이블·쿼리 계획을 확인하지 못하면 보류합니다. SELECT 문법만으로 무부작용이나 무료라고 판단하지 않습니다.

3. 승인된 수정과 지침만 반영합니다

차트의 query를 열어 승인된 집계 정의 한 가지만 수정합니다. 사람이 원문 차이를 대조합니다. Certify query를 on으로 설정하고 instructions는 한 줄에 한 지침으로 입력하는 것이 공식 순서입니다.

기간·단위·미정 조건을 정확히 보존하고 인증 설명에 기밀이 없는지 확인합니다. 편집기의 SQL이 승인본과 달라지면 임의 보정이나 LLM 재작성 대신 정정 계획을 다시 승인받습니다.

승인 기록에는 수정 전 원문 위치, 승인된 수정 범위와 수정 후 원문 위치를 따로 남깁니다. 지침은 한 줄씩 입력하되 승인 문서에 없는 예외나 집계 조건을 보태지 않습니다. 미정인 기간이나 단위를 그럴듯한 값으로 채우지 않습니다.

4. 별도 승인 후 Test를 한 번 실행합니다

공식 순서의 다음 단계는 Test입니다. 다만 공식 문서는 내부 검사 범위를 상세히 규정하지 않으므로 Test를 전체 보안 검사나 정확성·완전성 보증으로 취급하지 않습니다.

이 절차에서는 승인 후 한 번만 실행합니다. 실제 반환 표시·오류·값·단위·범위·필터를 원자료와 따로 대조합니다.

실제 동작을 확인할 수 없으면 중단합니다. 확인하지 못한 항목은 ‘확인 필요’로 남깁니다.

Test를 눌렀다는 기록과 실제 결과를 검산했다는 기록은 분리합니다. 어떤 표시가 나왔는지, 무엇을 원자료와 대조했는지와 확인 시각을 사람이 적습니다. 오류가 사라져도 승인된 정의와 결과가 맞는지 확인하지 못했다면 다음 단계로 가지 않습니다.

5. 시험한 원문과 게시 대상을 맞춥니다

실제로 시험한 SQL·instructions가 게시할 원문과 같은지 확인하고 조직 재사용 승인을 재확인합니다. Test 이후 어느 하나라도 바뀌었다면 이전 Test를 근거로 Publish하지 않고 새 검토·승인을 받습니다.

게시 승인자는 최종 SQL과 지침의 내부 보존 위치를 확인하고 조직 재사용 범위를 승인합니다. Test 직후 다른 편집이 발견되면 그 상태를 기준으로 재검토합니다. 이 합의는 제품이 자동으로 편집을 잠그거나 두 사람의 승인을 강제한다는 설명이 아닙니다.

Publish 후에는 검사가 끝난 다음 certified 상태를 확인합니다. 이 Publish는 쿼리 인증 게시이며 Share 공개 링크 생성과 같지 않습니다. 완료 시간이나 구체적인 성공 문구는 가정하지 않습니다.

6. 인증 상태와 차트 배지를 따로 검수합니다

해당 숫자를 클릭하거나 data sidebar를 열어 쿼리·표시값·last refreshed·배지를 승인 원문과 대조합니다. Data의 차트 쿼리는 연결 소스에서 실행되므로 로컬 자료만 확인했다고 생각하지 않습니다.

내부 기록은 정의 일치, Test 원문 일치, query certified 상태, 차트 배지, 정확성 검산, 기존 범위 불변을 별도 행에 적습니다. 기존 공유·Live sharing·연결·다른 쿼리·설정이 그대로인지 확인합니다. 하나라도 불일치하면 완료가 아닌 보류입니다.

기록의 상태는 확인 완료·상충·확인 필요로 구분합니다. 쿼리는 certified로 보이지만 해당 차트의 배지를 확인하지 못했다면 두 행을 모두 완료로 묶지 않습니다. 자료팀 승인자는 검산 근거와 남은 미확인 항목을 읽고 마지막 판정을 내립니다.

복사해서 쓰는 프롬프트

필요하면 아래 프롬프트로 빈 내부 검수 양식을 만듭니다. 실제 자료를 AI에 보내지 않습니다. 출력은 사람이 승인된 내부 환경에서 작성합니다.

실전 인사이트

주의할 점

자주 묻는 질문

출처

마무리

완료 지점은 검수한 Q-A의 인증 상태와 해당 차트 배지를 내부 기록으로 확인한 상태입니다. 외부 배포 허가나 조직 전체의 검수 완료로 넓히지 않습니다. 제공 조건을 확인하지 못한 기기·언어·지역은 현재 계정 화면과 조직 정책에서 따로 확인합니다.

한 줄 요약: 승인 원문, Test, Publish 후 인증 상태, 차트 배지를 따로 확인하고 불일치는 보류합니다.