Oracle Cloud Infrastructureドキュメント

DBMS_CLOUD Avro、ORCまたはParquet用のパッケージ・フォーマット・オプション

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')
フォーマット・オプション 摘要 構文

maxvarchar

Avro、ORCまたはParquetフォーマット・ファイルで外部表を作成する際の文字列のデフォルトの最大varchar2()長を制御します。オプションは次のとおりです。

  • standard: varchar2()列の長さ制限が4000バイトであることを指定します。これは、MAX_STRING_SIZE = standardのシステムのautoと同等です。

    MAX_STRING_SIZE = extendedのシステムでは、Avro、ORCまたはParquetで外部表を作成し、maxvarcharをstandardとして指定すると、文字列がvarchar2(4000)に短縮されます。

  • extended: varchar2()列の長さ制限が32767バイトであることを指定します。これは、MAX_STRING_SIZE = extendedのシステムのautoと同等です。この値は、MAX_STRING_SIZE = standardのシステムでエラーが発生します。

  • auto: MAX_STRING_SIZE値に基づいて、varchar2()の最大バイト・サイズが自動的に選択されます。値autoは、maxvarcharのデフォルト値です。

maxvarchar: standard | extended | auto

デフォルト値:auto

regexuri

regexuriの値がTRUEに設定されている場合、クラウド・ソース・ファイルURIのファイル名でワイルドカードと正規表現を使用できます。

regexuriパラメータがFALSEに設定されている場合、文字「*」および「?」はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字「*」および「?」は指定された正規表現パターンの一部です。

正規表現パターンはURI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。ディレクトリ名に対して正規表現パターンはサポートされていません。

外部表の場合、このオプションは、オブジェクト・ストレージのファイルに作成される表でのみサポートされます。

たとえば:

format => JSON_OBJECT('regexuri' value TRUE)

REGEXP_LIKE条件の詳細は、「REGEXP_LIKE条件」を参照してください。

regexuri: True

デフォルト値:False
type

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

type : avro | orc | parquet

schema

schemaがfirstまたはallに設定されている場合、外部表の列とデータ型は、Avro、ORCまたはParquetファイルのメタデータから自動的に導出されます。

列名は、Avro、ORCまたはParquetに含まれるものと一致します。データ型は、Avro、ORCまたはParquetデータ型からOracleデータ型に変換されます。すべての列が表に追加されます。

値firstは、列とそのデータ型を自動生成するためにfile_uri_list内の最初のAvro、ORCまたはParquetファイルのメタデータを使用するよう指定します。すべてのファイルのスキーマが同じ場合は、firstを使用します。

値allは、列とそのデータ型を自動生成するためにfile_uri_list内のすべてのAvro、ORCまたはParquetファイルのメタデータを使用するよう指定します。各ファイルのスキーマが異なる可能性がある場合は、all (低速)を使用します。

デフォルト: column_listを指定した場合、schema値(指定されている場合)は無視されます。column_listを指定しない場合、schemaのデフォルト値はfirstです。

ノート: Avro、ORCまたはParquet形式のファイルの場合は、schemaフォーマット・オプションは使用できなくなり、DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEプロシージャを使用してパーティション化された外部表にcolumn_listパラメータを指定する必要があります。

schema : first | all