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)
형식 옵션 열에 설명된 대로 제한된 형식 옵션 세트는 DBMS_CLOUD.COPY_COLLECTION
또는 DBMS_CLOUD.COPY_DATA
(format
type
가 JSON인 경우)와 함께 유효합니다.
형식 옵션 | 설명 | 구문 |
---|---|---|
|
|
기본값: |
|
소스 파일의 문자 집합을 지정합니다. |
기본값: 데이터베이스 문자 집합 |
|
JSON 레코드에서 추출해야 하는 필드에 해당하는 JSON 경로 표현식의 배열입니다. 배열의 각 JSON 경로 표현식은 Oracle Database 19c JSON Developer's Guide 또는 Oracle Database 23ai JSON Developer's Guide의 SQL/JSON Path Expressions에 설명된 규칙을 따라야 합니다. JSON 및 |
문자열 형식으로 표현된 JSON 경로 표현식의 JSON 배열입니다. 예: 'columnpath' value |
JSON 데이터에 적합한 옵션 |
소스 파일의 압축 유형을 지정합니다. ZIP 아카이브 형식은 지원되지 않습니다.
|
기본값: 압축 없음을 의미하는 널 값입니다. |
|
데이터 유형 변환 오류로 인해 행이 거부된 경우 관련 열이 널로 저장되거나 행이 거부됩니다. |
기본값은 |
|
소스 파일의 날짜 형식을 지정합니다. 형식 옵션 J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
기본값: 데이터베이스 날짜 형식 |
|
필드 구분자를 지정합니다. 특수 문자를 구분자로 사용하려면 문자의 ASCII 코드에 대한 HEX 값을 지정합니다. 예를 들어, 다음은 TAB 문자를 구분자로 지정합니다.
|
기본값 |
|
외부 데이터 파일의 필드가 테이블의 열과 다른 순서로 지정되도록 합니다. 각 외부 데이터 파일의 첫번째 행을 사용하여 필드의 순서를 감지하고 테이블의 열에 매핑합니다. 외부 데이터 파일의 필드 이름은 대소문자를 구분하지 않고 테이블 열 이름과 비교됩니다. 이 형식 옵션은 다음 절차에 적용할 수 있습니다.
자세한 내용은 FIELD NAMES in Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하고 |
기본값: |
|
형식 옵션
예: format => JSON_OBJECT('enablelogs' value FALSE) |
기본값: |
|
형식 옵션 다음 매개변수를 지정하여 암호화 및 해독하려면
이러한 매개변수에 값을 지정하지 않으면 블록 암호화 체인화 수정자 및 블록 암호화 패딩 수정자 값은 기본적으로 형식 옵션
encryption 는 다음 DBMS_CLOUD 프로시저와 함께 사용됩니다.
예: 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(이진 LOB)을 해독하거나 암호화할 정규화된 사용자 정의 함수를 지정합니다. |
|
데이터는 예: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
기본값: 널, |
|
지정된 경우 "\" 문자가 이스케이프 문자로 사용됩니다. |
기본값: |
JSON 데이터에 적합한 옵션 |
true로 설정할 경우 빈 행이 무시됩니다. |
기본값: |
|
|
기본값 |
|
로드할 문서를 식별하는 JSON 경로입니다. 이 옵션은 |
기본값은 널입니다 |
keyassignment
|
새 컬렉션을 몽고 호환 컬렉션으로 만들지 아니면 SODA 컬렉션으로 만들지 지정합니다. 값이 기본적으로 이 매개변수는 설정되지 않으므로 새 컬렉션이 SODA 컬렉션으로 생성됩니다. |
기본값: |
|
경로 값을 경로(예: 이 매개변수는 선택사항이며 몽고 호환 컬렉션으로 로드하는 경우에만 유효합니다. 지정하지 않을 경우 Oracle은 12바이트 고유 시스템 ID를 생성하고 로드 중인 데이터에 |
기본값:
|
|
로케일에 민감한 정보가 파생될 수 있는 언어 이름(예: FRENCH)을 지정합니다. |
기본값은 널입니다 Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
|
기본적으로 예:
위 예제에 지정된
위 예제에 지정된 |
기본값: |
|
로그 테이블 이름 형식은 logprefix 기본적으로 logprefix는 대문자이지만 지정된 값을 큰따옴표로 묶으면 대소문자가 예약됩니다. 예: format => JSON_OBJECT ('logprefix' value 'TEST') 그런 다음 로그 파일은 |
기본값: |
|
적합한 값: 예: format => JSON_OBJECT ('logretention' value 7) |
기본값: |
이 옵션은 JSON 데이터에서만 유효합니다. |
최대 JSON 문서 크기입니다. |
기본값: 1MB 허용되는 최대값: 2기가바이트 |
|
그룹 구분 기호 및 십진수 문자로 사용할 문자를 지정합니다. decimal_character: 십진수는 숫자의 정수 부분을 십진수 부분과 구분합니다. group_separator: 그룹 구분 기호는 정수 그룹(즉, 천 단위, 백만 단위, 수십억 단위 등)을 구분합니다. |
기본값: 자세한 내용은 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
|
숫자 형식 모델을 지정합니다. 숫자 형식 모델에서는 숫자를 지정된 유효 자릿수로 반올림합니다. 숫자 형식 모델은 하나 이상의 숫자 형식 요소로 구성됩니다. 이는 |
기본값: 자세한 내용은 Oracle Database 19c SQL Language Reference의 Number Format Models 또는 Oracle Database 23ai SQL Language Reference를 참조하십시오. |
|
형식 옵션
데이터 파일이 구조화되지 않고 하이브 형식을 기반으로 하지 않는 객체 이름의 경우 |
|
|
필드의 인용 문자를 지정합니다. 지정된 경우 |
기본값: 널은 따옴표 없음을 의미합니다. |
JSON 데이터에 적합한 옵션 |
레코드 구분자를 지정합니다. 기본적으로 다음과 같이 기본 동작을 무효화하려는 경우 이 인수를 명시적으로 지정합니다.
레코드 구분자가 없음을 나타내려면 입력 파일에서 발생하지 않는
|
기본값: 감지된 줄바꿈 |
|
형식 옵션
정규 표현식 패턴은 URI의 파일 이름 또는 하위 폴더 경로에 대해서만 지원되며 패턴 일치는 External Table의 경우 이 옵션은 Object Storage에 있는 파일에 생성된 테이블에서만 지원됩니다. 예:
|
기본값: |
|
지정된 수의 행이 거부된 후 작업에 오류가 발생합니다. |
기본값: |
|
소스 파일의 필드 주위에 있는 따옴표를 제거합니다. |
기본값: |
|
파일 시작 위치에서 건너뛸 행 수를 지정합니다. |
기본값: 지정되지 않은 경우 0, 값 없이 지정된 경우 1 |
|
입력 데이터 특성을 추가로 결정하기 위한 할당영역 이름을 지정합니다. |
기본값은 널입니다 Oracle 지원 언어 목록은 Oracle Database 19c Database Globalization Support Guide의 Locale Data 또는 Oracle Database 23ai Database Globalization Support Guide를 참조하십시오. |
|
소스 파일의 시간 기록 형식을 지정합니다. 형식 옵션 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 |
기본값: 데이터베이스 시간기록 형식 문자열에는 "$"와 같은 대체 문자가 포함될 수 있습니다. |
|
소스 파일의 로컬 시간대 포함 타임스탬프 형식을 지정합니다. 형식 옵션 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 |
기본값: 로컬 시간대 형식의 데이터베이스 시간 기록 형식 |
|
소스 파일의 시간대 포함 시간 기록 형식을 지정합니다. 형식 옵션 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 |
기본값: 시간대 형식의 데이터베이스 시간 기록 형식 |
|
필드의 앞뒤 공백을 자르는 방법을 지정합니다. See the description of trim_spec in Oracle Database 19c Utilities or Oracle Database 23ai Utilities. |
기본값: |
|
파일의 데이터가 필드에 비해 너무 긴 경우 이 옵션은 행을 거부하지 않고 필드의 값을 자릅니다. |
기본값: |
|
소스 파일 유형을 지정합니다. CSV에 대한 설명은 Oracle Database 19c Utilities 또는 Oracle Database 23ai Utilities를 참조하십시오.
|
주: 모든DBMS_CLOUD 절차가 이러한 유형을 지원하는 것은 아닙니다.
기본값은 널입니다 JSON 데이터의 경우 |
|
이 옵션은 |
기본값: |