$()

쿼리 매개변수의 값을 반환합니다.

문법

$(EXPR, [DEFAULT_EXPR])
필수 매개변수
EXPR
쿼리 매개변수를 반환하는 표현식. 쿼리 매개변수의 이름은 큰 따옴표 쌍(" ")으로 감싸서 입력하세요.
선택 매개변수
DEFAULT_EXPR
EXPRnull일 때 함수가 반환할 기본값을 정의하는 표현식이나 값

설명

쿼리 매개변수는 쿼리에서 필요할 때 호출해 사용할 수 있는 변수로, 함수 등을 이용한 표현식을 이용함으로써 동적으로 값을 할당해 쿼리를 실행할 때 유용합니다. set 또는 evalc 명령어는 쿼리 매개변수를 정의할 때 사용됩니다. 쿼리 매개변수에 할당된 값을 쿼리나 프로시저에서 참조하려면 $() 함수를 사용하세요.

프로시저를 정의할 때 이 함수를 이용함으로써 프로시저가 쿼리 매개변수를 받을 수 있습니다. 단, 프로시저를 호출하는 쿼리와 프로시저는 동일한 매개변수 이름을 사용해야 합니다.

사용 예

  1. 현재 시각으로부터 최근 7일간 YOUR_TABLE 테이블에 기록된 데이터 조회

    set from=ago("7d")
    | set to=str(now())
    | table from=$("from") to=$("to") YOUR_TABLE
    
  2. 쿼리 매개변수 _from, _to로 지정한 기간 동안 YOUR_TABLE 테이블에 기록된 데이터 조회. 쿼리 매개변수의 값이 없으면(null), 현재 시각으로부터 최근 1일간 데이터 검색

    table from=$("_from", ago("1d")) to=$("_to", now()) YOUR_TABLE