DBMS_CLOUD 패키지 형식 옵션
DBMS_CLOUD의 형식 인수는 소스 파일의 형식을 지정합니다.
형식 인수를 지정하는 두 가지 방법은 다음과 같습니다.
format => '{"format_option" : "format_value" }'
and
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을 참조하십시오.
형식 옵션 열에 설명된 대로 제한된 형식 옵션 세트는 format type가 JSON인 경우 DBMS_CLOUD.COPY_COLLECTION 또는 DBMS_CLOUD.COPY_DATA에서 유효합니다.
| 형식 옵션 | 설명 | 구문 |
|---|---|---|
blankasnull |
true로 설정된 경우 공백으로 구성된 필드를 널로 로드합니다. |
기본값: |
|
소스 파일의 문자 집합을 지정합니다. |
기본값: 데이터베이스 문자 집합 |
|
JSON 레코드에서 추출해야 하는 필드에 해당하는 JSON 경로 표현식 배열입니다. 배열의 각 JSON 경로 표현식은 Oracle Database 19c JSON Developer's Guide 또는 Oracle Database 26ai JSON Developer's Guide의 SQL/JSON Path Expressions에 설명된 규칙을 따라야 합니다. JSON 및 |
문자열 형식으로 표현된 JSON 경로 표현식의 JSON 배열입니다. 예: 'columnpath' value '["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]' |
JSON 데이터에 적합한 옵션 |
소스 파일의 압축 유형을 지정합니다. ZIP 아카이브 형식은 지원되지 않습니다.
|
기본값: Null 값은 압축 없음을 의미합니다. |
conversionerrors |
데이터 유형 변환 오류로 인해 행이 거부된 경우 관련 열이 널로 저장되거나 행이 거부됩니다. |
기본값: |
dateformat |
소스 파일의 날짜 형식을 지정하십시오. 형식 옵션 J |
기본값: 데이터베이스 일자 형식 |
delimiter |
필드 구분자를 지정합니다. 특수 문자를 구분자로 사용하려면 해당 문자의 ASCII 코드에 대한 HEX 값을 지정합니다. 예를 들어, 다음은 TAB 문자를 구분자로 지정합니다. |
기본값 |
detectfieldorder |
외부 데이터 파일의 필드가 테이블의 열과 다른 순서로 지정되도록 지정합니다. 각 외부 데이터 파일의 첫번째 행을 사용하여 필드의 순서를 감지하고 테이블의 열에 매핑합니다. 외부 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 테이블 열의 이름과 비교됩니다. 이 형식 옵션은 다음 절차에 적용할 수 있습니다.
자세한 내용은 Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities의 FIELD NAMES와 |
기본값: |
enablelogs |
형식 옵션
예: format => JSON_OBJECT('enablelogs' value FALSE) |
기본값: |
encryption |
형식 옵션
이러한 매개변수에 대한 값을 지정하지 않은 경우 블록 암호화 체인 수정자 및 블록 암호화 패딩 수정자 값은 기본적으로 형식 옵션
예: 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 문자열입니다.
암호화 유형을 지정합니다.
암호화 키를 저장하는 데 사용되는 인증서를 지정합니다. user_defined_function: value지정된 BLOB(binary large object)를 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. |
endquote |
데이터는 예: format => JSON_OBJECT('quote' value '(', 'endquote' value ')') |
기본값: Null, 즉 |
escape |
지정된 경우 "\" 문자가 이스케이프 문자로 사용됩니다. |
기본값: |
JSON 데이터에 적합한 옵션 |
True로 설정하면 빈 행이 무시됩니다. |
기본값: |
ignoremissingcolumns |
열이 소스 파일보다 field_list에서 더 많을 경우 추가 열이 널로 저장됩니다. |
기본값 |
|
로드할 문서를 식별하는 JSON 경로입니다. 이 옵션은 |
기본값: Null |
| `keyassignment` `COPY_COLLECTION`에서만 사용 |
새 컬렉션을 몽고 호환 컬렉션으로 생성할지 아니면 SODA 컬렉션으로 생성할지 지정합니다. 값이 기본적으로 이 매개변수는 설정되지 않습니다. 즉, 새 컬렉션이 SODA 컬렉션으로 생성됩니다. |
기본값: |
|
값을 경로(예: 이 매개변수는 선택 사항이며 몽고 호환 컬렉션으로 로드하는 경우에만 유효합니다. 지정되지 않은 경우 Oracle은 12바이트 고유 시스템 ID를 생성하고 |
기본값:
|
language |
언어 이름(예: FRENCH)은 로케일에 민감한 정보가 파생될 수 있는 언어 이름을 지정합니다. |
기본값: Null Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
logdir |
기본적으로 예:
위 예제에 지정된
위 예제에 지정된 |
기본값: |
logprefix |
로그 테이블 이름 형식: logprefix 기본적으로 logprefix는 대문자로 표시되지만 대소문자는 지정된 값이 큰 따옴표로 묶일 때 예약됩니다. 예: format => JSON_OBJECT ('logprefix' value 'TEST')그런 다음 로그 파일은 |
기본값: |
logretention |
적합한 값: 예: format => JSON_OBJECT ('logretention' value 7) |
기본값: |
이 옵션은 JSON 데이터에만 적합합니다. |
최대 JSON 문서 크기입니다. |
기본값: 1MB 허용되는 최대값: 2GB |
numericcharacters |
그룹 구분자 및 십진수로 사용할 문자를 지정합니다. decimal_character: 십진수는 숫자의 정수 부분을 십진수 부분과 구분합니다. group_separator: 그룹 구분자는 정수 그룹(즉, 천, 수백만, 수십억 등)을 구분합니다. |
기본값: 자세한 내용은 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
numberformat |
숫자 형식 모델을 지정합니다. 숫자 형식 모델을 사용하면 숫자가 지정된 유효 자릿수로 반올림됩니다. 숫자 형식 모델은 하나 이상의 숫자 형식 요소로 구성됩니다.
|
기본값: 자세한 내용은 Oracle Database 19c SQL 언어 참조의 숫자 형식 모델 또는 Oracle Database 23ai SQL 언어 참조를 참조하십시오. |
partition_columns |
형식 옵션
데이터 파일이 구조화되지 않고 하이브 형식을 기반으로 하지 않는 객체 이름의 경우 지정된 |
|
quote |
인용부호는 필드의 인용 문자를 지정합니다. 지정된 경우 quote 문자는 로드 중에 제거됩니다. |
기본값: 널은 인용부호 없음을 의미 |
JSON 데이터에 적합한 옵션 |
레코드 구분자를 지정합니다. 기본적으로 다음과 같이 기본 동작을 재정의하려는 경우 이 인수를 명시적으로 지정합니다. 레코드 구분자가 없음을 나타내기 위해 입력 파일에서 발생하지 않는
|
기본값: newline 감지됨 |
regexuri |
형식 옵션
정규식 패턴은 URI의 파일 이름 또는 하위 폴더 경로에 대해서만 지원되며 패턴 일치는 External Table의 경우 이 옵션은 Object Storage의 파일에 생성되는 테이블에서만 지원됩니다. 예:
|
기본값: |
rejectlimit |
지정된 수의 행이 거부된 후 작업에 오류가 발생합니다. |
기본값: |
removequotes |
소스 파일의 필드 주위에 있는 인용부호를 제거하십시오. |
기본값: |
skipheaders |
파일 시작 위치에서 건너뛸 행 수를 지정합니다. |
기본값은 지정되지 않은 경우 0, 값 없이 지정된 경우 1입니다. |
territory |
입력 데이터 특성을 추가로 결정할 할당영역 이름을 지정합니다. |
기본값: Null Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
timestampformat |
소스 파일의 시간기록 형식을 지정하십시오. 형식 옵션 YYYY-MM-DD HH:MI:SS.FF |
기본값: 데이터베이스 시간 기록 형식 문자열은 "$"와 같은 와일드카드 문자를 포함할 수 있습니다. |
timestampltzformat |
소스 파일의 로컬 시간대 형식이 포함된 시간기록을 지정합니다. 형식 옵션 DD Mon YYYY HH:MI:SS.FF TZR |
기본값: 로컬 시간대 형식이 있는 데이터베이스 시간 기록 |
timestamptzformat |
소스 파일의 시간대 형식이 포함된 시간기록을 지정합니다. 형식 옵션 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 |
기본값: 시간대 형식이 있는 데이터베이스 시간 기록 |
trimspaces |
필드의 선행 및 후행 공백을 자르는 방법을 지정하십시오. Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities에서 trim_spec에 대한 설명을 참조하십시오. |
기본값: |
truncatecol |
파일의 데이터가 필드에 비해 너무 긴 경우 이 옵션은 행을 거부하지 않고 필드의 값을 자릅니다. |
기본값: |
type |
소스 파일 유형을 지정합니다. CSV에 대한 설명은 Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하십시오.
|
주: 모든
기본값: Null JSON 데이터의 경우 |
|
이 옵션은 |
기본값: |