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

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

이러한 매개변수는 DBMS_CLOUD.EXPORT_DATA에 사용할 수 있는 유효한 format 매개변수입니다. format type 옵션을 사용하고 값이 csv, json, parquet 또는 xml 중 하나일 때 텍스트 파일 출력을 지정합니다.

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

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

및:

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

기본값: 압축 없음을 의미하는 널 값입니다.

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:문자

기본값: 널, endquote를 의미하지 않습니다.

escape

"\" 문자를 사용하여 필드 값에서 따옴표 문자의 발생을 지정합니다.

주:

이 옵션은 csv type에만 적용됩니다.

escape : true

기본값: false

encryption

형식 옵션 encryption는 객체 저장소에서 데이터를 익스포트하고 임포트할 암호화 및 해독 옵션을 지정합니다.

다음 매개변수를 지정하여 암호화 및 해독하려면 encryption를 사용합니다.

  • user_defined_function: 지정된 BLOB(이진 LOB)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. 해독되거나 암호화된 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: value

암호화 유형을 지정합니다.

credential_name: value

암호화 키를 저장하는 데 사용되는 인증서를 지정합니다.

user_defined_function: value

지정된 BLOB(이진 LOB)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다.

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

형식 유형에 대한 기본 선택을 대체하는 사용자정의 파일 확장자입니다. DBMS_CLOUD.EXPORT_DATA를 사용하는 텍스트 형식(CSV, JSON, Parquet 또는 XML)에 적용됩니다.

지정된 문자열이 마침표(점)로 시작하지 않으면 최종 파일 이름의 파일 확장자 앞에 점이 자동으로 삽입됩니다.

원하는 파일 확장자가 없으면 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 (10 MB)

quote

CSV 형식으로 두 구분자 사이에 필드를 묶을 수 있습니다. quote 및 endquote로 구분자를 지정합니다. endquote가 지정되지 않은 경우 quote 문자가 기본적으로 endquote 문자로 사용됩니다.

주:

이 옵션은 csv type에만 적용됩니다.

quote: 문자

기본값: Null 의미는 필드를 따옴표로 묶지 않습니다.

trimspaces

필드의 앞쪽 및 뒤쪽 공백을 CSV 형식으로 트리밍하는 방법을 지정합니다. quote 매개변수가 지정된 경우 필드를 인용하기 전에 공백 자르기가 적용됩니다.

See the description of trim_spec in Oracle Database 19c Utilities or Oracle Database 23ai Utilities.

주:

이 옵션은 csv type에만 적용됩니다.

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

기본값: notrim

type

출력 파일 유형을 지정합니다.

csv: 질의 결과를 사용자정의 문자로 구분된 열 값 집합으로 익스포트할 수 있는 CSV(문자 구분 값) 형식을 지정합니다.

json: 질의 결과를 JSON 파일로 익스포트하도록 지정합니다.

parquet: 질의 결과를 Parquet 파일로 익스포트하도록 지정합니다.

xml: 질의 결과를 적합한 XML 문서의 행으로 익스포트하도록 지정합니다. 각 행은 <RECORD> </RECORD>의 루트 XML 태그로 캡슐화됩니다.

질의 결과는 XMLFOREST SQL 함수를 사용하여 자동으로 XML 형식으로 변환됩니다. 열 별칭을 사용하여 열의 XML 태그 이름을 사용자 정의합니다.

자세한 내용은 Oracle Database 19c Utilities의 access_parameters Clause 또는 Oracle Database 23ai Utilities를 참조하십시오.

type: csv|datapump|json|parquet|xml

관련 항목