node-postgres - GitLite

KO | EN

gitlite — search

#react #go #android #machine-learning #deep-learning #nodejs #macos #java #windows #cli #awesome-list #vue #pytorch #openai

node-postgres

(★ 13,193)

node.js용 PostgreSQL 클라이언트.

파일 탐색기

최종 버전 다운로드 (.zip)

- devcontainer.json
- docker-compose.yml
- Dockerfile
- - ci.yml
- CODEOWNERS
- dependabot.yaml
- FUNDING.yml
- - alert.tsx
  - info.tsx
  - logo.tsx
- - _app.js
  - _meta.js
  - announcements.mdx
  - index.mdx
- - favicon.ico
- .gitignore
- next.config.js
- package.json
- README.md
- theme.config.js
- yarn.lock
- - bench-pipelining.js
  - bench.js
  - Makefile
  - package.json
  - README.md
- - esbuild-cloudflare.config.mjs
  - esbuild-empty.config.mjs
  - package.json
  - rollup-cloudflare.config.mjs
  - rollup-empty.config.mjs
  - vite-cloudflare.config.mjs
  - vite-empty.config.mjs
  - webpack-cloudflare.config.mjs
  - webpack-empty.config.mjs
- - package.json
  - README.md
  - tsconfig.json
- - .coveralls.yml
  - .gitignore
  - .mocharc.json
  - index.d.ts
  - index.js
  - LICENSE
  - package.json
  - README.md
  - tsconfig.json
- - index.js
  - package.json
  - README.md
- - common-js-imports.test.cjs
  - package.json
  - pg-cloudflare.test.js
  - pg-connection-string.test.js
  - pg-cursor.test.js
  - pg-native.test.js
  - pg-pool.test.js
  - pg-protocol.test.js
  - pg-query-stream.test.js
  - pg.test.js
  - README.md
- - index.js
  - package.json
  - README.md
- - index.js
  - LICENSE
  - package.json
  - README.md
- - package.json
  - README.md
  - tsconfig.json
- - LICENSE
  - package.json
  - README.md
  - tsconfig.json
.gitattributes
.gitignore
.yarnrc
CHANGELOG.md
eslint.config.mjs
lerna.json
LICENSE
LOCAL_DEV.md
package.json
README.md
SPONSORS.md
tea.yaml
tsconfig.json
yarn.lock

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/brianc/node-postgres

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd node-postgres

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install pg

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

cd packages/pg

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# node-postgres
![Build Status](https://github.com/brianc/node-postgres/actions/workflows/ci.yml/badge.svg)
[![NPM version](https://img.shields.io/npm/v/pg.svg)](https://npmjs.org/package/pg "View this project on NPM")
[![NPM downloads](https://img.shields.io/npm/dm/pg.svg)](https://npmjs.org/package/pg "View this project on NPM")
Node.js(및 bun, deno, cloudflare 등)를 위한 논블로킹 PostgreSQL 클라이언트입니다. 순수 자바스크립트로 구현되어 있으며 선택적으로 네이티브 libpq 바인딩을 지원합니다.
## 모노레포
이 저장소는 코어 [pg](https://github.com/brianc/node-postgres/tree/master/packages/pg) 모듈과 소수의 관련 모듈들을 포함하는 모노레포입니다.
- [pg](https://github.com/brianc/node-postgres/tree/master/packages/pg)
- [pg-pool](https://github.com/brianc/node-postgres/tree/master/packages/pg-pool)
- [pg-native](https://github.com/brianc/node-postgres/tree/master/packages/pg-native)
- [pg-cursor](https://github.com/brianc/node-postgres/tree/master/packages/pg-cursor)
- [pg-query-stream](https://github.com/brianc/node-postgres/tree/master/packages/pg-query-stream)
- [pg-connection-string](https://github.com/brianc/node-postgres/tree/master/packages/pg-connection-string)
- [pg-protocol](https://github.com/brianc/node-postgres/tree/master/packages/pg-protocol)
## 설치
```
npm install pg
```
## 문서
이 저장소의 각 패키지에는 개발 및 기여 방법에 초점을 맞춘 자체 리드미(README)가 있습니다. 프로젝트 전체 문서 및 이 저장소에서 관리하는 관련 모듈에 대해서는 다음을 참조하세요.
### :star: [Documentation](https://node-postgres.com) :star:
문서의 소스 저장소는 [여기](https://github.com/brianc/node-postgres/tree/master/docs)에서 기여할 수 있습니다.
### 특징
- [Node.js를 위한 가장 빠른 PostgreSQL 클라이언트](https://github.com/nigrosimone/postgres-benchmarks)
- 순수 자바스크립트 클라이언트와 네이티브 libpq 바인딩이 \_동일한 API\_를 공유
- 커넥션 풀링
- 확장 가능한 JS ↔ PostgreSQL 데이터 타입 변환
- 지원되는 PostgreSQL 기능
- 매개변수화된 쿼리
- 쿼리 플랜 캐싱이 포함된 이름 지정된 구문(Named statements)
- `LISTEN/NOTIFY`를 이용한 비동기 알림
- `COPY TO/COPY FROM`을 이용한 대량 가져오기 및 내보내기
### 추가 기능
node-postgres는 설계상 추상화 계층이 매우 얇습니다. 다음은 수년간 완성도를 높이기 위해 사용해 온 유용한 모듈들입니다.
전체 목록은 [위키](https://github.com/brianc/node-postgres/wiki/Extras)에서 확인할 수 있습니다.
## 지원
node-postgres는 자유 소프트웨어입니다. 라이브러리와 관련하여 버그가 발생하면 [GitHub 저장소](https://github.com/brianc/node-postgres)에 이슈를 열어주세요. 문서에서 답변을 찾지 못한 질문이 있다면 문서의 어떤 부분이 불분명한지 지적하는 이슈를 남겨주세요. 더 나은 문서를 만들기 위해 최선을 다하겠습니다!
이슈를 열 때는 다음 정보를 제공해 주세요.
- Node 버전
- Postgres 버전
- 문제를 재현할 수 있는 가장 짧은 코드 조각
node-postgres 관련 내용이 거의 대부분인 소식을 받아보고 싶으시다면 bluesky에서 [@brianc](https://bsky.app/profile/brianc.bsky.social)를 팔로우하실 수도 있습니다. 예전 트위터/X 계정은 더 이상 사용하지 않습니다.
## 후원 :two\_hearts:
node-postgres의 지속적인 개발은 [커뮤니티](https://github.com/brianc/node-postgres/blob/master/SPONSORS.md)의 관대한 재정적 지원 덕분에 부분적으로 가능해졌습니다.
귀하 또는 귀하의 회사가 node-postgres로부터 혜택을 받고 있고 프로젝트의 재정적 지속 가능성을 돕고 싶으시다면 개발 [후원을 고려해 주세요](https://github.com/sponsors/brianc).
### 주요 후원자
node-postgres에 대한 관대하고 세심한 지원을 보내주신 [medplum](https://medplum.com)에 특별한 감사를 드립니다!
![Medplum logo](https://github.com/medplum/medplum-logo/blob/main/v3/medplum-logo-grape8.svg)
## 기여하기
\*\*:heart: 기여를 환영합니다!\*\*
다음 조건을 만족하는 풀 리퀘스트라면 \*\*기꺼이\*\* 수락하겠습니다.
- \*\*테스트가 포함된 경우\*\*
- 합리적으로 보이는 경우
- 하위 호환성을 깨지 않는 경우
변경 사항에 하위 호환성을 깨는 내용이 포함되어 있다면 반드시 그 점을 명시해 주세요.

풀 request에 남겨주시면 언제, 어떻게 배포할지, 그리고 어떤 유형의 문서화나 커뮤니케이션이 필요한지 함께 논의하고 계획할 수 있습니다.

### 로컬 개발 환경 설정
1. 저장소(repo)를 클론합니다.
2. 시스템에 `libpq-dev`가 설치되어 있는지 확인합니다(테스트 과정에서 네이티브 바인딩이 빌드됩니다).
3. 워크스페이스 루트에서 `yarn`을 실행한 다음 `yarn lerna bootstrap`을 실행합니다.
4. SSL이 활성화되어 있고 테스트를 위한 빈 데이터베이스가 포함된 PostgreSQL 인스턴스가 실행 중인지 확인하세요. \_참고: SSL 관련 코드를 변경하지 않는 경우 환경 변수 `PGTESTNOSSL=1`을 설정하여 SSL이 필요한 테스트를 건너뛸 수 있습니다.\_
5. postgres 인스턴스에 연결하기 위한 올바른 환경 변수가 설정되어 있는지 확인하세요. `PGUSER` 및 `PGPASSWORD` 등 표준 `PG\*` 환경 변수를 사용합니다...
6. 모든 테스트를 실행하려면 `yarn test`를 실행합니다.

## 문제 해결 및 FAQ
일반적인 오류의 원인과 해결 방법은 [Frequently Asked Questions (FAQ)](https://github.com/brianc/node-postgres/wiki/FAQ)에서 확인할 수 있습니다.

## 라이선스
Copyright (c) 2010-2020 Brian Carlson (brian.m.carlson@gmail.com)

본 소프트웨어 및 관련 문서 파일("소프트웨어")의 복사본을 취득하는 모든 사람에게 제한 없이 소프트웨어를 사용, 복사, 수정, 병합, 배포, 서브라이선스, 판매할 수 있는 권리를 포함하여 소프트웨어의 사본을 제공하는 권리가 무료로 부여되며, 이는 다음 조건에 따라 제공됩니다:

위의 저작권 고지와 이 허가 고지는 소프트웨어의 모든 사본 또는 중요한 부분에 포함되어야 합니다.

본 소프트웨어는 어떠한 종류의 보증도 없이 "있는 그대로" 제공되며, 상품성, 특정 목적에의 적합성, 비침해에 대한 보증을 포함하되 이에 국한되지 않습니다. 어떠한 경우에도 작성자나 저작권자는 계약, 불법행위 또는 기타 사유로 인해 소프트웨어와 관련하여 또는 소프트웨어의 사용이나 기타 거래로 인해 발생하는 청구, 손해 또는 기타 책임에 대해 어떠한 책임도 지지 않습니다.