Ridge Pgwire e drivers

ridged expõe um limite PostgreSQL-wire subconjunto v3 em loopback. Pgwire é um contrato de transporte; isso não faz Ridge um PostgreSQL servidor.

Ponto de extremidade padrão

Configuração Padrão
Anfitrião 127.0.0.1
Porto 7898
Banco de dados ridge
Usuário ridge
Mensagem máxima 1 MiB

Mantenha o ouvinte em loopback. Para um host remoto, use Ridge Admin foi verificado SSH direct-tcpip transporte ou controlado pelo operador SSH conexão.

Configuração de segurança

O bootstrap de primeira execução cria o diretório de dados, um superusuário durável e o banco de dados inicial em uma operação recuperável e, em seguida, imprime instruções de conexão:

ridged --init --data=/absolute/path/to/ridge --password=SECRET

O catálogo chega a {data}/security.catalog com permissões exclusivas do proprietário. Um servidor iniciado com o mesmo --data o descobre automaticamente; nenhuma configuração de ambiente é necessária. A nova execução de --init em um catálogo válido relata a inicialização existente em vez de substituí-la.

O serviço ainda reconhece o ambiente da operadora:

RIDGE_PGWIRE_PORT
RIDGE_PGWIRE_DATABASE
RIDGE_PGWIRE_USER
RIDGE_PGWIRE_PASSWORD
RIDGE_PGWIRE_READ_ONLY
RIDGE_PGWIRE_TLS_CERT
RIDGE_PGWIRE_TLS_KEY
RIDGE_SECURITY_CATALOG

RIDGE_PGWIRE_USER/RIDGE_PGWIRE_PASSWORD/RIDGE_PGWIRE_DATABASE são entradas de inicialização e de migração única, não o caminho de integração principal. RIDGE_SECURITY_CATALOG substitui o local do catálogo quando o catálogo deve estar fora do diretório de dados.

A autenticação por senha é um texto não criptografado dentro do canal TLS verificado. Ridge não reivindica SCRAM, identidade de certificado ou comportamento de privilégio amplo PostgreSQL além do catálogo de segurança documentado. Proteja o arquivo de ambiente com permissões restritivas.

Superfície de protocolo

O daemon suporta inicialização, negociação SSL, consulta simples e texto limitado Parse/Bind/Describe/Execute/Sync ciclo de vida. Preserva transaction/error estado, parameter/result metadados, digitação NULL, valores de texto seguros para binários, named/unnamed declarações, religação e lote de portal limitado, cancelamento e DISCARD ALL.

Os recursos não suportados incluem COPY, formatos binários gerais, portal de descrição relacional JDBC e catálogos amplos.

Clientes validados

Cliente Evidência congelada
libpq/psql 17,5
JDBC 42.7.7
Vá pgx 5.7.5
Psicopg Python 3.2.9
Nó página 8.16.3

Somente as configurações de teste documentadas e os formatos de consulta são reivindicados. Um ORM ainda pode falhar se esperar PostgreSQL catálogos, parâmetros de servidor, migrações ou codificações binárias fora do subconjunto.

Conexão básica

psql -X -h 127.0.0.1 -p 7898 -U ridge -d ridge
pg_isready -h 127.0.0.1 -p 7898 -d ridge

Use um pool de conexões limitado. Ao desconectar, a reprodução somente leitura funciona somente quando o chamador permite explicitamente. Nunca reproduza uma mutação cujo reconhecimento foi perdido; seu resultado é incerto até ser verificado.