Habilidades Azure PostgreSQL for TypeScript (node-postgres)
📦

Azure PostgreSQL for TypeScript (node-postgres)

Seguro 🔑 Variáveis de ambiente

Conectar Aplicações TypeScript ao Azure PostgreSQL com Segurança Empresarial

Construir aplicações de produção requer conexões de banco de dados seguras e escaláveis. Esta skill fornece padrões completos para Azure PostgreSQL com pooling de conexões, transações e autenticação passwordless com Microsoft Entra ID.

Suporta: Claude Codex Code(CC)
🥉 72 Bronze
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "Azure PostgreSQL for TypeScript (node-postgres)". Usuário solicita configuração básica de conexão PostgreSQL

Resultado esperado:

Fornece um exemplo completo de código TypeScript mostrando inicialização do Client com variáveis de ambiente, configuração SSL, estabelecimento de conexão, execução de queries e limpeza adequada da conexão em um bloco try/finally.

A utilizar "Azure PostgreSQL for TypeScript (node-postgres)". Usuário precisa de connection pooling para produção

Resultado esperado:

Entrega configuração de Pool com settings de produção incluindo máximo de 20 conexões, idle timeout de 30 segundos, exemplos de execução de query, checkout explícito de client para múltiplas queries e padrões adequados de liberação.

A utilizar "Azure PostgreSQL for TypeScript (node-postgres)". Usuário quer autenticação passwordless Entra ID

Resultado esperado:

Mostra configuração do DefaultAzureCredential, aquisição de token para recurso PostgreSQL, uso do token como senha na configuração do client e uma classe wrapper para refresh automático de token antes da expiração.

Auditoria de Segurança

Seguro
v1 • 2/25/2026

This is a prompt-only skill containing documentation and code examples for Azure PostgreSQL connections. Static analysis scanned 0 files with 0 code lines since the skill only contains a SKILL.md documentation file. No executable code patterns, external commands, network calls, or dangerous operations were detected. The skill provides educational content about secure database connection practices including parameterized queries, SSL configuration, and proper credential handling.

0
Arquivos analisados
0
Linhas analisadas
1
achados
1
Total de auditorias

Fatores de risco

🔑 Variáveis de ambiente (1)
SKILL.md:24-35
Auditado por: claude

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
50
Comunidade
100
Segurança
74
Conformidade com especificações

O Que Você Pode Construir

Backend de API de Produção

Construa serviços backend escaláveis com pooling de conexões que gerencia eficientemente requisições de banco de dados concurrentes e gerenciamento automático de conexões.

Aplicações Empresariais Seguras

Implemente autenticação passwordless de banco de dados usando managed identities do Microsoft Entra ID para conformidade de segurança aprimorada.

Aplicações Data-Intensive

Execute operações complexas multi-statement com suporte a transações garantindo consistência e integridade dos dados.

Tente Estes Prompts

Conexão PostgreSQL Básica 
Mostre-me como conectar ao Azure PostgreSQL a partir do TypeScript usando o cliente pg com autenticação por senha e SSL habilitado.
Configuração de Connection Pool 
Crie um connection pool para Azure PostgreSQL com configuração adequada para uso em produção incluindo max connections, idle timeout e configurações de connection timeout.
Autenticação Microsoft Entra ID 
Mostre-me como implementar autenticação passwordless ao Azure PostgreSQL usando managed identity do Microsoft Entra ID com refresh automático de token.
Transação com Tratamento de Erros 
Crie uma função helper de transação que envolve operações de banco de dados com lógica BEGIN, COMMIT e ROLLBACK incluindo tratamento de erros adequado e liberação de conexão.

Melhores Práticas

  • Sempre use consultas parametrizadas em vez de concatenação de strings para prevenir vulnerabilidades de SQL injection
  • Use connection pools em vez de conexões únicas para aplicações de produção para melhorar performance e utilização de recursos
  • Habilite SSL com rejectUnauthorized definido como true para todas as conexões Azure PostgreSQL para garantir comunicação criptografada

Evitar

  • Nunca concatene input do usuário diretamente em queries SQL - sempre use queries parametrizadas com placeholders
  • Evite criar novas instâncias de Client para cada query - isso esgota conexões do banco de dados e degrada performance
  • Não pule a lógica de refresh de token ao usar autenticação Entra ID - tokens expiram após aproximadamente uma hora

Perguntas Frequentes

Qual é a diferença entre Client e Pool no node-postgres?
Client representa uma única conexão de banco de dados adequada para scripts simples. Pool gerencia múltiplas conexões, lidando automaticamente com checkout e liberação para requisições concurrentes, tornando-o ideal para aplicações de produção.
Como lidar com expiração de token do Microsoft Entra ID?
Implemente uma classe wrapper que rastreia o tempo de expiração do token e adquire um token novo 5 minutos antes da expiração. A classe AzurePostgresPool fornecida demonstra este padrão automaticamente.
Por que Azure PostgreSQL requer SSL com rejectUnauthorized definido como true?
Azure impõe conexões criptografadas por segurança. Definir rejectUnauthorized como true garante que o certificado do servidor seja validado, prevenindo ataques man-in-the-middle.
Qual tamanho de pool devo usar para Azure PostgreSQL?
Comece com máximo de 20 conexões para workloads médios. Ajuste baseado nos limites de conexão do seu tier Azure e monitore pool.waitingCount para detectar quando conexões estão esgotadas.
Como executar a mesma query para múltiplos sets de parâmetros eficientemente?
Use pool.query() para queries únicas ou checkout um client com pool.connect() para múltiplas queries relacionadas. Sempre libere o client de volta ao pool usando client.release() em um bloco finally.
Posso usar esta skill com servidores PostgreSQL não hospedados no Azure?
Sim, o pacote core pg funciona com qualquer servidor PostgreSQL. No entanto, autenticação Microsoft Entra ID e algumas configurações específicas do Azure apenas se aplicam ao Azure Database for PostgreSQL.

Detalhes do Desenvolvedor

Autor

sickn33

Licença

MIT

Repositório

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-postgres-ts

Referência

main

Estrutura de arquivos

📄 SKILL.md