Навыки Azure PostgreSQL for TypeScript (node-postgres)
📦

Azure PostgreSQL for TypeScript (node-postgres)

Безопасно 🔑 Переменные окружения

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.

Поддерживает: Claude Codex Code(CC)
📊 69 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «Azure PostgreSQL for TypeScript (node-postgres)». Usuário solicita configuração básica de conexão PostgreSQL

Ожидаемый результат:

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.

Использование «Azure PostgreSQL for TypeScript (node-postgres)». Usuário precisa de connection pooling para produção

Ожидаемый результат:

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.

Использование «Azure PostgreSQL for TypeScript (node-postgres)». Usuário quer autenticação passwordless Entra ID

Ожидаемый результат:

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.

Аудит безопасности

Безопасно
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
Просканировано файлов
0
Проанализировано строк
1
находки
1
Всего аудитов

Факторы риска

🔑 Переменные окружения (1)
SKILL.md:24-35
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
100
Безопасность
74
Соответствие спецификации

Что вы можете построить

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.

Попробуйте эти промпты

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.

Лучшие практики

  • 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

Избегать

  • 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

Часто задаваемые вопросы

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.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

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

Ссылка

main

Структура файлов

📄 SKILL.md