Criar tabelas no Microsoft Fabric HorizonDB

Este artigo cria um esquema de exemplo PostgreSQL reutilizável no Fabric HorizonDB. As tabelas usam colunas de identidade, chaves primárias e estrangeiras, restrições de verificação, carimbos de tempo com fusos horários e um índice.

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.
  • Acesso ao editor SQL ou a outro cliente PostgreSQL.
  • Faça login como criador do banco de dados. Outros usuários e entidades de segurança não podem se conectar ao PostgreSQL na pré-visualização atual.

Crie o esquema de exemplo

Abra uma nova consulta e execute:

CREATE SCHEMA IF NOT EXISTS horizon_sample;

O uso de um esquema dedicado mantém o exemplo separado dos esquemas gerenciados por serviços e de aplicação.

Criar a tabela do cliente

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()
);

Esta tabela usa uma coluna de identidade PostgreSQL para sua chave primária substituta. A restrição única impede nomes de clientes duplicados neste exemplo.

Criar a tabela de pedidos

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()
);

A chave estrangeira impede que um pedido faça referência a um cliente ausente. As restrições de verificação protegem o vocabulário de status e impedem totais negativos.

Adicionar um índice

As restrições primárias e únicas já criam índices. Adicione um índice para um padrão comum de acesso por clientes e datas:

CREATE INDEX IF NOT EXISTS ix_orders_customer_date
ON horizon_sample.orders (customer_id, order_date DESC);

Não adicione índices sem um motivo de carga de trabalho. Cada índice consome armazenamento e adiciona trabalho a inserções, atualizações, aspiração e espelhamento.

Verifique os objetos

Inspecione as colunas:

SELECT
    table_name,
    column_name,
    data_type,
    is_nullable,
    column_default
FROM information_schema.columns
WHERE table_schema = 'horizon_sample'
  AND table_name IN ('customers', 'orders')
ORDER BY table_name, ordinal_position;

Inspecionar restrições:

SELECT
    table_name,
    constraint_name,
    constraint_type
FROM information_schema.table_constraints
WHERE table_schema = 'horizon_sample'
ORDER BY table_name, constraint_type, constraint_name;

Os resultados esperados incluem chaves primárias em ambas as tabelas, uma chave externa de orders para customers, restrições únicas e restrições de verificação.

Atualize o explorador de objetos, expanda Esquemas, expanda horizon_sample, e expanda Tabelas. Selecione customers ou orders para inspecionar colunas e chaves.

Entenda propriedade e acesso

A identidade que cria um objeto normalmente o detém. A propriedade permite mudanças poderosas, incluindo a eliminação do objeto.

Somente a identidade Microsoft Entra que criou o banco de dados pode se conectar durante a visualização atual. Compartilhar o item Fabric não habilita usuários adicionais do PostgreSQL. Não crie funções de login para contornar a restrição.

Para mais informações, consulte Validar o acesso PostgreSQL.

Limpeza

Revise o nome do esquema antes de executar:

DROP SCHEMA IF EXISTS horizon_sample CASCADE;

CASCADE elimina todos os objetos do schema. Não o use em um schema gerenciado pelo serviço ou de aplicativo.

Próxima etapa

Carregar dados de amostra.