DBMS_CLOUDパッケージ形式オプション
DBMS_CLOUD
のformat引数は、ソース・ファイルの形式を指定します。
format引数を指定するには、次の2つの方法があります。
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」形式のオプションについては、「Avro、ORCまたはParquet用のDBMS_CLOUDパッケージ形式オプション」を参照してください。「書式オプション」列に示されているように、format
type
がJSONの場合、フォーマット・オプションの限定セットはDBMS_CLOUD.COPY_COLLECTION
またはDBMS_CLOUD.COPY_DATA
で有効です。
書式オプション | 説明 | 構文 |
---|---|---|
|
AWSやOCIオブジェクト・ストレージなどの「Apache Iceberg」表のタイプと、データ・カタログからの情報や直接メタデータURIからの情報など、外部表の作成に使用される情報を指定します。 |
|
|
|
デフォルト値: |
|
ソース・ファイルの文字セットを指定します |
デフォルト値: データベース文字セット |
|
JSONレコードから抽出する必要があるフィールドに対応するJSONパス式の配列。 配列内の各JSONパス式は、「SQL/JSONパス式」で説明されているルールに従う必要があります。 JSONおよび |
文字列形式で表されたjsonパス式のJSON配列。 たとえば: 'columnpath'の値 |
JSONデータで有効なオプション |
ソース・ファイルの圧縮タイプを指定します ZIPアーカイブ形式はサポートされていません。 値 |
デフォルト値: null値は圧縮を意味しません。 |
|
データ型の変換エラーのために行が拒否された場合、関連する列はnullとして格納されるか、行は拒否されます。 |
デフォルト値: |
|
ソース・ファイルの日付形式を指定します。 フォーマット・オプション J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
デフォルト値: データベースの日付形式 |
|
フィールド区切り文字を指定します デリミタとして特殊文字を使用するには、その文字のASCIIコードのHEX値を指定します。 たとえば、次の例では、TAB文字をデリミタとして指定します:
|
デフォルト値の |
|
外部データ・ファイルのフィールドが表の列と異なる順序になるように指定します。 各外部データ・ファイルの最初の行を使用してフィールドの順序を検出し、それを表の列にマップします。 外部データファイルのフィールド名は、表列の名前と大文字と小文字を区別しない方法で比較されます。 この書式オプションは、次の手順に適用できます:
詳細は、「フィールド名」および |
デフォルト値: |
|
フォーマット・オプション
たとえば: 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 (バイナリ・ラージ・オブジェクト)を復号化または暗号化する完全修飾ユーザー定義関数を指定します。 |
|
たとえば: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
デフォルト値: NULL。 |
|
「\」の文字は、指定するとエスケープ文字として使用されます。 |
デフォルト値: |
JSONデータで有効なオプション |
trueに設定すると空白行は無視されます。 |
デフォルト値: |
|
|
デフォルト値 |
|
暗黙的なパーティション化は、次の方法で有効化されます:
オプションの説明と構文については、 |
デフォルト値: |
|
暗黙的なパーティション化の有効化および例の詳細は、 |
デフォルト値: |
|
ロードするドキュメントを識別するJSONパス。 このオプションは、 |
デフォルト値: NULL |
keyassignment
|
新しいコレクションをモンゴ互換コレクションとして作成するか、SODAコレクションとして作成するかを指定します。 値が デフォルトでは、このパラメータは設定されません。つまり、新しいコレクションがSODAコレクションとして作成されます。 |
デフォルト: |
|
値をパス(たとえば、 このパラメータはオプションであり、モンゴ互換コレクションへのロードにのみ有効です。 指定しない場合、Oracleは12バイトの一意のシステムIDを生成し、ロードされるデータに |
デフォルト:
|
|
ロケール依存情報の導出元となる言語名(FRENCHなど)を指定します。 |
デフォルト値: NULL Oracle対応言語のリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』の「ロケール・データ」を参照してください。 |
|
デフォルトでは、 たとえば:
上の例で指定した
上の例で指定した |
デフォルト値: |
|
ログ表名の形式は次のとおりです: ログ接頭辞 デフォルトでは、logprefixは大文字ですが、指定された値が二重引用符で囲まれている場合は大/小文字が保持されます。 たとえば: format => JSON_OBJECT ('logprefix' value 'TEST') ログ・ファイルは、次のような |
デフォルト値: |
|
有効な値: たとえば: format => JSON_OBJECT ('logretention' value 7) |
デフォルト値: |
このオプションはJSONデータでのみ有効です |
JSONドキュメントの最大サイズ。 |
デフォルト値: 1メガバイト 最大許容値: 2ギガバイト |
|
グループ・セパレータおよび小数点文字として使用する文字を指定します。 decimal_character: 小数部分は、数値の整数部分を小数部分から区切ります。 group_separator: グループ・セパレータは、整数グループ(千、百万、十億など)を区切ります。 |
デフォルト値: 詳細については、『Oracle Databaseグローバリゼーション・サポート・ガイド』のNLS_NUMERIC_CHARACTERSを参照してください。 |
|
数値書式モデルを指定します。 数値書式モデルでは、数値が指定した有効桁数に丸められます。 数値書式モデルは、1つ以上の数値書式要素で構成されます。 これは、 |
デフォルト値: 詳細は、「SQL言語リファレンス」の「数値書式モデル」を参照してください。 |
|
フォーマット・オプション
データファイルが構造化されておらず、 Hive形式に基づかないオブジェクト名の場合、 |
|
|
フィールドの引用符を指定します。指定すると、ロード中に |
デフォルト値: ヌルは見積もりを意味しない |
JSONデータで有効なオプション |
レコード区切り文字を指定します デフォルトでは、 デフォルトの動作をオーバーライドする場合は、この引数を明示的に指定します。たとえば:
レコード・デリミタがないことを示すために、入力ファイルに出現しない
|
デフォルト値: 検出された復帰改行 |
|
フォーマット・オプション
正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致は 外部表の場合、このオプションは、オブジェクト・ストレージのファイルに作成される表でのみサポートされます。 たとえば:
|
デフォルト値 : |
|
指定された行数が拒否されると、操作はエラーになります。 |
デフォルト値: |
|
ソース・ファイル内の任意のフィールドの引用符を削除します。 |
デフォルト値: |
|
ファイルの先頭からスキップする行数を指定します。 |
デフォルト値: 指定されていない場合は0、値なしの場合は1 |
|
入力データ特性をさらに詳細に決定するためのテリトリ名を指定します。 |
デフォルト値: NULL Oracle対応のテリトリのリストについては、『Oracle Databaseグローバリゼーション・サポート・ガイド』の「ロケール・データ」を参照してください。 |
|
ソース・ファイルのタイムスタンプ形式を指定します。 フォーマット・オプション 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 |
デフォルト値: タイムゾーン形式のデータベース・タイムスタンプ |
|
フィールドの先頭と末尾のスペースをどのようにトリミングするかを指定します。 trim_specの説明を参照してください。 |
デフォルト値: |
|
ファイル内のデータがフィールドに対して長すぎる場合、このオプションは行を拒否するのではなくフィールドの値を切り捨てます。 |
デフォルト値: |
|
ソース・ファイルのタイプを指定します。 「field_definitions句」の
「Avro、ORCまたはParquet用のDBMS_CLOUDパッケージ形式オプション」 for
|
ノート: すべてのDBMS_CLOUD プロシージャがこれらのタイプをサポートしているわけではありません。
デフォルト値: NULL JSONデータの場合、 |
|
このオプションは、 |
デフォルト値: |
親トピック: DBMS_CLOUDパッケージ