HPL/SQL - ACTIVITY_COUNT 변수

ACTIVITY_COUNT 내장 변수는 마지막으로 실행한 SQL 문에 영향을 받은 행의 개수를 담고 있어요. 쿼리가 몇 건의 데이터를 다뤘는지 확인하고 싶을 때 유용해요.

출처: 문서

본문

ACTIVITY_COUNT 내장 변수는 마지막 SQL 문에 영향받은 행의 개수를 담고 있습니다.

중요 사항: 현재 Hive는 JDBC Statement.getUpdateCount()를 지원하지 않습니다. 그래서 INSERT 문의 경우 ACTIVITY_COUNT는 Hive 0.13 이하에서는 0, Hive 0.14 이후에서는 -1을 반환합니다. 자세한 내용은 HIVE-7680을 참고하세요.

현재 Hive에서는 ACTIVITY_COUNT를 SELECT 문에만 사용할 수 있습니다. SELECT INTO가 행을 반환하면 ACTIVITY_COUNT는 1로 설정됩니다. 또한 커서를 사용하면 FETCH 문이 실행될 때마다 ACTIVITY_COUNT가 1씩 증가합니다.

예제:

DECLARE var INT;

SELECT id INTO var FROM default.dual;

IF ACTIVITY_COUNT = 1 THEN
  PRINT 'id = ' || var;
END IF;

호환성: Teradata

같이 보기:

더 알아보기 (Learn more)

활동 개수(affected row count)가 아니라 오류 상황의 세부 정보를 얻으려면 GET DIAGNOSTICS 문서를 함께 보세요. HPL/SQL의 다른 내장 변수인 SQLCODE, SQLSTATE도 오류 처리에 자주 함께 사용됩니다.