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 对二进制数据进行编码或解码的方式。有效值为十六进制、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 为所有非 null 字段添加引号。
ALL 为所有字段添加引号。
NON_NUMERIC 为所有非数字字段添加引号。
NONE 绝不引用字段。如果数据中出现分隔符，打印机会在其前面添加转义字符。 如果未设置转义字符，格式验证会抛出异常。