View a markdown version of this page

Definindo relações entre conjuntos de dados em um tópico - Amazon Quick
Formato JSON de relacionamentoMelhores práticas para relacionamentosLimitações atuais

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Definindo relações entre conjuntos de dados em um tópico

 Aplica-se a: Enterprise Edition 
   Público-alvo: administradores e autores do Amazon Quick 

Os relacionamentos mostram ao Quick Sight como unir conjuntos de dados quando uma pergunta ou um visual abrange várias tabelas. Você define relacionamentos especificando chaves de junção entre pares de conjuntos de dados usando um arquivo de configuração JSON.

O gráfico de relacionamento deve ser um gráfico acíclico direcionado (DAG) — relacionamentos circulares não são suportados. Recomendamos modelar seus conjuntos de dados em um esquema em estrela com uma ou mais tabelas de fatos centrais unidas a tabelas de dimensões compartilhadas.

Para definir relações entre conjuntos de dados

  1. Abra o tópico que você deseja configurar.

  2. Navegue até a guia Relacionamentos.

    Editor de tópicos mostrando a guia Relações com seis conjuntos de dados listados: PRODUCT_DIM, CUSTOMER_DIM, DATE_DIM, SALES_FACT, RETURN_FACT e STORE_DIM.

  3. Escolha Carregar arquivo ou Criar manualmente.

    A guia Relacionamentos mostra os botões Carregar arquivo e Criar manualmente, com os tipos de arquivo suportados YAML e JSON anotados.

  4. Faça upload de um arquivo JSON definindo seus relacionamentos (veja o exemplo a seguir). Após o upload, o gráfico de relacionamento é exibido visualmente à esquerda e os detalhes da chave de união aparecem à direita. Selecione uma união para verificar o mapeamento do relacionamento.

    Gráfico de relacionamento mostrando SALES_FACT e RETURN_FACT como tabelas de fatos centrais conectadas a PRODUCT_DIM, CUSTOMER_DIM, DATE_DIM e STORE_DIM com teclas de junção exibidas no painel direito.

  5. Para editar um relacionamento, escolha Editar, atualize as colunas de união usando os seletores suspensos e escolha Salvar.

    Modo de edição de relacionamentos mostrando menus suspensos editáveis de colunas de união para cada par de conjuntos de dados, com os botões Cancelar e Salvar no canto superior direito.

Formato JSON de relacionamento

O exemplo a seguir mostra uma configuração de esquema em estrela com uma tabela central SALES_FACT unida às tabelas de dimensões:

{
  "datasetPairs": [
    {
      "datasetLeft": { "datasetName": "SALES_FACT", "joinColumnNames": ["CUSTOMER_ID"] },
      "datasetRight": { "datasetName": "CUSTOMER_DIM", "joinColumnNames": ["CUSTOMER_ID"] }
    },
    {
      "datasetLeft": { "datasetName": "SALES_FACT", "joinColumnNames": ["PRODUCT_ID"] },
      "datasetRight": { "datasetName": "PRODUCT_DIM", "joinColumnNames": ["PRODUCT_ID"] }
    },
    {
      "datasetLeft": { "datasetName": "SALES_FACT", "joinColumnNames": ["STORE_ID"] },
      "datasetRight": { "datasetName": "STORE_DIM", "joinColumnNames": ["STORE_ID"] }
    }
  ]
}

Cada entrada em datasetPairs especifica um par de conjuntos de dados e as colunas usadas para uni-los. As chaves compostas são suportadas pela inclusão de vários nomes de colunas na joinColumnNames matriz.

Melhores práticas para relacionamentos

  • Comece com um esquema em estrela. Uma tabela de fatos central cercada por tabelas de dimensões minimiza a complexidade da junção e maximiza o desempenho da consulta.

  • Use chaves de junção limpas. Use chaves substitutas de números inteiros sempre que possível. Confirme os tipos de dados correspondentes nos dois lados. Remova os valores nulos das colunas-chave de junção (os nulos nunca coincidem nas junções internas).

  • Valide a integridade referencial. Cada chave estrangeira na tabela de fatos deve existir na tabela de dimensões.

  • Evite junções circulares. O gráfico de relacionamento deve ser acíclico. Se seu modelo criar um ciclo, quebre-o removendo uma perna e desnormalizando o caminho redundante.

  • Pre-join correntes de flocos de neve quando possível. Se uma dimensão tiver subdimensões (por exemplo, Cliente → Geografia → Região), considere nivelá-las em um conjunto de dados de dimensão única para reduzir os saltos de junção.

Limitações atuais

As seguintes limitações se aplicam aos relacionamentos definidos:

  • Os relacionamentos usam a semântica de junção interna para planilhas de análise. Somente linhas com chaves correspondentes em ambos os conjuntos de dados aparecem nos resultados.

  • O gráfico de relacionamento deve ser acíclico (sem junções circulares).

  • Self-relationships (um conjunto de dados relacionado a si mesmo) não são suportados.

  • Todos os conjuntos de dados em um tópico devem usar o mesmo modo de consulta (SPICEou consulta direta).

  • Um tópico não pode exceder 12 conjuntos de dados.

nota

Ao usar tópicos no Amazon Quick Chat, o agente de LLM-powered bate-papo não se limita às uniões internas. Ele pode gerar SQL com junções à esquerda, junções externas, uniões e subconsultas com base em suas instruções personalizadas. Essas limitações do tipo de junção se aplicam somente ao caminho de consumo da planilha de análise.