DBMS_DCAT 서브 프로그램 요약

이 테이블에는 데이터 카탈로그 접속을 생성, 질의 및 삭제하는 데 사용되는 DBMS_DCAT 패키지 프로시저가 나열됩니다.

하위 프로그램 설명
SET_DATA_CATALOG_CREDENTIAL 프로시저 데이터 카탈로그에 대한 특정 접속에 사용되는 데이터 카탈로그 액세스 인증서를 설정합니다.
SET_OBJECT_STORE_CREDENTIAL 프로시저 객체 저장소에 액세스하기 위해 제공된 고유 접속 식별자가 사용하는 인증서를 설정합니다.
SET_DATA_CATALOG_CONN 프로시저 제공된 데이터 카탈로그에 대한 접속 생성
UNSET_DATA_CATALOG_CONN 프로시저 기존 데이터 카탈로그 접속 제거

SET_DATA_CATALOG_CREDENTIAL 프로시저

이 절차에서는 데이터 카탈로그에 대한 특정 접속에 사용되는 데이터 카탈로그 액세스 인증서를 설정합니다.

구문

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CREDENTIAL(
    credential_name VARCHAR2(128) DEFAULT NULL,
    dcat_con_id     VARCHAR2 DEFAULT NULL
  );

매개변수

매개변수 설명
credential_name 데이터 카탈로그 액세스에 사용되는 인증서입니다.
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 이 인증서는 dcat_con_id로 식별된 접속에 사용됩니다. 기본값은 Null입니다.

이 인증서에는 데이터 카탈로그 관리 권한이 있어야 합니다. 데이터 카탈로그 정책을 참조하십시오.

SET_OBJECT_STORE_CREDENTIAL 프로시저

이 절차에서는 객체 저장소에 액세스하기 위해 제공된 고유 접속 식별자가 사용하는 인증서를 설정합니다. 객체 저장소 액세스 자격 증명을 변경하면 새 자격 증명을 사용하도록 기존의 동기화된 테이블이 모두 변경됩니다.

구문

PROCEDURE DBMS_DCAT.SET_OBJECT_STORE_CREDENTIAL(
    credential_name  VARCHAR2(128),
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
  );

매개변수

매개변수 설명
credential_name 객체 저장소에 액세스하기 위해 외부 테이블에서 사용하는 인증서입니다.
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 기본값은 NULL입니다.

SET_DATA_CATALOG_CONN 프로시저

이 프로시저는 제공된 데이터 카탈로그에 대한 접속을 생성합니다. 메타데이터와 데이터 카탈로그를 동기화하려면 접속이 필요합니다. 자율운영 AI 데이터베이스 인스턴스는 여러 데이터 카탈로그 인스턴스에 접속할 수 있으며 OCI 데이터 카탈로그 및 AWS Glue 데이터 카탈로그에 대한 접속을 지원합니다.

구문

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CONN (
   region         VARCHAR2 DEFAULT NULL,
   endpoint       VARCHAR2 DEFAULT NULL,
   catalog_id     VARCHAR2 DEFAULT NULL,
   dcat_con_id    VARCHAR2 DEFAULT NULL,
   catalog_type   VARCHAR2 DEFAULT NULL,
   token_endpoint VARCHAR2 DEFAULT Null
 );

매개변수

매개변수 설명
region Data Catalog 영역입니다. endpoint가 지정된 경우 region은 선택 사항입니다. endpoint 및 region가 모두 제공된 경우 endpoint가 우선합니다. 기본값은 NULL입니다.
endpoint 데이터 카탈로그 끝점입니다. region가 지정된 경우 endpoint은 선택 사항입니다. endpoint 및 region가 모두 제공된 경우 endpoint가 우선합니다. 기본값은 NULL입니다.
catalog_id 데이터 카탈로그 인스턴스에 대한 고유 OCID(Oracle Cloud Identifier)입니다. AWS 접착제 데이터 카탈로그에 연결할 때 catalog_id는 선택 사항입니다.
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 이 식별자는 여러 데이터 카탈로그에 접속할 때 필요하며 하나의 데이터 카탈로그에만 접속할 때는 선택사항입니다. 후속 호출에서 또는 뷰를 질의할 때 데이터 카탈로그 접속을 참조하는 데 사용됩니다. 식별자가 지정되지 않은 경우 이 프로시저는 NULL 연결 식별자를 생성합니다. dcat_con_id에 적용되는 제한 사항은 다음과 같습니다.
  • 자율운영 AI 데이터베이스 인스턴스 내에서 고유해야 합니다.
  • 문자로 시작해야 함.
  • 영숫자, 밑줄(_), 달러 기호($) 및 파운드 기호(#)를 포함할 수 있습니다.
  • 길이는 최소 16자 이상이어야 함.
catalog_type 연결할 데이터 카탈로그의 유형입니다. 허용되는 값:
  • OCI_DCAT - OCI 데이터 카탈로그
  • AWS_GLUE - AWS Glue 데이터 카탈로그
  • NULL - 제공된 영역 또는 끝점에서 카탈로그 유형이 자동으로 감지됩니다.
token_endpoint OAuth 인증에 대한 액세스 토큰 끝점입니다. 기본값은 NULL입니다.

사용

연결을 설정하려면 이 프로시저를 한 번만 호출하면 됩니다. 연결 프로세스의 일부로 자율운영 AI 데이터베이스는 데이터 카탈로그에 사용자정의 속성을 추가합니다. 이러한 사용자정의 속성은 데이터 카탈로그 사용자가 액세스할 수 있으며 기본 이름(스키마, 테이블 및 열) 및 열 데이터 유형을 무효화할 수 있습니다.

접속을 생성하기 전에 인증서를 생성하고 설정해야 합니다. 연결 프로세스에 대한 설명은 OCI 데이터 카탈로그용 Typical Workflow with Data Catalog 및 AWS Glue 데이터 카탈로그용 User Workflow for Querying with AWS Glue Data Catalog를 참조하십시오.

예

예제: 알려진 OCID로 연결

이 예에서 자율운영 AI 데이터베이스는 uk-london-1 영역의 데이터 카탈로그에 접속합니다. catalog_id 매개변수는 데이터 카탈로그 인스턴스에 대해 Oracle Cloud 식별자(ocid)를 사용합니다. 데이터 카탈로그의 유형은 AWS Glue 데이터 카탈로그 또는 OCI 데이터 카탈로그로 자동 결정됩니다.

BEGIN
  DBMS_DCAT.SET_DATA_CATALOG_CONN(
    region=>'uk-london-1',
    catalog_id=>'ocid1.datacatalog.oc1.uk-london-1...');
END;
/

예: AWS Glue 데이터 카탈로그에 연결

연결은 자율운영 AI 데이터베이스 인스턴스와 AWS Glue 데이터 카탈로그 간의 연결입니다. 연결 성공 후 자율운영 AI 데이터베이스 인스턴스는 AWS Glue와 동기화할 수 있습니다. 각 AWS 계정에는 지역당 하나의 AWS Glue 데이터 카탈로그가 있으며 각 지역마다 해당하는 서비스 엔드포인트를 사용하여 각 카탈로그에 액세스할 수 있습니다. API DBMS_DCAT.SET_DATA_CATALOG_CONN를 호출하여 자율운영 AI 데이터베이스 인스턴스를 AWS Glue 데이터 카탈로그와 연관시키고 카탈로그가 상주하는 영역의 끝점을 지정할 수 있습니다.

AWS Glue 엔드포인트 및 할당량을 참조하십시오.

이 예에서 자율운영 AI 데이터베이스는 uk-london-1 리전의 AWS Glue Data Catalog에 연결됩니다. AWS Glue Data Catalog 접속이므로 catalog_id 매개변수가 필요하지 않습니다.

BEGIN
  DBMS_DCAT.SET_DATA_CATALOG_CONN(
    region=>'uk-london-1',
    catalog_type=>'AWS_GLUE'
END;
/

UNSET_DATA_CATALOG_CONN 프로시저

이 절차에서는 기존 데이터 카탈로그 접속을 제거합니다.

구문

주: 이 프로시저를 호출하면 보호된 스키마와 이전 동기화의 일부로 생성된 외부 테이블이 모두 삭제됩니다. 데이터 카탈로그의 메타데이터에는 영향을 주지 않습니다.

PROCEDURE DBMS_DCAT.UNSET_DATA_CATALOG_CONN (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
);

매개변수

매개변수 설명
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 기본값은 Null입니다.

동기화 서브 프로그램

동기화 실행, 동기화 작업 생성 및 삭제, 동기화된 스키마 삭제는 이 표에 나열된 절차에 따라 수행할 수 있습니다.

주: 2022년 4월 4일에는 sync_option 및 grant_read 매개변수가 DBMS_DCAT.RUN_SYNC 프로시저에 추가되었습니다. 해당 일자 이전에 생성된 스케줄링된 동기화 작업의 정확한 성능을 보장하려면 스케줄링된 동기화 작업을 삭제하고 재생성해야 합니다. DROP_SYNC_JOB 프로시저 및 CREATE_SYNC_JOB 프로시저를 참조하십시오.

하위 프로그램 설명
CREATE_SYNC_JOB 프로시저 RUN_SYNC를 주기적으로 호출하는 스케줄러 작업 생성
DROP_SYNC_JOB 프로시저 제공된 고유 접속 식별자에 대한 기존 동기화 작업 삭제
DROP_SYNCED_SCHEMAS 프로시저 제공된 고유 접속 식별자에 대해 이전에 동기화된 스키마 모두 삭제
RUN_SYNC 프로시저 동기화 작업 실행

RUN_SYNC 프로시저

이 프로시저는 동기화 작업을 실행하며 동기화의 시작점입니다. 입력으로 선택된 데이터 카탈로그 자산, 폴더 및 엔티티 목록을 가져와서 외부 테이블을 생성, 삭제 및 변경하여 구체화합니다.

sync_option 매개변수는 RUN_SYNC 프로시저가 수행하는 작업(SYNC, DELETE 또는 REPLACE)을 지정합니다. 작업은 synced_objects 매개변수 범위 내의 엔티티에 대해 수행됩니다.

RUN_SYNC 프로시저에 대한 모든 호출은 동기화 상태 및 해당 log_table에 대한 정보를 얻기 위해 USER_LOAD_OPERATIONS 뷰를 질의하는 데 사용할 수 있는 고유한 operation_id를 반환합니다. DBMS_DCAT$SYNC_LOG 뷰를 질의하여 현재 사용자가 실행한 마지막 동기화 작업에 대해 log_table에 쉽게 액세스할 수 있습니다. 자세한 내용은 DBMS_DCAT$SYNC_LOG 뷰를 참조하십시오.

주: 2022년 4월 4일에는 sync_option 및 grant_read 매개변수가 DBMS_DCAT.RUN_SYNC 프로시저에 추가되었습니다. 해당 일자 이전에 생성된 스케줄링된 동기화 작업의 정확한 성능을 보장하려면 스케줄링된 동기화 작업을 삭제하고 재생성해야 합니다. DROP_SYNC_JOB 프로시저 및 CREATE_SYNC_JOB 프로시저를 참조하십시오.

분할된 논리적 엔티티 또는 접착제 테이블 동기화

다음 세 가지가 모두 적용되는 경우 RUN_SYNC 프로시저는 각 논리적 엔티티 또는 Glue 테이블에 대해 분할된 외부 테이블을 생성합니다.

  1. OCI 데이터 카탈로그 논리적 엔티티 또는 Glue 테이블에는 분할된 속성이 하나 이상 있습니다.

  2. OCI 데이터 카탈로그의 경우 논리적 엔티티는 접두어 기반 파일 이름 패턴에서 파생됩니다. 정규 표현식 기반 패턴에서 파생된 분할된 논리적 엔티티는 지원되지 않습니다.

  3. OCI 데이터 카탈로그의 경우 논리적 엔티티는 하이브 스타일 또는 비하이브 폴더 형식을 따르는 분할된 데이터를 기반으로 합니다. 객체 이름을 사용하여 비하이브 스타일 형식을 따르는 분할된 데이터를 기반으로 하는 논리적 엔티티는 지원되지 않습니다.

    • 예 1. 접두어 기반 파일 이름 패턴으로 Hive 스타일 분할 형식을 따르는 수집된 객체를 기반으로 하는 논리적 엔티티입니다.

      다음 객체를 고려하십시오.

      Bucket: MYBUCKET
cluster1/db1.db/sales/country=USA/year=2020/month=01/sales1.csv
cluster1/db1.db/sales/country=USA/year=2020/month=01/sales2.csv
cluster1/db1.db/sales/country=USA/year=2020/month=02/sales1.csv

      시작 폴더 접두어가 cluster1/db1.db인 파일 이름 패턴을 사용하여 버킷을 수집하면 country, year 및 month의 세 분할 영역 속성을 가진 SALES라는 논리적 엔티티가 생성됩니다. 분할된 속성의 유형은 Partition이고 분할되지 않은 속성의 유형은 Primitive입니다.

    • 예 2. 접두어 기반 파일 이름 패턴을 사용하여 비Hive 스타일 분할 형식을 따르는 수집된 객체를 기반으로 하는 논리적 엔티티입니다.

      다음 객체를 고려하십시오.

      Bucket: MYBUCKET
cluster2/db2.db/sales/USA/2020/01/sales1.csv
cluster2/db2.db/sales/USA/2020/01/sales2.csv
cluster2/db2.db/sales/USA/2020/02/sales1.csv

      시작 폴더 접두어가 cluster2/db2.db인 파일 이름 패턴을 사용하여 버킷을 수집하면 name0, name1 및 name2의 세 분할 영역 속성을 가진 SALES라는 논리적 엔티티가 생성됩니다. 생성된 논리적 엔티티와 예제 1 간의 유일한 차이점은 분할된 속성의 이름이 자동 생성되고 예제 1에서는 URL(각각 country, year 및 month)에서 추출된다는 것입니다.

분할된 논리적 엔티티를 동기화하는 전체 엔드 투 엔드 예제는 예: 분할된 데이터 시나리오를 참조하십시오.

분할된 논리적 엔티티/글루 테이블의 증분 동기화

RUN_SYNC 프로시저에 대한 모든 호출은 데이터베이스와 동기화할 OCI 데이터 카탈로그 논리적 엔티티 또는 AWS Glue 테이블 집합을 지정합니다. 논리적 엔티티 또는 Glue 테이블이 두 개의 RUN_SYNC 호출에 있는 경우 두번째 호출은 기존 External Table을 보존하고 변경할 수 있습니다. 다음 표에서는 논리적 엔티티 또는 접착제 테이블이 분할될 때 지원되는 논리적 엔티티 또는 접착제 테이블 변경 사항을 보여줍니다.

논리적 엔티티 또는 접착제 테이블 변경 작업
분할 영역 추가, 제거 또는 업데이트 데이터 카탈로그에서 변경 사항을 감지했는지 여부에 관계없이 External Partitioned Table의 모든 Partition이 갱신됩니다.
분할된 속성 추가 분할된 열을 외부 분할 테이블에 추가하는 것은 지원되지 않습니다. 예외가 발생했습니다.
분할 영역 속성 삭제 외부 분할 테이블에서 분할된 열 삭제는 지원되지 않습니다. 예외가 발생했습니다.
분할된 속성 이름 바꾸기 분할된 외부 테이블에서 분할된 열의 이름 바꾸기는 지원되지 않습니다. 예외가 발생했습니다.

구문

PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );
PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    operation_id     OUT NOCOPY NUMBER,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );

매개변수

매개변수 설명
synced_objects

이 매개변수는 동기화할 데이터 카탈로그 객체를 지정하는 JSON 문서입니다.

OCI 데이터 카탈로그의 경우 JSON 문서는 데이터 자산, 폴더(객체 저장소 버킷) 또는 논리적 엔티티와 같은 여러 세분성의 엔티티 집합을 지정합니다. asset_list는 자산 객체 배열이거나 'sync all (object store) data assets in the catalog'를 나타내는 단일 "*" 문자열을 포함하는 배열입니다.

AWS Glue 데이터 카탈로그의 경우 JSON 문서는 데이터베이스, 테이블과 같은 여러 세분성의 테이블 목록을 지정합니다. 이 문서는 데이터베이스 목록을 지정합니다. 사용자는 데이터베이스 내에서 개별 테이블을 지정하여 동기화되도록 테이블 집합을 제한할 수 있습니다.
sync_option (옵션) 다음 세 가지 옵션이 제공됩니다.
  • SYNC(기본값) - 이 옵션은 synced_objects 범위를 통해 데이터 카탈로그에 있는 항목이 자율운영 AI 데이터베이스에 표시되도록 합니다. 마지막 동기화 작업 이후 논리적 엔티티 또는 접착제 테이블이 데이터 카탈로그에서 삭제된 경우 자율운영 AI 데이터베이스에서 삭제됩니다. synced_objects 범위에 대해 다음 작업이 수행됩니다.
    • 새 데이터 카탈로그 엔티티에 대한 테이블을 추가합니다.
    • 삭제된 데이터 카탈로그 엔티티에 대한 테이블을 제거합니다.
    • 기존 테이블에 대한 속성(예: 이름, 열 및 데이터 유형) 갱신
  • DELETE - synced_objects 범위 내에서 테이블을 삭제합니다.
  • REPLACE - 현재 동기화된 모든 객체를 synced_objects 범위 내의 객체로 바꿉니다.
error_semantics (선택 사항) 이 매개변수는 오류 동작을 지정합니다. SKIP_ERRORS로 설정하면 개별 엔티티에 오류가 발생하더라도 동기화를 계속하려고 시도합니다. STOP_ON_ERROR로 설정하면 첫번째로 발생한 오류에 대해 프로시저가 실패합니다. 기본값은 SKIP_ERRORS입니다.
log_level (선택 사항) 이 매개변수는 로깅 세부정보의 증가 레벨에서 다음 값을 지정합니다. (OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL) 기본값은 INFO입니다.
grant_read (선택 사항) 이 매개변수는 이 RUN_SYNC 호출로 처리되는 모든 외부 테이블에 대해 READ 권한이 자동으로 부여되는 사용자/롤 목록입니다. grant_read 목록의 모든 사용자/롤에는 synced_objects 매개변수로 지정된 엔티티에 해당하는 모든 새 외부 테이블 또는 기존 외부 테이블에 대한 READ 권한이 부여됩니다. RUN_SYNC 프로시저는 동기화된 외부 테이블에 대해 이미 부여된 권한을 유지합니다.
operation_id

(선택 사항) 이 매개변수는 동기화에 대한 USER_LOAD_OPERATIONS에서 해당 항목을 찾고 로그 테이블의 이름을 결정하는 데 사용됩니다.

주: 사용자가 USER_LOAD_OPERATIONS에서 최신 동기화를 질의할 수 있도록 operation_id를 반환하지 않는 RUN_SYNC 버전을 사용할 수 있습니다.

dcat_con_id 이 매개변수는 데이터 카탈로그에 대한 접속이 생성될 때 지정된 고유 데이터 카탈로그 접속 식별자입니다. SET_DATA_CATALOG_CONN 프로시저를 참조하십시오. 이 매개변수는 동기화에 사용되는 연결을 식별하며 파생된 스키마 이름의 일부가 됩니다. 스키마 이름이 파생되는 방법에 대한 설명은 동기화 매핑을 참조하십시오. 파라미터 기본값은 NULL입니다.

예

예: 모든 OCI 데이터 카탈로그 엔티티 동기화.

다음 예에서는 모든 데이터 카탈로그 엔티티가 동기화됩니다.

EXEC DBMS_DCAT.RUN_SYNC(synced_objects=>'{"asset_list":["*"]}');

예: 모든 OCI 데이터 카탈로그 데이터 자산을 동기화하기 위한 synced_objects 매개변수입니다.

다음은 데이터 카탈로그의 모든(오브젝트 스토리지) 데이터 자산을 동기화하기 위한 synced_objects 매개변수의 예입니다.

{"asset_list" : ["*"]}

예: 특정 OCI 데이터 카탈로그 데이터 자산을 동기화하기 위한 synced_objects 매개변수.

다음은 두 데이터 자산을 동기화하기 위한 synced_objects 매개변수의 예입니다.

{"asset_list": [
        {
            "asset_id":"...-9e2e7f78fd5f"
        },
        {
            "asset_id":"...-9e2e7f74523"
        }
    ]}

예: 데이터 자산 내에서 특정 OCI 데이터 카탈로그 엔티티를 동기화하기 위한 synced_objects 매개변수입니다.

다음은 데이터 자산 내의 두 엔티티를 동기화하기 위한 예제 synced_objects 매개변수를 보여줍니다.

{"asset_list": [
        {
            "asset_id":"...-9e2e7f78fd5f",
            "folder_list":[
                "f1",
                "f2"
           ]
        }
    ]}

예: 데이터 자산 내의 특정 OCI 데이터 카탈로그 폴더 및 엔티티를 동기화하기 위한 synced_objects 매개변수입니다.

다음은 데이터 자산 내에서 두 개의 폴더와 두 개의 엔티티를 동기화하기 위한 예제 synced_objects 매개변수를 보여줍니다.

{"asset_list":[
        {
            "asset_id":"...-9e2e7f78fd5f",
            "entity_list": [
                "entity1",
                "entity2"
            ],
             "folder_list": [
                "f1",
                "f2"
            ]
        }
    ]}

예: 모든 AWS 접착제 데이터 카탈로그 데이터베이스 동기화를 위한 synced_objects 매개변수.

다음은 AWS Glue 데이터 카탈로그의 모든 데이터베이스를 동기화하기 위한 예제 synced_objects 매개변수를 보여줍니다.

{"database_list":["*"]}

예: 2개의 AWS 접착제 데이터 카탈로그 데이터베이스 동기화를 위한 synced_objects 매개변수.

다음은 두 개의 AWS Glue Data Catalog 데이터베이스를 동기화하기 위한 예제 synced_objects 매개변수를 보여줍니다.

{"database_list":[
    {"database":"tpcdscsv"},
    {"database":"tpcdsparquet"} ]}

예: 3개의 AWS 접착제 데이터 카탈로그 데이터베이스 동기화를 위한 synced_objects 매개변수.

다음은 AWS Glue Data Catalog 데이터베이스에서 세 개의 테이블을 동기화하기 위한 예제 synced_objects 매개변수를 보여줍니다.

{"database_list":[
 {"database":"tpcdsparquet",
     "table_list": [ "tpcdsparquet_customer",
                     "tpcdsparquet_item",
                     "tpcdsparquet_web_sales" ] } ]}

CREATE_SYNC_JOB 프로시저

이 프로시저는 정기적으로 RUN_SYNC를 호출하는 스케줄러 작업을 생성합니다.

동기화할 객체 집합, 오류 의미, 로그 레벨 및 반복 간격을 입력으로 사용합니다. 동기화 작동 방식에 대한 자세한 내용은 RUN_SYNC Procedure를 참조하십시오.

단일 동기화 작업만 있을 수 있습니다. force 매개변수가 TRUE로 설정되지 않은 경우 다른 작업이 이미 지정된 경우 CREATE_SYNC_JOB 프로시저가 실패합니다. force가 TRUE로 설정된 경우 이전 작업이 삭제됩니다.

다른 동기화가 진행 중인 동안 스케줄러 작업을 실행하려고 하면 스케줄러 작업이 실패합니다.

주: 2022년 4월 4일에는 sync_option 및 grant_read 매개변수가 DBMS_DCAT.RUN_SYNC 프로시저에 추가되었습니다. 해당 일자 이전에 생성된 스케줄링된 동기화 작업의 정확한 성능을 보장하려면 스케줄링된 동기화 작업을 삭제하고 재생성해야 합니다. DROP_SYNC_JOB 프로시저 및 CREATE_SYNC_JOB 프로시저를 참조하십시오.

구문

PROCEDURE DBMS_DCAT.CREATE_SYNC_JOB (
    synced_objects   IN CLOB,
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    repeat_interval  IN VARCHAR2,
    force            IN VARCHAR2 DEFAULT 'FALSE',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
);

매개변수

매개변수 설명
synced_objects RUN_SYNC 프로시저에 설명된 대로 동기화할 객체를 지정하는 JSON 객체입니다. RUN_SYNC Procedure를 참조하십시오.
error_semantics (선택 사항) RUN_SYNC에 대해 지정된 오류 동작입니다. 기본값은 SKIP_ERRORS입니다.
log_level (선택 사항) RUN_SYNC에 대해 지정된 로깅 레벨입니다. 기본값은 INFO입니다.
repeat_interval DBMS_SCHEDULER.CREATE_JOB 프로시저의 반복 간격 매개변수와 동일한 의미로 작업에 대해 간격을 반복합니다. repeat_interval에 대한 자세한 내용은 작업 생성 개요를 참조하십시오.
force (선택 사항) TRUE인 경우 기존 동기화 작업이 먼저 삭제됩니다. FALSE인 경우 동기화 작업이 이미 있으면 CREATE_SYNC_JOB 프로시저가 실패합니다. 기본값은 FALSE입니다.
grant_read (선택 사항) 절차 RUN_SYNC에 설명된 대로 동기화된 외부 테이블에서 READ를 부여할 사용자/역할 목록입니다. RUN_SYNC Procedure를 참조하십시오.
sync_option (선택 사항) RUN_SYNC 절차에 설명된 대로 이전 RUN_SYNC 작업을 통해 이미 동기화된 엔티티에 대한 동작입니다. RUN_SYNC Procedure를 참조하십시오.
dcat_con_id 이 매개변수는 데이터 카탈로그에 대한 접속이 생성될 때 지정된 고유한 데이터 카탈로그 접속 식별자입니다. SET_DATA_CATALOG_CONN 프로시저를 참조하십시오. 이 매개변수는 동기화에 사용되는 연결을 식별하며 파생된 스키마 이름의 일부가 됩니다. 스키마 이름이 파생되는 방법에 대한 설명은 동기화 매핑을 참조하십시오. 파라미터 기본값은 NULL입니다.

DROP_SYNC_JOB 프로시저

이 프로시저는 제공된 고유 연결 식별자에 대한 기존 동기화 작업을 삭제합니다.

구문

PROCEDURE DBMS_DCAT.DROP_SYNC_JOB (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

매개변수

매개변수 설명
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 기본값은 NULL입니다.

DROP_SYNCED_SCHEMAS 프로시저

이 프로시저는 제공된 고유 연결 식별자에 대해 이전에 동기화된 스키마를 모두 삭제합니다.

구문

PROCEDURE DBMS_DCAT.DROP_SYNCED_SCHEMAS (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

매개변수

매개변수 설명
dcat_con_id 고유한 데이터 카탈로그 접속 식별자입니다. 기본값은 NULL입니다.