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": boolean,
    "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

boolean

如果希望第一列包含資料欄名稱而非實際資料，請將此值設為 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。

QuoteMode

定義引號行為。

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

BinaryDataEncoding

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

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