O que são schemas no PostgreSQL?

Question

Accepted Answer

Um **schema** no PostgreSQL é um **namespace** dentro de um banco de dados — um container lógico que agrupa tabelas, views, funções e outros objetos relacionados. Schemas permitem organizar objetos e evitar colisões de nomes; o schema padrão é `public`.

## Schemas organizam objetos dentro de um banco de dados

```text
A PostgreSQL server can have multiple DATABASES.
Each database can have multiple SCHEMAS (namespaces).
Each schema contains TABLES, views, functions, etc.
→ Hierarchy: server → database → schema → tables/objects
```

```sql
CREATE SCHEMA sales;                    -- create a schema
CREATE TABLE sales.orders (...);         -- a table IN the sales schema (qualified name)
SELECT * FROM sales.orders;              -- reference with schema.table

-- the default schema is `public` — unqualified objects go there
CREATE TABLE users (...);                -- actually public.users
```

Objetos são referenciados como `schema.object`. Sem um prefixo de schema, o Postgres usa o **search path** (padrão: `public`).

## O search path

```sql
SHOW search_path;                        -- default: "$user", public
SET search_path TO sales, public;        -- look in sales first, then public
SELECT * FROM orders;                    -- finds sales.orders (no prefix needed)
```

O **search path** determina quais schemas o Postgres procura para nomes não qualificados — defini-lo permite usar nomes curtos dentro de um schema escolhido.

## Por que usar schemas

```text
✓ ORGANIZATION — group related objects (e.g. `sales`, `inventory`, `auth` schemas)
✓ Avoid naming collisions — two schemas can each have an `orders` table
✓ MULTI-TENANCY — a schema per tenant (isolating each customer's data)
✓ SECURITY/permissions — grant access per schema
✓ Separating concerns — e.g. an `app` schema vs an `analytics` schema
```

Um padrão comum é um **schema por tenant** em aplicações multi-tenant, ou agrupamento por domínio/módulo.

## Por que isso importa

Schemas são um recurso PostgreSQL útil para **organizar objetos de banco de dados**, e compreendê-los é valioso para estruturar bancos de dados bem, especialmente conforme crescem ou servem múltiplos tenants.

Compreender que um schema é um namespace dentro de um banco de dados (agrupando tabelas, views, funções) — com a hierarquia de servidor → banco de dados → schema → objetos — esclarece como o Postgres organiza objetos e como referenciá-los (`schema.object`, ou confiando no **search path** para nomes não qualificados, com padrão `public`).

Conhecer os **usos práticos** é o valor-chave: schemas fornecem organização (agrupando objetos relacionados por domínio/módulo — `auth`, `sales`, `analytics`), evitam colisões de nomes (schemas diferentes podem ter tabelas com mesmo nome), habilitam segurança/permissões por schema, e crucialmente suportam **multi-tenancy** (um padrão comum de um schema por tenant para isolar dados de cada cliente — uma opção arquitetônica importante para aplicações SaaS).

Compreender schemas e o search path ajuda você a organizar um banco de dados de forma limpa, evitar a desordem e colisões de colocar tudo em `public`, e implementar padrões como multi-tenancy.

Como organizar objetos de banco de dados logicamente importa para manutenibilidade (especialmente em aplicações maiores), e como schemas habilitam padrões importantes (separação de domínio, multi-tenancy, segurança por schema), compreender schemas do PostgreSQL — o que são, o search path, e seus usos práticos — é conhecimento valioso e praticamente relevante para estruturar bancos de dados Postgres efetivamente, particularmente relevante para aplicações maiores ou multi-tenant onde boa organização de objetos é importante.