CSV 設定

您可以在 JSON 檔案中新增必要設定，並使用 --input-parameter csv-dialect=DataPath 選項搭配 qsam encode 或 qsam decode 指令指定這個檔案，藉此設定 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

指定代表空值的字串。
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 編碼或解碼二進位資料的方式。有效值為十六進位、Base64 或十六進位。預設值為 base64。
date_format

string

指定日期格式。預設格式為 yyyy-mm-dd。
timestamp_format

string

指定時間戳記的格式。預設值為 DateTimeFormatter.ISO_INSTANT。
quote_mode

enum (QuoteMode)

指定引用行為。預設值為 MINIMAL。

BinaryDataEncoding

指定 Mainframe Connector 編碼或解碼二進位資料的方式。有效值為十六進位、Base64 或十六進位。預設值為 base64。

列舉
BASE64 將二進位資料編碼為 ASCII 字串。
HEX 將二進位資料編碼為十六進位 (\x 格式) 或逸出八進位。
HEXADECIMAL 將二進位資料編碼為十六進位 (0x 格式) 或原始二進位。

WriteHeaderMode

定義寫入 CSV 標題的行為。

列舉
NO 不會寫入 CSV 標頭。
YES 只有在有資料時，才會寫入 CSV 標頭。
ALWAYS 一律寫入 CSV 標題。

QuoteMode

定義引用行為。

列舉
MINIMAL 引號欄位包含特殊字元，例如欄位分隔符號、引號字元或行分隔符號字串中的任何字元。
ALL_NON_NULL 以引號括住所有非空值欄位。
ALL 為所有欄位加上引號。
NON_NUMERIC 以引號括住所有非數字欄位。
NONE 請勿為欄位加上引號。如果資料中出現分隔符號，印表機會在分隔符號前加上逸出字元。 如果未設定逸出字元，格式驗證會擲回例外狀況。