Postgres 노드#

Postgres 노드를 사용하여 Postgres에서 작업을 자동화하고 Postgres를 다른 애플리케이션과 통합하세요. n8n은 쿼리 실행, 데이터베이스의 행 삽입 및 업데이트를 포함하여 다양한 Postgres 기능에 대한 기본 지원을 제공합니다.

이 페이지에서는 Postgres 노드가 지원하는 작업 목록과 추가 리소스에 대한 링크를 찾을 수 있습니다.

자격 증명

인증 설정에 대한 안내는 Postgres 자격 증명을 참조하세요.

작업#

삭제: 전체 테이블 또는 테이블의 행 삭제
쿼리 실행: SQL 쿼리 실행
삽입: 테이블에 행 삽입
삽입 또는 업데이트: 테이블에 행 삽입 또는 업데이트
선택: 테이블에서 행 선택
업데이트: 테이블의 행 업데이트

삭제#

이 작업을 사용하여 전체 테이블 또는 테이블의 행을 삭제합니다.

다음 매개변수를 입력하세요:

연결할 자격 증명: 기존 Postgres 자격 증명을 만들거나 선택합니다.
작업: 삭제를 선택합니다.
스키마: 작업하려는 테이블이 포함된 스키마를 선택합니다. 드롭다운 목록에서 선택하려면 목록에서 선택을 선택하거나 스키마 이름을 입력하려면 이름으로를 선택합니다.
테이블: 작업하려는 테이블을 선택합니다. 드롭다운 목록에서 선택하려면 목록에서 선택을 선택하거나 테이블 이름을 입력하려면 이름으로를 선택합니다.
명령: 수행할 삭제 작업:
- 트렁케이트: 테이블의 데이터를 제거하지만 테이블의 구조는 유지합니다.
  - 시퀀스 재시작: 트렁케이트 프로세스의 일환으로 자동 증가 열을 초기 값으로 재설정할지 여부.
- 삭제: "선택 행" 조건과 일치하는 행을 삭제합니다. 아무것도 선택하지 않으면 Postgres는 모든 행을 삭제합니다.
  - 선택 행: 일치할 행을 정의하기 위해 열, 연산자 및 값을 정의합니다.
  - 조건 결합: "선택 행"의 조건을 결합하는 방법. AND는 모든 조건이 참이어야 하며, OR는 하나의 조건 이상이 참이어야 합니다.
- 드롭: 테이블의 데이터와 구조를 영구적으로 삭제합니다.

삭제 옵션#

캐스케이드: 뷰 및 시퀀스와 같이 테이블에 종속된 모든 객체를 드롭할지 여부. 트렁케이트 또는 드롭 명령을 사용하는 경우 사용할 수 있습니다.
연결 타임아웃: 데이터베이스에 연결하기 위해 시도할 초 수.
유휴 연결 닫기 지연: 유휴 연결이 닫기 적격으로 간주되기 전에 기다릴 초 수.
쿼리 일괄 처리: 데이터베이스에 쿼리를 전송하는 방법:
- 단일 쿼리: 모든 수신 항목에 대한 단일 쿼리.
- 독립적으로: 실행의 수신 항목당 하나의 쿼리를 실행합니다.
- 트랜잭션: 모든 쿼리를 트랜잭션으로 실행합니다. 실패가 발생하면 Postgres는 모든 변경 사항을 롤백합니다.
대형 숫자 출력 형식: NUMERIC 및 BIGINT 열을 출력할 형식:
- 숫자: 표준 숫자에 사용합니다.
- 텍스트: 16자 이상의 숫자를 예상하는 경우 사용합니다. 이를 사용하지 않으면 숫자가 잘못될 수 있습니다.

쿼리 실행#

이 작업을 사용하여 SQL 쿼리를 실행합니다.

다음 매개변수를 입력하세요:

연결할 자격 증명: 기존 Postgres 자격 증명을 생성하거나 선택합니다.
작업: 쿼리 실행을 선택합니다.
쿼리: 실행할 SQL 쿼리입니다. n8n 표현식 및 $1, $2, $3와 같은 토큰을 사용하여 준비된 문을 빌드하고 쿼리 매개변수와 함께 사용합니다.

쿼리 실행 옵션#

연결 시간 초과: 데이터베이스에 연결하기 위해 시도할 초 수입니다.
유휴 연결 닫기 지연: 유휴 연결을 닫기 위한 자격을 고려하기 전에 대기할 초 수입니다.
쿼리 배치: 데이터베이스에 쿼리를 전송하는 방법입니다:
- 단일 쿼리: 모든 수신 항목에 대해 단일 쿼리입니다.
- 독립적으로: 실행의 각 수신 항목에 대해 하나의 쿼리를 실행합니다.
- 트랜잭션: 모든 쿼리를 트랜잭션으로 실행합니다. 실패가 발생하면 Postgres는 모든 변경 사항을 롤백합니다.
쿼리 매개변수: 쿼리 매개변수로 사용할 값의 쉼표로 구분된 목록입니다.
대형 숫자 출력을: NUMERIC 및 BIGINT 열을 출력할 형식입니다:
- 숫자: 표준 숫자에 사용합니다.
- 텍스트: 16자리 이상의 숫자를 예상하는 경우 사용합니다. 이를 사용하지 않으면 숫자가 부정확할 수 있습니다.
빈 문자열을 NULL로 교체: 입력에서 빈 문자열을 NULL로 교체할지 여부입니다. 이는 스프레드시트 소프트웨어에서 내보낸 데이터 작업 시 유용할 수 있습니다.

삽입#

이 작업을 사용하여 테이블에 행을 삽입합니다.

다음 매개변수를 입력하세요:

연결할 자격 증명: 기존 Postgres 자격 증명을 생성하거나 선택합니다.
작업: 삽입을 선택합니다.
스키마: 작업할 테이블이 있는 스키마를 선택합니다. 드롭다운 목록에서 스키마를 선택하려면 목록에서 선택을 선택하거나 스키마 이름을 입력하려면 이름으로를 선택합니다.
테이블: 작업할 테이블을 선택합니다. 드롭다운 목록에서 테이블을 선택하려면 목록에서 선택을 선택하거나 테이블 이름을 입력하려면 이름으로를 선택합니다.
열 매핑 모드: 열 이름을 수신 데이터에 매핑하는 방법:
- 각 열을 수동으로 매핑: 각 열에 사용할 값을 선택합니다.
- 자동으로 매핑: 수신 데이터를 Postgres의 일치하는 열 이름에 자동으로 매핑합니다. 이를 위해서는 수신 데이터 필드 이름이 Postgres의 열 이름과 일치해야 합니다. 필요한 경우 이 노드 이전에 필드 편집(설정) 노드를 사용하여 형식을 조정하십시오.

삽입 옵션#

연결 시간 초과: 데이터베이스에 연결하기 위해 시도할 초 수입니다.
유휴 연결 닫기 지연: 유휴 연결을 닫기 위한 자격을 고려하기 전에 대기할 초 수입니다.
쿼리 배치: 데이터베이스에 쿼리를 전송하는 방법입니다:
- 단일 쿼리: 모든 수신 항목에 대해 단일 쿼리입니다.
- 독립적으로: 실행의 각 수신 항목에 대해 하나의 쿼리를 실행합니다.
- 트랜잭션: 모든 쿼리를 트랜잭션으로 실행합니다. 실패가 발생하면 Postgres는 모든 변경 사항을 롤백합니다.
출력 열: 출력할 열을 선택합니다. 사용 가능한 열 목록에서 선택하거나 표현식을 사용하여 ID를 지정할 수 있습니다.
대형 숫자 출력을: NUMERIC 및 BIGINT 열을 출력할 형식입니다:
- 숫자: 표준 숫자에 사용합니다.
- 텍스트: 16자리 이상의 숫자를 예상하는 경우 사용합니다. 이를 사용하지 않으면 숫자가 부정확할 수 있습니다.
충돌 시 건너뛰기: 삽입이 고유 또는 배제 제약 조건을 위반하는 경우 오류를 발생시키는 대신 행을 건너뛸지 여부입니다.
빈 문자열을 NULL로 교체: 입력에서 빈 문자열을 NULL로 교체할지 여부입니다. 이는 스프레드시트 소프트웨어에서 내보낸 데이터 작업 시 유용할 수 있습니다.

삽입 또는 업데이트#

이 작업을 사용하여 테이블에 행을 삽입하거나 업데이트합니다.

다음 매개변수를 입력하십시오:

연결할 자격 증명: 기존 Postgres 자격 증명을 생성하거나 선택합니다.
작업: 삽입 또는 업데이트를 선택합니다.
스키마: 작업할 테이블이 포함된 스키마를 선택합니다. 드롭다운 목록에서 스키마를 선택하려면 목록에서 선택을 선택하거나 스키마 이름을 입력하려면 이름으로를 선택합니다.
테이블: 작업할 테이블을 선택합니다. 드롭다운 목록에서 테이블을 선택하려면 목록에서 선택을 선택하거나 테이블 이름을 입력하려면 이름으로를 선택합니다.
열 매핑 모드: 열 이름을 수신 데이터에 매핑하는 방법:
- 각 열을 수동으로 매핑: 각 열에 대해 사용할 값을 선택합니다.
- 자동 매핑: 수신 데이터를 Postgres의 일치하는 열 이름에 자동으로 매핑합니다. 이 작업이 진행되려면 수신 데이터 필드 이름이 Postgres의 열 이름과 일치해야 합니다. 필요하다면 이 노드 이전에 필드 편집(설정) 노드를 사용하여 형식을 조정하는 것을 고려하세요.

삽입 또는 업데이트 옵션#

연결 시간 초과: 데이터베이스에 연결을 시도하는 초 수입니다.
유휴 연결 닫기 지연: 유휴 연결을 닫기에 적합하다고 고려하기 전에 대기할 초 수입니다.
쿼리 배치: 데이터베이스에 쿼리를 보내는 방법:
- 단일 쿼리: 모든 수신 항목에 대한 단일 쿼리.
- 독립적으로: 실행의 각 수신 항목에 대해 하나의 쿼리를 실행합니다.
- 트랜잭션: 트랜잭션 내에서 모든 쿼리를 실행합니다. 실패가 발생하면 Postgres는 모든 변경 사항을 롤백합니다.
출력 열: 출력할 열을 선택합니다. 사용 가능한 열 목록에서 선택하거나 표현식을 사용하여 ID를 지정할 수 있습니다.
큰 숫자 출력 형식: NUMERIC 및 BIGINT 열을 출력하는 형식:
- 숫자: 표준 숫자에 사용할 수 있습니다.
- 텍스트: 16자리 이상의 숫자를 예상하는 경우 사용합니다. 이 형식을 사용하지 않으면 숫자가 부정확할 수 있습니다.
빈 문자열을 NULL로 교체: 입력에서 빈 문자열을 NULL로 교체할지 여부입니다. 이는 스프레드시트 소프트웨어에서 내보낸 데이터로 작업할 때 유용할 수 있습니다.

선택#

이 작업을 사용하여 테이블에서 행을 선택합니다.

다음 매개변수를 입력하십시오:

연결할 자격 증명: 기존 Postgres 자격 증명을 생성하거나 선택합니다.
작업: 선택을 선택합니다.
스키마: 작업할 테이블이 포함된 스키마를 선택합니다. 드롭다운 목록에서 스키마를 선택하려면 목록에서 선택을 선택하거나 스키마 이름을 입력하려면 이름으로를 선택합니다.
모든 결과 반환: 모든 결과를 반환할지 아니면 지정된 한도까지 반환할지를 선택합니다.
한도: 모든 결과 반환이 비활성화된 경우 반환할 최대 항목 수입니다.
행 선택: 행을 선택하기 위한 조건을 설정합니다. 열, 연산자 및 조건에 맞는 값을 정의합니다. 아무것도 선택하지 않으면 Postgres는 모든 행을 선택합니다.
조건 결합: 행 선택에서 조건을 결합하는 방법입니다. AND는 모든 조건이 참이어야 하며, OR는 최소한 하나의 조건이 참이어야 합니다.
정렬: 선택한 행을 정렬하는 방법을 선택합니다. 목록에서 또는 ID로 열을 선택하고 정렬 방향을 선택합니다.

옵션 선택#

연결 시간 초과: 데이터베이스에 연결 시도하는 초 수입니다.
유휴 연결 닫기 지연: 유휴 연결을 닫을 수 있다고 간주하기 전에 대기할 초 수입니다.
쿼리 배치: 데이터베이스에 쿼리를 보내는 방법:
- 단일 쿼리: 모든 들어오는 항목에 대한 단일 쿼리입니다.
- 독립적으로: 실행의 각 들어오는 항목에 대해 하나의 쿼리를 실행합니다.
- 트랜잭션: 모든 쿼리를 트랜잭션으로 실행합니다. 오류가 발생하면 Postgres가 모든 변경사항을 롤백합니다.
출력 열: 출력할 열을 선택합니다. 사용 가능한 열 목록에서 선택하거나 식를 사용하여 ID를 지정할 수 있습니다.
대형 형식 숫자 출력: NUMERIC 및 BIGINT 열을 출력할 형식입니다:
- 숫자: 표준 숫자에 사용합니다.
- 텍스트: 16자리 이상의 숫자를 예상할 경우 사용합니다. 이 옵션 없이 숫자가 부정확할 수 있습니다.

업데이트#

이 작업을 사용하여 테이블의 행을 업데이트합니다.

다음 매개변수를 입력하세요:

연결할 자격 증명: 기존 Postgres 자격 증명을 생성하거나 선택합니다.
작업: 업데이트를 선택합니다.
스키마: 작업할 테이블이 포함된 스키마를 선택합니다. 드롭다운 목록에서 스키마를 선택하기 위해 목록에서를 선택하거나 스키마 이름을 입력하기 위해 이름으로를 선택합니다.
테이블: 작업할 테이블을 선택합니다. 드롭다운 목록에서 테이블을 선택하기 위해 목록에서를 선택하거나 테이블 이름을 입력하기 위해 이름으로를 선택합니다.
열 매핑 모드: 열 이름을 들어오는 데이터에 매핑하는 방법:
- 각 열을 수동으로 매핑: 각 열에 사용할 값을 선택합니다.
- 자동으로 매핑: 들어오는 데이터를 Postgres의 일치하는 열 이름에 자동으로 매핑합니다. 이 작업이 작동하려면 들어오는 데이터 필드 이름이 Postgres의 열 이름과 일치해야 합니다. 필요한 경우 이 노드 전에 필드 편집(설정) 노드를 사용하여 형식을 조정하는 것을 고려하십시오.

업데이트 옵션#

연결 시간 초과: 데이터베이스에 연결 시도하는 초 수입니다.
유휴 연결 닫기 지연: 유휴 연결을 닫을 수 있다고 간주하기 전에 대기할 초 수입니다.
쿼리 배치: 데이터베이스에 쿼리를 보내는 방법:
- 단일 쿼리: 모든 들어오는 항목에 대한 단일 쿼리입니다.
- 독립적으로: 실행의 각 들어오는 항목에 대해 하나의 쿼리를 실행합니다.
- 트랜잭션: 모든 쿼리를 트랜잭션으로 실행합니다. 오류가 발생하면 Postgres가 모든 변경사항을 롤백합니다.
출력 열: 출력할 열을 선택합니다. 사용 가능한 열 목록에서 선택하거나 식을 사용하여 ID를 지정할 수 있습니다.
대형 형식 숫자 출력: NUMERIC 및 BIGINT 열을 출력할 형식입니다:
- 숫자: 표준 숫자에 사용합니다.
- 텍스트: 16자리 이상의 숫자를 예상할 경우 사용합니다. 이 옵션 없이 숫자가 부정확할 수 있습니다.
빈 문자열을 NULL로 교체: 입력에서 빈 문자열을 NULL로 교체할지 여부입니다. 이는 스프레드시트 소프트웨어에서 내보낸 데이터를 처리할 때 유용할 수 있습니다.

템플릿 및 예제#

쿼리 매개변수 사용#

Postgres 데이터베이스에서 실행할 쿼리를 작성할 때, 옵션 섹션의 쿼리 매개변수 필드를 사용하여 쿼리에 데이터를 로드할 수 있습니다. n8n은 쿼리 매개변수의 데이터를 정화하여 SQL 주입을 방지합니다.

예를 들어, 이메일 주소로 사람을 찾고 싶다고 가정해 보겠습니다. 다음 입력 데이터를 고려하십시오:

[  
    {  
        "email": "alex@example.com",  
        "name": "Alex",  
        "age": 21    
    },  
    {  
        "email": "jamie@example.com",  
        "name": "Jamie",  
        "age": 33    
    }  
]  

다음과 같은 쿼리를 작성할 수 있습니다:

SELECT * FROM $1:name WHERE email = $2;  

그런 다음 쿼리 매개변수에서 사용할 필드 값을 제공하십시오. 고정된 값이나 표현식을 제공할 수 있습니다. 이 예에서는 표현식을 사용하여 노드가 각 입력 항목에서 이메일 주소를 순차적으로 가져올 수 있도록 합니다:

// users는 예시 테이블 이름입니다  
users, {{ $json.email }}  

일반적인 문제#

일반적인 질문이나 문제 및 제안된 솔루션에 대해서는 일반적인 문제를 참조하십시오.

n8n 공식 기술 문서 한글판 by 인포그랩

Postgres 노드#

작업#

삭제#

삭제 옵션#

쿼리 실행#

쿼리 실행 옵션#

삽입#

삽입 옵션#

삽입 또는 업데이트#

삽입 또는 업데이트 옵션#

선택#

옵션 선택#

업데이트#

업데이트 옵션#

템플릿 및 예제#

관련 리소스#

쿼리 매개변수 사용#

일반적인 문제#