CSV 設定

如要設定 Mainframe Connector 轉碼器的 CSV 格式，請在 JSON 檔案中新增必要設定，並使用 --input-parameter csv-dialect=DataPath 選項，透過 qsam encode 或 qsam decode 指令指定這個檔案。您必須按照「CsvConfiguration」一節的規定定義 CSV 設定。

本頁面說明可設定為轉碼輸入參數的各種 CSV 參數。CsvConfiguration 物件包含所有 CSV 編碼器和解碼器設定選項。

CsvConfiguration

您可以使用 CsvConfiguration 物件設定 CSV 解碼和編碼器。

JSON 表示法 
{
    "binary_data_encoding": enum (BinaryDataEncoding),
    "date_format": string,
    "delimiter": string,
    "header": enum (WriteHeaderMode),
    "line_terminator": string,
    "list_end_delimiter": string,
    "list_start_delimiter": string,
    "null_representation": string,
    "quote": string,
    "quote_escaping": string,
    "quote_mode": enum (QuoteMode),
    "struct_end_delimiter": string,
    "struct_start_delimiter": string,
    "support_list": boolean,
    "support_struct": boolean,
    "timestamp_format": string
}
欄位
binary_data_encoding

enum (BinaryDataEncoding)

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

string

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

string

指定用於分隔欄位的字元。
header

enum (WriteHeaderMode)

如要讓第一列包含資料欄名稱而非實際資料，請將此屬性設為 true。
line_terminator

string

指定用於分隔行的字元。
list_end_delimiter

string

如果 support_list 設為 true，這個值代表清單的結尾字元分隔符。
list_start_delimiter

string

如果 support_list 設為 true，這個值代表清單的起始字元分隔符號。
null_representation

string

指定代表空值的字串。
quote

string

指定引號字元。
quote_escaping

string

指定逸出字元。
quote_mode

enum (QuoteMode)

指定引號行為。預設值為 MINIMAL。
struct_end_delimiter

string

如果 support_struct 設為 true，這個值代表結構體的結尾字元分隔符。
struct_start_delimiter

string

如果 support_struct 設為 true，這個值代表 struct 的起始字元分隔符號。
support_list

boolean

如要讓 Mainframe Connector 支援 CSV 格式的清單，請設為 true。
support_struct

boolean

如要讓 Mainframe Connector 支援 CSV 中的結構體，請設為 true。
timestamp_format

string

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

列舉

BinaryDataEncoding

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

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

QuoteMode

定義引號行為。

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

WriteHeaderMode

定義寫入 CSV 標題的行為。

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