Updated on 2025-06-27 GMT+08:00

Setting Up the Go Driver Environment

Obtaining the Driver Package

Download the driver package and its verification package listed in Table 1.

Table 1 Driver package download list

Version

Download Address

V2.0-8.x

Driver package

Verification package for the driver package

To prevent a software package from being tampered with during transmission or storage, download the corresponding verification package and perform the following steps to verify the software package:
  • Verifying the software package integrity on a Linux server:
    1. Upload the software package and verification package to the same directory on the VM.
    2. Run the following command to verify the integrity of the software package:

      cat GaussDB_driver.zip.sha256 | sha256sum --check

      If OK is displayed in the command output, the verification is successful.

      GaussDB_driver.zip: OK
  • Verifying the software package integrity on a Windows server:
    1. Press Win+R to open the Run dialog box. Type cmd in the text box and press Enter to open the Command Prompt window.
    2. Run the following command to obtain the hash value of the driver package:

      certutil -hashfile {local_directory_of_the_driver_package}\{driver_package_name} sha256

      • Replace {local_directory_of_the_driver_package} with the actual download path, for example, C:\Users.
      • Replace {driver_package_name} with the name of the downloaded driver package, for example, GaussDB_driver.zip.

      Example: certutil -hashfile C:\Users\GaussDB_driver.zip sha256

    3. Compare the hash value obtained in 2 with the hash value of the verification package obtained in Table 1.
      • If they are consistent, the verification is successful.
      • If they are inconsistent, download the driver package again and repeat 1 to 3 to verify the driver package.

Environment Class

  • Configure the Go environment.

    You need to configure the following parameters in the environment variables:

    • GO111MODULE: Set GO111MODULE to on when installing the Go driver by importing a file online. If you do not want to reconstruct the go mod project, set GO111MODULE to off and manually download the dependency package. The dependency package must be at the same level as the driver root directory and service code.
    • GOPROXY: When importing data online, you need to configure the path that contains the Go driver package.
    • You can configure other Go environment variables based on your scenario parameters.

    Run the go env command to view the Go environment variable configuration result and check whether the Go version is 1.13 or later.

  • Install the Go driver.
    • Obtain the Go driver package GaussDB-Kernel_Database version number_OS version number_64bit_Go.tar.gz from the driver package. Decompress the package to obtain the Go driver source code package.
    • Go to the root path of the Go driver code and run the go mod tidy command to download related dependencies. You need to configure GOPATH=${Path for storing the Go driver dependency package} in the environment variables.
    • If the dependencies have been downloaded to the localhost, you can add a line "Replace the Go driver package with the local Go driver package address through replace" to go.mod, indicating that all import Go driver packages in the code are stored in the local path and the dependencies are not downloaded from the proxy.
    • When you run the go mod tidy command to download dependencies, some of them may be downloaded as an earlier version. If the earlier version has vulnerabilities, you can change the dependency version in the go.mod file and update the dependency to the version after the vulnerability is fixed to avoid risks.
    • Users are not involved in the driver development and can call Go driver 1.13 or later. The runtime library needs to be updated to 1.18 or later.

Driver Class

When creating a database connection, you need to enter the database driver name gaussdb. For details about the Go driver, see Go Driver Compatibility.