BIND_VALUES

BIND_VALUES

쿼리에서 사용된 바인드 변수(bind variable)들의 값에 대한 정보를 반환하는 INFORMATION_SCHEMA 테이블 함수예요.

출처: 공식 문서

본문

이 INFORMATION_SCHEMA 테이블 함수는 쿼리에서 사용된 바인드 변수들의 값에 대한 정보를 반환합니다.

구문 (Syntax)

BIND_VALUES( <query_id> )

인자 (Arguments)

하나 이상의 바인드 변수를 포함하는 쿼리의 문자열 식별자입니다.

Snowflake 쿼리 ID는 01b71944-0001-b181-0000-0129032279f6 같은 고유한 문자열입니다.

NULL이면 빈 테이블이 반환됩니다.

사용 참고 사항 (Usage notes)

• 현재 사용자가 실행한 쿼리에 대한 바인드 변수 값을 반환합니다. 또한, 사용자 세션에서 현재 활성화된 역할 또는 계층 구조에서 더 높은 역할이 쿼리가 실행된 사용자 관리형 웨어하우스에 대한 MONITOR 또는 OPERATE 권한을 가지고 있으면 어떤 사용자가 실행한 쿼리에 대해서도 바인드 변수 값을 반환합니다. 자세한 내용은 Virtual warehouse privileges를 참고하세요.

• Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이어야 하거나 함수 이름이 완전히 한정되어 있어야 합니다. 자세한 내용은 Snowflake Information Schema를 참고하세요.

• 이 함수는 지난 7일 동안 실행된 모든 쿼리를 반환할 수 있습니다.

• 이 함수는 다음 시나리오에서는 바인드 값을 반환하지 않거나 오류를 반환할 수 있습니다:

• ALLOW_BIND_VALUES_ACCESS 계정 수준 매개변수가 FALSE로 설정된 경우.

• 바인드 변수에 Snowflake 저장소 임계값을 초과하는 큰 값이 있는 경우.

• 쿼리에 Snowflake 저장소 임계값을 초과하는 많은 수의 바인드 변수가 있는 경우.

• 바인드 변수에 민감한 데이터가 포함된 경우. 추출과 처리는 최선(best-effort) 방식으로 수행되며, 데이터가 민감한 것으로 간주되는지는 맥락에 따라 달라집니다.

• 함수 호출이 배열 바인드(array binds)를 포함하는 쿼리를 지정하는 경우.

• 함수 호출이 존재하지 않는 쿼리를 지정하는 경우.

• 함수 호출이 만료되어 더 이상 쿼리 이력에 없는 쿼리를 지정하는 경우.

출력 (Output)

BIND_VALUES 테이블 함수는 지정된 쿼리에서 사용된 각 바인드 변수에 대해 한 행을 생성합니다. 각 행은 다음 열들을 포함합니다:

예제 (Examples)

Retrieve bind variable values를 참고하세요.

더 알아보기 (Learn more)

• Snowflake Information Schema