Skip to content

스크립트 개발 / 환경 변수 DFF.ENV

스크립트 편집기 왼쪽 사이드바에서 구성한 환경 변수는 Script에서 해당 ID로 읽을 수 있습니다.

API

메서드 설명
DFF.ENV(key, default=None) 환경 변수를 읽고, 존재하지 않으면 default를 반환합니다.
DFF.ENV.get(key, default=None) DFF.ENV(...)를 직접 호출하는 것과 동일합니다.
DFF.ENV.keys() 사용 가능한 환경 변수의 ID 목록을 반환합니다.
DFF.ENV.ref(key, default=None) 동적 값 평가를 지원하는 DFF.API 매개변수를 위한 지연 참조를 생성합니다.
예시
1
2
3
company_name = DFF.ENV('companyName')
page_size = DFF.ENV('pageSize', default=10)
all_keys = DFF.ENV.keys()

환경 변수를 찾을 수 없으면 default를 반환하고, 기본값을 전달하지 않으면 None을 반환합니다. password 유형의 환경 변수는 자동으로 복호화됩니다. 타입 변환이 구성된 경우 변환된 Python 값이 반환됩니다. 구성 오류로 인해 타입 변환 중 예외가 발생할 수 있으므로, 선택적 변수를 읽을 때는 기본값이나 폴백 로직을 제공해야 합니다.

타입 폴백 예시
1
2
3
4
5
def get_page_size():
    try:
        return int(DFF.ENV('pageSize', default=10) or 10)
    except Exception:
        return 10

동적 참조

DFF.ENV.ref(...)는 현재 환경 변수 값이 아닌 동적 참조를 반환합니다. 참조는 Func 메타데이터가 소비될 때 해석되며, DFF.API의 delayed_cron_job, timeout, expires 및 queue 매개변수에 사용할 수 있습니다.

예시
1
2
3
@DFF.API('동적 타임아웃', timeout=DFF.ENV.ref('FUNC_TIMEOUT', default=35))
def dynamic_timeout():
    return 'ok'

연결 주소, Token, 비밀번호 및 환경별 차이 구성은 환경 변수에 우선적으로 저장해야 하며, Script 내에 하드코딩하지 말고 print(...)나 Func 응답을 통해 민감한 값을 출력해서는 안 됩니다.