php中文网

丢失记录之谜:在 Go 中调试 JSON 到 CSV 的转换

php中文网

在我的一个业余项目中构建数据转换实用程序期间,我需要将 json 格式的文件转换为 csv 格式。我遇到了一个棘手的问题,花了近一个小时进行调试才确定根本原因。

这个过程应该很简单,包括三个主要步骤:

  1. 打开 json 文件
  2. 将该 json 文件解析为特定的结构
  3. 将数据写入 csv 文件 首先,让您了解一下,json 是一个包含 65,342 个元素的数组。
func jsontocsv(data *srcsheet) {
    // create file name in a format like "email_241030172647.csv" (email_yymmddhhmmss.csv)
    fname := filename()

    // create file
    f, err := os.create(fname)
    if err != nil {
        log.println("unable to create file", err)
        return
    }
    defer f.close() // closing to release resources
    w := csv.newwriter(f) // initializing csv writer

    // add header
    header := []string{"email", "provider", "added_on"}
    if err = w.write(header); err != nil {
        log.println("unable to write header", err)
        return
    }

    count := 0
    for domain, elm := range data.email {
        if err := w.write(newrecord(domain, elm)); err != nil {
            log.println("unable to add new record", domain, err)
            return
        } else {
            count++
        }
    }

    log.println("number of records written =", count)
}

func newrecord(email string, e *srcelements) []string {
    if e == nil {
        return nil
    }

    dbformat := "2006-01-02 15:04:05.000"
    addedon := time.now().utc().format(dbformat)

    r := []string{email, e.provider, addedon}
    return r
}

代码很简单:创建一个具有特定名称格式的新文件,推迟其关闭,初始化 csv 编写器,然后开始写入该文件。超级简单吧?

步骤 1 和 2 效果很好,所以省略了。让我们将焦点转移到步骤 3,其中发生了意外的情况:csv 输出仅包含 65,032 条记录,这意味着缺少 310 条记录。

为了排除故障,我尝试了仅使用 7 个 json 元素(而不是 65,032 个)的代码。令人惊讶的是,csv 文件中根本没有写入任何内容!

我仔细检查了一些简单的错误,比如缺少文件关闭,但一切看起来都很好。然后我重试了完整的 65,032 个元素,希望能获得更多线索。这时我发现不仅少了310条记录,而且最后一条记录也不完整。

65030 adam@gmail.com, gmail, 2023-03-17 15:04:05.000
65031 jac@hotmail.com, hotmail, 2023-03-17 15:04:05.000
65032 nancy@xyz.com, hotmail, 2023-03-

这是进步——我现在可以缩小问题范围并专注于 w.write(newrecord(domain, elm)),特别是 w.write(...) 方法。我查了文档,找到了原因:

...写入会被缓冲,因此最终必须调用 [writer.flush] 以确保记录写入底层 io.writer ...

我忘记调用 w.flush()。这是有道理的,因为从性能角度来看,csv 编写器会缓冲写入,而不是每次调用 w.write() 时执行 i/o 操作。通过缓冲数据,它减少了 i/o 负载,并在最后调用 w.flush() 确保缓冲区中的任何剩余数据都写入文件。

这是更正后的代码:

...
f, err := os.Create(fName)
    if err != nil {
        log.Println("Unable to create file", err)
        return
    }
    defer f.Close()
    w := csv.NewWriter(f)
    defer w.Flush()

    // Add header
    header := []string{"email", "provider", "added_on"}
...

为了确认,我检查了 bufio.go 源代码,发现默认缓冲区大小为 4k。在 writerune(...) 方法中,您将看到每当缓冲区达到其限制时它就会调用 flush。

就这些了!我希望你喜欢阅读。我倾向于从错误中学到很多东西——无论是我的还是别人的。即使没有立即解决办法,发现错误的方法也可以帮助我避免将来陷入类似的陷阱。这就是为什么我想分享这个经验!

以上就是丢失记录之谜:在 Go 中调试 JSON 到 CSV 的转换的详细内容,更多请关注php中文网其它相关文章!