Como relacionar dois cubos no HubCount BI Studio

Ligue dois cubos por um campo que existe nos dois e traga as colunas de um para dentro do outro. Exemplo: o cubo Vendas tem a unidade de negócio, e o cubo Unidades tem a região e o gerente de cada unidade. Depois de relacionar, Vendas passa a ter região e gerente, e você pode montar um gráfico de receita por região.

Quando usar

• Quando uma informação mora num cubo, mas a análise está em outro: cadastro de clientes, produtos, unidades ou vendedores.
• Quando você quer agrupar ou filtrar uma medida por um dado que não vem na tabela principal.

Se os dois dados cabem numa mesma tabela da fonte, junte-os na própria consulta SQL em vez de criar um relacionamento.

Antes de começar

• Os dois cubos precisam estar no mesmo projeto.
• Os campos de cada cubo precisam estar escolhidos e salvos. Só campos marcados na aba Mapeamento de Campos aparecem para ligar. Veja Campos do cubo.
• Pense em qual cubo é o principal. O relacionamento sai do cubo que você está editando (a origem) e vai até o outro (o destino). O destino é uma tabela de consulta: para cada valor do campo de ligação, ele deve ter uma linha só.

Criar o relacionamento

O relacionamento só vale quando os três campos da linha estão preenchidos. Para ligar por mais de um campo, clique em Adicionar Relacionamento e preencha outra linha. A tabela mostra 5 linhas por página.

O que muda no cubo

Ao completar a linha, o HubCount BI Studio copia todos os campos do cubo de destino para o cubo atual, já marcados. Eles aparecem na aba Mapeamento de Campos, na lista Selecione os campos, dentro de Campos de Relacionamento, e têm o tipo Relacionamentos.

• O nome amigável de cada campo copiado tem o nome técnico do campo de origem e o nome do cubo entre parênteses, como regiao (Unidades). Você pode trocá-lo na tabela de mapeamento.
• Eles viram campos comuns nas medidas: servem para agrupar, filtrar e escolher o valor.
• Se um campo do destino tem o mesmo nome técnico de um campo que já existe, o HubCount BI Studio renomeia a cópia por dentro (acrescenta o nome do cubo) e mostra o aviso de que houve renomeação. No exemplo, unidade existe nos dois cubos.

Como a ligação funciona

Para cada linha do cubo principal, o HubCount BI Studio procura no cubo de destino a linha cujo campo de ligação tem o mesmo valor, e traz os campos dela.

Regra	O que significa
Comparação por texto	Os valores são comparados como texto, sem diferenciar maiúsculas de minúsculas. Varejo e varejo se encontram. 00123 e 123 não.
Primeira linha vale	Se o destino tem várias linhas com o mesmo valor, só a primeira é usada. Por isso o destino deve ter uma linha por valor.
Sem correspondência	Se o valor não existe no destino, ou o campo está vazio, os campos do destino ficam vazios naquela linha. Ela continua no cubo.
Não sobrescreve	O HubCount BI Studio só preenche um campo vindo do destino quando o cubo principal não tem valor para ele.

Remover um relacionamento

Clique no ícone de lixeira da linha e salve o cubo. Isso remove a ligação e também os campos copiados daquele cubo. Se uma medida ou um gráfico usava um desses campos, ele deixa de funcionar: troque o campo antes de excluir.

Para mudar a ligação, exclua a linha e crie outra. Trocar só um dos campos de uma linha já criada não atualiza a ligação salva.

Exemplo: região e gerente nas vendas da Aurora

Na Contabilidade Exemplo, o projeto “Resultado Comercial 2026” da Aurora Comércio Ltda tem dois cubos. O cubo Vendas tem receita por unidade de negócio. O cubo Unidades lista cada unidade com a região e o gerente:

unidade	regiao	gerente
Indústria	Sudeste	Marina Alves
Varejo	Sul	Carlos Pinto
Serviços	Nordeste	Joana Reis

Relacione Campo do Cubo de Origem “Unidade” de Vendas com o campo “Unidade” do cubo Unidades. Depois de salvar, crie uma medida de soma sobre a Receita agrupada por regiao (Unidades), ou filtre a medida pelo gerente. O gráfico passa a mostrar a receita por região, sem você mexer na tabela de vendas.

Cuidados

• Ligue por um código ou identificador, não por nomes, que mudam com mais facilidade. Os dois campos precisam ter os mesmos valores, escritos do mesmo jeito.
• Campos de relacionamento não entram na lista de origem nem na de destino. Por isso não dá para encadear relacionamentos entre três cubos.
• O cubo de destino precisa ter os campos escolhidos. Se você mudar os campos dele depois, abra este cubo e confira os campos de relacionamento.
• Se o cubo de destino sair do projeto, a ligação deixa de aparecer no editor. Confira o diagrama depois de qualquer mudança.
• Se o cubo de destino reúne cadastros de várias empresas do projeto (campos do tipo Id da Empresa) e o mesmo código aparece em mais de uma empresa, só a primeira linha com aquele código vale. O relacionamento não separa por empresa: ligue por um código que seja único no cubo de destino. Veja Campos do cubo.
• Campos renomeados por conflito de nome (como unidade no exemplo) merecem uma conferência: abra a aba Dados Integrados e veja se os valores vieram.

Próximos passos

• Use os campos novos em medidas e filtros.
• Crie contas entre campos dos dois cubos com campos calculados.