EXPORT_DATA에 대한 DBMS_CLOUD 패키지 형식 옵션

텍스트 파일 형식, CSV, JSON 또는 XML을 사용하는 DBMS_CLOUD.EXPORT_DATA에 대해 적합한 형식 매개변수 옵션을 설명합니다.

DBMS_CLOUD.EXPORT_DATA와 함께 사용할 수 있는 적합한 format 매개변수입니다. format type 옵션을 사용하고 값이 csv, json, parquet 또는 xml 중 하나인 경우 텍스트 파일 출력을 지정합니다.

형식 인수를 지정하는 두 가지 방법은 다음과 같습니다.

format => '{"format_option" : "format_value" }'

and

format => json_object('format_option' value 'format_value')

예를 들면 다음과 같습니다.

format => json_object('type' VALUE 'json')

여러 형식 옵션을 지정하려면 값을 ","로 구분합니다.

예:

format => json_object('compression' value 'gzip', 'type' value 'json')

이 표에서는 format 매개변수 type 옵션이 CSV, JSON, Parquet 또는 XML 중 하나인 경우 DBMS_CLOUD.EXPORT_DATA에 대한 형식 옵션을 다룹니다. 기타 프로시저 및 기타 출력 유형의 경우 형식 옵션 목록은 DBMS_CLOUD Package Format Options을 참조하십시오.

형식 옵션	설명	구문
compression	소스 파일의 압축 유형을 지정합니다. 주: ZIP 아카이브 형식은 지원되지 않습니다. format type가 csv, json 또는 xml인 경우 기본 압축은 Null이며 압축이 없음을 의미합니다. format type가 parquet인 경우 기본 압축은 snappy입니다.	type가 다음과 같은 경우:csv | json | xml compression: gzip 기본값: Null 값은 압축 없음을 의미합니다. type가 parquet인 경우 compression: gzip | snappy 기본값: snappy
delimiter	사용자정의 필드 구분자를 지정합니다. format => json_object('delimiter' value '|') 구분자 값은 ASCII 코드 또는 이스케이프 문자일 수 없습니다. 주: 이 옵션은 csv type에만 적용됩니다.	delimiter : 문자 기본값 (쉼표)
endquote	필드가 quote 및 endquote를 사용하여 두 구분자 사이에 묶일 수 있도록 지정합니다. endquote가 지정되지 않은 경우 quote 문자가 기본적으로 endquote 문자로 사용됩니다. 예: format => JSON_OBJECT('quote' value '(' , 'endquote' value ')') 주: 이 옵션은 csv type에만 적용됩니다.	endquote: 문자 기본값: Null, 즉 endquote가 없습니다.
escape	"\\" 문자를 사용하여 필드 값에서 따옴표 문자 발생을 지정합니다. 주: 이 옵션은 csv type에만 적용됩니다.	escape : true 기본값: false
encryption	형식 옵션 encryption은 객체 저장소에서 데이터를 익스포트 및 임포트할 암호화 및 해독 옵션을 지정합니다. encryption를 사용하여 암호화 및 해독할 다음 매개변수를 지정합니다. user_defined_function: 지정된 BLOB(이진 대형 객체)를 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. 암호 해독되거나 암호화된 BLOB를 반환합니다. 이 매개변수는 encryption에 대한 다른 매개변수와 함께 사용할 수 없습니다. 예: ADMIN.DECRYPTION_CALLBACK. type: 해독 또는 암호화할 내장 암호화 알고리즘을 지정합니다. user_defined_function 및 type는 상호 배타적입니다. type는 블록 암호화 알고리즘 + 블록 암호화 체인 수정자 + 블록 암호화 패딩 수정자 형식의 값을 허용합니다. 지원되는 블록 암호화 알고리즘은 다음과 같습니다. DBMS_CRYPTO.ENCRYPT_AES256 지원되는 블록 암호화 체인 수정자는 다음과 같습니다. DBMS_CRYPTO.CHAIN_CBC DBMS_CRYPTO.CHAIN_CFB DBMS_CRYPTO.CHAIN_ECB DBMS_CRYPTO.CHAIN_OFB 지원되는 블록 암호 패딩 수정자는 다음과 같습니다. DBMS_CRYPTO.PAD_PKCS5 DBMS_CRYPTO.PAD_NONE DBMS_CRYPTO.PAD_ZERO DBMS_CRYPTO.PAD_ORCL credential_name: 암호화 키를 저장하는 데 사용되는 인증서를 지정합니다. 이러한 매개변수에 값을 지정하지 않은 경우 블록 암호화 체인 수정자 및 블록 암호화 패딩 수정자 값은 기본적으로 DBMS_CRYPTO.CHAIN_CBC 및 DBMS_CRYPTO.PAD_PKCS5로 설정됩니다. 형식 옵션 encryption는 다음 DBMS_CLOUD 프로시저와 함께 사용됩니다. 다음 프로시저에 대해 해독할 매개변수를 전달하는 데 사용됩니다. DBMS_CLOUD.COPY_DATA DBMS_CLOUD.CREATE_EXTERNAL_TABLE DBMS_CLOUD.CREATE_HYBRID_TABLE DBMS_CLOUD.COPY_COLLECTION 다음 프로시저에 대해 암호화할 매개변수를 전달하는 데 사용됩니다. DBMS_CLOUD.EXPORT_DATA 예: format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED'))	encryption:value 여기서 value는 암호화를 위한 추가 매개변수를 제공하는 JSON 문자열입니다. type: 값 암호화 유형을 지정합니다. credential_name: value 암호화 키를 저장하는 데 사용되는 인증서를 지정합니다. user_defined_function: value 지정된 BLOB(binary large object)를 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다.
header	csv 유형의 출력 파일에서 열 이름을 첫번째 행으로 씁니다. header 옵션은 boolean 또는 string 값을 사용할 수 있습니다. 적합한 값은 다음과 같습니다. false: 머리글 행을 건너뜁니다. true: 머리글 행을 포함합니다. 열 이름은 query 매개변수의 SELECT 문을 기반으로 합니다. 가상 열 또는 표현식을 사용할 때는 SELECT 문에서 열 별칭을 지정해야 합니다. String to define custom header names: 사용자정의 이름으로 머리글 행을 정의할 수 있습니다. 문자열 값의 열 및 구분자 수는 SELECT 문의 열 및 구분자 수와 일치해야 합니다. 기본 구분자는 쉼표(,)입니다. 예: format => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true) 주: 이 옵션은 csv type에만 적용됩니다.	header: true| false| String to define custom header names 기본값: false
fileextension	형식 유형에 대한 기본 선택을 대체하는 사용자정의 파일 확장자입니다. CSV, JSON, Parquet 또는 XML과 같은 DBMS_CLOUD.EXPORT_DATA의 텍스트 형식에 적용됩니다. 지정된 문자열이 마침표(점)로 시작하지 않으면 최종 파일 이름의 파일 확장자 앞에 점이 자동으로 삽입됩니다. 파일 확장자가 필요하지 않은 경우 fileextension ='none' 값을 사용합니다.	유효한 값: 임의의 파일 확장자. 기본값: format type 옵션에 따라 달라집니다. CSV 형식: .csv JSON 형식: .json PARQUET 형식 : .parquet XML 형식: .xml
maxfilesize	생성된 최대 출력 크기에 대한 바이트 수입니다. 이는 format type 옵션이 csv, json 또는 xml로 설정된 경우 DBMS_CLOUD.EXPORT_DATA를 사용하여 데이터를 익스포트하기 위한 텍스트 기반 형식에 적용됩니다. 주: format type 옵션이 parquet인 경우 이 옵션은 적합하지 않습니다.	최소값: 10485760 (10 MB ) 최대값: 1GB 기본값은 10485760(10MB)입니다.
quote	CSV 형식에서는 두 구분자로 필드를 묶을 수 있습니다. quote 및 endquote로 구분자를 지정합니다. endquote가 지정되지 않은 경우 quote 문자가 기본적으로 endquote 문자로 사용됩니다. 주: 이 옵션은 csv type에만 적용됩니다.	quote: 문자 기본값: Null 의미는 필드를 따옴표로 묶지 않습니다.
trimspaces	CSV 형식에 대해 필드의 선행 및 후행 공백을 자르는 방식을 지정합니다. quote 매개변수가 지정된 경우 필드를 인용하기 전에 자르기 공백이 적용됩니다. Oracle Database 19c Utilities 또는 Oracle Database 26ai Utilities에서 trim_spec에 대한 설명을 참조하십시오. 주: 이 옵션은 csv type에만 적용됩니다.	trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim 기본값: notrim
type	출력 파일 유형을 지정합니다. csv: 사용자정의 문자로 구분된 열 값 집합으로 질의 결과를 익스포트할 수 있도록 해주는 CSV(문자 구분 값) 형식을 지정합니다. json: 질의 결과를 JSON 파일로 익스포트하도록 지정합니다. parquet: 질의 결과를 Parquet 파일로 익스포트하도록 지정합니다. xml: 질의 결과를 적합한 XML 문서의 행으로 익스포트하도록 지정합니다. 각 행은 의 루트 XML 태그로 캡슐화됩니다. 질의 결과는 XMLFOREST SQL 함수를 사용하여 자동으로 XML 형식으로 변환됩니다. 열 별칭을 사용하여 열에 대한 XML 태그 이름을 사용자정의합니다. 자세한 내용은 Oracle Database 19c Utilities 또는 Oracle Database 26ai Utilities의 access_parameters Clause를 참조하십시오.	type: csv|datapump|json|parquet|xml

관련 콘텐츠

EXPORT_DATA 프로시저