如何在Bigtable中存储64位编码长数字？Java递增异常求解

一、正确存储64位有符号长整数到Bigtable #

Bigtable要求64位有符号整数以大端字节序（Big-Endian）的原始二进制字节数组存储，不需要Base64编码，也不需要手动反转字节（ByteBuffer默认就是大端序）。具体步骤：

1. 将long类型数字转换为大端字节数组
   使用Java的ByteBuffer可直接生成符合要求的字节数组，示例代码：

   long targetNum = 987654321L;
   // 分配8字节空间（long类型占8字节）
   ByteBuffer byteBuffer = ByteBuffer.allocate(Long.BYTES);
   // 写入long值，ByteBuffer默认采用大端序
   byteBuffer.putLong(targetNum);
   // 获取最终的大端字节数组
   byte[] bigEndianBytes = byteBuffer.array();
   

2. 将字节数组存入Bigtable
   通过Put接口写入，示例：

   BigtableDataClient dataClient = BigtableDataClient.create();
   Put put = Put.newBuilder(ByteString.copyFromUtf8("row-key-1"))
       .setColumn("cf", "count", bigEndianBytes)
       .build();
   dataClient.put(put);
   

二、解决readModifyWrite递增时的异常 #

出现「值必须存储为64位编码的有符号整数」异常，本质是单元格存储的内容不符合Bigtable格式要求（不是大端序的64位二进制整数），按以下方式处理：

1. 确保存储的是正确格式的字节数组
   必须使用上述ByteBuffer方法生成的字节数组，不能存储字符串、Base64编码后的字节，也不能用小端序的字节数组。

2. 正确调用readModifyWrite方法
   直接针对符合格式的列执行递增操作，示例代码：

   ReadModifyWriteRow modifyRequest = ReadModifyWriteRow.newBuilder()
       .setTableName(TableName.of("your-project-id", "your-instance-id", "your-table-name"))
       .setRowKey(ByteString.copyFromUtf8("row-key-1"))
       .addColumnModification(ColumnModification.newBuilder()
           .setFamilyName("cf")
           .setColumnName(ByteString.copyFromUtf8("count"))
           .incrementAmount(1) // 可自定义递增值
           .build())
       .build();
   
   // 执行递增并获取结果
   Row resultRow = dataClient.readModifyWriteRow(modifyRequest);
   // 解析返回的递增后的值
   long updatedValue = resultRow.getColumn("cf", "count").getLatestValue().asReadOnlyByteBuffer().getLong();
   

常见误区说明 #

• 不要用Base64编码：Bigtable需要原始二进制字节，Base64会把二进制转成文本编码，不符合格式要求。
• 不要手动反转字节：ByteBuffer默认就是大端序，手动反转会变成小端序，导致格式不匹配。

内容的提问来源于stack exchange，提问作者Smart Coder