Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é RLS?

    A RLS restringe quais linhas podem ser lidas ou alteradas em uma tabela. Entenda as políticas do PostgreSQL e as exceções de acesso administrativo.

    Também chamado de: Row Level Security, Row-Level Security, restrições de acesso por linha

    Acesso avaliado para cada linha

    A RLS (Row-Level Security) é um mecanismo que restringe quais linhas de uma tabela podem ser consultadas ou modificadas. No PostgreSQL, você habilita esse controle na tabela e define políticas com expressões que retornam verdadeiro ou falso. Uma linha só fica disponível para o comando quando satisfaz as políticas aplicáveis ao papel conectado.

    As permissões gerais da tabela continuam necessárias. Conceder SELECT permite tentar a consulta, mas a RLS determina quais linhas ela pode retornar. A documentação do PostgreSQL também distingue a expressão USING, que filtra as linhas existentes, da expressão WITH CHECK, que verifica os novos valores de uma inserção ou atualização.

    Um chamado com identificador conhecido

    Neste exemplo didático, cada empresa usa um papel próprio do banco. A tabela chamados tem a coluna empresa, cujo valor corresponde ao nome desse papel. Uma política de leitura compara empresa = current_user. Conectada como empresa_a, a aplicação tenta buscar pelo identificador um chamado associado a empresa_b.

    A consulta não retorna esse chamado porque a comparação da política é falsa para essa linha, mesmo que a aplicação conheça o identificador. Você deve repetir o teste com o papel usado pela aplicação, pois uma consulta feita pelo proprietário da tabela pode ignorar o filtro.

    Esse exemplo pressupõe que a identidade da empresa já foi associada corretamente ao papel conectado. Uma aplicação que compartilha um único papel entre empresas precisa estabelecer outra forma confiável de identificar a empresa para a política. A RLS não deduz essa identidade a partir da tela aberta no navegador.

    Exceções de acesso

    Superusuários e papéis com BYPASSRLS ignoram as políticas. O proprietário da tabela normalmente também as ignora, salvo com FORCE ROW LEVEL SECURITY. Por isso, credenciais administrativas produzem resultados diferentes dos acessos comuns.

    A RLS controla linhas, com políticas que podem variar conforme o comando. Ações sobre a tabela inteira, como TRUNCATE, ficam fora desse controle. As permissões concedidas ao papel precisam considerar essa exceção para evitar que ele possa esvaziar a tabela inteira.

    Dúvidas frequentes

    Perguntas frequentes sobre RLS

    Habilitar a RLS concede acesso às linhas?
    No PostgreSQL, a RLS habilitada sem política aplicável recusa o acesso normal às linhas. Uma política também não substitui as permissões concedidas na tabela. O papel conectado precisa atender às duas camadas de acesso.
    Uma política de consulta permite inserir registros?
    Uma política definida para SELECT permite somente a leitura prevista por ela. A inserção exige a permissão de INSERT e uma política aplicável ao comando. A expressão WITH CHECK pode verificar os valores da linha que será inserida.
    O administrador está sujeito à mesma política?
    Superusuários e papéis com BYPASSRLS ignoram a RLS. O proprietário da tabela normalmente também a ignora, mas pode ficar sujeito às políticas com FORCE ROW LEVEL SECURITY. Essa configuração não retira a exceção de superusuários e papéis com BYPASSRLS.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    A RLS permite implementar restrições de acesso aos registros de aplicações com cadastros e organizações diferentes.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano