Tutorial: Construa uma solução de ponta a ponta com Microsoft Fabric HorizonDB

Neste tutorial, você cria uma pequena solução de gerenciamento de pedidos com o Fabric HorizonDB. Você usa as três capacidades Federated Analytics: espelhamento de banco de dados para análise, consultas federadas sobre dados espelhados e um depósito separado, e carregamento de dados por meio de um Copy job. Você também cria um relatório Power BI, analisa dados espelhados em um caderno e conecta uma aplicação PostgreSQL local.

Importante

Fabric HorizonDB está em prévia pública. Capacidades, limites e comportamento podem mudar antes da disponibilidade geral. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.

Scenario

A Contoso precisa de um banco de dados operacional para pedidos de clientes. Consultas de aplicação devem usar o endpoint PostgreSQL, enquanto os relatórios devem usar a cópia analítica espelhada para que consultas analíticas não concorram com o trabalho operacional.

Você cria estes recursos:

Resource Nome do tutorial Purpose
Ambiente de trabalho Fabric contoso-horizondb-tutorial Contém os itens do tutorial.
Banco de dados HorizonDB contoso-orders-db Armazena clientes e pedidos operacionais.
Esquema PostgreSQL horizon_sample Contém as tabelas do tutorial.
Terminal de análise SQL Criado com a integração Fabric HorizonDB Fornece acesso somente de leitura a dados espelhados.
esquema estrangeiro do PostgreSQL fabric_mirror Expõe as tabelas Contoso espelhadas como tabelas estrangeiras somente de leitura.
Depósito contoso-signals-warehouse Armazena a fonte sintética dbo.customer_signals usada pela federação e pelo job Copy.
Servidor estrangeiro de propriedade do cliente customer_signals_dw Conecta o PostgreSQL ao armazém separado.
Schema estrangeiro do PostgreSQL fabric_sales Expõe sinais do warehouse sem armazenar suas linhas localmente.
Copiar tarefa load-contoso-customer-signals Carrega sinais de cliente no staging PostgreSQL.
Modelo semântico do Power BI contoso-orders-model Modela clientes e pedidos para geração de relatórios.
relatório Power BI contoso-order-operations Visualiza totais de pedidos e status.
Fabric notebook contoso-orders-analysis Analisa dados espelhados através do endpoint de análise SQL.
Aplicação Python contoso-orders-app Consulta sinais federados e carregados via PostgreSQL como criador do banco de dados.

Use estes nomes ao longo do tutorial ou registre seus nomes substitutos para poder usá-los de forma consistente.

Architecture

O tutorial utiliza caminhos operacionais e analíticos separados:

  1. O editor Fabric SQL usa o endpoint PostgreSQL do Fabric HorizonDB para trabalhos operacionais.
  2. O espelhamento do Fabric HorizonDB publica de forma assíncrona tabelas elegíveis para o OneLake.
  3. O endpoint de análise SQL, o modelo semântico, o relatório Power BI e o caderno usam a cópia analítica espelhada.
  4. O endpoint PostgreSQL usa pg_fabric_fdw para consultar dados Fabric suportados por meio de tabelas externas somente de leitura.
  5. Um trabalho de Cópia carrega um resultado Fabric limitado no Staging PostgreSQL antes de uma etapa de publicação idempotente.
  6. O aplicativo se conecta ao PostgreSQL como o criador e consulta views sobre sinais federados ou carregados localmente.

O endpoint PostgreSQL e o endpoint de análise SQL possuem motores, permissões, atualização e operações suportadas diferentes. Não use o endpoint de SQL Analytics para gravações operacionais.

O processo de espelhamento é assíncrono. Um banco de dados saudável não garante que os dados espelhados estejam atualizados, e um endpoint de análise SQL saudável não garante que o banco de dados operacional esteja pronto.

Modelo de dados de exemplo

O horizon_sample esquema contém duas tabelas:

  • customers armazena o nome e o segmento do cliente.
  • orders Armazena uma referência de pedido, relacionamento com o cliente, data, status, valor e carimbo de data de criação.

Cada tabela possui uma chave primária para que possa participar de consultas relacionais e verificações de elegibilidade para espelhamento. A carga do tutorial é reexecutável e usa chaves de negócios estáveis para evitar linhas de exemplo duplicadas.

O que você aprenderá

Neste tutorial, você:

  1. Crie um espaço de trabalho Fabric.
  2. Crie e valide um banco de dados HorizonDB.
  3. Crie tabelas PostgreSQL e carregue dados de exemplo.
  4. Use o editor SQL e o explorador de objetos.
  5. Revise o estado de monitoramento, segurança e integração básicos.
  6. Valide o espelhamento e consulte o endpoint de análise SQL.
  7. Consulte as tabelas espelhadas do Fabric HorizonDB por meio da federação.
  8. Carregue um resultado delimitado do Fabric no Fabric HorizonDB usando um trabalho de cópia.
  9. Construa um modelo semântico Power BI e relaise.
  10. Analise dados de pedidos espelhados em um notebook Fabric.
  11. Consulte dados federados e carregados em um pequeno aplicativo Python.
  12. Remova os recursos do tutorial.

Prerequisites

  • Um tenant do Microsoft Fabric onde o Fabric HorizonDB está disponível.
  • Acesso a uma capacidade Fabric elegível.
  • Permissão para criar um espaço de trabalho ou acesso a um espaço de trabalho onde você pode criar os itens necessários.
  • Uma identidade Microsoft Entra habilitada para a prévia do Fabric HorizonDB.
  • Acesso ao espaço de trabalho como colaborador ou administrador e permissão para criar itens de banco de dados PostgreSQL, warehouse, trabalho de cópia, modelo semântico, relatório e notebook.
  • Permissão para ler as fontes Fabric usadas para federação e carregamento.
  • Python 3.10 ou superior para a etapa do aplicativo.

Você não precisa instalar um servidor PostgreSQL. O Fabric HorizonDB fornece o endpoint gerenciado PostgreSQL.

Use um espaço de trabalho dedicado para desenvolvimento ou teste e dados sintéticos e não sensíveis. Confirme as limitações de habilitação da versão prévia e de recuperação com seu administrador ou contato da versão prévia. Somente a identidade Microsoft Entra que cria o banco de dados pode se conectar ao PostgreSQL. Use essa identidade em todo o banco de dados, Copiar destino de tarefa e exercícios de aplicação local.

O item Fabric se chama contoso-orders-db, mas o banco de dados da conexão PostgreSQL é postgres na pré-visualização atual. Copie os valores de conexão do painel Visual Studio Code do item.

Sequência do tutorial

Conclua os passos em ordem:

  1. Crie um espaço de trabalho.
  2. Crie um banco de dados HorizonDB.
  3. Crie tabelas e carregue dados de exemplo.
  4. Consulte e inspecione o banco de dados.
  5. Use o endpoint de análise SQL.
  6. Consultar os dados espelhados do Fabric no Fabric HorizonDB.
  7. Carregue dados Fabric no Fabric HorizonDB com um trabalho de Cópia.
  8. Crie visualizações do Power BI.
  9. Analise dados em um notebook.
  10. Conecte uma aplicação PostgreSQL.
  11. Limpar os recursos.

Próxima etapa