GETVARIABLE

GETVARIABLE 함수는 SQL 변수 이름과 연결된 값을 반환해요.

출처: GETVARIABLE

본문

GETVARIABLE 함수는 SQL 변수 이름과 연결된 값을 반환해요.

구문 (Syntax)

GETVARIABLE( '<name>' )

인자 (Arguments)

name — SQL 변수의 이름이에요. 변수를 정의할 때 소문자를 사용했더라도 변수 이름을 대문자로 지정해야 해요.

반환 (Returns)

반환 값의 데이터 타입은 VARCHAR예요.

사용 메모 (Usage notes)

이 함수를 같은 세션에서 두 번 이상 호출하면 현재 세션에 대한 결과 캐시(result cache)를 사용해요. 이 결과 캐시는 행 액세스 정책과 같은 정책 객체의 본문을 포함해 이 함수를 호출하는 모든 곳에 적용돼요.

예제 (Examples)

이 함수와 변수의 값을 가져오는 다른 방법을 사용하는 방법을 보여줘요:

SET MY_LOCAL_VARIABLE= 'my_local_variable_value';
+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
SELECT 
    GETVARIABLE('MY_LOCAL_VARIABLE'), 
    SESSION_CONTEXT('MY_LOCAL_VARIABLE'),
    $MY_LOCAL_VARIABLE;
+----------------------------------+--------------------------------------+-------------------------+
| GETVARIABLE('MY_LOCAL_VARIABLE') | SESSION_CONTEXT('MY_LOCAL_VARIABLE') | $MY_LOCAL_VARIABLE      |
|----------------------------------+--------------------------------------+-------------------------|
| my_local_variable_value          | my_local_variable_value              | my_local_variable_value |
+----------------------------------+--------------------------------------+-------------------------+

SET 명령으로 변수를 생성하면 변수 이름은 모두 대문자로 강제 설정돼요. GETVARIABLE과 SESSION_CONTEXT 함수는 함수 이름의 대문자 버전을 전달해야 해요. $ 표기법은 대문자 또는 소문자 변수 이름 모두에서 동작해요.

SET var_2 = 'value_2';
+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
SELECT 
    GETVARIABLE('var_2'),
    GETVARIABLE('VAR_2'),
    SESSION_CONTEXT('var_2'),
    SESSION_CONTEXT('VAR_2'),
    $var_2,
    $VAR_2;
+----------------------+----------------------+--------------------------+--------------------------+---------+---------+
| GETVARIABLE('VAR_2') | GETVARIABLE('VAR_2') | SESSION_CONTEXT('VAR_2') | SESSION_CONTEXT('VAR_2') | $VAR_2  | $VAR_2  |
|----------------------+----------------------+--------------------------+--------------------------+---------+---------|
| NULL                 | value_2              | NULL                     | value_2                  | value_2 | value_2 |
+----------------------+----------------------+--------------------------+--------------------------+---------+---------+

더 알아보기 (Learn more)

세션 변수 함수 (Session variable functions)
컨텍스트 함수 (Context functions)