ee-database 동기화 클라이언트

클라이언트는 작업이 아니라 상태를 가져옵니다. 각 델타는 변경된 엔터티의 현재 행 전체를 멱등 INSERT … ON CONFLICT … DO UPDATE 형태로 담고 있으므로, 배치를 놓치더라도 대상이 수렴합니다.

동기화 클라이언트를 사용하는 이유는?

스키마 데이터베이스는 n8n, Make.com, MCP, 원시 웹훅 또는 REST 델타 피드 등 여러 방식으로 사용할 수 있습니다. 동기화 클라이언트는 완전 자동화된 경로로, 구축할 것도 유출될 것도 가장 적습니다.

빠른 시작

먼저 스키마에 데이터베이스를 등록한 다음, 클라이언트를 페어링하여 데이터베이스 옆에서 실행하세요.

1. 1

   데이터베이스 등록

   Databases 페이지에서 미러링하려는 스키마에 데이터베이스를 등록하고 데이터베이스 키를 검토하세요. 전체 모델은 Databases를 참고하세요. 이 단계에서 클라이언트가 적용할 대상 방언을 선언합니다.

2. 2

   클라이언트 설치

   Releases에서 서명된 바이너리를 다운로드하거나 소스에서 빌드하세요(Go ≥ 1.23).

   go build -o ee-database .

   소스와 서명된 릴리스는 TOT-Concept/ee-database(MIT)에 있습니다.

3. 3

   브라우저로 페어링하기

   ee-database pair를 실행하세요. /database/connect에서 짧은 코드와 함께 브라우저 탭이 열립니다. 코드를 확인하고, 이 클라이언트가 동기화할 데이터베이스를 선택하세요.

   ee-database pair --server https://entityenricher.ai
   
   Open this URL in your browser to confirm pairing:
      https://entityenricher.ai/database/connect?code=7QX-KP2
   
     Code: 7QX-KP2
   
   Waiting for confirmation...

   토큰을 선호하시나요? Databases 페이지(Sync client → Pair a client)에서 발급한 후 직접 전달하세요: ee-database pair --server … <refresh-token>.

4. 4

   데이터베이스 옆에서 실행하세요

   첫 실행 시 클라이언트는 .sql 스냅샷을 가져와 적용한 다음, 연결하여 델타를 스트리밍합니다. --save-dsn은 연결 문자열을 로컬에 저장하므로 이후 실행에는 인수가 필요 없습니다.

   ee-database run --dsn "postgres://user:pass@localhost:5432/mydb" --save-dsn

   “Next to”는 데이터베이스 서버 위가 아니라 네트워크상 인접함을 의미합니다: DSN에 접근할 수 있는 모든 머신이나 컨테이너가 동작하며 — 보통 TLS를 강제하는 클라우드 관리형 PostgreSQL(Azure, OVHcloud, AWS RDS…)도 포함됩니다: …/mydb?sslmode=require.

전달 방식: 리스와 ack

델타는 데이터베이스별 엄격한 FIFO 아웃박스를 통해 Entity Enricher를 떠납니다. 서버는 보이는 윈도우를 120초 동안 리스하여 하나의 배치로 푸시하고, 클라이언트는 배치 전체를 단일 트랜잭션으로 적용한 뒤 ack 로 응답하며, 이는 커서를 진행시키고 다음 윈도우를 즉시 트리거합니다. 배치 도중 종료된 클라이언트는 리스 만료와 서버 측 재푸시로 보호되므로, 손실되거나 이중 커밋되는 것은 없습니다.

데이터베이스와 방언(dialect)

대상 방언은 Entity Enricher의 스키마 데이터베이스 등록으로 고정됩니다. 클라이언트는 서버가 렌더링하는 SQL을 그대로 적용합니다. PostgreSQL이 출시 방언이며, MySQL 및 SQLite 드라이버는 해당 SQL 렌더러가 출시될 때를 대비해 이미 번들되어 있습니다. 다중 문장 적용은 드라이버별로 처리됩니다(pgx 단순 프로토콜, MySQL multiStatements, CGO 없는 SQLite).

보안

CLI 참조

자격 증명은 페어링된 데이터베이스마다 하나의 프로필로 ~/.config/ee-database/profiles/ 아래에 mode-600으로 저장됩니다. 데이터베이스당 한 번 페어링하며, 여러 개가 페어링된 경우 --database NAME으로 하나를 선택합니다. 자동화를 전혀 원하지 않으십니까? 동일한 피드는 일반 REST로도 제공됩니다: GET /api/databases//changes 후 POST /api/databases//ack — 데이터베이스를 참조하세요.

오픈 소스