Tutorial: Criar tabelas e carregar dados no Microsoft Fabric HorizonDB

Nesta etapa do tutorial, você usa o editor SQL do Fabric HorizonDB para criar o esquema horizon_sample e carregar um pequeno conjunto de dados de pedidos da Contoso usando SQL do PostgreSQL.

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

  • Conclua a criação de um banco de dados HorizonDB.
  • Abra o contoso-orders-db item.
  • Faça login como criador do banco de dados, a única identidade que pode se conectar ao PostgreSQL na pré-visualização atual.

Abra o editor do SQL

  1. Abra a experiência de consulta do banco de dados operacional para contoso-orders-db.

  2. Crie uma nova consulta SQL.

  3. Confirme que a consulta tem como alvo o endpoint PostgreSQL, e não o endpoint de análise SQL.

  4. Executar:

    SELECT
        current_database() AS database_name,
        current_user AS signed_in_user,
        clock_timestamp() AS connected_at;
    
  5. Confirme que o resultado identifica o banco de dados postgres, conforme mostrado nos detalhes de conexão do item, e a identidade efetiva do criador.

Criar o esquema e as tabelas

Execute o seguinte script:

CREATE SCHEMA IF NOT EXISTS horizon_sample;

CREATE TABLE IF NOT EXISTS horizon_sample.customers (
    customer_id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    customer_name text NOT NULL UNIQUE,
    segment text NOT NULL,
    created_at timestamptz NOT NULL DEFAULT now()
);

CREATE TABLE IF NOT EXISTS horizon_sample.orders (
    order_id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    order_reference text NOT NULL UNIQUE,
    customer_id bigint NOT NULL
        REFERENCES horizon_sample.customers (customer_id),
    order_date date NOT NULL DEFAULT current_date,
    status text NOT NULL
        CHECK (status IN ('open', 'processing', 'completed', 'cancelled')),
    total numeric(12, 2) NOT NULL
        CHECK (total >= 0),
    created_at timestamptz NOT NULL DEFAULT now()
);

As tabelas usam colunas identity, restrições e tipos de carimbo de tempo do PostgreSQL. As chaves primárias também suportam as verificações de elegibilidade para espelhamento que você realiza posteriormente.

Carregar as linhas de exemplo

Execute esta carga reexecutável:

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;

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;

ON CONFLICT Torna a carga idempotente para os nomes estáveis de clientes e referências de pedido. Executá-lo novamente atualiza as linhas de exemplo em vez de criar duplicatas.

Validar os dados

Executar:

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;

O resultado contém três linhas:

Pedido Customer Segmento Status Total
ORD-1001 Contoso Retail Enterprise em aberto 1250.00
ORD-1002 Lojas Fabrikam Comercial processamento 425,50
ORD-1003 Adventure Works Enterprise concluído 980,25

Valide o agregado:

SELECT
    count(*) AS order_count,
    sum(total) AS order_total,
    min(order_date) AS earliest_order_date,
    max(order_date) AS latest_order_date
FROM horizon_sample.orders;

O esperado order_count é 3, e o esperado order_total é 2655.75.

Atualize o explorador de objetos

  1. Atualize o explorador de objetos do banco de dados.
  2. Expanda a coleção de esquema.
  3. Expanda horizon_sample.
  4. Expanda a coleção de tabelas.
  5. Selecione customers, e inspecione suas colunas e a chave primária.
  6. Selecione orders, e inspecione suas colunas, chave primária, chave estrangeira, restrição única e restrições de verificação.

Se o explorador não atualizar, verifique as tabelas por meio dos metadados PostgreSQL:

SELECT
    table_schema,
    table_name,
    table_type
FROM information_schema.tables
WHERE table_schema = 'horizon_sample'
ORDER BY table_name;

Mais adiante no tutorial, você usa um trabalho Copy para carregar um resultado delimitado separado de sinais de clientes de uma fonte Fabric elegível. Mantenha as linhas operacionais de cliente e pedido nesta etapa inalteradas para que você possa comparar os resultados analíticos do PostgreSQL e espelhados.

Solucionar problemas de carga

Sintoma Resolução
permission denied for schema Confirme que você está conectado como criador do banco de dados e que está criando objetos em um esquema de propriedade do cliente.
relation does not exist Execute o script de criação, verifique o banco de dados atual e qualifique a tabela com horizon_sample.
Falha de restrição única Revise os nomes dos clientes existentes e as referências de pedidos antes de alterar a regra de conflito.
Uma chave estrangeira falha Carregue clientes antes dos pedidos e verifique a junção do cliente.
O Gerenciador de Objetos está desatualizado Faça commit do DDL, se necessário, atualize o explorador e verifique com information_schema.

Próxima etapa