Requirements
- LangSmith 인스턴스가 네트워크로 액세스할 수 있는 프로비저닝된 PostgreSQL 데이터베이스. 다음과 같은 관리형 PostgreSQL 서비스를 사용하는 것을 권장합니다:
- 참고: PostgreSQL 버전 >= 14만 공식적으로 지원합니다.
- PostgreSQL 데이터베이스에 대한 관리자 액세스 권한이 있는 사용자. 이 사용자는 필요한 테이블, 인덱스 및 스키마를 생성하는 데 사용됩니다.
- 이 사용자는 데이터베이스에서 extension을 생성할 수 있는 권한도 필요합니다. btree_gin, btree_gist, pgcrypto, citext, ltree, pg_trgm extension을 사용하거나 설치를 시도합니다.
- public이 아닌 다른 스키마를 사용하는 경우, extension이 활성화된 다른 스키마가 없는지 확인하거나 검색 경로에 해당 스키마를 포함해야 합니다.
-
pgbouncer 및 기타 connection pooler에 대한 지원은 커뮤니티 기반입니다. 커뮤니티 멤버들은 pgbouncer가
pool_mode=session과 적절한ignore_startup_parameters설정(작성 시점 기준으로search_path와lock_timeout을 무시해야 함)으로 작동했다고 보고했습니다. connection pool을 오염시키지 않도록 주의가 필요하며, 어느 정도의 PostgreSQL 전문 지식이 권장됩니다. LangChain Inc는 현재 pgbouncer, amazon rds proxy 또는 기타 pooler에 대한 공식 테스트 커버리지나 상업적 지원에 대한 로드맵 계획이 없지만, 커뮤니티는 GitHub issue를 통해 지원에 대해 논의하고 협력할 수 있습니다. - 기본적으로 최소 2개의 vCPU와 8GB 메모리를 가진 인스턴스를 권장합니다. 하지만 실제 요구 사항은 워크로드와 사용자 수에 따라 달라집니다. PostgreSQL 인스턴스를 모니터링하고 필요에 따라 확장하는 것을 권장합니다.
Connection String
PostgreSQL 데이터베이스에 대한 connection string을 제공해야 합니다. 이 connection string에는 다음 정보가 포함되어야 합니다:- Host
- Port
- Database
- Username
- Password(특수 문자가 있는 경우 url encode해야 합니다)
- URL params
Configuration
connection string을 준비했다면 LangSmith 인스턴스가 외부 PostgreSQL 데이터베이스를 사용하도록 구성할 수 있습니다. LangSmith Helm Chart 설치의values 파일 또는 Docker 설치의 .env 파일을 수정하여 이를 수행할 수 있습니다.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.