- 카테고리:
BIND_VALUES¶
참고
이 함수를 사용하려면 계정에서 :doc:`2025_06 동작 변경 번들 </release-notes/bcr-bundles/2025_06_bundle>`을 활성화해야 합니다. 이 번들은 기본적으로 비활성화되어 있습니다.
이 INFORMATION_SCHEMA 테이블 함수는 쿼리에 사용된 :doc:`바인드 변수</sql-reference/bind-variables>`의 값에 대한 정보를 반환합니다.
구문¶
BIND_VALUES( <query_id> )
인자¶
query_id하나 이상의 바인드 변수를 포함하는 쿼리의 문자열 식별자입니다.
Snowflake 쿼리 ID는
01b71944-0001-b181-0000-0129032279f6과 비슷한 고유한 문자열입니다.NULL인 경우 빈 테이블이 반환됩니다.
사용법 노트¶
현재 사용자가 실행하는 쿼리에 대한 바인드 변수 값을 반환합니다. 또한 사용자 세션에서 현재 활성 상태인 역할이나 계층 구조상 상위 역할에게, 쿼리가 실행된 사용자 관리형 웨어하우스에 대한 MONITOR 또는 OPERATE 권한이 있는 경우 모든 사용자가 실행하는 쿼리에 대한 바인드 변수 값을 반환합니다. 자세한 내용은 가상 웨어하우스 권한 섹션을 참조하십시오.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.
이 함수는 지난 7일 동안 실행된 모든 쿼리를 반환할 수 있습니다.
다음 시나리오에서는 이 함수가 바인드 값을 반환하지 않거나 오류를 반환할 수 있습니다.
ALLOW_BIND_VALUES_ACCESS 계정 수준 매개 변수를 ``FALSE``로 설정합니다.
바인드 변수에 Snowflake 저장소 임계값을 초과하는 큰 값이 있습니다.
쿼리에 Snowflake 저장소 임계값을 초과하는 많은 수의 바인드 변수가 있습니다.
바인드 변수에 민감한 데이터가 포함되어 있습니다. 추출 및 처리는 최선을 다해 수행되며 데이터가 민감한 것으로 간주되는지 여부는 컨텍스트에 따라 다릅니다.
함수 호출은 :ref:`배열 바인드<label-bind_variables_array_binds>`를 포함하는 쿼리를 지정합니다.
함수 호출이 존재하지 않는 쿼리를 지정합니다.
함수 호출이 만료되어 더 이상 쿼리 기록에 없는 쿼리를 지정합니다.
출력¶
BIND_VALUES 테이블 함수는 지정된 쿼리에 사용되는 각 바인드 변수에 대해 하나의 행을 생성합니다. 각 행에는 다음 열이 포함됩니다.
열 이름 |
데이터 타입 |
설명 |
|---|---|---|
QUERY_ID |
VARCHAR |
쿼리의 ID입니다. |
POSITION |
NUMBER |
위치 바인드 변수의 경우 바인드 변수의 위치입니다. 명명된 바인드 변수의 경우 필드는 NULL입니다. |
NAME |
VARCHAR |
명명된 바인드 변수의 경우 바인드 변수의 이름입니다. 위치 바인드 변수의 경우 필드는 NULL입니다. |
TYPE |
VARCHAR |
바인드 변수의 Snowflake 데이터 타입입니다. |
VALUE |
VARCHAR |
바인드 변수의 값입니다. 100,000자를 초과하는 바인드 값은 잘립니다. |
예¶
바인드 변수 값 검색하기 섹션을 참조하십시오.