n8n 메타데이터

요약

Code node에서 Python을 사용할 수 있습니다. Python (Pyodide, deprecated)

n8n 메타데이터를 다루는 방법입니다.

여기에는 다음이 포함됩니다:

셀프 호스팅 n8n을 위한 n8n 환경 변수 접근.
워크플로, 실행, 노드에 대한 메타데이터.
인스턴스 Variables 및 External secrets에 대한 정보.

Note

Python 지원

Code node에서 Python을 사용할 수 있습니다. 표현식에서는 사용할 수 없습니다.

JavaScript

메서드	설명	Code node에서 사용 가능?
`$env`	n8n 인스턴스 구성 환경 변수를 포함합니다.	✅
`$execution.customData`	사용자 지정 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 Custom executions data를 참고하세요.	✅
`$execution.id`	현재 워크플로 실행의 고유 ID입니다.	✅
`$execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.	✅
`$execution.resumeUrl`	Wait node에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.	✅
`$getWorkflowStaticData(type)`	예제를 확인하세요. 정적 데이터는 워크플로를 테스트할 때는 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅에 의해 호출되어야 합니다. 이를 통해 정적 워크플로 데이터에 접근할 수 있습니다.	✅
`$("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.	✅
`$itemIndex`	아이템 목록에서 해당 아이템의 인덱스입니다.	❌
`$nodeVersion`	현재 노드의 버전을 가져옵니다.	✅
`$prevNode.name`	현재 입력이 유래한 노드의 이름입니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$prevNode.outputIndex`	현재 입력이 유래한 출력 커넥터의 인덱스입니다. 이전 노드에 출력이 여러 개 있는 경우(If 또는 Switch node 등) 사용합니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 이런 식으로 이어집니다).	✅
`$secrets`	External secrets 설정에 대한 정보를 포함합니다.	❌
`$vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.	✅
`$version`	노드 버전입니다.	❌
`$workflow.active`	워크플로가 활성화되어 있는지(true) 아닌지(false)를 나타냅니다.	✅
`$workflow.id`	워크플로 ID입니다.	✅
`$workflow.name`	워크플로 이름입니다.	✅

Python (native)

메서드	설명
`_items`	"Run once for all items" 모드에서 수신되는 아이템을 포함합니다.
`_item`	"Run once for each item" 모드에서 반복 처리 중인 아이템을 포함합니다.

Python (Pyodide, deprecated)

메서드	설명
`_env`	n8n 인스턴스 구성 환경 변수를 포함합니다.
`_execution.customData`	사용자 지정 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 Custom executions data를 참고하세요.
`_execution.id`	현재 워크플로 실행의 고유 ID입니다.
`_execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.
`_execution.resumeUrl`	Wait node에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.
`_getWorkflowStaticData(type)`	예제를 확인하세요. 정적 데이터는 워크플로를 테스트할 때는 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅에 의해 호출되어야 합니다. 이를 통해 정적 워크플로 데이터에 접근할 수 있습니다.
`_("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.
`_nodeVersion`	현재 노드의 버전을 가져옵니다.
`_prevNode.name`	현재 입력이 유래한 노드의 이름입니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_prevNode.outputIndex`	현재 입력이 유래한 출력 커넥터의 인덱스입니다. 이전 노드에 출력이 여러 개 있는 경우(If 또는 Switch node 등) 사용합니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 이런 식으로 이어집니다).
`_secrets`	External secrets 설정에 대한 정보를 포함합니다.
`_vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.
`_workflow.active`	워크플로가 활성화되어 있는지(true) 아닌지(false)를 나타냅니다.
`_workflow.id`	워크플로 ID입니다.
`_workflow.name`	워크플로 이름입니다.

n8n 메타데이터

n8n v2.29

원문 보기

번역일: 2026-06-22

요약

Code node에서 Python을 사용할 수 있습니다. Python (Pyodide, deprecated)

n8n 메타데이터를 다루는 방법입니다.

여기에는 다음이 포함됩니다:

셀프 호스팅 n8n을 위한 n8n 환경 변수 접근.
워크플로, 실행, 노드에 대한 메타데이터.
인스턴스 Variables 및 External secrets에 대한 정보.

Note

Python 지원

Code node에서 Python을 사용할 수 있습니다. 표현식에서는 사용할 수 없습니다.

JavaScript

메서드	설명	Code node에서 사용 가능?
`$env`	n8n 인스턴스 구성 환경 변수를 포함합니다.	✅
`$execution.customData`	사용자 지정 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 Custom executions data를 참고하세요.	✅
`$execution.id`	현재 워크플로 실행의 고유 ID입니다.	✅
`$execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.	✅
`$execution.resumeUrl`	Wait node에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.	✅
`$getWorkflowStaticData(type)`	예제를 확인하세요. 정적 데이터는 워크플로를 테스트할 때는 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅에 의해 호출되어야 합니다. 이를 통해 정적 워크플로 데이터에 접근할 수 있습니다.	✅
`$("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.	✅
`$itemIndex`	아이템 목록에서 해당 아이템의 인덱스입니다.	❌
`$nodeVersion`	현재 노드의 버전을 가져옵니다.	✅
`$prevNode.name`	현재 입력이 유래한 노드의 이름입니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$prevNode.outputIndex`	현재 입력이 유래한 출력 커넥터의 인덱스입니다. 이전 노드에 출력이 여러 개 있는 경우(If 또는 Switch node 등) 사용합니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge node를 사용하는 경우 `$prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.	✅
`$runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 이런 식으로 이어집니다).	✅
`$secrets`	External secrets 설정에 대한 정보를 포함합니다.	❌
`$vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.	✅
`$version`	노드 버전입니다.	❌
`$workflow.active`	워크플로가 활성화되어 있는지(true) 아닌지(false)를 나타냅니다.	✅
`$workflow.id`	워크플로 ID입니다.	✅
`$workflow.name`	워크플로 이름입니다.	✅

Python (native)

메서드	설명
`_items`	"Run once for all items" 모드에서 수신되는 아이템을 포함합니다.
`_item`	"Run once for each item" 모드에서 반복 처리 중인 아이템을 포함합니다.

Python (Pyodide, deprecated)

메서드	설명
`_env`	n8n 인스턴스 구성 환경 변수를 포함합니다.
`_execution.customData`	사용자 지정 실행 데이터를 설정하고 가져옵니다. 자세한 내용은 Custom executions data를 참고하세요.
`_execution.id`	현재 워크플로 실행의 고유 ID입니다.
`_execution.mode`	실행이 자동으로 트리거되었는지, 아니면 워크플로를 수동으로 실행하여 트리거되었는지를 나타냅니다. 가능한 값은 `test`와 `production`입니다.
`_execution.resumeUrl`	Wait node에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL입니다.
`_getWorkflowStaticData(type)`	예제를 확인하세요. 정적 데이터는 워크플로를 테스트할 때는 유지되지 않습니다. 정적 데이터를 저장하려면 워크플로가 활성화되어 있고 트리거 또는 웹훅에 의해 호출되어야 합니다. 이를 통해 정적 워크플로 데이터에 접근할 수 있습니다.
`_("<node-name>").isExecuted`	노드가 이미 실행되었는지 확인합니다.
`_nodeVersion`	현재 노드의 버전을 가져옵니다.
`_prevNode.name`	현재 입력이 유래한 노드의 이름입니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_prevNode.outputIndex`	현재 입력이 유래한 출력 커넥터의 인덱스입니다. 이전 노드에 출력이 여러 개 있는 경우(If 또는 Switch node 등) 사용합니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_prevNode.runIndex`	현재 입력을 생성한 이전 노드의 실행 횟수입니다. Merge node를 사용하는 경우 `_prevNode`는 항상 첫 번째 입력 커넥터를 사용한다는 점에 유의하세요.
`_runIndex`	n8n이 현재 노드를 실행한 횟수입니다. 0부터 시작합니다(첫 번째 실행은 0, 두 번째는 1, 이런 식으로 이어집니다).
`_secrets`	External secrets 설정에 대한 정보를 포함합니다.
`_vars`	활성 환경에서 사용 가능한 Variables를 포함합니다.
`_workflow.active`	워크플로가 활성화되어 있는지(true) 아닌지(false)를 나타냅니다.
`_workflow.id`	워크플로 ID입니다.
`_workflow.name`	워크플로 이름입니다.