機械翻訳について

EXPORT_DATAのDBMS_CLOUDパッケージ形式オプション

DBMS_CLOUD.EXPORT_DATAの有効なフォーマット・パラメータ・オプションを、テキスト・ファイル形式「CSV、JSON、ParquetまたはXML」 「およびOracle Data Pump用」で説明しています。

これらは、DBMS_CLOUD.EXPORT_DATAで使用する有効なformatパラメータです。 format typeオプションを使用し、値が次のいずれかである場合、テキスト・ファイルの出力を指定: csv, json, parquetまたはxml。 また、format typeがdatapumpの場合、formatオプションも表示されます。

format引数を指定するには、次の2つの方法があります。

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

および:

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

例:

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

複数のフォーマット・オプションを指定するには、値を,で区切ります。

たとえば:

format => json_object('compression' value 'gzip', 'type' value 'json')

この表は、formatパラメータtypeオプションが次のいずれかである場合のDBMS_CLOUD.EXPORT_DATAの書式オプションについて説明しています: CSV、JSON、ParquetまたはXML。 その他のプロシージャおよびその他の出力タイプについては、「DBMS_CLOUDパッケージ・フォーマット・オプション」でフォーマット・オプションのリストを参照してください。

書式オプション 説明 構文

compression

ソース・ファイルの圧縮タイプを指定します

ノート: ZIPアーカイブ形式はサポートされていません。

format typeがcsv、jsonまたはxmlの場合、デフォルトの圧縮はNullで、圧縮は行われません。

format typeがparquetの場合、デフォルトの圧縮はsnappyです。

format typeがdatapumpの場合、サポートされているOracle Data Pumpアクセス・パラメータを指定できます:

  • compression: 有効な値は次のとおりです: BASIC, LOW, MEDIUMおよびHIGH。

  • version: 有効な値は次のとおりです: COMPATIBLE、LATEST、および指定されたversion_number。

typeの場合:csv | json | xml

compression:gzip | zlib | zstd | bzip2

デフォルト値: null値は圧縮を意味しません。

typeがparquetの場合

compression: gzip | snappy

デフォルト値: snappy

型がdatapumpの場合

compression: BASIC|LOW|MEDIUM|HIGH

delimiter

カスタム・フィールド・デリミタを指定します。

format => json_object('delimiter' value '|')

デリミタ値は、ASCIIコードまたはエスケープ文字にできません。

ノート:

このオプションは、csv typeにのみ適用されます。

delimiter : 文字

デフォルト値、 (カンマ)

endquote

quoteとendquoteの2つのデリミタ間でフィールドを囲むことができることを指定します。 endquoteを指定しない場合、quote文字はデフォルトでendquote文字として使用されます。

たとえば:

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

ノート:

このオプションは、csv typeにのみ適用されます。

endquote:character

デフォルト値: NULL。endquoteがないことを意味します。

escape

""文字を使用して、フィールド値の引用符文字の出現を指定します。

ノート:

このオプションは、csv typeにのみ適用されます。

escape : true

デフォルト値: false

encryption

フォーマット・オプションencryptionは、オブジェクト・ストアとの間でデータをエクスポートおよびインポートする暗号化および復号化オプションを指定します。

encryptionを使用して、暗号化および復号化に次のパラメータを指定します:

  • user_defined_function: 指定されたBLOB (バイナリ・ラージ・オブジェクト)を復号化または暗号化する完全修飾ユーザー定義関数を指定します。 復号化または暗号化されたBLOBを返します。 このパラメータは、encryptionの他のパラメータと相互に排他的です。

    たとえば、ADMIN.DECRYPTION_CALLBACKです。

  • type: 復号化または暗号化する組込み暗号化アルゴリズムを指定します。user_defined_functionとtypeは相互に排他的です。

    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_HYBRID_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 (バイナリ・ラージ・オブジェクト)を復号化または暗号化する完全修飾ユーザー定義関数を指定します。

header

列名をcsvタイプの出力ファイルの最初の行として書き込みます。

headerオプションは、booleanまたはstring値を受け入れることができます。

有効な値は次のとおりです。

  • false: ヘッダー行をスキップします。

  • true: ヘッダー行が含まれます。 列名は、queryパラメータのSELECT文に基づいています。 仮想列または式を使用する場合は、SELECT文で列の別名を指定する必要があります。

  • String to define custom header names: カスタム名を使用してヘッダー行を定義できます。 文字列値の列およびデリミタの数は、SELECT文の列およびデリミタの数と一致する必要があります。 デフォルトのデリミタはカンマ(、)です。

たとえば:

format => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true)

ノート:

このオプションは、csv typeにのみ適用されます。

header: true| false| String to define custom header names

デフォルト値: false

fileextension

フォーマット・タイプのデフォルトの選択を上書きするためのカスタム・ファイル拡張子。 これは、DBMS_CLOUD.EXPORT_DATAを使用したテキスト形式に適用されます: CSV、JSON、ParquetまたはXML。

指定された文字列がピリオド(ドット)で始まらない場合、最終ファイル名のファイル拡張子の前にドットが自動的に挿入されます。

ファイル拡張子が必要ない場合は、値を使用: fileextension = 'none'

有効な値: 任意のファイル拡張子。

デフォルト値: format typeオプションによって異なります:
  • CSV形式: .csv
  • JSON形式: .json
  • PARQUET形式: .parquet
  • XMLフォーマット: .xml

maxfilesize

生成された出力の最大サイズのバイト数。

これは、format typeオプションがcsv、json、またはxmlに設定されている場合、DBMS_CLOUD.EXPORT_DATAを使用してデータをエクスポートするためのテキストベースの形式に適用されます。

ノート: このオプションは、format typeオプションがparquetの場合は無効です。

最小値: 10485760 (10 MB )

最大値: 1 GB

デフォルト値: 10485760 (10 MB)

quote

「CSV内」形式。フィールドを2つのデリミタで囲むことができます。 quoteおよびendquoteを使用してデリミタを指定します。 endquoteを指定しない場合、quote文字はデフォルトでendquote文字として使用されます。

ノート:

このオプションは、csv typeにのみ適用されます。

quote: 文字

デフォルト値: NULLの意味では、フィールドは引用符で囲みません。

trimspaces

CSV形式のフィールドの先頭および末尾のスペースの切捨て方法を指定します。 quoteパラメータが指定されている場合、フィールドを引用符で囲む前にトリップ・スペースが適用されます。

trim_specの説明を参照してください。

ノート:

このオプションは、csv typeにのみ適用されます。

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

デフォルト値: notrim

type

出力ファイル・タイプを指定します。

csv: 任意のカスタム文字で区切られた列値のセットとして問合せ結果をエクスポートできる、文字区切り値(CSV)形式を指定します。

json: 問合せ結果をJSONファイルとしてエクスポートするように指定します。

parquet: 問合せ結果をParquetファイルとしてエクスポートすることを指定します。

xml: 有効なXML文書の行として問合せ結果をエクスポートするように指定します。 各行は、<RECORD> </RECORD>のルートXMLタグにカプセル化されます。

問合せ結果は、XMLFOREST SQL関数を使用して自動的にXML形式に変換されます。 列のXMLタグ名をカスタマイズするには、列の別名を使用します。

format typeがdatapumpの場合、サポートされているOracle Data Pumpアクセス・パラメータを指定できます:

  • compression: 有効な値は次のとおりです: BASIC, LOW, MEDIUMおよびHIGH。

  • version: 有効な値は次のとおりです: COMPATIBLE、LATEST、および指定されたversion_number。

詳細については、「access_parameters句」を参照してください。

type: csv|datapump|json|parquet|xml