テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミング
CSV、JSON、ParquetまたはXMLテキスト・ファイル出力でのDBMS_CLOUD.EXPORT_DATA
を使用した出力ファイル・ネーミングについて説明します。
DBMS_CLOUD.EXPORT_DATA
は、query
パラメータで指定された問合せを実行し、クラウド・オブジェクト・ストア・バケットまたはディレクトリ内のテキスト・ファイルに結果を送信します。出力形式は、指定するformat
パラメータtype
(CSV、JSON、ParquetまたはXMLのいずれか)によって異なります。
プロシージャを高速化し、出力を生成するために、DBMS_CLOUD.EXPORT_DATA
はその作業を分割します。つまり、システム・リソースに応じて、DBMS_CLOUD.EXPORT_DATA
を実行すると、プロシージャによってクラウド・オブジェクト・ストア・バケットまたはディレクトリ内に複数の出力ファイルが作成されます。
生成される各ファイルの形式は:
[FileNamePrefix | client_info_module_action]_sequenceNum_timestamp.format_extension.[compression_extension]
-
FileNamePrefix: (optional) If a FileNamePrefix is supplied,
DBMS_CLOUD.EXPORT_DATA
uses the file name prefix to generate file names for the results.FileNamePrefixは、file_uri_list
パラメータ値のバケットまたはディレクトリ名の後に指定されたテキストを使用して指定されます。file_uri_list
のFileNamePrefixに複数の値を指定することはできません。 -
client_info_module_action: If a file name prefix is not supplied with the
file_uri_list
parameter,DBMS_CLOUD.EXPORT_DATA
uses the combination of client_info, application module and action as the file name prefix (when this information is available).このプロシージャは、問合せを実行するデータベース・セッションのアプリケーション情報からこれらの名前を取得します。client_info、module名およびaction名の詳細は、DBMS_APPLICATION_INFOを参照してください。ファイル名接頭辞が
file_uri_list
で指定されておらず、データベース・セッション属性も使用できない場合、DBMS_CLOUD.EXPORT_DATA
はファイル名接頭辞"data
""を使用します。 -
sequenceNum:
DBMS_CLOUD.EXPORT_DATA
の問合せに関連付けられた順序番号。問合せ、データベース・サービス、およびECPUの数(データベースがOCPUを使用している場合のOCPU)に応じて、1つ以上のsequenceNumがあります。また、結果のサイズに応じて、sequenceNumごとに1つ以上の出力ファイルがあります。データベース・サービスの詳細は、Autonomous Databaseでの同時実行性および優先度の管理を参照してください。
-
timestamp: ファイルがアップロードされたときのタイムスタンプ。
-
format_extension: デフォルト値は、
format
のtype
値によって異なります:- CSV形式:
.csv
- JSON形式:
.json
- PARQUET形式
.parquet
- XML形式:
.xml
詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ形式オプションの
format
オプションのfileextension
に関する説明を参照してください。 - CSV形式:
-
compression_extension:
format
パラメータにcompression
オプションに値gzip
を含める場合、これは"gz"
です。format
type
がparquet
の場合、compression
値snappy
もサポートされ、これがデフォルトです。
たとえば、次のDBMS_CLOUD.EXPORT_DATA
プロシージャのファイル名接頭辞は、file_uri_list
パラメータにdept_export
として指定されています。この例では、指定されたオブジェクト・ストアへの出力を指定された形式で生成します。
BEGIN
DBMS_CLOUD.EXPORT_DATA
(
credential_name => 'DEF_CRED_NAME',
file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
query => 'SELECT * FROM DEPT',
format => JSON_OBJECT('type' value 'json'));
END;
/
ファイル名接頭辞を指定すると、生成される出力ファイルには、次のようなファイル名接頭辞が含まれます:
dept_export_1_20210809T173033Z.json
dept_export_2_20210809T173034Z.json
dept_export_3_20210809T173041Z.json
dept_export_4_20210809T173035Z.json
生成される出力ファイルの数は、結果のサイズ、データベース・サービス、およびAutonomous DatabaseインスタンスのECPU (OCPUを使用している場合のOCPU)の数によって異なります。
次の例では、file_uri_list
パラメータにファイル名接頭辞が含まれず、compression
パラメータに値gzip
が指定されています:
BEGIN
DBMS_CLOUD.EXPORT_DATA
(
credential_name => 'DEF_CRED_NAME',
file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/',
query => 'SELECT * FROM DEPT',
format => json_object('type' value 'json', 'compression' value 'gzip'));
END;
/
ファイル名接頭辞がfile_uri_list
パラメータに含まれない場合、DBMS_CLOUD.EXPORT_DATA
は、client_info_module_actionという形式のファイル名接頭辞を使用します。この例では、生成された出力ファイルには、次のようにDBMS_CLOUD.EXPORT_DATA
が提供するファイル名接頭辞が含まれ、ファイルはgzipで圧縮され、ファイル拡張子.gz
が追加されます:
Client1_Module1_Action1_1_20210809T173033Z.json.gz
Client1_Module1_Action1_2_20210809T173034Z.json.gz
Client1_Module1_Action1_3_20210809T173041Z.json.gz
Client1_Module1_Action1_4_20210809T173035Z.json.gz
DBMS_CLOUD.EXPORT_DATA
の実行時にclient_info_module_actionセッション情報が使用できない場合、ファイル名接頭辞はdata
に設定されます。たとえば:
data_1_20210809T173033Z.json.gz
data_2_20210809T173034Z.json.gz
data_3_20210809T173041Z.json.gz
data_4_20210809T173035Z.json.gz
たとえば、次のDBMS_CLOUD.EXPORT_DATA
プロシージャのファイル名接頭辞は、file_uri_list
パラメータにdept_export
として指定されています。この例では、指定されたディレクトリへの出力を指定された形式で生成します。
BEGIN
DBMS_CLOUD.EXPORT_DATA
(
file_uri_list => 'DATA_PUMP_DIR:sales.json',
query => 'SELECT * FROM SALES',
format => JSON_OBJECT('type' value 'json'));
END;
/
ファイル名接頭辞を指定すると、生成される出力ファイルには、次のようなファイル名接頭辞が含まれます:
sales_1_20230705T124523275915Z.csv
DBMS_CLOUD.EXPORT_DATA
を使用したファイル・ネーミングに関するノート:
-
DBMS_CLOUD.EXPORT_DATA
は、バケットまたはディレクトリを作成しません。 -
DBMS_CLOUD.EXPORT_DATA
によって生成されるファイルの数は、ECPUの数(データベースがOCPUを使用する場合のOCPU)、データベース・サービス、および結果データのサイズによって決まります。 -
file_uri_list
パラメータでディレクトリ・オブジェクト名を指定する場合は、次のようになります。-
指定されたディレクトリが存在し、そのディレクトリへの
WRITE
アクセス権を持っている必要があります。 -
ディレクトリ名は、二重引用符で囲むと大文字と小文字が区別されます。
-
資格証明名パラメータを指定しないでください。
-
-
CSV、JSONまたはXML出力の場合、生成されたファイルに10MBのデータが含まれると、デフォルトで新しい出力ファイルが作成されます。ただし、結果データが10MB未満の場合でも、データベース・サービスおよびAutonomous DatabaseインスタンスのECPU (OCPUを使用している場合)の数によっては、複数の出力ファイルが作成される可能性があります。
CSV、JSONまたはXMLのデフォルトの出力ファイルのチャンク・サイズは10MBです。この値は、
format
パラメータのmaxfilesize
オプションを使用して変更できます。詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ形式オプションを参照してください。 -
Parquet出力の場合、生成される各ファイルは128MB未満で、複数の出力ファイルが生成される可能性があります。ただし、結果データが128MB未満の場合でも、データベース・サービスおよびAutonomous DatabaseインスタンスのECPU (OCPUを使用している場合)の数によっては、複数の出力ファイルが作成される可能性があります。
format
パラメータのmaxfilesize
オプションは、Parquetファイルには適用されません。