01 - OBJETIVO (solução proposta)

Adicionar texto orientativo na tela de criação de índices do BigQuery, informando as restrições para criação de Vector Index.

02 - DESCRIÇÃO DAS TELAS

CAROL:

Tela: Data Model advanced options > BigQuery > Indexes (criação/edição)

Componente a ser adicionado:

• Banner de alerta (attention) posicionado abaixo do título "BigQuery"

• Ícone de fechar (X) no canto direito do banner

Texto do banner:

BigQuery vector index requirements

• To create a vector index, the table must have at least 5,000 rows.

• If the table is under 10 MB, you can still create the index—but it will

start indexing only after the table reaches 10 MB.

For additional information, consult the documentation [link para documentação]

PLATAFORMA IDEIA:

Tela: Nova Entidade > Criação de índices (step 5) — PostgreSQL

Componente a ser adicionado:

• Banner de alerta (attention) posicionado acima da área "Configuração do índice"

• Exibido condicionalmente conforme o tipo de índice selecionado (IVFFLAT ou HNSW)

• Ícone de fechar (X) no canto direito do banner

Comportamento condicional do banner:

Quando o tipo de índice selecionado for IVFFLAT:

Texto do banner:

Atenção

• Índices IVFFLAT exigem que a tabela já contenha dados representativos antes da criação do índice (etapa de treinamento k means). Não é possível criar um índice IVFFLAT em uma tabela vazia.

• A dimensão máxima indexável para vetores é de 2.000 dimensões.

• Todas as linhas da coluna indexada devem possuir o mesmo número de dimensões.

• Vetores NULL e vetores zerados (para distância cosseno) não são indexados. Para informações adicionais, consulte a documentação. [pgvector Documentation]

Quando o tipo de índice selecionado for HNSW:

Texto do banner:

Atenção

• Índices HNSW podem ser criados em tabelas vazias, porém possuem tempo de construção mais lento e maior consumo de memória.

• A dimensão máxima indexável para vetores é de 2.000 dimensões.

• Todas as linhas da coluna indexada devem possuir o mesmo número de dimensões.

• Vetores NULL e vetores zerados (para distância cosseno) não são indexados. Para informações adicionais, consulte a documentação. [pgvector Documentation]

03 - ASSETS

• Figma Carol: https://www.figma.com/design/FiL1iRG6RPjuNCgVzgGqvaZ3/%F0%9F%9F%A3-Carol-3.0?node-id=39217-23779&t=MhcLQeXWLzdlNFLt-4

• Figma Plataforma IDeIA: https://www.figma.com/design/L7gu9AFD79a6opdtSNjFdm/Prot%C3%B3tipo---IDeIA-2.0?node-id=23115-24655&t=16eUIZldyUY28XmZ-0

• Documentação BigQuery Vector Index: https://cloud.google.com/bigquery/docs/vector-index

• Documentação PostgreSQL (pgvector): https://github.com/pgvector/pgvector#indexing

04 - CRITÉRIOS DE ACEITE

Interface:

• Banner de atenção exibido na tela de criação/edição de índices

• Link "pgvector" visível e funcional

• Link "BQ Documentation" visível e funcional

• Botão de fechar (X) permite ocultar o banner