DynoTable

테이블 통계

열려 있는 모든 테이블에는 탭 도구 모음에 Stats 버튼 — 막대 차트 아이콘 — 이 있으며, 비주얼 모드와 PartiQL 모드 모두에서 사용할 수 있습니다. 이 버튼은 테이블별 패널을 열어 테이블의 구조를 한눈에 보여 주고, 자동 완성이 여러분의 필드를 알 수 있도록 테이블을 인덱싱하게 해 주며, 추론된 schema를 TypeScript, Zod, JSON Schema로 내보냅니다.

테이블 통계 패널: 키와 인덱스, 크기 추정치, 인덱싱 상태, 인덱싱된 필드 목록.
테이블 통계 패널: 키와 인덱스, 크기 추정치, 인덱싱 상태, 인덱싱된 필드 목록.

개요

패널 상단은 테이블의 구조를 펼쳐 보여 줍니다.

  • 기본 키 — 파티션 키, 그리고 테이블에 정렬 키가 있다면 정렬 키.
  • 보조 인덱스 — 각 글로벌 또는 로컬 보조 인덱스와 그 키. 인덱스가 많은 테이블도 화면이 늘어지지 않습니다 — 목록이 제자리에서 스크롤됩니다.
  • Items · Size · Avg item — DynamoDB 자체의 추정치입니다. 약 6시간마다 갱신되므로 정확한 수치가 아니라 대략적인 값으로 받아들이세요. 주의 사항은 DynamoDB estimate에 마우스를 올리면 볼 수 있습니다.

테이블 인덱싱하기

인덱싱된 필드가 없으면 Workbench와 PartiQL 쿼리 편집기는 필드나 값 제안을 보여 주지 않습니다. 키워드, 함수, 연산자 자동 완성은 계속 동작합니다.

인덱스는 다음에 데이터를 제공합니다.

  • 쿼리 편집기: Workbench와 PartiQL의 필드·값 제안, 그리고 Workbench의 알 수 없는 컬럼 검사.
  • 항목 편집기: 인덱싱된 데이터가 키가 아닌 모든 필드 이름 제안과 모든 값 제안을 제공합니다. PK, SK, GSI, LSI 키 이름은 테이블 정의에서 오므로 인덱스가 필요 없습니다.
  • 비주얼 테이블 도구: 컬럼 선택기, 비주얼 쿼리 및 스캔 필터, Smart Table 노드, 관계 속성 선택기.
  • AI: 활성 테이블에 대한 @column 제안, schema 도구, 두 쿼리 편집기의 고스트 텍스트와 인라인 편집을 위한 schema 힌트, 조인된 Smart Table 컬럼의 정규화.
  • 통계와 공유: Indexed fields 목록, 추론된 schema 내보내기, 인덱스를 Team Workspace에 게시하기.

인덱스 기반 자동 완성과 AI 고스트 텍스트는 별개입니다. Workbench와 PartiQL의 인덱스 제안에는 제한이 없고, AI 고스트 텍스트는 기본적으로 꺼져 있으며 활성 라이선스가 필요합니다.

항목 편집기에서 DynamoDB JSON 모드는 인덱싱된 값 자동 완성을 억제합니다. 필드 이름 자동 완성은 그곳에서도 계속 동작합니다.

인덱스가 생기거나 커지는 경로는 다섯 가지입니다.

  1. 수동 스캔: Index table은 기본적으로 최대 10,000개 항목을 스캔합니다. Reindex는 현재 인덱스를 먼저 지운 뒤 같은 상한까지 스캔합니다. 폭이 넓거나 롱테일이 긴 테이블에서는 상한을 넘어서야 처음 나타나는 속성이 계속 빠져 있게 됩니다.
  2. 가져온 페이지: 테이블 페이지를 가져올 때 DynoTable이 인덱스를 지우지 않고 그 항목들을 인덱스에 추가합니다.
  3. Smart Tables: 처음 가져온 페이지가 인덱스를 부트스트랩합니다.
  4. Team Workspace: 동료가 게시한 인덱스를 로컬 스캔 없이 가져올 수 있습니다. 가져오기가 무엇을 대체하는지는 Team Workspace를 참고하세요.
  5. AI 부트스트랩: schema를 찾지 못하면 AI가 답하기 전에 약 100개 항목으로 최선을 다한 인덱스를 만듭니다. 기존 인덱스에 더하는 방식입니다.

수동 스캔은 진행 상황을 실시간으로 보여 주며 DynamoDB 읽기를 사용합니다. 인덱싱이 끝나면 Indexed fields가 발견된 속성을 나열하며, commonData.status 같은 점으로 이어진 중첩 경로도 포함합니다.

각 필드는 관찰된 타입과, 샘플링한 항목 전반에서 필수였는지 선택이었는지를 보여 줍니다. 필드가 몇 개를 넘어가면 필터 상자가 나타나 원하는 필드를 빠르게 찾을 수 있습니다. Clear index는 로컬 인덱스를 제거합니다.

schema 내보내기

인덱싱된 테이블에서 Export를 열고 형식을 고르면 항목을 타입이 있는 schema로 바꿀 수 있습니다.

  • TypeScript — interface.
  • Zod — z.object(...) schema(Standard-Schema 호환).
  • JSON Schema — draft 2020-12.

클립보드에 복사하거나 파일로 저장하세요. 모든 내보내기는 샘플링한 항목에서 추론되었다는 안내로 시작합니다 — 훌륭한 출발점이지만 권위 있는 계약은 아닙니다. 선택 여부는 인덱싱 중 각 속성이 얼마나 자주 나타났는지를 반영하며, 기본 키 속성은 항상 필수로 표시됩니다.

이것은 데이터의 구조 에 대한 schema로, 데이터 자체를 내보내는 Export와는 다릅니다.

업데이트됨