CSV の構成

JSON ファイルに必要な構成を追加し、qsam encode コマンドまたは qsam decode コマンドで --input-parameter csv-dialect=DataPath オプションを使用してこのファイルを指定することで、Mainframe Connector トランスコーダの CSV 形式を構成できます。CsvConfiguration セクションで指定されているように、CSV 構成を定義する必要があります。

このページでは、トランスコーディングの入力パラメータとして構成できるさまざまな CSV パラメータについて説明します。CsvConfiguration オブジェクトには、すべての CSV エンコーダとデコーダの構成オプションが含まれています。

CsvConfiguration

CsvConfiguration オブジェクトを使用すると、CSV デコードとエンコーダの構成を構成できます。

JSON 表現
{
    "null_representation": string,
    "header": enum (WriteHeaderMode),
    "quote_escaping": string,
    "quote": string,
    "delimiter": string,
    "line_terminator": string,
    "support_list": boolean,
    "list_start_delimiter": string,
    "list_end_delimiter": string,
    "support_struct": boolean,
    "struct_start_delimiter": string,
    "struct_end_delimiter": string,
    "binary_data_encoding": enum (BinaryDataEncoding),
    "date_format": string,
    "timestamp_format": string,
    "quote_mode": enum (QuoteMode)
}
フィールド
null_representation

string

null 文字を表す文字列を指定します。

header

enum (WriteHeaderMode)

最初の行に実際のデータではなく列名を含める場合は、これを true に設定します。

quote_escaping

string

エスケープ文字を指定します。

quote

string

引用符を指定します。

delimiter

string

フィールドの区切りに使用する文字を指定します。

line_terminator

string

行の区切りに使用する文字を指定します。

support_list

boolean

Mainframe Connector で CSV のリストをサポートする場合は、true に設定します。

list_start_delimiter

string

support_list が true に設定されている場合、この値はリストの開始文字の区切り文字を表します。

list_end_delimiter

string

support_list が true に設定されている場合、この値はリストの終了文字区切り文字を表します。

support_struct

boolean

Mainframe Connector で CSV の構造体をサポートする場合は true に設定します。

struct_start_delimiter

string

support_struct が true に設定されている場合、この値は構造体の開始文字区切り文字を表します。

struct_end_delimiter

string

support_struct が true に設定されている場合、この値は構造体の終了文字区切り文字を表します。

binary_data_encoding

enum (BinaryDataEncoding)

Mainframe Connector がバイナリデータをエンコードまたはデコードする方法を指定します。有効な値は、16 進数、base64、16 進数です。デフォルト値は base64 です。

date_format

string

日付の形式を指定します。デフォルトの形式は yyyy-mm-dd です。

timestamp_format

string

タイムスタンプの形式を指定します。デフォルト値は DateTimeFormatter.ISO_INSTANT です。

quote_mode

enum (QuoteMode)

引用の動作を指定します。デフォルト値は MINIMAL です。

WriteHeaderMode

CSV ヘッダーの書き込み動作を定義します。

列挙型
NO CSV ヘッダーを書き込みません。
YES データが存在する場合にのみ CSV ヘッダーを書き込みます。
ALWAYS CSV ヘッダーを常に書き込みます。

BinaryDataEncoding

Mainframe Connector がバイナリデータをエンコードまたはデコードする方法を指定します。有効な値は、16 進数、base64、16 進数です。デフォルト値は base64 です。

列挙型
BASE64 バイナリデータを ASCII 文字列にエンコードします。
HEX バイナリデータを 16 進数(\x 形式)またはエスケープされた 8 進数にエンコードします。
HEXADECIMAL バイナリデータを 16 進数(0x 形式)または生のバイナリにエンコードします。

QuoteMode

引用の動作を定義します。

列挙型
MINIMAL フィールド区切り文字、引用符文字、行区切り文字の文字列に含まれる文字などの特殊文字を含むフィールドを引用符で囲みます。
ALL_NON_NULL null 以外のすべてのフィールドを引用符で囲みます。
ALL すべてのフィールドを引用符で囲みます。
NON_NUMERIC 数値以外のフィールドをすべて引用符で囲みます。
NONE フィールドを引用符で囲みません。データに区切り文字が含まれている場合、プリンタは区切り文字の前にエスケープ文字を付加します。エスケープ文字が設定されていない場合、形式の検証で例外がスローされます。