SuitsDocs
레퍼런스노드 레퍼런스액션액션연동연동

Neon

Neon Serverless Postgres의 프로젝트, 브랜치, 데이터베이스, 엔드포인트, 역할을 관리하고 SQL 쿼리를 실행합니다.

개요

항목내용
카테고리연동
연동 필요Neon API Key
지원 리소스프로젝트, 브랜치, 데이터베이스, 엔드포인트, 역할, 작업 이력, SQL 쿼리

작업 종류

프로젝트

작업설명
프로젝트 목록모든 프로젝트 목록 조회
프로젝트 조회특정 프로젝트 상세 조회
프로젝트 생성새 프로젝트 생성 (이름, 리전 지정)
프로젝트 업데이트프로젝트 이름 변경
프로젝트 삭제프로젝트 삭제
연결 문자열 조회데이터베이스 연결 문자열(Connection String) 조회

브랜치

작업설명
브랜치 목록프로젝트의 브랜치 목록 조회
브랜치 조회특정 브랜치 상세 조회
브랜치 생성부모 브랜치에서 새 브랜치 분기
브랜치 업데이트브랜치 이름 변경 및 보호 설정
브랜치 삭제브랜치 삭제
기본 브랜치 설정기본 브랜치로 설정
브랜치 복원특정 시점으로 브랜치 복원 (Point-in-Time Recovery)
부모로 리셋부모 브랜치 상태로 리셋

데이터베이스

작업설명
데이터베이스 목록브랜치의 데이터베이스 목록 조회
데이터베이스 조회특정 데이터베이스 상세 조회
데이터베이스 생성새 데이터베이스 생성
데이터베이스 삭제데이터베이스 삭제

엔드포인트

작업설명
엔드포인트 목록프로젝트의 엔드포인트 목록 조회
엔드포인트 조회특정 엔드포인트 상세 조회
엔드포인트 생성새 엔드포인트 생성 (읽기/쓰기 또는 읽기 전용)
엔드포인트 업데이트커넥션 풀링, 타임아웃 등 설정 변경
엔드포인트 삭제엔드포인트 삭제
엔드포인트 시작일시정지된 엔드포인트 시작
엔드포인트 일시정지엔드포인트 일시정지
엔드포인트 재시작엔드포인트 재시작

역할

작업설명
역할 목록브랜치의 역할 목록 조회
역할 조회특정 역할 상세 조회
역할 생성새 역할 생성
역할 삭제역할 삭제
비밀번호 조회역할의 비밀번호 조회
비밀번호 재설정역할의 비밀번호 재설정

작업 이력

작업설명
작업 이력 목록프로젝트의 작업 이력 조회
작업 상세 조회특정 작업 상세 조회

SQL 쿼리

작업설명
SQL 쿼리 실행SQL 쿼리 실행 (파라미터 바인딩 지원, $1, $2 형식)
트랜잭션 실행여러 SQL을 트랜잭션 내에서 순차 실행 (격리 수준 설정 가능)

지원 리전

리전코드
서울aws-ap-northeast-2
도쿄aws-ap-northeast-1
싱가포르aws-ap-southeast-1
미국 동부aws-us-east-1
미국 동부 2aws-us-east-2
미국 서부aws-us-west-2
유럽 중부aws-eu-central-1
유럽 서부aws-eu-west-1
유럽 서부 2aws-eu-west-2

활용 예시

데이터 조회 후 데이터모델 동기화

트리거: 일정 (매 시간)
액션 1: Neon - SQL 쿼리 실행
├── 연결 문자열: postgresql://user:pass@host/db
├── SQL: SELECT * FROM orders WHERE created_at > $1
├── 파라미터: ["{{$now.minus(1, 'hour')}}"]
액션 2: 반복 (조회 결과)
액션 3: 행 생성 (주문 데이터모델)

개발 환경 자동 생성

트리거: 웹훅 (PR 생성 이벤트)
액션 1: Neon - 브랜치 생성
├── 프로젝트 ID: "project-abc123"
├── 브랜치 이름: {{trigger.body.branchName}}
액션 2: 슬랙 메시지
└── 메시지: "개발 DB 브랜치 생성 완료: {{actions.neon.branchName}}"

모범 사례

Neon API Key는 Neon 콘솔 > Settings > API Keys에서 생성할 수 있습니다. SQL 쿼리 실행 시에는 별도의 연결 문자열이 필요하며, 프로젝트 > Connection Details에서 확인할 수 있습니다.

SQL 파라미터 바인딩

SQL 인젝션 방지를 위해 반드시 파라미터 바인딩($1, $2)을 사용하세요.

에러 처리

API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요.