CSV 配置

您可以在 JSON 文件中添加所需配置，并通过 qsam encode 或 qsam decode 命令使用 --input-parameter csv-dialect=DataPath 选项指定此文件，从而配置 Mainframe Connector 转码器的 CSV 格式。您必须按照 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

指定表示 null 字符的字符串。
quote

string

指定英文引号字符。
quote_escaping

string

指定转义字符。
quote_mode

enum (QuoteMode)

指定引用行为。默认值为 MINIMAL。
struct_end_delimiter

string

如果 support_struct 设置为 true，则此值表示结构体的结束字符分隔符。
struct_start_delimiter

string

如果 support_struct 设置为 true，则此值表示结构体的起始字符分隔符。
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 为所有非 null 字段添加引号。
MINIMAL 为包含特殊字符（例如字段定界符、引号字符或行分隔符字符串中的任何字符）的字段添加引号。
NONE 从不引用字段。如果数据中出现定界符，打印机会在其前面添加转义字符。如果未设置转义字符，格式验证会抛出异常。
NON_NUMERIC 为所有非数字字段添加引号。

WriteHeaderMode

定义写入 CSV 标题的行为。

枚举
ALWAYS 始终写入 CSV 标题。
NO 不写入 CSV 标题。
YES 仅当存在数据时才写入 CSV 标题。