Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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-dbitem. - 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
Abra a experiência de consulta do banco de dados operacional para
contoso-orders-db.Crie uma nova consulta SQL.
Confirme que a consulta tem como alvo o endpoint PostgreSQL, e não o endpoint de análise SQL.
Executar:
SELECT current_database() AS database_name, current_user AS signed_in_user, clock_timestamp() AS connected_at;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
- Atualize o explorador de objetos do banco de dados.
- Expanda a coleção de esquema.
- Expanda
horizon_sample. - Expanda a coleção de tabelas.
- Selecione
customers, e inspecione suas colunas e a chave primária. - 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. |