Snowflake Scripting에서 추적 이벤트 내보내기¶
Snowflake SYSTEM
함수를 사용하여 Snowflake Scripting으로 작성된 함수 또는 프로시저 처리기에서 추적 이벤트를 내보낼 수 있습니다.
추적 이벤트를 내보내기 전에 원하는 데이터가 이벤트 테이블에 저장되도록 추적 수준을 설정했는지 확인합니다. 자세한 내용은 추적 수준 설정하기 섹션을 참조하십시오.
참고
추적 이벤트 내보내기를 시작하려면 먼저 이벤트 테이블을 설정해야 합니다. 자세한 내용은 이벤트 테이블 설정하기 섹션을 참조하십시오.
이벤트 테이블에서 SELECT 명령을 실행하여 저장된 추적 이벤트 데이터에 액세스할 수 있습니다. 자세한 내용은 추적 데이터에 액세스하기 섹션을 참조하십시오.
Snowflake에서 로깅 설정 및 메시지 검색에 대한 일반적인 정보는 함수와 프로시저의 추적 이벤트 섹션을 참조하십시오.
참고
추적 이벤트를 추가할 때 염두에 두어야 할 지침은 추적 이벤트를 추가하는 일반 지침 섹션을 참조하십시오.
추적 이벤트 추가하기¶
SYSTEM$ADD_EVENT(Snowflake Scripting의 경우) 함수를 호출하고 이벤트 이름을 전달하여 추적 이벤트를 추가할 수 있습니다. 선택적으로 특성(키-값 페어)을 이벤트와 연결할 수도 있습니다.
다음 예제의 코드에서는 SProcEmptyEvent
와 SProcEventWithAttributes
의 두 이벤트가 추가됩니다. 이 코드에서 SProcEventWithAttributes
를 사용하면 key1
과 key2
의 두 가지 특성도 추가됩니다.
SYSTEM$ADD_EVENT("SProcEmptyEvent")
SYSTEM$ADD_EVENT("SProcEventWithAttributes", {"key1": "value1", "key2": "value2"})
이러한 이벤트를 추가하면 이벤트 테이블에 두 개의 행이 생기는데, RECORD 열의 값이 각각 다릅니다.
{
"name": "SProcEmptyEvent"
}
{
"name": "SProcEventWithAttributes"
}
SProcEventWithAttributes
이벤트 행의 RECORD_ATTRIBUTES 열에 다음 특성을 포함합니다.
{
"key1": "value1",
"key2": "value2"
}
범위 특성 추가하기¶
SYSTEM$SET_SPAN_ATTRIBUTES 함수를 호출하여 범위와 연결된 특성(키-값 페어)을 설정할 수 있습니다.
범위에 대한 자세한 내용은 Snowflake가 추적 이벤트를 표시하는 방법 섹션을 참조하십시오.
SYSTEM$SET_SPAN_ATTRIBUTES(Snowflake Scripting의 경우) 함수는 다음 형식으로 사용할 수 있습니다.
SYSTEM$SET_SPAN_ATTRIBUTES(<object>);
여기서
object
는 이 추적 이벤트의 특성을 지정하는 키-값 페어가 있는 Snowflake Scripting 오브젝트입니다.
다음 예제의 코드는 4가지 특성을 만들고 해당 값을 설정합니다.
SYSTEM$SET_SPAN_ATTRIBUTES('{'attr1':'value1', 'attr2':true}');
이러한 특성을 설정하면 이벤트 테이블의 RECORD_ATTRIBUTES 열에 다음 내용이 표시됩니다.
{
"attr1": "value1",
"attr2": "value2"
}
예¶
다음 예제의 코드에서는 SYSTEM$ADD_EVENT 함수를 사용하여 name_a
라는 이벤트와 name_b
라는 이벤트를 추가합니다. name_b
와 함께 두 특성 score
와 pass
를 연결합니다. 이 코드는 또한 SYSTEM$SET_SPAN_ATTRIBUTES를 사용하여 범위의 두 가지 특성인 attr1
과 attr2
를 설정합니다.
create procedure MYPROC()
returns double
language sql
as
$$
begin
-- Add an event without attributes
SYSTEM$ADD_EVENT('name_a');
-- Add an event with attributes
let attr := {'score':89, 'pass':true};
SYSTEM$ADD_EVENT('name_b', attr);
-- Set attributes for the span
SYSTEM$SET_SPAN_ATTRIBUTES("{'attr1':'value1', 'attr2':true}");
return 3.14;
end;
$$
;
call MYPROC();