대량 파일 관리를 위한 DBMS

하위 프로그램	설명
BULK_COPY 프로시저	이 절차에서는 한 클라우드 오브젝트 스토리지 버킷의 파일을 다른 버킷으로 복사합니다.
BULK_DELETE 프로시저	이 절차에서는 클라우드 오브젝트 스토리지 버킷 또는 폴더에서 파일을 삭제합니다.
BULK_DOWNLOAD 프로시저	이 절차에서는 클라우드 객체 저장소 버킷의 파일을 Autonomous Database의 디렉토리로 다운로드합니다.
BULK_MOVE 프로시저	이 절차에서는 클라우드 오브젝트 스토리지 버킷 간에 파일을 이동합니다.
BULK_UPLOAD 프로시저	이 절차에서는 Autonomous Database의 디렉토리에서 클라우드 오브젝트 스토리지로 파일을 업로드합니다.

필요 조건

개발자는 Oracle Public Cloud, 멀티클라우드 또는 Exadata Cloud@Customer에 배포된 Autonomous Database에서 DBMS_CLOUD 절차를 사용할 수 있습니다.

배포 선택에 따라 Amazon S3, Azure Blob Storage 및 Google Cloud Storage 서비스 제공업체와 함께 DBMS_CLOUD 절차를 사용하려면 다음 필요 조건이 충족되어야 합니다.

Oracle Public Cloud 또는 멀티클라우드
Exadata Cloud@Customer

플리트 관리자가 아래 설명된 대로 NAT 게이트웨이를 사용하여 아웃바운드 접속을 구성해야 합니다.

Oracle Cloud Infrastructure 문서의 NAT 게이트웨이 생성 지침에 따라 Autonomous Database 리소스가 상주하는 VCN(가상 클라우드 네트워크)에서 NAT 게이트웨이를 생성합니다.
NAT 게이트웨이를 생성한 후 각 서브넷(VCN 내)에 경로 규칙 및 송신 보안 규칙을 추가합니다. 여기서 Autonomous Database 리소스는 게이트웨이를 사용하여 Azure AD 인스턴스에서 퍼블릭 키를 얻을 수 있습니다.
1. 서브넷의 서브넷 세부 정보 페이지로 이동합니다.
2. 서브넷 정보 탭에서 서브넷의 경로 테이블 이름을 눌러 경로 테이블 세부정보 페이지를 표시합니다.
3. 기존 경로 규칙의 테이블에서 다음 특성을 가진 규칙이 이미 있는지 확인합니다.
  - 대상: 0.0.0.0/0
  - 대상 유형: NAT 게이트웨이
  - 대상: VCN에서 방금 생성한 NAT 게이트웨이의 이름입니다.
  해당 규칙이 없는 경우 경로 규칙 추가를 누르고 해당 특성을 가진 경로 규칙을 추가합니다.
4. 서브넷에 대한 서브넷 세부정보 페이지로 돌아갑니다.
5. 서브넷의 보안 목록 테이블에서 서브넷의 보안 목록 이름을 눌러 해당 보안 목록 세부정보 페이지를 표시합니다.
6. 사이드 메뉴의 리소스에서 송신 규칙을 누릅니다.
7. 기존 송신 규칙의 테이블에서 다음 특성을 가진 규칙이 이미 있는지 확인합니다.
  - 대상 유형: CIDR
  - 대상: 0.0.0.0/0
  - IP 프로토콜: TCP
  - 소스 포트 범위: 443
  - 대상 포트 범위: 모두
  해당 규칙이 없으면 Add Egress Rules를 누르고 이러한 특성을 가진 송신 규칙을 추가합니다.

환경의 HTTP 프록시 설정에서 데이터베이스가 클라우드 서비스 공급자에 액세스할 수 있도록 허용해야 합니다.

해당 설정은 콘솔을 사용하여 Cloud@Customer에서 Exadata Database Service 프로비전에 설명된 대로 Exadata Cloud@Customer 인프라를 생성하는 동안 플리트 관리자가 정의합니다.

주:

HTTP 프록시를 포함한 네트워크 구성은 Exadata 인프라가 활성화 필요 상태가 될 때까지만 편집할 수 있습니다. 활성화된 후에는 해당 설정을 편집할 수 없습니다.

이미 프로비전된 Exadata 인프라에 대해 HTTP 프록시를 설정하려면 My Oracle Support에서 SR(서비스 요청)이 필요합니다. 자세한 내용은 My Oracle Support에서 서비스 요청 생성을 참조하십시오.

BULK_COPY 프로시저

이 절차에서는 한 클라우드 오브젝트 스토리지 버킷의 파일을 다른 버킷으로 대량 복사합니다. 오버로드된 폼에서는 operation_id 매개변수를 사용할 수 있습니다.

REGEXP_LIKE 연산자와 호환되는 정규 표현식 패턴을 사용하여 삭제할 파일 목록을 필터링할 수 있습니다.

소스 및 대상 버킷 또는 폴더는 동일하거나 다른 클라우드 객체 저장소 제공자에 있을 수 있습니다.

소스와 대상이 고유 객체 저장소에 있거나 동일한 클라우드 제공자의 계정이 다른 경우 소스 및 대상 위치에 대해 별도의 인증서 이름을 지정할 수 있습니다.

소스 인증서 이름은 기본적으로 대상 위치에서도 사용됩니다.

구문

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

매개변수

매개변수	설명
`source_credential_name`	클라우드 객체 스토리지에 액세스할 인증서의 이름입니다. `source_credential_name` 값을 제공하지 않으면 `credential_name`가 `NULL`로 설정됩니다.
`source_location_uri`	소스 오브젝트 스토리지 버킷 또는 폴더 위치를 가리키는 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`target_location_uri`	파일을 복사해야 하는 대상 오브젝트 스토리지 버킷 또는 폴더에 대한 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`target_credential_name`	대상 클라우드 객체 스토리지 위치에 액세스할 인증서의 이름입니다. `target_credential_name` 값을 제공하지 않으면 `target_location_uri`가 `source_credential_name` 값으로 설정됩니다.
`regex_filter`	파일을 필터링할 REGEX 표현식을 지정합니다. REGEX 표현식 패턴은 `REGEXP_LIKE` 연산자와 호환되어야 합니다. `regex_filter` 값을 제공하지 않으면 `regex_filter`가 `NULL`로 설정됩니다. 자세한 내용은 REGEXP_LIKE 조건을 참조하십시오.
`format`	파일 작업에 대한 추가 구성 옵션을 지정합니다. 이러한 옵션은 JSON 문자열로 지정됩니다. 지원되는 형식 옵션은 다음과 같습니다. `logretention`: 대량 작업에 대해 상태 테이블이 보존되는 기간(일)을 결정하는 정수 값을 사용합니다. 기본값은 2일입니다. `logprefix`: 대량 작업 상태 테이블 이름 접두어 문자열을 결정하는 문자열 값을 받아들입니다. 작업 유형이 기본값입니다. `BULK_COPY`의 경우 기본 `logprefix` 값은 `COPYOBJ`입니다. `priority`: 동시에 수행되는 파일 작업 수를 결정하는 문자열 값을 허용합니다. 우선 순위가 높은 작업은 더 많은 데이터베이스 리소스를 소비하므로 더 빠르게 실행됩니다. 이 매개변수는 다음 값을 받아들입니다. `HIGH`: 데이터베이스의 ECPU 개수(데이터베이스에서 OCPU를 사용하는 경우 OCPU 개수)를 사용하여 처리된 병렬 파일 개수를 결정합니다. `MEDIUM`: 중간 서비스에 대한 동시성 제한을 사용하는 동시 프로세스 수를 결정합니다. 기본값은 4입니다. `LOW`: 파일을 순차적으로 처리합니다. 기본값은 `MEDIUM`입니다. 최대 동시 파일 작업 수는 64개로 제한됩니다. `format` 값을 제공하지 않으면 `format`가 `NULL`로 설정됩니다.
`operation_id`	이 매개변수를 사용하여 로드 작업의 진행률 및 최종 상태를 `USER_LOAD_OPERATIONS` 뷰의 해당 ID로 추적할 수 있습니다.

사용법 참고

소스 및 대상 URI가 동일한 오브젝트 스토리지 버킷 또는 폴더를 가리킬 때 오류가 반환됩니다.

예

BEGIN 
DBMS_CLOUD.BULK_COPY (
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format       => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
);
END;
/

BULK_DELETE 프로시저

이 절차에서는 클라우드 오브젝트 스토리지에서 파일을 대량 삭제합니다. 오버로드된 폼에서는 operation_id 매개변수를 사용할 수 있습니다. REGEXP_LIKE 연산자와 호환되는 정규 표현식 패턴을 사용하여 삭제할 파일 목록을 필터링할 수 있습니다.

구문

 DBMS_CLOUD.BULK_DELETE(
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DELETE (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

매개변수

매개변수	설명
`credential_name`	클라우드 객체 스토리지에 액세스할 인증서의 이름입니다. `credential_name` 값을 제공하지 않으면 `credential_name`가 `NULL`로 설정됩니다.
`location_uri`	Autonomous Database에서 Object Storage 위치를 가리키는 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`regex_filter`	파일을 필터링할 REGEX 표현식을 지정합니다. REGEX 표현식 패턴은 `REGEXP_LIKE` 연산자와 호환되어야 합니다. `regex_filter` 값을 제공하지 않으면 `regex_filter`가 `NULL`로 설정됩니다. 자세한 내용은 REGEXP_LIKE 조건을 참조하십시오.
`format`	파일 작업에 대한 추가 구성 옵션을 지정합니다. 이러한 옵션은 JSON 문자열로 지정됩니다. 지원되는 형식 옵션은 다음과 같습니다. `logretention`: 대량 작업에 대해 상태 테이블이 보존되는 기간(일)을 결정하는 정수 값을 사용합니다. 기본값은 2일입니다. `logprefix`: 대량 작업 상태 테이블 이름 접두어 문자열을 결정하는 문자열 값을 받아들입니다. 작업 유형이 기본값입니다. `BULK_DELETE`의 경우 기본 `logprefix` 값은 `DELETE`입니다. `priority`: 동시에 수행되는 파일 작업 수를 결정하는 문자열 값을 허용합니다. 우선 순위가 높은 작업은 더 많은 데이터베이스 리소스를 소비하며 더 빨리 완료됩니다. 이 매개변수는 다음 값을 받아들입니다. `HIGH`: 데이터베이스의 ECPU 개수(데이터베이스에서 OCPU를 사용하는 경우 OCPU 개수)를 사용하여 처리된 병렬 파일 수를 결정합니다. `MEDIUM`: 중간 서비스에 대한 동시성 제한을 사용하는 동시 프로세스 수를 결정합니다. 기본값은 4입니다. `LOW`: 파일을 순차적으로 처리합니다. 기본값은 `MEDIUM`입니다. 최대 동시 파일 작업 수는 64개로 제한됩니다. `format` 값을 제공하지 않으면 `format`가 `NULL`로 설정됩니다.
`operation_id`	이 매개변수를 사용하여 로드 작업의 진행률 및 최종 상태를 `USER_LOAD_OPERATIONS` 뷰의 해당 ID로 추적할 수 있습니다.

예

BEGIN
DBMS_CLOUD.BULK_DELETE (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKDEL')
);
END;
/

BULK_DOWNLOAD 프로시저

이 절차에서는 Cloud Object Storage에서 파일을 Autonomous Database 디렉토리로 다운로드합니다. 오버로드된 폼에서는 operation_id 매개변수를 사용할 수 있습니다. REGEXP_LIKE 연산자와 호환되는 정규 표현식 패턴을 사용하여 다운로드할 파일 목록을 필터링할 수 있습니다.

구문

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

매개변수

매개변수	설명
`credential_name`	클라우드 객체 스토리지에 액세스할 인증서의 이름입니다. `credential_name` 값을 제공하지 않으면 `credential_name`가 `NULL`로 설정됩니다.
`location_uri`	Autonomous Database에서 Object Storage 위치를 가리키는 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`directory_name`	파일을 다운로드할 Autonomous Database의 디렉토리 이름입니다. 이 매개변수는 필수입니다.
`regex_filter`	파일을 필터링할 REGEX 표현식을 지정합니다. REGEX 표현식 패턴은 `REGEXP_LIKE` 연산자와 호환되어야 합니다. `regex_filter` 값을 제공하지 않으면 `regex_filter`가 `NULL`로 설정됩니다. 자세한 내용은 REGEXP_LIKE 조건을 참조하십시오.
`format`	파일 작업에 대한 추가 구성 옵션을 지정합니다. 이러한 옵션은 JSON 문자열로 지정됩니다. 지원되는 형식 옵션은 다음과 같습니다. `logretention`: 대량 작업에 대해 상태 테이블이 보존되는 기간(일)을 결정하는 정수 값을 사용합니다. 기본값은 2일입니다. `logprefix`: 대량 작업 상태 테이블 이름 접두어 문자열을 결정하는 문자열 값을 받아들입니다. `BULK_DOWNLOAD`의 경우 기본 `logprefix` 값은 `DOWNLOAD`입니다. 작업 유형이 기본값입니다. `priority`: 동시에 수행되는 파일 작업 수를 결정하는 문자열 값을 허용합니다. 우선 순위가 높은 작업은 더 많은 데이터베이스 리소스를 소비하며 더 빨리 완료됩니다. 이 매개변수는 다음 값을 받아들입니다. `HIGH`: 데이터베이스의 ECPU 개수(데이터베이스에서 OCPU를 사용하는 경우 OCPU 개수)를 사용하여 처리된 병렬 파일 수를 결정합니다. `MEDIUM`: 중간 서비스에 대한 동시성 제한을 사용하는 동시 프로세스 수를 결정합니다. 기본값은 4입니다. `LOW`: 파일을 순차적으로 처리합니다. 기본값은 `MEDIUM`입니다. 최대 동시 파일 작업 수는 64개로 제한됩니다. `format` 값을 제공하지 않으면 `format`가 `NULL`로 설정됩니다.
`operation_id`	이 매개변수를 사용하여 로드 작업의 진행률 및 최종 상태를 `USER_LOAD_OPERATIONS` 뷰의 해당 ID로 추적할 수 있습니다.

예

BEGIN
DBMS_CLOUD.BULK_DOWNLOAD (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
 );
END;
/

BULK_MOVE 프로시저

이 절차에서는 클라우드 오브젝트 스토리지 버킷 또는 폴더 간에 파일을 대량으로 이동합니다. 오버로드된 폼에서는 operation_id 매개변수를 사용할 수 있습니다.

REGEXP_LIKE 연산자와 호환되는 정규 표현식 패턴을 사용하여 삭제할 파일 목록을 필터링할 수 있습니다.

소스 및 대상 버킷 또는 폴더는 동일하거나 다른 클라우드 객체 저장소 제공자에 있을 수 있습니다.

소스와 대상이 고유 객체 저장소에 있거나 동일한 클라우드 제공자의 계정이 다른 경우 소스 및 대상 위치에 대해 별도의 인증서 이름을 지정할 수 있습니다.

소스 인증서 이름은 기본적으로 대상 인증서 이름이 제공되지 않은 경우 대상 위치에서도 사용됩니다.

파일을 이동하는 첫 번째 단계는 파일을 대상 위치로 복사한 다음 소스 파일을 성공적으로 복사한 후 삭제하는 것입니다.

객체 저장소에서 소스와 대상 위치 간의 이름 바꾸기 작업을 허용하는 경우 객체 이름이 이동되지 않고 이름이 바뀝니다.

구문

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

매개변수

매개변수	설명
`source_credential_name`	소스 클라우드 객체 스토리지에 액세스할 인증서의 이름입니다. `source_credential_name` 값을 제공하지 않으면 `credential_name`가 `NULL`로 설정됩니다.
`source_location_uri`	소스 오브젝트 스토리지 버킷 또는 폴더 위치를 가리키는 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`target_location_uri`	파일을 이동해야 하는 대상 오브젝트 스토리지 버킷 또는 폴더에 대한 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`target_credential_name`	대상 클라우드 객체 스토리지 위치에 액세스할 인증서의 이름입니다. `target_credential_name` 값을 제공하지 않으면 `target_location_uri`가 `source_credential_name` 값으로 설정됩니다.
`regex_filter`	파일을 필터링할 REGEX 표현식을 지정합니다. REGEX 표현식 패턴은 `REGEXP_LIKE` 연산자와 호환되어야 합니다. `regex_filter` 값을 제공하지 않으면 `regex_filter`가 `NULL`로 설정됩니다. 자세한 내용은 REGEXP_LIKE 조건을 참조하십시오.
`format`	파일 작업에 대한 추가 구성 옵션을 지정합니다. 이러한 옵션은 JSON 문자열로 지정됩니다. 지원되는 형식 옵션은 다음과 같습니다. `logretention`: 대량 작업에 대해 상태 테이블이 보존되는 기간(일)을 결정하는 정수 값을 사용합니다. 기본값은 2일입니다. `logprefix`: 대량 작업 상태 테이블 이름 접두어 문자열을 결정하는 문자열 값을 받아들입니다. 작업 유형이 기본값입니다. `BULK_MOVE`의 경우 기본 `logprefix` 값은 `MOVE`입니다. `priority`: 동시에 수행되는 파일 작업 수를 결정하는 문자열 값을 허용합니다. 우선 순위가 높은 작업은 더 많은 데이터베이스 리소스를 소비하며 더 빨리 완료됩니다. 이 매개변수는 다음 값을 받아들입니다. `HIGH`: 데이터베이스의 ECPU 개수(데이터베이스에서 OCPU를 사용하는 경우 OCPU 개수)를 사용하여 처리된 병렬 파일 수를 결정합니다. `MEDIUM`: 중간 서비스에 대한 동시성 제한을 사용하는 동시 프로세스 수를 결정합니다. 기본값은 4입니다. `LOW`: 파일을 순차적으로 처리합니다. 기본값은 `MEDIUM`입니다. 최대 동시 파일 작업 수는 64개로 제한됩니다. `format` 값을 제공하지 않으면 `format`가 `NULL`로 설정됩니다.
`operation_id`	이 매개변수를 사용하여 로드 작업의 진행률 및 최종 상태를 `USER_LOAD_OPERATIONS` 뷰의 해당 ID로 추적할 수 있습니다.

예

BEGIN 
DBMS_CLOUD.BULK_MOVE (    
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format                 => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKMOVE')
);
END;
/

주:

소스 및 대상 URI가 동일한 오브젝트 스토리지 버킷 또는 폴더를 가리킬 때 오류가 반환됩니다.

BULK_UPLOAD 프로시저

이 절차는 Autonomous Database 디렉토리에서 Cloud Object Storage로 파일을 복사합니다. 오버로드된 폼에서는 operation_id 매개변수를 사용할 수 있습니다.

구문

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

매개변수

매개변수	설명
`credential_name`	클라우드 객체 스토리지에 액세스할 인증서의 이름입니다. `credential_name` 값을 제공하지 않으면 `credential_name`가 `NULL`로 설정됩니다.
`location_uri`	파일을 업로드할 오브젝트 스토리지 위치를 가리키는 URI를 지정합니다. 이 매개변수는 필수입니다. URI의 형식은 클라우드 객체 스토리지 서비스에 따라 다릅니다. 자세한 내용은 DBMS_CLOUD Package File Cloud Object Storage URI Formats를 참조하십시오.
`directory_name`	파일을 업로드하는 Autonomous Database의 디렉토리 이름입니다. 이 매개변수는 필수입니다.
`regex_filter`	파일을 필터링할 REGEX 표현식을 지정합니다. REGEX 표현식 패턴은 `REGEXP_LIKE` 연산자와 호환되어야 합니다. `regex_filter` 값을 제공하지 않으면 `regex_filter`가 `NULL`로 설정됩니다. 자세한 내용은 REGEXP_LIKE 조건을 참조하십시오.
`format`	파일 작업에 대한 추가 구성 옵션을 지정합니다. 이러한 옵션은 JSON 문자열로 지정됩니다. 지원되는 형식 옵션은 다음과 같습니다. `logretention`: 대량 작업에 대해 상태 테이블이 보존되는 기간(일)을 결정하는 정수 값을 사용합니다. 기본값은 2일입니다. `logprefix`: 대량 작업 상태 테이블 이름 접두어 문자열을 결정하는 문자열 값을 받아들입니다. 작업 유형이 기본값입니다. `BULK_UPLOAD`의 경우 기본 `logprefix` 값은 `UPLOAD`입니다. `priority`: 동시에 수행되는 파일 작업 수를 결정하는 문자열 값을 허용합니다. 우선 순위가 높은 작업은 더 많은 데이터베이스 리소스를 소비하며 더 빨리 완료됩니다. 이 매개변수는 다음 값을 받아들입니다. `HIGH`: 데이터베이스의 ECPU 개수(데이터베이스에서 OCPU를 사용하는 경우 OCPU 개수)를 사용하여 처리된 병렬 파일 수를 결정합니다. `MEDIUM`: 중간 서비스에 대한 동시성 제한을 사용하는 동시 프로세스 수를 결정합니다. 기본값은 4입니다. `LOW`: 파일을 순차적으로 처리합니다. 기본값은 `MEDIUM`입니다. 최대 동시 파일 작업 수는 64개로 제한됩니다. `format` 값을 제공하지 않으면 `format`가 `NULL`로 설정됩니다.
`operation_id`	이 매개변수를 사용하여 로드 작업의 진행률 및 최종 상태를 `USER_LOAD_OPERATIONS` 뷰의 해당 ID로 추적할 수 있습니다.

예

BEGIN
DBMS_CLOUD.BULK_UPLOAD ( 
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKUPLOAD')
 );
END;
/