Data Table 노드 행(row) 작업
n8n v2.29행 작업을 사용하여 데이터 테이블에서 행을 삭제, 가져오기, 삽입, 업데이트, upsert 하거나 필터링합니다. 이 작업을 사용하여 정의된 조건에 따라 데이터 테이블에서 하나 이상의 행을 삭제합니다. 이 옵션들을 사용하여 작업 동작을 더 세밀하게 조정합니다:
행 작업을 사용하여 데이터 테이블에서 행을 삭제, 가져오기, 삽입, 업데이트, upsert 하거나 필터링합니다. 노드 자체에 대한 자세한 내용은 Data Table 노드 문서를 참고하세요.
행 삭제#
이 작업을 사용하여 정의된 조건에 따라 데이터 테이블에서 하나 이상의 행을 삭제합니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: Delete를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다
- Must Match: 다음 단계에서 정의된 Any Condition(조건 중 하나) 또는 All Conditions(모든 조건)에 일치하는 행을 삭제할지 선택합니다.
- Conditions: Add Condition을 클릭하여 데이터 테이블에서 작업할 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
행 삭제 옵션#
이 옵션들을 사용하여 작업 동작을 더 세밀하게 조정합니다:
- Dry Run: 테이블을 수정하지 않고 삭제를 시뮬레이션하려면 활성화합니다. 노드는 작업 전후 상태를 포함하여 삭제될 행을 반환합니다.
행 가져오기#
이 작업을 사용하여 정의된 조건에 따라 데이터 테이블에서 하나 이상의 행을 가져옵니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: Get을 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다
- Must Match: 다음 단계에서 정의된 Any Condition 또는 All Conditions에 일치하는 행을 가져올지 선택합니다.
- Conditions: Add Condition을 클릭하여 데이터 테이블에서 작업할 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
- Return All: 일치하는 모든 행을 반환하려면 활성화합니다. 또는 비활성화하고 반환할 행 수에 대한 Limit을 입력합니다(예:
50). - Order By: 결과를 정렬할 칼럼과 방향(오름차순 또는 내림차순)을 정의하려면 활성화합니다. 또는 비활성화하여 결과를 정렬하지 않습니다.
행 존재 여부 확인(If row exists)#
이 작업을 사용하여 정의된 조건에 일치하는 행이 데이터 테이블에 존재하는지 확인합니다. 일치하는 행이 발견되면 노드는 받은 입력 항목을 변경 없이 그대로 출력합니다. 일치하는 행이 없으면 아무것도 출력하지 않습니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: If Row Exists를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다
- Must Match: 행이 다음 단계에서 정의된 Any Condition 또는 All Conditions에 일치해야 하는지 선택합니다.
- Conditions: Add Condition을 클릭하여 작업할 데이터 테이블 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
행 미존재 확인(If row does not exist)#
이 작업을 사용하여 정의된 조건에 일치하는 행이 데이터 테이블에 존재하지 않는지 확인합니다. 일치하는 행이 발견되지 않으면 노드는 받은 입력 항목을 변경 없이 그대로 출력합니다. 일치하는 행이 존재하면 아무것도 출력하지 않습니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: If Row Does Not Exist를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다.
- Must Match: 행이 다음 단계에서 정의된 Any Condition 또는 All Conditions에 일치해야 하는지 선택합니다.
- Conditions: Add Condition을 클릭하여 작업할 데이터 테이블 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
행 삽입#
이 작업을 사용하여 데이터 테이블에 새 행을 삽입합니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: Insert를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다.
- Mapping Column Mode: 다음 중 하나를 선택합니다:
- Map Each Column Manually: 들어오는 데이터 필드를 어떤 칼럼에 매핑할지 명시적으로 선택합니다. 들어오는 데이터 필드 이름이 데이터 테이블 칼럼 이름과 일치하지 않는 경우에도 매핑할 수 있습니다. 매핑에서 특정 값을 삭제하도록 선택할 수 있습니다.
- Map Automatically: 노드가 이름을 기준으로 데이터 필드를 칼럼에 자동으로 매핑하도록 허용합니다. 매핑이 성공하려면 들어오는 데이터의 필드 이름이 데이터 테이블의 칼럼 이름과 정확히 일치해야 합니다. 모든 필드가 매핑됩니다.
행 삽입 옵션#
이 옵션들을 사용하여 작업 동작을 더 세밀하게 조정합니다:
- Optimize Bulk: 삽입된 데이터가 반환되지 않도록 하려면 활성화합니다. 이는 대량 삽입 성능을 최대 5배까지 향상시킵니다.
행 업데이트#
이 작업을 사용하여 정의된 조건에 따라 데이터 테이블에서 하나 이상의 행을 업데이트합니다.
다음 파라미터를 입력합니다:
- Resource: Row를 선택합니다.
- Operation: Update를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다.
- Must Match: 다음 단계에서 정의된 Any Condition 또는 All Conditions에 일치하는 행을 업데이트할지 선택합니다.
- Conditions: Add Condition을 클릭하여 작업할 데이터 테이블 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
- Mapping Column Mode: 다음 중 하나를 선택합니다:
- Map Each Column Manually: 들어오는 데이터 필드를 어떤 칼럼에 매핑할지 명시적으로 선택합니다. 들어오는 데이터 필드 이름이 데이터 테이블 칼럼 이름과 일치하지 않는 경우에도 매핑할 수 있습니다. 매핑에서 특정 값을 삭제하도록 선택할 수 있습니다.
- Map Auomatically: 노드가 이름을 기준으로 데이터 필드를 칼럼에 자동으로 매핑하도록 허용합니다. 매핑이 성공하려면 들어오는 데이터의 필드 이름이 데이터 테이블의 칼럼 이름과 정확히 일치해야 합니다. 모든 필드가 매핑됩니다.
행 업데이트 옵션#
이 옵션들을 사용하여 작업 동작을 더 세밀하게 조정합니다:
- Dry Run: 테이블을 수정하지 않고 업데이트를 시뮬레이션하려면 활성화합니다. 노드는 작업 전후 상태를 포함하여 업데이트될 행을 반환합니다.
Upsert 행#
이 작업을 사용하여 데이터 테이블에 upsert 합니다. 정의된 조건에 일치하는 행이 존재하면 제공된 값으로 업데이트됩니다. 일치하는 행이 없으면 새 행이 생성됩니다.
- Resource: Row를 선택합니다.
- Operation: Upsert를 선택합니다.
- Data table: 작업할 데이터 테이블을 식별하는 방법을 선택합니다:
- From list: 모든 데이터 테이블의 드롭다운 목록에서 테이블을 선택합니다.
- By Name: 데이터 테이블의 이름을 입력합니다.
- By ID: 데이터 테이블의 ID를 입력합니다.
- Must Match: 다음 단계에서 정의된 Any Condition 또는 All Conditions에 일치하는 행을 upsert 할지 선택합니다.
- Conditions: Add Condition을 클릭하여 작업할 데이터 테이블 행을 정의합니다. 여러 조건을 추가할 수 있습니다. 각 조건에 대해:
- Column: 비교할 칼럼을 선택합니다.
- Condition: 칼럼 값을 비교할 방법을 선택합니다: Equals, Not Equals, Greater Than, Greater Than or Equal, Less Than, Less Than or Equal, Is Empty, Is Not Empty.
- Value: 칼럼 값과 비교할 값을 입력합니다. 고정 값 또는 이전 노드의 데이터를 참조하는 표현식을 사용할 수 있습니다. 이 필드는 Is Empty 및 Is Not Empty 조건에서는 존재하지 않습니다.
- Mapping Column Mode: 다음 중 하나를 선택합니다:
- Map Each Column Manually: 들어오는 데이터 필드를 어떤 칼럼에 매핑할지 명시적으로 선택합니다. 들어오는 데이터 필드 이름이 데이터 테이블 칼럼 이름과 일치하지 않는 경우에도 매핑할 수 있습니다. 매핑에서 특정 값을 삭제하도록 선택할 수 있습니다.
- Map Auomatically: 노드가 이름을 기준으로 데이터 필드를 칼럼에 자동으로 매핑하도록 허용합니다. 매핑이 성공하려면 들어오는 데이터의 필드 이름이 데이터 테이블의 칼럼 이름과 정확히 일치해야 합니다. 모든 필드가 매핑됩니다.
Upsert 행 옵션#
이 옵션들을 사용하여 작업 동작을 더 세밀하게 조정합니다:
- Dry Run: 테이블을 수정하지 않고 upsert 작업을 시뮬레이션하려면 활성화합니다. 노드는 작업 전후 상태를 포함하여 영향을 받을 행을 반환합니다.