DBMS_CLOUD 패키지 형식 옵션

DBMS_CLOUD의 format 인수는 소스 파일의 형식을 지정합니다.

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

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

및:

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

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

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

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

예:

format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 
                           'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)

주:

Avro, ORC 또는 Parquet 형식 옵션은 DBMS_CLOUD Package Format Options for Avro, ORC, or Parquet을 참조하십시오.

형식 옵션 열에 설명된 대로 제한된 형식 옵션 세트는 DBMS_CLOUD.COPY_COLLECTION 또는 DBMS_CLOUD.COPY_DATA(format type가 JSON인 경우)와 함께 유효합니다.

형식 옵션 설명 구문

형식 옵션	설명	구문
`blankasnull`	`true`로 설정된 경우 공백으로 구성된 필드를 널로 로드합니다.	`blankasnull` `: true` 기본값: `False`
`characterset` `format` JSON 및 `COPY_DATA`에서 적합	소스 파일의 문자 집합을 지정합니다.	`characterset`: 문자열 기본값: 데이터베이스 문자 집합
`columnpath` `format` JSON 및 `COPY_DATA`에서만 사용	JSON 레코드에서 추출해야 하는 필드에 해당하는 JSON 경로 표현식의 배열입니다. 배열의 각 JSON 경로 표현식은 Oracle Database 19c JSON Developer's Guide 또는 Oracle Database 23ai JSON Developer's Guide의 SQL/JSON Path Expressions에 설명된 규칙을 따라야 합니다. JSON 및 `DBMS_CLOUD.COPY_DATA` 형식으로만 사용할 수 있습니다.	문자열 형식으로 표현된 JSON 경로 표현식의 JSON 배열입니다. 예: 'columnpath' value `'["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'`
`compression` JSON 데이터에 적합한 옵션	소스 파일의 압축 유형을 지정합니다. ZIP 아카이브 형식은 지원되지 않습니다. `auto` 값을 지정하면 압축 유형이 `gzip, zlib, std, bzip2`인지 확인합니다.	`compression`: `auto\|gzip\|zlib\|bzip2` 기본값: 압축 없음을 의미하는 널 값입니다.
`conversionerrors`	데이터 유형 변환 오류로 인해 행이 거부된 경우 관련 열이 널로 저장되거나 행이 거부됩니다.	`conversionerrors` : `reject_record \| store_null` 기본값은 `reject_record`입니다.
`dateformat`	소스 파일의 날짜 형식을 지정합니다. 형식 옵션 `AUTO`는 다음 형식을 검색합니다. J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD	`dateformat`: string 기본값: 데이터베이스 날짜 형식
`delimiter`	필드 구분자를 지정합니다. 특수 문자를 구분자로 사용하려면 문자의 ASCII 코드에 대한 HEX 값을 지정합니다. 예를 들어, 다음은 TAB 문자를 구분자로 지정합니다. `format => json_object('delimiter' value 'X''9''')`	`delimiter`: 문자 기본값 `\|`(파이프 문자)
`detectfieldorder`	외부 데이터 파일의 필드가 테이블의 열과 다른 순서로 지정되도록 합니다. 각 외부 데이터 파일의 첫번째 행을 사용하여 필드의 순서를 감지하고 테이블의 열에 매핑합니다. 외부 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 테이블 열 이름과 비교됩니다. 이 형식 옵션은 다음 절차에 적용할 수 있습니다. `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` `detectfieldorder`에 대한 제한 사항: 데이터 파일의 필드 이름은 첫 번째 레코드 라인에 나타나야 하며 필드 이름 사이에 공백이 없어야 합니다. 필드 이름 레코드의 필드 구분자는 파일의 데이터에 대한 필드 구분자와 동일해야 합니다. 따옴표로 묶인 필드 이름은 지원되지 않습니다. 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 External Table 열의 이름과 비교됩니다. 포함된 필드 구분자는 필드 이름에 사용할 수 없습니다. 테이블의 열 수는 데이터 파일의 필드 수와 일치해야 합니다. Bigdata 또는 Oracle Data Pump 형식에는 해당 형식에 이진 파일 형식의 정확한 열 메타 데이터 정보가 있으므로 이 형식 옵션은 적용할 수 없습니다. 텍스트 형식 CSV, JSON, Parquet 또는 XML은 첫 번째 라인에 필드 이름이 포함되어 있을 때 이 자동 현장 주문 감지 기능을 활용할 수 있습니다. 자세한 내용은 FIELD NAMES in Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하고 `ALL FILES`에 대한 설명을 참조하십시오.	`detectfieldorder: true` 기본값: `false`
`enablelogs`	형식 옵션 `enablelogs`는 다음 `DBMS_CLOUD` 프로시저와 함께 사용됩니다. `COPY_DATA` `COPY_COLLECTION` `EXPORT_DATA` `enablelogs`는 부울 값을 지정합니다. `TRUE`로 설정하면 로그가 생성됩니다. `FALSE`로 설정하면 로그가 생성되지 않습니다. 예: `format => JSON_OBJECT('enablelogs' value FALSE)`	`enablelogs: false` 기본값: `true`
`encryption`	형식 옵션 `encryption`는 객체 저장소에서 데이터를 익스포트하고 임포트할 암호화 및 해독 옵션을 지정합니다. 다음 매개변수를 지정하여 암호화 및 해독하려면 `encryption`를 사용합니다. `user_defined_function`: 지정된 BLOB(이진 LOB)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. 해독되거나 암호화된 BLOB을 반환합니다. `user_defined_function`는 `encryption`에 대한 다른 매개변수와 함께 사용할 수 없습니다. 예: `ADMIN.DECRYPTION_CALLBACK`. `type`: 해독하거나 암호화할 `DBMS_CRYPTO` 암호화 알고리즘을 지정합니다. `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_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_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)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다.
`endquote`	데이터는 `quote` 및 `endquote`로 지정된 두 구분자 사이에 묶을 수 있습니다. 지정된 경우 로드 중 `quote` 및 `endquote` 문자가 제거됩니다. 예: `format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’)`	`endquote:character` 기본값: 널, `endquote`를 의미하지 않습니다.
`escape`	지정된 경우 "\" 문자가 이스케이프 문자로 사용됩니다.	`escape` `: true` 기본값: `false`
`ignoreblanklines` JSON 데이터에 적합한 옵션	true로 설정할 경우 빈 행이 무시됩니다.	`ignoreblanklines` `: true` 기본값: `False`
`ignoremissingcolumns`	`field_list`에 소스 파일보다 더 많은 열이 있는 경우 추가 열이 널로 저장됩니다.	`ignoremissingcolumns` `: true` 기본값 `False`
`jsonpath` `COPY_COLLECTION`에서만 사용	로드할 문서를 식별하는 JSON 경로입니다. 이 옵션은 `DBMS_CLOUD.COPY_COLLECTION`가 있는 JSON 수집 데이터에 대해서만 유효합니다.	`jsonpath`: 문자열 기본값은 널입니다
`keyassignment` `COPY_COLLECTION`에서만 사용	새 컬렉션을 몽고 호환 컬렉션으로 만들지 아니면 SODA 컬렉션으로 만들지 지정합니다. 값이 `embedded_oid`로 설정되면 새 컬렉션이 몽고 호환 컬렉션으로 생성됩니다. 기본적으로 이 매개변수는 설정되지 않으므로 새 컬렉션이 SODA 컬렉션으로 생성됩니다.	`keyassignment`: `embedded_oid` 기본값: `keyassignment`가 설정되지 않았습니다.
`keypath` `COPY_COLLECTION`에서만 사용	`'_id'` 값으로 로드할 데이터의 속성을 지정합니다. `keypath`가 지정된 경우 `keyassignment` 값도 `embedded_oid`로 지정해야 합니다. 경로 값을 경로(예: `'$.mykey'`)로 설정하여 경로 값을 `'_id'` 값으로 선택합니다. 이 매개변수는 선택사항이며 몽고 호환 컬렉션으로 로드하는 경우에만 유효합니다. 지정하지 않을 경우 Oracle은 12바이트 고유 시스템 ID를 생성하고 로드 중인 데이터에 `'_id'` 속성이 없는 경우 이를 `'_id'` 속성으로 채웁니다.	`keypath`: `string` 기본값: `keypath`가 설정되지 않았습니다. `keypath`가 설정된 경우 기본 string 값은 `NULL`입니다.
`language`	로케일에 민감한 정보가 파생될 수 있는 언어 이름(예: FRENCH)을 지정합니다.	`language`: string 기본값은 널입니다 Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.
`logdir`	`logfile_table` 또는 `badfile_table` 파일이 저장되는 디렉토리 객체 이름을 결정하는 문자열 값을 지정합니다. 기본적으로 `logdir`는 대소문자를 구분하지 않지만 지정된 값을 큰 따옴표로 묶으면 대소문자가 예약됩니다. 예: `format => JSON_OBJECT ('logdir' value 'test_log')` 위 예제에 지정된 `logdir` 형식 옵션은 `logfile_table` 또는 `badfile_table` 파일을 `TEST_LOG` 디렉토리 객체에 저장합니다. `format => JSON_OBJECT ('logdir' value '"test_log"')` 위 예제에 지정된 `logdir` 형식 옵션은 `logfile_table` 또는 `badfile_table` 파일을 `test_log` 디렉토리 객체에 저장합니다.	`logdir`: 문자열 기본값: `DATA_PUMP_DIR`
`logprefix`	`logfile_table` 및 `badfile_table` 파일의 접두어를 결정하는 문자열 값을 지정합니다. 로그 테이블 이름 형식은 logprefix`$`operation_id입니다. 기본적으로 logprefix는 대문자이지만 지정된 값을 큰따옴표로 묶으면 대소문자가 예약됩니다. 예: `format => JSON_OBJECT ('logprefix' value 'TEST')` 그런 다음 로그 파일은 `TEST` 접두어(예: `TEST$2_LOG` 및 `TEST$2_BAD`)를 사용합니다.	`logprefix`: 문자열 기본값: `COPY`
`logretention`	`logfile_table` 및 `badfile_table` 파일이 보존되는 양의 정수 기간(일)을 지정합니다. 적합한 값: `0` - `99999` 예: `format => JSON_OBJECT ('logretention' value 7)`	`logretention`: 숫자 기본값: `2`
`maxdocsize` 이 옵션은 JSON 데이터에서만 유효합니다.	최대 JSON 문서 크기입니다.	`maxdocsize`: 숫자 기본값: 1MB 허용되는 최대값: 2기가바이트
`numericcharacters`	그룹 구분 기호 및 십진수 문자로 사용할 문자를 지정합니다. decimal_character: 십진수는 숫자의 정수 부분을 십진수 부분과 구분합니다. group_separator: 그룹 구분 기호는 정수 그룹(즉, 천 단위, 백만 단위, 수십억 단위 등)을 구분합니다.	`numericcharacters: 'decimal_character group_separator'` 기본값: `".,"` 자세한 내용은 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.
`numberformat`	숫자 형식 모델을 지정합니다. 숫자 형식 모델에서는 숫자를 지정된 유효 자릿수로 반올림합니다. 숫자 형식 모델은 하나 이상의 숫자 형식 요소로 구성됩니다. 이는 `numericcharacters`와 함께 사용됩니다.	`numberformat: number_format_model` 기본값: `NLS_TERRITORY` 매개변수의 설정에서 파생됩니다. 자세한 내용은 Oracle Database 19c SQL Language Reference의 Number Format Models 또는 Oracle Database 23ai SQL Language Reference를 참조하십시오.
`partition_columns`	형식 옵션 `partition_columns`는 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE`와 함께 데이터 파일 유형(구조적 또는 비구조적)에 따라 분할 영역 열이 파일 경로에서 파생될 때 분할 영역 열의 열 이름 및 데이터 유형을 지정하는 데 사용됩니다. `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE`에 `column_list` 매개변수가 포함되고 데이터 파일이 구조화되지 않은 경우(예: CSV 텍스트 파일) `partition_columns`에는 데이터 유형이 포함되지 않습니다. 예를 들어, 이 유형의 `partition_columns` 사양에 대해 다음과 같은 형식을 사용합니다. `'"partition_columns":["state","zipcode"]'` 데이터 유형은 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `column_list` 매개변수에 지정되어 있으므로 필요하지 않습니다. `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE`에 `column_list` 매개변수가 포함되지 않고 데이터 파일(예: Avro, ORC 또는 Parquet 파일)이 구조화된 경우 `partition_columns` 옵션에 데이터 유형이 포함됩니다. 예를 들어, 다음은 `partition_columns` 사양을 보여줍니다. `'"partition_columns":[ {"name":"country", "type":"varchar2(10)"}, {"name":"year", "type":"number"}, {"name":"month", "type":"varchar2(10)"}]'` 데이터 파일이 구조화되지 않고 `type` 하위 절이 `partition_columns`로 지정된 경우 `type` 하위 절은 무시됩니다. 하이브 형식을 기반으로 하지 않는 객체 이름의 경우 `partition_columns` 지정된 열의 순서는 `file_uri_list`의 객체 이름에 나타나는 순서와 일치해야 합니다.
`quote`	필드의 인용 문자를 지정합니다. 지정된 경우 `quote` 문자는 로드 중에 제거됩니다.	`quote`: 문자 기본값: 널은 따옴표 없음을 의미합니다.
`recorddelimiter` JSON 데이터에 적합한 옵션	레코드 구분자를 지정합니다. 기본적으로 `DBMS_CLOUD`는 올바른 줄바꿈 문자를 구분자로 자동으로 찾으려고 시도합니다. 먼저 파일에서 Windows 줄바꿈 문자 "`\r\n`"을 검색합니다. Windows 줄바꿈 문자를 찾으면 이 문자가 절차의 모든 파일에 대한 레코드 구분자로 사용됩니다. Windows 개행 문자를 찾을 수 없는 경우 UNIX/Linux 개행 문자 "`\n`"을 검색하고 찾을 경우 "`\n`"을 절차의 모든 파일에 대한 레코드 구분자로 사용합니다. 다음과 같이 기본 동작을 무효화하려는 경우 이 인수를 명시적으로 지정합니다. `format => json_object('recorddelimiter' VALUE '''\r\n''')` 레코드 구분자가 없음을 나타내려면 입력 파일에서 발생하지 않는 `recorddelimiter`를 지정할 수 있습니다. 예를 들어 구분자가 없음을 나타내려면 제어 문자 0x01(SOH)를 `recorddelimiter`의 값으로 지정하고 `recorddelimiter` 값을 `"0x''01''"`로 설정합니다(이 문자는 JSON 텍스트에서 발생하지 않음). 예: `format => '{"recorddelimiter" : "0x''01''"}'` `recorddelimiter`는 프로시저 호출당 한 번씩 설정됩니다. 기본값인 `detected newline`를 사용하는 경우 모든 파일은 동일한 레코드 구분자를 사용합니다(있는 경우).	`recorddelimiter`: 문자 기본값: 감지된 줄바꿈
`regexuri`	형식 옵션 `regexuri`는 다음 DBMS_CLOUD 프로시저와 함께 사용됩니다. `COPY_COLLECTION` `COPY_DATA` `CREATE_EXTERNAL_TABLE` `CREATE_EXTERNAL_PART_TABLE` `CREATE_HYBRID_PART_TABLE` `regexuri` 값이 `TRUE`로 설정된 경우 클라우드 소스 파일 URI의 파일 이름에 와일드카드 및 정규 표현식을 사용할 수 있습니다. `regexuri` 매개변수가 `FALSE`로 설정된 경우 "" 및 "?" 문자는 와일드카드 문자로 간주됩니다. `regexuri` 매개변수가 `TRUE`로 설정된 경우 "" 및 "?" 문자는 지정된 정규식 패턴의 일부입니다. 정규 표현식 패턴은 URI의 파일 이름 또는 하위 폴더 경로에 대해서만 지원되며 패턴 일치는 `REGEXP_LIKE` 함수에서 수행하는 패턴 일치와 동일합니다. 디렉토리 이름에는 정규식 패턴이 지원되지 않습니다. External Table의 경우 이 옵션은 Object Storage에 있는 파일에 생성된 테이블에서만 지원됩니다. 예: `format => JSON_OBJECT('regexuri' value TRUE)` `REGEXP_LIKE` 조건에 대한 자세한 내용은 REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference 또는 Oracle Database 23ai SQL Language Reference를 참조하십시오.	`regexuri`: `True` 기본값: `False`
`rejectlimit`	지정된 수의 행이 거부된 후 작업에 오류가 발생합니다.	`rejectlimit`: 숫자 기본값: `0`
`removequotes`	소스 파일의 필드 주위에 있는 따옴표를 제거합니다.	`removequotes`: `true` 기본값: `False`
`skipheaders`	파일 시작 위치에서 건너뛸 행 수를 지정합니다.	`skipheaders`: 숫자 기본값: 지정되지 않은 경우 0, 값 없이 지정된 경우 1
`territory`	입력 데이터 특성을 추가로 결정하기 위한 할당영역 이름을 지정합니다.	`territory`: 문자열 기본값은 널입니다 Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.
`timestampformat`	소스 파일의 시간 기록 형식을 지정합니다. 형식 옵션 `AUTO`는 다음 형식을 검색합니다. YYYY-MM-DD HH:MI:SS.FF YYYY-MM-DD HH:MI:SS.FF3 YYYY-MM-DD HH24:MI:SS.FF3 MM/DD/YYYY HH:MI:SS.FF3	`timestampformat`: string 기본값: 데이터베이스 시간기록 형식 문자열에는 "$"와 같은 대체 문자가 포함될 수 있습니다.
`timestampltzformat`	소스 파일의 로컬 시간대 포함 타임스탬프 형식을 지정합니다. 형식 옵션 `AUTO`는 다음 형식을 검색합니다. DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR	`timestampltzformat`: string 기본값: 로컬 시간대 형식의 데이터베이스 시간 기록 형식
`timestamptzformat`	소스 파일의 시간대 포함 시간 기록 형식을 지정합니다. 형식 옵션 `AUTO`는 다음 형식을 검색합니다. DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR	`timestamptzformat`: 문자열 기본값: 시간대 형식의 데이터베이스 시간 기록 형식
`trimspaces`	필드의 앞뒤 공백을 자르는 방법을 지정합니다. See the description of trim_spec in Oracle Database 19c Utilities or Oracle Database 23ai Utilities.	`trimspaces`: `rtrim\| ltrim\| notrim\| lrtrim\| ldrtrim` 기본값: `notrim`
`truncatecol`	파일의 데이터가 필드에 비해 너무 긴 경우 이 옵션은 행을 거부하지 않고 필드의 값을 자릅니다.	`truncatecol`:`true` 기본값: `False`
`type`	소스 파일 유형을 지정합니다. CSV에 대한 설명은 Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하십시오. `type`가 `datapump`인 경우 다른 적합한 형식 옵션은 `rejectlimit`뿐입니다. `type`가 `datapump`인 경우 Oracle Cloud Infrastructure Object Storage 및 Oracle Cloud Infrastructure Object Storage Classic만 지원됩니다. `type` 값 `avro`, `orc` 또는 `parquet`는 DBMS_CLOUD Package Format Options for Avro, ORC, or Parquet을 참조하십시오. `DBMS_CLOUD.COPY_COLLECTION` `type`를 사용하는 JSON 데이터의 경우 `json`(기본값) 및 `ejson`의 두 가지 적합한 값이 있습니다. `DBMS_CLOUD.COPY_COLLECTION`의 경우 이 두 값은 모두 입력이 JSON 데이터임을 지정합니다. `ejson` 값은 텍스트 JSON 입력 데이터의 확장된 객체가 고유 이진 JSON 모음의 스칼라 JSON 값으로 변환되도록 합니다. `json` 값은 이 변환을 수행하지 않으며 입력 데이터의 모든 객체가 이진 JSON 형식으로 변환됩니다. `DBMS_CLOUD.COPY_DATA` `type`가 포함된 JSON 데이터의 경우 적합한 값 `json`가 하나 있습니다. 이 값은 입력이 JSON 데이터임을 지정합니다. JSON 객체 로드에 대한 자세한 내용은 COPY_COLLECTION Procedure를 참조하십시오. `type` 매개변수에 `ejson` 값이 있을 때 해석되는 확장된 JSON 객체에 대한 자세한 내용은 확장된 스칼라 값을 나타내는 텍스트 JSON 객체를 참조하십시오.	`type`: `csv\|csv` `with embedded`\|`csv` `without embedded` `\|avro\|\|datapump\|orc\|parquet` 주: 모든 `DBMS_CLOUD` 절차가 이러한 유형을 지원하는 것은 아닙니다. `csv`는 `csv` `without embedded`와 동일합니다. 기본값은 널입니다 JSON 데이터의 경우 `DBMS_CLOUD.COPY_COLLECTION`과 함께 사용할 적합한 `type` 값이 두 개 있습니다. `json`\|`ejson` 이 경우 기본값은 `json`입니다. `DBMS_CLOUD.COPY_DATA`가 포함된 JSON 데이터의 경우 `json`만 적합합니다.
`unpackarrays` `COPY_COLLECTION`에서만 사용	`true`로 설정하면 로드된 문서가 배열인 경우 배열의 콘텐츠가 배열 자체가 아닌 문서로 로드됩니다. 이는 최상위 레벨 배열에만 적용됩니다. `true`로 설정하면 전체 배열이 단일 문서로 삽입됩니다. 이 옵션은 `DBMS_CLOUD.COPY_COLLECTION`가 있는 JSON 수집 데이터에 대해서만 유효합니다.	`unpackarrays: true` 기본값: `False`

blankasnull

true로 설정된 경우 공백으로 구성된 필드를 널로 로드합니다.

blankasnull : true

기본값: False

characterset

format JSON 및 COPY_DATA에서 적합

소스 파일의 문자 집합을 지정합니다.

characterset: 문자열

기본값: 데이터베이스 문자 집합

columnpath

format JSON 및 COPY_DATA에서만 사용

JSON 레코드에서 추출해야 하는 필드에 해당하는 JSON 경로 표현식의 배열입니다. 배열의 각 JSON 경로 표현식은 Oracle Database 19c JSON Developer's Guide 또는 Oracle Database 23ai JSON Developer's Guide의 SQL/JSON Path Expressions에 설명된 규칙을 따라야 합니다.

JSON 및 DBMS_CLOUD.COPY_DATA 형식으로만 사용할 수 있습니다.

문자열 형식으로 표현된 JSON 경로 표현식의 JSON 배열입니다. 예: 'columnpath' value '["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'

compression

JSON 데이터에 적합한 옵션

소스 파일의 압축 유형을 지정합니다.

ZIP 아카이브 형식은 지원되지 않습니다.

auto 값을 지정하면 압축 유형이 gzip, zlib, std, bzip2인지 확인합니다.

compression: auto|gzip|zlib|bzip2

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

conversionerrors

데이터 유형 변환 오류로 인해 행이 거부된 경우 관련 열이 널로 저장되거나 행이 거부됩니다.

conversionerrors : reject_record | store_null

기본값은 reject_record입니다.

dateformat

소스 파일의 날짜 형식을 지정합니다. 형식 옵션 AUTO는 다음 형식을 검색합니다.

J 
MM-DD-YYYYBC 
MM-DD-YYYY 
YYYYMMDD HHMISS 
YYMMDD HHMISS 
YYYY.DDD 
YYYY-MM-DD

dateformat: string

기본값: 데이터베이스 날짜 형식

delimiter

필드 구분자를 지정합니다.

특수 문자를 구분자로 사용하려면 문자의 ASCII 코드에 대한 HEX 값을 지정합니다. 예를 들어, 다음은 TAB 문자를 구분자로 지정합니다.

format => json_object('delimiter' value 'X''9''')

delimiter: 문자

기본값 |(파이프 문자)

detectfieldorder

외부 데이터 파일의 필드가 테이블의 열과 다른 순서로 지정되도록 합니다. 각 외부 데이터 파일의 첫번째 행을 사용하여 필드의 순서를 감지하고 테이블의 열에 매핑합니다. 외부 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 테이블 열 이름과 비교됩니다.

이 형식 옵션은 다음 절차에 적용할 수 있습니다.

DBMS_CLOUD.COPY_DATA
DBMS_CLOUD.CREATE_EXTERNAL_TABLE
DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE
DBMS_CLOUD.CREATE_HYBRID_PART_TABLE

detectfieldorder에 대한 제한 사항:

데이터 파일의 필드 이름은 첫 번째 레코드 라인에 나타나야 하며 필드 이름 사이에 공백이 없어야 합니다.
필드 이름 레코드의 필드 구분자는 파일의 데이터에 대한 필드 구분자와 동일해야 합니다.
따옴표로 묶인 필드 이름은 지원되지 않습니다. 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 External Table 열의 이름과 비교됩니다.
포함된 필드 구분자는 필드 이름에 사용할 수 없습니다.
테이블의 열 수는 데이터 파일의 필드 수와 일치해야 합니다.
Bigdata 또는 Oracle Data Pump 형식에는 해당 형식에 이진 파일 형식의 정확한 열 메타 데이터 정보가 있으므로 이 형식 옵션은 적용할 수 없습니다.

텍스트 형식 CSV, JSON, Parquet 또는 XML은 첫 번째 라인에 필드 이름이 포함되어 있을 때 이 자동 현장 주문 감지 기능을 활용할 수 있습니다.

자세한 내용은 FIELD NAMES in Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하고 ALL FILES에 대한 설명을 참조하십시오.

detectfieldorder: true

기본값: false

enablelogs

형식 옵션 enablelogs는 다음 DBMS_CLOUD 프로시저와 함께 사용됩니다.

COPY_DATA
COPY_COLLECTION
EXPORT_DATA

enablelogs는 부울 값을 지정합니다. TRUE로 설정하면 로그가 생성됩니다. FALSE로 설정하면 로그가 생성되지 않습니다.

예:

format => JSON_OBJECT('enablelogs' value FALSE)

enablelogs: false

기본값: true

encryption

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

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

user_defined_function: 지정된 BLOB(이진 LOB)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. 해독되거나 암호화된 BLOB을 반환합니다. user_defined_function는 encryption에 대한 다른 매개변수와 함께 사용할 수 없습니다.

예: ADMIN.DECRYPTION_CALLBACK.
type: 해독하거나 암호화할 DBMS_CRYPTO 암호화 알고리즘을 지정합니다.

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_EXTERNAL_PART_TABLE
- DBMS_CLOUD.CREATE_HYBRID_PART_TABLE
  
  DBMS_CLOUD.CREATE_HYBRID_PART_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)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다.

endquote

데이터는 quote 및 endquote로 지정된 두 구분자 사이에 묶을 수 있습니다. 지정된 경우 로드 중 quote 및 endquote 문자가 제거됩니다.

예:

format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’)

endquote:character

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

escape

지정된 경우 "\" 문자가 이스케이프 문자로 사용됩니다.

escape : true

기본값: false

ignoreblanklines

JSON 데이터에 적합한 옵션

true로 설정할 경우 빈 행이 무시됩니다.

ignoreblanklines : true

기본값: False

ignoremissingcolumns

field_list에 소스 파일보다 더 많은 열이 있는 경우 추가 열이 널로 저장됩니다.

ignoremissingcolumns : true

기본값 False

jsonpath

COPY_COLLECTION에서만 사용

로드할 문서를 식별하는 JSON 경로입니다.

이 옵션은 DBMS_CLOUD.COPY_COLLECTION가 있는 JSON 수집 데이터에 대해서만 유효합니다.

jsonpath: 문자열

기본값은 널입니다

keyassignment

COPY_COLLECTION에서만 사용

새 컬렉션을 몽고 호환 컬렉션으로 만들지 아니면 SODA 컬렉션으로 만들지 지정합니다.

값이 embedded_oid로 설정되면 새 컬렉션이 몽고 호환 컬렉션으로 생성됩니다.

기본적으로 이 매개변수는 설정되지 않으므로 새 컬렉션이 SODA 컬렉션으로 생성됩니다.

keyassignment: embedded_oid

기본값: keyassignment가 설정되지 않았습니다.

keypath

COPY_COLLECTION에서만 사용

'_id' 값으로 로드할 데이터의 속성을 지정합니다.

keypath가 지정된 경우 keyassignment 값도 embedded_oid로 지정해야 합니다.

경로 값을 경로(예: '$.mykey')로 설정하여 경로 값을 '_id' 값으로 선택합니다.

이 매개변수는 선택사항이며 몽고 호환 컬렉션으로 로드하는 경우에만 유효합니다.

지정하지 않을 경우 Oracle은 12바이트 고유 시스템 ID를 생성하고 로드 중인 데이터에 '_id' 속성이 없는 경우 이를 '_id' 속성으로 채웁니다.

keypath: string

기본값: keypath가 설정되지 않았습니다.

keypath가 설정된 경우 기본 string 값은 NULL입니다.

language

로케일에 민감한 정보가 파생될 수 있는 언어 이름(예: FRENCH)을 지정합니다.

language: string

기본값은 널입니다

Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.

logdir

logfile_table 또는 badfile_table 파일이 저장되는 디렉토리 객체 이름을 결정하는 문자열 값을 지정합니다.

기본적으로 logdir는 대소문자를 구분하지 않지만 지정된 값을 큰 따옴표로 묶으면 대소문자가 예약됩니다.

예:

format => JSON_OBJECT ('logdir' value 'test_log')

위 예제에 지정된 logdir 형식 옵션은 logfile_table 또는 badfile_table 파일을 TEST_LOG 디렉토리 객체에 저장합니다.

format => JSON_OBJECT ('logdir' value '"test_log"')

위 예제에 지정된 logdir 형식 옵션은 logfile_table 또는 badfile_table 파일을 test_log 디렉토리 객체에 저장합니다.

logdir: 문자열

기본값: DATA_PUMP_DIR

logprefix

logfile_table 및 badfile_table 파일의 접두어를 결정하는 문자열 값을 지정합니다.

로그 테이블 이름 형식은 logprefix$operation_id입니다.

기본적으로 logprefix는 대문자이지만 지정된 값을 큰따옴표로 묶으면 대소문자가 예약됩니다.

예:

format => JSON_OBJECT ('logprefix' value 'TEST')

그런 다음 로그 파일은 TEST 접두어(예: TEST$2_LOG 및 TEST$2_BAD)를 사용합니다.

logprefix: 문자열

기본값: COPY

logretention

logfile_table 및 badfile_table 파일이 보존되는 양의 정수 기간(일)을 지정합니다.

적합한 값: 0 - 99999

예:

format => JSON_OBJECT ('logretention' value 7)

logretention: 숫자

기본값: 2

maxdocsize

이 옵션은 JSON 데이터에서만 유효합니다.

최대 JSON 문서 크기입니다.

maxdocsize: 숫자

기본값: 1MB

허용되는 최대값: 2기가바이트

numericcharacters

그룹 구분 기호 및 십진수 문자로 사용할 문자를 지정합니다.

decimal_character: 십진수는 숫자의 정수 부분을 십진수 부분과 구분합니다.

group_separator: 그룹 구분 기호는 정수 그룹(즉, 천 단위, 백만 단위, 수십억 단위 등)을 구분합니다.

numericcharacters: 'decimal_character group_separator'

기본값: ".,"

자세한 내용은 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.

numberformat

숫자 형식 모델을 지정합니다. 숫자 형식 모델에서는 숫자를 지정된 유효 자릿수로 반올림합니다. 숫자 형식 모델은 하나 이상의 숫자 형식 요소로 구성됩니다.

이는 numericcharacters와 함께 사용됩니다.

numberformat: number_format_model

기본값: NLS_TERRITORY 매개변수의 설정에서 파생됩니다.

자세한 내용은 Oracle Database 19c SQL Language Reference의 Number Format Models 또는 Oracle Database 23ai SQL Language Reference를 참조하십시오.

partition_columns

형식 옵션 partition_columns는 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE와 함께 데이터 파일 유형(구조적 또는 비구조적)에 따라 분할 영역 열이 파일 경로에서 파생될 때 분할 영역 열의 열 이름 및 데이터 유형을 지정하는 데 사용됩니다.

DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE에 column_list 매개변수가 포함되고 데이터 파일이 구조화되지 않은 경우(예: CSV 텍스트 파일) partition_columns에는 데이터 유형이 포함되지 않습니다. 예를 들어, 이 유형의 partition_columns 사양에 대해 다음과 같은 형식을 사용합니다.
```
'"partition_columns":["state","zipcode"]'
```
데이터 유형은 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE column_list 매개변수에 지정되어 있으므로 필요하지 않습니다.
DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE에 column_list 매개변수가 포함되지 않고 데이터 파일(예: Avro, ORC 또는 Parquet 파일)이 구조화된 경우 partition_columns 옵션에 데이터 유형이 포함됩니다. 예를 들어, 다음은 partition_columns 사양을 보여줍니다.
```
'"partition_columns":[
               {"name":"country", "type":"varchar2(10)"},
               {"name":"year", "type":"number"},
               {"name":"month", "type":"varchar2(10)"}]'
```

데이터 파일이 구조화되지 않고 type 하위 절이 partition_columns로 지정된 경우 type 하위 절은 무시됩니다.

하이브 형식을 기반으로 하지 않는 객체 이름의 경우 partition_columns 지정된 열의 순서는 file_uri_list의 객체 이름에 나타나는 순서와 일치해야 합니다.

quote

필드의 인용 문자를 지정합니다. 지정된 경우 quote 문자는 로드 중에 제거됩니다.

quote: 문자

기본값: 널은 따옴표 없음을 의미합니다.

recorddelimiter

JSON 데이터에 적합한 옵션

레코드 구분자를 지정합니다.

기본적으로 DBMS_CLOUD는 올바른 줄바꿈 문자를 구분자로 자동으로 찾으려고 시도합니다. 먼저 파일에서 Windows 줄바꿈 문자 "\r\n"을 검색합니다. Windows 줄바꿈 문자를 찾으면 이 문자가 절차의 모든 파일에 대한 레코드 구분자로 사용됩니다. Windows 개행 문자를 찾을 수 없는 경우 UNIX/Linux 개행 문자 "\n"을 검색하고 찾을 경우 "\n"을 절차의 모든 파일에 대한 레코드 구분자로 사용합니다.

다음과 같이 기본 동작을 무효화하려는 경우 이 인수를 명시적으로 지정합니다.

format => json_object('recorddelimiter' VALUE '''\r\n''')

레코드 구분자가 없음을 나타내려면 입력 파일에서 발생하지 않는 recorddelimiter를 지정할 수 있습니다. 예를 들어 구분자가 없음을 나타내려면 제어 문자 0x01(SOH)를 recorddelimiter의 값으로 지정하고 recorddelimiter 값을 "0x''01''"로 설정합니다(이 문자는 JSON 텍스트에서 발생하지 않음). 예:

format => '{"recorddelimiter" : "0x''01''"}'

recorddelimiter는 프로시저 호출당 한 번씩 설정됩니다. 기본값인 detected newline를 사용하는 경우 모든 파일은 동일한 레코드 구분자를 사용합니다(있는 경우).

recorddelimiter: 문자

기본값: 감지된 줄바꿈

regexuri

형식 옵션 regexuri는 다음 DBMS_CLOUD 프로시저와 함께 사용됩니다.

COPY_COLLECTION
COPY_DATA
CREATE_EXTERNAL_TABLE
CREATE_EXTERNAL_PART_TABLE
CREATE_HYBRID_PART_TABLE

regexuri 값이 TRUE로 설정된 경우 클라우드 소스 파일 URI의 파일 이름에 와일드카드 및 정규 표현식을 사용할 수 있습니다.

regexuri 매개변수가 FALSE로 설정된 경우 "*" 및 "?" 문자는 와일드카드 문자로 간주됩니다. regexuri 매개변수가 TRUE로 설정된 경우 "*" 및 "?" 문자는 지정된 정규식 패턴의 일부입니다.

정규 표현식 패턴은 URI의 파일 이름 또는 하위 폴더 경로에 대해서만 지원되며 패턴 일치는 REGEXP_LIKE 함수에서 수행하는 패턴 일치와 동일합니다. 디렉토리 이름에는 정규식 패턴이 지원되지 않습니다.

External Table의 경우 이 옵션은 Object Storage에 있는 파일에 생성된 테이블에서만 지원됩니다.

예:

format => JSON_OBJECT('regexuri' value TRUE)

REGEXP_LIKE 조건에 대한 자세한 내용은 REGEXP_LIKE Condition in Oracle Database 19c SQL Language Reference 또는 Oracle Database 23ai SQL Language Reference를 참조하십시오.

regexuri: True

기본값: False

rejectlimit

지정된 수의 행이 거부된 후 작업에 오류가 발생합니다.

rejectlimit: 숫자

기본값: 0

removequotes

소스 파일의 필드 주위에 있는 따옴표를 제거합니다.

removequotes: true

기본값: False

skipheaders

파일 시작 위치에서 건너뛸 행 수를 지정합니다.

skipheaders: 숫자

기본값: 지정되지 않은 경우 0, 값 없이 지정된 경우 1

territory

입력 데이터 특성을 추가로 결정하기 위한 할당영역 이름을 지정합니다.

territory: 문자열

기본값은 널입니다

Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오.

timestampformat

소스 파일의 시간 기록 형식을 지정합니다. 형식 옵션 AUTO는 다음 형식을 검색합니다.

YYYY-MM-DD HH:MI:SS.FF 
YYYY-MM-DD HH:MI:SS.FF3
YYYY-MM-DD HH24:MI:SS.FF3
MM/DD/YYYY HH:MI:SS.FF3

timestampformat: string

기본값: 데이터베이스 시간기록 형식

문자열에는 "$"와 같은 대체 문자가 포함될 수 있습니다.

timestampltzformat

소스 파일의 로컬 시간대 포함 타임스탬프 형식을 지정합니다. 형식 옵션 AUTO는 다음 형식을 검색합니다.

DD Mon YYYY HH:MI:SS.FF TZR 
MM/DD/YYYY HH:MI:SS.FF TZR 
YYYY-MM-DD HH:MI:SS+/-TZR 
YYYY-MM-DD HH:MI:SS.FF3 
DD.MM.YYYY HH:MI:SS TZR

timestampltzformat: string

기본값: 로컬 시간대 형식의 데이터베이스 시간 기록 형식

timestamptzformat

소스 파일의 시간대 포함 시간 기록 형식을 지정합니다. 형식 옵션 AUTO는 다음 형식을 검색합니다.

DD Mon YYYY HH:MI:SS.FF TZR 
MM/DD/YYYY HH:MI:SS.FF TZR 
YYYY-MM-DD HH:MI:SS+/-TZR 
YYYY-MM-DD HH:MI:SS.FF3 
DD.MM.YYYY HH:MI:SS TZR

timestamptzformat: 문자열

기본값: 시간대 형식의 데이터베이스 시간 기록 형식

trimspaces

필드의 앞뒤 공백을 자르는 방법을 지정합니다.

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

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

기본값: notrim

truncatecol

파일의 데이터가 필드에 비해 너무 긴 경우 이 옵션은 행을 거부하지 않고 필드의 값을 자릅니다.

truncatecol:true

기본값: False

type

소스 파일 유형을 지정합니다.

CSV에 대한 설명은 Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하십시오.

type가 datapump인 경우 다른 적합한 형식 옵션은 rejectlimit뿐입니다.

type가 datapump인 경우 Oracle Cloud Infrastructure Object Storage 및 Oracle Cloud Infrastructure Object Storage Classic만 지원됩니다.

type 값 avro, orc 또는 parquet는 DBMS_CLOUD Package Format Options for Avro, ORC, or Parquet을 참조하십시오.

DBMS_CLOUD.COPY_COLLECTION type를 사용하는 JSON 데이터의 경우 json(기본값) 및 ejson의 두 가지 적합한 값이 있습니다. DBMS_CLOUD.COPY_COLLECTION의 경우 이 두 값은 모두 입력이 JSON 데이터임을 지정합니다. ejson 값은 텍스트 JSON 입력 데이터의 확장된 객체가 고유 이진 JSON 모음의 스칼라 JSON 값으로 변환되도록 합니다. json 값은 이 변환을 수행하지 않으며 입력 데이터의 모든 객체가 이진 JSON 형식으로 변환됩니다.

DBMS_CLOUD.COPY_DATA type가 포함된 JSON 데이터의 경우 적합한 값 json가 하나 있습니다. 이 값은 입력이 JSON 데이터임을 지정합니다.

JSON 객체 로드에 대한 자세한 내용은 COPY_COLLECTION Procedure를 참조하십시오.
type 매개변수에 ejson 값이 있을 때 해석되는 확장된 JSON 객체에 대한 자세한 내용은 확장된 스칼라 값을 나타내는 텍스트 JSON 객체를 참조하십시오.

type: csv|csv with embedded|csv without embedded |avro||datapump|orc|parquet

주:

모든 DBMS_CLOUD 절차가 이러한 유형을 지원하는 것은 아닙니다.

csv는 csv without embedded와 동일합니다.

기본값은 널입니다

JSON 데이터의 경우 DBMS_CLOUD.COPY_COLLECTION과 함께 사용할 적합한 type 값이 두 개 있습니다. json|ejson 이 경우 기본값은 json입니다. DBMS_CLOUD.COPY_DATA가 포함된 JSON 데이터의 경우 json만 적합합니다.

unpackarrays

COPY_COLLECTION에서만 사용

true로 설정하면 로드된 문서가 배열인 경우 배열의 콘텐츠가 배열 자체가 아닌 문서로 로드됩니다. 이는 최상위 레벨 배열에만 적용됩니다.

true로 설정하면 전체 배열이 단일 문서로 삽입됩니다.

이 옵션은 DBMS_CLOUD.COPY_COLLECTION가 있는 JSON 수집 데이터에 대해서만 유효합니다.

unpackarrays: true

기본값: False

관련 항목

제목 및 저작권 정보

Oracle and/or its affiliates.