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、hex です。デフォルト値は base64 です。
date_format

string

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

string

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

enum (QuoteMode)

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

BinaryDataEncoding

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

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

WriteHeaderMode

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

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

QuoteMode

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

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