Postgres.js용 Aurora DSQL 커넥터

Postgres.js용 Aurora DSQL 커넥터는 JavaScript 애플리케이션을 Amazon Aurora DSQL 클러스터에 연결하기 위한 IAM 인증을 통합하는 Postgres.js를 기반으로 구축된 Node.js 커넥터입니다.

Postgres.js용 Aurora DSQL 커넥터는 Postgres.js 클라이언트 및 풀 기능을 확장하는 인증 플러그인으로 설계되어 애플리케이션이 IAM 자격 증명을 사용하여 Amazon Aurora DSQL과 인증할 수 있도록 합니다. 커넥터는 데이터베이스에 직접 연결되지 않지만 기본 Postgres.js 드라이버를 기반으로 원활한 IAM 인증을 제공합니다.

커넥터 정보

Amazon Aurora DSQL은 PostgreSQL 호환 애플리케이션에 고가용성과 확장성을 제공하는 분산된 SQL 데이터베이스 서비스입니다. Aurora DSQL에는 기존 Node.js 드라이버가 기본적으로 지원하지 않는 시간 제한 토큰을 사용한 IAM 기반 인증이 필요합니다.

Postgres.js용 Aurora DSQL 커넥터의 기본 개념은 Postgres.js 클라이언트 위에 IAM 토큰 생성을 처리하는 인증 계층을 추가하여, 사용자가 기존 Postgres.js 워크플로를 변경하지 않고도 Aurora DSQL에 연결할 수 있도록 하는 것입니다.

Postgres.js용 Aurora DSQL 커넥터는 대부분의 Postgres.js 버전에서 작동합니다. 사용자는 Postgres.js를 직접 설치하여 자체 버전을 제공합니다.

Aurora DSQL 인증이란 무엇입니까?

Aurora DSQL에서 인증에는 다음이 포함됩니다.

Postgres.js용 Aurora DSQL 커넥터는 이러한 요구 사항을 이해하고 연결을 설정할 때 IAM 인증 토큰을 자동으로 생성하도록 설계되었습니다.

특성

빠른 시작 설명서

요구 사항

설치

npm install @aws/aurora-dsql-postgresjs-connector
# Postgres.js is a peer-dependency, so users must install it themselves
npm install postgres

기본 사용법

import { auroraDSQLPostgres } from '@aws/aurora-dsql-postgresjs-connector';

const sql = auroraDSQLPostgres({
  host: 'your-cluster.dsql.us-east-1.on.aws',
  username: 'admin',
    
});

// Execute queries
const result = await sql`SELECT current_timestamp`;
console.log(result);

// Clean up
await sql.end();

호스트 대신 클러스터 ID 사용

const sql = auroraDSQLPostgres({
  host: 'your-cluster-id',
  region: 'us-east-1',
  username: 'admin',
    
});

연결 문자열

const sql = AuroraDSQLPostgres(
  'postgres://admin@your-cluster.dsql.us-east-1.on.aws'
);

const result = await sql`SELECT current_timestamp`;

고급 구성

import { fromNodeProviderChain } from '@aws-sdk/credential-providers';

const sql = AuroraDSQLPostgres({
  host: 'your-cluster.dsql.us-east-1.on.aws',
  database: 'postgres',
  username: 'admin',
  customCredentialsProvider: fromNodeProviderChain(), // Optionally provide custom credentials provider
  tokenDurationSecs: 3600,                            // Token expiration (seconds)
  
  // Standard Postgres.js options
  max: 20,                              // Connection pool size
  ssl: { rejectUnauthorized: false }    // SSL configuration
});

구성 옵션

모든 표준 Postgres.js 옵션도 지원됩니다.

Authentication

커넥터는 DSQL 클라이언트 토큰 생성기를 사용하여 토큰을 생성하여 DSQL 인증을 자동으로 처리합니다. AWS 리전이 제공되지 않으면 제공된 호스트 이름에서 자동으로 구문 분석됩니다.

Aurora DSQL의 인증에 대한 자세한 내용은 사용 설명서를 참조하세요.

관리자 및 일반 사용자

샘플 사용

Postgres.js용 Aurora DSQL 커넥터를 사용하는 JavaScript 예제는 GitHub에서 확인할 수 있습니다. 예제 실행 방법에 대한 자세한 내용은 예제 디렉터리를 참조하세요.