Carregar dados de amostra no Microsoft Fabric HorizonDB

Este artigo carrega um conjunto de dados compacto nativo do PostgreSQL no Fabric HorizonDB. O script é reexecutável e usa chaves de negócios estáveis com ON CONFLICT.

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.

Prerequisites

  • Um banco de dados HorizonDB.
  • As tabelas em Create tables.
  • Faça login como criador do banco de dados. Somente essa identidade Microsoft Entra pode se conectar ao PostgreSQL na pré-visualização atual.

Inserir clientes

Abra uma nova consulta PostgreSQL e execute:

INSERT INTO horizon_sample.customers (customer_name, segment)
VALUES
    ('Contoso Retail', 'Enterprise'),
    ('Fabrikam Stores', 'Commercial'),
    ('Adventure Works', 'Enterprise')
ON CONFLICT (customer_name) DO UPDATE
SET segment = EXCLUDED.segment;

O nome único do cliente atua como uma chave de negócio de amostra estável.

Use dados sintéticos em um espaço de trabalho dedicado para testes. Registre os IDs de cliente gerados antes de criar sinais de armazém; os valores de identidade não têm garantia de começar em 1 ou permanecer consecutivos após as reexecuções.

Inserir pedidos

INSERT INTO horizon_sample.orders (
    order_reference,
    customer_id,
    order_date,
    status,
    total
)
SELECT
    source.order_reference,
    customer.customer_id,
    source.order_date,
    source.status,
    source.total
FROM (
    VALUES
        ('ORD-1001', 'Contoso Retail', current_date, 'open', 1250.00::numeric),
        ('ORD-1002', 'Fabrikam Stores', current_date - 1, 'processing', 425.50::numeric),
        ('ORD-1003', 'Adventure Works', current_date - 2, 'completed', 980.25::numeric)
) AS source (
    order_reference,
    customer_name,
    order_date,
    status,
    total
)
JOIN horizon_sample.customers AS customer
  ON customer.customer_name = source.customer_name
ON CONFLICT (order_reference) DO UPDATE
SET
    customer_id = EXCLUDED.customer_id,
    order_date = EXCLUDED.order_date,
    status = EXCLUDED.status,
    total = EXCLUDED.total;

A junção obtém IDs de cliente gerados a partir de nomes de clientes estáveis. Executar novamente o script atualiza os pedidos existentes em vez de adicionar duplicatas.

Validar a carga

SELECT
    order_row.order_reference,
    customer.customer_name,
    customer.segment,
    order_row.order_date,
    order_row.status,
    order_row.total
FROM horizon_sample.orders AS order_row
JOIN horizon_sample.customers AS customer
  ON customer.customer_id = order_row.customer_id
ORDER BY order_row.order_reference;

Os resultados esperados contêm três pedidos, um para cada cliente.

Validar as contagens:

SELECT
    (SELECT count(*) FROM horizon_sample.customers) AS customer_count,
    (SELECT count(*) FROM horizon_sample.orders) AS order_count;

Execute novamente a carga e confirme que as contagens permanecem três e três.

Use uma transação para cargas de aplicações

Para alterações relacionadas, envolva a carga completa em uma transação:

BEGIN;

-- Run the customer and order upsert statements.

COMMIT;

Use ROLLBACK; quando a validação falhar. Para importações maiores, carregue uma tabela de preparação, valide tipos e chaves de negócios e, em seguida, publique com uma transação idempotente. Não reprocesse uma transação após um commit indeterminado sem antes reconciliar as chaves de negócio.

Limpeza

Para remover todas as linhas das tabelas de exemplo enquanto as mantém, execute o seguinte comando. Isso também exclui quaisquer linhas que não sejam exemplo que você adicionou; não o execute se precisar mantê-las:

TRUNCATE TABLE
    horizon_sample.orders,
    horizon_sample.customers
RESTART IDENTITY;

Revise os nomes das tabelas antes de executar o comando.

Próxima etapa

Consulte os dados de exemplo.