Estatísticas da tabela

Toda tabela aberta tem um botão Estatísticas — o ícone de gráfico de barras — na barra de ferramentas da aba, tanto no modo Visual quanto no PartiQL. Ele abre um painel por tabela que mostra a estrutura da tabela num relance, permite indexar a tabela para que o autocompletar conheça seus campos, e exporta um esquema inferido em TypeScript, Zod ou JSON Schema.

O painel Estatísticas da tabela: chaves e índices, estimativas de tamanho, status de indexação e a lista de campos indexados.
O painel Estatísticas da tabela: chaves e índices, estimativas de tamanho, status de indexação e a lista de campos indexados.

Visão geral

O topo do painel apresenta a estrutura da tabela:

  • Chave primária — a chave de partição e a chave de ordenação, se a tabela tiver uma.
  • Índices secundários — cada índice secundário global ou local e suas chaves. Uma tabela com muitos índices continua compacta — a lista rola no próprio lugar.
  • Itens · Tamanho · Item médio — as próprias estimativas do DynamoDB. Elas são atualizadas aproximadamente a cada seis horas, então trate-as como valores aproximados, não como contagens exatas. Passe o cursor sobre estimativa do DynamoDB para ver a ressalva.

Indexing your table

Sem campos indexados, os editores de consulta do Workbench e do PartiQL não mostram nenhuma sugestão de campo ou de valor. O autocompletar de palavras-chave, funções e operadores continua funcionando.

O índice alimenta:

  • Editores de consulta: as sugestões de campos e valores do Workbench e do PartiQL, além da verificação de colunas desconhecidas do Workbench.
  • Editor de itens: os dados indexados fornecem todas as sugestões de nome de campo fora das chaves e todas as sugestões de valor. Os nomes de chave PK, SK, GSI e LSI vêm da definição da tabela e não precisam de índice.
  • Ferramentas visuais de tabela: o seletor de colunas, os filtros visuais de query e de scan, os nós de Smart Table e o seletor de atributo de relacionamento.
  • IA: as sugestões @column para a tabela ativa, as ferramentas de esquema, as dicas de esquema para o ghost text e as edições inline nos dois editores de consulta, e a normalização de colunas joinadas de Smart Table.
  • Estatísticas e compartilhamento: a lista Campos indexados, a exportação do esquema inferido e a publicação de índices no Workspace de Equipe.

O autocompletar movido pelo índice e o ghost text de IA são coisas separadas. As sugestões vindas do índice no Workbench e no PartiQL não têm restrição; o ghost text de IA vem desligado por padrão e exige uma licença ativa.

No editor de itens, o modo DynamoDB JSON suprime o autocompletar de valores indexados. O autocompletar de nomes de campo continua funcionando ali.

Um índice pode surgir ou crescer de cinco maneiras:

  1. Scan manual: Indexar tabela escaneia até 10.000 itens por padrão. Reindexar limpa o índice atual primeiro e depois escaneia até o mesmo limite. Em tabelas largas ou de cauda longa, os atributos vistos pela primeira vez além do limite continuam ausentes.
  2. Páginas buscadas: conforme você busca páginas da tabela, o DynoTable adiciona esses itens ao índice sem limpá-lo.
  3. Smart Tables: a primeira página buscada inicializa o índice.
  4. Workspace de Equipe: o índice publicado por um colega pode ser importado sem nenhum scan local. Veja Workspace de Equipe para o que uma importação substitui.
  5. Inicialização pela IA: diante de um esquema desconhecido, a IA monta um índice de melhor esforço com cerca de 100 itens antes de responder. Ele soma ao índice existente.

O scan manual mostra o progresso ao vivo e consome leituras do DynamoDB. Depois de indexar, Campos indexados lista os atributos encontrados, incluindo caminhos aninhados com ponto, como commonData.status.

Cada campo mostra o tipo observado e se ele era obrigatório ou opcional ao longo dos itens amostrados. Passando de alguns poucos campos, aparece uma caixa de filtro para você encontrar um rapidamente. Limpar índice remove o índice local.

Exportar um esquema

A partir de uma tabela indexada, abra Exportar e escolha um formato para transformar seus itens em um esquema tipado:

  • TypeScript — uma interface.
  • Zod — um esquema z.object(...) (compatível com Standard-Schema).
  • JSON Schema — draft 2020-12.

Copie para a área de transferência ou salve em um arquivo. Toda exportação abre com uma nota informando que foi inferida a partir dos itens amostrados — um ótimo ponto de partida, não um contrato autoritativo. A opcionalidade reflete com que frequência cada atributo apareceu durante a indexação; atributos da chave primária são sempre marcados como obrigatórios.

Este é um esquema da estrutura dos seus dados — distinto de uma Exportação dos dados em si.

Atualizado