본문으로 건너뛰기

파라미터 관리

최근 업데이트 2026. 10. 05.

공간 파라미터 개요​

공간 파라미터는 파라미터 체계의 구성 요소이며, 적용 범위는 공간 전체입니다. 즉, 해당 공간의 모든 작업 플로우, 오프라인 동기화 계획 등의 모듈에서 이러한 공간 파라미터를 사용할 수 있습니다. 공간 파라미터는 사전 설정 공간 파라미터와 커스텀 공간 파라미터로 나뉩니다.

사전 설정 파라미터​

사전 설정 파라미터설명
기준 날짜 ${bd}

Base date, 데이터 정산의 기준 날짜이며, 워크스페이스를 새로 만들 때 날짜 형식과 오프셋을 정의해야 합니다

자세한 내용은 데이터 개발 공간 관리에서 확인할 수 있습니다

기준 시간대 ${btz}

Base timezone, 데이터 정산의 기준 시간대이며, 워크스페이스를 새로 만들 때 시간대를 정의해야 합니다

자세한 내용은 데이터 개발 공간 관리에서 확인할 수 있습니다

이론적 스케줄 시간 ${st}

작업 인스턴스가 이론적으로 실행되어야 하는 시점으로, 기본 형식은 yyyyMMddHHmmss이며 워크스페이스를 새로 만들 때 정의해야 합니다

자세한 내용은 데이터 개발 공간 관리에서 확인할 수 있습니다

실행 환경 ${env}실행 환경에 따라 해당 환경 값을 사용하며, 가능한 값은 dev, product입니다
운영 환경 데이터베이스 ${ws_prod_db}시스템에 사전 설정된 운영 환경 데이터베이스 이름으로, 작업 플로우 개발에 사용할 수 있습니다
개발 환경 데이터베이스 ${ws_dev_db}시스템에 사전 설정된 개발 환경 데이터베이스 이름으로, 작업 플로우 개발에 사용할 수 있습니다
IDE 데이터베이스 ${ws_ide_db}시스템에 사전 설정된 IDE 데이터베이스 이름
공간 기준 날짜 및 시간대 정의

공간 파라미터(커스텀)​

공간 파라미터 목록에서 현재 공간에서 사용할 수 있는 모든 커스텀 공간 파라미터를 확인할 수 있습니다

사용자는 파라미터 관리 모듈에서 + 공간 파라미터를 클릭하여 커스텀 공간 파라미터를 추가할 수도 있습니다.

공간 파라미터 설정은 다음과 같습니다.

필드설명
파라미터 이름

커스텀 공간 파라미터의 이름

  • 최대 40자이며, 현재 사전 설정 파라미터와 이름이 같을 수 없고 공간 내에서 고유해야 합니다
  • ws_로 시작할 수 없으며, ${bd}, ${btz}는 사용할 수 없습니다.
  • 영문자로 시작해야 하며, 영문 소문자, 숫자, 밑줄을 포함할 수 있습니다
타입

커스텀 공간 파라미터 타입

  • '일반 텍스트'와 '표현식' 두 가지 타입으로 나뉩니다

일반 텍스트: 일반 텍스트 값입니다. 예:

  • num = 2
  • city = shanghai

표현식: 표현식에서 사전 설정 파라미터를 참조할 수 있습니다

예를 들어 기본 날짜 형식이 yyyy-MM-dd인 사전 설정 파라미터 ${bd}를 참조하는 경우, 표현식은 다음과 같이 작성할 수 있습니다

  • ${bd} 값: 2025-02-01
  • ${bd:yyyy-MM-dd-7} 값: 2025-01-23
  • ${bd:yy/MM/dd-7} 값: 2025/01/23
값
  • 타입 = '일반 텍스트'인 경우 직접 입력한 값입니다
  • 타입 = '표현식'인 경우 표현식입니다
설명공간 파라미터 설명

공간 파라미터 표현식 작성 예시​

${bd}를 그대로 사용하면 별도의 후처리 없이 기본값과 기본 형식으로 반환됩니다

${bd}의 서식 지정 표현식은 DolphinScheduler(DS)의 직접 표현식과 비슷하며, ${bd:yyyy-MM-dd-1}, ${bd:dd/MM/yy} 등이 있습니다. 커스텀 형식(마찬가지로 SimpleDateFormat 사용) 뒤에 바로 "+/-" 숫자를 붙일 수 있으며, 단위는 일입니다.

${bd:yyyy-MM-dd} 형식을 예로 들면 다음과 같습니다.

  • N주 후: ${bd:yyyy-MM-dd+N*week}
  • N주 전: ${bd:yyyy-MM-dd-N*week}
  • N일 후: ${bd:yyyy-MM-dd+N}, ${bd:yyyy-MM-dd+N*day}
  • N일 전: ${bd:yyyy-MM-dd-N}, ${bd:yyyy-MM-dd-N*day}
  • N시간 후: ${bd:yyyy-MM-dd HH:mm:ss+N*hour}
  • N시간 전: ${bd:yyyy-MM-dd HH:mm:ss-N*hour}
  • N분 후: ${bd:yyyy-MM-dd HH:mm:ss+N*minute}
  • N분 전: ${bd:yyyy-MM-dd HH:mm:ss-N*minute}

연도와 월의 오프셋은 다음 방식을 사용할 수 있습니다.

  • N개월 후: ${bd:yyyy-MM-dd+N*month}
  • N개월 전: ${bd:yyyy-MM-dd-N*month}
  • N년 후: ${bd:yyyy-MM-dd+N*year}
  • N년 전: ${bd:yyyy-MM-dd-N*year}
이 문서가 도움이 되었나요?