Dynamodb

# MFA TOTP가 필요한 경우 (aws-vault이 자동 처리)
aws-vault exec <profile> -- dy <command>

dy CLI 명령어 (읽기 전용만 허용)

# 테이블 목록
dy list

# 테이블 스키마 상세
dy desc -t <table>

# 아이템 조회 (PK + SK)
dy get -t <table> <pk> [<sk>]

# 쿼리 (PK 필수, SK 조건 선택)
dy query -t <table> <pk> [-i <gsi>] [-s <sk_condition>]

# 스캔 (주의: 대량 데이터)
dy scan -t <table> [--limit N]

차단 명령어

put, del, upd, bwrite, admin, bootstrap, import, export, backup, restore — 쓰기/관리 명령은 절대 실행하지 않는다.

dy 서브커맨드별 옵션

공통 옵션

• -t, --table <name> — 테이블명 (필수)
• <pk> — 파티션 키 값 (위치 인자)
• -o, --output <format> — 출력 형식 (json, yaml, raw)

dy get 옵션

• [sk] — 소트 키 값 (위치 인자)
• --consistent-read — 강력한 일관된 읽기
• 주의: -a/--attributes 미지원. 전체 아이템이 반환됨.

dy query 옵션

• -s, --sort-key <expr> — 소트 키 조건 (예: 'begins_with Contract#', '= Member#abc')
• -i, --index <name> — GSI 이름 (예: gsi-1, GSI1)
• -a, --attributes <cols> — 출력할 속성 (쉼표 구분, query 전용)
• --keys-only — PK/SK만 출력
• --filter <expression> — 필터 표현식
• --limit <N> — 결과 수 제한

dy upd 옵션 (쓰기 — 에이전트 직접 실행 차단, 명령어 제시용)

• --set <expr> — 속성 수정/추가 (예: --set 'name = "Alice"')
• --remove <attrs> — 속성 제거 (예: --remove 'Category, Rank')
• --atomic-counter <attr> — 숫자 속성 +1 증가

테이블명 패턴

{service}-{env} (예: classroom-service-dev, writing-service-stag)

쿼리 예시

# 이메일로 계정 조회
aws-vault exec classting-stag -- dy query -t account-service-stag -i gsi-1 'AccountEmail#[email protected]'

# 계정이 속한 조직의 멤버 조회
aws-vault exec classting-stag -- dy query -t organization-service-stag -i gsi-3 'Account#15089337373340913'

# 멤버의 라이센스 조회 (SK begins_with)
aws-vault exec classting-stag -- dy query -t organization-service-stag -i gsi-1 'Member#abc123' -s 'begins_with Contract#'

# 특정 속성만 출력
aws-vault exec classting-stag -- dy query -t organization-service-stag -i gsi-1 'Contract#xyz' -a 'id,orgId,licenses,variants'

스키마 참조

쿼리를 구성하기 전에 반드시 references/schema.yaml을 읽어 키 패턴과 GSI를 확인할 것. 소스코드에서 키 매핑 로직을 추가로 확인해야 할 경우 Glob/Grep/Read 도구를 사용할 수 있다.