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