ESQL의 사용자 정의 특성

DECLARE문에 EXTERNAL 키워드를 지정하여 사용자의 ESQL 프로그램에서 변수로서 사용자 정의 특성(UDPs)에 액세스하십시오. 예를 들어, ESQL문 DECLARE today EXTERNAL CHARACTER 'monday' 는 초기값이 mondaytoday 라는 사용자 정의 특성을 정의합니다.

사용자 정의 특성을 사용하려면 먼저 이를 사용하는 메시지 플로우를 구성할 때 특성을 메시지 플로우 편집기에서 정의해야 합니다. UDP를 메시지 플로우 편집기에서 정의할 때 값과 특성 유형을 정의해야 합니다. 값은 기본값일 수 있으며, UDP의 유형에 따라 다릅니다. 메시지 플로우 편집기에서 UDP에 지정된 값은 ESQL 프로그램에서 UDP에 지정한 값에 우선합니다.

서브플로우를 위해 UDP를 정의할 수도 있습니다. UDP는 글로벌 범위를 갖고 있으며 특정 서브플로우에 특정하지 않습니다. 메시지 플로우에서 서브플로우를 재사용하며 서브플로우에 동일한 UDP가 있는 경우에는 UDP를 서로 다른 값으로 설정할 수 없습니다.

UDP 를 사용하는 메시지 흐름을 배포하기 전에, BAR 편집기에서 ` UDP `의 값을 변경할 수 있습니다. 지정된 값이 없는 UDP가 포함된 메시지 플로우를 배치하려고 하는 경우, 배치 실패가 발생합니다. 자세한 정보는 사용자 정의 특성을 사용하여 배치 시 메시지 플로우 구성을 참조하십시오.

관리 REST API를 사용하여 런타임 시 UDP의 값을 수정할 수도 있습니다. 자세한 정보는 관리 REST API를 사용하여 런타임 시 메시지 플로우 사용자 정의 특성 설정을 참조하십시오.

UDP를 사용하여 구성 데이터를 설정하고, 일반 설치 특성과 같이 사용할 수 있습니다. 포함된 사용자 작성 플러그인에 대한 외부 호출 또는 환경 트리의 구문 분석이 없고 트리에서 데이터를 읽는 비용을 구문 분석하는 것이 제거됩니다. UDP의 값은 배치 시간의 변수에서 완성됩니다.

모듈 또는 스키마에서만 UDP를 선언할 수 있습니다. 동적으로 메시지 플로우의 실행을 변경하기 위해 런타임 시 UDP를 조회하고, 발견하고 설정할 수 있습니다. 자세한 정보는 사용자 정의 특성을 참조하십시오.

ESQL을 사용하는 다음 내장 노드에서 UDP에 액세스할 수 있습니다.
  • 컴퓨팅
  • 데이터베이스
  • DatabaseInput
  • 필터

JavaCompute 노드에서 UDP 에 액세스하는 방법에 대한 설명은 “ JavaCompute 노드에서 메시지 흐름 사용자 정의 속성에 액세스하기”를 참조하십시오.