Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix bigint unsigned null column scan to err type int64 #1612

Open
wants to merge 5 commits into
base: master
Choose a base branch
from

Conversation

elonnzhang
Copy link

@elonnzhang elonnzhang commented Jul 26, 2024

Description

when i use gorm scan sql rows to map[string]any, i got an error (out of range).
gorm scan sql.Rows to map[string]any by ScanRows
there has three step:

  1. prepare values ​​according to column type. https://github.com/go-gorm/gorm/blob/master/scan.go#L25,
columnTypes, _ := rows.ColumnTypes()
prepareValues(values, db, columnTypes, columns)
  1. rows.Scan(...any)
rows.Scan(values...)
  1. assign column name and value to map
scanIntoMap(mapValue, values, columns)

in step 2, when occur number(tiny int short long longlong )null column, this type will be all set to scanTypeNullInt,

scanTypeNullInt    = reflect.TypeOf(sql.NullInt64{})

# "database/sql"#L210
// NullInt64 represents an int64 that may be null.
// NullInt64 implements the [Scanner] interface so
// it can be used as a scan destination, similar to [NullString].
type NullInt64 struct {
    Int64 int64
    Valid bool // Valid is true if Int64 is not NULL
}

tiny int short long type will be ok, its Maximum value will not out of range int64
but unsigned longlong may be out of range.
int64:-9223372036854775808 ~9223372036854775807,
uint64:0 ~ 18446744073709551615

a uint64 assign to NullInt64 will be out of range, because the value store into int64

so to fix it

Must add a new scan type NullUint64 to represent unsigned bigint null column.
and though flag to judge unsigned or not.

Dur to database/sql support generics Null[T] type, it will be easy to support NullUint64.

scanTypeNullUInt   = reflect.TypeOf(sql.Null[uint64]{})

Reproduce the problem

table example

CREATE TABLE `tbl_name` (
  `id` int NOT NULL COMMENT '',
  `ubigint` bigint unsigned DEFAULT NULL COMMENT '9223372036854775808',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
INSERT INTO `tbl_name` (`id`, `ubigint`) VALUES (1, 9223372036854775808);

code

func main() {
	// connect to db
	db, err := sql.Open("mysql", "dsn")
	if err != nil {
		log.Fatal(err)
	}
	defer func() { _ = db.Close() }()

	gormDB, err := gorm.Open(gormMysql.New(gormMysql.Config{
		Conn: db,
	}), &gorm.Config{})
	var result map[string]any
	if err := gormDB.Raw("select * from tbl_name where id = 1").Scan(&result).Error; err != nil {
		log.Fatal(err)
	}
	// print type and value
	fmt.Printf("Type: %v\n", reflect.TypeOf(result))
	fmt.Printf("Value: %v\n", result)
}

Env

go version
go version go1.22.3 darwin/arm64

Error log

sql: Scan error on column index 1, name "ubigint": converting driver.Value type uint64 ("9223372036854775808") to a int64: value out of range
[9.744ms] [rows:1] select * from tbl_name where id = 1
2024/07/26 19:36:29 sql: Scan error on column index 1, name "ubigint": converting driver.Value type uint64 ("9223372036854775808") to a int64: value out of range

Checklist

  • Code compiles correctly
  • Created tests which fail without the change (if possible)
  • All tests passing
  • Extended the README / documentation, if necessary
  • Added myself / the copyright holder to the AUTHORS file

Summary by CodeRabbit

  • Documentation

    • Updated the AUTHORS file to include Jiabin Zhang as a contributor.
  • Enhancements

    • Improved handling of unsigned integer types in the MySQL field representation, enhancing type safety for data scanning processes.

Copy link

coderabbitai bot commented Jul 26, 2024

Walkthrough

The update introduces Jiabin Zhang as a new contributor in the AUTHORS file, including their email address. No other modifications were made to the existing entries or the file's structure, which remains sorted alphabetically and follows the established format for listing authors. Additionally, changes were made to the fields.go file in the MySQL driver for Go, where a new variable scanTypeNullUint was added to enhance the handling of unsigned integer types in the scanning process.

Changes

Files Change Summary
AUTHORS Added Jiabin Zhang's name and email address to the authors list.
fields.go Introduced scanTypeNullUint to handle sql.Null[uint64]{} in the scanType method for unsigned integers.

Poem

🐇 In fields of code where rabbits play,
New authors join, hip-hip-hooray!
With every name, our tale expands,
Together we build with joyful hands!
A project grows, our hearts align,
In unity, our efforts shine! 🌼✨


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

Commits

Files that changed from the base of the PR and between 44553d6 and 11f9287.

Files selected for processing (2)
  • AUTHORS (1 hunks)
  • fields.go (2 hunks)
Files skipped from review due to trivial changes (1)
  • AUTHORS
Additional comments not posted (2)
fields.go (2)

131-131: LGTM!

The declaration of scanTypeNullUInt to handle sql.Null[uint64]{} is appropriate for addressing the issue of out-of-range errors when scanning uint64 values into NullInt64.


189-191: LGTM!

The modification to the scanType method to return scanTypeNullUInt when the flagUnsigned flag is set is correct. This ensures proper handling of unsigned bigint null columns.

@coveralls
Copy link

coveralls commented Jul 29, 2024

Coverage Status

coverage: 82.351% (-0.04%) from 82.39%
when pulling 6368cf3 on elonnzhang:fix_bigint_unsigned_scan_type
into f62f523 on go-sql-driver:master.

@methane
Copy link
Member

methane commented Jul 29, 2024

We don't drop Go 1.21 support yet. So we can not use sql.Null without dirty build tag hacks.

@elonnzhang
Copy link
Author

We don't drop Go 1.21 support yet. So we can not use sql.Null without dirty build tag hacks.

ok,i just notice sql.Null introduced in 1.22

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

Commits

Files that changed from the base of the PR and between 11f9287 and 4a5269c.

Files selected for processing (1)
  • fields.go (2 hunks)
Files skipped from review as they are similar to previous changes (1)
  • fields.go

@elonnzhang
Copy link
Author

We don't drop Go 1.21 support yet. So we can not use sql.Null without dirty build tag hacks.

Can we use sql.NullString to temporarily support all supported version avoid this problem (out of range)
until we support minimum version is go 1.22?

@methane
Copy link
Member

methane commented Jul 30, 2024

I prefer 1 breaking change over 2 breaking changes.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (1)
AUTHORS (1)

125-125: Maintain alphabetical ordering in AUTHORS file.

The new entry "Jiabin Zhang" should be placed between "Zhang Xiang" and "Zhenye Xie" to maintain alphabetical ordering.

Move the entry to the correct position:

 Zhang Xiang <angwerzx at 126.com>
+Jiabin Zhang <jiabin.z at qq.com>
 Zhenye Xie <xiezhenye at gmail.com>
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 4a5269c and fdd0987.

📒 Files selected for processing (1)
  • AUTHORS (1 hunks)

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Outside diff range and nitpick comments (1)
fields.go (1)

189-191: Fix indentation for consistency.

The logic for handling unsigned bigint nulls is correct, but the indentation doesn't match the surrounding code style.

Apply this formatting fix:

-		if mf.flags&flagUnsigned != 0 {
-			return scanTypeNullUint
-		}
+        if mf.flags&flagUnsigned != 0 {
+            return scanTypeNullUint
+        }
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between fdd0987 and 6368cf3.

📒 Files selected for processing (1)
  • fields.go (2 hunks)

@@ -128,6 +128,7 @@
scanTypeInt64 = reflect.TypeOf(int64(0))
scanTypeNullFloat = reflect.TypeOf(sql.NullFloat64{})
scanTypeNullInt = reflect.TypeOf(sql.NullInt64{})
scanTypeNullUint = reflect.TypeOf(sql.Null[uint64]{})
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Breaking change: sql.Null requires Go 1.22.

As mentioned in the PR discussion, Go 1.21 support hasn't been dropped yet. Using sql.Null[uint64] would break compatibility with Go 1.21 and earlier versions.

Consider one of these alternatives:

  1. Use build tags to conditionally include this for Go 1.22+
  2. Create a custom NullUint64 type that implements the required interfaces:
// NullUint64 represents a uint64 that may be null
type NullUint64 struct {
    Uint64 uint64
    Valid  bool
}

// Implement Scanner and Valuer interfaces
func (n *NullUint64) Scan(value any) error {
    if value == nil {
        n.Uint64, n.Valid = 0, false
        return nil
    }
    n.Valid = true
    return convertAssign(&n.Uint64, value)
}

func (n NullUint64) Value() (driver.Value, error) {
    if !n.Valid {
        return nil, nil
    }
    return n.Uint64, nil
}

Comment on lines +189 to +191
if mf.flags&flagUnsigned != 0 {
return scanTypeNullUint
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codebase verification

Based on the test content examination, I can now provide a final response:

Test coverage for unsigned bigint nulls is insufficient

The codebase has tests for unsigned bigint (biguint) but only covers the non-null case with basic values (0, 65535, 42). There are no specific test cases for:

  • Null unsigned bigint values
  • Edge cases near uint64 maximum values
  • Values exceeding int64 range
  • Add test cases in driver_test.go for scanTypeNullUint similar to existing bigintnull tests
  • Include edge cases testing uint64 values > math.MaxInt64
🔗 Analysis chain

Verify test coverage for unsigned bigint nulls.

Let's ensure the changes are properly tested, especially for edge cases where uint64 values exceed int64 range.


Let's examine the specific test content in driver_test.go since it appears in both searches.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Search for tests involving unsigned bigint columns
echo "Searching for tests with unsigned bigint columns..."
rg -l --type go "(?i)(unsigned.*bigint|uint64.*null)" *_test.go

# Search for existing null scanning tests
echo "Searching for null scanning tests..."
rg -l --type go "(?i)(nullint|nulluint|null.*scan)" *_test.go

Length of output: 755


Script:

#!/bin/bash
# Check the content of driver_test.go for unsigned bigint and null scanning tests
echo "Examining driver_test.go for unsigned bigint and null scanning tests..."
rg -A 10 -B 2 "(?i)(unsigned.*bigint|uint64.*null|nullint|nulluint|null.*scan)" driver_test.go

Length of output: 11427

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants