Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Este guia requer o VillageSQL 0.0.4 ou posterior.
O MySQL não tem uma forma nativa de representar um ponto ou uma região em um espaço n-dimensional. Você pode encadear condições AND em várias colunas numéricas, mas isso só cobre a contenção — não se estende a consultas de distância e não permite tratar os atributos de uma linha como um valor geométrico unificado. A extensão vsql_cube do VillageSQL adiciona um tipo personalizado cube que torna os dois tipos de consulta naturais.

O Problema

Suponha que você tenha um catálogo de produtos em que cada produto tem um preço, uma avaliação média e uma contagem de avaliações. Um comprador quer produtos com preço entre US50eUS 50 e US 200, avaliação de pelo menos 3,5 e pelo menos 50 avaliações. Isso é um AND de três partes:
A cadeia de AND encontra as correspondências. Mas se você quiser os 5 produtos mais parecidos com um dado produto — os mais próximos em preço, avaliação e contagem de avaliações ao mesmo tempo — não há uma resposta natural em SQL. Você teria que trazer os candidatos para o código da aplicação e calcular as distâncias lá.

Com o VillageSQL: o tipo cube

O tipo cube armazena um ponto ou uma caixa em um espaço n-dimensional. Um ponto é uma localização; uma caixa é uma região definida por duas coordenadas de canto. Os dois ficam em uma coluna comum.
cube é uma palavra reservada do MySQL, então coloque-a entre crases no DDL. O parâmetro de dimensão (3) é obrigatório — cube sem um número não é suportado.

Inserindo dados

Insira a string de coordenadas diretamente e deixe a própria conversão da coluna interpretá-la. Não a envolva em cube_point_nd(): essa função retorna um cube sem parâmetro, que não pode ser convertido implicitamente em uma coluna cube(3) parametrizada por dimensão (ERROR 3219).
As coordenadas aqui são (price, rating, review_count) — um ponto por produto.

Consultas de intervalo com cube_contains

Defina a sua região de busca como uma caixa. cube_box_nd() recebe as coordenadas do canto inferior seguidas pelas do canto superior, então uma caixa tridimensional recebe seis números.
cube_contains(@region, attrs) retorna 1 quando o ponto do produto está dentro da caixa — equivalente às três condições AND de uma vez, mas também combinável com consultas de distância.

Vizinho mais próximo com cube_distance

Para encontrar os produtos mais parecidos com um dado produto, meça a distância euclidiana no espaço de atributos:
Uma observação sobre escala: o preço está na casa das centenas, a avaliação vai de 0 a 5 e a contagem de avaliações pode chegar aos milhares. A distância euclidiana bruta será dominada pela contagem de avaliações. Normalize as três dimensões para uma escala comum (por exemplo, 0–1) antes de inserir, se você quiser uma pontuação de similaridade equilibrada.

Verificando sobreposição

cube_overlaps() retorna 1 se duas caixas compartilham algum espaço — útil para verificar se um produto se qualifica para qualquer uma de várias faixas de promoção:

Solução de Problemas

Veja também