CSV 配置

您可以通过在 JSON 文件中添加所需的配置,并使用 --input-parameter csv-dialect=DataPath 选项与 qsam encodeqsam decode 命令一起指定此文件,来配置 Mainframe 连接器转码器的 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

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

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 为所有非 null 字段添加引号。
ALL 为所有字段添加引号。
NON_NUMERIC 为所有非数字字段添加引号。
NONE 请勿为字段添加引号。当数据中出现分隔符时,打印机会在其前面添加转义字符。如果未设置转义字符,格式验证会抛出异常。

BinaryDataEncoding

指定 Mainframe Connector 对二进制数据进行编码或解码的方式。有效值为十六进制、base64 或十六进制。默认值为 base64。

枚举
BASE64 将二进制数据编码为 ASCII 字符串。
HEX 将二进制数据编码为十六进制 (\x 格式) 或转义的八进制。
HEXADECIMAL 将二进制数据编码为十六进制(0x 格式)或原始二进制。