DBMS_DATA_TOOLS_JOBS 패키지 참조

이 장에서는 Data Studio의 작업 기능과 함께 사용하는 패키지에 대한 정보를 제공합니다. DBMS_DATA_TOOLS_JOBS 하위 프로그램의 요약 항목에서는 DBMS_DATA_TOOLS_JOBS 패키지에 포함된 프로시저도 다룹니다.

항목:

DBMS_DATA_TOOLS_JOB 서브 프로그램 요약

DBMS_DATA_TOOLS_JOB 프로시저

DBMS_DATA_TOOLS_JOB 하위 프로그램 요약
DBMS_DATA_TOOLS_JOB 패키지는 Data Studio 도구 모음의 작업 기능과 함께 사용하는 일정 잡기 함수 및 프로시저 모음을 제공합니다.

상위 항목: 작업 기능

DBMS_DATA_TOOLS_JOB 서브 프로그램 요약

DBMS_DATA_TOOLS_JOB 패키지는 Data Studio 도구 모음의 작업 기능과 함께 사용하는 일정 잡기 함수 및 프로시저 모음을 제공합니다.

DBMS_DATA_TOOLS_JOB 패키지 서브 프로그램

다음 표에서는 DBMS_DATA_TOOLS_JOB 하위 프로그램을 나열하고 간략하게 설명합니다.

표 22-2 DBMS_DATA_TOOLS_JOB DBMS_DATA_TOOLS_JOB 서브 프로그램의 이름 및 설명

하위 프로그램	설명
작업 프로시저 생성	이 프로시저는 새 작업을 생성합니다.
작업 프로시저 삭제	스케줄러에서 작업을 삭제합니다.
작업 프로시저 이름 바꾸기	작업 이름을 원하는 이름으로 바꿉니다.
작업 프로시저 갱신	기존 작업의 속성을 수정합니다.
프로시저를 실행합니다.	정의한 일정에 관계없이 작업을 즉시 실행합니다.
작업 프로시저 정지	실행 중인 작업을 중지합니다. 이렇게 하면 작업이 정상적으로 종료되고 필요한 경우 강제로 중지됩니다.

보안 고려사항

작업 단계 URL, 요청 본문 또는 보고 구성에 비밀, Bearer 토큰, 비밀번호, 개인 키, 서명된 URL 또는 기타 자격 증명과 같은 중요한 데이터를 직접 배치하지 마십시오. 이러한 값은 작업 정의와 함께 저장한 후 나중에 검색할 수 있습니다. 인증을 위해 데이터베이스 인증서 또는 명명된 인증서를 사용합니다.

CREATE_JOB 프로시저

이 프로시저는 단일 작업을 생성합니다. enabled 속성을 TRUE로 설정하여 활성화된 상태로 작업을 생성하면 Scheduler는 스케줄에 따라 작업을 자동으로 실행합니다. 비활성화된 작업을 생성하는 경우 Enable Job 기능을 사용하여 해당 작업을 활성화해야 작업이 실행됩니다.

구문

dbms_data_tools_job.create_job(
                       job_name        in varchar2,
                       description     in varchar2,
                       steps           in clob,
                       owner           in varchar2 default null,
                       start_date      IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                       repeat_interval IN VARCHAR2                 DEFAULT NULL,
                       end_date        IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                       job_class       IN VARCHAR2                 DEFAULT NULL,
                       enabled         IN BOOLEAN                  DEFAULT FALSE,
                       reporting       in clob default null);

CREATE_JOB 프로시저 파라미터

표 22-3 CREATE_JOB 프로시저 파라미터

매개변수	설명
작업 이름	작업에 지정할 이름입니다. `job_name`가 지정되지 않은 경우 오류가 생성됩니다.
설명	작업에 대해 설정된 추가 정보를 나타냅니다.
단계	이는 Data Studio 도구가 작업으로 구성된 다양한 작업을 나타냅니다. 단계는 JSON 배열입니다. 각 배열 요소는 JSON 객체입니다. 다음은 모든 객체에 적용되는 JSON 요소입니다. `type` - string, 수행되는 단계 유형 선언: data_load, smart_table, procedure, http. `on_errors`- 문자열 `stop`: 오류가 발생하면 작업이 중지되고 오류가 발생합니다. `continue`: 오류가 기록되지만 다음 작업 단계에서 처리가 계속됩니다. `step_name` - 로그에 표시할 단계의 설명적 이름 각 객체 유형에는 유형에 따라 몇 가지 추가 요소가 있습니다. `data_load`: `data_load_name` - (필수) 실행할 이전에 생성된 데이터 로드의 이름 `smart_table`: `recipe_name` - (필수) 실행할 이전에 생성된 스마트 테이블 레시피의 이름입니다. `url` - (필수) 접속할 REST URL입니다. `method` - GET(기본값), POST, PUT, DELETE 또는 기타 HTTP 동사 `procedure`: `procedure` - 실행할 프로시저의 (필수) 이름입니다. 선택적으로 스키마 한정 가능하고, 베어 프로시저 또는 패키지 메소드일 수 있습니다. `arguments` - 프로시저에 제공할 문자열, 숫자 또는 부울 인수의 배열입니다. 주의: HTTP 단계의 경우 URL 또는 요청 본문에 중요한 데이터를 배치하지 마십시오. 인증을 위해 데이터베이스 인증서 또는 명명된 인증서를 사용합니다.
소유자	작업이 생성되는 스키마입니다. 스키마를 지정하지 않고 작업을 생성하는 경우 소유자는 `CREATE_JOB` 프로시저를 실행하는 사용자가 됩니다.
시작 날짜	이 속성은 이 작업이 시작되도록 일정이 잡힌 첫번째 날짜 및 시간을 지정합니다. `start_date` 및 `repeat_interval`가 널로 유지되면 작업이 사용으로 설정되는 즉시 작업이 실행되도록 일정이 잡힙니다. Calendaring 표현식을 사용하여 반복 간격을 지정하는 반복 작업의 경우 `start_date`가 참조 날짜로 사용됩니다. 작업이 처음 실행될 때는 현재 날짜와 시간 당일 또는 그 이후인 Calendaring 표현식이 처음 일치합니다. Scheduler를 사용해도는 작업이 정확한 시간에 실행되지 않도록 보장할 수 없습니다. 시스템이 오버로드되거나 리소스를 사용할 수없는 경우가 있기 때문입니다.
반복 간격	이 속성은 창이 반복되는 빈도를 지정합니다. 스케줄러 Calendaring 구문을 사용하여 표현합니다. 자세한 내용은 "달성 구문"을 참조하십시오. PL/SQL 표현식은 Window의 반복 간격을 지정하는 데 사용할 수 없습니다. 지정된 표현식은 다음에 창이 열릴 시간을 결정하기 위해 평가됩니다. `repeat_interval`가 지정되지 않은 경우 지정된 시작 날짜에 한 번만 창이 열립니다.
종료 날짜	이 속성은 작업이 만료되어 더 이상 실행되지 않는 날짜 및 시간을 지정합니다. `end_date`에 대한 값은 `start_date`에 대한 값보다 이후여야 합니다. `end_date`가 `start_date`보다 작으면 오류가 생성됩니다. `end_date`가 `start_date`와 동일한 경우 작업이 실행되지 않고 오류가 생성되지 않습니다. `end_date`에 대한 값이 지정되지 않은 경우 `stop job`가 아니면 작업이 영원히 반복됩니다.
작업 클래스	이 작업이 연관된 클래스입니다.
사용으로 설정	이 속성은 작업이 생성될지 여부를 지정합니다. 가능한 설정은 `TRUE` 또는 `FALSE`입니다. 기본적으로 이 속성은 `FALSE`로 설정되므로 작업이 사용 안함으로 생성됩니다. 비활성화된 작업은 작업에 대한 메타 데이터가 캡처되었으며 작업이 데이터베이스 객체로 존재함을 의미합니다. 그러나 스케줄러는 작업을 무시하고 작업 조정자는 작업을 처리하도록 선택하지 않습니다. 작업 조정자가 작업을 처리하려면 작업을 활성화해야 합니다. `Enable Job` 아이콘을 선택하여 작업을 사용으로 설정할 수 있습니다.
보고	이 속성은 Jobs 기능의 Report 버튼을 통해 작업 실행 세부 정보를 지정합니다. `dbms_live_feed`에 대한 보고 인수와 유사한 JSON 객체입니다. 다음 요소를 가질 수 있습니다. `completed`: 작업이 완료될 때 통지할 대상입니다. `errors`: 작업의 일부 단계에서 오류가 발생한 경우 통지할 대상입니다. `failed`: 작업 컨텍스트 외부에서 치명적인 오류가 발생할 때 알릴 대상입니다. `long`: 작업이 오래 실행되었을 때 통지할 대상입니다. 이 네 가지 요소 각각은 `smtp` 요소 또는 `slack` 요소의 슬랙 채널에 전자메일 주소 배열을 지정할 수 있습니다. `long` 요소는 너무 `long`를 실행한 것으로 간주되기 전에 작업을 실행해야 하는 기간을 결정하는 `max_runtime_seconds` 요소를 가질 수 있습니다. 주의: 보고 구성에 중요한 데이터를 포함하지 마십시오.

DELETE_JOB 프로시저

이 절차에서는 작업을 삭제합니다.

구문

dbms_data_tools_job.delete_job(
                     job_name in varchar2, 
                     owner    in varchar2 default null);

DELETE_JOB 프로시저 파라미터

표 22-4 DELETE_JOB 프로시저 매개변수

매개변수	설명
작업 이름	작업에 지정할 이름입니다. `job_name`가 지정되지 않은 경우 오류가 생성됩니다.
소유자	작업이 생성되는 스키마입니다. 스키마를 지정하지 않고 작업을 생성하는 경우 소유자는 `CREATE_JOB` 프로시저를 실행하는 사용자가 됩니다.

RENAME_JOB 프로시저

이 프로시저는 작업의 이름을 바꿉니다.

구문

dbms_data_tools_job.rename_job(
                       old_job_name in varchar2,
                       new_job_name in varchar2,
                       owner        in varchar2 default null);

RENAME_JOB 프로시저 파라미터

표 22-5 RENAME_JOB 프로시저 파라미터

매개변수	설명
이전 작업 이름	기존 작업의 이름입니다.
새 작업 이름	새 작업의 이름입니다.
소유자	작업이 생성되는 스키마입니다.

UPDATE_JOB 프로시저

이 프로시저는 기존 작업 속성을 갱신합니다.

구문

dbms_data_tools_job.update_job(
                       job_name        IN VARCHAR2,
                       owner           IN VARCHAR2 DEFAULT NULL,
                       description     IN VARCHAR2 DEFAULT NULL,
                       steps           IN clob DEFAULT NULL,
                       start_date      IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                       repeat_interval IN VARCHAR2                 DEFAULT NULL,
                       end_date        IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
                       job_class       IN VARCHAR2                 DEFAULT NULL,
                       enabled         IN BOOLEAN                  DEFAULT NULL,
                       reporting       IN clob DEFAULT NULL);

UPDATE_JOB 프로시저 파라미터

표 22-6 UPDATE_JOB 프로시저 매개변수

매개변수	설명
작업 이름	업데이트할 작업의 이름입니다.
소유자	작업이 갱신될 스키마입니다.
설명	적용할 업데이트된 설명입니다.
단계	업데이트할 새 단계입니다. 주의: HTTP 단계의 경우 URL 또는 요청 본문에 중요한 데이터를 배치하지 마십시오. 인증을 위해 데이터베이스 인증서 또는 명명된 인증서를 사용합니다.
시작 날짜	새 시작일입니다.
반복 간격	업데이트된 반복 간격입니다.
종료 날짜	업데이트된 종료 일자입니다.
작업 클래스	업데이트된 작업 클래스입니다.
사용으로 설정	사용 또는 사용 안함으로 설정될 수 있습니다.
보고	업데이트된 보고 속성입니다. 주의: 보고 구성에 중요한 데이터를 포함하지 마십시오.

프로시저 실행

이 프로시저는 작업을 즉시 실행합니다.

작업이 활성화되면 스케줄러가 이를 자동으로 실행합니다. 스케줄에 따라 작업을 실행하기 위해 RUN_JOB를 호출할 필요는 없습니다. RUN_JOB를 사용하여 일반 일정 외부에서 작업을 실행합니다.

구문

dbms_data_tools_job.run(
                job_name            in varchar2,
                owner               in varchar2 default null,
                use_current_session in number   default null,
                options             in clob     default null);

RUN 프로시저 매개변수

표 22-7 RUN 프로시저 매개변수

매개변수	설명
작업 이름	작업 이름 또는 콤마로 구분된 항목 목록입니다. 여기서 각 항목은 기존 작업의 이름이며 선택적으로 앞에 스키마 이름과 점 구분자가 옵니다. 다중 대상 작업을 지정하면 작업이 모든 대상에서 실행됩니다. 이 경우 `use_current_session` 인수는 `FALSE`여야 합니다.
소유자	작업이 실행되는 스키마입니다.
현재 세션 사용	이 파라미터는 작업 실행이 프로시저가 호출된 세션과 동일한 세션에서 발생해야 하는지 여부를 지정합니다. `use_current_session`가 `TRUE`로 설정된 경우: 작업을 테스트하고 명령행에서 가능한 오류를 확인할 수 있습니다. `RUN`는 정기적으로 일정이 잡힌 작업 실행과 병렬로 실행할 수 있습니다. `use_current_session`가 `FALSE`로 설정된 경우: 오류 정보를 찾으려면 작업 로그를 확인해야 합니다. `scheduler_jobs`의 모든 관련 필드가 업데이트됩니다. 정기적으로 일정이 잡힌 작업이 실행 중인 경우 `RUN`가 실패합니다.
옵션

STOP_JOB 프로시저

이 프로시저는 현재 실행 중인 작업이나 작업 클래스의 모든 작업을 정지합니다.

작업을 중지한 후 일회성 작업의 상태는 STOPPED로 설정되고, 반복 작업의 상태는 작업의 다음 실행이 예약되었는지 여부에 따라 SCHEDULED 또는 COMPLETED로 설정됩니다.

구문

dbms_data_tools_job.stop_job(
                     job_name in varchar2,
                     owner    in varchar2 default null,
                     force    in boolean  default false);

STOP_JOB 프로시저 파라미터

표 22-8 STOP_JOB 프로시저 매개변수

매개변수 설명

작업 이름

매개변수	설명
작업 이름	중지할 작업 이름입니다. 스키마 이름 및 점 구분 기호(선택 사항)가 앞에 오는 기존 작업의 이름입니다.
소유자	작업이 정지될 스키마입니다.
FORCE	`force`가 `FALSE`로 설정된 경우 스케줄러는 인터럽트 방식을 사용하여 작업을 정상적으로 중지하려고 시도합니다. 이 메소드는 슬래이브 프로세스를 다시 제어합니다. 슬래이브 프로세스는 작업 큐의 작업 상태를 정지됨으로 갱신할 수 있습니다. 실패하면 오류가 반환됩니다. `force`가 `TRUE`로 설정된 경우 스케줄러는 작업 슬래이브를 즉시 종료합니다. Oracle은 force가 `TRUE`로 설정된 `STOP_JOB`는 `force`가 `FALSE`로 설정된 `STOP_JOB`가 실패한 후에만 사용할 것을 권장합니다. `force` 옵션을 사용하려면 `MANAGE SCHEDULER` 시스템 권한이 필요합니다.

중지할 작업 이름입니다. 스키마 이름 및 점 구분 기호(선택 사항)가 앞에 오는 기존 작업의 이름입니다.

소유자

작업이 정지될 스키마입니다.

FORCE

force가 FALSE로 설정된 경우 스케줄러는 인터럽트 방식을 사용하여 작업을 정상적으로 중지하려고 시도합니다. 이 메소드는 슬래이브 프로세스를 다시 제어합니다. 슬래이브 프로세스는 작업 큐의 작업 상태를 정지됨으로 갱신할 수 있습니다. 실패하면 오류가 반환됩니다.

force가 TRUE로 설정된 경우 스케줄러는 작업 슬래이브를 즉시 종료합니다. Oracle은 force가 TRUE로 설정된 STOP_JOB는 force가 FALSE로 설정된 STOP_JOB가 실패한 후에만 사용할 것을 권장합니다.

force 옵션을 사용하려면 MANAGE SCHEDULER 시스템 권한이 필요합니다.

상위 항목: DBMS_DATA_TOOLS_JOBS 패키지 참조